@deepseek-ai/dsh-client-connection 0.0.1-rc.1 → 0.0.1-rc.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/connection/README.md
-README.md: 85ff46052ba2f032ee6a95b16c396d45e766d3ba
-README.zh.md: 89cbb19a984d88e09b7af0890f57ecd15d46d3a5
+README.md: a82bb55ab65df2732ad16248d2cc9aa15b60e94d
+README.zh.md: d4c19db8e74e3562ec55b5ef60675aef79b82008

package/README.md

@@ -2,7 +2,7 @@
 
 English | [中文](README.zh.md)
 
-Wire consumer layer: the client plugin's apply mounts `ctx.connection` (shared api client + current-page loopback state + single-consumer stream-loop starter); the export face carries the wire contract types, the `AbstractApiClient` abstraction, and the loop's sink/config types. The browser carrier uses HTTP POST for unary and respond operations and opens one downlink-only WebSocket each for `events.mux` and `events.host`; the in-process carrier satisfies the same two-stream abstraction. The Host half owns the single `/api` route and its Fetch bridge; a registered TypeRT interceptor claims its Remote endpoints before the API Proxy fallback. Loopback hostname classification stays package-internal: the `/api` Host fence and WebSocket upgrades use it directly, while other client plugins consume the derived `ctx.connection.isLoopback` state. The node half's `/api` route pins the privileged method set (`host.pickDirectory`, `host.openPath`, and the whole configuration plane — `settings.describe`/`openDocument`/`update`/`replace`/`mutate` and `credentials.describe`/`set`/`unset`; reads and native actions included, since describing returns the exposed configuration, opening acts on the Host desktop, and probing an arbitrary reference reports where a credential comes from — and the agent-preset authoring plane, `agentPreset.read`/`copy`/`openDocument`/`remove`, since a composition names the plugins a session runs, so reading one is reconnaissance, and copy/remove/openDocument manage the roster and drive the host desktop (authoring is copy-only, so none of them accepts composition text or a path); `agentPreset.list` and `agentPreset.select` stay out — the roster carries only ids and trust, and choosing a preset grants nothing `session.create`'s own `agentPreset` did not, over a default that already carries bash) to loopback by passing the trust fence with an empty trust list — a declared `trustedHosts` authority reaches every other method, while these stay loopback-local until a real authentication layer exists. The platform carriers and ConnectionController loop are package-internal; apply selects and drives them. The downlink boundary is documented in the [WebSocket downlink carrier Agent Note](../../../.agents/notes/implemented/architecture/2026-08-04-websocket-downlink-carrier.md).
+Wire consumer layer: the client plugin's apply mounts `ctx.connection` (shared api client + current-page loopback state + observable generation-scoped `hostDescription` + single-consumer stream-loop starter); the export face carries the wire contract types, the `AbstractApiClient` abstraction, and the loop's sink/config types. Each successful readiness handshake publishes the exact `host.describe` value before `onConnected`; generation loss and explicit stop clear it, so native-capability consumers never retain a disconnected answer. The browser carrier uses HTTP POST for unary and respond operations and opens one downlink-only WebSocket each for `events.mux` and `events.host`; the in-process carrier satisfies the same two-stream abstraction. The Host half owns the single `/api` route and its Fetch bridge; a registered TypeRT interceptor claims its Remote endpoints before the API Proxy fallback. Loopback hostname classification stays package-internal: the `/api` Host fence and WebSocket upgrades use it directly, while other client plugins consume the derived `ctx.connection.isLoopback` state. The node half's `/api` route pins the privileged method set (`host.pickDirectory`, `host.openPath`, and the whole configuration plane — `settings.describe`/`openDocument`/`update`/`replace`/`mutate` and `credentials.describe`/`set`/`unset`; reads and native actions included, since describing returns the exposed configuration, opening acts on the Host desktop, and probing an arbitrary reference reports where a credential comes from — and the agent-preset authoring plane, `agentPreset.read`/`copy`/`openDocument`/`remove`, since a composition names the plugins a session runs, so reading one is reconnaissance, and copy/remove/openDocument manage the roster and drive the host desktop (authoring is copy-only, so none of them accepts composition text or a path); `agentPreset.list` and `agentPreset.select` stay out — the roster carries only ids and trust, and choosing a preset grants nothing `session.create`'s own `agentPreset` did not, over a default that already carries bash) to loopback by passing the trust fence with an empty trust list — a declared `trustedHosts` authority reaches every other method, while these stay loopback-local until a real authentication layer exists. The platform carriers and ConnectionController loop are package-internal; apply selects and drives them. The downlink boundary is documented in the [WebSocket downlink carrier Agent Note](../../../.agents/notes/implemented/architecture/2026-08-04-websocket-downlink-carrier.md).
 
 ## /api browser-trust fence
 

