@deepseek-ai/dsh-host-plugin-inventory 0.1.6-alpha.1 → 0.1.7-alpha.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/host/plugin-inventory/README.md
-README.md: b64a017df28716cfd0b5c3a41f437b87b8e4f19e
-README.zh.md: a29bc402537d88fa512675bfb768502753ca7929
+README.md: 8450339c1430b2ed1620004343f75d9cc21a0a19
+README.zh.md: 345bf367ce9fe85fdfc80994a09e3b2f26fdc0ce

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-Clients can call `pluginInventory/list` to display the host’s current plugins in load order, including each entry’s identifier, module specifier, effective enablement, and live phase. Deployments with an agent-preset roster also report each preset’s metadata, health, and flattened plugin composition; without a roster, preset data is absent. Each response is a point-in-time, read-only snapshot for display and diagnostics: it cannot mutate plugins and provides no history, introduction source, or change subscription.
+Clients can call `pluginInventory/list` to display the host’s current plugins in load order, including each entry’s identifier, module specifier, effective enablement, live phase, and available display text. Deployments with an agent-preset roster also report each preset’s metadata, health, and flattened plugin composition; without a roster, preset data is absent. Each response is a point-in-time, read-only snapshot for display and diagnostics: it cannot mutate plugins and provides no history or change subscription.
 
 ## Table of Contents
 
@@ -31,6 +31,8 @@ Call `pluginInventory/list` when a client or settings page needs to show what is
 
 Each row is one non-group Loader entry: its entry id, the exact module specifier, the effective enablement (including disabled ancestor groups), and the current root Fiber phase. `pending` means the entry waits to load, `loading` that it is being read, `active` that it is running, `failed` that its fiber rejected, and `unloading` that it is being torn down; `null` means no live root Fiber exists at all. Structural group rows are skipped.
 
+Loader and preset rows can carry optional `meta` with a title, description, or metadata diagnostic. The Host returns available translations and literal fallbacks; the Client selects its language. Metadata diagnostics do not change enablement or fiber phase.
+
 ### Per-preset compositions
 
 With a roster composed, `agentPresets` carries one group per preset in roster order: its id, whether the deployment ships it or the user owns it (`trust`, which clients use to localize shipped names), published display name, whether a session naming no preset composes it, and flattened plugin rows — entry id (null when the file row declares none), module specifier, effective enablement, the row's own `!!js` disabled expression when it carries one, and a root-fiber phase when the composition is live. A preset some session already composed answers from its newest standing generation — even when its file has since broken, because the mount is what those sessions run; one never composed since boot answers from its composition file with disabled gates evaluated against the Loader context, and reading never mounts a preset. `conditional` enablement marks a gate the Host could not evaluate, and a broken preset nothing composed stays listed with its reason and no rows. Without a roster the field is absent.
@@ -49,7 +51,9 @@ The inventory is a snapshot for display and diagnostics: a client can render the
 
 ### Design concept
 
-The gateway is a direct projection with no second lifecycle truth: every `list()` call reads `ctx.loader.entries()` and maps each non-group entry to its public row. Cordis's internal `plugin/status` events already maintain `Entry.fiber` and `Fiber.state`, so a cache would only add another lifecycle truth to keep synchronized. The agent-preset roster is an optional peer resolved per call through `ctx.get('agentPresets')`: its `compositionInventory()` owns every preset read, and this package only maps root-fiber states onto the public phase vocabulary.
+The gateway is a direct projection with no second lifecycle truth: every `list()` call reads `ctx.loader.entries()` and maps each non-group entry to its public row. Cordis's internal `plugin/status` events already maintain `Entry.fiber` and `Fiber.state`, so a cache would only add another lifecycle truth to keep synchronized. The agent-preset roster is an optional peer resolved per call through `ctx.get('agentPresets')`: its `compositionInventory()` owns preset composition reads, and this package maps root-fiber states onto the public phases.
+
+Display metadata comes from the optional `pluginPackages` service using each Loader tree's resolution base, or the gateway context's base for preset rows. Without the service or the applicable base, `meta` is absent. Reading metadata does not load or activate plugins.
 
 ### The phase mapping
 
