@armadra/agent 0.5.1 → 0.6.1

package/dist/i18n/catalog.js

@@ -0,0 +1,72 @@
+/**
+ * 全部领域的汇总（docs/wave6-plan.md §5.1、D23）。[W6-C0] 一次登记全部领域，之后无人再改本文件：
+ * 各批次只改自己的 `messages/<领域>.ts`。
+ *
+ * 领域 → 所有者：cli / subcommands（I1）；interactive / approval / plan / rewind / panels / permissions（I2）；
+ * report / print / drivers / session / errors（I3）；config（I4）；agents（A）；trace（T1 / T2）；
+ * memory（M）；auth（O）；settings（S）。
+ */
+import * as cli from "./messages/cli.js";
+import * as subcommands from "./messages/subcommands.js";
+import * as interactive from "./messages/interactive.js";
+import * as approval from "./messages/approval.js";
+import * as plan from "./messages/plan.js";
+import * as rewind from "./messages/rewind.js";
+import * as panels from "./messages/panels.js";
+import * as permissions from "./messages/permissions.js";
+import * as report from "./messages/report.js";
+import * as print from "./messages/print.js";
+import * as config from "./messages/config.js";
+import * as drivers from "./messages/drivers.js";
+import * as session from "./messages/session.js";
+import * as errors from "./messages/errors.js";
+import * as agents from "./messages/agents.js";
+import * as trace from "./messages/trace.js";
+import * as memory from "./messages/memory.js";
+import * as auth from "./messages/auth.js";
+import * as settings from "./messages/settings.js";
+const en = {
+    cli: cli.en,
+    subcommands: subcommands.en,
+    interactive: interactive.en,
+    approval: approval.en,
+    plan: plan.en,
+    rewind: rewind.en,
+    panels: panels.en,
+    permissions: permissions.en,
+    report: report.en,
+    print: print.en,
+    config: config.en,
+    drivers: drivers.en,
+    session: session.en,
+    errors: errors.en,
+    agents: agents.en,
+    trace: trace.en,
+    memory: memory.en,
+    auth: auth.en,
+    settings: settings.en,
+};
+const zh = {
+    cli: cli.zh,
+    subcommands: subcommands.zh,
+    interactive: interactive.zh,
+    approval: approval.zh,
+    plan: plan.zh,
+    rewind: rewind.zh,
+    panels: panels.zh,
+    permissions: permissions.zh,
+    report: report.zh,
+    print: print.zh,
+    config: config.zh,
+    drivers: drivers.zh,
+    session: session.zh,
+    errors: errors.zh,
+    agents: agents.zh,
+    trace: trace.zh,
+    memory: memory.zh,
+    auth: auth.zh,
+    settings: settings.zh,
+};
+export const CATALOGS = { en, zh };
+/** 领域名（一级命名空间）。 */
+export const MESSAGE_DOMAINS = Object.keys(en);

package/dist/i18n/format.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 与语言无关的格式化小工具（docs/wave6-plan.md §5.1；R8 §2.4）。[W6-C0]
+ *
+ * - `plural`：只有英文需要复数；中文文案直接写「N 个文件」，不调它。
+ * - `formatDuration`：紧凑时长，两种语言共用（`45s`、`2m 10s`、`1h24m`）；长句里的「7 分钟」走消息目录。
+ *   现有 4 处各自实现（`status-bar.ts`、`session-report.ts`、`tool-summary.ts`、`print-mode.ts`）由各迁移批次
+ *   改用这里的变体，前提是 zh 黄金字节不变（`short` / `precise` 两个变体就是为此保留的）。
+ * - 数字（`formatTokens` / `formatUsd` / `formatPercent`）与日期（ISO）保持原样，不本地化。
+ */
+/**
+ * 英文复数：`plural(1, "file")` → `1 file`，`plural(3, "file")` → `3 files`；
+ * 不规则词给第三参数：`plural(2, "entry", "entries")`。
+ */
+export declare function plural(n: number, word: string, pluralForm?: string): string;
+/**
+ * 时长的紧凑写法。
+ * - `compact`（缺省）：`45s`、`2m 10s`、`2m`、`1h24m`、`3h`；
+ * - `short`：状态行用（与 `status-bar.ts` 逐字节相同），`45s`、`2m`、`1h0m`、`1h24m`；
+ * - `precise`：工具耗时用，`2.1s`（< 10 s 一位小数）、`45s`、`1m05s`。
+ */
+export declare function formatDuration(ms: number, style?: "compact" | "short" | "precise"): string;

