@deepseek-ai/dsh-cordis-host-runner 0.1.7-rc.2 → 0.2.0-rc.2

package/README.i18n.yaml

@@ -18,8 +18,11 @@
   en: bdaba8036acf80c9
   zh: 2dd8f972c3023a8a
 /deepseek-ai-dsh-cordis-host-runner/use-this-package/minimal-configuration:
-  en: 0be8b7f1580ca751
-  zh: 984c4757e9d6e094
+  en: ca844fa88b307274
+  zh: da2032bfe3c1b792
+/deepseek-ai-dsh-cordis-host-runner/use-this-package/client-inspection:
+  en: b4a2fe9e7aa9dee7
+  zh: 56f55558809970da
 /deepseek-ai-dsh-cordis-host-runner/use-this-package/what-a-run-does:
   en: a3c86c081974a710
   zh: 180e1b7824c070d4

package/README.md

@@ -38,9 +38,17 @@ Mount this plugin for the inspection registry or programmatic dynamic-package li
 | Field | Default | Meaning |
 |---|---|---|
 | `vmTimeoutMs` | `5000` | Milliseconds the synchronous portion of a host half may run in the vm before evaluation is aborted |
+| `clientInspectTimeoutMs` | `10000` | Maximum wait for a valid Client inspect response; an integer from 1 to 2147483647 milliseconds |
 
 The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-cordis-host-runner) is the exhaustive source for every accepted field.
 
+<a id="client-inspection"></a>
+### Client inspection
+
+When Gateway is mounted, a Client query with no live event stream fails before dispatch. This check does not subscribe to disconnections: queries already dispatched retain their original deadline. Standalone event transports without Gateway retain the same timeout behavior.
+
+Client queries accept the first valid page response within `clientInspectTimeoutMs`. A failed page does not prevent another page from answering successfully. If no valid result arrives, the query rejects with the first Client failure or output-validation diagnostic; when no page answers, it asks the caller to open or reconnect the Harness page and retry. Cancellation and registry disposal also end pending queries. Reconnecting a page does not replay a missed request, so retry after the connection is restored. Host queries are unaffected by this timeout.
+
 ### What a run does
 
 Programmatic callers use `define`, `run`, `stop`, and `undefine`; the browser panel operates existing definitions. Host-only packages activate in this process. A package with a browser half waits for approval or cancellation, then loads Host before Client. `mode: "run"` starts the current version; `mode: "update"` replaces it. Stop disposes the live effects and retains the definition; undefine also forgets it.

package/README.zh.md

@@ -38,9 +38,17 @@ kind: "package-reference"
 | 字段 | 默认值 | 含义 |
 |---|---|---|
 | `vmTimeoutMs` | `5000` | host 半在 vm 中同步执行的那部分被中止求值前可运行的毫秒数 |
+| `clientInspectTimeoutMs` | `10000` | 等待有效 Client 检查响应的最长时间；1 到 2147483647 毫秒之间的整数 |
 
 生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-cordis-host-runner)是每个受支持字段的穷尽式真源。
 
+<a id="client-inspection"></a>
+### Client 检查
+
+装载 Gateway 时，没有活动事件流的 Client 查询在发送前就会失败。此检查不订阅断连：已发送的查询仍沿用原期限。没有 Gateway 的独立事件传输保持相同的超时行为。
+
+Client 查询在 `clientInspectTimeoutMs` 内接受首个有效页面响应。某个页面失败不会阻止其他页面成功回答。若没有有效结果，查询返回首个 Client 错误或输出校验诊断；若没有页面回答，则提示调用方打开或重新连接 Harness 页面后重试。取消和注册表卸载也会结束待处理查询。页面重连不会重放错过的请求，因此需在连接恢复后重试。Host 查询不受此超时影响。
+
 ### run 会做什么
 
 程序调用方使用 `define`、`run`、`stop` 和 `undefine`；浏览器面板操作已有定义。仅含 Host 的包在本进程激活。带浏览器部分的包等待审批或取消，批准后先加载 Host 再加载 Client。`mode: "run"` 启动当前版本，`mode: "update"` 替换版本。Stop 释放运行中的 effect 并保留定义；undefine 还会移除定义。

