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

package/dist/tui/screens/use-chat-viewport.js

@@ -0,0 +1,50 @@
+// 对话视口 —— 「翻页 / 按行 / 滚轮 / 回底」的唯一入口
+//
+// 从 `chat.tsx` 抽出来的理由：视口是**不依赖会话**的独立状态机（一个 `viewTop` 状态
+// 加一份最近布局的引用），却被塞在 God Component 里，与消息、输入、向导混在一起。
+// 抽出来后，「滚动」这件事只有这一个地方能改。
+//
+// 关键点：所有动作都走 `scrollTo()` → `clampViewTop()`，因此
+//   · 越界方向被自然吃掉，不会出现「滚过头回不来」；
+//   · 回到底部时 `clampViewTop()` 返回 `null`，视口**自动**恢复「跟随最新内容」，
+//     不需要各处手写「滚到底就清空滚动状态」。
+import { useCallback, useRef, useState } from "react";
+import { WHEEL_STEP } from "../mouse.js";
+import { clampViewTop } from "./layout.js";
+export function useChatViewport() {
+    const [viewTop, setViewTop] = useState(null);
+    const layoutRef = useRef(null);
+    // 下面的回调只读 `layoutRef`（布局每帧更新）与 `setViewTop`，没有闭包捕获的旧状态，
+    // 所以依赖数组为空即可保持引用稳定（可安全传给 memo 化的子组件）。
+    // `scrollTo` 是下面三个动作的公共实现，**不对外暴露**：调用方只需要「翻页 / 按行 / 滚轮」，
+    // 直接设任意顶部值既没必要，也绕过了「以布局实际生效的顶部为基准」这条约束。
+    const scrollTo = useCallback((nextTop) => {
+        const L = layoutRef.current;
+        if (!L)
+            return;
+        setViewTop(clampViewTop(L.totalLines, L.budget, nextTop));
+    }, []);
+    const scrollByPage = useCallback((dir) => {
+        const L = layoutRef.current;
+        if (!L)
+            return;
+        // 按「布局实际生效的顶部」算，而不是原始 `viewTop`：贴底时 `viewTop` 是
+        // `null`，从 `layout.viewTop` 起算才能从底部往上翻一屏。
+        scrollTo(L.viewTop + dir * Math.max(1, L.budget - 1));
+    }, [scrollTo]);
+    const scrollByLine = useCallback((dir) => {
+        const L = layoutRef.current;
+        if (!L)
+            return;
+        scrollTo(L.viewTop + dir);
+    }, [scrollTo]);
+    const scrollByWheel = useCallback((dir) => {
+        const L = layoutRef.current;
+        if (!L)
+            return;
+        scrollTo(L.viewTop + dir * WHEEL_STEP);
+    }, [scrollTo]);
+    const scrollToBottom = useCallback(() => setViewTop(null), []);
+    return { viewTop, layoutRef, scrollByPage, scrollByLine, scrollByWheel, scrollToBottom };
+}
+//# sourceMappingURL=use-chat-viewport.js.map

package/dist/tui/screens/use-chat-viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-viewport.js","sourceRoot":"","sources":["../../../src/tui/screens/use-chat-viewport.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,yDAAyD;AACzD,kDAAkD;AAClD,yBAAyB;AACzB,EAAE;AACF,gDAAgD;AAChD,8BAA8B;AAC9B,2DAA2D;AAC3D,2BAA2B;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAC;AAqB5D,MAAM,UAAU,eAAe;IAC7B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;IAElD,wDAAwD;IACxD,sCAAsC;IACtC,0DAA0D;IAC1D,wCAAwC;IACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,OAAe,EAAE,EAAE;QAC/C,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,GAAW,EAAE,EAAE;QACd,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,gDAAgD;QAChD,0CAA0C;QAC1C,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,GAAW,EAAE,EAAE;QACd,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;IAC5B,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,GAAW,EAAE,EAAE;QACd,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,GAAG,UAAU,CAAC,CAAC;IACzC,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAE/D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAC3F,CAAC"}

package/dist/tui/screens/use-input-editing.d.ts

