@ai-zen/cli 0.9.0 → 1.0.0-alpha.10

package/dist/stdio-runner.js

@@ -0,0 +1,161 @@
+/**
+ * 纯 stdio 模式运行器
+ *
+ * 约定（见 TODO §1）：
+ *   - 不进入交互循环、不显示横幅、不等待任何按键；
+ *   - 仅把**最终 assistant 文本**写入 stdout（零 ANSI、零 emoji 前缀、零 spinner）；
+ *   - 日志 / 进度 / SDK 输出一律走 stderr；
+ *   - 成功退出码 0，失败非 0。
+ *
+ * 该模式不落盘（不写草稿 / 对话存档），仅当显式 `--save` 时保存对话存档。
+ */
+import { AgentNS } from "@ai-zen/agents-core";
+import { AutoRefreshToolsPlugin, ContextGuardPlugin, setLogger, } from "@ai-zen/agents-sdk";
+import { createAgent } from "./agent-creator.js";
+import { readConfig } from "./config.js";
+import { CwdTrackerPlugin } from "./cwd-tracker-plugin.js";
+import { SubAgentGuardInstallerPlugin } from "./sub-agent-guard-plugin.js";
+import { conversationRepository } from "./conversation-repository.js";
+import { formatShortTime } from "./format-time.js";
+/** 向 stderr 写一行（stdlib 日志统一出口） */
+function logStderr(line) {
+    process.stderr.write(line.endsWith("\n") ? line : line + "\n");
+}
+/**
+ * 读取全部 stdin 文本。
+ * stdin 为 TTY（无管道）或读取失败时返回空串。
+ */
+export async function readStdin() {
+    if (process.stdin.isTTY)
+        return "";
+    try {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        return Buffer.concat(chunks).toString("utf-8").replace(/\r\n/g, "\n");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * 合并「指令 + stdin 内容」（见 TODO §5 开放问题 2：参数为指令、stdin 为内容）。
+ * - 两者都有：`指令\n\n内容`
+ * - 仅其一：取该者
+ */
+export function mergePrompt(instruction, stdin) {
+    const inst = instruction.trim();
+    const body = stdin.replace(/\r?\n$/, "");
+    if (inst && body.trim())
+        return `${inst}\n\n${body}`;
+    if (inst)
+        return inst;
+    return body;
+}
+/** 从内容块中提取纯文本；非文本块（图片/文件）以占位文本表示 */
+export function extractText(content) {
+    if (content == null)
+        return "";
+    if (typeof content === "string")
+        return content;
+    const parts = [];
+    for (const section of content) {
+        if (section.type === "text")
+            parts.push(section.text);
+        else if (section.type === "image_url")
+            parts.push(`[图片: ${section.image_url.url}]`);
+        else if (section.type === "file")
+            parts.push(`[文件: ${section.file_id ?? section.filename ?? "内联文件"}]`);
+    }
+    return parts.join("\n");
+}
+/**
+ * 无交互地确定 model / agent / 上下文阈值。
+ * 与 TUI 路径不同：这里**绝不弹出选择框**，缺失即视为配置错误。
+ */
+async function resolveTarget() {
+    const config = await readConfig();
+    const modelId = config.defaultModel ?? config.models[0]?.id;
+    if (!modelId)
+        throw new Error("没有可用的模型，请先运行 `ai` 完成配置");
+    const model = config.models.find((m) => m.id === modelId);
+    if (!model)
+        throw new Error(`默认模型 ${modelId} 不存在`);
+    const endpoint = config.endpoints.find((e) => e.id === model.endpointId);
+    if (!endpoint)
+        throw new Error(`模型 ${modelId} 引用的端点 ${model.endpointId} 不存在`);
+    if (!endpoint.apiKey) {
+        throw new Error(`端点 "${endpoint.name}" 的 API Key 未设置，请先运行 \`ai\` 进入交互界面配置`);
+    }
+    const maxTokens = model.maxContextTokens ??
+        (model.maxContextChars ? Math.floor(model.maxContextChars / 4) : undefined);
+    return { modelId, agentId: config.defaultAgent ?? "default", maxTokens };
+}
+/** 运行一次纯 stdio 对话，返回进程退出码 */
+export async function runStdio(options) {
+    const { instruction, save } = options;
+    const stdinText = await readStdin();
+    const prompt = mergePrompt(instruction, stdinText);
+    if (!prompt.trim()) {
+        logStderr("ai: 没有输入内容（请提供参数，或通过管道传入文本）");
+        return 2;
+    }
+    // 保持 stdout 纯净：SDK 全局日志与 console.log 统一改道 stderr
+    const stderrLogger = (message) => logStderr(message);
+    setLogger({ info: stderrLogger, warn: stderrLogger, error: stderrLogger });
+    const originalLog = console.log;
+    console.log = (...args) => logStderr(args.map((a) => String(a)).join(" "));
+    try {
+        const { modelId, agentId, maxTokens } = await resolveTarget();
+        const agent = await createAgent({ agentId });
+        agent.use(new CwdTrackerPlugin());
+        agent.use(new AutoRefreshToolsPlugin());
+        if (maxTokens && maxTokens > 0) {
+            agent.use(new ContextGuardPlugin({ maxTokens }));
+            agent.use(new SubAgentGuardInstallerPlugin({ maxTokens }));
+        }
+        await agent.init();
+        const messages = await agent.send(prompt);
+        const lastAssistant = [...messages]
+            .reverse()
+            .find((m) => m.role === AgentNS.Role.Assistant);
+        if (!lastAssistant || lastAssistant.status === AgentNS.MessageStatus.Error) {
+            logStderr("ai: 模型返回错误");
+            return 1;
+        }
+        if (save) {
+            const name = `对话_${formatShortTime(new Date().toISOString())}`;
+            const now = new Date().toISOString();
+            await conversationRepository.write({
+                id: name.replace(/[\\/:*?"<>|]/g, "_"),
+                agentId,
+                modelId,
+                messages: agent.messages,
+                cwd: process.cwd(),
+                createdAt: now,
+                updatedAt: now,
+            });
+            logStderr(`已保存对话: ${name}`);
+        }
+        // 结果：仅此一处写入 stdout
+        const text = extractText(lastAssistant.content);
+        if (text)
+            process.stdout.write(text.endsWith("\n") ? text : text + "\n");
+        return 0;
+    }
+    catch (error) {
+        logStderr(`ai: ${error?.message ?? error}`);
+        return 1;
+    }
+    finally {
+        // 恢复被改道的 console（进程通常随即退出，但保持副作用可逆）
+        setLogger({
+            info: originalLog,
+            warn: console.warn,
+            error: console.error,
+        });
+        console.log = originalLog;
+    }
+}
+//# sourceMappingURL=stdio-runner.js.map

package/dist/stdio-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-runner.js","sourceRoot":"","sources":["../src/stdio-runner.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,106 @@
+/**
+ * TUI 对话会话 —— Agent 装配 + 「内容变更」信号
+ *
+ * 渲染以 SDK 的 `agent.messages` 为**唯一数据源**：本模块不再把流式 delta 翻译成
+ * 自定义事件 / 中间模型（Block / LiveAssistant），只做两件事：
+ *   1. SDK 事件到达时通知上层「messages 变了，该重渲染了」；
+ *   2. 把系统级提示（notice / error）转发到独立通道（绝不写进 messages）。
+ *
+ * 本模块不依赖 React / Ink，可独立单测。
+ */
+import { AgentNS } from "@ai-zen/agents-core";
+import { type AutoMigrateTriggerInfo, type HandoffMode } from "@ai-zen/agents-sdk";
+import { stripCwdNote } from "./text.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 层弹出选择器实现）。
+     * 返回 `null` 表示跳过本次迁移；未提供时按默认执行者（原 agent 自交接）直接迁移。
+     */
+    requestMode?: (info: AutoMigrateTriggerInfo) => Promise<HandoffMode | null>;
+}
+/** 去掉 CwdTrackerPlugin 追加在用户消息末尾的工作目录提示（转发自 ./text.js） */
+export { stripCwdNote };
+export declare class ChatSession {
+    readonly modelId: string;
+    readonly agentId: string;
+    readonly maxTokens?: number;
+    currentName: string;
+    currentId: string;
+    private agent;
+    private readonly ctx;
+    private readonly handoffService;
+    private readonly notifier;
+    private readonly requestMode?;
+    private readonly disposers;
+    private constructor();
+    /** 创建会话：装配 Agent、插件与「变更信号」 */
+    static create(options: ChatSessionOptions, notifier: ChatSessionNotifier): Promise<ChatSession>;
+    /** 对话消息（唯一真相源） */
+    get messages(): AgentNS.Message[];
+    /** 最近一次响应的 token 用量（供「本轮 / 当前上下文占用」展示与阈值判定） */
+    get lastUsage(): AgentNS.Usage | undefined;
+    /**
+     * 本会话累计 token 用量。
+     *
+     * 逐消息求和（`sumUsage`）：含各 assistant 消息的 `usage`（自身响应）与工具消息的
+     * `subAgentUsage`（内部委派——含所有层级子 Agent）。每轮请求都会重发完整历史，
+     * 故求和即计费口径的累计消耗；且随消息持久化，续接 / `/load` 亦不丢。
+     */
+    get totalUsage(): AgentNS.Usage;
+    /** 发送一条消息；内容变化经 `notifier.onChange` 通知，`resolve` 表示本轮结束 */
+    send(input: string): Promise<void>;
+    /** 中止当前请求（Ctrl+C 语义：仅取消本轮，不退出） */
+    abort(): void;
+    /**
+     * 重置会话（/new）：先把当前对话归档（有内容才存），再清空历史并重建 Agent。
+     *
+     * 归档必须先于 `currentId` 切换：`save()` 按 `this.currentId` 落盘，若先换 id
+     * 会把旧内容写到新会话文件上（等于旧对话丢失）。返回被归档的会话 id，
+     * 无内容可存时返回 null。
+     */
+    reset(): Promise<string | null>;
+    /**
+     * 应用外部配置变更（如 `/config` 改了当前端点的 API Key / Base URL）：
+     * **保留消息与上下文**，按磁盘上的新配置重建 Agent。
+     *
+     * 关键：`getScope()` 是持有配置快照的单例，必须连同 Scope 一起重建，
+     * 否则端点凭据仍是旧的（这也是 `resetScope()` 要 `dispose` 旧实例的原因）。
+     */
+    reload(): Promise<void>;
+    /** 手动任务迁移（`/migrate`）：交接 + 开新会话；与自动迁移共用同一服务实例 */
+    migrate(mode?: HandoffMode): Promise<string>;
+    /**
+     * 只产出交接文档（`/handoff`）：不切换会话、不改动历史。
+     *
+     * 交接回合（指令 + 工具调用 + 回执）会留在 `agent.messages` 里，
+     * 用户可继续要求细化同一份文档（重写同一路径即可）。
+     */
+    handoff(mode?: HandoffMode): Promise<string>;
+    /** 撤回：删除索引 index 起的消息，返回被撤回的首条用户消息文本（用于预填输入） */
+    rollbackTo(index: number): string;
+    /** 保存当前对话到存档 */
+    save(): Promise<string>;
+    /** 释放事件监听（重建 Agent 时调用，避免监听器泄漏） */
+    dispose(): void;
+    private attach;
+    /**
+     * 订阅 SDK 事件，仅把它们当作「messages 可能已变化」的信号：
+     * - `chunk-parsed`（每片 delta 应用后）：高频 → 走合帧（`immediate=false`）；
+     * - `open` / `parsed` / `finally`：轮次边界 → 立即上屏；
+     * - `error`：转发到通知通道。
+     */
+    private wire;
+}
+//# sourceMappingURL=chat-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/tui/chat-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAY,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAGjB,MAAM,oBAAoB,CAAC;AAW5B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,oBAAoB;AACpB,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC7E;AAED,0DAA0D;AAC1D,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAgE;IAC7F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAEnD,OAAO;IAkBP,8BAA8B;WACjB,MAAM,CACjB,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAAC,WAAW,CAAC;IA8BvB,kBAAkB;IAClB,IAAI,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAEhC;IAED,+CAA+C;IAC/C,IAAI,SAAS,IAAI,OAAO,CAAC,KAAK,GAAG,SAAS,CAEzC;IAED;;;;;;OAMG;IACH,IAAI,UAAU,IAAI,OAAO,CAAC,KAAK,CAE9B;IAED,2DAA2D;IACrD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxC,kCAAkC;IAClC,KAAK,IAAI,IAAI;IAIb;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoBrC;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAc7B,iDAAiD;IAC3C,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBlD;;;;;OAKG;IACG,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAalD,gDAAgD;IAChD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQjC,gBAAgB;IACV,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAiB7B,mCAAmC;IACnC,OAAO,IAAI,IAAI;YAMD,MAAM;IAuCpB;;;;;OAKG;IACH,OAAO,CAAC,IAAI;CA8Cb"}

package/dist/tui/chat-session.js

@@ -0,0 +1,299 @@
+/**
+ * TUI 对话会话 —— Agent 装配 + 「内容变更」信号
+ *
+ * 渲染以 SDK 的 `agent.messages` 为**唯一数据源**：本模块不再把流式 delta 翻译成
+ * 自定义事件 / 中间模型（Block / LiveAssistant），只做两件事：
+ *   1. SDK 事件到达时通知上层「messages 变了，该重渲染了」；
+ *   2. 把系统级提示（notice / error）转发到独立通道（绝不写进 messages）。
+ *
+ * 本模块不依赖 React / Ink，可独立单测。
+ */
+import { AgentNS, sumUsage } from "@ai-zen/agents-core";
+import { AutoRefreshToolsPlugin, ContextGuardPlugin, } from "@ai-zen/agents-sdk";
+import { createAgent, resetScope } from "../agent-creator.js";
+import { readConfig } from "../config.js";
+import { CwdTrackerPlugin } from "../cwd-tracker-plugin.js";
+import { ConversationPersistPlugin } from "../conversation-persist-plugin.js";
+import { SubAgentGuardInstallerPlugin } from "../sub-agent-guard-plugin.js";
+import { createAutoMigratePlugin } from "../auto-migrate-confirm.js";
+import { createHandoffService } from "../handoff-service.js";
+import { conversationRepository, generateConversationId } from "../conversation-repository.js";
+import { writeLastSession } from "../session-pointer.js";
+import { stripCwdNote } from "./text.js";
+/** 去掉 CwdTrackerPlugin 追加在用户消息末尾的工作目录提示（转发自 ./text.js） */
+export { stripCwdNote };
+export class ChatSession {
+    modelId;
+    agentId;
+    maxTokens;
+    currentName;
+    currentId;
+    agent;
+    ctx;
+    handoffService;
+    notifier;
+    requestMode;
+    disposers = [];
+    constructor(handoffService, ctx, options, maxTokens, notifier) {
+        this.handoffService = handoffService;
+        this.ctx = ctx;
+        this.modelId = options.modelId;
+        this.agentId = options.agentId || "default";
+        this.maxTokens = maxTokens;
+        this.currentId = ctx.currentId || generateConversationId();
+        this.currentName = ctx.currentName;
+        this.notifier = notifier;
+        this.requestMode = options.requestMode;
+    }
+    /** 创建会话：装配 Agent、插件与「变更信号」 */
+    static async create(options, notifier) {
+        const config = await readConfig();
+        const model = config.models.find((m) => m.id === options.modelId);
+        const maxTokens = model?.maxContextTokens ??
+            (model?.maxContextChars ? Math.floor(model.maxContextChars / 4) : undefined);
+        const agent = await createAgent({ messages: options.messages, agentId: options.agentId });
+        const currentId = options.conversationId || generateConversationId();
+        const ctx = {
+            agent,
+            input: "",
+            currentName: options.conversationName || currentId,
+            currentId,
+            modelId: options.modelId,
+            agentId: options.agentId,
+            running: true,
+        };
+        const handoffService = createHandoffService(ctx, {
+            // 迁移进度/结果经通知通道渲染，避免直接写 stdout 撕裂画面
+            log: (text) => notifier.onNotice(text, "info"),
+        });
+        ctx.handoffService = handoffService;
+        const session = new ChatSession(handoffService, ctx, options, maxTokens, notifier);
+        session.agent = agent;
+        await session.attach(agent);
+        return session;
+    }
+    /** 对话消息（唯一真相源） */
+    get messages() {
+        return this.agent.messages;
+    }
+    /** 最近一次响应的 token 用量（供「本轮 / 当前上下文占用」展示与阈值判定） */
+    get lastUsage() {
+        return this.agent.lastUsage;
+    }
+    /**
+     * 本会话累计 token 用量。
+     *
+     * 逐消息求和（`sumUsage`）：含各 assistant 消息的 `usage`（自身响应）与工具消息的
+     * `subAgentUsage`（内部委派——含所有层级子 Agent）。每轮请求都会重发完整历史，
+     * 故求和即计费口径的累计消耗；且随消息持久化，续接 / `/load` 亦不丢。
+     */
+    get totalUsage() {
+        return sumUsage(this.agent.messages);
+    }
+    /** 发送一条消息；内容变化经 `notifier.onChange` 通知，`resolve` 表示本轮结束 */
+    async send(input) {
+        try {
+            await this.agent.send(input);
+        }
+        catch (error) {
+            this.notifier.onNotice(error?.message ?? String(error), "error");
+        }
+        finally {
+            this.notifier.onChange(true);
+        }
+    }
+    /** 中止当前请求（Ctrl+C 语义：仅取消本轮，不退出） */
+    abort() {
+        this.agent.abort();
+    }
+    /**
+     * 重置会话（/new）：先把当前对话归档（有内容才存），再清空历史并重建 Agent。
+     *
+     * 归档必须先于 `currentId` 切换：`save()` 按 `this.currentId` 落盘，若先换 id
+     * 会把旧内容写到新会话文件上（等于旧对话丢失）。返回被归档的会话 id，
+     * 无内容可存时返回 null。
+     */
+    async reset() {
+        const hasContent = this.agent.messages.some((m) => m.role === AgentNS.Role.User);
+        const archivedId = hasContent ? await this.save() : null;
+        this.dispose();
+        const agent = await createAgent({
+            agentId: this.agentId === "default" ? undefined : this.agentId,
+        });
+        this.agent = agent;
+        this.ctx.agent = agent;
+        this.currentId = generateConversationId();
+        this.ctx.currentId = this.currentId;
+        this.currentName = this.currentId;
+        this.ctx.currentName = this.currentName;
+        await this.attach(agent);
+        this.notifier.onChange(true);
+        return archivedId;
+    }
+    /**
+     * 应用外部配置变更（如 `/config` 改了当前端点的 API Key / Base URL）：
+     * **保留消息与上下文**，按磁盘上的新配置重建 Agent。
+     *
+     * 关键：`getScope()` 是持有配置快照的单例，必须连同 Scope 一起重建，
+     * 否则端点凭据仍是旧的（这也是 `resetScope()` 要 `dispose` 旧实例的原因）。
+     */
+    async reload() {
+        const messages = [...this.agent.messages];
+        this.dispose();
+        await resetScope();
+        const agent = await createAgent({
+            messages,
+            agentId: this.agentId === "default" ? undefined : this.agentId,
+        });
+        this.agent = agent;
+        this.ctx.agent = agent;
+        await this.attach(agent);
+        this.notifier.onChange(true);
+    }
+    /** 手动任务迁移（`/migrate`）：交接 + 开新会话；与自动迁移共用同一服务实例 */
+    async migrate(mode) {
+        if (!this.messages.some((m) => m.role === AgentNS.Role.User)) {
+            throw new Error("当前对话还没有可迁移的内容");
+        }
+        const ctx = await this.handoffService.migrate({
+            agent: this.agent,
+            mode,
+            conversationId: this.currentId,
+        });
+        // 迁移后服务会开启新会话，同步会话元信息
+        this.currentName = this.ctx.currentName;
+        this.currentId = this.ctx.currentId ?? generateConversationId();
+        this.notifier.onChange(true);
+        return ctx.handoffPath;
+    }
+    /**
+     * 只产出交接文档（`/handoff`）：不切换会话、不改动历史。
+     *
+     * 交接回合（指令 + 工具调用 + 回执）会留在 `agent.messages` 里，
+     * 用户可继续要求细化同一份文档（重写同一路径即可）。
+     */
+    async handoff(mode) {
+        if (!this.messages.some((m) => m.role === AgentNS.Role.User)) {
+            throw new Error("当前对话还没有可交接的内容");
+        }
+        const ctx = await this.handoffService.handoff({
+            agent: this.agent,
+            mode,
+            conversationId: this.currentId,
+        });
+        this.notifier.onChange(true);
+        return ctx.handoffPath;
+    }
+    /** 撤回：删除索引 index 起的消息，返回被撤回的首条用户消息文本（用于预填输入） */
+    rollbackTo(index) {
+        if (index < 0 || index >= this.agent.messages.length)
+            return "";
+        const removed = this.agent.messages.splice(index);
+        const firstUser = removed.find((m) => m.role === AgentNS.Role.User);
+        if (typeof firstUser?.content !== "string")
+            return "";
+        return stripCwdNote(firstUser.content);
+    }
+    /** 保存当前对话到存档 */
+    async save() {
+        const id = this.currentId;
+        const existing = await conversationRepository.read(id);
+        const now = new Date().toISOString();
+        await conversationRepository.write({
+            id,
+            agentId: this.agentId,
+            modelId: this.modelId,
+            messages: this.agent.messages,
+            cwd: process.cwd(),
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+        });
+        await writeLastSession(process.cwd(), id);
+        return id;
+    }
+    /** 释放事件监听（重建 Agent 时调用，避免监听器泄漏） */
+    dispose() {
+        for (const off of this.disposers.splice(0))
+            off();
+    }
+    // ==================== 内部：装配 Agent 与插件 ====================
+    async attach(agent) {
+        agent.use(new CwdTrackerPlugin());
+        agent.use(new AutoRefreshToolsPlugin());
+        agent.use(new ConversationPersistPlugin({
+            getId: () => this.currentId,
+            agentId: this.agentId,
+            modelId: this.modelId,
+            cwd: process.cwd(),
+            onError: (text) => this.notifier.onNotice(text, "info"),
+        }));
+        if (this.maxTokens && this.maxTokens > 0) {
+            agent.use(new ContextGuardPlugin({
+                maxTokens: this.maxTokens,
+                // 交接回合放宽阈值（而非放行）：交接恰好发生在上下文最满的时刻，
+                // 且交接回合本身还要再发请求，不放宽会被护栏误杀；放宽仍保留熔断
+                isSuspended: () => this.handoffService.busy,
+            }));
+            agent.use(createAutoMigratePlugin({
+                service: this.handoffService,
+                maxTokens: this.maxTokens,
+                // TUI 下由 Ink 层提供执行者选择器；无选择通道时按默认执行者（原 agent 自交接）迁移
+                shouldConfirm: () => Boolean(this.requestMode),
+                choose: (info) => this.requestMode(info),
+                log: (text) => this.notifier.onNotice(text, "info"),
+            }));
+            agent.use(new SubAgentGuardInstallerPlugin({ maxTokens: this.maxTokens }));
+        }
+        this.wire(agent);
+        await agent.init();
+    }
+    /**
+     * 订阅 SDK 事件，仅把它们当作「messages 可能已变化」的信号：
+     * - `chunk-parsed`（每片 delta 应用后）：高频 → 走合帧（`immediate=false`）；
+     * - `open` / `parsed` / `finally`：轮次边界 → 立即上屏；
+     * - `error`：转发到通知通道。
+     */
+    wire(agent) {
+        const notify = (immediate) => this.notifier.onChange(immediate);
+        const onOpen = () => notify(true);
+        const onChunk = () => notify(false);
+        const onParsed = () => notify(true);
+        const onFinally = () => notify(true);
+        const onError = (error) => {
+            this.notifier.onNotice(error?.message ?? String(error), "error");
+            notify(true);
+        };
+        const onSubStart = ({ subAgent, toolCallContext }) => {
+            const name = toolCallContext?.tool_call?.function?.name || "子任务";
+            this.notifier.onNotice(`🧩 子任务 ${name} 运行中…`, "info");
+            subAgent.events.on("open", onOpen);
+            subAgent.events.on("chunk-parsed", onChunk);
+            subAgent.events.on("error", onError);
+            notify(true);
+        };
+        const onSubEnd = ({ toolCallContext }) => {
+            const name = toolCallContext?.tool_call?.function?.name || "子任务";
+            // 子 Agent 的用量由 core 在委派边界钉到父侧 tool 消息的 subAgentUsage 上，
+            // 故此处只需提示，累计经 sumUsage(agent.messages) 自然包含
+            this.notifier.onNotice(`✓ 子任务 ${name} 完成`, "info");
+            notify(true);
+        };
+        agent.events.on("open", onOpen);
+        agent.events.on("chunk-parsed", onChunk);
+        agent.events.on("parsed", onParsed);
+        agent.events.on("finally", onFinally);
+        agent.events.on("error", onError);
+        agent.events.on("sub-agent-start", onSubStart);
+        agent.events.on("sub-agent-end", onSubEnd);
+        this.disposers.push(() => {
+            agent.events.off("open", onOpen);
+            agent.events.off("chunk-parsed", onChunk);
+            agent.events.off("parsed", onParsed);
+            agent.events.off("finally", onFinally);
+            agent.events.off("error", onError);
+            agent.events.off("sub-agent-start", onSubStart);
+            agent.events.off("sub-agent-end", onSubEnd);
+        });
+    }
+}
+//# sourceMappingURL=chat-session.js.map

package/dist/tui/chat-session.js.map

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

package/dist/tui/components.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Ink 通用组件 —— Spinner / 选择列表 / 状态栏 / 斜杠命令菜单 / 键位提示
+ */
+import type { CommandHint } from "../conversation-commands/registry.js";
+export declare function Spinner({ label }: {
+    label?: string;
+}): import("react").JSX.Element;
+export interface SelectItem<T> {
+    label: string;
+    value: T;
+    hint?: string;
+    icon?: string;
+}
+export interface SelectListProps<T> {
+    items: SelectItem<T>[];
+    onSelect: (value: T) => void;
+    isActive?: boolean;
+    initialIndex?: number;
+    /**
+     * 终端列数：提供时把每项裁成严格单行。
+     *
+     * 「吸底」布局的顶部留白是按行数算的，任一条目折行都会多占一行、把整帧顶高一格，
+     * 故列表类屏幕必须传它。
+     */
+    columns?: number;
+}
+export declare function SelectList<T>({ items, onSelect, isActive, initialIndex, columns }: SelectListProps<T>): import("react").JSX.Element;
+export interface StatusBarProps {
+    model: string;
+    agent: string;
+    /** 最近一轮的 token 用量（lastUsage.total_tokens） */
+    lastTokens?: number;
+    /** 本会话累计 token 用量（含子 Agent） */
+    totalTokens?: number;
+    busy?: boolean;
+    hint?: string;
+}
+export declare function StatusBar({ model, agent, lastTokens, totalTokens, busy, hint }: StatusBarProps): import("react").JSX.Element;
+export interface SlashMenuProps {
+    hints: CommandHint[];
+    selected: number;
+}
+export declare function SlashMenu({ hints, selected }: SlashMenuProps): import("react").JSX.Element;
+export declare function KeyHints({ hints }: {
+    hints: [string, string][];
+}): import("react").JSX.Element;
+//# sourceMappingURL=components.d.ts.map

package/dist/tui/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/tui/components.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAMxE,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,+BAYpD;AAID,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAe,EAAE,YAAgB,EAAE,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,+BAsChH;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,cAAc,+BAiB9F;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,cAAc,+BAiB5D;AAID,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;CAAE,+BAUhE"}