@cloudflare/sandbox 0.0.0-1dfb064 → 0.0.0-2011e85

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/CHANGELOG.md +162 -15
  2. package/Dockerfile +171 -85
  3. package/README.md +92 -769
  4. package/dist/index.d.ts +1889 -0
  5. package/dist/index.d.ts.map +1 -0
  6. package/dist/index.js +3146 -0
  7. package/dist/index.js.map +1 -0
  8. package/package.json +16 -8
  9. package/src/clients/base-client.ts +295 -0
  10. package/src/clients/command-client.ts +115 -0
  11. package/src/clients/file-client.ts +300 -0
  12. package/src/clients/git-client.ts +91 -0
  13. package/src/clients/index.ts +60 -0
  14. package/src/clients/interpreter-client.ts +333 -0
  15. package/src/clients/port-client.ts +105 -0
  16. package/src/clients/process-client.ts +180 -0
  17. package/src/clients/sandbox-client.ts +39 -0
  18. package/src/clients/types.ts +88 -0
  19. package/src/clients/utility-client.ts +123 -0
  20. package/src/errors/adapter.ts +238 -0
  21. package/src/errors/classes.ts +594 -0
  22. package/src/errors/index.ts +109 -0
  23. package/src/file-stream.ts +169 -0
  24. package/src/index.ts +89 -53
  25. package/src/interpreter.ts +62 -44
  26. package/src/request-handler.ts +94 -55
  27. package/src/sandbox.ts +980 -492
  28. package/src/security.ts +34 -28
  29. package/src/sse-parser.ts +8 -11
  30. package/src/version.ts +6 -0
  31. package/startup.sh +3 -0
  32. package/tests/base-client.test.ts +364 -0
  33. package/tests/command-client.test.ts +444 -0
  34. package/tests/file-client.test.ts +831 -0
  35. package/tests/file-stream.test.ts +310 -0
  36. package/tests/get-sandbox.test.ts +149 -0
  37. package/tests/git-client.test.ts +415 -0
  38. package/tests/port-client.test.ts +293 -0
  39. package/tests/process-client.test.ts +683 -0
  40. package/tests/request-handler.test.ts +292 -0
  41. package/tests/sandbox.test.ts +706 -0
  42. package/tests/sse-parser.test.ts +291 -0
  43. package/tests/utility-client.test.ts +339 -0
  44. package/tests/version.test.ts +16 -0
  45. package/tests/wrangler.jsonc +35 -0
  46. package/tsconfig.json +9 -1
  47. package/tsdown.config.ts +12 -0
  48. package/vitest.config.ts +31 -0
  49. package/container_src/bun.lock +0 -122
  50. package/container_src/circuit-breaker.ts +0 -121
  51. package/container_src/control-process.ts +0 -784
  52. package/container_src/handler/exec.ts +0 -185
  53. package/container_src/handler/file.ts +0 -406
  54. package/container_src/handler/git.ts +0 -130
  55. package/container_src/handler/ports.ts +0 -314
  56. package/container_src/handler/process.ts +0 -568
  57. package/container_src/handler/session.ts +0 -92
  58. package/container_src/index.ts +0 -601
  59. package/container_src/isolation.ts +0 -1038
  60. package/container_src/jupyter-server.ts +0 -579
  61. package/container_src/jupyter-service.ts +0 -461
  62. package/container_src/jupyter_config.py +0 -48
  63. package/container_src/mime-processor.ts +0 -255
  64. package/container_src/package.json +0 -18
  65. package/container_src/shell-escape.ts +0 -42
  66. package/container_src/startup.sh +0 -84
  67. package/container_src/types.ts +0 -131
  68. package/src/client.ts +0 -1009
  69. package/src/errors.ts +0 -218
  70. package/src/interpreter-types.ts +0 -383
  71. package/src/jupyter-client.ts +0 -349
  72. package/src/types.ts +0 -502
package/CHANGELOG.md CHANGED
@@ -1,5 +1,155 @@
1
1
  # @cloudflare/sandbox
