@ai-zen/cli 1.0.0-alpha.3 → 1.0.0-alpha.31

package/dist/tui/screens/use-overlays.d.ts

@@ -0,0 +1,25 @@
+import { type Dispatch, type SetStateAction } from "react";
+import type { SelectItem } from "../components.js";
+/** 确认框请求：`question` 上屏，用户作答后由 `resolve` 结算 */
+export interface ConfirmState {
+    question: string;
+    resolve: (value: boolean) => void;
+}
+/** 选择器请求：`items` 上屏，用户选中 / 取消后由 `resolve` 结算（取消为 `null`） */
+export interface PickerState {
+    title: string;
+    items: SelectItem<string>[];
+    resolve: (value: string | null) => void;
+}
+export interface ChatOverlays {
+    confirmState: ConfirmState | null;
+    pickerState: PickerState | null;
+    /** 命令层推送覆盖层用（`runCommand` / `chooseHandoffMode` 的入参类型） */
+    setConfirmState: Dispatch<SetStateAction<ConfirmState | null>>;
+    setPickerState: Dispatch<SetStateAction<PickerState | null>>;
+    /** 作答：结算 Promise 并关掉覆盖层（无覆盖层时为空操作） */
+    resolveConfirm: (value: boolean) => void;
+    resolvePicker: (value: string | null) => void;
+}
+export declare function useChatOverlays(): ChatOverlays;
+//# sourceMappingURL=use-overlays.d.ts.map

package/dist/tui/screens/use-overlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-overlays.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/use-overlays.ts"],"names":[],"mappings":"AAWA,OAAO,EAAyB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,0DAA0D;IAC1D,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;IAC7D,sCAAsC;IACtC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/C;AAED,wBAAgB,eAAe,IAAI,YAAY,CAqB9C"}

package/dist/tui/screens/use-overlays.js

@@ -0,0 +1,32 @@
+// 覆盖层（确认框 / 选择器）—— 「弹一个、答一个、再关掉」的唯一实现
+//
+// 两种覆盖层共用同一套契约：调用方给一个 `resolve` 回调，拿到一个 Promise，
+// **用户在覆盖层上作答后 Promise 才结算**。这正是命令处理器能写成
+// `const ok = await confirm(...)` 的原因。
+//
+// 从 `chat.tsx` 抽出来的理由：这套 `resolve` 生命周期被埋在 God Component 里，
+// 既没法单测（要从键盘打到命令层才能碰到），也容易被下一个人的 `setState` 写出
+// 「先清状态、后调 resolve」的竞态。抽出来后：
+//   · 关状态与调 resolve 在**同一次**函数式更新里完成，不会读到过期状态；
+//   · 已经是 `null` 时重复 resolve 是安全空操作（Esc 连按不会炸）。
+import { useCallback, useState } from "react";
+export function useChatOverlays() {
+    const [confirmState, setConfirmState] = useState(null);
+    const [pickerState, setPickerState] = useState(null);
+    // 用函数式更新而不是闭包里的 `confirmState`：连按两下 Esc / 两个键同一帧到达时，
+    // 第二次更新仍能看到「已被第一次清掉」的真实状态，不会重复 resolve。
+    const resolveConfirm = useCallback((value) => {
+        setConfirmState((cs) => {
+            cs?.resolve(value);
+            return null;
+        });
+    }, []);
+    const resolvePicker = useCallback((value) => {
+        setPickerState((ps) => {
+            ps?.resolve(value);
+            return null;
+        });
+    }, []);
+    return { confirmState, pickerState, setConfirmState, setPickerState, resolveConfirm, resolvePicker };
+}
+//# sourceMappingURL=use-overlays.js.map

package/dist/tui/screens/use-overlays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-overlays.js","sourceRoot":"","sources":["../../../src/tui/screens/use-overlays.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,iDAAiD;AACjD,yCAAyC;AACzC,uCAAuC;AACvC,EAAE;AACF,4DAA4D;AAC5D,+CAA+C;AAC/C,6BAA6B;AAC7B,+CAA+C;AAC/C,gDAAgD;AAChD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAsC,MAAM,OAAO,CAAC;AA2BlF,MAAM,UAAU,eAAe;IAC7B,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAsB,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAEzE,qDAAqD;IACrD,wCAAwC;IACxC,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,KAAc,EAAE,EAAE;QACpD,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE;YACrB,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,KAAoB,EAAE,EAAE;QACzD,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE;YACpB,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AACvG,CAAC"}

