Skip to main content

Interface: GraphNode

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

A single vertex in the compiled execution graph.

Nodes are immutable once compiled; all runtime state lives in GraphState.

Properties​

checkpoint​

checkpoint: "both" | "none" | "before" | "after"

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

When the runtime should persist a checkpoint snapshot.

  • before — snapshot taken before executor runs (enables re-entry on crash).
  • after — snapshot taken after executor succeeds.
  • both — snapshot taken at both points.
  • none — no snapshot for this node.

complexity?​

optional complexity: number

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

Optional planner-estimated node complexity (0-1).

discoveryPolicy?​

optional discoveryPolicy: DiscoveryPolicy

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

Dynamic capability discovery configuration applied before execution.

effectClass​

effectClass: EffectClass

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

Classifies the side-effects this node may produce.

executionMode​

executionMode: NodeExecutionMode

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

Controls the LLM turn budget for this node.

executorConfig​

executorConfig: NodeExecutorConfig

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

Full executor configuration; discriminated union determines runtime strategy.

guardrailPolicy?​

optional guardrailPolicy: GuardrailPolicy

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

Declarative guardrails evaluated on input and/or output payloads.

id​

id: string

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

Unique identifier within the parent CompiledExecutionGraph. Must not equal START or END.

inputSchema?​

optional inputSchema: Record<string, unknown>

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

JSON-Schema-compatible description of the expected input shape.

llm?​

optional llm: NodeLlmConfig

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

Optional per-node LLM provider/model override.

memoryPolicy?​

optional memoryPolicy: MemoryPolicy

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

Memory read/write configuration applied by the runtime around execution.

metadata?​

optional metadata: Record<string, unknown>

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

Optional builder-supplied metadata.

The runtime currently consumes one well-known key:

  • outputAs: string — when present, the node's successful output is promoted into state.artifacts[outputAs] after execution. When absent, the node's output is promoted into state.artifacts[id] by default. Any executor that explicitly sets result.artifactsUpdate takes precedence over either default.

Builders are free to attach additional opaque keys for tooling.

outputSchema?​

optional outputSchema: Record<string, unknown>

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

JSON-Schema-compatible description of the expected output shape.

personaPolicy?​

optional personaPolicy: PersonaPolicy

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

Persona layer configuration injected into the prompt context.

retryPolicy?​

optional retryPolicy: RetryPolicy

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

Automatic retry configuration for transient failures.

timeout?​

optional timeout: number

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

Maximum wall-clock execution time in milliseconds before the node is aborted.

type​

type: "tool" | "extension" | "voice" | "gmi" | "human" | "guardrail" | "router" | "subgraph"

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

Coarse type label kept in sync with executorConfig.type for fast switching.