@armadra/agent 0.5.1 → 0.6.0

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

@@ -0,0 +1,123 @@
+/**
+ * 消息目录：plan（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I2]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ *
+ * `/plan` 命令（`plan-command.ts`）、Plan 审批框（`plan-dialog.ts`）与审批后的提示（`plan-flow.ts`）。
+ * 用户**输入**的别名（`批准`、步骤标题）不在这里，两种语言同时识别（`plan/controller.ts`、`plan/extract.ts`）。
+ */
+export declare const en: {
+    usage: string;
+    status: {
+        proposed: string;
+        approved: string;
+        rejected: string;
+        superseded: string;
+    };
+    untitled: string;
+    command: {
+        modePlan: (back: string) => string;
+        mode: (mode: string) => string;
+        noPlanYet: string;
+        noPlan: string;
+        head: (version: number, status: string, title: string) => string;
+        file: (path: string) => string;
+        steps: (n: number) => string;
+        todos: (done: number, total: number, current: string | undefined) => string;
+        actions: string;
+        notFound: string;
+        unavailable: string;
+        invalidMode: (arg: string, usage: string) => string;
+        approved: (version: number, mode: string) => string;
+        rejected: (version: number) => string;
+    };
+    dialog: {
+        title: string;
+        optionApprove: string;
+        optionApproveFresh: string;
+        optionRevise: (ellipsis: string) => string;
+        optionReject: string;
+        modeBack: (mode: string) => string;
+        modeHeadingFresh: string;
+        modeHeading: string;
+        editing: (ellipsis: string) => string;
+        version: (version: number) => string;
+        stepCount: (n: number) => string;
+        edited: string;
+        moreSteps: (ellipsis: string, n: number) => string;
+        feedbackCompact: string;
+        feedback: string;
+        hintMainCompact: (arrows: string, edit: boolean) => string;
+        hintMain: (arrows: string, edit: boolean) => string;
+        hintModeCompact: (arrows: string) => string;
+        hintMode: (arrows: string) => string;
+        hintReviseCompact: (edit: boolean) => string;
+        hintRevise: (edit: boolean) => string;
+        hintEditing: string;
+    };
+    flow: {
+        pending: (version: number) => string;
+        approved: (version: number, mode: string) => string;
+        approvedFresh: (version: number, sessionId: string, mode: string) => string;
+        rejectedExit: (version: number, mode: string) => string;
+        rejectedStay: (version: number) => string;
+    };
+};
+export declare const zh: {
+    usage: string;
+    status: {
+        proposed: string;
+        approved: string;
+        rejected: string;
+        superseded: string;
+    };
+    untitled: string;
+    command: {
+        modePlan: (back: string) => string;
+        mode: (mode: string) => string;
+        noPlanYet: string;
+        noPlan: string;
+        head: (version: number, status: string, title: string) => string;
+        file: (path: string) => string;
+        steps: (n: number) => string;
+        todos: (done: number, total: number, current: string | undefined) => string;
+        actions: string;
+        notFound: string;
+        unavailable: string;
+        invalidMode: (arg: string, usage: string) => string;
+        approved: (version: number, mode: string) => string;
+        rejected: (version: number) => string;
+    };
+    dialog: {
+        title: string;
+        optionApprove: string;
+        optionApproveFresh: string;
+        optionRevise: (ellipsis: string) => string;
+        optionReject: string;
+        modeBack: (mode: string) => string;
+        modeHeadingFresh: string;
+        modeHeading: string;
+        editing: (ellipsis: string) => string;
+        version: (version: number) => string;
+        stepCount: (n: number) => string;
+        edited: string;
+        moreSteps: (ellipsis: string, n: number) => string;
+        feedbackCompact: string;
+        feedback: string;
+        hintMainCompact: (arrows: string, edit: boolean) => string;
+        hintMain: (arrows: string, edit: boolean) => string;
+        hintModeCompact: (arrows: string) => string;
+        hintMode: (arrows: string) => string;
+        hintReviseCompact: (edit: boolean) => string;
+        hintRevise: (edit: boolean) => string;
+        hintEditing: string;
+    };
+    flow: {
+        pending: (version: number) => string;
+        approved: (version: number, mode: string) => string;
+        approvedFresh: (version: number, sessionId: string, mode: string) => string;
+        rejectedExit: (version: number, mode: string) => string;
+        rejectedStay: (version: number) => string;
+    };
+};

package/dist/i18n/messages/plan.js

