@songtonyli/dsh-cli 0.1.11 → 0.1.13

package/node_modules/@deepseek-ai/dsh-client-ui-renderer/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-renderer",
   "description": "Browser UI renderer: React slot bindings, ctx.uiRenderer, and the assembled application root",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -41,7 +41,8 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-invariants": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-invariants": "0.1.6-alpha.2",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
     "@types/use-sync-external-store": "^1.5.0",

package/node_modules/@deepseek-ai/dsh-client-ui-schedule/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-schedule",
   "description": "Read-only active Schedule catalog in the Web Session header",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.6-alpha.2",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -40,13 +40,15 @@
     "@deepseek-ai/cordis": "4.0.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-api-session-controller": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-locale": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-schedule": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-schedule": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.6-alpha.2",
     "@testing-library/react": "^16.1.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",

package/node_modules/@deepseek-ai/dsh-client-ui-session/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/ui-session/README.md
-README.md: 75fd792866afc29c6c99fd0879588e80b75b22dc
-README.zh.md: 3f6667d27f7a5e13bff6ee892e2e5ecb05852afc
+README.md: 4fff368e58d7b422ba6948be78e543c31f5cef59
+README.zh.md: db37539b59231bfef50f3bdcc33aeae94e881a44

package/node_modules/@deepseek-ai/dsh-client-ui-session/README.md

@@ -8,7 +8,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-React and Slot adapter for Session Controller state. It contributes Session list and pending-interaction hooks at root scope, materializes per-Session hooks and props, and owns the standard `SessionProvider` rendering behavior without taking ownership of Session transport or lifecycle state. Use it when a browser feature needs Session state through standard React props and hooks.
+Use this package to expose Session catalog, retain information, and unified UI status through standard Slot hooks. It materializes per-`SessionBinding` hooks and props, while `SessionProvider` can inherit an outer binding or bind an explicit `SessionReference`. It owns process-local pending-interaction and completion-reminder policy without owning Controller transport, history, or references.
 
 ## Table of Contents
 

package/node_modules/@deepseek-ai/dsh-client-ui-session/README.zh.md

@@ -8,7 +8,7 @@ kind: "package-reference"
 
 ## 概述
 
-面向会话控制器状态的 React 与 Slot 适配器。本包在 root scope 提供会话列表和 pending-interaction 钩子，物化逐会话钩子与 prop，并拥有标准 `SessionProvider` 渲染行为，但不接管会话 transport 或 lifecycle 状态。当浏览器功能需要通过标准 React prop 和钩子读取会话状态时，请使用它。
+使用本包可通过标准 Slot 钩子公开 Session catalog、retain 信息与统一 UI 状态。它按 `SessionBinding` 物化钩子和 prop，而 `SessionProvider` 可以继承外围 binding 或绑定显式 `SessionReference`。它拥有进程本地的 pending-interaction 与完成提醒策略，但不拥有 Controller transport、历史或 reference。
 
 ## 目录
 

package/node_modules/@deepseek-ai/dsh-client-ui-session/lib/client.js

