ActionWalkWithParallel
Interface: ActionWalkWithParallel
Defined in: src/action/walk.ts:169
The factory's extended surface. Existing structural ActionWalk values remain valid without implementing the new operation.
Extends
Properties
ref
readonlyref:ActionWalkRef
Defined in: src/action/walk.ts:133
Inherited from
Methods
interrupt()
interrupt(
input):boolean
Defined in: src/action/walk.ts:158
Stop this walk's plan at the next step boundary, with the reason on the record. Arms the walk: consumed by the plan in flight before its next step, or by the next run() at step zero — the person's intent stands either way. Returns false when already armed. The reason is REQUIRED: a silent break is the abandonment this family refuses.
Parameters
input
by
reason
string
Returns
boolean
Inherited from
parallel()
parallel(
steps,options?):Promise<ActionPlanManifest>
Defined in: src/action/walk.ts:175
Run caller-selected independent actions with bounded asynchronous overlap. Admission failures throw before dispatch. Individual refusals/failures do not stop independent queued items; interruption stops only undispatched items and waits for running handlers. Completion concerns whenInvoked, never automatic effect verification.
Parameters
steps
readonly ActionParallelStep[]
options?
concurrency?
number
Defaults to the number of items. Must be a positive safe integer.
onRow?
(row) => void
Completion order; the final manifest retains input order.
Returns
Promise<ActionPlanManifest>
record()
record():
object
Defined in: src/action/walk.ts:161
Every manifest this walk has produced, in order — the route actually taken, which is not the route anybody planned.
Returns
object
manifests
readonlymanifests: readonlyActionPlanManifest[]
ref
readonlyref:ActionWalkRef
Inherited from
run()
run(
steps,options?):Promise<ActionPlanManifest>
Defined in: src/action/walk.ts:140
Admit and execute one plan. Admission failures THROW before anything runs — nothing happened, so an exception is honest. Execution failures never throw: they are manifest rows, because by then something DID happen and the caller needs the ledger, not a stack trace.
Parameters
steps
readonly ActionPlanStep[]
options?
onRow?
(row) => void
Called as each row lands — the FE's live loop: render the batch step by step, and put the stop control beside it, because the moment you can SEE a batch running is the moment you need to be able to stop it. Isolated: a listener that throws never breaks the walk (the recorder law, applied here).
Returns
Promise<ActionPlanManifest>