@deepseek-ai/dsh-tool-cordis 0.2.0-rc.1 → 0.2.0-rc.2

package/README.i18n.yaml

@@ -39,8 +39,8 @@
   en: f57a20cd4e76d13c
   zh: 7b673116422bee87
 /deepseek-ai-dsh-tool-cordis/known-limitations-and-deferred-work:
-  en: ffe15dd1fd333dbf
-  zh: b256afc74a1782cb
+  en: 3c135d9cb67790d2
+  zh: ff2d0a444f55d28f
 /deepseek-ai-dsh-tool-cordis/known-limitations-and-deferred-work/dev-note:
   en: 0a1253c6f7b5e8b9
   zh: 9f56528562c7c914

package/README.md

@@ -68,7 +68,7 @@ Unchanged tool schemas remain prefix-stable. Query results append to history; en
 
 <a id="known-limitations-and-deferred-work"></a>
 
-- Client queries wait for a responding page or cancellation. Inspection cannot invoke service methods, configure plugins, or execute generated code.
+- Client queries need a responding page and use the Host runner's [bounded wait and retry policy](../cordis-host-runner/README.md#client-inspection). Inspection cannot invoke service methods, configure plugins, or execute generated code.
 - `Config.listConfigs` walks the profile Loader tree only. Agent preset `plugins` lists mount in detached preset trees, so a plugin present only inside a preset declaration is not listed unless the profile tree also mounts it.
 
 <a id="dev-note"></a>

package/README.zh.md

@@ -68,7 +68,7 @@ Host provider 结合生成的 Service/Event 目录、经 app-boot Config 投影
 
 <a id="known-limitations-and-deferred-work"></a>
 
