agentdb 1.6.1 → 2.0.0-alpha.2

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/examples/README.md

@@ -0,0 +1,105 @@
+# AgentDB Examples
+
+Practical examples demonstrating how to use AgentDB programmatically.
+
+## Prerequisites
+
+```bash
+npm install agentdb@alpha
+```
+
+## Examples
+
+### 1. quickstart.js - Basic Usage
+
+Simple example showing database initialization and version checking.
+
+```bash
+node examples/quickstart.js
+```
+
+**What it demonstrates**:
+- Creating a database instance
+- Accessing package version
+- Basic error handling
+
+### 2. reflexion-memory.js _(Coming in alpha.3)_
+
+Store and retrieve episodic memories using the Reflexion pattern.
+
+**Features**:
+- Episode storage
+- Similarity-based retrieval
+- Pattern recognition
+
+### 3. skill-library.js _(Coming in alpha.3)_
+
+Manage reusable skills with version control.
+
+**Features**:
+- Skill storage
+- Version management
+- Skill retrieval
+
+### 4. causal-reasoning.js _(Coming in alpha.3)_
+
+Build causal graphs for explainable AI decisions.
+
+**Features**:
+- Causal edge creation
+- Counterfactual reasoning
+- Causal path queries
+
+## Current Limitations (Alpha.2)
+
+**Note**: The programmatic API is under active development. For alpha.2:
+
+1. **Use CLI for initialization**:
+   ```bash
+   npx agentdb@alpha init --db ./my-database.db
+   ```
+
+2. **Schemas not auto-created**: You must run `agentdb init` before using the database programmatically
+
+3. **Limited examples**: More comprehensive examples coming in alpha.3
+
+## Recommended Workflow (Alpha.2)
+
+### Step 1: Initialize via CLI
+```bash
+npx agentdb@alpha init --db ./agent-memory.db --dimensions 384
+```
+
+### Step 2: Use programmatically
+```javascript
+import { createDatabase } from 'agentdb';
+
+const db = await createDatabase('./agent-memory.db');
+// Database is ready to use
+```
+
+## Coming in Alpha.3
+
+- ✅ Auto-initialization: `AgentDB.create(config)` factory method
+- ✅ Complete examples for all features
+- ✅ TypeScript examples
+- ✅ Integration examples
+
+## Get Help
+
+- **Documentation**: https://github.com/ruvnet/agentic-flow/tree/main/packages/agentdb
+- **Issues**: https://github.com/ruvnet/agentic-flow/issues
+- **CLI Help**: `npx agentdb@alpha --help`
+
+## Contributing Examples
+
+Have a cool example? Submit a PR!
+
+1. Create your example in `/examples/your-example.js`
+2. Add documentation to this README
+3. Ensure it works with current alpha version
+4. Submit PR with description
+
+---
+
+**Note**: These examples are for AgentDB v2.0 alpha. The API may change before stable release.

package/examples/quickstart.js

@@ -0,0 +1,43 @@
+/**
+ * AgentDB Quickstart Example
+ *
+ * This example shows the recommended way to use AgentDB programmatically.
+ *
+ * Usage:
+ *   node examples/quickstart.js
+ */
+
+import { AgentDB } from 'agentdb';
+import { createDatabase } from 'agentdb';
+
+async function main() {
+  console.log('=== AgentDB Quickstart Example ===\n');
+
+  try {
+    // Method 1: Simple initialization
+    console.log('1. Creating AgentDB instance...');
+    const db = await createDatabase('./examples/quickstart.db');
+
+    // TODO: Auto-initialize schemas in future version
+    // For now, you need to run: agentdb init first
+    // This will be fixed in alpha.3
+
+    console.log('✓ Database created\n');
+
+    // For now, recommend using CLI for initialization:
+    console.log('Note: For alpha.2, please initialize via CLI first:');
+    console.log('  npx agentdb init --db ./examples/quickstart.db\n');
+
+    // Display package version
+    const packageJson = await import('agentdb/package.json', {
+      assert: { type: 'json' }
+    });
+    console.log(`AgentDB version: ${packageJson.default.version}`);
+
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "agentdb",
-  "version": "1.6.1",
-  "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.2",
+  "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",
   "bin": {
-    "agentdb": "dist/cli/agentdb-cli.js"
+    "agentdb": "dist/cli/agentdb-cli.js",
+    "agentdb-simulate": "dist/simulation/cli.js"
   },
   "exports": {
     ".": "./dist/index.js",
+    "./package.json": "./package.json",
     "./cli": "./dist/cli/agentdb-cli.js",
     "./controllers": "./dist/controllers/index.js",
     "./controllers/CausalMemoryGraph": "./dist/controllers/CausalMemoryGraph.js",
@@ -78,11 +80,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": {
@@ -98,6 +110,8 @@
   "files": [
     "dist",
     "src",
+    "simulation",
+    "examples",
     "scripts/postinstall.cjs",
     "README.md",
     "LICENSE"