@qilin-agent/experimental-inspector 3.1.3 → 3.1.6

package/lib/index.js

@@ -1,9 +1,6 @@
-import { createRequire } from "node:module";
 import z from "@qilin-agent/schemastery";
-import { fileURLToPath, pathToFileURL } from "node:url";
+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";
@@ -23,6 +20,14 @@ const NETWORK_TOPICS = [
 	"fetch/error"
 ];
 /**
+* Keeps each wrapper-created Request reachable while the caller's response body stream is reachable.
+* Node's fetch forwards the caller's abort signal only while that Request is reachable. The capture
+* clone shares one source with the caller's body stream and keeps that stream reachable while capture
+* reads. Entries are set after `response.clone()`, which replaces `response.body`. The map is
+* module-level so that responses obtained before `stop()` keep their Request reachable afterwards.
+*/
+const requestsByBody = /* @__PURE__ */ new WeakMap();
+/**
 * Install full fetch capture for every later call through `globalThis.fetch`.
 * @param publisher - Host source that receives fetch lifecycle records.
 * @param options - Per-body capture limits.
@@ -115,6 +120,7 @@ function installFetchObserver(publisher, options) {
 				responseCaptureError: renderError$1(error)
 			});
 		}
+		if (response.body !== null) requestsByBody.set(response.body, request);
 		return response;
 	};
 	Object.defineProperty(observedFetch, "name", {
@@ -1804,7 +1810,7 @@ function resolveInspectorOptions(options = {}) {
 async function startInspector(options = {}) {
 	const spec = resolveInspectorOptions(options);
 	const channel = new MessageChannel();
-	const clientProtocol = `qilin-inspector-v${String(0)}-${randomBytes(32).toString("base64url")}`;
+	const clientProtocol = `dsh-inspector-v${String(0)}-${randomBytes(32).toString("base64url")}`;
 	const lifecycle = new InspectorWorkerLifecycle(spawnWorker({
 		config: {
 			host: spec.host,
@@ -1906,7 +1912,7 @@ function spawnWorker(boot) {
 	};
 	if (!import.meta.url.endsWith(".ts")) return new Worker(new URL("./worker.js", import.meta.url), options);
 	const workerEntry = new URL("../../worker/entry.ts", import.meta.url);
-	const tsxEsmApiEntry = resolveTsxEsmApi();
+	const tsxEsmApiEntry = import.meta.resolve("tsx/esm/api");
 	const bootstrap = [
 		`import { register } from ${JSON.stringify(tsxEsmApiEntry)}`,
 		"register()",
@@ -1917,14 +1923,6 @@ function spawnWorker(boot) {
 		env: sourceWorkerEnv()
 	});
 }
-/** Resolve the tsx ESM loader API entry, as a file URL. */
-function resolveTsxEsmApi() {
-	try {
-		return import.meta.resolve("tsx/esm/api");
-	} catch {
-		return pathToFileURL(createRequire(import.meta.url).resolve("tsx/esm/api")).href;
-	}
-}
 function sourceWorkerEnv() {
 	const env = {};
 	if (process.platform === "win32") {
@@ -2368,23 +2366,39 @@ async function disposeInspectorResources(disposers, close, message) {
 //#endregion
 //#region lib/types/host/plugin.js
 /** Host Cordis plugin for the cross-realm Inspector Worker and full fetch capture. */
-/** Resolve this package's manifest URL; Vitest's module runner lacks import.meta.resolve. */
-function resolvePackageManifest() {
-	try {
-		return import.meta.resolve("@qilin-agent/experimental-inspector/package.json");
-	} catch {
-		return pathToFileURL(createRequire(import.meta.url).resolve("@qilin-agent/experimental-inspector/package.json")).href;
-	}
-}
 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
@@ -2397,13 +2411,7 @@ 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/", resolvePackageManifest())), {
+			const assets = serveStatic(fileURLToPath(new URL("./lib/devtools/", import.meta.resolve("@qilin-agent/experimental-inspector/package.json"))), {
 				index: false,
 				redirect: false,
 				fallthrough: true,
@@ -2492,13 +2500,18 @@ async function apply$1(ctx, config) {
 				}
 			}));
 			console.log(`qilin 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);
 			});
@@ -2507,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

@@ -269,16 +269,16 @@ var NetworkDomain = class {
 				return {
 					body: Buffer$1.from(body.bytes).toString("base64"),
 					base64Encoded: true,
-					qilinInspectorTruncated: body.truncated,
-					...body.captureError === void 0 ? {} : { qilinInspectorCaptureError: body.captureError }
+					dshInspectorTruncated: body.truncated,
+					...body.captureError === void 0 ? {} : { dshInspectorCaptureError: body.captureError }
 				};
 			}
 			case "Network.getRequestPostData": {
 				const body = this.store.requestBody(params.requestId);
 				return {
 					postData: Buffer$1.from(body.bytes).toString("utf8"),
-					qilinInspectorTruncated: body.truncated,
-					...body.captureError === void 0 ? {} : { qilinInspectorCaptureError: body.captureError }
+					dshInspectorTruncated: body.truncated,
+					...body.captureError === void 0 ? {} : { dshInspectorCaptureError: body.captureError }
 				};
 			}
 			case "Network.streamResourceContent": {
@@ -322,8 +322,8 @@ var NetworkDomain = class {
 				this.sendRequestStart(session, event.requestKey, resourceType);
 				session.sendEvent("Network.responseReceived", {
 					requestId: event.requestId,
-					loaderId: "qilin-inspector-loader",
-					frameId: "qilin-inspector-host-frame",
+					loaderId: "dsh-inspector-loader",
+					frameId: "dsh-inspector-host-frame",
 					timestamp,
 					type: resourceType,
 					response: {
@@ -364,7 +364,7 @@ var NetworkDomain = class {
 					requestId: event.requestId,
 					timestamp,
 					encodedDataLength: event.encodedDataLength,
-					qilinInspectorTruncated: event.truncated
+					dshInspectorTruncated: event.truncated
 				});
 				this.stopRequest(session, event.requestKey);
 				return;
@@ -392,7 +392,7 @@ var NetworkDomain = class {
 		this.requestTypes.get(session)?.set(requestKey, resourceType);
 		session.sendEvent("Network.requestWillBeSent", {
 			requestId: event.requestId,
-			loaderId: "qilin-inspector-loader",
+			loaderId: "dsh-inspector-loader",
 			documentURL: "qilin://host",
 			request: {
 				url: event.url,
@@ -2684,7 +2684,7 @@ var ClientRuntimeRouter = class {
 		if (capability === void 0) return;
 		const target = {
 			contextId: this.nextContextId--,
-			uniqueContextId: `qilin-client:${source.sourceId}:${source.generation}`,
+			uniqueContextId: `dsh-client:${source.sourceId}:${source.generation}`,
 			source,
 			capability
 		};
@@ -3286,8 +3286,8 @@ const CDP_METHOD_NOT_HANDLED = Symbol("CDP_METHOD_NOT_HANDLED");
 */
 function handleScaffold(request, target) {
 	const frame = {
-		id: "qilin-inspector-host-frame",
-		loaderId: "qilin-inspector-loader",
+		id: "dsh-inspector-host-frame",
+		loaderId: "dsh-inspector-loader",
 		url: "qilin://host",
 		domainAndRegistry: "",
 		securityOrigin: "qilin://host",
@@ -3334,9 +3334,9 @@ function handleScaffold(request, target) {
 		} };
 		case "Browser.getVersion": return {
 			protocolVersion: "1.3",
-			product: "qilin-experimental-inspector/0",
+			product: "dsh-experimental-inspector/0",
 			revision: "@experimental",
-			userAgent: "qilin-experimental-inspector",
+			userAgent: "dsh-experimental-inspector",
 			jsVersion: process.versions.v8
 		};
 		default: return CDP_METHOD_NOT_HANDLED;
@@ -4068,7 +4068,7 @@ var RuntimeDomainSession = class {
 		if (typeof unique === "string") {
 			const realm = this.realms.byUniqueContextId(unique);
 			if (realm !== void 0) return realm;
-			if (unique.startsWith("qilin-client:")) throw new Error("Client execution context is no longer available");
+			if (unique.startsWith("dsh-client:")) throw new Error("Client execution context is no longer available");
 			return this.realms.host();
 		}
 	}
@@ -4104,7 +4104,7 @@ var RuntimeDomainSession = class {
 		if (typeof params.uniqueContextId === "string") {
 			const realm = this.realms.byUniqueContextId(params.uniqueContextId);
 			if (realm?.nativeDomains.state === "unsupported") return realm.nativeDomains.reason;
-			if (params.uniqueContextId.startsWith("qilin-client:") && realm === void 0) return "Client execution context is no longer available";
+			if (params.uniqueContextId.startsWith("dsh-client:") && realm === void 0) return "Client execution context is no longer available";
 		}
 		for (const [key, value] of Object.entries(params)) {
 			if (!key.endsWith("ObjectId") && key !== "objectId") continue;
@@ -4148,7 +4148,7 @@ var RuntimeDomainSession = class {
 				name: `Client — ${realm.descriptor.label}`,
 				auxData: {
 					isDefault: false,
-					type: "qilin-client",
+					type: "dsh-client",
 					sourceId: realm.descriptor.sourceId
 				}
 			} }
@@ -5077,7 +5077,7 @@ var InspectorEndpoint = class {
 		}
 		if (pathname === "/json/version") {
 			this.json(response, {
-				Browser: "qilin-experimental-inspector/0",
+				Browser: "dsh-experimental-inspector/0",
 				"Protocol-Version": "1.3",
 				webSocketDebuggerUrl: this.cdpUrl()
 			});
@@ -5129,7 +5129,7 @@ var InspectorEndpoint = class {
 			}
 		}, {
 			targetId: this.config.targetId,
-			title: "DeepSeek Harness Host"
+			title: "QiLin Host"
 		}, this.sources, this.network, this.realms, this.cordisDom, this.cordisTrees, clientSourceId);
 		this.cdpSessions.set(socket, session);
 		socket.on("message", (data) => {
@@ -5197,7 +5197,7 @@ var InspectorEndpoint = class {
 		return {
 			id: this.config.targetId,
 			type: "page",
-			title: "DeepSeek Harness Host",
+			title: "QiLin Host",
 			description: "Experimental cross-realm Inspector target",
 			url: "qilin://host",
 			webSocketDebuggerUrl: this.cdpUrl(),
@@ -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": "@qilin-agent/experimental-inspector",
   "description": "Experimental cross-realm CDP hub for Host debugging and Client Runtime inspection",
-  "version": "3.1.3",
+  "version": "3.1.6",
   "icon": "./icon.svg",
   "publishConfig": {
     "access": "public"
@@ -11,6 +11,9 @@
     "url": "git+https://github.com/kkutysllb/QiLin.git",
     "directory": "packages/experimental/inspector"
   },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -23,7 +26,6 @@
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
     },
-    "./cordis.patch.yml": "./cordis.patch.yml",
     "./locale/*.json": "./locale/*.json",
     "./src/*": "./src/*",
     "./package.json": "./package.json"
@@ -40,10 +42,9 @@
     "locale/*.json",
     "lib/index.js",
     "lib/client.js",
-    "lib/worker.js",
     "lib/client.*.js",
+    "lib/worker.js",
     "lib/devtools/**",
-    "cordis.patch.yml",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
@@ -51,43 +52,38 @@
     "open": "^11.0.0",
     "serve-static": "^2.2.1",
     "ws": "^8.21.0",
-    "@qilin-agent/app-boot": "3.1.3",
-    "@qilin-agent/brand": "3.1.3",
-    "@qilin-agent/util-crypto": "3.1.3",
-    "@qilin-agent/schemastery": "~3.18.3"
+    "@qilin-agent/schemastery": "~3.18.5",
+    "@qilin-agent/util-crypto": "3.1.6",
+    "@qilin-agent/app-boot": "3.1.6"
   },
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/client-modules": "3.1.3",
-    "@qilin-agent/client-connection": "3.1.3",
-    "@qilin-agent/kylin-plugin-loader": "~1.0.4",
-    "@qilin-agent/host-webserver": "3.1.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
-    "@testing-library/react": "^16.1.0",
-    "@types/react": "~18.3.1",
+    "chrome-devtools-frontend": "1.0.1638082",
     "@types/serve-static": "^2.2.0",
+    "@testing-library/react": "^16.3.2",
+    "react": "^18.2.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
     "@types/ws": "^8.18.1",
-    "chrome-devtools-frontend": "1.0.1638082",
     "playwright": "^1.49.0",
-    "react": "^18.2.0",
-    "tsx": "^4.19.2",
-    "@qilin-agent/client-locale": "3.1.3",
-    "@qilin-agent/client-connection": "3.1.3",
-    "@qilin-agent/client-shortcuts": "3.1.3",
-    "@qilin-agent/client-store": "3.1.3",
-    "@qilin-agent/client-test-runtime": "3.1.3",
-    "@qilin-agent/client-ui-layout": "3.1.3",
-    "@qilin-agent/client-ui-primitives": "3.1.3",
-    "@qilin-agent/client-ui-renderer": "3.1.3",
-    "@qilin-agent/client-ui-slots": "3.1.3",
-    "@qilin-agent/cmdline": "3.1.3",
-    "@qilin-agent/host-webserver": "3.1.3",
-    "@qilin-agent/kylin-plugin-include": "~1.0.8",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/kylin-plugin-loader": "~1.0.4"
-  },
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "tsx": "^4.22.4",
+    "@qilin-agent/client-ui-renderer": "3.1.6",
+    "@qilin-agent/client-test-runtime": "3.1.6",
+    "@qilin-agent/client-ui-layout": "3.1.6",
+    "@qilin-agent/client-shortcuts": "3.1.6",
+    "@qilin-agent/client-store": "3.1.6",
+    "@qilin-agent/client-ui-slots": "3.1.6",
+    "@qilin-agent/client-ui-primitives": "3.1.6",
+    "@qilin-agent/client-locale": "3.1.6",
+    "@qilin-agent/kylin-plugin-include": "~1.0.10",
+    "@qilin-agent/kylin-plugin-loader": "~1.0.6",
+    "@qilin-agent/host-webserver": "3.1.6",
+    "@qilin-agent/cmdline": "3.1.6",
+    "@qilin-agent/client-connection": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/brand": "3.1.6",
+    "@qilin-agent/client-modules": "3.1.6"
   }
 }

package/cordis.patch.yml

@@ -1,5 +0,0 @@
-# Explicit local debugging overlay; the Host prints its debugging URL.
-
-- insert:
-    - id: experimental-inspector
-      name: './lib/index.js'

package/lib/devtools/chunks/protocol_monitor-B9nMqAAE.js

@@ -1,2 +0,0 @@
-import { r as e, t } from "./protocol_monitor-CvLQ8ms1.js";
-export { e as JSONEditor, t as ProtocolMonitor };