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

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":"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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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"}