@ai-zen/cli 1.0.0-alpha.2 → 1.0.0-alpha.22

package/dist/tui/chat-session.d.ts

@@ -1,81 +1,121 @@
 /**
- * TUI 对话会话 —— Agent 装配与结构化流式事件
+ * TUI 对话会话 —— Agent 装配 + 「内容变更」信号
  *
- * 与旧的行式渲染器（`src/conversation-runner.ts`）不同，这里把流式 delta
- * 翻译成**结构化事件**交给 React 层渲染，而非直接写 stdout，从而支持 Ink 的
- * 可控重绘（增量、无撕裂）。
+ * 渲染以 SDK 的 `agent.messages` 为**唯一数据源**：本模块不再把流式 delta 翻译成
+ * 自定义事件 / 中间模型（Block / LiveAssistant），只做两件事：
+ *   1. SDK 事件到达时通知上层「messages 变了，该重渲染了」；
+ *   2. 把系统级提示（notice / error）转发到独立通道（绝不写进 messages）。
  *
  * 本模块不依赖 React / Ink，可独立单测。
  */
 import { AgentNS } from "@ai-zen/agents-core";
-/** 流式事件：由 React 层消费并拼接成消息块 */
-export type ChatEvent = {
-    type: "user";
-    text: string;
-} | {
-    type: "assistant-start";
-} | {
-    type: "reasoning";
-    text: string;
-} | {
-    type: "content";
-    text: string;
-} | {
-    type: "tool";
-    index: number;
-    name?: string;
-    args?: string;
-} | {
-    type: "subagent-start";
-    name: string;
-} | {
-    type: "subagent-end";
-    name: string;
-} | {
-    type: "notice";
-    text: string;
-} | {
-    type: "error";
-    text: string;
-} | {
-    type: "done";
-};
-export type ChatEventHandler = (e: ChatEvent) => void;
+import { type AutoMigrateTriggerInfo, type HandoffMode } from "@ai-zen/agents-sdk";
+import type { TokenThresholds } from "@ai-zen/agents-sdk";
+import { stripCwdNote } from "./text.js";
+import { type RateSample } from "./token-rate.js";
+import { type PhaseInfo } from "./phase.js";
+/** 会话 → UI 的对外信号 */
+export interface ChatSessionNotifier {
+    /** 转录可能已变化（内容以 `agent.messages` 为准）；`immediate=true` 表示应立即上屏 */
+    onChange(immediate: boolean): void;
+    /** 系统级提示（notice / error），走独立栏位，绝不进 messages */
+    onNotice(text: string, tone: "info" | "error"): void;
+}
 export interface ChatSessionOptions {
-    modelId: string;
     agentId?: string;
     messages?: AgentNS.Message[];
     conversationId?: string;
     conversationName?: string;
-    /** 自动迁移二次确认（由 Ink 层弹出确认框实现） */
-    requestConfirm?: (question: string) => Promise<boolean>;
+    /**
+     * 自动迁移时的执行者选择（由 Ink 层弹出选择器实现）。
+     * 返回 `null` 表示跳过本次迁移；未提供时按默认执行者（原 agent 自交接）直接迁移。
+     */
+    requestMode?: (info: AutoMigrateTriggerInfo) => Promise<HandoffMode | null>;
 }