package/dist/tui/screens/use-wizard-host.d.ts

@@ -0,0 +1,46 @@
+import type { AppConfig, ReasoningPresets } from "@ai-zen/agents-sdk";
+import { type McpReadResult, type McpScope } from "../../config.js";
+import { type AgentStore } from "../../agents-store.js";
+import type { McpSnapshot, WizardCloseResult, WizardStep } from "../config-wizard/index.js";
+import type { Notice } from "./notice.js";
+export interface WizardHostDeps {
+    /** 当前模型 id：`/key` 直达它所用端点的密钥；也是「当前端点是否被改动」的比较基准 */
+    modelId: string;
+    /** 通知出口（读写失败、变更摘要都从这里出去，不进食转录） */
+    notify: (text: string, tone?: Notice["tone"]) => void;
+    /** 会话是否已建好（未建好时改配置只能重启） */
+    hasSession: () => boolean;
+    /** 会话还没建好就改了配置 → 只能重启进程让新配置生效 */
+    restart: () => void;
+    /** 改了当前端点 / MCP / Agent 定义 / 中断策略 → 重载会话（消息保留） */
+    reloadSession: () => void;
+    /**
+     * 快照读取器。缺省用真实实现；测试注入假实现即可，**不必** `vi.mock` 整个 config 模块
+     * ——模块级替换在进程内共享模块时会泄漏到其他测试文件。
+     */
+    readers?: {
+        readConfig: () => Promise<AppConfig>;
+        readMcpConfig: (scope: McpScope) => Promise<McpReadResult>;
+        readReasoningPresets: () => Promise<ReasoningPresets>;
+        readAgentStore: () => Promise<AgentStore>;
+    };
+}
+export interface WizardHost {
+    wizardStep: WizardStep | null;
+    wizardConfig: AppConfig | null;
+    wizardPresets: ReasoningPresets;
+    wizardAgents: {
+        id: string;
+        name: string;
+    }[];
+    wizardMcp: McpSnapshot | null;
+    wizardAgentStore: AgentStore | null;
+    /** 打开向导：先读齐快照再接管整屏（读失败则只报错、不进向导） */
+    openWizard: (step: WizardStep) => Promise<void>;
+    /** `/key`：直达当前模型所用端点的 API Key 编辑步骤 */
+    openKeyEditor: () => Promise<void>;
+    /** 向导关闭：渲染变更摘要，并让改动生效 */
+    closeWizard: (result: WizardCloseResult) => void;
+}
+export declare function useWizardHost({ modelId, notify, hasSession, restart, reloadSession, readers: injected, }: WizardHostDeps): WizardHost;
+//# sourceMappingURL=use-wizard-host.d.ts.map

package/dist/tui/screens/use-wizard-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-wizard-host.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/use-wizard-host.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAqE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACvI,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACtD,2BAA2B;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,iCAAiC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,kDAAkD;IAClD,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE;QACR,UAAU,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,aAAa,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;QAC3D,oBAAoB,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtD,cAAc,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;KAC3C,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,gBAAgB,CAAC;IAChC,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,oCAAoC;IACpC,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,sCAAsC;IACtC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,yBAAyB;IACzB,WAAW,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAClD;AAED,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,MAAM,EACN,UAAU,EACV,OAAO,EACP,aAAa,EACb,OAAO,EAAE,QAAQ,GAClB,EAAE,cAAc,GAAG,UAAU,CA6G7B"}

package/dist/tui/screens/use-wizard-host.js

