@cloudflare/sandbox 0.0.0-871f813 → 0.0.0-89632aa

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 (68) hide show
  1. package/CHANGELOG.md +234 -0
  2. package/Dockerfile +173 -89
  3. package/README.md +92 -707
  4. package/dist/index.d.ts +1953 -0
  5. package/dist/index.d.ts.map +1 -0
  6. package/dist/index.js +3280 -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 +98 -0
  13. package/src/clients/index.ts +64 -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 +156 -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 +94 -44
  25. package/src/interpreter.ts +62 -44
  26. package/src/request-handler.ts +94 -55
  27. package/src/sandbox.ts +887 -397
  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 +487 -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 +739 -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/handler/exec.ts +0 -340
  52. package/container_src/handler/file.ts +0 -844
  53. package/container_src/handler/git.ts +0 -182
  54. package/container_src/handler/ports.ts +0 -314
  55. package/container_src/handler/process.ts +0 -640
  56. package/container_src/index.ts +0 -656
  57. package/container_src/jupyter-server.ts +0 -579
  58. package/container_src/jupyter-service.ts +0 -458
  59. package/container_src/jupyter_config.py +0 -48
  60. package/container_src/mime-processor.ts +0 -255
  61. package/container_src/package.json +0 -18
  62. package/container_src/startup.sh +0 -84
  63. package/container_src/types.ts +0 -108
  64. package/src/client.ts +0 -1021
  65. package/src/errors.ts +0 -218
  66. package/src/interpreter-types.ts +0 -383
  67. package/src/jupyter-client.ts +0 -349
  68. package/src/types.ts +0 -401
package/CHANGELOG.md CHANGED
@@ -1,5 +1,239 @@
1
1
  # @cloudflare/sandbox
2
2
 
