@cicctencent/agent-core 0.1.1

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAI5D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEvF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,YAAY,CAAC;IACxB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,qEAAqE;IACrE,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxF,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,aAAa,CAAC,EAAE,OAAO,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE;;;;;OAKG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAID,MAAM,WAAW,SAAS;IACxB,gBAAgB;IAChB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,eAAe;IACf,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEvC,aAAa;IACb,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvE,qBAAqB;IACrB,aAAa,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAEtF,mBAAmB;IACnB,YAAY,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C,WAAW;IACX,UAAU,IAAI,IAAI,CAAC;IAEnB,WAAW;IACX,WAAW,IAAI,OAAO,CAAC;CACxB"}

package/dist/memory/checkpoint.d.ts

@@ -0,0 +1,62 @@
+/** 检查点数据 */
+export interface CheckpointData {
+    /** 上次 L2 聚合时的 L1 条目总数 */
+    lastL1Count: number;
+    /** 上次 L3 生成时的 L2 条目总数 */
+    lastL2Count: number;
+    /** 最后执行时间（ISO 字符串） */
+    lastRunAt: string;
+    /** 累计执行次数 */
+    runCount: number;
+}
+/**
+ * 记忆管道检查点
+ *
+ * 用于管道调度器判断是否需要触发 L2/L3：
+ * - 当 L1 增量（当前 - lastL1Count）达到阈值时触发 L2
+ * - 当 L2 增量（当前 - lastL2Count）达到阈值时触发 L3
+ */
+export declare class MemoryCheckpoint {
+    private filePath;
+    private data;
+    /**
+     * @param filePath 检查点文件路径，默认为 {cwd}/data/memories/checkpoint.json
+     */
+    constructor(filePath?: string);
+    /** 获取当前检查点数据 */
+    get(): CheckpointData;
+    /**
+     * 判断是否应触发 L2 聚合
+     * @param currentL1Count 当前 L1 条目总数
+     * @param threshold L2 触发阈值
+     */
+    shouldTriggerL2(currentL1Count: number, threshold: number): boolean;
+    /**
+     * 判断是否应触发 L3 画像更新
+     * @param currentL2Count 当前 L2 条目总数
+     * @param threshold L3 触发阈值
+     */
+    shouldTriggerL3(currentL2Count: number, threshold: number): boolean;
+    /**
+     * 更新检查点（L2 聚合完成后调用）
+     */
+    updateL2(currentL1Count: number): void;
+    /**
+     * 更新检查点（L3 画像完成后调用）
+     */
+    updateL3(currentL2Count: number): void;
+    /**
+     * 重置检查点（用于手动触发全量重建）
+     */
+    reset(): void;
+    private load;
+    private persist;
+}
+/**
+ * 获取全局检查点实例
+ * @param filePath 可选，首次调用时指定自定义路径
+ */
+export declare function getMemoryCheckpoint(filePath?: string): MemoryCheckpoint;
+/** 重置全局实例（用于测试或路径变更场景） */
+export declare function resetMemoryCheckpoint(): void;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/memory/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/memory/checkpoint.ts"],"names":[],"mappings":"AAWA,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAiB;IAE7B;;OAEG;gBACS,QAAQ,CAAC,EAAE,MAAM;IAK7B,gBAAgB;IAChB,GAAG,IAAI,cAAc;IAIrB;;;;OAIG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAInE;;;;OAIG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAInE;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAOtC;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAMtC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,OAAO;CAWhB;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAKvE;AAED,0BAA0B;AAC1B,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/memory/extractor.d.ts