@@ -97,8 +101,8 @@ None; this package neither assembles nor sends a provider request.
 These limits define what a point-in-time inventory cannot tell a client. They are current package constraints, not a task backlog.
 
 - **Point-in-time state only** — the result contains no durable failure history or subscription; a missing root Fiber is reported as `null`, regardless of why no live root exists.
-- **No introduction source or mutation** — the service does not identify which bundle, profile, or override introduced an entry, and it cannot enable, disable, add, or remove plugins in either plane.
-- **Presets appear only with a roster** — a deployment without `dsh-agent-presets` serves Loader entries alone; the `agentPresets` field is absent rather than empty.
+- **No layer attribution or mutation** — the service does not identify which bundle, profile, or override introduced an entry, and it cannot enable, disable, add, or remove plugins in either plane.
+- **Presets appear only with a roster** — a deployment without `dsh-agent-preset-registry` serves Loader entries alone; the `agentPresets` field is absent rather than empty.
 
 <a id="dev-note"></a>
 ### Dev Note

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-客户端可以调用 `pluginInventory/list`，按加载顺序展示宿主的当前插件，包括每个条目的标识符、模块标识、有效启用状态与存活阶段。部署组合了 agent preset roster 时，还会报告各预设的元数据、健康状态与压平后的插件组合；没有 roster 时，预设数据缺席。每次响应都是供展示和诊断使用的只读即时快照：它不能修改插件，也不提供历史、来源信息或变更订阅。
+客户端可以调用 `pluginInventory/list`，按加载顺序展示宿主的当前插件，包括每个条目的标识符、模块标识、有效启用状态、存活阶段与可用的展示文本。部署组合了 agent preset roster 时，还会报告各预设的元数据、健康状态与压平后的插件组合；没有 roster 时，预设数据缺席。每次响应都是供展示和诊断使用的只读即时快照：它不能修改插件，也不提供历史或变更订阅。
 
 ## 目录
 
@@ -31,6 +31,8 @@ kind: "package-reference"
 
 每一行是一个非组 Loader 条目：其条目 id、精确模块标识、有效启用状态（含被禁用的祖先组）与当前根 Fiber 阶段。`pending` 表示条目等待加载，`loading` 表示正在读取，`active` 表示正在运行，`failed` 表示其 fiber 被拒绝，`unloading` 表示正在拆除；`null` 表示完全不存在存活的根 Fiber。结构性的 group 行会被跳过。
 
+Loader 行与预设行可以携带可选的 `meta`，其中包含标题、描述或元信息诊断。Host 返回可用翻译与字面回退文本，由 Client 选择语言。元信息诊断不改变启停状态或 fiber 阶段。
+
 ### 每个预设的组合
 
 组合了 roster 时，`agentPresets` 按 roster 顺序携带每个预设一组：其 id、随部署内置还是用户自建（`trust`，客户端据此本地化内置预设名）、发布的显示名、未指名预设的会话是否组合它，以及压平后的插件行——条目 id（文件行未声明时为 null）、模块标识、有效启用状态、行自带的 `!!js` disabled 表达式（如有），以及组合存活时的根 Fiber 阶段。已有会话组合过的预设由其最新仍存续的世代作答——即使其文件事后损坏也是如此，因为挂载才是这些会话实际运行的组合；开机以来从未被组合的预设由其组合文件作答，disabled 门用 Loader 上下文求值，且读取从不挂载预设。`conditional` 表示宿主无法求值的门；无人组合的坏预设保留在列表中，携带原因且没有行。没有 roster 时该字段缺席。
@@ -49,7 +51,9 @@ kind: "package-reference"
 
 ### 设计理念
 
