@deepseek-ai/dsh-host-plugin-inventory 0.1.1-rc.2 → 0.1.2-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/host/plugin-inventory/README.md
-README.md: a91c02df5e7a57db89c9a63af6c4355573b843da
-README.zh.md: 786dfa8261c25bb838f6b8df88ae388bf78d764c
+README.md: f8be329198fd1ffe078b4f821ffc568700ec3f19
+README.zh.md: 8291a1cb4b27cce9efad22a85eaaaf0dadea10dc

package/README.md

@@ -1,22 +1,111 @@
+---
+description: "Read-only projection of the current Cordis Loader plugin state with each agent preset's composition beside it: the pluginInventory service and its pluginInventory/list Remote for web GUI host clients."
+kind: "package-reference"
+---
+
 # @deepseek-ai/dsh-host-plugin-inventory
 
 English | [中文](README.zh.md)
 
-Read-only Host projection of the current Cordis Loader tree. `PluginInventoryGateway` registers the `pluginInventory` service and publishes one generated direct Remote, `pluginInventory/list`. Every call reads `ctx.loader.entries()` directly, skips structural group rows, and returns the remaining entries in Loader order with only their Loader entry id, module specifier, effective enablement, and current root Fiber phase.
+## Summary
+
+Clients and settings pages can show what is currently composed in the host: calling `pluginInventory/list` returns the current non-group Loader entries in Loader order — entry id, module specifier, effective enablement, and root Fiber phase (`pending`, `loading`, `active`, `failed`, or `unloading`, or `null` when an entry has no live root Fiber). When an agent-preset roster is composed, the snapshot also carries one group per preset — id, trust, display name, default marking, health, and flattened composition rows — because a deployment that mounts the roster runs its model-facing plugins there rather than on the Loader's own entries. The snapshot is point-in-time: the Loader is the sole lifecycle authority, and this package owns no cache, history, provenance model, event stream, or mutation path. Client packages consume the Remote through the explicit [`api-remotes`](../../api/remotes/README.md) assembly rather than importing the Host implementation.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## Use this package
+
+Call `pluginInventory/list` when a client or settings page needs to show what is currently composed in the host — which plugins are loaded, enabled, and alive, and what each agent preset would give a session. The Remote is the only entry point: the service is Remote-only and deliberately declares no same-process Cordis `Context` merge.
+
+### What a snapshot contains
+
+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.
+
+### 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.
+
+### What you can and cannot do with it
+
+The inventory is a snapshot for display and diagnostics: a client can render the roster, flag failed entries, and detect changes by comparing snapshots. It cannot enable, disable, add, or remove plugins, and it carries no history — a fiber that already failed and was removed is absent. Because the service reads the Loader on every call, the answer always reflects the current composition rather than a cached view.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Implementation internals — click to expand</summary>
+
+### Design concept
 
-The phase is `pending`, `loading`, `active`, `failed`, or `unloading`; it is `null` when the entry has no live root Fiber. The snapshot is intentionally point-in-time: Loader remains the sole lifecycle authority, while this package owns no cache, history, provenance model, event stream, or mutation path. Its public payload types live under `./types`, and Typert generates the Host and Client Remote artifacts exposed by `./typert` and `./remote`.
+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 service is Remote-only and deliberately declares no same-process Cordis `Context` merge. Client packages consume it through the explicit [`api-remotes`](../../api/remotes/README.md) assembly rather than importing the Host implementation.
+### The phase mapping
 
