Skip to main content
API reference sections

Schema

ControlState

Who holds the session's controller while a run is Running (§7.4).

objective_satisfied is the fence: an orchestrator turn that completed the objective while a handover was pending does not end the run - the handover it was about to yield to wins - and the fact is carried here so that when control returns the run completes without a second turn.

Type object or object or object

Shape

One of 3 shapes:

  1. holder: "orchestrator"

    The orchestrator submits turns.

    FieldTypeDescription
    holderrequired"orchestrator"
  2. holder: "handover_pending"

    A person asked for control; the request waits for the turn boundary, and the orchestrator submits nothing more until control returns.

    FieldTypeDescription
    objective_satisfiedrequiredboolean
    holderrequired"handover_pending"
  3. holder: "human"

    A person holds the lease. Automatic submission is fenced; observation stays live.

    FieldTypeDescription
    objective_satisfiedrequiredboolean
    holderrequired"human"
Example
{
  "holder": "orchestrator"
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated .

Privacy choices

Choose which optional tools Koru may use on this site. Your choice is saved in a cookie in this browser for 12 months. Privacy policy

Privacy choices

Keep you signed in, protect forms and remember your language and this choice.

Always on

PostHog and Google Analytics 4 measure page views and actions such as downloads, using cookies or local storage.

PostHog records how pages are used, with form inputs masked and private pages excluded. Needs Analytics.

Ahrefs Web Analytics measures visits and where they come from, and Google Ads measures whether our ads led to a visit or download.