@zooique/memora 2.0.0 → 3.0.0

package/dist/utils/backgroundTask.d.ts

@@ -0,0 +1,38 @@
+/** 后台任务累计统计快照（宿主读后台健康度，纯只读） */
+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`），但**不可当作已完成计数**使用。
+ */
+export declare function awaitBackgroundTasks(timeoutMs?: number): Promise<number>;
+/**
+ * 重置模块级状态（仅测试使用，生产代码禁止调用）。
+ * 清理 activeCount、pendingQueue、stats，确保测试用例间状态隔离。
+ * @internal
+ */
+export declare function _resetBackgroundTaskState(): void;
+//# sourceMappingURL=backgroundTask.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/backgroundTask.js

@@ -0,0 +1,117 @@
+/**
+ * 后台任务统一收口门面 —— 一个「后台副作用」的单一启动/观测入口。
+ *
+ * 收敛散落的 `fire-and-forget`（摘要生成 round-summary / 命中刷新 search_memories.touch / 会话命名 session-title）：
+ * - 统一启动：不阻塞调用方，业务 Promise 交给门面兜底；
+ * - 统一观测：按 label 累计 pending/completed/failed，宿主可读后台健康度；
+ * - 统一兜底：失败统一记日志，业务侧补救经 onFailure 挂载（如宿主事件 emit）；
+ * 统一限流：最大并发槽位防止上述三类任务无界并发耗尽资源。
+ *
+ * 与模块级 logger 同模式（全局单例，组件直接 import，零注入成本）。
+ */
+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）；缺省仅记日志
+ */
+export function backgroundTask(label, factory, onFailure) {
+    stats.pending++;
+    if (activeCount < MAX_CONCURRENT_BACKGROUND_TASKS) {
+        // 有空闲槽位 → 立即执行
+        executeTask(label, factory, onFailure);
+    }
+    else {
+        // 槽位已满 → 排队等待
+        logger.debug({ label }, '后台任务排队等待执行');
+        pendingQueue.push({ label, factory, onFailure });
+    }
+}
+/**
+ * 执行一个任务（内部方法）。在有空闲槽位时调用。
+ * 任务完成后自动释放槽位并消费排队中的下一个任务。
+ */
+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;
+        }
+        // 等待下一个微任务周期，让 pending 计数有机会被更新
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    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

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

package/dist/utils/configResourceManager.d.ts

@@ -0,0 +1,79 @@
+import type { ScannedMarkdownEntry } from '../utils/scanner.js';
+/** 配置资源最小约束 */
+export interface ConfigResource {
+    name: string;
+    content: string;
+    filePath: string;
+}
+/**
+ * 配置资源管理器 — 抽象基类
+ * @typeParam T 子类资源类型
+ * @typeParam TOptions load() 的可选参数类型
+ */
+export declare abstract class ConfigResourceManager<T extends ConfigResource, TOptions = undefined> {
+    protected readonly configDir: string | undefined;
+    protected readonly subdir: string;
+    /** 资源列表缓存 */
+    protected items: T[];
+    /**
+     * 运行时注入项的名字集合——「是否有磁盘真理源」必须显式记账，不能从 filePath 反推
+     * （注入方 filePath 是约定，可填 '<runtime>'）。registerRuntimeItem() 登记，deleteItem/loadItems 注销。
+     */
+    private readonly runtimeNames;
+    /**
+     * @param configDir 配置目录（资源在 <configDir>/<subdir>/ 下）
+     * @param subdir 资源子目录名（如 'skills'、'personas'）
+     */
+    constructor(configDir: string | undefined, subdir: string);
+    /**
+     * 资源列表快照——返回浅拷贝而非内部数组引用，
+     * 防止外部 push/splice 绕过 register() 的重名校验与 deleteItem() 记账。
+     */
+    get list(): T[];
+    /** 加载资源到缓存，items 整体替换、运行时记账作废（子类 load() 中调用） */
+    protected loadItems(options?: TOptions): Promise<number>;
+    /**
+     * 重载资源——不能整体覆盖 items：那会抹除无磁盘真理源的运行时注入项
+     * （如 SkillManager.register 注入的运行时技能，纯内存态、不进记忆库），两侧就此分叉。
+     * 判据取 runtimeNames 显式记账；同名冲突以磁盘（更强真理源）为准并注销登记。
+     */
+    reload(): Promise<number>;
+    /**
+     * 子类声明「用户版本覆盖磁盘同名」的条目（默认无）
+     *
+     * 默认语义 = 磁盘（更强真理源）赢：运行时注入项撞磁盘扫描同名时，磁盘版胜出、
+     * 运行时记账注销。SkillManager 的用户技能目录（loadExtraDir）则声明为覆盖——
+     * reload 时用户版胜出、记账保留、扫描到的内置版被剔除（见 retainRuntimeItems）。
+     * RolePackManager 不覆写，保持默认「磁盘赢」。
+     */
+    protected isUserOverride(_name: string): boolean;
+    /**
+     * 将磁盘扫描结果与运行时注入项合并（子类自定义扫描的 reload 也应复用本方法）：
+     * 重新扫描磁盘后，保留无磁盘真理源的运行时注入项（如 loadExtraDir 注入的用户资源），
+     * 同名冲突以磁盘（更强真理源）为准并注销运行时记账——除非子类将同名声明为
+     * isUserOverride（用户覆盖内置）：此时用户版保留、记账保留、磁盘版被剔除。
+     *
+     * @param scanned 本次磁盘扫描得到的资源列表
+     * @returns 合并后的完整资源列表（磁盘在前、运行时注入在后）
+     */
+    protected retainRuntimeItems(scanned: T[]): T[];
+    /** 从内存缓存删除资源（含注销运行时记账） */
+    deleteItem(name: string): boolean;
+    /**
+     * 登记运行时注入的资源（子类 register() 唯一落点）——必须记账，
+     * 否则 reload() 会把无磁盘真理源的注入项当成"磁盘上已删除"而抹掉。
+     * 重名校验由子类调用前完成（各自语义不同）。
+     */
+    protected registerRuntimeItem(item: T): void;
+    /** 构建 system prompt 片段（name 不传则用当前激活资源） */
+    abstract buildSystemPrompt(name?: string): string;
+    /** 从扫描条目构建资源对象（子类实现差异化字段解析；返回 null 跳过该条目） */
+    protected createEntry(_entry: ScannedMarkdownEntry): Promise<T | null>;
+    /** load() 完成后的回调（子类可做激活选择） */
+    protected onAfterLoad(_items: T[], _options?: TOptions): void;
+    /** reload() 完成后的回调（子类可保持当前激活状态） */
+    protected onAfterReload(_items: T[]): void;
+    /** 扫描目录 + 构建条目列表（按 name 去重） */
+    private scanAndBuild;
+}
+//# sourceMappingURL=configResourceManager.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/configResourceManager.js

@@ -0,0 +1,150 @@
+/**
+ * 配置资源管理器抽象基类 — 消除 SkillManager / RolePackManager 的重复结构：
+ * 扫描 <configDir>/<subdir>/ 的 .md、load/reload/deleteItem 生命周期。
+ * 差异化保留在子类（createEntry 条目构造、buildSystemPrompt、各自额外状态/能力）。
+ */
+import { logger } from '../logging/logger.js';
+import { resolveSubdir, scanMarkdownDir } from '../utils/scanner.js';
+/**
+ * 配置资源管理器 — 抽象基类
+ * @typeParam T 子类资源类型
+ * @typeParam TOptions load() 的可选参数类型
+ */
+export class ConfigResourceManager {
+    configDir;
+    subdir;
+    /** 资源列表缓存 */
+    items = [];
+    /**
+     * 运行时注入项的名字集合——「是否有磁盘真理源」必须显式记账，不能从 filePath 反推
+     * （注入方 filePath 是约定，可填 '<runtime>'）。registerRuntimeItem() 登记，deleteItem/loadItems 注销。
+     */
+    runtimeNames = new Set();
+    /**
+     * @param configDir 配置目录（资源在 <configDir>/<subdir>/ 下）
+     * @param subdir 资源子目录名（如 'skills'、'personas'）
+     */
+    constructor(configDir, subdir) {
+        this.configDir = configDir;
+        this.subdir = subdir;
+    }
+    // ── 公共 API ──────────────────────────────────────────
+    /**
+     * 资源列表快照——返回浅拷贝而非内部数组引用，
+     * 防止外部 push/splice 绕过 register() 的重名校验与 deleteItem() 记账。
+     */
+    get list() {
+        return [...this.items];
+    }
+    // ── 受保护的基础设施 ──────────────────────────────────
+    /** 加载资源到缓存，items 整体替换、运行时记账作废（子类 load() 中调用） */
+    async loadItems(options) {
+        this.items = await this.scanAndBuild();
+        this.runtimeNames.clear();
+        this.onAfterLoad(this.items, options);
+        logger.info({ count: this.items.length, names: this.items.map((i) => i.name), subdir: this.subdir }, `${this.subdir} 资源加载完成`);
+        return this.items.length;
+    }
+    /**
+     * 重载资源——不能整体覆盖 items：那会抹除无磁盘真理源的运行时注入项
+     * （如 SkillManager.register 注入的运行时技能，纯内存态、不进记忆库），两侧就此分叉。
+     * 判据取 runtimeNames 显式记账；同名冲突以磁盘（更强真理源）为准并注销登记。
+     */
+    async reload() {
+        const oldCount = this.items.length;
+        const scanned = await this.scanAndBuild();
+        this.items = this.retainRuntimeItems(scanned);
+        this.onAfterReload(this.items);
+        logger.info({
+            oldCount,
+            newCount: this.items.length,
+            retainedRuntime: this.items.length - scanned.length,
+            subdir: this.subdir,
+        }, `${this.subdir} 资源已重载`);
+        return this.items.length;
+    }
+    /**
+     * 子类声明「用户版本覆盖磁盘同名」的条目（默认无）
+     *
+     * 默认语义 = 磁盘（更强真理源）赢：运行时注入项撞磁盘扫描同名时，磁盘版胜出、
+     * 运行时记账注销。SkillManager 的用户技能目录（loadExtraDir）则声明为覆盖——
+     * reload 时用户版胜出、记账保留、扫描到的内置版被剔除（见 retainRuntimeItems）。
+     * RolePackManager 不覆写，保持默认「磁盘赢」。
+     */
+    isUserOverride(_name) {
+        return false;
+    }
+    /**
+     * 将磁盘扫描结果与运行时注入项合并（子类自定义扫描的 reload 也应复用本方法）：
+     * 重新扫描磁盘后，保留无磁盘真理源的运行时注入项（如 loadExtraDir 注入的用户资源），
+     * 同名冲突以磁盘（更强真理源）为准并注销运行时记账——除非子类将同名声明为
+     * isUserOverride（用户覆盖内置）：此时用户版保留、记账保留、磁盘版被剔除。
+     *
+     * @param scanned 本次磁盘扫描得到的资源列表
+     * @returns 合并后的完整资源列表（磁盘在前、运行时注入在后）
+     */
+    retainRuntimeItems(scanned) {
+        const scannedNames = new Set(scanned.map((i) => i.name));
+        const runtimeInjected = this.items.filter((i) => this.runtimeNames.has(i.name) && (!scannedNames.has(i.name) || this.isUserOverride(i.name)));
+        for (const name of this.runtimeNames) {
+            // 磁盘同名赢（覆盖项已被保留，见上过滤）→ 注销记账；覆盖项保留记账（下次 reload 仍保留）
+            if (scannedNames.has(name) && !this.isUserOverride(name))
+                this.runtimeNames.delete(name);
+        }
+        // 覆盖项：剔除本次扫描到的磁盘同名版（用户版保留在后），避免同名双存
+        const effectiveScanned = scanned.filter((i) => !this.isUserOverride(i.name));
+        return [...effectiveScanned, ...runtimeInjected];
+    }
+    /** 从内存缓存删除资源（含注销运行时记账） */
+    deleteItem(name) {
+        const idx = this.items.findIndex((i) => i.name === name);
+        if (idx < 0) {
+            logger.warn({ name, subdir: this.subdir }, '内存缓存中未找到资源，跳过删除');
+            return false;
+        }
+        this.items.splice(idx, 1);
+        this.runtimeNames.delete(name);
+        logger.info({ name, remaining: this.items.length, subdir: this.subdir }, '资源已从内存缓存删除');
+        return true;
+    }
+    /**
+     * 登记运行时注入的资源（子类 register() 唯一落点）——必须记账，
+     * 否则 reload() 会把无磁盘真理源的注入项当成"磁盘上已删除"而抹掉。
+     * 重名校验由子类调用前完成（各自语义不同）。
+     */
+    registerRuntimeItem(item) {
+        this.items.push(item);
+        this.runtimeNames.add(item.name);
+    }
+    /** 从扫描条目构建资源对象（子类实现差异化字段解析；返回 null 跳过该条目） */
+    async createEntry(_entry) {
+        // 默认空实现：不解析任何条目，子类可覆写
+        return null;
+    }
+    // ── 生命周期钩子（子类可选覆写） ──────────────────────────
+    /** load() 完成后的回调（子类可做激活选择） */
+    onAfterLoad(_items, _options) {
+        // 默认空实现
+    }
+    /** reload() 完成后的回调（子类可保持当前激活状态） */
+    onAfterReload(_items) {
+        // 默认空实现
+    }
+    // ── 私有方法 ──────────────────────────────────────────
+    /** 扫描目录 + 构建条目列表（按 name 去重） */
+    async scanAndBuild() {
+        const map = new Map();
+        const dir = resolveSubdir(this.configDir, this.subdir);
+        if (!dir)
+            return [];
+        const entries = await scanMarkdownDir(dir);
+        for (const entry of entries) {
+            const item = await this.createEntry(entry);
+            if (item !== null) {
+                map.set(entry.name, item);
+            }
+        }
+        return Array.from(map.values());
+    }
+}
+//# sourceMappingURL=configResourceManager.js.map

package/dist/utils/configResourceManager.js.map

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

package/dist/utils/errors.d.ts

@@ -1,43 +1,38 @@
 /**
- * 统一错误类型
+ * 统一错误类型——把"系统 Error + 英文 stack"包装成"分类清晰 + 中文友好 + 有下一步建议"。
+ * 展示：标题（一眼看出问题）+ 详情（排查用）+ 建议（怎么修复）。
  *
- * 把"系统 Error + 英文 stack trace"包装成"分类清晰 + 中文友好 + 有下一步建议"的错误
- * 详见 ADR-006 · 安全模型
+ * **形态**：错误类只有 `MemoraError` 一个（承载 title/detail/suggestions/category）；
+ * 分类不靠子类，靠 `category` 字段 —— 工厂函数按分类建实例：
+ * `configError` / `networkError` / `llmError` / `toolError` / `securityError`，
+ * 另有统一文案模板 `chatBusyError`（对话繁忙，内部走 configError）。
+ * ⚠️ 旧注释曾写「4 大类 ConfigError/NetworkError/…」——**本文件不存在这些 PascalCase 类名**
+ * （既非类也非工厂名），且实为 **6 个 category 值**：`security` 由 securityError 产出、
+ * 被 security/pathGuard 生产消费 4 处；`unknown` 为兜底值（当前无工厂产出，供直接构造保留）。
+ * 勿按旧注释去改分类集合。
  *
- * 4 大类：
- *   - ConfigError      配置错误（apiKey 缺失、provider 不支持等）
- *   - NetworkError     网络错误（连接超时、DNS 失败、限流等）
- *   - LlmError         LLM 错误（4xx/5xx、返回异常 JSON）
- *   - ToolError        工具错误（路径越界、参数无效等）
- *
- * 错误展示原则：
- *   1. 标题（中文）—— 一眼看出什么问题
- *   2. 详情（原文）—— 排查用
- *   3. 建议（下一步）—— 怎么修复
+ * ⚠️ 与宿主 `LlmErrorCategory`（'connection'|'timeout'|'unknown'）**不是同一个联合**：
+ * 后者是**流式 error chunk** 的分类（见 hosts shared/protocol.ts），本文件只管 MemoraError。
  */
-export { toError } from '../utils/toError.js';
 type ErrorCategory = 'config' | 'network' | 'llm' | 'tool' | 'security' | 'unknown';
 /**
- * 工具错误码 — 用于 AgentLoop 的 Reflection（反思/自修正）逻辑
- *
- * 每个错误码关联一个 retryable 标记：
- *   - retryable：LLM 可以调整参数后重试（如文件路径错误、参数类型错误）
- *   - non-retryable：重试无意义（如权限拒绝、用户拒绝写入）
+ * 工具错误码——供 AgentLoop 的 Reflection（自修正）判断是否可重试：
+ * retryable 表示 LLM 调整参数后可重试；non-retryable 重试无意义。
  */
 export declare const ToolErrorCode: {
     /** 路径不在白名单内（不可重试） */
     readonly PATH_NOT_ALLOWED: "PATH_NOT_ALLOWED";
-    /** 文件不存在（可重试 — LLM 可能用错了路径） */
+    /** 文件不存在（可重试） */
     readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
     /** 权限不足（不可重试） */
     readonly PERMISSION_DENIED: "PERMISSION_DENIED";
-    /** 工具参数错误（可重试 — LLM 可以修正参数格式） */
+    /** 参数错误（可重试） */
     readonly ARGUMENT_ERROR: "ARGUMENT_ERROR";
     /** 用户拒绝写入（不可重试） */
     readonly WRITE_REJECTED: "WRITE_REJECTED";
-    /** 目录不存在（可重试 — LLM 可能用错了路径） */
+    /** 目录不存在（可重试） */
     readonly DIR_NOT_FOUND: "DIR_NOT_FOUND";
-    /** 未知工具（不可重试 — 工具未注册） */
+    /** 未知工具（不可重试） */
     readonly UNKNOWN_TOOL: "UNKNOWN_TOOL";
     /** 自定义工具执行失败（可重试） */
     readonly CUSTOM_TOOL_FAILED: "CUSTOM_TOOL_FAILED";
@@ -47,17 +42,11 @@ export declare const ToolErrorCode: {
 export type ToolErrorCodeValue = (typeof ToolErrorCode)[keyof typeof ToolErrorCode];
 export declare function isRetryableErrorCode(code: ToolErrorCodeValue): boolean;
 interface FriendlyErrorOptions {
-    /** 用户能看懂的简短标题（中文） */
     title: string;
-    /** 详细原因（可含原文） */
     detail?: string;
-    /** 下一步建议（数组，按优先级） */
     suggestions: string[];
-    /** 错误分类 */
     category: ErrorCategory;
-    /** 工具错误码（用于 AgentLoop Reflection 判断是否可重试） */
     errorCode?: ToolErrorCodeValue;
-    /** 原始错误（保留 stack） */
     cause?: Error;
 }
 export declare class MemoraError extends Error {
@@ -65,43 +54,46 @@ export declare class MemoraError extends Error {
     readonly detail: string | undefined;
     readonly suggestions: readonly string[];
     readonly category: ErrorCategory;
-    /** 工具错误码（用于 AgentLoop 反思判断是否可重试） */
     readonly errorCode: ToolErrorCodeValue | undefined;
     readonly cause: Error | undefined;
     constructor(opts: FriendlyErrorOptions);
-    /**
-     * 格式化为用户可读的展示字符串
-     */
+    /** 格式化为用户可读的展示字符串 */
     format(): string;
 }
-/**
- * 工厂：配置错误
- */
+/** 工厂：配置错误 */
 export declare function configError(title: string, detail: string | undefined, suggestions: string[], cause?: Error): MemoraError;
-/**
- * 工厂：对话繁忙错误
- *
- * 用于 chat() 进行中时拒绝其他需要独占 Agent 的操作（切换项目/Provider/会话/重载配置等）。
- * 12 处调用点统一使用此工厂，消除 `configError('对话繁忙', ...)` 的重复模板（ADR-017 枝叶层 2 次提取）。
- *
- * @param action 被拒绝的操作描述（如"切换项目"），拼接到"请等待其结束后再"之后
- * @returns MemoraError（config 类别）
- */
+/** 工厂：对话繁忙错误——chat() 进行中拒绝其他需独占 Agent 的操作，统一模板用此工厂 */
 export declare function chatBusyError(action: string): MemoraError;
-/**
- * 工厂：网络错误
- */
+/** 工厂：网络错误 */
 export declare function networkError(title: string, detail: string | undefined, suggestions: string[], cause?: Error): MemoraError;
-/**
- * 工厂：LLM 错误
- */
+/** 工厂：LLM 错误 */
 export declare function llmError(title: string, detail: string | undefined, suggestions: string[], cause?: Error): MemoraError;
-/**
- * 工厂：工具错误
- */
+/** 工厂：工具错误 */
 export declare function toolError(title: string, detail: string | undefined, suggestions: string[], cause?: Error, errorCode?: ToolErrorCodeValue): MemoraError;
+/** 工厂：安全错误（路径越界、黑名单命中、权限不足等） */
+export declare function securityError(title: string, detail: string | undefined, suggestions: string[], cause?: Error): MemoraError;
+/** 判断是否为 AbortError（用户主动取消或超时中断）——统一基于 err.name === 'AbortError'，
+ *  兼容原生 DOMException / 普通 Error 子类 / toError() 规范化后对象。 */
+export declare function isAbortError(err: unknown): boolean;
+/** 判断 AbortSignal 是否为「超时中断」（chat 锁超时 / LLM 无响应超时统一以 TimeoutError reason 标识）。
+ *  与用户取消（abort() 无 reason / AbortError reason）区分——锁超时中断不能谎报成用户取消。 */
+export declare function isTimeoutAbortSignal(signal: AbortSignal | undefined): boolean;
 /**
- * 工厂：安全错误（路径越界、黑名单命中、权限不足等）
+ * 判断**抛出的错误**是否为「超时」（非 abort 路径的载体）。
+ *
+ * 与 `isTimeoutAbortSignal` 是**同一语义的两种载体**（同判 `name === 'TimeoutError'`）：
+ * 前者看 `signal.reason`（signal 被 abort 的路径），本函数看**被抛出的错误对象**——
+ * 典型场景 = `openaiCompatible.parseSseStream` 的 SSE 停摆看门狗（`Promise.race` 竞速闸
+ * reject `DOMException('…','TimeoutError')`），它不经过 abort signal，故被归类为「失败」
+ * 而非「中断」，最终由 `consumeExecutionStream` 的通用 catch 收口。
+ *
+ * **用途（否则宿主文案不可达）**：把超时归入 `error.category = 'timeout'`，让宿主
+ * `chatPanel` 的 `friendlyByCategory.timeout`（「对话处理超时，请稍后重试」）真正生效；
+ * 缺该分类时宿主只能回退**原始技术文案**（DOMException message），用户读到的是侦探材料。
+ *
+ * 注：`toError()` 对 Error 实例原样返回（实测 `DOMException instanceof Error === true`），
+ * 故经 `llmCaller` 的 `toError(err)` 再 rethrow 后 `name` 不丢，本判据在链路末端依然成立。
  */
-export declare function securityError(title: string, detail: string | undefined, suggestions: string[], cause?: Error): MemoraError;
+export declare function isTimeoutError(err: unknown): boolean;
+export {};
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,KAAK,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAEpF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;IACxB,qBAAqB;;IAErB,+BAA+B;;IAE/B,iBAAiB;;IAEjB,iCAAiC;;IAEjC,mBAAmB;;IAEnB,+BAA+B;;IAE/B,yBAAyB;;IAEzB,qBAAqB;;IAErB,iBAAiB;;CAET,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAYpF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAEtE;AAGD,UAAU,oBAAoB;IAC5B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,qBAAqB;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;gBAEtB,IAAI,EAAE,oBAAoB;IAWtC;;OAEG;IACH,MAAM,IAAI,MAAM;CAYjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,CAAC,EAAE,KAAK,GACZ,WAAW,CAEb;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAMzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,CAAC,EAAE,KAAK,GACZ,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,CAAC,EAAE,KAAK,GACZ,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,CAAC,EAAE,KAAK,EACb,SAAS,CAAC,EAAE,kBAAkB,GAC7B,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,CAAC,EAAE,KAAK,GACZ,WAAW,CAEb"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}