Class TopologyRecorder

constructor

• new TopologyRecorder(options?: TopologyRecorderOptions): TopologyRecorder

  Parameters

  • options: TopologyRecorderOptions = {}

  Returns TopologyRecorder

Readonlyid

clear

• clear(): void

  Called by the executor before each run() — resets all state.

  Returns void

getByKind

• getByKind(kind: TopologyNodeKind): TopologyNode[]

  All nodes of a given kind.

  Parameters

  • kind: TopologyNodeKind

  Returns TopologyNode[]

getChildren

• getChildren(nodeId: string): TopologyNode[]

  Direct children of a node — insertion-ordered.

  Parameters

  • nodeId: string

  Returns TopologyNode[]

getParallelSiblings

• getParallelSiblings(nodeId: string): TopologyNode[]

  All fork-branch nodes sharing the same parent as nodeId — i.e., parallel siblings of a parallel branch. Empty if nodeId isn't a fork-branch or has no parent.

  Parameters

  • nodeId: string

  Returns TopologyNode[]

getSubflowNodes

• getSubflowNodes(): TopologyNode[]

  All mounted subflow nodes. Convenience for agent-centric views.

  Returns TopologyNode[]

getTopology

• getTopology(): Topology

  Live snapshot of the composition graph. Safe during or after a run.

  Returns Topology

onAttempt

• onAttempt(event: FlowAttemptEvent): void

  Called at the end of EVERY attempt — a stage's own, and the calls and observed attempts it makes during the stage (filter on record.kind) — with its record and the decision that followed (10.1). See FlowAttemptEvent.

  Parameters

  • event: FlowAttemptEvent

  Returns void

onDecision

• onDecision(event: FlowDecisionEvent): void

  Parameters

  • event: FlowDecisionEvent

  Returns void

onFork

• onFork(event: FlowForkEvent): void

  Parameters

  • event: FlowForkEvent

  Returns void

onLoop

• onLoop(event: FlowLoopEvent): void

  Parameters

  • event: FlowLoopEvent

  Returns void

onSubflowEntry

• onSubflowEntry(event: FlowSubflowEvent): void

  Parameters

  • event: FlowSubflowEvent

  Returns void

onSubflowExit

• onSubflowExit(event: FlowSubflowEvent): void

  Parameters

  • event: FlowSubflowEvent

  Returns void

toSnapshot

• toSnapshot(): {
      data: Topology;
      description: string;
      name: string;
      preferredOperation: "translate";
  }

  Emit a snapshot bundle for inclusion in executor.getSnapshot().

  Returns {
      data: Topology;
      description: string;
      name: string;
      preferredOperation: "translate";
  }