@@ -0,0 +1,123 @@
+// 配置向导宿主 —— 「打开向导 / 读齐快照 / 关闭后让改动生效」的唯一实现
+//
+// 从 `chat.tsx` 抽出来的理由：向导本身（`config-wizard/`）是独立状态机，但**宿主**
+// 的活儿散落在对话屏里 —— 6 个 `useState`、3 个入口函数，还要顺手记「当前模型用的是
+// 哪个端点」以便关闭时判断要不要重建会话。这些既不属于「对话」，也没法单测（要一路
+// 从键盘打到向导关闭才能碰到）。
+//
+// 依赖方向是**注入**而非 import 会话：宿主要做的事（通知、重启、重载会话）都通过
+// `WizardHostDeps` 传进来，于是 hook 可以在测试里用假依赖跑完整生命周期。
+import { useRef, useState } from "react";
+import { mcpConfigOrEmpty, readConfig, readMcpConfig, readReasoningPresets } from "../../config.js";
+import { readAgentStore } from "../../agents-store.js";
+import { resolveCredential } from "../../config-editor.js";
+import { t } from "../../i18n/index.js";
+export function useWizardHost({ modelId, notify, hasSession, restart, reloadSession, readers: injected, }) {
+    const readers = {
+        readConfig,
+        readMcpConfig,
+        readReasoningPresets,
+        readAgentStore,
+        ...injected,
+    };
+    const [wizardStep, setWizardStep] = useState(null);
+    const [wizardConfig, setWizardConfig] = useState(null);
+    const [wizardPresets, setWizardPresets] = useState({});
+    const [wizardAgents, setWizardAgents] = useState([]);
+    const [wizardMcp, setWizardMcp] = useState(null);
+    const [wizardAgentStore, setWizardAgentStore] = useState(null);
+    /**
+     * 打开向导时当前模型所用的端点 id —— 关闭时据此判断「当前端点有没有被改」。
+     *
+     * 用 ref 而不是 state：它只在 `openWizard` / `closeWizard` 之间传递，不上屏，
+     * 放 state 会多一次无意义渲染。
+     */
+    const currentEndpointRef = useRef(null);
+    const openWizard = async (step) => {
+        try {
+            const config = await readers.readConfig();
+            currentEndpointRef.current = resolveCredential(config, modelId)?.endpointId ?? null;
+            const agentStore = await readers.readAgentStore();
+            setWizardConfig(config);
+            setWizardPresets(await readers.readReasoningPresets());
+            setWizardAgents(agentStore.agents.map((agent) => ({ id: agent.id, name: agent.name || agent.id })));
+            setWizardAgentStore(agentStore);
+            // 坏文件照样进屏（屏上写明），只把失败原因随之带过去
+            const globalMcp = await readers.readMcpConfig("global");
+            const projectMcp = await readers.readMcpConfig("project");
+            const errors = {};
+            if (!globalMcp.ok)
+                errors.global = globalMcp.error;
+            if (!projectMcp.ok)
+                errors.project = projectMcp.error;
+            setWizardMcp({
+                global: mcpConfigOrEmpty(globalMcp),
+                project: mcpConfigOrEmpty(projectMcp),
+                ...(Object.keys(errors).length ? { errors } : {}),
+            });
+            setWizardStep(step);
+        }
+        catch (error) {
+            notify(t("chat.configReadFailed", { error: error?.message ?? error }), "error");
+        }
+    };
+    const openKeyEditor = async () => {
+        try {
+            const config = await readers.readConfig();
+            const credential = resolveCredential(config, modelId);
+            if (!credential) {
+                notify(t("chat.modelNoEndpoint", { id: modelId }), "error");
+                return;
+            }
+            currentEndpointRef.current = credential.endpointId;
+            setWizardConfig(config);
+            setWizardStep({ kind: "edit", field: "apiKey", endpointId: credential.endpointId });
+        }
+        catch (error) {
+            notify(t("chat.configReadFailed", { error: error?.message ?? error }), "error");
+        }
+    };
+    /** 向导关闭：渲染变更摘要；若改到当前端点 / MCP / Agent 定义则重建会话（消息保留） */
+    const closeWizard = (result) => {
+        setWizardStep(null);
+        setWizardConfig(null);
+        setWizardMcp(null);
+        setWizardAgentStore(null);
+        // 同一批摘要合成**一条**（多行）：既能全部显示，又只占通知队列的一个槽位。
+        // 逐条 push 在单槽时代只剩最后一条，在队列时代则会挤掉更早的进度提示。
+        const { summary } = result;
+        if (summary.length === 1) {
+            notify(t("chat.configUpdated", { line: summary[0] }));
+        }
+        else if (summary.length > 1) {
+            // 子项缩进 = 一个汉字宽度（两个半角空格），不加 `·` 之类的项目符号：
+            // 通知正文本身就左对齐于行首，子项只需要一点层级差，符号是多余装饰。
+            notify(t("chat.configUpdatedMulti", { lines: summary.map((line) => `  ${line}`).join("\n") }));
+        }
+        if (!result.dirty)
+            return;
+        // 会话都没建好 → 只能重启让新配置生效。
+        if (!hasSession()) {
+            restart();
+            return;
+        }
+        // 只有「当前端点 / MCP / Agent 定义 / 建 Agent 时才读的配置（中断策略）」变了
+        // 才需要重建会话；改的是别的模型、别的端点的参数，当前会话不受影响，不该白重连一次。
+        const endpointChanged = !!currentEndpointRef.current && result.changedEndpointIds.includes(currentEndpointRef.current);
+        if (endpointChanged || result.mcpChanged || result.agentsChanged || result.sessionOptionsChanged) {
+            reloadSession();
+        }
+    };
+    return {
+        wizardStep,
+        wizardConfig,
+        wizardPresets,
+        wizardAgents,
+        wizardMcp,
+        wizardAgentStore,
+        openWizard,
+        openKeyEditor,
+        closeWizard,
+    };
+}
+//# sourceMappingURL=use-wizard-host.js.map