@@ -0,0 +1,59 @@
+import type { LLMProvider } from '../llm/types.ts';
+import type { Message } from '../types.ts';
+/** 从对话中提取的原子事实 */
+export interface AtomFact {
+    /** 记忆键（snake_case，用于 upsert） */
+    key: string;
+    /** 事实内容 */
+    content: string;
+    /** 分类 */
+    category: 'user_preference' | 'project_knowledge' | 'learned_fact' | 'custom';
+    /** 重要程度 1-5 */
+    importance: number;
+    /** 来源会话 ID */
+    sourceSessionId: string;
+}
+/** 提取配置 */
+export interface ExtractorOptions {
+    /** LLM Provider 实例 */
+    llmProvider: LLMProvider;
+    /** 单次提取最大原子事实数，默认 5 */
+    maxFactsPerSession?: number;
+    /** 触发提取的最小迭代次数，默认 3 */
+    minIterations?: number;
+    /** 提取超时（毫秒），默认 30000 */
+    timeoutMs?: number;
+}
+/**
+ * LLM 驱动的原子事实提取器
+ * 从对话历史中提取持久性、可复用的结构化事实（L1 Atom）
+ */
+export declare class MemoryExtractor {
+    private llmProvider;
+    private maxFactsPerSession;
+    private minIterations;
+    private timeoutMs;
+    constructor(opts: ExtractorOptions);
+    /**
+     * 从对话消息中提取原子事实
+     * @param messages 对话消息列表
+     * @param sessionId 当前会话 ID
+     * @param existingKeys 已有的记忆键（用于去重）
+     * @returns 提取到的原子事实数组
+     */
+    extract(messages: Message[], sessionId: string, existingKeys: string[]): Promise<AtomFact[]>;
+    /**
+     * 调用 LLM 提取事实
+     */
+    private callLLM;
+    /**
+     * 解析 LLM 输出的 JSON 数组
+     */
+    private parseFacts;
+    private normalizeCategory;
+    /**
+     * 构建对话摘要（将消息列表压缩为文本，限制总字符数）
+     */
+    private buildMessagesSummary;
+}
+//# sourceMappingURL=extractor.d.ts.map

package/dist/memory/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/memory/extractor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,kBAAkB;AAClB,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,QAAQ,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,cAAc,GAAG,QAAQ,CAAC;IAC9E,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,WAAW;AACX,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,uBAAuB;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,gBAAgB;IAOlC;;;;;;OAMG;IACG,OAAO,CACX,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,QAAQ,EAAE,CAAC;IAetB;;OAEG;YACW,OAAO;IAqBrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAuB7B"}

package/dist/memory/persona.d.ts

@@ -0,0 +1,38 @@
+import type { LLMProvider } from '../llm/types.ts';
+import type { SceneBlock } from './scene.ts';
+/** 画像维度 */
+export interface PersonaFacet {
+    /** 维度键（如 coding_style, tool_preference） */
+    key: string;
+    /** 维度内容（markdown） */
+    content: string;
+}
+/** 画像生成器配置 */
+export interface PersonaGeneratorOptions {
+    llmProvider: LLMProvider;
+    /** 超时（毫秒），默认 30000 */
+    timeoutMs?: number;
+}
+/**
+ * L3 用户画像生成器
+ *
+ * 工作流程：
+ * 1. 接收 L2 场景块列表
+ * 2. 通过 LLM 从场景中提炼稳定用户特征
+ * 3. 增量更新画像（保留已有内容，仅修改受影响的部分）
+ */
+export declare class PersonaGenerator {
+    private llmProvider;
+    private timeoutMs;
+    constructor(opts: PersonaGeneratorOptions);
+    /**
+     * 生成或更新用户画像
+     * @param scenes L2 场景块列表
+     * @param existingPersona 已有画像（markdown 文本，用于增量更新）
+     * @returns 更新后的画像 markdown
+     */
+    generate(scenes: SceneBlock[], existingPersona?: string): Promise<string>;
+    private buildUserPrompt;
+    private callLLM;
+}
+//# sourceMappingURL=persona.d.ts.map

package/dist/memory/persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/memory/persona.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,cAAc;AACd,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,uBAAuB;IAKzC;;;;;OAKG;IACG,QAAQ,CACZ,MAAM,EAAE,UAAU,EAAE,EACpB,eAAe,GAAE,MAAW,GAC3B,OAAO,CAAC,MAAM,CAAC;IAalB,OAAO,CAAC,eAAe;YAoBT,OAAO;CAoBtB"}

