Rulvar API reference / @rulvar/core / IsolatedExecContext
Interface: IsolatedExecContext
Defined in: packages/core/src/l0/spi/executor.ts:29
The per-call context handed to a ToolExecutorProvider. It carries the tool span (so provider telemetry nests under the run tree), the cancellation signal, and a stable idempotency key.
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
agentType | string | - | packages/core/src/l0/spi/executor.ts:33 |
idempotencyKey | string | Stable identity of THIS logical tool call within THIS run incarnation: a deterministic function of the run, the logical invocation (the containing agent's journal seq plus the call's ordinal in that agent's tool loop), the tool name, the canonical arguments, and, for runs stamped with derivation 2 (RunMeta.execKeyDerivation; RV403), the run's generation token. A rerun of the same call after a mid-flight crash reuses the key, so a provider whose work has external side effects can fold an at-least-once retry into effectively-once; a different call, even with byte-identical arguments, never collides; and under derivation 2 a deleteRun-then-recreate of the same runId never reuses the deleted incarnation's keys. | packages/core/src/l0/spi/executor.ts:48 |
runId | string | - | packages/core/src/l0/spi/executor.ts:30 |
signal | AbortSignal | Fires on cancellation, a budget ceiling, or UsageLimits expiry. | packages/core/src/l0/spi/executor.ts:50 |
spanId | string | The tool span, minted under the agent span exactly like inprocess. | packages/core/src/l0/spi/executor.ts:32 |
Methods
log()
ts
log(
level,
msg,
data?): void;Defined in: packages/core/src/l0/spi/executor.ts:52
Emits telemetry log events under the tool span; never journals.
Parameters
| Parameter | Type |
|---|---|
level | "error" | "debug" | "info" | "warn" |
msg | string |
data? | Json |
Returns
void