3
+ ## 0.4.17
4
+
5
+ ### Patch Changes
6
+
7
+ - [#198](https://github.com/cloudflare/sandbox-sdk/pull/198) [`93c6cc7`](https://github.com/cloudflare/sandbox-sdk/commit/93c6cc7c6b8df9e0a733fa852faf5d2f1c5758da) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix container startup failures when WORKDIR is changed in derived Dockerfiles
8
+
9
+ ## 0.4.16
10
+
11
+ ### Patch Changes
12
+
13
+ - [#184](https://github.com/cloudflare/sandbox-sdk/pull/184) [`7989b61`](https://github.com/cloudflare/sandbox-sdk/commit/7989b6105cea8c381dd162be0bcb29db3e214fde) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Redact credentials from Git URLs in logs
14
+
15
+ - [#186](https://github.com/cloudflare/sandbox-sdk/pull/186) [`c2e3384`](https://github.com/cloudflare/sandbox-sdk/commit/c2e3384b151ae3f430c2edc8c492921d0b6b8b1c) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - Expose deleteSession API with proper safeguards
16
+ - Add `deleteSession(sessionId)` method to public SDK API
17
+ - Prevent deletion of default session (throws error with guidance to use `sandbox.destroy()`)
18
+ - Session cleanup kills all running commands in parallel before destroying shell
19
+ - Return structured `SessionDeleteResult` with success status, sessionId, and timestamp
20
+
21
+ ## 0.4.15
22
+
23
+ ### Patch Changes
24
+
25
+ - [#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
26
+
27
+ - [#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
28
+
29
+ ## 0.4.14
30
+
31
+ ### Patch Changes
32
+
33
+ - [#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
34
+
35
+ - [#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
36
+
37
+ 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.
38
+
39
+ - [#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
40
+
41
+ We inline types from `@repo/shared` so that it includes the types we reexport. Fixes #165
42
+
43
+ - [#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
44
+
45
+ ## 0.4.13
46
+
47
+ ### Patch Changes
48
+
49
+ - [#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
50
+
51
+ We inline types from `@repo/shared` so that it includes the types we reexport. Fixes #165
52
+
53
+ - [#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
54
+
55
+ ## 0.4.12
56
+
57
+ ### Patch Changes
58
+
59
+ - [#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
60
+
61
+ ## 0.4.11
62
+
63
+ ### Patch Changes
64
+
65
+ - [#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
66
+
67
+ ## 0.4.10
68
+
69
+ ### Patch Changes
70
+
71
+ - [#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
72
+
73
+ ## 0.4.9
74
+
75
+ ### Patch Changes
76
+
77
+ - [#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
78
+
79
+ 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()`.
80
+
81
+ The implementation is end-to-end:
82
+ - New `FileExistsResult` and `FileExistsRequest` types in shared package
83
+ - Handler endpoint at `/api/exists` in container layer
84
+ - Client method in `FileClient` and `Sandbox` classes
85
+ - Full test coverage (unit tests and E2E tests)
86
+
87
+ ## 0.4.8
88
+
89
+ ### Patch Changes
90
+
91
+ - [#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
92
+
93
+ ## 0.4.7
94
+
95
+ ### Patch Changes
96
+
97
+ - [#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
98
+
99
+ - [#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
100
+
101
+ ## 0.4.6
102
+
103
+ ### Patch Changes
104
+
105
+ - [#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
106
+
107
+ ## 0.4.5
108
+
109
+ ### Patch Changes
110
+
111
+ - [#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
112
+
113
+ ## 0.4.4
114
+
115
+ ### Patch Changes
116
+
117
+ - [#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
118
+
119
+ ## 0.4.3
120
+
121
+ ### Patch Changes
122
+
123
+ - [#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)
124
+
125
+ ## 0.4.2
126
+
127
+ ### Patch Changes
128
+
129
+ - [`e53d7e7`](https://github.com/cloudflare/sandbox-sdk/commit/e53d7e7ce185f79bdd899029bb532e9651ae7ba5) Thanks [@threepointone](https://github.com/threepointone)! - fix build by inlining repo/shared
130
+
131
+ ## 0.4.1
132
+
133
+ ### Patch Changes
134
+
135
+ - [#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
136
+
137
+ ## 0.4.0
138
+
139
+ ### Minor Changes
140
+
141
+ - [#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.
142
+
143
+ ### Patch Changes
144
+
145
+ - [#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
146
+
147
+ ## 0.3.3
148
+
149
+ ### Patch Changes
150
+
151
+ - [#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
152
+
153
+ ## 0.3.2
154
+
155
+ ### Patch Changes
156
+
157
+ - [#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.
158
+
159
+ ## 0.3.1
160
+
161
+ ### Patch Changes
162
+
163
+ - [#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
164
+
165
+ - [#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
166
+
167
+ - [#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
168
+
169
+ - [#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.
170
+
171
+ ## 0.3.0
172
+
173
+ ### Minor Changes
174
+
175
+ - [#59](https://github.com/cloudflare/sandbox-sdk/pull/59) [`b6757f7`](https://github.com/cloudflare/sandbox-sdk/commit/b6757f730c34381d5a70d513944bbf9840f598ab) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Add process isolation for sandbox commands
176
+
177
+ 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.
178
+
179
+ **Key security improvements:**
180
+ - Control plane processes are hidden from sandboxed commands
181
+ - Platform secrets in `/proc/1/environ` are inaccessible
182
+ - Ports 8888 (Jupyter) and 3000 (Bun) are protected from hijacking
183
+
184
+ **Breaking changes:**
185
+ 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.
186
+
187
+ ```javascript
188
+ // Before: manual session management
189
+ await sandbox.exec('cd /app', { sessionId: 'my-session' });
190
+
191
+ // After: automatic session per sandbox
192
+ await sandbox.exec('cd /app');
193
+ ```
194
+
195
+ 2. **Commands now maintain state**: Commands within the same sandbox now share state (working directory, environment variables, background processes). Previously each command was stateless.
196
+
197
+ ```javascript
198
+ // Before: each exec was independent
199
+ await sandbox.exec('cd /app');
200
+ await sandbox.exec('pwd'); // Output: /workspace
201
+
202
+ // After: state persists in session
203
+ await sandbox.exec('cd /app');
204
+ await sandbox.exec('pwd'); // Output: /app
205
+ ```
206
+
207
+ **Migration guide:**
208
+ - Remove `sessionId` from all method calls - each sandbox maintains its own session
209
+ - If you need isolated execution contexts within the same sandbox, use `sandbox.createSession()`:
210
+ ```javascript
211
+ // Create independent sessions with different environments
212
+ const buildSession = await sandbox.createSession({
213
+ name: 'build',
214
+ env: { NODE_ENV: 'production' },
215
+ cwd: '/build'
216
+ });
217
+ const testSession = await sandbox.createSession({
218
+ name: 'test',
219
+ env: { NODE_ENV: 'test' },
220
+ cwd: '/test'
221
+ });
222
+ ```
223
+ - Environment variables set in one command persist to the next
224
+ - Background processes remain active until explicitly killed
225
+ - Requires CAP_SYS_ADMIN (available in production, falls back gracefully in dev)
226
+
227
+ ### Patch Changes
228
+
229
+ - [#62](https://github.com/cloudflare/sandbox-sdk/pull/62) [`4bedc3a`](https://github.com/cloudflare/sandbox-sdk/commit/4bedc3aba347f3d4090a6efe2c9778bac00ce74a) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix broken build due to bun lockfile not being used
230
+
231
+ ## 0.2.4
232
+
233
+ ### Patch Changes
234
+
235
+ - [#57](https://github.com/cloudflare/sandbox-sdk/pull/57) [`12bbd12`](https://github.com/cloudflare/sandbox-sdk/commit/12bbd1229c07ef8c1c0bf58a4235a27938155b08) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Add listFiles method
236
+
3
237
  ## 0.2.3
4
238
 
5
239
  ### Patch Changes
package/Dockerfile CHANGED
@@ -1,106 +1,190 @@
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
+ CI=true 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
+ CI=true 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
- sudo \
37
- ca-certificates \
38
- gnupg \
39
- lsb-release \
40
- strace \
41
- && 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
42
136
 
43
137
  # Set Python 3.11 as default python3
44
- RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1
45
-
46
- # Install Node.js 20 LTS
47
- # Using the official NodeSource repository setup script
48
- RUN apt-get update && apt-get install -y ca-certificates curl gnupg \
49
- && mkdir -p /etc/apt/keyrings \
50
- && curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg \
51
- && echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list \
52
- && apt-get update \
53
- && apt-get install -y nodejs \
54
- && rm -rf /var/lib/apt/lists/*
55
-
56
- # Install Bun from official image (avoids architecture compatibility issues)
57
- COPY --from=bun-source /usr/local/bin/bun /usr/local/bin/bun
58
- COPY --from=bun-source /usr/local/bin/bunx /usr/local/bin/bunx
59
-
60
- # Install minimal Jupyter components
61
- RUN pip3 install --no-cache-dir \
62
- jupyter-server \
63
- jupyter-client \
64
- ipykernel \
65
- orjson \
66
- && python3 -m ipykernel install --user --name python3
67
-
68
- # Install scientific packages
69
- RUN pip3 install --no-cache-dir \
70
- matplotlib \
71
- numpy \
72
- pandas \
73
- seaborn
74
-
75
- # Install JavaScript kernel (ijavascript) - using E2B's fork
76
- RUN npm install -g --unsafe-perm git+https://github.com/e2b-dev/ijavascript.git \
77
- && ijsinstall --install=global
78
-
79
- # 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
80
154
  WORKDIR /container-server
81
155
 
82
- # Verify installations
83
- RUN python3 --version && \
84
- node --version && \
85
- npm --version && \
86
- bun --version && \
87
- jupyter --version && \
88
- 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/
162
+
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
89
166
 
90
- # Copy container source files to server directory
91
- COPY container_src/package.json ./
92
- RUN bun install
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
93
170
 
94
- COPY container_src/ ./
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
95
178
 
96
- # Create clean workspace directory for users
179
+ # Create clean workspace directory for user code
97
180
  RUN mkdir -p /workspace
98
181
 
99
- # Expose the application port (3000 for control, 8888 for Jupyter)
100
- EXPOSE 3000 8888
182
+ # Expose the application port (3000 for control)
183
+ EXPOSE 3000
101
184
 
102
- # Make startup script executable
185
+ # Copy and make startup script executable
186
+ COPY packages/sandbox/startup.sh ./
103
187
  RUN chmod +x startup.sh
104
188
 
105
189
  # Use startup script
106
- CMD ["./startup.sh"]
190
+ CMD ["/container-server/startup.sh"]