@@ -0,0 +1,124 @@
+/**
+ * 消息目录：plan（键名规范见 docs/i18n.md）。[W6-C0 建空壳，归 W6-I2]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ *
+ * `/plan` 命令（`plan-command.ts`）、Plan 审批框（`plan-dialog.ts`）与审批后的提示（`plan-flow.ts`）。
+ * 用户**输入**的别名（`批准`、步骤标题）不在这里，两种语言同时识别（`plan/controller.ts`、`plan/extract.ts`）。
+ */
+import { plural } from "../format.js";
+export const en = {
+    usage: "Usage: /plan [goal] | /plan approve [mode|fresh] | /plan reject",
+    status: {
+        proposed: "awaiting approval",
+        approved: "approved",
+        rejected: "rejected",
+        superseded: "superseded by a newer version",
+    },
+    untitled: "(untitled)",
+    command: {
+        modePlan: (back) => `Mode: Plan (returns to ${back} after approval)`,
+        mode: (mode) => `Mode: ${mode}`,
+        noPlanYet: "No plan yet: approve here once the model gives a <proposed_plan>",
+        noPlan: "No plan. /plan <goal> enters Plan mode",
+        head: (version, status, title) => `Plan v${version} · ${status} · ${title}`,
+        file: (path) => `File: ${path}`,
+        steps: (n) => `Steps (${n}):`,
+        todos: (done, total, current) => `Todos: ${done}/${total} done${current !== undefined ? ` · in progress ${current}` : ""}`,
+        actions: "/plan approve [mode|fresh] to approve · /plan reject to reject · type to give feedback",
+        notFound: "No plan awaiting approval",
+        unavailable: "This session has no Plan capability",
+        invalidMode: (arg, usage) => `Invalid execution mode: ${arg} (${usage})`,
+        approved: (version, mode) => `Approved plan v${version}; running in ${mode}`,
+        rejected: (version) => `Rejected plan v${version} (still in Plan mode)`,
+    },
+    dialog: {
+        title: "Plan awaiting approval",
+        optionApprove: "Approve and run",
+        optionApproveFresh: "Approve, run in fresh context",
+        optionRevise: (ellipsis) => `Keep revising${ellipsis}`,
+        optionReject: "Reject and leave Plan mode",
+        modeBack: (mode) => `Back to the previous mode (${mode})`,
+        modeHeadingFresh: "Run in a fresh context; execution mode",
+        modeHeading: "Execution mode",
+        editing: (ellipsis) => `Editing in the external editor${ellipsis}`,
+        version: (version) => `Plan v${version}`,
+        stepCount: (n) => plural(n, "step"),
+        edited: "Edited in the editor: approval runs the edited plan",
+        moreSteps: (ellipsis, n) => `  ${ellipsis} ${plural(n, "more step")} (/plan shows all)`,
+        feedbackCompact: "Feedback",
+        feedback: "Feedback (stays in Plan mode; the model rewrites the plan)",
+        hintMainCompact: (arrows, edit) => `${arrows} Enter${edit ? " · e edit" : ""} · Esc stay in Plan`,
+        hintMain: (arrows, edit) => `${arrows} select · Enter confirm${edit ? " · e edit plan" : ""} · Esc stay in Plan`,
+        hintModeCompact: (arrows) => `${arrows} Enter · Esc back`,
+        hintMode: (arrows) => `${arrows} select · Enter confirm · Esc back`,
+        hintReviseCompact: (edit) => `Enter send${edit ? " · Ctrl+E editor" : ""} · Esc back`,
+        hintRevise: (edit) => `Enter send${edit ? " · Ctrl+E external editor" : ""} · Esc back`,
+        hintEditing: "Save and close the editor to come back here",
+    },
+    flow: {
+        pending: (version) => `Plan v${version} awaits approval: /plan opens the dialog`,
+        approved: (version, mode) => `Approved plan v${version}; running in ${mode}`,
+        approvedFresh: (version, sessionId, mode) => `Approved plan v${version}; running in ${mode} in new session ${sessionId}`,
+        rejectedExit: (version, mode) => `Rejected plan v${version}; back to ${mode}`,
+        rejectedStay: (version) => `Rejected plan v${version} (still in Plan mode; /plan to view)`,
+    },
+};
+export const zh = {
+    usage: "用法：/plan [目标] | /plan approve [模式|fresh] | /plan reject",
+    status: {
+        proposed: "待审批",
+        approved: "已批准",
+        rejected: "已放弃",
+        superseded: "已被新版本取代",
+    },
+    untitled: "（无标题）",
+    command: {
+        modePlan: (back) => `模式：Plan（批准后回到 ${back}）`,
+        mode: (mode) => `模式：${mode}`,
+        noPlanYet: "还没有计划：模型给出 <proposed_plan> 后在这里审批",
+        noPlan: "没有计划。/plan <目标> 进入 Plan 模式",
+        head: (version, status, title) => `计划 v${version} · ${status} · ${title}`,
+        file: (path) => `文件：${path}`,
+        steps: (n) => `步骤（${n}）：`,
+        todos: (done, total, current) => `待办：${done}/${total} 完成${current !== undefined ? ` · 进行中 ${current}` : ""}`,
+        actions: "/plan approve [模式|fresh] 批准 · /plan reject 放弃 · 直接输入修改意见",
+        notFound: "没有待审批的计划",
+        unavailable: "当前会话没有 Plan 能力",
+        invalidMode: (arg, usage) => `执行模式无效：${arg}（${usage}）`,
+        approved: (version, mode) => `已批准计划 v${version}，以 ${mode} 执行`,
+        rejected: (version) => `已放弃计划 v${version}（仍在 Plan 模式）`,
+    },
+    dialog: {
+        title: "计划待审批",
+        optionApprove: "批准并执行",
+        optionApproveFresh: "批准，在新上下文执行",
+        optionRevise: (ellipsis) => `继续修改${ellipsis}`,
+        optionReject: "放弃，退出 Plan 模式",
+        modeBack: (mode) => `回到进入前的模式（${mode}）`,
+        modeHeadingFresh: "在新上下文执行，执行模式",
+        modeHeading: "执行模式",
+        editing: (ellipsis) => `正在外部编辑器里编辑${ellipsis}`,
+        version: (version) => `计划 v${version}`,
+        stepCount: (n) => `${n} 步`,
+        edited: "已在编辑器里修改：批准时以修改后的计划执行",
+        moreSteps: (ellipsis, n) => `  ${ellipsis} 另 ${n} 步（/plan 查看全部）`,
+        feedbackCompact: "修改意见",
+        feedback: "修改意见（留在 Plan 模式，模型据此重写计划）",
+        hintMainCompact: (arrows, edit) => `${arrows} Enter${edit ? " · e 编辑" : ""} · Esc 留在 Plan`,
+        hintMain: (arrows, edit) => `${arrows} 选择 · Enter 确认${edit ? " · e 编辑计划" : ""} · Esc 留在 Plan`,
+        hintModeCompact: (arrows) => `${arrows} Enter · Esc 返回`,
+        hintMode: (arrows) => `${arrows} 选择 · Enter 确认 · Esc 返回`,
+        hintReviseCompact: (edit) => `Enter 发送${edit ? " · Ctrl+E 编辑器" : ""} · Esc 返回`,
+        hintRevise: (edit) => `Enter 发送${edit ? " · Ctrl+E 外部编辑器" : ""} · Esc 返回`,
+        hintEditing: "保存并关闭编辑器后回到这里",
+    },
+    flow: {
+        pending: (version) => `计划 v${version} 待审批：/plan 打开审批框`,
+        approved: (version, mode) => `已批准计划 v${version}，以 ${mode} 执行`,
+        approvedFresh: (version, sessionId, mode) => `已批准计划 v${version}，在新会话 ${sessionId} 以 ${mode} 执行`,
+        rejectedExit: (version, mode) => `已放弃计划 v${version}，回到 ${mode}`,
+        rejectedStay: (version) => `已放弃计划 v${version}（仍在 Plan 模式，/plan 查看）`,
+    },
+};

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

