Skip to content

PersistentAI API Documentation / @persistentai/fireflow-types / SPTreeExecutionEngine

Class: SPTreeExecutionEngine

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:38

SP-Tree Execution Engine

Replaces the superstep-based execution model with an SP-tree (Series-Parallel tree) execution plan. Independent chains run in parallel without barriers.

Same public API as DeterministicExecutionEngine — drop-in replacement.

See

docs/design/027-sp-tree-execution-engine.md

Constructors

Constructor

new SPTreeExecutionEngine(flow, context, options?, onBreakpointHit?): SPTreeExecutionEngine

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:45

Parameters

flow

Flow

context

ExecutionContext

options?

SPTreeExecutionOptions

onBreakpointHit?

(node) => void

Returns

SPTreeExecutionEngine

Methods

createEvent()

createEvent<T>(type, data): ExecutionEventImpl<T>

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:282

Type Parameters

T

T extends ExecutionEventEnum

Parameters

type

T

data

ExecutionEventData[T]

Returns

ExecutionEventImpl<T>


execute()

execute(onComplete?): Promise<void>

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:102

Main entry point — same signature as DeterministicExecutionEngine.

Parameters

onComplete?

(context, eventQueue) => Promise<void>

Returns

Promise<void>


getCompletedNodes()

getCompletedNodes(): Set<string>

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:278

Returns

Set<string>


getDebugger()

getDebugger(): DebuggerController | null

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:270

Returns

DebuggerController | null


getOptions()

getOptions(): SPTreeExecutionOptions | undefined

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:274

Returns

SPTreeExecutionOptions | undefined


on()

on<T>(type, handler): () => void

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:251

Type Parameters

T

T extends ExecutionEventEnum

Parameters

type

T

handler

(event) => void | Promise<void>

Returns

(): void

Returns

void


onAll()

onAll(handler): () => void

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:258

Parameters

handler

(event) => void | Promise<void>

Returns

(): void

Returns

void


setEventCallback()

setEventCallback(callback): void

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:262

Parameters

callback

(context) => Promise<void>

Returns

void


setOnEventPublished()

setOnEventPublished(hook): void

Defined in: packages/fireflow-types/src/flow/execution/sp-tree-engine.ts:266

Parameters

hook

(event) => Promise<void>

Returns

void

Licensed under BUSL-1.1