@zooique/memora 3.0.1 → 5.0.0

package/dist/utils/backgroundTask.d.ts

@@ -1,38 +1,60 @@
-/** 后台任务累计统计快照（宿主读后台健康度，纯只读） */
-export interface BackgroundTaskStats {
-    /** 在途任务数（含排队中的） */
-    pending: number;
-    /** 成功完成数（累计） */
-    completed: number;
-    /** 失败数（累计，未被业务侧消化的） */
-    failed: number;
-}
-/**
- * 启动一个后台任务（不阻塞调用方）。统一计数 + 兜底失败日志 + 并发槽位控制。
- * 保留「调用即纳入在途计数」的契约——无论立即执行还是排队等待。
- *
- * @param label 任务标签（日志/观测区分用途）
- * @param factory 返回业务 Promise 的工厂；内部不要自行 `catch`，交给本门面统一兜底计数
- * @param onFailure 失败时的业务侧补救（如宿主事件 emit）；缺省仅记日志
- */
-export declare function backgroundTask(label: string, factory: () => Promise<unknown>, onFailure?: (err: unknown) => void): void;
-/** 读取后台任务累计统计快照（只读副本，宿主可观测后台健康度） */
-export declare function getBackgroundTaskStats(): BackgroundTaskStats;
 /**
- * 等待所有在途后台任务完成（带超时保护，防止任务永不返回阻塞 close）。
- * Agent.close() 必须调用此函数——否则后台命中刷新/摘要生成等任务可能在 storage 关闭后 upsert 失效。
+ * 后台任务槽位调度器（实例级）
  *
- * @param timeoutMs 超时时间（毫秒），默认 5000ms
- * @returns **等待开始时**的在途任务数（0 = 进入本函数时无在途任务）。
- *   ⚠️ 该值是「曾经在途」而非「已等到完成」：超时放弃剩余任务时返回值仍为初始在途数，
- *   不代表实际完成数。调用方据此判断「是否有在途任务」是正确的（如 `Agent.close()` 的
- *   `awaited > 0`），但**不可当作已完成计数**使用。
+ * 每实例持有独立的并发计数与排队队列。由装配期创建，归属 Agent 实例：
+ * 经 SeedDeps（摘要/命名）+ BuiltinToolHandlers（命中 touch）注入，close() 时等待/清场。
  */
-export declare function awaitBackgroundTasks(timeoutMs?: number): Promise<number>;
-/**
- * 重置模块级状态（仅测试使用，生产代码禁止调用）。
- * 清理 activeCount、pendingQueue、stats，确保测试用例间状态隔离。
- * @internal
- */
-export declare function _resetBackgroundTaskState(): void;
+export declare class BackgroundTaskScheduler {
+    /** 当前正在执行的任务数（不含排队中的） */
+    private activeCount;
+    /** 排队等待执行的任务（FIFO） */
+    private pendingQueue;
+    /** 在途任务数（调用即纳入在途计数，无论立即执行还是排队等待） */
+    private pendingCount;
+    /**
+     * 启动一个后台任务（不阻塞调用方）。统一计数 + 兜底失败日志 + 并发槽位控制。
+     * 保留「调用即纳入在途计数」的契约——无论立即执行还是排队等待。
+     *
+     * @param label 任务标签（日志/观测区分用途）
+     * @param factory 返回业务 Promise 的工厂；内部不要自行 `catch`，交给本门面统一兜底计数
+     * @param onFailure 失败时的业务侧补救（如宿主事件 emit）；缺省仅记日志
+     */
+    schedule(label: string, factory: () => Promise<unknown>, onFailure?: (err: unknown) => void): void;
+    /**
+     * 等待所有在途后台任务完成（带超时保护，防止任务永不返回阻塞 close）。
+     * Agent.close() 必须调用此方法——否则后台命中刷新/摘要生成等任务可能在 storage 关闭后 upsert 失效。
+     *
+     * @param timeoutMs 超时时间（毫秒），默认 5000ms
+     * @returns **等待开始时**的在途任务数（0 = 进入本函数时无在途任务）。
+     *   ⚠️ 该值是「曾经在途」而非「已等到完成」：超时放弃剩余任务时返回值仍为初始在途数，
+     *   不代表实际完成数。调用方据此判断「是否有在途任务」是正确的（如 `Agent.close()` 的
+     *   `awaited > 0`），但**不可当作已完成计数**使用。
+     */
+    awaitPending(timeoutMs?: number): Promise<number>;
+    /**
+     * 取消**尚未启动**的排队任务（丢弃队列，不中断在途任务）。
+     *
+     * 用途：close() 在 awaitPending 超时后调用，防止「关后仍从队列启动任务 → 写已关 storage」。
+     * ⚠️ 语义边界（勿外溢）：本方法**只清未启动队列**（pendingQueue），**不中断（不可中断）已在途任务**——
+     * 在途任务仍会跑完并各自计数回落；此处**不承诺**「关后不再有任何后台写入」。
+     *
+     * @returns 被丢弃的排队任务数（已计入 pendingCount 者相应扣除）
+     */
+    cancelPending(): number;
+    /**
+     * 执行一个任务（内部方法）。在有空闲槽位时调用。
+     * 任务完成后自动释放槽位并消费排队中的下一个任务。
+     */
+    private executeTask;
+    /**
+     * 任务结算（内部方法）：释放槽位 + 回落计数 + 记日志（失败另触发业务兜底）+ 消费队列。
+     * @param err null 表示成功，非 null 表示失败原因
+     */
+    private settle;
+    /**
+     * 从排队队列中消费一个任务执行（并发槽位释放时调用）。
+     * 保证不超过 MAX_CONCURRENT_BACKGROUND_TASKS 上限。
+     */
+    private drainQueue;
+}
 //# sourceMappingURL=backgroundTask.d.ts.map

