@roarpeng/graphflow 0.6.15 → 1.0.4

package/dist/graph/semantic-compression.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clusterSimilarNodes = clusterSimilarNodes;
+exports.summarizeCluster = summarizeCluster;
+exports.densifyNodeContent = densifyNodeContent;
+exports.applySemanticCompression = applySemanticCompression;
+const embeddings_1 = require("../learning/embeddings");
+const openbmb_1 = require("../routing/provider-adapters/openbmb");
+/**
+ * Clusters nodes by embedding similarity. Nodes within a cluster can be
+ * merged into a single summary line to save tokens.
+ */
+async function clusterSimilarNodes(nodes, options) {
+    const threshold = options?.similarityThreshold ?? 0.75;
+    const maxSize = options?.maxClusterSize ?? 5;
+    // Ensure all nodes have embeddings.
+    const withEmbedding = nodes.filter((n) => (0, embeddings_1.extractEmbedding)(n) !== null);
+    if (withEmbedding.length === 0)
+        return [];
+    const clusters = [];
+    const assigned = new Set();
+    for (const candidate of withEmbedding) {
+        if (assigned.has(candidate.id))
+            continue;
+        const cluster = [candidate];
+        assigned.add(candidate.id);
+        const candidateEmb = (0, embeddings_1.extractEmbedding)(candidate);
+        let simSum = 0;
+        for (const other of withEmbedding) {
+            if (assigned.has(other.id))
+                continue;
+            if (cluster.length >= maxSize)
+                break;
+            const otherEmb = (0, embeddings_1.extractEmbedding)(other);
+            if (!otherEmb)
+                continue;
+            const sim = (0, embeddings_1.cosineSimilarity)(candidateEmb, otherEmb);
+            if (sim >= threshold) {
+                cluster.push(other);
+                assigned.add(other.id);
+                simSum += sim;
+            }
+        }
+        // Only create cluster if we found similar nodes (cluster size > 1).
+        if (cluster.length > 1) {
+            clusters.push({
+                representative: candidate,
+                members: cluster,
+                avgSimilarity: simSum / (cluster.length - 1),
+            });
+        }
+    }
+    return clusters;
+}
+/**
+ * Generates a unified summary for a cluster of similar nodes.
+ * Uses the provided compression model handle (external or embedded) if given,
+ * otherwise falls back to direct embedded openbmb invocation.
+ * Example: 3 overloaded `login()` variants → "login function with 3 signatures".
+ */
+async function summarizeCluster(cluster, options) {
+    const memberContents = cluster.members.map((m) => m.content).slice(0, 5);
+    const prompt = [
+        "你是代码摘要生成器。多个相似的代码片段需要合并为一句统一描述。",
+        "要求：",
+        "1. 用一句话概括它们的共同功能（20字以内）",
+        "2. 如果是重载/变体，说明有几个版本",
+        "3. 不要逐个列举，只给出统一摘要",
+        "",
+        "代码片段：",
+        ...memberContents.map((c, i) => `${i + 1}. ${c}`),
+        "",
+        "统一摘要：",
+    ].join("\n");
+    const maxTokens = options?.maxSummaryTokens ?? 64;
+    try {
+        const result = options?.modelHandle
+            ? await options.modelHandle.generate(prompt, maxTokens)
+            : await (0, openbmb_1.openbmbGenerateText)({ prompt, model: options?.modelPath ?? "minicpm-1b" }, { ...options, maxTokens });
+        return result.trim().replace(/^统一摘要[:：]?\s*/i, "");
+    }
+    catch {
+        // Degrade gracefully: if no model is available, keep the representative's original content.
+        return cluster.representative.content;
+    }
+}
+/**
+ * Rewrites verbose node content into dense summaries.
+ * Uses the provided compression model handle if given, otherwise falls back to
+ * direct embedded openbmb invocation. Only applies to nodes exceeding minInputTokens.
+ */
+async function densifyNodeContent(node, options) {
+    const content = node.content;
+    const minInput = options?.minInputTokens ?? 150;
+    const estimatedTokens = Math.ceil(content.length / 4);
+    if (estimatedTokens < minInput) {
+        // Already concise.
+        return content;
+    }
+    const prompt = [
+        "你是代码压缩专家。将以下代码签名/内容改写为极简版（保留核心信息，去掉冗余）。",
+        "要求：",
+        "1. 保留函数名、参数、返回类型",
+        "2. 去掉注释、装饰器、冗长描述",
+        "3. 输出格式：function_name(params) -> return_type | 核心功能",
+        "",
+        `原内容：\n${content.slice(0, 600)}`,
+        "",
+        "压缩版：",
+    ].join("\n");
+    const maxTokens = options?.maxOutputTokens ?? 80;
+    try {
+        const result = options?.modelHandle
+            ? await options.modelHandle.generate(prompt, maxTokens)
+            : await (0, openbmb_1.openbmbGenerateText)({ prompt, model: options?.modelPath ?? "minicpm-1b" }, { ...options, maxTokens });
+        return result.trim().replace(/^压缩版[:：]?\s*/i, "");
+    }
+    catch {
+        // Degrade gracefully: if no model is available, keep the original content.
+        return content;
+    }
+}
+/**
+ * High-level pipeline: cluster similar nodes, summarize each cluster, and
+ * densify remaining verbose nodes. Returns compressed node set.
+ *
+ * When a compression model handle is provided, summarization/densification
+ * route through it (external economy tier or embedded minicpm); otherwise they
+ * fall back to direct embedded openbmb invocation.
+ */
+async function applySemanticCompression(nodes, options) {
+    const clusters = await clusterSimilarNodes(nodes, options?.clusteringOptions);
+    const clusterIds = new Set(clusters.flatMap((c) => c.members.map((m) => m.id)));
+    const summarizerOptions = {
+        ...options?.summarizerOptions,
+        ...(options?.modelHandle ? { modelHandle: options.modelHandle } : {}),
+    };
+    const densifierOptions = {
+        ...options?.densifierOptions,
+        ...(options?.modelHandle ? { modelHandle: options.modelHandle } : {}),
+    };
+    const compressed = [];
+    // Replace each cluster with a single summarized node.
+    for (const cluster of clusters) {
+        const summary = await summarizeCluster(cluster, summarizerOptions);
+        compressed.push({
+            ...cluster.representative,
+            content: summary,
+            metadata: {
+                ...cluster.representative.metadata,
+                compressed: true,
+                clusterSize: cluster.members.length,
+                originalIds: cluster.members.map((m) => m.id),
+            },
+        });
+    }
+    // Densify non-clustered nodes if verbose.
+    for (const node of nodes) {
+        if (clusterIds.has(node.id))
+            continue;
+        const dense = await densifyNodeContent(node, densifierOptions);
+        compressed.push({
+            ...node,
+            content: dense,
+            metadata: {
+                ...node.metadata,
+                ...(dense !== node.content ? { densified: true } : {}),
+            },
+        });
+    }
+    return compressed;
+}
+//# sourceMappingURL=semantic-compression.js.map

