@zooique/memora 2.0.3 → 3.0.1

package/dist/utils/eventEmitter.d.ts

@@ -1,178 +1,179 @@
-/** Agent 事件名常量（运行时真理源，与下方 AgentEventMap 键集一致） */
+import type { AskQuestion } from '../agent/types.js';
+/** Agent 事件名常量（运行时真理源，与 AgentEventMap 键集一致） */
 export declare const AGENT_EVENTS: {
     readonly memoryAdded: "memoryAdded";
-    readonly personaSwitched: "personaSwitched";
-    readonly decayCompleted: "decayCompleted";
+    readonly rolePackSwitched: "rolePackSwitched";
     readonly memoryRecalled: "memoryRecalled";
     readonly sessionForked: "sessionForked";
-    readonly insightExtracted: "insightExtracted";
-    readonly conflictDetected: "conflictDetected";
     readonly projectSwitched: "projectSwitched";
-    readonly skillMatched: "skillMatched";
     readonly archiveFailed: "archiveFailed";
     readonly contextTruncated: "contextTruncated";
+    /** LLM 主动压缩完成（第二级压缩，与 contextTruncated 的内核自动截断区分） */
+    readonly contextCompressed: "contextCompressed";
     readonly configReloaded: "configReloaded";
-    readonly guardrailError: "guardrailError";
     readonly archiveModeChanged: "archiveModeChanged";
-    readonly personaSwitchLocked: "personaSwitchLocked";
+    readonly rolePackSwitchLocked: "rolePackSwitchLocked";
     readonly workProjectionGenerated: "workProjectionGenerated";
-    readonly boostPersistFailed: "boostPersistFailed";
     readonly dedupCompleted: "dedupCompleted";
+    readonly sessionPauseTimedOut: "sessionPauseTimedOut";
+    readonly sessionResumeBlocked: "sessionResumeBlocked";
+    /** 订阅时宿主据此判断重要事件并 toast 提示 */
+    readonly sessionResumeFailed: "sessionResumeFailed";
+    /** 装配前判负（洞 3）：触发输入过大，剩余预算无法支撑至少一轮正文——与软上限不同失败原因 */
+    readonly inputTooLarge: "inputTooLarge";
+    /** 回答中 LLM 调 ask_user 工具主动提问（唯一「提问后暂停」通道） */
+    readonly questionPending: "questionPending";
+    readonly goalDriftDetected: "goalDriftDetected";
+    readonly sessionPaused: "sessionPaused";
+    readonly sessionResumed: "sessionResumed";
+    readonly sessionError: "sessionError";
+    readonly sessionRecovered: "sessionRecovered";
+    /** 会话标题被 LLM 自动更新（SessionNamer 完成后触发，宿主据此刷新 UI） */
+    readonly sessionTitleUpdated: "sessionTitleUpdated";
+    /**
+     * 轮次摘要生成完成（round-summary fire-and-forget 后台任务收口信号）。
+     * 宿主据此解锁「问答闭环完整结束」的 UI 状态（删除/分叉按钮解禁）——
+     * 避免 done 后立即删除导致孤儿 round-summary（摘要还在生成就删了源）。
+     * 一次 chat() 只触发一次，载荷带 roundId 溯源。
+     */
+    readonly roundSummaryGenerated: "roundSummaryGenerated";
 };
-/** 事件名联合类型（由 AGENT_EVENTS 推导，单一真理源，新增事件只需在此对象加一项） */
+/** 事件名联合类型（由 AGENT_EVENTS 推导，新增事件只需在此加一项） */
 export type AgentEventName = keyof typeof AGENT_EVENTS;
-/** 运行时校验用 Set（由 AGENT_EVENTS 派生） */
+/** 运行时校验用集合（由 AGENT_EVENTS 派生） */
 export declare const AGENT_EVENT_SET: ReadonlySet<string>;
