Skip to main content

Interface: CompiledExecutionGraph

Defined in: packages/agentos/src/orchestration/ir/types.ts:677

The fully compiled, execution-ready representation of an agent graph.

All three authoring APIs (AgentGraph builder, workflow DSL, mission planner) produce a CompiledExecutionGraph as their final compilation artefact. The runtime never interprets authoring-API-specific constructs — it operates exclusively on this type.

Properties​

checkpointPolicy​

checkpointPolicy: "none" | "every_node" | "explicit"

Defined in: packages/agentos/src/orchestration/ir/types.ts:705

Graph-wide default checkpoint persistence policy. Per-node GraphNode.checkpoint settings override this default.

  • every_node — persist after every node (safe, high storage cost).
  • explicit — persist only for nodes that declare checkpoint !== 'none'.
  • none — never persist (lowest overhead; no recovery on crash).

edges​

edges: GraphEdge[]

Defined in: packages/agentos/src/orchestration/ir/types.ts:685

All directed edges, including static entry/exit edges from/to START/END.

id​

id: string

Defined in: packages/agentos/src/orchestration/ir/types.ts:679

Stable, globally unique graph identifier (slug or UUIDv4).

memoryConsistency​

memoryConsistency: MemoryConsistencyMode

Defined in: packages/agentos/src/orchestration/ir/types.ts:707

Graph-wide memory consistency mode; may be overridden per-node via MemoryPolicy.consistency.

name​

name: string

Defined in: packages/agentos/src/orchestration/ir/types.ts:681

Human-readable display name.

nodes​

nodes: GraphNode[]

Defined in: packages/agentos/src/orchestration/ir/types.ts:683

All vertices, including any START/END bridge nodes inserted by the compiler.

reducers​

reducers: StateReducers

Defined in: packages/agentos/src/orchestration/ir/types.ts:696

Field-level reducer configuration applied after each node completes.

stateSchema​

stateSchema: object

Defined in: packages/agentos/src/orchestration/ir/types.ts:690

JSON-Schema-compatible schema declarations for the three GraphState generics. Used by the runtime for validation and by tooling for type generation.

artifacts​

artifacts: Record<string, unknown>

input​

input: Record<string, unknown>

scratch​

scratch: Record<string, unknown>