@deepseek-ai/dsh-ptc-runtime-node 0.2.0-rc.2 → 0.2.1-alpha.2

package/README.i18n.yaml

@@ -18,8 +18,8 @@
   en: 246231cf2a529550
   zh: 2b4ed96194acc639
 /deepseek-ai-dsh-ptc-runtime-node/use-this-package/configuration:
-  en: e5bca585d02f08ca
-  zh: a2e9a32fe4052d90
+  en: d8c1109db9f679ca
+  zh: 9c21a0bebc3a1c43
 /deepseek-ai-dsh-ptc-runtime-node/use-this-package/execution-and-results:
   en: 6d65b39223ca9f7a
   zh: 96f96341ecab1317
@@ -36,11 +36,11 @@
   en: 45527dad94dd9362
   zh: c1e1179391e89a3f
 /deepseek-ai-dsh-ptc-runtime-node/understand-the-implementation/source-and-built-bootstraps:
-  en: c01071304a9d563a
-  zh: 2938a64b13a257d8
+  en: 871adc8d69b07c85
+  zh: 2456b431749e78e0
 /deepseek-ai-dsh-ptc-runtime-node/understand-the-implementation/source-map:
-  en: a6702856dec3d449
-  zh: 0c442a74c8005571
+  en: e4cab2eb3f09e74b
+  zh: 5c10e8c4c0d9e56b
 /deepseek-ai-dsh-ptc-runtime-node/further-exploration:
   en: ac2e2ae13d3f1394
   zh: 5d08b9c658fcf83a

package/README.md

@@ -52,8 +52,7 @@ Configure the provider row after its required services are available:
 | `maxMessageBytes` | `134,217,728` | Limit for a control frame, outstanding argument bytes and queued control writes |
 | `maxPendingCalls` | `128` | Maximum simultaneous host binding calls |
 | `graceMs` | `3,000` | Managed termination and output-drain grace |
-| `nodeExecutable` | Current Node executable | Executable resolved in the subprocess execution world |
-| `bootstrapPath` | Package bootstrap | Optional absolute path to a preinstalled built bootstrap in that world |
+| `launch` | Local carrier | Explicit `{ kind: "node-script", executable, bootstrapPath? }` or `{ kind: "embedded", executable }` in the subprocess world |
 
 The [configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-ptc-runtime-node) defines accepted config fields. `resolve(request)` supplies cwd, the numeric or null deadline choice and the execution policy; `run(spec)` accepts those resolved inputs and does not fill missing values.
 
@@ -91,7 +90,7 @@ Length-framed JSON travels separately from stdout/stderr. The host bounds frames
 
 ### Source and built bootstraps
 
-Source execution loads an erasable-only bootstrap closure without relying on sibling built exports. Built execution uses the packaged `process.js` entry. An execution world that cannot map the host bootstrap requires a preinstalled compatible `bootstrapPath`; a host path is never assumed to name the same remote file.
+Source execution loads an erasable-only bootstrap closure without relying on sibling built exports. Built script execution uses `process.js`; a remote script deployment supplies `launch.bootstrapPath`. Embedded carriers launch their private worker through `launch.executable`. `resolveLaunch()` selects the local default during construction; an explicit remote invocation never depends on whether the client itself is packaged. A host path is never assumed to name the same remote file.
 
 ### Source map
 
@@ -103,7 +102,6 @@ Source execution loads an erasable-only bootstrap closure without relying on sib
 | [`src/bootstrap.ts`](src/bootstrap.ts) | Program evaluation, binding proxies and output capture |
 | [`src/channel.ts`](src/channel.ts) | Framing, bounded writes and protocol failures |
 | [`src/output-ledger.ts`](src/output-ledger.ts) | Host accounting for the outer result |
-| — | No runtime invariant companion is published; framing and process cleanup are enforced across the process boundary rather than through independent same-process observations. |
 
 </details>
 

package/README.zh.md

@@ -52,8 +52,7 @@ kind: "package-reference"
 | `maxMessageBytes` | `134,217,728` | 控制帧、未完成参数字节和排队控制写入的上限 |
 | `maxPendingCalls` | `128` | 同时进行的 Host 绑定调用数量上限 |
 | `graceMs` | `3,000` | 受管终止与输出排空宽限时间 |
