The sandbox starts empty — specify ALL needed packages in dependencies.
For data analysis, always include pandas and numpy.

Args:
    language: Sandbox language/runtime. Use "python", "node", or "r".
    dependencies: Packages to pre-install. Keys are package names,
        values are version strings (use "" for latest). Always use strings,
        never numbers — e.g. "2.2" not 2.2. Null/None is treated as "".
        Example: {"pandas": "", "numpy": "1.26", "matplotlib": "3.9.0"}.

Returns:
    JSON with session_id and session info.

Args:
    session_id: ID returned by create_session.
    code: Code to execute (Python, Node.js, or R, depending on the session runtime).
    timeout: Max execution time in seconds (max 300). Defaults to 30.

Returns:
    JSON with success, stdout, stderr, result, error, and display_outputs.

Useful for listing files, installing Linux dependencies, etc.

Args:
    session_id: ID returned by create_session.
    command: Shell command to execute (e.g. "ls -la", "apt-get install -y curl").

Returns:
    JSON with stdout, stderr, and exit_code.

Each entry can be:
- Host path: "source" (host path), optional "destination"
- Cross-session: "session_id" (source session), "path" (container path),
  optional "destination" — file must have been exported from that session.

Args:
    session_id: ID returned by create_session (destination).
    files: List of file objects. Examples:
        [{"source": "/tmp/report.pdf", "destination": "report.pdf"}]
        [{"session_id": "abc123", "path": "/workspace/out.csv", "destination": "out.csv"}]

Returns:
    JSON with per-file results (source, destination, success, size, error).

Files become available via the API download endpoint and for import_files
in other sessions. Result includes download_url for each file (API must
be running).

Args:
    session_id: ID returned by create_session.
    files: List of objects with "source" (path in container).
        Example: [{"source": "report.pdf"}, {"source": "/workspace/data.csv"}]

Returns:
    JSON with per-file results (session_id, path, success, size, error,
    download_url). path is always absolute (e.g. /workspace/file.png).

Args:
    session_id: ID returned by create_session.

Returns:
    JSON with success status.