Rulvar API reference / @rulvar/core / ResumeHandle
Interface: ResumeHandle<R>
Defined in: packages/core/src/engine/engine.ts:727
Extends
RunHandle<R>
Type Parameters
| Type Parameter |
|---|
R |
Properties
| Property | Type | Description | Inherited from | Defined in |
|---|---|---|---|---|
events | AsyncIterable<WorkflowEvent> | - | RunHandle.events | packages/core/src/engine/run-handle.ts:492 |
preview | Promise<ResumePreview> | Resolves at settle with the replay accounting. | - | packages/core/src/engine/engine.ts:729 |
result | Promise<RunOutcome<R>> | - | RunHandle.result | packages/core/src/engine/run-handle.ts:491 |
runId | string | - | RunHandle.runId | packages/core/src/engine/run-handle.ts:490 |
Methods
cancel()
cancel(reason?): Promise<void>;Defined in: packages/core/src/engine/run-handle.ts:516
Cooperative cancellation; the run settles 'cancelled' with a complete CostReport.
Parameters
| Parameter | Type |
|---|---|
reason? | string |
Returns
Promise<void>
Inherited from
on()
on<T>(type, cb): () => void;Defined in: packages/core/src/engine/run-handle.ts:493
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:phase:start" | "agent:phase:end" | "agent:end" | "agent:error" | "quota:denied" | "budget:exposure-wait" | "agent:schema-retry" | "control:wire" | "agent:stream" | "tool:start" | "tool:end" | "determinism:warning" | "plan:revised" | "node:parked" | "node:cancelled" | "node:linked" | "orchestrator:woke" | "orchestrator:budget" | "orchestrator:acceptance" | "escalation:raised" | "escalation:decided" | "spawn:admitted" | "spawn:rejected" | "admission:lease-lost" | "verify:failed" | "ledger:op" | "stall:detected" | "guard:oscillation" | "resolution:applied" | "resolution:superseded" | "termination:debit" | "termination:denied" | "termination:config-drift" | "journal:compat" |
Parameters
| Parameter | Type |
|---|---|
type | T |
cb | (e) => void |
Returns
() => void
Inherited from
resolveExternal()
resolveExternal(key, value): Promise<ResolutionOutcome>;Defined in: packages/core/src/engine/run-handle.ts:503
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
| Parameter | Type |
|---|---|
key | string |
value | Json |
Returns
Promise<ResolutionOutcome>
Inherited from
revokeApproval()
revokeApproval(key, options): Promise<ApprovalRevocationOutcome>;Defined in: packages/core/src/engine/run-handle.ts:511
Revokes a tool approval (RV4008): a still-open approval is denied through the ordinary arbitration, and a RECORDED allow gains a journaled approval_revoked decision that beats it at the consumption recheck, so an allow granted, crashed over, and revoked never dispatches its tool on resume.
Parameters
| Parameter | Type |
|---|---|
key | string |
options | { principal: string; reason: string; } |
options.principal | string |
options.reason | string |
Returns
Promise<ApprovalRevocationOutcome>