package/dist/i18n/format.js

@@ -0,0 +1,58 @@
+/**
+ * 与语言无关的格式化小工具（docs/wave6-plan.md §5.1；R8 §2.4）。[W6-C0]
+ *
+ * - `plural`：只有英文需要复数；中文文案直接写「N 个文件」，不调它。
+ * - `formatDuration`：紧凑时长，两种语言共用（`45s`、`2m 10s`、`1h24m`）；长句里的「7 分钟」走消息目录。
+ *   现有 4 处各自实现（`status-bar.ts`、`session-report.ts`、`tool-summary.ts`、`print-mode.ts`）由各迁移批次
+ *   改用这里的变体，前提是 zh 黄金字节不变（`short` / `precise` 两个变体就是为此保留的）。
+ * - 数字（`formatTokens` / `formatUsd` / `formatPercent`）与日期（ISO）保持原样，不本地化。
+ */
+let enRules;
+function isOne(n) {
+    try {
+        enRules ??= new Intl.PluralRules("en");
+        return enRules.select(n) === "one";
+    }
+    catch {
+        // small-icu / 无 Intl 的环境保底
+        return n === 1;
+    }
+}
+/**
+ * 英文复数：`plural(1, "file")` → `1 file`，`plural(3, "file")` → `3 files`；
+ * 不规则词给第三参数：`plural(2, "entry", "entries")`。
+ */
+export function plural(n, word, pluralForm) {
+    return `${n} ${isOne(n) ? word : (pluralForm ?? `${word}s`)}`;
+}
+/**
+ * 时长的紧凑写法。
+ * - `compact`（缺省）：`45s`、`2m 10s`、`2m`、`1h24m`、`3h`；
+ * - `short`：状态行用（与 `status-bar.ts` 逐字节相同），`45s`、`2m`、`1h0m`、`1h24m`；
+ * - `precise`：工具耗时用，`2.1s`（< 10 s 一位小数）、`45s`、`1m05s`。
+ */
+export function formatDuration(ms, style = "compact") {
+    const safe = Number.isFinite(ms) ? Math.max(0, ms) : 0;
+    if (style === "precise") {
+        const s = safe / 1000;
+        if (s < 10)
+            return `${s.toFixed(1)}s`;
+        if (s < 60)
+            return `${Math.floor(s)}s`;
+        const total = Math.floor(s);
+        return `${Math.floor(total / 60)}m${String(total % 60).padStart(2, "0")}s`;
+    }
+    const seconds = Math.floor(safe / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60) {
+        const rest = seconds % 60;
+        return style === "short" || rest === 0 ? `${minutes}m` : `${minutes}m ${rest}s`;
+    }
+    const hours = Math.floor(minutes / 60);
+    const restMinutes = minutes % 60;
+    if (style === "short")
+        return `${hours}h${restMinutes}m`;
+    return restMinutes === 0 ? `${hours}h` : `${hours}h${restMinutes}m`;
+}

