@armadra/agent 0.8.0 → 0.8.1

package/dist/agent/session-rewind.js

@@ -1,5 +1,5 @@
 /**
- * 会话回滚编排（docs/rewind-plan.md §2、§3.1、§3.3–§3.6）。[RW-B]
+ * 会话回滚编排（docs/history/rewind-plan.md §2、§3.1、§3.3–§3.6）。[RW-B]
  *
  * - 回合起点：`runPrompt` 开启新回合的那条用户消息（steer / followUp 并入当前回合、Stop Hook 续跑
  *   的 `hook` 消息都不算）。本进程内落盘的按记录判断；恢复的会话以 `ama.checkpoint` 条目为准，

package/dist/agent/session-settings.d.ts

@@ -1,6 +1,6 @@
 /**
  * 会话的可变设置：模型、思考级别、工具表与活动集、系统提示静态部分（从 session.ts 搬出，
- * docs/wave5-plan.md §9「session.ts → session-settings.ts」）。[W5-C0]
+ * docs/history/wave5-plan.md §9「session.ts → session-settings.ts」）。[W5-C0]
  *
  * 纯搬迁：`setModel / setThinkingLevel / setPermissionMode / setActiveTools / addTool /
  * updateSystem / announceStart / getTools` 的行为与事件顺序不变；`AgentSessionImpl` 以同名成员转发。

package/dist/agent/session-settings.js

@@ -1,6 +1,6 @@
 /**
  * 会话的可变设置：模型、思考级别、工具表与活动集、系统提示静态部分（从 session.ts 搬出，
- * docs/wave5-plan.md §9「session.ts → session-settings.ts」）。[W5-C0]
+ * docs/history/wave5-plan.md §9「session.ts → session-settings.ts」）。[W5-C0]
  *
  * 纯搬迁：`setModel / setThinkingLevel / setPermissionMode / setActiveTools / addTool /
  * updateSystem / announceStart / getTools` 的行为与事件顺序不变；`AgentSessionImpl` 以同名成员转发。

package/dist/agent/session-subagent.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent（设计 §5.2 task、D14；第五波 docs/wave5-plan.md §7，D22–D24）：`ToolContext.spawnSubagent`
+ * 子 Agent（设计 §5.2 task、D14；第五波 docs/history/wave5-plan.md §7，D22–D24）：`ToolContext.spawnSubagent`
  * 的实现与 ama 自己的 runner（`AmaRunner`）。[B2 → W5-G]
  *
  * - `runSubagent`：交给会话的任务注册表（subagent-registry.ts）——类型解析、并发池、前台 / 后台、

package/dist/agent/session-subagent.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent（设计 §5.2 task、D14；第五波 docs/wave5-plan.md §7，D22–D24）：`ToolContext.spawnSubagent`
+ * 子 Agent（设计 §5.2 task、D14；第五波 docs/history/wave5-plan.md §7，D22–D24）：`ToolContext.spawnSubagent`
  * 的实现与 ama 自己的 runner（`AmaRunner`）。[B2 → W5-G]
  *
  * - `runSubagent`：交给会话的任务注册表（subagent-registry.ts）——类型解析、并发池、前台 / 后台、

package/dist/agent/session-telemetry.d.ts

@@ -1,5 +1,5 @@
 /**
- * 会话遥测：输出速率与首 token 延迟（docs/wave5-plan.md §1.3，D2）。[W5-A]
+ * 会话遥测：输出速率与首 token 延迟（docs/history/wave5-plan.md §1.3，D2）。[W5-A]
  *
  * 以 `SessionExtension.wrapStream` 包一层流，只观察不改事件：
  * - 只统计 `purpose: "turn"`（缺省即 turn）；summary / warm / probe / classify 原样透传、不计入；

package/dist/agent/session-telemetry.js

@@ -1,5 +1,5 @@
 /**
- * 会话遥测：输出速率与首 token 延迟（docs/wave5-plan.md §1.3，D2）。[W5-A]
+ * 会话遥测：输出速率与首 token 延迟（docs/history/wave5-plan.md §1.3，D2）。[W5-A]
  *
  * 以 `SessionExtension.wrapStream` 包一层流，只观察不改事件：
  * - 只统计 `purpose: "turn"`（缺省即 turn）；summary / warm / probe / classify 原样透传、不计入；

package/dist/agent/session-trace-writer.d.ts

@@ -1,5 +1,5 @@
 /**
- * 轨迹写入（docs/wave6-plan.md §2.2、D5）。[W6-C0]
+ * 轨迹写入（docs/history/wave6-plan.md §2.2、D5）。[W6-C0]
  *
  * 会话扩展：订阅事件，把计时写成 `custom{customType:"ama.trace"}` 条目（`trace/types.ts` 的 `TraceEntryData`）。
  * - `step`：每个 turn 请求一条（成功、失败、被重试掉的都写），在 `turn_end` 时写——此时 assistant 与该批

package/dist/agent/session-trace-writer.js

@@ -1,5 +1,5 @@
 /**
- * 轨迹写入（docs/wave6-plan.md §2.2、D5）。[W6-C0]
+ * 轨迹写入（docs/history/wave6-plan.md §2.2、D5）。[W6-C0]
  *
  * 会话扩展：订阅事件，把计时写成 `custom{customType:"ama.trace"}` 条目（`trace/types.ts` 的 `TraceEntryData`）。
  * - `step`：每个 turn 请求一条（成功、失败、被重试掉的都写），在 `turn_end` 时写——此时 assistant 与该批

package/dist/agent/session.js

@@ -369,7 +369,7 @@ export class AgentSessionImpl {
             return Promise.reject(new AmaError("busy", "cannot compact while running"));
         return this.startCycle((signal) => this.compaction.compactManual(instructions, signal, cutAt));
     }
-    // [RW-B] 回滚（docs/rewind-plan.md §3；编排与校验在 session-rewind.ts）
+    // [RW-B] 回滚（docs/history/rewind-plan.md §3；编排与校验在 session-rewind.ts）
     rewindPoints = () => this.rewinder.points();
     rewind = (request) => this.rewinder.rewind(request);
     summarizeFrom = (entryId, instructions) => this.rewinder.summarizeFrom(entryId, instructions);

package/dist/agent/subagent-background.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 的后台化（docs/agents-concurrency-plan.md §2.3、§2.5–§2.6）。[W7-B1]
+ * 子 Agent 的后台化（docs/history/agents-concurrency-plan.md §2.3、§2.5–§2.6）。[W7-B1]
  *
  * 从 subagent-registry.ts 拆出（保持 ≤ 600 行）：
  * - `resolveTaskBackground`：`subagents.background`（auto / always / never）→ 本会话 `task` 的缺省；

package/dist/agent/subagent-background.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 的后台化（docs/agents-concurrency-plan.md §2.3、§2.5–§2.6）。[W7-B1]
+ * 子 Agent 的后台化（docs/history/agents-concurrency-plan.md §2.3、§2.5–§2.6）。[W7-B1]
  *
  * 从 subagent-registry.ts 拆出（保持 ≤ 600 行）：
  * - `resolveTaskBackground`：`subagents.background`（auto / always / never）→ 本会话 `task` 的缺省；

package/dist/agent/subagent-direct.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 视图的直接对话与实时数据（docs/wave6-plan.md §1.2–§1.3、D3）。[W6-A]
+ * 子 Agent 视图的直接对话与实时数据（docs/history/wave6-plan.md §1.2–§1.3、D3）。[W6-A]
  *
  * 从 subagent-registry.ts 拆出（保持 ≤ 600 行）：
  * - `liveOf`：视图读的快照、是否在并发池排队、ama 子会话的观察钩子与外部 Agent 的环形缓冲；

package/dist/agent/subagent-direct.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 视图的直接对话与实时数据（docs/wave6-plan.md §1.2–§1.3、D3）。[W6-A]
+ * 子 Agent 视图的直接对话与实时数据（docs/history/wave6-plan.md §1.2–§1.3、D3）。[W6-A]
  *
  * 从 subagent-registry.ts 拆出（保持 ≤ 600 行）：
  * - `liveOf`：视图读的快照、是否在并发池排队、ama 子会话的观察钩子与外部 Agent 的环形缓冲；

package/dist/agent/subagent-fork.d.ts

@@ -1,5 +1,5 @@
 /**
- * fork 式子 Agent（docs/model-efficiency-plan.md §2.1，D1–D3）。[ME-A]
+ * fork 式子 Agent（docs/history/model-efficiency-plan.md §2.1，D1–D3）。[ME-A]
  *
  * - fork 点 = 发出本次 `task` 调用的那条 assistant **之前一条**条目（= 父会话上一次真实请求的转录）；
  *   同一条 assistant 里并行的多个 fork 任务共享同一个 fork 点。

package/dist/agent/subagent-fork.js

@@ -1,5 +1,5 @@
 /**
- * fork 式子 Agent（docs/model-efficiency-plan.md §2.1，D1–D3）。[ME-A]
+ * fork 式子 Agent（docs/history/model-efficiency-plan.md §2.1，D1–D3）。[ME-A]
  *
  * - fork 点 = 发出本次 `task` 调用的那条 assistant **之前一条**条目（= 父会话上一次真实请求的转录）；
  *   同一条 assistant 里并行的多个 fork 任务共享同一个 fork 点。

package/dist/agent/subagent-registry.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 任务注册表（docs/wave5-plan.md §7.3–§7.6，D13、D23–D24）。[W5-G]
+ * 子 Agent 任务注册表（docs/history/wave5-plan.md §7.3–§7.6，D13、D23–D24）。[W5-G]
  *
  * 每个根会话一份（按会话 id 登记；compose-agents.ts 的扩展在会话构造时建，SDK / 测试直接构造的
  * 会话在首次 task 时以缺省环境懒建）。职责：

package/dist/agent/subagent-registry.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 任务注册表（docs/wave5-plan.md §7.3–§7.6，D13、D23–D24）。[W5-G]
+ * 子 Agent 任务注册表（docs/history/wave5-plan.md §7.3–§7.6，D13、D23–D24）。[W5-G]
  *
  * 每个根会话一份（按会话 id 登记；compose-agents.ts 的扩展在会话构造时建，SDK / 测试直接构造的
  * 会话在首次 task 时以缺省环境懒建）。职责：

package/dist/agent/system-prompt.js

@@ -18,7 +18,7 @@ export const SECTION_ORDER = [
     "rules",
     "project_context",
     "skills",
-    // [W6-C0] 记忆索引（W6-M，docs/wave6-plan.md §3.4）；未开启时为 undefined，字节不变
+    // [W6-C0] 记忆索引（W6-M，docs/history/wave6-plan.md §3.4）；未开启时为 undefined，字节不变
     "memory",
     "hooks",
     "cwd",

package/dist/agent/tool-availability.d.ts

@@ -1,5 +1,5 @@
 /**
- * 工具可用性的固定英文文案（docs/model-efficiency-plan.md §1.4、D5）：执行层拒绝与尾部提醒共用，
+ * 工具可用性的固定英文文案（docs/history/model-efficiency-plan.md §1.4、D5）：执行层拒绝与尾部提醒共用，
  * 发给模型，两种界面语言下逐字节相同。[ME-C0]
  * [ME-B] 两条提醒由 `ai/context.ts` 渲染（ai 不 import agent），定义移到那里、这里再导出。
  */

