@deepseek-ai/dsh-client-ui-settings-plugin-inventory 0.1.6-alpha.1 → 0.1.6-alpha.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/ui-settings-plugin-inventory/README.md
-README.md: 40b7e41cd2d6953fdf3b9155fd6adff9d9d65391
-README.zh.md: 45f3444ea4fa56fe4a55517eb5d981913c790b15
+README.md: 9b41c7490055dcf9865958a4e243b115fdbd40b8
+README.zh.md: dd4b1ebcd68a48573c42864eb796c58b49f9b834

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-The **Plugin list** tab lets Web users inspect plugins without changing their configuration. It presents agent presets first and collapses the global inventory until needed. Cards retain the package name as the primary title, identify instances by stable entry id, and expose enablement, source details, runtime status, disabled conditions, and discovery failures; preset-provided global entries name their presets. Search covers both groups and points to matches in other presets. The tab handles loading, empty, no-match, failure, and retry states without exposing transport details, and still shows the global inventory without a preset roster.
+The **Plugin list** tab lets Web users inspect plugins without changing their configuration. It lists agent presets, then the global inventory; both start collapsed and open on demand or during a search. Cards retain the package name as the primary title, identify instances by stable entry id, and expose enablement, source details, runtime status, disabled conditions, and discovery failures; preset-provided global entries name their presets. Search covers both groups and points to matches in other presets. The tab handles loading, empty, no-match, failure, and retry states without exposing transport details, and still shows the global inventory without a preset roster.
 
 ## Table of Contents
 
@@ -27,9 +27,11 @@ The **Plugin list** tab lets Web users inspect plugins without changing their co
 
 Open the Plugins section in Settings and select the **Plugin list** tab to inspect the Host's plugin inventory. The tab reads no Remote during plugin activation — selecting it for the first time mounts the component and lazily calls `ctx.remote.pluginInventory.list()` through `api-remotes`.
 
+A failed installation with pending pnpm build permissions offers **Allow these scripts and retry**. The action displays the exact package names and persistent permission scope, then retries the original package spec and activation choice. One click approves the entire displayed group, which can include pending packages from earlier attempts. Closing the page grants no permission.
+
 ### Reading a card
 
-Each collapsed card uses the short module name as its primary title, shows the stable entry id underneath, and carries a small enablement tag; enabled entries also show a colored root-fiber status dot. A composition-generated subtitle omits its leading `include:` marker, while hover, search, the accessible name, and expanded details retain the complete id. Long entry ids truncate in the row and remain available on hover. Expanding one card reveals the declared entry id, the full module specifier, and the state facts: a preset row names the preset it comes from, its runtime status when the composition is live, and its disable condition when it carries one; a preset-provided global row explains that agent presets provide it per session, names the presets that enable it, and offers a jump into the preset group. Preset names resolve through the shared `presetDisplayText` fold (`dsh-agent-presets/display`) over [`ui-agent-preset`](../ui-agent-preset/README.md)'s dictionaries: shipped presets follow the active locale while user-authored ones keep their own metadata, so an English surface never echoes the preset files' Chinese names. Search filters both groups by module name and entry id.
+Each collapsed card uses the short module name as its primary title, shows the stable entry id underneath, and carries a small enablement tag; a colored root-fiber status dot marks only the `pending`, `loading`, and `unloading` phases the tag cannot state, so an `active` fiber shows its tag alone. A composition-generated subtitle omits its leading `include:` marker, while hover, search, the accessible name, and expanded details retain the complete id. Long entry ids truncate in the row and remain available on hover. Expanding one card reveals the declared entry id, the full module specifier, and the state facts: a preset row names the preset it comes from, its runtime status when the composition is live, and its disable condition when it carries one; a preset-provided global row explains that agent presets provide it per session, names the presets that enable it, and offers a jump into the preset group. Preset names resolve through the shared `presetDisplayText` fold (`dsh-agent-presets/display`) over [`ui-agent-preset`](../ui-agent-preset/README.md)'s dictionaries: shipped presets follow the active locale while user-authored ones keep their own metadata, so an English surface never echoes the preset files' Chinese names. Search filters both groups by module name and entry id.
 
 ### The preset switcher
 
@@ -39,6 +41,8 @@ The switcher is the same selector-pill-plus-menu control the General settings ro
 
 A failed read renders a generic failure state inside the tab; retrying re-runs the lazy `list()` call without exposing transport details.
 