package/dist/i18n/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 界面语言（docs/wave6-plan.md §5.1、§5.2、D18；docs/i18n.md）。[W6-C0]
+ *
+ * - 语言优先级：`AMA_LANG` > `--lang` > `ui.language`（`auto` 视为未设）> `LC_ALL` / `LC_MESSAGES` /
+ *   `LANG` 第一个非空值；`/^zh/i` → zh，其余（含 `C` / `POSIX` / 空 / 判断不出）→ en。
+ * - 进程启动时定一次（`cli/main.ts` 解析参数与配置后、任何渲染前 `setLocale()`；SDK `createRuntime({ language })`
+ *   与 profile `language` 同理），不做运行中切换。未调用 `setLocale` 时首次取用按环境变量推断。
+ * - 取用：`const m = msg().print; io.stderr(m.limitTurns(limit))`——嵌套属性访问，不用字符串键；
+ *   **不要在模块顶层求值**（顶层 `const x = msg()…` 会按 import 时的语言定死，`scripts/check-i18n.mjs` 会拦）。
+ * - **给模型的文本固定英文、不走这里**：模型侧模块禁止 import `src/i18n`（`src/i18n/guard.test.ts`）。
+ */
+import { type Catalog } from "./catalog.js";
+export type { Catalog } from "./catalog.js";
+export { MESSAGE_DOMAINS } from "./catalog.js";
+export type { Messages, MessageLeaf } from "./types.js";
+export { formatDuration, plural } from "./format.js";
+export type Locale = "zh" | "en";
+export declare const LOCALES: readonly Locale[];
+/** `ui.language` 的取值。 */
+export type LanguageSetting = "auto" | Locale;
+export declare const LANGUAGE_SETTINGS: readonly LanguageSetting[];
+/** 语言从哪里来（`ama doctor` 显示「界面语言：zh（来源 LANG=zh_CN.UTF-8）」）。 */
+export type LocaleSource = {
+    kind: "env";
+    name: "AMA_LANG";
+    value: string;
+} | {
+    kind: "cli";
+} | {
+    kind: "config";
+} | {
+    kind: "locale";
+    name: "LC_ALL" | "LC_MESSAGES" | "LANG";
+    value: string;
+} | {
+    kind: "default";
+};
+/** 把 `zh` / `zh_CN.UTF-8` / `en-US` 之类的写法归一；不是 zh / en 的返回 undefined。 */
+export declare function parseLocale(value: string | undefined): Locale | undefined;
+/** 解析语言并给出来源。 */
+export declare function resolveLocaleWithSource(env: NodeJS.ProcessEnv, config?: {
+    language?: LanguageSetting | undefined;
+}, cli?: Locale): {
+    locale: Locale;
+    source: LocaleSource;
+};
+/** 解析语言（见文件头的优先级）。 */
+export declare function resolveLocale(env: NodeJS.ProcessEnv, config?: {
+    language?: LanguageSetting | undefined;
+}, cli?: Locale): Locale;
+/** 定下本进程的界面语言（启动时调用一次；测试 setup 钉 zh）。 */
+export declare function setLocale(locale: Locale): void;
+/** 当前界面语言；未 `setLocale` 时按环境变量推断（不缓存，便于 SDK 嵌入方之后再定）。 */
+export declare function getLocale(): Locale;
+/** 当前语言的消息目录。 */
+export declare function msg(): Catalog;
+/** 指定语言的消息目录（导出产物按导出时语言渲染等场景）。 */
+export declare function messagesFor(locale: Locale): Catalog;

package/dist/i18n/index.js