package/dist/graph/semantic-compression.js.map

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

package/dist/graph/token-savings.d.ts

@@ -0,0 +1,52 @@
+import type { GraphFlowConfig } from "../config/schema";
+/**
+ * Cumulative token savings tracker.
+ *
+ * Records each context compression / task run and provides aggregate
+ * statistics so users can quantify ROI (return on investment) of using
+ * GraphFlow's context compression.
+ *
+ * Stats are persisted to graphflow-out/token-savings.json as a simple
+ * append-only log with aggregate counters.
+ */
+export interface SavingsRecord {
+    timestamp: string;
+    query: string;
+    rawTokens: number;
+    compressedTokens: number;
+    savingsPercent: number;
+    source: "preview_context" | "run";
+}
+export interface SavingsStats {
+    totalRuns: number;
+    totalRawTokens: number;
+    totalCompressedTokens: number;
+    totalSavedTokens: number;
+    averageSavingsPercent: number;
+    firstRunAt: string | null;
+    lastRunAt: string | null;
+    recentRecords: SavingsRecord[];
+}
+/**
+ * Record a single savings event and update cumulative stats.
+ *
+ * @param config GraphFlow config
+ * @param record The savings record to append
+ */
+export declare function recordSavings(config: GraphFlowConfig, record: SavingsRecord): void;
+/**
+ * Get cumulative savings statistics.
+ *
+ * @param config GraphFlow config
+ */
+export declare function getSavingsStats(config: GraphFlowConfig): SavingsStats;
+/**
+ * Reset all savings statistics.
+ *
+ * @param config GraphFlow config
+ */
+export declare function resetSavingsStats(config: GraphFlowConfig): {
+    path: string;
+    reset: boolean;
+};
+//# sourceMappingURL=token-savings.d.ts.map

