Function sandbox_create

python/vibe-coding-ide/backend/src/agent/tools/sandbox.py:42–198

Create a persistent sandbox and remember it for this run. Args: runtime: Optional runtime, e.g. "node22", "python3.13". ports: Optional list of ports to expose (for previews). timeout_ms: Sandbox lifetime timeout in milliseconds. Returns: JSON with sandbox de

(
    ctx: RunContextWrapper[IDEContext],
    runtime: str | None = None,
    ports: list[int] | None = None,
    timeout_ms: int | None = 600_000,
    name: str | None = None,
)

@function_tool
async def sandbox_create(
    ctx: RunContextWrapper[IDEContext],
    runtime: str | None = None,
    ports: list[int] | None = None,
    timeout_ms: int | None = 600_000,
    name: str | None = None,
) -> str:
    """Create a persistent sandbox and remember it for this run.

    Args:
        runtime: Optional runtime, e.g. "node22", "python3.13".
        ports: Optional list of ports to expose (for previews).
        timeout_ms: Sandbox lifetime timeout in milliseconds.
    Returns:
        JSON with sandbox details.
    """
    tool_id = f"tc_{len(ctx.context.events) + 1}"
    args = {"runtime": runtime, "ports": ports, "timeout_ms": timeout_ms, "name": name}
    ctx.context.events.append(
        {
            "phase": "started",
            "tool_id": tool_id,
            "name": "sandbox_create",
            "arguments": args,
        }
    )

    sb_name = normalize_sandbox_name(ctx, name)

    # Synthetic runtimes: if a Ruby or Go runtime is requested, create on a Node runtime and bootstrap
    requested_runtime = runtime
    is_synthetic_ruby = bool(
        requested_runtime and str(requested_runtime).lower().startswith("ruby")
    )
    is_synthetic_go = bool(
        requested_runtime and str(requested_runtime).lower().startswith("go")
    )
    effective_runtime = requested_runtime
    if is_synthetic_ruby or is_synthetic_go:
        # Default to node22 as the base image for bootstrapping
        effective_runtime = "node22"

    sandbox = await Sandbox.create(
        timeout=timeout_ms or 600_000,
        runtime=effective_runtime,
        ports=ports,
    )
    # Map and set active sandbox
    ctx.context.sandbox_name_to_id[sb_name] = sandbox.sandbox_id
    ctx.context.active_sandbox = sb_name
    # Persist preferences per-sandbox
    if requested_runtime or effective_runtime:
        ctx.context.sandbox_runtime_map[sb_name] = (
            requested_runtime or effective_runtime
        )  # type: ignore[arg-type]
    if ports is not None:
        ctx.context.sandbox_ports_map[sb_name] = ports