+Fiber states map onto the public phase vocabulary, with `disposed` folding into `null` — an entry whose fiber is gone has no live root to report. The phase therefore never distinguishes why no live root exists: the entry may never have started, or its fiber may already have been disposed.
+
+### Source map
+
+| File | Role |
+|---|---|
+| [`src/index.ts`](src/index.ts) | `PluginInventoryGateway`: the `pluginInventory` Remote service and the Loader projection |
+| [`src/types.ts`](src/types.ts) | Public payload types: `PluginInventoryEntry`, `PluginInventorySnapshot`, `PluginFiberPhase` |
+| [`src/invariant.ts`](src/invariant.ts) | Invariant companion (no runtime invariant; every snapshot projects Loader-owned state) |
+
+Typert generates the Host and Client Remote artifacts exposed by `./typert` and `./remote`.
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+Read these when the inventory contract is not enough: how the Remote reaches clients, then the Loader it projects and the surface that renders it.
+
+- [Remote assembly](../../api/remotes/README.md) — how clients consume `pluginInventory/list` without importing the Host implementation.
+- [Cordis plugin loader](../../../vendor/loader/README.md) — the Loader whose entries this package projects.
+- [Plugin inventory settings surface](../../client/ui-settings-plugin-inventory/README.md) — the browser-side projection that renders the inventory.
+
+-----
+
+<a id="model-experience"></a>
 ## Model Experience
 
-None, as this Host-only inventory projection registers no prompt, tool, message, or provider request.
+None, as the host-side read-only Loader projection registers nothing model-facing.
 
 #### KV Cache effect
 
-None; this package never assembles model input.
+None; this package neither assembles nor sends a provider request.
 
 ## Known Limitations and Deferred Work
 
+<a id="known-limitations-and-deferred-work"></a>
+
+
+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 provenance or mutation** — the service does not identify which bundle, profile, or override introduced an entry, and it cannot enable, disable, add, or remove plugins.
+- **No provenance 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.
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -1,22 +1,111 @@
+---
+description: "当前 Cordis Loader 插件状态的只读投影，并附带每个 Agent 预设的组合：面向 web GUI 宿主客户端的 pluginInventory 服务及其 pluginInventory/list Remote。"
+kind: "package-reference"
+---
+
 # @deepseek-ai/dsh-host-plugin-inventory
 
 [English](README.md) | 中文
 
