Skip to main content

Interface: NodeExecutionResult

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:45

The normalised result returned by every NodeExecutor.execute() call regardless of which executor variant was dispatched.

The runtime inspects these fields to decide the next graph step:

  • success — whether the node completed without error.
  • output — arbitrary payload produced by the node (tool result, LLM response, etc.).
  • error — human-readable error message; only present when success is false.
  • routeTarget — next node id determined by a router or guardrail node.
  • scratchUpdate — partial object merged into GraphState.scratch by StateManager.
  • artifactsUpdate — partial object merged into GraphState.artifacts by StateManager.
  • events — additional GraphEvent values the executor wants the runtime to emit.
  • interrupt — when true, the runtime suspends the run and waits for human input.

Properties​

artifactsUpdate?​

optional artifactsUpdate: Record<string, unknown>

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:57

Partial update to merge into GraphState.artifacts.

error?​

optional error: string

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:51

Human-readable error description; populated only when success is false.

events?​

optional events: GraphEvent[]

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:59

Extra runtime events the executor wants to surface to callers.

expansionRequests?​

optional expansionRequests: object[]

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:61

Mission graph expansion requests emitted by this node's tool usage.

patch?​

optional patch: MissionGraphPatch

reason​

reason: string

request​

request: unknown

trigger​

trigger: MissionExpansionTrigger

interrupt?​

optional interrupt: boolean

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:68

When true, the runtime must suspend and await human resolution.

metadata?​

optional metadata: NodeTelemetry

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:74

Optional per-executor telemetry surfaced on the node_end event. Populated today by the GMI executor (iteration / tool-call counters); other executors leave it undefined.

output?​

optional output: unknown

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:49

Arbitrary output produced by the node.

routeTarget?​

optional routeTarget: string

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:53

Target node id returned by router or guardrail rerouting.

scratchUpdate?​

optional scratchUpdate: Record<string, unknown>

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:55

Partial update to merge into GraphState.scratch.

success​

success: boolean

Defined in: packages/agentos/src/orchestration/runtime/NodeExecutor.ts:47

Whether the node completed successfully.