@@ -0,0 +1,72 @@
+/**
+ * 界面语言（docs/wave6-plan.md §5.1、§5.2、D18；docs/i18n.md）。[W6-C0]
+ *
+ * - 语言优先级：`AMA_LANG` > `--lang` > `ui.language`（`auto` 视为未设）> `LC_ALL` / `LC_MESSAGES` /
+ *   `LANG` 第一个非空值；`/^zh/i` → zh，其余（含 `C` / `POSIX` / 空 / 判断不出）→ en。
+ * - 进程启动时定一次（`cli/main.ts` 解析参数与配置后、任何渲染前 `setLocale()`；SDK `createRuntime({ language })`
+ *   与 profile `language` 同理），不做运行中切换。未调用 `setLocale` 时首次取用按环境变量推断。
+ * - 取用：`const m = msg().print; io.stderr(m.limitTurns(limit))`——嵌套属性访问，不用字符串键；
+ *   **不要在模块顶层求值**（顶层 `const x = msg()…` 会按 import 时的语言定死，`scripts/check-i18n.mjs` 会拦）。
+ * - **给模型的文本固定英文、不走这里**：模型侧模块禁止 import `src/i18n`（`src/i18n/guard.test.ts`）。
+ */
+import { CATALOGS } from "./catalog.js";
+export { MESSAGE_DOMAINS } from "./catalog.js";
+export { formatDuration, plural } from "./format.js";
+export const LOCALES = ["zh", "en"];
+export const LANGUAGE_SETTINGS = ["auto", "zh", "en"];
+/** 把 `zh` / `zh_CN.UTF-8` / `en-US` 之类的写法归一；不是 zh / en 的返回 undefined。 */
+export function parseLocale(value) {
+    if (value === undefined)
+        return undefined;
+    const v = value.trim();
+    if (/^zh/i.test(v))
+        return "zh";
+    if (/^en/i.test(v))
+        return "en";
+    return undefined;
+}
+const LOCALE_VARS = ["LC_ALL", "LC_MESSAGES", "LANG"];
+/** 解析语言并给出来源。 */
+export function resolveLocaleWithSource(env, config, cli) {
+    const ama = env["AMA_LANG"];
+    const fromEnv = parseLocale(ama);
+    if (fromEnv !== undefined && ama !== undefined)
+        return { locale: fromEnv, source: { kind: "env", name: "AMA_LANG", value: ama } };
+    if (cli !== undefined)
+        return { locale: cli, source: { kind: "cli" } };
+    const configured = config?.language;
+    if (configured === "zh" || configured === "en")
+        return { locale: configured, source: { kind: "config" } };
+    for (const name of LOCALE_VARS) {
+        const value = env[name];
+        if (value === undefined || value === "")
+            continue;
+        // 第一个非空值说了算：zh* → zh，其余（en_US、C、POSIX…）→ en
+        return {
+            locale: parseLocale(value) === "zh" ? "zh" : "en",
+            source: { kind: "locale", name, value },
+        };
+    }
+    return { locale: "en", source: { kind: "default" } };
+}
+/** 解析语言（见文件头的优先级）。 */
+export function resolveLocale(env, config, cli) {
+    return resolveLocaleWithSource(env, config, cli).locale;
+}
+let current;
+/** 定下本进程的界面语言（启动时调用一次；测试 setup 钉 zh）。 */
+export function setLocale(locale) {
+    current = locale;
+}
+/** 当前界面语言；未 `setLocale` 时按环境变量推断（不缓存，便于 SDK 嵌入方之后再定）。 */
+export function getLocale() {
+    return current ?? resolveLocale(process.env);
+}
+/** 当前语言的消息目录。 */
+export function msg() {
+    return CATALOGS[getLocale()];
+}
+/** 指定语言的消息目录（导出产物按导出时语言渲染等场景）。 */
+export function messagesFor(locale) {
+    return CATALOGS[locale];
+}

package/dist/i18n/messages/agents.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 消息目录：agents（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-A]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ *
+ * W6-A：Agent 栏（状态、轮数、溢出行、按键提示）与子 Agent 视图（标题、占位、发送结果、外部 Agent 的说明）。
+ */
+export declare const en: {
+    status: {
+        queued: string;
+        running: string;
+        approval: string;
+        completed: string;
+        failed: string;
+        aborted: string;
+        max_turns: string;
+        interrupted: string;
+    };
+    turns: (n: number) => string;
+    bar: {
+        more: (n: number) => string;
+        keys: (up: string, down: string) => string;
+        empty: string;
+    };
+    view: {
+        back: string;
+        stopHint: (taskId: string) => string;
+        paused: string;
+        placeholder: (taskId: string) => string;
+        steered: (taskId: string) => string;
+        queued: (taskId: string) => string;
+        resumed: (taskId: string) => string;
+        sendFailed: (message: string) => string;
+        stopped: (taskId: string) => string;
+        commandsHere: string;
+        removed: (taskId: string) => string;
+        unknown: (taskId: string) => string;
+        turn: (n: number) => string;
+        waiting: string;
+        noTranscript: string;
+        loadFailed: (message: string) => string;
+        externalGone: (runner: string, sessionId: string) => string;
+        externalNoSession: (runner: string) => string;
+    };
+};
+export declare const zh: {
+    status: {
+        queued: string;
+        running: string;
+        approval: string;
+        completed: string;
+        failed: string;
+        aborted: string;
+        max_turns: string;
+        interrupted: string;
+    };
+    turns: (n: number) => string;
+    bar: {
+        more: (n: number) => string;
+        keys: (up: string, down: string) => string;
+        empty: string;
+    };
+    view: {
+        back: string;
+        stopHint: (taskId: string) => string;
+        paused: string;
+        placeholder: (taskId: string) => string;
+        steered: (taskId: string) => string;
+        queued: (taskId: string) => string;
+        resumed: (taskId: string) => string;
+        sendFailed: (message: string) => string;
+        stopped: (taskId: string) => string;
+        commandsHere: string;
+        removed: (taskId: string) => string;
+        unknown: (taskId: string) => string;
+        turn: (n: number) => string;
+        waiting: string;
+        noTranscript: string;
+        loadFailed: (message: string) => string;
+        externalGone: (runner: string, sessionId: string) => string;
+        externalNoSession: (runner: string) => string;
+    };
+};

