ReadonlyalarmAbsolute due-time (epoch ms) of the process's pending alarm, or null when none is scheduled.
A host that suspends the process between turns (a Durable Object) mirrors this onto its own
scheduler, since the runtime's alarm is an in-memory timer.
ReadonlycompletedUNIX timestamp in milliseconds.
ReadonlyenvironmentWhat the process is running on behalf of. See Environment.
ReadonlyerrorHow the process failed as a serializable SerializedError (its context carries any
structured detail, e.g. a notify override), or null unless it is in FAILED state.
ReadonlykeyKey of the process.
NOTE: There might be multiple running processes with the same key.
ReadonlymetricsReadonlyinputCount: numberTotal number of inputs submitted to the process.
ReadonlyoutputCount: numberTotal number of outputs submitted to the process.
ReadonlywallTime: numberTotal wall time of all handler invocations of the process in milliseconds.
ReadonlyparamsParameters of the process.
ReadonlyparentReadonlypidReadonlyrpcReadonlystartedUNIX timestamp in milliseconds.
ReadonlystateState of the process.
ReadonlystatusSubmits each input in order, then streams outputs until the process reaches State.IDLE or State.SUCCEEDED. While State.HYBERNATING, keeps waiting for outputs or a terminal state. The stream fails with a defect if the process reaches State.FAILED or State.TERMINATED.
Resolves when the process reaches State.IDLE (nothing in-flight; waiting for input), or a terminal state (State.SUCCEEDED, State.TERMINATED, State.FAILED).
Does not resolve while the process is State.HYBERNATING (e.g. alarm pending or non-terminal child). The effect keeps waiting until that external work finishes and the process becomes idle or terminal.
If the process fails, this effect throws a defect.
Resolves when the process settles its current foreground turn: State.IDLE or State.SUCCEEDED, or State.HYBERNATING with no pending alarm (i.e. only background children remain in flight).
Unlike runToCompletion, this does NOT wait for background children (e.g. delegated sub-agents) to finish — so a supervisor's chat turn returns as soon as its reply is complete, while sub-agents continue running and report back out of band. Still waits through alarm-pending hybernation (more queued turn work). Defects on State.FAILED.
Subscribe to ephemeral trace messages for this process. Replays buffered events, then streams new ones as they arrive. The stream completes when the process reaches a terminal state.
When consuming this stream from a short-lived parent effect (e.g. React
useEffect that runPromise(Effect.forEach(subscribe)) and returns), fork
the collector with Effect.forkDetach, not Effect.forkChild — the
parent scope closes as soon as forEach finishes and interrupts scoped forks
before live pushEphemeral events arrive. Interrupt the daemon fiber explicitly
on dispose.
Optionaloptions: SubscribeEphemeralOptions
A process: one running (or finished) instance of a durable operation, wherever its runtime runs.
Its Data fields are plain values; the rest are live members that talk to the runtime. A process read from a tree or list is a cheap snapshot that reaches its runtime only once a live member is used (see make).