Use case

A paused agent run should not become a restart.

Long-running agent work needs recovery as a first-class path. Orcho treats pause, halt, resume and handoff as run states, so the next worker or human can continue from the plan, event history and evidence already on record.

PUBLIC ALPHA

Read workflow portability Read handoffs and advisors

typed plan cross_plan.md

gate findings review_changes.json

run diff diff.patch

event spine events.jsonl

cost split metrics.json

handoff decision phase_handoff.json

Continuity

The run survives the worker.

A worker can fail, lose context, or need a human verdict. The important object is the run: its plan, phase state, findings, artifacts and decisions.

Handoff is recorded as part of the lifecycle.
Resume uses the existing run state instead of starting a new transcript.
Evidence remains inspectable after the session exits.

Portability

Different workers can pick up different phases.

Planning, implementation, review and repair can route to different agents or scripts without losing the delivery record. The protocol is the stable layer.