@@ -0,0 +1,86 @@
+/**
+ * 消息目录：print（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I3 迁入 `src/modes/{print,rpc,acp}/**`]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ * RPC / ACP 的 `error` / `message` 是人读文本，宿主按 `code` 判断（docs/rpc.md）；JSON 字段名不在这里。
+ */
+export declare const en: {
+    /** `ama -p` 的 stderr。 */
+    print: {
+        stdinIgnored: (wait: string) => string;
+        stdinWaiting: string;
+        seconds: (n: number) => string;
+        millis: (n: number) => string;
+        needsPrompt: string;
+        retry: (attempt: number, max: number, seconds: number, error: string) => string;
+        modelFailed: string;
+        planPending: (version: number, where: string) => string;
+        limitTurns: (limit: number) => string;
+        limitCost: (limit: string, spent: string) => string;
+        denied: (count: number, tools: readonly string[], reason: string) => string;
+    };
+    /** RPC 响应的 `error`（人读）。 */
+    rpc: {
+        unknownCommand: (type: string) => string;
+        parseFailed: (error: string) => string;
+        missingType: string;
+        unsupported: string;
+        noPlan: string;
+        badMode: (modes: readonly string[]) => string;
+    };
+    /** ACP 服务端（`ama --mode acp`）。 */
+    acp: {
+        missingParam: (key: string) => string;
+        promptNotArray: string;
+        unparsable: (reason: string) => string;
+        missingProtocolVersion: string;
+        fixedCwd: (cwd: string, got: string) => string;
+        sessionNotFound: (id: string, error: string) => string;
+        busy: string;
+        modelFailed: string;
+        unknownMode: (mode: string) => string;
+        allowOnce: string;
+        allowAlways: string;
+        rejectOnce: string;
+        truncated: (length: number) => string;
+    };
+};
+export declare const zh: {
+    print: {
+        stdinIgnored: (wait: string) => string;
+        stdinWaiting: string;
+        seconds: (n: number) => string;
+        millis: (n: number) => string;
+        needsPrompt: string;
+        retry: (attempt: number, max: number, seconds: number, error: string) => string;
+        modelFailed: string;
+        planPending: (version: number, where: string) => string;
+        limitTurns: (limit: number) => string;
+        limitCost: (limit: string, spent: string) => string;
+        denied: (count: number, tools: readonly string[], reason: string) => string;
+    };
+    rpc: {
+        unknownCommand: (type: string) => string;
+        parseFailed: (error: string) => string;
+        missingType: string;
+        unsupported: string;
+        noPlan: string;
+        badMode: (modes: readonly string[]) => string;
+    };
+    acp: {
+        missingParam: (key: string) => string;
+        promptNotArray: string;
+        unparsable: (reason: string) => string;
+        missingProtocolVersion: string;
+        fixedCwd: (cwd: string, got: string) => string;
+        sessionNotFound: (id: string, error: string) => string;
+        busy: string;
+        modelFailed: string;
+        unknownMode: (mode: string) => string;
+        allowOnce: string;
+        allowAlways: string;
+        rejectOnce: string;
+        truncated: (length: number) => string;
+    };
+};

