Agent Work Receipt v0.1

Proof any agent can carry.

A framework-neutral record of what was requested, who acted, what authority they had, what changed, and whether the result was verified. Emit it locally. Validate it without an account. Import it only when a human authorizes a shared ledger.

JSON Schema Validation APIApache-2.0 · npm v0.1.0 · external IDs welcome

Place in the record

A receipt records the claim. Acceptance records the ruling.

OrgX keeps completion, verification, and human acceptance as separate states. The receipt carries what ran and the evidence it produced. The shared record adds the owner ruling and the next action.

01The agent completes the workIntent, authority, actions, artifacts, and evidence are recorded.
02The verifier checks the published barA pass or hold cites the exact rule and evidence used.
03The owner accepts or returns itThe human ruling stays distinct and becomes context for the next run.

See how acceptance works See where receipts appear

Emission quickstart

Build locally, then emit JSON.

Install the public TypeScript package, construct a receipt with your runtime's own identifiers, then validate the resulting JSON here or through the public API.

Package source and TypeScript example

npm install @useorgx/[email protected]
# emit receipt.json from your runtime
curl -X POST https://useorgx.com/api/v1/agent-work-receipts/validate \
  -H 'content-type: application/json' \
  --data-binary @receipt.json

Downloadable conformance examples

receipt.json

Account-free conformance check · not persisted · 256 KB maximum