package/dist/tui/screens/use-wizard-host.js.map

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

package/dist/tui/status-segments.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 状态栏的折行 —— 输入是「按优先级排好的信息块」，输出是「确定的若干行」
+ *
+ * 为什么不用 Ink 自己的 wrap：状态栏高度必须是**确定值**，`computeChatLayout` 要靠它
+ * 算出对话区还能占几行（整帧高度恒等于终端行数，输入框才吸得住底）。让 Ink 在渲染时
+ * 折行，行数只有渲染完才知道，布局预算就会算错——轻则顶部留白多一行，重则把输入框
+ * 顶出屏幕。所以这里先在纯逻辑里折好，渲染层只负责按行铺颜色。
+ *
+ * 折行以「块」为单位（见 `packSegments`）：身份、用量、快捷键各是一块，窄屏时整块
+ * 顺延到下一行，而不是把一块劈成两半——也不再用 `justify-content: space-between` 把
+ * 两侧各切一半（左边「思考 高」被吃掉、右边提示只剩半截）。
+ */
+/** 一段带样式的文本（颜色由调用方给，这里只管切分） */
+export interface StatusSegment {
+    text: string;
+    color?: string;
+    bold?: boolean;
+}
+/**
+ * 把片段流按显示宽度折成若干行。
+ *
+ * 断行策略与 `wrapText` 一致：优先在**空格**处断（英文单词不被劈开），没有空格可断
+ * 时按字符硬断（CJK 本来就能任意断行）。折行后的行首空格会被吃掉，避免出现
+ * 「第二行无故缩进两格」。
+ */
+export declare function wrapSegments(segments: StatusSegment[], width: number): StatusSegment[][];
+/** 片段流的总显示宽度（宽字符算 2 列） */
+export declare function segmentsWidth(segments: StatusSegment[]): number;
+/**
+ * 以**块**为单位装行：能塞进当前行剩余宽度就并排（用 `separator` 连起来），
+ * 塞不下就整块挪到下一行；只有单块本身就比一整行还宽时，才退化成块内折行
+ * （`wrapSegments`），此时优先在空格 / CJK 边界断，尽量不劈开英文单词。
+ *
+ * 这样「换行时一块占一行」是默认行为：块是原子的排版单位，行的边界只会落在块边界上。
+ */
+export declare function packSegments(blocks: StatusSegment[][], width: number, separator?: StatusSegment[]): StatusSegment[][];
+//# sourceMappingURL=status-segments.d.ts.map

