Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/core / IsolatedExecRequest

Interface: IsolatedExecRequest

Defined in: packages/core/src/l0/spi/executor.ts:56

One out-of-process tool dispatch.

Properties

PropertyTypeDescriptionDefined in
argsJsonThe validated arguments, after the permission chain rewrote them.packages/core/src/l0/spi/executor.ts:62
ctxIsolatedExecContext-packages/core/src/l0/spi/executor.ts:81
cwd?stringThe acquired worktree's host directory (RV4914), present EXACTLY when the dispatching agent runs under worktree isolation and absent under 'none' and 'readonly', so a request without one is byte identical to what it was. The reference executors run the tool inside it: the subprocess child starts there, and the container executor bind mounts it as the work mount beside the ephemeral scratch mount, so the tool's writes land in the tree the patch is collected from instead of a directory removed after the call.packages/core/src/l0/spi/executor.ts:80
executorIsolatedExecutorTagThe declared executor tag ('subprocess''container').
specJsonThe tool's executorSpec: opaque host data telling THIS provider what to run (for a subprocess adapter, the command and its argv). Never identity; the engine passes it through verbatim.packages/core/src/l0/spi/executor.ts:68
toolstringThe tool contract name.packages/core/src/l0/spi/executor.ts:60