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

package/dist/tui/highlight.js

@@ -0,0 +1,117 @@
+/**
+ * 语法高亮**数据层** —— 只负责产出「带 scope 的 token」，不关心颜色（颜色与 Ink 渲染
+ * 由 UI 层负责）。这样把「高亮数据（190+ 语言）」这件事交给专业库，
+ * 我们只写渲染，避免自造轮子在语言覆盖上以卵击石。
+ *
+ * 数据来源：**highlight.js**（经 **lowlight** 产出 **hast** 树）。
+ * 这与业界同类 Ink/React TUI（如 Google Gemini CLI 依赖 `highlight.js` + `lowlight`）
+ * 的做法一致：库给结构化的 `hljs-*` scope，我们逐段映射成 Ink `<Text>` 颜色。
+ */
+import { createLowlight, common } from "lowlight";
+/** 单例：注册 highlight.js 的 ~37 种常用语言（json / bash / ts / py / go / rust …） */
+const lowlight = createLowlight(common);
+function shortScope(className) {
+    return className.replace(/^hljs-/, "");
+}
+/** 深度优先展平 hast：文本节点继承「最内层」元素的 scope（更具体者优先） */
+function walk(nodes, scope, out) {
+    for (const node of nodes) {
+        if (node.type === "text") {
+            if (node.value)
+                out.push({ text: node.value, scope });
+        }
+        else if (node.type === "element") {
+            const classNames = node.properties?.className ?? [];
+            const next = classNames.length ? shortScope(classNames[classNames.length - 1]) : scope;
+            walk(node.children, next, out);
+        }
+    }
+}
+/** 结果缓存：完成态内容在一次会话里反复渲染（滚动 / 每次按键），命中缓存避免重复高亮 */
+const cache = new Map();
+const CACHE_LIMIT = 512;
+function memo(key, produce) {
+    const hit = cache.get(key);
+    if (hit)
+        return hit;
+    const value = produce();
+    if (cache.size >= CACHE_LIMIT)
+        cache.clear();
+    cache.set(key, value);
+    return value;
+}
+/**
+ * 按语言把代码切成带 scope 的 token。
+ *
+ * - 语言已注册：走 highlight.js 词法；
+ * - 语言缺失 / 未注册（含 ` ``` ` 无标注）：**原样返回**为单段 `plain`，不做猜测
+ *   （`highlightAuto` 在短片段上容易误判，宁可不着色也不误导）。
+ */
+export function highlightCode(code, lang) {
+    const language = (lang ?? "").trim().toLowerCase();
+    if (!language || !code)
+        return code ? [{ text: code, scope: "" }] : [];
+    return memo(`${language}\u0000${code}`, () => {
+        try {
+            const root = lowlight.highlight(language, code);
+            const out = [];
+            walk(root.children, "", out);
+            return out.length ? out : [{ text: code, scope: "" }];
+        }
+        catch {
+            // 未注册语言：不高亮
+            return [{ text: code, scope: "" }];
+        }
+    });
+}
+/** JSON 高亮（工具调用参数）：等价于 `highlightCode(code, "json")` */
+export function highlightJson(code) {
+    return highlightCode(code, "json");
+}
+/** 已注册语言列表（供文档 / 调试） */
+export function supportedLanguages() {
+    return lowlight.listLanguages().sort();
+}
+// ==================== 围栏切分 ====================
+const FENCE_RE = /^\s*```(.*)$/;
+/**
+ * 把正文切成「普通文本 / 围栏代码块」两类片段。
+ *
+ * 围栏行（``` 与 ```lang）本身作为分隔符**不进入片段**，只解析出语言存进 `lang`；
+ * 渲染时由 `contentLines` 依据 `lang` 重新画出围栏行（`​```lang` / `​```），
+ * 从而既能按语言高亮代码、又能保留围栏边界。
+ */
+export function splitFences(text) {
+    const segments = [];
+    let buf = [];
+    let mode = "text";
+    let lang;
+    const flush = () => {
+        if (buf.length) {
+            segments.push(mode === "code"
+                ? { type: "code", lang, text: buf.join("\n") }
+                : { type: "text", text: buf.join("\n") });
+        }
+        buf = [];
+    };
+    for (const line of text.split("\n")) {
+        const m = FENCE_RE.exec(line);
+        if (m) {
+            flush();
+            if (mode === "text") {
+                mode = "code";
+                lang = m[1].trim() || undefined;
+            }
+            else {
+                mode = "text";
+                lang = undefined;
+            }
+        }
+        else {
+            buf.push(line);
+        }
+    }
+    flush();
+    return segments;
+}
+//# sourceMappingURL=highlight.js.map

