@armadra/agent 0.5.0 → 0.5.1

package/dist/modes/interactive/key-dispatch.js

@@ -68,12 +68,21 @@ export function createKeyDispatch(deps) {
         const current = editor.getText();
         editor.setText(current.trim() === "" ? last : `${last}\n${current}`);
     };
-    const cyclePermission = () => {
-        const session = deps.session();
-        const next = nextCycleMode(session.state.permissionMode);
-        session.setPermissionMode(next);
+    const applyMode = (mode, skipped) => {
+        deps.session().setPermissionMode(mode);
         status.refresh();
-        deps.showHint(`权限模式：${permissionModeLabel(next)}`);
+        const label = `权限模式：${permissionModeLabel(mode)}`;
+        deps.showHint(skipped ? `未进入 Bypass · ${label}` : label);
+    };
+    const cyclePermission = () => {
+        const next = nextCycleMode(deps.session().state.permissionMode);
+        // 取消进入 Bypass：跳过它继续循环（回到起点 Manual），而不是停在原模式——否则不进 Bypass 就绕不回去
+        const settle = (ok) => ok ? applyMode(next, false) : applyMode(nextCycleMode(next), true);
+        const answer = deps.confirmMode?.(next) ?? true;
+        if (typeof answer === "boolean")
+            settle(answer);
+        else
+            void answer.then(settle);
     };
     return (data) => {
         if (deps.inactive())
@@ -122,7 +131,9 @@ export function createKeyDispatch(deps) {
             dequeue();
             return true;
         }
-        if (is("app.permission.cycle")) {
+        // 与补全共用的键（缺省 Tab）只在输入为空、补全未打开时切换模式；有输入时照常交给编辑器补全
+        if (is("app.permission.cycle") &&
+            (!is("tui.editor.complete") || (editor.isEmpty() && !editor.isCompletionOpen))) {
             cyclePermission();
             return true;
         }

package/dist/modes/interactive/line/line-mode.d.ts

@@ -6,6 +6,8 @@
  *   问句之前逐行打印执行前预览（`request.preview`，W3-B9a-2）。
  * - 否则（管道）：逐行读 stdin，每行依次执行（等上一条运行结束）；没有审批 UI，ask → deny。
  *   模型错误在运行结束时只打印一次（重试中只显示 ↻）；有运行最终失败时退出码 1。
+ * - raw 终端里 `/permission full-auto` 进入 Bypass 前文本确认（`确认进入 Bypass？[y/N]`，本次运行确认过
+ *   一次后不再问；启动时已是 Bypass 视为已确认）。
  * - 斜杠命令走 commands-core（与 B7 同一语义），`pick` 退化为列出候选；`/rewind` 列编号、
  *   `/rewind <n> …` 执行，回到的单行原消息放回编辑行。
  */

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

@@ -6,6 +6,8 @@
  *   问句之前逐行打印执行前预览（`request.preview`，W3-B9a-2）。
  * - 否则（管道）：逐行读 stdin，每行依次执行（等上一条运行结束）；没有审批 UI，ask → deny。
  *   模型错误在运行结束时只打印一次（重试中只显示 ↻）；有运行最终失败时退出码 1。
+ * - raw 终端里 `/permission full-auto` 进入 Bypass 前文本确认（`确认进入 Bypass？[y/N]`，本次运行确认过
+ *   一次后不再问；启动时已是 Bypass 视为已确认）。
  * - 斜杠命令走 commands-core（与 B7 同一语义），`pick` 退化为列出候选；`/rewind` 列编号、
  *   `/rewind <n> …` 执行，回到的单行原消息放回编辑行。
  */
@@ -13,6 +15,7 @@ import { promptImages, sessionModel } from "../../image-input.js";
 import { taskRegistryView } from "../../../agent/subagent-registry.js";
 import { currentSession, switchSession } from "../../../cli/compose-session.js";
 import { ExitCode } from "../../../cli/exit-codes.js";
+import { BYPASS_LINE_QUESTION, BYPASS_MODE, BYPASS_RISK_LINES, createBypassGate, } from "../../../permissions/bypass.js";
 import { previewDisplayLines } from "../../../permissions/preview.js";
 import { AMA_VERSION } from "../../../version.js";
 import { runSlashCommand } from "../../commands-core.js";
@@ -105,6 +108,12 @@ export async function runLineMode(runtime, context, options = {}) {
         const model = session.state.model;
         io.stdout(`ama ${AMA_VERSION} · ${model?.provider}/${model?.id} · /help 查看命令，Ctrl+D 退出\n`);
     }
+    // /permission full-auto：进入 Bypass 前文本确认一次（管道里没有这一步，命令本身就是显式选择）
+    commands.confirmPermissionMode = createBypassGate(() => {
+        ed.hide();
+        io.stdout(`\n${BYPASS_RISK_LINES.map((l) => `  ${l}\n`).join("")}`);
+        return ed.ask(BYPASS_LINE_QUESTION, "n").then((answer) => answer === "y");
+    }, session.state.permissionMode === BYPASS_MODE);
     runtime.approvals.setUiBroker({
         ask: (request, signal) => new Promise((resolve) => {
             if (signal.aborted)

package/dist/modes/interactive/startup-ui.js

@@ -43,6 +43,7 @@ function askSelect(r, prompt) {
             keybindings: r.keys,
             maxVisible: 10,
             filterable: prompt.filterable === true,
+            ...(prompt.numberKeys === true ? { numberKeys: true } : {}),
             onSelect: (item) => {
                 finish(item.label);
                 done(item);
@@ -57,7 +58,9 @@ function askSelect(r, prompt) {
         body.addChild(list);
         body.addChild(new Text(r.theme.fg("dim", prompt.filterable === true
             ? "输入过滤 · ↑↓ 选择 · Enter 确认 · Esc 取消"
-            : "↑↓ 选择 · Enter 确认 · Esc 取消")));
+            : prompt.numberKeys === true
+                ? `↑↓ 选择 · Enter 确认 · 1-${prompt.items.length} 直接选 · Esc 取消`
+                : "↑↓ 选择 · Enter 确认 · Esc 取消")));
         tui.start();
         tui.setFocus(list);
     });
@@ -221,6 +224,7 @@ export function createStartupUi(options = {}) {
                 lines: [cwd, ...shown],
                 items: TRUST_CHOICES.map(({ value, label }) => ({ value, label })),
                 selected: "once",
+                numberKeys: true,
             });
             const choice = TRUST_CHOICES.find((c) => c.value === picked?.value);
             return choice?.answer ?? { trusted: false, remember: false };

package/dist/permissions/bypass.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 进入 Bypass permissions（`full-auto`）前的确认（docs/permissions.md「进入 Bypass」）。
+ *
+ * - 交互界面里的切换（Tab / Shift+Tab 循环、`/permission` 选择器、`/permission full-auto` 命令）
+ *   进入 Bypass 前问一次；本次运行内确认过之后不再问；启动时已是 Bypass（命令行
+ *   `--permission-mode full-auto`、配置、profile）视为已确认——那是用户的显式选择。
+ * - 离开 Bypass、切到其它模式都不问。
+ * - 只管「要不要问」与记住确认；怎么问（对话框 / 行式 y/N）由各界面提供 `ask`。
+ */
+import type { PermissionMode } from "./types.js";
+export declare const BYPASS_MODE: PermissionMode;
+export declare const BYPASS_CONFIRM_TITLE = "\u8FDB\u5165 Bypass permissions\uFF1F";
+/** 确认框正文：Bypass 意味着什么（一两条关键风险）。 */
+export declare const BYPASS_RISK_LINES: readonly string[];
+/** 选项：缺省选中「取消」。 */
+export declare const BYPASS_CHOICES: readonly [{
+    readonly label: "进入 Bypass";
+    readonly keys: "y";
+}, {
+    readonly label: "取消";
+    readonly keys: "n Esc";
+}];
+export declare const BYPASS_DEFAULT_CHOICE = 1;
+/** 行式界面的问句（单键 y/N，缺省 N）。 */
+export declare const BYPASS_LINE_QUESTION = "\u786E\u8BA4\u8FDB\u5165 Bypass\uFF1F[y/N] ";
+/** 不用问时同步返回 true（切换立即生效）；要问时返回等用户回答的 Promise。 */
+export type BypassGate = (mode: PermissionMode) => boolean | Promise<boolean>;
+/**
+ * 返回「切到 `mode` 前要不要放行」的闸门：不是 Bypass 直接放行；Bypass 首次调用 `ask`，
+ * 确认后本闸门内不再问。`confirmed` 为 true 表示启动时已在 Bypass（视为已确认）。
+ */
+export declare function createBypassGate(ask: () => Promise<boolean>, confirmed?: boolean): BypassGate;

package/dist/permissions/bypass.js

@@ -0,0 +1,36 @@
+/**
+ * 进入 Bypass permissions（`full-auto`）前的确认（docs/permissions.md「进入 Bypass」）。
+ *
+ * - 交互界面里的切换（Tab / Shift+Tab 循环、`/permission` 选择器、`/permission full-auto` 命令）
+ *   进入 Bypass 前问一次；本次运行内确认过之后不再问；启动时已是 Bypass（命令行
+ *   `--permission-mode full-auto`、配置、profile）视为已确认——那是用户的显式选择。
+ * - 离开 Bypass、切到其它模式都不问。
+ * - 只管「要不要问」与记住确认；怎么问（对话框 / 行式 y/N）由各界面提供 `ask`。
+ */
+export const BYPASS_MODE = "full-auto";
+export const BYPASS_CONFIRM_TITLE = "进入 Bypass permissions？";
+/** 确认框正文：Bypass 意味着什么（一两条关键风险）。 */
+export const BYPASS_RISK_LINES = [
+    "所有工具调用都不再询问：写文件、执行命令、联网直接放行",
+    "只有危险命令仍会询问，deny 规则照常生效；只建议在一次性沙箱、容器里用",
+];
+/** 选项：缺省选中「取消」。 */
+export const BYPASS_CHOICES = [
+    { label: "进入 Bypass", keys: "y" },
+    { label: "取消", keys: "n Esc" },
+];
+export const BYPASS_DEFAULT_CHOICE = 1;
+/** 行式界面的问句（单键 y/N，缺省 N）。 */
+export const BYPASS_LINE_QUESTION = "确认进入 Bypass？[y/N] ";
+/**
+ * 返回「切到 `mode` 前要不要放行」的闸门：不是 Bypass 直接放行；Bypass 首次调用 `ask`，
+ * 确认后本闸门内不再问。`confirmed` 为 true 表示启动时已在 Bypass（视为已确认）。
+ */
+export function createBypassGate(ask, confirmed = false) {
+    let ok = confirmed;
+    return (mode) => {
+        if (mode !== BYPASS_MODE || ok)
+            return true;
+        return ask().then((answer) => (ok = answer));
+    };
+}

package/dist/tui/keybindings.d.ts

@@ -36,7 +36,7 @@ export declare const DEFAULT_KEYBINDINGS: {
     readonly "app.exit": readonly ["ctrl+d"];
     readonly "app.message.followUp": readonly ["alt+enter"];
     readonly "app.message.dequeue": readonly ["alt+up"];
-    readonly "app.permission.cycle": readonly ["shift+tab"];
+    readonly "app.permission.cycle": readonly ["shift+tab", "tab"];
     readonly "app.tools.expand": readonly ["ctrl+o"];
     readonly "app.model.select": readonly ["ctrl+l"];
     readonly "app.thinking.select": readonly ["ctrl+t"];

package/dist/tui/keybindings.js

@@ -38,7 +38,7 @@ export const DEFAULT_KEYBINDINGS = {
     "app.exit": ["ctrl+d"],
     "app.message.followUp": ["alt+enter"],
     "app.message.dequeue": ["alt+up"],
-    "app.permission.cycle": ["shift+tab"],
+    "app.permission.cycle": ["shift+tab", "tab"],
     "app.tools.expand": ["ctrl+o"],
     "app.model.select": ["ctrl+l"],
     "app.thinking.select": ["ctrl+t"],

package/docs/permissions.md

@@ -30,6 +30,7 @@
 - 状态栏显示显示名：`mode:Auto`；`Bypass permissions` 标黄。
 - `/permission` 不带参数打开选择器：标题 `Mode`，每项「显示名 + 一行说明」，右侧是数字快捷键 1–6，当前模式打勾，配置里的缺省模式标 `Default`，Auto 标 `Recommended`。line 模式 `/permission` 打印同样的列表。
 - `Shift+Tab` 循环：Manual → Accept edits → Plan → Auto → Bypass permissions → Manual。`Allowlist only` 不在循环里，只能显式选。
+- **进入 Bypass**：交互界面里切到 Bypass（Tab / Shift+Tab 循环、`/permission` 选择器、`/permission full-auto`）先弹确认框，缺省选中「取消」；循环时取消则跳过 Bypass 回到 Manual，选择器与命令取消则保持原模式。本次运行确认过一次后不再问。命令行 `--permission-mode full-auto`、用户级配置与 profile 指定的不弹（那是显式选择）；line 模式问 `确认进入 Bypass？[y/N]`；管道输入、RPC `set_permission_mode`、ACP `session/set_mode` 由调用方负责，不弹。详见 [tui.md](tui.md)「进入 Bypass」。
 
 ### 审批对话框的来源标注
 

package/docs/tui.md

@@ -111,23 +111,23 @@ Accept edits     claude-opus-5-5 medium | Ctx 3.0% | proj ⎇ main 5ae9e54 (+12,
 
 ## 按键
 
-| 按键                 | 作用                                                                  |
-| -------------------- | --------------------------------------------------------------------- |
-| Enter                | 发送；运行中 = steer（插到当前轮）                                    |
-| Alt+Enter            | 运行中排到本轮之后（followUp）；空闲时等同 Enter                      |
-| Shift+Enter / Ctrl+J | 换行                                                                  |
-| Esc                  | 中断：排队的消息回填到输入框，然后停止当前运行；补全打开时先关补全    |
-| Esc Esc（空闲）      | 输入框为空：打开回滚列表（同 `/rewind`）；有字：清空并存进输入历史    |
-| Alt+↑                | 取回最后一条排队消息                                                  |
-| Shift+Tab            | 循环权限模式 Manual → Accept edits → Plan → Auto → Bypass permissions |
-| Ctrl+O               | 展开 / 折叠工具输出与思考块                                           |
-| Ctrl+L / Ctrl+T      | 选择模型 / 思考级别                                                   |
-| Ctrl+G               | 底部信息行 两行（full）↔ 一行（compact），只影响本会话                |
-| Ctrl+V               | 粘贴剪贴板里的图片：存进数据目录，光标处插入 `@<路径>`（同 `/paste`） |
-| Ctrl+C               | 清空输入；输入为空时 1.5 秒内再按一次退出（退出码 130）               |
-| Ctrl+D               | 输入为空时退出                                                        |
-| Tab                  | 补全                                                                  |
-| ↑ / ↓                | 单行时浏览历史（`<数据目录>/history`，500 条）                        |
+| 按键                 | 作用                                                                                                                                                             |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Enter                | 发送；运行中 = steer（插到当前轮）                                                                                                                               |
+| Alt+Enter            | 运行中排到本轮之后（followUp）；空闲时等同 Enter                                                                                                                 |
+| Shift+Enter / Ctrl+J | 换行                                                                                                                                                             |
+| Esc                  | 中断：排队的消息回填到输入框，然后停止当前运行；补全打开时先关补全                                                                                               |
+| Esc Esc（空闲）      | 输入框为空：打开回滚列表（同 `/rewind`）；有字：清空并存进输入历史                                                                                               |
+| Alt+↑                | 取回最后一条排队消息                                                                                                                                             |
+| Shift+Tab / Tab      | 循环权限模式 Manual → Accept edits → Plan → Auto → Bypass permissions（Tab 只在输入为空、补全未打开时，否则仍是补全；进入 Bypass 前确认，见下文「进入 Bypass」） |
+| Ctrl+O               | 展开 / 折叠工具输出与思考块                                                                                                                                      |
+| Ctrl+L / Ctrl+T      | 选择模型 / 思考级别                                                                                                                                              |
+| Ctrl+G               | 底部信息行 两行（full）↔ 一行（compact），只影响本会话                                                                                                           |
+| Ctrl+V               | 粘贴剪贴板里的图片：存进数据目录，光标处插入 `@<路径>`（同 `/paste`）                                                                                            |
+| Ctrl+C               | 清空输入；输入为空时 1.5 秒内再按一次退出（退出码 130）                                                                                                          |
+| Ctrl+D               | 输入为空时退出                                                                                                                                                   |
+| Tab                  | 补全                                                                                                                                                             |
+| ↑ / ↓                | 单行时浏览历史（`<数据目录>/history`，500 条）                                                                                                                   |
 
 按键可在 `~/.config/ama/keybindings.json` 覆盖，键是动作 id（`app.interrupt`、`app.rewind`、`app.message.followUp`、`app.statusLine.toggle`、`app.paste.image`、`tui.editor.newLine` ……），值是按键或按键数组，空数组表示禁用。`app.rewind` 是空闲时双击的那个键（缺省 Esc，两次间隔 ≤ 800 ms）。
 
@@ -189,6 +189,45 @@ Accept edits     claude-opus-5-5 medium | Ctx 3.0% | proj ⎇ main 5ae9e54 (+12,
 - `/tasks`：子 Agent 任务列表；`/agents`：可用的子 Agent 类型（见下文「子 Agent」）。
 - `/paste`：同 `Ctrl+V`。
 
+## 进入 Bypass
+
+切到 Bypass permissions（`full-auto`）之前底部弹一个确认框，样式同审批对话框（边框黄）：
+
+```
+╭─ 进入 Bypass permissions？ ──────────────────────────────────────────────────╮
+│ 所有工具调用都不再询问：写文件、执行命令、联网直接放行                       │
+│ 只有危险命令仍会询问，deny 规则照常生效；只建议在一次性沙箱、容器里用        │
+│                                                                              │
+│   1. 进入 Bypass                                                       y     │
+│ › 2. 取消                                                              n Esc │
+│                                                                              │
+│ ↑↓ 选择 · Enter 确认 · 1-2 直接选 · Esc 取消                                 │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+- 触发：Tab / Shift+Tab 循环到 Bypass、`/permission` 选择器选 Bypass、`/permission full-auto`。缺省选中「取消」：↑↓ 移动、Enter 确认、`1` / `2` 或 `y` / `n` 直选，Esc / Ctrl+C 取消（Ctrl+C 在这里不算退出的第一下）。
+- 取消：循环时**跳过 Bypass 回到循环起点 Manual**（底部提示「未进入 Bypass · 权限模式：Manual」），这样不进 Bypass 也能一路 Tab 绕回去，且落点总比 Auto 更严；选择器与命令取消时保持原模式（消息区「已取消，权限模式仍为 …」）。
+- 本次运行确认过一次后，再切到 Bypass 不再问；启动时已是 Bypass（`--permission-mode full-auto`、配置、profile）视为已确认，不弹。
+- 宽 < 56 列时去掉空行、按键提示缩短；ASCII 模式边框 `+ - |`、选中符 `>`、箭头 `^v`。帧黄金 `test/fixtures/tui/bypass-confirm-*.txt`。
+- line 模式（`--no-tui`）：`/permission full-auto` 先打印上面两行说明，再问 `确认进入 Bypass？[y/N]`（单键，Enter = N）；管道输入没有这一步。
+
+## 选择与确认的按键
+
+所有让人做选择的地方都支持 ↑↓ 移动 + Enter 确认，原有快捷键保留：
+
+| 位置                                    | 按键                                                     |
+| --------------------------------------- | -------------------------------------------------------- |
+| 审批对话框（含外部 Agent 首次运行确认） | ↑↓ Enter · 1–3 · y / a / n · Esc 拒绝 · v 完整输入       |
+| 计划审批框（主选项、执行模式）          | ↑↓ Enter · 1–4 / 1–3 · e 编辑计划 · Esc 留在 Plan / 返回 |
+| 回滚确认面板、冲突覆盖二次确认          | ↑↓ Enter · 数字直接执行 · Esc 取消 / 返回                |
+| 进入 Bypass 确认                        | ↑↓ Enter · 1–2 · y / n · Esc 取消                        |
+| 权限模式、思考级别选择器                | ↑↓ Enter · 数字直接选 · Esc 取消                         |
+| 模型、会话、树、任务选择器              | ↑↓ Enter · 输入过滤 · Esc 取消（可过滤的列表不用数字键） |
+| 启动时信任目录                          | ↑↓ Enter · 1–4 直接选 · Esc / Ctrl+C = 本次不信任        |
+| CLI 子命令计费 / 写入确认（TTY）        | ↑↓ Enter · 1–2 · y / n · Esc / Ctrl+C 取消（缺省取消）   |
+
+CLI 子命令（`ama providers add` / `refresh` 的写入与 `--probe` 计费确认、`ama models cache-probe`）在 TTY 下用同一套方向键选择，结束后收成一行「? 继续？ 继续」并恢复终端；stdin 不是 TTY（管道、CI）时仍是文本 `继续？[y/N]`（这些命令非交互时本就要求 `--yes`），`--yes` 跳过确认。
+
 ## 补全
 
 - 首行行首输入 `/`：命令、提示模板（`/<名字>`）、Skill（`/skill:<名字>`）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@armadra/agent",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "可独立使用、可嵌入 Armadra 的编码 / 协调 Agent",
   "type": "module",
   "keywords": [