Planning
PreviewTurning an objective into a revisable step graph with dependencies and verification contracts.
The planner converts an objective into a directed graph of steps. Plans are not fixed at creation: new evidence can add, remove, reorder or replace steps mid-run.
Plan structure#
{
class="tok-str">"id": class="tok-str">"plan_3ka81",
class="tok-str">"revision": class="tok-num">2,
class="tok-str">"strategy": class="tok-str">"investigate-then-act",
class="tok-str">"steps": [
{
class="tok-str">"id": class="tok-str">"s3",
class="tok-str">"title": class="tok-str">"Benchmark ingest throughput",
class="tok-str">"kind": class="tok-str">"tool",
class="tok-str">"tool": class="tok-str">"sandbox.exec",
class="tok-str">"depends_on": [class="tok-str">"s1", class="tok-str">"s2"],
class="tok-str">"parallelizable": true,
class="tok-str">"verify": { class="tok-str">"check": class="tok-str">"numeric_reproducible", class="tok-str">"tolerance": class="tok-num">0.05 },
class="tok-str">"budget": { class="tok-str">"wall_clock_seconds": class="tok-num">300 }
}
],
class="tok-str">"revisions": [
{ class="tok-str">"at": class="tok-str">"class="tok-num">00:class="tok-num">04:class="tok-num">12", class="tok-str">"reason": class="tok-str">"source contradiction on license terms", class="tok-str">"added": [class="tok-str">"s7"] }
]
}Step kinds#
reasonstep- A pure deliberation step. Produces analysis, hypotheses or a decision. No external effect.
toolstep- A single tool invocation with typed arguments. See Tool Calling.
researchstep- A scoped investigation delegated to the research subsystem.
delegatestep- Hand-off to a specialized sub-agent with a narrowed capability set.
verifystep- An explicit check whose failure blocks downstream steps.
approvestep- A pause point requiring a human decision before continuing.
Replanning triggers#
Last updated 2026-09-07