+The Plugin list also shows synchronization failures on the current page. Its retry reapplies the latest client graph without changing Host enablement or refreshing the page.
+
 -----
 
 <a id="understand-the-implementation"></a>

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-**插件列表**标签页让 Web 用户查看插件，而不改变其配置。它优先展示 agent（智能体）预设，并让全局清单保持收起，仅在需要时展开。卡片保留包名作为主标题，以稳定的条目 id 标识实例，并展示启停状态、出处、运行状态、禁用条件与发现失败；由预设提供的全局条目会列出对应预设。搜索覆盖两个分组，并指出其他预设中的匹配。标签页处理加载、空结果、无匹配、失败与重试状态，且不暴露传输细节；没有预设 roster 时仍会展示全局清单。
+**插件列表**标签页让 Web 用户查看插件，而不改变其配置。它先列 agent（智能体）预设分组，再列全局清单；两个分组默认都收起，按需展开，搜索期间保持展开。卡片保留包名作为主标题，以稳定的条目 id 标识实例，并展示启停状态、出处、运行状态、禁用条件与发现失败；由预设提供的全局条目会列出对应预设。搜索覆盖两个分组，并指出其他预设中的匹配。标签页处理加载、空结果、无匹配、失败与重试状态，且不暴露传输细节；没有预设 roster 时仍会展示全局清单。
 
 ## 目录
 
@@ -27,9 +27,11 @@ kind: "package-reference"
 
 打开设置中的「插件」分区并选择**插件列表**标签页，即可查看宿主的插件清单。插件激活期间不会读取 Remote——首次选择该标签页时才挂载组件，并通过 `api-remotes` 懒调用 `ctx.remote.pluginInventory.list()`。
 
+安装失败且存在待审批的 pnpm 构建权限时，页面提供“允许这些脚本并重试”。该操作展示准确包名和持久授权范围，再使用原来的包规格及启用选项重试。一次点击批准整个列表，其中可能包括此前安装留下的待审批包。关闭页面不会授予权限。
+
 ### 阅读卡片
 
-每张收起的卡片使用模块短名称作为主标题，在下方显示稳定的条目 id，并以小标签表示启停状态；已启用的条目还会显示彩色根 fiber 状态圆点。组合生成的次标题省略开头的 `include:` 标记；悬停、搜索、无障碍名称与展开详情仍保留完整 id。长条目 id 会在行内截断，悬停时仍可查看完整值。展开卡片后会显示声明的条目 id、完整模块标识与状态事实：预设行说明它来自哪个预设、组合存活时的运行状态，以及它携带的禁用条件；被预设提供的全局行说明它由 Agent 预设按会话提供、列出启用它的预设，并提供跳转到预设组的入口。预设名经共享的 `presetDisplayText` 纯函数（`dsh-agent-presets/display`）叠在 [`ui-agent-preset`](../ui-agent-preset/README.zh.md) 的字典上解析：内置预设走当前语言，用户自建预设保留自己的元数据，因此英文界面不会回显预设文件里的中文名。搜索按模块名称与条目 id 过滤两组。
+每张收起的卡片使用模块短名称作为主标题，在下方显示稳定的条目 id，并以小标签表示启停状态；彩色根 fiber 状态圆点只标记标签无法表达的 `pending`、`loading`、`unloading` 阶段，`active` 的条目只显示标签。组合生成的次标题省略开头的 `include:` 标记；悬停、搜索、无障碍名称与展开详情仍保留完整 id。长条目 id 会在行内截断，悬停时仍可查看完整值。展开卡片后会显示声明的条目 id、完整模块标识与状态事实：预设行说明它来自哪个预设、组合存活时的运行状态，以及它携带的禁用条件；被预设提供的全局行说明它由 Agent 预设按会话提供、列出启用它的预设，并提供跳转到预设组的入口。预设名经共享的 `presetDisplayText` 纯函数（`dsh-agent-presets/display`）叠在 [`ui-agent-preset`](../ui-agent-preset/README.zh.md) 的字典上解析：内置预设走当前语言，用户自建预设保留自己的元数据，因此英文界面不会回显预设文件里的中文名。搜索按模块名称与条目 id 过滤两组。
 
 ### 预设切换器
 
@@ -39,6 +41,8 @@ kind: "package-reference"
 
 读取失败会在标签页内渲染通用失败状态；重试会重新执行懒 `list()` 调用，且不会暴露传输细节。
 
+插件列表还显示当前页面的同步失败。重试会重新应用最新客户端图，不改变 Host 启用状态，也不刷新页面。
+
 -----
 
 <a id="understand-the-implementation"></a>

package/lib/client.js

