sandbox_run

Execute code in an isolated container with no network or host access. Task files live in /workspace; Python includes pandas, matplotlib, Pillow, pypdf, openpyxl. Node and ffmpeg are available. Files persist between calls. Operations can run up to 300 seconds; this is a process resource limit, not a task budget. Export large work in parts. Use sandbox_import for attached files and sandbox_publish to deliver an output.

User guide / All capabilities

Contract

Effect: read. Evidence role: discovery_only.

Run isolated code.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "python",
        "javascript",
        "shell"
      ]
    },
    "code": {
      "type": "string"
    },
    "timeout_ms": {
      "type": "number",
      "description": "100–300000 milliseconds; default 60000."
    }
  },
  "required": [
    "language",
    "code"
  ]
}

Execution requirements

The ordinary admission and tool execution checks apply.

Expected postconditions

Inspect the returned status, summary and data; do not infer success from a tool call alone.