-- Client 查询等待页面响应或取消。检查不能调用服务方法、配置插件或执行生成代码。
+- Client 查询需要页面响应，并采用 Host runner 的[有界等待与重试策略](../cordis-host-runner/README.zh.md#client-inspection)。检查不能调用服务方法、配置插件或执行生成代码。
 - `Config.listConfigs` 只遍历 profile 的 Loader 树。Agent preset 的 `plugins` 列表挂载在独立的 preset 树中，所以只出现在 preset 声明里的插件不会被列出，除非 profile 树也挂载了它。
 
 <a id="dev-note"></a>

package/lib/index.js

@@ -54,7 +54,7 @@ function apply(ctx) {
 	}));
 	ctx.tools.register(defineTool({
 		name: "cordis_inspect_query",
-		description: "Run a read-only query declared by an Inspect Provider. platform, provider, and method must come from cordis_inspect_list, and input must satisfy that method's schema. Use this Tool before writing plugin code to read exact Service methods, Event modes, plugin Config schemas, Tool schemas, theme tokens, or live Slot trees and props. Host queries run locally. A Client query waits for the first valid page response and remains pending until a page answers or the Tool is cancelled. This Tool cannot invoke business Service methods or modify the runtime.",
+		description: "Run a read-only query declared by an Inspect Provider. platform, provider, and method must come from cordis_inspect_list, and input must satisfy that method's schema. Use this Tool before writing plugin code to read exact Service methods, Event modes, plugin Config schemas, Tool schemas, theme tokens, or live Slot trees and props. Host queries run locally. A Client query waits for the first valid page response within the configured timeout; otherwise it reports a Client failure or asks you to reconnect and retry. This Tool cannot invoke business Service methods or modify the runtime.",
 		parameters: {
 			platform: {
 				type: "string",

package/lib/types/api-catalog.js

@@ -3308,6 +3308,12 @@ export const SERVICE_API = [
                 description: 'Carrier adapter shared by the WebSocket mux and local Host transports.',
                 parameters: [],
             },
+            {
+                signature: 'hasLiveClient(): boolean',
+                description: 'Check for an active Client event stream.',
+                parameters: [],
+                returns: 'whether a stream is open and has not been cancelled.',
+            },
             {
                 signature: 'registerRemoteEvents( source: TypertRemoteEventSource, host: RemoteEventHostInfo, ): () => Promise<void>',
                 description: 'Register the sole application-selected forwarded-event source.',
@@ -3334,6 +3340,26 @@ export const SERVICE_API = [
         summary: '`ctx.userQuestions`: validation plus the scoped answerer waterfall.',
         description: '`ctx.userQuestions`: validation plus the scoped answerer waterfall.',
         methods: [
+            {
+                signature: '@Remote answer(agent: Agent, callId: ToolCallId, answer: AskUserQuestionAnswer): boolean',
+                description: 'Answer a continued question. The reply is steered into the agent as a user message whose source names the call; that message is also the record that closes the question in the projection.',
+                parameters: [{ name: 'agent', description: 'Live root agent for the owning Session.' }, { name: 'callId', description: 'Continued question identity.' }, { name: 'answer', description: 'Complete structured answer batch, one item per question of the call.' }],
+                returns: 'Whether the question is still continued; an accepted reply stays queued until the agent admits its user message.',
+                throws: ['{UserQuestionError} `BAD_ANSWER` when the batch does not name each question of the call exactly once, or `REPLY_QUEUED` when a reply is already waiting for admission.'],
+            },
+            {
+                signature: '@Remote({ mode: \'stream\' }) async *attachWait(agent: Agent, callId: ToolCallId, signal: AbortSignal): AsyncIterable<{ remainingMs: number }>',
+                description: 'Let one answer UI hold a live timed wait. Closing the stream releases its claim.',
+                parameters: [{ name: 'agent', description: 'Live root agent owning the question.' }, { name: 'callId', description: 'Foreground tool call to attach to.' }, { name: 'signal', description: 'Remote stream cancellation, including Client disconnect.' }],
+                returns: 'One Host-computed remaining duration, or no frames once the wait ended.',
+            },
+            {
+                signature: 'async askTimed( request: AskUserQuestionRequest & { agent: Agent }, callId: ToolCallId, timeoutMs: number, ): Promise<TimedUserQuestionResult>',
+                description: 'Foreground wait whose first settlement the Client decides: the Client rejects with `ASK_TIMED_OUT` when its countdown ends, and this method maps that code to the pending result.',
+                parameters: [{ name: 'request', description: 'Questions, live owner agent, and abort signal.' }, { name: 'callId', description: 'Tool call identity the Client card is keyed by.' }, { name: 'timeoutMs', description: 'Positive foreground wait in milliseconds.' }],
+                returns: 'The answer when it arrives inside the window, otherwise a pending result, also when no connected Client claimed the request by the deadline.',
+                throws: ['{UserQuestionError} `BAD_TIMEOUT` for a non-integer, non-positive, or oversized wait.'],
+            },
             {
                 signature: 'async ask(request: AskUserQuestionRequest): Promise<AskUserQuestionAnswer>',
                 description: 'Ask the scoped answerer waterfall and wait for the user\'s answer.\n\nWhen a caller supplies an agent, human interaction is valid only for the exact live runtime root. Runtime ownership, not durable session lineage, decides this boundary: an owned child has no human answerer and would block forever, while a lineage-bearing session resumed as a new runtime root may ask normally.',
@@ -4479,7 +4505,7 @@ export const TYPE_API = [
     },
     {
         name: 'AskUserQuestionRequestEvent',
-        declaration: 'export interface AskUserQuestionRequestEvent {\n    questions: AskUserQuestionItem[];\n    agent?: Agent;\n    signal?: AbortSignal;\n}',
+        declaration: 'export interface AskUserQuestionRequestEvent {\n    questions: AskUserQuestionItem[];\n    agent?: Agent;\n    signal?: AbortSignal;\n    wait?: {\n        callId: ToolCallId;\n        timed?: boolean;\n    };\n}',
     },
     {
         name: 'AssembleContext',
@@ -7457,6 +7483,10 @@ export const TYPE_API = [
         name: 'TerminalWaitReason',
         declaration: 'export type TerminalWaitReason = \'stdin_read\' | \'inferred_idle\' | \'timeout\' | \'session_exit\';',
     },
+    {
+        name: 'TimedUserQuestionResult',
+        declaration: 'export type TimedUserQuestionResult = AskUserQuestionAnswer | {\n    pending: true;\n    callId: ToolCallId;\n};',
+    },
     {
         name: 'TimeOutOfRangeError',
         declaration: 'export interface TimeOutOfRangeError {\n    readonly code: \'time_out_of_range\';\n    readonly message: string;\n}',

package/lib/types/index.js

@@ -34,9 +34,9 @@ export function apply(ctx) {
         description: 'Run a read-only query declared by an Inspect Provider. platform, provider, and method must come from '
             + 'cordis_inspect_list, and input must satisfy that method\'s schema. Use this Tool before writing plugin code '
             + 'to read exact Service methods, Event modes, plugin Config schemas, Tool schemas, theme tokens, or live '
-            + 'Slot trees and props. Host queries run locally. A Client query waits for the first valid page response and '
-            + 'remains pending until a page answers or the Tool is cancelled. This Tool cannot invoke business Service '
-            + 'methods or modify the runtime.',
+            + 'Slot trees and props. Host queries run locally. A Client query waits for the first valid page response '
+            + 'within the configured timeout; otherwise it reports a Client failure or asks you to reconnect and retry. '
+            + 'This Tool cannot invoke business Service methods or modify the runtime.',
         parameters: {
             platform: { type: 'string', required: true, enum: ['host', 'client'], description: 'Runtime platform that owns the Provider.' },
             provider: { type: 'string', required: true, description: 'Exact Provider ID returned by cordis_inspect_list.' },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tool-cordis",
   "description": "Read-only runtime API inspection for Harness plugin development",
-  "version": "0.2.0-rc.1",
+  "version": "0.2.0-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -33,21 +33,21 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.1"
+    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
     "@deepseek-ai/cordis-plugin-group": "~1.0.4",
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.0-rc.2",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.1",
-    "@deepseek-ai/schemastery": "~3.18.4",
-    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.1"
+    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "~3.18.4"
   }
 }