package/dist/utils/backgroundTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundTask.d.ts","sourceRoot":"","sources":["../../src/utils/backgroundTask.ts"],"names":[],"mappings":"AAaA,+BAA+B;AAC/B,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAmBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GACjC,IAAI,CAWN;AA4CD,oCAAoC;AACpC,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB5E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAMhD"}
+{"version":3,"file":"backgroundTask.d.ts","sourceRoot":"","sources":["../../src/utils/backgroundTask.ts"],"names":[],"mappings":"AAqCA;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,yBAAyB;IACzB,OAAO,CAAC,WAAW,CAAK;IAExB,sBAAsB;IACtB,OAAO,CAAC,YAAY,CAAoB;IAExC,oCAAoC;IACpC,OAAO,CAAC,YAAY,CAAK;IAEzB;;;;;;;OAOG;IACH,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GACjC,IAAI;IAcP;;;;;;;;;OASG;IACG,YAAY,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBrD;;;;;;;;OAQG;IACH,aAAa,IAAI,MAAM;IAUvB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAiBnB;;;OAGG;IACH,OAAO,CAAC,MAAM;IAYd;;;OAGG;IACH,OAAO,CAAC,UAAU;CAOnB"}

package/dist/utils/backgroundTask.js

@@ -1,117 +1,148 @@
 /**
- * 后台任务统一收口门面 —— 一个「后台副作用」的单一启动/观测入口。
+ * 后台任务统一收口门面 —— 一个「后台副作用」的单一启动入口（**实例级**）。
  *
  * 收敛散落的 `fire-and-forget`（摘要生成 round-summary / 命中刷新 search_memories.touch / 会话命名 session-title）：
  * - 统一启动：不阻塞调用方，业务 Promise 交给门面兜底；
- * - 统一观测：按 label 累计 pending/completed/failed，宿主可读后台健康度；
  * - 统一兜底：失败统一记日志，业务侧补救经 onFailure 挂载（如宿主事件 emit）；
- * 统一限流：最大并发槽位防止上述三类任务无界并发耗尽资源。
+ * - 统一限流：最大并发槽位防止上述三类任务无界并发耗尽资源。
  *
- * 与模块级 logger 同模式（全局单例，组件直接 import，零注入成本）。
+ * ⚠️ **同名异物**（与 `src/agent/backgroundTasks.ts` 的 `BackgroundTaskRegistry` 严格区分）：
+ * 本类是「**内存型 fire-and-forget 副作用的任务槽位调度器**」（摘要/命名/打分，随 Agent 生命周期）；
+ * `BackgroundTaskRegistry` 是「**shell 子进程任务注册表**」（run_command background，可被 kill_command 寻址）。
+ * 两者同名不同物，勿混用。
+ *
+ * ⚠️ **实例级**（形态定案：一个 Agent = 一个项目）：并发槽位与排队队列绑定实例，
+ * N 个 Agent 实例各自 5 槽、各自 FIFO，互不挤占（见测试 MULTI-AGENT-1「隔离验证」块）。
+ * 旧版为模块级单例 —— 多实例共享槽位属已知代价，已按 SSOT 归位到实例。
+ *
+ * 删后注记（2026-10-16 · 5.0.0）：曾有 BackgroundTaskStats 统计快照出口
+ * （getBackgroundTaskStats + completed/failed 累计字段）——Agent 公开面包装零宿主消费，
+ * 连带拆除后 completed/failed 成只写字段（僵尸），遂整链删除。在途观测由
+ * awaitPending 的返回值承担；勿加回。
  */
 import { logger } from '../logging/logger.js';
