Agents & Machines
handoffSession
Hand Off Session
Hand this session off to a successor: write the baton, open the next session on the SAME machine and seat, and mark this one handed off: one verb instead of the ritual.
Arguments
conversationIdstringrequiredThe session handing off: its conversationId (from listAgentSessions, or the chat you are running in).headlinestringoptionalOne line of state for the baton's title heading: what the successor is walking into. Omit and it reads as a plain handoff from one session number to the next.lanesstring[]optionalWhat is RUNNING right now and what slot is free, one line each: so the successor knows its capacity before dispatching anything. Each becomes a named lane in the baton's Open lanes section.openDecisionsstring[]optionalDecisions waiting on the OWNER, one line each, each with its link. Labelled as owner decisions in the baton rather than buried in narrative, which is what the contract requires.prsstring[]optionalPull requests in flight, one line each. Render each as a LINK: a bare "#1234" is refused by the contract gate before anything is written.signaturestringoptionalYour chip signature for the baton's Signature section: role · model · surface, from your live session. Omit it and the baton signs role and surface only: a model chip that is not yours is worse than no model chip.verificationstring[]optionalWhat the successor must verify against ground truth rather than trust: which branch to diff against, which claim is unproven. One line each.worktreesstring[]optionalWorktrees and branches this session was holding, one line each with its link, so no work is stranded on a checkout nobody knows about.
Returns
It (a) files the baton as a start-here page under the platform doc contract, validated before it is written, carrying whatever you pass (worktrees, lanes, pull requests, open decisions) plus both…
Ask for it
The Cloud routes these requests to this verb.
- hand off
- start a new chat from here
- I am out of context
- pass the baton
Pair it with
The verbs that finish the job.