@deepseek-ai/dsh-client-ui-settings-plugins 0.1.0-rc.7 → 0.1.1-rc.1

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/ui-settings-plugins/README.md
-README.md: 92ba426b6bee3ae73e184dfcfd418e889bd47086
-README.zh.md: dc319ea9f128016b6df821575cb4d75740f04579
+README.md: 0ee0edbebadad8e8e895002cd9eb60a20f45809d
+README.zh.md: b57fe9522dcc37b67f494199b3bb6ef0cf4a2a54

package/README.md

@@ -20,7 +20,7 @@ A card stages what the user types and writes it only when they save. Each contro
 
 Saving writes each staged field through the client settings scope, which fences every write with the namespace revision it read, so a form that has drifted from the document is refused rather than overwriting a concurrent change. The Host is the only authority on whether a value was accepted — its validators own the constraints no schema can express — so the card reads the section back afterwards and reports a save that did not land, keeping those drafts for the user to correct.
 
-A key can also be written from another surface — the Models page addresses the same reference — which changes no settings section, so the card re-reads on the forwarded `credentials/updated` event for the reference it watches.
+A key can also be written from another surface — the Models page addresses the same reference — which changes no settings section, so the card re-reads on the forwarded `credentials/reference-updated` event for the reference it watches.
 
 A field's presence in the raw user layer — not its value — is what marks it overridden; a reset clears that field so it re-inherits the composition layer. Secret-role fields never ride a response, so a key control starts blank, reports only whether one is configured, and writes through the credentials domain rather than the settings section; a blank draft writes nothing and keeps the stored key.
 

package/README.zh.md

@@ -20,7 +20,7 @@
 
 保存时，每个暂存字段都通过客户端 settings scope 写入，该 scope 用读取时的命名空间 revision 为每次写入设栅，因此已与文档脱节的表单会被拒绝，而不是覆盖并发变更。某个值是否被接受只有 Host 说了算——schema 表达不了的约束归它的校验器所有——因此卡片在写入后回读分节，报告没有落盘的保存，并保留这些草稿供用户修改。
 
-密钥也可能从别的表层写入——模型页寻址的是同一个引用——而那不改变任何 settings 分节，因此卡片会在转发来的 `credentials/updated` 事件报告它所关注的引用时重读。
+密钥也可能从别的表层写入——模型页寻址的是同一个引用——而那不改变任何 settings 分节，因此卡片会在转发来的 `credentials/reference-updated` 事件报告它所关注的引用时重读。
 
 字段是否被覆盖，取决于它是否出现在原始用户层中，而非取决于它的值；重置会清除该字段，使其重新继承组装层。secret 角色的字段绝不搭乘响应，因此密钥控件初始为空、只报告是否已配置，并经由 credentials 领域而非 settings 分节写入；空草稿不写入任何东西，保留已存密钥。
 
@@ -32,6 +32,8 @@
 
 无；该包既不组装也不发送提供方请求。
 
+<a id="known-limitations-and-deferred-work"></a>
+
 ## 已知限制与暂缓事项
 
 - **只有宿主平面的插件会出现**——由 agent preset 挂载的插件把配置内联在该 preset 的 `agent.cordis.yml` 中，且根本无法注册 settings 命名空间（同一 preset 挂载第二个会话时会因重复注册而失败），因此本分区不会列出它。编辑那些值仍是 preset 编辑器的职责。

package/lib/client.js

@@ -20,16 +20,16 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var fields_module_css_default = {
-			"input": "At1oFq_input",
+			"badge": "At1oFq_badge",
+			"badgeMuted": "At1oFq_badgeMuted",
+			"badges": "At1oFq_badges",
 			"field": "At1oFq_field",
 			"head": "At1oFq_head",
-			"label": "At1oFq_label",
+			"hint": "At1oFq_hint",
+			"input": "At1oFq_input",
 			"inputInvalid": "At1oFq_inputInvalid",
 			"invalid": "At1oFq_invalid",
-			"badges": "At1oFq_badges",
-			"badgeMuted": "At1oFq_badgeMuted",
-			"badge": "At1oFq_badge",
-			"hint": "At1oFq_hint",
+			"label": "At1oFq_label",
 			"reset": "At1oFq_reset"
 		};
 		//#endregion
