@armadra/agent 0.5.1 → 0.6.0

package/dist/drivers/runner.js

@@ -17,6 +17,7 @@ import { AmaError } from "../errors.js";
 import { defaultSetTimer } from "./base.js";
 import { buildChildEnv } from "./env.js";
 import { askHuman, clampMode, supportedMode } from "./permissions.js";
+import { msg } from "../i18n/index.js";
 export const RUN_TIMEOUT_MS = 30 * 60 * 1000;
 export const IDLE_CLOSE_MS = 10 * 60 * 1000;
 function toUsage(turn) {
@@ -50,13 +51,13 @@ function statusOf(turn, timedOut, stopped) {
             return "failed";
     }
 }
-/** 最终报告：最终文本 + 工具摘要 / 触及文件（给协调者当资料，不是指令）。 */
+/** 最终报告：最终文本 + 工具摘要 / 触及文件（给协调者当资料，不是指令；[W6-C0] 标题固定英文）。 */
 export function reportText(turn) {
     const parts = [turn.finalText.trim()];
     if (turn.toolSummary.length > 0)
-        parts.push(`工具调用：\n${turn.toolSummary.map((l) => `- ${l}`).join("\n")}`);
+        parts.push(`Tool calls:\n${turn.toolSummary.map((l) => `- ${l}`).join("\n")}`);
     if (turn.filesTouched.length > 0)
-        parts.push(`修改的文件：\n${turn.filesTouched.map((f) => `- ${f}`).join("\n")}`);
+        parts.push(`Files changed:\n${turn.filesTouched.map((f) => `- ${f}`).join("\n")}`);
     return parts.filter((p) => p !== "").join("\n\n");
 }
 function failed(text, sessionId, runner) {
@@ -77,7 +78,7 @@ export class ProcessRunner {
         this.deps = deps;
         this.drivers = Array.isArray(driver) ? driver : [driver];
         if (this.drivers.length === 0)
-            throw new AmaError("invalid_arguments", "ProcessRunner 需要至少一个驱动");
+            throw new AmaError("invalid_arguments", "ProcessRunner needs at least one driver");
         this.id = deps.id ?? this.drivers[0].agentId;
     }
     get agentId() {
@@ -93,12 +94,12 @@ export class ProcessRunner {
         for (const driver of this.drivers) {
             const probe = await driver.probe();
             if (!probe.installed) {
-                reasons.push(`${driver.kind} 未安装`);
+                reasons.push(`${driver.kind} is not installed`);
                 continue;
             }
             const usable = supportedMode(mode, probe.capabilities.modes);
             if (usable === undefined) {
-                reasons.push(`${driver.kind} 不支持「${mode}」`);
+                reasons.push(`${driver.kind} does not support "${mode}"`);
                 continue;
             }
             const warning = probe.warning;
@@ -109,14 +110,14 @@ export class ProcessRunner {
                 ...(warning !== undefined ? { warning } : {}),
             };
         }
-        throw new AmaError("agent_unavailable", `外部 Agent ${this.id} 不可用（${reasons.join("；")}）`);
+        throw new AmaError("agent_unavailable", `external agent ${this.id} is unavailable (${reasons.join("; ")})`);
     }
     async start(request) {
         if (!this.deps.trusted(request.cwd))
-            throw new AmaError("agent_untrusted", `目录 ${request.cwd} 尚未被 ama 信任，不能在这里启动外部 Agent（它会执行项目里的 hooks 与配置）；先运行 ama trust`);
+            throw new AmaError("agent_untrusted", `${request.cwd} is not trusted by ama, so external agents cannot start here (they run the project's hooks and config); run ama trust there first`);
         const budget = this.deps.config?.sessionBudgetUsd;
         if (budget !== undefined && (this.deps.store?.totalUsd() ?? 0) >= budget)
-            throw new AmaError("budget_exhausted", `本会话外部 Agent 预算 $${budget} 已用尽`);
+            throw new AmaError("budget_exhausted", `external agent budget for this session ($${budget}) is used up`);
         const entry = agentEntry(this.deps.config, this.agentId);
         const mode = clampMode(request.mode, this.deps.parentMode?.(), entry?.maxMode);
         const chosen = await this.choose(mode);
@@ -141,13 +142,15 @@ class ProcessHandle {
     deps;
     session;
     sessionId = "";
-    chain = Promise.resolve(failed("尚未运行", "", ""));
+    chain = Promise.resolve(failed("not started", "", ""));
     busy = false;
     turns = 0;
     stopped = false;
     lifetime = new AbortController();
     clearIdle;
     agent;
+    /** [W6-C0] 本回合工具的骨架（id → 种类 / 状态 / 起止），回合结束写 `turn_trace`。 */
+    turnTools = new Map();
     constructor(runner, chosen, request, deps) {
         this.runner = runner;
         this.chosen = chosen;
@@ -165,7 +168,7 @@ class ProcessHandle {
             request.onEvent({
                 type: "notice",
                 level: "info",
-                text: `${this.agent} 以「${chosen.mode}」模式运行（请求的是「${request.mode}」，外部 Agent 不得比 ama 当前模式宽）`,
+                text: msg().drivers.agent.modeClamped(this.agent, chosen.mode, request.mode),
             });
     }
     get id() {
@@ -199,7 +202,7 @@ class ProcessHandle {
     }
     async send(text) {
         if (this.stopped)
-            throw new AmaError("agent_closed", `${this.agent} 已停止`);
+            throw new AmaError("agent_closed", `${this.agent} stopped`);
         if (this.busy && this.session?.steer !== undefined && this.chosen.capabilities.steer) {
             await this.session.steer([{ type: "text", text }]);
             return;
@@ -238,7 +241,18 @@ class ProcessHandle {
             case "thought_delta":
                 this.emit({ type: "thought", delta: event.text });
                 return;
-            case "tool_call":
+            case "tool_call": {
+                const at = this.now();
+                const skeleton = this.turnTools.get(event.id) ?? {
+                    kind: event.kind,
+                    status: "in_progress",
+                    startedAt: at,
+                };
+                if (event.status === "completed" || event.status === "failed") {
+                    skeleton.status = event.status;
+                    skeleton.endedAt = at;
+                }
+                this.turnTools.set(event.id, skeleton);
                 if (event.status === "pending")
                     return;
                 this.emit({
@@ -249,8 +263,11 @@ class ProcessHandle {
                         : event.status === "failed"
                             ? "failed"
                             : "completed",
+                    id: event.id,
+                    at,
                 });
                 return;
+            }
             case "notice":
                 this.emit({ type: "notice", level: event.level, text: event.text });
                 return;
@@ -265,7 +282,7 @@ class ProcessHandle {
                         this.emit({
                             type: "notice",
                             level: "warn",
-                            text: `${this.agent} 超出美元预算，已中断`,
+                            text: msg().drivers.agent.overBudget(this.agent),
                         });
                         cancel();
                     }
@@ -275,33 +292,61 @@ class ProcessHandle {
                 return;
         }
     }
+    now() {
+        return (this.deps.now ?? Date.now)();
+    }
+    /** [W6-C0] 回合骨架：只有种类、状态、时间与计数（不含工具标题、命令行、路径）。 */
+    emitTurnTrace(startedAt, stopReason, filesTouched) {
+        const tools = [...this.turnTools.values()];
+        this.turnTools = new Map();
+        this.emit({
+            type: "turn_trace",
+            trace: {
+                sessionId: this.sessionId,
+                turn: this.turns,
+                startedAt,
+                endedAt: this.now(),
+                stopReason,
+                tools,
+                toolCount: tools.length,
+                filesTouched,
+            },
+        });
+    }
     /** 关掉空闲进程后再续聊：能续接的以 resume 重开。 */
     async ensureSession() {
         if (this.session !== undefined)
             return this.session;
         if (this.chosen.capabilities.resume === "none" || this.sessionId === "")
-            throw new AmaError("agent_closed", `${this.agent} 会话已因空闲关闭且不支持续接`);
+            throw new AmaError("agent_closed", `${this.agent} session was closed while idle and cannot be resumed`);
         await this.open(this.sessionId);
         return this.session;
     }
     async runTurn(text) {
         if (this.stopped)
-            return failed(`${this.agent} 已停止`, this.sessionId, this.runner.id);
+            return failed(`${this.agent} stopped`, this.sessionId, this.runner.id);
         this.clearIdle?.();
         let release;
         const setTimer = this.deps.setTimer ?? defaultSetTimer;
         let timedOut = false;
+        let turnStartedAt;
         try {
             release = await this.deps.pool.acquire(this.agent, this.lifetime.signal);
             const session = this.session ?? (await this.ensureSession());
             this.busy = true;
             this.turns += 1;
+            turnStartedAt = this.now();
+            this.turnTools = new Map();
             this.emit({ type: "turn", turn: this.turns });
             const turnCost = { usd: 0 };
             const cancel = () => void session.cancel();
             const clearTimeout = setTimer(() => {
                 timedOut = true;
-                this.emit({ type: "notice", level: "warn", text: `${this.agent} 运行超时，已中断` });
+                this.emit({
+                    type: "notice",
+                    level: "warn",
+                    text: msg().drivers.agent.timedOut(this.agent),
+                });
                 cancel();
             }, this.deps.timeoutMs ?? RUN_TIMEOUT_MS);
             const onAbort = () => cancel();
@@ -344,10 +389,11 @@ class ProcessHandle {
                 this.emit({ type: "usage", usage, unit, amount });
             }
             const status = statusOf(turn, timedOut, this.stopped);
+            this.emitTurnTrace(turnStartedAt, timedOut ? "timeout" : turn.stopReason, turn.filesTouched.length);
             this.armIdle();
             return {
                 text: timedOut
-                    ? `${this.agent} 运行超时被中断。${turn.finalText !== "" ? `\n\n${reportText(turn)}` : ""}`
+                    ? `${this.agent} timed out and was interrupted.${turn.finalText !== "" ? `\n\n${reportText(turn)}` : ""}`
                     : reportText(turn),
                 usage,
                 stopReason: timedOut ? "timeout" : turn.stopReason,
@@ -357,12 +403,14 @@ class ProcessHandle {
             };
         }
         catch (error) {
+            if (turnStartedAt !== undefined)
+                this.emitTurnTrace(turnStartedAt, this.stopped ? "cancelled" : "error", 0);
             if (this.stopped)
                 return {
-                    ...failed(`${this.agent} 已停止`, this.sessionId, this.runner.id),
+                    ...failed(`${this.agent} stopped`, this.sessionId, this.runner.id),
                     status: "aborted",
                 };
-            return failed(`${this.agent} 失败：${error.message}`, this.sessionId, this.runner.id);
+            return failed(`${this.agent} failed: ${error.message}`, this.sessionId, this.runner.id);
         }
         finally {
             release?.();

package/dist/drivers/turn.js

@@ -78,7 +78,7 @@ export class TurnCollector {
         const summary = lines.length > TOOL_SUMMARY_LINES
             ? [
                 ...lines.slice(0, TOOL_SUMMARY_LINES - 1),
-                `… 另有 ${lines.length - TOOL_SUMMARY_LINES + 1} 次工具调用`,
+                `… ${lines.length - TOOL_SUMMARY_LINES + 1} more tool calls`,
             ]
             : lines;
         const result = {

package/dist/hooks/config.js

@@ -13,6 +13,7 @@ import { HOOKS_FILE, projectFile, userFile } from "../config/paths.js";
 import { HOOK_TIMEOUT_MAX_MS } from "../config/schema.js";
 import { checkMatcher } from "./matcher.js";
 import { HOOK_EVENTS } from "./types.js";
+import { msg } from "../i18n/index.js";
 export const DEFAULT_HOOK_TIMEOUT_MS = 60_000;
 export function clampTimeout(value, fallback) {
     const v = value ?? fallback;
@@ -53,7 +54,7 @@ function validateMatchers(file, config) {
         });
     }
     if (problems.length > 0) {
-        throw new StartupError("config_invalid", `配置文件无效：\n  ${problems.map((p) => `${file}: ${p}`).join("\n  ")}`, 3);
+        throw new StartupError("config_invalid", msg().drivers.hooks.configInvalid(problems.map((p) => `${file}: ${p}`).join("\n  ")), 3);
     }
 }
 function readLayer(source, file, required) {
@@ -84,7 +85,7 @@ export function loadHookConfigs(input) {
     else if (existsSync(projectPath)) {
         // 未信任时不解析内容（不让不可信文件的语法错误阻断启动），只看存在性。
         skippedProject = projectPath;
-        warnings.push(`${projectPath}: 项目未信任，跳过项目级 Hook（用 --trust 或在交互模式确认信任）`);
+        warnings.push(msg().drivers.hooks.projectUntrusted(projectPath));
     }
     const result = {
         hooks: flattenHookLayers(layers, input.defaultTimeoutMs ?? DEFAULT_HOOK_TIMEOUT_MS),

package/dist/hooks/protocol.js

@@ -6,6 +6,7 @@
  * 合并：决策最严 `deny > block > ask > allow`；`updatedInput` / `updatedPrompt` 只接受唯一
  * 一个返回者（多个则全部忽略并 warning）；`additionalContext` / `customInstructions` 按配置顺序拼接。
  */
+import { msg } from "../i18n/index.js";
 export const DECISION_SEVERITY = {
     deny: 4,
     block: 3,
@@ -60,7 +61,7 @@ export function parseHookOutput(stdout) {
             output.decision = decision;
         }
         else {
-            warnings.push(`未知 decision：${JSON.stringify(decision)}`);
+            warnings.push(msg().drivers.hooks.unknownDecision(JSON.stringify(decision)));
         }
     }
     for (const key of [
@@ -75,7 +76,7 @@ export function parseHookOutput(stdout) {
         if (typeof v === "string")
             output[key] = v;
         else
-            warnings.push(`${key} 应为字符串`);
+            warnings.push(msg().drivers.hooks.notString(key));
     }
     if ("updatedInput" in raw)
         output.updatedInput = raw["updatedInput"];
@@ -85,8 +86,9 @@ export function parseHookOutput(stdout) {
         output.suppressOutput = true;
     return { output, warnings };
 }
-function describe(result) {
-    return `Hook ${result.event}「${result.command}」`;
+/** [W6-C0] 回给模型的阻止理由固定英文（警告仍给人看）。 */
+function describeForModel(result) {
+    return `Hook ${result.event} "${result.command}"`;
 }
 function normalizeDecision(event, decision) {
     const accepted = ACCEPTED[event];
@@ -101,23 +103,27 @@ function normalizeDecision(event, decision) {
 export function interpretResult(result) {
     const event = result.event;
     if (result.timedOut) {
-        const message = `${describe(result)} 超时（${result.durationMs} ms）`;
+        const message = msg().drivers.hooks.timedOut(event, result.command, result.durationMs);
         if (event === "PreToolUse")
-            return { decision: "deny", reason: message, warning: message, useOutput: false };
+            return {
+                decision: "deny",
+                reason: `${describeForModel(result)} timed out (${result.durationMs} ms)`,
+                warning: message,
+                useOutput: false,
+            };
         return { warning: message, useOutput: false };
     }
     if (result.exitCode === 2) {
         const decision = blockingDecision(event);
-        const reason = result.stderr.trim() || `${describe(result)} 以退出码 2 阻止`;
+        const reason = result.stderr.trim() || `${describeForModel(result)} blocked with exit code 2`;
         if (decision === undefined)
             return { useOutput: false };
         return { decision, reason, useOutput: false };
     }
     if (result.exitCode !== 0) {
         const tail = result.stderr.trim().split("\n").slice(-3).join(" | ");
-        const code = result.exitCode === null ? "被信号终止" : `退出码 ${result.exitCode}`;
         return {
-            warning: `${describe(result)} 失败（${code}）${tail === "" ? "" : `：${tail}`}`,
+            warning: msg().drivers.hooks.failed(event, result.command, result.exitCode, tail),
             useOutput: false,
         };
     }
@@ -128,7 +134,7 @@ export function interpretResult(result) {
     if (decision === undefined) {
         return {
             useOutput: true,
-            warning: `${describe(result)} 的 decision "${output.decision}" 对 ${event} 无效，已忽略`,
+            warning: msg().drivers.hooks.invalidDecision(event, result.command, output.decision),
         };
     }
     const interpreted = { decision, useOutput: true };
@@ -200,12 +206,12 @@ export function mergeResults(results, extraWarnings = []) {
         outcome.hasUpdatedInput = true;
     }
     else if (inputs.length > 1) {
-        warnings.push(`${inputs.length} 个 Hook 同时返回 updatedInput，全部忽略`);
+        warnings.push(msg().drivers.hooks.multipleInputs(inputs.length));
     }
     if (prompts.length === 1 && prompts[0] !== undefined)
         outcome.updatedPrompt = prompts[0];
     else if (prompts.length > 1)
-        warnings.push(`${prompts.length} 个 Hook 同时返回 updatedPrompt，全部忽略`);
+        warnings.push(msg().drivers.hooks.multiplePrompts(prompts.length));
     const additionalContext = joinTexts(contexts);
     if (additionalContext !== undefined)
         outcome.additionalContext = additionalContext;

package/dist/host/api-impl.js

@@ -14,6 +14,7 @@ import { HostRunnerRegistry } from "../drivers/host-runners.js";
 import { AmaError } from "../errors.js";
 import { AMA_VERSION } from "../version.js";
 import { HOST_API_VERSION } from "./types.js";
+import { msg } from "../i18n/index.js";
 /** 进程内事件总线（宿主观察 AgentEvents）。 */
 export class AgentEventBus {
     handlers = new Map();
@@ -42,7 +43,7 @@ export class AgentEventBus {
                 await handler(event);
             }
             catch (error) {
-                this.log("error", `宿主事件处理器异常（${name}）`, error);
+                this.log("error", msg().drivers.host.handlerFailed(name), error);
             }
         }
     }
@@ -55,16 +56,16 @@ export function hostRunnersOf(api) {
 }
 function validateTool(tool) {
     if (typeof tool !== "object" || tool === null) {
-        throw new AmaError("invalid_arguments", "tools.register：工具定义应为对象");
+        throw new AmaError("invalid_arguments", msg().drivers.host.toolNotObject);
     }
     if (typeof tool.name !== "string" || !TOOL_NAME.test(tool.name)) {
-        throw new AmaError("invalid_arguments", `tools.register：工具名不合法：${String(tool.name)}`);
+        throw new AmaError("invalid_arguments", msg().drivers.host.toolBadName(String(tool.name)));
     }
     if (typeof tool.execute !== "function") {
-        throw new AmaError("invalid_arguments", `tools.register：${tool.name} 缺少 execute()`);
+        throw new AmaError("invalid_arguments", msg().drivers.host.toolNoExecute(tool.name));
     }
     if (!["read", "write", "execute"].includes(tool.permission)) {
-        throw new AmaError("invalid_arguments", `tools.register：${tool.name} 的 permission 不合法`);
+        throw new AmaError("invalid_arguments", msg().drivers.host.toolBadPermission(tool.name));
     }
 }
 export function createHostApi(deps) {
@@ -97,7 +98,7 @@ export function createHostApi(deps) {
             register(tool) {
                 validateTool(tool);
                 if (deps.tools.get(tool.name) !== undefined) {
-                    throw new AmaError("tool_exists", `tools.register：工具 ${tool.name} 已存在`);
+                    throw new AmaError("tool_exists", msg().drivers.host.toolExists(tool.name));
                 }
                 deps.tools.register(tool, "host");
                 registeredTools.push(tool.name);
@@ -112,10 +113,10 @@ export function createHostApi(deps) {
         instructions: Object.freeze({
             add(source) {
                 if (source.kind === "file" && typeof source.path !== "string") {
-                    throw new AmaError("invalid_arguments", "instructions.add：file 需要 path");
+                    throw new AmaError("invalid_arguments", msg().drivers.host.instructionNeedsPath);
                 }
                 if (source.kind === "text" && typeof source.text !== "string") {
-                    throw new AmaError("invalid_arguments", "instructions.add：text 需要 text");
+                    throw new AmaError("invalid_arguments", msg().drivers.host.instructionNeedsText);
                 }
                 instructions.push({ ...source });
             },
@@ -126,7 +127,7 @@ export function createHostApi(deps) {
         approvals: Object.freeze({
             setBroker(next) {
                 if (typeof next?.ask !== "function") {
-                    throw new AmaError("invalid_arguments", "approvals.setBroker：broker 需要 ask()");
+                    throw new AmaError("invalid_arguments", msg().drivers.host.brokerNeedsAsk);
                 }
                 broker = next;
             },
@@ -155,7 +156,7 @@ export function createHostApi(deps) {
         cache: Object.freeze({
             onWarmingDecision(handler) {
                 if (typeof handler !== "function") {
-                    throw new AmaError("invalid_arguments", "cache.onWarmingDecision：需要函数");
+                    throw new AmaError("invalid_arguments", msg().drivers.host.warmingNeedsFunction);
                 }
                 warmingHandlers.push(handler);
                 return () => {

package/dist/host/loader.js

@@ -15,6 +15,7 @@ import { isAbsolute, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { StartupError } from "../errors.js";
 import { HOST_API_VERSION } from "./types.js";
+import { msg } from "../i18n/index.js";
 const EXIT_HOST = 6;
 const EXIT_HOST_VERSION = 78;
 export const HOST_CREATE_TIMEOUT_MS = 10_000;
@@ -66,25 +67,25 @@ export function extractHostModule(namespace, label) {
     }
     const found = candidates.find((c) => isRecord(c) && ("hostApi" in c || "create" in c));
     if (!isRecord(found))
-        throw loadFailure(`${label}: 不是宿主适配器模块（缺少 hostApi / create 导出）`);
+        throw loadFailure(msg().drivers.host.notAdapter(label));
     if (found["hostApi"] !== HOST_API_VERSION) {
-        throw new StartupError("host_version_mismatch", `${label}: 宿主适配器 hostApi=${String(found["hostApi"])}，ama 需要 ${HOST_API_VERSION}`, EXIT_HOST_VERSION);
+        throw new StartupError("host_version_mismatch", msg().drivers.host.versionMismatch(label, String(found["hostApi"]), HOST_API_VERSION), EXIT_HOST_VERSION);
     }
     if (typeof found["create"] !== "function")
-        throw loadFailure(`${label}: 缺少 create(api) 函数`);
+        throw loadFailure(msg().drivers.host.noCreate(label));
     return found;
 }
 /** 加载并校验适配器模块。 */
 export async function loadHostModule(spec, cwd = process.cwd()) {
     const path = isAbsolute(spec) ? spec : resolve(cwd, spec);
     if (!existsSync(path))
-        throw loadFailure(`宿主适配器不存在：${path}`);
+        throw loadFailure(msg().drivers.host.notFound(path));
     let namespace;
     try {
         namespace = await importModule(path);
     }
     catch (error) {
-        throw loadFailure(`宿主适配器加载失败：${path}：${errorText(error)}`, error);
+        throw loadFailure(msg().drivers.host.loadFailed(path, errorText(error)), error);
     }
     return extractHostModule(namespace, path);
 }
@@ -92,7 +93,7 @@ export async function loadHostModule(spec, cwd = process.cwd()) {
 export async function createAdapter(module, api, label, timeoutMs = HOST_CREATE_TIMEOUT_MS) {
     let timer;
     const timeout = new Promise((_, reject) => {
-        timer = setTimeout(() => reject(loadFailure(`${label}: create() 超过 ${timeoutMs} ms 未返回`)), timeoutMs);
+        timer = setTimeout(() => reject(loadFailure(msg().drivers.host.createTimeout(label, timeoutMs))), timeoutMs);
     });
     let adapter;
     try {
@@ -101,7 +102,7 @@ export async function createAdapter(module, api, label, timeoutMs = HOST_CREATE_
     catch (error) {
         if (error instanceof StartupError)
             throw error;
-        throw loadFailure(`${label}: create() 失败：${errorText(error)}`, error);
+        throw loadFailure(msg().drivers.host.createFailed(label, errorText(error)), error);
     }
     finally {
         clearTimeout(timer);
@@ -109,7 +110,7 @@ export async function createAdapter(module, api, label, timeoutMs = HOST_CREATE_
     if (adapter === undefined || adapter === null)
         return undefined;
     if (typeof adapter !== "object" || typeof adapter.id !== "string" || adapter.id === "") {
-        throw loadFailure(`${label}: create() 返回的适配器缺少 id`);
+        throw loadFailure(msg().drivers.host.noId(label));
     }
     return adapter;
 }

package/dist/host/types.d.ts

@@ -19,6 +19,7 @@ import type { CacheMiss, WarmingDecisionHandler } from "../ai/cache/types.js";
 import type { HookEvent } from "../hooks/types.js";
 import type { ApprovalBroker, ApprovalDecision } from "../permissions/types.js";
 import type { SubagentRunner, ToolDefinition } from "../tools/types.js";
+import type { QuotaUpdateEvent } from "../agent/types-w6.js";
 import type { PlanProposedEvent, PlanResolvedEvent, SubagentEndEvent, SubagentStartEvent } from "../agent/types-w5.js";
 export type { ActionPreview, ActionPreviewTarget, ApprovalBroker, ApprovalDecision, ApprovalReason, ApprovalRequest, ApprovalRequestContext, } from "../permissions/types.js";
 export type { RunnerHandle, SubagentEvent, SubagentRunRequest, SubagentRunner, ToolAnnotations, ToolContext, ToolDefinition, ToolExecutionMode, ToolPermission, ToolResult, } from "../tools/types.js";
@@ -115,6 +116,8 @@ export interface AgentEvents {
     /** [W5-C0] 计划提出 / 审批结果。 */
     plan_proposed: Omit<PlanProposedEvent, "type">;
     plan_resolved: Omit<PlanResolvedEvent, "type">;
+    /** [W6-O] ChatGPT 订阅配额更新（docs/wave6-plan.md §4.5）。 */
+    quota_update: Omit<QuotaUpdateEvent, "type">;
 }
 /** [W5-C0] 宿主注入的 runner：`id` 即 `task(agent=<id>)` 的名字，`description` 进 task 工具描述。 */
 export type HostRunner = SubagentRunner & {