Sandbox Tools

import os
from polos import (
    Agent, max_steps, MaxStepsConfig,
    sandbox_tools, SandboxToolsConfig, DockerEnvironmentConfig,
)

# Workspace directory on the host -- gets mounted into the container at /workspace
workspace_dir = os.path.join(os.path.dirname(os.path.abspath(__file__)), "workspace")

# Create sandbox tools that run inside a Docker container
tools = sandbox_tools(
    SandboxToolsConfig(
        env="docker",
        docker=DockerEnvironmentConfig(
            image="node:20-slim",
            workspace_dir=workspace_dir,
            # setup_command="npm install",  # optional: run after container creation
            # memory="512m",               # optional: limit container memory
            # network="none",              # default: no network access
        ),
    )
)

import { defineAgent, maxSteps, sandboxTools } from '@polos/sdk';
import { anthropic } from '@ai-sdk/anthropic';
import path from 'node:path';

// Workspace directory on the host — this gets mounted into the container at /workspace
const workspaceDir = path.resolve(process.cwd(), 'workspace');

// Create sandbox tools that run inside a Docker container
export const tools = sandboxTools({
  env: 'docker',
  docker: {
    image: 'node:20-slim',
    workspaceDir,
    // setupCommand: 'npm install',  // optional: run after container creation
    // memory: '512m',               // optional: limit container memory
    // network: 'none',              // optional: no network access
  },
});

coding_agent = Agent(
    id="coding_agent",
    provider="anthropic",
    model="claude-sonnet-4-5",
    system_prompt=(
        "You are a coding agent with access to a sandbox environment. "
        "You can create files, edit code, run shell commands, and search the codebase. "
        "The workspace is at /workspace inside the container. "
        "Use the tools to complete the task, then summarize what you did and show the output. "
        "Always verify your work by running the code after writing it. "
        "In your final response, include the actual output from running the code."
    ),
    tools=tools,
    stop_conditions=[max_steps(MaxStepsConfig(count=50))],
)

export const codingAgent = defineAgent({
  id: 'coding_agent',
  model: anthropic('claude-sonnet-4-5'),
  systemPrompt:
    'You are a coding agent with access to a sandbox environment. ' +
    'You can create files, edit code, run shell commands, and search the codebase. ' +
    'The workspace is at /workspace inside the container. ' +
    'Use the tools to complete the task, then summarize what you did and show the output. ' +
    'Always verify your work by running the code after writing it. ' +
    'In your final response, include the actual output from running the code.',
  tools,
  stopConditions: [maxSteps({ count: 50 })],
});

from polos import Polos
from polos.features import events

handle = await polos.invoke(
    coding_agent.id, {"input": task, "conversationId": conversation_id, "streaming": True}
)

async for event in events.stream_workflow(polos, handle.root_workflow_id, handle.id):
    if event.event_type == "text_delta":
        content = event.data.get("content") if isinstance(event.data, dict) else None
        if isinstance(content, str):
            print(content, end="", flush=True)
    elif event.event_type == "tool_call":
        tool_call = event.data.get("tool_call", {}) if isinstance(event.data, dict) else {}
        tool_name = tool_call.get("function", {}).get("name", "unknown")
        print(f"\n  [Using {tool_name}...]")

const handle = await polos.invoke(
  codingAgent.id, { input: task, conversationId, streaming: true }
);

for await (const event of polos.events.streamWorkflow(handle.rootWorkflowId, handle.id)) {
  if (event.eventType === 'text_delta') {
    const content = (event.data as Record<string, unknown>)['content'];
    if (typeof content === 'string') {
      process.stdout.write(content);
    }
  } else if (event.eventType === 'tool_call') {
    const toolCall = (event.data as Record<string, unknown>)['tool_call'] as Record<string, unknown> | undefined;
    const fn = toolCall?.['function'] as Record<string, unknown> | undefined;
    console.log(`\n  [Using ${String(fn?.['name'] ?? 'unknown')}...]`);
  }
}

git clone https://github.com/polos-dev/polos.git
cd polos/python-examples/18-sandbox-tools
cp .env.example .env  # Add your POLOS_PROJECT_ID and API key
uv sync
python main.py

git clone https://github.com/polos-dev/polos.git
cd polos/typescript-examples/18-sandbox-tools
cp .env.example .env  # Add your POLOS_PROJECT_ID and API key
npm install
npx tsx main.ts