-当前 Cordis Loader 树的只读 Host 投影。`PluginInventoryGateway` 注册 `pluginInventory` 服务，并发布一个由 Typert 生成的直接 Remote：`pluginInventory/list`。每次调用都直接读取 `ctx.loader.entries()`，跳过结构性的 group 行，再按 Loader 顺序返回其余条目，并且只包含 Loader 条目 id、模块标识、有效启用状态与当前根 Fiber 阶段。
+## 概述
+
+客户端与设置页可以展示宿主当前组合了什么：调用 `pluginInventory/list` 即按 Loader 顺序返回当前的非组条目——条目 id、模块标识、有效启用状态与根 Fiber 阶段（`pending`、`loading`、`active`、`failed` 或 `unloading`；条目没有存活根 Fiber 时为 `null`）。当部署组合了 Agent 预设 roster 时，快照还携带每个预设一组——id、trust、显示名、默认标记、健康状态与压平后的组合行——因为挂载 roster 的部署把模型侧插件运行在预设组合里，而不是 Loader 自己的条目上。该快照只表示调用当下：Loader 是唯一的生命周期权威，本包不拥有缓存、历史、来源模型、事件流或修改路径。Client 包通过显式的 [`api-remotes`](../../api/remotes/README.zh.md) 组合消费这个 Remote，而不导入 Host 实现。
+
+## 目录
+
+- [使用本包](#use-this-package)
+- [理解实现](#understand-the-implementation)
+- [进一步探索](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用本包
+
+当客户端或设置页需要展示宿主当前组合了什么——哪些插件已加载、已启用、是否存活，以及每个 Agent 预设会给会话什么——时调用 `pluginInventory/list`。Remote 是唯一入口：该服务仅供 Remote 使用，刻意不声明同进程 Cordis `Context` merge。
+
+### 快照包含什么
+
+每一行是一个非组 Loader 条目：其条目 id、精确模块标识、有效启用状态（含被禁用的祖先组）与当前根 Fiber 阶段。`pending` 表示条目等待加载，`loading` 表示正在读取，`active` 表示正在运行，`failed` 表示其 fiber 被拒绝，`unloading` 表示正在拆除；`null` 表示完全不存在存活的根 Fiber。结构性的 group 行会被跳过。
+
+### 每个预设的组合
+
+组合了 roster 时，`agentPresets` 按 roster 顺序携带每个预设一组：其 id、随部署内置还是用户自建（`trust`，客户端据此本地化内置预设名）、发布的显示名、未指名预设的会话是否组合它，以及压平后的插件行——条目 id（文件行未声明时为 null）、模块标识、有效启用状态、行自带的 `!!js` disabled 表达式（如有），以及组合存活时的根 Fiber 阶段。已有会话组合过的预设由其最新 standing 世代作答——即使其文件事后损坏也是如此，因为挂载才是这些会话实际运行的组合；开机以来从未被组合的预设由其组合文件作答，disabled 门用 Loader 上下文求值，且读取从不挂载预设。`conditional` 表示宿主无法求值的门；无人组合的坏预设保留在列表中，携带原因且没有行。没有 roster 时该字段缺席。
+
+### 你能用它做什么、不能做什么
+
+该清单是供展示与诊断的快照：客户端可以渲染名单、标出失败条目，并通过比较快照检测变化。它不能启用、停用、添加或移除插件，也不携带历史——已经失败并被移除的 fiber 缺席。由于服务每次调用都读取 Loader，答案总是反映当前组合，而不是缓存视图。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 理解实现
+
+<details>
+<summary>实现细节——点击展开</summary>
+
+### 设计理念
 
-阶段为 `pending`、`loading`、`active`、`failed` 或 `unloading`；条目没有存活的根 Fiber 时则为 `null`。该快照刻意只表示调用当下：Loader 仍是唯一的生命周期权威，本包不拥有缓存、历史、来源模型、事件流或修改路径。公开 payload 类型位于 `./types`，Typert 生成由 `./typert` 与 `./remote` 导出的 Host 和 Client Remote 产物。
+网关是一层没有第二个生命周期真源的直接投影：每次 `list()` 调用都读取 `ctx.loader.entries()`，并把每个非组条目映射为公共行。Cordis 内部的 plugin/status 事件已经维护了 `Entry.fiber` 与 `Fiber.state`，因此再加缓存只会多出一个需要同步的生命周期真源。Agent 预设 roster 是每次调用经 `ctx.get('agentPresets')` 解析的可选伙伴：所有预设读取都由它的 `compositionInventory()` 负责，本包只把根 Fiber 状态映射到公共阶段词汇。
 
-该服务仅供 Remote 使用，刻意不声明同进程 Cordis `Context` merge。Client 包通过显式的 [`api-remotes`](../../api/remotes/README.zh.md) 组合消费它，而不导入 Host 实现。
+### 阶段映射
 
+Fiber 状态映射到公共阶段词汇，其中 `disposed` 折叠为 `null`——fiber 已消失的条目没有可报告的存活根。因此阶段从不区分为什么没有存活根：条目可能从未启动，也可能其 fiber 已被释放。
+
+### 源码地图
+
+| 文件 | 职责 |
+|---|---|
+| [`src/index.ts`](src/index.ts) | `PluginInventoryGateway`：`pluginInventory` Remote 服务与 Loader 投影 |
+| [`src/types.ts`](src/types.ts) | 公共 payload 类型：`PluginInventoryEntry`、`PluginInventorySnapshot`、`PluginFiberPhase` |
+| [`src/invariant.ts`](src/invariant.ts) | 不变式伴生插件（无运行时不变式；每个快照都投影 Loader 持有的状态） |
+
+Typert 生成由 `./typert` 与 `./remote` 导出的 Host 和 Client Remote 产物。
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 进一步探索
+
+当清单约定不够用时阅读以下内容：先看 Remote 如何到达客户端，再看它所投影的 Loader 与渲染它的界面。
+
+- [Remote 组合](../../api/remotes/README.zh.md)——客户端如何在不导入 Host 实现的情况下消费 `pluginInventory/list`。
+- [Cordis 插件 loader](../../../vendor/loader/README.md)——本包所投影条目的那个 Loader。
+- [插件清单设置界面](../../client/ui-settings-plugin-inventory/README.zh.md)——渲染该清单的浏览器侧投影。
+
+-----
+
+<a id="model-experience"></a>
 ## 模型体验
 
-无，因为这个仅限 Host 的清单投影不注册提示词、工具、消息或提供方请求。
+无。这个仅限 Host 的只读 Loader 投影不注册任何面向模型的内容。
 
 #### KV Cache 影响
 
-无；本包从不组装模型输入。
+无；该包既不组装也不发送提供方请求。
+
+## 已知限制与延期工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+
+这些限制说明一个点时刻清单无法告诉客户端什么。它们是当前包约束，不是任务积压。
+
+- **仅表示调用当下**——结果不包含持久的失败历史或订阅；只要不存在存活的根 Fiber，就会报告 `null`，而不区分其原因。
+- **无来源与修改能力**——服务不识别条目由哪个 bundle、profile 或 override 引入，也不能在任一平面启用、停用、添加或移除插件。
+- **预设仅随 roster 出现**——未装 `dsh-agent-presets` 的部署只提供 Loader 条目；`agentPresets` 字段缺席而非为空。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者的工作上下文——点击展开</summary>
 
-## 已知限制与暂缓事项
+无。
 
-- **仅表示调用当下** —— 结果不包含持久的失败历史或订阅；只要不存在存活的根 Fiber，就会报告 `null`，而不区分其原因。
-- **无来源与修改能力** —— 服务不识别条目由哪个 bundle、profile 或 override 引入，也不能启用、停用、添加或移除插件。
+</details>

package/lib/index.js

@@ -97,9 +97,15 @@ let PluginInventoryGateway = (() => {
 		* Read the Loader directly on every call. Cordis's internal plugin/status
 		* events already maintain Entry.fiber and Fiber.state, so a second cache
 		* would only add another lifecycle truth to keep synchronized.
-		* @returns Current non-group Loader entries in Loader order.
+		*
+		* When an agent-preset roster is composed, the snapshot also carries each
+		* 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.
 		*/
-		list() {
+		async list() {
 			const entries = [];
 			for (const entry of this.ctx.loader.entries()) {
 				if (entry.options.group) continue;
@@ -110,7 +116,18 @@ let PluginInventoryGateway = (() => {
 					fiberPhase: entry.fiber === void 0 ? null : FIBER_PHASE[entry.fiber.state]
 				});
 			}
-			return { entries };
+			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]
+					}))
+				}))
+			};
 		}
 	};
 })();

