DreamNet Public Core

Portable contracts for AI agents that remember, recover, and prove their work.

DreamNet Public Core is the open seam of the DreamNet ecosystem. It gives local, cloud, and edge agents a shared language for assignments, Capsules, lifecycle state, claims, and evidence-backed receipts.

It does not contain DreamNet's private orchestration, internal prompts, credentials, customer data, provider routing, or proprietary policy models.

Why It Exists

Most agent demos lose state when the process dies and leave no durable proof of what happened. Public Core starts with the operating contracts:

Goal
  -> Assignment
  -> Capsule
  -> Work
  -> Producing Claim Factory
  -> Independent Verification Factory
  -> Promotion Gate
  -> Claim + Receipts

The runtime can change. The evidence contract remains inspectable.

Install

Until the first registry release, install from GitHub:

npm install github:BrandonDucar/Dreamnet

Quick Start

import {
  createAssignment,
  createReceipt,
  validateAssignment,
  validateReceipt,
  type CapsuleManifest,
} from "@dreamnet/public-core";

const capsule: CapsuleManifest = {
  schemaVersion: "dreamnet.capsule.v1",
  capsuleId: "capsule:read-only-research",
  name: "Read-only Research",
  version: "1.0.0",
  description: "Produces a cited summary from approved sources.",
  capabilities: ["research", "summarize"],
  tools: ["approved-source-reader"],
  requiredPolicies: ["policy:read-only"],
  acceptedRiskTiers: ["low", "medium"],
  receiptRequired: true,
};

const assignment = createAssignment({
  principalId: "user:example",
  goal: "Summarize the approved source bundle",
  acceptanceCriteria: ["Every material statement cites evidence"],
  capsule,
  policyVersion: "policy:read-only@1",
});

if (!validateAssignment(assignment).valid) {
  throw new Error("Invalid assignment");
}

const receipt = createReceipt({
  assignment,
  traceId: "trace:example",
  workloadId: "workload:local",
  startedAt: new Date().toISOString(),
  status: "succeeded",
  summary: "The approved source bundle was summarized.",
  toolCalls: 1,
  evidence: [
    {
      id: "source:bundle",
      kind: "source",
      uri: "file:///approved/source.md",
    },
  ],
});

if (!validateReceipt(receipt).valid) {
  throw new Error("Invalid receipt");
}

Public Surface

• Typed Assignment Envelope v1
• Typed Capsule Manifest v1
• Explicit DreamLoop lifecycle states
• Typed Receipt Envelope v1
• Typed Claim Object v1
• Deterministic canonical JSON and SHA-256 helpers
• Zero-runtime-dependency validators
• JSON Schemas

See Public and Private Boundaries and Architecture. The complete public model is in the DreamNet Whitepaper.

Ecosystem

• DreamLoops
• GitGrid
• Cerberus
• Temporal Worker
• Claim Factory
• ToolGym
• Memory Weaver
• Proof Drop
• Quorum Lab
• Whale League

Status

0.1.x is an early public contract release. It is suitable for experiments, interoperability work, and feedback. It is not a wallet, transaction signer, authorization service, or production security boundary by itself.

License

Apache-2.0. DreamNet trademarks, private services, and proprietary repositories are not granted by this license.