package/dist/graph/token-savings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-savings.d.ts","sourceRoot":"","sources":["../../src/graph/token-savings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,iBAAiB,GAAG,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,aAAa,EAAE,CAAC;CAChC;AAuDD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAqBlF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAErE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAkB3F"}

package/dist/graph/token-savings.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordSavings = recordSavings;
+exports.getSavingsStats = getSavingsStats;
+exports.resetSavingsStats = resetSavingsStats;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const MAX_RECENT_RECORDS = 50;
+function resolveStatsPath(config) {
+    const root = config.graphPolicy.workspaceRoot ?? process.cwd();
+    return (0, node_path_1.join)(root, "graphflow-out", "token-savings.json");
+}
+function loadStats(statsPath) {
+    if (!(0, node_fs_1.existsSync)(statsPath)) {
+        return {
+            totalRuns: 0,
+            totalRawTokens: 0,
+            totalCompressedTokens: 0,
+            totalSavedTokens: 0,
+            averageSavingsPercent: 0,
+            firstRunAt: null,
+            lastRunAt: null,
+            recentRecords: [],
+        };
+    }
+    try {
+        const raw = (0, node_fs_1.readFileSync)(statsPath, "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            totalRuns: parsed.totalRuns ?? 0,
+            totalRawTokens: parsed.totalRawTokens ?? 0,
+            totalCompressedTokens: parsed.totalCompressedTokens ?? 0,
+            totalSavedTokens: parsed.totalSavedTokens ?? 0,
+            averageSavingsPercent: parsed.averageSavingsPercent ?? 0,
+            firstRunAt: parsed.firstRunAt ?? null,
+            lastRunAt: parsed.lastRunAt ?? null,
+            recentRecords: parsed.recentRecords ?? [],
+        };
+    }
+    catch {
+        return {
+            totalRuns: 0,
+            totalRawTokens: 0,
+            totalCompressedTokens: 0,
+            totalSavedTokens: 0,
+            averageSavingsPercent: 0,
+            firstRunAt: null,
+            lastRunAt: null,
+            recentRecords: [],
+        };
+    }
+}
+function saveStats(statsPath, stats) {
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(statsPath), { recursive: true });
+    (0, node_fs_1.writeFileSync)(statsPath, JSON.stringify(stats, null, 2), "utf8");
+}
+/**
+ * Record a single savings event and update cumulative stats.
+ *
+ * @param config GraphFlow config
+ * @param record The savings record to append
+ */
+function recordSavings(config, record) {
+    const statsPath = resolveStatsPath(config);
+    const stats = loadStats(statsPath);
+    stats.totalRuns += 1;
+    stats.totalRawTokens += record.rawTokens;
+    stats.totalCompressedTokens += record.compressedTokens;
+    stats.totalSavedTokens += record.rawTokens - record.compressedTokens;
+    stats.averageSavingsPercent =
+        stats.totalRawTokens > 0
+            ? Math.round((stats.totalSavedTokens / stats.totalRawTokens) * 100)
+            : 0;
+    stats.firstRunAt = stats.firstRunAt ?? record.timestamp;
+    stats.lastRunAt = record.timestamp;
+    stats.recentRecords.unshift(record);
+    if (stats.recentRecords.length > MAX_RECENT_RECORDS) {
+        stats.recentRecords = stats.recentRecords.slice(0, MAX_RECENT_RECORDS);
+    }
+    saveStats(statsPath, stats);
+}
+/**
+ * Get cumulative savings statistics.
+ *
+ * @param config GraphFlow config
+ */
+function getSavingsStats(config) {
+    return loadStats(resolveStatsPath(config));
+}
+/**
+ * Reset all savings statistics.
+ *
+ * @param config GraphFlow config
+ */
+function resetSavingsStats(config) {
+    const statsPath = resolveStatsPath(config);
+    if (!(0, node_fs_1.existsSync)(statsPath)) {
+        return { path: statsPath, reset: false };
+    }
+    const empty = {
+        totalRuns: 0,
+        totalRawTokens: 0,
+        totalCompressedTokens: 0,
+        totalSavedTokens: 0,
+        averageSavingsPercent: 0,
+        firstRunAt: null,
+        lastRunAt: null,
+        recentRecords: [],
+    };
+    saveStats(statsPath, empty);
+    return { path: statsPath, reset: true };
+}
+//# sourceMappingURL=token-savings.js.map