-| `nodeExecutable` | 当前 Node 可执行文件 | 在子进程执行世界中解析的可执行文件 |
-| `bootstrapPath` | 包内 bootstrap | 该执行世界中预先安装的构建后 bootstrap 的可选绝对路径 |
+| `launch` | 本地载体 | 子进程环境中显式的 `{ kind: "node-script", executable, bootstrapPath? }` 或 `{ kind: "embedded", executable }` |
 
 [配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-ptc-runtime-node)定义可接受的配置字段。`resolve(request)` 补全 cwd、数值或 null 截止选择与执行策略；`run(spec)` 接受这些已解析输入，不补缺省值。
 
@@ -91,7 +90,7 @@ Host 擦除可擦除类型，在配置的执行世界中解析可执行文件与
 
 ### 源代码与构建后 bootstrap
 
-源代码执行加载仅含可擦除语法的 bootstrap 依赖，不依赖同级包的构建后导出。构建后执行使用包内 `process.js` 入口。无法映射 Host bootstrap 的执行世界需要预先安装兼容的 `bootstrapPath`；不会假设 Host 路径对应同一个远程文件。
+源代码执行加载仅含可擦除语法的 bootstrap 依赖，不依赖同级包的构建后导出。构建后脚本使用 `process.js`，远端脚本部署提供 `launch.bootstrapPath`。内嵌载体通过 `launch.executable` 启动私有 worker。`resolveLaunch()` 在构造时选择本地默认值；显式的远端调用不依赖客户端自身是否打包。不会假设 Host 路径对应同一个远程文件。
 
 ### 源码索引
 
@@ -103,7 +102,6 @@ Host 擦除可擦除类型，在配置的执行世界中解析可执行文件与
 | [`src/bootstrap.ts`](src/bootstrap.ts) | 程序求值、绑定代理与输出捕获 |
 | [`src/channel.ts`](src/channel.ts) | 分帧、有界写入与协议失败 |
 | [`src/output-ledger.ts`](src/output-ledger.ts) | Host 外层结果计量 |
-| — | 不发布运行时不变式配套模块；分帧与进程清理跨进程边界强制执行，不依靠同进程中的独立观测。 |
 
 </details>
 

package/lib/index.js

@@ -4,7 +4,7 @@ import z from "@deepseek-ai/schemastery";
 import { DUNDER_MEMBER, PORTABLE_RESERVED_WORDS, PtcRuntime, RESERVED_BINDING_GLOBALS, RESERVED_ERROR_MEMBERS } from "@deepseek-ai/dsh-ptc-runtime";
 import { MAX_TIMER_DELAY_MS, clampTimeout } from "@deepseek-ai/dsh-timeout";
 import { SandboxUnavailableError, classifyRunnerFailure, isRunnerSpawnFailure } from "@deepseek-ai/dsh-sandbox";
-import { snapshotJsonValue } from "@deepseek-ai/dsh-util-values";
+import { assertNever, snapshotJsonValue } from "@deepseek-ai/dsh-util-values";
 import { Buffer as Buffer$1 } from "node:buffer";
 import { fileURLToPath, pathToFileURL } from "node:url";
 //#region lib/types/bindings.js
