agentdb 1.6.0 → 2.0.0-alpha.1

package/dist/src/types/quic.js

@@ -0,0 +1,272 @@
+/**
+ * QUIC Synchronization Types for AgentDB
+ *
+ * This file contains TypeScript interfaces and types for the QUIC-based
+ * multi-node synchronization system. These types mirror the Protocol Buffer
+ * definitions and provide type safety for the sync implementation.
+ */
+// ============================================================================
+// Episode Synchronization
+// ============================================================================
+/**
+ * Supported operations for episode sync
+ */
+export var EpisodeSyncOperation;
+(function (EpisodeSyncOperation) {
+    EpisodeSyncOperation["CREATE"] = "CREATE";
+    EpisodeSyncOperation["UPDATE"] = "UPDATE";
+    EpisodeSyncOperation["DELETE"] = "DELETE";
+})(EpisodeSyncOperation || (EpisodeSyncOperation = {}));
+/**
+ * User roles
+ */
+export var UserRole;
+(function (UserRole) {
+    UserRole["ADMIN"] = "admin";
+    UserRole["AGENT"] = "agent";
+    UserRole["OBSERVER"] = "observer";
+    UserRole["LEARNER"] = "learner";
+})(UserRole || (UserRole = {}));
+// ============================================================================
+// Configuration
+// ============================================================================
+/**
+ * Network topology types
+ */
+export var NetworkTopology;
+(function (NetworkTopology) {
+    NetworkTopology["HUB_AND_SPOKE"] = "hub_and_spoke";
+    NetworkTopology["MESH"] = "mesh";
+    NetworkTopology["HIERARCHICAL"] = "hierarchical";
+})(NetworkTopology || (NetworkTopology = {}));
+/**
+ * Conflict resolution strategies
+ */
+export var ConflictResolutionStrategy;
+(function (ConflictResolutionStrategy) {
+    ConflictResolutionStrategy["AUTO"] = "auto";
+    ConflictResolutionStrategy["MANUAL"] = "manual";
+    ConflictResolutionStrategy["INTERACTIVE"] = "interactive"; // Prompt user for resolution
+})(ConflictResolutionStrategy || (ConflictResolutionStrategy = {}));
+/**
+ * Sync mode
+ */
+export var SyncMode;
+(function (SyncMode) {
+    SyncMode["INCREMENTAL"] = "incremental";
+    SyncMode["FULL"] = "full";
+    SyncMode["HYBRID"] = "hybrid";
+})(SyncMode || (SyncMode = {}));
+// ============================================================================
+// Helper Functions (Type Guards & Utilities)
+// ============================================================================
+/**
+ * Type guard for episode sync
+ */
+export function isEpisodeSync(payload) {
+    return payload.type === 'episode_sync';
+}
+/**
+ * Type guard for skill sync
+ */
+export function isSkillSync(payload) {
+    return payload.type === 'skill_sync';
+}
+/**
+ * Type guard for causal edge sync
+ */
+export function isCausalEdgeSync(payload) {
+    return payload.type === 'causal_edge_sync';
+}
+/**
+ * Compare two vector clocks
+ */
+export function compareVectorClocks(a, b) {
+    const allNodes = new Set([...a.clocks.keys(), ...b.clocks.keys()]);
+    let aGreater = false;
+    let bGreater = false;
+    for (const node of allNodes) {
+        const aClock = a.clocks.get(node) || 0;
+        const bClock = b.clocks.get(node) || 0;
+        if (aClock > bClock)
+            aGreater = true;
+        if (bClock > aClock)
+            bGreater = true;
+    }
+    if (aGreater && !bGreater)
+        return 'after';
+    if (bGreater && !aGreater)
+        return 'before';
+    if (!aGreater && !bGreater)
+        return 'equal';
+    return 'concurrent';
+}
+/**
+ * Merge two vector clocks (take max of each node)
+ */
+export function mergeVectorClocks(a, b) {
+    const merged = new Map(a.clocks);
+    for (const [node, clock] of b.clocks) {
+        const existingClock = merged.get(node) || 0;
+        merged.set(node, Math.max(existingClock, clock));
+    }
+    return { clocks: merged };
+}
+/**
+ * Increment vector clock for local node
+ */
+export function incrementVectorClock(clock, nodeId) {
+    const newClocks = new Map(clock.clocks);
+    const currentClock = newClocks.get(nodeId) || 0;
+    newClocks.set(nodeId, currentClock + 1);
+    return { clocks: newClocks };
+}
+/**
+ * Create empty vector clock
+ */
+export function createVectorClock() {
+    return { clocks: new Map() };
+}
+// ============================================================================
+// CRDT Operations
+// ============================================================================
+/**
+ * Increment G-Counter for a node
+ */
+export function incrementGCounter(counter, nodeId, delta = 1) {
+    const newCounters = new Map(counter.nodeCounters);
+    const current = newCounters.get(nodeId) || 0;
+    newCounters.set(nodeId, current + delta);
+    return { nodeCounters: newCounters };
+}
+/**
+ * Get total value of G-Counter
+ */
+export function getGCounterValue(counter) {
+    return Array.from(counter.nodeCounters.values()).reduce((sum, count) => sum + count, 0);
+}
+/**
+ * Merge two G-Counters (take max per node)
+ */
+export function mergeGCounter(a, b) {
+    const merged = new Map(a.nodeCounters);
+    for (const [nodeId, count] of b.nodeCounters) {
+        const existingCount = merged.get(nodeId) || 0;
+        merged.set(nodeId, Math.max(existingCount, count));
+    }
+    return { nodeCounters: merged };
+}
+/**
+ * Update LWW-Register with new value
+ */
+export function updateLWWRegister(register, newValue, nodeId, timestamp = Date.now()) {
+    if (timestamp > register.timestamp ||
+        (timestamp === register.timestamp && nodeId > register.nodeId)) {
+        return { value: newValue, timestamp, nodeId };
+    }
+    return register;
+}
+/**
+ * Merge two LWW-Registers (keep most recent)
+ */
+export function mergeLWWRegister(a, b) {
+    if (b.timestamp > a.timestamp) {
+        return b;
+    }
+    else if (b.timestamp === a.timestamp) {
+        return b.nodeId > a.nodeId ? b : a;
+    }
+    return a;
+}
+/**
+ * Add element to OR-Set
+ */
+export function addToORSet(set, element, uniqueTag) {
+    const newAdds = new Map(set.adds);
+    if (!newAdds.has(element)) {
+        newAdds.set(element, new Set());
+    }
+    newAdds.get(element).add(uniqueTag);
+    return { adds: newAdds, removes: set.removes };
+}
+/**
+ * Remove element from OR-Set
+ */
+export function removeFromORSet(set, element) {
+    const tags = set.adds.get(element);
+    if (!tags)
+        return set;
+    const newRemoves = new Set(set.removes);
+    tags.forEach(tag => newRemoves.add(tag));
+    return { adds: set.adds, removes: newRemoves };
+}
+/**
+ * Get current elements in OR-Set
+ */
+export function getORSetElements(set) {
+    const elements = new Set();
+    for (const [element, tags] of set.adds) {
+        // Check if any tag is not in removes
+        for (const tag of tags) {
+            if (!set.removes.has(tag)) {
+                elements.add(element);
+                break;
+            }
+        }
+    }
+    return elements;
+}
+/**
+ * Merge two OR-Sets
+ */
+export function mergeORSet(a, b) {
+    const mergedAdds = new Map();
+    const mergedRemoves = new Set([...a.removes, ...b.removes]);
+    // Merge adds from both sets
+    const allElements = new Set([...a.adds.keys(), ...b.adds.keys()]);
+    for (const element of allElements) {
+        const aTags = a.adds.get(element) || new Set();
+        const bTags = b.adds.get(element) || new Set();
+        const mergedTags = new Set([...aTags, ...bTags]);
+        // Remove tags that are in removes set
+        for (const tag of mergedTags) {
+            if (mergedRemoves.has(tag)) {
+                mergedTags.delete(tag);
+            }
+        }
+        if (mergedTags.size > 0) {
+            mergedAdds.set(element, mergedTags);
+        }
+    }
+    return { adds: mergedAdds, removes: mergedRemoves };
+}
+// ============================================================================
+// Conflict Resolution Helpers
+// ============================================================================
+/**
+ * Weighted average for numeric conflict resolution
+ */
+export function weightedAverage(v1, w1, v2, w2) {
+    if (w1 + w2 === 0)
+        return 0;
+    return (v1 * w1 + v2 * w2) / (w1 + w2);
+}
+/**
+ * Determine authorization for operation
+ */
+export function isAuthorized(jwt, requiredScope) {
+    return jwt.scopes.includes(requiredScope);
+}
+/**
+ * Check if JWT is expired
+ */
+export function isJWTExpired(jwt) {
+    return Date.now() >= jwt.exp * 1000;
+}
+/**
+ * Generate unique tag for OR-Set operations
+ */
+export function generateUniqueTag(nodeId, timestamp = Date.now()) {
+    return `${nodeId}-${timestamp}-${Math.random().toString(36).substr(2, 9)}`;
+}
+//# sourceMappingURL=quic.js.map