package/lib/index.js

@@ -714,13 +714,26 @@ function pluginName(plugin) {
 /** Host registry for model-visible, read-only Cordis capability queries. */
 /** Registry and cross-page router behind the two model-facing inspect tools. */
 var CordisInspectRegistryService = class extends Service {
+	clientQueryTimeoutMs;
 	providers = /* @__PURE__ */ new Map();
 	pending = /* @__PURE__ */ new Map();
 	clientManifest;
 	nextRequest = 1;
-	/** Register the process-global Host registry. */
-	constructor(ctx) {
+	/**
+	* Register the process-global Host registry.
+	* @param ctx - owning Host context.
+	* @param clientQueryTimeoutMs - maximum wait for a valid Client response, in milliseconds.
+	*/
+	constructor(ctx, clientQueryTimeoutMs) {
 		super(ctx, "cordisInspect");
+		this.clientQueryTimeoutMs = clientQueryTimeoutMs;
+		ctx.effect(() => () => {
+			for (const pending of this.pending.values()) pending.settle({
+				ok: false,
+				reason: "cancelled",
+				message: "Client inspect registry was disposed"
+			});
+		}, "cordis-inspect: pending queries");
 	}
 	/**
 	* Register one Host provider.
@@ -768,7 +781,8 @@ var CordisInspectRegistryService = class extends Service {
 	* @param input - optional lossless JSON input.
 	* @param agent - requesting Agent and scope.
 	* @param signal - tool-call cancellation.
-	* @returns provider JSON data.
+	* @returns provider JSON data; Client queries fail fast when Gateway has no live Client
+	* and retain only the first observed failure diagnostic for timeout reporting.
 	*/
 	async query(platform, providerId, methodName, input, agent, signal) {
 		if (platform === "host") {
@@ -791,23 +805,25 @@ var CordisInspectRegistryService = class extends Service {
 	* @param agent - Agent whose Session owns the query.
 	* @param requestId - Pending Client query identity.
 	* @param resolution - Client provider result or failure.
-	* @returns whether this response settled the still-pending query.
+	* @returns acknowledgement with accepted true only for a success that settles the query; only the first failure diagnostic is retained.
 	*/
 	resolveClientQuery(agent, requestId, resolution) {
 		const pending = this.pending.get(requestId);
 		if (pending === void 0 || pending.request.agentId !== agent.id) return { accepted: false };
-		if (!resolution.ok) return { accepted: false };
+		if (!resolution.ok) {
+			pending.failure ??= `${resolution.reason}: ${resolution.message}`;
+			return { accepted: false };
+		}
 		try {
 			resolution = {
 				ok: true,
 				data: validateOutput("Client", pending.request.provider, pending.method, resolution.data)
 			};
-		} catch {
+		} catch (error) {
+			pending.failure ??= error instanceof Error ? error.message : String(error);
 			return { accepted: false };
 		}
-		this.pending.delete(requestId);
 		pending.settle(resolution);
-		this.ctx.emit("cordis/inspect-query-resolved", { requestId });
 		return { accepted: true };
 	}
 	async queryClient(providerId, methodName, input, agent, signal) {
@@ -816,6 +832,8 @@ var CordisInspectRegistryService = class extends Service {
 		const method = findMethod(provider, methodName);
 		validateInput("Client", providerId, method, input);
 		signal.throwIfAborted();
+		const gateway = this.ctx.get("typertGateway");
+		if (gateway !== void 0 && !gateway.hasLiveClient()) throw new Error(`Client inspect query ${providerId}.${methodName} has no connected Harness page. Open or reconnect the Harness page, then retry.`);
 		const requestId = `inspect-${this.nextRequest++}`;
 		const request = {
 			requestId,
@@ -828,29 +846,45 @@ var CordisInspectRegistryService = class extends Service {
 			this.pending.set(requestId, {
 				request,
 				method,
-				settle: resolve
+				settle: (resolution) => {
+					this.pending.delete(requestId);
+					resolve(resolution);
+					try {
+						this.ctx.emit("cordis/inspect-query-resolved", { requestId });
+					} catch (error) {
+						console.error("[cordis-host-runner] notifying Client inspect completion failed:", error);
+					}
+				}
 			});
 		});
 		const onAbort = () => {
-			const pending = this.pending.get(requestId);
-			if (pending === void 0) return;
-			this.pending.delete(requestId);
-			pending.settle({
+			this.pending.get(requestId)?.settle({
 				ok: false,
 				reason: "cancelled",
 				message: `Client inspect query ${providerId}.${methodName} was cancelled`
 			});
-			this.ctx.emit("cordis/inspect-query-resolved", { requestId });
 		};
+		const timer = setTimeout(() => {
+			const pending = this.pending.get(requestId);
+			if (pending === void 0) return;
+			const detail = pending.failure === void 0 ? "Open or reconnect the Harness page, then retry." : `Client failure: ${pending.failure}`;
+			pending.settle({
+				ok: false,
+				reason: "provider-error",
+				message: `Client inspect query ${providerId}.${methodName} timed out after ${this.clientQueryTimeoutMs}ms. ${detail}`
+			});
+		}, this.clientQueryTimeoutMs);
 		signal.addEventListener("abort", onAbort, { once: true });
-		if (signal.aborted) onAbort();
-		else this.ctx.emit("cordis/inspect-query", request);
 		try {
+			if (signal.aborted) onAbort();
+			else this.ctx.emit("cordis/inspect-query", request);
 			const resolution = await result;
 			if (!resolution.ok) throw new Error(`${providerId}.${methodName}: ${resolution.message}`);
 			return resolution.data;
 		} finally {
+			clearTimeout(timer);
 			signal.removeEventListener("abort", onAbort);
+			this.pending.delete(requestId);
 		}
 	}
 };
@@ -1536,7 +1570,10 @@ let DynamicCordisRunnerService = (() => {
 			});
 		}
 		static inject = ["tools"];
-		static Config = z.object({ vmTimeoutMs: z.number().min(1).default(5e3) });
+		static Config = z.object({
+			vmTimeoutMs: z.number().min(1).default(5e3),
+			clientInspectTimeoutMs: z.number().step(1).min(1).max(2147483647).default(1e4)
+		});
 		rootCtx = __runInitializers(this, _instanceExtraInitializers);
 		registry = new DynamicCordisRegistry();
 		inspectRegistry;
@@ -1548,7 +1585,7 @@ let DynamicCordisRunnerService = (() => {
 			super(ctx, "dynamicCordisRunner");
 			this.rootCtx = ctx;
 			this.resolved = config;
-			this.inspectRegistry = new CordisInspectRegistryService(ctx);
+			this.inspectRegistry = new CordisInspectRegistryService(ctx, this.resolved.clientInspectTimeoutMs);
 		}
 		/**
 		* Define a new Plugin's first Package or append a Package to an existing Plugin.
@@ -1876,11 +1913,12 @@ let DynamicCordisRunnerService = (() => {
 			return null;
 		}
 		/**
-		* Claim one pending Client inspect query with its live result.
+		* Submit a Client inspect result or failure for a pending query.
 		* @param agent - Session that owns the query.
 		* @param requestId - exact pending query identity.
 		* @param resolution - provider result or structured refusal.
-		* @returns whether this answer won the query.
+		* @returns acknowledgement with accepted true only for a valid success that settles the query;
+		* pending-query failures return { accepted: false } and retain only the first diagnostic.
 		*/
 		resolveInspectQuery(agent, requestId, resolution) {
 			return this.inspectRegistry.resolveClientQuery(agent, requestId, resolution);

package/lib/typert.host.js

@@ -304,7 +304,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisClientSource',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_getClientCode_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":389,"column":3},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":392,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/inventory',
@@ -319,7 +319,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/inventory:result',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_inventory_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":530,"column":3},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":534,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/invoke',
@@ -374,7 +374,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisInvokeResult',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_invoke_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":746,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":750,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/reportClientGuardFailure',
@@ -434,7 +434,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/reportClientGuardFailure:result',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_reportClientGuardFailure_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":723,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":727,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/reportRenderFailure',
@@ -494,7 +494,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/reportRenderFailure:result',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_reportRenderFailure_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":689,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":693,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/resolveInspectQuery',
@@ -544,7 +544,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#CordisInspectResolveAck',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_resolveInspectQuery_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":516,"column":3},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":520,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/resolveRequestRun',
@@ -579,7 +579,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisResolveAck',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_resolveRequestRun_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":418,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":421,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/runHostHalf',
@@ -659,7 +659,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisHostHalfResult',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_runHostHalf_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":330,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":333,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/settleUserRun',
@@ -709,7 +709,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisRunResponse',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_settleUserRun_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":443,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":446,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/stopFromPanel',
@@ -749,7 +749,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisStopResponse',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_stopFromPanel_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":485,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":488,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/syncInspectManifest',
@@ -774,7 +774,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/syncInspectManifest:result',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_syncInspectManifest_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":503,"column":3},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":506,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/undefineFromPanel',
@@ -814,7 +814,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisUndefineReceipt',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_undefineFromPanel_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":232,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":235,"column":9},
     },
   ],
   model: {
@@ -853,14 +853,14 @@ export const TYPERT = {
             "name": "query",
             "signature": "async query( platform: CordisInspectPlatform, providerId: string, methodName: string, input: JsonValue | undefined, agent: Agent, signal: AbortSignal, ): Promise<JsonValue>",
             "summary": "Execute one provider query on its owning platform.",
-            "jsDoc": "/**\n * Execute one provider query on its owning platform.\n * @param platform - Host or Client runtime.\n * @param providerId - provider selected from {@link list}.\n * @param methodName - declared method name.\n * @param input - optional lossless JSON input.\n * @param agent - requesting Agent and scope.\n * @param signal - tool-call cancellation.\n * @returns provider JSON data.\n */"
+            "jsDoc": "/**\n * Execute one provider query on its owning platform.\n * @param platform - Host or Client runtime.\n * @param providerId - provider selected from {@link list}.\n * @param methodName - declared method name.\n * @param input - optional lossless JSON input.\n * @param agent - requesting Agent and scope.\n * @param signal - tool-call cancellation.\n * @returns provider JSON data; Client queries fail fast when Gateway has no live Client\n * and retain only the first observed failure diagnostic for timeout reporting.\n */"
           },
           {
             "kind": "method",
             "name": "resolveClientQuery",
             "signature": "resolveClientQuery( agent: Agent, requestId: CordisInspectRequestId, resolution: CordisInspectQueryResolution, ): CordisInspectResolveAck",
             "summary": "Accept the first valid Client response for a pending query.",
-            "jsDoc": "/**\n * Accept the first valid Client response for a pending query.\n * @param agent - Agent whose Session owns the query.\n * @param requestId - Pending Client query identity.\n * @param resolution - Client provider result or failure.\n * @returns whether this response settled the still-pending query.\n */"
+            "jsDoc": "/**\n * Accept the first valid Client response for a pending query.\n * @param agent - Agent whose Session owns the query.\n * @param requestId - Pending Client query identity.\n * @param resolution - Client provider result or failure.\n * @returns acknowledgement with accepted true only for a success that settles the query; only the first failure diagnostic is retained.\n */"
           }
         ],
         "types": [
@@ -1194,7 +1194,7 @@ export const TYPERT = {
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    goal: GoalMessageSource;\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'session-reference': SessionReferenceSource;\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    goal: GoalMessageSource;\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'session-reference': SessionReferenceSource;\n    'user-question-reply': { kind: 'user-question-reply'; callId: ToolCallId; outcome: 'answered'; };\n}"
           },
           {
             "name": "ModelMessageSource",
@@ -1282,7 +1282,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'schedule/change': ScheduleChange;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n    'feedback/record': FeedbackRecord;\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'schedule/change': ScheduleChange;\n}"
           },
           {
             "name": "SessionEventType",
@@ -1535,8 +1535,8 @@ export const TYPERT = {
             "kind": "method",
             "name": "resolveInspectQuery",
             "signature": "@Remote('resolveInspectQuery') resolveInspectQuery( agent: Agent, requestId: CordisInspectRequestId, resolution: CordisInspectQueryResolution, ): CordisInspectResolveAck",
-            "summary": "Claim one pending Client inspect query with its live result.",
-            "jsDoc": "/**\n * Claim one pending Client inspect query with its live result.\n * @param agent - Session that owns the query.\n * @param requestId - exact pending query identity.\n * @param resolution - provider result or structured refusal.\n * @returns whether this answer won the query.\n */"
+            "summary": "Submit a Client inspect result or failure for a pending query.",
+            "jsDoc": "/**\n * Submit a Client inspect result or failure for a pending query.\n * @param agent - Session that owns the query.\n * @param requestId - exact pending query identity.\n * @param resolution - provider result or structured refusal.\n * @returns acknowledgement with accepted true only for a valid success that settles the query;\n * pending-query failures return { accepted: false } and retain only the first diagnostic.\n */"
           },
           {
             "kind": "method",
@@ -2025,7 +2025,7 @@ export const TYPERT = {
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    goal: GoalMessageSource;\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'session-reference': SessionReferenceSource;\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    goal: GoalMessageSource;\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'session-reference': SessionReferenceSource;\n    'user-question-reply': { kind: 'user-question-reply'; callId: ToolCallId; outcome: 'answered'; };\n}"
           },
           {
             "name": "ModelMessageSource",
@@ -2113,7 +2113,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'schedule/change': ScheduleChange;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n    'feedback/record': FeedbackRecord;\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'schedule/change': ScheduleChange;\n}"
           },
           {
             "name": "SessionEventType",

package/lib/typert.remote-client.js

@@ -301,7 +301,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisClientSource',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_getClientCode_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":389,"column":3},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":392,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/inventory',
@@ -316,7 +316,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/inventory:result',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_inventory_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":530,"column":3},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":534,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/invoke',
@@ -371,7 +371,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisInvokeResult',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_invoke_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":746,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":750,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/reportClientGuardFailure',
@@ -431,7 +431,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/reportClientGuardFailure:result',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_reportClientGuardFailure_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":723,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":727,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/reportRenderFailure',
@@ -491,7 +491,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/reportRenderFailure:result',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_reportRenderFailure_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":689,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":693,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/resolveInspectQuery',
@@ -541,7 +541,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#CordisInspectResolveAck',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_resolveInspectQuery_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":516,"column":3},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":520,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/resolveRequestRun',
@@ -576,7 +576,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisResolveAck',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_resolveRequestRun_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":418,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":421,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/runHostHalf',
@@ -656,7 +656,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisHostHalfResult',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_runHostHalf_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":330,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":333,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/settleUserRun',
@@ -706,7 +706,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisRunResponse',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_settleUserRun_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":443,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":446,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/stopFromPanel',
@@ -746,7 +746,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisStopResponse',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_stopFromPanel_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":485,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":488,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/syncInspectManifest',
@@ -771,7 +771,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/syncInspectManifest:result',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_syncInspectManifest_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":503,"column":3},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":506,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-cordis-host-runner#dynamicCordisRunner/undefineFromPanel',
@@ -811,7 +811,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-cordis-host-runner/types#DynamicCordisUndefineReceipt',
         create: _deepseek_ai_dsh_cordis_host_runner_dynamicCordisRunner_undefineFromPanel_result$schema,
       },
-      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":232,"column":9},
+      sourceLocation: {"file":"packages/extensions/cordis-host-runner/src/index.ts","line":235,"column":9},
     },
   ],
 }

package/lib/types/index.d.ts

@@ -56,6 +56,8 @@ declare module '@deepseek-ai/cordis' {
 export interface Config {
     /** Maximum synchronous VM evaluation time in milliseconds. */
     vmTimeoutMs?: number;
+    /** Maximum wait for a valid Client inspect response in milliseconds. */
+    clientInspectTimeoutMs?: number;
 }
 /** Host-only snapshot consumed by inspect and tool result rendering. */
 export interface DynamicCordisSnapshotRow {
@@ -176,11 +178,12 @@ export declare class DynamicCordisRunnerService extends TypertRemoteService {
      */
     syncInspectManifest(providers: readonly CordisInspectProviderManifest[]): null;
     /**
-     * Claim one pending Client inspect query with its live result.
+     * Submit a Client inspect result or failure for a pending query.
      * @param agent - Session that owns the query.
      * @param requestId - exact pending query identity.
      * @param resolution - provider result or structured refusal.
-     * @returns whether this answer won the query.
+     * @returns acknowledgement with accepted true only for a valid success that settles the query;
+     * pending-query failures return { accepted: false } and retain only the first diagnostic.
      */
     resolveInspectQuery(agent: Agent, requestId: CordisInspectRequestId, resolution: CordisInspectQueryResolution): CordisInspectResolveAck;
     /**

package/lib/types/index.js

@@ -126,6 +126,7 @@ let DynamicCordisRunnerService = (() => {
         static inject = ['tools'];
         static Config = z.object({
             vmTimeoutMs: z.number().min(1).default(5000),
+            clientInspectTimeoutMs: z.number().step(1).min(1).max(2_147_483_647).default(10_000),
         });
         rootCtx = __runInitializers(this, _instanceExtraInitializers);
         registry = new DynamicCordisRegistry();
@@ -138,7 +139,7 @@ let DynamicCordisRunnerService = (() => {
             super(ctx, 'dynamicCordisRunner');
             this.rootCtx = ctx;
             this.resolved = config;
-            this.inspectRegistry = new CordisInspectRegistryService(ctx);
+            this.inspectRegistry = new CordisInspectRegistryService(ctx, this.resolved.clientInspectTimeoutMs);
         }
         /**
          * Define a new Plugin's first Package or append a Package to an existing Plugin.
@@ -475,11 +476,12 @@ let DynamicCordisRunnerService = (() => {
             return null;
         }
         /**
-         * Claim one pending Client inspect query with its live result.
+         * Submit a Client inspect result or failure for a pending query.
          * @param agent - Session that owns the query.
          * @param requestId - exact pending query identity.
          * @param resolution - provider result or structured refusal.
-         * @returns whether this answer won the query.
+         * @returns acknowledgement with accepted true only for a valid success that settles the query;
+         * pending-query failures return { accepted: false } and retain only the first diagnostic.
          */
         resolveInspectQuery(agent, requestId, resolution) {
             return this.inspectRegistry.resolveClientQuery(agent, requestId, resolution);

package/lib/types/inspect-registry.d.ts

@@ -26,12 +26,17 @@ declare module '@deepseek-ai/cordis' {
 }
 /** Registry and cross-page router behind the two model-facing inspect tools. */
 export declare class CordisInspectRegistryService extends Service {
+    private readonly clientQueryTimeoutMs;
     private readonly providers;
     private readonly pending;
     private clientManifest;
     private nextRequest;
-    /** Register the process-global Host registry. */
-    constructor(ctx: Context);
+    /**
+     * Register the process-global Host registry.
+     * @param ctx - owning Host context.
+     * @param clientQueryTimeoutMs - maximum wait for a valid Client response, in milliseconds.
+     */
+    constructor(ctx: Context, clientQueryTimeoutMs: number);
     /**
      * Register one Host provider.
      * @param registration - manifest and local query handler.
@@ -56,7 +61,8 @@ export declare class CordisInspectRegistryService extends Service {
      * @param input - optional lossless JSON input.
      * @param agent - requesting Agent and scope.
      * @param signal - tool-call cancellation.
-     * @returns provider JSON data.
+     * @returns provider JSON data; Client queries fail fast when Gateway has no live Client
+     * and retain only the first observed failure diagnostic for timeout reporting.
      */
     query(platform: CordisInspectPlatform, providerId: string, methodName: string, input: JsonValue | undefined, agent: Agent, signal: AbortSignal): Promise<JsonValue>;
     /**
@@ -64,7 +70,7 @@ export declare class CordisInspectRegistryService extends Service {
      * @param agent - Agent whose Session owns the query.
      * @param requestId - Pending Client query identity.
      * @param resolution - Client provider result or failure.
-     * @returns whether this response settled the still-pending query.
+     * @returns acknowledgement with accepted true only for a success that settles the query; only the first failure diagnostic is retained.
      */
     resolveClientQuery(agent: Agent, requestId: CordisInspectRequestId, resolution: CordisInspectQueryResolution): CordisInspectResolveAck;
     private queryClient;

package/lib/types/inspect-registry.js

@@ -4,13 +4,24 @@ import { snapshotJsonValue } from '@deepseek-ai/dsh-util-values';
 import { assertSupportedJsonSchema, validateJsonSchemaValue } from '@deepseek-ai/dsh-tools';
 /** Registry and cross-page router behind the two model-facing inspect tools. */
 export class CordisInspectRegistryService extends Service {
+    clientQueryTimeoutMs;
     providers = new Map();
     pending = new Map();
     clientManifest;
     nextRequest = 1;
-    /** Register the process-global Host registry. */
-    constructor(ctx) {
+    /**
+     * Register the process-global Host registry.
+     * @param ctx - owning Host context.
+     * @param clientQueryTimeoutMs - maximum wait for a valid Client response, in milliseconds.
+     */
+    constructor(ctx, clientQueryTimeoutMs) {
         super(ctx, 'cordisInspect');
+        this.clientQueryTimeoutMs = clientQueryTimeoutMs;
+        ctx.effect(() => () => {
+            for (const pending of this.pending.values()) {
+                pending.settle({ ok: false, reason: 'cancelled', message: 'Client inspect registry was disposed' });
+            }
+        }, 'cordis-inspect: pending queries');
     }
     /**
      * Register one Host provider.
@@ -61,7 +72,8 @@ export class CordisInspectRegistryService extends Service {
      * @param input - optional lossless JSON input.
      * @param agent - requesting Agent and scope.
      * @param signal - tool-call cancellation.
-     * @returns provider JSON data.
+     * @returns provider JSON data; Client queries fail fast when Gateway has no live Client
+     * and retain only the first observed failure diagnostic for timeout reporting.
      */
     async query(platform, providerId, methodName, input, agent, signal) {
         if (platform === 'host') {
@@ -82,26 +94,28 @@ export class CordisInspectRegistryService extends Service {
      * @param agent - Agent whose Session owns the query.
      * @param requestId - Pending Client query identity.
      * @param resolution - Client provider result or failure.
-     * @returns whether this response settled the still-pending query.
+     * @returns acknowledgement with accepted true only for a success that settles the query; only the first failure diagnostic is retained.
      */
     resolveClientQuery(agent, requestId, resolution) {
         const pending = this.pending.get(requestId);
         if (pending === undefined || pending.request.agentId !== agent.id)
             return { accepted: false };
-        if (!resolution.ok)
+        // A failed page must not prevent another page from supplying a valid result.
+        if (!resolution.ok) {
+            pending.failure ??= `${resolution.reason}: ${resolution.message}`;
             return { accepted: false };
+        }
         try {
             resolution = {
                 ok: true,
                 data: validateOutput('Client', pending.request.provider, pending.method, resolution.data),
             };
         }
-        catch {
+        catch (error) {
+            pending.failure ??= error instanceof Error ? error.message : String(error);
             return { accepted: false };
         }
-        this.pending.delete(requestId);
         pending.settle(resolution);
-        this.ctx.emit('cordis/inspect-query-resolved', { requestId });
         return { accepted: true };
     }
     async queryClient(providerId, methodName, input, agent, signal) {
@@ -111,6 +125,10 @@ export class CordisInspectRegistryService extends Service {
         const method = findMethod(provider, methodName);
         validateInput('Client', providerId, method, input);
         signal.throwIfAborted();
+        const gateway = this.ctx.get('typertGateway');
+        if (gateway !== undefined && !gateway.hasLiveClient()) {
+            throw new Error(`Client inspect query ${providerId}.${methodName} has no connected Harness page. Open or reconnect the Harness page, then retry.`);
+        }
         const requestId = `inspect-${this.nextRequest++}`;
         const request = {
             requestId,
@@ -120,29 +138,56 @@ export class CordisInspectRegistryService extends Service {
             ...input === undefined ? {} : { input },
         };
         const result = new Promise((resolve) => {
-            this.pending.set(requestId, { request, method, settle: resolve });
+            this.pending.set(requestId, {
+                request,
+                method,
+                settle: (resolution) => {
+                    this.pending.delete(requestId);
+                    resolve(resolution);
+                    try {
+                        this.ctx.emit('cordis/inspect-query-resolved', { requestId });
+                    }
+                    catch (error) {
+                        console.error('[cordis-host-runner] notifying Client inspect completion failed:', error);
+                    }
+                },
+            });
         });
         const onAbort = () => {
+            this.pending.get(requestId)?.settle({
+                ok: false,
+                reason: 'cancelled',
+                message: `Client inspect query ${providerId}.${methodName} was cancelled`,
+            });
+        };
+        const timer = setTimeout(() => {
             const pending = this.pending.get(requestId);
             if (pending === undefined)
                 return;
-            this.pending.delete(requestId);
-            pending.settle({ ok: false, reason: 'cancelled', message: `Client inspect query ${providerId}.${methodName} was cancelled` });
-            this.ctx.emit('cordis/inspect-query-resolved', { requestId });
-        };
+            const detail = pending.failure === undefined
+                ? 'Open or reconnect the Harness page, then retry.'
+                : `Client failure: ${pending.failure}`;
+            pending.settle({
+                ok: false,
+                reason: 'provider-error',
+                message: `Client inspect query ${providerId}.${methodName} timed out after ${this.clientQueryTimeoutMs}ms. ${detail}`,
+            });
+        }, this.clientQueryTimeoutMs);
         signal.addEventListener('abort', onAbort, { once: true });
-        if (signal.aborted)
-            onAbort();
-        else
-            this.ctx.emit('cordis/inspect-query', request);
         try {
+            if (signal.aborted)
+                onAbort();
+            else
+                this.ctx.emit('cordis/inspect-query', request);
             const resolution = await result;
             if (!resolution.ok)
                 throw new Error(`${providerId}.${methodName}: ${resolution.message}`);
             return resolution.data;
         }
         finally {
+            clearTimeout(timer);
             signal.removeEventListener('abort', onAbort);
+            this.pending.delete(requestId);
         }
     }
 }

package/lib/types/types.d.ts

@@ -71,7 +71,10 @@ export interface CordisInspectQueryResolved {
 }
 /** Whether a Client answer claimed the still-pending query. */
 export interface CordisInspectResolveAck {
-    /** False for unknown, cancelled, stale, or late answers. */
+    /**
+     * True only for a valid success that settles the query;
+     * false for retained failures and unknown, timed out, cancelled, or late answers.
+     */
     accepted: boolean;
 }
 /** Whether a package starts the current version or replaces it. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-cordis-host-runner",
   "description": "Dynamic package definition registry, host-half sandbox lifecycle, and invoke handler table for model-mounted dual-half packages",
-  "version": "0.1.7-rc.2",
+  "version": "0.2.0-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -45,28 +45,29 @@
   "license": "MIT",
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/schemastery": "~3.18.4",
-    "@deepseek-ai/dsh-util-values": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-util-values": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "~3.18.4"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-brand": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-scope": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-scope": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
     "@deepseek-ai/cordis-plugin-timer": "~1.1.6",
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-brand": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-scope": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-api-gateway": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-scope": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.2"
   }
 }