Rulvar API reference

---

Rulvar API reference / @rulvar/rulvar / IsolatedExecContext

Interface: IsolatedExecContext

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

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/dist/index.d.ts
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/dist/index.d.ts
runId	string	-	packages/core/dist/index.d.ts
signal	AbortSignal	Fires on cancellation, a budget ceiling, or UsageLimits expiry.	packages/core/dist/index.d.ts
spanId	string	The tool span, minted under the agent span exactly like inprocess.	packages/core/dist/index.d.ts

Methods

log()

log(
   level, 
   msg, 
   data?): void;

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

Emits telemetry log events under the tool span; never journals.

Parameters

Parameter	Type
level	"error" | "debug" | "info" | "warn"
msg	string
data?	Json

Returns

void