-网关是一层没有第二个生命周期真源的直接投影：每次 `list()` 调用都读取 `ctx.loader.entries()`，并把每个非组条目映射为公共行。Cordis 内部的 `plugin/status` 事件已经维护了 `Entry.fiber` 与 `Fiber.state`，因此再加缓存只会多出一个需要同步的生命周期真源。agent preset roster 是每次调用经 `ctx.get('agentPresets')` 解析的可选伙伴：所有预设读取都由它的 `compositionInventory()` 负责，本包只把根 Fiber 状态映射到公共阶段词汇。
+网关是一层没有第二个生命周期真源的直接投影：每次 `list()` 调用都读取 `ctx.loader.entries()`，并把每个非组条目映射为公共行。Cordis 内部的 `plugin/status` 事件已经维护了 `Entry.fiber` 与 `Fiber.state`，因此再加缓存只会多出一个需要同步的生命周期真源。agent preset roster 是每次调用经 `ctx.get('agentPresets')` 解析的可选伙伴：预设组合读取由它的 `compositionInventory()` 负责，本包把根 Fiber 状态映射到公共阶段。
+
+展示元信息来自可选的 `pluginPackages` 服务：Loader 行使用其所属树的解析基准，预设行使用网关上下文的基准。服务或对应基准不存在时，`meta` 缺席。读取元信息不会加载或激活插件。
 
 ### 阶段映射
 
@@ -97,8 +101,8 @@ Typert 生成由 `./typert` 与 `./remote` 导出的 Host 和 Client Remote 产
 这些限制说明即时清单无法向客户端提供哪些信息。它们是当前包约束，不是任务积压。
 
 - **仅表示调用当下**——结果不包含持久的失败历史或订阅；只要不存在存活的根 Fiber，就会报告 `null`，而不区分其原因。
-- **无来源与修改能力**——服务不识别条目由哪个 bundle、profile 或 override 引入，也不能在任一平面启用、停用、添加或移除插件。
-- **预设仅随 roster 出现**——未装 `dsh-agent-presets` 的部署只提供 Loader 条目；`agentPresets` 字段缺席而非为空。
+- **不标识引入层，也不修改插件**——服务不识别条目由哪个 bundle、profile 或 override 引入，也不能在任一平面启用、停用、添加或移除插件。
+- **预设仅随 roster 出现**——未装 `dsh-agent-preset-registry` 的部署只提供 Loader 条目；`agentPresets` 字段缺席而非为空。
 
 <a id="dev-note"></a>
 ### 开发备注

package/lib/index.js

@@ -39,7 +39,11 @@ var __esDecorate = function(ctor, descriptorIn, decorators, contextIn, initializ
 	if (target) Object.defineProperty(target, contextIn.name, descriptor);
 	done = true;
 };
-/** Brand an existing Loader-tree entry id at the owning boundary. */
+/**
+* Brand an existing Loader-tree entry id at the owning boundary.
+* @param value - the entry id as the Loader tree spells it.
+* @returns the same id as the inventory's branded entry id.
+*/
 function pluginEntryId(value) {
 	return value;
 }
@@ -102,34 +106,54 @@ let PluginInventoryGateway = (() => {
 		* preset's composition rows, because those rows — not the Loader's own
 		* entries — are where a deployment that mounts the roster runs its
 		* model-facing plugins.
-		* @returns Current non-group Loader entries in Loader order, with per-preset
-		* compositions when a roster is composed.
+		* @returns Current non-group Loader entries in Loader order, with optional display metadata
+		* and per-preset compositions when a roster is composed.
 		*/
 		async list() {
-			const entries = [];
-			for (const entry of this.ctx.loader.entries()) {
-				if (entry.options.group) continue;
-				entries.push({
-					entryId: pluginEntryId(entry.id),
-					moduleName: entry.options.name,
-					enabled: !entry.disabled,
-					fiberPhase: entry.fiber === void 0 ? null : FIBER_PHASE[entry.fiber.state]
-				});
-			}
-			const presets = this.ctx.get("agentPresets");
-			if (presets === void 0) return { entries };
-			return {
-				entries,
-				agentPresets: (await presets.compositionInventory()).map((composition) => ({
-					...composition,
-					rows: composition.rows.map(({ fiberState, ...row }) => ({
-						...row,
-						fiberPhase: fiberState === void 0 ? null : FIBER_PHASE[fiberState]
-					}))
-				}))
-			};
+			return readPluginInventory(this.ctx);
 		}
 	};
 })();