package/dist/tui/status-segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-segments.d.ts","sourceRoot":"","sources":["../../src/tui/status-segments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAwCD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,EAAE,CAyDxF;AAED,0BAA0B;AAC1B,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAM/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EAAE,EAAE,EACzB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,aAAa,EAAsB,GAC7C,aAAa,EAAE,EAAE,CAwCnB"}

package/dist/tui/status-segments.js

@@ -0,0 +1,166 @@
+/**
+ * 状态栏的折行 —— 输入是「按优先级排好的信息块」，输出是「确定的若干行」
+ *
+ * 为什么不用 Ink 自己的 wrap：状态栏高度必须是**确定值**，`computeChatLayout` 要靠它
+ * 算出对话区还能占几行（整帧高度恒等于终端行数，输入框才吸得住底）。让 Ink 在渲染时
+ * 折行，行数只有渲染完才知道，布局预算就会算错——轻则顶部留白多一行，重则把输入框
+ * 顶出屏幕。所以这里先在纯逻辑里折好，渲染层只负责按行铺颜色。
+ *
+ * 折行以「块」为单位（见 `packSegments`）：身份、用量、快捷键各是一块，窄屏时整块
+ * 顺延到下一行，而不是把一块劈成两半——也不再用 `justify-content: space-between` 把
+ * 两侧各切一半（左边「思考 高」被吃掉、右边提示只剩半截）。
+ */
+import { clusterWidth, graphemes } from "./text.js";
+function toChars(segments) {
+    const chars = [];
+    for (const segment of segments) {
+        // 按**字素簇**切，不按 code point：`✌️`（VS16）是两个 code point 但占 2 列，
+        // 逐 code point 累加会算成 1 列 → 状态栏行超宽 → Ink 二次折行 → 帧高多一行。
+        for (const ch of graphemes(segment.text)) {
+            chars.push({ ch, color: segment.color, bold: segment.bold, width: clusterWidth(ch) });
+        }
+    }
+    return chars;
+}
+/** 连续同色同粗细的字符合并回一个片段 */
+function toSegments(chars) {
+    const segments = [];
+    for (const char of chars) {
+        const last = segments[segments.length - 1];
+        if (last && last.color === char.color && last.bold === char.bold) {
+            last.text += char.ch;
+        }
+        else {
+            segments.push({ text: char.ch, color: char.color, bold: char.bold });
+        }
+    }
+    return segments;
+}
+/** 行尾空格没有意义（会视觉上「多出一截」），折行前后都裁掉 */
+function trimTail(line) {
+    while (line.length > 0 && line[line.length - 1].ch === " ")
+        line.pop();
+}
+/**
+ * 把片段流按显示宽度折成若干行。
+ *
+ * 断行策略与 `wrapText` 一致：优先在**空格**处断（英文单词不被劈开），没有空格可断
+ * 时按字符硬断（CJK 本来就能任意断行）。折行后的行首空格会被吃掉，避免出现
+ * 「第二行无故缩进两格」。
+ */
+export function wrapSegments(segments, width) {
+    const limit = Math.max(1, width);
+    const chars = toChars(segments);
+    const lines = [];
+    let line = [];
+    let lineWidth = 0;
+    for (let index = 0; index < chars.length; index += 1) {
+        const char = chars[index];
+        // 行已满且下一个正好是空格：直接断行并把这个空格丢掉，而不是往回找上一处空格
+        // （否则会把已经排好的「aaaa bbbb」硬拆成「aaaa」+「bbbb」，白白浪费半行）
+        if (char.ch === " " && lineWidth + char.width > limit && line.length > 0) {
+            trimTail(line);
+            lines.push(line);
+            line = [];
+            lineWidth = 0;
+            continue;
+        }
+        if (lineWidth + char.width > limit && line.length > 0) {
+            // 当前行最后一个空格的位置：能在此断就在此断，把尾巴挪到下一行
+            let spaceAt = -1;
+            for (let i = line.length - 1; i > 0; i -= 1) {
+                if (line[i].ch === " ") {
+                    spaceAt = i;
+                    break;
+                }
+            }
+            if (spaceAt > 0) {
+                const carry = line.slice(spaceAt + 1);
+                line = line.slice(0, spaceAt);
+                trimTail(line);
+                lines.push(line);
+                line = carry;
+                lineWidth = carry.reduce((sum, item) => sum + item.width, 0);
+            }
+            else {
+                trimTail(line);
+                lines.push(line);
+                line = [];
+                lineWidth = 0;
+            }
+        }
+        if (line.length === 0) {
+            if (char.ch === " ")
+                continue; // 行首不吃空格
+            // 行首的孤儿分隔符（`·`）是折行切出来的，留在开头只会变成「· ⚡ 47 tok/s」，
+            // 难看且无意义（换行本身已表达分隔），连同其后的空格一并丢掉。
+            if (char.ch === "·" && index > 0) {
+                while (index + 1 < chars.length && chars[index + 1].ch === " ")
+                    index += 1;
+                continue;
+            }
+        }
+        line.push(char);
+        lineWidth += char.width;
+    }
+    trimTail(line);
+    lines.push(line);
+    return lines.map(toSegments);
+}
+/** 片段流的总显示宽度（宽字符算 2 列） */
+export function segmentsWidth(segments) {
+    let width = 0;
+    for (const segment of segments) {
+        for (const ch of graphemes(segment.text))
+            width += clusterWidth(ch);
+    }
+    return width;
+}
+/**
+ * 以**块**为单位装行：能塞进当前行剩余宽度就并排（用 `separator` 连起来），
+ * 塞不下就整块挪到下一行；只有单块本身就比一整行还宽时，才退化成块内折行
+ * （`wrapSegments`），此时优先在空格 / CJK 边界断，尽量不劈开英文单词。
+ *
+ * 这样「换行时一块占一行」是默认行为：块是原子的排版单位，行的边界只会落在块边界上。
+ */
+export function packSegments(blocks, width, separator = [{ text: " · " }]) {
+    const limit = Math.max(1, width);
+    const separatorWidth = segmentsWidth(separator);
+    const lines = [];
+    let line = [];
+    let lineWidth = 0;
+    const flush = () => {
+        if (line.length === 0)
+            return;
+        lines.push(line);
+        line = [];
+        lineWidth = 0;
+    };
+    for (const block of blocks) {
+        const blockWidth = segmentsWidth(block);
+        if (blockWidth === 0)
+            continue; // 空块（如本轮没有速率）不占位，也不留分隔符
+        if (line.length > 0) {
+            if (lineWidth + separatorWidth + blockWidth <= limit) {
+                line = [...line, ...separator, ...block];
+                lineWidth += separatorWidth + blockWidth;
+                continue;
+            }
+            flush();
+        }
+        if (blockWidth <= limit) {
+            line = [...block];
+            lineWidth = blockWidth;
+            continue;
+        }
+        // 单块超一整行：块内折行兜底，尾巴留在 `line` 上等着接下一块
+        const chunks = wrapSegments(block, limit);
+        const tail = chunks.pop();
+        lines.push(...chunks);
+        line = tail;
+        lineWidth = segmentsWidth(tail);
+    }
+    flush();
+    return lines.length > 0 ? lines : [[]];
+}
+//# sourceMappingURL=status-segments.js.map