@@ -340,15 +340,36 @@ var JsonChannel = class {
 //#region lib/types/launch.js
 /** Select source or built bootstrap assets in the mounted execution world. */
 /**
+* Resolve the local carrier default or validate an explicit execution-world invocation.
+* @param config - explicit remote or local worker configuration; omitted selects this carrier.
+* @returns the worker invocation without guessing from the execution world's paths.
+*/
+function resolveLaunch(config) {
+	const launch = config ?? {
+		kind: "pkg" in process ? "embedded" : "node-script",
+		executable: process.execPath
+	};
+	if (launch.executable.length === 0) throw new Error("ptc-runtime-node: launch.executable must be non-empty");
+	if (launch.kind === "node-script" && launch.bootstrapPath !== void 0 && !isAbsolute(launch.bootstrapPath)) throw new Error("ptc-runtime-node: launch.bootstrapPath must be absolute");
+	return launch;
+}
+/**
 * Select explicit arguments without inheriting host loader or inspector flags.
 * @param fs - Filesystem mapping host bootstrap assets into the process world.
-* @param config - Optional preinstalled built bootstrap.
+* @param config - resolved worker invocation.
 * @param maxMessageBytes - Validated frame and queued-write limit.
 * @returns Arguments following the resolved Node executable.
 */
 function bootstrapArgs(fs, config, maxMessageBytes) {
-	if (config.bootstrapPath !== void 0) return [config.bootstrapPath, String(maxMessageBytes)];
-	if ("pkg" in process) return [String(maxMessageBytes)];
+	switch (config.kind) {
+		case "embedded": return [String(maxMessageBytes)];
+		case "node-script": return scriptBootstrapArgs(fs, config.bootstrapPath, maxMessageBytes);
+		/* v8 ignore next -- Callers supply the resolved, closed LaunchConfig union. */
+		default: return assertNever(config);
+	}
+}
+function scriptBootstrapArgs(fs, bootstrapPath, maxMessageBytes) {
+	if (bootstrapPath !== void 0) return [bootstrapPath, String(maxMessageBytes)];
 	const mapped = (path) => {
 		const result = fs.processPathFromHostPath(path);
 		if (result === void 0) throw new Error(`PTC runtime bootstrap is unavailable in the subprocess execution world: ${path}`);
@@ -776,8 +797,14 @@ var NodePtcRuntime = class extends PtcRuntime {
 		maxMessageBytes: z.number().default(134217728),
 		maxPendingCalls: z.number().default(128),
 		graceMs: z.number().default(3e3),
-		nodeExecutable: z.string(),
-		bootstrapPath: z.string()
+		launch: z.union([z.object({
+			kind: z.const("node-script").required(),
+			executable: z.string().required(),
+			bootstrapPath: z.string()
+		}), z.object({
+			kind: z.const("embedded").required(),
+			executable: z.string().required()
+		})])
 	});
 	language = "typescript";
 	isolation = "process";
@@ -791,7 +818,7 @@ var NodePtcRuntime = class extends PtcRuntime {
 		super(ctx);
 		this.config = {
 			...config,
-			nodeExecutable: config.nodeExecutable ?? process.execPath
+			launch: resolveLaunch(config.launch)
 		};
 		for (const [key, value] of Object.entries(this.config)) if (typeof value === "number" && (!Number.isFinite(value) || value <= 0)) throw new Error(`ptc-runtime-node: ${key} must be positive and finite`);
 		for (const key of [
@@ -803,8 +830,6 @@ var NodePtcRuntime = class extends PtcRuntime {
 		if (!Number.isSafeInteger(this.config.maxMessageBytes) || this.config.maxMessageBytes > 4294967295) throw new Error("ptc-runtime-node: maxMessageBytes must fit an unsigned 32-bit frame length");
 		if (!Number.isSafeInteger(this.config.maxPendingCalls)) throw new Error("ptc-runtime-node: maxPendingCalls must be an integer");
 		if (!Number.isSafeInteger(this.config.maxOldGenerationSizeMb)) throw new Error("ptc-runtime-node: maxOldGenerationSizeMb must be an integer");
-		if (this.config.nodeExecutable.length === 0) throw new Error("ptc-runtime-node: nodeExecutable must be non-empty");
-		if (this.config.bootstrapPath !== void 0 && !isAbsolute(this.config.bootstrapPath)) throw new Error("ptc-runtime-node: bootstrapPath must be absolute");
 		ctx.effect(() => async () => {
 			this.disposed = true;
 			const active = [...this.live];
@@ -938,14 +963,14 @@ var NodePtcRuntime = class extends PtcRuntime {
 				})),
 				maxOutputBytes: this.config.maxOutputBytes
 			};
-			const executable = await this.ctx.subprocess.resolveExecutable(this.config.nodeExecutable, void 0, signal);
+			const executable = await this.ctx.subprocess.resolveExecutable(this.config.launch.executable, void 0, signal);
 			if (settled) return await result.promise;
-			const packaged = "pkg" in process && this.config.bootstrapPath === void 0;
+			const packaged = this.config.launch.kind === "embedded";
 			const heapFlag = `--max-old-space-size=${this.config.maxOldGenerationSizeMb}`;
 			const argv = [
 				executable,
 				...packaged ? [] : [heapFlag],
-				...bootstrapArgs(this.ctx.fs, this.config, this.config.maxMessageBytes)
+				...bootstrapArgs(this.ctx.fs, this.config.launch, this.config.maxMessageBytes)
 			];
 			confined = policy.mode === "danger-full-access" ? void 0 : await this.ctx.sandbox.confine(argv, {
 				...policy,

package/lib/types/index.d.ts

@@ -4,8 +4,11 @@ import { PtcRuntime } from '@deepseek-ai/dsh-ptc-runtime';
 import type { PtcRunRequest, PtcRunResult, PtcRunSpec } from '@deepseek-ai/dsh-ptc-runtime';
 import type { SandboxMode } from '@deepseek-ai/dsh-sandbox';
 import type { LaunchConfig } from './launch.ts';
+export type { LaunchConfig } from './launch.ts';
 /** Deployment-varying runtime bounds and launch choices. */
-export interface Config extends LaunchConfig {
+export interface Config {
+    /** Worker invocation in the subprocess world; omitted selects the local carrier. */
+    launch?: LaunchConfig;
     /** Default elapsed deadline, including nested tool and approval waits. */
     timeoutMs?: number;
     /** Maximum numeric elapsed budget accepted by resolve. */

package/lib/types/launch.d.ts

@@ -1,17 +1,30 @@
 import type { FileSystem } from '@deepseek-ai/dsh-fs';
-/** Deployment-owned Node executable and optional preinstalled built bootstrap. */
-export interface LaunchConfig {
-    /** Executable in the subprocess world; defaults to the current Node executable. */
-    nodeExecutable?: string;
-    /** Absolute preinstalled built bootstrap in the execution world. */
+/** Deployment-owned worker invocation in the subprocess execution world. */
+export type LaunchConfig = {
+    /** Start a separately installed Node executable and JavaScript bootstrap. */
+    kind: 'node-script';
+    /** Executable name or path resolved by the subprocess provider. */
+    executable: string;
+    /** Absolute preinstalled bootstrap; omitted maps this package's bootstrap into the execution world. */
     bootstrapPath?: string;
-}
+} | {
+    /** Start the private PTC worker embedded in a packaged executable. */
+    kind: 'embedded';
+    /** Packaged executable name or path resolved by the subprocess provider. */
+    executable: string;
+};
+/**
+ * Resolve the local carrier default or validate an explicit execution-world invocation.
+ * @param config - explicit remote or local worker configuration; omitted selects this carrier.
+ * @returns the worker invocation without guessing from the execution world's paths.
+ */
+export declare function resolveLaunch(config?: LaunchConfig): LaunchConfig;
 /**
  * Select explicit arguments without inheriting host loader or inspector flags.
  * @param fs - Filesystem mapping host bootstrap assets into the process world.
- * @param config - Optional preinstalled built bootstrap.
+ * @param config - resolved worker invocation.
  * @param maxMessageBytes - Validated frame and queued-write limit.
  * @returns Arguments following the resolved Node executable.
  */
-export declare function bootstrapArgs(fs: FileSystem, config: LaunchConfig, maxMessageBytes: number): string[];
+export declare function bootstrapArgs(fs: Pick<FileSystem, 'processPathFromHostPath'>, config: LaunchConfig, maxMessageBytes: number): string[];
 //# sourceMappingURL=launch.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-ptc-runtime-node",
   "description": "Sandboxed Node process implementation of the DeepSeek Harness PTC execution capability",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -31,31 +31,31 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-timeout": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-ptc-runtime": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-fs": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-subprocess": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-sandbox": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-sandbox-policy": "0.2.0-rc.2"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-ptc-runtime": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-subprocess": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-sandbox": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.1-alpha.2"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-util-values": "0.2.0-rc.2",
-    "@deepseek-ai/schemastery": "~3.18.4"
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.2",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-ptc-runtime": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-timeout": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-fs": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-subprocess": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-sandbox": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-sandbox-policy": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-subprocess-local": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-sandbox-local": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-fs-local": "0.2.0-rc.2"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-ptc-runtime": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-subprocess": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-sandbox": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-subprocess-local": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-sandbox-local": "0.2.1-alpha.2"
   }
 }