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

package/README.i18n.yaml

@@ -18,8 +18,8 @@
   en: e8c90b0ad037513c
   zh: 563454508c30d9b0
 /deepseek-ai-dsh-tool-cordis/understand-the-implementation:
-  en: de18fe3471a4a341
-  zh: fda07860cfe1e325
+  en: ff959016d633c6c0
+  zh: d84dfa7e9d73532f
 /deepseek-ai-dsh-tool-cordis/further-exploration:
   en: 1863373f02bcc196
   zh: 3efdbf5569411562
@@ -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

@@ -35,7 +35,7 @@ Creator mode includes this toolset. Other compositions mount `@deepseek-ai/dsh-t
 <details>
 <summary>Implementation internals — click to expand</summary>
 
-Host providers combine generated Service/Event catalogs, the live Loader tree projected through the app-boot Config projector, and the requesting agent's tool registry. Client providers synchronize their manifests through the existing inspection registry and answer queries from a connected page. The host entry owns the Host provider registrations and the preset row owns the two tools, each through Cordis effects; the registry rejects a duplicate provider id, which is why the providers register once per process rather than per preset. No invariant companion is published because inspection reads its providers directly and maintains no independent runtime projection.
+Host providers combine generated Service/Event catalogs, the live Loader tree projected through the app-boot Config projector, and the requesting agent's tool registry. Client providers synchronize their manifests through the existing inspection registry and answer queries from a connected page. The host entry owns the Host provider registrations and the preset row owns the two tools, each through Cordis effects; the registry rejects a duplicate provider id, which is why the providers register once per process rather than per preset.
 
 </details>
 
@@ -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

@@ -35,7 +35,7 @@ kind: "package-reference"
 <details>
 <summary>实现细节 — 点击展开</summary>
 
-Host provider 结合生成的 Service/Event 目录、经 app-boot Config 投影器投影的运行中 Loader 树，以及请求 agent 的工具注册表。Client provider 通过现有检查注册表同步清单，并从已连接页面回答查询。宿主入口持有 Host provider 的注册，preset 行持有两个工具，都通过 Cordis effect；注册表拒绝重复的 provider id，所以 provider 按进程注册一次而不是按 preset 注册。检查直接读取 provider，不维护独立运行时投影，因此不发布不变式配套插件。
+Host provider 结合生成的 Service/Event 目录、经 app-boot Config 投影器投影的运行中 Loader 树，以及请求 agent 的工具注册表。Client provider 通过现有检查注册表同步清单，并从已连接页面回答查询。宿主入口持有 Host provider 的注册，preset 行持有两个工具，都通过 Cordis effect；注册表拒绝重复的 provider id，所以 provider 按进程注册一次而不是按 preset 注册。
 
 </details>
 
@@ -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

@@ -73,6 +73,12 @@ export const SERVICE_API = [
                 parameters: [{ name: 'definition', description: 'Parsed configuration supplied by the declaring plugin.' }],
                 returns: 'Definition disposer after activation or its diagnostic settles; the declaring plugin owns it.',
             },
+            {
+                signature: 'inspectCompositions(ctx?: Context): AgentPresetInspection[]',
+                description: 'Inspect retained revisions, or the exact revision an Agent joined.',
+                parameters: [{ name: 'ctx', description: 'optional Agent context; omission includes all retained revisions.' }],
+                returns: 'detached module references and isolation diagnostics; no match returns an empty list.',
+            },
             {
                 signature: 'async list(): Promise<AgentPreset[]>',
                 description: 'Read every declared preset, including activation failures.',
@@ -487,6 +493,32 @@ export const SERVICE_API = [
             },
         ],
     },
+    {
+        key: 'claudeCodeMods',
+        summary: 'The bridge service: loaded mods, their hooks, and the harness listeners that raise their events.',
+        description: 'The bridge service: loaded mods, their hooks, and the harness listeners that raise their events. Mods join through ClaudeCodeMods.add, which defineMod calls when a mod plugin mounts. The Remote methods let a Client draw each session\'s band above the prompt and press its buttons.',
+        methods: [
+            {
+                signature: '@Remote({ mode: \'stream\' }) watchBand(agent: Agent, signal: AbortSignal): AsyncIterable<SurfaceSnapshot>',
+                description: 'Watch the band above the prompt of one session: the current drawing, then every redraw, until the Client stops watching.',
+                parameters: [{ name: 'agent', description: 'the session\'s agent, resolved by the Gateway.' }, { name: 'signal', description: 'carrier cancellation.' }],
+                returns: 'the band\'s snapshots.',
+            },
+            {
+                signature: '@Remote pressBand(agent: Agent, generation: number, actionId: string): Promise<SurfaceSnapshot>',
+                description: 'Press a button of the band\'s current drawing: runs the mod\'s `onPress` and redraws.',
+                parameters: [{ name: 'agent', description: 'the session\'s agent, resolved by the Gateway.' }, { name: 'generation', description: 'the drawing the Client saw.' }, { name: 'actionId', description: 'the button\'s action id in that drawing.' }],
+                returns: 'the snapshot after the press.',
+            },
+            {
+                signature: 'async add(definition: ModDefinition): Promise<() => Promise<void>>',
+                description: 'Load one mod beneath every mod loaded before it: run its `register`, keep its hooks, and report which of its events this host never raises.',
+                parameters: [{ name: 'definition', description: 'the mod as its plugin defined it.' }],
+                returns: 'the disposer that removes the mod\'s hooks, closes its timers, and releases its registrations.',
+                throws: ['Error when the name is invalid or taken, or when `register` throws (Claude Code\'s `hooks module did not load` wording).'],
+            },
+        ],
+    },
     {
         key: 'clientModules',
         summary: 'The web plugin table service: incremental `dsh.client` scan + wire composition + bundle route + index injection rows.',
@@ -931,8 +963,8 @@ export const SERVICE_API = [
     },
     {
         key: 'fileUploads',
-        summary: 'Host service owning upload storage and Agent-scoped staged receipts.',
-        description: 'Host service owning upload storage and Agent-scoped staged receipts.',
+        summary: 'Host service owning upload storage and receipts keyed by each receiving Agent\'s exact Session.',
+        description: 'Host service owning upload storage and receipts keyed by each receiving Agent\'s exact Session.',
         methods: [
             {
                 signature: 'registerAgentResolver(resolve: AgentResolver): () => void',
@@ -954,7 +986,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'resolve(agent: Agent, receiptId: FileUploadReceiptId): FileAttachmentRef | undefined',
-                description: 'Resolve one staged receipt inside its receiving Agent scope.',
+                description: 'Resolve one staged receipt for the receiving Agent\'s exact Session.',
                 parameters: [{ name: 'agent', description: 'receiving Agent.' }, { name: 'receiptId', description: 'opaque receipt minted for one completed upload.' }],
                 returns: 'durable file reference, or `undefined` for an unknown or foreign receipt.',
             },
@@ -1190,19 +1222,6 @@ export const SERVICE_API = [
             },
         ],
     },
-    {
-        key: 'invariants',
-        summary: 'Package-owned invariant registry with global and regex-based selection.',
-        description: 'Package-owned invariant registry with global and regex-based selection.',
-        methods: [
-            {
-                signature: 'register(packageName: string, installer: InvariantInstaller): () => void',
-                description: 'Register one package\'s invariant installer. The package name is reserved even when filtering disables its checks. Enabled installers run in a child fiber; failure disposes that fiber and releases the reservation.',
-                parameters: [{ name: 'packageName', description: 'full npm package name that owns the contribution.' }, { name: 'installer', description: 'listener or startup-check installer for the child context.' }],
-                returns: 'an effect-scoped disposer for the registration.',
-            },
-        ],
-    },
     {
         key: 'jobController',
         summary: 'Host service backing the generated `ctx.remote.job` namespace.',
@@ -1588,7 +1607,7 @@ export const SERVICE_API = [
                 signature: '@Remote listBundles(): Promise<BundleInfo[]>',
                 description: 'Read the profile\'s installed bundles, the bundles this dsh installation supplies, and the selected names that are not bundles. A dependency without a bundle patch is listed, as a `not-bundle` problem, only while it is selected.',
                 parameters: [],
-                returns: 'Package versions, manifest descriptions, rows, optional display metadata, activation selections, whether the installation offers the bundle, and removal availability.',
+                returns: 'Package versions, manifest descriptions, the installable spec of profile dependencies, rows, optional display metadata, activation selections, whether the installation offers the bundle, and removal availability.',
             },
             {
                 signature: '@Remote async registries(): Promise<PluginRegistries>',
@@ -1634,8 +1653,8 @@ export const SERVICE_API = [
             },
             {
                 signature: '@Remote removeBundle(name: string): Promise<ChangeResult>',
-                description: 'Unload and remove a profile-owned bundle dependency through dsh plugin\'s pnpm path.',
-                parameters: [{ name: 'name', description: 'Installed dependency name.' }],
+                description: 'Unload and remove a profile-owned bundle dependency through dsh plugin\'s pnpm path; a selected name no dependency holds is only deselected.',
+                parameters: [{ name: 'name', description: 'Installed dependency or selected bundle name.' }],
                 returns: 'Removal diagnostics and the remaining profile state.',
             },
         ],
@@ -1797,7 +1816,7 @@ export const SERVICE_API = [
         methods: [
             {
                 signature: 'async create(sessionId: SessionId, request: ScheduleCreateRequest, signal?: AbortSignal): Promise<ScheduleRecord>',
-                description: 'Create a reminder bound to the caller-selected Session without activating it.\n\nThe request must supply a title; a missing, blank-after-trim, or over-long title rejects with `invalid_prompt` instead of deriving one from the prompt. The record is built from the clock reading taken before the request joins the serialized queue, so a create that waits behind a longer operation keeps its request-time anchor and may already be due when the queue reaches it.',
+                description: 'Create a reminder bound to the caller-selected Session without activating it.\n\nThe request must supply a title; a missing, blank-after-trim, or over-long title rejects with `invalid_prompt` instead of deriving one from the prompt. A Session a delegated child owns rejects with `subagent_session`, because delivery can never reach it: the child is one whose delegation depth is above zero. The record is built from the clock reading taken before the request joins the serialized queue, so a create that waits behind a longer operation keeps its request-time anchor and may already be due when the queue reaches it.',
                 parameters: [{ name: 'sessionId', description: 'Original Session receiving the reminder.' }, { name: 'request', description: 'Validated tool selector, required title, and reminder content.' }, { name: 'signal', description: 'Optional cancellation checked before persistence begins, including after FIFO waits.' }],
                 returns: 'The durably stored schedule. Cancellation does not roll back an in-flight write.',
             },
@@ -1822,15 +1841,15 @@ export const SERVICE_API = [
             },
             {
                 signature: '@Remote(\'delete\') async delete(request: ScheduleDeleteRequest, signal?: AbortSignal): Promise<ScheduleDeleteResult>',
-                description: 'Delete one task belonging to the selected Session, leaving queued messages intact.\n\nThe row is removed: the task no longer schedules, leaves `list` and `catalog`, and its saved delivery records go with it.',
+                description: 'Delete one task belonging to the selected Session, leaving queued messages intact.\n\nThe row is removed: the task no longer schedules, leaves `list` and `catalog`, and its saved delivery records go with it. A task bound to a Session a delegated child owns stays deletable even though creation and timing edits refuse that binding, so a task stored before that rule existed remains removable.',
                 parameters: [{ name: 'request', description: 'Session and exact task identity.' }, { name: 'signal', description: 'Optional cancellation checked before persistence begins, including after FIFO waits.' }],
                 returns: 'Whether that Session owned a deleted task. Cancellation does not roll back an in-flight write.',
             },
             {
                 signature: '@Remote(\'update\') async update(request: ScheduleUpdateRequest, signal?: AbortSignal): Promise<ScheduleUpdateResult>',
-                description: 'Update the name, instruction, and timing of an active task within the original Session binding without activating the Session or changing saved deliveries.\n\nEach supplied field replaces its stored value; an omitted field keeps it. A name or instruction change alone does not reset the committed target.',
+                description: 'Update the name, instruction, and timing of an active task within the original Session binding without activating the Session or changing saved deliveries.\n\nEach supplied field replaces its stored value; an omitted field keeps it. A name or instruction change alone does not reset the committed target. A Session a delegated child owns returns the non-mutating `subagent_session` result, so an edit cannot re-arm a task bound to a Session delivery can never reach, and the Web editor can explain the refusal through the ordinary result it already renders.',
                 parameters: [{ name: 'request', description: 'Task binding, complete observed record, and any combination of timing, name, and instruction.' }, { name: 'signal', description: 'Cancellation checked after domain readiness and FIFO waits, before persistence begins.' }],
-                returns: 'The committed record, unchanged record for a no-op, or a non-mutating input/lookup/conflict result. Storage and lifecycle failures reject; cancellation after a write starts does not roll it back.',
+                returns: 'The committed record, unchanged record for a no-op, or a non-mutating input/lookup/conflict/refusal result. Storage and lifecycle failures reject; cancellation after a write starts does not roll it back.',
             },
         ],
     },
@@ -1854,7 +1873,7 @@ export const SERVICE_API = [
             {
                 signature: '@Remote(\'list\') async list(_request: SessionListRequest, signal: AbortSignal): Promise<SessionListValue>',
                 description: 'Read all visible Session rows without resuming an Agent.',
-                parameters: [{ name: '_request', description: 'reserved empty list request.' }, { name: 'signal', description: 'cancellation for persistence reads.' }],
+                parameters: [{ name: '_request', description: 'reserved empty list request.' }, { name: 'signal', description: 'cancellation for persistence reads and summary generation.' }],
                 returns: 'visible Session summaries ordered by activity.',
             },
             {
@@ -2323,7 +2342,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'async flush(session: Session): Promise<boolean>',
-                description: 'Dispatch the awaited `session/flush` durability checkpoint for `session`, with the carrier captured at enter. THE flush entry point: the store owns the carrier, so callers (the checkpoint policy\'s per-request barrier, goal-round-driver\'s idle checkpoint, teardown drains, and consumers that flush themselves before reading storage) must come through here rather than dispatch a raw `ctx.parallel(\'session/flush\', …)` — one owner, one spelling, and the scoped-dispatch invariant can pin it.',
+                description: 'Dispatch the awaited `session/flush` durability checkpoint for `session`, with the carrier captured at enter. THE flush entry point: the store owns the carrier, so callers (the checkpoint policy\'s per-request barrier, goal-round-driver\'s idle checkpoint, teardown drains, and consumers that flush themselves before reading storage) must come through here rather than dispatch a raw `ctx.parallel(\'session/flush\', …)` — one owner and one spelling.',
                 parameters: [{ name: 'session', description: 'the session whose buffered events must reach durable storage.' }],
                 returns: 'whether at least one durability listener participated, after every listener has settled successfully.',
                 throws: ['the first registered listener failure after every listener settles.'],
@@ -2768,7 +2787,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'get(name: string): DomainImpl | undefined',
-                description: 'Look up an open domain by name, untyped. Diagnostic surface (the package invariant cross-checks change events against live domain state); typed consumers hold the handle returned by open.',
+                description: 'Look up an open domain by name, untyped. Diagnostic surface; typed consumers hold the handle returned by open.',
                 parameters: [{ name: 'name', description: 'Domain name.' }],
                 returns: 'the open domain runtime, or `undefined` when not open.',
             },