package/dist/tui/status-segments.js.map

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

package/dist/tui/text.d.ts

@@ -4,41 +4,56 @@
  * 从 `screens.tsx` 中抽出，供对话屏、凭据设置屏、配置中心共用，
  * 避免 `screens.tsx ↔ config-wizard.tsx` 相互 import 形成循环依赖。
  */
-/** 终端显示宽度（宽字符计 2，组合字符计 0） */
+/** 终端显示宽度（按字素簇，与 Ink 的排版完全一致） */
 export declare function displayWidth(text: string): number;
+/** 单个字素簇的显示宽度（结果带缓存） */
+export declare function clusterWidth(cluster: string): number;
+export declare function graphemes(text: string): string[];
 /**
  * 按显示宽度把文本折成多行（保留显式换行）。
- * 拉丁文优先在空格处断行，CJK / 超长词按字符硬断；保证每行显示宽度 ≤ limit。
+ * 拉丁文优先在空格处断行，CJK / 超长词按**字素簇**硬断；保证每行显示宽度 ≤ limit。
  */
 export declare function wrapText(text: string, limit: number): string[];
 /** 带光标位置的输入区折行结果 */
 export interface InputLayout {
     /** 折行后的各行文本（不含提示符） */
     lines: string[];
+    /**
+     * 每行首字符的**字素簇下标**（与 `lines` 同长）。
+     *
+     * 上下移动光标要靠它把「第几行 + 行内第几列」换算回文本下标；不能把 `lines` 长度
+     * 相加得出 —— 软折行不占字符，硬换行（`\n`）才占一个。
+     */
+    rowStarts: number[];
     /** 光标所在行（0 起始） */
     cursorRow: number;
-    /** 光标在该行内的字符偏移（code point 计） */
+    /** 光标在该行内的字符偏移（**字素簇**计，不是 code point） */
     cursorCol: number;
 }
 /**
- * 把输入文本按显示宽度折行，并定位光标（`cursor` 为字符索引，以 code point 计）。
- * 折行采用逐字符硬断（不做空格优先），以保证光标映射精确、支持跨行编辑。
+ * 把输入文本按显示宽度折行，并定位光标（`cursor` 为**字素簇**索引）。
+ * 折行采用逐簇硬断（不做空格优先），以保证光标映射精确、支持跨行编辑。
  */
 export declare function layoutInput(text: string, cursor: number, width: number): InputLayout;
 /** 单行输入左侧留白：Box paddingX(1) + 提示符 `❯ `（宽 2） */
 export declare const INPUT_PREFIX_WIDTH = 3;
 /**
- * 判断一段输入是否为「终端应答序列」而非用户输入。
+ * 判断一段输入是否为「终端上报序列」而非用户输入。
  *
  * 典型来源：
  *   - Kitty 键盘协议查询的应答：`CSI ? <flags> u`（Ink 开启 `kittyKeyboard` 时会发 `CSI ? u`）；
  *   - 光标位置报告（CPR）：`CSI <row>;<col> R`；
- *   - 设备状态报告：`CSI ? <n> n`。
+ *   - 设备状态报告：`CSI ? <n> n`；
+ *   - 鼠标上报（SGR）：`CSI < b ; x ; y M`——滚轮 / 点击 / 拖拽，见 `mouse.ts`。
  *
  * 这类序列本应由 Ink 的解析器整体吞掉。但当它被**拆包**时（前导 ESC 被 Ink 的
  * 「待定转义刷新定时器」当作一次独立的 Escape 键消费），残留在后一个 chunk 里的
  * `[?0u` 会退化成普通文本并被当作输入插入输入框（实测重现）。此处做一层护栏；
  * 根因（不再向终端发查询）已在渲染选项里关闭。
+ *
+ * 鼠标上报是**主动开启**的（`src/tui/mouse.ts`），且 Ink 会把整条序列当作 `char`
+ * 交给 `useInput`，所以这里必须兜住——否则滚一下就往输入框里插一段 `[<64;10;5M`。
+ * 注意：需要读滚轮的屏（对话屏）必须**在处理完滚轮之后**再调用本函数。
  */
 export declare function isTerminalReply(sequence: string): boolean;
 /**
@@ -68,4 +83,9 @@ export declare function usableFrameRows(terminalRows: number): number;
  * 传入行数超过一帧时返回 0（由调用方负责限制内容行数）。
  */
 export declare function bottomPadding(terminalRows: number, contentLines: number): number;
+/**
+ * 去掉 CwdTrackerPlugin 追加在用户消息末尾的工作目录提示。
+ * 该提示是喂给模型的上下文，不该显示给用户。
+ */
+export declare function stripCwdNote(text: string): string;
 //# sourceMappingURL=text.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/tui/text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH,6BAA6B;AAC7B,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B9D;AAID,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAgDpF;AAED,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAY3D;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhF"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/tui/text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAwB;AACxB,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQpD;AAuCD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B9D;AAID,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAoDpF;AAED,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAY3D;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjD"}