package/dist/i18n/messages/print.js

@@ -0,0 +1,91 @@
+/**
+ * 消息目录：print（键名规范见 docs/i18n.md）。[W6-C0 建空壳，W6-I3 迁入 `src/modes/{print,rpc,acp}/**`]
+ *
+ * en 是形状源；zh 用 `satisfies Messages<typeof en>`，缺键 / 多键 / 参数不符在 tsc 期报错。
+ * 整句一个键、禁止片段拼接；插值写成函数，条件分支写进函数体。
+ * RPC / ACP 的 `error` / `message` 是人读文本，宿主按 `code` 判断（docs/rpc.md）；JSON 字段名不在这里。
+ */
+import { plural } from "../format.js";
+export const en = {
+    /** `ama -p` 的 stderr。 */
+    print: {
+        stdinIgnored: (wait) => `ama: no piped input within ${wait}, ignored; to wait for it, end the arguments with -\n`,
+        stdinWaiting: "ama: waiting for stdin to end (Ctrl+D ends it; the prompt can also be an argument)…\n",
+        seconds: (n) => plural(n, "second"),
+        millis: (n) => `${n} ms`,
+        needsPrompt: "ama: -p needs a prompt (positional argument or stdin pipe)\n",
+        retry: (attempt, max, seconds, error) => `ama: ↻ retry ${attempt}/${max} (in ${seconds}s): ${error}\n`,
+        modelFailed: "model call failed",
+        planPending: (version, where) => `ama: plan v${version} saved, awaiting approval (not executed): ${where}; -p does not approve on anyone's behalf — ` +
+            "approve it in the interactive UI or via RPC plan_response, or set plan.unattended: approve to let -p approve and continue",
+        limitTurns: (limit) => `ama: reached the turn limit ${limit} (--max-turns / limits.maxTurns); run ended before finishing`,
+        limitCost: (limit, spent) => `ama: reached the cost limit ${limit} (spent ${spent}; --max-cost / limits.maxCostUsd); run ended before finishing`,
+        denied: (count, tools, reason) => `ama: ${plural(count, "tool call")} denied: ${tools.join(", ")}${reason !== "" ? ` (${reason})` : ""}; ` +
+            "-p has no one to approve; to allow them use --permission-mode auto-edit|auto or --allow <rule>",
+    },
+    /** RPC 响应的 `error`（人读）。 */
+    rpc: {
+        unknownCommand: (type) => `unknown command: ${type}`,
+        parseFailed: (error) => `JSON parse failed: ${error}`,
+        missingType: "missing type",
+        unsupported: "this session does not support this command",
+        noPlan: "this session has no plan extension",
+        badMode: (modes) => `mode must be ${modes.join(" | ")}`,
+    },
+    /** ACP 服务端（`ama --mode acp`）。 */
+    acp: {
+        missingParam: (key) => `missing ${key}`,
+        promptNotArray: "prompt must be an array of content blocks",
+        unparsable: (reason) => `ACP: unparsable input (${reason})`,
+        missingProtocolVersion: "missing protocolVersion",
+        fixedCwd: (cwd, got) => `the session directory of ama --mode acp is fixed to the start directory ${cwd} (got ${got})`,
+        sessionNotFound: (id, error) => `session ${id} not found: ${error}`,
+        busy: "the current session is running; send session/cancel first",
+        modelFailed: "model request failed",
+        unknownMode: (mode) => `unknown mode: ${mode}`,
+        allowOnce: "Allow",
+        allowAlways: "Allow for this session",
+        rejectOnce: "Deny",
+        truncated: (length) => `…(truncated, ${plural(length, "character")} in total)`,
+    },
+};
+export const zh = {
+    print: {
+        stdinIgnored: (wait) => `ama: 未在 ${wait}内收到管道输入，已忽略；需要等待请在末尾加 -\n`,
+        stdinWaiting: "ama: 正在等待 stdin 输入结束（Ctrl+D 结束；提示也可以直接写成参数）…\n",
+        seconds: (n) => `${n} 秒`,
+        millis: (n) => `${n} 毫秒`,
+        needsPrompt: "ama: -p 需要提示（位置参数或 stdin 管道）\n",
+        retry: (attempt, max, seconds, error) => `ama: ↻ 重试 ${attempt}/${max}（${seconds}s 后）：${error}\n`,
+        modelFailed: "模型调用失败",
+        planPending: (version, where) => `ama: 计划 v${version} 已落盘、待审批（未执行）：${where}；-p 不替人批准——` +
+            "在交互界面或 RPC plan_response 里审批，或设 plan.unattended: approve 让 -p 批准后接着执行",
+        limitTurns: (limit) => `ama: 已达到回合上限 ${limit}（--max-turns / limits.maxTurns），运行在完成前结束`,
+        limitCost: (limit, spent) => `ama: 已达到费用上限 ${limit}（累计 ${spent}；--max-cost / limits.maxCostUsd），运行在完成前结束`,
+        denied: (count, tools, reason) => `ama: ${count} 次工具调用被拒：${tools.join("、")}${reason !== "" ? `（${reason}）` : ""}；` +
+            "-p 没有人审批，需要放行时用 --permission-mode auto-edit|auto 或 --allow <规则>",
+    },
+    rpc: {
+        unknownCommand: (type) => `未知命令：${type}`,
+        parseFailed: (error) => `JSON 解析失败：${error}`,
+        missingType: "缺少 type",
+        unsupported: "该会话不支持此命令",
+        noPlan: "该会话没有装配 plan 扩展",
+        badMode: (modes) => `mode 应为 ${modes.join(" | ")}`,
+    },
+    acp: {
+        missingParam: (key) => `缺少 ${key}`,
+        promptNotArray: "prompt 应为内容块数组",
+        unparsable: (reason) => `ACP：无法解析的输入（${reason}）`,
+        missingProtocolVersion: "缺少 protocolVersion",
+        fixedCwd: (cwd, got) => `ama --mode acp 的会话目录固定为启动目录 ${cwd}（收到 ${got}）`,
+        sessionNotFound: (id, error) => `找不到会话 ${id}：${error}`,
+        busy: "当前会话正在运行，先 session/cancel",
+        modelFailed: "模型请求失败",
+        unknownMode: (mode) => `未知模式：${mode}`,
+        allowOnce: "允许",
+        allowAlways: "本会话允许",
+        rejectOnce: "拒绝",
+        truncated: (length) => `…（已截断，共 ${length} 字符）`,
+    },
+};