package/dist/memory/pipeline.d.ts

@@ -0,0 +1,50 @@
+import type { LLMProvider } from '../llm/types.ts';
+import type { MemoryServiceLike } from './types.ts';
+import { type SceneBlock } from './scene.ts';
+import type { Message } from '../types.ts';
+/** 管道配置 */
+export interface PipelineOptions {
+    llmProvider: LLMProvider;
+    /** 触发 L2 聚合的 L1 增量阈值（新 L1 条目数），默认 5 */
+    l2Threshold?: number;
+    /** 触发 L3 画像更新的 L2 增量阈值，默认 3 */
+    l3Threshold?: number;
+}
+/** 管道执行结果 */
+export interface PipelineResult {
+    /** 本次提取的 L1 原子事实数 */
+    l1Extracted: number;
+    /** 是否触发了 L2 聚合 */
+    l2Triggered: boolean;
+    /** 是否触发了 L3 画像更新 */
+    l3Triggered: boolean;
+    /** 新的场景块（如果触发了 L2） */
+    newScenes?: SceneBlock[];
+    /** 更新的画像（如果触发了 L3） */
+    newPersona?: string;
+}
+/**
+ * 记忆管道调度器
+ *
+ * 调度策略：
+ * 1. 每次对话结束：提取 L1 原子事实
+ * 2. L1 累积达到阈值：触发 L2 场景聚合
+ * 3. L2 累积达到阈值：触发 L3 画像生成
+ *
+ * 所有操作均为 fire-and-forget，不阻塞对话响应
+ */
+export declare class MemoryPipeline {
+    private llmProvider;
+    private l2Threshold;
+    private l3Threshold;
+    constructor(opts: PipelineOptions);
+    /**
+     * 执行完整管道（L1 提取 → 条件触发 L2 → 条件触发 L3）
+     *
+     * @param messages 对话消息
+     * @param sessionId 会话 ID
+     * @param memoryService MemoryService 实例（延迟导入避免循环依赖）
+     */
+    run(messages: Message[], sessionId: string, memoryService: MemoryServiceLike): Promise<PipelineResult>;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/memory/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/memory/pipeline.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAA4B,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9E,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,WAAW;AACX,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;IACzB,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;gBAEhB,IAAI,EAAE,eAAe;IAMjC;;;;;;OAMG;IACG,GAAG,CACP,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,iBAAiB,GAC/B,OAAO,CAAC,cAAc,CAAC;CAwH3B"}

package/dist/memory/prompts.d.ts

@@ -0,0 +1,9 @@
+/** 原子事实提取 Prompt（系统提示） */
+export declare const EXTRACTION_SYSTEM_PROMPT = "You are a memory extraction engine. Analyze the conversation and extract persistent, reusable facts.\n\n**Rules:**\n- Only extract OBJECTIVE, PERSISTENT facts that will be useful in future conversations\n- Extract: user preferences, project knowledge, technical stack, learned patterns, important decisions\n- DO NOT extract: one-off task details (e.g. \"fix bug X\"), temporary state, debugging logs\n- Each fact must be atomic (one discrete piece of knowledge)\n- Use concise, declarative language\n- Prefer updating existing keys over creating duplicates\n\n**Categories:**\n- user_preference: User's working habits, tool preferences, coding style\n- project_knowledge: Project architecture, tech stack, conventions\n- learned_fact: New knowledge gained during the conversation\n\n**Output format (strict JSON array):**\n[\n  { \"key\": \"snake_case_key\", \"content\": \"Brief factual statement\", \"category\": \"user_preference|project_knowledge|learned_fact\", \"importance\": 1-5 }\n]\n\nIf no extractable facts exist, output an empty array: []\nDo not add explanations or markdown outside the JSON.";
+/** 构建提取用户提示 */
+export declare function buildExtractionUserPrompt(messagesSummary: string, existingKeys: string[]): string;
+/** 场景聚合 Prompt（Phase 4 L2） */
+export declare const SCENE_AGGREGATION_SYSTEM_PROMPT = "You are a memory organizer. Group related atomic facts into thematic scenario blocks.\n\n**Rules:**\n- Each scenario should have a clear title and description\n- Group facts by topic/project/domain (e.g. \"\u8FDE\u63A5\u5668\u529F\u80FD\u5F00\u53D1\", \"\u9879\u76EE\u67B6\u6784\u51B3\u7B56\")\n- Max 15 scenarios total. Merge or archive old scenarios if needed.\n- A fact can belong to only one scenario\n\n**Output format (strict JSON array):**\n[\n  {\n    \"sceneId\": \"snake_case_id\",\n    \"title\": \"\u573A\u666F\u6807\u9898\",\n    \"description\": \"\u573A\u666F\u63CF\u8FF0\uFF081-2\u53E5\uFF09\",\n    \"atomIds\": [\"atom_id_1\", \"atom_id_2\"]\n  }\n]";
+/** 画像生成 Prompt（Phase 4 L3） */
+export declare const PERSONA_GENERATION_SYSTEM_PROMPT = "You are a user profiling engine. Based on the scenario blocks provided, generate or incrementally update a user persona.\n\n**Rules:**\n- Focus on stable, enduring traits: working style, technical preferences, communication patterns\n- Use clear section headers (## \u6280\u672F\u504F\u597D, ## \u5DE5\u4F5C\u98CE\u683C, ## \u9879\u76EE\u80CC\u666F, etc.)\n- Keep the persona concise (max 800 words)\n- When updating: preserve existing content, only modify sections affected by new scenarios\n\n**Output format: Markdown**\nWrite the persona directly as markdown text.";
+//# sourceMappingURL=prompts.d.ts.map

package/dist/memory/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/memory/prompts.ts"],"names":[],"mappings":"AAIA,0BAA0B;AAC1B,eAAO,MAAM,wBAAwB,wlCAqBiB,CAAC;AAEvD,eAAe;AACf,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,CASR;AAED,8BAA8B;AAC9B,eAAO,MAAM,+BAA+B,gqBAgB1C,CAAC;AAEH,8BAA8B;AAC9B,eAAO,MAAM,gCAAgC,6jBASA,CAAC"}

package/dist/memory/recall.d.ts

@@ -0,0 +1,66 @@
+import type { MemoryEntry, MemoryLayer } from './types.ts';
+/** 召回结果 */
+export interface RecallResult {
+    /** 召回的记忆条目（按相关度排序） */
+    entries: ScoredMemoryEntry[];
+    /** 是否超时 */
+    timedOut: boolean;
+    /** 召回策略描述 */
+    strategy: string;
+}
+/** 带分数的记忆条目 */
+export interface ScoredMemoryEntry extends MemoryEntry {
+    /** 相关度分数 0-1 */
+    relevanceScore: number;
+}
+/** 召回配置 */
+export interface RecallOptions {
+    /** 最大返回条数，默认 5 */
+    maxResults?: number;
+    /** 召回超时（毫秒），默认 3000 */
+    timeoutMs?: number;
+    /** 仅召回指定层级 */
+    layers?: MemoryLayer[];
+}
+/**
+ * 智能记忆召回引擎
+ *
+ * 召回策略（优先级排序）：
+ * 1. 关键词匹配：userText 分词后与 key/content 做模糊匹配
+ * 2. 重要性加权：importance 高的记忆权重更大
+ * 3. 时效性衰减：近期更新的记忆优先（updatedAt 越新分数越高）
+ *
+ * 超时保护：超过 timeoutMs 立即返回空结果，不阻塞对话
+ */
+export declare class MemoryRecallEngine {
+    /**
+     * 召回相关记忆（带超时保护）
+     */
+    recall(userText: string, allMemories: MemoryEntry[], options?: RecallOptions): Promise<RecallResult>;
+    private recallInner;
+    /**
+     * 提取查询词项（简单分词）
+     * 支持中英文混合：英文按空格，中文按字
+     */
+    private extractTerms;
+    /**
+     * 计算关键词匹配分数（TF-IDF 加权）
+     * 稀有词（出现在少量记忆中）获得更高权重，常见词权重降低
+     */
+    private computeKeywordScore;
+    /**
+     * 构建 IDF 映射表：term → IDF 分数
+     * IDF = log(N / df)，N=总文档数，df=包含该 term 的文档数
+     */
+    private buildIDFMap;
+    /**
+     * 计算时效性分数（0-1）
+     * 24 小时内的记忆得 1.0，30 天前的记忆得 ~0.1
+     */
+    private computeRecencyScore;
+}
+/**
+ * 将召回结果格式化为可注入 system prompt 的文本
+ */
+export declare function formatRecallForPrompt(result: RecallResult): string;
+//# sourceMappingURL=recall.d.ts.map

package/dist/memory/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/memory/recall.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,WAAW;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAe;AACf,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,gBAAgB;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAE7B;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EAAE,EAC1B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC;YAWV,WAAW;IAgDzB;;;OAGG;IACH,OAAO,CAAC,YAAY;IA0BpB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAuBnB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAS5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CASlE"}

package/dist/memory/scene.d.ts

@@ -0,0 +1,49 @@
+import type { LLMProvider } from '../llm/types.ts';
+/** 场景块（L2） */
+export interface SceneBlock {
+    /** 场景 ID（snake_case） */
+    sceneId: string;
+    /** 场景标题 */
+    title: string;
+    /** 场景描述 */
+    description: string;
+    /** 归属的原子事实 ID 列表 */
+    atomIds: string[];
+}
+/** 聚合器配置 */
+export interface SceneAggregatorOptions {
+    llmProvider: LLMProvider;
+    /** 最大场景数，默认 15 */
+    maxScenes?: number;
+    /** 超时（毫秒），默认 30000 */
+    timeoutMs?: number;
+}
+/**
+ * L2 场景聚合器
+ *
+ * 工作流程：
+ * 1. 收集所有 L1 原子事实
+ * 2. 通过 LLM 将相关事实分组为场景块
+ * 3. 输出 SceneBlock[]，供 MemoryService 更新 L2 条目
+ */
+export declare class SceneAggregator {
+    private llmProvider;
+    private maxScenes;
+    private timeoutMs;
+    constructor(opts: SceneAggregatorOptions);
+    /**
+     * 聚合原子事实为场景块
+     * @param atoms L1 原子事实列表（key + content + id）
+     * @param existingScenes 已有场景（用于增量更新）
+     */
+    aggregate(atoms: Array<{
+        id: string;
+        key: string;
+        content: string;
+        category: string;
+    }>, existingScenes?: SceneBlock[]): Promise<SceneBlock[]>;
+    private buildUserPrompt;
+    private callLLM;
+    private parseScenes;
+}
+//# sourceMappingURL=scene.d.ts.map

package/dist/memory/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/memory/scene.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,cAAc;AACd,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,YAAY;AACZ,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,WAAW,CAAC;IACzB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,sBAAsB;IAMxC;;;;OAIG;IACG,SAAS,CACb,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EAC5E,cAAc,GAAE,UAAU,EAAO,GAChC,OAAO,CAAC,UAAU,EAAE,CAAC;IAcxB,OAAO,CAAC,eAAe;YAqBT,OAAO;IAqBrB,OAAO,CAAC,WAAW;CAsBpB"}

package/dist/memory/types.d.ts

@@ -0,0 +1,43 @@
+/** 记忆层级 */
+export type MemoryLayer = 'L0' | 'L1' | 'L2' | 'L3';
+/** 记忆条目（与上层 MemoryService 的 MemoryEntry 保持一致，上层负责转换） */
+export interface MemoryEntry {
+    /** 唯一标识（基于 key 生成） */
+    id: string;
+    /** 记忆分类：user_preference / project_knowledge / learned_fact / custom / scene / persona */
+    category: string;
+    /** 记忆键（用于 upsert） */
+    key: string;
+    /** 记忆内容 */
+    content: string;
+    /** 重要程度 1-5，默认 3 */
+    importance: number;
+    /** 创建时间（ISO 字符串） */
+    createdAt: string;
+    /** 最后更新时间（ISO 字符串） */
+    updatedAt: string;
+    /** 记忆层级：L0=原始对话 L1=原子事实 L2=场景块 L3=用户画像，默认 L1 */
+    memoryLayer: MemoryLayer;
+    /** 来源会话 ID（自动提取时记录） */
+    sourceSessionId?: string;
+    /** 提取时间戳（ISO 字符串） */
+    sourceTimestamp?: string;
+    /** L2 场景 ID（归属场景块） */
+    sceneId?: string;
+    /** L3 画像维度（如 coding_style, tool_preference） */
+    personaFacet?: string;
+    /** 来源层级（该条目从哪一层提炼而来） */
+    sourceLayer?: MemoryLayer;
+    /** 来源条目 ID 列表（溯源链） */
+    sourceIds?: string[];
+}
+/**
+ * MemoryServiceLike — 管道调度器所需的 MemoryService 最小接口
+ * 上层（server 侧）的 MemoryService 实现此接口即可接入管道
+ */
+export interface MemoryServiceLike {
+    getKeys(): string[];
+    getAllEntries(layer?: MemoryLayer): MemoryEntry[];
+    save(key: string, content: string, category: string, importance: number, extras?: Partial<Pick<MemoryEntry, 'memoryLayer' | 'sourceSessionId' | 'sourceTimestamp' | 'sceneId' | 'sourceLayer' | 'sourceIds'>>): MemoryEntry;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAIA,WAAW;AACX,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,WAAW,EAAE,WAAW,CAAC;IACzB,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,IAAI,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IAClD,IAAI,CACF,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC,CAAC,GACnI,WAAW,CAAC;CAChB"}

package/dist/middleware/types.d.ts

@@ -0,0 +1,52 @@
+import type { HookContext, HookResult } from '../hooks/types.ts';
+/**
+ * 中间件 before/after 接收的上下文信息
+ * 包含当前迭代的关键状态快照，中间件可读取但不应直接修改
+ */
+export interface MiddlewareContext {
+    /** 会话 ID */
+    sessionId: string;
+    /** 当前迭代轮次 */
+    iteration: number;
+    /** 当前消息列表（只读快照） */
+    messages: ReadonlyArray<{
+        role: string;
+        content: string | null;
+    }>;
+    /** 当前可用工具数量 */
+    toolCount: number;
+}
+/**
+ * 中间件接口 — Hook 系统的结构化增强层
+ *
+ * 与 Hook 共存，提供更清晰的 before/after 生命周期：
+ * - `before` / `after`：在每轮迭代的开始/结束执行
+ * - `onToolBefore` / `onToolAfter`：在工具执行前/后执行（与 before_tool/after_tool Hook 并行）
+ *
+ * 执行顺序：Middleware.before → Hook.on_iteration_start → ... → Hook.before_tool → Middleware.onToolBefore → 工具执行 → Hook.after_tool → Middleware.onToolAfter → ... → Middleware.after
+ */
+export interface Middleware {
+    /** 中间件名称（用于日志和调试） */
+    name: string;
+    /**
+     * 每轮迭代开始前调用
+     * 适合：预检查、上下文注入、状态审计
+     */
+    before?(ctx: MiddlewareContext): Promise<void>;
+    /**
+     * 每轮迭代结束后调用
+     * 适合：后处理、指标收集、日志记录
+     */
+    after?(ctx: MiddlewareContext): Promise<void>;
+    /**
+     * 工具执行前调用（与 before_tool Hook 同层）
+     * 返回值与 Hook 的 before_tool 合并（block/modify 均生效）
+     */
+    onToolBefore?(ctx: HookContext): Promise<HookResult | void>;
+    /**
+     * 工具执行后调用（与 after_tool Hook 同层）
+     * 返回值与 Hook 的 after_tool 合并（inject 均生效）
+     */
+    onToolAfter?(ctx: HookContext): Promise<HookResult | void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/middleware/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/middleware/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIjE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,QAAQ,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAClE,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;OAGG;IACH,YAAY,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE5D;;;OAGG;IACH,WAAW,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC5D"}

package/dist/sandbox/types.d.ts

@@ -0,0 +1,59 @@
+import type { SecurityRule } from '../security/types.ts';
+import type { ShellExecutor, FileSystemExecutor } from '../tool/types.ts';
+/** 沙箱配置 */
+export interface SandboxConfig {
+    /** 沙箱根目录（默认 ~/.workagent/sandboxes/{id}） */
+    rootDir: string;
+    /** 允许的文件扩展名（脚本执行用），空 = 不限制 */
+    allowedExtensions?: string[];
+    /** 最大文件大小 (bytes)，默认 10MB */
+    maxFileSize?: number;
+    /** 执行超时 (ms)，默认 30000 */
+    execTimeout?: number;
+    /** 是否启用命令限制（默认 true） */
+    commandRestriction?: boolean;
+}
+/** 默认沙箱配置 */
+export declare const DEFAULT_SANDBOX_CONFIG: Partial<SandboxConfig>;
+/** 脚本语言类型 */
+export type ScriptLanguage = 'python' | 'nodejs' | 'shell';
+/** 沙箱实例接口 */
+export interface Sandbox {
+    readonly id: string;
+    readonly rootDir: string;
+    /** 获取受限的 Shell 执行器 */
+    getShellExecutor(): ShellExecutor;
+    /** 获取受限的文件系统执行器 */
+    getFileSystemExecutor(): FileSystemExecutor;
+    /**
+     * 运行脚本（写入临时文件并执行）
+     * @param language 脚本语言：python / nodejs / shell
+     * @param code     脚本代码
+     * @param timeout  执行超时 (ms)
+     */
+    runScript(language: ScriptLanguage, code: string, timeout?: number): Promise<string>;
+    /** 销毁沙箱（清理临时文件） */
+    destroy(): Promise<void>;
+}
+/** 沙箱管理器接口 */
+export interface SandboxManager {
+    /** 创建沙箱 */
+    create(id: string, config?: Partial<SandboxConfig>): Promise<Sandbox>;
+    /** 获取已创建的沙箱 */
+    get(id: string): Sandbox | undefined;
+    /** 销毁指定沙箱 */
+    destroy(id: string): Promise<void>;
+    /** 销毁所有沙箱 */
+    destroyAll(): Promise<void>;
+}
+/**
+ * 沙箱专用命令黑名单（在 SecurityGuard 基础上扩展）
+ * 这些规则阻止任何试图突破沙箱隔离的操作
+ */
+export declare const SANDBOX_BLOCKED_COMMANDS: SecurityRule[];
+/**
+ * 沙箱允许的环境变量白名单
+ * 只保留脚本运行所需的最小环境变量集合
+ */
+export declare const SANDBOX_SAFE_ENV_KEYS: string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/sandbox/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sandbox/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI1E,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,aAAa;AACb,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,aAAa,CAIzD,CAAC;AAIF,aAAa;AACb,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,aAAa;AACb,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sBAAsB;IACtB,gBAAgB,IAAI,aAAa,CAAC;IAClC,mBAAmB;IACnB,qBAAqB,IAAI,kBAAkB,CAAC;IAC5C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrF,mBAAmB;IACnB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAID,cAAc;AACd,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,eAAe;IACf,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,aAAa;IACb,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,aAAa;IACb,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAID;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,YAAY,EAyFlD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAezC,CAAC"}

package/dist/security/guard.d.ts

@@ -0,0 +1,41 @@
+import type { SanitizeResult, SecurityRule, SecurityPolicy } from './types.ts';
+export declare class SecurityGuard {
+    private policy;
+    /** 已编译的正则规则缓存（避免每次 sanitize 重复遍历数组） */
+    private compiledBlacklist;
+    private compiledCustomRewrite;
+    private compiledCustomWarn;
+    /** 删除保护规则（使用 policy.trashDir） */
+    private deleteProtectionRule;
+    constructor(policy?: Partial<SecurityPolicy>);
+    /** 编译规则缓存（policy 变更时调用） */
+    private invalidateCompiledRules;
+    private getCompiledBlacklist;
+    private getCompiledCustomRewrite;
+    private getCompiledCustomWarn;
+    /** 检查命令安全性 */
+    sanitize(command: string): SanitizeResult;
+    /** 添加自定义安全规则 */
+    addRule(rule: SecurityRule): void;
+    /** 移除规则 */
+    removeRule(name: string): void;
+    /** 更新安全策略 */
+    setPolicy(policy: Partial<SecurityPolicy>): void;
+    /** 获取当前策略 */
+    getPolicy(): SecurityPolicy;
+    /**
+     * 扫描并脱敏文本中的敏感信息
+     * 将检测到的 API Key、Token、密码等替换为 [REDACTED:xxx]
+     * @param text 输入文本（通常是工具结果）
+     * @returns 脱敏后的文本
+     */
+    sanitizeCredentials(text: string): string;
+    /**
+     * 检测文本是否包含敏感信息
+     * @param text 输入文本
+     * @returns 检测到的敏感信息类型列表
+     */
+    detectCredentials(text: string): string[];
+    private matchRule;
+}
+//# sourceMappingURL=guard.d.ts.map

package/dist/security/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/security/guard.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyE/E,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAE/B,uCAAuC;IACvC,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,qBAAqB,CAA+B;IAC5D,OAAO,CAAC,kBAAkB,CAA+B;IACzD,iCAAiC;IACjC,OAAO,CAAC,oBAAoB,CAAe;gBAE/B,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAM5C,2BAA2B;IAC3B,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,wBAAwB;IAOhC,OAAO,CAAC,qBAAqB;IAO7B,cAAc;IACd,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAuDzC,gBAAgB;IAChB,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAKjC,WAAW;IACX,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B,aAAa;IACb,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAQhD,aAAa;IACb,SAAS,IAAI,cAAc;IAM3B;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYzC;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAczC,OAAO,CAAC,SAAS;CAMlB"}

package/dist/security/types.d.ts

@@ -0,0 +1,36 @@
+export type Severity = 'safe' | 'warn' | 'danger' | 'blocked';
+export interface SanitizeResult {
+    /** 是否允许执行 */
+    safe: boolean;
+    /** 改写后的命令（如 rm → mv 到回收站） */
+    rewritten?: string;
+    /** 拒绝/警告原因 */
+    reason?: string;
+    /** 严重程度 */
+    severity: Severity;
+}
+export interface SecurityRule {
+    /** 规则名称 */
+    name: string;
+    /** 匹配模式（正则或函数） */
+    pattern: RegExp | ((command: string) => boolean);
+    /** 命中后的严重程度 */
+    severity: Severity;
+    /** 命中后的处理：'block' 阻止 | 'rewrite' 改写 | 'warn' 放行但记录 */
+    action: 'block' | 'rewrite' | 'warn';
+    /** 改写函数（action='rewrite' 时使用） */
+    rewriter?: (command: string) => string;
+    /** 规则描述 */
+    description?: string;
+}
+export interface SecurityPolicy {
+    /** 是否启用删除保护（rm → mv 到回收站） */
+    deleteProtection: boolean;
+    /** 回收站路径 */
+    trashDir: string;
+    /** 是否启用黑名单 */
+    blacklistEnabled: boolean;
+    /** 自定义规则 */
+    rules: SecurityRule[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/security/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/security/types.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,IAAI,EAAE,OAAO,CAAC;IACd,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAID,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IACjD,eAAe;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,sDAAsD;IACtD,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY;IACZ,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB"}