@zooique/memora 0.1.0

package/dist/skill/skillManager.js

@@ -0,0 +1,198 @@
+/**
+ * 技能管理器 — 单层目录扫描 + 关键词匹配
+ *
+ * 职责：
+ *   - 启动时扫描 configDir/skills/ 目录
+ *   - 通过关键词匹配选择技能（初期阶段一/二）
+ *   - 写入 SQLite 索引（source: skill，遵循"万物皆记忆"）
+ *   - 后期触发条件（≥15个技能 / 关键词命中率 <80%）→ 切换为 LLM 自主选择
+ *
+ * 设计原则（ADR-004 万物皆记忆）：
+ *   - 技能遵循"万物皆记忆"——存入 SQLite 作为 skill 来源记忆
+ *   - 单层目录：<configDir>/skills/（宿主负责汇总全局+项目级技能到 configDir）
+ *   - 与 PersonaManager 存储策略一致：文件加载 → 内存缓存 + SQLite 索引
+ *
+ * 触发词说明：
+ *   每个 skill 文件的 frontmatter 声明 keywords（逗号分隔）和 trigger（触发正则，可选）。
+ *   skill 文件命名规范：`<技能名>.md`（如"去AI味.md""审视角.md""写代码.md"）。
+ */
+import { scoreByKeywords } from '../utils/segmenter.js';
+import { SOURCE_LABELS } from '../memory/types.js';
+import { logger } from '../logging/logger.js';
+import { configError } from '../utils/errors.js';
+import { scanMarkdownDir, parseKeywords, parseTrigger, resolveSubdir } from '../utils/scanner.js';
+/**
+ * 技能管理器
+ */
+export class SkillManager {
+    configDir;
+    index;
+    /** 技能列表缓存（启动时扫描一次） */
+    skills = [];
+    /**
+     * @param configDir 配置目录（技能文件在 <configDir>/skills/ 下）
+     * @param index SQLite 索引（用于写入 skill 记忆）
+     */
+    constructor(configDir, index) {
+        this.configDir = configDir;
+        this.index = index;
+    }
+    /**
+     * 启动时加载：扫描技能目录
+     *
+     * @returns 加载的技能数量
+     */
+    async load() {
+        this.skills = await this.scanSkills();
+        logger.info({ count: this.skills.length, names: this.skills.map((s) => s.name) }, '技能加载完成');
+        // 写入 SQLite 索引（遵循"万物皆记忆"——与 PersonaManager 一致）
+        await this.writeAllToIndex();
+        return this.skills.length;
+    }
+    /**
+     * 根据用户输入匹配最合适的技能
+     *
+     * 匹配流程：
+     *   1. 先检查所有 trigger 正则，命中直接返回（最高优先级）
+     *   2. 再检查关键词匹配（TF 计分，得分排序）
+     *   3. 若匹配多项但得分相同 → 取第一个
+     *   4. 无任何匹配 → 返回 null
+     *
+     * @param userInput 用户输入文本
+     * @returns 匹配结果，无匹配返回 null
+     */
+    match(userInput) {
+        if (this.skills.length === 0)
+            return null;
+        // 1. trigger 正则匹配（最高优先级）
+        for (const skill of this.skills) {
+            if (skill.trigger?.test(userInput)) {
+                logger.debug({ skill: skill.name, trigger: skill.trigger.source }, '技能触发器匹配');
+                return { skill, score: 1.0 };
+            }
+        }
+        const matches = [];
+        for (const skill of this.skills) {
+            if (skill.keywords.length === 0)
+                continue;
+            const score = scoreByKeywords(userInput, skill.keywords);
+            if (score > 0) {
+                matches.push({ skill, score });
+            }
+        }
+        if (matches.length === 0)
+            return null;
+        // 得分从高到低排序，取第一个
+        matches.sort((a, b) => b.score - a.score);
+        const best = matches[0];
+        if (!best)
+            return null;
+        logger.debug({ matched: best.skill.name, score: best.score }, '技能关键词匹配');
+        return best;
+    }
+    /**
+     * 根据技能名获取技能
+     *
+     * @param name 技能名
+     * @returns 技能条目，不存在返回 null
+     */
+    get(name) {
+        return this.skills.find((s) => s.name === name) ?? null;
+    }
+    /**
+     * 获取所有技能列表
+     */
+    get list() {
+        return this.skills;
+    }
+    /**
+     * 注册运行时注入的技能
+     *
+     * 供 Agent.addSkill() 调用：宿主程序可在 init() 之后动态注入技能。
+     * 重复注册同名技能会被拒绝（与文件加载的技能冲突时也按"先到先得"判断）。
+     *
+     * @param skill 技能条目
+     * @throws 技能名已存在时抛错
+     */
+    register(skill) {
+        if (this.skills.some((s) => s.name === skill.name)) {
+            throw configError(`技能 "${skill.name}" 已存在，不能重复注册`, undefined, ['请使用不同的技能名称']);
+        }
+        this.skills.push(skill);
+        logger.info({ name: skill.name, keywords: skill.keywords.length }, '技能已注册（运行时注入）');
+    }
+    /**
+     * 构建 system prompt 中的技能段
+     *
+     * 格式：
+     *   【当前技能】技能名
+     *   技能 prompt 正文...
+     *
+     * @param name 技能名（可选，不传返回空）
+     */
+    buildSystemPrompt(name) {
+        if (!name)
+            return '';
+        const skill = this.get(name);
+        if (!skill)
+            return '';
+        return `【当前技能】${skill.name}\n${skill.content}`;
+    }
+    // ── 私有方法 ──────────────────────────────────────
+    /**
+     * 将所有技能写入 SQLite 索引
+     */
+    async writeAllToIndex() {
+        if (!this.index)
+            return;
+        for (const skill of this.skills) {
+            this.writeSkillToIndex(skill);
+        }
+        logger.info({ count: this.skills.length }, '技能记忆已写入 SQLite');
+    }
+    /**
+     * 将单个技能写入 SQLite 索引
+     */
+    writeSkillToIndex(skill) {
+        if (!this.index)
+            return;
+        const now = new Date().toISOString();
+        const memory = {
+            id: `skill:${skill.name}`,
+            content: skill.content,
+            source: SOURCE_LABELS.SKILL,
+            name: skill.name,
+            createdAt: now,
+            accessedAt: now,
+            score: 0.7,
+        };
+        this.index.upsert(memory);
+    }
+    /**
+     * 扫描 configDir/skills/ 目录
+     *
+     * 宿主负责将全局+项目级技能汇总到 configDir，
+     * 内核只扫描一个目录，不做路径假设。
+     */
+    async scanSkills() {
+        const map = new Map();
+        const skillsDir = resolveSubdir(this.configDir, 'skills');
+        if (skillsDir) {
+            const entries = await scanMarkdownDir(skillsDir);
+            for (const entry of entries) {
+                const skill = {
+                    name: entry.name,
+                    keywords: parseKeywords(entry.frontmatter),
+                    trigger: parseTrigger(entry.frontmatter),
+                    description: entry.frontmatter['description'],
+                    content: entry.body.trim(),
+                    filePath: entry.filePath,
+                    layer: 'project',
+                };
+                map.set(entry.name, skill);
+            }
+        }
+        return Array.from(map.values());
+    }
+}
+//# sourceMappingURL=skillManager.js.map

