Interface SandboxedToolForgeConfig

Configuration options for the SandboxedToolForge.

All fields are optional and fall back to sensible defaults.

interface SandboxedToolForgeConfig {
    memoryMB?: number;
    executor?: ForgedCodeExecutor;
    timeoutMs?: number;
    fetchDomainAllowlist?: string[];
    fsReadRoots?: string[];
}

Properties

memoryMB? executor? timeoutMs? fetchDomainAllowlist? fsReadRoots?

Properties

Optional memoryMB

memoryMB?: number

Memory budget in megabytes, handed to the executor with each call. The in-process executor reports the memory used and does not limit it; an executor that can limit memory uses it as the limit.

Default

128

Optional executor

executor?: ForgedCodeExecutor

What runs forged code. Defaults to an InProcessExecutor (node:vm inside this process; isolates: false).

Optional timeoutMs

timeoutMs?: number

Maximum wall-clock execution time in milliseconds.

Default

5000

Optional fetchDomainAllowlist

fetchDomainAllowlist?: string[]

When fetch is in the allowlist, only requests to these domains are permitted. An empty array means all domains are allowed. Domain matching is case-insensitive and checks exact host equality.

Default

[]

Optional fsReadRoots

fsReadRoots?: string[]

Filesystem roots sandboxed fs.readFile calls may access. Relative paths are resolved from the current working directory. Defaults to the current working directory only.

Settings

Member Visibility

Theme

On This Page

memoryMBexecutortimeoutMsfetchDomainAllowlistfsReadRoots