package/dist/src/types/quic.js.map

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

package/dist/src/utils/NodeIdMapper.d.ts

@@ -0,0 +1,38 @@
+/**
+ * NodeIdMapper - Maps numeric episode IDs to full graph node IDs
+ *
+ * Solves the issue where ReflexionMemory.storeEpisode() returns numeric IDs
+ * but GraphDatabaseAdapter edges need full string node IDs (e.g., "episode-123456")
+ */
+export declare class NodeIdMapper {
+    private static instance;
+    private numericToNode;
+    private nodeToNumeric;
+    private constructor();
+    static getInstance(): NodeIdMapper;
+    /**
+     * Register a mapping between numeric ID and full node ID
+     */
+    register(numericId: number, nodeId: string): void;
+    /**
+     * Get full node ID from numeric ID
+     */
+    getNodeId(numericId: number): string | undefined;
+    /**
+     * Get numeric ID from full node ID
+     */
+    getNumericId(nodeId: string): number | undefined;
+    /**
+     * Clear all mappings (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get statistics about mappings
+     */
+    getStats(): {
+        totalMappings: number;
+        numericIds: number;
+        nodeIds: number;
+    };
+}
+//# sourceMappingURL=NodeIdMapper.d.ts.map

package/dist/src/utils/NodeIdMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeIdMapper.d.ts","sourceRoot":"","sources":["../../../src/utils/NodeIdMapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IACpD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,aAAa,CAA6B;IAElD,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKjD;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIhD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAO3E"}

