types

Module: vibex/types

Execution Types (Internal)

These types support the internal execution engine. They are NOT part of the user-facing API. Users work with Mission → Plan → Task.

The execution engine uses these types to:

Track execution state
Support complex execution patterns (parallel, conditional)
Enable pause/resume of long-running operations

Note: “steps” in AI SDK refers to multi-turn tool execution loops. Our “ExecutionNode” is different - it’s an internal graph node.

Interfaces

ExecutionContext

View source

Execution context - runtime state for an execution

Properties:

Name	Type	Description
`id`	`string`
`missionId`	`string`
`taskId`	`string`	(optional)
`variables`	`Record<string, unknown>`
`history`	`unknown[]`
`currentNodeId`	`string`	(optional)
`status`	`ExecutionStatus`
`input`	`unknown`
`output`	`unknown`	(optional)
`error`	`unknown`	(optional)

ExecutionNode

View source

Base execution node (internal)

Properties:

Name	Type	Description
`id`	`string`
`type`	`ExecutionNodeType`
`name`	`string`
`description`	`string`	(optional)
`next`	`string \| string[]`	(optional)
`config`	`unknown`	(optional)
`metadata`	`Record<string, unknown>`	(optional)

AgentExecutionNode

View source

Agent execution node

Properties:

Name	Type	Description
`type`	`"agent"`
`config`	`object`

ToolExecutionNode

View source

Tool execution node

Properties:

Name	Type	Description
`type`	`"tool"`
`config`	`\{ toolName: string; arguments: Record<string, unknown>; \}`

ConditionNode

View source

Condition node for branching

Properties:

Name	Type	Description
`type`	`"condition"`
`config`	`\{ expression: string; yes: string; no: string; \}`

HumanInputNode

View source

Human input node (pause for user)

Properties:

Name	Type	Description
`type`	`"human_input"`
`config`	`object`

ParallelNode

View source

Parallel execution node

Properties:

Name	Type	Description
`type`	`"parallel"`
`config`	`\{ branches: string[]; mode: "wait_all" \| "race"; \}`

ExecutionGraph

View source

Execution graph (internal representation)

Properties:

Name	Type	Description
`id`	`string`
`name`	`string`
`description`	`string`	(optional)
`nodes`	`ExecutionNode[]`
`variables`	`Record<string, unknown>`	(optional)
`metadata`	`Record<string, unknown>`	(optional)

ExecutionNodeResult

View source

Result of executing a single node

Properties:

Name	Type	Description
`nodeId`	`string`
`status`	`"completed" \| "failed" \| "skipped"`
`output`	`unknown`	(optional)
`error`	`unknown`	(optional)
`startTime`	`Date`
`endTime`	`Date`
`logs`	`string[]`	(optional)

Types

ExecutionStatus

View source


type ExecutionStatus = | "pending"
  | "running"
  | "paused"
  | "completed"
  | "failed"
  | "cancelled"

ExecutionNodeType

View source

Node types in the execution graph


type ExecutionNodeType = | "start"
  | "end"
  | "agent"
  | "tool"
  | "condition"
  | "human_input"
  | "parallel"

WorkflowStatus

View source


type WorkflowStatus = ExecutionStatus

WorkflowContext

View source


type WorkflowContext = ExecutionContext

WorkflowStep

View source


type WorkflowStep = ExecutionNode

Workflow

View source


type Workflow = ExecutionGraph

ExecutionStepResult

View source


type ExecutionStepResult = ExecutionNodeResult