opensandbox-code-interpreter 0.1.2.dev0__tar.gz → 1.1.1__tar.gz

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/.gitignore

@@ -133,6 +133,8 @@ dist
 # Gatsby files
 .cache/
 public
+!docs/public/
+!docs/public/CNAME
 
 # Serverless directories
 .serverless/
@@ -222,6 +224,9 @@ secrets/
 
 # Generated API documentation
 docs/generated/
+docs/.vitepress/generated/
+docs/.vitepress/dist/
+docs/.vitepress/cache/
 apidocs/
 
 # Test results
@@ -263,3 +268,29 @@ nbdist/
 # Generated files
 generated/
 **/generated/**
+
+# Fast Sandbox FastPath gRPC stubs are committed intentionally (deterministic protoc
+# output; the server package needs them at install time, so they are checked
+# in rather than regenerated).
+!server/opensandbox_server/services/fast_sandbox/generated/
+!server/opensandbox_server/services/fast_sandbox/generated/**
+server/opensandbox_server/services/fast_sandbox/generated/__pycache__/
+
+# execd eBPF kernel BTF dumps (bpf2go build-time only, never committed —
+# see components/execd/pkg/ebpf/prog/audit.bpf.c; regenerate with:
+#   bpftool btf dump file /sys/kernel/btf/vmlinux format c > .../vmlinux.h)
+components/execd/pkg/ebpf/prog/vmlinux.h
+components/execd/pkg/ebpf/prog/vmlinux_*.h
+
+# gVisor runtime binaries (downloaded dynamically)
+kubernetes/test/kind/gvisor/runsc
+kubernetes/test/kind/gvisor/containerd-shim-runsc-v1
+bin/
+obj/
+
+.qoder/
+/.vs
+
+# fast-sandbox pinned source checkout (materialized by
+# manifests/release/build-fast-sandbox.sh from manifests/third-party/fast-sandbox.commit)
+.fast-sandbox/

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/PKG-INFO

@@ -1,11 +1,11 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: opensandbox-code-interpreter
-Version: 0.1.2.dev0
+Version: 1.1.1
 Summary: OpenSandbox Code Interpreter Python SDK - Advanced code execution with persistent contexts
-Project-URL: Homepage, https://github.com/alibaba/OpenSandbox
-Project-URL: Repository, https://github.com/alibaba/OpenSandbox
-Project-URL: Documentation, https://docs.opensandbox.io
-Project-URL: Issues, https://github.com/alibaba/OpenSandbox/issues
+Project-URL: Homepage, https://open-sandbox.ai
+Project-URL: Repository, https://github.com/opensandbox-group/OpenSandbox
+Project-URL: Documentation, https://open-sandbox.ai
+Project-URL: Issues, https://github.com/opensandbox-group/OpenSandbox/issues
 Author-email: OpenSandbox Team <ninan.nn@alibaba-inc.com>
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -223,13 +223,12 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: opensandbox<0.2.0,>=0.1.1
-Requires-Dist: pydantic<3.0,>=2.0.0
+Requires-Dist: opensandbox<2.0.0,>=1.1.1
+Requires-Dist: pydantic<3.0,>=2.4.2
 Description-Content-Type: text/markdown
 
 # OpenSandbox Code Interpreter SDK for Python
 
-English | [中文](README_zh.md)
 
 A Python SDK for executing code in secure, isolated sandboxes. It provides a high-level API for running Python, Java,
 Go, TypeScript, and other languages safely, with support for code execution contexts.
@@ -241,7 +240,7 @@ This SDK requires a Docker image containing the Code Interpreter runtime environ
 Node.js, etc.
 
 For detailed information about supported languages and versions, refer to the
-[Environment Documentation](../../../sandboxes/code-interpreter/README.md).
+[Environment Documentation](https://github.com/opensandbox-group/sandbox-images).
 
 ## Installation
 
@@ -281,9 +280,9 @@ async def main() -> None:
 
     # 2. Create a Sandbox with the code-interpreter image + runtime versions
     sandbox = await Sandbox.create(
-        "opensandbox/code-interpreter:latest",
+        "opensandbox/code-interpreter:v1.1.0",
         connection_config=config,
-        entrypoint=["/opt/opensandbox/code-interpreter.sh"],
+        entrypoint=["/opt/code-interpreter/code-interpreter.sh"],
         env={
             "PYTHON_VERSION": "3.11",
             "JAVA_VERSION": "17",
@@ -342,9 +341,9 @@ config = ConnectionConfigSync(
 )
 
 sandbox = SandboxSync.create(
-    "opensandbox/code-interpreter:latest",
+    "opensandbox/code-interpreter:v1.1.0",
     connection_config=config,
-    entrypoint=["/opt/opensandbox/code-interpreter.sh"],
+    entrypoint=["/opt/code-interpreter/code-interpreter.sh"],
     env={"PYTHON_VERSION": "3.11"},
 )
 with sandbox:
@@ -355,6 +354,14 @@ with sandbox:
     sandbox.kill()
 ```
 
+### Installing Python packages at runtime
+
+You can install packages directly via `sandbox.commands.run(...)`:
+
+```python
+execution = await sandbox.commands.run("pip install pandas numpy")
+```
+
 ## Runtime Configuration
 
 ### Docker Image

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/README.md

@@ -1,6 +1,5 @@
 # OpenSandbox Code Interpreter SDK for Python
 
-English | [中文](README_zh.md)
 
 A Python SDK for executing code in secure, isolated sandboxes. It provides a high-level API for running Python, Java,
 Go, TypeScript, and other languages safely, with support for code execution contexts.
@@ -12,7 +11,7 @@ This SDK requires a Docker image containing the Code Interpreter runtime environ
 Node.js, etc.
 
 For detailed information about supported languages and versions, refer to the
-[Environment Documentation](../../../sandboxes/code-interpreter/README.md).
+[Environment Documentation](https://github.com/opensandbox-group/sandbox-images).
 
 ## Installation
 
@@ -52,9 +51,9 @@ async def main() -> None:
 
     # 2. Create a Sandbox with the code-interpreter image + runtime versions
     sandbox = await Sandbox.create(
-        "opensandbox/code-interpreter:latest",
+        "opensandbox/code-interpreter:v1.1.0",
         connection_config=config,
-        entrypoint=["/opt/opensandbox/code-interpreter.sh"],
+        entrypoint=["/opt/code-interpreter/code-interpreter.sh"],
         env={
             "PYTHON_VERSION": "3.11",
             "JAVA_VERSION": "17",
@@ -113,9 +112,9 @@ config = ConnectionConfigSync(
 )
 
 sandbox = SandboxSync.create(
-    "opensandbox/code-interpreter:latest",
+    "opensandbox/code-interpreter:v1.1.0",
     connection_config=config,
-    entrypoint=["/opt/opensandbox/code-interpreter.sh"],
+    entrypoint=["/opt/code-interpreter/code-interpreter.sh"],
     env={"PYTHON_VERSION": "3.11"},
 )
 with sandbox:
@@ -126,6 +125,14 @@ with sandbox:
     sandbox.kill()
 ```
 
+### Installing Python packages at runtime
+
+You can install packages directly via `sandbox.commands.run(...)`:
+
+```python
+execution = await sandbox.commands.run("pip install pandas numpy")
+```
+
 ## Runtime Configuration
 
 ### Docker Image

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/pyproject.toml

@@ -1,4 +1,4 @@
-# Copyright 2025 Alibaba Group Holding Ltd.
+# Copyright 2025 The OpenSandbox Authors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -42,15 +42,15 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "pydantic>=2.0.0,<3.0",
-    "opensandbox>=0.1.1,<0.2.0",
+    "pydantic>=2.4.2,<3.0",
+    "opensandbox>=1.1.1,<2.0.0",
 ]
 
 [project.urls]
-Homepage = "https://github.com/alibaba/OpenSandbox"
-Repository = "https://github.com/alibaba/OpenSandbox"
-Documentation = "https://docs.opensandbox.io"
-Issues = "https://github.com/alibaba/OpenSandbox/issues"
+Homepage = "https://open-sandbox.ai"
+Repository = "https://github.com/opensandbox-group/OpenSandbox"
+Documentation = "https://open-sandbox.ai"
+Issues = "https://github.com/opensandbox-group/OpenSandbox/issues"
 
 [tool.hatch.version]
 source = "vcs"
@@ -58,9 +58,9 @@ source = "vcs"
 [tool.hatch.version.raw-options]
 # This package is in a subdirectory; explicitly point setuptools-scm at the git root.
 root = "../../.."
-tag_regex = "^python/code-interpreter/v(?P<version>\\d+\\.\\d+\\.\\d+(?:[\\.\\w\\+\\-]*)?)$"
-git_describe_command = 'git describe --dirty --tags --long --match "python/code-interpreter/v*"'
-fallback_version = "0.1.0"
+tag_regex = "^release-(?P<version>\\d+\\.\\d+\\.\\d+(?:[\\.\\w\\+\\-]*)?)$"
+git_describe_command = 'git describe --dirty --tags --long --match "release-*"'
+fallback_version = "0.1.3"
 
 [tool.hatch.build]
 include = [

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/src/code_interpreter/__init__.py

@@ -1,5 +1,5 @@
 #
-# Copyright 2025 Alibaba Group Holding Ltd.
+# Copyright 2025 The OpenSandbox Authors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/src/code_interpreter/adapters/__init__.py

@@ -1,5 +1,5 @@
 #
-# Copyright 2025 Alibaba Group Holding Ltd.
+# Copyright 2025 The OpenSandbox Authors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/src/code_interpreter/adapters/code_adapter.py

@@ -1,5 +1,5 @@
 #
-# Copyright 2025 Alibaba Group Holding Ltd.
+# Copyright 2025 The OpenSandbox Authors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -22,6 +22,7 @@ API clients and handling SSE streaming for real-time code execution.
 
 import json
 import logging
+import time
 
 import httpx
 from opensandbox.adapters.converter.event_node import EventNode
@@ -32,6 +33,7 @@ from opensandbox.adapters.converter.execution_event_dispatcher import (
     ExecutionEventDispatcher,
 )
 from opensandbox.adapters.converter.response_handler import (
+    extract_request_id,
     handle_api_error,
     require_parsed,
 )
@@ -39,6 +41,7 @@ from opensandbox.config import ConnectionConfig
 from opensandbox.exceptions import InvalidArgumentException, SandboxApiException
 from opensandbox.models.execd import Execution, ExecutionHandlers
 from opensandbox.models.sandboxes import SandboxEndpoint
+from opensandbox.transport import unwrap_retry_transport
 
 from code_interpreter.adapters.converter.code_execution_converter import (
     CodeExecutionConverter,
@@ -49,18 +52,28 @@ from code_interpreter.services.code import Codes
 logger = logging.getLogger(__name__)
 
 
+def _normalize_sse_event(event_dict: dict) -> dict:
+    if "type" in event_dict and "timestamp" in event_dict:
+        return event_dict
+    if "code" in event_dict and "message" in event_dict:
+        return {
+            "type": "error",
+            "timestamp": int(time.time() * 1000),
+            "error": {
+                "ename": str(event_dict["code"]),
+                "evalue": str(event_dict["message"]),
+                "traceback": [],
+            },
+        }
+    return event_dict
+
+
 class CodesAdapter(Codes):
     """
     Adapter implementation for code execution service.
 
-    This adapter wraps auto-generated API clients and provides the concrete
-    implementation of the Codes interface. It handles both standard
-    API calls and SSE streaming for real-time code execution output.
-
-    Similar to CommandServiceAdapter, this adapter uses:
-    - Generated API clients for simple operations (create_context, interrupt)
-    - Direct httpx SSE streaming for run
-    - ExceptionConverter for unified exception handling
+    Handles standard API calls plus direct httpx SSE streaming for
+    real-time code execution output.
     """
 
     RUN_CODE_PATH = "/code"
@@ -85,10 +98,7 @@ class CodesAdapter(Codes):
         timeout_seconds = self.connection_config.request_timeout.total_seconds()
         timeout = httpx.Timeout(timeout_seconds)
 
-        headers = {
-            "User-Agent": self.connection_config.user_agent,
-            **self.connection_config.headers,
-        }
+        headers = self.execd_endpoint.build_request_headers(self.connection_config)
 
         # Execd API does not require authentication
         self._client = Client(
@@ -96,12 +106,19 @@ class CodesAdapter(Codes):
             timeout=timeout,
         )
 
-        # Inject httpx client (adapter-owned)
+        # Adapter clients must own their transports: aclose() closes them,
+        # and the shared/user connection_config transport must survive that.
+        self._owns_clients = self.connection_config.owns_transport
+        main_transport: httpx.AsyncBaseTransport | None
+        if self._owns_clients:
+            main_transport = self.connection_config.new_owned_transport()
+        else:
+            main_transport = self.connection_config.transport
         self._httpx_client = httpx.AsyncClient(
             base_url=base_url,
             headers=headers,
             timeout=timeout,
-            transport=self.connection_config.transport,
+            transport=main_transport,
         )
         self._client.set_async_httpx_client(self._httpx_client)
 
@@ -111,6 +128,14 @@ class CodesAdapter(Codes):
             "Accept": "text/event-stream",
             "Cache-Control": "no-cache",
         }
+        # SSE bootstraps bypass the retry wrapper: request bodies are
+        # not replayable and a non-idempotent status opt-in would cause
+        # duplicate execution on a resent SSE POST.
+        sse_transport = (
+            self.connection_config.new_owned_transport()
+            if self._owns_clients
+            else self.connection_config.transport
+        )
         self._sse_client = httpx.AsyncClient(
             headers=sse_headers,
             timeout=httpx.Timeout(
@@ -119,7 +144,7 @@ class CodesAdapter(Codes):
                 write=timeout_seconds,
                 pool=None,
             ),
-            transport=self.connection_config.transport,
+            transport=unwrap_retry_transport(sse_transport),
         )
 
     async def _get_client(self):
@@ -135,6 +160,21 @@ class CodesAdapter(Codes):
         """Return SSE client (read timeout disabled) for execd streaming."""
         return self._sse_client
 
+    async def aclose(self) -> None:
+        """Release the adapter-owned HTTP clients.
+
+        Never closes the shared ``connection_config.transport``; the sandbox
+        stays usable after ``aclose()``. Clients wrapping a user-supplied
+        transport are left open (httpx would close the caller's transport
+        with them).
+        """
+        if not self._owns_clients:
+            return
+        try:
+            await self._httpx_client.aclose()
+        finally:
+            await self._sse_client.aclose()
+
     async def create_context(self, language: str) -> CodeContext:
         """
         Creates a new execution context for code interpretation.
@@ -197,7 +237,9 @@ class CodesAdapter(Codes):
             )
             handle_api_error(response_obj, "List code contexts")
             parsed_list = require_parsed(response_obj, list, "List code contexts")
-            return [CodeExecutionConverter.from_api_code_context(c) for c in parsed_list]
+            return [
+                CodeExecutionConverter.from_api_code_context(c) for c in parsed_list
+            ]
         except Exception as e:
             logger.error("Failed to list contexts", exc_info=e)
             raise ExceptionConverter.to_sandbox_exception(e) from e
@@ -243,14 +285,18 @@ class CodesAdapter(Codes):
         """
         Executes code within the specified context using SSE streaming.
 
-        Similar to CommandServiceAdapter.run, this uses direct httpx
+        Uses direct httpx
         streaming to handle SSE responses from the execd service.
         """
         if not code.strip():
             raise InvalidArgumentException("Code cannot be empty")
 
         try:
-            if context is not None and language is not None and context.language != language:
+            if (
+                context is not None
+                and language is not None
+                and context.language != language
+            ):
                 raise InvalidArgumentException(
                     f"language '{language}' must match context.language '{context.language}'"
                 )
@@ -280,13 +326,12 @@ class CodesAdapter(Codes):
                     await response.aread()
                     error_body = response.text
                     logger.error(
-                        "Failed to run code. Status: %s, Body: %s",
-                        response.status_code,
-                        error_body,
+                        f"Failed to run code. Status: {response.status_code}, Body: {error_body}"
                     )
                     raise SandboxApiException(
-                        message=f"Failed to run code. Status code: {response.status_code}",
+                        message=f"Failed to run code. Status code: {response.status_code}, Body: {error_body}",
                         status_code=response.status_code,
+                        request_id=extract_request_id(response.headers),
                     )
 
                 dispatcher = ExecutionEventDispatcher(execution, handlers)
@@ -301,22 +346,20 @@ class CodesAdapter(Codes):
                         data = data[5:].strip()
 
                     try:
-                        event_dict = json.loads(data)
+                        event_dict = _normalize_sse_event(json.loads(data))
                         event_node = EventNode(**event_dict)
                         await dispatcher.dispatch(event_node)
                     except json.JSONDecodeError:
-                        logger.debug("Failed to parse SSE line: %s", line)
+                        logger.debug(f"Failed to parse SSE line: {line}")
                         continue
                     except Exception as e:
-                        logger.error("Error processing event: %s", data, exc_info=e)
+                        logger.error(f"Error processing event: {data}", exc_info=e)
                         continue
 
             return execution
 
         except Exception as e:
-            logger.error(
-                "Failed to run code (length: %s)", len(code), exc_info=e
-            )
+            logger.error(f"Failed to run code (length: {len(code)})", exc_info=e)
             raise ExceptionConverter.to_sandbox_exception(e) from e
 
     async def interrupt(self, execution_id: str) -> None:
@@ -339,3 +382,23 @@ class CodesAdapter(Codes):
         except Exception as e:
             logger.error("Failed to interrupt code execution", exc_info=e)
             raise ExceptionConverter.to_sandbox_exception(e) from e
+
+    async def ping(self) -> bool:
+        """
+        Check if the execd code execution service is alive.
+
+        Uses the shared generated API client so the ping exercises the same
+        HTTP client and endpoint that serve code execution requests.
+        """
+        try:
+            from opensandbox.api.execd.api.health import ping as ping_api
+
+            client = await self._get_client()
+            response_obj = await ping_api.asyncio_detailed(client=client)
+
+            handle_api_error(response_obj, "Ping code interpreter")
+            return True
+
+        except Exception as e:
+            logger.debug(f"Code interpreter ping failed: {e}")
+            return False

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/src/code_interpreter/adapters/converter/__init__.py

@@ -1,5 +1,5 @@
 #
-# Copyright 2025 Alibaba Group Holding Ltd.
+# Copyright 2025 The OpenSandbox Authors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/src/code_interpreter/adapters/converter/code_execution_converter.py

@@ -1,5 +1,5 @@
 #
-# Copyright 2025 Alibaba Group Holding Ltd.
+# Copyright 2025 The OpenSandbox Authors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{opensandbox_code_interpreter-0.1.2.dev0 → opensandbox_code_interpreter-1.1.1}/src/code_interpreter/adapters/factory.py

@@ -1,5 +1,5 @@
 #
-# Copyright 2025 Alibaba Group Holding Ltd.
+# Copyright 2025 The OpenSandbox Authors
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.