@deepseek-ai/dsh-experimental-inspector 0.2.1-alpha.2 → 0.2.1-alpha.4

package/README.i18n.yaml

@@ -18,8 +18,8 @@
   en: 6d290aabc543f878
   zh: 7ad283b159ae2c29
 /deepseek-ai-dsh-experimental-inspector/runtime-layout:
-  en: 30dad7b7fe3b3465
-  zh: 2bda395981802f59
+  en: 13f495af2fec307d
+  zh: ec4bebf24a87ec54
 /deepseek-ai-dsh-experimental-inspector/configuration:
   en: d094842893700446
   zh: 7a7f880ba795948f

package/README.md

@@ -48,7 +48,7 @@ The frontend uses browser runtime adapters and excludes Node-only transports at
 <a id="runtime-layout"></a>
 ## Runtime layout
 
-The Worker never accesses live Cordis objects: the shared Host/Client collector projects them into validated snapshots before transport. Cordis owns plugin composition, `ctx.inspector` registration, bootstrap injection, and disposal. A late-loading Client fetches its bootstrap through an authenticated Host route. Bootstrap transport and source-setup failures warn and retain connection-reset recovery for both injected and fetched startup; invalid bootstrap data or service-registration failures reject startup. Source replacement joins old service-consumer cleanup before claiming another source, and unloading an active plugin cancels its pending bootstrap refresh.
+The Worker never accesses live Cordis objects: the shared Host/Client collector projects them into validated snapshots before transport. Cordis owns plugin composition, `ctx.inspector` registration, bootstrap injection, and disposal. A late-loading Client fetches its bootstrap through an authenticated Host route, which the Host registers before it starts the Worker: a request waits for Worker readiness and then receives the bootstrap, or `503` when startup fails; an aborted request stops waiting. When the platform cannot run the Worker and reports Node's `ERR_FEATURE_UNAVAILABLE_ON_PLATFORM`, such as the browser preview's Worker host, the Host logs one warning and the plugin still starts with only that route, which answers `503`; it provides no `ctx.inspector`, DevTools routes, bootstrap injection, or `devtools://` URL. Any other startup error still rejects the plugin. Bootstrap transport and source-setup failures warn and retain connection-reset recovery for both injected and fetched startup; invalid bootstrap data or service-registration failures reject startup. Source replacement joins old service-consumer cleanup before claiming another source, and unloading an active plugin cancels its pending bootstrap refresh.
 
 The Host plugin starts the Worker and connects a dedicated `MessagePort`. The Client uses injected or fetched browser-source parameters to open an authenticated WebSocket directly to the Worker; it receives no DevTools URL. Chrome DevTools connects to the Worker's CDP WebSocket. A private `node:inspector.Session` per DevTools connection attaches from the Worker to the Host main thread, so Host debugging remains available while Host JavaScript is paused.
 

package/README.zh.md

@@ -48,7 +48,7 @@ Host 在相对于应用根目录的 `inspector/devtools/devtools_app.html` 路
 <a id="runtime-layout"></a>
 ## 运行时布局
 
-Worker 不访问实时 Cordis 对象；共享 Host/Client collector 会在传输前把它们投影成已验证快照。Cordis 负责插件组合、注册 `ctx.inspector`、注入 bootstrap 和 dispose（资源释放）。后加载的 Client 通过已鉴权的 Host 路由获取 bootstrap。初始注入与主动获取两条路径中，bootstrap 传输或 source 建立失败均记录警告并保留连接重置后的重试；bootstrap 数据非法或服务注册失败则使启动失败。替换 source 会等待旧服务消费者清理完成，再申请新 source；卸载已激活插件会取消其未完成的 bootstrap 刷新。
+Worker 不访问实时 Cordis 对象；共享 Host/Client collector 会在传输前把它们投影成已验证快照。Cordis 负责插件组合、注册 `ctx.inspector`、注入 bootstrap 和 dispose（资源释放）。后加载的 Client 通过已鉴权的 Host 路由获取 bootstrap。Host 在启动 Worker 之前注册该路由，请求会等到 Worker 就绪后返回 bootstrap，启动失败时返回 `503`；请求中止时立即停止等待。当前平台无法运行 Worker 并报告 Node 的 `ERR_FEATURE_UNAVAILABLE_ON_PLATFORM` 时（例如浏览器预览的 Worker host），Host 记录一条警告，插件仍照常启动，只保留该路由并返回 `503`，不提供 `ctx.inspector`、DevTools 路由、bootstrap 注入或 `devtools://` URL；其他任何启动错误仍使插件启动失败。初始注入与主动获取两条路径中，bootstrap 传输或 source 建立失败均记录警告并保留连接重置后的重试；bootstrap 数据非法或服务注册失败则使启动失败。替换 source 会等待旧服务消费者清理完成，再申请新 source；卸载已激活插件会取消其未完成的 bootstrap 刷新。
 
 Host 插件启动 Worker 并连接专用 `MessagePort`。Client 使用注入或主动获取的浏览器 source 参数，直接向 Worker 打开带鉴权的 WebSocket，不接收 DevTools URL。Chrome DevTools 连接 Worker 的 CDP WebSocket。每条 DevTools 连接在 Worker 中独占一个连接 Host 主线程的 `node:inspector.Session`，因此 Host JavaScript 暂停时仍可调试 Host。
 

