Call this when the user says 'wrap up this session', 'continue in another AI', or 'hand this over to <client>'. For AI switching, create a resumable handover with the same session. For client delivery, return one proof link with verifiable receipts. Pass continue_from to chain off a job you picked up.
View input schema
{
"type": "object",
"properties": {
"ref": {
"description": "Optional referral source to preserve as source_ref on the saved handover.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"loop": {
"description": "Run a proof loop. Defaults to true for jobs with at least two steps, false otherwise.",
"type": "boolean"
},
"recipient_type": {
"default": "human",
"type": "string",
"enum": [
"human",
"agent",
"ai"
],
"description": "Recipient category: human, agent, or AI. Defaults to human."
},
"next_steps": {
"default": [],
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"description": "Ordered, actionable steps for the recipient to continue the work."
},
"allowed_tools": {
"default": [],
"maxItems": 150,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": "Optional tool names to allow for the recipient's continuation."
},
"recipient": {
"default": "Your recipient",
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Display name or label for the person, agent, or AI receiving this handover."
},
"work": {
"description": "Paste work to save as a supplied-work receipt, without claiming it was independently checked.",
"type": "string",
"minLength": 1,
"maxLength": 64000
},
"goal": {
"type": "string",
"maxLength": 2000,
"description": "The objective this handover should help the recipient continue."
},
"summary": {
"type": "string",
"maxLength": 2000,
"description": "Concise account of what has been completed so far."
},
"sources": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"anyOf": [
{
"description": "A source URL relevant to the saved work.",
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "object",
"properties": {
"ref": {
"description": "URL of a source relevant to the saved work.",
"type": "string",
"maxLength": 2048,
"format": "uri"
}
},
"required": [
"ref"
]
}
]
},
"description": "Reference URLs related to the work being handed over."
},
"_session_id": {
"type": "string",
"maxLength": 64,
"description": "Optional stable bot-job ID. Reuse it across calls to bind a Day Pass and keep the job ledger together."
},
"continue_from": {
"description": "Chain off a handover picked up through handover_accept in this same job session.",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
},
"thread_id": {
"type": "string",
"maxLength": 64,
"description": "Optional continuity thread ID to associate with this handover."
},
"receipt_ids": {
"maxItems": 500,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
},
"description": "IDs of existing receipts to attach as evidence for the handed-over work."
},
"step_sources": {
"description": "Sources by original receipt ID. Reachability is checked by Zambo, not accuracy.",
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"receipt_id": {
"description": "Receipt ID for the handover step these sources support.",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
},
"sources": {
"description": "Sources associated with this receipt's step.",
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"ref": {
"description": "Citation or source reference associated with this receipt.",
"type": "string",
"minLength": 1,
"maxLength": 2048
}
},
"required": [
"ref"
]
}
}
},
"required": [
"receipt_id",
"sources"
]
}
},
"step_areas": {
"default": [],
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"receipt_id": {
"description": "Receipt ID for the step associated with this work area.",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
},
"area": {
"description": "Work area, such as legal review or final approval.",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"receipt_id",
"area"
]
},
"description": "Work-area labels mapped to receipt IDs; each entry identifies one receipt and its area."
},
"client_prefs": {
"type": "object",
"properties": {
"no_ai_for": {
"description": "Work areas the client asked not to use AI for.",
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"description": "Client constraints to carry forward, such as areas where AI must not be used."
},
"exclude_receipt_ids": {
"maxItems": 500,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
},
"description": "Receipt IDs to leave out of this handover."
},
"deliverables": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"description": "Human-readable name for this delivered file or artifact.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"url": {
"description": "Optional URL where the recipient can access this deliverable.",
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"content": {
"description": "Optional text content to include directly as the deliverable.",
"type": "string",
"maxLength": 64000
},
"sha256": {
"description": "Optional SHA-256 digest used to identify the exact deliverable bytes.",
"type": "string",
"pattern": "^(sha256:)?[a-f0-9]{64}$"
}
},
"required": [
"name"
]
},
"description": "Named outputs to include, with an optional URL, content, or SHA-256 hash."
},
"not_checked": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"description": "Relevant items that were not independently checked."
},
"not_run": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"description": "Checks or actions that were not run as part of this work."
},
"shield": {
"default": true,
"type": "boolean",
"description": "Whether to run the handover content shield check; defaults to true."
},
"creator_payment_url": {
"description": "Optional creator-owned payment link shown to the client only after acceptance. Zambo does not hold or process this payment.",
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"payment": {
"type": "object",
"properties": {
"method": {
"description": "Payment protocol used for the supplied settlement details.",
"type": "string",
"const": "x402"
},
"network": {
"description": "Network identifier on which the payment was settled.",
"type": "string",
"maxLength": 100
},
"tx_hash": {
"description": "Transaction hash for the payment, if available.",
"type": "string",
"maxLength": 256
},
"settlement_ref": {
"description": "Provider settlement reference, if available.",
"type": "string",
"maxLength": 256
},
"amount": {
"description": "Settled payment amount as a string, if available.",
"type": "string",
"maxLength": 100
},
"asset": {
"description": "Payment asset or token symbol, if available.",
"type": "string",
"maxLength": 100
},
"payTo": {
"description": "Recipient address that received the payment, if available.",
"type": "string",
"maxLength": 256
}
},
"required": [
"method"
],
"description": "Optional caller-supplied x402 payment metadata; it does not itself prove settlement."
},
"visibility": {
"default": "public",
"type": "string",
"enum": [
"public",
"unlisted",
"private"
],
"description": "Who can open the handover: public, unlisted by link, or private."
},
"redact": {
"type": "object",
"properties": {
"auto_pii": {
"description": "Automatically detect and redact likely personal information.",
"default": true,
"type": "boolean"
},
"fields": {
"description": "Additional field names to redact from the public handover.",
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"maxLength": 200
}
},
"mode": {
"description": "How selected private values are handled in public output.",
"default": "mask",
"type": "string",
"enum": [
"mask",
"hash_only",
"omit"
]
}
},
"description": "Privacy settings for masking, hashing, or omitting selected fields."
},
"branding": {
"type": "object",
"properties": {
"name": {
"description": "Optional display name shown on the handover.",
"type": "string",
"maxLength": 100
},
"logo_url": {
"description": "Optional logo URL shown on the handover.",
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"accent": {
"description": "Optional six-digit hex accent color.",
"type": "string",
"pattern": "^#[a-f0-9]{6}$"
}
},
"description": "Optional display name, logo URL, and accent color for the handover page."
},
"anchor": {
"default": true,
"type": "boolean",
"description": "Whether to request an optional external anchor for the handover receipt; defaults to true."
},
"dry_run": {
"default": false,
"type": "boolean",
"description": "Preview the proposed handover without publishing it."
},
"acknowledge_warnings": {
"description": "Publish only after reviewing missing evidence or a failed/risky shield scan. Warning labels stay visible.",
"default": false,
"type": "boolean"
},
"_caller_label": {
"type": "string",
"maxLength": 80,
"description": "Optional caller label recorded as a caller-reported claim in the receipt.",
"default": "zambo-starter"
},
"_caller_handle": {
"type": "string",
"maxLength": 64,
"description": "Opaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization."
},
"_ref": {
"type": "string",
"format": "uuid",
"description": "Optional handover referral ID from your install link."
},
"_continuity_ai_label": {
"type": "string",
"maxLength": 48,
"description": "Optional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client."
},
"_zambo_key": {
"type": "string",
"maxLength": 160,
"description": "Optional opaque Zambo access capability. Never place it in a URL or public log."
},
"receipt_visibility": {
"type": "string",
"enum": [
"public",
"private"
],
"default": "public",
"description": "Receipt visibility for this call. Public is the default. Private returns a bearer link; anyone with that link can read it, so keep it secret. The raw token is not stored."
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}