Skip to content

rulvar API reference


rulvar API reference / @rulvar/rulvar / ResumeHandle

Interface: ResumeHandle<R>

Defined in: packages/core/dist/index.d.ts

Extends

Type Parameters

Type Parameter
R

Properties

PropertyTypeDescriptionInherited fromDefined in
eventsAsyncIterable<WorkflowEvent>-RunHandle.eventspackages/core/dist/index.d.ts
previewPromise<ResumePreview>Resolves at settle with the replay accounting.-packages/core/dist/index.d.ts
resultPromise<RunOutcome<R>>-RunHandle.resultpackages/core/dist/index.d.ts
runIdstring-RunHandle.runIdpackages/core/dist/index.d.ts

Methods

cancel()

ts
cancel(reason?): Promise<void>;

Defined in: packages/core/dist/index.d.ts

Cooperative cancellation; the run settles 'cancelled' with a complete CostReport.

Parameters

ParameterType
reason?string

Returns

Promise&lt;void&gt;

Inherited from

RunHandle.cancel


on()

ts
on<T>(type, cb): () => void;

Defined in: packages/core/dist/index.d.ts

Type Parameters

Type Parameter
T extends | "run:start" | "run:end" | "phase:start" | "log" | "budget:update" | "external:waiting" | "approval:pending" | "child:start" | "child:end" | "agent:queued" | "agent:start" | "agent:end" | "agent:error" | "agent:schema-retry" | "agent:stream" | "tool:start" | "tool:end" | "plan:revised" | "node:parked" | "node:cancelled" | "node:linked" | "orchestrator:woke" | "orchestrator:budget" | "escalation:raised" | "escalation:decided" | "spawn:admitted" | "spawn:rejected" | "verify:failed" | "ledger:op" | "stall:detected" | "guard:oscillation" | "resolution:applied" | "resolution:superseded" | "termination:debit" | "termination:denied" | "termination:config-drift" | "journal:compat"

Parameters

ParameterType
typeT
cb(e) => void

Returns

() => void

Inherited from

RunHandle.on


resolveExternal()

ts
resolveExternal(key, value): Promise<ResolutionOutcome>;

Defined in: packages/core/dist/index.d.ts

Resolves an open awaitExternal suspension (DEF-4 signature): applied when this attempt wins the first-closing-wins fold; repeated resolution is defined behavior, not an error. An invalid live payload throws InvalidResolutionError and journals nothing.

Parameters

ParameterType
keystring
valueJson

Returns

Promise&lt;ResolutionOutcome&gt;

Inherited from

RunHandle.resolveExternal