package/icon.svg

@@ -1,12 +1,23 @@
 <svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <circle cx="15.5" cy="15.5" r="8.5" fill="url(#a)" />
-  <circle cx="15.5" cy="15.5" r="5" fill="#FFFFFF" />
-  <path d="M13.2 15.5L14.9 17.2L18.2 13.9" stroke="#145AF3" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" />
-  <path d="M22 22L29 29" stroke="#145AF3" stroke-width="3.2" stroke-linecap="round" />
+  <g mask="url(#data-lens-cutout)">
+    <rect x="11" y="7" width="16" height="16" rx="2" fill="#7FB7FC" fill-opacity="0.55" />
+    <rect x="7" y="11" width="17" height="15" rx="2" fill="url(#data-panel)" />
+    <path d="M10 15H18M10 18H15" stroke="#FFFFFF" stroke-width="1.5" />
+  </g>
+  <path d="M26 26L30 30" stroke="#658EFF" stroke-width="3" />
+  <circle cx="23" cy="23" r="4.5" stroke="url(#data-lens)" stroke-width="2.5" />
   <defs>
-    <linearGradient id="a" x1="7" y1="7" x2="24" y2="24" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#7CB7FF" />
-      <stop offset="1" stop-color="#45D9E7" />
+    <mask id="data-lens-cutout" maskUnits="userSpaceOnUse" x="0" y="0" width="36" height="36">
+      <rect width="36" height="36" fill="#FFFFFF" />
+      <circle cx="23" cy="23" r="3.25" fill="#000000" />
+    </mask>
+    <linearGradient id="data-panel" x1="9" y1="11" x2="23" y2="26" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#6DB9FB" />
+      <stop offset="1" stop-color="#3650DE" />
+    </linearGradient>
+    <linearGradient id="data-lens" x1="19" y1="19" x2="27" y2="27" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#45D9E7" />
+      <stop offset="1" stop-color="#67C7FE" />
     </linearGradient>
   </defs>
 </svg>

package/lib/index.js

@@ -1,8 +1,6 @@
 import z from "@deepseek-ai/schemastery";
 import { fileURLToPath } from "node:url";
 import { connect } from "node:net";
-import serveStatic from "serve-static";
-import open, { apps } from "open";
 import { randomBytes, randomUUID } from "node:crypto";
 import { tmpdir } from "node:os";
 import { MessageChannel, Worker } from "node:worker_threads";