2
2
 
3
+ ## 0.4.15
4
+
5
+ ### Patch Changes
6
+
7
+ - [#185](https://github.com/cloudflare/sandbox-sdk/pull/185) [`7897cdd`](https://github.com/cloudflare/sandbox-sdk/commit/7897cddefc366bbd640ea138b34a520a0b2ddf8c) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix foreground commands blocking on background processes
8
+
9
+ - [#183](https://github.com/cloudflare/sandbox-sdk/pull/183) [`ff2fa91`](https://github.com/cloudflare/sandbox-sdk/commit/ff2fa91479357ef88cfb22418f88acb257462faa) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - update python to 3.11.14
10
+
11
+ ## 0.4.14
12
+
13
+ ### Patch Changes
14
+
15
+ - [#172](https://github.com/cloudflare/sandbox-sdk/pull/172) [`1bf3576`](https://github.com/cloudflare/sandbox-sdk/commit/1bf35768b02532c77df6f30a2f2eb08cb2b12115) Thanks [@threepointone](https://github.com/threepointone)! - Update dependencies
16
+
17
+ - [#176](https://github.com/cloudflare/sandbox-sdk/pull/176) [`7edbfa9`](https://github.com/cloudflare/sandbox-sdk/commit/7edbfa906668d75f540527f50b52483dc787192c) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Add cache mounts to Dockerfile for faster builds
18
+
19
+ Adds cache mounts for npm, apt, and pip package managers in the Dockerfile. This speeds up Docker image builds when dependencies change, particularly beneficial for users building from source.
20
+
21
+ - [#172](https://github.com/cloudflare/sandbox-sdk/pull/172) [`1bf3576`](https://github.com/cloudflare/sandbox-sdk/commit/1bf35768b02532c77df6f30a2f2eb08cb2b12115) Thanks [@threepointone](https://github.com/threepointone)! - Fix type generation
22
+
23
+ We inline types from `@repo/shared` so that it includes the types we reexport. Fixes #165
24
+
25
+ - [#175](https://github.com/cloudflare/sandbox-sdk/pull/175) [`77cb937`](https://github.com/cloudflare/sandbox-sdk/commit/77cb93762a619523758f769a10509e665ca819fe) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Move .connect to .wsConnect within DO stub
26
+
27
+ ## 0.4.13
28
+
29
+ ### Patch Changes
30
+
31
+ - [#168](https://github.com/cloudflare/sandbox-sdk/pull/168) [`6b08f02`](https://github.com/cloudflare/sandbox-sdk/commit/6b08f02c061aef07cc98188abef2973ac92365f8) Thanks [@threepointone](https://github.com/threepointone)! - Fix type generation
32
+
33
+ We inline types from `@repo/shared` so that it includes the types we reexport. Fixes #165
34
+
35
+ - [#162](https://github.com/cloudflare/sandbox-sdk/pull/162) [`c4db459`](https://github.com/cloudflare/sandbox-sdk/commit/c4db459389a7b86048a03410d67d4dd7bf4a6085) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - Add WebSocket support via connect() method for routing client WebSocket connections directly to container services
36
+
37
+ ## 0.4.12
38
+
39
+ ### Patch Changes
40
+
41
+ - [#137](https://github.com/cloudflare/sandbox-sdk/pull/137) [`7f4442b`](https://github.com/cloudflare/sandbox-sdk/commit/7f4442b7a097587d8f8e8f9ff2f887df6943a3db) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - add keepAlive flag to prevent containers from shutting down
42
+
43
+ ## 0.4.11
44
+
45
+ ### Patch Changes
46
+
47
+ - [#159](https://github.com/cloudflare/sandbox-sdk/pull/159) [`e16659a`](https://github.com/cloudflare/sandbox-sdk/commit/e16659a1815923f1cd1176f51a052725d820ee16) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Use latest containers package version
48
+
49
+ ## 0.4.10
50
+
51
+ ### Patch Changes
52
+
53
+ - [#156](https://github.com/cloudflare/sandbox-sdk/pull/156) [`b61841c`](https://github.com/cloudflare/sandbox-sdk/commit/b61841cfb3248022ee8136311e54955ed9faa1ee) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix WebSocket upgrade requests through exposed ports
54
+
55
+ ## 0.4.9
56
+
57
+ ### Patch Changes
58
+
59
+ - [#152](https://github.com/cloudflare/sandbox-sdk/pull/152) [`8e7773e`](https://github.com/cloudflare/sandbox-sdk/commit/8e7773ec9571a5f968cbbc5f48e38e01d7d13b77) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Add exists() method to check if a file or directory exists
60
+
61
+ This adds a new `exists()` method to the SDK that checks whether a file or directory exists at a given path. The method returns a boolean indicating existence, similar to Python's `os.path.exists()` and JavaScript's `fs.existsSync()`.
62
+
63
+ The implementation is end-to-end:
64
+ - New `FileExistsResult` and `FileExistsRequest` types in shared package
65
+ - Handler endpoint at `/api/exists` in container layer
66
+ - Client method in `FileClient` and `Sandbox` classes
67
+ - Full test coverage (unit tests and E2E tests)
68
+
69
+ ## 0.4.8
70
+
71
+ ### Patch Changes
72
+
73
+ - [#153](https://github.com/cloudflare/sandbox-sdk/pull/153) [`f6a5c3e`](https://github.com/cloudflare/sandbox-sdk/commit/f6a5c3e1607fce5fc26f816e9206ae437898d5af) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix token extraction regex causing Invalid token errors
74
+
75
+ ## 0.4.7
76
+
77
+ ### Patch Changes
78
+
79
+ - [#141](https://github.com/cloudflare/sandbox-sdk/pull/141) [`c39674b`](https://github.com/cloudflare/sandbox-sdk/commit/c39674b8fe2e986e59a794b6bb3a5f51a87bae89) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix commands hanging when reading stdin by redirecting stdin to /dev/null
80
+
81
+ - [#143](https://github.com/cloudflare/sandbox-sdk/pull/143) [`276efc0`](https://github.com/cloudflare/sandbox-sdk/commit/276efc0ca8776bcc8de79e7e58dd24d9f418cc5c) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Remove unnecessary existing session check
82
+
83
+ ## 0.4.6
84
+
85
+ ### Patch Changes
86
+
87
+ - [#133](https://github.com/cloudflare/sandbox-sdk/pull/133) [`da2cfb8`](https://github.com/cloudflare/sandbox-sdk/commit/da2cfb876675eb3445970c90b4d70d00288a7c74) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - feat: Add version sync detection between npm package and Docker image
88
+
89
+ ## 0.4.5
90
+
91
+ ### Patch Changes
92
+
93
+ - [#127](https://github.com/cloudflare/sandbox-sdk/pull/127) [`e79ac80`](https://github.com/cloudflare/sandbox-sdk/commit/e79ac80bc855a3ec527d44cc14585794b23cb129) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - configurable sleepAfter
94
+
95
+ ## 0.4.4
96
+
97
+ ### Patch Changes
98
+
99
+ - [#125](https://github.com/cloudflare/sandbox-sdk/pull/125) [`fddccfd`](https://github.com/cloudflare/sandbox-sdk/commit/fddccfdce8204ce2aa7dadc0ad9fb2acbdeaec51) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - add docker image to pkg workflow
100
+
101
+ ## 0.4.3
102
+
103
+ ### Patch Changes
104
+
105
+ - [#114](https://github.com/cloudflare/sandbox-sdk/pull/114) [`8c1f440`](https://github.com/cloudflare/sandbox-sdk/commit/8c1f440ad6fd89a5c69f9ca9d055ad9b183dd1c3) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Debloat base docker image (2.63GB → 1.03GB)
106
+
107
+ ## 0.4.2
108
+
109
+ ### Patch Changes
110
+
111
+ - [`e53d7e7`](https://github.com/cloudflare/sandbox-sdk/commit/e53d7e7ce185f79bdd899029bb532e9651ae7ba5) Thanks [@threepointone](https://github.com/threepointone)! - fix build by inlining repo/shared
112
+
113
+ ## 0.4.1
114
+
115
+ ### Patch Changes
116
+
117
+ - [#111](https://github.com/cloudflare/sandbox-sdk/pull/111) [`1b5496b`](https://github.com/cloudflare/sandbox-sdk/commit/1b5496bfceaee53c31911b409476ea87bebffe4c) Thanks [@threepointone](https://github.com/threepointone)! - trigger a release
118
+
119
+ ## 0.4.0
120
+
121
+ ### Minor Changes
122
+
123
+ - [#95](https://github.com/cloudflare/sandbox-sdk/pull/95) [`7aee736`](https://github.com/cloudflare/sandbox-sdk/commit/7aee736bf07a4bf9020e2109bdaaa70214d52a01) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Rewrite SDK with cleaner design patterns and tests. Remove the unnecessary isolation cruft and fix foundational issues with streaming, sessions, validations and error handling. Cover the SDK with unit & e2e tests.
124
+
125
+ ### Patch Changes
126
+
127
+ - [#106](https://github.com/cloudflare/sandbox-sdk/pull/106) [`da947cd`](https://github.com/cloudflare/sandbox-sdk/commit/da947cd9543fc99831eefb1e8741fc905cb8fa42) Thanks [@jahands](https://github.com/jahands)! - fix examples failing to deploy and prevent committing node_modules
128
+
129
+ ## 0.3.3
130
+
131
+ ### Patch Changes
132
+
133
+ - [#83](https://github.com/cloudflare/sandbox-sdk/pull/83) [`eec5bb6`](https://github.com/cloudflare/sandbox-sdk/commit/eec5bb6203dd5d775b4b54e91c26de25eeb767ce) Thanks [@mikenomitch](https://github.com/mikenomitch)! - Bump containers package version
134
+
135
+ ## 0.3.2
136
+
137
+ ### Patch Changes
138
+
139
+ - [#76](https://github.com/cloudflare/sandbox-sdk/pull/76) [`ef9e320`](https://github.com/cloudflare/sandbox-sdk/commit/ef9e320dcef30e57797fef6ebd9a9383fa9720d9) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Replace Jupyter with lightweight interpreters for >90% faster cold starts for `.runCode` calls, while maintaining full code execution capabilities and rich output support.
140
+
141
+ ## 0.3.1
142
+
143
+ ### Patch Changes
144
+
145
+ - [#71](https://github.com/cloudflare/sandbox-sdk/pull/71) [`fb3c9c2`](https://github.com/cloudflare/sandbox-sdk/commit/fb3c9c22242d9d4f157c26f547f1e697ef7875f9) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Bump containers package version
146
+
147
+ - [#70](https://github.com/cloudflare/sandbox-sdk/pull/70) [`e1fa354`](https://github.com/cloudflare/sandbox-sdk/commit/e1fa354ab1bc7b0e89db4901b67028ebf1a93d0a) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix escaped quotes in file write operations
148
+
149
+ - [#68](https://github.com/cloudflare/sandbox-sdk/pull/68) [`69b91d1`](https://github.com/cloudflare/sandbox-sdk/commit/69b91d1a8f6afb63262cc381ea93e94a033ed5e8) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Configurable timeouts via environment variables in isolation.ts
150
+
151
+ - [#66](https://github.com/cloudflare/sandbox-sdk/pull/66) [`eca93b9`](https://github.com/cloudflare/sandbox-sdk/commit/eca93b97e40fa0d3bd9dc27af2cc214ec355b696) Thanks [@peterp](https://github.com/peterp)! - Determine if the port is specified in the URL.
152
+
3
153
  ## 0.3.0
4
154
 
5
155
  ### Minor Changes
@@ -9,50 +159,47 @@
9
159
  Implements PID namespace isolation to protect control plane processes (Jupyter, Bun) from sandboxed code. Commands executed via `exec()` now run in isolated namespaces that cannot see or interact with system processes.
10
160
 
11
161
  **Key security improvements:**
12
-
13
162
  - Control plane processes are hidden from sandboxed commands
14
163
  - Platform secrets in `/proc/1/environ` are inaccessible
15
164
  - Ports 8888 (Jupyter) and 3000 (Bun) are protected from hijacking
16
165
 
17
166
  **Breaking changes:**
18
-
19
167
  1. **Removed `sessionId` parameter**: The `sessionId` parameter has been removed from all methods (`exec()`, `execStream()`, `startProcess()`, etc.). Each sandbox now maintains its own persistent session automatically.
20
168
 
21
169
  ```javascript
22
170
  // Before: manual session management
23
- await sandbox.exec("cd /app", { sessionId: "my-session" });
171
+ await sandbox.exec('cd /app', { sessionId: 'my-session' });
24
172
 
25
173
  // After: automatic session per sandbox
26
- await sandbox.exec("cd /app");
174
+ await sandbox.exec('cd /app');
27
175
  ```
28
176
 
29
177
  2. **Commands now maintain state**: Commands within the same sandbox now share state (working directory, environment variables, background processes). Previously each command was stateless.
30
178
 
31
179
  ```javascript
32
180
  // Before: each exec was independent
33
- await sandbox.exec("cd /app");
34
- await sandbox.exec("pwd"); // Output: /workspace
181
+ await sandbox.exec('cd /app');
182
+ await sandbox.exec('pwd'); // Output: /workspace
35
183
 
36
184
  // After: state persists in session
37
- await sandbox.exec("cd /app");
38
- await sandbox.exec("pwd"); // Output: /app
185
+ await sandbox.exec('cd /app');
186
+ await sandbox.exec('pwd'); // Output: /app
39
187
  ```
40
188
 
41
189
  **Migration guide:**
42
-
43
190
  - Remove `sessionId` from all method calls - each sandbox maintains its own session
44
191
  - If you need isolated execution contexts within the same sandbox, use `sandbox.createSession()`:
45
192
  ```javascript
46
193
  // Create independent sessions with different environments
47
194
  const buildSession = await sandbox.createSession({
48
- name: "build",
49
- env: { NODE_ENV: "production" },
50
- cwd: "/build",
195
+ name: 'build',
196
+ env: { NODE_ENV: 'production' },
197
+ cwd: '/build'
51
198
  });
52
199
  const testSession = await sandbox.createSession({
53
- name: "test",
54
- env: { NODE_ENV: "test" },
55
- cwd: "/test",
200
+ name: 'test',
201
+ env: { NODE_ENV: 'test' },
202
+ cwd: '/test'
56
203
  });
57
204
  ```
58
205
  - Environment variables set in one command persist to the next
package/Dockerfile CHANGED
@@ -1,103 +1,189 @@
1
- # Sandbox base image with development tools, Python, Node.js, and Bun
2
- FROM oven/bun:latest AS bun-source
3
- FROM ubuntu:22.04
1
+ # Sandbox container image with full development environment
2
+ # Multi-stage build optimized for Turborepo monorepo
3
+
4
+ # ============================================================================
5
+ # Stage 1: Prune monorepo to only include necessary packages
6
+ # ============================================================================
7
+ FROM node:20-alpine AS pruner
8
+
9
+ WORKDIR /app
10
+
11
+ # Install Turborepo globally
12
+ RUN npm install -g turbo
13
+
14
+ # Copy entire monorepo
15
+ COPY . .
16
+
17
+ # Prune to only @repo/sandbox-container and its dependencies (@repo/shared)
18
+ # The --docker flag generates out/json and out/full directories
19
+ RUN turbo prune @repo/sandbox-container --docker
20
+
21
+ # ============================================================================
22
+ # Stage 2: Install dependencies and build packages
23
+ # ============================================================================
24
+ FROM node:20-alpine AS builder
25
+
26
+ WORKDIR /app
27
+
28
+ # Copy pruned lockfile and package.json files (for Docker layer caching)
29
+ COPY --from=pruner /app/out/json/ .
30
+ COPY --from=pruner /app/out/package-lock.json ./package-lock.json
31
+
32
+ # Install ALL dependencies with cache mount for npm packages
33
+ RUN --mount=type=cache,target=/root/.npm \
34
+ npm ci
35
+
36
+ # Copy pruned source code
37
+ COPY --from=pruner /app/out/full/ .
38
+
39
+ # Build all packages (Turborepo handles dependency order automatically)
40
+ # This builds @repo/shared first, then @repo/sandbox-container
41
+ RUN npx turbo run build
42
+
43
+ # ============================================================================
44
+ # Stage 3: Install production-only dependencies
45
+ # ============================================================================
46
+ FROM node:20-alpine AS prod-deps
47
+
48
+ WORKDIR /app
49
+
50
+ # Copy package files from builder
51
+ COPY --from=builder /app/package.json ./package.json
52
+ COPY --from=builder /app/package-lock.json ./package-lock.json
53
+ COPY --from=builder /app/packages ./packages
54
+ COPY --from=builder /app/tooling ./tooling
55
+
56
+ # Install ONLY production dependencies (excludes typescript, @types/*, etc.)
57
+ RUN --mount=type=cache,target=/root/.npm \
58
+ npm ci --production
59
+
60
+ # ============================================================================
61
+ # Stage 4: Download pre-built Python 3.11.14
62
+ # ============================================================================
63
+ FROM ubuntu:22.04 AS python-builder
64
+
65
+ # Prevent interactive prompts during package installation
66
+ ENV DEBIAN_FRONTEND=noninteractive
67
+
68
+ # Accept architecture from Docker BuildKit (for multi-arch builds)
69
+ ARG TARGETARCH
70
+
71
+ # Install minimal dependencies for downloading
72
+ RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
73
+ --mount=type=cache,target=/var/lib/apt,sharing=locked \
74
+ rm -f /etc/apt/apt.conf.d/docker-clean && \
75
+ echo 'Binary::apt::APT::Keep-Downloaded-Packages "true";' >/etc/apt/apt.conf.d/keep-cache && \
76
+ apt-get update && apt-get install -y --no-install-recommends \
77
+ wget ca-certificates
78
+
79
+ # Download and extract pre-built Python 3.11.14 from python-build-standalone
80
+ # Using PGO+LTO optimized builds for better performance
81
+ # Supports multi-arch: amd64 (x86_64) and arm64 (aarch64)
82
+ RUN --mount=type=cache,target=/tmp/python-cache \
83
+ # Map Docker TARGETARCH to python-build-standalone arch naming
84
+ if [ "$TARGETARCH" = "amd64" ]; then \
85
+ PYTHON_ARCH="x86_64-unknown-linux-gnu"; \
86
+ EXPECTED_SHA256="edd8d11aa538953d12822fab418359a692fd1ee4ca2675579fbf0fa31e3688f1"; \
87
+ elif [ "$TARGETARCH" = "arm64" ]; then \
88
+ PYTHON_ARCH="aarch64-unknown-linux-gnu"; \
89
+ EXPECTED_SHA256="08141d31f95d86a23f23e4c741b726de0055f12f83200d1d4867b4e8e6e967c5"; \
90
+ else \
91
+ echo "Unsupported architecture: $TARGETARCH" && exit 1; \
92
+ fi && \
93
+ cd /tmp/python-cache && \
94
+ wget -nc https://github.com/indygreg/python-build-standalone/releases/download/20251028/cpython-3.11.14+20251028-${PYTHON_ARCH}-install_only.tar.gz && \
95
+ # Verify SHA256 checksum for security
96
+ echo "${EXPECTED_SHA256} cpython-3.11.14+20251028-${PYTHON_ARCH}-install_only.tar.gz" | sha256sum -c - && \
97
+ cd /tmp && \
98
+ tar -xzf /tmp/python-cache/cpython-3.11.14+20251028-${PYTHON_ARCH}-install_only.tar.gz && \
99
+ mv python /usr/local/ && \
100
+ rm -rf /tmp/cpython-*
101
+
102
+ # ============================================================================
103
+ # Stage 5: Runtime - Ubuntu 22.04 with only runtime dependencies
104
+ # ============================================================================
105
+ FROM ubuntu:22.04 AS runtime
106
+
107
+ # Accept version as build argument (passed from npm_package_version)
108
+ ARG SANDBOX_VERSION=unknown
4
109
 
5
110
  # Prevent interactive prompts during package installation
6
111
  ENV DEBIAN_FRONTEND=noninteractive
7
112
 
8
- # Install essential system packages and development tools
9
- RUN apt-get update && apt-get install -y \
10
- # Basic utilities
11
- curl \
12
- wget \
13
- git \
14
- unzip \
15
- zip \
16
- # Process management
17
- procps \
18
- htop \
19
- # Build tools
20
- build-essential \
21
- pkg-config \
22
- # Network tools
23
- net-tools \
24
- iputils-ping \
25
- dnsutils \
26
- # Text processing
27
- jq \
28
- vim \
29
- nano \
30
- # Python dependencies
31
- python3.11 \
32
- python3.11-dev \
33
- python3-pip \
34
- python3.11-venv \
35
- # Other useful tools
36
- ca-certificates \
37
- gnupg \
38
- lsb-release \
39
- strace \
40
- && rm -rf /var/lib/apt/lists/*
113
+ # Set the sandbox version as an environment variable for version checking
114
+ ENV SANDBOX_VERSION=${SANDBOX_VERSION}
115
+
116
+ # Install runtime packages and Python runtime libraries
117
+ RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
118
+ --mount=type=cache,target=/var/lib/apt,sharing=locked \
119
+ rm -f /etc/apt/apt.conf.d/docker-clean && \
120
+ echo 'Binary::apt::APT::Keep-Downloaded-Packages "true";' >/etc/apt/apt.conf.d/keep-cache && \
121
+ apt-get update && apt-get install -y --no-install-recommends \
122
+ ca-certificates curl wget procps git unzip zip jq file \
123
+ libssl3 zlib1g libbz2-1.0 libreadline8 libsqlite3-0 \
124
+ libncursesw6 libtinfo6 libxml2 libxmlsec1 libffi8 liblzma5 libtk8.6 && \
125
+ update-ca-certificates
126
+
127
+ # Copy pre-built Python from python-builder stage
128
+ COPY --from=python-builder /usr/local/python /usr/local/python
129
+
130
+ # Create symlinks and update shared library cache
131
+ RUN ln -s /usr/local/python/bin/python3.11 /usr/local/bin/python3.11 && \
132
+ ln -s /usr/local/python/bin/python3 /usr/local/bin/python3 && \
133
+ ln -s /usr/local/python/bin/pip3 /usr/local/bin/pip3 && \
134
+ echo "/usr/local/python/lib" > /etc/ld.so.conf.d/python.conf && \
135
+ ldconfig
41
136
 
42
137
  # Set Python 3.11 as default python3
43
- RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1
44
-
45
- # Install Node.js 20 LTS using official NodeSource setup script
46
- RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
47
- && apt-get install -y nodejs \
48
- && rm -rf /var/lib/apt/lists/*
49
-
50
- # Install Bun from official image (avoids architecture compatibility issues)
51
- COPY --from=bun-source /usr/local/bin/bun /usr/local/bin/bun
52
- COPY --from=bun-source /usr/local/bin/bunx /usr/local/bin/bunx
53
-
54
- # Install minimal Jupyter components
55
- RUN pip3 install --no-cache-dir \
56
- jupyter-server \
57
- jupyter-client \
58
- ipykernel \
59
- orjson \
60
- && python3 -m ipykernel install --user --name python3
61
-
62
- # Install scientific packages
63
- RUN pip3 install --no-cache-dir \
64
- matplotlib \
65
- numpy \
66
- pandas \
67
- seaborn
68
-
69
- # Install JavaScript kernel (ijavascript) - using E2B's fork
70
- RUN npm install -g git+https://github.com/e2b-dev/ijavascript.git \
71
- && ijsinstall --install=global
72
-
73
- # Set up container server directory
138
+ RUN update-alternatives --install /usr/bin/python3 python3 /usr/local/bin/python3.11 1
139
+
140
+ # Install Python packages
141
+ RUN --mount=type=cache,target=/root/.cache/pip \
142
+ pip3 install --no-cache-dir matplotlib numpy pandas ipython
143
+
144
+ # Install Node.js 20 LTS from official Node image
145
+ COPY --from=node:20-slim /usr/local/bin/node /usr/local/bin/node
146
+ COPY --from=node:20-slim /usr/local/lib/node_modules /usr/local/lib/node_modules
147
+ RUN ln -s /usr/local/lib/node_modules/npm/bin/npm-cli.js /usr/local/bin/npm && \
148
+ ln -s /usr/local/lib/node_modules/npm/bin/npx-cli.js /usr/local/bin/npx
149
+
150
+ # Install Bun runtime from official image
151
+ COPY --from=oven/bun:1 /usr/local/bin/bun /usr/local/bin/bun
152
+
153
+ # Set up runtime container server directory
74
154
  WORKDIR /container-server
75
155
 
76
- # Verify installations
77
- RUN python3 --version && \
78
- node --version && \
79
- npm --version && \
80
- bun --version && \
81
- jupyter --version && \
82
- jupyter kernelspec list
156
+ # Copy built sandbox-container package
157
+ COPY --from=builder /app/packages/sandbox-container/dist ./dist
158
+ COPY --from=builder /app/packages/sandbox-container/package.json ./package.json
159
+
160
+ # Copy Python executor to runtime location
161
+ COPY --from=builder /app/packages/sandbox-container/src/runtime/executors/python/ipython_executor.py ./dist/runtime/executors/python/
83
162
 
84
- # Copy container source files to server directory
85
- COPY container_src/package.json container_src/bun.lock ./
86
- RUN bun install --frozen-lockfile
163
+ # Copy production-only node_modules (excludes typescript, @types/*, etc.)
164
+ # Includes: @repo/shared, zod, esbuild (runtime dependencies)
165
+ COPY --from=prod-deps /app/node_modules ./node_modules
87
166
 
88
- COPY container_src/ ./
167
+ # Copy workspace packages
168
+ COPY --from=prod-deps /app/packages/shared/dist ./packages/shared/dist
169
+ COPY --from=prod-deps /app/packages/shared/package.json ./packages/shared/package.json
89
170
 
90
- # Compile TypeScript control process
91
- # Use npx -p typescript to ensure we get the right tsc command
92
- RUN npx -p typescript tsc control-process.ts --outDir . --module commonjs --target es2020 --esModuleInterop --skipLibCheck
171
+ # Configure process pool sizes (can be overridden at runtime)
172
+ ENV PYTHON_POOL_MIN_SIZE=3
173
+ ENV PYTHON_POOL_MAX_SIZE=15
174
+ ENV JAVASCRIPT_POOL_MIN_SIZE=3
175
+ ENV JAVASCRIPT_POOL_MAX_SIZE=10
176
+ ENV TYPESCRIPT_POOL_MIN_SIZE=3
177
+ ENV TYPESCRIPT_POOL_MAX_SIZE=10
93
178
 
94
- # Create clean workspace directory for users
179
+ # Create clean workspace directory for user code
95
180
  RUN mkdir -p /workspace
96
181
 
97
- # Expose the application port (3000 for control, 8888 for Jupyter)
98
- EXPOSE 3000 8888
182
+ # Expose the application port (3000 for control)
183
+ EXPOSE 3000
99
184
 
100
- # Make startup script executable
185
+ # Copy and make startup script executable
186
+ COPY packages/sandbox/startup.sh ./
101
187
  RUN chmod +x startup.sh
102
188
 
103
189
  # Use startup script