-/** 去掉 CwdTrackerPlugin 追加在用户消息末尾的工作目录提示 */
-export declare function stripCwdNote(text: string): string;
+/** 去掉 CwdTrackerPlugin 追加在用户消息末尾的工作目录提示（转发自 ./text.js） */
+export { stripCwdNote };
 export declare class ChatSession {
-    readonly modelId: string;
+    /**
+     * 当前模型 id —— 从 Agent 定义读，**不再单独存一份**。
+     *
+     * 模型的唯一真相源是 `AgentDefinition.modelId`：会话不记模型，配置也没有
+     * `defaultModel`。这样状态栏、落盘与 SDK 实发请求用的永远是同一个值。
+     */
+    get modelId(): string;
     readonly agentId: string;
-    readonly maxTokens?: number;
-    currentName: string;
-    currentId: string;
+    /** 当前模型的上下文阈值（交接软线 + 阻断硬线），缺省时不装护栏插件 */
+    readonly tokenThresholds?: TokenThresholds;
+    /**
+     * 会话 id / 名称的**唯一真相源是 `ctx`**（`ConversationContext`）。
+     *
+     * 为什么必须代理而不是各存一份：自动迁移由 SDK 的 `AutoMigratePlugin` 直接驱动
+     * `HandoffService.migrate()`，**不经过本类任何方法**，新 id 只会写进 `ctx.currentId`
+     * （`onMigrated` 钩子）。若本类另持一份 `currentId`，自动迁移后它就停在旧值上，
+     * 而 `ConversationPersistPlugin.getId()` 读的正是这份旧值——于是 prune 之后的
+     * 「系统提示 + 交接断点」会被写进**旧会话文件**，把已保存的完整历史覆盖掉。
+     */
+    get currentId(): string;
+    set currentId(id: string);
+    get currentName(): string;
+    set currentName(name: string);
     private agent;
     private readonly ctx;
-    private readonly migrationService;
-    private readonly onEvent;
-    private readonly requestConfirm?;
+    private readonly handoffService;
+    private readonly notifier;
+    private readonly requestMode?;
     private readonly disposers;
+    /** 生成过程的 token 速率统计（状态栏展示，见 `token-rate.ts`） */
+    private readonly rate;
+    /** 当前生成阶段（消息栏 spinner 文案，见 `phase.ts`） */
+    private readonly phaseTracker;
+    /**
+     * 进行中的交接/迁移的取消句柄（`null` = 当前没有交接）。
+     *
+     * 为什么不能只靠 `agent.abort()`：交接的 `summary` 模式走的是独立的
+     * `chat.completions.create` 请求，`agent.abort()` 根本够不到它；而 `self` 模式
+     * 虽然能中断，但 core 层把中止收敛成「消息标记 Aborted、send 正常返回」，SDK 那边
+     * 会误判成「模型没写出文档」而重试 + 降级 summary 再跑一轮。
+     * 所以交接必须自己带一条 `AbortSignal`。
+     */
+    private handoffAbort;
     private constructor();
-    /** 创建会话：装配 Agent、插件与流式事件 */
-    static create(options: ChatSessionOptions, onEvent: ChatEventHandler): Promise<ChatSession>;
+    /** 创建会话：装配 Agent、插件与「变更信号」 */
+    static create(options: ChatSessionOptions, notifier: ChatSessionNotifier): Promise<ChatSession>;
+    /** 对话消息（唯一真相源） */
     get messages(): AgentNS.Message[];
-    /** 最近一次响应的 token 用量 */
+    /** 最近一次响应的 token 用量（供「本轮 / 当前上下文占用」展示与阈值判定） */
     get lastUsage(): AgentNS.Usage | undefined;
-    /** 发送一条消息；事件通过 `onEvent` 持续回传；resolve 表示本轮结束 */
+    /**
+     * 本会话累计 token 用量。
+     *
+     * 逐消息求和（`sumUsage`）：含各 assistant 消息的 `usage`（自身响应）与工具消息的
+     * `subAgentUsage`（内部委派——含所有层级子 Agent）。每轮请求都会重发完整历史，
+     * 故求和即计费口径的累计消耗；且随消息持久化，续接 / `/load` 亦不丢。
+     */
+    get totalUsage(): AgentNS.Usage;
+    /** 当前速率快照：生成中看 `live`（实时），结束后看 `average`（本轮平均） */
+    get rateSample(): RateSample;
+    /** 当前生成阶段；空闲时为 null（消息栏据此显示「处理中」或不起 spinner） */
+    get phase(): PhaseInfo | null;
+    /** 发送一条消息；内容变化经 `notifier.onChange` 通知，`resolve` 表示本轮结束 */
     send(input: string): Promise<void>;
     /** 中止当前请求（Ctrl+C 语义：仅取消本轮，不退出） */
     abort(): void;
-    /** 重置会话（/new）：清空历史并重建 Agent */
-    reset(): Promise<void>;
+    /**
+     * 按「可取消」方式跑一段交接：创建 `AbortController` 并在结束时收尾。
+     *
+     * 收尾放 `finally`：成功后也要清掉，否则下一次 Ctrl+C 会往一个已完成的
+     * controller 上发出无意义的 abort。
+     */
+    private runCancellable;
+    /**
+     * 重置会话（/new）：先把当前对话归档（有内容才存），再清空历史并重建 Agent。
+     *
+     * 归档必须先于 `currentId` 切换：`save()` 按 `this.currentId` 落盘，若先换 id
+     * 会把旧内容写到新会话文件上（等于旧对话丢失）。返回被归档的会话 id，
+     * 无内容可存时返回 null。
+     */
+    reset(): Promise<string | null>;
     /**
      * 应用外部配置变更（如 `/config` 改了当前端点的 API Key / Base URL）：
      * **保留消息与上下文**，按磁盘上的新配置重建 Agent。
@@ -84,8 +124,15 @@ export declare class ChatSession {
      * 否则端点凭据仍是旧的（这也是 `resetScope()` 要 `dispose` 旧实例的原因）。
      */
     reload(): Promise<void>;
-    /** 手动任务迁移（/migrate）：与自动迁移共用同一服务实例 */
-    migrate(): Promise<void>;
+    /** 手动任务迁移（`/migrate`）：交接 + 开新会话；与自动迁移共用同一服务实例 */
+    migrate(mode?: HandoffMode): Promise<string>;
+    /**
+     * 只产出交接文档（`/handoff`）：不切换会话、不改动历史。
+     *
+     * 交接回合（指令 + 工具调用 + 回执）会留在 `agent.messages` 里，
+     * 用户可继续要求细化同一份文档（重写同一路径即可）。
+     */
+    handoff(mode?: HandoffMode): Promise<string>;
     /** 撤回：删除索引 index 起的消息，返回被撤回的首条用户消息文本（用于预填输入） */
     rollbackTo(index: number): string;
     /** 保存当前对话到存档 */
@@ -93,8 +140,12 @@ export declare class ChatSession {
     /** 释放事件监听（重建 Agent 时调用，避免监听器泄漏） */
     dispose(): void;
     private attach;
+    /**
+     * 订阅 SDK 事件，仅把它们当作「messages 可能已变化」的信号：
+     * - `chunk-parsed`（每片 delta 应用后）：高频 → 走合帧（`immediate=false`）；
+     * - `open` / `parsed` / `finally`：轮次边界 → 立即上屏；
+     * - `error`：转发到通知通道。
+     */
     private wire;
-    /** 把流式 delta 翻译为结构化事件 */
-    private emitDelta;
 }
 //# sourceMappingURL=chat-session.d.ts.map

package/dist/tui/chat-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/tui/chat-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/tui/chat-session.ts"],"names":[],"mappings":"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"}