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

package/dist/tui/mouse.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 鼠标滚轮支持 —— 终端模式开关 + SGR 上报解析
+ *
+ * 为什么需要自己实现：Ink 7 没有 `useMouse`（整个 `ink/build` 里 "mouse" 只出现在
+ * `measure-element.js` 的一句注释中），终端也默认**不把**鼠标事件发给应用——滚轮被
+ * 终端自己拿去滚 scrollback。要收到滚轮，必须由应用主动打开终端上报模式。
+ *
+ * 两种编码，只认后者：
+ *   - `DECSET 1000`：上报「按钮按下 / 释放」（滚轮也算按钮），是收到滚轮的前提；
+ *   - `DECSET 1006`：改用 SGR 扩展坐标 `CSI < b ; x ; y M`（释放为 `m`）。**必须开**：
+ *     老的 X10 编码（`CSI M` + 3 个原始字节）会被 Ink 的输入解析器拆成 `[M` 和三个
+ *     普通字符两条事件，后者会被当正文插进输入框（已实测重现）。
+ *
+ * 上报到 Ink 的形态（pty 实测）：`useInput` 的 `char` 是 `"[<64;10;5M"`，`key` 的
+ * 所有标志位都是 false。也就是说**鼠标序列和用户打字走的是同一条路**——任何可能插入
+ * 文本的处理器都必须先拦一道（见 `isTerminalReply` 与各屏守卫）。
+ *
+ * 取舍（用户已知情并选择开启）：
+ *   - 点击 / 拖拽被应用吃掉，多数终端需按住 `Shift` 才回退到原生选词复制；
+ *   - tmux / screen 需 `set -g mouse off`，否则滚轮先被多路复用器拦进 copy-mode；
+ *   - 应用内滚动只动视口，不产生终端 scrollback。
+ */
+/** 开启上报：1000（按钮事件，含滚轮）+ 1006（SGR 扩展坐标） */
+export declare const MOUSE_ENABLE = "\u001B[?1000h\u001B[?1006h";
+/** 关闭上报。任何退出路径都必须下发，否则 shell 提示符后面会开始吐 `^[[<64;…M` */
+export declare const MOUSE_DISABLE = "\u001B[?1000l\u001B[?1006l";
+/** 滚轮一格滚动的行数（各终端应用的通行值） */
+export declare const WHEEL_STEP = 3;
+export interface WheelEvent {
+    /** `-1` = 向上滚（回看更早的内容），`1` = 向下滚（回到更新的内容） */
+    direction: -1 | 1;
+    /** 终端列（1-based），当前仅用于将来做「按鼠标位置定位」 */
+    x: number;
+    /** 终端行（1-based） */
+    y: number;
+}
+/** 是否为鼠标上报序列（滚轮、点击、拖拽、移动都算） */
+export declare function isMouseSequence(input: string): boolean;
+/**
+ * 从鼠标序列中解出滚轮事件；不是滚轮（点击 / 拖拽 / 横向滚轮）返回 `null`。
+ *
+ * SGR 的按钮码：`64` 滚轮上、`65` 滚轮下、`66` / `67` 横向滚轮。横向在这个视口里
+ * 没有对应维度，直接丢弃——否则横向滚一下就莫名其妙跳几行。
+ */
+export declare function parseWheel(input: string): WheelEvent | null;
+/**
+ * 打开终端鼠标上报。
+ *
+ * 输出的是纯模式设置序列（不打印字符、不移动光标），因此可以安全地直接写 stdout，
+ * 不会与 Ink 的增量重绘打架。重复下发是幂等的。
+ */
+export declare function enableMouseTracking(stream?: NodeJS.WriteStream): void;
+/** 关闭终端鼠标上报（幂等）。退出 / 信号 / 异常路径都要调用。 */
+export declare function disableMouseTracking(stream?: NodeJS.WriteStream): void;
+//# sourceMappingURL=mouse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../src/tui/mouse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,YAAY,+BAA+B,CAAC;AAEzD,sDAAsD;AACtD,eAAO,MAAM,aAAa,+BAA+B,CAAC;AAE1D,2BAA2B;AAC3B,eAAO,MAAM,UAAU,IAAI,CAAC;AAa5B,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAClB,qCAAqC;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;CACX;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAU3D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,MAAM,CAAC,WAA4B,GAAG,IAAI,CAErF;AAED,uCAAuC;AACvC,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAAM,CAAC,WAA4B,GAAG,IAAI,CAEtF"}