package/dist/graph/token-savings.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { orchestrate, type OrchestrateOptions } from "./core/orchestrator";
 export { createVsCodeRuntime } from "./surfaces/vscode/extension";
-export { runTask, runTaskResult, previewContext, getGraphFlowSettings, getSettingsPanelStatus, testRoutingAndIndexGraph, indexGraphFromSettings, validateSettingsForGraphIndex, validateSettingsForRouting, saveGraphFlowSettings, indexGraph, inspectGraph, getSkillInsights, resolveConfig, diagnoseRouting, diagnoseRoutingResult, runLearningNightly, runLearningNightlyResult, planAndBrainstorm, planAndBrainstormResult, buildMcpServerNode, detectInstalledAgents, formatModelConfigGuide, installMcpToDetectedAgents, assertGraphFlowRuntime, } from "./surfaces/cli/runtime";
+export { runTask, runTaskResult, reportOutcome, previewContext, expandAnchor, getGraphFlowSettings, getSettingsPanelStatus, testRoutingAndIndexGraph, indexGraphFromSettings, validateSettingsForGraphIndex, validateSettingsForRouting, saveGraphFlowSettings, indexGraph, inspectGraph, getSkillInsights, resolveConfig, diagnoseRouting, diagnoseRoutingResult, runLearningNightly, runLearningNightlyResult, planAndBrainstorm, planAndBrainstormResult, buildMcpServerNode, detectInstalledAgents, formatModelConfigGuide, installMcpToDetectedAgents, assertGraphFlowRuntime, } from "./surfaces/cli/runtime";
 export type { GraphFlowRuntime, GraphFlowRuntimeModule } from "./surfaces/cli/runtime";
 export type { DetectedAgent, McpInstallOptions, McpInstallResult, McpInstallStrategy, } from "./integrations/agent-mcp-installer";
 export { parseCliOptions, formatCliResult, type CliCommandResult } from "./surfaces/cli/output";
