Interface SandboxExecutionRequest

Input to the sandbox executor for running a single sandboxed tool invocation.

interface SandboxExecutionRequest {
    code: string;
    input: unknown;
    allowlist: AllowlistName[];
    memoryMB: number;
    timeoutMs: number;
    call?: CallHandle;
}

Properties

code: string

Source code of the sandboxed module (same format as SandboxedToolSpec.code).

input: unknown

The argument object passed to the run(input) entry point.

allowlist: AllowlistName[]

APIs the sandbox is permitted to call. Anything not listed is blocked.

memoryMB: number

Nominal heap budget in megabytes for the sandbox execution. The current node:vm-backed JavaScript executor reports heap deltas but does not preemptively enforce this limit.

Default

128
timeoutMs: number

Maximum wall-clock time in milliseconds before the sandbox is forcibly killed and an error is returned.

Default

5000
call?: CallHandle

The run's handle. Required when the forge has a broker attached (a host with EmergentConfig.capabilities); the engine fills it.