Filter 14: code_interpreter

[leseb]

Purpose

Execute code in a sandboxed container environment. Return stdout/stderr and generated files.

Status: Future — not part of the MVP filter set. Part of the OpenAI Responses API spec.

Behavior

• Receive code from model's tool call
• Spin up sandboxed container (or reuse existing session)
• Execute code with timeout and resource limits
• Capture stdout, stderr, and any generated files
• Emit code_interpreter_call.in_progress, code_interpreter_call.interpreting, code_interpreter_call.completed events
• Return execution results + file outputs as tool result message

Request parameters

• type: "code_interpreter"
• container: container/sandbox configuration (image, resources, timeout)
• allowed_languages: optional list of permitted languages

Config

filter: code_interpreter
runtime: docker  # docker | kata | firecracker | wasm
default_image: python:3.12-slim
timeout_seconds: 30
max_memory_mb: 512
max_cpu_cores: 1
sandbox_network: none  # none | restricted | full

Dependencies

• Container runtime

Reference

• Proposal: Responses API Filters — Filter 14
• Part of Epic: Responses API and Agentic Loop Orchestration #93