Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/core / ToolExecutorProvider

Interface: ToolExecutorProvider ​

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

The isolated tool executor seam. A provider runs one dispatch to its JSON result. A thrown error becomes the call's error tool result, never a run abort: an executor failure (non-zero exit, timeout kill, unparseable output, infrastructure error) is surfaced to the model exactly like any other tool error, so the loop can react and the run stays durable.

Methods ​

describeRegulatedPosture()? ​

ts
optional describeRegulatedPosture(): RegulatedPostureDescriptor;

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

The construction-side posture attestation (RV4204): a PURE snapshot of what the executor chose at construction (ledger, env allowlist, ceilings, isolation seam), read by compileRegulatedProfile and folded into the hashed posture map; see the regulated-posture module.

Returns ​

RegulatedPostureDescriptor


run() ​

ts
run(request): Promise<Json>;

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

Runs one dispatch to its JSON result; throws to signal tool failure.

Parameters ​

ParameterType
requestIsolatedExecRequest

Returns ​

Promise&lt;Json&gt;