package/lib/typert.host.js

@@ -6,8 +6,22 @@ const _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema
   'entryId': z.intersection(z.string(), z.unknown()).readonly(),
   'moduleName': z.string().readonly(),
   'enabled': z.boolean().readonly(),
-  'fiberPhase': z.union([z.literal(null), z.literal("failed"), z.literal("pending"), z.literal("active"), z.literal("loading"), z.literal("unloading")]).readonly(),
+  'fiberPhase': z.union([z.literal(null), z.literal("pending"), z.literal("active"), z.literal("failed"), 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(),
+  '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(),
+})).readonly(),
+})).readonly().optional(),
 })
 
 export const TYPERT = {
@@ -29,7 +43,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-host-plugin-inventory/types#PluginInventorySnapshot',
         schema: _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema,
       },
-      sourceLocation: {"file":"packages/host/plugin-inventory/src/index.ts","line":57,"column":3},
+      sourceLocation: {"file":"packages/host/plugin-inventory/src/index.ts","line":66,"column":9},
     },
   ],
   model: {

package/lib/typert.remote-client.js

@@ -6,8 +6,22 @@ const _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema
   'entryId': z.intersection(z.string(), z.unknown()).readonly(),
   'moduleName': z.string().readonly(),
   'enabled': z.boolean().readonly(),
-  'fiberPhase': z.union([z.literal(null), z.literal("failed"), z.literal("pending"), z.literal("active"), z.literal("loading"), z.literal("unloading")]).readonly(),
+  'fiberPhase': z.union([z.literal(null), z.literal("pending"), z.literal("active"), z.literal("failed"), 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(),
+  '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(),
+})).readonly(),
+})).readonly().optional(),
 })
 
 export const TYPERT_REMOTE = {
@@ -26,7 +40,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-host-plugin-inventory/types#PluginInventorySnapshot',
         schema: _deepseek_ai_dsh_host_plugin_inventory_pluginInventory_list_result$schema,
       },