@@ -3308,6 +3327,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 +3359,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.',
@@ -3923,7 +3968,7 @@ export const EVENT_API = [
         mode: 'emit',
         signature: '\'credentials/reference-updated\'(ref: CredentialRef): void',
         summary: 'Committed change to a provider-managed credential source: a `set`, an `unset`, or an external edit observed in storage.',
-        description: 'Committed change to a provider-managed credential source: a `set`, an `unset`, or an external edit observed in storage. Ambient process-environment changes are not observable and never emit. Listener failures are contained and logged — a sync throw and an async rejection alike — without changing the committed operation\'s outcome, except `INVARIANT`-coded failures, which rethrow after every listener ran; that rethrow reaches the emitter only from synchronous listeners, so invariant checks on this event must not be async functions.',
+        description: 'Committed change to a provider-managed credential source: a `set`, an `unset`, or an external edit observed in storage. Ambient process-environment changes are not observable and never emit. Listener failures are contained and logged — a sync throw and an async rejection alike — without changing the committed operation\'s outcome.',
         parameters: [{ name: 'ref', description: 'the reference whose stored value changed.' }],
     },
     {
@@ -4397,6 +4442,10 @@ export const TYPE_API = [
         name: 'AgentPresetDocument',
         declaration: 'export interface AgentPresetDocument {\n    readonly agentPreset: string;\n    readonly content: string;\n    readonly name?: string;\n    readonly description?: string;\n}',
     },
+    {
+        name: 'AgentPresetInspection',
+        declaration: 'export interface AgentPresetInspection {\n    readonly id: string;\n    readonly modules: readonly {\n        readonly moduleName: string;\n        readonly baseUrl?: string;\n        readonly useHostBase: boolean;\n    }[];\n    readonly leakedServices: readonly string[];\n}',
+    },
     {
         name: 'AgentPresetRoster',
         declaration: 'export interface AgentPresetRoster {\n    readonly presets: readonly AgentPresetRow[];\n}',
@@ -4421,6 +4470,10 @@ export const TYPE_API = [
         name: 'AgentStatus',
         declaration: 'export type AgentStatus = \'idle\' | \'running\';',
     },
+    {
+        name: 'AnyHook',
+        declaration: 'export type AnyHook = ModHook<unknown, unknown>;',
+    },
     {
         name: 'ApiKeyRecord',
         declaration: 'export interface ApiKeyRecord {\n    readonly kind: \'api-key\';\n    readonly key?: string;\n    readonly env?: Readonly<Record<string, string>>;\n}',
@@ -4453,6 +4506,10 @@ export const TYPE_API = [
         name: 'ArchiveSessionOptions',
         declaration: 'export interface ArchiveSessionOptions {\n    readonly stopActivity?: boolean;\n}',
     },
+    {
+        name: 'AskOptions',
+        declaration: 'export interface AskOptions {\n    options?: readonly string[];\n    header?: string;\n    multiSelect?: true;\n}',
+    },
     {
         name: 'AskUserQuestionAnswer',
         declaration: 'export interface AskUserQuestionAnswer {\n    answers: AskUserQuestionAnswerItem[];\n}',
@@ -4479,7 +4536,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',
@@ -4597,6 +4654,10 @@ export const TYPE_API = [
         name: 'BashEnvVariableInfo',
         declaration: 'export interface BashEnvVariableInfo extends BashEnvVariable {\n    contributor: string;\n    key: DshEnvironmentKey;\n}',
     },
+    {
+        name: 'BoxProps',
+        declaration: 'export interface BoxProps {\n    readonly flexDirection?: \'row\' | \'column\' | undefined;\n    readonly paddingX?: number | undefined;\n    readonly paddingY?: number | undefined;\n    readonly padding?: number | undefined;\n    readonly gap?: number | undefined;\n    readonly border?: boolean | string | undefined;\n    readonly borderColor?: string | undefined;\n    readonly children?: UiNode | undefined;\n}',
+    },
     {
         name: 'Branded',
         declaration: 'export type Branded<B extends string> = string & {\n    readonly [BRAND]: B;\n};',
@@ -4611,15 +4672,19 @@ export const TYPE_API = [
     },
     {
         name: 'BundleInfo',
-        declaration: 'export interface BundleInfo {\n    name: string;\n    version?: string;\n    meta?: PluginLocalizedMeta;\n    description?: string;\n    enabled: boolean;\n    installed: boolean;\n    optional: boolean;\n    removable: boolean;\n    readOnlyReason?: ReadOnlyReason;\n    error?: ManagementError;\n    rows: BundleRowInfo[];\n    overrides: string[];\n}',
+        declaration: 'export interface BundleInfo {\n    name: string;\n    version?: string;\n    meta?: PluginLocalizedMeta;\n    description?: string;\n    enabled: boolean;\n    installed: boolean;\n    source?: string;\n    optional: boolean;\n    removable: boolean;\n    readOnlyReason?: ReadOnlyReason;\n    error?: ManagementError;\n    rows: BundleRowInfo[];\n    overrides: string[];\n}',
     },
     {
         name: 'BundleRowInfo',
         declaration: 'export interface BundleRowInfo {\n    rowId: string;\n    moduleName: string;\n    meta?: PluginLocalizedMeta;\n    entryId?: PluginEntryId;\n}',
     },
+    {
+        name: 'ButtonProps',
+        declaration: 'export interface ButtonProps {\n    readonly label: string;\n    readonly hotkey?: string | undefined;\n    readonly disabled?: boolean | undefined;\n    readonly onPress?: (() => unknown) | undefined;\n}',
+    },
     {
         name: 'ChangeResult',
-        declaration: 'export interface ChangeResult {\n    changed: boolean;\n    application: \'applied\' | \'restart-required\' | \'overridden\' | \'failed\' | \'cancelled\';\n    stage: \'install\' | \'enable\' | \'remove\';\n    target: string;\n    enabled?: boolean;\n    error?: ManagementError;\n    warnings?: string[];\n    packageResult?: PackageResult;\n    bundle?: string;\n    pendingBuilds?: string[];\n    approvedBuilds?: string[];\n    registries?: Registry[];\n    failedAt?: \'registry\' | \'spec-host\';\n}',
+        declaration: 'export interface ChangeResult {\n    changed: boolean;\n    application: \'applied\' | \'restart-required\' | \'overridden\' | \'failed\' | \'cancelled\';\n    stage: \'install\' | \'enable\' | \'remove\';\n    target: string;\n    enabled?: boolean;\n    error?: ManagementError;\n    warnings?: string[];\n    packageResult?: PackageResult;\n    bundle?: string;\n    version?: string;\n    pendingBuilds?: string[];\n    approvedBuilds?: string[];\n    registries?: Registry[];\n    failedAt?: \'registry\' | \'spec-host\';\n}',
     },
     {
         name: 'ClientArtifactBaseline',
@@ -4653,6 +4718,10 @@ export const TYPE_API = [
         name: 'CommandId',
         declaration: 'export type CommandId = Branded<\'CommandId\'>;',
     },
+    {
+        name: 'CommandInfo',
+        declaration: 'export interface CommandInfo {\n    name: string;\n    description: string;\n    source: \'builtin\' | \'plugin\' | \'user\' | \'mcp\';\n    plugin?: string;\n}',
+    },
     {
         name: 'CommandInputDescriptor',
         declaration: 'export interface CommandInputDescriptor {\n    readonly hint: string;\n    readonly attachments?: boolean;\n}',
@@ -4665,6 +4734,18 @@ export const TYPE_API = [
         name: 'CommandResult',
         declaration: 'export type CommandResult = {\n    readonly kind: \'success\';\n    readonly text?: string;\n    readonly sourceEventSeq?: SessionSeq;\n} | {\n    readonly kind: \'error\';\n    readonly text: string;\n};',
     },
+    {
+        name: 'CommandRunInput',
+        declaration: 'export interface CommandRunInput {\n    command: string;\n    args: string;\n    origin: PromptOrigin;\n}',
+    },
+    {
+        name: 'CommandRunResult',
+        declaration: 'export interface CommandRunResult {\n    text?: string;\n}',
+    },
+    {
+        name: 'CommandSpec',
+        declaration: 'export interface CommandSpec {\n    name: string;\n    description: string;\n    argumentHint?: string;\n    immediate?: true;\n}',
+    },
     {
         name: 'CommandSubmitAttachment',
         declaration: 'export type CommandSubmitAttachment = ({\n    readonly type: \'image\';\n} & EncodedImageAttachment) | {\n    readonly type: \'file\';\n    readonly receiptId: string;\n};',
@@ -5221,6 +5302,30 @@ export const TYPE_API = [
         name: 'GrantRecord',
         declaration: 'export interface GrantRecord {\n    readonly kind: \'grant\';\n    readonly payload: unknown;\n}',
     },
+    {
+        name: 'HookBudget',
+        declaration: 'export interface HookBudget {\n    readonly ms: number;\n    readonly remainingMs: number;\n}',
+    },
+    {
+        name: 'HookFailure',
+        declaration: 'export interface HookFailure {\n    readonly kind: \'throw\' | \'timeout\';\n    readonly message: string;\n}',
+    },
+    {
+        name: 'HookMatcher',
+        declaration: 'export type HookMatcher = Readonly<Record<string, MatcherValue>>;',
+    },
+    {
+        name: 'HookNext',
+        declaration: 'export interface HookNext<E, R> {\n    (e: E): Promise<R>;\n    readonly signal: AbortSignal;\n    readonly origin: HookOrigin;\n    readonly budget: HookBudget;\n    to(e: E, tier: ModTier): Promise<R>;\n    readonly error?: HookFailure;\n    readonly called?: boolean;\n}',
+    },
+    {
+        name: 'HookOrigin',
+        declaration: 'export interface HookOrigin {\n    readonly plugin: string;\n    readonly tier: ModTier;\n}',
+    },
+    {
+        name: 'HookRegistration',
+        declaration: 'export interface HookRegistration {\n    catch(handler: AnyHook): void;\n}',
+    },
     {
         name: 'HostConnectionFetch',
         declaration: 'export interface HostConnectionFetch {\n    register(route: ConnectionFetchRoute): () => Promise<void>;\n}',
@@ -5313,14 +5418,6 @@ export const TYPE_API = [
         name: 'InvalidTimeZoneError',
         declaration: 'export interface InvalidTimeZoneError {\n    readonly code: \'invalid_time_zone\';\n    readonly message: string;\n}',
     },
-    {
-        name: 'InvariantFailure',
-        declaration: 'export type InvariantFailure = (message: string) => never;',
-    },
-    {
-        name: 'InvariantInstaller',
-        declaration: 'export interface InvariantInstaller {\n    (ctx: Context, fail: InvariantFailure): void | Promise<void>;\n    readonly inject?: Inject;\n}',
-    },
     {
         name: 'InvocationDescriptor',
         declaration: 'export interface InvocationDescriptor {\n    readonly id: string;\n    readonly service: string;\n    readonly namespace: string;\n    readonly method: string;\n    readonly implementation?: string;\n    readonly mode?: \'stream\';\n    readonly invocation: {\n        readonly kind: \'direct\';\n    } | {\n        readonly kind: \'context\';\n        readonly context: string;\n        readonly wire: string;\n        readonly codec: TypertCodec;\n    };\n    readonly scope?: {\n        readonly context: string;\n        readonly wire: string;\n    };\n    readonly parameters: readonly InvocationParameterDescriptor[];\n    readonly uplink?: {\n        readonly codec: TypertCodec;\n    };\n    readonly cancellation?: {\n        readonly parameter: \'signal\';\n    };\n    readonly result: TypertCodec;\n    readonly sourceLocation?: InvocationSourceLocation;\n}',
@@ -5601,6 +5698,10 @@ export const TYPE_API = [
         name: 'ManualCompactAgentContext',
         declaration: 'export interface ManualCompactAgentContext extends CompactionAgentContext {\n    runMaintenance<T>(task: (signal: AbortSignal) => Promise<T>): Promise<T>;\n}',
     },
+    {
+        name: 'MatcherValue',
+        declaration: 'export type MatcherValue = string | number | boolean | null | RegExp | readonly (string | number | boolean | null)[];',
+    },
     {
         name: 'McpResourceProvider',
         declaration: 'export interface McpResourceProvider {\n    request(request: McpResourceRequest, exec: ToolExecution): Promise<JsonValue>;\n}',
@@ -5701,6 +5802,10 @@ export const TYPE_API = [
         name: 'MessageSourceMap',
         declaration: 'export interface MessageSourceMap {\n    user: {\n        kind: \'user\';\n    };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    \'system-prompt\': SystemPromptMessageSource;\n}',
     },
+    {
+        name: 'ModDefinition',
+        declaration: 'export interface ModDefinition {\n    readonly name: string;\n    readonly version?: string;\n    readonly root?: string;\n    readonly options?: PluginOptions;\n    readonly register: ModRegister;\n}',
+    },
     {
         name: 'ModelCatalog',
         declaration: 'export interface ModelCatalog {\n    readonly default: ModelSelection;\n    readonly routableProviders: readonly string[];\n    readonly groups: readonly ModelProviderGroup[];\n    readonly failures: readonly ModelCatalogFailure[];\n}',
@@ -5737,6 +5842,30 @@ export const TYPE_API = [
         name: 'ModelReasoningEffort',
         declaration: 'export interface ModelReasoningEffort {\n    readonly id: string;\n    readonly name: string;\n    readonly description?: string;\n}',
     },
+    {
+        name: 'ModEvents',
+        declaration: 'export interface ModEvents {\n    \'session.start\': {\n        input: SessionStartInput;\n        result: SessionStartResult;\n    };\n    \'session.end\': {\n        input: SessionEndInput;\n        result: SessionEndResult;\n    };\n    \'prompt.submit\': {\n        input: PromptSubmitInput;\n        result: PromptSubmitResult;\n    };\n    \'turn.start\': {\n        input: TurnStartInput;\n        result: TurnStartResult;\n    };\n    \'turn.complete\': {\n        input: TurnCompleteInput;\n        result: TurnCompleteResult;\n    };\n    \'tool.call\': {\n        input: ToolCallInput;\n        result: ToolCallResult;\n    };\n    \'command.run\': {\n        input: CommandRunInput;\n        result: CommandRunResult;\n    };\n    \'ui.render\': {\n        input: UiRenderInput;\n        result: UiRenderResult;\n    };\n}',
+    },
+    {
+        name: 'ModHook',
+        declaration: 'export type ModHook<E, R> = ($: ModsApi, e: E, next: HookNext<E, R>) => R | Promise<R>;',
+    },
+    {
+        name: 'ModOn',
+        declaration: 'export interface ModOn {\n    <K extends keyof ModEvents>(event: K, hook: ModHook<ModEvents[K][\'input\'], ModEvents[K][\'result\']>): HookRegistration;\n    <K extends keyof ModEvents>(event: K, matcher: HookMatcher, hook: ModHook<ModEvents[K][\'input\'], ModEvents[K][\'result\']>): HookRegistration;\n    (event: string, hook: AnyHook): HookRegistration;\n    (event: string, matcher: HookMatcher, hook: AnyHook): HookRegistration;\n}',
+    },
+    {
+        name: 'ModRegister',
+        declaration: 'export type ModRegister = (on: ModOn, options: PluginOptions) => unknown;',
+    },
+    {
+        name: 'ModsApi',
+        declaration: 'export interface ModsApi {\n    readonly plugin: {\n        readonly name: string;\n        readonly root: string;\n    };\n    readonly ui: {\n        log(text: string, options?: UiLogOptions): void;\n        toast(text: string, options?: ToastOptions): void;\n        status(text: string | undefined): void;\n        invalidate(event: string): void;\n        open(pane: PaneOpenArgs): Promise<PaneOpenResult>;\n        close(pane: {\n            id: string;\n        }): Promise<void>;\n        panes(): Promise<never[]>;\n        ask(question: string, options?: readonly string[] | AskOptions): Promise<string>;\n        resolve(e: UiRenderInput): UiElements;\n    };\n    readonly command: {\n        register(command: CommandSpec): Promise<void>;\n        run(input: {\n            command: string;\n            args?: string;\n        }): Promise<CommandRunResult>;\n        list(): Promise<CommandInfo[]>;\n    };\n    readonly tool: {\n        register(tool: ToolSpec): Promise<void>;\n        call(input: {\n            tool: string;\n            [argument: string]: unknown;\n        }): Promise<ToolCallResult>;\n        list(): Promise<ToolInfo[]>;\n    };\n    readonly prompt: {\n        submit(input: PromptSubmitArgs): Promise<{\n            text: string;\n        }>;\n    };\n    readonly session: {\n        id(): Promise<string>;\n        cwd(): Promise<string>;\n        root(): Promise<string>;\n        model(): Promise<string>;\n        turns(): Promise<number>;\n        messages(): Promise<SessionMessage[]>;\n        us /* …truncated — full shape in source */',
+    },
+    {
+        name: 'ModTier',
+        declaration: 'export type ModTier = \'prepend\' | \'user\' | \'append\' | \'builtin\' | \'core\';',
+    },
     {
         name: 'NativeFileApplication',
         declaration: 'export interface NativeFileApplication {\n    readonly id: string;\n    readonly name: string;\n    readonly default: boolean;\n    readonly icon: string | null;\n}',
@@ -5805,6 +5934,14 @@ export const TYPE_API = [
         name: 'PackageResult',
         declaration: 'export interface PackageResult {\n    exitCode: number;\n    output: string;\n    truncated: boolean;\n    logPath: string;\n    kind?: PluginInstallFailureKind;\n    timedOut?: boolean;\n    incompatible?: IncompatiblePlugin[];\n}',
     },
+    {
+        name: 'PaneOpenArgs',
+        declaration: 'export interface PaneOpenArgs {\n    id: string;\n    title?: string;\n    focus?: true;\n    closeOnEscape?: true;\n    holdToasts?: true;\n    rows?: number;\n    columns?: number;\n}',
+    },
+    {
+        name: 'PaneOpenResult',
+        declaration: 'export interface PaneOpenResult {\n    id: string;\n    isPlaced: boolean;\n    reason?: string;\n}',
+    },
     {
         name: 'PeerAdmission',
         declaration: 'export type PeerAdmission = {\n    readonly peer: PeerScope;\n} | {\n    readonly rejection: 401 | 403;\n};',
@@ -5873,6 +6010,14 @@ export const TYPE_API = [
         name: 'PluginLocalizedMeta',
         declaration: 'export interface PluginLocalizedMeta {\n    readonly title?: LocalizedText;\n    readonly description?: LocalizedText;\n    readonly icon?: string;\n    readonly error?: string;\n}',
     },
+    {
+        name: 'PluginOptions',
+        declaration: 'export type PluginOptions = Readonly<Record<string, PluginOptionValue>>;',
+    },
+    {
+        name: 'PluginOptionValue',
+        declaration: 'export type PluginOptionValue = string | number | boolean | readonly string[];',
+    },
     {
         name: 'PluginRegistries',
         declaration: 'export interface PluginRegistries {\n    readonly registry: Registry;\n    readonly fallbackRegistries: readonly string[];\n    readonly resolved: string | null;\n}',
@@ -5981,6 +6126,10 @@ export const TYPE_API = [
         name: 'PromptFileBinding',
         declaration: 'export interface PromptFileBinding extends Disposable {\n    commit(): void;\n}',
     },
+    {
+        name: 'PromptOrigin',
+        declaration: 'export type PromptOrigin = {\n    kind: \'composer\';\n} | {\n    kind: \'plugin\';\n    name: string;\n};',
+    },
     {
         name: 'PromptSection',
         declaration: 'export interface PromptSection {\n    readonly name: string;\n    readonly order: number;\n    readonly text: string | ((context: AssembleContext) => string);\n    readonly interpolate?: boolean;\n    readonly complete?: boolean;\n}',
@@ -5989,6 +6138,18 @@ export const TYPE_API = [
         name: 'PromptSectionOrderName',
         declaration: 'export type PromptSectionOrderName = keyof typeof SECTION_ORDERS;',
     },
+    {
+        name: 'PromptSubmitArgs',
+        declaration: 'export interface PromptSubmitArgs {\n    text: string;\n    asUser?: boolean;\n}',
+    },
+    {
+        name: 'PromptSubmitInput',
+        declaration: 'export interface PromptSubmitInput {\n    text: string;\n    context?: readonly string[];\n    turnId?: string;\n    wait: boolean;\n    origin: PromptOrigin;\n}',
+    },
+    {
+        name: 'PromptSubmitResult',
+        declaration: 'export type PromptSubmitResult = {\n    text: string;\n    context?: readonly string[];\n    drop?: undefined;\n} | {\n    drop: string;\n    text?: undefined;\n    context?: undefined;\n};',
+    },
     {
         name: 'ProviderRequestId',
         declaration: 'export type ProviderRequestId = Branded<\'ProviderRequestId\'>;',
@@ -6079,7 +6240,7 @@ export const TYPE_API = [
     },
     {
         name: 'Reload',
-        declaration: 'export interface Reload {\n    filename: string;\n    runtime?: Plugin.Runtime | undefined;\n}',
+        declaration: 'export interface Reload {\n    filename: string;\n    modules: ReloadModules;\n    runtime?: Plugin.Runtime | undefined;\n}',
     },
     {
         name: 'RemoteError',
@@ -6267,7 +6428,7 @@ export const TYPE_API = [
     },
     {
         name: 'ScheduleToolError',
-        declaration: 'export type ScheduleToolError = InvalidPromptError | InvalidSelectorError | InvalidRuleError | InvalidTimeZoneError | NotFutureError | TimeOutOfRangeError | FrequencyTooHighError | InternalScheduleError;',
+        declaration: 'export type ScheduleToolError = InvalidPromptError | InvalidSelectorError | InvalidRuleError | InvalidTimeZoneError | NotFutureError | TimeOutOfRangeError | FrequencyTooHighError | SubagentSessionError | InternalScheduleError;',
     },
     {
         name: 'ScheduleUpdateContent',
@@ -6321,6 +6482,14 @@ export const TYPE_API = [
         name: 'SendTeamMessageResult',
         declaration: 'export interface SendTeamMessageResult {\n    readonly messageId: TeamMessageId;\n    readonly status: \'accepted\' | \'queued\';\n}',
     },
+    {
+        name: 'SerializedElement',
+        declaration: 'export interface SerializedElement {\n    readonly type: \'Box\' | \'Text\' | \'Button\';\n    readonly props: Readonly<Record<string, string | number | boolean>>;\n    readonly children: readonly SerializedNode[];\n    readonly actionId?: string;\n}',
+    },
+    {
+        name: 'SerializedNode',
+        declaration: 'export type SerializedNode = SerializedElement | string;',
+    },
     {
         name: 'ServerResponse',
         declaration: 'export interface ServerResponse {\n    readonly type: \'server-response\';\n    readonly rpcId: RpcId;\n    readonly result: ConnectionRpcResult<unknown>;\n}',
@@ -6405,6 +6574,14 @@ export const TYPE_API = [
         name: 'SessionCreateValue',
         declaration: 'export interface SessionCreateValue {\n    readonly sessionId: SessionId;\n    readonly agentPreset?: string;\n}',
     },
+    {
+        name: 'SessionEndInput',
+        declaration: 'export interface SessionEndInput {\n    reason: \'clear\' | \'logout\' | \'prompt_input_exit\' | \'resume\' | \'other\';\n    sessionId: string;\n}',
+    },
+    {
+        name: 'SessionEndResult',
+        declaration: 'export interface SessionEndResult {\n    sessionId: string;\n}',
+    },
     {
         name: 'SessionEvent',
         declaration: 'export type SessionEvent<T extends SessionEventType = SessionEventType> = {\n    [K in SessionEventType]: {\n        type: K;\n        seq: SessionSeq;\n        time: number;\n        data: SessionEventMap[K];\n        ignorable?: true;\n    } & (K extends SurfaceEventType ? SurfaceIntent<K> : {\n        surfaceOp?: never;\n        sourceEventSeqs?: never;\n    });\n}[T];',
@@ -6581,6 +6758,10 @@ export const TYPE_API = [
         name: 'SessionLogSnapshot',
         declaration: 'export interface SessionLogSnapshot {\n    session: SessionHeader;\n    inheritedEventCount: SessionLogOffset;\n    events: SessionEvent[];\n}',
     },
+    {
+        name: 'SessionMessage',
+        declaration: 'export interface SessionMessage {\n    role: \'user\' | \'assistant\';\n    text: string;\n    toolUses: ToolUseSummary[];\n}',
+    },
     {
         name: 'SessionMessageProjection',
         declaration: 'export interface SessionMessageProjection<T extends SessionEventType = SessionEventType> {\n    type: T;\n    project(event: SessionEvent<T>, context: SessionMessageProjectionContext): ReadonlyMap<SessionSeq, Message>;\n}',
@@ -6761,6 +6942,14 @@ export const TYPE_API = [
         name: 'SessionSeqCursor',
         declaration: 'export type SessionSeqCursor = SessionSeq | -1;',
     },
+    {
+        name: 'SessionStartInput',
+        declaration: 'export interface SessionStartInput {\n    cwd: string;\n    surface: string | null;\n    isInteractive: boolean;\n}',
+    },
+    {
+        name: 'SessionStartResult',
+        declaration: 'export interface SessionStartResult {\n    cwd: string;\n}',
+    },
     {
         name: 'SessionStartSource',
         declaration: 'export type SessionStartSource = \'startup\' | \'resume\' | \'clear\' | \'compact\';',
@@ -6943,7 +7132,7 @@ export const TYPE_API = [
     },
     {
         name: 'SignInErrorCode',
-        declaration: 'export type SignInErrorCode = \'network\' | \'protocol\' | \'expired\' | \'storage\';',
+        declaration: 'export type SignInErrorCode = \'no-response\' | \'network\' | \'protocol\' | \'expired\' | \'storage\';',
     },
     {
         name: 'SkillCandidate',
@@ -7201,6 +7390,10 @@ export const TYPE_API = [
         name: 'SubagentSendMessageOptions',
         declaration: 'export interface SubagentSendMessageOptions {\n    readonly signal: AbortSignal;\n}',
     },
+    {
+        name: 'SubagentSessionError',
+        declaration: 'export interface SubagentSessionError {\n    readonly code: \'subagent_session\';\n    readonly message: string;\n}',
+    },
     {
         name: 'SubagentStartRequest',
         declaration: 'export interface SubagentStartRequest {\n    readonly label?: string;\n    readonly prompt: ContentBlock[];\n    readonly parent: Agent;\n    readonly signal: AbortSignal;\n    readonly agentOptions?: AgentOptions;\n    readonly outputSchema?: ObjectJsonSchema;\n    readonly maxDepth?: number;\n    readonly toolFilter?: ToolRestriction;\n    readonly persona?: string;\n}',
@@ -7293,6 +7486,10 @@ export const TYPE_API = [
         name: 'SurfaceOp',
         declaration: 'export type SurfaceOp = \'append\' | {\n    op: \'replace\';\n    startSeq: SessionSeq;\n    endSeq: SessionSeq;\n};',
     },
+    {
+        name: 'SurfaceSnapshot',
+        declaration: 'export interface SurfaceSnapshot {\n    readonly generation: number;\n    readonly tree: readonly SerializedNode[] | null;\n}',
+    },
     {
         name: 'SystemMessage',
         declaration: 'export interface SystemMessage extends MessageBase {\n    readonly role: \'system\';\n    readonly source: MessageSourceMap[\'system-prompt\'];\n}',
@@ -7457,10 +7654,22 @@ export const TYPE_API = [
         name: 'TerminalWaitReason',
         declaration: 'export type TerminalWaitReason = \'stdin_read\' | \'inferred_idle\' | \'timeout\' | \'session_exit\';',
     },
+    {
+        name: 'TextProps',
+        declaration: 'export interface TextProps {\n    readonly color?: string | undefined;\n    readonly bold?: boolean | undefined;\n    readonly dimColor?: boolean | undefined;\n    readonly italic?: boolean | undefined;\n    readonly underline?: boolean | undefined;\n    readonly children?: UiNode | undefined;\n}',
+    },
+    {
+        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}',
     },
+    {
+        name: 'ToastOptions',
+        declaration: 'export interface ToastOptions {\n    timeoutMs?: number;\n}',
+    },
     {
         name: 'TokenMeasurement',
         declaration: 'export interface TokenMeasurement {\n    readonly logRevision: SessionLogOffset;\n    readonly baseline: TokenMeasurementBaseline;\n    readonly surfaceDeltaTokens: number;\n    readonly totalTokens: number;\n    readonly surfaceTokens: number;\n    readonly nodes: readonly TokenSurfaceNode[];\n}',
@@ -7489,10 +7698,18 @@ export const TYPE_API = [
         name: 'ToolCallId',
         declaration: 'export type ToolCallId = Branded<\'ToolCallId\'>;',
     },
+    {
+        name: 'ToolCallInput',
+        declaration: 'export interface ToolCallInput {\n    tool: string;\n    tool_use_id: string;\n    agentId?: string;\n    [argument: string]: unknown;\n}',
+    },
     {
         name: 'ToolCallKind',
         declaration: 'export type ToolCallKind = \'read\' | \'edit\' | \'delete\' | \'move\' | \'search\' | \'execute\' | \'fetch\' | \'other\';',
     },
+    {
+        name: 'ToolCallResult',
+        declaration: 'export type ToolCallResult = {\n    deny: string;\n    result?: undefined;\n    isError?: undefined;\n} | {\n    result: unknown;\n    isError?: true;\n    deny?: undefined;\n};',
+    },
     {
         name: 'ToolCallView',
         declaration: 'export type ToolCallView = GenericCallView | TerminalCallView | DiffCallView;',
@@ -7549,6 +7766,10 @@ export const TYPE_API = [
         name: 'ToolHistory',
         declaration: 'export interface ToolHistory {\n    readonly tools: readonly ToolSchema[];\n    readonly updates: readonly {\n        readonly messageId: MessageId;\n        readonly additions: readonly ToolSchema[];\n    }[];\n}',
     },
+    {
+        name: 'ToolInfo',
+        declaration: 'export interface ToolInfo {\n    name: string;\n    description: string;\n}',
+    },
     {
         name: 'ToolMessageSource',
         declaration: 'export interface ToolMessageSource {\n    kind: \'tool\';\n    callId: ToolCallId;\n}',
@@ -7601,10 +7822,18 @@ export const TYPE_API = [
         name: 'ToolSchema',
         declaration: 'export interface ToolSchema {\n    deferLoading?: true;\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n}',
     },
+    {
+        name: 'ToolSpec',
+        declaration: 'export interface ToolSpec {\n    name: string;\n    description: string;\n    inputSchema?: Record<string, unknown>;\n}',
+    },
     {
         name: 'ToolUpdate',
         declaration: 'export type ToolUpdate = \'in-history\' | \'addition-only\';',
     },
+    {
+        name: 'ToolUseSummary',
+        declaration: 'export interface ToolUseSummary {\n    tool_use_id: string;\n    tool: string;\n    input: Record<string, unknown>;\n}',
+    },
     {
         name: 'Transcript',
         declaration: 'export interface Transcript {\n    readonly text: string;\n    readonly audioSeconds: number;\n    readonly inferenceSeconds: number;\n}',
@@ -7613,6 +7842,14 @@ export const TYPE_API = [
         name: 'TranscriptionRequest',
         declaration: 'export interface TranscriptionRequest {\n    readonly audioBase64: string;\n    readonly providerId?: SpeechProviderId;\n    readonly language?: string;\n}',
     },
+    {
+        name: 'TurnCompleteInput',
+        declaration: 'export interface TurnCompleteInput {\n    turnId: string;\n    answer: string;\n    durationMs: number;\n    isAborted: boolean;\n    reason: \'answer\' | \'aborted\' | \'error\';\n    agentId?: string;\n    usage?: TurnUsage;\n}',
+    },
+    {
+        name: 'TurnCompleteResult',
+        declaration: 'export interface TurnCompleteResult {\n    text: string;\n}',
+    },
     {
         name: 'TurnEndCancelCause',
         declaration: 'export type TurnEndCancelCause = AgentCancelCause | {\n    readonly kind: \'legacy\';\n};',
@@ -7625,6 +7862,18 @@ export const TYPE_API = [
         name: 'TurnEndReasonMap',
         declaration: 'export interface TurnEndReasonMap {\n    completed: {\n        kind: \'completed\';\n    };\n    aborted: {\n        kind: \'aborted\';\n        reason: TurnEndCancelCause;\n    };\n    blocked: {\n        kind: \'blocked\';\n    };\n    error: {\n        kind: \'error\';\n        error: LlmFailure;\n    };\n    \'max-tokens\': {\n        kind: \'max-tokens\';\n    };\n    interrupted: {\n        kind: \'interrupted\';\n    };\n    forked: {\n        kind: \'forked\';\n    };\n}',
     },
+    {
+        name: 'TurnStartInput',
+        declaration: 'export interface TurnStartInput {\n    text: string;\n    turnId: string;\n    agentId?: string;\n}',
+    },
+    {
+        name: 'TurnStartResult',
+        declaration: 'export interface TurnStartResult {\n    turnId: string;\n}',
+    },
+    {
+        name: 'TurnUsage',
+        declaration: 'export interface TurnUsage {\n    input_tokens: number;\n    output_tokens: number;\n    cache_read_input_tokens: number;\n    cache_creation_input_tokens: number;\n    model: string;\n}',
+    },
     {
         name: 'TypertCodec',
         declaration: 'export type TypertCodec = {\n    readonly mode: \'strict\';\n    readonly typeSymbol: string;\n    readonly create: () => TypertSchema;\n    readonly decode?: (value: unknown) => unknown;\n    readonly encode?: (value: unknown, writeBytes: (bytes: Uint8Array, path: readonly (string | number)[]) => null) => unknown;\n} | {\n    readonly mode: \'src-json\';\n};',
@@ -7729,6 +7978,30 @@ export const TYPE_API = [
         name: 'TypertTypeModel',
         declaration: 'export interface TypertTypeModel {\n    readonly name: string;\n    readonly declaration: string;\n}',
     },
+    {
+        name: 'UiElement',
+        declaration: 'export interface UiElement {\n    readonly type: \'Box\' | \'Text\' | \'Button\';\n    readonly props: Readonly<Record<string, unknown>>;\n}',
+    },
+    {
+        name: 'UiElements',
+        declaration: 'export interface UiElements {\n    readonly Box: (props: BoxProps) => UiElement;\n    readonly Text: (props: TextProps) => UiElement;\n    readonly Button: (props: ButtonProps) => UiElement;\n}',
+    },
+    {
+        name: 'UiLogOptions',
+        declaration: 'export interface UiLogOptions {\n    to?: \'transcript\' | \'debug\';\n}',
+    },
+    {
+        name: 'UiNode',
+        declaration: 'export type UiNode = UiElement | string | number | null | undefined | false | readonly UiNode[];',
+    },
+    {
+        name: 'UiRenderInput',
+        declaration: 'export interface UiRenderInput {\n    component: \'AbovePrompt\' | \'Pane\';\n    surface: string;\n    requestId?: string;\n    props: Readonly<Record<string, unknown>>;\n    viewport: {\n        readonly columns: number;\n        readonly rows?: number;\n    };\n}',
+    },
+    {
+        name: 'UiRenderResult',
+        declaration: 'export type UiRenderResult = UiNode;',
+    },
     {
         name: 'UpdateTeamTaskRequest',
         declaration: 'export interface UpdateTeamTaskRequest {\n    readonly taskId: TeamTaskId;\n    readonly expectedRevision: number;\n    readonly action: TeamTaskAction;\n    readonly subject?: string;\n    readonly description?: string;\n    readonly blockedBy?: readonly TeamTaskId[];\n    readonly writeScopes?: readonly string[];\n    readonly owner?: 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.1-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -32,22 +32,22 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@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/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/cordis-plugin-group": "~1.0.4",
-    "@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/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/cordis-plugin-group": "~1.0.5-alpha.1",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
   }
 }