@armadra/agent 0.10.0 → 0.12.0

package/dist/drivers/host-runners.js

@@ -4,12 +4,41 @@
  * 一个宿主适配器一份（host/api-impl.ts 建，经 {@link ExternalAgents} 的 `hostRunners` 选项交给每个
  * 主会话）：宿主可以在 `create()` 里或之后任何时候 `provide`，同名替换；返回的函数注销。
  * `onChange` 供 `/agents` / RPC `get_agents` 的缓存刷新。
+ *
+ * [#226] `onDone`（`HostApi.runners.onDone`）：任务入口经 {@link HostRunnerRegistry.resolve} 拿到的是
+ * 观察包装——句柄的每一轮（`start` 之后、每次 `send` / `interrupt` / `message` 之后）在 `wait()` 落定时
+ * 发一次 {@link RunnerDoneEvent}。包装只观察：`wait()` 的结果与异常原样返回，其余成员原样转给宿主句柄；
+ * 同一轮里多次 `wait()` 只发一次，落定后没有新一轮的 `wait()` 不再发。
  */
 import { AmaError } from "../errors.js";
 import { msg } from "../i18n/index.js";
+const TERMINAL = [
+    "completed",
+    "failed",
+    "aborted",
+    "max_turns",
+    "interrupted",
+];
+/** 与任务注册表的终态判定一致：中断优先，其次结果自报的终态，再按 `isError`。 */
+function statusOf(result, aborted) {
+    if (aborted)
+        return "aborted";
+    const own = result.status;
+    if (own !== undefined && TERMINAL.includes(own))
+        return own;
+    return result.isError ? "failed" : "completed";
+}
 export class HostRunnerRegistry {
     runners = new Map();
     listeners = new Set();
+    doneHandlers = new Set();
+    observed = new WeakMap();
+    now;
+    log;
+    constructor(options = {}) {
+        this.now = options.now ?? Date.now;
+        this.log = options.log ?? (() => undefined);
+    }
     provide(runner) {
         if (typeof runner?.id !== "string" || runner.id === "" || typeof runner.start !== "function")
             throw new AmaError("invalid_arguments", msg().drivers.host.runnerNeedsIdStart);
@@ -25,6 +54,18 @@ export class HostRunnerRegistry {
     get(id) {
         return this.runners.get(id);
     }
+    /** [#226] 任务入口用：同 {@link get}，但返回发 `onDone` 的观察包装（同一 runner 包装复用）。 */
+    resolve(id) {
+        const runner = this.runners.get(id);
+        if (runner === undefined)
+            return undefined;
+        let wrapped = this.observed.get(runner);
+        if (wrapped === undefined) {
+            wrapped = this.observe(runner);
+            this.observed.set(runner, wrapped);
+        }
+        return wrapped;
+    }
     list() {
         return [...this.runners.values()];
     }
@@ -33,6 +74,13 @@ export class HostRunnerRegistry {
         this.listeners.add(listener);
         return () => void this.listeners.delete(listener);
     }
+    /** [#226] 每轮结束时回调（`HostApi.runners.onDone`）；返回注销函数。 */
+    onDone(handler) {
+        if (typeof handler !== "function")
+            throw new AmaError("invalid_arguments", msg().drivers.host.runnerDoneNeedsFunction);
+        this.doneHandlers.add(handler);
+        return () => void this.doneHandlers.delete(handler);
+    }
     changed() {
         for (const listener of [...this.listeners]) {
             try {
@@ -43,4 +91,103 @@ export class HostRunnerRegistry {
             }
         }
     }
+    emitDone(event) {
+        for (const handler of [...this.doneHandlers]) {
+            try {
+                const out = handler(event);
+                if (out instanceof Promise)
+                    out.catch((error) => this.fail(error));
+            }
+            catch (error) {
+                this.fail(error);
+            }
+        }
+    }
+    fail(error) {
+        this.log(msg().drivers.host.handlerFailed("runners.onDone"), error);
+    }
+    observe(runner) {
+        return new Proxy(runner, {
+            get: (target, prop) => {
+                if (prop !== "start")
+                    return forward(target, prop);
+                return async (request) => this.observeHandle(target.id, request, this.now(), await target.start(request));
+            },
+        });
+    }
+    observeHandle(runner, request, startedAt, handle) {
+        let round = 0;
+        let fresh = true;
+        let pending = false;
+        let stopped = false;
+        let roundStart = startedAt;
+        const activity = () => {
+            if (pending)
+                return;
+            fresh = true;
+            roundStart = this.now();
+        };
+        const settle = (at, done) => {
+            pending = false;
+            const endedAt = this.now();
+            const event = {
+                runner,
+                sessionId: handle.id,
+                round,
+                status: done.status,
+                isError: done.status === "failed" || done.status === "aborted",
+                startedAt: at,
+                endedAt,
+                durationMs: Math.max(0, endedAt - at),
+            };
+            if (request.taskId !== undefined)
+                event.taskId = request.taskId;
+            if (done.text !== undefined)
+                event.text = done.text;
+            if (done.error !== undefined)
+                event.error = done.error;
+            this.emitDone(event);
+        };
+        const wait = () => {
+            const result = handle.wait();
+            if (!fresh)
+                return result;
+            fresh = false;
+            pending = true;
+            stopped = false;
+            round += 1;
+            const at = roundStart;
+            const aborted = () => stopped || request.signal.aborted;
+            result.then((value) => settle(at, { status: statusOf(value, aborted()), text: value.text }), (error) => settle(at, {
+                status: aborted() ? "aborted" : "failed",
+                error: error instanceof Error ? error.message : String(error),
+            }));
+            return result;
+        };
+        return new Proxy(handle, {
+            get: (target, prop) => {
+                const value = forward(target, prop);
+                if (prop === "wait")
+                    return wait;
+                if (prop === "stop" && typeof value === "function")
+                    return (...args) => {
+                        if (pending)
+                            stopped = true;
+                        return value(...args);
+                    };
+                if ((prop === "send" || prop === "interrupt" || prop === "message") &&
+                    typeof value === "function")
+                    return (...args) => {
+                        activity();
+                        return value(...args);
+                    };
+                return value;
+            },
+        });
+    }
+}
+/** 原样读宿主对象的成员：getter 以原对象为 this，方法绑定到原对象。 */
+function forward(target, prop) {
+    const value = Reflect.get(target, prop, target);
+    return typeof value === "function" ? value.bind(target) : value;
 }

package/dist/hooks/matcher.d.ts

@@ -3,8 +3,8 @@
  *
  * 语法：缺省 / 空串 / `*` 匹配全部；`bash` 精确；`write|edit` 多选；`canvas_*` glob；
  * `bash(git push*)` 先匹配工具名，再对参数文本做 glob；`/regex/flags` 对工具名做正则。
- * 括号内的文本：bash → `input.command`；文件类工具 → `input.path`（或 `file_path`）；
- * 其它工具 → 输入 JSON 文本。`|` 只在括号外分隔候选。只在 Pre/PostToolUse 生效。
+ * 括号内的文本：bash → `input.command`；文件类工具 → `input.path`（或 `file_path` / `pattern`）；
+ * web_fetch → `input.url`（整个 URL，与权限规则的 `host/path` 语义不同）；其它工具 → 输入 JSON 文本。`|` 只在括号外分隔候选。只在 Pre/PostToolUse 生效。
  */
 export type ToolMatcher = (toolName: string, input: unknown) => boolean;
 /** glob → 正则：`*` 任意字符串（含 `/`），`?` 单个字符，其余字面量。 */

package/dist/hooks/matcher.js

@@ -3,8 +3,8 @@
  *
  * 语法：缺省 / 空串 / `*` 匹配全部；`bash` 精确；`write|edit` 多选；`canvas_*` glob；
  * `bash(git push*)` 先匹配工具名，再对参数文本做 glob；`/regex/flags` 对工具名做正则。
- * 括号内的文本：bash → `input.command`；文件类工具 → `input.path`（或 `file_path`）；
- * 其它工具 → 输入 JSON 文本。`|` 只在括号外分隔候选。只在 Pre/PostToolUse 生效。
+ * 括号内的文本：bash → `input.command`；文件类工具 → `input.path`（或 `file_path` / `pattern`）；
+ * web_fetch → `input.url`（整个 URL，与权限规则的 `host/path` 语义不同）；其它工具 → 输入 JSON 文本。`|` 只在括号外分隔候选。只在 Pre/PostToolUse 生效。
  */
 /** glob → 正则：`*` 任意字符串（含 `/`），`?` 单个字符，其余字面量。 */
 export function globToRegExp(glob) {
@@ -46,7 +46,7 @@ export function argumentText(toolName, input) {
         const record = input;
         if (toolName === "bash" && typeof record["command"] === "string")
             return record["command"];
-        for (const key of ["path", "file_path", "pattern"]) {
+        for (const key of ["path", "file_path", "pattern", "url"]) {
             const value = record[key];
             if (typeof value === "string")
                 return value;

package/dist/host/api-impl.d.ts

@@ -9,6 +9,9 @@
  * [W5-EG] `runners.provide`（docs/history/wave5-plan.md §5.5，D17）：宿主注入的 runner 进本适配器的
  * {@link HostRunnerRegistry}（跨会话共享），每个主会话的外部 Agent 入口（agents/external.ts）经
  * {@link hostRunnersOf} 取到它；有宿主时 ama 不自 spawn 外部 CLI，只认这里注入的。
+ *
+ * [#226] `runners.onDone` 与 `minor`（host-api 1.1）：每轮结束的事件由 registry 的观察包装发出，
+ * 处理器异常走本适配器的 `log`。
  */
 import { HostRunnerRegistry } from "../drivers/host-runners.js";
 import type { AgentEventName, AgentEvents, ApprovalBroker, HostAdapter, HostAdapterHandle, HostApi, HostMode, InstructionSource } from "./types.js";

package/dist/host/api-impl.js

@@ -9,11 +9,14 @@
  * [W5-EG] `runners.provide`（docs/history/wave5-plan.md §5.5，D17）：宿主注入的 runner 进本适配器的
  * {@link HostRunnerRegistry}（跨会话共享），每个主会话的外部 Agent 入口（agents/external.ts）经
  * {@link hostRunnersOf} 取到它；有宿主时 ama 不自 spawn 外部 CLI，只认这里注入的。
+ *
+ * [#226] `runners.onDone` 与 `minor`（host-api 1.1）：每轮结束的事件由 registry 的观察包装发出，
+ * 处理器异常走本适配器的 `log`。
  */
 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 { HOST_API_MINOR, HOST_API_VERSION } from "./types.js";
 import { msg } from "../i18n/index.js";
 /** 进程内事件总线（宿主观察 AgentEvents）。 */
 export class AgentEventBus {
@@ -76,15 +79,16 @@ export function createHostApi(deps) {
     let broker;
     const warmingHandlers = [];
     let notify = deps.notify;
-    const runners = new HostRunnerRegistry();
     const writeErr = deps.stderr ?? ((text) => void process.stderr.write(text));
     const log = deps.log ??
         ((level, message) => {
             if (level === "warn" || level === "error")
                 writeErr(`ama: [host] ${message}\n`);
         });
+    const runners = new HostRunnerRegistry({ log: (message, error) => log("error", message, error) });
     const api = Object.freeze({
         version: HOST_API_VERSION,
+        minor: HOST_API_MINOR,
         agent: Object.freeze({ name: "ama", version: AMA_VERSION }),
         env: Object.freeze({ ...(deps.env ?? process.env) }),
         mode: deps.mode,
@@ -168,6 +172,7 @@ export function createHostApi(deps) {
         }),
         runners: Object.freeze({
             provide: (runner) => runners.provide(runner),
+            onDone: (handler) => runners.onDone(handler),
         }),
     });
     hostRunnerRegistries.set(api, runners);

package/dist/host/types.d.ts

@@ -14,11 +14,14 @@
  *   以 `task(agent=…)` 入口出现；有宿主时内置外部 runner 一律不可用，实现归 W5-E / W5-G）；
  *   `AgentEvents` 加 `subagent_start / subagent_end / plan_proposed / plan_resolved`。
  *   HOST_API_VERSION 不变。
+ * - （#226）host-api 1.1：可选面 `HostApi.runners.onDone`（宿主 runner 每轮结束的 {@link RunnerDoneEvent}）
+ *   与 `HostApi.minor`。主版本 `HOST_API_VERSION` 要求宿主严格相等，只在破坏性变化时改；只加不改的
+ *   增量递增 {@link HOST_API_MINOR}，宿主按成员是否存在做特性探测。
  */
 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 { SubagentRunner, SubagentStatus, 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";
@@ -27,6 +30,8 @@ export type { JsonSchema } from "../ai/types.js";
 export type { CacheMiss, WarmDecision, WarmingDecisionHandler } from "../ai/cache/types.js";
 export declare const HOST_API_VERSION: 1;
 export type HostApiVersion = typeof HOST_API_VERSION;
+/** host-api 小版本：只加不改的可选面每加一批递增（1 = `runners.onDone`）；旧运行时没有 `api.minor`，按 0 算。 */
+export declare const HOST_API_MINOR: 1;
 export type HostMode = "interactive" | "line" | "print" | "rpc";
 export type InstructionSource = {
     kind: "file";
@@ -123,9 +128,35 @@ export interface AgentEvents {
 export type HostRunner = SubagentRunner & {
     readonly description: string;
 };
+/**
+ * [#226] 宿主 runner 的一轮结束（`runners.onDone`）：`start()` 之后第一轮、每次续聊（`send` / `interrupt`）
+ * 之后的下一轮各一次。`wait()` 返回时带 `text`，抛错时带 `error`；中断（任务的 signal abort 或 `stop()`）
+ * 时 `status` 为 `aborted`。时间都是 epoch 毫秒。
+ */
+export interface RunnerDoneEvent {
+    /** 宿主 runner 的 id（即 `task(agent=<id>)`）。 */
+    runner: string;
+    /** ama 的任务 id（`SubagentRunRequest.taskId`）；直接调用 runner 时缺省。 */
+    taskId?: string;
+    /** runner 自己的会话 id（`RunnerHandle.id`）。 */
+    sessionId: string;
+    /** 第几轮，从 1 起。 */
+    round: number;
+    status: SubagentStatus;
+    isError: boolean;
+    /** `wait()` 返回的结果文本。 */
+    text?: string;
+    /** `wait()` 抛出的错误信息。 */
+    error?: string;
+    startedAt: number;
+    endedAt: number;
+    durationMs: number;
+}
 export type AgentEventName = keyof AgentEvents;
 export interface HostApi {
     readonly version: HostApiVersion;
+    /** [#226] host-api 小版本（{@link HOST_API_MINOR}）；旧版本运行时没有它，按 0 算。 */
+    readonly minor?: number;
     readonly agent: {
         readonly name: "ama";
         readonly version: string;
@@ -181,6 +212,11 @@ export interface HostApi {
      */
     readonly runners?: {
         provide(runner: HostRunner): () => void;
+        /**
+         * [#226] 宿主 runner 每轮结束时调用（只观察：抛错只记日志，不影响 `wait()` 的结果）；返回值用于注销。
+         * 可选面（host-api 1.1）：旧版本运行时没有它，用前判断 `typeof api.runners?.onDone === "function"`。
+         */
+        onDone?(handler: (event: RunnerDoneEvent) => void | Promise<void>): () => void;
     };
 }
 /** Runtime 持有的已激活适配器。 */

package/dist/host/types.js

@@ -14,5 +14,10 @@
  *   以 `task(agent=…)` 入口出现；有宿主时内置外部 runner 一律不可用，实现归 W5-E / W5-G）；
  *   `AgentEvents` 加 `subagent_start / subagent_end / plan_proposed / plan_resolved`。
  *   HOST_API_VERSION 不变。
+ * - （#226）host-api 1.1：可选面 `HostApi.runners.onDone`（宿主 runner 每轮结束的 {@link RunnerDoneEvent}）
+ *   与 `HostApi.minor`。主版本 `HOST_API_VERSION` 要求宿主严格相等，只在破坏性变化时改；只加不改的
+ *   增量递增 {@link HOST_API_MINOR}，宿主按成员是否存在做特性探测。
  */
 export const HOST_API_VERSION = 1;
+/** host-api 小版本：只加不改的可选面每加一批递增（1 = `runners.onDone`）；旧运行时没有 `api.minor`，按 0 算。 */
+export const HOST_API_MINOR = 1;

package/dist/host.d.ts

@@ -1,5 +1,5 @@
 /**
  * `@armadra/agent/host` 子路径：宿主适配器类型 + HOST_API_VERSION（设计 §6.2、D7）。[B0] 所有。
  */
-export { HOST_API_VERSION } from "./host/types.js";
+export { HOST_API_MINOR, HOST_API_VERSION } from "./host/types.js";
 export type * from "./host/types.js";

package/dist/host.js

@@ -1,4 +1,4 @@
 /**
  * `@armadra/agent/host` 子路径：宿主适配器类型 + HOST_API_VERSION（设计 §6.2、D7）。[B0] 所有。
  */
-export { HOST_API_VERSION } from "./host/types.js";
+export { HOST_API_MINOR, HOST_API_VERSION } from "./host/types.js";

package/dist/i18n/catalog.d.ts

@@ -642,6 +642,8 @@ declare const en: {
                 codemode: (calls: number, lines: number) => string;
                 done: string;
                 outputLines: (n: number) => string;
+                fetched: (title: string | undefined, size: string, format: string) => string;
+                fetchRedirect: (url: string) => string;
                 awaiting: (glyph: string) => string;
                 subagentRunning: (elapsed: string) => string;
                 running: (elapsed: string) => string;
@@ -741,6 +743,7 @@ declare const en: {
         option: {
             allow: string;
             allowSession: string;
+            allowSessionHost: (host: string) => string;
             deny: string;
         };
         hint: (arrows: string) => string;
@@ -748,6 +751,7 @@ declare const en: {
         outcome: {
             allow: (what: string) => string;
             allowSession: (what: string) => string;
+            allowSessionHost: (what: string, host: string) => string;
             deny: (what: string) => string;
             cancelled: (what: string) => string;
         };
@@ -1645,6 +1649,7 @@ declare const en: {
             brokerNeedsAsk: string;
             warmingNeedsFunction: string;
             runnerNeedsIdStart: string;
+            runnerDoneNeedsFunction: string;
             notAdapter: (label: string) => string;
             versionMismatch: (label: string, found: string, needed: number) => string;
             noCreate: (label: string) => string;

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

@@ -40,6 +40,8 @@ export declare const en: {
     option: {
         allow: string;
         allowSession: string;
+        /** web_fetch：本会话记住的是主机。 */
+        allowSessionHost: (host: string) => string;
         deny: string;
     };
     hint: (arrows: string) => string;
@@ -48,6 +50,7 @@ export declare const en: {
     outcome: {
         allow: (what: string) => string;
         allowSession: (what: string) => string;
+        allowSessionHost: (what: string, host: string) => string;
         deny: (what: string) => string;
         cancelled: (what: string) => string;
     };
@@ -85,6 +88,7 @@ export declare const zh: {
     option: {
         allow: string;
         allowSession: string;
+        allowSessionHost: (host: string) => string;
         deny: string;
     };
     hint: (arrows: string) => string;
@@ -92,6 +96,7 @@ export declare const zh: {
     outcome: {
         allow: (what: string) => string;
         allowSession: (what: string) => string;
+        allowSessionHost: (what: string, host: string) => string;
         deny: (what: string) => string;
         cancelled: (what: string) => string;
     };

package/dist/i18n/messages/approval.js

@@ -41,6 +41,8 @@ export const en = {
     option: {
         allow: "Allow",
         allowSession: "Allow for this session",
+        /** web_fetch：本会话记住的是主机。 */
+        allowSessionHost: (host) => `Allow ${host} for this session`,
         deny: "Deny",
     },
     hint: (arrows) => `${arrows} select · Enter confirm · v full input`,
@@ -49,6 +51,7 @@ export const en = {
     outcome: {
         allow: (what) => `Allowed ${what}`,
         allowSession: (what) => `Allowed ${what} (similar calls won't ask again this session)`,
+        allowSessionHost: (what, host) => `Allowed ${what} (${host} won't ask again this session)`,
         deny: (what) => `Denied ${what}`,
         cancelled: (what) => `Approval cancelled (timeout or interrupt): ${what}`,
     },
@@ -86,6 +89,7 @@ export const zh = {
     option: {
         allow: "允许",
         allowSession: "本会话允许同类",
+        allowSessionHost: (host) => `本会话允许 ${host}`,
         deny: "拒绝",
     },
     hint: (arrows) => `${arrows} 选择 · Enter 确认 · v 完整输入`,
@@ -93,6 +97,7 @@ export const zh = {
     outcome: {
         allow: (what) => `已允许 ${what}`,
         allowSession: (what) => `已允许 ${what}（本会话同类不再询问）`,
+        allowSessionHost: (what, host) => `已允许 ${what}（本会话 ${host} 不再询问）`,
         deny: (what) => `已拒绝 ${what}`,
         cancelled: (what) => `审批已取消（超时或中断）：${what}`,
     },

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

@@ -57,6 +57,7 @@ export declare const en: {
         brokerNeedsAsk: string;
         warmingNeedsFunction: string;
         runnerNeedsIdStart: string;
+        runnerDoneNeedsFunction: string;
         notAdapter: (label: string) => string;
         versionMismatch: (label: string, found: string, needed: number) => string;
         noCreate: (label: string) => string;
@@ -115,6 +116,7 @@ export declare const zh: {
         brokerNeedsAsk: string;
         warmingNeedsFunction: string;
         runnerNeedsIdStart: string;
+        runnerDoneNeedsFunction: string;
         notAdapter: (label: string) => string;
         versionMismatch: (label: string, found: string, needed: number) => string;
         noCreate: (label: string) => string;

package/dist/i18n/messages/drivers.js

@@ -58,6 +58,7 @@ export const en = {
         brokerNeedsAsk: "approvals.setBroker: broker needs ask()",
         warmingNeedsFunction: "cache.onWarmingDecision: needs a function",
         runnerNeedsIdStart: "runners.provide: needs a runner with id and start",
+        runnerDoneNeedsFunction: "runners.onDone: needs a function",
         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`,
@@ -116,6 +117,7 @@ export const zh = {
         brokerNeedsAsk: "approvals.setBroker：broker 需要 ask()",
         warmingNeedsFunction: "cache.onWarmingDecision：需要函数",
         runnerNeedsIdStart: "runners.provide：需要带 id 与 start 的 runner",
+        runnerDoneNeedsFunction: "runners.onDone：需要函数",
         notAdapter: (label) => `${label}: 不是宿主适配器模块（缺少 hostApi / create 导出）`,
         versionMismatch: (label, found, needed) => `${label}: 宿主适配器 hostApi=${found}，ama 需要 ${needed}`,
         noCreate: (label) => `${label}: 缺少 create(api) 函数`,

package/dist/i18n/messages/interactive-view.d.ts

@@ -70,6 +70,9 @@ export declare const en: {
         codemode: (calls: number, lines: number) => string;
         done: string;
         outputLines: (n: number) => string;
+        /** web_fetch：`<标题> · <大小> · markdown|text|json|binary`。 */
+        fetched: (title: string | undefined, size: string, format: string) => string;
+        fetchRedirect: (url: string) => string;
         awaiting: (glyph: string) => string;
         subagentRunning: (elapsed: string) => string;
         running: (elapsed: string) => string;
@@ -139,6 +142,8 @@ export declare const zh: {
         codemode: (calls: number, lines: number) => string;
         done: string;
         outputLines: (n: number) => string;
+        fetched: (title: string | undefined, size: string, format: string) => string;
+        fetchRedirect: (url: string) => string;
         awaiting: (glyph: string) => string;
         subagentRunning: (elapsed: string) => string;
         running: (elapsed: string) => string;

package/dist/i18n/messages/interactive-view.js

@@ -73,6 +73,9 @@ export const en = {
         codemode: (calls, lines) => `${plural(calls, "inner call")} · script printed ${plural(lines, "line")}`,
         done: "done",
         outputLines: (n) => `${plural(n, "line")} of output`,
+        /** web_fetch：`<标题> · <大小> · markdown|text|json|binary`。 */
+        fetched: (title, size, format) => [title, size, format].filter((p) => p !== undefined && p !== "").join(" · "),
+        fetchRedirect: (url) => `redirected to ${url} (not followed)`,
         awaiting: (glyph) => `${glyph} awaiting approval`,
         subagentRunning: (elapsed) => `subagent · running ${elapsed}`,
         running: (elapsed) => `running · ${elapsed}`,
@@ -142,6 +145,8 @@ export const zh = {
         codemode: (calls, lines) => `${calls} 个内层调用 · 脚本输出 ${lines} 行`,
         done: "完成",
         outputLines: (n) => `${n} 行输出`,
+        fetched: (title, size, format) => [title, size, format].filter((p) => p !== undefined && p !== "").join(" · "),
+        fetchRedirect: (url) => `重定向到 ${url}（未跟随）`,
         awaiting: (glyph) => `${glyph} 等待确认`,
         subagentRunning: (elapsed) => `子 Agent · 运行中 ${elapsed}`,
         running: (elapsed) => `运行中 · ${elapsed}`,

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

@@ -196,6 +196,8 @@ export declare const en: {
             codemode: (calls: number, lines: number) => string;
             done: string;
             outputLines: (n: number) => string;
+            fetched: (title: string | undefined, size: string, format: string) => string;
+            fetchRedirect: (url: string) => string;
             awaiting: (glyph: string) => string;
             subagentRunning: (elapsed: string) => string;
             running: (elapsed: string) => string;
@@ -444,6 +446,8 @@ export declare const zh: {
             codemode: (calls: number, lines: number) => string;
             done: string;
             outputLines: (n: number) => string;
+            fetched: (title: string | undefined, size: string, format: string) => string;
+            fetchRedirect: (url: string) => string;
             awaiting: (glyph: string) => string;
             subagentRunning: (elapsed: string) => string;
             running: (elapsed: string) => string;

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  */
 export { AMA_VERSION } from "./version.js";
 export { AmaError, StartupError, isAmaError } from "./errors.js";
-export { HOST_API_VERSION } from "./host/types.js";
+export { HOST_API_MINOR, HOST_API_VERSION } from "./host/types.js";
 export { RPC_PROTOCOL_VERSION } from "./rpc.js";
 export { SESSION_FORMAT_VERSION } from "./session/types.js";
 export { HOOK_EVENTS } from "./hooks/types.js";

package/dist/index.js

@@ -7,7 +7,7 @@
 // 值
 export { AMA_VERSION } from "./version.js";
 export { AmaError, StartupError, isAmaError } from "./errors.js";
-export { HOST_API_VERSION } from "./host/types.js";
+export { HOST_API_MINOR, HOST_API_VERSION } from "./host/types.js";
 export { RPC_PROTOCOL_VERSION } from "./rpc.js";
 export { SESSION_FORMAT_VERSION } from "./session/types.js";
 export { HOOK_EVENTS } from "./hooks/types.js";

package/dist/modes/commands-core.d.ts

@@ -58,8 +58,15 @@ export interface CommandInfo {
     name: string;
     args?: string;
     description: string;
+    /** 只在该能力可用时列出（`/help`、补全、RPC `get_commands`）；输入时照常分派。 */
+    requires?: "memory" | "task";
 }
 export declare const BUILTIN_COMMANDS: readonly CommandInfo[];
+/**
+ * 能力关闭的命令不列出（capability-off.test.ts 锁定）：memory = 记忆工具已注册（`memory.enabled`）；
+ * task = 模型能直接调 `task`，或能经 codemode 脚本调（`task` 已注册且 codemode 在活动集）。
+ */
+export declare function availableCommands(runtime: Pick<Runtime, "tools">, session: Pick<AgentSession, "getTools">, list?: readonly CommandInfo[]): CommandInfo[];
 export declare function parseSlash(line: string): {
     name: string;
     args: string;

package/dist/modes/commands-core.js

@@ -66,7 +66,9 @@ export const BUILTIN_COMMANDS = [
     command("cache", "cache", "[warm off|streaming|idle | fingerprint]"),
     command("statusline", "statusline", "[full|compact]"),
     command("plan", "plan", { key: "planArgs" }),
-    command("tasks", "tasks", "[id] | stop <id> | bg [id]"),
+    Object.assign(command("tasks", "tasks", "[id] | stop <id> | bg [id]"), {
+        requires: "task",
+    }),
     command("agents", "agents"),
     command("paste", "paste"),
     command("interrupt", "interrupt", { key: "interruptArgs" }),
@@ -74,8 +76,24 @@ export const BUILTIN_COMMANDS = [
     // [W6-C0] 第六波（W6-S / W6-T1 / W6-M 实现）
     command("config", "config", "[key=value]"),
     command("trace", "trace", { key: "traceArgs" }),
-    command("memory", "memory", { key: "memoryArgs" }),
+    Object.assign(command("memory", "memory", { key: "memoryArgs" }), {
+        requires: "memory",
+    }),
 ];
+/**
+ * 能力关闭的命令不列出（capability-off.test.ts 锁定）：memory = 记忆工具已注册（`memory.enabled`）；
+ * task = 模型能直接调 `task`，或能经 codemode 脚本调（`task` 已注册且 codemode 在活动集）。
+ */
+export function availableCommands(runtime, session, list = BUILTIN_COMMANDS) {
+    const active = new Set(session.getTools().map((t) => t.name));
+    const registered = new Set(runtime.tools.list());
+    const has = (requires) => requires === "memory"
+        ? registered.has("memory")
+        : requires === "task"
+            ? active.has("task") || (active.has("codemode") && registered.has("task"))
+            : true;
+    return list.filter((c) => has(c.requires));
+}
 const ALIASES = { quit: "exit", q: "exit", "?": "help" };
 export function parseSlash(line) {
     const m = /^\/([A-Za-z?][\w-]*)(?:\s+([\s\S]*))?$/.exec(line.trim());
@@ -84,8 +102,8 @@ export function parseSlash(line) {
     const raw = m[1].toLowerCase();
     return { name: ALIASES[raw] ?? raw, args: (m[2] ?? "").trim() };
 }
-function helpText() {
-    const lines = BUILTIN_COMMANDS.map((c) => `/${c.name}${c.args !== undefined ? ` ${c.args}` : ""}  ${c.description}`);
+function helpText(ctx) {
+    const lines = availableCommands(ctx.runtime, ctx.session()).map((c) => `/${c.name}${c.args !== undefined ? ` ${c.args}` : ""}  ${c.description}`);
     const m = msg().report.commands;
     return [...lines, m.skillLine, m.templateLine].join("\n");
 }
@@ -142,7 +160,7 @@ export async function runSlashCommand(line, ctx) {
     const session = ctx.session();
     switch (name) {
         case "help":
-            return { kind: "handled", message: helpText() };
+            return { kind: "handled", message: helpText(ctx) };
         case "exit":
             return { kind: "exit" };
         case "new": {