@armadra/agent 0.4.0 → 0.5.0

package/dist/modes/interactive/line/line-render.js

@@ -6,6 +6,9 @@ import { THINKING_LEVELS } from "../../../ai/thinking.js";
 import { listSessions } from "../../../cli/compose-store.js";
 import { AUTO_LAYER_TEXT, permissionModeLines } from "../../../permissions/modes.js";
 import { cacheEventNotice, warmSentNotice } from "../../session-report.js";
+import { isFirstRunRequest, sourceLabel } from "../approval-dialog.js";
+import { LIMIT_WARNING, backgroundJobText, limitReachedText, modelFallbackText, } from "../event-notices.js";
+import { taskStatusText } from "../tasks-report.js";
 const SUMMARY_KEYS = ["command", "path", "pattern", "file_path", "url", "description", "name"];
 /** 工具参数的一行摘要（第一个常见字段，折叠换行、截到 80 字符）。 */
 export function argsSummary(args) {
@@ -21,8 +24,18 @@ export function argsSummary(args) {
     }
     return "";
 }
-export function approvalQuestion(request) {
-    const task = (request.context?.depth ?? 0) > 0 ? "[task] " : "";
+export function approvalQuestion(request, taskAgent) {
+    const label = sourceLabel(request, taskAgent);
+    const task = label === undefined ? "" : `${label} `;
+    const origin = request.context?.origin;
+    if (origin !== undefined) {
+        const where = origin.toolCall.locations?.[0];
+        return `${task}允许 ${origin.toolCall.title}${where !== undefined ? ` ${where}` : ""}？[y 允许 / a 本会话都允许 / N 拒绝] `;
+    }
+    if (isFirstRunRequest(request)) {
+        const input = request.input;
+        return `${task}${String(input["note"])} 允许？[y 允许 / N 拒绝] `;
+    }
     const summary = argsSummary(request.input);
     const auto = request.autoDecision;
     const why = request.reason === "dangerous"
@@ -131,11 +144,34 @@ export class EventPrinter {
                     this.failures++;
                     this.line(`ama: 错误：${error}`, true);
                 }
-                // 失败时 warning 就是同一条错误文本，不再重复打印
-                if (event.warning !== undefined && event.warning !== error)
+                // 失败时 warning 就是同一条错误文本，不再重复打印；预算到限已由 limit_reached 说明
+                if (event.warning !== undefined &&
+                    event.warning !== error &&
+                    event.warning !== LIMIT_WARNING)
                     this.line(`ama: ${event.warning}`, true);
                 return;
             }
+            // [W5-U] 第五波事件
+            case "plan_proposed": {
+                const file = event.filePath !== undefined ? `（${event.filePath}）` : "";
+                this.line(`◇ 计划 v${event.version} 待审批${file}：/plan approve [模式|fresh] 批准 · /plan reject 放弃 · 直接输入修改意见`);
+                return;
+            }
+            case "subagent_start":
+                this.line(`  ↳ ${event.taskId} ${event.agent}${event.background ? "（后台）" : ""} 开始`);
+                return;
+            case "subagent_end":
+                this.line(`  ↳ ${event.taskId} ${taskStatusText(event.status)}`);
+                return;
+            case "limit_reached":
+                this.line(`ama: ${limitReachedText(event)}`, true);
+                return;
+            case "model_fallback":
+                this.line(`ama: ${modelFallbackText(event)}`, true);
+                return;
+            case "background_job":
+                this.line(`ama: ${backgroundJobText(event)}`, true);
+                return;
             default:
                 return;
         }

package/dist/modes/interactive/message-view.d.ts

@@ -47,7 +47,7 @@ export declare class PrefixedText implements Component {
     render(width: number): string[];
     invalidate(): void;
 }
-/** 粗估 token（4 字符 ≈ 1 token），只用于思考块的流式计数。 */
+export declare function displayText(text: string): string;
 export declare function estimateTokens(text: string): number;
 export declare function contentText(content: string | readonly ContentBlock[]): string;
 /** 一条助手消息：按内容块（思考 / 文本）同步子组件；工具调用块由 tool-view 单独显示。 */

package/dist/modes/interactive/message-view.js