-/** 后台任务累计统计（模块级单例状态） */
-const stats = { pending: 0, completed: 0, failed: 0 };
-/** 后台任务最大并发数（生产安全性：防止无界并发耗尽资源） */
+/** 后台任务最大并发数（每实例上限；生产安全性：防止无界并发耗尽资源） */
 const MAX_CONCURRENT_BACKGROUND_TASKS = 5;
-/** 当前正在执行的任务数（不含排队中的） */
-let activeCount = 0;
-const pendingQueue = [];
 /**
- * 启动一个后台任务（不阻塞调用方）。统一计数 + 兜底失败日志 + 并发槽位控制。
- * 保留「调用即纳入在途计数」的契约——无论立即执行还是排队等待。
+ * 后台任务槽位调度器（实例级）
  *
- * @param label 任务标签（日志/观测区分用途）
- * @param factory 返回业务 Promise 的工厂；内部不要自行 `catch`，交给本门面统一兜底计数
- * @param onFailure 失败时的业务侧补救（如宿主事件 emit）；缺省仅记日志
+ * 每实例持有独立的并发计数与排队队列。由装配期创建，归属 Agent 实例：
+ * 经 SeedDeps（摘要/命名）+ BuiltinToolHandlers（命中 touch）注入，close() 时等待/清场。
  */
