@framers/agentos 0.1.32 → 0.1.33

package/dist/neo4j/Neo4jConnectionManager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Shared Neo4j connection manager for AgentOS.
+ *
+ * Manages a single neo4j-driver Driver instance with connection pooling,
+ * session factory, health checks, and graceful shutdown. All Neo4j-backed
+ * implementations (VectorStore, KnowledgeGraph, GraphRAG, CapabilityGraph)
+ * share one connection manager instance to avoid redundant pools.
+ *
+ * neo4j-driver is loaded via dynamic import so it is never required
+ * unless explicitly configured — matching the hnswlib-node optional pattern.
+ *
+ * @module @framers/agentos/neo4j/Neo4jConnectionManager
+ */
+import type { Neo4jConnectionConfig } from './types.js';
+/**
+ * Shared Neo4j connection manager.
+ *
+ * Usage:
+ * ```typescript
+ * const mgr = new Neo4jConnectionManager();
+ * await mgr.initialize({ uri: 'bolt://localhost:7687', username: 'neo4j', password: 'pw' });
+ *
+ * // All backends receive the same manager
+ * const vectorStore = new Neo4jVectorStore(mgr);
+ * const knowledgeGraph = new Neo4jKnowledgeGraph({ connectionManager: mgr });
+ * ```
+ */
+export declare class Neo4jConnectionManager {
+    /** neo4j-driver's Driver instance — null until initialize() */
+    private driver;
+    private neo4jModule;
+    private config;
+    private database;
+    /** Whether initialize() has been called successfully */
+    get isInitialized(): boolean;
+    /**
+     * Initialize the connection manager.
+     * Dynamically imports neo4j-driver, creates the driver, and verifies connectivity.
+     */
+    initialize(config: Neo4jConnectionConfig): Promise<void>;
+    /**
+     * Create a session. Callers MUST close the session in a finally block.
+     *
+     * @param mode - 'READ' for read-only transactions, 'WRITE' for write transactions.
+     */
+    session(mode?: 'READ' | 'WRITE'): any;
+    /**
+     * Check Neo4j connectivity.
+     */
+    checkHealth(): Promise<{
+        isHealthy: boolean;
+        details?: any;
+    }>;
+    /**
+     * Gracefully close the driver and release all connection pool resources.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=Neo4jConnectionManager.d.ts.map

package/dist/neo4j/Neo4jConnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Neo4jConnectionManager.d.ts","sourceRoot":"","sources":["../../src/neo4j/Neo4jConnectionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAsB;IACjC,+DAA+D;IAC/D,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAU;IAE1B,wDAAwD;IACxD,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC9D;;;;OAIG;IACH,OAAO,CAAC,IAAI,GAAE,MAAM,GAAG,OAAgB,GAAG,GAAG;IAW7C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IAsBnE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC"}

package/dist/neo4j/Neo4jConnectionManager.js

@@ -0,0 +1,115 @@
+/**
+ * @fileoverview Shared Neo4j connection manager for AgentOS.
+ *
+ * Manages a single neo4j-driver Driver instance with connection pooling,
+ * session factory, health checks, and graceful shutdown. All Neo4j-backed
+ * implementations (VectorStore, KnowledgeGraph, GraphRAG, CapabilityGraph)
+ * share one connection manager instance to avoid redundant pools.
+ *
+ * neo4j-driver is loaded via dynamic import so it is never required
+ * unless explicitly configured — matching the hnswlib-node optional pattern.
+ *
+ * @module @framers/agentos/neo4j/Neo4jConnectionManager
+ */
+/**
+ * Shared Neo4j connection manager.
+ *
+ * Usage:
+ * ```typescript
+ * const mgr = new Neo4jConnectionManager();
+ * await mgr.initialize({ uri: 'bolt://localhost:7687', username: 'neo4j', password: 'pw' });
+ *
+ * // All backends receive the same manager
+ * const vectorStore = new Neo4jVectorStore(mgr);
+ * const knowledgeGraph = new Neo4jKnowledgeGraph({ connectionManager: mgr });
+ * ```
+ */
+export class Neo4jConnectionManager {
+    constructor() {
+        /** neo4j-driver's Driver instance — null until initialize() */
+        this.driver = null;
+        this.neo4jModule = null;
+    }
+    /** Whether initialize() has been called successfully */
+    get isInitialized() {
+        return this.driver !== null;
+    }
+    /**
+     * Initialize the connection manager.
+     * Dynamically imports neo4j-driver, creates the driver, and verifies connectivity.
+     */
+    async initialize(config) {
+        if (this.driver)
+            return; // Already initialized
+        try {
+            // @ts-ignore -- neo4j-driver is an optional peer dependency
+            this.neo4jModule = await import('neo4j-driver');
+        }
+        catch {
+            throw new Error('neo4j-driver is not installed. Install it as an optional peer dependency:\n' +
+                '  npm install neo4j-driver\n' +
+                'Or use a different backend (in_memory, hnswlib, sql, qdrant).');
+        }
+        this.config = config;
+        this.database = config.database ?? 'neo4j';
+        const neo4j = this.neo4jModule.default ?? this.neo4jModule;
+        this.driver = neo4j.driver(config.uri, neo4j.auth.basic(config.username, config.password), {
+            maxConnectionPoolSize: config.maxConnectionPoolSize ?? 50,
+            connectionAcquisitionTimeout: config.connectionAcquisitionTimeoutMs ?? 30000,
+        });
+        // Verify connectivity early
+        await this.driver.verifyConnectivity();
+    }
+    /**
+     * Create a session. Callers MUST close the session in a finally block.
+     *
+     * @param mode - 'READ' for read-only transactions, 'WRITE' for write transactions.
+     */
+    session(mode = 'READ') {
+        if (!this.driver || !this.neo4jModule) {
+            throw new Error('Neo4jConnectionManager not initialized. Call initialize() first.');
+        }
+        const neo4j = this.neo4jModule.default ?? this.neo4jModule;
+        return this.driver.session({
+            database: this.database,
+            defaultAccessMode: mode === 'READ' ? neo4j.session.READ : neo4j.session.WRITE,
+        });
+    }
+    /**
+     * Check Neo4j connectivity.
+     */
+    async checkHealth() {
+        if (!this.driver) {
+            return { isHealthy: false, details: 'Not initialized' };
+        }
+        const session = this.session('READ');
+        try {
+            const result = await session.run('RETURN 1 AS ping');
+            return {
+                isHealthy: true,
+                details: {
+                    ping: result.records[0]?.get('ping'),
+                    database: this.database,
+                    uri: this.config.uri,
+                },
+            };
+        }
+        catch (err) {
+            return { isHealthy: false, details: err?.message };
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Gracefully close the driver and release all connection pool resources.
+     */
+    async shutdown() {
+        if (this.driver) {
+            await this.driver.close();
+            this.driver = null;
+            this.neo4jModule = null;
+        }
+    }
+}
+//# sourceMappingURL=Neo4jConnectionManager.js.map

package/dist/neo4j/Neo4jConnectionManager.js.map

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

package/dist/neo4j/Neo4jCypherRunner.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Thin parameterized Cypher query runner wrapping Neo4jConnectionManager.
+ *
+ * Handles session lifecycle (create/close in finally), executeRead/executeWrite
+ * dispatch, and result record mapping. All Cypher is parameterized — no string
+ * interpolation — to prevent injection.
+ *
+ * @module @framers/agentos/neo4j/Neo4jCypherRunner
+ */
+import type { Neo4jConnectionManager } from './Neo4jConnectionManager.js';
+/**
+ * Helper for running parameterized Cypher queries.
+ */
+export declare class Neo4jCypherRunner {
+    private connectionManager;
+    constructor(connectionManager: Neo4jConnectionManager);
+    /**
+     * Execute a read-only Cypher query with automatic session management.
+     * Returns result records mapped to plain objects.
+     */
+    read<T = Record<string, unknown>>(cypher: string, params?: Record<string, unknown>): Promise<T[]>;
+    /**
+     * Execute a write Cypher query with automatic session management.
+     * Returns result records mapped to plain objects.
+     */
+    write<T = Record<string, unknown>>(cypher: string, params?: Record<string, unknown>): Promise<T[]>;
+    /**
+     * Execute a write Cypher query that returns no results.
+     */
+    writeVoid(cypher: string, params?: Record<string, unknown>): Promise<void>;
+    /**
+     * Execute multiple write statements in a single transaction.
+     */
+    writeTransaction(statements: Array<{
+        cypher: string;
+        params?: Record<string, unknown>;
+    }>): Promise<void>;
+}
+//# sourceMappingURL=Neo4jCypherRunner.d.ts.map

package/dist/neo4j/Neo4jCypherRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Neo4jCypherRunner.d.ts","sourceRoot":"","sources":["../../src/neo4j/Neo4jCypherRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;GAEG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,sBAAsB;IAE7D;;;OAGG;IACG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,EAAE,CAAC;IAUf;;;OAGG;IACG,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,EAAE,CAAC;IAUf;;OAEG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACG,gBAAgB,CACpB,UAAU,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GACtE,OAAO,CAAC,IAAI,CAAC;CAYjB"}

package/dist/neo4j/Neo4jCypherRunner.js

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview Thin parameterized Cypher query runner wrapping Neo4jConnectionManager.
+ *
+ * Handles session lifecycle (create/close in finally), executeRead/executeWrite
+ * dispatch, and result record mapping. All Cypher is parameterized — no string
+ * interpolation — to prevent injection.
+ *
+ * @module @framers/agentos/neo4j/Neo4jCypherRunner
+ */
+/**
+ * Helper for running parameterized Cypher queries.
+ */
+export class Neo4jCypherRunner {
+    constructor(connectionManager) {
+        this.connectionManager = connectionManager;
+    }
+    /**
+     * Execute a read-only Cypher query with automatic session management.
+     * Returns result records mapped to plain objects.
+     */
+    async read(cypher, params = {}) {
+        const session = this.connectionManager.session('READ');
+        try {
+            const result = await session.executeRead((tx) => tx.run(cypher, params));
+            return result.records.map((r) => r.toObject());
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Execute a write Cypher query with automatic session management.
+     * Returns result records mapped to plain objects.
+     */
+    async write(cypher, params = {}) {
+        const session = this.connectionManager.session('WRITE');
+        try {
+            const result = await session.executeWrite((tx) => tx.run(cypher, params));
+            return result.records.map((r) => r.toObject());
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Execute a write Cypher query that returns no results.
+     */
+    async writeVoid(cypher, params = {}) {
+        const session = this.connectionManager.session('WRITE');
+        try {
+            await session.executeWrite((tx) => tx.run(cypher, params));
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Execute multiple write statements in a single transaction.
+     */
+    async writeTransaction(statements) {
+        const session = this.connectionManager.session('WRITE');
+        try {
+            await session.executeWrite(async (tx) => {
+                for (const stmt of statements) {
+                    await tx.run(stmt.cypher, stmt.params ?? {});
+                }
+            });
+        }
+        finally {
+            await session.close();
+        }
+    }
+}
+//# sourceMappingURL=Neo4jCypherRunner.js.map

package/dist/neo4j/Neo4jCypherRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Neo4jCypherRunner.js","sourceRoot":"","sources":["../../src/neo4j/Neo4jCypherRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC5B,YAAoB,iBAAyC;QAAzC,sBAAiB,GAAjB,iBAAiB,CAAwB;IAAG,CAAC;IAEjE;;;OAGG;IACH,KAAK,CAAC,IAAI,CACR,MAAc,EACd,SAAkC,EAAE;QAEpC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAC9E,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAO,CAAC,CAAC;QAC3D,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CACT,MAAc,EACd,SAAkC,EAAE;QAEpC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAC/E,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAO,CAAC,CAAC;QAC3D,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACb,MAAc,EACd,SAAkC,EAAE;QAEpC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAClE,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,UAAuE;QAEvE,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,EAAO,EAAE,EAAE;gBAC3C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;oBAC9B,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/neo4j/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Neo4j Integration Module
+ *
+ * Shared infrastructure for all Neo4j-backed AgentOS implementations.
+ * neo4j-driver is an optional peer dependency — never loaded unless configured.
+ *
+ * @module @framers/agentos/neo4j
+ */
+export { Neo4jConnectionManager } from './Neo4jConnectionManager.js';
+export { Neo4jCypherRunner } from './Neo4jCypherRunner.js';
+export type { Neo4jConnectionConfig, Neo4jRecord } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neo4j/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/neo4j/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/neo4j/index.js

@@ -0,0 +1,11 @@
+/**
+ * Neo4j Integration Module
+ *
+ * Shared infrastructure for all Neo4j-backed AgentOS implementations.
+ * neo4j-driver is an optional peer dependency — never loaded unless configured.
+ *
+ * @module @framers/agentos/neo4j
+ */
+export { Neo4jConnectionManager } from './Neo4jConnectionManager.js';
+export { Neo4jCypherRunner } from './Neo4jCypherRunner.js';
+//# sourceMappingURL=index.js.map

package/dist/neo4j/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/neo4j/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/neo4j/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Neo4j connection configuration types for AgentOS.
+ * @module @framers/agentos/neo4j/types
+ */
+/**
+ * Configuration for connecting to a Neo4j instance.
+ * Used by Neo4jConnectionManager and all Neo4j-backed implementations.
+ */
+export interface Neo4jConnectionConfig {
+    /** Connection URI (e.g., 'bolt://localhost:7687', 'neo4j+s://xxx.databases.neo4j.io') */
+    uri: string;
+    /** Username — 'neo4j' for default installations */
+    username: string;
+    /** Password */
+    password: string;
+    /** Database name — defaults to 'neo4j' */
+    database?: string;
+    /** Max connection pool size — defaults to 50 */
+    maxConnectionPoolSize?: number;
+    /** Connection acquisition timeout in ms — defaults to 30000 */
+    connectionAcquisitionTimeoutMs?: number;
+}
+/**
+ * Record shape returned by Neo4j result mapping.
+ */
+export type Neo4jRecord = Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/neo4j/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/neo4j/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Neo4j connection configuration types for AgentOS.
+ * @module @framers/agentos/neo4j/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/neo4j/types.js.map

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

package/dist/rag/VectorStoreManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VectorStoreManager.d.ts","sourceRoot":"","sources":["../../src/rag/VectorStoreManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EAGpB,MAAM,oCAAoC,CAAC;AAuB5C;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,oBAAoB,CAA4B;IACxD,OAAO,CAAC,kBAAkB,CAAoC;IAC9D,OAAO,CAAC,aAAa,CAAkB;IACvC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;IAE1C;;;OAGG;;IAOH;;OAEG;IACU,UAAU,CACrB,aAAa,EAAE,wBAAwB,EACvC,iBAAiB,EAAE,mBAAmB,EAAE,GACvC,OAAO,CAAC,IAAI,CAAC;IAoEhB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IAgC9B;;OAEG;IACI,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAapD;;OAEG;IACI,kBAAkB,IAAI,YAAY;IAmBzC;;OAEG;IACU,qBAAqB,CAChC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmB/E;;OAEG;IACI,eAAe,IAAI,MAAM,EAAE;IAKlC;;OAEG;IACI,iBAAiB,IAAI,MAAM,EAAE;IAKpC;;OAEG;IACU,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC;IA0DtF;;OAEG;IACU,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;CAmBnD"}
+{"version":3,"file":"VectorStoreManager.d.ts","sourceRoot":"","sources":["../../src/rag/VectorStoreManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EAGpB,MAAM,oCAAoC,CAAC;AAuB5C;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,oBAAoB,CAA4B;IACxD,OAAO,CAAC,kBAAkB,CAAoC;IAC9D,OAAO,CAAC,aAAa,CAAkB;IACvC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;IAE1C;;;OAGG;;IAOH;;OAEG;IACU,UAAU,CACrB,aAAa,EAAE,wBAAwB,EACvC,iBAAiB,EAAE,mBAAmB,EAAE,GACvC,OAAO,CAAC,IAAI,CAAC;IAoEhB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IA+B9B;;OAEG;IACI,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAapD;;OAEG;IACI,kBAAkB,IAAI,YAAY;IAmBzC;;OAEG;IACU,qBAAqB,CAChC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmB/E;;OAEG;IACI,eAAe,IAAI,MAAM,EAAE;IAKlC;;OAEG;IACI,iBAAiB,IAAI,MAAM,EAAE;IAKpC;;OAEG;IACU,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC;IA0DtF;;OAEG;IACU,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;CAmBnD"}

package/dist/rag/VectorStoreManager.js

@@ -138,13 +138,12 @@ export class VectorStoreManager {
             case 'qdrant':
                 // Qdrant vector store via HTTP (self-hosted or cloud)
                 return new QdrantVectorStore();
-            // case 'pinecone':
-            //   // Ensure PineconeVectorStoreConfig is imported and used
-            //   return new PineconeVectorStore();
-            // case 'weaviate':
-            //   // Ensure WeaviateVectorStoreConfig is imported and used
-            //   return new WeaviateVectorStore();
-            // Add cases for other supported vector store types
+            case 'neo4j':
+                // Neo4j vector store via native vector indexes (requires neo4j-driver)
+                // Dynamic import to keep neo4j-driver optional
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const { Neo4jVectorStore } = require('./implementations/vector_stores/Neo4jVectorStore');
+                return new Neo4jVectorStore();
             default:
                 throw new GMIError(`Unsupported vector store provider type: '${providerConfig.type}' for provider ID '${providerConfig.id}'.`, GMIErrorCode.NOT_SUPPORTED, { providerType: providerConfig.type, providerId: providerConfig.id });
         }

package/dist/rag/VectorStoreManager.js.map

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

package/dist/rag/graphrag/Neo4jGraphRAGEngine.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview Neo4j-backed GraphRAG engine for AgentOS.
+ *
+ * Implements `IGraphRAGEngine` using Neo4j for persistent entity/relationship/community
+ * storage, native HNSW vector indexes for entity/community semantic search, and
+ * GDS Louvain for community detection (with client-side graphology fallback).
+ *
+ * The entity extraction pipeline (LLM or pattern-based) is delegated to the caller
+ * or reused from the existing GraphRAGEngine's extraction utilities.
+ *
+ * Features:
+ * - Persistent graph storage in Neo4j
+ * - Native vector indexes on entity/community embeddings
+ * - GDS Louvain community detection (falls back to graphology if GDS unavailable)
+ * - Document contribution tracking for safe re-ingestion
+ * - Global search (community summaries) and local search (entity + 1-hop expansion)
+ * - Shared Neo4jConnectionManager for connection pooling
+ *
+ * @module @framers/agentos/rag/graphrag/Neo4jGraphRAGEngine
+ * @see ./IGraphRAG.ts for the interface definition.
+ */
+import type { IGraphRAGEngine, GraphRAGConfig, GraphEntity, GraphRelationship, GraphCommunity, GraphRAGSearchOptions, GlobalSearchResult, LocalSearchResult } from './IGraphRAG.js';
+import type { MetadataValue } from '../IVectorStore.js';
+import type { Neo4jConnectionManager } from '../../neo4j/Neo4jConnectionManager.js';
+interface LLMProvider {
+    generateText(prompt: string, options?: {
+        maxTokens?: number;
+        temperature?: number;
+    }): Promise<string>;
+}
+export interface Neo4jGraphRAGEngineDeps {
+    connectionManager: Neo4jConnectionManager;
+    embeddingManager?: {
+        generateEmbeddings(input: {
+            texts: string | string[];
+        }): Promise<{
+            embeddings: number[][];
+        }>;
+    };
+    llmProvider?: LLMProvider;
+}
+export declare class Neo4jGraphRAGEngine implements IGraphRAGEngine {
+    private deps;
+    private config;
+    private cypher;
+    private embeddingDimension;
+    private _isInitialized;
+    constructor(deps: Neo4jGraphRAGEngineDeps);
+    initialize(config: GraphRAGConfig): Promise<void>;
+    ingestDocuments(documents: Array<{
+        id: string;
+        content: string;
+        metadata?: Record<string, MetadataValue>;
+    }>): Promise<{
+        entitiesExtracted: number;
+        relationshipsExtracted: number;
+        communitiesDetected: number;
+        documentsProcessed: number;
+    }>;
+    removeDocuments(documentIds: string[]): Promise<{
+        documentsRemoved: number;
+        communitiesDetected: number;
+    }>;
+    globalSearch(query: string, options?: GraphRAGSearchOptions): Promise<GlobalSearchResult>;
+    localSearch(query: string, options?: GraphRAGSearchOptions): Promise<LocalSearchResult>;
+    getEntities(options?: {
+        type?: string;
+        limit?: number;
+    }): Promise<GraphEntity[]>;
+    getRelationships(entityId: string): Promise<GraphRelationship[]>;
+    getCommunities(level?: number): Promise<GraphCommunity[]>;
+    getStats(): Promise<{
+        totalEntities: number;
+        totalRelationships: number;
+        totalCommunities: number;
+        communityLevels: number;
+        documentsIngested: number;
+    }>;
+    clear(): Promise<void>;
+    shutdown(): Promise<void>;
+    private detectCommunities;
+    private detectCommunitiesGDS;
+    private detectCommunitiesClientSide;
+    private storeCommunities;
+    private extractEntitiesAndRelationships;
+    private extractViaLLM;
+    private extractViaPatterns;
+    private generateEntityEmbeddings;
+    private nodeToGraphEntity;
+    private nodeToCommunity;
+    private safeParseJson;
+    private simpleHash;
+}
+export {};
+//# sourceMappingURL=Neo4jGraphRAGEngine.d.ts.map

package/dist/rag/graphrag/Neo4jGraphRAGEngine.d.ts.map

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