package/dist/tui/highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.js","sourceRoot":"","sources":["../../src/tui/highlight.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlD,0EAA0E;AAC1E,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAaxC,SAAS,UAAU,CAAC,SAAiB;IACnC,OAAO,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,+CAA+C;AAC/C,SAAS,IAAI,CAAC,KAAoB,EAAE,KAAa,EAAE,GAAc;IAC/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,KAAK;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,UAAU,GAAI,IAAI,CAAC,UAAU,EAAE,SAAkC,IAAI,EAAE,CAAC;YAC9E,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACxF,IAAI,CAAC,IAAI,CAAC,QAAyB,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;AAC3C,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,SAAS,IAAI,CAAC,GAAW,EAAE,OAAwB;IACjD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;IACxB,IAAI,KAAK,CAAC,IAAI,IAAI,WAAW;QAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC7C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAa;IACvD,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnD,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,OAAO,IAAI,CAAC,GAAG,QAAQ,SAAS,IAAI,EAAE,EAAE,GAAG,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAoB,CAAC;YACnE,MAAM,GAAG,GAAc,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;YACZ,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,kBAAkB;IAChC,OAAO,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,iDAAiD;AAEjD,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,IAAI,GAAG,GAAa,EAAE,CAAC;IACvB,IAAI,IAAI,GAAoB,MAAM,CAAC;IACnC,IAAI,IAAwB,CAAC;IAC7B,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CACX,IAAI,KAAK,MAAM;gBACb,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC9C,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3C,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,EAAE,CAAC;IACX,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,CAAC;YACN,KAAK,EAAE,CAAC;YACR,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,IAAI,GAAG,MAAM,CAAC;gBACd,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,MAAM,CAAC;gBACd,IAAI,GAAG,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tui/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * TUI 入口 —— 屏幕循环与终端状态安全
+ *
+ * 流程：启动界面 → 端点凭据预检（缺 API Key 时先引导输入）→ 对话屏
+ * （优先续接「上一轮会话」，否则新建对话）。
+ * 对话屏内 `/clear`、`/back`、`/load` 通过重挂载（新 Ink 实例 + 原生清屏）实现；
+ * 对话屏退出即结束进程。
+ *
+ * 终端安全：SIGINT / SIGTERM / 未捕获异常均卸载 Ink，恢复 raw mode 与光标。
+ */
+/**
+ * Ink 渲染选项（集中声明，便于单测锁定关键决策）。
+ *
+ * `kittyKeyboard` 刻意取 `disabled`，关闭 Kitty 键盘协议的「自动查询」：
+ *
+ * - Ink 的 `auto` 模式会在**每个实例创建时**发送一次 `CSI ? u` 查询，终端则回
+ *   `CSI ? 0 u`（flags=0，不支持）。本 TUI 会反复挂载（启动界面 → 对话 →
+ *   配置向导 …），于是应答源源不断；
+ * - 应答一旦被**拆包**（前导 ESC 被 Ink 的「待定转义刷新定时器」当作一次独立的
+ *   Escape 键消费），残留在后一个 chunk 里的 `[?0u` 会退化成普通文本被当作输入
+ *   插入输入框（已实测重现）；
+ * - 而该协议的收益（Ctrl / Alt / Shift + Enter 换行）在本环境本就不生效——
+ *   换行由不依赖终端协议的 `Ctrl+N` / `Ctrl+J` 承担。
+ */
+export declare const RENDER_OPTIONS: {
+    readonly exitOnCtrlC: false;
+    readonly alternateScreen: false;
+    readonly incrementalRendering: true;
+    readonly kittyKeyboard: {
+        readonly mode: "disabled";
+    };
+};
+export declare function runTui(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tui/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0CH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAkLX,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA6C5C"}

package/dist/tui/index.js

@@ -0,0 +1,265 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * TUI 入口 —— 屏幕循环与终端状态安全
+ *
+ * 流程：启动界面 → 端点凭据预检（缺 API Key 时先引导输入）→ 对话屏
+ * （优先续接「上一轮会话」，否则新建对话）。
+ * 对话屏内 `/clear`、`/back`、`/load` 通过重挂载（新 Ink 实例 + 原生清屏）实现；
+ * 对话屏退出即结束进程。
+ *
+ * 终端安全：SIGINT / SIGTERM / 未捕获异常均卸载 Ink，恢复 raw mode 与光标。
+ */
+import { render, useApp } from "ink";
+import { AgentRepository } from "@ai-zen/agents-sdk";
+import { AGENTS_DIR, readConfig, saveConfig } from "../config.js";
+import { resolveCredential } from "../config-editor.js";
+import { ConfigWizard } from "./config-wizard/index.js";
+import { conversationRepository } from "../conversation-repository.js";
+import { readLastSession } from "../session-pointer.js";
+import { Splash, Chat } from "./screens/index.js";
+/** ANSI：清屏 + 光标归位 + 显示光标（屏幕间切换时从头绘制，避免行偏移） */
+const CLEAR_SCREEN = "\x1b[2J\x1b[H\x1b[?25h";
+/**
+ * 告别并终止进程。
+ *
+ * Ink 卸载后，进程仍可能被残留句柄（TTY stdin 处于 flowing、SDK 的 Timeout/Immediate 等）
+ * 挂住，导致「返回 shell 却不退出、终端不归还」。这里显式恢复终端、暂停 stdin 并 exit，
+ * 保证退出即干净交还 shell（Windows 下 TTY 写为异步，用回调 + 兜底定时器双保险）。
+ */
+function farewell() {
+    try {
+        process.stdin.setRawMode?.(false);
+    }
+    catch {
+        /* ignore */
+    }
+    try {
+        process.stdin.pause();
+    }
+    catch {
+        /* ignore */
+    }
+    const finish = () => process.exit(0);
+    process.stdout.write("\x1b[?25h\n再见 👋\n", finish);
+    setTimeout(finish, 250);
+}
+/** 当前活动的 Ink 实例（用于信号处理时兜底卸载） */
+let activeInstance = null;
+/**
+ * Ink 渲染选项（集中声明，便于单测锁定关键决策）。
+ *
+ * `kittyKeyboard` 刻意取 `disabled`，关闭 Kitty 键盘协议的「自动查询」：
+ *
+ * - Ink 的 `auto` 模式会在**每个实例创建时**发送一次 `CSI ? u` 查询，终端则回
+ *   `CSI ? 0 u`（flags=0，不支持）。本 TUI 会反复挂载（启动界面 → 对话 →
+ *   配置向导 …），于是应答源源不断；
+ * - 应答一旦被**拆包**（前导 ESC 被 Ink 的「待定转义刷新定时器」当作一次独立的
+ *   Escape 键消费），残留在后一个 chunk 里的 `[?0u` 会退化成普通文本被当作输入
+ *   插入输入框（已实测重现）；
+ * - 而该协议的收益（Ctrl / Alt / Shift + Enter 换行）在本环境本就不生效——
+ *   换行由不依赖终端协议的 `Ctrl+N` / `Ctrl+J` 承担。
+ */
+export const RENDER_OPTIONS = {
+    exitOnCtrlC: false,
+    alternateScreen: false,
+    // 只重绘「变化的行」，而不是每帧擦除 + 重写整屏（Ink 默认 false，走 createStandard）。
+    // 流式高频下把每帧输出量从 O(屏幕大小) 降到 O(变化量)，显著减轻 SSH 带宽 / 背压压力。
+    incrementalRendering: true,
+    kittyKeyboard: { mode: "disabled" },
+};
+function mount(node) {
+    process.stdout.write(CLEAR_SCREEN);
+    const instance = render(node, RENDER_OPTIONS);
+    activeInstance = instance;
+    return instance.waitUntilExit().finally(() => {
+        if (activeInstance === instance)
+            activeInstance = null;
+    });
+}
+// ==================== 端点凭据预检 ====================
+/**
+ * 首启凭据门 —— 所选模型绑定的端点缺 API Key 时，先弹出 Ink 原生输入屏。
+ *
+ * 输入完成（或放弃）后退出该屏，把结果回传给 `mount()` 的返回值。
+ */
+function CredentialGate({ config, endpointId }) {
+    const { exit } = useApp();
+    return (_jsx(ConfigWizard, { config: config, onboarding: true, closeOnSave: true, initialStep: { kind: "edit", field: "apiKey", endpointId }, onSave: saveConfig, onClose: (result) => exit(result) }));
+}
+/**
+ * 端点凭据预检：返回 `false` 表示用户放弃配置（调用方应退出）。
+ *
+ * 配置本身残缺（模型 / 端点不存在）时不在此拦截 —— 交给对话屏报错，
+ * 那里可按 `k` 打开配置中心自行修配置。
+ */
+async function ensureCredential(modelId) {
+    const config = await readConfig();
+    const credential = resolveCredential(config, modelId);
+    if (!credential || credential.configured)
+        return true;
+    const result = (await mount(_jsx(CredentialGate, { config: config, endpointId: credential.endpointId })));
+    return Boolean(result?.dirty);
+}
+async function resolveTarget() {
+    const config = await readConfig();
+    const repository = new AgentRepository(AGENTS_DIR);
+    const agents = await repository.list();
+    const agentId = config.defaultAgent ?? agents[0]?.id;
+    let modelId;
+    if (agentId) {
+        const agent = await repository.read(agentId);
+        modelId = agent?.modelId;
+    }
+    modelId = modelId ?? config.defaultModel ?? config.models[0]?.id;
+    if (!modelId) {
+        throw new Error("没有可用的模型，请先在配置中添加端点与模型（配置文件 config.json）");
+    }
+    return { modelId, agentId };
+}
+/** 目标模型是否仍在配置中（续接的会话可能引用了已删除的模型） */
+async function modelExists(modelId) {
+    const config = await readConfig();
+    return config.models.some((model) => model.id === modelId);
+}
+/** 读取「上一轮会话 id」指针，续接该会话（指针缺失或会话不存在时返回 null） */
+async function resumeLastSession() {
+    const pointer = await readLastSession(process.cwd());
+    if (!pointer)
+        return null;
+    const conversation = await conversationRepository.read(pointer.id);
+    if (!conversation)
+        return null;
+    return targetFromMessages({
+        modelId: conversation.modelId,
+        agentId: conversation.agentId,
+        messages: conversation.messages,
+        conversationId: conversation.id,
+        conversationName: conversation.id,
+    });
+}
+/** 从已保存对话构造对话目标 */
+function targetFromMessages(input) {
+    return {
+        modelId: input.modelId,
+        agentId: input.agentId,
+        messages: input.messages,
+        conversationId: input.conversationId,
+        conversationName: input.conversationName,
+    };
+}
+// ==================== 对话屏 ====================
+/**
+ * 运行对话屏；`/clear`、`/back`、`/load` 通过重挂载（新 Ink 实例 + 原生清屏）实现，
+ * 其余退出（退出）直接结束。
+ */
+async function runChat(target) {
+    let current = target;
+    let messages = target.messages;
+    let initialInput;
+    while (true) {
+        const result = await mount(_jsx(Chat, { modelId: current.modelId, agentId: current.agentId, messages: messages, conversationId: current.conversationId, conversationName: current.conversationName, initialInput: initialInput }));
+        if (result && typeof result === "object") {
+            const value = result;
+            if (value.load) {
+                // /load：整体切换到另一段已保存对话（含模型 / Agent），重挂载对话屏
+                current = {
+                    modelId: value.load.modelId,
+                    agentId: value.load.agentId,
+                    conversationId: value.load.conversationId,
+                    conversationName: value.load.conversationName,
+                };
+                messages = value.load.messages;
+                initialInput = undefined;
+                continue;
+            }
+            if (value.restart) {
+                messages = value.messages ?? messages;
+                initialInput = value.initialInput;
+                continue;
+            }
+        }
+        return;
+    }
+}
+// ==================== 入口 ====================
+export async function runTui() {
+    const uninstallSignals = installSignalSafety();
+    try {
+        // 启动界面（一次性）
+        await mount(_jsx(Splash, {}));
+        // 直达对话：优先续接「上一轮会话」，否则新建对话
+        let target = await resumeLastSession();
+        if (target && !(await modelExists(target.modelId))) {
+            // 续接目标引用了已从配置中删除的模型：退回默认模型但保留历史，
+            // 避免卡在「模型不存在」的报错屏而无处可走
+            const fallback = await resolveTarget().catch(() => null);
+            target = fallback
+                ? {
+                    ...fallback,
+                    messages: target.messages,
+                    conversationId: target.conversationId,
+                    conversationName: target.conversationName,
+                }
+                : null;
+        }
+        else if (!target) {
+            try {
+                target = await resolveTarget();
+            }
+            catch (error) {
+                process.stderr.write(`\n✖ 无法启动对话：${error?.message ?? error}\n`);
+            }
+        }
+        if (!target) {
+            farewell();
+            return;
+        }
+        // 端点凭据预检：未配置 API Key 时先弹出输入屏，而不是「报错即退出」
+        if (!(await ensureCredential(target.modelId))) {
+            farewell();
+            return;
+        }
+        await runChat(target);
+        farewell();
+    }
+    finally {
+        uninstallSignals();
+        activeInstance = null;
+    }
+}
+/** 安装信号与异常兜底：任何异常退出路径都先卸载 Ink，避免「花屏终端」 */
+function installSignalSafety() {
+    const restore = () => {
+        try {
+            activeInstance?.unmount();
+        }
+        catch {
+            /* 忽略 */
+        }
+        activeInstance = null;
+    };
+    const onSigint = () => {
+        restore();
+        process.exit(130);
+    };
+    const onSigterm = () => {
+        restore();
+        process.exit(143);
+    };
+    const onFatal = (error) => {
+        restore();
+        process.stderr.write(`\n✖ 意外错误: ${error?.message ?? error}\n`);
+        process.exit(1);
+    };
+    process.on("SIGINT", onSigint);
+    process.on("SIGTERM", onSigterm);
+    process.on("uncaughtException", onFatal);
+    process.on("unhandledRejection", onFatal);
+    return () => {
+        process.off("SIGINT", onSigint);
+        process.off("SIGTERM", onSigterm);
+        process.off("uncaughtException", onFatal);
+        process.off("unhandledRejection", onFatal);
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/tui/index.js.map

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

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

@@ -0,0 +1,35 @@
+import { Dispatch, SetStateAction } from "react";
+import type { HandoffMode } from "@ai-zen/agents-sdk";
+import { SelectItem } from "../components.js";
+import { ChatSession } from "../chat-session.js";
+import { WizardStep } from "../config-wizard/index.js";
+export interface ChatCommandHost {
+    session: ChatSession;
+    /** 通知通道：命令反馈（保存 / 清除 / 迁移结果 …）走独立栏位，不进 messages */
+    notice: (text: string, tone?: "info" | "error") => void;
+    /** 清屏（保留上下文）：把转录显示起点推到最新 */
+    clearTranscript: () => void;
+    rows: number;
+    exit: (arg?: any) => void;
+    suspendTerminal: (fn: () => void | Promise<void>) => Promise<void>;
+    openWizard: (step: WizardStep) => Promise<void>;
+    openKeyEditor: () => Promise<void>;
+    doExit: () => void;
+    setPickerState: Dispatch<SetStateAction<{
+        title: string;
+        items: SelectItem<string>[];
+        resolve: (value: string | null) => void;
+    } | null>>;
+    setConfirmState: Dispatch<SetStateAction<{
+        question: string;
+        resolve: (value: boolean) => void;
+    } | null>>;
+    setInputText: (text: string) => void;
+}
+/**
+ * 解析命令后的执行者参数（`/migrate self`、`/handoff summary`）。
+ * 缺省返回 undefined（走服务默认值）；非法值也返回 undefined，由调用方报错。
+ */
+export declare function parseHandoffMode(raw?: string): HandoffMode | undefined;
+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

@@ -0,0 +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;AAI/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGvD,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;CACtC;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,CAkNhG"}