@@ -8,4 +8,5 @@ export { createMcpServer, executeToolCall, getToolDefinitions, startStdioServer,
 export type { TaskRunResult } from "./core/types";
 export { createGraphClient, type GraphClient, } from "./graph/client-factory";
 export { validateConfig, loadConfig, loadConfigSafe, type LoadConfigResult } from "./config/loader";
+export { graphflowSkills, invokeSkill, listSkills, type GraphFlowSkillName, type SkillInputByName, type SkillOutputByName, type CompressContextInput, type CompressContextOutput, type PlanTaskInput, type PlanTaskOutput, type PlanInsightInput, type PlanInsightOutput, type IndexGraphInput, type IndexGraphOutput, type InspectGraphInput, type InspectGraphOutput, type ExpandAnchorInput, type ExpandAnchorOutput, type RunTaskInput, type RunTaskOutput, } from "./skills";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EACL,OAAO,EACP,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,0BAA0B,EAC1B,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACvF,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EACL,OAAO,EACP,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,0BAA0B,EAC1B,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACvF,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,EACL,eAAe,EACf,WAAW,EACX,UAAU,EACV,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfigSafe = exports.loadConfig = exports.validateConfig = exports.createGraphClient = exports.startStdioServer = exports.getToolDefinitions = exports.executeToolCall = exports.createMcpServer = exports.formatCliResult = exports.parseCliOptions = exports.assertGraphFlowRuntime = exports.installMcpToDetectedAgents = exports.formatModelConfigGuide = exports.detectInstalledAgents = exports.buildMcpServerNode = exports.planAndBrainstormResult = exports.planAndBrainstorm = exports.runLearningNightlyResult = exports.runLearningNightly = exports.diagnoseRoutingResult = exports.diagnoseRouting = exports.resolveConfig = exports.getSkillInsights = exports.inspectGraph = exports.indexGraph = exports.saveGraphFlowSettings = exports.validateSettingsForRouting = exports.validateSettingsForGraphIndex = exports.indexGraphFromSettings = exports.testRoutingAndIndexGraph = exports.getSettingsPanelStatus = exports.getGraphFlowSettings = exports.previewContext = exports.runTaskResult = exports.runTask = exports.createVsCodeRuntime = exports.orchestrate = void 0;
+exports.listSkills = exports.invokeSkill = exports.graphflowSkills = exports.loadConfigSafe = exports.loadConfig = exports.validateConfig = exports.createGraphClient = exports.startStdioServer = exports.getToolDefinitions = exports.executeToolCall = exports.createMcpServer = exports.formatCliResult = exports.parseCliOptions = exports.assertGraphFlowRuntime = exports.installMcpToDetectedAgents = exports.formatModelConfigGuide = exports.detectInstalledAgents = exports.buildMcpServerNode = exports.planAndBrainstormResult = exports.planAndBrainstorm = exports.runLearningNightlyResult = exports.runLearningNightly = exports.diagnoseRoutingResult = exports.diagnoseRouting = exports.resolveConfig = exports.getSkillInsights = exports.inspectGraph = exports.indexGraph = exports.saveGraphFlowSettings = exports.validateSettingsForRouting = exports.validateSettingsForGraphIndex = exports.indexGraphFromSettings = exports.testRoutingAndIndexGraph = exports.getSettingsPanelStatus = exports.getGraphFlowSettings = exports.expandAnchor = exports.previewContext = exports.reportOutcome = exports.runTaskResult = exports.runTask = exports.createVsCodeRuntime = exports.orchestrate = void 0;
 var orchestrator_1 = require("./core/orchestrator");
 Object.defineProperty(exports, "orchestrate", { enumerable: true, get: function () { return orchestrator_1.orchestrate; } });
 var extension_1 = require("./surfaces/vscode/extension");
@@ -8,7 +8,9 @@ Object.defineProperty(exports, "createVsCodeRuntime", { enumerable: true, get: f
 var runtime_1 = require("./surfaces/cli/runtime");
 Object.defineProperty(exports, "runTask", { enumerable: true, get: function () { return runtime_1.runTask; } });
 Object.defineProperty(exports, "runTaskResult", { enumerable: true, get: function () { return runtime_1.runTaskResult; } });
+Object.defineProperty(exports, "reportOutcome", { enumerable: true, get: function () { return runtime_1.reportOutcome; } });
 Object.defineProperty(exports, "previewContext", { enumerable: true, get: function () { return runtime_1.previewContext; } });
+Object.defineProperty(exports, "expandAnchor", { enumerable: true, get: function () { return runtime_1.expandAnchor; } });
 Object.defineProperty(exports, "getGraphFlowSettings", { enumerable: true, get: function () { return runtime_1.getGraphFlowSettings; } });
 Object.defineProperty(exports, "getSettingsPanelStatus", { enumerable: true, get: function () { return runtime_1.getSettingsPanelStatus; } });
 Object.defineProperty(exports, "testRoutingAndIndexGraph", { enumerable: true, get: function () { return runtime_1.testRoutingAndIndexGraph; } });
@@ -45,4 +47,8 @@ var loader_1 = require("./config/loader");
 Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return loader_1.validateConfig; } });
 Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return loader_1.loadConfig; } });
 Object.defineProperty(exports, "loadConfigSafe", { enumerable: true, get: function () { return loader_1.loadConfigSafe; } });