-export function backgroundTask(label, factory, onFailure) {
-    stats.pending++;
-    if (activeCount < MAX_CONCURRENT_BACKGROUND_TASKS) {
-        // 有空闲槽位 → 立即执行
-        executeTask(label, factory, onFailure);
+export class BackgroundTaskScheduler {
+    /** 当前正在执行的任务数（不含排队中的） */
+    activeCount = 0;
+    /** 排队等待执行的任务（FIFO） */
+    pendingQueue = [];
+    /** 在途任务数（调用即纳入在途计数，无论立即执行还是排队等待） */
+    pendingCount = 0;
+    /**
+     * 启动一个后台任务（不阻塞调用方）。统一计数 + 兜底失败日志 + 并发槽位控制。
+     * 保留「调用即纳入在途计数」的契约——无论立即执行还是排队等待。
+     *
+     * @param label 任务标签（日志/观测区分用途）
+     * @param factory 返回业务 Promise 的工厂；内部不要自行 `catch`，交给本门面统一兜底计数
+     * @param onFailure 失败时的业务侧补救（如宿主事件 emit）；缺省仅记日志
+     */
+    schedule(label, factory, onFailure) {
+        // 调用即计入在途（立即执行 or 排队均算）
+        this.pendingCount++;
+        if (this.activeCount < MAX_CONCURRENT_BACKGROUND_TASKS) {
+            // 有空闲槽位 → 立即执行
+            this.executeTask(label, factory, onFailure);
+        }
+        else {
+            // 槽位已满 → 排队等待
+            logger.debug({ label }, '后台任务排队等待执行');
+            this.pendingQueue.push({ label, factory, onFailure });
+        }
     }
-    else {
-        // 槽位已满 → 排队等待
-        logger.debug({ label }, '后台任务排队等待执行');
-        pendingQueue.push({ label, factory, onFailure });
+    /**
+     * 等待所有在途后台任务完成（带超时保护，防止任务永不返回阻塞 close）。
+     * Agent.close() 必须调用此方法——否则后台命中刷新/摘要生成等任务可能在 storage 关闭后 upsert 失效。
+     *
+     * @param timeoutMs 超时时间（毫秒），默认 5000ms
+     * @returns **等待开始时**的在途任务数（0 = 进入本函数时无在途任务）。
+     *   ⚠️ 该值是「曾经在途」而非「已等到完成」：超时放弃剩余任务时返回值仍为初始在途数，
+     *   不代表实际完成数。调用方据此判断「是否有在途任务」是正确的（如 `Agent.close()` 的
+     *   `awaited > 0`），但**不可当作已完成计数**使用。
+     */
+    async awaitPending(timeoutMs = 5000) {
+        const initialPending = this.pendingCount;
+        if (initialPending === 0)
+            return 0;
+        logger.debug({ pending: initialPending }, '等待后台任务完成...');
+        const startTime = Date.now();
+        while (this.pendingCount > 0) {
+            if (Date.now() - startTime > timeoutMs) {
+                logger.warn({ pending: this.pendingCount, timeoutMs }, '等待后台任务超时，放弃剩余任务');
+                break;
+            }
+            // 等待下一个微任务周期，让 pending 计数有机会被更新
+            await new Promise((resolve) => setTimeout(resolve, 50));
+        }
+        return initialPending;
     }
-}
-/**
- * 执行一个任务（内部方法）。在有空闲槽位时调用。
- * 任务完成后自动释放槽位并消费排队中的下一个任务。
- */
-function executeTask(label, factory, onFailure) {
-    activeCount++;
-    const task = factory();
-    task.then(() => {
-        stats.pending--;
-        stats.completed++;
-        activeCount--;
-        logger.debug({ label }, '后台任务完成');
-        drainQueue();
-    }, (err) => {
-        stats.pending--;
-        stats.failed++;
-        activeCount--;
-        logger.warn({ err, label }, '后台任务失败');
-        onFailure?.(err);
-        drainQueue();
-    });
-}
-/**
- * 从排队队列中消费一个任务执行（并发槽位释放时调用）。
- * 保证不超过 MAX_CONCURRENT_BACKGROUND_TASKS 上限。
- */
-function drainQueue() {
-    if (activeCount >= MAX_CONCURRENT_BACKGROUND_TASKS)
-        return;
-    const next = pendingQueue.shift();
-    if (!next)
-        return;
-    // 排队任务启动时仍计入 pending（已在入队时计数），这里仅消费槽位
-    executeTask(next.label, next.factory, next.onFailure);
-}
-/** 读取后台任务累计统计快照（只读副本，宿主可观测后台健康度） */
-export function getBackgroundTaskStats() {
-    return { ...stats };
-}
-/**
- * 等待所有在途后台任务完成（带超时保护，防止任务永不返回阻塞 close）。
- * Agent.close() 必须调用此函数——否则后台命中刷新/摘要生成等任务可能在 storage 关闭后 upsert 失效。
- *
- * @param timeoutMs 超时时间（毫秒），默认 5000ms
- * @returns **等待开始时**的在途任务数（0 = 进入本函数时无在途任务）。
- *   ⚠️ 该值是「曾经在途」而非「已等到完成」：超时放弃剩余任务时返回值仍为初始在途数，
- *   不代表实际完成数。调用方据此判断「是否有在途任务」是正确的（如 `Agent.close()` 的
- *   `awaited > 0`），但**不可当作已完成计数**使用。
- */
-export async function awaitBackgroundTasks(timeoutMs = 5000) {
-    const initialPending = stats.pending;
-    if (initialPending === 0)
-        return 0;
-    logger.debug({ pending: initialPending }, '等待后台任务完成...');
-    const startTime = Date.now();
-    while (stats.pending > 0) {
-        if (Date.now() - startTime > timeoutMs) {
-            logger.warn({ pending: stats.pending, timeoutMs }, '等待后台任务超时，放弃剩余任务');
-            break;
+    /**
+     * 取消**尚未启动**的排队任务（丢弃队列，不中断在途任务）。
+     *
+     * 用途：close() 在 awaitPending 超时后调用，防止「关后仍从队列启动任务 → 写已关 storage」。
+     * ⚠️ 语义边界（勿外溢）：本方法**只清未启动队列**（pendingQueue），**不中断（不可中断）已在途任务**——
+     * 在途任务仍会跑完并各自计数回落；此处**不承诺**「关后不再有任何后台写入」。
+     *
+     * @returns 被丢弃的排队任务数（已计入 pendingCount 者相应扣除）
+     */
+    cancelPending() {
+        const discarded = this.pendingQueue.length;
+        if (discarded === 0)
+            return 0;
+        // 排队任务在入队时已计入 pendingCount，丢弃时同步扣回
+        this.pendingQueue.length = 0;
+        this.pendingCount -= discarded;
+        logger.warn({ discarded }, 'close: 丢弃未启动的排队后台任务');
+        return discarded;
+    }
+    /**
+     * 执行一个任务（内部方法）。在有空闲槽位时调用。
+     * 任务完成后自动释放槽位并消费排队中的下一个任务。
+     */
+    executeTask(label, factory, onFailure) {
+        this.activeCount++;
+        const task = factory();
+        task.then(() => {
+            this.settle(label, null, onFailure);
+        }, (err) => {
+            this.settle(label, err, onFailure);
+        });
+    }
+    /**
+     * 任务结算（内部方法）：释放槽位 + 回落计数 + 记日志（失败另触发业务兜底）+ 消费队列。
+     * @param err null 表示成功，非 null 表示失败原因
+     */
+    settle(label, err, onFailure) {
+        this.pendingCount--;
+        this.activeCount--;
+        if (err === null) {
+            logger.debug({ label }, '后台任务完成');
         }
-        // 等待下一个微任务周期，让 pending 计数有机会被更新
-        await new Promise((resolve) => setTimeout(resolve, 50));
+        else {
+            logger.warn({ err, label }, '后台任务失败');
+            onFailure?.(err);
+        }
+        this.drainQueue();
+    }
+    /**
+     * 从排队队列中消费一个任务执行（并发槽位释放时调用）。
+     * 保证不超过 MAX_CONCURRENT_BACKGROUND_TASKS 上限。
+     */
+    drainQueue() {
+        if (this.activeCount >= MAX_CONCURRENT_BACKGROUND_TASKS)
+            return;
+        const next = this.pendingQueue.shift();
+        if (!next)
+            return;
+        // 排队任务启动时仍计入 pending（已在入队时计数），这里仅消费槽位
+        this.executeTask(next.label, next.factory, next.onFailure);
     }
-    return initialPending;
-}
-/**
- * 重置模块级状态（仅测试使用，生产代码禁止调用）。
- * 清理 activeCount、pendingQueue、stats，确保测试用例间状态隔离。
- * @internal
- */
-export function _resetBackgroundTaskState() {
-    stats.pending = 0;
-    stats.completed = 0;
-    stats.failed = 0;
-    activeCount = 0;
-    pendingQueue.length = 0;
 }
 //# sourceMappingURL=backgroundTask.js.map

package/dist/utils/backgroundTask.js.map

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

package/dist/utils/configResourceManager.d.ts

@@ -59,12 +59,16 @@ export declare abstract class ConfigResourceManager<T extends ConfigResource, TO
     protected retainRuntimeItems(scanned: T[]): T[];
     /** 从内存缓存删除资源（含注销运行时记账） */
     deleteItem(name: string): boolean;
-    /**
-     * 登记运行时注入的资源（子类 register() 唯一落点）——必须记账，
+    /** 登记运行时注入的资源（子类 register() 唯一落点）——必须记账，
      * 否则 reload() 会把无磁盘真理源的注入项当成"磁盘上已删除"而抹掉。
      * 重名校验由子类调用前完成（各自语义不同）。
      */
     protected registerRuntimeItem(item: T): void;
+    /**
+     * 运行时注入名单的只读快照（子类对账用，如角色包「重扫用户目录」）。
+     * 名单本体保持基类私有单点记账——子类只读快照，禁止外部改写。
+     */
+    protected get runtimeItemNames(): string[];
     /** 构建 system prompt 片段（name 不传则用当前激活资源） */
     abstract buildSystemPrompt(name?: string): string;
     /** 从扫描条目构建资源对象（子类实现差异化字段解析；返回 null 跳过该条目） */

package/dist/utils/configResourceManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configResourceManager.d.ts","sourceRoot":"","sources":["../../src/utils/configResourceManager.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,eAAe;AACf,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,8BAAsB,qBAAqB,CAAC,CAAC,SAAS,cAAc,EAAE,QAAQ,GAAG,SAAS;IAetF,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IAChD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAfnC,aAAa;IACb,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,CAAM;IAE1B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD;;;OAGG;gBAEkB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM;IAKnC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAC,EAAE,CAEd;IAID,gDAAgD;cAChC,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAW9D;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAiB/B;;;;;;;OAOG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;;;;;OAQG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAe/C,0BAA0B;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAejC;;;;OAIG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAO5C,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAEjD,6CAA6C;cAC7B,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAO5E,8BAA8B;IAC9B,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI;IAI7D,mCAAmC;IACnC,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI;IAM1C,+BAA+B;YACjB,YAAY;CAc3B"}
+{"version":3,"file":"configResourceManager.d.ts","sourceRoot":"","sources":["../../src/utils/configResourceManager.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,eAAe;AACf,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,8BAAsB,qBAAqB,CAAC,CAAC,SAAS,cAAc,EAAE,QAAQ,GAAG,SAAS;IAetF,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IAChD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAfnC,aAAa;IACb,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,CAAM;IAE1B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD;;;OAGG;gBAEkB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM;IAKnC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAC,EAAE,CAEd;IAID,gDAAgD;cAChC,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAW9D;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAiB/B;;;;;;;OAOG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;;;;;OAQG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAe/C,0BAA0B;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAejC;;;OAGG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAK5C;;;OAGG;IACH,SAAS,KAAK,gBAAgB,IAAI,MAAM,EAAE,CAEzC;IAID,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAEjD,6CAA6C;cAC7B,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAO5E,8BAA8B;IAC9B,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI;IAI7D,mCAAmC;IACnC,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI;IAM1C,+BAA+B;YACjB,YAAY;CAc3B"}

package/dist/utils/configResourceManager.js

@@ -107,8 +107,7 @@ export class ConfigResourceManager {
         logger.info({ name, remaining: this.items.length, subdir: this.subdir }, '资源已从内存缓存删除');
         return true;
     }
-    /**
-     * 登记运行时注入的资源（子类 register() 唯一落点）——必须记账，
+    /** 登记运行时注入的资源（子类 register() 唯一落点）——必须记账，
      * 否则 reload() 会把无磁盘真理源的注入项当成"磁盘上已删除"而抹掉。
      * 重名校验由子类调用前完成（各自语义不同）。
      */
@@ -116,6 +115,13 @@ export class ConfigResourceManager {
         this.items.push(item);
         this.runtimeNames.add(item.name);
     }
+    /**
+     * 运行时注入名单的只读快照（子类对账用，如角色包「重扫用户目录」）。
+     * 名单本体保持基类私有单点记账——子类只读快照，禁止外部改写。
+     */
+    get runtimeItemNames() {
+        return [...this.runtimeNames];
+    }
     /** 从扫描条目构建资源对象（子类实现差异化字段解析；返回 null 跳过该条目） */
     async createEntry(_entry) {
         // 默认空实现：不解析任何条目，子类可覆写

package/dist/utils/configResourceManager.js.map

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

package/dist/utils/errors.d.ts

@@ -11,8 +11,9 @@
  * 被 security/pathGuard 生产消费 4 处；`unknown` 为兜底值（当前无工厂产出，供直接构造保留）。
  * 勿按旧注释去改分类集合。
  *
- * ⚠️ 与宿主 `LlmErrorCategory`（'connection'|'timeout'|'unknown'）**不是同一个联合**：
- * 后者是**流式 error chunk** 的分类（见 hosts shared/protocol.ts），本文件只管 MemoraError。
+ * ⚠️ 与 `LlmErrorCategory`（'connection'|'timeout'|'unknown'）**不是同一个联合**：
+ * 后者是**流式 error chunk** 的分类，唯一定义在 `src/agent/types.ts`（宿主
+ * `shared/protocol.ts` 的 error 变体以同值内联字面量复刻，改值须两处同步）；本文件只管 MemoraError。
  */
 type ErrorCategory = 'config' | 'network' | 'llm' | 'tool' | 'security' | 'unknown';
 /**
@@ -36,6 +37,15 @@ export declare const ToolErrorCode: {
     readonly UNKNOWN_TOOL: "UNKNOWN_TOOL";
     /** 自定义工具执行失败（可重试） */
     readonly CUSTOM_TOOL_FAILED: "CUSTOM_TOOL_FAILED";
+    /**
+     * 能力未装配 / 未注入回调（**不可重试**）。
+     *
+     * 语义 = 「这个工具当前根本没有实现方」，而非「执行了一次没成功」——
+     * 重试无意义（缺的是宿主装配，不是运气），故刻意不进 `RETRYABLE_ERROR_CODES`；
+     * 让 LLM 换手段或报告用户，而不是空转重试烧迭代。
+     * 覆盖 toolExecutor 全线 `[ERR:TOOL:NOT_AVAILABLE]` 出口（provider/回调未注入）。
+     */
+    readonly NOT_AVAILABLE: "NOT_AVAILABLE";
     /** 通用错误（不可重试） */
     readonly UNKNOWN: "UNKNOWN";
 };

package/dist/utils/errors.d.ts.map

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

package/dist/utils/errors.js

@@ -11,8 +11,9 @@
  * 被 security/pathGuard 生产消费 4 处；`unknown` 为兜底值（当前无工厂产出，供直接构造保留）。
  * 勿按旧注释去改分类集合。
  *
- * ⚠️ 与宿主 `LlmErrorCategory`（'connection'|'timeout'|'unknown'）**不是同一个联合**：
- * 后者是**流式 error chunk** 的分类（见 hosts shared/protocol.ts），本文件只管 MemoraError。
+ * ⚠️ 与 `LlmErrorCategory`（'connection'|'timeout'|'unknown'）**不是同一个联合**：
+ * 后者是**流式 error chunk** 的分类，唯一定义在 `src/agent/types.ts`（宿主
+ * `shared/protocol.ts` 的 error 变体以同值内联字面量复刻，改值须两处同步）；本文件只管 MemoraError。
  */
 /**
  * 工具错误码——供 AgentLoop 的 Reflection（自修正）判断是否可重试：
@@ -35,6 +36,15 @@ export const ToolErrorCode = {
     UNKNOWN_TOOL: 'UNKNOWN_TOOL',
     /** 自定义工具执行失败（可重试） */
     CUSTOM_TOOL_FAILED: 'CUSTOM_TOOL_FAILED',
+    /**
+     * 能力未装配 / 未注入回调（**不可重试**）。
+     *
+     * 语义 = 「这个工具当前根本没有实现方」，而非「执行了一次没成功」——
+     * 重试无意义（缺的是宿主装配，不是运气），故刻意不进 `RETRYABLE_ERROR_CODES`；
+     * 让 LLM 换手段或报告用户，而不是空转重试烧迭代。
+     * 覆盖 toolExecutor 全线 `[ERR:TOOL:NOT_AVAILABLE]` 出口（provider/回调未注入）。
+     */
+    NOT_AVAILABLE: 'NOT_AVAILABLE',
     /** 通用错误（不可重试） */
     UNKNOWN: 'UNKNOWN',
 };

package/dist/utils/errors.js.map

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