@@ -0,0 +1,44 @@
+import type { Notice } from "./notice.js";
+export interface InputEditingDeps {
+    /** 初始草稿（`/back` 撤回后重挂载用的预填内容），缺省空 */
+    initialText?: string;
+    /** 通知出口（暂存 / 取回草稿的提示，走通知通道而不是转录） */
+    notify: (text: string, tone?: Notice["tone"]) => void;
+}
+export interface InputEditing {
+    /** 当前草稿 */
+    input: string;
+    /** 光标位置：以字素簇计的索引（0..字数），可落在末尾之后一格 */
+    cursor: number;
+    /** 整体替换草稿（光标移到末尾） */
+    setInputText: (text: string) => void;
+    insertAtCursor: (text: string) => void;
+    deleteBeforeCursor: () => void;
+    deleteAfterCursor: () => void;
+    deleteWordBeforeCursor: () => void;
+    deleteWordAfterCursor: () => void;
+    deleteToStartOfLine: () => void;
+    deleteToEndOfLine: () => void;
+    /** Ctrl+W：删到前一空白（标点不切分） */
+    deletePrevWhitespace: () => void;
+    /** Ctrl+Y / Alt+Y：取回 kill ring 里的一段；`advance` 为真时循环到更早的一段 */
+    yank: (advance: boolean) => void;
+    /** Ctrl+_：撤销上一次编辑 */
+    undoEdit: () => void;
+    /** Ctrl+S：暂存草稿 / 取回草稿 */
+    toggleStash: () => void;
+    moveCursor: (delta: number) => void;
+    moveCursorToLineStart: () => void;
+    moveCursorToLineEnd: () => void;
+    /** 按词左右移动：`dir` 为 -1 往前、1 往后 */
+    moveCursorByWord: (dir: -1 | 1) => void;
+    /** 历史：上一条 / 下一条（没有可翻的时候自动空转） */
+    historyPrev: () => void;
+    historyNext: () => void;
+    /** 提交时调用：清空草稿并退出历史浏览（历史游标复位到底部） */
+    clearDraft: () => void;
+    /** 提交成功时调用：记进历史并把历史游标复位到底部 */
+    rememberSubmitted: (text: string) => void;
+}
+export declare function useInputEditing({ initialText, notify }: InputEditingDeps): InputEditing;
+//# sourceMappingURL=use-input-editing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-input-editing.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/use-input-editing.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAClC,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,2BAA2B;IAC3B,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,6DAA6D;IAC7D,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,qBAAqB;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,yBAAyB;IACzB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAClC,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,gCAAgC;IAChC,gBAAgB,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IACxC,gCAAgC;IAChC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,mCAAmC;IACnC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,8BAA8B;IAC9B,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,wBAAgB,eAAe,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,gBAAgB,GAAG,YAAY,CAoLvF"}

package/dist/tui/screens/use-input-editing.js

