@armadra/agent 0.5.1 → 0.6.1

package/dist/i18n/messages/config.js

@@ -0,0 +1,241 @@
+/**
+ * 消息目录：config（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I4 迁入]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ * 配置键说明（`keys` / `dynamicDefaults`）体量大，放在 `config-keys.ts`，经 `keyDoc(path)` 取用。
+ */
+import * as keyDocs from "./config-keys.js";
+export const en = {
+    /** 配置校验诊断（checker.ts、schema.ts、schema-w5.ts、schema-w6.ts）。 */
+    schema: {
+        enumArray: (choices) => `should be an array of ${choices.join(" | ")}`,
+        ports: "should be an array of port numbers (0–65535; 0 = any free port)",
+        required: "required",
+        memoryDir: "memory.enabled is true but memory.dir is not an absolute path",
+        object: "should be an object",
+        unknownKey: "unknown field, ignored",
+        version: "version must be 1",
+        requiredString: "required string missing",
+        string: "should be a string",
+        boolean: "should be a boolean",
+        number: "should be a number",
+        range: (min, max) => `should be between ${min} and ${max}`,
+        oneOf: (choices) => `should be one of ${choices.join(" | ")}`,
+        stringArray: "should be an array of strings",
+        array: "should be an array",
+        modelsDev: `should be "provider/model" or false`,
+        modelsEnabled: `should be "provider/model[@channel]" or "provider/*"`,
+        noChannels: "the provider has no channels",
+        unknownChannelOf: (name, available) => `channel "${name}" does not exist (available: ${available.join(", ")})`,
+        modelInput: `should be ("text" | "image")[]`,
+        channelName: "channel names may only contain letters, digits, _ and - (no / or @), at most 32 characters",
+        atLeastOneChannel: "at least one channel is required",
+        unknownChannel: (name) => `channel "${name}" does not exist`,
+        defaultChannelWithoutChannels: "defaultChannel cannot be set without channels",
+        builtinDeny: "should be a boolean or an array of strings",
+        writablePath: "should be an absolute path or ~/…; ignored",
+        providersMissing: "providers missing",
+        hookEvent: (events) => `unknown event (available: ${events.join(", ")})`,
+        hookType: `type must be "command"`,
+        hookCommandEmpty: "command is empty",
+        clearAtLeast: 'should be "auto" or a non-negative number',
+        agentId: "agent ids may only contain lowercase letters, digits, - . _ (optional acp: prefix)",
+    },
+    /** 层级合并（merge.ts）的告警。 */
+    merge: {
+        projectIgnored: (label, key) => `${label}: ${key} cannot be set at project level; ignored`,
+        projectMemoryOnlyDisable: (label) => `${label}: project level can only set memory.enabled to false; other memory keys ignored`,
+        projectOnlyKeys: (label, allowed, ignored) => `${label}: project level can only set ${allowed}; ignoring ${ignored}`,
+        projectPresetLoosen: (label, preset, current) => `${label}: project level cannot loosen the tool preset; ignoring tools.preset ${preset} (current ${current})`,
+        projectOnlyValue: (label, key, value, ignored) => `${label}: project level only accepts ${key} "${value}"; ignoring ${ignored}`,
+        projectPlanBashTighten: (label, value, current) => `${label}: project level can only tighten plan.bash; ignoring ${value} (current ${current})`,
+        projectModeTighten: (label, value, current) => `${label}: project level can only tighten the permission mode; ignoring ${value} (current ${current})`,
+        projectLowerOnly: (label, key, value, current) => `${label}: project level can only lower ${key}; ignoring ${value} (current ${current})`,
+        projectNoAllow: (label, rules) => `${label}: project level cannot add allow rules; ignoring ${rules}`,
+        projectNoBuiltinDeny: (label) => `${label}: project level cannot change the built-in deny table; ignoring permission.builtinDeny`,
+        projectNoAutoSafe: (label) => `${label}: project level cannot add permission.autoSafeCommands (loosening); ignored`,
+        projectModeLoosen: (label, mode) => `${label}: project level cannot set the permission mode to ${mode} (loosening; only the user config, profile or command line may); ignored`,
+    },
+    /** 读配置文件（load.ts）。 */
+    load: {
+        jsonSyntax: (line, column, message) => `JSON syntax error (line ${line}, column ${column}): ${message}`,
+        jsonSyntaxNear: (line, column, message) => `JSON syntax error (near line ${line}, column ${column}): ${message}`,
+        jsonEmpty: "JSON syntax error: the file is empty",
+        notFound: "file not found",
+        invalid: (lines) => `invalid config file:\n  ${lines.join("\n  ")}`,
+    },
+    /** [W6-I5] profile.json（profile.ts）。 */
+    profile: {
+        notFound: (path) => `${path}: file not found`,
+        relativePaths: (path, lines) => `${path}: paths in a profile must be absolute:\n  ${lines.join("\n  ")}`,
+    },
+    /** [W6-I5] auth.json 权限过宽（auth-file.ts）。 */
+    authFile: {
+        modeTooOpen: (path, mode) => `${path}: permissions are ${mode}, should be 0600 (chmod 600 ${path})`,
+    },
+    /** 目录（paths.ts）。 */
+    paths: {
+        notDirectory: "not a directory",
+        notWritable: (label, dir, reason) => `${label} is not writable: ${dir} (${reason})`,
+        configDir: "config directory",
+        dataDir: "data directory",
+        sessionDir: "session directory",
+    },
+    /** 上下文文件（context-files.ts）。 */
+    context: {
+        readFailed: (path, reason) => `${path}: failed to read (${reason})`,
+        truncated: (path, maxBytes) => `${path}: larger than ${maxBytes} bytes, truncated`,
+    },
+    /** `ama init`（init.ts）。 */
+    init: {
+        status: {
+            created: "created",
+            exists: "already exists, left unchanged",
+            updated: "updated to the current version",
+            unchanged: "already the current version",
+            overwritten: "rewritten (original backed up as .bak)",
+        },
+        dirCreated: "created (0700)",
+        dirExists: "already exists",
+        nextSteps: [
+            "Next steps:",
+            "  ama auth set anthropic          save a key for a built-in provider (or set ANTHROPIC_API_KEY etc.)",
+            "  ama providers add <id> --base-url <url>   connect a relay or self-hosted service",
+            "  ama doctor                      check config, keys and environment",
+            "  ama config show                 show the effective config and where each value comes from",
+        ].join("\n"),
+    },
+    /** config.schema.json 里供应商内部字段的说明（顶层与各段的键用 `keys`）。 */
+    jsonSchema: {
+        api: "Protocol",
+        compat: 'Protocol compatibility switches (docs/providers.md "compat")',
+        modelId: "Model id (the name sent upstream)",
+        modelBaseUrl: "Overrides the channel / provider address",
+        contextWindow: "Context tokens; filled from models.dev by default, not guessed when there is no match",
+        maxTokens: "Output limit per request; defaults to min(models.dev, 64k) or 8192",
+        input: '["text"] or ["text", "image"] (accepts images)',
+        modelChannels: "Channels the model is mounted on; the first is preferred",
+        modelsDev: 'models.dev entry "provider/model"; false disables enrichment',
+        baseUrl: "Endpoint address",
+        channelApiKey: "$ENV / ${ENV} / !command / literal; defaults to the provider's key",
+        apiKey: "$ENV / ${ENV} / !command / literal",
+        channels: "Channels: several endpoints under one provider",
+        defaultChannel: "Preferred channel; defaults to the first of channels",
+        models: "Custom models (an entry with the same id replaces the whole model)",
+        modelOverrides: "Only changes metadata of existing models",
+    },
+    ...keyDocs.en,
+};
+export const zh = {
+    schema: {
+        enumArray: (choices) => `应为 ${choices.join(" | ")} 组成的数组`,
+        ports: "应为端口号数组（0–65535；0 = 任意空闲端口）",
+        required: "缺少必填字段",
+        memoryDir: "memory.enabled 为 true 时 memory.dir 必须是绝对路径",
+        object: "应为对象",
+        unknownKey: "未知字段，已忽略",
+        version: "version 必须为 1",
+        requiredString: "缺少必填字符串",
+        string: "应为字符串",
+        boolean: "应为布尔值",
+        number: "应为数字",
+        range: (min, max) => `应在 ${min}–${max} 之间`,
+        oneOf: (choices) => `取值应为 ${choices.join(" | ")}`,
+        stringArray: "应为字符串数组",
+        array: "应为数组",
+        modelsDev: `应为 "provider/model" 或 false`,
+        modelsEnabled: `应为 "provider/model[@channel]" 或 "provider/*"`,
+        noChannels: "供应商没有 channels",
+        unknownChannelOf: (name, available) => `渠道 "${name}" 不存在（可用：${available.join(", ")}）`,
+        modelInput: `应为 ("text" | "image")[]`,
+        channelName: "渠道名只能含字母、数字、_ 与 -（不含 / 与 @），最长 32",
+        atLeastOneChannel: "至少要有一个渠道",
+        unknownChannel: (name) => `渠道 "${name}" 不存在`,
+        defaultChannelWithoutChannels: "没有 channels 时不能设 defaultChannel",
+        builtinDeny: "应为布尔值或字符串数组",
+        writablePath: "应为绝对路径或 ~/…，已忽略",
+        providersMissing: "缺少 providers",
+        hookEvent: (events) => `未知事件（可用：${events.join(", ")}）`,
+        hookType: `type 必须为 "command"`,
+        hookCommandEmpty: "命令为空",
+        clearAtLeast: '应为 "auto" 或非负数字',
+        agentId: "Agent id 只能是小写字母、数字、- . _（可带 acp: 前缀）",
+    },
+    merge: {
+        projectIgnored: (label, key) => `${label}: 项目级不能设 ${key}，已忽略`,
+        projectMemoryOnlyDisable: (label) => `${label}: 项目级只能把 memory.enabled 设为 false，忽略 memory 的其它键`,
+        projectOnlyKeys: (label, allowed, ignored) => `${label}: 项目级只能设 ${allowed}，忽略 ${ignored}`,
+        projectPresetLoosen: (label, preset, current) => `${label}: 项目级不能放宽工具预设，忽略 tools.preset ${preset}（当前 ${current}）`,
+        projectOnlyValue: (label, key, value, ignored) => `${label}: 项目级只接受 ${key} "${value}"，忽略 ${ignored}`,
+        projectPlanBashTighten: (label, value, current) => `${label}: 项目级只能收紧 plan.bash，忽略 ${value}（当前 ${current}）`,
+        projectModeTighten: (label, value, current) => `${label}: 项目级只能收紧权限模式，忽略 ${value}（当前 ${current}）`,
+        projectLowerOnly: (label, key, value, current) => `${label}: 项目级只能调小 ${key}，忽略 ${value}（当前 ${current}）`,
+        projectNoAllow: (label, rules) => `${label}: 项目级不能加 allow 规则，忽略 ${rules}`,
+        projectNoBuiltinDeny: (label) => `${label}: 项目级不能改内置 deny 表，忽略 permission.builtinDeny`,
+        projectNoAutoSafe: (label) => `${label}: 项目级不能追加 permission.autoSafeCommands（放宽），已忽略`,
+        projectModeLoosen: (label, mode) => `${label}: 项目级不能把权限模式设为 ${mode}（放宽，只能在用户级配置、profile 或命令行设），已忽略`,
+    },
+    load: {
+        jsonSyntax: (line, column, message) => `JSON 语法错误（第 ${line} 行第 ${column} 列）：${message}`,
+        jsonSyntaxNear: (line, column, message) => `JSON 语法错误（第 ${line} 行第 ${column} 列附近）：${message}`,
+        jsonEmpty: "JSON 语法错误：文件为空",
+        notFound: "文件不存在",
+        invalid: (lines) => `配置文件无效：\n  ${lines.join("\n  ")}`,
+    },
+    profile: {
+        notFound: (path) => `${path}: 文件不存在`,
+        relativePaths: (path, lines) => `${path}: profile 中的路径必须是绝对路径：\n  ${lines.join("\n  ")}`,
+    },
+    authFile: {
+        modeTooOpen: (path, mode) => `${path}: 权限为 ${mode}，应为 0600（chmod 600 ${path}）`,
+    },
+    paths: {
+        notDirectory: "不是目录",
+        notWritable: (label, dir, reason) => `${label}不可写：${dir}（${reason}）`,
+        configDir: "配置目录",
+        dataDir: "数据目录",
+        sessionDir: "会话目录",
+    },
+    context: {
+        readFailed: (path, reason) => `${path}: 读取失败（${reason}）`,
+        truncated: (path, maxBytes) => `${path}: 超过 ${maxBytes} 字节，已截断`,
+    },
+    init: {
+        status: {
+            created: "已创建",
+            exists: "已存在，未改动",
+            updated: "已更新为当前版本",
+            unchanged: "已是当前版本",
+            overwritten: "已重写（原文件备份为 .bak）",
+        },
+        dirCreated: "已创建（0700）",
+        dirExists: "已存在",
+        nextSteps: [
+            "下一步：",
+            "  ama auth set anthropic          保存内置供应商的 key（或设置 ANTHROPIC_API_KEY 等环境变量）",
+            "  ama providers add <id> --base-url <url>   接入中转站或自建服务",
+            "  ama doctor                      检查配置、key 与运行环境",
+            "  ama config show                 查看生效配置与每项来源",
+        ].join("\n"),
+    },
+    jsonSchema: {
+        api: "协议",
+        compat: "协议兼容开关（docs/providers.md「compat」）",
+        modelId: "模型 id（发给上游的名字）",
+        modelBaseUrl: "覆盖渠道 / 供应商的地址",
+        contextWindow: "上下文 token；缺省从 models.dev 补，匹配不到不猜",
+        maxTokens: "单次输出上限；缺省 min(models.dev, 64k) 或 8192",
+        input: '["text"] 或 ["text", "image"]（收图片）',
+        modelChannels: "挂载的渠道，第一个是首选",
+        modelsDev: 'models.dev 条目 "provider/model"；false 关闭补全',
+        baseUrl: "接口地址",
+        channelApiKey: "$ENV / ${ENV} / !command / 字面量；缺省用供应商的 key",
+        apiKey: "$ENV / ${ENV} / !command / 字面量",
+        channels: "渠道：一个供应商下的多种接口",
+        defaultChannel: "首选渠道；缺省 channels 的第一个",
+        models: "自定义模型（同 id 整条替换）",
+        modelOverrides: "只改已有模型的元数据",
+    },
+    ...keyDocs.zh,
+};

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