@@ -8,19 +8,79 @@ window.__ModuleLoader__.load({
 		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
 		let _deepseek_ai_dsh_client_ui_slots = require("@deepseek-ai/dsh-client-ui-slots");
 		let react_jsx_runtime = require("react/jsx-runtime");
-		let react = require("react");
+		//#region ../../util/values/src/index.ts
+		/**
+		* Weak-key lookup with a strongly retained iterable set of associated values.
+		*
+		* Each value must belong to only one key. The container performs no automatic
+		* cleanup; owners delete associations or clear the container at lifecycle end.
+		*/
+		var WeakMapWithValues = class {
+			keys = /* @__PURE__ */ new WeakMap();
+			valueSet = /* @__PURE__ */ new Set();
+			/** Live strongly retained values in insertion order. */
+			values = this.valueSet;
+			/**
+			* Read the value associated with a key.
+			* @param key - weakly held lookup key.
+			* @returns the associated value, or absence.
+			*/
+			get(key) {
+				return this.keys.get(key);
+			}
+			/**
+			* Test whether a key has an association.
+			* @param key - weakly held lookup key.
+			* @returns whether the key is present.
+			*/
+			has(key) {
+				return this.keys.has(key);
+			}
+			/**
+			* Associate one key with one caller-unique value.
+			* @param key - weakly held lookup key.
+			* @param value - strongly retained value that belongs to no other key.
+			* @returns this container.
+			*/
+			set(key, value) {
+				if (this.keys.has(key)) {
+					const previous = this.keys.get(key);
+					if (previous === value) return this;
+					this.valueSet.delete(previous);
+				}
+				this.keys.set(key, value);
+				this.valueSet.add(value);
+				return this;
+			}
+			/**
+			* Remove one association and its strongly retained value.
+			* @param key - weakly held lookup key.
+			* @returns whether an association was removed.
+			*/
+			delete(key) {
+				if (!this.keys.has(key)) return false;
+				const value = this.keys.get(key);
+				const deleted = this.keys.delete(key);
+				this.valueSet.delete(value);
+				return deleted;
+			}
+			/** Remove every association and strongly retained value. */
+			clear() {
+				this.keys = /* @__PURE__ */ new WeakMap();
+				this.valueSet.clear();
+			}
+		};
+		//#endregion
 		//#region lib/types/client/session-provider.js
-		/** Session-owned rendering semantics for the standard SessionProvider seat. */
 		/**
 		* Render the selected Session body or its empty branch.
 		* @param binding - current Session scope binding.
 		* @param props - standard Session area render props.
-		* @returns the selected Session subtree, keyed by Session identity.
+		* @returns the selected Session subtree.
 		*/
 		function renderSessionArea(binding, { empty, children }) {
-			const sessionId = binding.key;
-			if (sessionId === void 0) return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: empty?.() ?? null });
-			return (0, react_jsx_runtime.jsx)(react.Fragment, { children }, sessionId);
+			if (binding.key === void 0) return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: empty?.() ?? null });
+			return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children });
 		}
 		//#endregion
 		//#region lib/types/client/index.js
