dispatch_handoff
Builds a handoff bundle from a public brief for a specified target, including optional doctrine references and metadata, to prepare material for a runtime without executing work.
Instructions
Build a public dispatch handoff.
Bundles an existing public brief, caller-defined target, optional linkage, optional doctrine text, and metadata
into a self-contained handoff for a caller-owned runtime. In plugin mode, this handoff is material for
a customer-side ephemeral subagent; it is not permission for Manager to execute the scope inline.
When to use:
- Prepare a saved public brief for handoff to a runtime without requiring another MCP read.
- Include small workspace-local reference files beside the embedded brief content.
- Support a plugin-mode Manager -> ephemeral executor crossing when dispatch handoff material is useful.
When NOT to use:
- Do not use this to execute work; it only builds a handoff.
- Do not use this without a saved brief; use transport_register directly for brief-less tracking.
- Do not use this as a fallback after subagent spawning fails.
Examples:
>>> dispatch_handoff("brief-import-audit-2026-05-06-a1b2c3", "audit-job")
{"schema": "nogra.dispatch.handoff.v1", "target": "audit-job", "brief": {...}, ...}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | Free-form caller-defined runtime target. | |
| brief_id | Yes | Public brief id to embed into the dispatch handoff. | |
| metadata | No | Optional caller-owned handoff metadata. | |
| intent_id | No | Optional caller-owned intent id. | |
| doctrine_refs | No | Optional workspace-relative doctrine file refs to embed. | |
| parent_run_id | No | Optional parent transport run id for caller linkage. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||