@@ -2369,14 +2367,38 @@ async function disposeInspectorResources(disposers, close, message) {
 //#region lib/types/host/plugin.js
 /** Host Cordis plugin for the cross-realm Inspector Worker and full fetch capture. */
 const DEVTOOLS_PATH = "/inspector/devtools";
-/** Start the Worker, expose `ctx.inspector`, and inject the matching Client bootstrap. */
+/** Node's standard code for a feature the running platform cannot provide, such as `worker_threads` in a browser Worker host. */
+const FEATURE_UNAVAILABLE_ON_PLATFORM = "ERR_FEATURE_UNAVAILABLE_ON_PLATFORM";
+/**
+* Start the Worker, expose `ctx.inspector`, and inject the matching Client bootstrap.
+* The bootstrap route exists before the Worker is ready, so a Client published during startup waits instead of failing.
+* When the platform cannot run the Worker (`ERR_FEATURE_UNAVAILABLE_ON_PLATFORM`), the plugin warns once and stays active
+* with only that route, which answers 503; every other startup failure rolls back and rejects the fiber.
+*/
 async function apply$1(ctx, config) {
 	await ctx.effect(async () => {
 		const spec = resolveInspectorOptions(config);
-		const handle = await startInspector(spec);
+		const ready = Promise.withResolvers();
 		const disposers = [];
-		const dispose = () => disposeInspectorResources(disposers, () => handle.close(), "experimental-inspector: disposal failed");
+		let worker;
+		const dispose = () => disposeInspectorResources(disposers, () => worker?.close(), "experimental-inspector: disposal failed");
 		try {
+			disposers.push(ctx.connection.fetch.register({
+				path: INSPECTOR_BOOTSTRAP_PATH,
+				methods: ["GET"],
+				requestBody: "buffered",
+				fetch: (request) => bootstrapResponse(ready.promise, request.signal)
+			}));
+			const handle = await startInspector(spec).catch((error) => {
+				if (!isUnavailableOnPlatform(error)) throw error;
+				ctx.logger.warn("experimental-inspector: NodeJS Inspector is unavailable on this platform; Host inspection stays disabled", error);
+			});
+			if (handle === void 0) {
+				ready.resolve(void 0);
+				return dispose;
+			}
+			worker = handle;
+			const { default: serveStatic } = await import("serve-static");
 			disposers.push(publishCordisTree(ctx, handle.source, {
 				maxNodes: spec.maxCordisNodes,
 				maxBytes: spec.maxSourceFrameBytes - 4096
@@ -2389,12 +2411,6 @@ async function apply$1(ctx, config) {
 					value: handle.endpoint.client
 				});
 			}));
-			disposers.push(ctx.connection.fetch.register({
-				path: INSPECTOR_BOOTSTRAP_PATH,
-				methods: ["GET"],
-				requestBody: "buffered",
-				fetch: () => Promise.resolve(Response.json(handle.endpoint.client, { headers: { "cache-control": "no-store" } }))
-			}));
 			const assets = serveStatic(fileURLToPath(new URL("./lib/devtools/", import.meta.resolve("@deepseek-ai/dsh-experimental-inspector/package.json"))), {
 				index: false,
 				redirect: false,
@@ -2484,13 +2500,18 @@ async function apply$1(ctx, config) {
 				}
 			}));
 			console.log(`dsh inspector: ${handle.endpoint.devtoolsFrontendUrl}`);
-			if (ctx.get("cmdlineArgs")?.get().includes("--inspect")) await open(handle.endpoint.devtoolsFrontendUrl, {
-				app: { name: apps.chrome },
-				wait: false
-			}).catch((error) => {
-				ctx.logger.error("experimental-inspector: Chrome could not open DevTools", error);
-			});
+			ready.resolve(handle.endpoint.client);
+			if (ctx.get("cmdlineArgs")?.get().includes("--inspect")) {
+				const { default: open, apps } = await import("open");
+				await open(handle.endpoint.devtoolsFrontendUrl, {
+					app: { name: apps.chrome },
+					wait: false
+				}).catch((error) => {
+					ctx.logger.error("experimental-inspector: Chrome could not open DevTools", error);
+				});
+			}
 		} catch (error) {
+			ready.resolve(void 0);
 			await dispose().catch((cleanupError) => {
 				ctx.logger.error("experimental-inspector: initialization rollback failed", cleanupError);
 			});
@@ -2499,6 +2520,38 @@ async function apply$1(ctx, config) {
 		return dispose;
 	}, "experimental-inspector: Host Worker");
 }
+/**
+* Report whether a Worker startup failure means this platform cannot run the Inspector at all.
+* @param error - Rejection from {@link startInspector}.
+* @returns True only for Node's `ERR_FEATURE_UNAVAILABLE_ON_PLATFORM` code; messages are never inspected.
+*/
+function isUnavailableOnPlatform(error) {
+	return error instanceof Error && "code" in error && error.code === FEATURE_UNAVAILABLE_ON_PLATFORM;
+}
+/**
+* Answer one bootstrap request once Host initialization settles or the browser abandons the request.
+* @param ready - Resolves with the Client bootstrap, or with undefined after initialization failed or found the platform unavailable.
+* @param signal - Request signal; an aborted request stops waiting and receives no endpoint.
+* @returns The bootstrap JSON, or 503 when the Inspector is unavailable or the request was aborted.
+*/
+async function bootstrapResponse(ready, signal) {
+	const headers = { "cache-control": "no-store" };
+	const abandoned = Promise.withResolvers();
+	const abandon = () => {
+		abandoned.resolve(void 0);
+	};
+	if (signal.aborted) abandon();
+	else signal.addEventListener("abort", abandon, { once: true });
+	try {
+		const client = await Promise.race([ready, abandoned.promise]);
+		return client === void 0 ? new Response(null, {
+			status: 503,
+			headers
+		}) : Response.json(client, { headers });
+	} finally {
+		signal.removeEventListener("abort", abandon);
+	}
+}
 //#endregion
 //#region lib/types/index.js
 /** Repository-facing Host package entry over the mirrored implementation tree. */

package/lib/types/host/plugin.d.ts

@@ -14,6 +14,11 @@ export interface HostPluginConfig extends Omit<InspectorOptions, 'clientOrigins'
     /** Browser origins allowed to open the Client ingest WebSocket. */
     clientOrigins?: string[];
 }