@@ -16,6 +16,8 @@
  */
 import { Card, Container, Markdown, Spacer, Text, visibleWidth, wrapTextWithAnsi, } from "../../tui.js";
 import { formatCost, formatTokens } from "./status-bar.js";
+import { notificationSummary } from "./subagent-view.js";
+import { PLAN_APPROVED_PROMPT } from "../../plan/prompts.js";
 /** 退出摘要的时长：不足 1 分钟按秒，否则按分钟。 */
 function sessionDuration(ms) {
     const seconds = Math.max(0, Math.round(ms / 1000));
@@ -60,7 +62,11 @@ export const ORIGIN_LABELS = {
     steer: "插话",
     followUp: "之后",
     host: "宿主",
+    task: "子 Agent 通知",
+    plan: "计划",
 };
+/** [W5-U] origin 为 plan 的交接消息（给模型的英文开场）在消息区的说法。 */
+const PLAN_HANDOFF_TEXT = "按批准的计划开始执行";
 /** 首行带前缀、续行按 `indent` 缩进的文本（用户消息、排队消息）。 */
 export class PrefixedText {
     prefix;
@@ -155,6 +161,11 @@ class ThinkingView {
     }
 }
 /** 粗估 token（4 字符 ≈ 1 token），只用于思考块的流式计数。 */
+/** [W5-U] 计划块的开闭标签（独占一行）只给模型与提取用，消息区不显示（计划正文照常渲染）。 */
+const PLAN_TAG_LINE = /^[ \t]*<\/?proposed_plan>[ \t]*$/gm;
+export function displayText(text) {
+    return text.includes("proposed_plan>") ? text.replace(PLAN_TAG_LINE, "") : text;
+}
 export function estimateTokens(text) {
     return Math.ceil(text.length / 4);
 }
@@ -214,8 +225,9 @@ export class AssistantView extends Container {
             if (block.text.trim() === "")
                 return;
             const view = this.part(index, () => this.options.markdown === false ? new Text("") : new Markdown("", { theme }));
-            if (view.getText() !== block.text)
-                view.setText(block.text);
+            const text = displayText(block.text);
+            if (view.getText() !== text)
+                view.setText(text);
             order.push(view);
         });
         const gap = this.options.compact !== true;
@@ -339,6 +351,16 @@ export class MessageView extends Container {
             return;
         }
         const label = ORIGIN_LABELS[origin] ?? origin;