+/** Read current Loader entries and optional preset compositions.
+* @param ctx Context with the Loader service.
+* @returns Current inventory with optional display metadata and no separate runtime cache.
+*/
+async function readPluginInventory(ctx) {
+	const entries = [];
+	const packages = ctx.get("pluginPackages");
+	for (const entry of ctx.loader.entries()) {
+		if (entry.options.group) continue;
+		const base = entry.parent.tree.ctx.baseUrl;
+		const meta = base === void 0 ? void 0 : packages?.metaOf(entry.options.name, base);
+		entries.push({
+			entryId: pluginEntryId(entry.id),
+			moduleName: entry.options.name,
+			enabled: !entry.disabled,
+			fiberPhase: entry.fiber === void 0 ? null : FIBER_PHASE[entry.fiber.state],
+			...meta === void 0 ? {} : { meta }
+		});
+	}
+	const presets = ctx.get("agentPresets");
+	const management = ctx.get("pluginManager") === void 0 ? {} : { managementAvailable: true };
+	if (presets === void 0) return {
+		entries,
+		...management
+	};
+	return {
+		entries,
+		agentPresets: (await presets.compositionInventory()).map((composition) => ({
+			...composition,
+			rows: composition.rows.map(({ fiberState, ...row }) => {
+				const meta = ctx.baseUrl === void 0 ? void 0 : packages?.metaOf(row.moduleName, ctx.baseUrl);
+				return {
+					...row,
+					fiberPhase: fiberState === void 0 ? null : FIBER_PHASE[fiberState],
+					...meta === void 0 ? {} : { meta }
+				};
+			})
+		})),
+		...management
+	};
+}
 //#endregion
-export { PluginInventoryGateway, PluginInventoryGateway as default };
+export { PluginInventoryGateway, PluginInventoryGateway as default, pluginEntryId, readPluginInventory };

package/lib/typert.host.js

@@ -1,28 +1,49 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
 import { z } from 'zod'
 
-const _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema = z.object({
+let _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema$value
+const _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema = () => (_deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema$value ??= z.object({
+  'managementAvailable': z.boolean().readonly().optional(),
   'entries': z.array(z.object({
   'entryId': z.intersection(z.string(), z.unknown()).readonly(),
   'moduleName': z.string().readonly(),
+  'meta': z.object({
+  'title': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly().optional(),
+  'description': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly().optional(),
+  'icon': z.string().readonly().optional(),
+  'error': z.string().readonly().optional(),
+}).readonly().optional(),
   'enabled': z.boolean().readonly(),
-  'fiberPhase': z.union([z.literal(null), z.literal("pending"), z.literal("active"), z.literal("failed"), z.literal("loading"), z.literal("unloading")]).readonly(),
+  'fiberPhase': z.union([z.literal(null), z.literal("failed"), z.literal("pending"), z.literal("active"), z.literal("loading"), z.literal("unloading")]).readonly(),
 })).readonly(),
   'agentPresets': z.array(z.object({
   'id': z.string().readonly(),
-  'trust': z.union([z.literal("system"), z.literal("user")]).readonly(),
   'name': z.string().readonly().optional(),
   'isDefault': z.boolean().readonly(),
   'broken': z.string().readonly().optional(),
   'rows': z.array(z.object({
   'entryId': z.union([z.literal(null), z.string()]).readonly(),
   'moduleName': z.string().readonly(),
+  'meta': z.object({
+  'title': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly().optional(),
+  'description': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly().optional(),
+  'icon': z.string().readonly().optional(),
+  'error': z.string().readonly().optional(),
+}).readonly().optional(),
   'enabled': z.union([z.literal(false), z.literal(true), z.literal("conditional")]).readonly(),
   'condition': z.string().readonly().optional(),
-  'fiberPhase': z.union([z.literal(null), z.literal("pending"), z.literal("active"), z.literal("failed"), z.literal("loading"), z.literal("unloading")]).readonly(),
+  'fiberPhase': z.union([z.literal(null), z.literal("failed"), z.literal("pending"), z.literal("active"), z.literal("loading"), z.literal("unloading")]).readonly(),
 })).readonly(),
 })).readonly().optional(),
-})
+}))
 
 export const TYPERT = {
   package: '@deepseek-ai/dsh-host-plugin-inventory',
@@ -41,9 +62,9 @@ export const TYPERT = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-host-plugin-inventory/types#PluginInventorySnapshot',
-        schema: _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema,
+        create: _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema,
       },