@@ -0,0 +1,123 @@
+/**
+ * 消息目录：drivers（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I3 迁入 `src/{drivers,agents,hooks,host}/**`]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ * 这里只放给人看的提示（外部 Agent 的 notice、日志、Hook 警告、宿主适配器错误）；进 task 工具结果、
+ * 回给模型的文本固定英文，写在各模块里、不走这里。
+ */
+export declare const en: {
+    /** 外部 Agent 的 notice 与日志。 */
+    agent: {
+        reapedOrphans: (pids: string) => string;
+        unverifiedVersion: (program: string, version: string, verified: string) => string;
+        cancelGraceExpired: string;
+        modeClamped: (agent: string, chosen: string, requested: string) => string;
+        overBudget: (agent: string) => string;
+        timedOut: (agent: string) => string;
+        resumeUnsupported: (agent: string) => string;
+        resumeNotFound: (agent: string, id: string) => string;
+        noMatchingMode: (agent: string, mode: string) => string;
+        noImages: (agent: string) => string;
+        noImagesDriver: (agent: string) => string;
+        noImagesOneshot: (agent: string) => string;
+        initializeRejected: (agent: string, error: string) => string;
+        nonJson: (agent: string) => string;
+        denials: (agent: string, count: number) => string;
+        budgetStop: (agent: string) => string;
+        error: (agent: string, message: string, retrying: boolean) => string;
+        askedQuestion: (agent: string, tool: string) => string;
+        askedQuestionCodex: (agent: string) => string;
+        mcpElicitation: (agent: string) => string;
+    };
+    /** Hook 配置与输出的警告（给人看；回给模型的阻止理由固定英文）。 */
+    hooks: {
+        configInvalid: (lines: string) => string;
+        projectUntrusted: (path: string) => string;
+        unknownDecision: (value: string) => string;
+        notString: (key: string) => string;
+        timedOut: (event: string, command: string, ms: number) => string;
+        failed: (event: string, command: string, exitCode: number | null, tail: string) => string;
+        invalidDecision: (event: string, command: string, decision: string) => string;
+        multipleInputs: (count: number) => string;
+        multiplePrompts: (count: number) => string;
+    };
+    /** 宿主适配器（host/**）：错误给宿主开发者看，宿主按 code 判断。 */
+    host: {
+        handlerFailed: (name: string) => string;
+        toolNotObject: string;
+        toolBadName: (name: string) => string;
+        toolNoExecute: (name: string) => string;
+        toolBadPermission: (name: string) => string;
+        toolExists: (name: string) => string;
+        instructionNeedsPath: string;
+        instructionNeedsText: string;
+        brokerNeedsAsk: string;
+        warmingNeedsFunction: string;
+        runnerNeedsIdStart: string;
+        notAdapter: (label: string) => string;
+        versionMismatch: (label: string, found: string, needed: number) => string;
+        noCreate: (label: string) => string;
+        notFound: (path: string) => string;
+        loadFailed: (path: string, error: string) => string;
+        createTimeout: (label: string, ms: number) => string;
+        createFailed: (label: string, error: string) => string;
+        noId: (label: string) => string;
+    };
+};
+export declare const zh: {
+    agent: {
+        reapedOrphans: (pids: string) => string;
+        unverifiedVersion: (program: string, version: string, verified: string) => string;
+        cancelGraceExpired: string;
+        modeClamped: (agent: string, chosen: string, requested: string) => string;
+        overBudget: (agent: string) => string;
+        timedOut: (agent: string) => string;
+        resumeUnsupported: (agent: string) => string;
+        resumeNotFound: (agent: string, id: string) => string;
+        noMatchingMode: (agent: string, mode: string) => string;
+        noImages: (agent: string) => string;
+        noImagesDriver: (agent: string) => string;
+        noImagesOneshot: (agent: string) => string;
+        initializeRejected: (agent: string, error: string) => string;
+        nonJson: (agent: string) => string;
+        denials: (agent: string, count: number) => string;
+        budgetStop: (agent: string) => string;
+        error: (agent: string, message: string, retrying: boolean) => string;
+        askedQuestion: (agent: string, tool: string) => string;
+        askedQuestionCodex: (agent: string) => string;
+        mcpElicitation: (agent: string) => string;
+    };
+    hooks: {
+        configInvalid: (lines: string) => string;
+        projectUntrusted: (path: string) => string;
+        unknownDecision: (value: string) => string;
+        notString: (key: string) => string;
+        timedOut: (event: string, command: string, ms: number) => string;
+        failed: (event: string, command: string, exitCode: number | null, tail: string) => string;
+        invalidDecision: (event: string, command: string, decision: string) => string;
+        multipleInputs: (count: number) => string;
+        multiplePrompts: (count: number) => string;
+    };
+    host: {
+        handlerFailed: (name: string) => string;
+        toolNotObject: string;
+        toolBadName: (name: string) => string;
+        toolNoExecute: (name: string) => string;
+        toolBadPermission: (name: string) => string;
+        toolExists: (name: string) => string;
+        instructionNeedsPath: string;
+        instructionNeedsText: string;
+        brokerNeedsAsk: string;
+        warmingNeedsFunction: string;
+        runnerNeedsIdStart: string;
+        notAdapter: (label: string) => string;
+        versionMismatch: (label: string, found: string, needed: number) => string;
+        noCreate: (label: string) => string;
+        notFound: (path: string) => string;
+        loadFailed: (path: string, error: string) => string;
+        createTimeout: (label: string, ms: number) => string;
+        createFailed: (label: string, error: string) => string;
+        noId: (label: string) => string;
+    };
+};