+        // [W5-U] 后台子 Agent 的 <task-notification> 是给模型的全文，消息区只留一行
+        const summary = origin === "task"
+            ? notificationSummary(text)
+            : origin === "plan" && text === PLAN_APPROVED_PROMPT
+                ? PLAN_HANDOFF_TEXT
+                : undefined;
+        if (summary !== undefined) {
+            this.add(new PrefixedText(t.fg("dim", t.glyphs.queued) + " " + t.fg("muted", `${label}  `), t.fg("muted", summary)));
+            return;
+        }
         this.add(new PrefixedText(t.fg("dim", t.glyphs.queued) + " " + t.fg("muted", `${label}  `), t.fg("muted", text)));
     }
     newAssistant() {

package/dist/modes/interactive/panels.d.ts

@@ -4,12 +4,29 @@
  *
  * - `/session`：标题 `会话 <id 前 8 位> · <文件>`；模型 / 消息 / 用量 / 上下文（余量表，阈值着色），
  *   空一行后「缓存」段（与 `/cache` 共用 `cacheRows`）；
+ * - [W5-U] `/session` 多「子 Agent」行（任务汇总）与「外部 Agent」段（按 Agent 的运行次数与用量，单位不换算）；
  * - `/permissions`：权限模式、判定顺序（折行对齐值列）、规则（allow success、deny error、来源 dim）、
  *   最近的 auto 判定。
  */
 import type { AgentSession } from "../../agent/types.js";
 import type { Runtime } from "../../cli/runtime.js";
-import { type Component, type Theme } from "../../tui.js";
+import { KeyValue, type Component, type KeyValueRow, type Theme } from "../../tui.js";
+/** 多段内容按顺序拼起来（段之间不加空行，由调用方放空串）。 */
+export declare class Stack implements Component {
+    private readonly parts;
+    constructor(parts: readonly (Component | string)[]);
+    render(width: number): string[];
+    invalidate(): void;
+}
+/** 缩进若干列的子组件。 */
+export declare class Indent implements Component {
+    private readonly child;
+    private readonly columns;
+    constructor(child: Component, columns: number);
+    render(width: number): string[];
+    invalidate(): void;
+}
+export declare function keyValue(rows: readonly KeyValueRow[], theme: Theme, wrap?: boolean): KeyValue;
 export declare function sessionPanel(session: AgentSession, theme: Theme, options?: {
     now?: number;
     home?: string;

package/dist/modes/interactive/panels.js

@@ -4,15 +4,16 @@
  *
  * - `/session`：标题 `会话 <id 前 8 位> · <文件>`；模型 / 消息 / 用量 / 上下文（余量表，阈值着色），
  *   空一行后「缓存」段（与 `/cache` 共用 `cacheRows`）；
+ * - [W5-U] `/session` 多「子 Agent」行（任务汇总）与「外部 Agent」段（按 Agent 的运行次数与用量，单位不换算）；
  * - `/permissions`：权限模式、判定顺序（折行对齐值列）、规则（allow success、deny error、来源 dim）、
  *   最近的 auto 判定。
  */
 import { AUTO_LAYER_TEXT, permissionModeLabel } from "../../permissions/modes.js";
 import { Card, KeyValue, Meter, } from "../../tui.js";
-import { cacheRows, formatTokenCount, formatUsd } from "../session-report.js";
+import { cacheRows, externalRows, formatTokenCount, formatUsd, taskStatsText, } from "../session-report.js";
 import { tildePath } from "../../cli/startup-screen.js";
 /** 多段内容按顺序拼起来（段之间不加空行，由调用方放空串）。 */
-class Stack {
+export class Stack {
     parts;
     constructor(parts) {
         this.parts = parts;
@@ -27,7 +28,7 @@ class Stack {
     }
 }
 /** 缩进若干列的子组件。 */
-class Indent {
+export class Indent {
     child;
     columns;
     constructor(child, columns) {
@@ -44,7 +45,7 @@ class Indent {
         this.child.invalidate();
     }
 }
-function keyValue(rows, theme, wrap = false) {
+export function keyValue(rows, theme, wrap = false) {
     return new KeyValue(rows, { theme, maxKeyRatio: 0.3, ...(wrap ? { wrap: true } : {}) });
 }
 function cacheSection(session, theme, now) {
@@ -93,8 +94,21 @@ export function sessionPanel(session, theme, options = {}) {
         },
         { key: "上下文", value: meter + window },
     ];
+    const tasks = taskStatsText(session);
+    if (tasks !== undefined)
+        rows.push({ key: "子 Agent", value: tasks });
+    const external = externalRows(session);
+    const externalSection = external.length > 0
+        ? ["", theme.bold("外部 Agent"), new Indent(keyValue(external, theme), 2)]
+        : [];
     const file = state.sessionFile === undefined ? "未落盘" : tildePath(state.sessionFile, options.home);
-    return new Card(new Stack([keyValue(rows, theme), "", ...cacheSection(session, theme, now)]), {
+    const parts = [
+        keyValue(rows, theme),
+        "",
+        ...cacheSection(session, theme, now),
+        ...externalSection,
+    ];
+    return new Card(new Stack(parts), {
         theme,
         title: `会话 ${state.sessionId.slice(0, 8)}`,
         subtitle: file,

package/dist/modes/interactive/plan-command.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `/plan` 的语义（line 模式与交互模式共用，经 commands-core）。[W5-U]
+ *
+ * - `/plan`：当前计划与状态（版本、状态、文件、步骤、待办进度、所处模式）；
+ * - `/plan approve [模式|fresh]`：批准待审批的计划（没有计划块时把上一条回复当作计划，docs/wave5-plan.md
+ *   §6.3）；模式缺省回到进入 plan 前的模式，`fresh` 在新会话里执行（新建会话 → `adopt(plan)` → 发计划
+ *   全文）；
+ * - `/plan reject`：放弃待审批的计划（留在 Plan 模式）；
+ * - `/plan <目标>`：进入 Plan 模式并把目标作为提示发出。
+ */
+import type { AgentSession, PlanData } from "../../agent/types.js";
+import type { SwitchRequest } from "../../cli/compose-session.js";
+import type { PermissionMode } from "../../permissions/types.js";
+import { type PlanController } from "../../plan/controller.js";
+export declare const PLAN_USAGE = "\u7528\u6CD5\uFF1A/plan [\u76EE\u6807] | /plan approve [\u6A21\u5F0F|fresh] | /plan reject";
+export declare function planStatusText(status: PlanData["status"]): string;
+/** 计划的标题：第一个 `#` 标题，没有时取第一行非空文本。 */
+export declare function planTitle(plan: Pick<PlanData, "markdown">): string;
+/** 批准后的执行模式（缺省回到进入 plan 前的模式；进入前就是 plan 则 default）。 */
+export declare function defaultExecutionMode(controller: PlanController): PermissionMode;
+/** `/plan` 的纯文本说明。 */
+export declare function describePlan(controller: PlanController, session: AgentSession): string;
+export interface PlanCommandContext {
+    switchSession(request: SwitchRequest): Promise<AgentSession>;
+}
+export type PlanCommandResult = {
+    kind: "handled";
+    message: string;
+    wait?: boolean;
+} | {
+    kind: "prompt";
+    text: string;
+};
+/** 「新上下文执行」：新建会话、记下计划与 todo、切到执行模式，返回首条消息。 */
+export declare function approveFresh(controller: PlanController, plan: PlanData, mode: PermissionMode, ctx: PlanCommandContext, editedMarkdown?: string): Promise<{
+    session: AgentSession;
+    prompt: string;
+    plan: PlanData;
+}>;
+export declare function planCommand(session: AgentSession, args: string, ctx: PlanCommandContext): Promise<PlanCommandResult>;

package/dist/modes/interactive/plan-command.js

@@ -0,0 +1,129 @@
+/**
+ * `/plan` 的语义（line 模式与交互模式共用，经 commands-core）。[W5-U]
+ *
+ * - `/plan`：当前计划与状态（版本、状态、文件、步骤、待办进度、所处模式）；
+ * - `/plan approve [模式|fresh]`：批准待审批的计划（没有计划块时把上一条回复当作计划，docs/wave5-plan.md
+ *   §6.3）；模式缺省回到进入 plan 前的模式，`fresh` 在新会话里执行（新建会话 → `adopt(plan)` → 发计划
+ *   全文）；
+ * - `/plan reject`：放弃待审批的计划（留在 Plan 模式）；
+ * - `/plan <目标>`：进入 Plan 模式并把目标作为提示发出。
+ */
+import { AmaError } from "../../errors.js";
+import { parsePermissionMode, permissionModeLabel } from "../../permissions/modes.js";
+import { planController } from "../../plan/controller.js";
+import { executionMode } from "../../plan/store.js";
+export const PLAN_USAGE = "用法：/plan [目标] | /plan approve [模式|fresh] | /plan reject";
+const STATUS_TEXT = {
+    proposed: "待审批",
+    approved: "已批准",
+    rejected: "已放弃",
+    superseded: "已被新版本取代",
+};
+export function planStatusText(status) {
+    return STATUS_TEXT[status];
+}
+/** 计划的标题：第一个 `#` 标题，没有时取第一行非空文本。 */
+export function planTitle(plan) {
+    const lines = plan.markdown.split(/\r?\n/).map((l) => l.trim());
+    const heading = lines.find((l) => /^#{1,6}\s+\S/.test(l));
+    if (heading !== undefined)
+        return heading.replace(/^#{1,6}\s+/, "");
+    return lines.find((l) => l !== "" && !/^<\/?proposed_plan>$/.test(l)) ?? "（无标题）";
+}
+/** 批准后的执行模式（缺省回到进入 plan 前的模式；进入前就是 plan 则 default）。 */
+export function defaultExecutionMode(controller) {
+    return executionMode(undefined, controller.prePlanMode());
+}
+/** `/plan` 的纯文本说明。 */
+export function describePlan(controller, session) {
+    const plan = controller.current();
+    const mode = session.state.permissionMode;
+    const pre = controller.prePlanMode();
+    const modeLine = mode === "plan"
+        ? `模式：Plan（批准后回到 ${permissionModeLabel(executionMode(undefined, pre))}）`
+        : `模式：${permissionModeLabel(mode)}`;
+    if (plan === null) {
+        return mode === "plan"
+            ? [modeLine, "还没有计划：模型给出 <proposed_plan> 后在这里审批"].join("\n")
+            : "没有计划。/plan <目标> 进入 Plan 模式";
+    }
+    const lines = [
+        `计划 v${plan.version} · ${planStatusText(plan.status)} · ${planTitle(plan)}`,
+        ...(plan.filePath !== undefined ? [`文件：${plan.filePath}`] : []),
+        modeLine,
+    ];
+    if (plan.steps.length > 0) {
+        lines.push(`步骤（${plan.steps.length}）：`);
+        for (const step of plan.steps)
+            lines.push(`  ${step.id} ${step.text}`);
+    }
+    const todos = controller.todos();
+    if (todos.length > 0) {
+        const done = todos.filter((t) => t.status === "done").length;
+        const current = todos.find((t) => t.status === "in_progress");
+        lines.push(`待办：${done}/${todos.length} 完成${current !== undefined ? ` · 进行中 ${current.text}` : ""}`);
+    }
+    if (plan.status === "proposed")
+        lines.push("/plan approve [模式|fresh] 批准 · /plan reject 放弃 · 直接输入修改意见");
+    return lines.join("\n");
+}
+/** 「新上下文执行」：新建会话、记下计划与 todo、切到执行模式，返回首条消息。 */
+export async function approveFresh(controller, plan, mode, ctx, editedMarkdown) {
+    const result = await controller.respond({
+        planId: plan.id,
+        decision: "approve_fresh",
+        mode,
+        ...(editedMarkdown !== undefined ? { editedMarkdown } : {}),
+    });
+    const next = await ctx.switchSession({ kind: "new" });
+    planController(next)?.adopt(result.plan);
+    next.setPermissionMode(result.mode ?? mode);
+    return { session: next, prompt: result.freshPrompt ?? result.plan.markdown, plan: result.plan };
+}
+function pendingOrLastReply(controller) {
+    const plan = controller.pending() ?? controller.proposeFromLastReply();
+    if (plan === undefined)
+        throw new AmaError("plan_not_found", "没有待审批的计划");
+    return plan;
+}
+export async function planCommand(session, args, ctx) {
+    const controller = planController(session);
+    const [verb = "", ...rest] = args.split(/\s+/).filter((s) => s !== "");
+    if (controller === undefined) {
+        if (args === "")
+            return { kind: "handled", message: "当前会话没有 Plan 能力" };
+        throw new AmaError("invalid_arguments", "当前会话没有 Plan 能力");
+    }
+    if (verb === "")
+        return { kind: "handled", message: describePlan(controller, session) };
+    if (verb === "approve") {
+        if (rest.length > 1)
+            throw new AmaError("invalid_arguments", PLAN_USAGE);
+        const plan = pendingOrLastReply(controller);
+        const arg = rest[0];
+        if (arg === "fresh") {
+            const fresh = await approveFresh(controller, plan, defaultExecutionMode(controller), ctx);
+            return { kind: "prompt", text: fresh.prompt };
+        }
+        const mode = arg === undefined ? defaultExecutionMode(controller) : parsePermissionMode(arg);
+        if (mode === undefined || mode === "plan")
+            throw new AmaError("invalid_arguments", `执行模式无效：${arg ?? ""}（${PLAN_USAGE}）`);
+        const result = await controller.respond({ planId: plan.id, decision: "approve", mode });
+        return {
+            kind: "handled",
+            message: `已批准计划 v${result.plan.version}，以 ${permissionModeLabel(result.mode ?? mode)} 执行`,
+            wait: true,
+        };
+    }
+    if (verb === "reject" && rest.length === 0) {
+        const plan = controller.pending();
+        if (plan === undefined)
+            throw new AmaError("plan_not_found", "没有待审批的计划");
+        await controller.respond({ planId: plan.id, decision: "reject" });
+        return { kind: "handled", message: `已放弃计划 v${plan.version}（仍在 Plan 模式）` };
+    }
+    // 其余：目标文本
+    if (session.state.permissionMode !== "plan")
+        session.setPermissionMode("plan");
+    return { kind: "prompt", text: args };
+}

package/dist/modes/interactive/plan-dialog.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 计划审批对话框（docs/wave5-plan.md §6.1、§6.3）：底部覆盖层，与权限审批框同一手法。[W5-U]
+ *
+ * ```
+ * ╭─ 计划待审批 ──────────────────────────────────────────────╮
+ * │ 计划 v1 · 3 步 · ~/.local/share/ama/plans/3f2a9c1e-v1.md  │
+ * │ 给 status-bar 加回退模型显示                              │
+ * │   S1 读 status-bar.ts 与 status-area.ts                   │
+ * │   …                                                       │
+ * │                                                           │
+ * │ › 1. 批准并执行                                           │
+ * │   2. 批准，在新上下文执行                                 │
+ * │   3. 继续修改…                                            │
+ * │   4. 放弃，退出 Plan 模式                                 │
+ * │                                                           │
+ * │ ↑↓ 选择 · Enter 确认 · e 编辑计划 · Esc 留在 Plan         │
+ * ╰───────────────────────────────────────────────────────────╯
+ * ```
+ *
+ * - 1 / 2 之后选执行模式：回到进入前的模式（缺省）/ Accept edits / Auto；Esc 回到上一步。
+ * - 3「继续修改」：行内写意见（Enter 发送，`Ctrl+E` 改用外部编辑器写），意见作为普通用户消息、留在 plan；
+ *   Esc 回到上一步。
+ * - `e`：在外部编辑器（`$VISUAL` / `$EDITOR`，TUI 挂起）里改计划全文；批准时以改后的版本（version + 1）
+ *   交接。
+ * - 4「放弃」：计划标 rejected 并退出 Plan 模式（回到进入前的模式）；Esc：计划标 rejected、留在 Plan 模式
+ *   （§6.1）。
+ * - 宽 < 56 时紧凑：去掉空行、按键提示缩短。ASCII 字形走 theme.glyphs。
+ */
+import type { PlanData } from "../../agent/types.js";
+import type { PermissionMode } from "../../permissions/types.js";
+import { type Component, type Focusable, type Keybindings, type OverlayHandle, type Theme } from "../../tui.js";
+/** 对话框里最多列出的步骤数。 */
+export declare const PLAN_DIALOG_STEPS = 6;
+export type PlanChoice = {
+    decision: "approve" | "approve_fresh";
+    mode: PermissionMode;
+    editedMarkdown?: string;
+} | {
+    decision: "revise";
+    feedback: string;
+}
+/** `exit`：放弃并退出 Plan 模式（选项 4）；Esc 为 false。 */
+ | {
+    decision: "reject";
+    exit: boolean;
+};
+export interface PlanDialogHost {
+    theme: Theme;
+    keybindings?: Keybindings;
+    showOverlay(component: Component): OverlayHandle;
+    /** 外部编辑器：返回改后的文本，取消或失败返回 undefined。 */
+    editExternal?(text: string, kind: "plan" | "feedback"): Promise<string | undefined>;
+    /** 计划文件路径的显示（缩写家目录）。 */
+    displayPath?(path: string): string;
+    /** 重画（外部编辑器回来之后）。 */
+    render?(): void;
+    onOpen?(): void;
+    onClose?(): void;
+}
+export interface PlanDialogInput {
+    plan: PlanData;
+    /** 「回到进入前的模式」对应的执行模式。 */
+    preMode: PermissionMode;
+}
+export declare class PlanDialog implements Component, Focusable {
+    private readonly input;
+    private readonly host;
+    private readonly done;
+    focused: boolean;
+    private stage;
+    private selected;
+    private modeSelected;
+    /** 选执行模式时记下的是 1 还是 2。 */
+    private fresh;
+    private feedback;
+    private edited;
+    constructor(input: PlanDialogInput, host: PlanDialogHost, done: (choice: PlanChoice) => void);
+    private modes;
+    handleInput(data: string): void;
+    private keys;
+    private cancelKey;
+    private mainInput;
+    private choose;
+    private modeInput;
+    private approve;
+    private reviseInput;
+    private editPlan;
+    private editFeedback;
+    render(width: number): string[];
+    /** 版本、步数、文件、标题与前几步。 */
+    private summary;
+    private optionLines;
+    private reviseLines;
+    private hint;
+    invalidate(): void;
+}
+/** 打开对话框，等用户选择。 */
+export declare function openPlanDialog(host: PlanDialogHost, input: PlanDialogInput): Promise<PlanChoice>;