@@ -72,20 +132,25 @@ window.__ModuleLoader__.load({
 		var UiSession = class extends _deepseek_ai_cordis.Service {
 			sessions;
 			descriptors = [BUILTIN_SOURCE];
-			bindings = /* @__PURE__ */ new Map();
+			bindings = new WeakMapWithValues();
 			absent;
-			currentBinding;
-			currentListeners = /* @__PURE__ */ new Set();
+			current;
 			pendingDomains = [];
 			pendingSnapshot = /* @__PURE__ */ new Map();
-			pendingListeners = /* @__PURE__ */ new Set();
-			/** Root source of pending UI interactions, independent from Controller snapshots. */
-			pendingInteractions = {
-				getSnapshot: () => this.pendingSnapshot,
+			running = /* @__PURE__ */ new Map();
+			completionUnread = /* @__PURE__ */ new Set();
+			statusSnapshot = /* @__PURE__ */ new Map();
+			statusListeners = /* @__PURE__ */ new Set();
+			mainRetainId;
+			disposeMainRetain = () => {};
+			active = true;
+			/** Root source combining running, pending-interaction, and completion-reminder facts. */
+			sessionStatus = {
+				getSnapshot: () => this.statusSnapshot,
 				subscribe: (listener) => {
-					this.pendingListeners.add(listener);
+					this.statusListeners.add(listener);
 					return () => {
-						this.pendingListeners.delete(listener);
+						this.statusListeners.delete(listener);
 					};
 				}
 			};
@@ -98,34 +163,51 @@ window.__ModuleLoader__.load({
 			constructor(ctx, sessions) {
 				super(ctx, "uiSession");
 				this.sessions = sessions;
-				this.absent = this.materializeAbsent();
-				this.currentBinding = this.resolveCurrent();
+				this.absent = createBindingSource(this.materializeAbsent());
+				this.current = createBindingSource(this.absent.value);
 				this.adapter = {
-					current: {
-						getSnapshot: () => this.currentBinding,
-						subscribe: (listener) => {
-							this.currentListeners.add(listener);
-							return () => {
-								this.currentListeners.delete(listener);
-							};
-						}
-					},
-					resolve: (key) => this.resolve(key),
+					current: this.current,
+					bindingSource: (target) => this.bindingSource(target),
 					renderArea: renderSessionArea
 				};
 				ctx.effect(() => {
 					const disposeList = sessions.list.subscribe(() => {
-						this.publishCurrent();
+						this.publishMain();
 					});
+					const disposeStatus = sessions.list.subscribe(() => {
+						this.reconcileStatus();
+					});
+					const disposeRemoteStatus = ctx.remote.$on("api-session/status", (sessionId, running) => {
+						this.observeRunning(sessionId, running);
+					});
+					this.publishMain();
+					this.reconcileStatus();
 					return () => {
+						this.active = false;
 						disposeList();
-						const records = [...this.bindings.values()];
+						disposeStatus();
+						disposeRemoteStatus();
+						this.disposeMainRetain();
+						const records = [...this.bindings.values];
 						this.bindings.clear();
 						for (const record of records) record.release();
 					};
 				}, "ui-session: Session binding projection");
 			}
 			/**
+			* Resolve a stable renderer source for an owned Session reference or explicit absence.
+			* @param reference - active reference supplied by the Provider owner, or absence.
+			* @returns the binding source, which falls back to the absent projection when its generation ends.
+			* @throws when the reference does not belong to the active Controller generation.
+			*/
+			bindingSource(reference) {
+				if (!this.active) return this.absent;
+				if (reference === void 0) return this.absent;
+				const owner = reference.binding;
+				if (this.sessions.binding(reference.sessionId) !== owner) throw new Error("ui-session: Session reference is not active in this Controller");
+				return this.sourceFor(owner);
+			}
+			/**
 			* Register one Session-scoped standard-source contribution.
 			* @param descriptor - static member roster and per-binding resolver.
 			* @returns disposer owned by the caller's Cordis fiber.
@@ -177,38 +259,42 @@ window.__ModuleLoader__.load({
 			}
 			rebuildBindings() {
 				const absent = this.materializeAbsent();
-				const bindings = /* @__PURE__ */ new Map();
-				try {
-					for (const [sessionId, cached] of this.bindings) bindings.set(sessionId, this.createMaterializedBinding(cached.owner));
-				} catch (error) {
-					for (const record of bindings.values()) record.release();
-					throw error;
-				}
-				const previous = this.bindings;
-				this.absent = absent;
-				this.bindings = bindings;
-				for (const record of previous.values()) record.release();
-				this.publishCurrent();
+				const updates = [...this.bindings.values].map((record) => ({
+					source: record.source,
+					value: this.materialize(record.owner)
+				}));
+				this.absent.value = absent;
+				for (const { source, value } of updates) source.value = value;
+				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.absent.listeners, "[ui-session] absent binding");
+				for (const { source } of updates) (0, _deepseek_ai_dsh_client_store.notifySubscribers)(source.listeners, "[ui-session] Session binding");
+				this.publishMain();
 			}
-			resolve(key) {
-				const owner = this.sessions.binding(key);
-				if (owner === void 0) return void 0;
-				const cached = this.bindings.get(key);
-				if (cached?.owner === owner) return cached.value;
+			sourceFor(owner) {
+				const cached = this.bindings.get(owner);
+				if (cached !== void 0) return cached.source;
 				const record = this.createMaterializedBinding(owner);
-				this.bindings.set(key, record);
-				cached?.release();
-				return record.value;
+				this.bindings.set(owner, record);
+				return record.source;
 			}
-			resolveCurrent() {
-				const current = this.sessions.list.getSnapshot().current;
-				return current === void 0 ? this.absent : this.resolve(current) ?? this.absent;
+			publishMain() {
+				if (!this.active) return;
+				const byId = this.sessions.list.getSnapshot().byId;
+				const currentId = this.current.value.key;
+				const nextId = currentId !== void 0 && (this.sessions.retainInfo(currentId).getSnapshot().retainedBy.mainView ?? 0) > 0 ? currentId : Object.values(byId).find((candidate) => (candidate.retainedBy.mainView ?? 0) > 0)?.id;
+				this.watchMainRetention(nextId);
+				const owner = nextId === void 0 ? void 0 : this.sessions.binding(nextId);
+				const value = owner === void 0 ? this.absent.value : this.sourceFor(owner).value;
+				if (this.current.value === value) return;
+				this.current.value = value;
+				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.current.listeners, "[ui-session] main binding");
 			}
-			publishCurrent() {
-				const next = this.resolveCurrent();
-				if (next === this.currentBinding) return;
-				this.currentBinding = next;
-				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.currentListeners, "[ui-session] current binding");
+			watchMainRetention(sessionId) {
+				if (sessionId === this.mainRetainId) return;
+				this.disposeMainRetain();
+				this.mainRetainId = sessionId;
+				this.disposeMainRetain = sessionId === void 0 ? () => {} : this.sessions.retainInfo(sessionId).subscribe(() => {
+					this.publishMain();
+				});
 			}
 			publishPendingInteractions() {
 				const next = /* @__PURE__ */ new Map();
@@ -223,20 +309,67 @@ window.__ModuleLoader__.load({
 				const projected = new Map([...next].map(([sessionId, value]) => [sessionId, value.interaction]));
 				if (samePendingInteractions(this.pendingSnapshot, projected)) return;
 				this.pendingSnapshot = projected;
-				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.pendingListeners, "[ui-session] pending interactions");
+				this.publishStatus();
+			}
+			observeRunning(sessionId, running) {
+				const previous = this.running.get(sessionId);
+				const beforeBaseline = this.sessions.list.getSnapshot().phase === "pending";
+				this.running.set(sessionId, running);
+				if (running) this.completionUnread.delete(sessionId);
+				else if ((previous === true || previous === void 0 && beforeBaseline) && !this.isMain(sessionId)) this.completionUnread.add(sessionId);
+				this.publishStatus();
+			}
+			reconcileStatus() {
+				const list = this.sessions.list.getSnapshot();
+				const present = new Set(Object.keys(list.byId));
+				for (const id of present) {
+					const row = list.byId[id];
+					if (row === void 0) continue;
+					const previous = this.running.get(id);
+					if (previous === void 0) this.running.set(id, row.running);
+					else if (previous !== row.running) this.observeRunning(id, row.running);
+					if ((row.retainedBy.mainView ?? 0) > 0) this.completionUnread.delete(id);
+				}
+				if (list.phase === "ready") for (const id of this.running.keys()) {
+					if (present.has(id)) continue;
+					this.running.delete(id);
+					this.completionUnread.delete(id);
+				}
+				this.publishStatus();
+			}
+			isMain(sessionId) {
+				return (this.sessions.list.getSnapshot().byId[sessionId]?.retainedBy.mainView ?? 0) > 0;
+			}
+			publishStatus() {
+				const ids = new Set([
+					...Object.keys(this.sessions.list.getSnapshot().byId),
+					...this.running.keys(),
+					...this.pendingSnapshot.keys(),
+					...this.completionUnread
+				]);
+				const next = /* @__PURE__ */ new Map();
+				for (const id of ids) next.set(id, {
+					running: this.running.get(id),
+					pendingInteraction: this.pendingSnapshot.get(id),
+					completionUnread: this.completionUnread.has(id)
+				});
+				if (sameSessionStatus(this.statusSnapshot, next)) return;
+				this.statusSnapshot = next;
+				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.statusListeners, "[ui-session] Session status");
 			}
 			createMaterializedBinding(owner) {
 				const value = this.materialize(owner);
+				this.ctx.slots.bindStoreScope(value);
+				const source = createBindingSource(value);
 				const releaseEffect = owner.ctx.effect(() => () => {
-					if (this.bindings.get(owner.sessionId) !== record) return;
-					this.bindings.delete(owner.sessionId);
-					if (this.currentBinding !== value) return;
-					this.currentBinding = this.absent;
-					(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.currentListeners, "[ui-session] current binding");
+					if (this.bindings.get(owner) === record) this.bindings.delete(owner);
+					source.value = this.absent.value;
+					(0, _deepseek_ai_dsh_client_store.notifySubscribers)(source.listeners, "[ui-session] Session binding");
+					this.publishMain();
 				}, `ui-session: binding ${owner.sessionId}`);
 				const record = {
 					owner,
-					value,
+					source,
 					release: () => {
 						releaseEffect();
 					}
@@ -255,15 +388,13 @@ window.__ModuleLoader__.load({
 					copyDeclared("keyed hook", keyedHooks, descriptor.keyedHooks, contribution.keyedHooks, finalProps);
 					copyDeclared("prop", props, descriptor.props, contribution.props, finalProps);
 				}
-				const value = {
+				return {
 					key: binding.sessionId,
 					ctx: binding.ctx,
 					hooks,
 					keyedHooks,
 					props
 				};
-				this.ctx.slots.bindStoreScope(value);
-				return value;
 			}
 			materializeAbsent() {
 				const hooks = {};
@@ -283,6 +414,20 @@ window.__ModuleLoader__.load({
 				};
 			}
 		};
+		function createBindingSource(value) {
+			const source = {
+				value,
+				listeners: /* @__PURE__ */ new Set(),
+				getSnapshot: () => source.value,
+				subscribe: (listener) => {
+					source.listeners.add(listener);
+					return () => {
+						source.listeners.delete(listener);
+					};
+				}
+			};
+			return source;
+		}
 		function validateContribution(descriptor, contribution) {
 			rejectUndeclared("hook", descriptor.hooks, contribution.hooks);
 			rejectUndeclared("keyed hook", descriptor.keyedHooks, contribution.keyedHooks);
@@ -311,19 +456,34 @@ window.__ModuleLoader__.load({
 			finalProps.add(propName);
 		}
 		/** Required Controller and renderer services. */
-		const inject = ["sessions", "slots"];
+		const inject = [
+			"sessions",
+			"slots",
+			"remote"
+		];
 		/**
 		* Install the Session root source and scoped adapter.
 		* @param ctx - Client Cordis context.
 		*/
 		function apply(ctx) {
 			const service = new UiSession(ctx, ctx.sessions);
-			ctx.slots.provideRoot({ hooks: {
-				sessions: ctx.sessions.list,
-				sessionPendingInteraction: service.pendingInteractions
-			} });
+			ctx.slots.provideRoot({
+				hooks: {
+					sessions: ctx.sessions.list,
+					sessionStatus: service.sessionStatus
+				},
+				keyedHooks: { sessionRetainInfo: (key) => ctx.sessions.retainInfo(key) }
+			});
 			ctx.slots.installScope("session", service.adapter);
 		}
+		function sameSessionStatus(left, right) {
+			if (left.size !== right.size) return false;
+			for (const [id, status] of left) {
+				const candidate = right.get(id);
+				if (candidate === void 0 || candidate.running !== status.running || candidate.pendingInteraction !== status.pendingInteraction || candidate.completionUnread !== status.completionUnread) return false;
+			}
+			return true;
+		}
 		function samePendingInteractions(left, right) {
 			if (left.size !== right.size) return false;
 			for (const [sessionId, interaction] of left) if (right.get(sessionId) !== interaction) return false;

package/node_modules/@deepseek-ai/dsh-client-ui-session/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-session",
   "description": "Session Controller adapter for React and session-scoped slots",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -28,6 +28,7 @@
   "dsh": {
     "client": {
       "inject": [
+        "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-api-session-controller",
         "@deepseek-ai/dsh-client-ui-renderer"
       ],
@@ -40,9 +41,12 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.1.6-alpha.2",
     "@types/react": "~18.3.1",
     "react": "^18.2.0"
   },

package/node_modules/@deepseek-ai/dsh-client-ui-settings/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-settings",
   "description": "Settings domain base plugin: the settings-namespace scope service and the canonical settings slot-type contract",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -39,12 +39,13 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "0.1.6-alpha.1",
-    "@deepseek-ai/dsh-settings": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.1.6-alpha.2",
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "@deepseek-ai/schemastery": "3.18.2",
-    "@deepseek-ai/dsh-util-values": "0.1.6-alpha.1"
+    "@deepseek-ai/dsh-util-values": "0.1.6-alpha.2"
   },
   "files": [
     "lib/index.js",

package/node_modules/@deepseek-ai/dsh-client-ui-settings-general/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/ui-settings-general/README.md
-README.md: af68c42ad111f74e68037436e18a5be57195a64b
-README.zh.md: f929df66a13cde7beb63721922f2a3f4aa90ba43
+README.md: 0ea39cbb56b2040004513723b6d838a1ce9e7557
+README.zh.md: 9566471c68067e4ec461c28aeeb9a806a718fb90

package/node_modules/@deepseek-ai/dsh-client-ui-settings-general/README.md

@@ -27,6 +27,8 @@ Use this package to give the dsh web client a Settings panel, connection-recover
 
 Users reach the shell through the sidebar's bottom Settings control; feature plugins contribute their pages and onboarding steps through the slot ledgers this shell projects. In both the expanded sidebar and collapsed rail, the control exposes the localized Settings label as its accessible name. A pale-yellow **Disconnected** action beside Settings indicates browser offline suspension; its permanent retry glyph marks the retry action, which the Chinese outage copy also names (连接异常，刷新重试). Every recovery attempt shows a spinner beside **Reconnecting** with one to three dots advancing every 500ms, and an attempt stays visible for at least 800ms so brief retries do not flicker. Selecting either yellow state starts an immediate retry; press feedback stays within the warning palette. Recovery changes the region to pale-green **Connected** for two seconds from the moment the green pill becomes visible. The pill fades in on appearance, fades out over 150ms on removal, and sizes to its current label. Initial startup and uninterrupted healthy operation remain silent. The shell renders the modal panel, the navigation built from `settings.section` entries, and exactly one mounted onboarding step at a time.
 
+In Desktop, the account-row update control shows availability, progress, verification, readiness, and persistent retry feedback. The preload carries semantic phase, version, progress, and classified failures; the component resolves every visible and accessible string from the active `settings` locale, including after an in-application language change. Selecting an available update starts downloading; installation requires a separate shell-owned confirmation. A collapsed sidebar shows the same status as a dot on its top expand button. Connection feedback takes priority except during shell-reported installation, when the expected backend disconnect must not hide update status. Failure restores connection feedback. Both controls share one carrier subscription; browser code cannot choose packages or authorize installation. [Desktop updates](../../../apps/desktop/README.md) owns the release workflow.
+
 ### The General section
 
 The General section holds rows registered into `settings.general.item` by feature packages — it has no built-in rows. Feature plugins own the row copy and behavior; the shell only provides the section and its slot. The Appearance row, for example, lives in ui-theme.

package/node_modules/@deepseek-ai/dsh-client-ui-settings-general/README.zh.md

@@ -27,6 +27,8 @@ kind: "package-reference"
 
 用户通过侧边栏底部的 Settings 控件进入外壳；功能插件通过本外壳所投影的 slot 账本贡献自己的页面与引导步骤。在展开侧边栏和收起轨道中，该控件都会把本地化的 Settings 文案作为其可访问名称。Settings 右侧浅黄色的**连接异常**操作表示浏览器离线暂停；其常驻重试图形与中文文案「连接异常，刷新重试」都指明重试动作。每次恢复尝试都显示 spinner 加**重新连接中**，其后一至三个点每 500ms 前进一次，且每次尝试至少可见 800ms，短暂重试不会闪动。选中任一黄色状态都会立即发起重试；按压反馈留在黄色色阶内。恢复后该区域变为浅绿色的**连接成功**，从绿色药丸可见起驻留 2 秒再消失。药丸出现时淡入、移除时以 150ms 淡出，宽度随当前文案自适应。首次启动与未曾中断的健康连接保持静默。外壳渲染模态面板、由 `settings.section` 条目构建的导航，以及每次只挂载一个的引导步骤。
 
+在 Desktop 中，账户行更新控件显示可用版本、进度、验证、就绪和持久重试反馈。预加载仅传递语义化阶段、版本、进度和失败类别；组件从当前 `settings` locale 解析全部可见与无障碍文案，并在应用内语言变化后同步更新。选择可用更新即开始下载；安装需要独立的壳拥有的确认。侧栏收起时，其顶部展开按钮以圆点显示相同状态。连接反馈通常优先展示，但壳报告正在安装时，预期的后端断开不能遮盖更新状态；失败后恢复连接反馈。两个控件共用一次载体订阅；浏览器代码不能选择安装包或授权安装。[Desktop 更新](../../../apps/desktop/README.zh.md)负责发布流程。
+
 ### 「通用」分区
 
 「通用」分区承载由功能包注册进 `settings.general.item` 的行——它没有内置行。功能插件拥有行文案与行为；外壳只提供分区及其 slot。例如「外观」行位于 ui-theme。