package/README.zh.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 中文
 
-协议消费层：客户端插件的 apply 会挂载 `ctx.connection`（共享 API 客户端 + 当前页面的 loopback 状态 + 单消费方流循环启动器）；导出表层携带协议约定类型、`AbstractApiClient` 抽象，以及循环的 sink／配置类型。浏览器载体以 HTTP POST 发送 unary／respond，并为 `events.mux` 与 `events.host` 各开一条只下行的 WebSocket；进程内载体满足同一双流抽象。Host half 持有唯一 `/api` route 及其 Fetch bridge；已注册的 TypeRT interceptor 会先认领自己的 Remote endpoint，未认领请求再回退 API Proxy。Loopback hostname 判定逻辑留在包内部：`/api` Host fence 与 WebSocket upgrade 会直接使用它，其他客户端插件则消费派生的 `ctx.connection.isLoopback` 状态。node 半侧的 `/api` 路由让特权方法集（`host.pickDirectory`、`host.openPath`，以及整个配置面——`settings.describe`/`openDocument`/`update`/`replace`/`mutate` 与 `credentials.describe`/`set`/`unset`；读取与原生操作也在内，因为 describe 会返回已暴露的配置、打开操作会作用于 Host 桌面，而探测任意引用会报出某条凭据来自何处——以及 agent preset 的创作面 `agentPreset.read`/`copy`/`openDocument`/`remove`，因为组装指明了一个会话所运行的插件，读取它是侦察，而 copy/remove/openDocument 管理名单并驱动宿主桌面（创作只有复制一种写入，因此这些方法都不接收组装文本或路径）；`agentPreset.list` 与 `agentPreset.select` 不在其中——名单只携带 id 与信任级别，而选择一个 preset 并不比 `session.create` 自带的 `agentPreset` 多给任何能力，何况默认 preset 本就带着 bash）以空信任表过信任 fence，从而钉在回环——已声明的 `trustedHosts` 授权可达其余全部方法，而这些方法在真正的认证层出现之前仍只限回环本机。平台载体与 ConnectionController 循环属于包内部；apply 负责选择并驱动它们。下行边界见 [WebSocket 下行载体 Agent Note](../../../.agents/notes/implemented/architecture/2026-08-04-websocket-downlink-carrier.md)。
+协议消费层：客户端插件的 apply 会挂载 `ctx.connection`（共享 API 客户端 + 当前页面的 loopback 状态 + 可观察且按 generation 生效的 `hostDescription` + 单消费方流循环启动器）；导出表层携带协议约定类型、`AbstractApiClient` 抽象，以及循环的 sink／配置类型。每次就绪握手成功后，都会在 `onConnected` 之前发布完整的 `host.describe` 值；generation 失效或显式 stop 会清空它，因此原生能力消费者不会保留已经断线的判断。浏览器载体以 HTTP POST 发送 unary／respond，并为 `events.mux` 与 `events.host` 各开一条只下行的 WebSocket；进程内载体满足同一双流抽象。Host half 持有唯一 `/api` route 及其 Fetch bridge；已注册的 TypeRT interceptor 会先认领自己的 Remote endpoint，未认领请求再回退 API Proxy。Loopback hostname 判定逻辑留在包内部：`/api` Host fence 与 WebSocket upgrade 会直接使用它，其他客户端插件则消费派生的 `ctx.connection.isLoopback` 状态。node 半侧的 `/api` 路由让特权方法集（`host.pickDirectory`、`host.openPath`，以及整个配置面——`settings.describe`/`openDocument`/`update`/`replace`/`mutate` 与 `credentials.describe`/`set`/`unset`；读取与原生操作也在内，因为 describe 会返回已暴露的配置、打开操作会作用于 Host 桌面，而探测任意引用会报出某条凭据来自何处——以及 agent preset 的创作面 `agentPreset.read`/`copy`/`openDocument`/`remove`，因为组装指明了一个会话所运行的插件，读取它是侦察，而 copy/remove/openDocument 管理名单并驱动宿主桌面（创作只有复制一种写入，因此这些方法都不接收组装文本或路径）；`agentPreset.list` 与 `agentPreset.select` 不在其中——名单只携带 id 与信任级别，而选择一个 preset 并不比 `session.create` 自带的 `agentPreset` 多给任何能力，何况默认 preset 本就带着 bash）以空信任表过信任 fence，从而钉在回环——已声明的 `trustedHosts` 授权可达其余全部方法，而这些方法在真正的认证层出现之前仍只限回环本机。平台载体与 ConnectionController 循环属于包内部；apply 负责选择并驱动它们。下行边界见 [WebSocket 下行载体 Agent Note](../../../.agents/notes/implemented/architecture/2026-08-04-websocket-downlink-carrier.md)。
 
 ## /api 浏览器信任栅栏
 

