@morlay/ui-conversation-manager 0.0.2-alpha.7 → 0.0.2-alpha.9

package/README.md

@@ -28,16 +28,16 @@ ui-plugin-manager 同一种注册方式）。页面分两层 Tabs（官方 `Pill
 **默认排除已归档**（给上游 UI 用），归档集的管理动作要完整集合，两条路不混（决策见
 [session-rdb 的 ADR](../session-rdb/.agents/adrs/20260922-会话列表两条路.md)）：
 
-| 动作         | 接缝                                                                                                        |
-| ------------ | ----------------------------------------------------------------------------------------------------------- |
+| 动作         | 接缝                                                                                                                             |
+| ------------ | -------------------------------------------------------------------------------------------------------------------------------- |
 | 列表与标题   | `POST /api/session.rows`（`@morlay/session-rdb`：完整语料 + 标题 + 最后活动时间 + 工作区归属；搜索 / 子代理过滤 / 分页都在后端） |
-| 归档         | `ctx.uiWorkspace.archiveSession`（上游 ui-workspace，未归档行提供）                                         |
-| 取消归档     | `ctx.uiWorkspace.unarchiveSession`（上游 ui-workspace，已归档行提供）                                       |
-| 导出         | `POST /api/session.export`（`@morlay/session-rdb`，直接下载 zip）                                           |
-| 删除         | `POST /api/session.delete`（`@morlay/session-rdb`，仅已归档行可用）                                         |
-| 导入为新会话 | `POST /api/session.import`（`@morlay/session-rdb`，不带 `sessionId` = 新建会话）                            |
-| 清理孤儿数据 | `POST /api/session.gc`（停 agent → 回收孤儿 subagent 会话 → 回收孤儿事件行 → VACUUM；执行期间阻塞界面）     |
-| 用量统计     | `POST /api/session.usage`（`@morlay/session-rdb` 读专用用量表聚合；进入统计视图时拉一次，维度切换本地折叠） |
+| 归档         | `ctx.uiWorkspace.archiveSession`（上游 ui-workspace，未归档行提供）                                                              |
+| 取消归档     | `ctx.uiWorkspace.unarchiveSession`（上游 ui-workspace，已归档行提供）                                                            |
+| 导出         | `POST /api/session.export`（`@morlay/session-rdb`，直接下载 zip）                                                                |
+| 删除         | `POST /api/session.delete`（`@morlay/session-rdb`，仅已归档行可用）                                                              |
+| 导入为新会话 | `POST /api/session.import`（`@morlay/session-rdb`，不带 `sessionId` = 新建会话）                                                 |
+| 清理孤儿数据 | `POST /api/session.gc`（停 agent → 回收孤儿 subagent 会话 → 回收孤儿事件行 → VACUUM；执行期间阻塞界面）                          |
+| 用量统计     | `POST /api/session.usage`（`@morlay/session-rdb` 读专用用量表聚合；进入统计视图时拉一次，维度切换本地折叠）                      |
 
 归档 / 取消归档 / 删除 / 导入 / GC 成功后重拉会话行；host 拒绝（未归档 / 正在使用 / 不存在）
 时按错误码给出可读文案。列表每页 20 条，搜索框复用官方 `Input`（连同官方图标与焦点样式）。
@@ -54,8 +54,9 @@ GC 是唯一会**停止所有运行中 agent** 的动作：确认后进入不可
 
 时间范围的按钮与维度 tab 共用**同一套官方 tab 条视觉**（文字 13/16 wt500、选中态品牌蓝 + 2px 下划线，
 取自会话头部的 `ConversationRoot.module.css`），只在其语义上用 `radiogroup`（单选筛选）区别于维度的 `tab`；
-**不用 `Pill`**——官方 `ui-primitives` README 写明它的选中态是按钮填充风格（`button-ghost-active-fill` + 内描边），
-且视图切换应使用消费方自有的 tab 条组合，`Pill` 在官方代码里只用于只读状态（`TerminalBlock`）。
+**不用 `Pill`**——官方 `ui-primitives` README 里 `Pill` 是「视图切换与筛选用法的可选中胶囊」（只读 capsule 是
+`Tag`），官方那件互斥择一的选择件是 `SegmentedControl`（受控 tab 形态 `SegmentedTabs`）；我们这里是**单选筛选**：
+视觉取 tab 条、语义用 `radiogroup`。
 
 统计的每一行（总览与列表）是同一形态：行 label + 横向排布的单项，所以读法一致——
 「`data-usage-key=2026-09-14` 行里 `data-usage-cell=input` 的 `data-usage-value`」。
@@ -97,5 +98,5 @@ GC 是唯一会**停止所有运行中 agent** 的动作：确认后进入不可
 
 ## 文档
 
-- 决策：[ADR-禁用上游已归档入口改由对话管理页承载](../better-session/.agents/adrs/20260918-禁用上游已归档入口改由对话管理页承载.md)
+- 决策：[ADR-禁用上游已归档入口改由对话管理页承载](../../bundles/better-session/.agents/adrs/20260918-禁用上游已归档入口改由对话管理页承载.md)
 - 测试落点：[`src/__tests__/`](./src/__tests__)（注册面 / 页面 / 注入面 / 数字格式化四条 spec）

package/dist/client.d.cts

@@ -1096,9 +1096,8 @@ interface ToolRemovalBlock {
 }
 /**
  * Merge-extensible content blocks keyed by `type`. New core blocks must land
- * with adapter, UI, and compaction support. Developer tool-change blocks are
- * reserved for Session V4 persistence; providers and UI reject them until
- * their producers and consumers are implemented together.
+ * with adapter, UI, and compaction support. Tool-change blocks belong to
+ * developer messages; `projectToolUpdates` selects what each route receives.
  */
 interface ContentBlockMap {
   'text': TextBlock;
@@ -1328,6 +1327,16 @@ interface LlmModelReasoningInfo {
  * can follow the cached history instead of rewriting message 0.
  */
 type SystemPromptUpdate = 'in-history';
+/**
+ * How a model accepts native tool declarations that change mid-conversation.
+ * `'addition-only'`: the model reads a `tool-addition` block in a later
+ * developer message as activating a tool declared with `deferLoading`, so an
+ * added tool follows the cached history instead of rewriting the declaration
+ * list. `'in-history'`: the model additionally reads `tool-removal` blocks,
+ * so a removed tool keeps its declaration and the removal follows the history.
+ * Absent means every request declares the complete current tool list.
+ */
+type ToolUpdate = 'in-history' | 'addition-only';
 /** Exact-route model metadata resolved by its owning adapter. */
 interface LlmResolvedModelInfo extends LlmModelInfo {
   /** Provider-owned context capacity when known. */
@@ -1338,6 +1347,8 @@ interface LlmResolvedModelInfo extends LlmModelInfo {
   reasoning?: LlmModelReasoningInfo;
   /** Declared mid-conversation system prompt handling; absent means only a leading system message is read. */
   systemPromptUpdate?: SystemPromptUpdate;
+  /** Declared mid-conversation tool declaration handling; absent means every request declares the complete tool list. */
+  toolUpdate?: ToolUpdate;
 }
 /**
  * Adapter-private lossless-JSON state for replaying a successful response,
@@ -1426,6 +1437,18 @@ interface RequestUserInput {
 }
 /** A durable conversation message or a user input used only for one request. */
 type RequestMessage = Message | RequestUserInput;
+/** Logged tool declarations and update identities since the last declaration reset. */
+interface ToolHistory {
+  /** Complete active declarations at the start of this history. */
+  readonly tools: readonly ToolSchema[];
+  /** Ordered developer messages, with additions resolved from their historical headers. */
+  readonly updates: readonly {
+    /** Identity used to locate this update in the derived request history. */
+    readonly messageId: MessageId;
+    /** Added definitions resolved from the event's referenced request header. */
+    readonly additions: readonly ToolSchema[];
+  }[];
+}
 /** A single model request, fully assembled. */
 interface GenerateOptions {
   /** Registered provider route selecting the adapter instance. */
@@ -1447,6 +1470,8 @@ interface GenerateOptions {
   system?: string;
   /** Tool schemas (adapters map to the provider's `tools` field). */
   tools?: ToolSchema[];
+  /** Session-folded tool history used for route projection; omission sends complete declarations without tool updates. */
+  toolHistory?: ToolHistory;
   temperature?: number;
   maxTokens?: number;
   /**
@@ -1884,6 +1909,8 @@ interface PreparedLlmCall {
   readonly inputModalities?: readonly ModelModality[];
   /** Exact model system prompt update mode captured with the adapter dispatch generation. */
   readonly systemPromptUpdate?: SystemPromptUpdate;
+  /** Exact model tool update mode captured with the adapter dispatch generation. */
+  readonly toolUpdate?: ToolUpdate;
   /** Config fields materialized by the captured adapter rather than proposed by the caller. */
   readonly adapterDefaults: LlmCallConfigAdapterDefaults;
   /**
@@ -1933,8 +1960,9 @@ declare abstract class LlmAdapter {
   imageRequestPricing(_provider: string, _model: string): LlmImageRequestPricing | undefined;
   /**
    * List models this adapter can currently advertise for one owned provider.
-   * The result is advisory: an adapter may accept unlisted model ids, and
-   * consumers must not turn absence into request rejection.
+   * Core routing accepts unlisted model ids; catalog-driven entry points such
+   * as the GUI may require membership. Adapters used there must advertise
+   * their available models; the base empty catalog offers no GUI selection.
    * @param _provider - one provider route owned by this adapter.
    * @returns discoverable models in adapter-preferred order.
    */
@@ -2122,7 +2150,8 @@ declare class LlmRuntime extends TypertRemoteService {
   private detachedModalities;
   /**
    * Discover models advertised by one registered provider. Catalog membership
-   * is advisory and never changes routing or request validation.
+   * does not constrain core routing. Catalog-driven entry points may restrict
+   * selection and submission to the advertised models.
    * @param provider - registered provider route to inspect.
    * @returns detached model metadata in adapter-preferred order.
    */
@@ -2436,9 +2465,9 @@ interface RequestContext {
  * Why a `request/header` snapshot was appended: `'initial'` — the log's first
  * header (a new conversation); `'resume'` — a loop instance's first request
  * over a log that already has header events (process restart, fork seed);
- * `'change'` — a later request used a different header, with `startsSeries`
- * preserving a coincident series boundary; `'series'` — an unchanged header
- * began an explicitly distinct message series or followed a surface replacement.
+ * `'change'` — a later request used a different header; `'series'` — an unchanged
+ * header began an explicitly distinct message series or followed a surface
+ * replacement. Other reasons carry `startsSeries` when a new series coincides.
  */
 type RequestHeaderReason = 'initial' | 'resume' | 'change' | 'series';
 /**
@@ -2588,7 +2617,7 @@ interface SessionEventMap {
   'request/header': {
     header: EpochHeader;
     reason: RequestHeaderReason;
-    /** A changed header also begins a distinct model-message series. */
+    /** This request begins a distinct model-message series, independently of the header reason. */
     startsSeries?: true;
   };
   /**
@@ -2974,6 +3003,16 @@ declare class Session {
    * @returns the latest immutable route metadata.
    */
   requestContext(): RequestContext | undefined;
+  /** Cached historical tool definitions and updates for request projection. */
+  private readonly toolHistoryProjection;
+  /** Index of the next committed event not yet consumed by the tool-history fold. */
+  private toolHistorySeq;
+  /**
+   * Fold unseen committed events into capability-independent tool history.
+   * Initial access reconstructs inherited history; later reads consume only new events.
+   * @returns an immutable snapshot for LLM request projection, including historical addition definitions.
+   */
+  toolHistory(): ToolHistory;
   /** The derived-message cache: frozen projections, extended per unseen node. */
   private derived;
   /** Surface position (nodes projected) the cache has reached. */
@@ -3182,7 +3221,10 @@ interface SessionRowsPage {
   page: number;
   pageSize: number;
 }
-/** 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）。 */
+/**
+ * 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）：`day` / `week` 是本地自然日 /
+ * 自然周，`7d` / `30d` / `90d` 是最近 N 个自然日（含今天）——边界由 host 按本地时区算，客户端只传语义。
+ */
 type UsageRangeKey = "all" | "day" | "week" | "7d" | "30d" | "90d";
 /** 活动计数（与 session-rdb `./usage` 的回报结构镜像）：轮次 / 步骤 / 用户输入 / 工具调用。 */
 interface UsageActivityTotals {

package/dist/client.d.mts

@@ -1096,9 +1096,8 @@ interface ToolRemovalBlock {
 }
 /**
  * Merge-extensible content blocks keyed by `type`. New core blocks must land
- * with adapter, UI, and compaction support. Developer tool-change blocks are
- * reserved for Session V4 persistence; providers and UI reject them until
- * their producers and consumers are implemented together.
+ * with adapter, UI, and compaction support. Tool-change blocks belong to
+ * developer messages; `projectToolUpdates` selects what each route receives.
  */
 interface ContentBlockMap {
   'text': TextBlock;
@@ -1328,6 +1327,16 @@ interface LlmModelReasoningInfo {
  * can follow the cached history instead of rewriting message 0.
  */
 type SystemPromptUpdate = 'in-history';
+/**
+ * How a model accepts native tool declarations that change mid-conversation.
+ * `'addition-only'`: the model reads a `tool-addition` block in a later
+ * developer message as activating a tool declared with `deferLoading`, so an
+ * added tool follows the cached history instead of rewriting the declaration
+ * list. `'in-history'`: the model additionally reads `tool-removal` blocks,
+ * so a removed tool keeps its declaration and the removal follows the history.
+ * Absent means every request declares the complete current tool list.
+ */
+type ToolUpdate = 'in-history' | 'addition-only';
 /** Exact-route model metadata resolved by its owning adapter. */
 interface LlmResolvedModelInfo extends LlmModelInfo {
   /** Provider-owned context capacity when known. */
@@ -1338,6 +1347,8 @@ interface LlmResolvedModelInfo extends LlmModelInfo {
   reasoning?: LlmModelReasoningInfo;
   /** Declared mid-conversation system prompt handling; absent means only a leading system message is read. */
   systemPromptUpdate?: SystemPromptUpdate;
+  /** Declared mid-conversation tool declaration handling; absent means every request declares the complete tool list. */
+  toolUpdate?: ToolUpdate;
 }
 /**
  * Adapter-private lossless-JSON state for replaying a successful response,
@@ -1426,6 +1437,18 @@ interface RequestUserInput {
 }
 /** A durable conversation message or a user input used only for one request. */
 type RequestMessage = Message | RequestUserInput;
+/** Logged tool declarations and update identities since the last declaration reset. */
+interface ToolHistory {
+  /** Complete active declarations at the start of this history. */
+  readonly tools: readonly ToolSchema[];
+  /** Ordered developer messages, with additions resolved from their historical headers. */
+  readonly updates: readonly {
+    /** Identity used to locate this update in the derived request history. */
+    readonly messageId: MessageId;
+    /** Added definitions resolved from the event's referenced request header. */
+    readonly additions: readonly ToolSchema[];
+  }[];
+}
 /** A single model request, fully assembled. */
 interface GenerateOptions {
   /** Registered provider route selecting the adapter instance. */
@@ -1447,6 +1470,8 @@ interface GenerateOptions {
   system?: string;
   /** Tool schemas (adapters map to the provider's `tools` field). */
   tools?: ToolSchema[];
+  /** Session-folded tool history used for route projection; omission sends complete declarations without tool updates. */
+  toolHistory?: ToolHistory;
   temperature?: number;
   maxTokens?: number;
   /**
@@ -1884,6 +1909,8 @@ interface PreparedLlmCall {
   readonly inputModalities?: readonly ModelModality[];
   /** Exact model system prompt update mode captured with the adapter dispatch generation. */
   readonly systemPromptUpdate?: SystemPromptUpdate;
+  /** Exact model tool update mode captured with the adapter dispatch generation. */
+  readonly toolUpdate?: ToolUpdate;
   /** Config fields materialized by the captured adapter rather than proposed by the caller. */
   readonly adapterDefaults: LlmCallConfigAdapterDefaults;
   /**
@@ -1933,8 +1960,9 @@ declare abstract class LlmAdapter {
   imageRequestPricing(_provider: string, _model: string): LlmImageRequestPricing | undefined;
   /**
    * List models this adapter can currently advertise for one owned provider.
-   * The result is advisory: an adapter may accept unlisted model ids, and
-   * consumers must not turn absence into request rejection.
+   * Core routing accepts unlisted model ids; catalog-driven entry points such
+   * as the GUI may require membership. Adapters used there must advertise
+   * their available models; the base empty catalog offers no GUI selection.
    * @param _provider - one provider route owned by this adapter.
    * @returns discoverable models in adapter-preferred order.
    */
@@ -2122,7 +2150,8 @@ declare class LlmRuntime extends TypertRemoteService {
   private detachedModalities;
   /**
    * Discover models advertised by one registered provider. Catalog membership
-   * is advisory and never changes routing or request validation.
+   * does not constrain core routing. Catalog-driven entry points may restrict
+   * selection and submission to the advertised models.
    * @param provider - registered provider route to inspect.
    * @returns detached model metadata in adapter-preferred order.
    */
@@ -2436,9 +2465,9 @@ interface RequestContext {
  * Why a `request/header` snapshot was appended: `'initial'` — the log's first
  * header (a new conversation); `'resume'` — a loop instance's first request
  * over a log that already has header events (process restart, fork seed);
- * `'change'` — a later request used a different header, with `startsSeries`
- * preserving a coincident series boundary; `'series'` — an unchanged header
- * began an explicitly distinct message series or followed a surface replacement.
+ * `'change'` — a later request used a different header; `'series'` — an unchanged
+ * header began an explicitly distinct message series or followed a surface
+ * replacement. Other reasons carry `startsSeries` when a new series coincides.
  */
 type RequestHeaderReason = 'initial' | 'resume' | 'change' | 'series';
 /**
@@ -2588,7 +2617,7 @@ interface SessionEventMap {
   'request/header': {
     header: EpochHeader;
     reason: RequestHeaderReason;
-    /** A changed header also begins a distinct model-message series. */
+    /** This request begins a distinct model-message series, independently of the header reason. */
     startsSeries?: true;
   };
   /**
@@ -2974,6 +3003,16 @@ declare class Session {
    * @returns the latest immutable route metadata.
    */
   requestContext(): RequestContext | undefined;
+  /** Cached historical tool definitions and updates for request projection. */
+  private readonly toolHistoryProjection;
+  /** Index of the next committed event not yet consumed by the tool-history fold. */
+  private toolHistorySeq;
+  /**
+   * Fold unseen committed events into capability-independent tool history.
+   * Initial access reconstructs inherited history; later reads consume only new events.
+   * @returns an immutable snapshot for LLM request projection, including historical addition definitions.
+   */
+  toolHistory(): ToolHistory;
   /** The derived-message cache: frozen projections, extended per unseen node. */
   private derived;
   /** Surface position (nodes projected) the cache has reached. */
@@ -3182,7 +3221,10 @@ interface SessionRowsPage {
   page: number;
   pageSize: number;
 }
-/** 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）。 */
+/**
+ * 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）：`day` / `week` 是本地自然日 /
+ * 自然周，`7d` / `30d` / `90d` 是最近 N 个自然日（含今天）——边界由 host 按本地时区算，客户端只传语义。
+ */
 type UsageRangeKey = "all" | "day" | "week" | "7d" | "30d" | "90d";
 /** 活动计数（与 session-rdb `./usage` 的回报结构镜像）：轮次 / 步骤 / 用户输入 / 工具调用。 */
 interface UsageActivityTotals {

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Conversation Manager",
-    "description": "Full-page panel for archived sessions: search, unarchive, delete, and import as a new session."
+    "description": "Full-page conversation management panel (browser half): search across sessions, unarchive, delete and import as a new session."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "对话管理页",
-    "description": "已归档会话的全局面板页：搜索、取消归档、删除、导入为新会话。"
+    "description": "「对话管理」全局面板页（浏览器半）：会话（含已归档）的搜索、取消归档、删除与导入为新会话。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morlay/ui-conversation-manager",
-  "version": "0.0.2-alpha.7",
-  "description": "「对话管理」全局面板页（浏览器半）：已归档会话的搜索、取消归档、删除，以及导入为新会话。",
+  "version": "0.0.2-alpha.9",
+  "description": "「对话管理」全局面板页（浏览器半）：会话（含已归档）的搜索、取消归档、删除，以及导入为新会话。",
   "keywords": [
     "archived-sessions",
     "conversation-manager",
@@ -39,18 +39,18 @@
     "react-dom": "^18.2.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "4.0.4",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-workspace": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
-    "@morlay/dsh-client-ui-primitives": "0.0.2-alpha.7"
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-workspace": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.7-rc.2",
+    "@morlay/dsh-client-ui-primitives": "0.0.2-alpha.9"
   },
   "dsh": {
     "client": {

package/src/client/controller.ts

@@ -41,7 +41,10 @@ export interface SessionRowsPage {
   pageSize: number;
 }
 
-/** 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）。 */
+/**
+ * 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）：`day` / `week` 是本地自然日 /
+ * 自然周，`7d` / `30d` / `90d` 是最近 N 个自然日（含今天）——边界由 host 按本地时区算，客户端只传语义。
+ */
 export type UsageRangeKey = "all" | "day" | "week" | "7d" | "30d" | "90d";
 
 /** 活动计数（与 session-rdb `./usage` 的回报结构镜像）：轮次 / 步骤 / 用户输入 / 工具调用。 */