package/dist/agent/tool-availability.js

@@ -1,5 +1,5 @@
 /**
- * 工具可用性的固定英文文案（docs/model-efficiency-plan.md §1.4、D5）：执行层拒绝与尾部提醒共用，
+ * 工具可用性的固定英文文案（docs/history/model-efficiency-plan.md §1.4、D5）：执行层拒绝与尾部提醒共用，
  * 发给模型，两种界面语言下逐字节相同。[ME-C0]
  * [ME-B] 两条提醒由 `ai/context.ts` 渲染（ai 不 import agent），定义移到那里、这里再导出。
  */

package/dist/agent/types-w5.d.ts

@@ -1,5 +1,5 @@
 /**
- * 第五波会话契约（docs/wave5-plan.md §1.3、§5.4、§6.3、§6.5、§7.5、§8.3；[W5-C0]）。
+ * 第五波会话契约（docs/history/wave5-plan.md §1.3、§5.4、§6.3、§6.5、§7.5、§8.3；[W5-C0]）。
  *
  * 这里放新增事件的载荷与 `SessionStats` 的扩展形状，由 agent/types.ts 并入 `SessionEvent` /
  * `SessionStats` 并再导出（agent/types.ts 已接近 600 行）。全部是新增事件与可选字段：
@@ -81,7 +81,7 @@ export interface SubagentEndEvent {
     };
 }
 /**
- * [W7-B1] 前台任务转后台（docs/agents-concurrency-plan.md §2.5）：`user` = 人（TUI `Ctrl+B` 等），
+ * [W7-B1] 前台任务转后台（docs/history/agents-concurrency-plan.md §2.5）：`user` = 人（TUI `Ctrl+B` 等），
  * `timeout` = `subagents.autoBackgroundAfterMs` 到时，`host` = 宿主 / SDK（`session.backgroundTask`）。
  */
 export interface SubagentBackgroundEvent {

package/dist/agent/types-w5.js

@@ -1,5 +1,5 @@
 /**
- * 第五波会话契约（docs/wave5-plan.md §1.3、§5.4、§6.3、§6.5、§7.5、§8.3；[W5-C0]）。
+ * 第五波会话契约（docs/history/wave5-plan.md §1.3、§5.4、§6.3、§6.5、§7.5、§8.3；[W5-C0]）。
  *
  * 这里放新增事件的载荷与 `SessionStats` 的扩展形状，由 agent/types.ts 并入 `SessionEvent` /
  * `SessionStats` 并再导出（agent/types.ts 已接近 600 行）。全部是新增事件与可选字段：

package/dist/agent/types-w6.d.ts

@@ -1,5 +1,5 @@
 /**
- * 第六波会话事件与统计（docs/wave6-plan.md §4.4、D17）。[W6-C0] 契约文件：形状在这里，行为由 W6-O 实现。
+ * 第六波会话事件与统计（docs/history/wave6-plan.md §4.4、D17）。[W6-C0] 契约文件：形状在这里，行为由 W6-O 实现。
  */
 /** 一档配额窗口的用量。 */
 export interface QuotaWindow {

package/dist/agent/types-w6.js

@@ -1,4 +1,4 @@
 /**
- * 第六波会话事件与统计（docs/wave6-plan.md §4.4、D17）。[W6-C0] 契约文件：形状在这里，行为由 W6-O 实现。
+ * 第六波会话事件与统计（docs/history/wave6-plan.md §4.4、D17）。[W6-C0] 契约文件：形状在这里，行为由 W6-O 实现。
  */
 export {};

package/dist/agent/types.d.ts

@@ -423,7 +423,7 @@ export interface AgentSession {
         followUp: string[];
     };
     /**
-     * [W7-B1] 阻塞中的前台子 Agent 任务转后台（不给 taskId = 全部；docs/agents-concurrency-plan.md §2.5）。
+     * [W7-B1] 阻塞中的前台子 Agent 任务转后台（不给 taskId = 全部；docs/history/agents-concurrency-plan.md §2.5）。
      * `reason` 缺省 `"host"`（宿主 / SDK）；TUI 的人工操作传 `"user"`。返回被转后台或被打断等待的 taskId。
      */
     backgroundTask(taskId?: string, reason?: "user" | "timeout" | "host"): string[];

package/dist/agent/worktree.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 的 git worktree 隔离（docs/wave5-plan.md §7.4，D24）。[W5-G]
+ * 子 Agent 的 git worktree 隔离（docs/history/wave5-plan.md §7.4，D24）。[W5-G]
  *
  * - `git worktree add -b ama/task-<taskId> <repo>/.ama/worktrees/<taskId> HEAD`；子会话 cwd 指向
  *   worktree 里与父 cwd 对应的子目录；

package/dist/agent/worktree.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 的 git worktree 隔离（docs/wave5-plan.md §7.4，D24）。[W5-G]
+ * 子 Agent 的 git worktree 隔离（docs/history/wave5-plan.md §7.4，D24）。[W5-G]
  *
  * - `git worktree add -b ama/task-<taskId> <repo>/.ama/worktrees/<taskId> HEAD`；子会话 cwd 指向
  *   worktree 里与父 cwd 对应的子目录；

package/dist/agents/builtin.d.ts

@@ -1,5 +1,5 @@
 /**
- * 内置子 Agent 类型（docs/wave5-plan.md §7.2，D22–D23）。[W5-G]
+ * 内置子 Agent 类型（docs/history/wave5-plan.md §7.2，D22–D23）。[W5-G]
  *
  * 三个类型都用父会话的活动工具集（工具表与父字节一致，缓存前缀可复用）；只读靠权限层：
  * `explore` / `plan` 的 `permissionMode: "plan"` 让子会话用 plan 模式的管线，写类工具与非只读 bash

package/dist/agents/builtin.js

@@ -1,5 +1,5 @@
 /**
- * 内置子 Agent 类型（docs/wave5-plan.md §7.2，D22–D23）。[W5-G]
+ * 内置子 Agent 类型（docs/history/wave5-plan.md §7.2，D22–D23）。[W5-G]
  *
  * 三个类型都用父会话的活动工具集（工具表与父字节一致，缓存前缀可复用）；只读靠权限层：
  * `explore` / `plan` 的 `permissionMode: "plan"` 让子会话用 plan 模式的管线，写类工具与非只读 bash

package/dist/agents/catalog.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 类型目录：内置 ⊕ 发现的定义 ⊕ 外部 runner（docs/wave5-plan.md §7.1–§7.3、§7.6）。[W5-G]
+ * 子 Agent 类型目录：内置 ⊕ 发现的定义 ⊕ 外部 runner（docs/history/wave5-plan.md §7.1–§7.3、§7.6）。[W5-G]
  *
  * - 发现的同名定义覆盖内置类型（不 warning）；外部 runner（W5-E 的 ProcessRunner、宿主 runner）以
  *   `add()` 登记，名字已存在时保留先登记者。

package/dist/agents/catalog.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 类型目录：内置 ⊕ 发现的定义 ⊕ 外部 runner（docs/wave5-plan.md §7.1–§7.3、§7.6）。[W5-G]
+ * 子 Agent 类型目录：内置 ⊕ 发现的定义 ⊕ 外部 runner（docs/history/wave5-plan.md §7.1–§7.3、§7.6）。[W5-G]
  *
  * - 发现的同名定义覆盖内置类型（不 warning）；外部 runner（W5-E 的 ProcessRunner、宿主 runner）以
  *   `add()` 登记，名字已存在时保留先登记者。

package/dist/agents/discover.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 定义发现（docs/wave5-plan.md §7.1，D22）。[W5-G]
+ * 子 Agent 定义发现（docs/history/wave5-plan.md §7.1，D22）。[W5-G]
  *
  * 顺序：`--agent-dir`（可重复，profile `agentDirs` 由启动步骤并在其后）→ config `agents.dirs` →
  * `<configDir>/agents/*.md`（用户级）→ `<cwd>/.ama/agents/*.md`（项目级，需信任；未信任跳过并记入

package/dist/agents/discover.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 定义发现（docs/wave5-plan.md §7.1，D22）。[W5-G]
+ * 子 Agent 定义发现（docs/history/wave5-plan.md §7.1，D22）。[W5-G]
  *
  * 顺序：`--agent-dir`（可重复，profile `agentDirs` 由启动步骤并在其后）→ config `agents.dirs` →
  * `<configDir>/agents/*.md`（用户级）→ `<cwd>/.ama/agents/*.md`（项目级，需信任；未信任跳过并记入

package/dist/agents/external.d.ts

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 接入 `task(agent=…)`（docs/wave5-plan.md §5.3–§5.5、§7.3、§7.6，D13、D15、D17）。[W5-EG]
+ * 外部 Agent 接入 `task(agent=…)`（docs/history/wave5-plan.md §5.3–§5.5、§7.3、§7.6，D13、D15、D17）。[W5-EG]
  *
  * - 名字：`claude` / `codex` / `acp:<program>` / 驱动表里的其它 id（`gemini` …，`ama` 除外——那是子会话
  *   类型的 runner 名；ama 自己经 ACP 用 `acp:ama`）/ 宿主注入的 runner id（宿主注入的 `ama` 在类型里的 runner

package/dist/agents/external.js

@@ -1,5 +1,5 @@
 /**
- * 外部 Agent 接入 `task(agent=…)`（docs/wave5-plan.md §5.3–§5.5、§7.3、§7.6，D13、D15、D17）。[W5-EG]
+ * 外部 Agent 接入 `task(agent=…)`（docs/history/wave5-plan.md §5.3–§5.5、§7.3、§7.6，D13、D15、D17）。[W5-EG]
  *
  * - 名字：`claude` / `codex` / `acp:<program>` / 驱动表里的其它 id（`gemini` …，`ama` 除外——那是子会话
  *   类型的 runner 名；ama 自己经 ACP 用 `acp:ama`）/ 宿主注入的 runner id（宿主注入的 `ama` 在类型里的 runner

package/dist/agents/parse.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 定义文件解析（docs/wave5-plan.md §7.1，D22）。[W5-G]
+ * 子 Agent 定义文件解析（docs/history/wave5-plan.md §7.1，D22）。[W5-G]
  *
  * 一个 `*.md` = 一个类型：frontmatter 与 Skill 同一套 YAML 子集（skills/frontmatter.ts），字段名
  * kebab-case；正文 = 追加到子会话系统提示末尾的角色说明。不合格的文件不加载并给出 warning（拼错的

package/dist/agents/parse.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 定义文件解析（docs/wave5-plan.md §7.1，D22）。[W5-G]
+ * 子 Agent 定义文件解析（docs/history/wave5-plan.md §7.1，D22）。[W5-G]
  *
  * 一个 `*.md` = 一个类型：frontmatter 与 Skill 同一套 YAML 子集（skills/frontmatter.ts），字段名
  * kebab-case；正文 = 追加到子会话系统提示末尾的角色说明。不合格的文件不加载并给出 warning（拼错的

package/dist/agents/result.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 结果的上限、落盘与通知文本（docs/wave5-plan.md §7.4，D23–D24）。[W5-G]
+ * 子 Agent 结果的上限、落盘与通知文本（docs/history/wave5-plan.md §7.4，D23–D24）。[W5-G]
  *
  * - 结果 > 50 KB（UTF-8 字节）保留头 70% + 尾 30%，中间一行说明省略了多少、全文在哪；
  * - 后台任务完成后以 `<task-notification>` 作为 followUp 投递给父会话（系统提示 rules 里由 task

package/dist/agents/result.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 结果的上限、落盘与通知文本（docs/wave5-plan.md §7.4，D23–D24）。[W5-G]
+ * 子 Agent 结果的上限、落盘与通知文本（docs/history/wave5-plan.md §7.4，D23–D24）。[W5-G]
  *
  * - 结果 > 50 KB（UTF-8 字节）保留头 70% + 尾 30%，中间一行说明省略了多少、全文在哪；
  * - 后台任务完成后以 `<task-notification>` 作为 followUp 投递给父会话（系统提示 rules 里由 task
@@ -63,7 +63,7 @@ export function taskNotification(input) {
         attrs.push(`outputFile="${attr(input.outputFile)}"`);
     return `<task-notification ${attrs.join(" ")}>\n${input.report}\n</task-notification>`;
 }
-// [W7-B1] 后台任务的固定英文文案（docs/agents-concurrency-plan.md §2.5；工具结果不进缓存前缀，但要
+// [W7-B1] 后台任务的固定英文文案（docs/history/agents-concurrency-plan.md §2.5；工具结果不进缓存前缀，但要
 // 稳定，便于测试与模型学习）。
 export const NOTIFY_HINT = "A <task-notification> arrives when it finishes; use task_ctl to wait, stop or read output.";
 export function startedText(taskId, agent) {

package/dist/agents/task-record.d.ts

@@ -1,6 +1,6 @@
 /**
  * 子 Agent 任务记录：并发池、单条任务的状态、runner 进度 → `subagent_update`、父会话
- * `custom{ama.task}` 快照的写入形状与 resume 重建（docs/wave5-plan.md §7.4–§7.5）。[W5-G]
+ * `custom{ama.task}` 快照的写入形状与 resume 重建（docs/history/wave5-plan.md §7.4–§7.5）。[W5-G]
  * 编排在 agent/subagent-registry.ts。
  */
 import type { SessionTaskStats, SubagentStartEvent, SubagentUpdateEvent } from "../agent/types-w5.js";
@@ -42,7 +42,7 @@ export interface AmaRunnerSpec {
 }
 /**
  * [W6-C0] 外部 Agent 的展示事件（`DriverEvent` 派生，子 Agent 视图用）：只在内存环形缓冲里（≤ 2000 条 /
- * 1 MB），不落盘（docs/wave6-plan.md §1.2、D2）。
+ * 1 MB），不落盘（docs/history/wave6-plan.md §1.2、D2）。
  */
 export interface ExternalDisplayEvent {
     at: number;
@@ -72,7 +72,7 @@ export type TaskHandle = RunnerHandle & {
      */
     message?(text: string, when: "followUp" | "send" | "interrupt"): Promise<void>;
 };
-/** [W6-A] 外部 Agent 环形缓冲的上限（docs/wave6-plan.md D2）。 */
+/** [W6-A] 外部 Agent 环形缓冲的上限（docs/history/wave6-plan.md D2）。 */
 export declare const RING_MAX_EVENTS = 2000;
 export declare const RING_MAX_BYTES: number;
 /**

package/dist/agents/task-record.js

@@ -1,6 +1,6 @@
 /**
  * 子 Agent 任务记录：并发池、单条任务的状态、runner 进度 → `subagent_update`、父会话
- * `custom{ama.task}` 快照的写入形状与 resume 重建（docs/wave5-plan.md §7.4–§7.5）。[W5-G]
+ * `custom{ama.task}` 快照的写入形状与 resume 重建（docs/history/wave5-plan.md §7.4–§7.5）。[W5-G]
  * 编排在 agent/subagent-registry.ts。
  */
 import { AmaError } from "../errors.js";
@@ -44,7 +44,7 @@ export class SubagentPool {
         this.waiters[0]?.();
     }
 }
-/** [W6-A] 外部 Agent 环形缓冲的上限（docs/wave6-plan.md D2）。 */
+/** [W6-A] 外部 Agent 环形缓冲的上限（docs/history/wave6-plan.md D2）。 */
 export const RING_MAX_EVENTS = 2000;
 export const RING_MAX_BYTES = 1024 * 1024;
 /**

package/dist/agents/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 定义契约（docs/wave5-plan.md §7.1–§7.2，D22）。[W5-C0] 契约文件，发现与解析归 W5-G。
+ * 子 Agent 定义契约（docs/history/wave5-plan.md §7.1–§7.2，D22）。[W5-C0] 契约文件，发现与解析归 W5-G。
  *
  * 定义文件：`--agent-dir`（可重复）→ profile `agentDirs` → `~/.config/ama/agents/*.md` →
  * `<cwd>/.ama/agents/*.md`（需信任）；frontmatter 与 Skill 同风格（kebab-case），正文追加到子会话

package/dist/agents/types.js

@@ -1,5 +1,5 @@
 /**
- * 子 Agent 定义契约（docs/wave5-plan.md §7.1–§7.2，D22）。[W5-C0] 契约文件，发现与解析归 W5-G。
+ * 子 Agent 定义契约（docs/history/wave5-plan.md §7.1–§7.2，D22）。[W5-C0] 契约文件，发现与解析归 W5-G。
  *
  * 定义文件：`--agent-dir`（可重复）→ profile `agentDirs` → `~/.config/ama/agents/*.md` →
  * `<cwd>/.ama/agents/*.md`（需信任）；frontmatter 与 Skill 同风格（kebab-case），正文追加到子会话

package/dist/ai/apis/anthropic-compat.d.ts

@@ -1,5 +1,5 @@
 /**
- * anthropic-messages 的 compat 推断（[W5-M2]，docs/wave5-plan.md §3.1、D10）：按请求主机给缺省。
+ * anthropic-messages 的 compat 推断（[W5-M2]，docs/history/wave5-plan.md §3.1、D10）：按请求主机给缺省。
  *
  * 顺序：保守缺省 ← 主机表（`model.baseUrl` 的主机名子串，先命中先用）← `provider.compat` ←
  * `model.compat`（字段级覆盖，undefined 不覆盖）。registry 物化后的模型已把供应商 / 渠道 compat 合进
@@ -14,7 +14,7 @@
  * - OpenRouter：流式 usage 只出现在 `message_delta`，`applyAnthropicUsage` 本就按非 null 字段合并，
  *   不需要开关（anthropic-compat.test.ts 核对）。
  *
- * 表里每一项都对应厂商文档或实测（docs/research/R1-models-protocols.md §2.1、docs/providers.md「渠道实测」）。
+ * 表里每一项都对应厂商文档或实测（docs/research/R1-models-protocols.md §2.1、docs/guides/providers.md「渠道实测」）。
  */
 import type { AnthropicMessagesCompat, Model, ProviderData } from "../types.js";
 export type ResolvedAnthropicCompat = Required<AnthropicMessagesCompat>;

package/dist/ai/apis/anthropic-compat.js

@@ -1,5 +1,5 @@
 /**
- * anthropic-messages 的 compat 推断（[W5-M2]，docs/wave5-plan.md §3.1、D10）：按请求主机给缺省。
+ * anthropic-messages 的 compat 推断（[W5-M2]，docs/history/wave5-plan.md §3.1、D10）：按请求主机给缺省。
  *
  * 顺序：保守缺省 ← 主机表（`model.baseUrl` 的主机名子串，先命中先用）← `provider.compat` ←
  * `model.compat`（字段级覆盖，undefined 不覆盖）。registry 物化后的模型已把供应商 / 渠道 compat 合进
@@ -14,7 +14,7 @@
  * - OpenRouter：流式 usage 只出现在 `message_delta`，`applyAnthropicUsage` 本就按非 null 字段合并，
  *   不需要开关（anthropic-compat.test.ts 核对）。
  *
- * 表里每一项都对应厂商文档或实测（docs/research/R1-models-protocols.md §2.1、docs/providers.md「渠道实测」）。
+ * 表里每一项都对应厂商文档或实测（docs/research/R1-models-protocols.md §2.1、docs/guides/providers.md「渠道实测」）。
  */
 export const ANTHROPIC_COMPAT_KEYS = [
     "supportsCacheControlOnTools",

package/dist/ai/apis/cache-params.d.ts

@@ -5,7 +5,7 @@
  * - `sendPromptCacheKey`、`supportsLongCacheRetention`：按 `HOST_CACHE_CAPABILITIES`（[W5-M2]，官方
  *   文档写明支持的主机才开；其余主机——含全部中转——缺省关）。`sendPromptCacheKey` 只对 OpenAI 两条线有意义；
  * - `sendSessionAffinityHeaders`、`supportsExplicitPromptCacheMode`：缺省一律关（实测中转都接受
- *   但未见命中提升，OpenRouter 未实测，见 docs/providers.md「缓存」）；
+ *   但未见命中提升，OpenRouter 未实测，见 docs/guides/providers.md「缓存」）；
  * - `cacheReporting`：`auto`。
  * 显式 `model.compat`（registry 已把 provider.compat 合进来）逐字段覆盖推断。
  *

package/dist/ai/apis/cache-params.js

@@ -5,7 +5,7 @@
  * - `sendPromptCacheKey`、`supportsLongCacheRetention`：按 `HOST_CACHE_CAPABILITIES`（[W5-M2]，官方
  *   文档写明支持的主机才开；其余主机——含全部中转——缺省关）。`sendPromptCacheKey` 只对 OpenAI 两条线有意义；
  * - `sendSessionAffinityHeaders`、`supportsExplicitPromptCacheMode`：缺省一律关（实测中转都接受
- *   但未见命中提升，OpenRouter 未实测，见 docs/providers.md「缓存」）；
+ *   但未见命中提升，OpenRouter 未实测，见 docs/guides/providers.md「缓存」）；
  * - `cacheReporting`：`auto`。
  * 显式 `model.compat`（registry 已把 provider.compat 合进来）逐字段覆盖推断。
  *

package/dist/ai/apis/chatgpt-backend.d.ts

@@ -1,5 +1,5 @@
 /**
- * openai-responses 的 ChatGPT 订阅后端（compat `chatgptBackend`；docs/wave6-plan.md §4.1、§4.6、D14、D17）。[W6-O]
+ * openai-responses 的 ChatGPT 订阅后端（compat `chatgptBackend`；docs/history/wave6-plan.md §4.1、§4.6、D14、D17）。[W6-O]
  *
  * - 请求体：强制 `store:false`、`stream:true`、`input` 数组；按后端删禁用字段（SIWC 15 个；codex 5 个，保留
  *   `prompt_cache_key`）；SIWC 不发 `role:"system"` item（改 developer）；`instructionsMode: "developer-message"`

package/dist/ai/apis/chatgpt-backend.js

@@ -1,5 +1,5 @@
 /**
- * openai-responses 的 ChatGPT 订阅后端（compat `chatgptBackend`；docs/wave6-plan.md §4.1、§4.6、D14、D17）。[W6-O]
+ * openai-responses 的 ChatGPT 订阅后端（compat `chatgptBackend`；docs/history/wave6-plan.md §4.1、§4.6、D14、D17）。[W6-O]
  *
  * - 请求体：强制 `store:false`、`stream:true`、`input` 数组；按后端删禁用字段（SIWC 15 个；codex 5 个，保留
  *   `prompt_cache_key`）；SIWC 不发 `role:"system"` item（改 developer）；`instructionsMode: "developer-message"`

package/dist/ai/apis/chatgpt-rate-limits.d.ts

@@ -1,5 +1,5 @@
 /**
- * ChatGPT 订阅配额解析（docs/wave6-plan.md §4.1 配额行、D17；R6 §1.2 配额三行）。[W6-O]
+ * ChatGPT 订阅配额解析（docs/history/wave6-plan.md §4.1 配额行、D17；R6 §1.2 配额三行）。[W6-O]
  *
  * - 响应头（codex flavor）：`x-codex-primary-used-percent` / `-window-minutes` / `-reset-at`（epoch 秒），
  *   `secondary` 同形；

package/dist/ai/apis/chatgpt-rate-limits.js

@@ -1,5 +1,5 @@
 /**
- * ChatGPT 订阅配额解析（docs/wave6-plan.md §4.1 配额行、D17；R6 §1.2 配额三行）。[W6-O]
+ * ChatGPT 订阅配额解析（docs/history/wave6-plan.md §4.1 配额行、D17；R6 §1.2 配额三行）。[W6-O]
  *
  * - 响应头（codex flavor）：`x-codex-primary-used-percent` / `-window-minutes` / `-reset-at`（epoch 秒），
  *   `secondary` 同形；

package/dist/ai/apis/max-tokens.d.ts

@@ -1,5 +1,5 @@
 /**
- * `max_tokens` 的主动收紧与被动修正（docs/model-efficiency-plan.md §1.9、D9）。[ME-C]
+ * `max_tokens` 的主动收紧与被动修正（docs/history/model-efficiency-plan.md §1.9、D9）。[ME-C]
  *
  * - 主动收紧：窗口已知时 `max_tokens = min(请求值, max(MIN_OUTPUT_TOKENS, 窗口 − 估算输入 − 余量))`，
  *   输入按请求体字符 / 4 估算（本模块自带，不依赖 compaction/）。预算型思考（`fixed`）不收紧：

package/dist/ai/apis/max-tokens.js

@@ -1,5 +1,5 @@
 /**
- * `max_tokens` 的主动收紧与被动修正（docs/model-efficiency-plan.md §1.9、D9）。[ME-C]
+ * `max_tokens` 的主动收紧与被动修正（docs/history/model-efficiency-plan.md §1.9、D9）。[ME-C]
  *
  * - 主动收紧：窗口已知时 `max_tokens = min(请求值, max(MIN_OUTPUT_TOKENS, 窗口 − 估算输入 − 余量))`，
  *   输入按请求体字符 / 4 估算（本模块自带，不依赖 compaction/）。预算型思考（`fixed`）不收紧：

package/dist/ai/apis/shared.d.ts

@@ -52,7 +52,7 @@ export declare function finishDone(stream: AssistantEventStreamImpl, tracker: Bl
 /** 出错或中止：关块、写 errorMessage、发 error（signal 已中止 → aborted）。 */
 export declare function finishError(stream: AssistantEventStreamImpl, tracker: BlockTracker, model: Model, error: unknown, signal: AbortSignal): void;
 /**
- * 供应商以安全理由拒答（Anthropic `stop_reason: "refusal"`，docs/acp-plan.md D12）：消息照旧以
+ * 供应商以安全理由拒答（Anthropic `stop_reason: "refusal"`，docs/history/acp-plan.md D12）：消息照旧以
  * `error` 收尾（TUI / print / 重试的口径不变），`rawStopReason` 记原值；需要区分的消费者（ACP 的
  * `refusal` 停止原因）用 {@link stopReasonOf}。这是 `refusal` 的唯一映射处。[ACP-B]
  */

package/dist/ai/apis/shared.js

@@ -189,7 +189,7 @@ export function finishError(stream, tracker, model, error, signal) {
     stream.push({ type: "error", reason: aborted ? "aborted" : "error", message: output });
 }
 /**
- * 供应商以安全理由拒答（Anthropic `stop_reason: "refusal"`，docs/acp-plan.md D12）：消息照旧以
+ * 供应商以安全理由拒答（Anthropic `stop_reason: "refusal"`，docs/history/acp-plan.md D12）：消息照旧以
  * `error` 收尾（TUI / print / 重试的口径不变），`rawStopReason` 记原值；需要区分的消费者（ACP 的
  * `refusal` 停止原因）用 {@link stopReasonOf}。这是 `refusal` 的唯一映射处。[ACP-B]
  */

package/dist/ai/image-intern.d.ts

@@ -1,5 +1,5 @@
 /**
- * 图片 base64 按内容哈希驻留（docs/memory-plan.md D5、§2.5）。
+ * 图片 base64 按内容哈希驻留（docs/history/memory-plan.md D5、§2.5）。
  *
  * `WeakRef` 的目标不能是字符串，所以驻留单元是 `ImageBlock`：表为 `Map<键, WeakRef<ImageBlock>>`，
  * 键 = `mimeType` + base64 字符串的 sha256；`FinalizationRegistry` 在 block 被回收后清键。命中时返回
@@ -10,7 +10,7 @@
  */
 import type { ImageBlock } from "./types.js";
 /**
- * 会话条目的最小形状：ai 不 import session（docs/design.md §1.1），`SessionEntry[]` 可直接传入。
+ * 会话条目的最小形状：ai 不 import session（docs/design/design.md §1.1），`SessionEntry[]` 可直接传入。
  * 只有 `type === "message"` 且 `message.content` 为数组的条目里的 `image` 块参与驻留。
  */
 export interface ImageCarrier {

package/dist/ai/image-intern.js

@@ -1,5 +1,5 @@
 /**
- * 图片 base64 按内容哈希驻留（docs/memory-plan.md D5、§2.5）。
+ * 图片 base64 按内容哈希驻留（docs/history/memory-plan.md D5、§2.5）。
  *
  * `WeakRef` 的目标不能是字符串，所以驻留单元是 `ImageBlock`：表为 `Map<键, WeakRef<ImageBlock>>`，
  * 键 = `mimeType` + base64 字符串的 sha256；`FinalizationRegistry` 在 block 被回收后清键。命中时返回

package/dist/ai/image-limits.d.ts

@@ -1,5 +1,5 @@
 /**
- * 图片大小上限（docs/wave5-plan.md §4、D11；R1 §3.2）。[W5-I]
+ * 图片大小上限（docs/history/wave5-plan.md §4、D11；R1 §3.2）。[W5-I]
  *
  * 各家的上限都按 **base64 后**的字节数计算：`base64Bytes = ceil(bytes / 3) * 4`。
  *

package/dist/ai/image-limits.js

@@ -1,5 +1,5 @@
 /**
- * 图片大小上限（docs/wave5-plan.md §4、D11；R1 §3.2）。[W5-I]
+ * 图片大小上限（docs/history/wave5-plan.md §4、D11；R1 §3.2）。[W5-I]
  *
  * 各家的上限都按 **base64 后**的字节数计算：`base64Bytes = ceil(bytes / 3) * 4`。
  *

package/dist/ai/json-body.d.ts

@@ -1,5 +1,5 @@
 /**
- * 请求体序列化（docs/memory-plan.md D3、§2.3）。
+ * 请求体序列化（docs/history/memory-plan.md D3、§2.3）。
  *
  * 带图请求体里 base64 占绝大部分字节；`JSON.stringify(body)` 会先拼出整份中间字符串，再由 fetch
  * 编码成 UTF-8。这里先廉价扫一遍：没有 ≥ {@link LARGE_STRING_BYTES} 的字符串就照旧走原生；有就只沿

package/dist/ai/json-body.js

@@ -1,5 +1,5 @@
 /**
- * 请求体序列化（docs/memory-plan.md D3、§2.3）。
+ * 请求体序列化（docs/history/memory-plan.md D3、§2.3）。
  *
  * 带图请求体里 base64 占绝大部分字节；`JSON.stringify(body)` 会先拼出整份中间字符串，再由 fetch
  * 编码成 UTF-8。这里先廉价扫一遍：没有 ≥ {@link LARGE_STRING_BYTES} 的字符串就照旧走原生；有就只沿