-      sourceLocation: {"file":"packages/host/plugin-inventory/src/index.ts","line":57,"column":3},
+      sourceLocation: {"file":"packages/host/plugin-inventory/src/index.ts","line":66,"column":9},
     },
   ],
 }

package/lib/types/index.d.ts

@@ -11,9 +11,15 @@ export declare class PluginInventoryGateway extends TypertRemoteService {
      * Read the Loader directly on every call. Cordis's internal plugin/status
      * events already maintain Entry.fiber and Fiber.state, so a second cache
      * would only add another lifecycle truth to keep synchronized.
-     * @returns Current non-group Loader entries in Loader order.
+     *
+     * When an agent-preset roster is composed, the snapshot also carries each
+     * 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.
      */
-    list(): PluginInventorySnapshot;
+    list(): Promise<PluginInventorySnapshot>;
 }
 export default PluginInventoryGateway;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -77,9 +77,15 @@ let PluginInventoryGateway = (() => {
          * Read the Loader directly on every call. Cordis's internal plugin/status
          * events already maintain Entry.fiber and Fiber.state, so a second cache
          * would only add another lifecycle truth to keep synchronized.
-         * @returns Current non-group Loader entries in Loader order.
+         *
+         * When an agent-preset roster is composed, the snapshot also carries each
+         * 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.
          */
-        list() {
+        async list() {
             const entries = [];
             for (const entry of this.ctx.loader.entries()) {
                 if (entry.options.group)
@@ -91,7 +97,17 @@ let PluginInventoryGateway = (() => {
                     fiberPhase: entry.fiber === undefined ? null : FIBER_PHASE[entry.fiber.state],
                 });
             }
-            return { entries };
+            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 };
         }
     };
 })();

package/lib/types/types.d.ts

@@ -12,8 +12,47 @@ export interface PluginInventoryEntry {
     readonly enabled: boolean;
     readonly fiberPhase: PluginFiberPhase;
 }
+/** Effective enablement of one preset composition row. */
+export type PresetPluginEnablement = boolean | 'conditional';
+/** One plugin row an agent preset's composition names. */
+export interface AgentPresetPluginRow {
+    /** Composition row id, or null when the row declares none. */
+    readonly entryId: string | null;
+    /** Module specifier the row names. */
+    readonly moduleName: string;
+    /**
+     * Effective enablement, including disabled ancestor groups. `'conditional'`
+     * marks a `!!js` disabled expression on a composition no session has
+     * mounted, which only a Loader context can decide.
+     */
+    readonly enabled: PresetPluginEnablement;
+    /** The row's own `!!js` disabled expression, when it carries one. */
+    readonly condition?: string;
+    /** Root-fiber phase when the composition is live; null otherwise. */
+    readonly fiberPhase: PluginFiberPhase;
+}
+/** One agent preset's identity and flattened composition in the inventory. */
+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. */
+    readonly isDefault: boolean;
+    /** Why this preset's composition cannot be read; absent when rows answer. */
+    readonly broken?: string;
+    /** Plugin rows in composition order; empty when the preset is broken. */
+    readonly rows: readonly AgentPresetPluginRow[];
+}
 /** Point-in-time inventory returned by the plugin inventory Remote. */
 export interface PluginInventorySnapshot {
     readonly entries: readonly PluginInventoryEntry[];
+    /**
+     * Per-preset compositions, present only when an agent-preset roster is
+     * composed in this deployment.
+     */
+    readonly agentPresets?: readonly AgentPresetPluginGroup[];
 }
 //# sourceMappingURL=types.d.ts.map

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.1-rc.2",
+  "version": "0.1.2-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -52,17 +52,24 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.2",
-    "@deepseek-ai/dsh-brand": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.1-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2",
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-agent-presets": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.2",
-    "@deepseek-ai/dsh-brand": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.1-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2",
+    "@deepseek-ai/cordis": "^4.0.2"
   }
 }