@@ -185,11 +185,13 @@ window.__ModuleLoader__.load({
 		const PHASE_DOT_STATES = {
 			pending: "idle",
 			loading: "ongoing",
-			active: "done",
-			failed: "error",
 			unloading: "ongoing"
 		};
-		/** Status dot naming a live root-fiber phase; rows with no live fiber show none. */
+		/** Whether a live root-fiber phase carries a dot of its own. */
+		function showsPhaseDot(phase) {
+			return phase === "pending" || phase === "loading" || phase === "unloading";
+		}
+		/** Status dot naming a live root-fiber phase; rows without a dotted phase show none. */
 		function PhaseDot({ phase, t }) {
 			const status = phaseLabel(phase, t);
 			return (0, react_jsx_runtime.jsx)("span", {
@@ -215,7 +217,8 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/** Render the read-only plugin inventory: agent presets first, then the global plane. */
-		function PluginInventorySettingsTab({ list, presetName, t }) {
+		function PluginInventorySettingsTab({ list, presetName, t, useClientSync, retryClient }) {
+			const clientSync = useClientSync((snapshot) => snapshot);
 			const sectionId = (0, react.useId)();
 			const [request, setRequest] = (0, react.useState)(0);
 			const [query, setQuery] = (0, react.useState)("");
@@ -268,8 +271,8 @@ window.__ModuleLoader__.load({
 			const selectedRows = selected === void 0 ? [] : selected.rows.filter(rowMatch);
 			const otherPresetMatches = searching ? presets.filter((preset) => preset !== selected && preset.rows.some(rowMatch)) : [];
 			const otherMatchCount = otherPresetMatches.reduce((total, preset) => total + preset.rows.filter(rowMatch).length, 0);
-			const presetEffectiveOpen = searching || (presetOpen ?? true);
-			const globalEffectiveOpen = searching || (globalOpen ?? presets.length === 0);
+			const presetEffectiveOpen = searching || (presetOpen ?? false);
+			const globalEffectiveOpen = searching || (globalOpen ?? false);
 			const nothingMatches = searching && globalCount === 0 && selectedRows.length === 0 && otherPresetMatches.length === 0;
 			const retry = () => {
 				setState({ status: "loading" });
@@ -293,7 +296,7 @@ window.__ModuleLoader__.load({
 					expanded,
 					onToggle: toggleRow,
 					ariaLabel: `${title}${row.entryId === null ? "" : `, ${row.entryId}`}, ${stateText}`,
-					trailing: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [row.enabled === true && !failed && row.fiberPhase !== null ? (0, react_jsx_runtime.jsx)(PhaseDot, {
+					trailing: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [row.enabled === true && showsPhaseDot(row.fiberPhase) ? (0, react_jsx_runtime.jsx)(PhaseDot, {
 						phase: row.fiberPhase,
 						t
 					}) : null, (0, react_jsx_runtime.jsx)(StateTag, {
@@ -328,7 +331,7 @@ window.__ModuleLoader__.load({
 					expanded,
 					onToggle: toggleRow,
 					ariaLabel: `${title}, ${entry.entryId}, ${stateText}`,
-					trailing: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [entry.enabled && !failed && entry.fiberPhase !== null ? (0, react_jsx_runtime.jsx)(PhaseDot, {
+					trailing: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [entry.enabled && showsPhaseDot(entry.fiberPhase) ? (0, react_jsx_runtime.jsx)(PhaseDot, {
 						phase: entry.fiberPhase,
 						t
 					}) : null, (0, react_jsx_runtime.jsx)(StateTag, {
@@ -357,6 +360,32 @@ window.__ModuleLoader__.load({
 				className: PluginInventorySettingsTab_module_css_default.section,
 				"aria-busy": state.status === "loading",
 				children: [
+					clientSync.syncing ? (0, react_jsx_runtime.jsx)("p", {
+						className: PluginInventorySettingsTab_module_css_default.status,
+						role: "status",
+						children: t("clientSyncing")
+					}) : null,
+					clientSync.failures.length === 0 ? null : (0, react_jsx_runtime.jsxs)("div", {
+						className: PluginInventorySettingsTab_module_css_default.failure,
+						"data-client-sync-failure": true,
+						children: [
+							(0, react_jsx_runtime.jsx)("p", {
+								role: "alert",
+								children: t("clientSyncFailed")
+							}),
+							(0, react_jsx_runtime.jsx)("ul", { children: clientSync.failures.map((failure) => (0, react_jsx_runtime.jsxs)("li", { children: [
+								failure.id,
+								": ",
+								failure.message
+							] }, failure.id)) }),
+							(0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								disabled: clientSync.syncing,
+								onClick: retryClient,
+								children: t("clientSyncRetry")
+							})
+						]
+					}),
 					state.status === "loading" ? (0, react_jsx_runtime.jsx)("p", {
 						className: PluginInventorySettingsTab_module_css_default.status,
 						children: t("loading")
@@ -559,6 +588,9 @@ window.__ModuleLoader__.load({
 		const zh = {
 			tab: "插件列表",
 			loading: "正在读取插件…",
+			clientSyncing: "正在同步本页面的插件…",
+			clientSyncFailed: "本页面的插件未能完成同步；服务端的启用状态保持不变。",
+			clientSyncRetry: "重试本页面同步",
 			error: "暂时无法读取插件。",
 			retry: "重试",
 			search: "搜索插件",
@@ -598,6 +630,9 @@ window.__ModuleLoader__.load({
 		const en = {
 			tab: "Plugin list",
 			loading: "Reading plugins…",
+			clientSyncing: "Syncing plugins on this page…",
+			clientSyncFailed: "Some plugins could not sync on this page. Host enablement is unchanged.",
+			clientSyncRetry: "Retry this page",
 			error: "Plugins are temporarily unavailable.",
 			retry: "Retry",
 			search: "Search plugins",
@@ -643,7 +678,8 @@ window.__ModuleLoader__.load({
 			"slots",
 			"locale",
 			"remote",
-			"remote.pluginInventory"
+			"remote.pluginInventory",
+			"modules"
 		];
 		/** Contribute the lazy inventory tab to the Plugins settings section. */
 		function apply(ctx) {
@@ -661,7 +697,13 @@ window.__ModuleLoader__.load({
 			const presetName = (preset) => presetDisplayText(preset, agentPresetCopy).name;
 			const injected = () => ({
 				list,
-				presetName
+				presetName,
+				hooks: { clientSync: ctx.modules.entries.state },
+				retryClient: () => {
+					ctx.modules.entries.retry().catch((error) => {
+						ctx.logger.error(error);
+					});
+				}
 			});
 			ctx.slots.inject("settings.plugins.tab", () => ctx.slots.register({
 				name: "settings.plugins.tab",

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

@@ -1,9 +1,17 @@
 import { type ReactNode } from 'react';
+import type { ClientEntryState } from '@deepseek-ai/dsh-client-modules/client';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
 import type { PluginInventorySnapshot } from '@deepseek-ai/dsh-api-remotes/client';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 type AgentPresetGroup = NonNullable<PluginInventorySnapshot['agentPresets']>[number];
 /** Registration-side Remote face used by the section. */
 export interface PluginInventorySettingsTabInjected {
+    /** Page-local module synchronization, independent from the Host inventory. */
+    hooks: {
+        clientSync: ObservableSnapshot<ClientEntryState>;
+    };
+    /** Retry the latest client graph without changing the Host composition. */
+    retryClient: () => void;
     /** Read a current Host inventory snapshot. */
     list: () => Promise<PluginInventorySnapshot>;
     /**
@@ -15,6 +23,6 @@ export interface PluginInventorySettingsTabInjected {
 /** Full component props assembled by the Settings slot renderer. */
 export type PluginInventorySettingsTabProps = PropsRuntime<'settings.plugins.tab'> & PropsLocale<'settings.pluginInventory'> & InjectFace<PluginInventorySettingsTabInjected>;
 /** Render the read-only plugin inventory: agent presets first, then the global plane. */
-export declare function PluginInventorySettingsTab({ list, presetName, t }: PluginInventorySettingsTabProps): ReactNode;
+export declare function PluginInventorySettingsTab({ list, presetName, t, useClientSync, retryClient }: PluginInventorySettingsTabProps): ReactNode;
 export {};
 //# sourceMappingURL=PluginInventorySettingsTab.d.ts.map

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

@@ -3,6 +3,9 @@
 export declare const zh: {
     tab: string;
     loading: string;
+    clientSyncing: string;
+    clientSyncFailed: string;
+    clientSyncRetry: string;
     error: string;
     retry: string;
     search: string;
@@ -44,6 +47,9 @@ export type PluginInventoryLocaleKey = keyof typeof zh;
 export declare const en: {
     tab: string;
     loading: string;
+    clientSyncing: string;
+    clientSyncFailed: string;
+    clientSyncRetry: string;
     error: string;
     retry: string;
     search: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-settings-plugin-inventory",
   "description": "Read-only Cordis Loader inventory tab in Web Plugins settings",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -31,7 +31,8 @@
         "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-agent-preset"
+        "@deepseek-ai/dsh-client-ui-agent-preset",
+        "@deepseek-ai/dsh-client-modules"
       ],
       "platform": "web"
     }
@@ -45,16 +46,18 @@
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-agent-preset": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-agent-preset": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-modules": "^0.1.6-alpha.2"
   },
   "files": [
     "lib/index.js",