@@ -162,21 +162,21 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var PluginCard_module_css_default = {
-			"discard": "YyYd_a_discard",
-			"header": "YyYd_a_header",
-			"pending": "YyYd_a_pending",
-			"name": "YyYd_a_name",
 			"body": "YyYd_a_body",
-			"failed": "YyYd_a_failed",
-			"save": "YyYd_a_save",
-			"chevronOpen": "YyYd_a_chevronOpen",
-			"chevron": "YyYd_a_chevron",
+			"card": "YyYd_a_card",
 			"cardOpen": "YyYd_a_cardOpen",
-			"readOnly": "YyYd_a_readOnly",
+			"chevron": "YyYd_a_chevron",
+			"chevronOpen": "YyYd_a_chevronOpen",
 			"description": "YyYd_a_description",
-			"card": "YyYd_a_card",
+			"discard": "YyYd_a_discard",
+			"failed": "YyYd_a_failed",
+			"footer": "YyYd_a_footer",
 			"headText": "YyYd_a_headText",
-			"footer": "YyYd_a_footer"
+			"header": "YyYd_a_header",
+			"name": "YyYd_a_name",
+			"pending": "YyYd_a_pending",
+			"readOnly": "YyYd_a_readOnly",
+			"save": "YyYd_a_save"
 		};
 		//#endregion
 		//#region lib/types/client/PluginCard.js
@@ -371,14 +371,14 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var PluginsSettingsSection_module_css_default = {
-			"tabs": "pbvGtq_tabs",
 			"cards": "pbvGtq_cards",
-			"tab": "pbvGtq_tab",
+			"empty": "pbvGtq_empty",
 			"heading": "pbvGtq_heading",
 			"intro": "pbvGtq_intro",
-			"empty": "pbvGtq_empty",
+			"panel": "pbvGtq_panel",
 			"section": "pbvGtq_section",
-			"panel": "pbvGtq_panel"
+			"tab": "pbvGtq_tab",
+			"tabs": "pbvGtq_tabs"
 		};
 		//#endregion
 		//#region lib/types/client/ConfigurablePluginsTab.js