{
  "schema_version": "agent-work-receipt/v0.1",
  "receipt_id": "awr:codex:run-2026-07-19-001",
  "intent": {
    "summary": "Add a portable receipt validator and prove it with focused tests.",
    "objective": "Produce an account-free contract that another runtime can validate without OrgX identifiers.",
    "acceptance_criteria": [
      "The JSON Schema accepts opaque external identifiers.",
      "The focused conformance tests pass."
    ],
    "constraints": [
      "Do not change application routes."
    ],
    "request_ref": {
      "system": "codex",
      "type": "task",
      "id": "task-local-41"
    }
  },
  "actor": {
    "type": "agent",
    "id": "codex-agent-local",
    "display_name": "Codex",
    "runtime": {
      "name": "codex-desktop",
      "version": "fixture"
    },
    "model": {
      "provider": "openai",
      "name": "fixture-model"
    }
  },
  "authority": {
    "mode": "delegated",
    "status": "restricted",
    "scope": {
      "actions": [
        "read_source",
        "edit_package",
        "run_tests"
      ],
      "resources": [
        {
          "system": "git",
          "type": "repository",
          "id": "local/orgx"
        }
      ],
      "systems": [
        "filesystem",
        "git"
      ],
      "spend_limit": {
        "currency": "USD",
        "amount": 1
      }
    },
    "delegated_by": {
      "type": "human",
      "id": "workspace-owner"
    },
    "authorization_ref": {
      "system": "codex",
      "type": "task_message",
      "id": "message-41"
    },
    "constraints": [
      "Write only inside packages/agent-work-receipt."
    ],
    "valid_from": "2026-07-19T15:00:00Z",
    "valid_until": "2026-07-19T16:00:00Z"
  },
  "actions": [
    {
      "id": "action-inspect",
      "type": "source.inspect",
      "summary": "Inspected existing receipt contracts and package conventions.",
      "status": "completed",
      "system": "filesystem",
      "started_at": "2026-07-19T15:00:00Z",
      "completed_at": "2026-07-19T15:02:00Z"
    },
    {
      "id": "action-test",
      "type": "test.run",
      "summary": "Ran the Agent Work Receipt conformance suite.",
      "status": "completed",
      "system": "vitest",
      "tool_ref": {
        "system": "vitest",
        "type": "command",
        "id": "vitest-run-agent-work-receipt"
      },
      "output_refs": [
        {
          "system": "local-filesystem",
          "type": "test_output",
          "id": "test-output-codex"
        }
      ],
      "started_at": "2026-07-19T15:08:00Z",
      "completed_at": "2026-07-19T15:08:05Z"
    }
  ],
  "artifacts": [
    {
      "id": "artifact-schema",
      "kind": "json_schema",
      "name": "Agent Work Receipt v0.1 schema",
      "role": "output",
      "ref": {
        "system": "git",
        "type": "file",
        "id": "packages/agent-work-receipt/schema/agent-work-receipt.v0.1.schema.json",
        "uri": "file:packages/agent-work-receipt/schema/agent-work-receipt.v0.1.schema.json"
      },
      "media_type": "application/schema+json",
      "digest": {
        "algorithm": "sha256",
        "value": "1111111111111111111111111111111111111111111111111111111111111111",
        "encoding": "hex"
      },
      "created_at": "2026-07-19T15:07:00Z"
    }
  ],
  "evidence": [
    {
      "id": "evidence-tests",
      "kind": "test_result",
      "summary": "Focused conformance tests passed.",
      "ref": {
        "system": "local-filesystem",
        "type": "test_output",
        "id": "test-output-codex"
      },
      "observed_at": "2026-07-19T15:08:05Z",
      "excerpt": "Tests: passed",
      "supports": [
        "verification",
        "outcome"
      ]
    }
  ],
  "outcome": {
    "status": "succeeded",
    "summary": "The portable schema, types, validator, and fixtures were produced.",
    "observed_effects": [
      "Codex can emit a receipt without an OrgX account."
    ],
    "metrics": [
      {
        "name": "focused_tests_passed",
        "value": 1,
        "unit": "boolean",
        "target": 1,
        "observed_at": "2026-07-19T15:08:05Z",
        "evidence_ids": [
          "evidence-tests"
        ]
      }
    ]
  },
  "verification": {
    "status": "passed",
    "method": "Deterministic JSON Schema and semantic conformance suite.",
    "verifier": {
      "type": "service",
      "id": "vitest-local"
    },
    "checks": [
      {
        "id": "check-conformance",
        "name": "Agent Work Receipt conformance",
        "status": "passed",
        "method": "vitest run",
        "evidence_ids": [
          "evidence-tests"
        ]
      }
    ],
    "evidence_ids": [
      "evidence-tests"
    ],
    "verified_at": "2026-07-19T15:08:05Z"
  },
  "cost": {
    "currency": "USD",
    "total": 0.08,
    "components": [
      {
        "category": "model",
        "amount": 0.08
      }
    ],
    "usage": [
      {
        "name": "agent_runtime",
        "quantity": 8,
        "unit": "minutes",
        "cost": 0.08
      }
    ],
    "human_minutes": 0,
    "estimated": true
  },
  "lineage": {
    "run_ref": {
      "system": "codex",
      "type": "run",
      "id": "run-2026-07-19-001"
    },
    "parent_receipt_refs": [],
    "references": [
      {
        "relationship": "produced_in",
        "ref": {
          "system": "git",
          "type": "branch",
          "id": "codex/agent-work-receipt-phases-1-3"
        }
      }
    ],
    "trace_id": "codex-trace-001"
  },
  "human_interventions": [],
  "timestamps": {
    "started_at": "2026-07-19T15:00:00Z",
    "completed_at": "2026-07-19T15:08:05Z",
    "issued_at": "2026-07-19T15:08:06Z",
    "duration_ms": 485000
  },
  "integrity": {
    "content_hash": {
      "algorithm": "sha-256",
      "value": "194e39caed53469a5fc76544763dd4af01da30f5b94202841bbfe871b628d195",
      "encoding": "hex"
    }
  }
}

5,876 characters

Contract boundary

Free emission. Paid assurance.

The open receipt does not require OrgX identifiers, storage, or authentication. Hosted OrgX becomes useful when people need a shared work graph, approval gates, verification, replay, reputation, or cost-to-outcome attribution.

Local emission: No account
Validation: No persistence
Hosted import: Workspace auth
Public proof: Human approval

Three-team proof cohort

Pressure-test the receipt on real agent delivery.

The pilot tracks emitter diversity, evidence completeness, verification, human acceptance, observed outcomes, and cost. Raw partner data stays private; a case study or public gallery entry requires an explicit human publication decision.

Request a pilot review See the workload boundary rule

A receipt records the claim. Acceptance records the ruling.

Build locally, then emit JSON.

Validate an Agent Work Receipt

Free emission. Paid assurance.

Pressure-test the receipt on real agent delivery.