@armadra/agent 0.5.0 → 0.5.1

package/dist/cli/choice-prompt.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CLI 子命令的方向键选择（零依赖）：TTY 下 raw mode 画一个编号选项列表，原地重画。
+ *
+ * - 按键：↑↓（与 Ctrl+P / Ctrl+N）移动、Enter 确认、数字直选、选项按键提示里的单个字母直选（`y` / `n`），
+ *   Esc / Ctrl+C / stdin 结束 = 取消；
+ * - 结束后把列表收成一行「? 问题 答案」，恢复 raw 状态与光标，暂停 stdin；进程意外退出时也恢复；
+ * - 颜色与字形按环境：`NO_COLOR` / 非 TTY 输出无色，`AMA_ASCII` / 区域设置决定 ASCII 字形（字形表见
+ *   docs/tui-design.md §2.2）；
+ * - 输入不是可开 raw 的 TTY（管道、CI）时 {@link confirmContinue} 回落为原来的文本 `[y/N]` 问答。
+ */
+export interface ChoiceInput {
+    isTTY?: boolean;
+    isRaw?: boolean;
+    setRawMode?(raw: boolean): unknown;
+    on(event: "data" | "end", listener: (chunk?: Buffer | string) => void): unknown;
+    off(event: "data" | "end", listener: (chunk?: Buffer | string) => void): unknown;
+    resume?(): unknown;
+    pause?(): unknown;
+}
+export interface ChoiceOption {
+    label: string;
+    /** 右侧按键提示（空格分隔）；其中的单个字母同时是直选键。 */
+    keys?: string;
+}
+export interface PromptChoiceOptions {
+    question: string;
+    options: readonly ChoiceOption[];
+    /** 缺省选中的下标。 */
+    selected?: number;
+    /** 缺省 `process.stdin`。 */
+    input?: ChoiceInput;
+    /** 缺省写 stderr。 */
+    write?(text: string): void;
+    env?: NodeJS.ProcessEnv;
+    /** 输出是否 TTY（决定颜色）；缺省看 stderr。 */
+    outputIsTTY?: boolean;
+}
+/** 能否用方向键选择：输入是 TTY 且能开 raw。 */
+export declare function canPromptChoice(input?: ChoiceInput): boolean;
+/** 一块输入切成单个按键（转义序列整体、其余逐字符）。 */
+export declare function splitKeys(data: string): string[];
+/** 方向键选择：返回选中的下标，取消返回 undefined。调用方先用 {@link canPromptChoice} 判断。 */
+export declare function promptChoice(options: PromptChoiceOptions): Promise<number | undefined>;
+export interface ConfirmOptions {
+    /** 缺省「继续？」。 */
+    question?: string;
+    input?: ChoiceInput & NodeJS.ReadableStream;
+    write?(text: string): void;
+    /** 文本回落时问句写到哪里，缺省 stderr。 */
+    output?: NodeJS.WritableStream;
+    env?: NodeJS.ProcessEnv;
+    outputIsTTY?: boolean;
+}
+/**
+ * 计费 / 写入前的确认：TTY 下方向键选择「继续 / 取消」（缺省取消，`y` / `n` 直选）；
+ * 否则回落为文本 `继续？[y/N]`（只有 y / yes 算同意）。
+ */
+export declare function confirmContinue(options?: ConfirmOptions): Promise<boolean>;

package/dist/cli/choice-prompt.js