@@ -0,0 +1,192 @@
+// 输入编辑 —— 草稿文本与光标、历史、kill ring、撤销栈、暂存区的唯一实现
+//
+// 从 `chat.tsx` 抽出来的理由：这一整块（`input` / `cursor` / `history` / kill ring /
+// undo / stash + 20 个编辑动作）是**纯编辑器语义**，与「对话屏」毫无关系，却和会话、
+// 向导、渲染挤在同一个组件里 —— 于是既不能单测，也每次都被误认为「对话的一部分」。
+//
+// 两条贯穿全篇的约定：
+//
+//   1. **按字素簇编辑**：所有位置计算都走 `graphemes()`。`❤️` 是 2 个 code point、
+//      `👨‍👩‍👧` 是 5 个，但它们都是**一个**字符 —— 按 code point 删会切出半个字素簇。
+//   2. **纯函数算、hook 只套用**：具体「删哪个词、删到哪」在 `input.ts` /
+//      `input-editing.ts` 里（有独立测试），这里只负责「拿到结果 → 更新状态 + 记撤销」。
+import { useRef, useState } from "react";
+import { deleteToLineEnd, deleteToLineStart, deleteWordLeft, deleteWordRight, wordLeft, wordRight, } from "./input.js";
+import { deleteToPrevWhitespace, killedText, killAt, popUndo, pushKill, pushUndo, } from "../input-editing.js";
+import { graphemes } from "../text.js";
+import { t } from "../../i18n/index.js";
+export function useInputEditing({ initialText, notify }) {
+    const [input, setInput] = useState(initialText ?? "");
+    const [cursor, setCursor] = useState(graphemes(initialText ?? "").length);
+    const [history, setHistory] = useState([]);
+    /** 历史游标：-1 = 不在浏览历史（当前是草稿） */
+    const historyIndex = useRef(-1);
+    /** kill ring：Ctrl+W/U/K 删掉的文本，Ctrl+Y 取回、Alt+Y 循环 */
+    const killRingRef = useRef([]);
+    const yankIndexRef = useRef(-1);
+    /** 编辑撤销栈（Ctrl+_） */
+    const undoStackRef = useRef([]);
+    /** 暂存区（Ctrl+S） */
+    const stashRef = useRef(null);
+    const setInputText = (text) => {
+        setInput(text);
+        setCursor(graphemes(text).length);
+    };
+    /**
+     * 取「当前文本 + 钳制后的光标」，所有编辑动作的统一起点。
+     *
+     * 钳制防的**不是**「cursor 越界」——`cursor` 的每个写入点都已保证落在 `[0, len]`；
+     * 防的是**文本与光标不同步**：`input` 与 `cursor` 是两个 state，任何一处只改其一
+     * （或将来新增编辑动作忘了同步）都会让 `cp > chars.length` 成立，那时 `slice`
+     * 会静默切少、`cp - 1` 会变负。钳一下把后果限制在「本次编辑落点不对」。
+     */
+    const clampCursor = () => {
+        const chars = graphemes(input);
+        return { chars, cp: Math.max(0, Math.min(cursor, chars.length)) };
+    };
+    const insertAtCursor = (text) => {
+        const { chars, cp } = clampCursor();
+        setInput(chars.slice(0, cp).join("") + text + chars.slice(cp).join(""));
+        setCursor(cp + graphemes(text).length);
+    };
+    const deleteBeforeCursor = () => {
+        const { chars, cp } = clampCursor();
+        if (cp === 0)
+            return;
+        setInput(chars.slice(0, cp - 1).join("") + chars.slice(cp).join(""));
+        setCursor(cp - 1);
+    };
+    const deleteAfterCursor = () => {
+        const { chars, cp } = clampCursor();
+        if (cp >= chars.length)
+            return;
+        setInput(chars.slice(0, cp).join("") + chars.slice(cp + 1).join(""));
+    };
+    /** 套用纯函数算好的「文本 + 光标」结果（无变化则不触发重渲染，也不进撤销栈） */
+    const applyEdit = (r) => {
+        if (r.text === input && r.cursor === cursor)
+            return;
+        undoStackRef.current = pushUndo(undoStackRef.current, { text: input, cursor });
+        setInput(r.text);
+        setCursor(r.cursor);
+    };
+    /** 删除类编辑：额外把删掉的文本放进 kill ring（Ctrl+Y 可取回） */
+    const applyKill = (r) => {
+        if (r.text === input && r.cursor === cursor)
+            return;
+        killRingRef.current = pushKill(killRingRef.current, killedText(input, r.text));
+        yankIndexRef.current = -1;
+        applyEdit(r);
+    };
+    const yank = (advance) => {
+        const ring = killRingRef.current;
+        if (ring.length === 0)
+            return;
+        const next = advance ? yankIndexRef.current + 1 : 0;
+        // 只用 `killAt` 的 undefined 做越界守卫（环已到头），不再先判一遍 `next >= ring.length`
+        const text = killAt(ring, next);
+        if (text === undefined)
+            return;
+        yankIndexRef.current = next;
+        insertAtCursor(text);
+    };
+    const undoEdit = () => {
+        const popped = popUndo(undoStackRef.current);
+        if (!popped)
+            return;
+        undoStackRef.current = popped.rest;
+        setInput(popped.state.text);
+        setCursor(popped.state.cursor);
+    };
+    const toggleStash = () => {
+        if (input.length > 0) {
+            stashRef.current = { text: input, cursor };
+            setInputText("");
+            notify(t("notice.draftSaved"));
+            return;
+        }
+        const stashed = stashRef.current;
+        if (!stashed)
+            return;
+        stashRef.current = null;
+        setInput(stashed.text);
+        setCursor(stashed.cursor);
+        notify(t("notice.draftRestored"));
+    };
+    const moveCursor = (delta) => {
+        const len = graphemes(input).length;
+        setCursor((c) => Math.max(0, Math.min(len, c + delta)));
+    };
+    const moveCursorByWord = (dir) => {
+        setCursor(dir === -1 ? wordLeft(input, cursor) : wordRight(input, cursor));
+    };
+    const moveCursorToLineStart = () => {
+        const { chars, cp } = clampCursor();
+        let i = cp;
+        while (i > 0 && chars[i - 1] !== "\n")
+            i -= 1;
+        setCursor(i);
+    };
+    const moveCursorToLineEnd = () => {
+        const { chars, cp } = clampCursor();
+        let i = cp;
+        while (i < chars.length && chars[i] !== "\n")
+            i += 1;
+        setCursor(i);
+    };
+    // 历史浏览：「上一条」从最新开始往回走，「下一条」走到底就回到空草稿。
+    // 上下两处按键（Ctrl+P/N 与 ↑/↓）共用这一对，不再各写一遍。
+    const historyPrev = () => {
+        if (history.length === 0)
+            return;
+        const idx = historyIndex.current < 0 ? history.length - 1 : Math.max(0, historyIndex.current - 1);
+        historyIndex.current = idx;
+        setInputText(history[idx]);
+    };
+    const historyNext = () => {
+        if (historyIndex.current < 0)
+            return;
+        const idx = historyIndex.current + 1;
+        if (idx >= history.length) {
+            historyIndex.current = -1;
+            setInputText("");
+            return;
+        }
+        historyIndex.current = idx;
+        setInputText(history[idx]);
+    };
+    const clearDraft = () => {
+        setInput("");
+        setCursor(0);
+        historyIndex.current = -1;
+    };
+    const rememberSubmitted = (text) => {
+        setHistory((h) => [...h, text]);
+        historyIndex.current = -1;
+    };
+    return {
+        input,
+        cursor,
+        setInputText,
+        insertAtCursor,
+        deleteBeforeCursor,
+        deleteAfterCursor,
+        deleteWordBeforeCursor: () => applyKill(deleteWordLeft(input, cursor)),
+        deleteWordAfterCursor: () => applyKill(deleteWordRight(input, cursor)),
+        deleteToStartOfLine: () => applyKill(deleteToLineStart(input, cursor)),
+        deleteToEndOfLine: () => applyKill(deleteToLineEnd(input, cursor)),
+        deletePrevWhitespace: () => applyKill(deleteToPrevWhitespace(input, cursor)),
+        yank,
+        undoEdit,
+        toggleStash,
+        moveCursor,
+        moveCursorToLineStart,
+        moveCursorToLineEnd,
+        moveCursorByWord,
+        historyPrev,
+        historyNext,
+        clearDraft,
+        rememberSubmitted,
+    };
+}
+//# sourceMappingURL=use-input-editing.js.map

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

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

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,35 @@
+import type { AppConfig, ReasoningPresets } from "@ai-zen/agents-sdk";
+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;
+}
+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, }: 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;AAEtE,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,2CAA2C;IAC3C,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;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,GACd,EAAE,cAAc,GAAG,UAAU,CA0F7B"}

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