package/dist/tui/mouse.js

@@ -0,0 +1,74 @@
+/**
+ * 鼠标滚轮支持 —— 终端模式开关 + SGR 上报解析
+ *
+ * 为什么需要自己实现：Ink 7 没有 `useMouse`（整个 `ink/build` 里 "mouse" 只出现在
+ * `measure-element.js` 的一句注释中），终端也默认**不把**鼠标事件发给应用——滚轮被
+ * 终端自己拿去滚 scrollback。要收到滚轮，必须由应用主动打开终端上报模式。
+ *
+ * 两种编码，只认后者：
+ *   - `DECSET 1000`：上报「按钮按下 / 释放」（滚轮也算按钮），是收到滚轮的前提；
+ *   - `DECSET 1006`：改用 SGR 扩展坐标 `CSI < b ; x ; y M`（释放为 `m`）。**必须开**：
+ *     老的 X10 编码（`CSI M` + 3 个原始字节）会被 Ink 的输入解析器拆成 `[M` 和三个
+ *     普通字符两条事件，后者会被当正文插进输入框（已实测重现）。
+ *
+ * 上报到 Ink 的形态（pty 实测）：`useInput` 的 `char` 是 `"[<64;10;5M"`，`key` 的
+ * 所有标志位都是 false。也就是说**鼠标序列和用户打字走的是同一条路**——任何可能插入
+ * 文本的处理器都必须先拦一道（见 `isTerminalReply` 与各屏守卫）。
+ *
+ * 取舍（用户已知情并选择开启）：
+ *   - 点击 / 拖拽被应用吃掉，多数终端需按住 `Shift` 才回退到原生选词复制；
+ *   - tmux / screen 需 `set -g mouse off`，否则滚轮先被多路复用器拦进 copy-mode；
+ *   - 应用内滚动只动视口，不产生终端 scrollback。
+ */
+/** 开启上报：1000（按钮事件，含滚轮）+ 1006（SGR 扩展坐标） */
+export const MOUSE_ENABLE = "\u001b[?1000h\u001b[?1006h";
+/** 关闭上报。任何退出路径都必须下发，否则 shell 提示符后面会开始吐 `^[[<64;…M` */
+export const MOUSE_DISABLE = "\u001b[?1000l\u001b[?1006l";
+/** 滚轮一格滚动的行数（各终端应用的通行值） */
+export const WHEEL_STEP = 3;
+/**
+ * SGR 鼠标上报：`CSI < b ; x ; y M|m`。
+ *
+ * 前导 ESC 可有可无 —— Ink 喂给 `useInput` 的 `char` 已被剥掉 ESC（实测为 `[<64;…`），
+ * 但直接处理原始 stdin 数据时它还带着，两种都接受才不会漏。
+ */
+const SGR_MOUSE = /^(?:\u001b)?\[<(\d+);(\d+);(\d+)([Mm])$/;
+/** 修饰位：Shift(4) / Meta(8) / Ctrl(16) / Motion(32) —— 判定滚轮前要剥掉 */
+const MODIFIER_BITS = 0b11100;
+/** 是否为鼠标上报序列（滚轮、点击、拖拽、移动都算） */
+export function isMouseSequence(input) {
+    return SGR_MOUSE.test(input);
+}
+/**
+ * 从鼠标序列中解出滚轮事件；不是滚轮（点击 / 拖拽 / 横向滚轮）返回 `null`。
+ *
+ * SGR 的按钮码：`64` 滚轮上、`65` 滚轮下、`66` / `67` 横向滚轮。横向在这个视口里
+ * 没有对应维度，直接丢弃——否则横向滚一下就莫名其妙跳几行。
+ */
+export function parseWheel(input) {
+    const match = SGR_MOUSE.exec(input);
+    if (!match)
+        return null;
+    const code = Number(match[1]) & ~MODIFIER_BITS;
+    if (code !== 64 && code !== 65)
+        return null;
+    return {
+        direction: code === 64 ? -1 : 1,
+        x: Number(match[2]),
+        y: Number(match[3]),
+    };
+}
+/**
+ * 打开终端鼠标上报。
+ *
+ * 输出的是纯模式设置序列（不打印字符、不移动光标），因此可以安全地直接写 stdout，
+ * 不会与 Ink 的增量重绘打架。重复下发是幂等的。
+ */
+export function enableMouseTracking(stream = process.stdout) {
+    stream.write(MOUSE_ENABLE);
+}
+/** 关闭终端鼠标上报（幂等）。退出 / 信号 / 异常路径都要调用。 */
+export function disableMouseTracking(stream = process.stdout) {
+    stream.write(MOUSE_DISABLE);
+}
+//# sourceMappingURL=mouse.js.map

package/dist/tui/mouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouse.js","sourceRoot":"","sources":["../../src/tui/mouse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAE1D,2BAA2B;AAC3B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,SAAS,GAAG,yCAAyC,CAAC;AAE5D,iEAAiE;AACjE,MAAM,aAAa,GAAG,OAAO,CAAC;AAW9B,+BAA+B;AAC/B,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;IAC/C,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO;QACL,SAAS,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACpB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAA6B,OAAO,CAAC,MAAM;IAC7E,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAC7B,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,oBAAoB,CAAC,SAA6B,OAAO,CAAC,MAAM;IAC9E,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AAC9B,CAAC"}

package/dist/tui/phase.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 生成阶段 —— 消息栏那一行提示的六态判定（纯逻辑，不依赖 React / Ink / SDK）
+ *
+ * 原先那里只有一个「思考中…」，但一轮对话里模型实际会走过几个阶段，用同一个词概括
+ * 在多数时候是**说错话**：等首 token 时并没有在思考，工具执行时更是模型根本没在跑。
+ * 于是按数据来源把阶段拆细：
+ *
+ * | 阶段 | 判据 | 用户真正关心什么 |
+ * |------|------|------------------|
+ * | `connecting` | `onInnerLoopStart`（请求即将发出）→ `open`（响应头到达） | 是不是网络卡住了 |
+ * | `queued` | `open` 之后、首个内容 chunk 之前 | 服务端排队 / 冷启动，还没开始吐字 |
+ * | `thinking` | 收到 `reasoning_content` delta | 推理模型中 |
+ * | `tool-calling` | 收到 `tool_calls` / `function_call` delta | 模型正在决定调哪个工具、拼参数 |
+ * | `tool-waiting` | 流结束（`parsed`）且该轮带工具调用 | 工具在执行，等结果回来才能继续 |
+ * | `streaming` | 收到 `content` delta | 正在输出正文 |
+ *
+ * 判据只用**事件与 delta 的形状**，不读文案、不猜时序；多轮工具调用时阶段会自然
+ * 回到 `connecting`（下一轮请求前由插件钩子重置）。
+ */
+/** 生成阶段（见文件头表格） */
+export type PhaseKind = "connecting" | "queued" | "thinking" | "tool-calling" | "tool-waiting" | "streaming";
+export interface PhaseInfo {
+    kind: PhaseKind;
+    /** 工具名（`tool-calling` / `tool-waiting` 时有值；流式早期可能还没吐到 name） */
+    tool?: string;
+}
+/**
+ * 阶段跟踪器。生命周期由 `ChatSession` 驱动：
+ * `connecting()` → `opened()` → 若干 `delta()` → `streamEnded()` →（下一轮）`connecting()` …
+ * 一轮结束调 `reset()`。
+ */
+export declare class PhaseTracker {
+    private current;
+    /** 当前阶段；空闲（没有在生成的轮次）时为 null */
+    get phase(): PhaseInfo | null;
+    /** 清空（一轮结束 / 重建会话时调用） */
+    reset(): void;
+    /** 请求已发出、等响应头（DNS / TCP / TLS / 服务端受理都在这一段） */
+    connecting(): void;
+    /**
+     * 响应头已到（SDK 的 `open` 事件）——连接建立，进入「等首 token」。
+     *
+     * 注意不能在这里直接进 `thinking`：`open` 只说明服务端受理了请求，
+     * 推理模型冷启动排几十秒是常事，那段等待被叫成「思考中」就是在骗人。
+     */
+    opened(): void;
+    /**
+     * 收到一个流式 chunk：按 delta 的实际内容推进阶段。
+     *
+     * 优先级是 `tool_calls` > `content` > `reasoning_content`：一个 chunk 里同时出现
+     * 时，靠后的才代表「模型现在在干什么」（决定调工具 → 工具参数；已经出正文 →
+     * 思考阶段结束）。三者都没有（如只带 `usage` 的收尾 chunk）则保持原阶段不变。
+     */
+    delta(chunk: unknown): void;
+    /**
+     * 流结束（SDK 的 `parsed` 事件，参数是本轮 assistant 消息）。
+     *
+     * 本轮带工具调用 → 接下来是工具执行，模型不在跑；不带 → 由调用方 `reset()`。
+     */
+    streamEnded(receiver: unknown): void;
+}
+/** 阶段对应的提示文案（中英由词典决定，这里只做分发） */
+export declare function phaseLabel(phase: PhaseInfo | null): string;
+//# sourceMappingURL=phase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/tui/phase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,mBAAmB;AACnB,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,cAAc,GACd,cAAc,GACd,WAAW,CAAC;AAEhB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAA0B;IAEzC,+BAA+B;IAC/B,IAAI,KAAK,IAAI,SAAS,GAAG,IAAI,CAE5B;IAED,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAIb,+CAA+C;IAC/C,UAAU,IAAI,IAAI;IAIlB;;;;;OAKG;IACH,MAAM,IAAI,IAAI;IAId;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAqB3B;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;CAQrC;AAED,gCAAgC;AAChC,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAoB1D"}

package/dist/tui/phase.js

@@ -0,0 +1,112 @@
+/**
+ * 生成阶段 —— 消息栏那一行提示的六态判定（纯逻辑，不依赖 React / Ink / SDK）
+ *
+ * 原先那里只有一个「思考中…」，但一轮对话里模型实际会走过几个阶段，用同一个词概括
+ * 在多数时候是**说错话**：等首 token 时并没有在思考，工具执行时更是模型根本没在跑。
+ * 于是按数据来源把阶段拆细：
+ *
+ * | 阶段 | 判据 | 用户真正关心什么 |
+ * |------|------|------------------|
+ * | `connecting` | `onInnerLoopStart`（请求即将发出）→ `open`（响应头到达） | 是不是网络卡住了 |
+ * | `queued` | `open` 之后、首个内容 chunk 之前 | 服务端排队 / 冷启动，还没开始吐字 |
+ * | `thinking` | 收到 `reasoning_content` delta | 推理模型中 |
+ * | `tool-calling` | 收到 `tool_calls` / `function_call` delta | 模型正在决定调哪个工具、拼参数 |
+ * | `tool-waiting` | 流结束（`parsed`）且该轮带工具调用 | 工具在执行，等结果回来才能继续 |
+ * | `streaming` | 收到 `content` delta | 正在输出正文 |
+ *
+ * 判据只用**事件与 delta 的形状**，不读文案、不猜时序；多轮工具调用时阶段会自然
+ * 回到 `connecting`（下一轮请求前由插件钩子重置）。
+ */
+import { t } from "../i18n/index.js";
+/**
+ * 阶段跟踪器。生命周期由 `ChatSession` 驱动：
+ * `connecting()` → `opened()` → 若干 `delta()` → `streamEnded()` →（下一轮）`connecting()` …
+ * 一轮结束调 `reset()`。
+ */
+export class PhaseTracker {
+    current = null;
+    /** 当前阶段；空闲（没有在生成的轮次）时为 null */
+    get phase() {
+        return this.current;
+    }
+    /** 清空（一轮结束 / 重建会话时调用） */
+    reset() {
+        this.current = null;
+    }
+    /** 请求已发出、等响应头（DNS / TCP / TLS / 服务端受理都在这一段） */
+    connecting() {
+        this.current = { kind: "connecting" };
+    }
+    /**
+     * 响应头已到（SDK 的 `open` 事件）——连接建立，进入「等首 token」。
+     *
+     * 注意不能在这里直接进 `thinking`：`open` 只说明服务端受理了请求，
+     * 推理模型冷启动排几十秒是常事，那段等待被叫成「思考中」就是在骗人。
+     */
+    opened() {
+        this.current = { kind: "queued" };
+    }
+    /**
+     * 收到一个流式 chunk：按 delta 的实际内容推进阶段。
+     *
+     * 优先级是 `tool_calls` > `content` > `reasoning_content`：一个 chunk 里同时出现
+     * 时，靠后的才代表「模型现在在干什么」（决定调工具 → 工具参数；已经出正文 →
+     * 思考阶段结束）。三者都没有（如只带 `usage` 的收尾 chunk）则保持原阶段不变。
+     */
+    delta(chunk) {
+        const delta = chunk?.choices?.[0]?.delta;
+        if (!delta || typeof delta !== "object")
+            return;
+        const toolCall = Array.isArray(delta.tool_calls) ? delta.tool_calls[0] : undefined;
+        if (toolCall || delta.function_call) {
+            // 工具名只在首个 delta 里给出，后续 delta 只带参数片段 → 沿用已知的名字
+            const name = toolCall?.function?.name || delta.function_call?.name || this.current?.tool;
+            this.current = { kind: "tool-calling", tool: name || undefined };
+            return;
+        }
+        if (delta.content) {
+            this.current = { kind: "streaming" };
+            return;
+        }
+        if (delta.reasoning_content) {
+            this.current = { kind: "thinking" };
+        }
+    }
+    /**
+     * 流结束（SDK 的 `parsed` 事件，参数是本轮 assistant 消息）。
+     *
+     * 本轮带工具调用 → 接下来是工具执行，模型不在跑；不带 → 由调用方 `reset()`。
+     */
+    streamEnded(receiver) {
+        const message = receiver;
+        const calls = Array.isArray(message?.tool_calls) ? message.tool_calls : [];
+        if (calls.length === 0 && !message?.function_call)
+            return;
+        const name = calls[0]?.function?.name || message?.function_call?.name || this.current?.tool;
+        this.current = { kind: "tool-waiting", tool: name || undefined };
+    }
+}
+/** 阶段对应的提示文案（中英由词典决定，这里只做分发） */
+export function phaseLabel(phase) {
+    if (!phase)
+        return t("phase.working");
+    switch (phase.kind) {
+        case "connecting":
+            return t("phase.connecting");
+        case "queued":
+            return t("phase.queued");
+        case "thinking":
+            return t("phase.thinking");
+        case "streaming":
+            return t("phase.streaming");
+        case "tool-calling":
+            return phase.tool
+                ? t("phase.toolCallingWith", { name: phase.tool })
+                : t("phase.toolCalling");
+        case "tool-waiting":
+            return phase.tool
+                ? t("phase.toolWaitingWith", { name: phase.tool })
+                : t("phase.toolWaiting");
+    }
+}
+//# sourceMappingURL=phase.js.map

package/dist/tui/phase.js.map

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

package/dist/tui/screens/chat-commands.d.ts

@@ -1,11 +1,15 @@
-import { Dispatch, SetStateAction } from "react";
+import type { Dispatch, SetStateAction } from "react";
+import type { HandoffMode } from "@ai-zen/agents-sdk";
 import { SelectItem } from "../components.js";
 import { ChatSession } from "../chat-session.js";
+import { type CommandName } from "../../conversation-commands/registry.js";
 import { WizardStep } from "../config-wizard/index.js";
-import { ChatAction } from "./state.js";
 export interface ChatCommandHost {
     session: ChatSession;
-    dispatch: Dispatch<ChatAction>;
+    /** 通知通道：命令反馈（保存 / 清除 / 迁移结果 …）走独立栏位，不进 messages */
+    notice: (text: string, tone?: "info" | "error") => void;
+    /** 清屏（保留上下文）：把转录显示起点推到最新 */
+    clearTranscript: () => void;
     rows: number;
     exit: (arg?: any) => void;
     suspendTerminal: (fn: () => void | Promise<void>) => Promise<void>;
@@ -22,6 +26,63 @@ export interface ChatCommandHost {
         resolve: (value: boolean) => void;
     } | null>>;
     setInputText: (text: string) => void;
+    /** 更新状态栏的思考强度展示（`/think` 写入后由上层重取）；文案与置灰一起给，避免漂移 */
+    setEffortView: (view: {
+        text: string;
+        dimmed: boolean;
+    } | null) => void;
+    /**
+     * 触发一次界面重渲染（`/lang` 切换语言后用）。
+     *
+     * `t()` 是模块级函数，语言一变，已渲染的文案不会自己更新 —— 必须让 React
+     * 重新执行一遍渲染函数才能取到新语言。这里只递增一个计数，不携带任何状态。
+     */
+    refreshLocale: () => void;
 }
+/**
+ * 执行者参数（`/migrate self`）的解析结果。
+ *
+ * 分成「合法值」与「非法原值」两个字段，而不是一个 boolean + 一个 `string | undefined`：
+ * 调用方一看到 `invalid` 有值就能直接回显，不需要靠类型收窄去猜。
+ */
+export interface HandoffSelection {
+    /** 显式指定且合法的执行者（`self` / `summary`）；未指定为 `undefined` */
+    mode: HandoffMode | undefined;
+    /** 显式指定但不合法的原值（报错回显用） */
+    invalid: string | undefined;
+}
+/** 单个命令的执行上下文：宿主能力 + 已解析的参数 */
+export interface CommandContext extends ChatCommandHost {
+    /** 命中命令的**主名**（别名已归一：`/effort` → `think`、`/quit` → `exit`） */
+    name: CommandName;
+    /** 原始输入（含 `/`），用于「未知命令」等场景回显 */
+    raw: string;
+    /** 首个 token 之后的参数（`/migrate summary` → `["summary"]`） */
+    args: string[];
+    /** 通知（默认 info 语气） */
+    push: (text: string, tone?: "info" | "error") => void;
+    /**
+     * 弹选择器并等用户作答（取消为 `null`），由各命令自己决定取消后说什么。
+     */
+    pick: (title: string, items: SelectItem<string>[]) => Promise<string | null>;
+}
+/**
+ * 解析命令后的执行者参数（`/migrate self`、`/handoff summary`）。
+ * 缺省返回 undefined（走服务默认值）；非法值也返回 undefined，由调用方报错。
+ */
+export declare function parseHandoffMode(raw?: string): HandoffMode | undefined;
+/**
+ * 解析 `/handoff` `/migrate` 的执行者参数。
+ *
+ * 单独成函数而不是挂在 `CommandContext` 上：16 个命令里只有这两个用得到，
+ * 挂在上下文中会让另外 14 个命令（`/save` `/help` `/clear` …）每次也白算一遍。
+ */
+export declare function parseHandoffSelection(args: readonly string[]): HandoffSelection;
+/**
+ * 执行一条斜杠命令。
+ *
+ * @param name 命令名（含别名，大小写不敏感；由 `parseCommandInput()` 从输入里取出）
+ * @param raw  原始输入（含 `/`），用于参数解析与错误回显
+ */
 export declare function runCommand(name: string, raw: string, host: ChatCommandHost): Promise<void>;
 //# sourceMappingURL=chat-commands.d.ts.map

package/dist/tui/screens/chat-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-commands.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/chat-commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAMjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAgB,MAAM,oBAAoB,CAAC;AAI/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC1B,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,cAAc,EAAE,QAAQ,CACtB,cAAc,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,CAC/G,CAAC;IACF,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1G,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA+KhG"}
+{"version":3,"file":"chat-commands.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/chat-commands.ts"],"names":[],"mappings":"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"}