-/** Agent 事件映射表（事件名 → 事件载荷类型），键集受 AgentEventName 约束 */
+/** 事件名 → 载荷类型映射（键集受 AgentEventName 约束） */
 export interface AgentEventMap extends Record<AgentEventName, unknown> {
-    /** 记忆被写入存储（insight 提取、rule 注入、skill 注入等） */
     memoryAdded: {
         id: string;
         source: string;
         name: string;
     };
-    /** 角色被切换（自动匹配或手动指定） */
-    personaSwitched: {
+    rolePackSwitched: {
         from: string | null;
         to: string;
     };
-    /** 记忆衰减完成 */
-    decayCompleted: {
-        decayedCount: number;
-    };
-    /** 记忆被召回（用于宿主 UI 展示"想起 X 条记忆"） */
     memoryRecalled: {
         count: number;
         query: string;
     };
-    /** 会话被分叉 */
     sessionForked: {
         from: string;
         to: string;
-        messageCount: number;
-    };
-    /** 洞察被提取 */
-    insightExtracted: {
-        source: string;
-        insight: string;
+        roundCount: number;
     };
-    /** 记忆冲突被检测到（contradicts 关系写入时触发，宿主可通知用户） */
-    conflictDetected: {
-        newMemoryId: string;
-        newInsight: string;
-        targetId: string;
-        targetContent: string;
-    };
-    /** 项目被切换（宿主 UI 可据此刷新项目相关界面） */
     projectSwitched: {
         from: string | null;
         to: string;
         projectName: string;
     };
-    /** 技能被匹配（宿主 UI 可据此展示当前激活技能） */
-    skillMatched: {
-        skill: string;
-        score: number;
-    };
-    /** 归档操作失败（fire-and-forget catch 分支发射，宿主可通知用户） */
     archiveFailed: {
-        /** 失败阶段：profile（用户画像）/ insight（洞察提取）/ content（会话内容归档） */
-        stage: 'profile' | 'insight' | 'content';
-        /** 失败原因摘要（error.message，截断 200 字符避免 payload 过大） */
+        stage: 'session';
         message: string;
     };
-    /** 上下文窗口截断（消息超出 token 上限被裁剪，宿主可通知用户消息被丢弃） */
     contextTruncated: {
-        /** 被裁剪掉的消息数量 */
         skippedCount: number;
-        /** 保留的消息数量 */
         keptCount: number;
     };
-    /** 配置热重载完成（含对话期间暂存后补执行的 reload） */
+    /** LLM 主动压缩完成载荷：压缩目标 + 被替换消息数 + 摘要长度 */
+    contextCompressed: {
+        target: 'earliest_round' | 'largest_tool_result';
+        replacedCount: number;
+        summaryLength: number;
+    };
     configReloaded: {
-        /** 重载来源（persona/rule/skill/guardrail） */
         source: string;
     };
-    /** Guardrail 规则正则编译失败（安全放行但应通知用户规则未生效） */
-    guardrailError: {
-        /** 规则原文（截断 100 字符） */
-        rule: string;
-        /** 编译失败原因 */
-        message: string;
-    };
-    /** 归档模式切换 */
     archiveModeChanged: {
-        /** 切换前模式 */
         from: string;
-        /** 切换后模式 */
         to: string;
     };
-    /** 角色切换锁定状态变化（防抖期间用户尝试切换被拒绝时通知） */
-    personaSwitchLocked: {
-        /** 锁定原因 */
+    rolePackSwitchLocked: {
         reason: string;
-        /** 锁定时长（秒） */
         lockedSeconds: number;
     };
-    /** 作品投影生成/更新（宿主可据此刷新作品面板） */
     workProjectionGenerated: {
-        /** 源文件路径 */
         sourcePath: string;
-        /** 投影摘要 */
         summary: string;
     };
-    /** boost score 持久化失败（宿主可通知用户记忆权重可能丢失） */
-    boostPersistFailed: {
-        /** 记忆 ID */
-        memoryId: string;
-        /** 失败原因 */
-        message: string;
-    };
-    /** 语义去重完成（宿主可据此刷新记忆面板） */
     dedupCompleted: {
-        /** 被降级的记忆数 */
         deduplicatedCount: number;
-        /** 被降级的记忆 ID 列表 */
         demotedIds: string[];
     };
+    sessionPauseTimedOut: {
+        sessionId: string;
+        pauseDuration: number;
+        date?: string;
+        session?: string;
+    };
+    sessionResumeBlocked: {
+        sessionId: string;
+        reason: string;
+    };
+    sessionResumeFailed: {
+        sessionId?: string;
+        reason: string;
+    };
+    /** 装配前判负载荷：剩余预算详情 + 给宿主的降级提示（建议放文件用 read_file 读） */
+    inputTooLarge: {
+        inputLength: number;
+        remainingTokens: number;
+        hint: string;
+    };
+    questionPending: AskQuestion[];
+    goalDriftDetected: {
+        sessionId: string;
+        mainGoal: string;
+        newGoal: string;
+        similarity: number;
+        level: 'same' | 'confirm' | 'drift';
+        constraints: string[];
+        /** 原名 goalVersion，仅载荷不承担校验 */
+        goalChangeSeq: number;
+    };
+    sessionPaused: {
+        reason: string;
+        source: string;
+        sessionId?: string;
+    };
+    sessionResumed: {
+        sessionId?: string;
+    };
+    sessionError: {
+        cause: string;
+        sessionId?: string;
+    };
+    sessionRecovered: {
+        sessionId?: string;
+    };
+    /** 会话标题更新载荷：会话 ID + 新标题 */
+    sessionTitleUpdated: {
+        sessionId: string;
+        title: string;
+    };
+    /** 轮次摘要生成完成载荷：本轮 roundId（溯源）+ 成功/失败（失败时宿主仍需兜底解锁） */
+    roundSummaryGenerated: {
+        roundId: string;
+        success: boolean;
+    };
 }
 /** 事件处理器类型 */
 export type AgentEventHandler<T> = (event: T) => void;
 /**
- * 类型安全的事件发射器
- *
- * 泛型参数 EventMap 约束了合法的事件名和对应的载荷类型，
- * 调用方在编译期就能获得类型检查和自动补全。
+ * 类型安全事件发射器——泛型 EventMap 约束合法事件名与载荷类型，
+ * 调用方在编译期获得类型检查和自动补全。
  */
 export declare class TypedEventEmitter<EventMap extends object> {
     private readonly listeners;
-    /**
-     * 订阅事件
-     * @param event - 事件名
-     * @param handler - 事件处理器
-     */
+    /** 订阅事件（同一 handler 引用加入 Set，天然避免重复监听） */
     on<K extends keyof EventMap & string>(event: K, handler: (event: EventMap[K]) => void): void;
-    /**
-     * 取消订阅
-     * @param event - 事件名
-     * @param handler - 要移除的处理器（必须是同一个引用）
-     */
+    /** 取消订阅（必须是与 on 相同的引用） */
     off<K extends keyof EventMap & string>(event: K, handler: (event: EventMap[K]) => void): void;
-    /**
-     * 订阅事件（仅触发一次，触发后自动移除）
-     * @param event - 事件名
-     * @param handler - 事件处理器
-     */
+    /** 一次性订阅：触发后自动移除，再转发给 handler（防泄漏） */
     once<K extends keyof EventMap & string>(event: K, handler: (event: EventMap[K]) => void): void;
-    /**
-     * 发射事件
-     * @param event - 事件名
-     * @param payload - 事件载荷
-     */
+    /** 发射事件；单处理器异常不阻断其余监听器 */
     protected emit<K extends keyof EventMap & string>(event: K, payload: EventMap[K]): void;
-    /**
-     * 移除所有监听器（用于 close() 清理）
-     */
+    /** 移除所有监听器（用于 close() 清理） */
     protected removeAllListeners(): void;
 }
 //# sourceMappingURL=eventEmitter.d.ts.map

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

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

package/dist/utils/eventEmitter.js

@@ -1,51 +1,57 @@
 /**
- * 轻量类型事件发射器 — 零外部依赖
- *
- * 供 Agent 向宿主项目广播对话外事件（记忆变更、角色切换、衰减完成等）。
- * 不依赖 Node.js EventEmitter，保持"零 native 依赖内核"约束。
- *
- * 使用方式：
- *   agent.on('memoryAdded', (e) => console.log(e.source, e.name));
- *   agent.off('memoryAdded', handler);
+ * 轻量类型事件发射器（零 native 依赖）——Agent 向宿主广播外层事件：
+ * agent.on('memoryAdded', (e) => ...)；off 解绑。
  */
 import { getLogger } from '../utils/loggerHolder.js';
 import { toError } from '../utils/toError.js';
-/** Agent 事件名常量（运行时真理源，与下方 AgentEventMap 键集一致） */
+/** Agent 事件名常量（运行时真理源，与 AgentEventMap 键集一致） */
 export const AGENT_EVENTS = {
     memoryAdded: 'memoryAdded',
-    personaSwitched: 'personaSwitched',
-    decayCompleted: 'decayCompleted',
+    rolePackSwitched: 'rolePackSwitched',
     memoryRecalled: 'memoryRecalled',
     sessionForked: 'sessionForked',
-    insightExtracted: 'insightExtracted',
-    conflictDetected: 'conflictDetected',
     projectSwitched: 'projectSwitched',
-    skillMatched: 'skillMatched',
     archiveFailed: 'archiveFailed',
     contextTruncated: 'contextTruncated',
+    /** LLM 主动压缩完成（第二级压缩，与 contextTruncated 的内核自动截断区分） */
+    contextCompressed: 'contextCompressed',
     configReloaded: 'configReloaded',
-    guardrailError: 'guardrailError',
     archiveModeChanged: 'archiveModeChanged',
-    personaSwitchLocked: 'personaSwitchLocked',
+    rolePackSwitchLocked: 'rolePackSwitchLocked',
     workProjectionGenerated: 'workProjectionGenerated',
-    boostPersistFailed: 'boostPersistFailed',
     dedupCompleted: 'dedupCompleted',
+    sessionPauseTimedOut: 'sessionPauseTimedOut',
+    sessionResumeBlocked: 'sessionResumeBlocked',
+    /** 订阅时宿主据此判断重要事件并 toast 提示 */
+    sessionResumeFailed: 'sessionResumeFailed',
+    /** 装配前判负（洞 3）：触发输入过大，剩余预算无法支撑至少一轮正文——与软上限不同失败原因 */
+    inputTooLarge: 'inputTooLarge',
+    /** 回答中 LLM 调 ask_user 工具主动提问（唯一「提问后暂停」通道） */
+    questionPending: 'questionPending',
+    goalDriftDetected: 'goalDriftDetected',
+    sessionPaused: 'sessionPaused',
+    sessionResumed: 'sessionResumed',
+    sessionError: 'sessionError',
+    sessionRecovered: 'sessionRecovered',
+    /** 会话标题被 LLM 自动更新（SessionNamer 完成后触发，宿主据此刷新 UI） */
+    sessionTitleUpdated: 'sessionTitleUpdated',
+    /**
+     * 轮次摘要生成完成（round-summary fire-and-forget 后台任务收口信号）。
+     * 宿主据此解锁「问答闭环完整结束」的 UI 状态（删除/分叉按钮解禁）——
+     * 避免 done 后立即删除导致孤儿 round-summary（摘要还在生成就删了源）。
+     * 一次 chat() 只触发一次，载荷带 roundId 溯源。
+     */
+    roundSummaryGenerated: 'roundSummaryGenerated',
 };
-/** 运行时校验用 Set（由 AGENT_EVENTS 派生） */
+/** 运行时校验用集合（由 AGENT_EVENTS 派生） */
 export const AGENT_EVENT_SET = new Set(Object.values(AGENT_EVENTS));
 /**
- * 类型安全的事件发射器
- *
- * 泛型参数 EventMap 约束了合法的事件名和对应的载荷类型，
- * 调用方在编译期就能获得类型检查和自动补全。
+ * 类型安全事件发射器——泛型 EventMap 约束合法事件名与载荷类型，
+ * 调用方在编译期获得类型检查和自动补全。
  */
 export class TypedEventEmitter {
     listeners = new Map();
-    /**
-     * 订阅事件
-     * @param event - 事件名
-     * @param handler - 事件处理器
-     */
+    /** 订阅事件（同一 handler 引用加入 Set，天然避免重复监听） */
     on(event, handler) {
         let set = this.listeners.get(event);
         if (!set) {
@@ -54,19 +60,11 @@ export class TypedEventEmitter {
         }
         set.add(handler);
     }
-    /**
-     * 取消订阅
-     * @param event - 事件名
-     * @param handler - 要移除的处理器（必须是同一个引用）
-     */
+    /** 取消订阅（必须是与 on 相同的引用） */
     off(event, handler) {
         this.listeners.get(event)?.delete(handler);
     }
-    /**
-     * 订阅事件（仅触发一次，触发后自动移除）
-     * @param event - 事件名
-     * @param handler - 事件处理器
-     */
+    /** 一次性订阅：触发后自动移除，再转发给 handler（防泄漏） */
     once(event, handler) {
         const wrapper = ((data) => {
             this.off(event, wrapper);
@@ -74,11 +72,7 @@ export class TypedEventEmitter {
         });
         this.on(event, wrapper);
     }
-    /**
-     * 发射事件
-     * @param event - 事件名
-     * @param payload - 事件载荷
-     */
+    /** 发射事件；单处理器异常不阻断其余监听器 */
     emit(event, payload) {
         const set = this.listeners.get(event);
         if (!set || set.size === 0)
@@ -92,9 +86,7 @@ export class TypedEventEmitter {
             }
         }
     }
-    /**
-     * 移除所有监听器（用于 close() 清理）
-     */
+    /** 移除所有监听器（用于 close() 清理） */
     removeAllListeners() {
         this.listeners.clear();
     }

package/dist/utils/eventEmitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"eventEmitter.js","sourceRoot":"","sources":["../../src/utils/eventEmitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,iDAAiD;AACjD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,uBAAuB,EAAE,yBAAyB;IAClD,kBAAkB,EAAE,oBAAoB;IACxC,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAKX,oCAAoC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;AA0FzF;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACX,SAAS,GAAG,IAAI,GAAG,EAAyC,CAAC;IAE9E;;;;OAIG;IACH,EAAE,CAAoC,KAAQ,EAAE,OAAqC;QACnF,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAmC,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAoC,KAAQ,EAAE,OAAqC;QACpF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAmC,CAAC,CAAC;IACzE,CAAC;IAED;;;;OAIG;IACH,IAAI,CACF,KAAQ,EACR,OAAqC;QAErC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAiB,EAAE,EAAE;YACrC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAuC,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAiC,CAAC;QACnC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACO,IAAI,CAAoC,KAAQ,EAAE,OAAoB;QAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACnC,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACO,kBAAkB;QAC1B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"eventEmitter.js","sourceRoot":"","sources":["../../src/utils/eventEmitter.ts"],"names":[],"mappings":"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"}

package/dist/utils/fileSafe.d.ts

@@ -0,0 +1,20 @@
+import { type Stats } from 'node:fs';
+/**
+ * 内容文件读取长度上限（字符）——防超大文件撑爆上下文
+ *
+ * SSOT 说明：角色包侧原以 `MAX_CONTENT_FILE_LEN` 使用本值；提升为共享原语后，
+ * 全局技能读取 L3 资源与 validateFile 也获得同等级保护。
+ */
+export declare const DEFAULT_MAX_CONTENT_LEN = 200000;
+/**
+ * 读取文本文件内容，超限截断；失败返回 null（不告警，由调用方决定语义）。
+ *
+ * @param filePath 文件绝对路径
+ * @param maxLen 最大长度（字符），超限截断
+ */
+export declare function readFileCapped(filePath: string, maxLen?: number): Promise<string | null>;
+/** 安全的 stat 同步调用：不可访问返回 null，不抛异常（返回完整 `Stats`，调用方按需取字段） */
+export declare function statSyncSafe(path: string): Stats | null;
+/** 安全的存在性同步调用：不可访问按不存在处理，不抛异常（实现即 `existsSync`，名字与之一致） */
+export declare function existsSyncSafe(path: string): boolean;
+//# sourceMappingURL=fileSafe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileSafe.d.ts","sourceRoot":"","sources":["../../src/utils/fileSafe.ts"],"names":[],"mappings":"AAcA,OAAO,EAAwB,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAgC,GACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAMvD;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMpD"}

package/dist/utils/fileSafe.js

@@ -0,0 +1,56 @@
+/**
+ * 文件安全访问原语（读取 / stat / 存在性）——收口两侧重复的私有实现
+ *
+ * 背景：全局技能（SkillManager）与角色包内嵌技能（RolePackManager）各自在文件访问上
+ * 长出了私有辅助函数，且**能力不对等**：
+ * - 角色包侧 `readContentSafe` 有**长度上限**（防超大文件膨胀），全局侧 `readFile` 裸读无上限；
+ * - 角色包侧 `getSkillScriptPath` 有**存在性校验**，全局侧无。
+ * 按「差异点取更全面形态」的收敛原则，把**更全面的一侧**提升为共享原语，两侧同时受益。
+ *
+ * 边界：本模块只提供**能力**，不替调用方决定失败语义——
+ * 读取失败返回 null，由调用方决定是降级为空串（角色包内容文件）还是向上报 null（L3 资源）。
+ * 失败语义是对外契约，统一它会造成破坏性变更，故不在本模块收口。
+ */
+import { readFile } from 'node:fs/promises';
+import { statSync, existsSync } from 'node:fs';
+/**
+ * 内容文件读取长度上限（字符）——防超大文件撑爆上下文
+ *
+ * SSOT 说明：角色包侧原以 `MAX_CONTENT_FILE_LEN` 使用本值；提升为共享原语后，
+ * 全局技能读取 L3 资源与 validateFile 也获得同等级保护。
+ */
+export const DEFAULT_MAX_CONTENT_LEN = 200_000;
+/**
+ * 读取文本文件内容，超限截断；失败返回 null（不告警，由调用方决定语义）。
+ *
+ * @param filePath 文件绝对路径
+ * @param maxLen 最大长度（字符），超限截断
+ */
+export async function readFileCapped(filePath, maxLen = DEFAULT_MAX_CONTENT_LEN) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return content.length > maxLen ? content.slice(0, maxLen) : content;
+    }
+    catch {
+        return null;
+    }
+}
+/** 安全的 stat 同步调用：不可访问返回 null，不抛异常（返回完整 `Stats`，调用方按需取字段） */
+export function statSyncSafe(path) {
+    try {
+        return statSync(path);
+    }
+    catch {
+        return null;
+    }
+}
+/** 安全的存在性同步调用：不可访问按不存在处理，不抛异常（实现即 `existsSync`，名字与之一致） */
+export function existsSyncSafe(path) {
+    try {
+        return existsSync(path);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fileSafe.js.map

package/dist/utils/fileSafe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSafe.js","sourceRoot":"","sources":["../../src/utils/fileSafe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAc,MAAM,SAAS,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,SAAiB,uBAAuB;IAExC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/frontmatter.d.ts

@@ -1,9 +1,8 @@
 /**
  * Frontmatter 通用解析/序列化工具
  *
- * 直接消费者为 memory/store.ts 和 utils/scanner.ts
- * （scanner 间接供 personaManager / skillManager 使用），非 persona/skill 直接 import。
- * 详见 ADR-004 · 记忆统一为"类型 + 永久性标记"模型
+ * 直接消费者为 utils/scanner.ts、skill/skillManager.ts、role-pack/rolePackManager.ts（frontmatter 解析），
+ * 并经 index.ts 导出供宿主复用。
  */
 /**
  * 解析 frontmatter 块为键值对

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

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd,CAwBA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKhF"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd,CAwBA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKhF"}

package/dist/utils/frontmatter.js

@@ -1,9 +1,8 @@
 /**
  * Frontmatter 通用解析/序列化工具
  *
- * 直接消费者为 memory/store.ts 和 utils/scanner.ts
- * （scanner 间接供 personaManager / skillManager 使用），非 persona/skill 直接 import。
- * 详见 ADR-004 · 记忆统一为"类型 + 永久性标记"模型
+ * 直接消费者为 utils/scanner.ts、skill/skillManager.ts、role-pack/rolePackManager.ts（frontmatter 解析），
+ * 并经 index.ts 导出供宿主复用。
  */
 /**
  * 解析 frontmatter 块为键值对

package/dist/utils/frontmatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAI1C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClE,gDAAgD;IAChD,mDAAmD;IACnD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACrE,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;IAED,mEAAmE;IACnE,8CAA8C;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,GAAG,CAAC;YAAE,SAAS;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC;YAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmC;IACtE,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAI1C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClE,gDAAgD;IAChD,mDAAmD;IACnD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACrE,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;IAED,mEAAmE;IACnE,8CAA8C;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,GAAG,CAAC;YAAE,SAAS;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC;YAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmC;IACtE,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/utils/hash.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 计算字符串的 SHA-256 指纹（hex 格式）
+ *
+ * 用途：
+ *   - "模型看到了什么"可追溯：对系统提示 / 记忆 ID 集合生成轻量指纹，
+ *     让宿主在调试时能对比"本轮注入的内容是否变化"，而不必存储全量内容
+ *
+ * @param input 输入字符串
+ * @returns 64 位小写 hex 哈希
+ */
+export declare function sha256Fingerprint(input: string): string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAcA;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/utils/hash.js

@@ -0,0 +1,27 @@
+/**
+ * 通用哈希工具 — 内容指纹生成
+ *
+ * 职责：
+ *   - 提供纯函数 sha256Fingerprint，对任意字符串生成 SHA-256 hex 指纹
+ *   - 供可观测性埋点（系统提示指纹、记忆集合指纹）复用，
+ *     避免在 agent/ 层各自重复实现 createHash 逻辑
+ *
+ * 设计约束：
+ *   - 纯函数：无状态、无副作用、同输入同输出
+ *   - 复用 node:crypto（Node.js 内置），零第三方依赖
+ */
+import { createHash } from 'node:crypto';
+/**
+ * 计算字符串的 SHA-256 指纹（hex 格式）
+ *
+ * 用途：
+ *   - "模型看到了什么"可追溯：对系统提示 / 记忆 ID 集合生成轻量指纹，
+ *     让宿主在调试时能对比"本轮注入的内容是否变化"，而不必存储全量内容
+ *
+ * @param input 输入字符串
+ * @returns 64 位小写 hex 哈希
+ */
+export function sha256Fingerprint(input) {
+    return createHash('sha256').update(input, 'utf-8').digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/utils/http.d.ts

@@ -0,0 +1,17 @@
+/**
+ * HTTP 网络工具：浏览器 User-Agent 常量 + 带超时控制的 fetch。
+ * web-search / web-fetch 默认实现共享，避免同语义逻辑双处维护（SSOT 下沉）。
+ */
+/** 通用浏览器 User-Agent（避免被目标站当作爬虫拒绝） */
+export declare const BROWSER_UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+/**
+ * 带超时控制的 fetch：手动 AbortController + setTimeout（兼容性优于 AbortSignal.timeout），
+ * 防不可达端点挂起调用方；成功/失败均清理定时器。
+ *
+ * @param url 目标 URL
+ * @param timeoutMs 超时毫秒
+ * @param userAgent 可选 UA 头（缺省不发送）
+ * @returns fetch Response（调用方负责检查 ok 与 body 读取）
+ */
+export declare function fetchWithTimeout(url: string, timeoutMs: number, userAgent?: string): Promise<Response>;
+//# sourceMappingURL=http.d.ts.map