@@ -0,0 +1,103 @@
+// 配置向导宿主 —— 「打开向导 / 读齐快照 / 关闭后让改动生效」的唯一实现
+//
+// 从 `chat.tsx` 抽出来的理由：向导本身（`config-wizard/`）是独立状态机，但**宿主**
+// 的活儿散落在对话屏里 —— 6 个 `useState`、3 个入口函数，还要顺手记「当前模型用的是
+// 哪个端点」以便关闭时判断要不要重建会话。这些既不属于「对话」，也没法单测（要一路
+// 从键盘打到向导关闭才能碰到）。
+//
+// 依赖方向是**注入**而非 import 会话：宿主要做的事（通知、重启、重载会话）都通过
+// `WizardHostDeps` 传进来，于是 hook 可以在测试里用假依赖跑完整生命周期。
+import { useRef, useState } from "react";
+import { 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, }) {
+    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 readConfig();
+            currentEndpointRef.current = resolveCredential(config, modelId)?.endpointId ?? null;
+            const agentStore = await readAgentStore();
+            setWizardConfig(config);
+            setWizardPresets(await readReasoningPresets());
+            setWizardAgents(agentStore.agents.map((agent) => ({ id: agent.id, name: agent.name || agent.id })));
+            setWizardAgentStore(agentStore);
+            setWizardMcp({ global: await readMcpConfig("global"), project: await readMcpConfig("project") });
+            setWizardStep(step);
+        }
+        catch (error) {
+            notify(t("chat.configReadFailed", { error: error?.message ?? error }), "error");
+        }
+    };
+    const openKeyEditor = async () => {
+        try {
+            const config = await 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 定义」变了才需要重建会话；改的是别的模型、
+        // 别的端点的参数，当前会话不受影响，不该白重连一次。
+        const endpointChanged = !!currentEndpointRef.current && result.changedEndpointIds.includes(currentEndpointRef.current);
+        if (endpointChanged || result.mcpChanged || result.agentsChanged)
+            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"}