agent-orcha 0.0.2 → 0.0.3

package/dist/lib/knowledge/graph-rag/entity-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-extractor.js","sourceRoot":"","sources":["../../../../lib/knowledge/graph-rag/entity-extractor.ts"],"names":[],"mappings":"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"}

package/dist/lib/knowledge/graph-rag/extraction-cache.d.ts

@@ -0,0 +1,30 @@
+import type { CachedGraphData, ExtractedEntity, ExtractedRelationship, Community } from './types.js';
+/**
+ * File-based JSON cache for graph extraction results.
+ * Invalidates when source document content changes (SHA-256 hash).
+ */
+export declare class ExtractionCache {
+    private cacheDir;
+    constructor(baseDir: string, knowledgeName: string);
+    /**
+     * Compute SHA-256 hash of concatenated document contents.
+     */
+    static computeSourceHash(documentContents: string[]): string;
+    /**
+     * Check if valid cache exists for the given source hash.
+     */
+    isValid(sourceHash: string): Promise<boolean>;
+    /**
+     * Load cached graph data.
+     */
+    load(): Promise<CachedGraphData>;
+    /**
+     * Save graph data to cache.
+     */
+    save(sourceHash: string, entities: ExtractedEntity[], relationships: ExtractedRelationship[], communities: Community[]): Promise<void>;
+    /**
+     * Clear the cache directory.
+     */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=extraction-cache.d.ts.map

package/dist/lib/knowledge/graph-rag/extraction-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-cache.d.ts","sourceRoot":"","sources":["../../../../lib/knowledge/graph-rag/extraction-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAiB,eAAe,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOpH;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAIlD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,MAAM;IAQ5D;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWnD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAgBtC;;OAEG;IACG,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,eAAe,EAAE,EAC3B,aAAa,EAAE,qBAAqB,EAAE,EACtC,WAAW,EAAE,SAAS,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC;IAmBhB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

package/dist/lib/knowledge/graph-rag/extraction-cache.js

@@ -0,0 +1,88 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { createLogger } from '../../logger.js';
+const logger = createLogger('ExtractionCache');
+const CONFIG_VERSION = '1.0';
+/**
+ * File-based JSON cache for graph extraction results.
+ * Invalidates when source document content changes (SHA-256 hash).
+ */
+export class ExtractionCache {
+    cacheDir;
+    constructor(baseDir, knowledgeName) {
+        this.cacheDir = path.join(baseDir, knowledgeName);
+    }
+    /**
+     * Compute SHA-256 hash of concatenated document contents.
+     */
+    static computeSourceHash(documentContents) {
+        const hash = crypto.createHash('sha256');
+        for (const content of documentContents) {
+            hash.update(content);
+        }
+        return hash.digest('hex');
+    }
+    /**
+     * Check if valid cache exists for the given source hash.
+     */
+    async isValid(sourceHash) {
+        try {
+            const metadataPath = path.join(this.cacheDir, 'metadata.json');
+            const content = await fs.readFile(metadataPath, 'utf-8');
+            const metadata = JSON.parse(content);
+            return metadata.sourceHash === sourceHash && metadata.configVersion === CONFIG_VERSION;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Load cached graph data.
+     */
+    async load() {
+        const [metadataRaw, entitiesRaw, relationshipsRaw, communitiesRaw] = await Promise.all([
+            fs.readFile(path.join(this.cacheDir, 'metadata.json'), 'utf-8'),
+            fs.readFile(path.join(this.cacheDir, 'entities.json'), 'utf-8'),
+            fs.readFile(path.join(this.cacheDir, 'relationships.json'), 'utf-8'),
+            fs.readFile(path.join(this.cacheDir, 'communities.json'), 'utf-8'),
+        ]);
+        return {
+            metadata: JSON.parse(metadataRaw),
+            entities: JSON.parse(entitiesRaw),
+            relationships: JSON.parse(relationshipsRaw),
+            communities: JSON.parse(communitiesRaw),
+        };
+    }
+    /**
+     * Save graph data to cache.
+     */
+    async save(sourceHash, entities, relationships, communities) {
+        await fs.mkdir(this.cacheDir, { recursive: true });
+        const metadata = {
+            sourceHash,
+            extractedAt: new Date().toISOString(),
+            configVersion: CONFIG_VERSION,
+        };
+        await Promise.all([
+            fs.writeFile(path.join(this.cacheDir, 'metadata.json'), JSON.stringify(metadata, null, 2)),
+            fs.writeFile(path.join(this.cacheDir, 'entities.json'), JSON.stringify(entities, null, 2)),
+            fs.writeFile(path.join(this.cacheDir, 'relationships.json'), JSON.stringify(relationships, null, 2)),
+            fs.writeFile(path.join(this.cacheDir, 'communities.json'), JSON.stringify(communities, null, 2)),
+        ]);
+        logger.info(`Cache saved to ${this.cacheDir} (${entities.length} entities, ${relationships.length} relationships, ${communities.length} communities)`);
+    }
+    /**
+     * Clear the cache directory.
+     */
+    async clear() {
+        try {
+            await fs.rm(this.cacheDir, { recursive: true, force: true });
+            logger.info(`Cache cleared: ${this.cacheDir}`);
+        }
+        catch {
+            // Cache directory may not exist
+        }
+    }
+}
+//# sourceMappingURL=extraction-cache.js.map

package/dist/lib/knowledge/graph-rag/extraction-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-cache.js","sourceRoot":"","sources":["../../../../lib/knowledge/graph-rag/extraction-cache.ts"],"names":[],"mappings":"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"}

package/dist/lib/knowledge/graph-rag/global-search.d.ts

@@ -0,0 +1,19 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { GraphStore, GlobalSearchConfig } from './types.js';
+import type { SearchResult } from '../types.js';
+/**
+ * Community-summary map-reduce search.
+ * 1. Retrieve top N community summaries
+ * 2. Map: ask LLM to answer query using each summary
+ * 3. Reduce: synthesize all partial answers into final response
+ */
+export declare class GlobalSearch {
+    private store;
+    private llm;
+    private config;
+    constructor(store: GraphStore, llm: BaseChatModel, config: GlobalSearchConfig);
+    search(query: string, _k: number): Promise<SearchResult[]>;
+    private mapQuery;
+    private reduceAnswers;
+}
+//# sourceMappingURL=global-search.d.ts.map

package/dist/lib/knowledge/graph-rag/global-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-search.d.ts","sourceRoot":"","sources":["../../../../lib/knowledge/graph-rag/global-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,MAAM,CAAqB;gBAEvB,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB;IAMvE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAyDlD,QAAQ;YAoBR,aAAa;CAyB5B"}

package/dist/lib/knowledge/graph-rag/global-search.js

@@ -0,0 +1,96 @@
+import { HumanMessage, SystemMessage } from '@langchain/core/messages';
+import { createLogger } from '../../logger.js';
+const logger = createLogger('GraphGlobalSearch');
+/**
+ * Community-summary map-reduce search.
+ * 1. Retrieve top N community summaries
+ * 2. Map: ask LLM to answer query using each summary
+ * 3. Reduce: synthesize all partial answers into final response
+ */
+export class GlobalSearch {
+    store;
+    llm;
+    config;
+    constructor(store, llm, config) {
+        this.store = store;
+        this.llm = llm;
+        this.config = config;
+    }
+    async search(query, _k) {
+        logger.info(`Global search: "${query.substring(0, 50)}..." (topCommunities=${this.config.topCommunities})`);
+        const communities = await this.store.getCommunities();
+        if (communities.length === 0) {
+            logger.warn('No communities found');
+            return [];
+        }
+        // Take top N communities (sorted by size, largest first)
+        const topCommunities = [...communities]
+            .sort((a, b) => b.nodeIds.length - a.nodeIds.length)
+            .slice(0, this.config.topCommunities);
+        logger.info(`Using ${topCommunities.length} communities for map-reduce`);
+        // Map phase: get partial answers from each community
+        const partialAnswers = [];
+        for (const community of topCommunities) {
+            if (!community.summary)
+                continue;
+            try {
+                const answer = await this.mapQuery(query, community.title ?? community.id, community.summary);
+                if (answer && answer.trim().length > 0) {
+                    partialAnswers.push({
+                        communityId: community.id,
+                        title: community.title ?? community.id,
+                        answer,
+                    });
+                }
+            }
+            catch (error) {
+                logger.warn(`Map failed for community ${community.id}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        if (partialAnswers.length === 0) {
+            logger.warn('No partial answers generated');
+            return [];
+        }
+        // Reduce phase: synthesize final answer
+        const synthesized = await this.reduceAnswers(query, partialAnswers);
+        const result = {
+            content: synthesized,
+            metadata: {
+                type: 'graph-global',
+                communitiesUsed: partialAnswers.length,
+                communityIds: partialAnswers.map((a) => a.communityId),
+            },
+            score: 1.0, // Global search is always fully relevant to broad queries
+        };
+        return [result];
+    }
+    async mapQuery(query, communityTitle, communitySummary) {
+        const response = await this.llm.invoke([
+            new SystemMessage(`You are a helpful analyst. Given a community summary from a knowledge graph, answer the user's question based on the information available. If the community summary is not relevant to the question, respond with an empty string "".
+Be concise and factual.`),
+            new HumanMessage(`Community: ${communityTitle}\n\nSummary:\n${communitySummary}\n\nQuestion: ${query}`),
+        ]);
+        const text = typeof response.content === 'string'
+            ? response.content
+            : Array.isArray(response.content)
+                ? response.content.map((c) => (typeof c === 'string' ? c : 'text' in c ? c.text : '')).join('')
+                : '';
+        return text.trim();
+    }
+    async reduceAnswers(query, partialAnswers) {
+        const answersText = partialAnswers
+            .map((a, i) => `[${i + 1}] Community "${a.title}":\n${a.answer}`)
+            .join('\n\n');
+        const response = await this.llm.invoke([
+            new SystemMessage(`You are a synthesis expert. Given multiple partial answers from different knowledge graph communities, synthesize them into a single comprehensive answer. Remove redundancies, reconcile any conflicts, and present a coherent response.`),
+            new HumanMessage(`Question: ${query}\n\nPartial answers from different communities:\n\n${answersText}\n\nProvide a synthesized comprehensive answer:`),
+        ]);
+        const text = typeof response.content === 'string'
+            ? response.content
+            : Array.isArray(response.content)
+                ? response.content.map((c) => (typeof c === 'string' ? c : 'text' in c ? c.text : '')).join('')
+                : '';
+        return text.trim();
+    }
+}
+//# sourceMappingURL=global-search.js.map

package/dist/lib/knowledge/graph-rag/global-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-search.js","sourceRoot":"","sources":["../../../../lib/knowledge/graph-rag/global-search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,CAAa;IAClB,GAAG,CAAgB;IACnB,MAAM,CAAqB;IAEnC,YAAY,KAAiB,EAAE,GAAkB,EAAE,MAA0B;QAC3E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,EAAU;QACpC,MAAM,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,wBAAwB,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;QAE5G,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QACtD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACpC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,yDAAyD;QACzD,MAAM,cAAc,GAAG,CAAC,GAAG,WAAW,CAAC;aACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;aACnD,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAExC,MAAM,CAAC,IAAI,CAAC,SAAS,cAAc,CAAC,MAAM,6BAA6B,CAAC,CAAC;QAEzE,qDAAqD;QACrD,MAAM,cAAc,GAAkE,EAAE,CAAC;QAEzF,KAAK,MAAM,SAAS,IAAI,cAAc,EAAE,CAAC;YACvC,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,SAAS;YAEjC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC9F,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvC,cAAc,CAAC,IAAI,CAAC;wBAClB,WAAW,EAAE,SAAS,CAAC,EAAE;wBACzB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,EAAE;wBACtC,MAAM;qBACP,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,4BAA4B,SAAS,CAAC,EAAE,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrH,CAAC;QACH,CAAC;QAED,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,wCAAwC;QACxC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAiB;YAC3B,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE;gBACR,IAAI,EAAE,cAAc;gBACpB,eAAe,EAAE,cAAc,CAAC,MAAM;gBACtC,YAAY,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;aACvD;YACD,KAAK,EAAE,GAAG,EAAE,0DAA0D;SACvE,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,cAAsB,EAAE,gBAAwB;QACpF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YACrC,IAAI,aAAa,CACf;wBACgB,CACjB;YACD,IAAI,YAAY,CACd,cAAc,cAAc,iBAAiB,gBAAgB,iBAAiB,KAAK,EAAE,CACtF;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;YAC/C,CAAC,CAAC,QAAQ,CAAC,OAAO;YAClB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC/B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/F,CAAC,CAAC,EAAE,CAAC;QAET,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,KAAa,EACb,cAA6E;QAE7E,MAAM,WAAW,GAAG,cAAc;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;aAChE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YACrC,IAAI,aAAa,CACf,2OAA2O,CAC5O;YACD,IAAI,YAAY,CACd,aAAa,KAAK,sDAAsD,WAAW,iDAAiD,CACrI;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;YAC/C,CAAC,CAAC,QAAQ,CAAC,OAAO;YAClB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC/B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/F,CAAC,CAAC,EAAE,CAAC;QAET,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/lib/knowledge/graph-rag/graph-rag-factory.d.ts

@@ -0,0 +1,24 @@
+import type { GraphStore } from './types.js';
+import type { KnowledgeStoreInstance } from '../types.js';
+import type { GraphRagKnowledgeConfig } from '../types.js';
+/**
+ * Creates a GraphRAG KnowledgeStoreInstance from a graph-rag configuration.
+ * Orchestrates: load → split → extract entities → build graph → detect communities → summarize → index.
+ */
+export declare class GraphRagFactory {
+    /** Graph store references for API access (keyed by knowledge store name) */
+    private static graphStores;
+    /** Get a graph store by knowledge store name (for API endpoints) */
+    static getGraphStore(name: string): GraphStore | undefined;
+    static create(config: GraphRagKnowledgeConfig, projectRoot: string): Promise<KnowledgeStoreInstance>;
+    private static createGraphStore;
+    /**
+     * Build GraphNode objects from extracted entities, creating embeddings for each.
+     */
+    private static buildNodes;
+    /**
+     * Build GraphEdge objects from extracted relationships, resolving entity names to node IDs.
+     */
+    private static buildEdges;
+}
+//# sourceMappingURL=graph-rag-factory.d.ts.map

package/dist/lib/knowledge/graph-rag/graph-rag-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-rag-factory.d.ts","sourceRoot":"","sources":["../../../../lib/knowledge/graph-rag/graph-rag-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,UAAU,EAIX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAiB3D;;;GAGG;AACH,qBAAa,eAAe;IAC1B,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAC,WAAW,CAAiC;IAE3D,oEAAoE;IACpE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;WAI7C,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmJ1G,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAiB/B;;OAEG;mBACkB,UAAU;IAgC/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;CAkC1B"}

package/dist/lib/knowledge/graph-rag/graph-rag-factory.js

@@ -0,0 +1,239 @@
+import { MemoryGraphStore } from './memory-graph-store.js';
+import { Neo4jGraphStore } from './neo4j-graph-store.js';
+import { EntityExtractor } from './entity-extractor.js';
+import { ExtractionCache } from './extraction-cache.js';
+import { CommunityDetector } from './community-detector.js';
+import { CommunitySummarizer } from './community-summarizer.js';
+import { LocalSearch } from './local-search.js';
+import { GlobalSearch } from './global-search.js';
+import { detectSearchMode } from './search-mode-detector.js';
+import { LLMFactory } from '../../llm/llm-factory.js';
+import { KnowledgeStoreFactory } from '../knowledge-store-factory.js';
+import { createLogger } from '../../logger.js';
+import * as path from 'path';
+const logger = createLogger('GraphRAGFactory');
+/**
+ * Creates a GraphRAG KnowledgeStoreInstance from a graph-rag configuration.
+ * Orchestrates: load → split → extract entities → build graph → detect communities → summarize → index.
+ */
+export class GraphRagFactory {
+    /** Graph store references for API access (keyed by knowledge store name) */
+    static graphStores = new Map();
+    /** Get a graph store by knowledge store name (for API endpoints) */
+    static getGraphStore(name) {
+        return this.graphStores.get(name);
+    }
+    static async create(config, projectRoot) {
+        const graphConfig = config.graph;
+        const searchConfig = config.search;
+        logger.info(`Creating GraphRAG store "${config.name}"...`);
+        // 1. Load and split documents (reuse existing infrastructure)
+        logger.info('Loading documents...');
+        const documents = await KnowledgeStoreFactory.loadDocuments(config, projectRoot);
+        logger.info(`Loaded ${documents.length} document(s)`);
+        const splitDocs = await KnowledgeStoreFactory.splitDocuments(config, documents);
+        logger.info(`Split into ${splitDocs.length} chunk(s)`);
+        // 2. Create embeddings for entity descriptions
+        const embeddings = KnowledgeStoreFactory.createEmbeddings(config.embedding);
+        // 3. Create graph store
+        const store = this.createGraphStore(graphConfig);
+        // 4. Check cache
+        const cacheEnabled = graphConfig.cache.enabled;
+        const cachePath = path.resolve(projectRoot, graphConfig.cache.directory);
+        const cache = new ExtractionCache(cachePath, config.name);
+        const docContents = splitDocs.map((d) => d.pageContent);
+        const sourceHash = ExtractionCache.computeSourceHash(docContents);
+        let entities = [];
+        let relationships = [];
+        let communities = [];
+        let cacheHit = false;
+        if (cacheEnabled && await cache.isValid(sourceHash)) {
+            try {
+                logger.info('Cache HIT - loading from cache');
+                const cached = await cache.load();
+                entities = cached.entities;
+                relationships = cached.relationships;
+                communities = cached.communities;
+                cacheHit = true;
+            }
+            catch (cacheError) {
+                logger.warn(`Cache load failed, falling back to extraction: ${cacheError instanceof Error ? cacheError.message : String(cacheError)}`);
+            }
+        }
+        if (!cacheHit) {
+            if (cacheEnabled) {
+                logger.info('Cache MISS - running extraction pipeline');
+            }
+            // 5. Entity extraction
+            const extractionLlm = LLMFactory.create(graphConfig.extraction.llm);
+            const extractor = new EntityExtractor({
+                llm: extractionLlm,
+                entityTypes: graphConfig.extraction.entityTypes,
+                relationshipTypes: graphConfig.extraction.relationshipTypes,
+            });
+            const chunks = splitDocs.map((doc, idx) => ({
+                id: `chunk-${idx}`,
+                content: doc.pageContent,
+            }));
+            const extracted = await extractor.extractFromChunks(chunks);
+            entities = extracted.entities;
+            relationships = extracted.relationships;
+            // 6. Build graph
+            const nodes = await this.buildNodes(entities, embeddings);
+            const edges = this.buildEdges(relationships, nodes);
+            await store.addNodes(nodes);
+            await store.addEdges(edges);
+            // 7. Community detection
+            if (store instanceof MemoryGraphStore) {
+                const detector = new CommunityDetector(graphConfig.communities);
+                communities = await detector.detect(store);
+                // 8. Community summarization
+                if (communities.length > 0) {
+                    const summaryLlm = LLMFactory.create(graphConfig.communities.summaryLlm);
+                    const summarizer = new CommunitySummarizer(summaryLlm);
+                    communities = await summarizer.summarize(communities, store);
+                }
+            }
+            else {
+                // Neo4j: community detection not yet supported directly
+                communities = [];
+                logger.warn('Community detection not supported for Neo4j store (use memory store)');
+            }
+            await store.setCommunities(communities);
+            // 9. Save to cache
+            if (cacheEnabled) {
+                await cache.save(sourceHash, entities, relationships, communities);
+            }
+        }
+        // If loading from cache, we need to rebuild the graph store
+        if (cacheEnabled && entities.length > 0 && (await store.getAllNodes()).length === 0) {
+            const nodes = await this.buildNodes(entities, embeddings);
+            const edges = this.buildEdges(relationships, nodes);
+            await store.addNodes(nodes);
+            await store.addEdges(edges);
+            await store.setCommunities(communities);
+        }
+        logger.info(`GraphRAG "${config.name}" ready: ${entities.length} entities, ${relationships.length} relationships, ${communities.length} communities`);
+        // Register graph store for API access
+        this.graphStores.set(config.name, store);
+        // 10. Create search instances
+        const localSearch = new LocalSearch(store, embeddings, searchConfig.localSearch);
+        const globalSearchLlm = LLMFactory.create(searchConfig.globalSearch.llm);
+        const globalSearch = new GlobalSearch(store, globalSearchLlm, searchConfig.globalSearch);
+        // 11. Return KnowledgeStoreInstance
+        return {
+            config: config, // GraphRagKnowledgeConfig is compatible with KnowledgeConfig via the union
+            search: async (query, k) => {
+                const numResults = k ?? searchConfig.defaultK;
+                const mode = detectSearchMode(query);
+                logger.info(`Search mode: ${mode} for query: "${query.substring(0, 50)}..."`);
+                if (mode === 'global') {
+                    return globalSearch.search(query, numResults);
+                }
+                return localSearch.search(query, numResults);
+            },
+            addDocuments: async () => {
+                logger.warn('addDocuments not supported for GraphRAG stores - use refresh() instead');
+            },
+            refresh: async () => {
+                logger.info(`Refreshing GraphRAG store "${config.name}"...`);
+                await store.clear();
+                if (cacheEnabled) {
+                    await cache.clear();
+                }
+                // Re-run the full pipeline
+                await GraphRagFactory.create(config, projectRoot);
+            },
+        };
+    }
+    static createGraphStore(config) {
+        switch (config.store.type) {
+            case 'neo4j': {
+                const opts = config.store.options;
+                return new Neo4jGraphStore({
+                    uri: opts.uri ?? 'bolt://localhost:7687',
+                    username: opts.username ?? 'neo4j',
+                    password: opts.password ?? 'password',
+                    database: opts.database,
+                });
+            }
+            case 'memory':
+            default:
+                return new MemoryGraphStore();
+        }
+    }
+    /**
+     * Build GraphNode objects from extracted entities, creating embeddings for each.
+     */
+    static async buildNodes(entities, embeddings) {
+        const nodes = [];
+        // Batch embed all entity descriptions
+        const descriptions = entities.map((e) => `${e.name}: ${e.description}`);
+        let embeddingVectors = [];
+        try {
+            embeddingVectors = await embeddings.embedDocuments(descriptions);
+        }
+        catch (error) {
+            logger.error(`Failed to embed entity descriptions: ${error instanceof Error ? error.message : String(error)}`);
+            // Fall back to empty embeddings
+            embeddingVectors = entities.map(() => []);
+        }
+        for (let i = 0; i < entities.length; i++) {
+            const entity = entities[i];
+            const nodeId = normalizeId(entity.name, entity.type);
+            nodes.push({
+                id: nodeId,
+                type: entity.type,
+                name: entity.name,
+                description: entity.description,
+                properties: entity.properties,
+                sourceChunkIds: entity.properties.sourceChunkIds ?? [],
+                embedding: embeddingVectors[i],
+            });
+        }
+        return nodes;
+    }
+    /**
+     * Build GraphEdge objects from extracted relationships, resolving entity names to node IDs.
+     */
+    static buildEdges(relationships, nodes) {
+        const nodeIdMap = new Map();
+        for (const node of nodes) {
+            const key = `${node.name.toLowerCase()}::${node.type.toLowerCase()}`;
+            nodeIdMap.set(key, node.id);
+        }
+        const edges = [];
+        for (let i = 0; i < relationships.length; i++) {
+            const rel = relationships[i];
+            const sourceKey = `${rel.sourceName.toLowerCase()}::${rel.sourceType.toLowerCase()}`;
+            const targetKey = `${rel.targetName.toLowerCase()}::${rel.targetType.toLowerCase()}`;
+            const sourceId = nodeIdMap.get(sourceKey);
+            const targetId = nodeIdMap.get(targetKey);
+            if (!sourceId || !targetId) {
+                logger.debug(`Skipping relationship: missing node for ${rel.sourceName} -> ${rel.targetName}`);
+                continue;
+            }
+            edges.push({
+                id: `edge-${i}-${rel.type}`,
+                type: rel.type,
+                sourceId,
+                targetId,
+                description: rel.description,
+                weight: rel.weight,
+                properties: {},
+            });
+        }
+        return edges;
+    }
+}
+/**
+ * Create a deterministic node ID from entity name and type.
+ */
+function normalizeId(name, type) {
+    const normalized = `${type}::${name}`
+        .toLowerCase()
+        .replace(/[^a-z0-9:]+/g, '-')
+        .replace(/^-|-$/g, '');
+    return normalized;
+}
+//# sourceMappingURL=graph-rag-factory.js.map

package/dist/lib/knowledge/graph-rag/graph-rag-factory.js.map

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

package/dist/lib/knowledge/graph-rag/index.d.ts

@@ -0,0 +1,14 @@
+export { GraphRagFactory } from './graph-rag-factory.js';
+export { MemoryGraphStore } from './memory-graph-store.js';
+export { Neo4jGraphStore } from './neo4j-graph-store.js';
+export { EntityExtractor } from './entity-extractor.js';
+export { ExtractionCache } from './extraction-cache.js';
+export { CommunityDetector } from './community-detector.js';
+export { CommunitySummarizer } from './community-summarizer.js';
+export { LocalSearch } from './local-search.js';
+export { GlobalSearch } from './global-search.js';
+export { detectSearchMode } from './search-mode-detector.js';
+export type { SearchMode } from './search-mode-detector.js';
+export { GraphConfigSchema, GraphSearchConfigSchema, GraphExtractionConfigSchema, GraphCommunitiesConfigSchema, GraphStoreConfigSchema, GraphCacheConfigSchema, EntityTypeSchema, RelationshipTypeSchema, LocalSearchConfigSchema, GlobalSearchConfigSchema, } from './types.js';
+export type { GraphNode, GraphEdge, Community, GraphStore, GraphConfig, GraphSearchConfig, GraphExtractionConfig, GraphCommunitiesConfig, GraphStoreConfig, GraphCacheConfig, EntityTypeConfig, RelationshipTypeConfig, LocalSearchConfig, GlobalSearchConfig, ExtractedEntity, ExtractedRelationship, ExtractionResult, CacheMetadata, CachedGraphData, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/knowledge/graph-rag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/knowledge/graph-rag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/lib/knowledge/graph-rag/index.js

@@ -0,0 +1,12 @@
+export { GraphRagFactory } from './graph-rag-factory.js';
+export { MemoryGraphStore } from './memory-graph-store.js';
+export { Neo4jGraphStore } from './neo4j-graph-store.js';
+export { EntityExtractor } from './entity-extractor.js';
+export { ExtractionCache } from './extraction-cache.js';
+export { CommunityDetector } from './community-detector.js';
+export { CommunitySummarizer } from './community-summarizer.js';
+export { LocalSearch } from './local-search.js';
+export { GlobalSearch } from './global-search.js';
+export { detectSearchMode } from './search-mode-detector.js';
+export { GraphConfigSchema, GraphSearchConfigSchema, GraphExtractionConfigSchema, GraphCommunitiesConfigSchema, GraphStoreConfigSchema, GraphCacheConfigSchema, EntityTypeSchema, RelationshipTypeSchema, LocalSearchConfigSchema, GlobalSearchConfigSchema, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/knowledge/graph-rag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/knowledge/graph-rag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/lib/knowledge/graph-rag/local-search.d.ts

@@ -0,0 +1,20 @@
+import type { Embeddings } from '@langchain/core/embeddings';
+import type { GraphStore, LocalSearchConfig } from './types.js';
+import type { SearchResult } from '../types.js';
+/**
+ * Entity-neighborhood search.
+ * 1. Embed the query
+ * 2. Find top-K similar entity nodes by embedding
+ * 3. Expand each node's neighborhood by maxDepth hops
+ * 4. Return structured context as SearchResult[]
+ */
+export declare class LocalSearch {
+    private store;
+    private embeddings;
+    private config;
+    constructor(store: GraphStore, embeddings: Embeddings, config: LocalSearchConfig);
+    search(query: string, k: number): Promise<SearchResult[]>;
+    private formatNeighborhood;
+    private computeRelevanceScore;
+}
+//# sourceMappingURL=local-search.d.ts.map

package/dist/lib/knowledge/graph-rag/local-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-search.d.ts","sourceRoot":"","sources":["../../../../lib/knowledge/graph-rag/local-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAwB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB;IAM1E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiD/D,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,qBAAqB;CAI9B"}