package/lib/client.js

@@ -67,6 +67,10 @@ window.__ModuleLoader__.load({
 			isRunning() {
 				return this.running;
 			}
+			/** Re-read both mutable liveness guards after a potentially reentrant sink. */
+			isGenerationActive(controller) {
+				return this.isRunning() && !controller.signal.aborted;
+			}
 			async loop() {
 				while (this.running) {
 					const gen = ++this.generation;
@@ -99,7 +103,9 @@ window.__ModuleLoader__.load({
 						if (ac.signal.aborted) throw new Error("generation aborted during readiness handshake");
 						this.attempt = 0;
 						this.emitState("connected");
-						this.callSink(this.sinks.onConnected);
+						if (this.isGenerationActive(ac)) this.callSink(() => {
+							this.sinks.onConnected?.(descriptionResult.value);
+						});
 					} catch {
 						if (!ac.signal.aborted) ac.abort();
 					}
@@ -131,7 +137,6 @@ window.__ModuleLoader__.load({
 			}
 			/** Sink exception isolation: a business-layer throw is logged only, never affecting pump or reconnect semantics. */
 			callSink(fn) {
-				if (fn === void 0) return;
 				try {
 					fn();
 				} catch (error) {
@@ -492,7 +497,7 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* Fold a transport exception into the RpcResult error branch (unified error
-		* surface; 'internal' as the catch-all code). Lives with RpcResult so every
+		* API; 'internal' as the catch-all code). Lives with RpcResult so every
 		* carrier consumer folds the same way.
 		* @param error - the thrown value from the carrier.
 		* @returns the error branch of an RpcResult.
@@ -4880,6 +4885,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					existingCwd: string().optional()
 				})
 			}),
+			object({
+				code: literal("invalid-time-zone"),
+				message: string(),
+				details: object({ value: string() })
+			}),
 			object({
 				code: literal("workspace-attach-failed"),
 				message: string(),
@@ -5164,7 +5174,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		/**
 		* sessions domain zod schemas (names derived from map keys: sessionListRequestSchema /
 		* sessionListValueSchema). SessionEvent passthrough = strict envelope (type/seq/time) + wide
-		* data: the merge-extensible event surface keeps an unknown-type branch at the union level,
+		* data: the merge-extensible event API keeps an unknown-type branch at the union level,
 		* with no field-level passthrough. SessionId brand cast point: sessionIdSchema, and only there.
 		*/
 		/** SessionId: one brand cast after schema validation (the only cast point in this domain). */
@@ -5185,7 +5195,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			time: number(),
 			data: unknown(),
 			sourceEventSeqs: array(number()).optional(),
-			surfaceOp: unknown().optional()
+			surfaceOp: unknown().optional(),
+			ignorable: literal(true).optional()
 		});
 		/** SessionSummary row of session.list (`projections` reuses the history block's shape and schema). */
 		const sessionSummarySchema = object({
@@ -5347,7 +5358,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		object({
 			sessionId: sessionIdSchema,
 			mode: union([literal("queue"), literal("steer")]),
-			content: array(promptContentPartSchema)
+			content: array(promptContentPartSchema),
+			clientTimeZone: string().optional()
 		});
 		/** session.prompt response value (the command slot appears only when the prompt dispatched a slash command). */
 		const sessionPromptValueSchema = object({
@@ -5408,6 +5420,26 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			approvalId: approvalRequestIdSchema,
 			outcome: union([literal("allowed-once"), literal("rejected")])
 		});
+		/**
+		* One wire task view. `kind` stays an open string because producer plugins
+		* extend the registry's kind map by declaration merging, so the closed set is
+		* not knowable at this boundary.
+		*/
+		const taskViewSchema = object({
+			id: string().min(1),
+			kind: string().min(1),
+			label: string().min(1),
+			status: union([
+				literal("running"),
+				literal("stopping"),
+				literal("completed"),
+				literal("killed"),
+				literal("failed")
+			]),
+			detail: string().optional(),
+			startedAt: number().int().nonnegative(),
+			finishedAt: number().int().nonnegative().optional()
+		});
 		//#endregion
 		//#region ../../host/apiproxy/src/api/workspace.schema.ts
 		/**
@@ -5545,6 +5577,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					message: messageSchema
 				}))
 			}),
+			object({
+				type: literal("session/tasks"),
+				sessionId: sessionIdSchema,
+				tasks: array(taskViewSchema)
+			}),
 			object({
 				type: literal("session/projection"),
 				sessionId: sessionIdSchema,
@@ -5594,21 +5631,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				type: literal("host/archived-sessions-changed"),
 				archivedSessionIds: array(sessionIdSchema)
 			}),
-			object({ type: literal("host/commands-changed") }),
-			object({
-				type: literal("host/session-preset-changed"),
-				sessionId: sessionIdSchema,
-				agentPreset: string()
-			}),
-			object({
-				type: literal("host/settings-changed"),
-				ns: string()
-			}),
 			object({
-				type: literal("host/credentials-changed"),
-				ref: string()
+				type: literal("host/remote-event"),
+				event: string().min(1),
+				args: array(unknown())
 			}),
-			object({ type: literal("host/models-changed") }),
 			object({
 				type: literal("stream/error"),
 				error: rpcErrorSchema
@@ -5621,7 +5648,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			cwd: string(),
 			provider: string().optional(),
 			model: string().optional(),
-			attachedSessions: number().int().nonnegative()
+			attachedSessions: number().int().nonnegative(),
+			canOpenPath: boolean()
 		});
 		object({});
 		/** host.pickDirectory response value; null means the user cancelled. */
@@ -5983,7 +6011,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			parentSessionId: sessionIdSchema,
 			childSessionId: sessionIdSchema,
 			mode: literal("continuable"),
-			content: array(contentBlockSchema)
+			content: array(contentBlockSchema),
+			clientTimeZone: string().optional()
 		});
 		object({
 			parentSessionId: sessionIdSchema,
@@ -6354,7 +6383,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"- first item",
 			"  - nested item",
 			"",
-			"| Surface | State |",
+			"| Area | State |",
 			"| --- | --- |",
 			"| history | rendered |",
 			"| streaming | stable |",
@@ -8936,7 +8965,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						describe: (request) => ok(request, {
 							version: "0.0.0-fixture",
 							cwd: "/tmp/fixture",
-							attachedSessions
+							attachedSessions,
+							canOpenPath: true
 						}),
 						pickDirectory: (request) => ok(request, { path: `${FIXTURE_HOME}/Documents/project` }),
 						listDirectory: (request) => {
@@ -9594,7 +9624,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 							outcome: message.result.ok ? "answered" : "cancelled"
 						});
 						return Promise.resolve({ accepted: true });
-					}
+					},
+					downloads: { sessionLog: () => Promise.resolve(new Response("fixture mode does not serve session export", { status: 404 })) }
 				},
 				rpc: { call(channel, endpoint, payload) {
 					if (channel !== "/api") return Promise.reject(/* @__PURE__ */ new Error(`fixture connection RPC channel ${JSON.stringify(channel)} is unavailable`));
@@ -9916,17 +9947,49 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const api = fixtureClient ?? new WebApiClient();
 			const rpc = fixtureClient?.rpc ?? createWebConnectionRpc();
 			let started = false;
+			let description;
+			const descriptionListeners = /* @__PURE__ */ new Set();
+			const publishDescription = (next) => {
+				if (Object.is(description, next)) return;
+				description = next;
+				for (const listener of [...descriptionListeners]) try {
+					listener();
+				} catch (error) {
+					console.error("[web-runtime] host-description listener threw:", error);
+				}
+			};
 			const handle = {
 				api,
 				isLoopback: pageLocation === void 0 || isLoopbackHostname(pageLocation.hostname),
+				hostDescription: {
+					getSnapshot: () => description,
+					subscribe: (listener) => {
+						descriptionListeners.add(listener);
+						return () => {
+							descriptionListeners.delete(listener);
+						};
+					}
+				},
 				rpc,
 				start(sinks, config) {
 					if (started) throw new Error("connection: the stream loop is already owned by another consumer");
 					started = true;
-					const controller = new ConnectionController(api, sinks, config ?? {});
+					const controller = new ConnectionController(api, {
+						...sinks,
+						onConnected: (next) => {
+							publishDescription(next);
+							if (!Object.is(description, next)) return;
+							sinks.onConnected?.(next);
+						},
+						onStateChange: (state) => {
+							if (state === "reconnecting") publishDescription(void 0);
+							sinks.onStateChange?.(state);
+						}
+					}, config ?? {});
 					controller.start();
 					return { stop: () => {
 						controller.stop();
+						publishDescription(void 0);
 					} };
 				}
 			};

package/lib/types/client/api.d.ts

@@ -1,4 +1,4 @@
-export type { ApiProxy, SessionsApi, SessionSearchItem, SessionSummary, PromptContentPart, HostApi, EventsApi, MuxFrame, HostFrame, ApprovalResponsePayload, QuestionResponsePayload, HistoryEntry, ToolEventView, DirectoryEntry, DirectoryListing, ResponseValue, WorkspaceApi, WorkspaceId, WorkspaceView, CommandsApi, CommandDescriptor, SkillsApi, SkillEntry, ModelCatalogFailure, ModelCatalogModel, ModelProviderGroup, ModelReasoning, ModelReasoningEffort, ModelSelection, QueueAction, QueuedInboxItem, SessionModels, GoalsApi, GoalRef, SettingsApi, SettingsNamespaceView, SettingsPathOpView, SettingsSecretView, CredentialsApi, CredentialView, ConfigurableProviderView, DiscoveredModelView, LlmApi, SubagentsApi, SubagentAddress, SubagentCatalog, SubagentListEntry, SubagentPromptReceipt, } from '@deepseek-ai/dsh-host-apiproxy/api';
+export type { ApiProxy, SessionsApi, SessionSearchItem, SessionSummary, PromptContentPart, HostApi, EventsApi, MuxFrame, HostFrame, ApprovalResponsePayload, QuestionResponsePayload, HistoryEntry, ToolEventView, DirectoryEntry, DirectoryListing, ResponseValue, WorkspaceApi, WorkspaceId, WorkspaceView, CommandsApi, CommandDescriptor, SkillsApi, SkillEntry, ModelCatalogFailure, ModelCatalogModel, ModelProviderGroup, ModelReasoning, ModelReasoningEffort, ModelSelection, QueueAction, QueuedInboxItem, SessionModels, GoalsApi, GoalRef, SettingsApi, SettingsNamespaceView, SettingsPathOpView, SettingsSecretView, CredentialsApi, CredentialView, ConfigurableProviderView, DiscoveredModelView, LlmApi, SubagentsApi, SubagentAddress, SubagentCatalog, SubagentListEntry, SubagentPromptReceipt, TaskView, } from '@deepseek-ai/dsh-host-apiproxy/api';
 export type { ToolCallView, ToolResultView } from '@deepseek-ai/dsh-tools/presentation';
 export type { RpcRequest, RpcResponse, RpcResult, RpcError, RpcErrorCode, ClientRequest, ServerResponse, ServerRequest, ClientResponse, RpcMessage, RpcReceipt, } from '@deepseek-ai/dsh-host-apiproxy/api';
 export { RpcId, SESSION_SEARCH_RESULT_LIMIT, transportError, } from '@deepseek-ai/dsh-host-apiproxy/api';

package/lib/types/client/connection.d.ts

@@ -1,4 +1,4 @@
-import type { IApiClient, HostFrame, MuxFrame, RpcRequest } from './api.ts';
+import type { HostDescription, IApiClient, HostFrame, MuxFrame, RpcRequest } from './api.ts';
 /** Reconnect/backoff tunables (deployment-varying — no hardcoded tunables; these become the
  *  future `ctx.connection` plugin's Config). All fields optional; defaults below. */
 export interface ConnectionConfig {
@@ -23,7 +23,7 @@ export interface ConnectionSinks {
     onMuxEnvelope?: (envelope: RpcRequest<MuxFrame>) => void;
     onHostEnvelope?: (envelope: RpcRequest<HostFrame>) => void;
     /** After each connection generation is established (both streams open + describe succeeded), first connect included. */
-    onConnected?: () => void;
+    onConnected?: (description: HostDescription) => void;
     /** Coarse state transitions (deduplicated: fires only on change). The initial pre-connect
      *  span reports nothing — the UI treats "no state yet" as connecting, not as an outage. */
     onStateChange?: (state: ConnectionState) => void;
@@ -52,6 +52,8 @@ export declare class ConnectionController {
     private backoffDelay;
     /** Read through a method: stop() flips the flag across awaits, so narrowing from the loop condition must not stick. */
     private isRunning;
+    /** Re-read both mutable liveness guards after a potentially reentrant sink. */
+    private isGenerationActive;
     private loop;
     /** Deduplicated state emission (sink isolation applies). */
     private emitState;

package/lib/types/client/index.d.ts

@@ -4,17 +4,24 @@
  * controller with its sinks.
  */
 import type { Context } from '@deepseek-ai/cordis';
-import type { IApiClient } from './api.ts';
+import type { HostDescription, IApiClient } from './api.ts';
 import { type ConnectionConfig, type ConnectionSinks, type ConnectionState } from './connection.ts';
 import type { ClientConnectionRpc } from '../rpc.ts';
-export type { ApiProxy, SessionsApi, SessionSearchItem, SessionSummary, PromptContentPart, HostApi, EventsApi, MuxFrame, HostFrame, ApprovalResponsePayload, QuestionResponsePayload, HistoryEntry, ToolEventView, DirectoryEntry, DirectoryListing, ToolCallView, ToolResultView, WorkspaceApi, WorkspaceId, WorkspaceView, CommandsApi, CommandDescriptor, SkillsApi, SkillEntry, ModelCatalogFailure, ModelCatalogModel, ModelProviderGroup, ModelReasoning, MessageId, ModelReasoningEffort, ModelSelection, QueueAction, QueuedInboxItem, SessionModels, SubagentsApi, SubagentAddress, SubagentCatalog, SubagentListEntry, SubagentPromptReceipt, RpcRequest, RpcResponse, RpcResult, RpcError, RpcErrorCode, ClientRequest, ServerResponse, ServerRequest, ClientResponse, RpcMessage, RpcReceipt, HostDescription, IApiClient, SessionId, SessionEvent, ContentBlock, StreamChunk, GoalsApi, GoalRef, SettingsApi, SettingsNamespaceView, SettingsPathOpView, SettingsSecretView, CredentialsApi, CredentialView, ConfigurableProviderView, DiscoveredModelView, LlmApi, } from './api.ts';
+export type { ApiProxy, SessionsApi, SessionSearchItem, SessionSummary, PromptContentPart, HostApi, EventsApi, MuxFrame, HostFrame, ApprovalResponsePayload, QuestionResponsePayload, HistoryEntry, ToolEventView, DirectoryEntry, DirectoryListing, ToolCallView, ToolResultView, WorkspaceApi, WorkspaceId, WorkspaceView, CommandsApi, CommandDescriptor, SkillsApi, SkillEntry, ModelCatalogFailure, ModelCatalogModel, ModelProviderGroup, ModelReasoning, MessageId, ModelReasoningEffort, ModelSelection, QueueAction, QueuedInboxItem, SessionModels, SubagentsApi, SubagentAddress, SubagentCatalog, SubagentListEntry, SubagentPromptReceipt, TaskView, RpcRequest, RpcResponse, RpcResult, RpcError, RpcErrorCode, ClientRequest, ServerResponse, ServerRequest, ClientResponse, RpcMessage, RpcReceipt, HostDescription, IApiClient, SessionId, SessionEvent, ContentBlock, StreamChunk, GoalsApi, GoalRef, SettingsApi, SettingsNamespaceView, SettingsPathOpView, SettingsSecretView, CredentialsApi, CredentialView, ConfigurableProviderView, DiscoveredModelView, LlmApi, } from './api.ts';
 export { RpcId, AbstractApiClient, transportError, } from './api.ts';
 export type { ConnectionConfig, ConnectionSinks, ConnectionState };
 export type { ClientConnectionRpc } from '../rpc.ts';
+/** Observable Host description published by each completed connection handshake. */
+export interface HostDescriptionSource {
+    /** Latest connected-generation description; absent before connect and while reconnecting. */
+    getSnapshot(): HostDescription | undefined;
+    /** Subscribe to description replacement and connection loss. */
+    subscribe(listener: () => void): () => void;
+}
 /** Required services (none — this is the wire root). */
 export declare const inject: string[];
 /**
- * The ctx.connection service surface: the api client plus a one-shot
+ * The ctx.connection service API: the API client plus a one-shot
  * controller starter (the runtime plugin supplies sinks when its object layer
  * is ready — connection stays consumer-agnostic).
  */
@@ -23,6 +30,8 @@ export interface ConnectionHandle {
     readonly api: IApiClient;
     /** Whether the current page authority is loopback; non-browser contexts default to true. */
     readonly isLoopback: boolean;
+    /** Generation-scoped Host facts, including native path-open capability. */
+    readonly hostDescription: HostDescriptionSource;
     /** Generic logical RPC channels over the same Connection transport. */
     readonly rpc: ClientConnectionRpc;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-connection",
   "description": "Wire consumer layer: HTTP-up/WebSocket-down client, ConnectionController dual streams with reconnect, and fixture api",
-  "version": "0.0.1-rc.1",
+  "version": "0.0.1-rc.2",
   "publishConfig": {
     "access": "restricted"
   },
@@ -39,13 +39,13 @@
   "license": "BSD-3-Clause",
   "dependencies": {
     "ws": "^8.21.0",
-    "@deepseek-ai/dsh-host-apiproxy": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-commands": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-attachment": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-attachment": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-host-apiproxy": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.2",
     "@deepseek-ai/schemastery": "^3.18.1-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1"
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.2"
   },
   "files": [
     "lib/index.js",
@@ -54,14 +54,14 @@
     "lib/types/**/*.d.ts"
   ],
   "peerDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1-rc.1"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.2",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2"
   }
 }