@zooique/memora 4.0.0 → 5.1.0

package/dist/agent/backgroundTasks.d.ts

@@ -42,7 +42,14 @@ export declare class BackgroundTaskRegistry {
     private listener;
     /** exit 钩子是否已注销（Agent 实例终态 shutdown 后置真，钩子空转防重复收割） */
     private disposed;
-    /** 进程退出兜底钩子（构造注册 / shutdown 注销，**配对**——防多实例钩子堆积） */
+    /**
+     * 进程退出兜底钩子（构造注册 / shutdown 注销，**配对**——防多实例钩子堆积）
+     *
+     * ⚠️ 已知代价（台账 `MULTI-AGENT-1` D8）：监听按**实例**注册 ⇒ 同进程**同时存活 >10 个**
+     * Agent 实例会触发 Node `MaxListenersExceededWarning`——仅警告、无功能损害（钩子 `disposed`
+     * 幂等空转，`close()`→`shutdown()` 配对注销即释放）。不引模块级共享钩子（= 回退单例、反 SSOT）、
+     * 不调 `setMaxListeners`（进程级调参有副作用）；触发 = 真实出现 >10 个并发存活项目。
+     */
     private readonly exitHook;
     constructor();
     /**

package/dist/agent/backgroundTasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundTasks.d.ts","sourceRoot":"","sources":["../../src/agent/backgroundTasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAEtC,oCAAoC;AACpC,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEnF,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED,4DAA4D;AAC5D,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,EAAE,WAAW,GAAG,UAAU,CAAC,CAAC;AAElG,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IAAE,MAAM,EAAE,2BAA2B,CAAA;CAAE,CAAC;AAE7F,iEAAiE;AACjE,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAW3E,qBAAa,sBAAsB;IACjC,8BAA8B;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,8BAA8B;IAC9B,OAAO,CAAC,GAAG,CAAK;IAChB,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAuC;IACvD,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAS;IAEzB,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAMvB;;IASF;;;;;OAKG;IACH,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI;IAIpE;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IA2BhE,+BAA+B;IAC/B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAK1C,8BAA8B;IAC9B,IAAI,IAAI,cAAc,EAAE;IAIxB;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,oBAAoB,CAAC;QAAC,MAAM,CAAC,EAAE,qBAAqB,CAAA;KAAE,GAAG,IAAI;IAS7F;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,IAAI,MAAM;IAUxB;;;;;;;;OAQG;IACH,QAAQ,IAAI,MAAM;IAOlB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,IAAI,cAAc,EAAE;IAW7B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,SAAS;IAWjB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAUxB,kEAAkE;IAClE,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,MAAM;IAUd,kCAAkC;IAClC,OAAO,CAAC,UAAU;CASnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAK9E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAK5E,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAYvE"}
+{"version":3,"file":"backgroundTasks.d.ts","sourceRoot":"","sources":["../../src/agent/backgroundTasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAEtC,oCAAoC;AACpC,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEnF,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED,4DAA4D;AAC5D,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,EAAE,WAAW,GAAG,UAAU,CAAC,CAAC;AAElG,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IAAE,MAAM,EAAE,2BAA2B,CAAA;CAAE,CAAC;AAE7F,iEAAiE;AACjE,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAW3E,qBAAa,sBAAsB;IACjC,8BAA8B;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,8BAA8B;IAC9B,OAAO,CAAC,GAAG,CAAK;IAChB,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAuC;IACvD,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAMvB;;IASF;;;;;OAKG;IACH,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI;IAIpE;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IA2BhE,+BAA+B;IAC/B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAK1C,8BAA8B;IAC9B,IAAI,IAAI,cAAc,EAAE;IAIxB;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,oBAAoB,CAAC;QAAC,MAAM,CAAC,EAAE,qBAAqB,CAAA;KAAE,GAAG,IAAI;IAS7F;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,IAAI,MAAM;IAUxB;;;;;;;;OAQG;IACH,QAAQ,IAAI,MAAM;IAOlB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,IAAI,cAAc,EAAE;IAW7B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,SAAS;IAWjB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAUxB,kEAAkE;IAClE,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,MAAM;IAUd,kCAAkC;IAClC,OAAO,CAAC,UAAU;CASnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAK9E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAK5E,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAYvE"}

package/dist/agent/backgroundTasks.js

@@ -25,7 +25,14 @@ export class BackgroundTaskRegistry {
     listener = null;
     /** exit 钩子是否已注销（Agent 实例终态 shutdown 后置真，钩子空转防重复收割） */
     disposed = false;
-    /** 进程退出兜底钩子（构造注册 / shutdown 注销，**配对**——防多实例钩子堆积） */
+    /**
+     * 进程退出兜底钩子（构造注册 / shutdown 注销，**配对**——防多实例钩子堆积）
+     *
+     * ⚠️ 已知代价（台账 `MULTI-AGENT-1` D8）：监听按**实例**注册 ⇒ 同进程**同时存活 >10 个**
+     * Agent 实例会触发 Node `MaxListenersExceededWarning`——仅警告、无功能损害（钩子 `disposed`
+     * 幂等空转，`close()`→`shutdown()` 配对注销即释放）。不引模块级共享钩子（= 回退单例、反 SSOT）、
+     * 不调 `setMaxListeners`（进程级调参有副作用）；触发 = 真实出现 >10 个并发存活项目。
+     */
     exitHook = () => {
         if (this.disposed)
             return; // Agent.close 已收割并注销，幂等空转

package/dist/agent/backgroundTasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundTasks.js","sourceRoot":"","sources":["../../src/agent/backgroundTasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backgroundTasks.js","sourceRoot":"","sources":["../../src/agent/backgroundTasks.ts"],"names":[],"mappings":"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"}

package/dist/agent/budget.d.ts

@@ -17,7 +17,7 @@ export declare const DEFAULT_ANCHOR_ANSWER_FACTOR = 1;
 export declare const MIN_RUNNABLE_DIALOGUE_TOKENS = 128;
 /** 预算计算入参 */
 export interface ContextBudgetInput {
-    /** 上下文窗口容量（token）：唯一真理源 = 宿主在构造内核前经 resolveContextWindow(window) 解析注入的单一数字（per-LLM 窗口，缺失回退默认 120K）。内核预算路径只消费单一数字，不认 provider/用户双层来源 */
+    /** 上下文窗口容量（token）：唯一真理源 = 宿主在构造内核前经 resolveContextWindow(window) 解析注入的单一数字（per-LLM 窗口，缺失回退 = AGENT_CONSTANTS.DEFAULT_MAX_CONTEXT_TOKENS，数字以该常量为真源、不在此落账）。内核预算路径只消费单一数字，不认 provider/用户双层来源 */
     readonly windowTokens: number;
     /** 固定开销（system+persona+rules+技能L1+工具schema，token） */
     readonly fixedOverheadTokens: number;
@@ -32,7 +32,8 @@ export interface ContextBudgetInput {
  * 解析有效上下文窗口（SSOT 单源公式，宿主在构造内核 Agent 前调用）。
  *
  * 唯一真理源 = 用户 per-LLM 配置的上下文上限（宿主装配时传入）；未配置 → 回退内核默认
- * DEFAULT_MAX_CONTEXT_TOKENS（120_000）。内核预算路径只吃单一数字 maxContextTokens，
+ * AGENT_CONSTANTS.DEFAULT_MAX_CONTEXT_TOKENS（数字以该常量为真源，不在此落账——真源改值时
+ * 注释不跟随会变撒谎）。内核预算路径只吃单一数字 maxContextTokens，
  * 不认 provider/用户双来源、不施加全局封顶——用户对自己填写的参数负责。
  */
 export declare function resolveContextWindow(window?: number): number;
@@ -50,8 +51,11 @@ export interface ContextBudget {
 /**
  * 上下文占用快照（真实用量，供输入区指示器展示；与 `ContextBudget` 的「预算上限」互补）。
  *
- * 设计：各段为 prepare 期**实际占用** token，互斥分段拼满整个窗口容量 `totalTokens`：
- *   角色包基础设定(system) | 完整对话 | 当前输入锚点 | 输出预留 | 剩余。
+ * 设计：各段为当前工作记忆的**实际占用** token，互斥分段拼满整个窗口容量 `totalTokens`：
+ *   角色包基础设定(system) | 动态注入(system) | 完整对话 | 当前输入锚点 | 输出预留 | 剩余。
+ * 「动态注入」= `messages[0]` 之外的**全部** system 消息（最近对话块 / 情报区 / 任务表 /
+ *   软上限与压力提示 / 搜索收敛提示 / 反思与自审查提示等运行时注入）——必须计入占用，
+ *   否则 free 系统性偏大、指示器偏乐观（用户按圆环判断"还能贴多少"必踩坑）。
  * 单一真理源 = 内核 prepare 计算（contextPreparer 经 loop.recordOccupancy 写入），
  * 宿主/webview 只渲染、不重算。free 非负收敛（窗口过小/输入过大时各段归零，free 不出现负值）。
  */
@@ -60,7 +64,14 @@ export interface ContextOccupancy {
     readonly totalTokens: number;
     /** 角色包/系统基础设定占用（system prompt：persona + rules + 技能 L1 + 工具 schema） */
     readonly rolePackBaseTokens: number;
-    /** 完整对话层实际占用（最近轮次注入正文 token） */
+    /**
+     * 动态注入占用（`messages[0]` 之外的 system 消息：最近对话块 / 情报区 / 任务表 /
+     * 软上限与压力提示 / 搜索收敛提示 / 反思与自审查提示等运行时注入）。
+     *
+     * 此前该段未计入任何分段、被静默算进 free ⇒ 指示器偏乐观（P1-1 修复）。
+     */
+    readonly dynamicSystemTokens: number;
+    /** 完整对话层实际占用（全量 user+assistant 问答闭环 token） */
     readonly dialogueTokens: number;
     /** 完整对话层注入的对话条数（user+assistant 消息总数；条数与 token 并存供宿主 hover 明细展示） */
     readonly dialogueCount: number;
@@ -77,6 +88,13 @@ export interface EstimateOccupancyInput {
     readonly totalTokens: number;
     /** 角色包/系统基础设定占用（system prompt 固定开销） */
     readonly rolePackBaseTokens: number;
+    /**
+     * 动态注入占用（`messages[0]` 之外的 system 消息）。
+     *
+     * **必填**（非可选默认 0）：漏填即 free 系统性偏大、指示器偏乐观——正是本段要根治的伤。
+     * 运行时路径由 `loop.getDynamicSystemTokens()` 提供；历史会话重算（无系统注入）显式传 0。
+     */
+    readonly dynamicSystemTokens: number;
     /** 完整对话层 token */
     readonly dialogueTokens: number;
     /** 完整对话层条数 */

package/dist/agent/budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/agent/budget.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/agent/budget.ts"],"names":[],"mappings":"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"}

package/dist/agent/budget.js

@@ -39,7 +39,8 @@ export const MIN_RUNNABLE_DIALOGUE_TOKENS = 128;
  * 解析有效上下文窗口（SSOT 单源公式，宿主在构造内核 Agent 前调用）。
  *
  * 唯一真理源 = 用户 per-LLM 配置的上下文上限（宿主装配时传入）；未配置 → 回退内核默认
- * DEFAULT_MAX_CONTEXT_TOKENS（120_000）。内核预算路径只吃单一数字 maxContextTokens，
+ * AGENT_CONSTANTS.DEFAULT_MAX_CONTEXT_TOKENS（数字以该常量为真源，不在此落账——真源改值时
+ * 注释不跟随会变撒谎）。内核预算路径只吃单一数字 maxContextTokens，
  * 不认 provider/用户双来源、不施加全局封顶——用户对自己填写的参数负责。
  */
 export function resolveContextWindow(window) {
@@ -56,11 +57,16 @@ export function resolveContextWindow(window) {
 export function estimateOccupancy(input) {
     const outputReserveRatio = input.outputReserveRatio ?? DEFAULT_OUTPUT_RESERVE_RATIO;
     const outputReserveTokens = Math.floor(input.totalTokens * outputReserveRatio);
-    const usedBeforeFree = input.rolePackBaseTokens + input.dialogueTokens + input.inputAnchorTokens + outputReserveTokens;
+    const usedBeforeFree = input.rolePackBaseTokens +
+        input.dynamicSystemTokens +
+        input.dialogueTokens +
+        input.inputAnchorTokens +
+        outputReserveTokens;
     const freeTokens = Math.max(0, input.totalTokens - usedBeforeFree);
     return {
         totalTokens: input.totalTokens,
         rolePackBaseTokens: input.rolePackBaseTokens,
+        dynamicSystemTokens: input.dynamicSystemTokens,
         dialogueTokens: input.dialogueTokens,
         dialogueCount: input.dialogueCount,
         inputAnchorTokens: input.inputAnchorTokens,

package/dist/agent/budget.js.map

@@ -1 +1 @@
-{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/agent/budget.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/agent/budget.ts"],"names":[],"mappings":"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"}

package/dist/agent/builtinToolHandlers.d.ts

@@ -2,8 +2,28 @@ import type { SecurityGuard } from '../security/pathGuard.js';
 import type { IMemoryStorage } from '../memory/storageInterface.js';
 import type { ISessionStore } from '../memory/sessionStore.js';
 import type { WriteExtensions } from '../agent/toolExecutor.js';
+import type { BackgroundTaskScheduler } from '../utils/backgroundTask.js';
+import type { AgentEventMap } from '../utils/eventEmitter.js';
 import type { MemoryInspector } from '../agent/managers/memoryInspector.js';
 import type { LlmProvider } from '../llm/provider.js';
+/**
+ * 脚本文件读取最大长度（run_code script_path 模式）
+ *
+ * 脚本代码要原样交给执行器，截断会破坏语法——故超限**直接报错**（不静默截断）。
+ * 与 read_file 不同：read_file 走 token 预算分段
+ * （LOOP_CONSTANTS.SINGLE_TOOL_RESULT_MAX_TOKENS），不使用字符上限，
+ * 故本常量与 read_file 不在同一量纲，无「谁更宽松」的可比关系。
+ *
+ * 消费面两处（CMD-1-CONTENT 起）：`readScriptFile`（run_code / run_project_script
+ * 的读取与裁决读）+ toolExecutor 的 run_skill_script 确认点读（技能脚本正文裁决）。
+ * 三者共用本常量 = 脚本正文预算唯一上限，禁为技能脚本单造第二套。
+ *
+ * 与 utils/fileSafe.DEFAULT_MAX_CONTENT_LEN 同为 200_000 属**异义同值**，勿误合并：
+ *   - 本常量：脚本原样读取上限（超限报错，内容交执行器）；
+ *   - DEFAULT_MAX_CONTENT_LEN：内容文件读取上限（超限截断，内容入上下文）。
+ * 两者各自独立演进，改一侧不联动另一侧。
+ */
+export declare const SCRIPT_READ_MAX_LEN = 200000;
 /**
  * 内置文件工具忽略的目录/文件名（模块级单一真理源）
  *
@@ -44,9 +64,17 @@ export declare class BuiltinToolHandlers {
     constructor(projectPath: string, security: SecurityGuard, memoryIndex: IMemoryStorage, sessionStore?: ISessionStore | undefined);
     /** 记忆搜索器（search_memories 语义后端，装配期注入；未注入时回退关键词 memoryIndex.search） */
     private memoryInspector;
+    /**
+     * 后台任务槽位调度器（装配期注入，与 SeedDeps 的调度器**同一实例**）：
+     * search_memories 命中即 touch 经此 fire-and-forget，共享 Agent 实例的 5 槽限流，
+     * 并纳入 close() 单点等待。未注入时 touch 静默跳过（与 onMemoryRecalled?.() 同款可选链，
+     * 保持「内置工具可被测试/脚本直调、无宿主即 no-op」语义）。
+     */
+    private backgroundTasks;
     /** 当前会话「正文或摘要已在眼前」的轮次提供者（装配期注入；search_memories 用它与装配期内容互斥） */
     private exclusionRoundIdsProvider;
-    /** memoryRecalled 事件发射回调（宿主感知「LLM 查询记忆命中 N 条」；装配期注入，缺省不发射） */
+    /** memoryRecalled 事件发射回调（宿主感知「LLM 查询记忆命中 N 条」；装配期注入，缺省不发射）。
+     * 载荷类型引用 AgentEventMap 单一真源（不内联复制，防与 eventEmitter 定义漂移）。 */
     private onMemoryRecalled;
     /**
      * 注入 MemoryInspector，启用 search_memories 的纯关键词搜索后端（memory-tool-recall-design §3.3）。
@@ -60,10 +88,7 @@ export declare class BuiltinToolHandlers {
      * **唯一触发位**：全库仅本类 emit memoryRecalled（无其他发射点）。
      * 缺省不注入则静默跳过（内置工具也可被测试/脚本直调，无宿主时 no-op）。
      */
-    setOnMemoryRecalled(callback: (info: {
-        count: number;
-        query: string;
-    }) => void): void;
+    setOnMemoryRecalled(callback: (info: AgentEventMap['memoryRecalled']) => void): void;
     /**
      * 注入召回互斥排除集提供者（memory-tool-recall-design §5.1 工具互斥）。
      * search_memories 用它排除「正文或摘要已在眼前」轮次的 round-summary，避免与装配期内容重复。
@@ -72,6 +97,14 @@ export declare class BuiltinToolHandlers {
      * 缺省不注入则不过滤（保持测试/独立调用可直接触发）。
      */
     setExclusionRoundIdsProvider(provider: () => ReadonlySet<string>): void;
+    /**
+     * 注入后台任务槽位调度器（装配期注入，与 SeedDeps 的调度器同一实例）。
+     * 装配依赖 loop/history，toolExec 在 assembler 中先于它构造，故用「构造后注入」而非构造参数。
+     * 注入后 search_memories 命中 touch 走实例级限流，并纳入 Agent.close() 等待；未注入则 touch 静默跳过。
+     *
+     * @param scheduler Agent 实例级后台任务调度器
+     */
+    setBackgroundTaskScheduler(scheduler: BackgroundTaskScheduler): void;
     /**
      * 解析相对路径为绝对路径
      *
@@ -145,9 +178,12 @@ export declare class BuiltinToolHandlers {
      * 仅做路径白名单校验 + 长度上限（SCRIPT_READ_MAX_LEN，防超大脚本滥用）。
      *
      * @param relativePath 相对项目根的文件路径
+     * @param label 调用面标识（默认 `run_code script_path`）。错误文案要说清"是哪个工具的
+     *   脚本"——裁决面（run_project_script 也复用本函数读正文做内容裁决）与执行面可能不同，
+     *   写死 run_code 会让项目脚本报出"run_code 脚本文件过长"（说谎）。
      * @returns 脚本文件原始内容
      */
-    readScriptFile(relativePath: string): Promise<string>;
+    readScriptFile(relativePath: string, label?: string): Promise<string>;
     /**
      * 删除项目文件（供 delete_file 工具）
      *
@@ -176,7 +212,7 @@ export declare class BuiltinToolHandlers {
      * @param relativePath 相对项目根的文件路径
      * @param content 要写入的内容
      * @param extensions 写入扩展（可选，用于 diff 确认等）
-     * @param mode 写入模式（合法值集 = WriteFileMode 类型，派生自 WRITE_FILE_MODES），默认 "overwrite"
+     * @param mode 写入模式（合法值集 = WriteFileMode 类型，派生自 WRITE_FILE_MODES），默认取 DEFAULT_WRITE_FILE_MODE
      * @param insertLine insert 模式下的目标行号（从 1 开始），省略则插入到末尾
      * @param oldString replace 模式下的被替换文本（须在旧内容中唯一出现）
      */
@@ -215,14 +251,18 @@ export declare class BuiltinToolHandlers {
      * @param query 搜索关键词
      * @param limitStr 返回数量上限
      * @param modeStr 搜索模式："match"（任一命中，默认）或 "near"（全部命中）
+     * @param toolCallId 本次 tool_call 唯一 ID（可选 · 宿主配对通道，MEM-EVENT-2）：原样透传进
+     *   memoryRecalled 载荷，供宿主把命中明细挂回对应工具折叠块。缺省 = 载荷不带该字段，
+     *   宿主回退轮次级兜底落位（测试/直调均可省略，不新造默认值）。
      */
-    searchMemories(query: string, limitStr: string, modeStr: string): Promise<string>;
+    searchMemories(query: string, limitStr: string, modeStr: string, toolCallId?: string): Promise<string>;
     /**
      * 命中即 touch：fire-and-forget 刷新命中记忆的 accessedAt（不涉及任何重要度字段）。
      *
      * 收敛到 keywordsTouch.ts 的单一真理源 touchScores（§5.2 只 touch 不加权，内部只调 storage.touch）——
-     * 不为工具命中另造写分路径。backgroundTask 保证 fire-and-forget 不阻塞搜索返回，
-     * 且统一并发限流；失败兜底记日志即可（touch 是排序副作用，非主线流程）。
+     * 不为工具命中另造写分路径。实例级调度器保证 fire-and-forget 不阻塞搜索返回，
+     * 且统一并发限流（同一 Agent 实例 5 槽）；失败兜底记日志即可（touch 是排序副作用，非主线流程）。
+     * 调度器未注入（测试/独立调用）→ 静默跳过 touch，不另造无主 Promise。
      *
      * @param hits 搜索命中项（取其 id 定位，实际写入交由 touchScores 收敛）
      */

package/dist/agent/builtinToolHandlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtinToolHandlers.d.ts","sourceRoot":"","sources":["../../src/agent/builtinToolHandlers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builtinToolHandlers.d.ts","sourceRoot":"","sources":["../../src/agent/builtinToolHandlers.ts"],"names":[],"mappings":"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"}

package/dist/agent/builtinToolHandlers.js

@@ -29,9 +29,8 @@ import { splitSessionId } from '../utils/time.js';
 // 越界提示前缀同源引入——loop 台账写侧据此识别「提示串非正文」不记账，防两侧前缀漂移
 import { formatSegmentationFooter, READ_FILE_NOTICE_PREFIX } from '../agent/toolLedger.js';
 // write_file 写入模式单一真理源（schema 描述与 handler 校验共用，避免双源漂移）
-import { WRITE_FILE_MODES, isWriteFileMode } from '../agent/builtinTools.js';
+import { DEFAULT_WRITE_FILE_MODE, WRITE_FILE_MODES, isWriteFileMode, } from '../agent/builtinTools.js';
 import { sanitizeExternalText, stripControlChars } from '../agent/toolExecutor.js';
-import { backgroundTask } from '../utils/backgroundTask.js';
 import { touchScores } from '../memory/keywordsTouch.js';
 import { AGENT_CONSTANTS, LOOP_CONSTANTS } from '../agent/constants.js';
 // token 估算唯一真理源（CJK 感知）——read_file 的分段预算与上下文占用/截断同口径
@@ -83,12 +82,16 @@ function clampCharsToTokenBudget(line, budget) {
  * （LOOP_CONSTANTS.SINGLE_TOOL_RESULT_MAX_TOKENS），不使用字符上限，
  * 故本常量与 read_file 不在同一量纲，无「谁更宽松」的可比关系。
  *
+ * 消费面两处（CMD-1-CONTENT 起）：`readScriptFile`（run_code / run_project_script
+ * 的读取与裁决读）+ toolExecutor 的 run_skill_script 确认点读（技能脚本正文裁决）。
+ * 三者共用本常量 = 脚本正文预算唯一上限，禁为技能脚本单造第二套。
+ *
  * 与 utils/fileSafe.DEFAULT_MAX_CONTENT_LEN 同为 200_000 属**异义同值**，勿误合并：
  *   - 本常量：脚本原样读取上限（超限报错，内容交执行器）；
  *   - DEFAULT_MAX_CONTENT_LEN：内容文件读取上限（超限截断，内容入上下文）。
  * 两者各自独立演进，改一侧不联动另一侧。
  */
-const SCRIPT_READ_MAX_LEN = 200_000;
+export const SCRIPT_READ_MAX_LEN = 200_000;
 /**
  * 内置文件工具忽略的目录/文件名（模块级单一真理源）
  *
@@ -144,9 +147,17 @@ export class BuiltinToolHandlers {
     }
     /** 记忆搜索器（search_memories 语义后端，装配期注入；未注入时回退关键词 memoryIndex.search） */
     memoryInspector = null;
+    /**
+     * 后台任务槽位调度器（装配期注入，与 SeedDeps 的调度器**同一实例**）：
+     * search_memories 命中即 touch 经此 fire-and-forget，共享 Agent 实例的 5 槽限流，
+     * 并纳入 close() 单点等待。未注入时 touch 静默跳过（与 onMemoryRecalled?.() 同款可选链，
+     * 保持「内置工具可被测试/脚本直调、无宿主即 no-op」语义）。
+     */
+    backgroundTasks = null;
     /** 当前会话「正文或摘要已在眼前」的轮次提供者（装配期注入；search_memories 用它与装配期内容互斥） */
     exclusionRoundIdsProvider = null;
-    /** memoryRecalled 事件发射回调（宿主感知「LLM 查询记忆命中 N 条」；装配期注入，缺省不发射） */
+    /** memoryRecalled 事件发射回调（宿主感知「LLM 查询记忆命中 N 条」；装配期注入，缺省不发射）。
+     * 载荷类型引用 AgentEventMap 单一真源（不内联复制，防与 eventEmitter 定义漂移）。 */
     onMemoryRecalled = null;
     /**
      * 注入 MemoryInspector，启用 search_memories 的纯关键词搜索后端（memory-tool-recall-design §3.3）。
@@ -175,6 +186,16 @@ export class BuiltinToolHandlers {
     setExclusionRoundIdsProvider(provider) {
         this.exclusionRoundIdsProvider = provider;
     }
+    /**
+     * 注入后台任务槽位调度器（装配期注入，与 SeedDeps 的调度器同一实例）。
+     * 装配依赖 loop/history，toolExec 在 assembler 中先于它构造，故用「构造后注入」而非构造参数。
+     * 注入后 search_memories 命中 touch 走实例级限流，并纳入 Agent.close() 等待；未注入则 touch 静默跳过。
+     *
+     * @param scheduler Agent 实例级后台任务调度器
+     */
+    setBackgroundTaskScheduler(scheduler) {
+        this.backgroundTasks = scheduler;
+    }
     // ─── 路径安全（内置 + 自定义工具共享） ──────────────────────────
     /**
      * 解析相对路径为绝对路径
@@ -369,20 +390,27 @@ export class BuiltinToolHandlers {
      * 仅做路径白名单校验 + 长度上限（SCRIPT_READ_MAX_LEN，防超大脚本滥用）。
      *
      * @param relativePath 相对项目根的文件路径
+     * @param label 调用面标识（默认 `run_code script_path`）。错误文案要说清"是哪个工具的
+     *   脚本"——裁决面（run_project_script 也复用本函数读正文做内容裁决）与执行面可能不同，
+     *   写死 run_code 会让项目脚本报出"run_code 脚本文件过长"（说谎）。
      * @returns 脚本文件原始内容
      */
-    async readScriptFile(relativePath) {
+    async readScriptFile(relativePath, label = 'run_code script_path') {
         if (!relativePath) {
-            throw toolError('run_code script_path 参数缺失', 'LLM 未传 script_path', ['script_path 不能为空'], undefined, ToolErrorCode.ARGUMENT_ERROR);
+            throw toolError(`${label} 参数缺失`, 'LLM 未传 script_path', ['script_path 不能为空'], undefined, ToolErrorCode.ARGUMENT_ERROR);
         }
         const absolutePath = this.resolveSafePath(relativePath);
-        this.guardPathOrThrow(absolutePath, 'run_code');
+        // 审计的 tool 名 = 调用面：run_project_script 复用本函数读正文做裁决时，写死 'run_code'
+        // 会把项目脚本的路径审计记到 run_code 头上（归属说谎）⇒ 传 label。
+        this.guardPathOrThrow(absolutePath, label);
         // 读前预检：目标是目录时给出可执行指引（脚本语义是文件）
-        await this.assertFileNotDir(absolutePath, relativePath, 'run_code script_path', '传入脚本文件路径');
+        // tool 名传 label（调用面）：路径审计要能看出这次读是谁发起的，写死 'run_code'
+        // 会让 run_project_script 的裁决读记到 run_code 头上（审计归属说谎）。
+        await this.assertFileNotDir(absolutePath, relativePath, label, '传入脚本文件路径');
         try {
             const content = await readFile(absolutePath, 'utf-8');
             if (content.length > SCRIPT_READ_MAX_LEN) {
-                throw toolError('run_code 脚本文件过长', `脚本超过 ${SCRIPT_READ_MAX_LEN} 字符上限`, ['精简脚本或拆分为多个文件'], undefined, ToolErrorCode.ARGUMENT_ERROR);
+                throw toolError(`${label} 脚本文件过长`, `脚本超过 ${SCRIPT_READ_MAX_LEN} 字符上限`, ['精简脚本或拆分为多个文件'], undefined, ToolErrorCode.ARGUMENT_ERROR);
             }
             return content;
         }
@@ -391,9 +419,9 @@ export class BuiltinToolHandlers {
                 throw err;
             const e = toError(err);
             if (isNodeErrorCode(err, 'ENOENT')) {
-                throw toolError('run_code 脚本文件不存在', `${absolutePath}：文件不存在`, ['确认 script_path 正确', '先 write_file 创建脚本再执行'], e, ToolErrorCode.FILE_NOT_FOUND);
+                throw toolError(`${label} 脚本文件不存在`, `${absolutePath}：文件不存在`, ['确认 script_path 正确', '先 write_file 创建脚本再执行'], e, ToolErrorCode.FILE_NOT_FOUND);
             }
-            throw toolError('run_code 读取脚本失败', `${absolutePath}：${e.message}`, ['确认文件可读'], e, ToolErrorCode.UNKNOWN);
+            throw toolError(`${label} 读取脚本失败`, `${absolutePath}：${e.message}`, ['确认文件可读'], e, ToolErrorCode.UNKNOWN);
         }
     }
     /**
@@ -464,11 +492,11 @@ export class BuiltinToolHandlers {
      * @param relativePath 相对项目根的文件路径
      * @param content 要写入的内容
      * @param extensions 写入扩展（可选，用于 diff 确认等）
-     * @param mode 写入模式（合法值集 = WriteFileMode 类型，派生自 WRITE_FILE_MODES），默认 "overwrite"
+     * @param mode 写入模式（合法值集 = WriteFileMode 类型，派生自 WRITE_FILE_MODES），默认取 DEFAULT_WRITE_FILE_MODE
      * @param insertLine insert 模式下的目标行号（从 1 开始），省略则插入到末尾
      * @param oldString replace 模式下的被替换文本（须在旧内容中唯一出现）
      */
-    async writeFile(relativePath, content, extensions, mode = 'overwrite', insertLine, oldString) {
+    async writeFile(relativePath, content, extensions, mode = DEFAULT_WRITE_FILE_MODE, insertLine, oldString) {
         if (!relativePath) {
             throw toolError('write_file 工具调用缺少 path 参数', 'LLM 未传 path', ['检查 personality.md 是否明确了 write_file 用法'], undefined, ToolErrorCode.ARGUMENT_ERROR);
         }
@@ -740,8 +768,11 @@ export class BuiltinToolHandlers {
      * @param query 搜索关键词
      * @param limitStr 返回数量上限
      * @param modeStr 搜索模式："match"（任一命中，默认）或 "near"（全部命中）
+     * @param toolCallId 本次 tool_call 唯一 ID（可选 · 宿主配对通道，MEM-EVENT-2）：原样透传进
+     *   memoryRecalled 载荷，供宿主把命中明细挂回对应工具折叠块。缺省 = 载荷不带该字段，
+     *   宿主回退轮次级兜底落位（测试/直调均可省略，不新造默认值）。
      */
-    async searchMemories(query, limitStr, modeStr) {
+    async searchMemories(query, limitStr, modeStr, toolCallId) {
         if (!query) {
             throw toolError('search_memories 工具调用缺少 query 参数', 'LLM 未传 query', ['query 不能为空'], undefined, ToolErrorCode.ARGUMENT_ERROR);
         }
@@ -790,9 +821,24 @@ export class BuiltinToolHandlers {
         // 只 touch 不加权（§5.2 定案）：accessedAt 是「使用轨迹」唯一事实源，touchScores 内部只调 storage.touch
         // 刷新访问时间、不写任何重要度字段——命中 = 被 LLM 想起，仅用于排序，不做记忆强化加权。查询低频，无自反馈（自动注入退役后根除正反馈）。
         this.touchHits(hits);
-        // memoryRecalled 事件（§2.4「保留改语义」定案）：LLM 查询记忆命中 N 条 → 宿主感知提示。
-        // 唯一发射位：此处是全库唯一 emit。
-        this.onMemoryRecalled?.({ count: hits.length, query });
+        // memoryRecalled 事件（§2.4「保留改语义」定案；4.1.0 MEM-EVENT-1 载荷扩展）：LLM 查询记忆
+        // 命中 N 条 → 宿主感知提示 + 命中明细（id/name/source/contentPreview，宿主 S3-1 可展开行渲染 /
+        // S3-3 反馈寻址）。contentPreview 5.0.0 起携带（宿主命中行按用户心智显示内容）。
+        // 唯一发射位：此处是全库唯一 emit。明细取自现成搜索结果（零新增查询）；条数上限由
+        // parseLimit 钳制（50）单点保证，此处全量映射不截断（不另立截断常量）。
+        this.onMemoryRecalled?.({
+            count: hits.length,
+            query,
+            hits: hits.map((h) => ({
+                id: h.id,
+                name: h.name,
+                source: h.source,
+                contentPreview: h.contentPreview,
+            })),
+            // 条件展开而非 `toolCallId` 恒在：缺省时载荷不出现该键（老内核载荷形态零变化，
+            // 消费方按「键存在」分流配对/兜底两条路径，不靠 undefined 嗅探）。
+            ...(toolCallId ? { toolCallId } : {}),
+        });
         const lines = hits.map((m, i) => {
             const preview = truncate(m.contentPreview ?? '', 80);
             const access = m.accessedAt ? ` accessedAt=${m.accessedAt}` : '';
@@ -809,15 +855,16 @@ export class BuiltinToolHandlers {
      * 命中即 touch：fire-and-forget 刷新命中记忆的 accessedAt（不涉及任何重要度字段）。
      *
      * 收敛到 keywordsTouch.ts 的单一真理源 touchScores（§5.2 只 touch 不加权，内部只调 storage.touch）——
-     * 不为工具命中另造写分路径。backgroundTask 保证 fire-and-forget 不阻塞搜索返回，
-     * 且统一并发限流；失败兜底记日志即可（touch 是排序副作用，非主线流程）。
+     * 不为工具命中另造写分路径。实例级调度器保证 fire-and-forget 不阻塞搜索返回，
+     * 且统一并发限流（同一 Agent 实例 5 槽）；失败兜底记日志即可（touch 是排序副作用，非主线流程）。
+     * 调度器未注入（测试/独立调用）→ 静默跳过 touch，不另造无主 Promise。
      *
      * @param hits 搜索命中项（取其 id 定位，实际写入交由 touchScores 收敛）
      */
     touchHits(hits) {
         if (hits.length === 0)
             return;
-        backgroundTask('search_memories.touch', () => touchScores(this.memoryIndex, hits.map((h) => h.id)));
+        this.backgroundTasks?.schedule('search_memories.touch', () => touchScores(this.memoryIndex, hits.map((h) => h.id)));
     }
     /**
      * `search_memories` 响应性护栏包装：给整次记忆搜索设上限。