Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/rulvar / progress

Function: progress()

ts
function progress(source, options?): ProgressHandle;

Defined in: packages/rulvar/src/live-progress.ts:774

Attaches a live progress view to a run and returns its handle. Accepts a RunHandle (subscribes through on(), leaving handle.events free for the host, and enriches the final frame from RunOutcome.cost; orchestrate returns exactly such a handle, so progress(orchestrate(...)) composes directly), a promise resolving to a handle (for wrappers that construct one asynchronously), or a raw WorkflowEvent iterable (the gapless path for resumes: progress(resumed.events); note it consumes that one-shot iterable). The view auto-stops when the run settles.

Parameters

ParameterType
sourceProgressSource
options?ProgressOptions

Returns

ProgressHandle