+var skills_1 = require("./skills");
+Object.defineProperty(exports, "graphflowSkills", { enumerable: true, get: function () { return skills_1.graphflowSkills; } });
+Object.defineProperty(exports, "invokeSkill", { enumerable: true, get: function () { return skills_1.invokeSkill; } });
+Object.defineProperty(exports, "listSkills", { enumerable: true, get: function () { return skills_1.listSkills; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oDAA2E;AAAlE,2GAAA,WAAW,OAAA;AACpB,yDAAkE;AAAzD,gHAAA,mBAAmB,OAAA;AAC5B,kDA0BgC;AAzB9B,kGAAA,OAAO,OAAA;AACP,wGAAA,aAAa,OAAA;AACb,yGAAA,cAAc,OAAA;AACd,+GAAA,oBAAoB,OAAA;AACpB,iHAAA,sBAAsB,OAAA;AACtB,mHAAA,wBAAwB,OAAA;AACxB,iHAAA,sBAAsB,OAAA;AACtB,wHAAA,6BAA6B,OAAA;AAC7B,qHAAA,0BAA0B,OAAA;AAC1B,gHAAA,qBAAqB,OAAA;AACrB,qGAAA,UAAU,OAAA;AACV,uGAAA,YAAY,OAAA;AACZ,2GAAA,gBAAgB,OAAA;AAChB,wGAAA,aAAa,OAAA;AACb,0GAAA,eAAe,OAAA;AACf,gHAAA,qBAAqB,OAAA;AACrB,6GAAA,kBAAkB,OAAA;AAClB,mHAAA,wBAAwB,OAAA;AACxB,4GAAA,iBAAiB,OAAA;AACjB,kHAAA,uBAAuB,OAAA;AACvB,6GAAA,kBAAkB,OAAA;AAClB,gHAAA,qBAAqB,OAAA;AACrB,iHAAA,sBAAsB,OAAA;AACtB,qHAAA,0BAA0B,OAAA;AAC1B,iHAAA,sBAAsB,OAAA;AASxB,gDAAgG;AAAvF,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AACzC,gDAK+B;AAJ7B,yGAAA,eAAe,OAAA;AACf,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAGlB,yDAGgC;AAF9B,mHAAA,iBAAiB,OAAA;AAGnB,0CAAoG;AAA3F,wGAAA,cAAc,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oDAA2E;AAAlE,2GAAA,WAAW,OAAA;AACpB,yDAAkE;AAAzD,gHAAA,mBAAmB,OAAA;AAC5B,kDA4BgC;AA3B9B,kGAAA,OAAO,OAAA;AACP,wGAAA,aAAa,OAAA;AACb,wGAAA,aAAa,OAAA;AACb,yGAAA,cAAc,OAAA;AACd,uGAAA,YAAY,OAAA;AACZ,+GAAA,oBAAoB,OAAA;AACpB,iHAAA,sBAAsB,OAAA;AACtB,mHAAA,wBAAwB,OAAA;AACxB,iHAAA,sBAAsB,OAAA;AACtB,wHAAA,6BAA6B,OAAA;AAC7B,qHAAA,0BAA0B,OAAA;AAC1B,gHAAA,qBAAqB,OAAA;AACrB,qGAAA,UAAU,OAAA;AACV,uGAAA,YAAY,OAAA;AACZ,2GAAA,gBAAgB,OAAA;AAChB,wGAAA,aAAa,OAAA;AACb,0GAAA,eAAe,OAAA;AACf,gHAAA,qBAAqB,OAAA;AACrB,6GAAA,kBAAkB,OAAA;AAClB,mHAAA,wBAAwB,OAAA;AACxB,4GAAA,iBAAiB,OAAA;AACjB,kHAAA,uBAAuB,OAAA;AACvB,6GAAA,kBAAkB,OAAA;AAClB,gHAAA,qBAAqB,OAAA;AACrB,iHAAA,sBAAsB,OAAA;AACtB,qHAAA,0BAA0B,OAAA;AAC1B,iHAAA,sBAAsB,OAAA;AASxB,gDAAgG;AAAvF,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AACzC,gDAK+B;AAJ7B,yGAAA,eAAe,OAAA;AACf,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAGlB,yDAGgC;AAF9B,mHAAA,iBAAiB,OAAA;AAGnB,0CAAoG;AAA3F,wGAAA,cAAc,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA;AACnD,mCAqBkB;AApBhB,yGAAA,eAAe,OAAA;AACf,qGAAA,WAAW,OAAA;AACX,oGAAA,UAAU,OAAA"}

package/dist/integrations/agent-mcp-installer.d.ts

@@ -38,7 +38,20 @@ export interface McpInstallResult {
     status: "injected" | "created" | "skipped" | "error" | "updated";
     message?: string;
 }
+export interface McpAgentInstallStatus {
+    agentId: string;
+    agentName: string;
+    configPath: string;
+    scope: "user" | "workspace";
+    detected: boolean;
+    installed: boolean;
+}
+export type McpConfigFormat = "json" | "codex-toml";
 export declare function detectInstalledAgents(): DetectedAgent[];
+/** Inspect detected agents and whether GraphFlow MCP is present in each config file. */
+export declare function getMcpInstallStatus(serverName?: string): McpAgentInstallStatus[];
+/** fnm multishell paths are session-temporary and break MCP after shell restart. */
+export declare function isEphemeralNodePath(nodePath: string): boolean;
 export declare function resolveSystemNodeCommand(): string | undefined;
 export declare function resolveMcpNodeLaunch(options: {
     nodeCommand?: string;

package/dist/integrations/agent-mcp-installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-mcp-installer.d.ts","sourceRoot":"","sources":["../../src/integrations/agent-mcp-installer.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,YAAY,GAAG,cAAc,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuJD,wBAAgB,qBAAqB,IAAI,aAAa,EAAE,CAYvD;AAOD,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,SAAS,CAa7D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAenD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CA4D5E;AAkHD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,EAAE,CA8CzF;AAED,wBAAgB,sBAAsB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAwCrE"}
+{"version":3,"file":"agent-mcp-installer.d.ts","sourceRoot":"","sources":["../../src/integrations/agent-mcp-installer.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,YAAY,GAAG,cAAc,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,YAAY,CAAC;AAyMpD,wBAAgB,qBAAqB,IAAI,aAAa,EAAE,CAYvD;AAwBD,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,UAAU,SAAc,GAAG,qBAAqB,EAAE,CAmCrF;AASD,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG7D;AAqBD,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,SAAS,CA0B7D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA8BnD;AAuBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CA8E5E;AA0OD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,EAAE,CAoDzF;AAED,wBAAgB,sBAAsB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CA0CrE"}