RunResult

RunResult<Out> = { lineage: RuntimeLineage; ok: true; value: Out; } | { failures: Failure[]; lineage: RuntimeLineage; ok: false; }

Defined in: execution/result.ts:35

Result of executing a plan.

A discriminated union with two variants:

• Success (ok: true): Contains the output value
• Failure (ok: false): Contains an array of failures

Both variants include lineage for debugging and provenance tracking.

Type Parameters

Out

Out

The output type of the plan

Type Declaration

{ lineage: RuntimeLineage; ok: true; value: Out; }

lineage

lineage: RuntimeLineage

Execution trace for debugging and provenance

ok

ok: true

Indicates successful execution

value

value: Out

The computed output value

{ failures: Failure[]; lineage: RuntimeLineage; ok: false; }

failures

failures: Failure[]

Array of failures that occurred (usually one, first failure aborts)

lineage

lineage: RuntimeLineage

Partial execution trace up to the failure point

ok

ok: false

Indicates failed execution

Example

const result = await run(plan, ctx)

if (result.ok) {
  console.log('Success:', result.value)
} else {
  console.log('Failed:', result.failures)
}

// Lineage is always available for debugging
console.log('Steps:', result.lineage.nodes.size)