Type parameter threaded from the parent AgentGraph.
Compiled execution graph IR produced by GraphCompiler.
Persistence backend for checkpoint snapshots.
Execute the graph to completion and return the final artifacts payload.
This is the simplest execution mode — it buffers all events internally and returns
only the terminal output. Use stream() when you need real-time progress updates.
Initial user-provided input frozen into GraphState.input.
The GraphState.artifacts value after the last node completes.
Execute the graph while yielding GraphEvent values at each significant step.
Events are emitted in strict causal order:
run_start → (node_start → node_end → edge_transition?)+ → run_end
Initial user-provided input frozen into GraphState.input.
Runtime events in causal order.
Resume a previously interrupted run from its latest persisted checkpoint.
The patch argument is accepted for API compatibility with future resume-with-patch
support; it is not forwarded to the runtime in the current implementation.
Either the original run id or an exact checkpoint id.
Optional patch: Partial<TState>Reserved for future use: optional partial state override.
The final GraphState.artifacts value after resumption completes.
When no checkpoint exists for the given identifier.
Inspect execution state for a completed or in-progress run.
The unique run identifier assigned at stream() call-time.
A stub object — full inspection support is tracked separately.
Full runtime inspection is not implemented yet; this currently returns a stub object until the run-registry subsystem lands.
Return the underlying CompiledExecutionGraph IR.
Useful for serialisation, debugging, or forwarding to external tooling.
A compiled, execution-ready agent graph.
Returned by
AgentGraph.compile()— do not instantiate directly.Wraps a
CompiledExecutionGraphIR object and aGraphRuntimeinstance, exposing the three execution modes: synchronousinvoke(), streamingstream(), and checkpoint-basedresume().