package/dist/i18n/messages/agents.js

@@ -0,0 +1,85 @@
+/**
+ * 消息目录：agents（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-A]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ *
+ * W6-A：Agent 栏（状态、轮数、溢出行、按键提示）与子 Agent 视图（标题、占位、发送结果、外部 Agent 的说明）。
+ */
+import { plural } from "../format.js";
+export const en = {
+    status: {
+        queued: "queued",
+        running: "running",
+        approval: "needs approval",
+        completed: "done",
+        failed: "failed",
+        aborted: "stopped",
+        max_turns: "out of turns",
+        interrupted: "interrupted",
+    },
+    turns: (n) => plural(n, "turn"),
+    bar: {
+        more: (n) => `${n} more`,
+        keys: (up, down) => `${up}${down} select · Enter open · Esc back`,
+        empty: "No sub-agent tasks yet",
+    },
+    view: {
+        back: "Esc back",
+        stopHint: (taskId) => `/tasks stop ${taskId} to stop`,
+        paused: "paused · End to follow",
+        placeholder: (taskId) => `Message ${taskId}`,
+        steered: (taskId) => `Sent to ${taskId}; delivered when its current turn ends`,
+        queued: (taskId) => `Queued for ${taskId}; sent when its current run ends`,
+        resumed: (taskId) => `Sent to ${taskId}; it continues in the background`,
+        sendFailed: (message) => `Could not send: ${message}`,
+        stopped: (taskId) => `Stopped ${taskId}`,
+        commandsHere: "Only /tasks stop works here; press Esc to go back for other commands",
+        removed: (taskId) => `Task ${taskId} is gone`,
+        unknown: (taskId) => `No task ${taskId}`,
+        turn: (n) => `turn ${n}`,
+        waiting: "Waiting for output…",
+        noTranscript: "No transcript for this task",
+        loadFailed: (message) => `Could not read the transcript: ${message}`,
+        externalGone: (runner, sessionId) => `Live output is kept only in memory. Run ${runner} and resume ${sessionId} to see the full transcript.`,
+        externalNoSession: (runner) => `Live output is kept only in memory; ${runner} did not report a session to resume.`,
+    },
+};
+export const zh = {
+    status: {
+        queued: "排队",
+        running: "运行中",
+        approval: "等待审批",
+        completed: "完成",
+        failed: "失败",
+        aborted: "已停止",
+        max_turns: "轮数耗尽",
+        interrupted: "已中断",
+    },
+    turns: (n) => `${n} 轮`,
+    bar: {
+        more: (n) => `另 ${n} 个`,
+        keys: (up, down) => `${up}${down} 选择 · Enter 打开 · Esc 返回`,
+        empty: "还没有子 Agent 任务",
+    },
+    view: {
+        back: "Esc 返回",
+        stopHint: (taskId) => `/tasks stop ${taskId} 停止`,
+        paused: "已暂停跟随 · End 继续",
+        placeholder: (taskId) => `发给 ${taskId}`,
+        steered: (taskId) => `已发给 ${taskId}，本轮结束后送达`,
+        queued: (taskId) => `已排队，${taskId} 本次运行结束后发送`,
+        resumed: (taskId) => `已发给 ${taskId}，在后台继续`,
+        sendFailed: (message) => `发送失败：${message}`,
+        stopped: (taskId) => `已停止 ${taskId}`,
+        commandsHere: "这里只能用 /tasks stop；其它命令按 Esc 返回后输入",
+        removed: (taskId) => `任务 ${taskId} 已不存在`,
+        unknown: (taskId) => `没有任务 ${taskId}`,
+        turn: (n) => `第 ${n} 轮`,
+        waiting: "等待输出…",
+        noTranscript: "这个任务没有对话记录",
+        loadFailed: (message) => `读取对话记录失败：${message}`,
+        externalGone: (runner, sessionId) => `实时输出只在内存里。用 ${runner} resume ${sessionId} 查看全文。`,
+        externalNoSession: (runner) => `实时输出只在内存里；${runner} 没有报告可续接的会话。`,
+    },
+};

