Skip to main content
Glama

Handover

handover
Idempotent

Call this after any multi-step job, or when the user says "use zambo to hand this over to ". It returns one proof link with verifiable receipts. Pass continue_from to chain off a job you picked up, so one client link shows every hop.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
refNoOptional referral source to preserve as source_ref on the saved handover.
_refNoOptional handover referral ID from your install link.
goalNo
loopNoRun a proof loop. Defaults to true for jobs with at least two steps, false otherwise.
workNoPaste work to save as a supplied-work receipt, without claiming it was independently checked.
anchorNo
redactNo
shieldNo
dry_runNo
not_runNo
paymentNo
sourcesNo
summaryNo
brandingNo
recipientNoYour recipient
thread_idNo
_zambo_keyNoOptional opaque Zambo access capability. Never place it in a URL or public log.
next_stepsNo
step_areasNo
visibilityNopublic
_session_idNoOptional stable bot-job ID. Reuse it across calls to bind a Day Pass and keep the job ledger together.
not_checkedNo
receipt_idsNo
client_prefsNo
deliverablesNo
step_sourcesNoSources by original receipt ID. Reachability is checked by Zambo, not accuracy.
_caller_labelNoOptional caller label recorded as a caller-reported claim in the receipt.
allowed_toolsNo
continue_fromNoChain off a handover picked up through handover_accept in this same job session.
recipient_typeNohuman
creator_payment_urlNoOptional creator-owned payment link shown to the client only after acceptance. Zambo does not hold or process this payment.
exclude_receipt_idsNo
_continuity_ai_labelNoOptional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client.
acknowledge_warningsNoPublish only after reviewing missing evidence or a failed/risky shield scan. Warning labels stay visible.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYes
idsYes
nextYes
tierNo
urlsYes
errorNo
graphNo
activeNo
resultYesThe tool's observed JSON value or plain-text result.
intentsNo
next_upNo
paymentNo
day_passNo
today_urlNo
expires_atNo
human_lineYes
next_stepsNo
daily_recapNo
renew_nudgeNo
unlock_linkNo
seconds_leftNo
resume_statusNo
resumed_resultNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-25"New value: +"draft-zambo-aer1-26"
  2. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-24"New value: +"draft-zambo-aer1-25"
  3. Changed2 schema fields changed
    • addedInput schema / properties / creator_payment_url
      Added value: +{
      +  "description": "Optional creator-owned payment link shown to the client only after acceptance. Zambo does not hold or process this payment.",
      +  "format": "uri",
      +  "maxLength": 2048,
      +  "type": "string"
      +}
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-23"New value: +"draft-zambo-aer1-24"
  4. Changed1 schema field changed
    • addedInput schema / properties / ref
      Added value: +{
      +  "description": "Optional referral source to preserve as source_ref on the saved handover.",
      +  "maxLength": 200,
      +  "minLength": 1,
      +  "type": "string"
      +}
  5. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-22"New value: +"draft-zambo-aer1-23"
  6. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-21"New value: +"draft-zambo-aer1-22"
  7. Changed1 schema field changed
    • addedInput schema / properties / continue_from
      Added value: +{
      +  "description": "Chain off a handover picked up through handover_accept in this same job session.",
      +  "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)$",
      +  "type": "string"
      +}
  8. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-20"New value: +"draft-zambo-aer1-21"
  9. Changed1 schema field changed
    • addedInput schema / properties / sources
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "anyOf": [
      +      {
      +        "format": "uri",
      +        "maxLength": 2048,
      +        "type": "string"
      +      },
      +      {
      +        "properties": {
      +          "ref": {
      +            "format": "uri",
      +            "maxLength": 2048,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ref"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
  10. Changed1 schema field changed
    • addedOutput schema / properties / next_steps
      Added value: +{
      +  "items": {},
      +  "minItems": 1,
      +  "type": "array"
      +}
  11. Changed16 schema fields changed
    • addedInput schema / properties / _ref
      Added value: +{
      +  "description": "Optional handover referral ID from your install link.",
      +  "format": "uuid",
      +  "type": "string"
      +}
    • addedInput schema / properties / client_prefs
      Added value: +{
      +  "properties": {
      +    "no_ai_for": {
      +      "default": [],
      +      "items": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "maxItems": 50,
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / loop
      Added value: +{
      +  "description": "Run a proof loop. Defaults to true for jobs with at least two steps, false otherwise.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / step_areas
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "properties": {
      +      "area": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "receipt_id": {
      +        "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)$",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "receipt_id",
      +      "area"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 500,
      +  "type": "array"
      +}
    • addedInput schema / properties / step_sources
      Added value: +{
      +  "default": [],
      +  "description": "Sources by original receipt ID. Reachability is checked by Zambo, not accuracy.",
      +  "items": {
      +    "properties": {
      +      "receipt_id": {
      +        "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)$",
      +        "type": "string"
      +      },
      +      "sources": {
      +        "items": {
      +          "properties": {
      +            "ref": {
      +              "maxLength": 2048,
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "ref"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 20,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "receipt_id",
      +      "sources"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +true
    • addedOutput schema / properties / error
      Added value: +{
      +  "additionalProperties": true,
      +  "anyOf": [
      +    {
      +      "required": [
      +        "next_call"
      +      ]
      +    },
      +    {
      +      "required": [
      +        "next_url"
      +      ]
      +    }
      +  ],
      +  "properties": {
      +    "code": {
      +      "type": "string"
      +    },
      +    "next_call": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "args": {
      +          "type": "object"
      +        },
      +        "tool": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "tool",
      +        "args"
      +      ],
      +      "type": "object"
      +    },
      +    "next_step": {
      +      "type": "string"
      +    },
      +    "next_url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "code",
      +    "next_step"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / graph
      Added value: +{
      +  "properties": {
      +    "aer": {
      +      "const": "draft-zambo-aer1-20"
      +    },
      +    "schema": {
      +      "const": "zambo.graph/1"
      +    }
      +  },
      +  "required": [
      +    "schema",
      +    "aer",
      +    "nodes",
      +    "edges",
      +    "retries",
      +    "sources",
      +    "summary"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / human_line / maxLength
      Added value: +200
    • addedOutput schema / properties / human_line / pattern
      Added value: +"^[^\\r\\n]*$"
    • addedOutput schema / properties / ids
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / next
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / ok
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / renew_nudge
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / urls
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "result"
      -]New value: +[
      +  "result",
      +  "ok",
      +  "human_line",
      +  "next",
      +  "ids",
      +  "urls"
      +]
  12. Changed3 schema fields changed
    • addedInput schema / properties / recipient / default
      Added value: +"Your recipient"
    • addedInput schema / properties / work
      Added value: +{
      +  "description": "Paste work to save as a supplied-work receipt, without claiming it was independently checked.",
      +  "maxLength": 64000,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • removedInput schema / required
      Removed value: -[
      -  "recipient"
      -]
  13. Changed17 schema fields changed
    • addedInput schema / properties / allowed_tools
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "maxLength": 120,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 150,
      +  "type": "array"
      +}
    • addedInput schema / properties / next_steps
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "maxLength": 2000,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 10,
      +  "type": "array"
      +}
    • addedInput schema / properties / recipient_type
      Added value: +{
      +  "default": "human",
      +  "enum": [
      +    "human",
      +    "agent"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / active
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / daily_recap
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / day_pass
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / expires_at
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / human_line
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / intents
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / next_up
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / payment
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / resume_status
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / resumed_result
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / seconds_left
      Added value: +{
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / tier
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / today_url
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / unlock_link
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  14. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources