@ai-zen/cli 1.0.0-alpha.20 → 1.0.0-alpha.23

package/dist/tui/input-editing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-editing.d.ts","sourceRoot":"","sources":["../../src/tui/input-editing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qCAAqC;AACrC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAU9E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhE;AAGD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,SAAiB,GAAG,MAAM,EAAE,CAIzF;AAED,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE;AAID,qCAAqC;AACrC,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,SAAa,GAAG,SAAS,EAAE,CAI9F;AAED,0BAA0B;AAC1B,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,IAAI,CAG1F"}
+{"version":3,"file":"input-editing.d.ts","sourceRoot":"","sources":["../../src/tui/input-editing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,6BAA6B;AAC7B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAU9E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhE;AAGD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,SAAiB,GAAG,MAAM,EAAE,CAIzF;AAED,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE;AAID,qCAAqC;AACrC,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,SAAa,GAAG,SAAS,EAAE,CAI9F;AAED,0BAA0B;AAC1B,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,IAAI,CAG1F"}

package/dist/tui/input-editing.js

@@ -4,10 +4,14 @@
  * 全部函数都是「(文本, 光标) → (文本, 光标)」的纯变换，便于单测；
  * chat.tsx 只负责把按键映射过来、套用结果、维护 kill ring 与撤销栈。
  *
+ * 光标单位是**字素簇**（`graphemes`），不是 code point：`✌️` 是 2 个 code point
+ * 但只是 1 个簇，按 code point 删会只删掉半个 emoji、留下孤立的变体选择符。
+ *
  * 键位语义依据 Claude Code 官方文档（interactive-mode.md）：
  * - `Ctrl+W` 删到**前一空白**（标点不切分：`src/utils/foo.ts` 一次删掉整条路径）
  * - `Alt+B/F/D` 按「词」处理（标点算分隔符：停在 `ts` / `foo` / `utils` / `src`）
  */
+import { graphemes } from "./text.js";
 function clampCursor(chars, cursor) {
     return Math.max(0, Math.min(cursor, chars.length));
 }
@@ -18,7 +22,7 @@ function clampCursor(chars, cursor) {
  * 因此 `src/utils/foo.ts` 会被整段删除，而不是只删 `foo.ts`。
  */
 export function deleteToPrevWhitespace(text, cursor) {
-    const chars = Array.from(text);
+    const chars = graphemes(text);
     const cp = clampCursor(chars, cursor);
     let from = cp;
     while (from > 0 && /\s/.test(chars[from - 1]))
@@ -37,8 +41,8 @@ export function deleteToPrevWhitespace(text, cursor) {
  * 免去每个删除函数各自返回「删了什么」。
  */
 export function killedText(before, after) {
-    const a = Array.from(before);
-    const b = Array.from(after);
+    const a = graphemes(before);
+    const b = graphemes(after);
     let prefix = 0;
     while (prefix < b.length && a[prefix] === b[prefix])
         prefix += 1;

package/dist/tui/input-editing.js.map

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

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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AAiBrC;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACf,OAAO,GAAqB,IAAI,CAAC;IAEzC,+BAA+B;IAC/B,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,yBAAyB;IACzB,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,+CAA+C;IAC/C,UAAU;QACR,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAc;QAClB,MAAM,KAAK,GAAI,KAAa,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QAClD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO;QAEhD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,IAAI,QAAQ,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACpC,8CAA8C;YAC9C,MAAM,IAAI,GACR,QAAQ,EAAE,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,aAAa,EAAE,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;YAC9E,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,IAAI,SAAS,EAAE,CAAC;YACjE,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,QAAiB;QAC3B,MAAM,OAAO,GAAG,QAAe,CAAC;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa;YAAE,OAAO;QAC1D,MAAM,IAAI,GACR,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,IAAI,OAAO,EAAE,aAAa,EAAE,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;QACjF,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,IAAI,SAAS,EAAE,CAAC;IACnE,CAAC;CACF;AAED,gCAAgC;AAChC,MAAM,UAAU,UAAU,CAAC,KAAuB;IAChD,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC;IACtC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY;YACf,OAAO,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,WAAW;YACd,OAAO,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,cAAc;YACjB,OAAO,KAAK,CAAC,IAAI;gBACf,CAAC,CAAC,CAAC,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBAClD,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAC7B,KAAK,cAAc;YACjB,OAAO,KAAK,CAAC,IAAI;gBACf,CAAC,CAAC,CAAC,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBAClD,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/tui/screens/agent-tabs.d.ts

@@ -0,0 +1,53 @@
+/** 一个可切换的 Agent 条目 */
+export interface AgentTab {
+    /** 稳定 id：`"main"` 或子 Agent 视图 id */
+    id: string;
+    /** 展示名（主 Agent 用 `agentTabs.main`，子 Agent 用 `agentTabs.sub` 带序号） */
+    label: string;
+    /** 执行状态；undefined = 不画圆点（主 Agent 的忙碌由输入行的 Spinner 表示） */
+    status?: AgentTabStatus;
+}
+/** 子 Agent 的执行状态 */
+export type AgentTabStatus = "running" | "done" | "failed";
+/**
+ * 状态符号：三种状态**同形不同色**（蓝 / 绿 / 红）。
+ *
+ * 用 `◈`（U+25C8）：比 `•` 更像个「状态指示符」，又不像 `●` 那样把一行密集文本撑得松散。
+ * 符号位于标签**之前**，使各标签的文字起始位置对齐。
+ */
+export declare const AGENT_STATUS_DOT = "\u25C8";
+/**
+ * 状态圆点的颜色 —— 状态的**唯一视觉真相**。
+ *
+ * 运行中在「亮蓝 ↔ 暗」之间交替（闪烁），其余状态恒定。抽成纯函数是因为颜色没法在
+ * 测试里断言（`ink-testing-library` 的 stdout 不是 TTY，Ink 不输出 ANSI）。
+ *
+ * @param blinkOn 仅对 `running` 有意义：false 时返回暗色，形成一亮一暗的闪烁
+ */
+export declare function agentStatusColor(status: AgentTabStatus, blinkOn?: boolean): string;
+/** 闪烁周期（毫秒）：一亮一暗为一个完整周期 */
+export declare const AGENT_BLINK_MS = 500;
+/**
+ * 运行中时返回随时间翻转的开关（其余时候恒为 true，且不启定时器）。
+ *
+ * 定时器只在本组件内驱动自己的重渲染，不牵动上层：`AgentTabs` 的 state 变化只影响
+ * 它自己这一行。
+ */
+export declare function useBlink(active: boolean, intervalMs?: number): boolean;
+/**
+ * 单个栏目的样式 —— 高亮规则的**唯一真相源**（组件与测试共用）。
+ *
+ * 抽成纯函数是因为颜色没法在测试里断言，只能锁样式契约。
+ */
+export declare function agentTabStyle(active: boolean): {
+    color: string;
+    bold: boolean;
+    backgroundColor?: string;
+};
+export interface AgentTabsProps {
+    tabs: readonly AgentTab[];
+    /** 当前选中的 id；不在 `tabs` 里时按「主 Agent」处理 */
+    activeId: string;
+}
+export declare function AgentTabs({ tabs, activeId }: AgentTabsProps): import("react").JSX.Element;
+//# sourceMappingURL=agent-tabs.d.ts.map

package/dist/tui/screens/agent-tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tabs.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/agent-tabs.tsx"],"names":[],"mappings":"AAgBA,sBAAsB;AACtB,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,oBAAoB;AACpB,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,WAAM,CAAC;AAEpC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,UAAO,GAAG,MAAM,CAG/E;AAED,2BAA2B;AAC3B,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,SAAiB,GAAG,OAAO,CAW9E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAOA;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,cAAc,+BA0B3D"}

package/dist/tui/screens/agent-tabs.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Agent 栏目 —— 主 Agent 与各子 Agent 之间的切换条。
+//
+// 位置固定在「消息列表下方、通知栏上方」：它切换的是消息列表的内容，所以要紧贴
+// 被它控制的那块区域。行为（何时出现、左右键怎么分流）在 chat.tsx，这里只负责画。
+//
+// 宽度：整条栏目**恰好占一行**。它参与 `computeChatLayout` 的底部高度预算，一旦
+// Ink 自己折出第二行，整帧就会比预算高一行、把输入框顶出屏幕。
+// 所以外层 `<Text wrap="truncate">` 兜住宽度，内层嵌套 `<Text>` 保住逐项着色
+// （Ink 里截断发生在带 `wrap` 的那一层，不会把内层样式丢掉）。
+//
+// 执行状态内联在标签**前**（一个圆点 + 颜色），不另推通知：通知栏凭空多一行会让整帧
+// 高度跳一下。运行中的圆点会闪烁（亮蓝 ↔ 暗），完成后恒为绿色，失败恒为红色。
+import { useEffect, useState } from "react";
+import { Box, Text } from "ink";
+import { theme } from "../theme.js";
+/**
+ * 状态符号：三种状态**同形不同色**（蓝 / 绿 / 红）。
+ *
+ * 用 `◈`（U+25C8）：比 `•` 更像个「状态指示符」，又不像 `●` 那样把一行密集文本撑得松散。
+ * 符号位于标签**之前**，使各标签的文字起始位置对齐。
+ */
+export const AGENT_STATUS_DOT = "◈";
+/**
+ * 状态圆点的颜色 —— 状态的**唯一视觉真相**。
+ *
+ * 运行中在「亮蓝 ↔ 暗」之间交替（闪烁），其余状态恒定。抽成纯函数是因为颜色没法在
+ * 测试里断言（`ink-testing-library` 的 stdout 不是 TTY，Ink 不输出 ANSI）。
+ *
+ * @param blinkOn 仅对 `running` 有意义：false 时返回暗色，形成一亮一暗的闪烁
+ */
+export function agentStatusColor(status, blinkOn = true) {
+    if (status === "running")
+        return blinkOn ? theme.running : theme.faint;
+    return status === "done" ? theme.ok : theme.error;
+}
+/** 闪烁周期（毫秒）：一亮一暗为一个完整周期 */
+export const AGENT_BLINK_MS = 500;
+/**
+ * 运行中时返回随时间翻转的开关（其余时候恒为 true，且不启定时器）。
+ *
+ * 定时器只在本组件内驱动自己的重渲染，不牵动上层：`AgentTabs` 的 state 变化只影响
+ * 它自己这一行。
+ */
+export function useBlink(active, intervalMs = AGENT_BLINK_MS) {
+    const [on, setOn] = useState(true);
+    useEffect(() => {
+        if (!active) {
+            setOn(true);
+            return;
+        }
+        const timer = setInterval(() => setOn((value) => !value), intervalMs);
+        return () => clearInterval(timer);
+    }, [active, intervalMs]);
+    return on;
+}
+/**
+ * 单个栏目的样式 —— 高亮规则的**唯一真相源**（组件与测试共用）。
+ *
+ * 抽成纯函数是因为颜色没法在测试里断言，只能锁样式契约。
+ */
+export function agentTabStyle(active) {
+    return {
+        color: active ? theme.assistant : theme.faint,
+        bold: active,
+        // 背景色块比改字色更能一眼看出「现在看的是谁」；非活动项必须没有背景，否则整条都是高亮
+        backgroundColor: active ? theme.border : undefined,
+    };
+}
+export function AgentTabs({ tabs, activeId }) {
+    // 只要有一个子 Agent 在跑就闪——整条栏目共用一个节奏，避免几个圆点各闪各的
+    const blinkOn = useBlink(tabs.some((tab) => tab.status === "running"));
+    return (_jsx(Box, { children: _jsx(Text, { wrap: "truncate", children: tabs.map((tab) => {
+                const active = tab.id === activeId;
+                // 左右各一个空格作为选项**自身**的 padding（落在高亮块内部），而不是把分隔空格
+                // 拼在下一个选项里——后者会让高亮底色贴住上一个选项的文案。
+                // 也不靠外层 Box 的 paddingX：那样首个选项的文字会整体右移一格，与 ❯ / 分隔线不齐。
+                return (_jsxs(Text, { ...agentTabStyle(active), children: [" ", tab.status ? (_jsx(Text, { color: agentStatusColor(tab.status, blinkOn), children: AGENT_STATUS_DOT })) : null, tab.label, " "] }, tab.id));
+            }) }) }));
+}
+//# sourceMappingURL=agent-tabs.js.map

package/dist/tui/screens/agent-tabs.js.map

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

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

@@ -1,7 +1,8 @@
-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";
 export interface ChatCommandHost {
     session: ChatSession;
@@ -25,13 +26,63 @@ export interface ChatCommandHost {
         resolve: (value: boolean) => void;
     } | null>>;
     setInputText: (text: string) => void;
-    /** 更新状态栏的思考强度展示（`/think` 写入后由上层重取） */
-    setEffortText: (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;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAgB,MAAM,oBAAoB,CAAC;AAe/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAIvD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,mDAAmD;IACnD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC;IACxD,4BAA4B;IAC5B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,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;IACrC,sCAAsC;IACtC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGtE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmXhG"}
+{"version":3,"file":"chat-commands.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/chat-commands.ts"],"names":[],"mappings":"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"}