package/dist/i18n/messages/approval.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 消息目录：approval（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I2]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ *
+ * 审批对话框（`modes/interactive/approval-dialog.ts`）、通用确认框（`confirm-dialog.ts`）与行式审批。
+ */
+export declare const en: {
+    /** 外部 Agent 来源标注：`[claude · session abc12345]`。 */
+    originLabel: (agent: string, sessionId: string) => string;
+    /** 标题里的原因。 */
+    title: {
+        firstRun: string;
+        dangerous: string;
+        hook: string;
+        confirm: string;
+    };
+    /** 首行工具名右侧的标签。 */
+    tag: {
+        dangerous: string;
+        hook: string;
+        firstRun: string;
+        confirm: string;
+    };
+    morePaths: (n: number) => string;
+    moreLines: (n: number) => string;
+    moreLinesView: (n: number) => string;
+    moreEdits: (n: number) => string;
+    firstRunMode: (mode: string) => string;
+    writeLines: (n: number) => string;
+    editCount: (n: number) => string;
+    externalRunner: (agent: string, runner: string) => string;
+    originAsks: (agent: string) => string;
+    firstRunLogin: string;
+    hookReason: (reason: string | undefined) => string;
+    dangerousWarn: string;
+    autoReason: (layer: string, reason: string) => string;
+    modeNeedsConfirm: (mode: string) => string;
+    option: {
+        allow: string;
+        allowSession: string;
+        deny: string;
+    };
+    hint: (arrows: string) => string;
+    hintCompact: (arrows: string) => string;
+    /** 消息区里的结果说明。 */
+    outcome: {
+        allow: (what: string) => string;
+        allowSession: (what: string) => string;
+        deny: (what: string) => string;
+        cancelled: (what: string) => string;
+    };
+    /** 通用确认框的按键行。 */
+    choiceHint: (arrows: string, n: number) => string;
+};
+export declare const zh: {
+    originLabel: (agent: string, sessionId: string) => string;
+    title: {
+        firstRun: string;
+        dangerous: string;
+        hook: string;
+        confirm: string;
+    };
+    tag: {
+        dangerous: string;
+        hook: string;
+        firstRun: string;
+        confirm: string;
+    };
+    morePaths: (n: number) => string;
+    moreLines: (n: number) => string;
+    moreLinesView: (n: number) => string;
+    moreEdits: (n: number) => string;
+    firstRunMode: (mode: string) => string;
+    writeLines: (n: number) => string;
+    editCount: (n: number) => string;
+    externalRunner: (agent: string, runner: string) => string;
+    originAsks: (agent: string) => string;
+    firstRunLogin: string;
+    hookReason: (reason: string | undefined) => string;
+    dangerousWarn: string;
+    autoReason: (layer: string, reason: string) => string;
+    modeNeedsConfirm: (mode: string) => string;
+    option: {
+        allow: string;
+        allowSession: string;
+        deny: string;
+    };
+    hint: (arrows: string) => string;
+    hintCompact: (arrows: string) => string;
+    outcome: {
+        allow: (what: string) => string;
+        allowSession: (what: string) => string;
+        deny: (what: string) => string;
+        cancelled: (what: string) => string;
+    };
+    choiceHint: (arrows: string, n: number) => string;
+};

package/dist/i18n/messages/approval.js