-/** Start the Worker, expose `ctx.inspector`, and inject the matching Client bootstrap. */
+/**
+ * Start the Worker, expose `ctx.inspector`, and inject the matching Client bootstrap.
+ * The bootstrap route exists before the Worker is ready, so a Client published during startup waits instead of failing.
+ * When the platform cannot run the Worker (`ERR_FEATURE_UNAVAILABLE_ON_PLATFORM`), the plugin warns once and stays active
+ * with only that route, which answers 503; every other startup failure rolls back and rejects the fiber.
+ */
 export declare function apply(ctx: Context, config: HostPluginConfig): Promise<void>;
 //# sourceMappingURL=plugin.d.ts.map

package/lib/worker.js

@@ -7272,18 +7272,22 @@ controlPort.on("message", (message) => {
 		});
 	}
 });
-try {
-	runtime = await startInspectorWorker(boot);
-	controlPort.postMessage({
-		type: "ready",
-		...runtime.endpoint
-	});
-} catch (error) {
-	controlPort.postMessage({
-		type: "failure",
-		message: error instanceof Error ? error.message : String(error)
-	});
-	await stop();
+/** Start the Worker server and report readiness, or report the failure and stop. */
+async function main() {
+	try {
+		runtime = await startInspectorWorker(boot);
+		controlPort.postMessage({
+			type: "ready",
+			...runtime.endpoint
+		});
+	} catch (error) {
+		controlPort.postMessage({
+			type: "failure",
+			message: error instanceof Error ? error.message : String(error)
+		});
+		await stop();
+	}
 }
+main();
 //#endregion
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-experimental-inspector",
   "description": "Experimental cross-realm CDP hub for Host debugging and Client Runtime inspection",
-  "version": "0.2.1-alpha.2",
+  "version": "0.2.1-alpha.4",
   "icon": "./icon.svg",
   "publishConfig": {
     "access": "public"
@@ -46,43 +46,39 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.2",
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.4",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2",
     "open": "^11.0.2",
     "serve-static": "^2.2.1",
     "ws": "^8.21.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
-    "@deepseek-ai/dsh-client-modules": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.2"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   },
   "devDependencies": {
     "chrome-devtools-frontend": "1.0.1638082",
     "@types/serve-static": "^2.2.0",
-    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.4",
     "@testing-library/react": "^16.3.3",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.2",
-    "@types/react": "~18.3.1",
-    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-shortcuts": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-shortcuts": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.4",
     "react": "^18.2.0",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/cordis-plugin-include": "~1.0.10-alpha.1",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
-    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-cmdline": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/cordis-plugin-include": "~1.0.10-alpha.2",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-cmdline": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.4",
     "@types/ws": "^8.18.1",
     "playwright": "^1.49.0",
-    "tsx": "^4.23.13"
+    "tsx": "^4.23.13",
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-modules": "0.2.1-alpha.4"
   }
 }