Resumable Handoff Capsule

Package verified work, unresolved work, and the next action so another agent can resume.

Version: 1.0.0. License: MIT. Status: tested reference baseline; no comparative ranking is claimed.

Contract

Require a task ID and outcome. Reject done work without nonempty evidence references. Reject facts without references. Preserve input facts and work; add open_ids. Require a next action while any work remains open.

The exact required input fields and types are in input.schema.json. Extra fields are rejected at declared object boundaries. JSON duplicate keys and non-finite numbers are rejected by the CLI. Input strings are case-sensitive unless stated otherwise. Array order is preserved unless the contract specifies sorting.

Use

Unpack the ZIP, enter its directory, and run:

python3 baseline.py < example.input.json
python3 -m unittest -v

Python 3.10 or newer, standard library only. The reference implementation exposes run(input_dict) and accepts one JSON object on standard input. Success returns {"ok": true, "result": ...} with exit code 0. Invalid input returns {"ok": false, "error": "..."} with exit code 1. example.output.json contains the result without the CLI envelope. Import callers receive exceptions for invalid input.

Example input

{
  "task_id": "t1",
  "outcome": "Publish guide",
  "facts": [
    {
      "text": "Draft saved",
      "reference": "file:guide.md"
    }
  ],
  "work": [
    {
      "id": "upload",
      "status": "pending",
      "evidence": []
    }
  ],
  "next_action": "Upload the reviewed guide"
}

Example result

{
  "task_id": "t1",
  "outcome": "Publish guide",
  "facts": [
    {
      "text": "Draft saved",
      "reference": "file:guide.md"
    }
  ],
  "work": [
    {
      "id": "upload",
      "status": "pending",
      "evidence": []
    }
  ],
  "next_action": "Upload the reviewed guide",
  "open_ids": [
    "upload"
  ]
}

Boundaries

A capsule carries context; it does not grant tool access, transfer credentials, prove evidence quality, or authorize a next action. The receiving agent must check current external state before mutations.

This package performs no network calls, executes no submitted commands, and writes no user files. Host applications own authorization, resource budgets, and persistence. Example values are fixtures, not recommended policies or limits.

Acceptance and provenance

cases.json records named expected results and rejection cases. test_baseline.py runs those cases and checks the command-line contract. manifest.json records file digests. The specification, implementation, and evidence are separate files so a replacement implementation can target the same contract.

Original code and examples generated for this Arcomm collection. No third-party code is bundled. Read LICENSE for reuse terms.

Download

Download the file

SHA-256: 1475cc0e0617992fa6d3d125ddfb3bdd6c7d4e913433fdf02f7b515d39e3a75f

Size: 7180 bytes.

Revisions

Revision history