-      sourceLocation: {"file":"packages/host/plugin-inventory/src/index.ts","line":66,"column":9},
+      sourceLocation: {"file":"packages/host/plugin-inventory/src/index.ts","line":71,"column":9},
     },
   ],
   model: {

package/lib/typert.remote-client.js

@@ -1,28 +1,49 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import { z } from 'zod'
 
-const _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema = z.object({
+let _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema$value
+const _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema = () => (_deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema$value ??= z.object({
+  'managementAvailable': z.boolean().readonly().optional(),
   'entries': z.array(z.object({
   'entryId': z.intersection(z.string(), z.unknown()).readonly(),
   'moduleName': z.string().readonly(),
+  'meta': z.object({
+  'title': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly().optional(),
+  'description': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly().optional(),
+  'icon': z.string().readonly().optional(),
+  'error': z.string().readonly().optional(),
+}).readonly().optional(),
   'enabled': z.boolean().readonly(),
-  'fiberPhase': z.union([z.literal(null), z.literal("pending"), z.literal("active"), z.literal("failed"), z.literal("loading"), z.literal("unloading")]).readonly(),
+  'fiberPhase': z.union([z.literal(null), z.literal("failed"), z.literal("pending"), z.literal("active"), z.literal("loading"), z.literal("unloading")]).readonly(),
 })).readonly(),
   'agentPresets': z.array(z.object({
   'id': z.string().readonly(),
-  'trust': z.union([z.literal("system"), z.literal("user")]).readonly(),
   'name': z.string().readonly().optional(),
   'isDefault': z.boolean().readonly(),
   'broken': z.string().readonly().optional(),
   'rows': z.array(z.object({
   'entryId': z.union([z.literal(null), z.string()]).readonly(),
   'moduleName': z.string().readonly(),
+  'meta': z.object({
+  'title': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly().optional(),
+  'description': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly().optional(),
+  'icon': z.string().readonly().optional(),
+  'error': z.string().readonly().optional(),
+}).readonly().optional(),
   'enabled': z.union([z.literal(false), z.literal(true), z.literal("conditional")]).readonly(),
   'condition': z.string().readonly().optional(),
-  'fiberPhase': z.union([z.literal(null), z.literal("pending"), z.literal("active"), z.literal("failed"), z.literal("loading"), z.literal("unloading")]).readonly(),
+  'fiberPhase': z.union([z.literal(null), z.literal("failed"), z.literal("pending"), z.literal("active"), z.literal("loading"), z.literal("unloading")]).readonly(),
 })).readonly(),
 })).readonly().optional(),
-})
+}))
 
 export const TYPERT_REMOTE = {
   package: '@deepseek-ai/dsh-host-plugin-inventory',
@@ -38,9 +59,9 @@ export const TYPERT_REMOTE = {
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-host-plugin-inventory/types#PluginInventorySnapshot',
-        schema: _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema,
+        create: _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema,
       },
-      sourceLocation: {"file":"packages/host/plugin-inventory/src/index.ts","line":66,"column":9},
+      sourceLocation: {"file":"packages/host/plugin-inventory/src/index.ts","line":71,"column":9},
     },
   ],
 }

package/lib/types/index.d.ts