package/dist/src/utils/NodeIdMapper.js

@@ -0,0 +1,57 @@
+/**
+ * NodeIdMapper - Maps numeric episode IDs to full graph node IDs
+ *
+ * Solves the issue where ReflexionMemory.storeEpisode() returns numeric IDs
+ * but GraphDatabaseAdapter edges need full string node IDs (e.g., "episode-123456")
+ */
+export class NodeIdMapper {
+    static instance = null;
+    numericToNode = new Map();
+    nodeToNumeric = new Map();
+    constructor() {
+        // Private constructor for singleton pattern
+    }
+    static getInstance() {
+        if (!NodeIdMapper.instance) {
+            NodeIdMapper.instance = new NodeIdMapper();
+        }
+        return NodeIdMapper.instance;
+    }
+    /**
+     * Register a mapping between numeric ID and full node ID
+     */
+    register(numericId, nodeId) {
+        this.numericToNode.set(numericId, nodeId);
+        this.nodeToNumeric.set(nodeId, numericId);
+    }
+    /**
+     * Get full node ID from numeric ID
+     */
+    getNodeId(numericId) {
+        return this.numericToNode.get(numericId);
+    }
+    /**
+     * Get numeric ID from full node ID
+     */
+    getNumericId(nodeId) {
+        return this.nodeToNumeric.get(nodeId);
+    }
+    /**
+     * Clear all mappings (useful for testing)
+     */
+    clear() {
+        this.numericToNode.clear();
+        this.nodeToNumeric.clear();
+    }
+    /**
+     * Get statistics about mappings
+     */
+    getStats() {
+        return {
+            totalMappings: this.numericToNode.size,
+            numericIds: this.numericToNode.size,
+            nodeIds: this.nodeToNumeric.size
+        };
+    }
+}
+//# sourceMappingURL=NodeIdMapper.js.map

package/dist/src/utils/NodeIdMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeIdMapper.js","sourceRoot":"","sources":["../../../src/utils/NodeIdMapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,QAAQ,GAAwB,IAAI,CAAC;IAC5C,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD;QACE,4CAA4C;IAC9C,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,YAAY,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB,EAAE,MAAc;QACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAc;QACzB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;YACtC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;YACnC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;SACjC,CAAC;IACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentdb",
-  "version": "1.6.0",
-  "description": "AgentDB - Frontier Memory Features with MCP Integration and Direct Vector Search: Causal reasoning, reflexion memory, skill library, automated learning, and raw vector similarity queries. 150x faster vector search. Full Claude Desktop support via Model Context Protocol.",
+  "version": "2.0.0-alpha.1",
+  "description": "AgentDB v2 - RuVector-powered graph database with Cypher queries, hyperedges, and ACID persistence. 150x faster than SQLite with integrated vector search, GNN learning, semantic routing, and comprehensive memory patterns. Includes reflexion memory, skill library, causal reasoning, and MCP integration.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,7 +26,8 @@
     "./controllers/MetadataFilter": "./dist/controllers/MetadataFilter.js",
     "./controllers/QUICServer": "./dist/controllers/QUICServer.js",
     "./controllers/QUICClient": "./dist/controllers/QUICClient.js",
-    "./controllers/SyncCoordinator": "./dist/controllers/SyncCoordinator.js"
+    "./controllers/SyncCoordinator": "./dist/controllers/SyncCoordinator.js",
+    "./controllers/HNSWIndex": "./dist/controllers/HNSWIndex.js"
   },
   "scripts": {
     "build": "npm run build:ts && npm run copy:schemas && npm run build:browser",
@@ -77,10 +78,21 @@
   "homepage": "https://agentdb.ruv.io",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.1",
+    "@ruvector/graph-node": "^0.1.15",
+    "@ruvector/router": "^0.1.15",
     "@xenova/transformers": "^2.17.2",
+    "ajv": "^8.17.1",
     "chalk": "^5.3.0",
+    "cli-table3": "^0.6.0",
     "commander": "^12.1.0",
+    "hnswlib-node": "^3.0.0",
+    "inquirer": "^9.3.8",
+    "marked-terminal": "^6.0.0",
+    "ora": "^7.0.0",
+    "ruvector": "^0.1.24",
     "sql.js": "^1.13.0",
+    "sqlite": "^5.1.1",
+    "sqlite3": "^5.1.7",
     "zod": "^3.25.76"
   },
   "devDependencies": {