package/dist/i18n/messages/drivers.js

@@ -0,0 +1,124 @@
+/**
+ * 消息目录：drivers（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I3 迁入 `src/{drivers,agents,hooks,host}/**`]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ * 这里只放给人看的提示（外部 Agent 的 notice、日志、Hook 警告、宿主适配器错误）；进 task 工具结果、
+ * 回给模型的文本固定英文，写在各模块里、不走这里。
+ */
+import { plural } from "../format.js";
+export const en = {
+    /** 外部 Agent 的 notice 与日志。 */
+    agent: {
+        reapedOrphans: (pids) => `cleaned up external agent processes left over from last time: ${pids}`,
+        unverifiedVersion: (program, version, verified) => `${program} ${version} is outside the verified range ${verified}; the protocol may have changed`,
+        cancelGraceExpired: "the external agent did not end its turn within the grace period after interrupt; closing the process",
+        modeClamped: (agent, chosen, requested) => `${agent} runs in "${chosen}" mode (requested "${requested}"; an external agent may not be looser than ama's current mode)`,
+        overBudget: (agent) => `${agent} exceeded its USD budget; interrupted`,
+        timedOut: (agent) => `${agent} timed out; interrupted`,
+        resumeUnsupported: (agent) => `${agent} cannot resume sessions; started a new one`,
+        resumeNotFound: (agent, id) => `${agent} cannot find session ${id}; started a new one`,
+        noMatchingMode: (agent, mode) => `${agent} has no "${mode}" mode; running in its own default mode (actions that need approval still come to you)`,
+        noImages: (agent) => `${agent} does not accept images; omitted`,
+        noImagesDriver: (agent) => `the ${agent} driver does not pass images yet; omitted`,
+        noImagesOneshot: (agent) => `${agent} one-shot mode does not pass images; omitted`,
+        initializeRejected: (agent, error) => `${agent}: initialize was not accepted (${error})`,
+        nonJson: (agent) => `${agent}: non-JSON output`,
+        denials: (agent, count) => `${agent} had ${plural(count, "action")} denied because no one was there to approve`,
+        budgetStop: (agent) => `${agent} reached its USD budget limit; stopped`,
+        error: (agent, message, retrying) => `${agent}: ${message}${retrying ? " (retrying)" : ""}`,
+        askedQuestion: (agent, tool) => `${agent} wants to ask you a question (${tool}); ama does not answer for you and asked it to put the question in its final reply`,
+        askedQuestionCodex: (agent) => `${agent} wants to ask you a question; ama does not answer for you — have it put the question in its final reply`,
+        mcpElicitation: (agent) => `${agent}'s MCP server asked for input; ama does not answer for you, cancelled`,
+    },
+    /** Hook 配置与输出的警告（给人看；回给模型的阻止理由固定英文）。 */
+    hooks: {
+        configInvalid: (lines) => `invalid config file:\n  ${lines}`,
+        projectUntrusted: (path) => `${path}: project not trusted, skipping project hooks (use --trust or confirm trust in interactive mode)`,
+        unknownDecision: (value) => `unknown decision: ${value}`,
+        notString: (key) => `${key} must be a string`,
+        timedOut: (event, command, ms) => `Hook ${event} "${command}" timed out (${ms} ms)`,
+        failed: (event, command, exitCode, tail) => `Hook ${event} "${command}" failed (${exitCode === null ? "killed by a signal" : `exit code ${exitCode}`})${tail === "" ? "" : `: ${tail}`}`,
+        invalidDecision: (event, command, decision) => `Hook ${event} "${command}": decision "${decision}" is not valid for ${event}; ignored`,
+        multipleInputs: (count) => `${count} hooks returned updatedInput at once; all ignored`,
+        multiplePrompts: (count) => `${count} hooks returned updatedPrompt at once; all ignored`,
+    },
+    /** 宿主适配器（host/**）：错误给宿主开发者看，宿主按 code 判断。 */
+    host: {
+        handlerFailed: (name) => `host event handler threw (${name})`,
+        toolNotObject: "tools.register: the tool definition must be an object",
+        toolBadName: (name) => `tools.register: invalid tool name: ${name}`,
+        toolNoExecute: (name) => `tools.register: ${name} is missing execute()`,
+        toolBadPermission: (name) => `tools.register: ${name} has an invalid permission`,
+        toolExists: (name) => `tools.register: tool ${name} already exists`,
+        instructionNeedsPath: "instructions.add: file needs path",
+        instructionNeedsText: "instructions.add: text needs text",
+        brokerNeedsAsk: "approvals.setBroker: broker needs ask()",
+        warmingNeedsFunction: "cache.onWarmingDecision: needs a function",
+        runnerNeedsIdStart: "runners.provide: needs a runner with id and start",
+        notAdapter: (label) => `${label}: not a host adapter module (missing hostApi / create export)`,
+        versionMismatch: (label, found, needed) => `${label}: host adapter hostApi=${found}, ama needs ${needed}`,
+        noCreate: (label) => `${label}: missing create(api) function`,
+        notFound: (path) => `host adapter not found: ${path}`,
+        loadFailed: (path, error) => `failed to load host adapter: ${path}: ${error}`,
+        createTimeout: (label, ms) => `${label}: create() did not return within ${ms} ms`,
+        createFailed: (label, error) => `${label}: create() failed: ${error}`,
+        noId: (label) => `${label}: the adapter returned by create() has no id`,
+    },
+};
+export const zh = {
+    agent: {
+        reapedOrphans: (pids) => `清理了上次遗留的外部 Agent 进程：${pids}`,
+        unverifiedVersion: (program, version, verified) => `${program} ${version} 不在已验证区间 ${verified}，协议可能有变化`,
+        cancelGraceExpired: "外部 Agent 中断后未在宽限内结束回合，关闭进程",
+        modeClamped: (agent, chosen, requested) => `${agent} 以「${chosen}」模式运行（请求的是「${requested}」，外部 Agent 不得比 ama 当前模式宽）`,
+        overBudget: (agent) => `${agent} 超出美元预算，已中断`,
+        timedOut: (agent) => `${agent} 运行超时，已中断`,
+        resumeUnsupported: (agent) => `${agent} 不支持续接会话，已新开`,
+        resumeNotFound: (agent, id) => `${agent} 找不到会话 ${id}，已新开`,
+        noMatchingMode: (agent, mode) => `${agent} 没有「${mode}」模式，按它自己的缺省模式运行（需要授权的操作仍交给你）`,
+        noImages: (agent) => `${agent} 不接受图片，已省略`,
+        noImagesDriver: (agent) => `${agent} 驱动暂不传图片，已省略`,
+        noImagesOneshot: (agent) => `${agent} 一次性模式不传图片，已省略`,
+        initializeRejected: (agent, error) => `${agent}: initialize 未被接受（${error}）`,
+        nonJson: (agent) => `${agent}: 非 JSON 输出`,
+        denials: (agent, count) => `${agent} 有 ${count} 次操作因无人审批被拒绝`,
+        budgetStop: (agent) => `${agent} 达到美元预算上限，已停止`,
+        error: (agent, message, retrying) => `${agent}：${message}${retrying ? "（重试中）" : ""}`,
+        askedQuestion: (agent, tool) => `${agent} 想向你提问（${tool}）；ama 不代答，已请它把问题写进最终回复`,
+        askedQuestionCodex: (agent) => `${agent} 想向你提问；ama 不代答，请让它把问题写进最终回复`,
+        mcpElicitation: (agent) => `${agent} 的 MCP 服务器请求输入；ama 不代答，已取消`,
+    },
+    hooks: {
+        configInvalid: (lines) => `配置文件无效：\n  ${lines}`,
+        projectUntrusted: (path) => `${path}: 项目未信任，跳过项目级 Hook（用 --trust 或在交互模式确认信任）`,
+        unknownDecision: (value) => `未知 decision：${value}`,
+        notString: (key) => `${key} 应为字符串`,
+        timedOut: (event, command, ms) => `Hook ${event}「${command}」超时（${ms} ms）`,
+        failed: (event, command, exitCode, tail) => `Hook ${event}「${command}」失败（${exitCode === null ? "被信号终止" : `退出码 ${exitCode}`}）${tail === "" ? "" : `：${tail}`}`,
+        invalidDecision: (event, command, decision) => `Hook ${event}「${command}」的 decision "${decision}" 对 ${event} 无效，已忽略`,
+        multipleInputs: (count) => `${count} 个 Hook 同时返回 updatedInput，全部忽略`,
+        multiplePrompts: (count) => `${count} 个 Hook 同时返回 updatedPrompt，全部忽略`,
+    },
+    host: {
+        handlerFailed: (name) => `宿主事件处理器异常（${name}）`,
+        toolNotObject: "tools.register：工具定义应为对象",
+        toolBadName: (name) => `tools.register：工具名不合法：${name}`,
+        toolNoExecute: (name) => `tools.register：${name} 缺少 execute()`,
+        toolBadPermission: (name) => `tools.register：${name} 的 permission 不合法`,
+        toolExists: (name) => `tools.register：工具 ${name} 已存在`,
+        instructionNeedsPath: "instructions.add：file 需要 path",
+        instructionNeedsText: "instructions.add：text 需要 text",
+        brokerNeedsAsk: "approvals.setBroker：broker 需要 ask()",
+        warmingNeedsFunction: "cache.onWarmingDecision：需要函数",
+        runnerNeedsIdStart: "runners.provide：需要带 id 与 start 的 runner",
+        notAdapter: (label) => `${label}: 不是宿主适配器模块（缺少 hostApi / create 导出）`,
+        versionMismatch: (label, found, needed) => `${label}: 宿主适配器 hostApi=${found}，ama 需要 ${needed}`,
+        noCreate: (label) => `${label}: 缺少 create(api) 函数`,
+        notFound: (path) => `宿主适配器不存在：${path}`,
+        loadFailed: (path, error) => `宿主适配器加载失败：${path}：${error}`,
+        createTimeout: (label, ms) => `${label}: create() 超过 ${ms} ms 未返回`,
+        createFailed: (label, error) => `${label}: create() 失败：${error}`,
+        noId: (label) => `${label}: create() 返回的适配器缺少 id`,
+    },
+};

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