@@ -1,8 +1,14 @@
 /** Read-only projection of the current Cordis Loader plugin entries. */
 import type { Context } from '@deepseek-ai/cordis';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-import type { PluginInventorySnapshot } from './types.ts';
+import type { PluginEntryId, PluginInventorySnapshot } from './types.ts';
 export type * from './types.ts';
+/**
+ * Brand an existing Loader-tree entry id at the owning boundary.
+ * @param value - the entry id as the Loader tree spells it.
+ * @returns the same id as the inventory's branded entry id.
+ */
+export declare function pluginEntryId(value: string): PluginEntryId;
 /** Remote-only service exposing the Loader's current non-group entry state. */
 export declare class PluginInventoryGateway extends TypertRemoteService {
     static inject: string[];
@@ -16,10 +22,15 @@ export declare class PluginInventoryGateway extends TypertRemoteService {
      * preset's composition rows, because those rows — not the Loader's own
      * entries — are where a deployment that mounts the roster runs its
      * model-facing plugins.
-     * @returns Current non-group Loader entries in Loader order, with per-preset
-     * compositions when a roster is composed.
+     * @returns Current non-group Loader entries in Loader order, with optional display metadata
+     * and per-preset compositions when a roster is composed.
      */
     list(): Promise<PluginInventorySnapshot>;
 }
 export default PluginInventoryGateway;
+/** Read current Loader entries and optional preset compositions.
+ * @param ctx Context with the Loader service.
+ * @returns Current inventory with optional display metadata and no separate runtime cache.
+ */
+export declare function readPluginInventory(ctx: Context): Promise<PluginInventorySnapshot>;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -34,8 +34,12 @@ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn,
     done = true;
 };
 import { TypertRemoteService, Remote } from '@deepseek-ai/dsh-typert-protocol';
-/** Brand an existing Loader-tree entry id at the owning boundary. */
-function pluginEntryId(value) {
+/**
+ * Brand an existing Loader-tree entry id at the owning boundary.
+ * @param value - the entry id as the Loader tree spells it.
+ * @returns the same id as the inventory's branded entry id.
+ */
+export function pluginEntryId(value) {
     return value;
 }
 /** Runtime mirror: FiberState is a cross-package const enum. */
@@ -82,35 +86,51 @@ let PluginInventoryGateway = (() => {
          * preset's composition rows, because those rows — not the Loader's own
          * entries — are where a deployment that mounts the roster runs its
          * model-facing plugins.
-         * @returns Current non-group Loader entries in Loader order, with per-preset
-         * compositions when a roster is composed.
+         * @returns Current non-group Loader entries in Loader order, with optional display metadata
+         * and per-preset compositions when a roster is composed.
          */
         async list() {
-            const entries = [];
-            for (const entry of this.ctx.loader.entries()) {
-                if (entry.options.group)
-                    continue;
-                entries.push({
-                    entryId: pluginEntryId(entry.id),
-                    moduleName: entry.options.name,
-                    enabled: !entry.disabled,
-                    fiberPhase: entry.fiber === undefined ? null : FIBER_PHASE[entry.fiber.state],
-                });
-            }
-            const presets = this.ctx.get('agentPresets');
-            if (presets === undefined)
-                return { entries };
-            const agentPresets = (await presets.compositionInventory()).map(composition => ({
-                ...composition,
-                rows: composition.rows.map(({ fiberState, ...row }) => ({
-                    ...row,
-                    fiberPhase: fiberState === undefined ? null : FIBER_PHASE[fiberState],
-                })),
-            }));
-            return { entries, agentPresets };
+            return readPluginInventory(this.ctx);
         }
     };
 })();
 export { PluginInventoryGateway };
 export default PluginInventoryGateway;