package/dist/skill/skillManager.js.map

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

package/dist/skill/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 技能模块类型定义
+ */
+/** 技能条目（从 skills/*.md 解析） */
+export interface SkillEntry {
+    /** 技能名（文件名去 .md） */
+    name: string;
+    /** 触发关键词列表 */
+    keywords: string[];
+    /** 触发正则（可选，优先级高于 keywords） */
+    trigger?: RegExp;
+    /** 技能描述（可选） */
+    description?: string;
+    /** 技能 prompt 正文 */
+    content: string;
+    /** 来源路径 */
+    filePath: string;
+    /** 来源层（agent / project） */
+    layer: 'agent' | 'project';
+}
+/** 技能匹配结果 */
+export interface SkillMatch {
+    /** 匹配的技能 */
+    skill: SkillEntry;
+    /** 匹配得分（0-1，用于排序） */
+    score: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skill/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,KAAK,EAAE,UAAU,CAAC;IAClB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/skill/types.js

@@ -0,0 +1,5 @@
+/**
+ * 技能模块类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skill/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skill/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,86 @@
+export { toError } from '../utils/toError.js';
+export type ErrorCategory = 'config' | 'network' | 'llm' | 'tool' | 'security' | 'unknown';
+/**
+ * 工具错误码 — 用于 AgentLoop 的 Reflection（反思/自修正）逻辑
+ *
+ * 每个错误码关联一个 retryable 标记：
+ *   - 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 TOOL_TIMEOUT: "TOOL_TIMEOUT";
+    /** 用户拒绝写入（不可重试） */
+    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";
+    /** 通用错误（不可重试） */
+    readonly UNKNOWN: "UNKNOWN";
+};
+export type ToolErrorCodeValue = (typeof ToolErrorCode)[keyof typeof ToolErrorCode];
+export declare function isRetryableErrorCode(code: ToolErrorCodeValue): boolean;
+export interface FriendlyErrorOptions {
+    /** 用户能看懂的简短标题（中文） */
+    title: string;
+    /** 详细原因（可含原文） */
+    detail?: string;
+    /** 下一步建议（数组，按优先级） */
+    suggestions: string[];
+    /** 错误分类 */
+    category: ErrorCategory;
+    /** 工具错误码（用于 AgentLoop Reflection 判断是否可重试） */
+    errorCode?: ToolErrorCodeValue;
+    /** 原始错误（保留 stack） */
+    cause?: Error;
+}
+export declare class MemoraError extends Error {
+    readonly title: string;
+    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;
+    /**
+     * 记录到日志（结构化）
+     */
+    log(): void;
+}
+/**
+ * 工厂：配置错误
+ */
+export declare function configError(title: string, detail: string | undefined, suggestions: string[], cause?: Error): MemoraError;
+/**
+ * 工厂：网络错误
+ */
+export declare function networkError(title: string, detail: string | undefined, suggestions: string[], cause?: Error): MemoraError;
+/**
+ * 工厂：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;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3F;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;IACxB,qBAAqB;;IAErB,+BAA+B;;IAE/B,iBAAiB;;IAEjB,iCAAiC;;IAEjC,kBAAkB;;IAElB,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;AAapF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAEtE;AAED,MAAM,WAAW,oBAAoB;IACnC,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;IAahB;;OAEG;IACH,GAAG,IAAI,IAAI;CAcZ;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;;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"}

package/dist/utils/errors.js

@@ -0,0 +1,143 @@
+/**
+ * 统一错误类型
+ *
+ * 把"系统 Error + 英文 stack trace"包装成"分类清晰 + 中文友好 + 有下一步建议"的错误
+ * 详见 ADR-006 · 安全模型
+ *
+ * 4 大类：
+ *   - ConfigError      配置错误（apiKey 缺失、provider 不支持等）
+ *   - NetworkError     网络错误（连接超时、DNS 失败、限流等）
+ *   - LlmError         LLM 错误（4xx/5xx、返回异常 JSON）
+ *   - ToolError        工具错误（路径越界、参数无效等）
+ *
+ * 错误展示原则：
+ *   1. 标题（中文）—— 一眼看出什么问题
+ *   2. 详情（原文）—— 排查用
+ *   3. 建议（下一步）—— 怎么修复
+ */
+import { getLogger } from '../utils/loggerHolder.js';
+// 纯逻辑 toError，浏览器端可直接 import 此文件而不引入 logger 依赖
+export { toError } from '../utils/toError.js';
+/**
+ * 工具错误码 — 用于 AgentLoop 的 Reflection（反思/自修正）逻辑
+ *
+ * 每个错误码关联一个 retryable 标记：
+ *   - retryable：LLM 可以调整参数后重试（如文件路径错误、参数类型错误）
+ *   - non-retryable：重试无意义（如权限拒绝、用户拒绝写入）
+ */
+export const ToolErrorCode = {
+    /** 路径不在白名单内（不可重试） */
+    PATH_NOT_ALLOWED: 'PATH_NOT_ALLOWED',
+    /** 文件不存在（可重试 — LLM 可能用错了路径） */
+    FILE_NOT_FOUND: 'FILE_NOT_FOUND',
+    /** 权限不足（不可重试） */
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    /** 工具参数错误（可重试 — LLM 可以修正参数格式） */
+    ARGUMENT_ERROR: 'ARGUMENT_ERROR',
+    /** 工具执行超时（可重试） */
+    TOOL_TIMEOUT: 'TOOL_TIMEOUT',
+    /** 用户拒绝写入（不可重试） */
+    WRITE_REJECTED: 'WRITE_REJECTED',
+    /** 目录不存在（可重试 — LLM 可能用错了路径） */
+    DIR_NOT_FOUND: 'DIR_NOT_FOUND',
+    /** 未知工具（不可重试 — 工具未注册） */
+    UNKNOWN_TOOL: 'UNKNOWN_TOOL',
+    /** 自定义工具执行失败（可重试） */
+    CUSTOM_TOOL_FAILED: 'CUSTOM_TOOL_FAILED',
+    /** 通用错误（不可重试） */
+    UNKNOWN: 'UNKNOWN',
+};
+/**
+ * 判断错误码是否可重试
+ */
+const RETRYABLE_ERROR_CODES = new Set([
+    ToolErrorCode.FILE_NOT_FOUND,
+    ToolErrorCode.ARGUMENT_ERROR,
+    ToolErrorCode.TOOL_TIMEOUT,
+    ToolErrorCode.DIR_NOT_FOUND,
+    ToolErrorCode.CUSTOM_TOOL_FAILED,
+]);
+export function isRetryableErrorCode(code) {
+    return RETRYABLE_ERROR_CODES.has(code);
+}
+export class MemoraError extends Error {
+    title;
+    detail;
+    suggestions;
+    category;
+    /** 工具错误码（用于 AgentLoop 反思判断是否可重试） */
+    errorCode;
+    cause;
+    constructor(opts) {
+        super(opts.title);
+        this.name = 'MemoraError';
+        this.title = opts.title;
+        this.detail = opts.detail;
+        this.suggestions = Object.freeze(opts.suggestions);
+        this.category = opts.category;
+        this.errorCode = opts.errorCode;
+        this.cause = opts.cause;
+    }
+    /**
+     * 格式化为用户可读的展示字符串
+     */
+    format() {
+        const lines = [];
+        lines.push(`❌ ${this.title}`);
+        if (this.detail)
+            lines.push(`   原因：${this.detail}`);
+        if (this.suggestions.length > 0) {
+            lines.push(`   建议：`);
+            for (const s of this.suggestions) {
+                lines.push(`     - ${s}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 记录到日志（结构化）
+     */
+    log() {
+        getLogger().error({
+            err: this,
+            category: this.category,
+            title: this.title,
+            detail: this.detail,
+            suggestions: this.suggestions,
+            cause: this.cause?.message,
+            stack: this.stack,
+        }, this.title);
+    }
+}
+/**
+ * 工厂：配置错误
+ */
+export function configError(title, detail, suggestions, cause) {
+    return new MemoraError({ title, detail, suggestions, category: 'config', cause });
+}
+/**
+ * 工厂：网络错误
+ */
+export function networkError(title, detail, suggestions, cause) {
+    return new MemoraError({ title, detail, suggestions, category: 'network', cause });
+}
+/**
+ * 工厂：LLM 错误
+ */
+export function llmError(title, detail, suggestions, cause) {
+    return new MemoraError({ title, detail, suggestions, category: 'llm', cause });
+}
+/**
+ * 工厂：工具错误
+ */
+export function toolError(title, detail, suggestions, cause, errorCode) {
+    return new MemoraError({ title, detail, suggestions, category: 'tool', cause, errorCode });
+}
+/**
+ * 工厂：安全错误（路径越界、黑名单命中、权限不足等）
+ */
+export function securityError(title, detail, suggestions, cause) {
+    return new MemoraError({ title, detail, suggestions, category: 'security', cause });
+}
+// toError 已移至 ./toError.ts（纯逻辑，零依赖），此处 re-export 保持向后兼容
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/eventEmitter.d.ts

@@ -0,0 +1,87 @@
+/** Agent 事件映射表（事件名 → 事件载荷类型） */
+export interface AgentEventMap {
+    /** 记忆被写入存储（insight 提取、rule 注入、skill 注入等） */
+    memoryAdded: {
+        id: string;
+        source: string;
+        name: string;
+    };
+    /** 角色被切换（自动匹配或手动指定） */
+    personaSwitched: {
+        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;
+    };
+    /** 项目被切换（A-003：宿主 UI 可据此刷新项目相关界面） */
+    projectSwitched: {
+        from: string | null;
+        to: string;
+        projectName: string;
+    };
+    /** 技能被匹配（A-003：宿主 UI 可据此展示当前激活技能） */
+    skillMatched: {
+        skill: string;
+        score: number;
+    };
+}
+/** 事件名联合类型 */
+export type AgentEventName = keyof AgentEventMap;
+/** 事件处理器类型 */
+export type AgentEventHandler<T> = (event: T) => void;
+/**
+ * 类型安全的事件发射器
+ *
+ * 泛型参数 EventMap 约束了合法的事件名和对应的载荷类型，
+ * 调用方在编译期就能获得类型检查和自动补全。
+ */
+export declare class TypedEventEmitter<EventMap extends object> {
+    private readonly listeners;
+    /**
+     * 订阅事件
+     * @param event - 事件名
+     * @param handler - 事件处理器
+     */
+    on<K extends keyof EventMap & string>(event: K, handler: (event: EventMap[K]) => void): void;
+    /**
+     * 取消订阅
+     * @param event - 事件名
+     * @param handler - 要移除的处理器（必须是同一个引用）
+     */
+    off<K extends keyof EventMap & string>(event: K, handler: (event: EventMap[K]) => void): void;
+    /**
+     * 订阅事件（仅触发一次，触发后自动移除）
+     * @param event - 事件名
+     * @param 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() 清理）
+     */
+    protected removeAllListeners(): void;
+}
+//# sourceMappingURL=eventEmitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eventEmitter.d.ts","sourceRoot":"","sources":["../../src/utils/eventEmitter.ts"],"names":[],"mappings":"AAaA,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,uBAAuB;IACvB,eAAe,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,aAAa;IACb,cAAc,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,kCAAkC;IAClC,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,YAAY;IACZ,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,YAAY;IACZ,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,qCAAqC;IACrC,eAAe,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,qCAAqC;IACrC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,cAAc;AACd,MAAM,MAAM,cAAc,GAAG,MAAM,aAAa,CAAC;AAEjD,cAAc;AACd,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,iBAAiB,CAAC,QAAQ,SAAS,MAAM;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoD;IAE9E;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAS5F;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAI7F;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EACpC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GACpC,IAAI;IAQP;;;;OAIG;IACH,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAYvF;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;CAGrC"}

package/dist/utils/eventEmitter.js

@@ -0,0 +1,79 @@
+/**
+ * 轻量类型事件发射器 — 零外部依赖
+ *
+ * 供 Agent 向宿主项目广播对话外事件（记忆变更、角色切换、衰减完成等）。
+ * 不依赖 Node.js EventEmitter，保持"零 native 依赖内核"约束。
+ *
+ * 使用方式：
+ *   agent.on('memoryAdded', (e) => console.log(e.source, e.name));
+ *   agent.off('memoryAdded', handler);
+ */
+import { getLogger } from '../utils/loggerHolder.js';
+import { toError } from '../utils/errors.js';
+/**
+ * 类型安全的事件发射器
+ *
+ * 泛型参数 EventMap 约束了合法的事件名和对应的载荷类型，
+ * 调用方在编译期就能获得类型检查和自动补全。
+ */
+export class TypedEventEmitter {
+    listeners = new Map();
+    /**
+     * 订阅事件
+     * @param event - 事件名
+     * @param handler - 事件处理器
+     */
+    on(event, handler) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(handler);
+    }
+    /**
+     * 取消订阅
+     * @param event - 事件名
+     * @param handler - 要移除的处理器（必须是同一个引用）
+     */
+    off(event, handler) {
+        this.listeners.get(event)?.delete(handler);
+    }
+    /**
+     * 订阅事件（仅触发一次，触发后自动移除）
+     * @param event - 事件名
+     * @param handler - 事件处理器
+     */
+    once(event, handler) {
+        const wrapper = ((data) => {
+            this.off(event, wrapper);
+            handler(data);
+        });
+        this.on(event, wrapper);
+    }
+    /**
+     * 发射事件
+     * @param event - 事件名
+     * @param payload - 事件载荷
+     */
+    emit(event, payload) {
+        const set = this.listeners.get(event);
+        if (!set || set.size === 0)
+            return;
+        for (const handler of set) {
+            try {
+                handler(payload);
+            }
+            catch (err) {
+                getLogger().warn({ event, err: toError(err).message }, '宿主事件处理器异常');
+            }
+        }
+    }
+    /**
+     * 移除所有监听器（用于 close() 清理）
+     */
+    removeAllListeners() {
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=eventEmitter.js.map

package/dist/utils/eventEmitter.js.map

@@ -0,0 +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,mBAAmB,CAAC;AA4B5C;;;;;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"}