@@ -0,0 +1,83 @@
+/**
+ * 消息目录：errors（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I3]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ */
+import type { ImageFileErrorDetail } from "../../tools/image-file.js";
+import type { FieldSource } from "../../ai/providers/enrich.js";
+import type { MatchKind } from "../../ai/providers/models-dev.js";
+import type { ModelLookup } from "../../ai/types.js";
+export declare const en: {
+    /** [W6-I3] 图片附件：当前模型不收图片（`--image` / `@路径`）。 */
+    imageUnsupported: (model: string | undefined) => string;
+    /** [W6-I3] SDK（`createRuntime` / `createAgentSession`）。 */
+    /** [W6-I5] 端点拒收缓存参数后自动去掉重发（`ai/apis/cache-params.ts`）。 */
+    cacheParamsStripped: (key: string, field: string, suggestion: string | undefined) => string;
+    sdk: {
+        noSubcommand: string;
+        modelNotFound: (ref: string) => string;
+        noModel: string;
+        noPlan: string;
+    };
+    /** [W6-I3] 模型查找、models.dev 元数据（`src/ai/providers/**`）。 */
+    models: {
+        lookupFailure: (ref: string, reason: Extract<ModelLookup, {
+            ok: false;
+        }>["reason"], list: string, hasCandidates: boolean) => string;
+        source: (source: FieldSource) => string;
+        unmatched: string;
+        match: (kind: MatchKind, ref: string, normalized: string | undefined) => string;
+        consensus: (key: string, entries: number, groups: number, best: number, signature: string) => string;
+        notObject: string;
+        snapshotMissing: (id: string) => string;
+        apiNotObject: string;
+        apiMissingProvider: (id: string) => string;
+        noModelsAfterFilter: (id: string) => string;
+        none: string;
+        describe: (via: string, providers: number, models: number) => string;
+        viaSnapshot: (at: string) => string;
+        viaRefresh: (snapshot: string, refreshed: string) => string;
+        refreshFailed: (reason: string) => string;
+        notListed: (unknown: string, choices: string) => string;
+        refreshStatus: (status: "updated" | "unchanged" | "failed", providers: number, models: number, at: string | undefined) => string;
+        section: (kind: "added" | "removed" | "changed", count: number) => string;
+        more: (count: number) => string;
+        changed: (ref: string, parts: readonly string[]) => string;
+    };
+    /** [W6-C0] 读图失败（`tools/image-file.ts` 的 `AmaError.detail`），`--image` 与 `@路径` 显示。 */
+    imageFile: (d: ImageFileErrorDetail) => string;
+};
+export declare const zh: {
+    imageUnsupported: (model: string | undefined) => string;
+    cacheParamsStripped: (key: string, field: string, suggestion: string | undefined) => string;
+    sdk: {
+        noSubcommand: string;
+        modelNotFound: (ref: string) => string;
+        noModel: string;
+        noPlan: string;
+    };
+    models: {
+        lookupFailure: (ref: string, reason: "not_found" | "ambiguous" | "provider_not_found" | "channel_not_found", list: string, hasCandidates: boolean) => string;
+        source: (source: FieldSource) => "config" | "目录" | "缺省" | "models.dev";
+        unmatched: string;
+        match: (kind: MatchKind, ref: string, normalized: string | undefined) => string;
+        consensus: (key: string, entries: number, groups: number, best: number, signature: string) => string;
+        notObject: string;
+        snapshotMissing: (id: string) => string;
+        apiNotObject: string;
+        apiMissingProvider: (id: string) => string;
+        noModelsAfterFilter: (id: string) => string;
+        none: string;
+        describe: (via: string, providers: number, models: number) => string;
+        viaSnapshot: (at: string) => string;
+        viaRefresh: (snapshot: string, refreshed: string) => string;
+        refreshFailed: (reason: string) => string;
+        notListed: (unknown: string, choices: string) => string;
+        refreshStatus: (status: "failed" | "unchanged" | "updated", providers: number, models: number, at: string | undefined) => string;
+        section: (kind: "added" | "removed" | "changed", count: number) => string;
+        more: (count: number) => string;
+        changed: (ref: string, parts: readonly string[]) => string;
+    };
+    imageFile: (d: ImageFileErrorDetail) => string;
+};