@deepseek-ai/dsh-e2b 0.1.2-rc.1 → 0.1.5-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/e2b/e2b/README.md
-README.md: 7d8c5728ee5e8243165338cddb1930f34e8f7d3f
-README.zh.md: b4f0854d6b76875fcadd9cc07a4b014310a0cfbb
+README.md: 09c23e4540b708ada5fc6d485806058793937a09
+README.zh.md: 0e63443c1fb962895669649e52e3809b0e95397d

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-`dsh-e2b` provides one shared remote Linux sandbox for the E2B provider family: the agent's file operations, shell commands, and terminals all run inside this sandbox instead of on your machine. The sandbox is created when the family starts and deleted automatically when the configured lifetime expires or the app shuts down — anything it held disappears with it. You configure three things: an API key, a remote working directory, and the sandbox lifetime. Use it together with `dsh-fs-e2b` and `dsh-subprocess-e2b`; on its own it adds no user-visible features. Nothing here reaches the model, and no shipped composition enables this family by default.
+`dsh-e2b` runs the agent's file operations, shell commands, and terminals in one shared remote Linux sandbox instead of on your machine. The sandbox is created at startup and deleted when its configured lifetime expires or the app shuts down, so everything it holds is ephemeral. Configure an API key, an absolute remote working directory, and the sandbox lifetime. Use it with `dsh-fs-e2b` and `dsh-subprocess-e2b`; by itself it adds no user-visible capability. It sends nothing to the model, and no shipped composition enables E2B by default.
 
 ## Table of Contents
 

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-`dsh-e2b` 为 E2B 提供方家族提供一个共享的远程 Linux 沙箱：agent（智能体）的文件操作、shell 命令与终端都在这个沙箱内运行，而不是在你的机器上。家族启动时沙箱会自动创建，并在配置的生命周期到期或应用关闭时自动删除——其中保存的一切都会随之消失。你需要配置三件事：API 密钥、远程工作目录与沙箱生命周期。请与 `dsh-fs-e2b`、`dsh-subprocess-e2b` 一起使用；单独挂载它不会带来任何用户可见的功能。这里的一切都不会触及模型，而且任何已发布的组合都不会默认启用本家族。
+`dsh-e2b` 让 agent（智能体）的文件操作、shell 命令与终端在一个共享的远程 Linux 沙箱内运行，而不是在你的机器上。应用启动时会创建沙箱，并在配置的生命周期到期或应用关闭时删除它，因此其中保存的一切都是短暂的。请配置 API 密钥、绝对远程工作目录与沙箱生命周期。请与 `dsh-fs-e2b`、`dsh-subprocess-e2b` 一起使用；单独使用它不会带来任何用户可见的能力。它不会向模型发送任何内容，而且任何已发布的组合都不会默认启用 E2B。
 
 ## 目录
 

package/lib/index.js

@@ -3,6 +3,32 @@ import { posix } from "node:path";
 import { Service } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";
 import { CommandExitError, FileNotFoundError, FileType, FileType as FileType$1, Sandbox, Sandbox as Sandbox$1, SandboxNotFoundError, SandboxNotFoundError as SandboxNotFoundError$1 } from "e2b";
+import { proxyRouteFor } from "@deepseek-ai/dsh-http-proxy";
+//#region lib/types/api-url.js
+/**
+* The E2B control-plane URL, derived the way the SDK derives it.
+* @module @deepseek-ai/dsh-e2b/src/api-url.ts
+*/
+/** The SDK's own default control-plane domain; `E2B_DOMAIN` overrides it there and here alike. */
+const E2B_DEFAULT_DOMAIN = "e2b.app";
+/** The debug control plane the SDK substitutes, on loopback and plain HTTP. */
+const E2B_DEBUG_API_URL = "http://localhost:3000";
+/**
+* The control-plane URL the SDK will actually call, derived the way the SDK derives it: an explicit
+* `E2B_API_URL` first, then the debug substitute, then the domain default. Choosing a proxy for
+* anything else would pick the wrong scheme's proxy, ignore a bypass entry naming the real host, and
+* — for the loopback debug plane — hand a proxy the control-plane traffic and its API key.
+*
+* @param env - the process environment to read; overridable so tests need no ambient state.
+* @returns the absolute control-plane URL.
+*/
+function e2bApiUrl(env = process.env) {
+	const explicit = env.E2B_API_URL;
+	if (explicit !== void 0 && explicit !== "") return explicit;
+	if ((env.E2B_DEBUG ?? "false").toLowerCase() === "true") return E2B_DEBUG_API_URL;
+	return `https://api.${env.E2B_DOMAIN ?? E2B_DEFAULT_DOMAIN}`;
+}
+//#endregion
 //#region lib/types/index.js
 /**
 * Shared ownership of one E2B sandbox. Capability adapters await the same SDK
@@ -92,11 +118,13 @@ var E2BRuntime = class extends Service {
 		if (!Number.isFinite(this.config.timeoutMs) || this.config.timeoutMs <= 0) throw new Error("dsh-e2b: timeoutMs must be a positive finite number");
 	}
 	async open() {
+		const route = proxyRouteFor(new URL(e2bApiUrl()));
 		const sandbox = await Sandbox$1.create({
 			apiKey: this.config.apiKey,
 			timeoutMs: this.config.timeoutMs,
 			secure: true,
-			lifecycle: { onTimeout: "kill" }
+			lifecycle: { onTimeout: "kill" },
+			...route.proxied ? { proxy: route.proxy } : {}
 		});
 		try {
 			await sandbox.files.makeDir(this.cwd);

package/lib/types/api-url.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The E2B control-plane URL, derived the way the SDK derives it.
+ * @module @deepseek-ai/dsh-e2b/src/api-url.ts
+ */
+/**
+ * The control-plane URL the SDK will actually call, derived the way the SDK derives it: an explicit
+ * `E2B_API_URL` first, then the debug substitute, then the domain default. Choosing a proxy for
+ * anything else would pick the wrong scheme's proxy, ignore a bypass entry naming the real host, and
+ * — for the loopback debug plane — hand a proxy the control-plane traffic and its API key.
+ *
+ * @param env - the process environment to read; overridable so tests need no ambient state.
+ * @returns the absolute control-plane URL.
+ */
+export declare function e2bApiUrl(env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=api-url.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-e2b",
   "description": "Shared E2B sandbox lifecycle for DeepSeek Harness provider adapters",
-  "version": "0.1.2-rc.1",
+  "version": "0.1.5-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -27,6 +27,7 @@
   ],
   "license": "MIT",
   "peerDependencies": {
+    "@deepseek-ai/dsh-http-proxy": "^0.1.5-alpha.1",
     "@deepseek-ai/cordis": "^4.0.2"
   },
   "dependencies": {
@@ -34,19 +35,22 @@
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-app-boot": "^0.1.2-rc.1",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-bash-local": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-fs-e2b": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-loader-smoke": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-lsp": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-lsp-stdio": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-sandbox-policy": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session-projection": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-subprocess-e2b": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-terminal": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-terminal-bash": "^0.1.2-rc.1"
+    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-app-boot": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-bash-local": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-fs-e2b": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-loader-smoke": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-lsp": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-lsp-stdio": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-subprocess-e2b": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-terminal": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-terminal-bash": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-http-proxy": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-launch-environment": "^0.1.5-alpha.1"
   }
 }