Hand off current work in one high-level operation

POST
/v1/work/handoffs/prepare-current

This operation captures its own boundary; do not call capture_content_source or another Handoff operation first. next_action is one WorkClaim object or null, never an array; omissions is an array of strings or []. Capture an inspected boundary and prepare a temporary evidence-bearing Handoff without committing it. Capture the inspected boundary of a requested work transfer and prepare its Handoff. Use a unique source_id, exact evidence where available, and declared facts otherwise. The returned handoff member is the temporary carrier; commit only for an authorized durable milestone. A preview-only request makes no write. The handoff input contains schema="powercontext.current-work-handoff.v1", trust="untrusted_input", objective, state, disposition, next_action, and omissions. Each state item and non-null next_action is a WorkClaim with text, basis, and evidence (not citations). Facts inspected in the conversation or repository use basis="declared" and evidence=[] unless an exact existing PowerContext citation was returned. Never fabricate a citation for the new source_id or mark a claim verified with empty evidence.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer credential resolved to an opaque authenticated Principal by the Server deployment.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/work/handoffs/prepare-current" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "source_id": "string",    "handoff": {      "schema": "powercontext.current-work-handoff.v1",      "trust": "untrusted_input",      "objective": "string",      "state": [        {          "text": "string",          "basis": "declared",          "evidence": [            {              "kind": "source",              "source_ref": {                "name": "string",                "source_id": "string"              }            }          ]        }      ],      "disposition": "continuable",      "next_action": {        "text": "string",        "basis": "declared",        "evidence": [          {            "kind": "source",            "source_ref": {              "name": "string",              "source_id": "string"            }          }        ]      },      "omissions": [        "string"      ]    }  }'
{  "boundary": {    "kind": "work-contract",    "source": {      "name": "string",      "source_id": "string"    },    "position": 1,    "content_digest": "stringstringstringstringstringstringstringstringstringstringstringstrin"  },  "handoff": {    "generation": {      "receipt": "string"    },    "schema": "powercontext.prepared-handoff.v1",    "scope_id": "string",    "base": {      "family": "string",      "artifact_id": "string",      "revision": 1    },    "content": {      "generation": {        "scope_id": "string",        "prompt_key": "handoff.generate",        "selection": "built_in",        "artifact": {          "family": "string",          "artifact_id": "string",          "revision": 1        },        "definition_version": "string",        "builtin_version": "string",        "compiled_digest": "string",        "original_draft_digest": "string",        "edit_status": "unchanged"      },      "schema": "powercontext.handoff.v1",      "objective": "string",      "state": [        {          "text": "string",          "citations": [            {              "kind": "source",              "source_ref": {                "name": "string",                "source_id": "string"              }            }          ]        }      ],      "disposition": "continuable",      "next_action": {        "text": "string",        "citations": [          {            "kind": "source",            "source_ref": {              "name": "string",              "source_id": "string"            }          }        ]      },      "omissions": [        {          "text": "string",          "citation": {            "kind": "source",            "source_ref": {              "name": "string",              "source_id": "string"            }          }        }      ]    }  }}

Create a grounded Work Contract POST

Persist an inspectable delegation baseline without granting execution authority. Record the inspected baseline of explicitly delegated work: objective, evidence, scope, exclusions, completion criteria, and authorization. Ordinary coding or discussion alone does not need a Work Contract. The contract is historical input and grants no authority beyond current instructions.

Resolve and acknowledge a Handoff POST

Re-resolve one prepared or exact Handoff, check evidence, and capture the receiver's explicit live-state, capability, and authorization checks. Record the receiver decision for an exact prepared or committed Handoff after checking readable evidence, live state, capabilities, and authorization. Never acknowledge an unresolved latest selector or report accepted while required checks are unknown. Acknowledgement does not execute or complete the task.