@@ -0,0 +1,140 @@
+/**
+ * CLI 子命令的方向键选择（零依赖）：TTY 下 raw mode 画一个编号选项列表，原地重画。
+ *
+ * - 按键：↑↓（与 Ctrl+P / Ctrl+N）移动、Enter 确认、数字直选、选项按键提示里的单个字母直选（`y` / `n`），
+ *   Esc / Ctrl+C / stdin 结束 = 取消；
+ * - 结束后把列表收成一行「? 问题 答案」，恢复 raw 状态与光标，暂停 stdin；进程意外退出时也恢复；
+ * - 颜色与字形按环境：`NO_COLOR` / 非 TTY 输出无色，`AMA_ASCII` / 区域设置决定 ASCII 字形（字形表见
+ *   docs/tui-design.md §2.2）；
+ * - 输入不是可开 raw 的 TTY（管道、CI）时 {@link confirmContinue} 回落为原来的文本 `[y/N]` 问答。
+ */
+import { createInterface } from "node:readline/promises";
+import { createTheme, defaultKeybindings, detectCapabilities, padToWidth, resolveAscii, visibleWidth, } from "../tui.js";
+const HIDE_CURSOR = "\x1b[?25l";
+const SHOW_CURSOR = "\x1b[?25h";
+/** 能否用方向键选择：输入是 TTY 且能开 raw。 */
+export function canPromptChoice(input = process.stdin) {
+    return input.isTTY === true && typeof input.setRawMode === "function";
+}
+/** 一块输入切成单个按键（转义序列整体、其余逐字符）。 */
+export function splitKeys(data) {
+    return data.match(/\x1b\[[0-9;?]*[ -/]*[@-~]|\x1bO[A-Za-z]|\x1b(?![[O])|[\s\S]/gu) ?? [];
+}
+/** 方向键选择：返回选中的下标，取消返回 undefined。调用方先用 {@link canPromptChoice} 判断。 */
+export function promptChoice(options) {
+    const input = options.input ?? process.stdin;
+    const write = options.write ?? ((text) => void process.stderr.write(text));
+    const env = options.env ?? process.env;
+    const theme = createTheme("dark", {
+        caps: detectCapabilities(env, options.outputIsTTY ?? process.stderr.isTTY === true),
+        ascii: resolveAscii(undefined, env),
+    });
+    const g = theme.glyphs;
+    const items = options.options;
+    const n = items.length;
+    let selected = Math.max(0, Math.min(n - 1, options.selected ?? 0));
+    let drawn = 0;
+    const keyWidth = Math.max(0, ...items.map((o) => (o.keys ?? "").length));
+    const labelWidth = Math.max(...items.map((o) => visibleWidth(o.label)));
+    const question = `${theme.fg("accent", "?")} ${theme.bold(options.question)}`;
+    const frame = () => [
+        question,
+        ...items.map((item, i) => {
+            const on = i === selected;
+            const left = `${on ? g.prompt : " "} ${i + 1}. ${padToWidth(item.label, labelWidth)}`;
+            const keys = item.keys === undefined ? "" : `  ${theme.fg("dim", item.keys.padEnd(keyWidth))}`;
+            return (on ? theme.fg("accent", theme.bold(left)) : left) + keys;
+        }),
+        theme.fg("dim", `${g.arrowUp}${g.arrowDown} 选择 · Enter 确认 · 1-${n} 直接选 · Esc 取消`),
+    ];
+    const draw = (lines) => {
+        const up = drawn > 0 ? `\x1b[${drawn}A` : "";
+        write(`${up}\r\x1b[J${lines.join("\n")}\n`);
+        drawn = lines.length;
+    };
+    return new Promise((resolve) => {
+        const wasRaw = input.isRaw === true;
+        let done = false;
+        const restore = () => {
+            input.setRawMode?.(wasRaw);
+            write(SHOW_CURSOR);
+        };
+        const finish = (index) => {
+            if (done)
+                return;
+            done = true;
+            input.off("data", onData);
+            input.off("end", onEnd);
+            process.off("exit", restore);
+            const answer = index === undefined ? "（已取消）" : items[index].label;
+            draw([`${question} ${theme.fg("dim", answer)}`]);
+            restore();
+            input.pause?.();
+            resolve(index);
+        };
+        const onKey = (key) => {
+            const letter = /^[a-z]$/i.test(key) ? key.toLowerCase() : "";
+            const byLetter = letter === "" ? -1 : items.findIndex((o) => (o.keys ?? "").split(/\s+/).includes(letter));
+            if (byLetter !== -1)
+                return finish(byLetter);
+            if (defaultKeybindings.matches(key, "tui.select.cancel"))
+                return finish(undefined);
+            if (/^[1-9]$/.test(key) && Number(key) <= n)
+                return finish(Number(key) - 1);
+            if (key === "\r" || key === "\n")
+                return finish(selected);
+            if (defaultKeybindings.matches(key, "tui.select.up"))
+                selected = (selected + n - 1) % n;
+            else if (defaultKeybindings.matches(key, "tui.select.down"))
+                selected = (selected + 1) % n;
+            else
+                return;
+            draw(frame());
+        };
+        const onData = (chunk) => {
+            for (const key of splitKeys(String(chunk ?? ""))) {
+                if (done)
+                    return;
+                onKey(key);
+            }
+        };
+        const onEnd = () => finish(undefined);
+        process.once("exit", restore);
+        input.setRawMode?.(true);
+        write(HIDE_CURSOR);
+        draw(frame());
+        input.on("data", onData);
+        input.on("end", onEnd);
+        input.resume?.();
+    });
+}
+/**
+ * 计费 / 写入前的确认：TTY 下方向键选择「继续 / 取消」（缺省取消，`y` / `n` 直选）；
+ * 否则回落为文本 `继续？[y/N]`（只有 y / yes 算同意）。
+ */
+export async function confirmContinue(options = {}) {
+    const question = options.question ?? "继续？";
+    const input = options.input ?? process.stdin;
+    if (canPromptChoice(input)) {
+        const index = await promptChoice({
+            question,
+            options: [
+                { label: "继续", keys: "y" },
+                { label: "取消", keys: "n Esc" },
+            ],
+            selected: 1,
+            input,
+            ...(options.write !== undefined ? { write: options.write } : {}),
+            ...(options.env !== undefined ? { env: options.env } : {}),
+            ...(options.outputIsTTY !== undefined ? { outputIsTTY: options.outputIsTTY } : {}),
+        });
+        return index === 0;
+    }
+    const rl = createInterface({ input, output: options.output ?? process.stderr });
+    try {
+        return /^y(es)?$/i.test((await rl.question(`${question}[y/N] `)).trim());
+    }
+    finally {
+        rl.close();
+    }
+}

package/dist/cli/subcommands/models-cache-probe.d.ts

@@ -7,7 +7,7 @@
  * （字段缺失或恒 0）；其余（读到一点、只有写入）→ `inconclusive`（粒度或 TTL 问题）。
  *
  * 计费动作：执行前打印预估（两次 × `--tokens` × 目录输入价，无价 `$?`）；非 TTY 必须 `--yes`
- * （否则退出 2），TTY 下问一次 y/N。`--json` 时预估写 stderr，stdout 只有一个结果对象。
+ * （否则退出 2），TTY 下方向键选一次「继续 / 取消」（choice-prompt.ts）。`--json` 时预估写 stderr，stdout 只有一个结果对象。
  * 协议层不保留原始响应，「usage 字段」列的是该协议解析时读取的字段名。
  */
 import type { Api, Model, Usage } from "../../ai/types.js";

package/dist/cli/subcommands/models-cache-probe.js

@@ -7,12 +7,12 @@
  * （字段缺失或恒 0）；其余（读到一点、只有写入）→ `inconclusive`（粒度或 TTL 问题）。
  *
  * 计费动作：执行前打印预估（两次 × `--tokens` × 目录输入价，无价 `$?`）；非 TTY 必须 `--yes`
- * （否则退出 2），TTY 下问一次 y/N。`--json` 时预估写 stderr，stdout 只有一个结果对象。
+ * （否则退出 2），TTY 下方向键选一次「继续 / 取消」（choice-prompt.ts）。`--json` 时预估写 stderr，stdout 只有一个结果对象。
  * 协议层不保留原始响应，「usage 字段」列的是该协议解析时读取的字段名。
  */
-import { createInterface } from "node:readline/promises";
 import { priceTokens } from "../../ai/cost.js";
 import { UsageError } from "../args.js";
+import { confirmContinue } from "../choice-prompt.js";
 import { ExitCode } from "../exit-codes.js";
 export const PROBE_DEFAULT_TOKENS = 2048;
 export const PROBE_DEFAULT_GAP_MS = 3000;
@@ -78,15 +78,6 @@ function intOption(ctx, name, fallback, min) {
         throw new UsageError(`--${name} 应为不小于 ${min} 的整数`);
     return value;
 }
-async function confirm() {
-    const rl = createInterface({ input: process.stdin, output: process.stderr });
-    try {
-        return /^y(es)?$/i.test((await rl.question("继续？[y/N] ")).trim());
-    }
-    finally {
-        rl.close();
-    }
-}
 function sampleLine(index, s) {
     const field = s.cacheReported === undefined ? "?" : s.cacheReported ? "有" : "无";
     return `#${index}  input ${s.input} · cacheRead ${s.cacheRead} · cacheWrite ${s.cacheWrite} · 缓存字段 ${field}`;
@@ -122,7 +113,7 @@ async function run(ctx) {
             io.stderr("ama: cache-probe 会发两次计费请求，非交互环境需加 --yes\n");
             return ExitCode.Usage;
         }
-        if (!(await confirm())) {
+        if (!(await confirmContinue({ env: io.env }))) {
             io.stderr("ama: 已取消\n");
             return ExitCode.Ok;
         }

package/dist/cli/subcommands/providers.d.ts

@@ -8,7 +8,7 @@
  * - list / channels：供应商 → 渠道 → 模型数与 key 来源（从不显示 key）。remove：删配置与 auth.json 条目。
  *
  * 计费：`--probe` 每模型每渠道一次最小请求（并发执行，见到首个流事件即判可用并断开，见
- * probe-runner.ts）；执行前打印预估，TTY 问 y/N，非 TTY 必须 `--yes`。
+ * probe-runner.ts）；执行前打印预估，TTY 下方向键选「继续 / 取消」（choice-prompt.ts，y / n 直选），非 TTY 必须 `--yes`。
  */
 import type { AmaConfig } from "../../config/types.js";
 import type { CliIo, RuntimeDeps } from "../deps.js";

package/dist/cli/subcommands/providers.js

@@ -8,10 +8,9 @@
  * - list / channels：供应商 → 渠道 → 模型数与 key 来源（从不显示 key）。remove：删配置与 auth.json 条目。
  *
  * 计费：`--probe` 每模型每渠道一次最小请求（并发执行，见到首个流事件即判可用并断开，见
- * probe-runner.ts）；执行前打印预估，TTY 问 y/N，非 TTY 必须 `--yes`。
+ * probe-runner.ts）；执行前打印预估，TTY 下方向键选「继续 / 取消」（choice-prompt.ts，y / n 直选），非 TTY 必须 `--yes`。
  */
 import { existsSync } from "node:fs";
-import { createInterface } from "node:readline/promises";
 import { describeModelsDev, loadModelsDevIndex } from "../../ai/providers/models-dev-cache.js";
 import { modelsDevFields } from "../../ai/providers/models-dev.js";
 import { PROVIDER_ID_PATTERN, setAuthKey } from "../../config/auth-file.js";
@@ -19,6 +18,7 @@ import { loadConfigFile } from "../../config/load.js";
 import { CONFIG_FILE_VERSION } from "../../config/types.js";
 import { writeConfigFile } from "../../config/write.js";
 import { parseSubArgs, UsageError } from "../args.js";
+import { confirmContinue } from "../choice-prompt.js";
 import { pickByPrice } from "../default-model.js";
 import { ExitCode } from "../exit-codes.js";
 import { extractKey } from "./auth.js";
@@ -76,13 +76,7 @@ export function userConfig(level) {
 }
 async function confirm(io, question) {
     io.stderr(question);
-    const rl = createInterface({ input: process.stdin, output: process.stderr });
-    try {
-        return /^y(es)?$/i.test((await rl.question("继续？[y/N] ")).trim());
-    }
-    finally {
-        rl.close();
-    }
+    return confirmContinue({ env: io.env });
 }
 /** --yes / TTY 确认；非 TTY 且没有 --yes 返回 false 并提示（调用方退出 2）。 */
 async function approved(ctx, what) {

package/dist/modes/commands-core.d.ts

@@ -14,6 +14,7 @@
 import type { AgentSession, RewindDraftText } from "../agent/types.js";
 import type { SwitchRequest } from "../cli/compose-session.js";
 import type { Runtime } from "../cli/runtime.js";
+import type { PermissionMode } from "../permissions/types.js";
 export { describeSession } from "./session-report.js";
 export type CommandResult = {
     kind: "handled";
@@ -36,6 +37,11 @@ export interface CommandContext {
     /** 当前会话（切换后是新的那个）。 */
     session(): AgentSession;
     switchSession(request: SwitchRequest): Promise<AgentSession>;
+    /**
+     * `/permission <模式>` 切换前的确认（进入 Bypass 前问一次，见 permissions/bypass.ts）；返回 false
+     * 保持原模式。没有时直接切换（管道、RPC 等无人值守入口）。
+     */
+    confirmPermissionMode?(mode: PermissionMode): boolean | Promise<boolean>;
 }
 export interface CommandInfo {
     name: string;

package/dist/modes/commands-core.js

@@ -171,6 +171,15 @@ export async function runSlashCommand(line, ctx) {
             if (mode === undefined) {
                 throw new AmaError("invalid_arguments", `权限模式应为 ${PERMISSION_MODE_ORDER.join(" | ")}（也可写显示名，如 "Accept edits"）`);
             }
+            const current = session.state.permissionMode;
+            if (mode !== current && ctx.confirmPermissionMode !== undefined) {
+                if (!(await ctx.confirmPermissionMode(mode))) {
+                    return {
+                        kind: "handled",
+                        message: `已取消，权限模式仍为 ${permissionModeLabel(current)}`,
+                    };
+                }
+            }
             session.setPermissionMode(mode);
             return { kind: "handled", message: `权限模式：${permissionModeLabel(mode)}` };
         }

package/dist/modes/interactive/commands.d.ts

@@ -14,6 +14,7 @@
 import type { AgentSession, RewindDraftText } from "../../agent/types.js";
 import type { SwitchRequest } from "../../cli/compose-session.js";
 import type { Runtime } from "../../cli/runtime.js";
+import type { PermissionMode } from "../../permissions/types.js";
 import type { Component, SelectItem, Theme } from "../../tui.js";
 import { type CommandInfo } from "../commands-core.js";
 import { type NoticeLevel } from "./message-view.js";
@@ -48,6 +49,8 @@ export interface CommandUi {
     home?: string;
     /** 进程环境：给出时 /model 选择器按 fake-visibility 规则藏起测试供应商 fake。 */
     env?: Readonly<Record<string, string | undefined>>;
+    /** 切换权限模式前的确认（进入 Bypass 前弹确认框）；返回 false 保持原模式。 */
+    confirmMode?(mode: PermissionMode): boolean | Promise<boolean>;
     /** [W5-U] 界面自己处理的第五波命令（agent-ui.ts）；处理了返回 true。 */
     extra?(name: string, args: string): Promise<boolean>;
 }

package/dist/modes/interactive/commands.js

@@ -13,6 +13,7 @@
  */
 import { formatModelRef } from "../../ai/providers/channels.js";
 import { AgentSessionImpl } from "../../agent/session.js";
+import { THINKING_LEVELS } from "../../ai/thinking.js";
 import { listSessions } from "../../cli/compose-store.js";
 import { hideFakeProvider } from "../../cli/fake-visibility.js";
 import { AUTO_LAYER_TEXT, permissionModeLabel } from "../../permissions/modes.js";
@@ -30,7 +31,7 @@ export const KEY_HINTS = [
     "Enter 发送（运行中 = 插话）  Alt+Enter 排到本轮之后  Shift+Enter / Ctrl+J 换行",
     "Esc 中断（排队消息回填编辑器）  Alt+↑ 取回最后一条排队消息",
     "空闲时 Esc Esc：输入框为空 = 回滚（/rewind），有字 = 清空（↑ 取回）",
-    "Shift+Tab 切换权限模式  Ctrl+L 模型  Ctrl+T 思考级别  Ctrl+O 展开工具输出与思考",
+    "Shift+Tab / Tab（输入为空时）切换权限模式（进入 Bypass 前确认）  Ctrl+L 模型  Ctrl+T 思考级别  Ctrl+O 展开工具输出与思考",
     "审批：1–3 或 ↑↓ Enter 选择，y 允许  a 本会话允许同类  n / Esc 拒绝  v 完整输入",
     "计划审批：1 批准  2 新上下文执行  3 继续修改  4 放弃并退出 Plan  e 编辑计划  Esc 留在 Plan",
     "Ctrl+V 粘贴剪贴板图片（插入 @路径）  Ctrl+G 底部信息行两行 / 一行",
@@ -164,6 +165,11 @@ async function handlePick(what, ui) {
             if (picked === undefined)
                 return;
             const mode = picked.value;
+            const current = session.state.permissionMode;
+            if (mode !== current && ui.confirmMode !== undefined && !(await ui.confirmMode(mode))) {
+                ui.notice("info", `已取消，权限模式仍为 ${permissionModeLabel(current)}`);
+                return;
+            }
             session.setPermissionMode(mode);
             ui.notice("info", `权限模式：${permissionModeLabel(mode)}`);
             return;
@@ -176,6 +182,10 @@ async function handlePick(what, ui) {
                 title: "思考级别",
                 items: thinkingItems(reasoning),
                 selected: session.state.thinkingLevel,
+                currentValue: session.state.thinkingLevel,
+                filterable: false,
+                numberKeys: true,
+                footer: `↑↓ 选择 · 1-${THINKING_LEVELS.length} 直接选 · Enter 确认 · Esc 取消`,
             });
             if (picked !== undefined)
                 session.setThinkingLevel(picked.value);
@@ -222,6 +232,7 @@ export async function runInteractiveCommand(line, ui) {
             runtime: ui.runtime,
             session: () => ui.session(),
             switchSession: (request) => ui.switchSession(request),
+            ...(ui.confirmMode !== undefined ? { confirmPermissionMode: ui.confirmMode } : {}),
         });
         if (result === undefined)
             return false;

package/dist/modes/interactive/confirm-dialog.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 通用确认框：底部覆盖层 + `Box`，选项样式与审批对话框一致（终端界面视觉设计 v1 §3.11）。
+ *
+ * - 编号选项 `› 1. 进入 Bypass   y`，选中行 `›` + `selection` 底色，右侧按键提示 `dim`；
+ * - 按键：↑↓ 移动（循环）、Enter 确认、数字直选、选项按键提示里的单个字母直选（如 `y` / `n`）；
+ *   Esc / Ctrl+C / `tui.select.cancel` 取消（返回 undefined）；
+ * - 宽 < 56 列紧凑：去掉空行、按键提示只留第一个、底部提示缩短。字形取 `theme.glyphs`（ASCII 回退）。
+ *
+ * 用途：进入 Bypass permissions 前的确认（`confirmBypass`，permissions/bypass.ts）。
+ */
+import { type Component, type Focusable, type Keybindings, type OverlayHandle, type OverlayOptions, type SemanticColor, type Theme } from "../../tui.js";
+export interface ChoiceOption {
+    label: string;
+    /** 右侧按键提示（空格分隔）；其中的单个字母同时是直选键。 */
+    keys: string;
+}
+export interface ChoiceSpec {
+    title: string;
+    /** 正文（已着色），选项之上。 */
+    body: readonly string[];
+    options: readonly ChoiceOption[];
+    /** 缺省选中的下标。 */
+    selected?: number;
+    borderColor?: SemanticColor;
+}
+export interface ChoiceHost {
+    theme: Theme;
+    keybindings?: Keybindings;
+    showOverlay(component: Component, options: OverlayOptions): OverlayHandle;
+}
+export declare class ChoiceDialog implements Component, Focusable {
+    private readonly spec;
+    private readonly host;
+    private readonly done;
+    focused: boolean;
+    private selected;
+    constructor(spec: ChoiceSpec, host: Omit<ChoiceHost, "showOverlay">, done: (index: number | undefined) => void);
+    get selectedIndex(): number;
+    handleInput(data: string): void;
+    render(width: number): string[];
+    private optionLines;
+    invalidate(): void;
+}
+/** 打开确认框（底部覆盖层）：返回选中的下标，取消返回 undefined。 */
+export declare function openChoice(host: ChoiceHost, spec: ChoiceSpec): Promise<number | undefined>;
+/** Bypass 确认框的内容（缺省选中「取消」，边框 warning）。 */
+export declare function bypassChoiceSpec(theme: Theme): ChoiceSpec;
+/** 进入 Bypass 前问一次：选「进入 Bypass」返回 true，取消 / 选「取消」返回 false。 */
+export declare function confirmBypass(host: ChoiceHost): Promise<boolean>;

package/dist/modes/interactive/confirm-dialog.js

@@ -0,0 +1,121 @@
+/**
+ * 通用确认框：底部覆盖层 + `Box`，选项样式与审批对话框一致（终端界面视觉设计 v1 §3.11）。
+ *
+ * - 编号选项 `› 1. 进入 Bypass   y`，选中行 `›` + `selection` 底色，右侧按键提示 `dim`；
+ * - 按键：↑↓ 移动（循环）、Enter 确认、数字直选、选项按键提示里的单个字母直选（如 `y` / `n`）；
+ *   Esc / Ctrl+C / `tui.select.cancel` 取消（返回 undefined）；
+ * - 宽 < 56 列紧凑：去掉空行、按键提示只留第一个、底部提示缩短。字形取 `theme.glyphs`（ASCII 回退）。
+ *
+ * 用途：进入 Bypass permissions 前的确认（`confirmBypass`，permissions/bypass.ts）。
+ */
+import { BYPASS_CHOICES, BYPASS_CONFIRM_TITLE, BYPASS_DEFAULT_CHOICE, BYPASS_RISK_LINES, } from "../../permissions/bypass.js";
+import { Box, defaultKeybindings, matchesKey, padToWidth, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "../../tui.js";
+/** 宽度低于它（Box 外宽）时用紧凑布局。 */
+const COMPACT_WIDTH = 56;
+export class ChoiceDialog {
+    spec;
+    host;
+    done;
+    focused = false;
+    selected;
+    constructor(spec, host, done) {
+        this.spec = spec;
+        this.host = host;
+        this.done = done;
+        this.selected = Math.max(0, Math.min(spec.options.length - 1, spec.selected ?? 0));
+    }
+    get selectedIndex() {
+        return this.selected;
+    }
+    handleInput(data) {
+        const keys = this.host.keybindings ?? defaultKeybindings;
+        const n = this.spec.options.length;
+        const letter = data.length === 1 ? data.toLowerCase() : "";
+        const byLetter = letter === "" || !/^[a-z]$/.test(letter)
+            ? -1
+            : this.spec.options.findIndex((o) => o.keys.split(/\s+/).includes(letter));
+        if (byLetter !== -1)
+            this.done(byLetter);
+        else if (matchesKey(data, "escape") ||
+            keys.matches(data, "app.clear") ||
+            keys.matches(data, "tui.select.cancel")) {
+            this.done(undefined);
+        }
+        else if (/^[1-9]$/.test(data) && Number(data) <= n)
+            this.done(Number(data) - 1);
+        else if (keys.matches(data, "tui.select.up"))
+            this.selected = (this.selected + n - 1) % n;
+        else if (keys.matches(data, "tui.select.down"))
+            this.selected = (this.selected + 1) % n;
+        else if (matchesKey(data, "enter"))
+            this.done(this.selected);
+    }
+    render(width) {
+        const { theme } = this.host;
+        const compact = width + 4 < COMPACT_WIDTH;
+        const lines = [];
+        for (const line of this.spec.body)
+            lines.push(...wrapTextWithAnsi(line, width));
+        if (!compact)
+            lines.push("");
+        lines.push(...this.optionLines(width, compact));
+        if (!compact)
+            lines.push("");
+        const g = theme.glyphs;
+        const arrows = g.arrowUp + g.arrowDown;
+        const n = this.spec.options.length;
+        lines.push(theme.fg("dim", compact
+            ? `${arrows} Enter · 1-${n} · Esc`
+            : `${arrows} 选择 · Enter 确认 · 1-${n} 直接选 · Esc 取消`));
+        return lines.map((l) => truncateToWidth(l, width));
+    }
+    optionLines(width, compact) {
+        const { theme } = this.host;
+        const g = theme.glyphs;
+        const shown = this.spec.options.map((o) => (compact ? o.keys.split(/\s+/)[0] : o.keys));
+        const keyWidth = Math.max(...shown.map((k) => visibleWidth(k)));
+        return this.spec.options.map((option, i) => {
+            const selected = i === this.selected;
+            const left = `${selected ? g.prompt : " "} ${i + 1}. ${option.label}`;
+            const right = padToWidth(shown[i], keyWidth);
+            const room = Math.max(1, width - keyWidth - 1);
+            const label = selected ? theme.fg("accent", theme.bold(left)) : left;
+            const line = padToWidth(truncateToWidth(label, room), room) + " " + theme.fg("dim", right);
+            return selected ? theme.bg("selection", line) : line;
+        });
+    }
+    invalidate() { }
+}
+/** 打开确认框（底部覆盖层）：返回选中的下标，取消返回 undefined。 */
+export function openChoice(host, spec) {
+    return new Promise((resolve) => {
+        let handle;
+        let settled = false;
+        const dialog = new ChoiceDialog(spec, host, (index) => {
+            if (settled)
+                return;
+            settled = true;
+            handle?.hide();
+            resolve(index);
+        });
+        handle = host.showOverlay(new Box(dialog, {
+            title: spec.title,
+            theme: host.theme,
+            ...(spec.borderColor !== undefined ? { borderColor: spec.borderColor } : {}),
+        }), { anchor: "bottom" });
+    });
+}
+/** Bypass 确认框的内容（缺省选中「取消」，边框 warning）。 */
+export function bypassChoiceSpec(theme) {
+    return {
+        title: BYPASS_CONFIRM_TITLE,
+        body: BYPASS_RISK_LINES.map((line, i) => (i === 0 ? theme.fg("warning", line) : line)),
+        options: BYPASS_CHOICES,
+        selected: BYPASS_DEFAULT_CHOICE,
+        borderColor: "warning",
+    };
+}
+/** 进入 Bypass 前问一次：选「进入 Bypass」返回 true，取消 / 选「取消」返回 false。 */
+export async function confirmBypass(host) {
+    return (await openChoice(host, bypassChoiceSpec(host.theme))) === 0;
+}

package/dist/modes/interactive/interactive-mode.js

@@ -28,12 +28,14 @@ import { startupInfo, startupScreenLevel, tildePath } from "../../cli/startup-sc
 import { KEYBINDINGS_FILE } from "../../config/paths.js";
 import { AmaError, isAmaError } from "../../errors.js";
 import { Container, Editor, Keybindings, Loader, ProcessTerminal, Spacer, TUI, Text, createTheme, detectCapabilities, resolveAscii, resolveThemeName, loadKeybindingsFile, } from "../../tui.js";
+import { BYPASS_MODE, createBypassGate } from "../../permissions/bypass.js";
 import { onTerminationSignals } from "../shared.js";
 import { AgentUi } from "./agent-ui.js";
 import { ApprovalDialogBroker, approvalOutcomeText } from "./approval-dialog.js";
 import { mergingBroker } from "./approval-merge.js";
 import { ALL_COMMANDS, runInteractiveCommand } from "./commands.js";
 import { InteractiveCompletion } from "./completion.js";
+import { confirmBypass } from "./confirm-dialog.js";
 import { createKeyDispatch } from "./key-dispatch.js";
 import { MessageView, exitSummaryLines } from "./message-view.js";
 import { openPicker } from "./pickers.js";
@@ -270,6 +272,8 @@ export function runInteractiveMode(runtime, context, options = {}) {
         columns: () => terminal.columns,
         rows: () => terminal.rows,
     };
+    // 进入 Bypass 前确认一次；启动时已是 Bypass（命令行 / 配置指定）视为已确认
+    const confirmMode = createBypassGate(() => confirmBypass(pickerHost), session.state.permissionMode === BYPASS_MODE);
     const rewind = createRewindFlow({
         ...pickerHost,
         session: () => session,
@@ -290,6 +294,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
             return next;
         },
         pick: (spec) => openPicker(pickerHost, spec),
+        confirmMode,
         rewind: () => rewind.open(),
         setDraft,
         notice,
@@ -350,6 +355,7 @@ export function runInteractiveMode(runtime, context, options = {}) {
         onExpandToggle: (expanded) => view.setThinkingExpanded(expanded),
         onStatusLineToggle: () => area.toggle(),
         onPasteImage: () => void agentUi.paste(),
+        confirmMode,
         submit: (text, via) => submit(text, via),
         runCommand: (line) => void runCommand(line),
         exit: (code) => exit(code),

package/dist/modes/interactive/key-dispatch.d.ts

@@ -11,6 +11,7 @@
  * 输入历史；运行中 Esc 仍为中断，中断后交给 `onInterrupted`（中断即撤回）。
  */
 import type { AgentSession } from "../../agent/types.js";
+import type { PermissionMode } from "../../permissions/types.js";
 import type { Editor, Keybindings } from "../../tui.js";
 import type { StatusBar } from "./status-bar.js";
 import type { ToolTracker } from "./tool-view.js";
@@ -31,6 +32,11 @@ export interface KeyDispatchDeps {
     onExpandToggle?(expanded: boolean): void;
     /** Ctrl+G：切换底部信息行，返回切换后的布局。 */
     onStatusLineToggle?(): "full" | "compact";
+    /**
+     * 循环到某模式前的确认（进入 Bypass 前弹确认框，permissions/bypass.ts）；返回 false 时跳过该模式，
+     * 落到循环里的下一个。没有时直接切换。
+     */
+    confirmMode?(mode: PermissionMode): boolean | Promise<boolean>;
     /** Ctrl+V：粘贴剪贴板图片（W5-U）。 */
     onPasteImage?(): void;
     submit(text: string, via: "followUp"): void;