+/** Read current Loader entries and optional preset compositions.
+ * @param ctx Context with the Loader service.
+ * @returns Current inventory with optional display metadata and no separate runtime cache.
+ */
+export async function readPluginInventory(ctx) {
+    const entries = [];
+    const packages = ctx.get('pluginPackages');
+    for (const entry of ctx.loader.entries()) {
+        if (entry.options.group)
+            continue;
+        const base = entry.parent.tree.ctx.baseUrl;
+        const meta = base === undefined ? undefined : packages?.metaOf(entry.options.name, base);
+        entries.push({
+            entryId: pluginEntryId(entry.id),
+            moduleName: entry.options.name,
+            enabled: !entry.disabled,
+            fiberPhase: entry.fiber === undefined ? null : FIBER_PHASE[entry.fiber.state],
+            ...meta === undefined ? {} : { meta },
+        });
+    }
+    const presets = ctx.get('agentPresets');
+    const management = ctx.get('pluginManager') === undefined ? {} : { managementAvailable: true };
+    if (presets === undefined)
+        return { entries, ...management };
+    const agentPresets = (await presets.compositionInventory()).map(composition => ({
+        ...composition,
+        rows: composition.rows.map(({ fiberState, ...row }) => {
+            const meta = ctx.baseUrl === undefined ? undefined : packages?.metaOf(row.moduleName, ctx.baseUrl);
+            return {
+                ...row,
+                fiberPhase: fiberState === undefined ? null : FIBER_PHASE[fiberState],
+                ...meta === undefined ? {} : { meta },
+            };
+        }),
+    }));
+    return { entries, agentPresets, ...management };
+}
 //# sourceMappingURL=index.js.map

package/lib/types/types.d.ts

@@ -1,4 +1,5 @@
 import type { Branded } from '@deepseek-ai/dsh-brand';
+import type { PluginLocalizedMeta } from '@deepseek-ai/dsh-package-manifest';
 /** Stable Loader-tree identity of one configured plugin entry. */
 export type PluginEntryId = Branded<'PluginEntryId'>;
 /** Lifecycle state of an entry's root Fiber, or null when it has no live root Fiber. */
@@ -8,6 +9,8 @@ export interface PluginInventoryEntry {
     readonly entryId: PluginEntryId;
     /** Exact module specifier imported by the Loader entry. */
     readonly moduleName: string;
+    /** Local package display metadata, independent of whether the entry is enabled. */
+    readonly meta?: PluginLocalizedMeta;
     /** Effective Loader enablement, including disabled ancestor groups. */
     readonly enabled: boolean;
     readonly fiberPhase: PluginFiberPhase;
@@ -20,6 +23,8 @@ export interface AgentPresetPluginRow {
     readonly entryId: string | null;
     /** Module specifier the row names. */
     readonly moduleName: string;
+    /** Local package display metadata, independent of whether the preset is mounted. */
+    readonly meta?: PluginLocalizedMeta;
     /**
      * Effective enablement, including disabled ancestor groups. `'conditional'`
      * marks a `!!js` disabled expression on a composition no session has
@@ -35,8 +40,6 @@ export interface AgentPresetPluginRow {
 export interface AgentPresetPluginGroup {
     /** Stable preset id. */
     readonly id: string;
-    /** Whether the deployment ships the preset or the user owns it. */
-    readonly trust: 'system' | 'user';
     /** Display name the preset published; a reader falls back to the id. */
     readonly name?: string;
     /** Whether a session naming no preset composes this one. */
@@ -48,6 +51,8 @@ export interface AgentPresetPluginGroup {
 }
 /** Point-in-time inventory returned by the plugin inventory Remote. */
 export interface PluginInventorySnapshot {
+    /** Whether this Host exposes persistent current-profile management. */
+    readonly managementAvailable?: boolean;
     readonly entries: readonly PluginInventoryEntry[];
     /**
      * Per-preset compositions, present only when an agent-preset roster is

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-host-plugin-inventory",
   "description": "Read-only Remote projection of current Cordis Loader plugin state",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.7-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -47,22 +47,24 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.4",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-brand": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.3"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/dsh-agent-presets": {
+    "@deepseek-ai/dsh-agent-preset-registry": {
       "optional": true
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/dsh-app-boot": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-package-manifest": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.4",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-brand": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.3"
   }
 }