@@ -0,0 +1,100 @@
+/**
+ * 消息目录：approval（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I2]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ *
+ * 审批对话框（`modes/interactive/approval-dialog.ts`）、通用确认框（`confirm-dialog.ts`）与行式审批。
+ */
+import { plural } from "../format.js";
+export const en = {
+    /** 外部 Agent 来源标注：`[claude · session abc12345]`。 */
+    originLabel: (agent, sessionId) => `[${agent} · session ${sessionId}]`,
+    /** 标题里的原因。 */
+    title: {
+        firstRun: "First run of an external agent",
+        dangerous: "Dangerous command",
+        hook: "Hook asks for confirmation",
+        confirm: "Needs confirmation",
+    },
+    /** 首行工具名右侧的标签。 */
+    tag: {
+        dangerous: "Dangerous command",
+        hook: "Hook asks for confirmation",
+        firstRun: "First run",
+        confirm: "Needs confirmation",
+    },
+    morePaths: (n) => `… ${plural(n, "more path")}`,
+    moreLines: (n) => `… ${plural(n, "more line")}`,
+    moreLinesView: (n) => `… ${plural(n, "more line")} (v to view)`,
+    moreEdits: (n) => `… ${plural(n, "more edit")}`,
+    firstRunMode: (mode) => `Mode ${mode}`,
+    writeLines: (n) => `writes ${plural(n, "line")}`,
+    editCount: (n) => plural(n, "edit"),
+    externalRunner: (agent, runner) => `External agent ${agent}: runs with your ${runner} CLI login (includes this session's first-run confirmation)`,
+    originAsks: (agent) => `${agent} asks for confirmation`,
+    firstRunLogin: "First run of this CLI with your login in this session",
+    hookReason: (reason) => `Hook: ${reason ?? "(no reason given)"}`,
+    dangerousWarn: "This command may be destructive; please confirm",
+    autoReason: (layer, reason) => `Auto ${layer}: ${reason}`,
+    modeNeedsConfirm: (mode) => `Confirmation required in permission mode ${mode}`,
+    option: {
+        allow: "Allow",
+        allowSession: "Allow for this session",
+        deny: "Deny",
+    },
+    hint: (arrows) => `${arrows} select · Enter confirm · v full input`,
+    hintCompact: (arrows) => `${arrows} Enter · v full input`,
+    /** 消息区里的结果说明。 */
+    outcome: {
+        allow: (what) => `Allowed ${what}`,
+        allowSession: (what) => `Allowed ${what} (similar calls won't ask again this session)`,
+        deny: (what) => `Denied ${what}`,
+        cancelled: (what) => `Approval cancelled (timeout or interrupt): ${what}`,
+    },
+    /** 通用确认框的按键行。 */
+    choiceHint: (arrows, n) => `${arrows} select · Enter confirm · 1-${n} pick · Esc cancel`,
+};
+export const zh = {
+    originLabel: (agent, sessionId) => `[${agent} · 会话 ${sessionId}]`,
+    title: {
+        firstRun: "首次运行外部 Agent",
+        dangerous: "危险命令",
+        hook: "Hook 要求确认",
+        confirm: "需要确认",
+    },
+    tag: {
+        dangerous: "危险命令",
+        hook: "Hook 要求确认",
+        firstRun: "首次运行",
+        confirm: "需要确认",
+    },
+    morePaths: (n) => `… 另 ${n} 个路径`,
+    moreLines: (n) => `… 另 ${n} 行`,
+    moreLinesView: (n) => `… 另 ${n} 行（v 查看）`,
+    moreEdits: (n) => `… 另 ${n} 处`,
+    firstRunMode: (mode) => `模式 ${mode}`,
+    writeLines: (n) => `写入 ${n} 行`,
+    editCount: (n) => `${n} 处修改`,
+    externalRunner: (agent, runner) => `外部 Agent ${agent}：以你在 ${runner} CLI 的登录运行（含本会话首次运行确认）`,
+    originAsks: (agent) => `${agent} 请求确认`,
+    firstRunLogin: "本会话首次以你的登录运行该 CLI",
+    hookReason: (reason) => `Hook：${reason ?? "（无说明）"}`,
+    dangerousWarn: "这条命令可能有破坏性，请确认",
+    autoReason: (layer, reason) => `Auto ${layer}：${reason}`,
+    modeNeedsConfirm: (mode) => `权限模式 ${mode} 下需要确认`,
+    option: {
+        allow: "允许",
+        allowSession: "本会话允许同类",
+        deny: "拒绝",
+    },
+    hint: (arrows) => `${arrows} 选择 · Enter 确认 · v 完整输入`,
+    hintCompact: (arrows) => `${arrows} Enter · v 完整输入`,
+    outcome: {
+        allow: (what) => `已允许 ${what}`,
+        allowSession: (what) => `已允许 ${what}（本会话同类不再询问）`,
+        deny: (what) => `已拒绝 ${what}`,
+        cancelled: (what) => `审批已取消（超时或中断）：${what}`,
+    },
+    choiceHint: (arrows, n) => `${arrows} 选择 · Enter 确认 · 1-${n} 直接选 · Esc 取消`,
+};