@@ -920,47 +920,28 @@ window.__ModuleLoader__.load({
 		* is never dispatched, so a plugin this deployment did not compose leaves no
 		* trace and does not count toward the empty line.
 		*/
-		/** Reads the served namespaces and pairs them with the cards that claim them. */
+		/** Derives the served namespaces from the shared describe mirror and pairs them with the cards that claim them. */
 		var ConfigurablePluginsTabController = class {
-			api;
+			describeFace;
 			entries;
 			store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)({
 				loaded: false,
 				namespaces: []
 			});
-			/** Last Host answer; kept so a slot mutation republishes without a wire read. */
-			served = [];
-			loaded = false;
-			generation = 0;
 			disposed = false;
+			unsubscribe;
 			/**
-			* @param api - settings wire face.
+			* @param describeFace - the shared mirror's describe face; its refreshes
+			* (document commits, reconnects) are what keep the served set current.
 			* @param entries - reads the cards currently registered into the section's slot.
 			*/
-			constructor(api, entries) {
-				this.api = api;
+			constructor(describeFace, entries) {
+				this.describeFace = describeFace;
 				this.entries = entries;
-			}
-			/** Opaque read of {@link disposed}: control flow cannot narrow it across awaits. */
-			isDisposed() {
-				return this.disposed;
-			}
-			/**
-			* Re-read the served namespaces from the Host and republish.
-			* @returns settlement after the read, or immediately once disposed.
-			*/
-			async load() {
-				if (this.isDisposed()) return;
-				const generation = ++this.generation;
-				let response;
-				try {
-					response = await this.api.settings.describe({});
-				} catch (_settingsReadFailure) {
-					return;
-				}
-				if (this.isDisposed() || generation !== this.generation || !response.result.ok) return;
-				this.served = response.result.value.namespaces.map((view) => view.ns);
-				this.loaded = true;
+				this.unsubscribe = describeFace.subscribe(() => {
+					this.publish();
+				});
+				describeFace.ensure();
 				this.publish();
 			}
 			/** Republish after the slot ledger changed; a card registered late joins here. */
@@ -968,10 +949,10 @@ window.__ModuleLoader__.load({
 				if (this.disposed) return;
 				this.publish();
 			}
-			/** Stop publishing; an in-flight read settles without touching the store. */
+			/** Stop publishing and stop following the mirror. */
 			dispose() {
 				this.disposed = true;
-				this.generation += 1;
+				this.unsubscribe();
 			}
 			/**
 			* Build the face the tab's slot registration injects.
@@ -981,12 +962,15 @@ window.__ModuleLoader__.load({
 				return { hooks: { configurablePlugins: this.store } };
 			}
 			publish() {
-				const served = new Set(this.served);
+				if (this.disposed) return;
+				const mirrored = this.describeFace.getSnapshot();
+				const loaded = mirrored.view !== void 0;
+				const served = new Set(mirrored.view?.namespaces.map((view) => view.ns) ?? []);
 				const namespaces = this.entries().flatMap((entry) => entry.options.key !== void 0 && served.has(entry.options.key) ? [entry.options.key] : []);
 				const previous = this.store.getSnapshot();
-				if (previous.loaded === this.loaded && previous.namespaces.length === namespaces.length && previous.namespaces.every((ns, index) => ns === namespaces[index])) return;
+				if (previous.loaded === loaded && previous.namespaces.length === namespaces.length && previous.namespaces.every((ns, index) => ns === namespaces[index])) return;
 				this.store.set({
-					loaded: this.loaded,
+					loaded,
 					namespaces
 				});
 			}
@@ -1251,23 +1235,16 @@ window.__ModuleLoader__.load({
 			const bash = new BashCardController(ctx.settingsScope.bind({ namespace: SHELL_NS }));
 			const agentLoop = new AgentLoopCardController(ctx.settingsScope.bind({ namespace: AGENT_LOOP_NS }));
 			const webSearch = new WebSearchCardController(ctx.settingsScope.bind({ namespace: WEB_SEARCH_NS }), api);
-			ctx.effect(() => ctx.remote.$on("credentials/updated", (ref) => {
+			ctx.effect(() => ctx.remote.$on("credentials/reference-updated", (ref) => {
 				webSearch.refreshCredential(ref);
 			}), "ui-settings-plugins: credential invalidations");
-			const configurable = new ConfigurablePluginsTabController(api, () => ctx.slots.entries("settings.plugin.item"));
+			const configurable = new ConfigurablePluginsTabController(ctx.settingsScope.describe(), () => ctx.slots.entries("settings.plugin.item"));
 			ctx.effect(() => () => {
 				configurable.dispose();
 			}, "ui-settings-plugins: tab directory");
-			ctx.effect(() => ctx.remote.$on("settings/document-updated", () => {
-				configurable.load();
-			}), "ui-settings-plugins: served-namespace invalidations");
-			ctx.effect(() => ctx.on("connection/reset", () => {
-				configurable.load();
-			}), "ui-settings-plugins: served-namespace reconnect");
 			ctx.effect(() => ctx.slots.subscribe("settings.plugin.item", () => {
 				configurable.refresh();
 			}), "ui-settings-plugins: card ledger");
-			configurable.load();
 			let tabsVersion = -1;
 			let tabsRevision = -1;
 			let tabs = [];

package/lib/types/client/tab-store.d.ts

@@ -9,7 +9,7 @@
  * is never dispatched, so a plugin this deployment did not compose leaves no
  * trace and does not count toward the empty line.
  */
-import type { IApiClient } from '@deepseek-ai/dsh-client-connection/client';
+import type { SettingsDescribeFace } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { StoredEntry } from '@deepseek-ai/dsh-client-ui-slots';
 import { type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
 /** What the section renders. */
@@ -38,31 +38,22 @@ export interface ConfigurablePluginsTabFace {
         configurablePlugins: SnapshotStore<ConfigurablePluginsTabState>;
     };
 }
-/** Reads the served namespaces and pairs them with the cards that claim them. */
+/** Derives the served namespaces from the shared describe mirror and pairs them with the cards that claim them. */
 export declare class ConfigurablePluginsTabController {
-    private readonly api;
+    private readonly describeFace;
     private readonly entries;
     private readonly store;
-    /** Last Host answer; kept so a slot mutation republishes without a wire read. */
-    private served;
-    private loaded;
-    private generation;
     private disposed;
+    private readonly unsubscribe;
     /**
-     * @param api - settings wire face.
+     * @param describeFace - the shared mirror's describe face; its refreshes
+     * (document commits, reconnects) are what keep the served set current.
      * @param entries - reads the cards currently registered into the section's slot.
      */
-    constructor(api: Pick<IApiClient, 'settings'>, entries: () => readonly StoredEntry[]);
-    /** Opaque read of {@link disposed}: control flow cannot narrow it across awaits. */
-    private isDisposed;
-    /**
-     * Re-read the served namespaces from the Host and republish.
-     * @returns settlement after the read, or immediately once disposed.
-     */
-    load(): Promise<void>;
+    constructor(describeFace: SettingsDescribeFace, entries: () => readonly StoredEntry[]);
     /** Republish after the slot ledger changed; a card registered late joins here. */
     refresh(): void;
-    /** Stop publishing; an in-flight read settles without touching the store. */
+    /** Stop publishing and stop following the mirror. */
     dispose(): void;
     /**
      * Build the face the tab's slot registration injects.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-settings-plugins",
   "description": "Plugins settings section with feature-owned tabs and configurable host-plane plugin cards",
-  "version": "0.1.0-rc.7",
+  "version": "0.1.1-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -43,32 +43,27 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "react": "^18.2.0",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-web-react": "^0.1.0-rc.7"
+    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.1"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-web-react": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.1-rc.1"
   },
   "files": [
     "lib/index.js",