@roarpeng/graphflow 1.1.0 → 1.2.0

package/dist/integrations/skill-installer.js

@@ -0,0 +1,373 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSkillSourcePath = resolveSkillSourcePath;
+exports.resolveCursorRulesSourcePath = resolveCursorRulesSourcePath;
+exports.resolveClaudeMdSourcePath = resolveClaudeMdSourcePath;
+exports.installTraeSkills = installTraeSkills;
+exports.installCursorRules = installCursorRules;
+exports.installClaudeCodeMd = installClaudeCodeMd;
+exports.installAllSkills = installAllSkills;
+/**
+ * skill-installer.ts — 共享的 Skill / Rules 安装模块
+ *
+ * 封装 Trae Skill、Cursor Rules、Claude Code CLAUDE.md 的安装逻辑，
+ * 可被 CLI init 和 VS Code 扩展共用。所有安装失败静默处理（log warn）。
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+// ── 平台检测 ──────────────────────────────────────────────────────────
+const isWindows = process.platform === "win32";
+function resolveHomePaths() {
+    const home = (0, node_os_1.homedir)();
+    const appData = process.env.APPDATA ?? (isWindows ? (0, node_path_1.join)(home, "AppData", "Roaming") : "");
+    const localAppData = process.env.LOCALAPPDATA ?? (isWindows ? (0, node_path_1.join)(home, "AppData", "Local") : "");
+    return { home, appData, localAppData };
+}
+// ── Trae Skill 安装 ──────────────────────────────────────────────────
+function getTraeUserDirs() {
+    const { home, appData } = resolveHomePaths();
+    const dirs = [];
+    if (isWindows) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "Trae"))) {
+            dirs.push({
+                name: "Trae",
+                skillsDir: (0, node_path_1.join)(appData, "Trae", "User", "skills"),
+            });
+        }
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "Trae CN"))) {
+            dirs.push({
+                name: "Trae CN",
+                skillsDir: (0, node_path_1.join)(appData, "Trae CN", "User", "skills"),
+            });
+        }
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "TRAE SOLO CN"))) {
+            dirs.push({
+                name: "TRAE SOLO CN",
+                skillsDir: (0, node_path_1.join)(appData, "TRAE SOLO CN", "User", "skills"),
+            });
+        }
+    }
+    else {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".config", "Trae"))) {
+            dirs.push({
+                name: "Trae",
+                skillsDir: (0, node_path_1.join)(home, ".config", "Trae", "User", "skills"),
+            });
+        }
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".config", "Trae CN"))) {
+            dirs.push({
+                name: "Trae CN",
+                skillsDir: (0, node_path_1.join)(home, ".config", "Trae CN", "User", "skills"),
+            });
+        }
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".config", "TRAE SOLO CN"))) {
+            dirs.push({
+                name: "TRAE SOLO CN",
+                skillsDir: (0, node_path_1.join)(home, ".config", "TRAE SOLO CN", "User", "skills"),
+            });
+        }
+    }
+    return dirs;
+}
+// ── Cursor Rules 安装 ─────────────────────────────────────────────────
+function getCursorRulesDirs() {
+    const { home, appData } = resolveHomePaths();
+    const dirs = [];
+    // 用户级 Cursor rules 目录
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".cursor"))) {
+        dirs.push({
+            name: "Cursor (user)",
+            rulesDir: (0, node_path_1.join)(home, ".cursor", "rules"),
+        });
+    }
+    // AppData 位置（某些 Cursor 版本）
+    if (isWindows && (0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "Cursor"))) {
+        dirs.push({
+            name: "Cursor (AppData)",
+            rulesDir: (0, node_path_1.join)(appData, "Cursor", "User", "rules"),
+        });
+    }
+    return dirs;
+}
+// ── Claude Code CLAUDE.md 安装 ────────────────────────────────────────
+function getClaudeCodeDirs() {
+    const { home, appData } = resolveHomePaths();
+    const dirs = [];
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(home, ".claude"))) {
+        dirs.push({
+            name: "Claude Code",
+            claudeDir: (0, node_path_1.join)(home, ".claude"),
+        });
+    }
+    if (isWindows && (0, node_fs_1.existsSync)((0, node_path_1.join)(appData, "Claude Code"))) {
+        dirs.push({
+            name: "Claude Code (AppData)",
+            claudeDir: (0, node_path_1.join)(appData, "Claude Code"),
+        });
+    }
+    return dirs;
+}
+// ── 路径解析（支持多种候选路径） ────────────────────────────────────────
+/**
+ * 解析 Trae Skill 源文件路径。
+ * 支持以下候选路径（按优先级排序）：
+ * 1. vendorRuntimeRoot（VS Code 扩展打包后 vendor/graphflow 路径）
+ * 2. 标准的 dist/surfaces/ 路径
+ * 3. src/surfaces/ 源码路径
+ */
+function resolveSkillSourcePath(vendorRuntimeRoot) {
+    const candidates = [
+        // VS Code 扩展 vendor 路径（打包后）
+        ...(vendorRuntimeRoot
+            ? [
+                (0, node_path_1.join)(vendorRuntimeRoot, "src", "surfaces", "trae-skill", "graphflow"),
+                (0, node_path_1.join)(vendorRuntimeRoot, "dist", "surfaces", "trae-skill", "graphflow"),
+            ]
+            : []),
+        // 标准构建产物路径
+        (0, node_path_1.join)(__dirname, "..", "..", "surfaces", "trae-skill", "graphflow"),
+        (0, node_path_1.join)(__dirname, "..", "..", "..", "src", "surfaces", "trae-skill", "graphflow"),
+        (0, node_path_1.join)(process.cwd(), "src", "surfaces", "trae-skill", "graphflow"),
+        (0, node_path_1.join)(process.cwd(), "dist", "surfaces", "trae-skill", "graphflow"),
+    ];
+    for (const dir of candidates) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(dir, "SKILL.md"))) {
+            return dir;
+        }
+    }
+    return undefined;
+}
+/**
+ * 解析 Cursor Rules 源文件路径。
+ */
+function resolveCursorRulesSourcePath(vendorRuntimeRoot) {
+    const candidates = [
+        // VS Code 扩展 vendor 路径（打包后）
+        ...(vendorRuntimeRoot
+            ? [
+                (0, node_path_1.join)(vendorRuntimeRoot, "src", "surfaces", "cursor-rules"),
+                (0, node_path_1.join)(vendorRuntimeRoot, "dist", "surfaces", "cursor-rules"),
+            ]
+            : []),
+        // 标准构建产物路径
+        (0, node_path_1.join)(__dirname, "..", "..", "surfaces", "cursor-rules"),
+        (0, node_path_1.join)(__dirname, "..", "..", "..", "src", "surfaces", "cursor-rules"),
+        (0, node_path_1.join)(process.cwd(), "src", "surfaces", "cursor-rules"),
+        (0, node_path_1.join)(process.cwd(), "dist", "surfaces", "cursor-rules"),
+    ];
+    for (const dir of candidates) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(dir, "graphflow.mdc"))) {
+            return dir;
+        }
+    }
+    return undefined;
+}
+/**
+ * 解析 Claude Code CLAUDE.md 源文件路径。
+ */
+function resolveClaudeMdSourcePath(vendorRuntimeRoot) {
+    const candidates = [
+        // VS Code 扩展 vendor 路径（打包后）
+        ...(vendorRuntimeRoot
+            ? [
+                (0, node_path_1.join)(vendorRuntimeRoot, "CLAUDE.md"),
+            ]
+            : []),
+        // 标准路径
+        (0, node_path_1.join)(__dirname, "..", "..", "CLAUDE.md"),
+        (0, node_path_1.join)(__dirname, "..", "..", "..", "CLAUDE.md"),
+        (0, node_path_1.join)(process.cwd(), "CLAUDE.md"),
+    ];
+    for (const filePath of candidates) {
+        if ((0, node_fs_1.existsSync)(filePath)) {
+            return filePath;
+        }
+    }
+    return undefined;
+}
+// ── 文件安装辅助 ────────────────────────────────────────────────────
+/**
+ * 通用文件安装：将源文件复制到目标位置，若已存在且内容相同则跳过。
+ */
+function installFile(sourcePath, destDir, destFileName) {
+    const destFile = (0, node_path_1.join)(destDir, destFileName);
+    const existed = (0, node_fs_1.existsSync)(destFile);
+    if (existed) {
+        const existingContent = (0, node_fs_1.readFileSync)(destFile, "utf8");
+        const newContent = (0, node_fs_1.readFileSync)(sourcePath, "utf8");
+        if (existingContent === newContent) {
+            return { status: "skipped", message: "already up to date" };
+        }
+    }
+    (0, node_fs_1.mkdirSync)(destDir, { recursive: true });
+    (0, node_fs_1.copyFileSync)(sourcePath, destFile);
+    return { status: existed ? "updated" : "created" };
+}
+// ── 单项安装函数 ──────────────────────────────────────────────────────
+/**
+ * 安装 Trae Skill（SKILL.md）到所有检测到的 Trae 用户目录。
+ */
+function installTraeSkills(vendorRuntimeRoot) {
+    const results = [];
+    const skillSourceDir = resolveSkillSourcePath(vendorRuntimeRoot);
+    if (!skillSourceDir) {
+        results.push({
+            target: "Trae",
+            status: "skipped",
+            message: "Skill source (SKILL.md) not found",
+        });
+        return results;
+    }
+    const traeDirs = getTraeUserDirs();
+    if (traeDirs.length === 0) {
+        results.push({
+            target: "Trae",
+            status: "skipped",
+            message: "No Trae installation detected",
+        });
+        return results;
+    }
+    const sourceSkillFile = (0, node_path_1.join)(skillSourceDir, "SKILL.md");
+    for (const trae of traeDirs) {
+        try {
+            const destDir = (0, node_path_1.join)(trae.skillsDir, "graphflow");
+            const result = installFile(sourceSkillFile, destDir, "SKILL.md");
+            results.push({ target: trae.name, status: result.status, message: result.message });
+        }
+        catch (error) {
+            results.push({
+                target: trae.name,
+                status: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return results;
+}
+/**
+ * 安装 Cursor Rules（graphflow.mdc）到所有检测到的 Cursor 用户目录。
+ */
+function installCursorRules(vendorRuntimeRoot) {
+    const results = [];
+    const rulesSourceDir = resolveCursorRulesSourcePath(vendorRuntimeRoot);
+    if (!rulesSourceDir) {
+        results.push({
+            target: "Cursor",
+            status: "skipped",
+            message: "Cursor rules source (graphflow.mdc) not found",
+        });
+        return results;
+    }
+    const cursorDirs = getCursorRulesDirs();
+    if (cursorDirs.length === 0) {
+        results.push({
+            target: "Cursor",
+            status: "skipped",
+            message: "No Cursor installation detected",
+        });
+        return results;
+    }
+    const sourceRulesFile = (0, node_path_1.join)(rulesSourceDir, "graphflow.mdc");
+    for (const cursor of cursorDirs) {
+        try {
+            const result = installFile(sourceRulesFile, cursor.rulesDir, "graphflow.mdc");
+            results.push({ target: cursor.name, status: result.status, message: result.message });
+        }
+        catch (error) {
+            results.push({
+                target: cursor.name,
+                status: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return results;
+}
+/**
+ * 安装 Claude Code CLAUDE.md 到检测到的 Claude Code 用户目录。
+ */
+function installClaudeCodeMd(vendorRuntimeRoot) {
+    const results = [];
+    const sourcePath = resolveClaudeMdSourcePath(vendorRuntimeRoot);
+    if (!sourcePath) {
+        results.push({
+            target: "Claude Code",
+            status: "skipped",
+            message: "CLAUDE.md source not found",
+        });
+        return results;
+    }
+    const claudeDirs = getClaudeCodeDirs();
+    if (claudeDirs.length === 0) {
+        results.push({
+            target: "Claude Code",
+            status: "skipped",
+            message: "No Claude Code installation detected",
+        });
+        return results;
+    }
+    for (const claude of claudeDirs) {
+        try {
+            const result = installFile(sourcePath, claude.claudeDir, "CLAUDE.md");
+            results.push({ target: claude.name, status: result.status, message: result.message });
+        }
+        catch (error) {
+            results.push({
+                target: claude.name,
+                status: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return results;
+}
+// ── 一站式安装函数 ────────────────────────────────────────────────────
+/**
+ * 一键安装所有 Skill / Rules / CLAUDE.md。
+ * 所有失败静默处理（catch + 返回 error 状态），不会抛出异常。
+ *
+ * @param vendorRuntimeRoot 可选的 vendor 运行时根目录（VS Code 扩展中使用）
+ * @param log 可选的日志回调，用于输出安装信息
+ */
+function installAllSkills(vendorRuntimeRoot, log) {
+    const logFn = log ?? ((msg) => console.log(msg));
+    const traeSkills = installTraeSkills(vendorRuntimeRoot);
+    for (const result of traeSkills) {
+        if (result.status === "error") {
+            logFn(`[WARN] Trae Skill ${result.target}: ${result.message}`);
+            continue;
+        }
+        if (result.status === "skipped") {
+            logFn(`[SKIP] Trae Skill ${result.target}: ${result.message ?? "skipped"}`);
+            continue;
+        }
+        logFn(`[OK] ${result.status === "created" ? "Created" : "Updated"} Trae Skill for ${result.target}`);
+    }
+    const cursorRules = installCursorRules(vendorRuntimeRoot);
+    for (const result of cursorRules) {
+        if (result.status === "error") {
+            logFn(`[WARN] Cursor Rules ${result.target}: ${result.message}`);
+            continue;
+        }
+        if (result.status === "skipped") {
+            logFn(`[SKIP] Cursor Rules ${result.target}: ${result.message ?? "skipped"}`);
+            continue;
+        }
+        logFn(`[OK] ${result.status === "created" ? "Created" : "Updated"} Cursor Rules for ${result.target}`);
+    }
+    const claudeMd = installClaudeCodeMd(vendorRuntimeRoot);
+    for (const result of claudeMd) {
+        if (result.status === "error") {
+            logFn(`[WARN] Claude Code CLAUDE.md ${result.target}: ${result.message}`);
+            continue;
+        }
+        if (result.status === "skipped") {
+            logFn(`[SKIP] Claude Code CLAUDE.md ${result.target}: ${result.message ?? "skipped"}`);
+            continue;
+        }
+        logFn(`[OK] ${result.status === "created" ? "Created" : "Updated"} Claude Code CLAUDE.md for ${result.target}`);
+    }
+    return { traeSkills, cursorRules, claudeMd };
+}
+//# sourceMappingURL=skill-installer.js.map

package/dist/integrations/skill-installer.js.map

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

package/dist/learning/embeddings.d.ts

@@ -2,7 +2,18 @@ import type { GraphNode } from "../core/types";
 export declare const EMBEDDING_DIM = 256;
 export interface EmbeddingProvider {
     embed(text: string): Promise<number[]>;
+    /**
+     * 预热：用一段简短的 dummy 文本（如 "warmup"）做一次推理，
+     * 避免首个真实请求的冷启动延迟（尤其是本地模型懒加载场景）。
+     * 异步执行，不应阻塞主流程。可选实现。
+     */
+    warmup?(): Promise<void>;
 }
+/**
+ * 安全地预热 embedding provider。不会抛出异常，适合用 `void warmupEmbeddingProvider(p)` 非阻塞调用。
+ * 预热失败不影响主流程，首个真实请求会再次尝试加载/推理。
+ */
+export declare function warmupEmbeddingProvider(provider: EmbeddingProvider): Promise<void>;
 export declare function cosineSimilarity(a: number[], b: number[]): number;
 export declare function hashEmbedding(text: string, dim?: number): number[];
 export declare function createHashEmbeddingProvider(dim?: number): EmbeddingProvider;

package/dist/learning/embeddings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/learning/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACxC;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAgBjE;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,EAAE,CAcjF;AAED,wBAAgB,2BAA2B,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,CAM1F;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,iBAAiB,CAwBpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI,CAOjE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,CAK/E;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,SAAS,EAAE,CAAC,CAWtB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,GAAE,MAAW,GAAG,SAAS,EAAE,CAwBzF;AAED,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/learning/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC;;;;OAIG;IACH,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CASxF;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAgBjE;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,EAAE,CAcjF;AAED,wBAAgB,2BAA2B,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,CAU1F;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,iBAAiB,CA4BpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI,CAOjE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,CAK/E;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,SAAS,EAAE,CAAC,CAWtB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,GAAE,MAAW,GAAG,SAAS,EAAE,CAwBzF;AAED,cAAc,mBAAmB,CAAC"}

package/dist/learning/embeddings.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EMBEDDING_DIM = void 0;
+exports.warmupEmbeddingProvider = warmupEmbeddingProvider;
 exports.cosineSimilarity = cosineSimilarity;
 exports.hashEmbedding = hashEmbedding;
 exports.createHashEmbeddingProvider = createHashEmbeddingProvider;
@@ -24,6 +25,21 @@ exports.attachEmbedding = attachEmbedding;
 exports.embedAndAttachNodes = embedAndAttachNodes;
 exports.reciprocalRankFusion = reciprocalRankFusion;
 exports.EMBEDDING_DIM = 256;
+/**
+ * 安全地预热 embedding provider。不会抛出异常，适合用 `void warmupEmbeddingProvider(p)` 非阻塞调用。
+ * 预热失败不影响主流程，首个真实请求会再次尝试加载/推理。
+ */
+async function warmupEmbeddingProvider(provider) {
+    if (typeof provider.warmup !== "function") {
+        return;
+    }
+    try {
+        await provider.warmup();
+    }
+    catch {
+        // 预热失败静默处理：不阻断 provider 创建与后续真实请求
+    }
+}
 function cosineSimilarity(a, b) {
     if (!a || !b || a.length === 0 || b.length === 0 || a.length !== b.length) {
         return 0;
@@ -74,6 +90,10 @@ function createHashEmbeddingProvider(dim = exports.EMBEDDING_DIM) {
         async embed(text) {
             return hashEmbedding(text, dim);
         },
+        // hash 嵌入无懒加载，预热仅做一次廉价推理以保持接口一致
+        async warmup() {
+            await hashEmbedding("warmup", dim);
+        },
     };
 }
 function createOpenAiEmbeddingProvider(options) {
@@ -99,6 +119,10 @@ function createOpenAiEmbeddingProvider(options) {
             }
             return emb;
         },
+        // 远程 API 无本地冷启动，预热为空操作以避免初始化时产生不必要的网络请求与计费
+        async warmup() {
+            /* no-op: 远程 provider 无需本地预热 */
+        },
     };
 }
 function extractEmbedding(node) {

package/dist/learning/embeddings.js.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/learning/embeddings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/learning/embeddings.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAkBA,0DASC;AAED,4CAgBC;AAWD,sCAcC;AAED,kEAUC;AAED,sEAgCC;AAED,4CAOC;AAED,0CAKC;AAED,kDAcC;AAED,oDAwBC;AA5KY,QAAA,aAAa,GAAG,GAAG,CAAC;AAYjC;;;GAGG;AACI,KAAK,UAAU,uBAAuB,CAAC,QAA2B;IACvE,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrB,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;QACf,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QACd,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAChB,CAAC;IACD,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,KAAK,CAAC,GAAW;IACxB,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY,EAAE,MAAc,qBAAa;IACrE,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IACtB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpF,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAC7B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;QAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3B,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;IAC9D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,2BAA2B,CAAC,MAAc,qBAAa;IACrE,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,IAAY;YACtB,OAAO,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,gCAAgC;QAChC,KAAK,CAAC,MAAM;YACV,MAAM,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,6BAA6B,CAAC,OAI7C;IACC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,2BAA2B,CAAC;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAAC;IACxD,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,IAAY;YACtB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,aAAa,EAAE;gBAC5C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE;iBAC1C;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;aAC7C,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0C,CAAC;YACzE,MAAM,GAAG,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC1E,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,2CAA2C;QAC3C,KAAK,CAAC,MAAM;YACV,+BAA+B;QACjC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAe;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IAChE,CAAC;IACD,OAAO,GAAe,CAAC;AACzB,CAAC;AAED,SAAgB,eAAe,CAAC,IAAe,EAAE,SAAmB;IAClE,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE;KAClD,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,KAAkB,EAClB,QAA2B;IAE3B,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,oBAAoB,CAAC,QAAuB,EAAE,IAAY,EAAE;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA8C,CAAC;IACxE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YACrE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1E,IAAI;QACJ,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;QAC/B,KAAK,EAAE,CAAC;KACT,CAAC,CAAC,CAAC;IACJ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAClD,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,oDAAkC"}

package/dist/learning/episodic-memory.d.ts

@@ -1,5 +1,6 @@
 import type { GraphNode } from "../core/types";
 import type { GraphClient } from "../graph/client-factory";
+import { type EmbeddingProvider } from "./embeddings";
 export interface EpisodeRecord {
     id: string;
     task: string;
@@ -17,7 +18,7 @@ export interface EpisodeRecord {
     runFeedback?: string;
 }
 export declare function extractTaskTokens(task: string): string[];
-export declare function recordEpisode(client: GraphClient, episode: Omit<EpisodeRecord, "id" | "createdAt" | "updatedAt">): Promise<EpisodeRecord>;
+export declare function recordEpisode(client: GraphClient, episode: Omit<EpisodeRecord, "id" | "createdAt" | "updatedAt">, embeddingProvider?: EmbeddingProvider): Promise<EpisodeRecord>;
 /**
  * Update an existing episode's outcome after an external agent reports back.
  * This closes the learning loop in bridge mode: the episode is initially
@@ -25,7 +26,7 @@ export declare function recordEpisode(client: GraphClient, episode: Omit<Episode
  * whether execution succeeded, optionally providing lessons learned.
  */
 export declare function updateEpisodeOutcome(client: GraphClient, episodeId: string, outcome: "pass" | "fail", lessons?: string[]): Promise<EpisodeRecord | undefined>;
-export declare function findSimilarEpisodes(client: GraphClient, task: string, limit?: number): Promise<EpisodeRecord[]>;
+export declare function findSimilarEpisodes(client: GraphClient, task: string, limit?: number, embeddingProvider?: EmbeddingProvider): Promise<EpisodeRecord[]>;
 export declare function loadAllEpisodes(client: GraphClient): Promise<EpisodeRecord[]>;
 export declare function summarizeEpisodeForPrompt(episode: EpisodeRecord): string;
 export declare function parseEpisodes(nodes: GraphNode[]): EpisodeRecord[];

package/dist/learning/episodic-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"episodic-memory.d.ts","sourceRoot":"","sources":["../../src/learning/episodic-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOxD;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAC7D,OAAO,CAAC,aAAa,CAAC,CA0BxB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAyBpC;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,GACR,OAAO,CAAC,aAAa,EAAE,CAAC,CAsB1B;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAGnF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAcxE;AAwBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,aAAa,EAAE,CAcjE;AA0CD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAyD7B"}
+{"version":3,"file":"episodic-memory.d.ts","sourceRoot":"","sources":["../../src/learning/episodic-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOxD;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,EAC9D,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,aAAa,CAAC,CAwCxB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAyBpC;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,EACT,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,aAAa,EAAE,CAAC,CAqE1B;AAgCD,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAGnF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAcxE;AAwBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,aAAa,EAAE,CAcjE;AA0CD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAyD7B"}