agentdb 3.0.0-alpha.2 → 3.0.0-alpha.20

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentdb",
-  "version": "3.0.0-alpha.2",
-  "description": "AgentDB v3 - Intelligent agentic vector database with RVF native format, RuVector-powered graph DB, Cypher queries, ACID persistence. 150x faster than SQLite with self-learning GNN, 6 cognitive memory patterns, semantic routing, COW branching, and comprehensive MCP integration. Runs anywhere: Node.js, browsers, edge, offline.",
+  "version": "3.0.0-alpha.20",
+  "description": "Self-learning vector memory for AI agents — single-file .rvf cognitive container with HNSW search, episodic Reflexion memory, causal graph + Cypher, 9 RL algorithms, Thompson Sampling bandit, 41 MCP tools, hybrid (BM25 + dense) retrieval, GNN attention. 150x faster than SQLite. Up to +36% search quality from feedback. Runs in Node, browsers (WASM), edge, offline. Backs the agentic-flow / ruflo / Claude Code memory layer.",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -45,13 +45,18 @@
     "./controllers/QUICClient": "./dist/src/controllers/QUICClient.js",
     "./controllers/SyncCoordinator": "./dist/src/controllers/SyncCoordinator.js",
     "./controllers/HNSWIndex": "./dist/src/controllers/HNSWIndex.js",
-    "./controllers/AttentionService": "./dist/src/controllers/AttentionService.js"
+    "./controllers/AttentionService": "./dist/src/controllers/AttentionService.js",
+    "./controllers/SparsificationService": "./dist/src/controllers/SparsificationService.js",
+    "./controllers/MincutService": "./dist/src/controllers/MincutService.js",
+    "./services/federated-learning": "./dist/src/services/federated-learning.js",
+    "./model": "./dist/src/model/ModelCacheLoader.js"
   },
   "scripts": {
     "build": "npm run build:ts && npm run copy:schemas && npm run build:browser",
     "build:ts": "tsc",
     "copy:schemas": "mkdir -p dist/schemas && cp src/schemas/*.sql dist/schemas/",
-    "build:browser": "node scripts/build-browser.js",
+    "build:browser": "node scripts/build-browser.js && node scripts/build-browser-v2.js",
+    "build:edge": "node scripts/build-browser.config.js",
     "build:napi": "bash scripts/optimize-napi.sh",
     "build:wasm": "bash scripts/optimize-wasm.sh",
     "build:optimized": "npm run build:napi && npm run build:wasm && npm run build",
@@ -60,7 +65,8 @@
     "test": "vitest",
     "test:unit": "vitest --run",
     "test:browser": "vitest browser-bundle-unit.test.js --run",
-    "test:ci": "npm run test:browser && npm run build && npm run verify:bundle",
+    "test:ci": "npm run test:unit && npm run test:browser && npm run build && npm run verify:bundle && npm run test:mcp-stdio",
+    "test:mcp-stdio": "node tests/mcp-stdio-purity.mjs",
     "verify:bundle": "node scripts/verify-bundle.js",
     "cli": "node dist/src/cli/agentdb-cli.js",
     "docker:test": "docker build -f docs/SQLITE-FIX-DOCKER-TEST.Dockerfile -t agentdb-test . && docker run --rm agentdb-test",
@@ -71,49 +77,105 @@
     "benchmark:backends": "tsx benchmarks/compare-backends.ts",
     "benchmark:profile": "tsx scripts/profile-hot-paths.ts",
     "benchmark:ruvector": "tsx benchmarks/ruvector-benchmark.ts",
-    "benchmark:all": "npm run benchmark:attention && npm run benchmark:backends && npm run benchmark:profile && npm run benchmark:ruvector"
+    "benchmark:adr072": "vitest run tests/benchmarks/adr-072-phase1-benchmark.test.ts --reporter=verbose",
+    "benchmark:adr072:fast": "vitest run tests/benchmarks/validate-adr072.test.ts",
+    "benchmark:all": "npm run benchmark:attention && npm run benchmark:backends && npm run benchmark:profile && npm run benchmark:ruvector",
+    "build:model": "node scripts/build-model-rvf.mjs",
+    "prebuild": "node scripts/inline-schemas.mjs"
   },
   "keywords": [
     "agentdb",
     "vector-database",
+    "vector-store",
+    "vector-search",
     "ai-agents",
+    "agent-memory",
+    "agentic-ai",
+    "agentic",
+    "agent-database",
     "memory",
+    "self-learning",
+    "self-improving",
+    "reinforcement-learning",
+    "rl",
+    "thompson-sampling",
+    "bandit",
     "causal-reasoning",
+    "causal-graph",
     "reflexion",
     "episodic-memory",
     "skill-library",
     "lifelong-learning",
     "explainable-ai",
+    "explainable-recall",
     "provenance",
+    "audit-log",
     "hnsw",
+    "knn",
+    "ann",
     "embeddings",
+    "embedding-search",
+    "semantic-search",
+    "hybrid-search",
+    "bm25",
+    "rrf",
+    "rag",
+    "retrieval-augmented-generation",
+    "cypher",
+    "graph-database",
+    "knowledge-graph",
+    "gnn",
+    "attention",
+    "mmr",
+    "rerank",
     "sqlite",
     "sql.js",
-    "wasm"
+    "wasm",
+    "edge",
+    "browser",
+    "offline-first",
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "claude-code-plugin",
+    "anthropic",
+    "llm-memory",
+    "llm-tools",
+    "agent-orchestration",
+    "agentic-flow",
+    "ruflo",
+    "ruvector",
+    "rust",
+    "napi",
+    "typescript"
   ],
   "author": "ruv",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ruvnet/agentic-flow.git",
-    "directory": "packages/agentdb"
+    "url": "git+https://github.com/ruvnet/agentdb.git"
   },
   "bugs": {
-    "url": "https://github.com/ruvnet/agentic-flow/issues"
+    "url": "https://github.com/ruvnet/agentdb/issues"
   },
-  "homepage": "https://agentdb.ruv.io",
+  "homepage": "https://github.com/ruvnet/agentdb#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.1",
     "@opentelemetry/api": "^1.9.0",
+    "@ruvector/graph-transformer": "^2.0.4",
     "ajv": "^8.18.0",
     "jsonwebtoken": "^9.0.2",
     "sql.js": "^1.13.0"
   },
   "devDependencies": {
+    "@playwright/test": "^1.58.2",
     "@types/jsonwebtoken": "^9.0.10",
     "@types/node": "^22.10.2",
+    "@types/uuid": "^11.0.0",
     "dotenv": "^16.4.7",
     "esbuild": "^0.25.11",
+    "http-server": "^14.1.1",
+    "playwright": "^1.58.2",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^4.0.15"
@@ -124,37 +186,44 @@
   "files": [
     "dist/src/",
     "dist/schemas/",
+    "dist/models/",
     "scripts/postinstall.cjs",
     "README.md",
     "LICENSE"
   ],
   "optionalDependencies": {
     "@opentelemetry/resources": "^1.25.0",
-    "@opentelemetry/sdk-node": "^0.52.0",
+    "@opentelemetry/sdk-node": "^0.218.0",
     "@opentelemetry/semantic-conventions": "^1.25.0",
     "@ruvector/attention": "^0.1.2",
     "@ruvector/gnn": "^0.1.23",
     "@ruvector/graph-node": "^2.0.2",
     "@ruvector/router": "^0.1.15",
     "@ruvector/ruvllm": "^2.5.1",
-    "@ruvector/rvf": "^0.1.9",
+    "@ruvector/rvf": "^0.2.3",
     "@ruvector/rvf-node": "^0.1.7",
     "@ruvector/rvf-solver": "^0.1.7",
     "@ruvector/rvf-wasm": "^0.1.6",
     "@ruvector/sona": "^0.1.4",
-    "@xenova/transformers": "^2.17.2",
+    "@huggingface/transformers": "^4.2.0",
     "argon2": "^0.44.0",
     "better-sqlite3": "^11.8.1",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "hnswlib-node": "^3.0.0",
     "inquirer": "^9.3.8",
-    "ruvector": "^0.1.30",
-    "ruvector-attention-wasm": "^0.1.0"
+    "ruvector": "^0.2.40",
+    "ruvector-attention-wasm": "^0.1.32",
+    "ruvector-graph-transformer-wasm": "^2.0.4"
   },
   "overrides": {
-    "@xenova/transformers": {
-      "sharp": "^0.33.0"
+    "@ruvector/ruvllm-darwin-arm64": "2.0.1",
+    "@ruvector/ruvllm-darwin-x64": "2.0.1",
+    "@ruvector/ruvllm-linux-arm64-gnu": "2.0.1",
+    "@ruvector/ruvllm-linux-x64-gnu": "2.0.1",
+    "@ruvector/ruvllm-win32-x64-msvc": "2.0.1",
+    "@huggingface/transformers": {
+      "sharp": "^0.34.5"
     }
   }
 }

package/scripts/postinstall.cjs

@@ -1,161 +1,30 @@
 #!/usr/bin/env node
 /**
  * AgentDB Post-Install Script
- * Handles better-sqlite3 installation in various environments
+ * Verifies sql.js (WASM SQLite) is available — no native compilation needed.
  */
 
-const { execSync } = require('child_process');
-const { existsSync } = require('fs');
-const { join } = require('path');
-
-const packageRoot = join(__dirname, '..');
-
-/**
- * Check if better-sqlite3 is properly installed
- */
-function checkBetterSqlite3() {
-  try {
-    // Try to require better-sqlite3
-    const Database = require('better-sqlite3');
-    const db = new Database(':memory:');
-    db.close();
-    console.log('✅ better-sqlite3 is working correctly');
-    return true;
-  } catch (error) {
-    console.warn('⚠️  better-sqlite3 native binding issue:', (error && error.message) || 'unknown');
-    return false;
-  }
-}
-
-/**
- * Attempt to rebuild better-sqlite3
- */
-function rebuildBetterSqlite3() {
-  console.log('🔧 Attempting to rebuild better-sqlite3...');
-
-  try {
-    // Try to rebuild
-    execSync('npm rebuild better-sqlite3', {
-      cwd: packageRoot,
-      stdio: 'inherit',
-      env: Object.assign({}, process.env, { npm_config_build_from_source: 'true' })
-    });
-
-    if (checkBetterSqlite3()) {
-      console.log('✅ Rebuild successful');
-      return true;
-    }
-  } catch (error) {
-    console.warn('⚠️  Rebuild failed:', (error && error.message) || 'unknown');
-  }
-
-  return false;
-}
-
-/**
- * Check for required build tools
- */
-function checkBuildTools() {
-  const tools = {
-    python: ['python3 --version', 'python --version'],
-    make: ['make --version'],
-    compiler: ['g++ --version', 'clang++ --version', 'cl /?']
-  };
-
-  const available = {};
-
-  for (const name in tools) {
-    const commands = tools[name];
-    available[name] = false;
-    for (let i = 0; i < commands.length; i++) {
-      try {
-        execSync(commands[i], { stdio: 'ignore' });
-        available[name] = true;
-        break;
-      } catch (error) {
-        // Continue trying other commands
-      }
-    }
-  }
-
-  return available;
-}
-
-/**
- * Provide installation guidance
- */
-function provideGuidance() {
-  console.log('\n📋 Installation Guidance for better-sqlite3:\n');
-
-  const buildTools = checkBuildTools();
-
-  if (!buildTools.python) {
-    console.log('❌ Python not found. Install Python 3:');
-    console.log('   - Ubuntu/Debian: sudo apt-get install python3');
-    console.log('   - Alpine: apk add python3');
-    console.log('   - macOS: brew install python3');
-    console.log('   - Windows: https://www.python.org/downloads/\n');
-  }
-
-  if (!buildTools.make) {
-    console.log('❌ Make not found. Install build tools:');
-    console.log('   - Ubuntu/Debian: sudo apt-get install build-essential');
-    console.log('   - Alpine: apk add make');
-    console.log('   - macOS: xcode-select --install');
-    console.log('   - Windows: npm install --global windows-build-tools\n');
-  }
-
-  if (!buildTools.compiler) {
-    console.log('❌ C++ compiler not found. Install compiler:');
-    console.log('   - Ubuntu/Debian: sudo apt-get install g++');
-    console.log('   - Alpine: apk add g++');
-    console.log('   - macOS: xcode-select --install');
-    console.log('   - Windows: Install Visual Studio Build Tools\n');
-  }
-
-  console.log('📚 For Docker environments, use this base setup:');
-  console.log('   Alpine: apk add --no-cache python3 make g++ sqlite sqlite-dev');
-  console.log('   Ubuntu: apt-get install -y python3 make g++ sqlite3 libsqlite3-dev\n');
-
-  console.log('🔗 More info: https://github.com/WiseLibs/better-sqlite3/blob/master/docs/troubleshooting.md\n');
-}
-
-/**
- * Main installation check
- */
 function main() {
-  console.log('🔍 Verifying AgentDB installation...\n');
-
   // Skip in CI environments or if explicitly disabled
   if (process.env.CI || process.env.AGENTDB_SKIP_POSTINSTALL === 'true') {
-    console.log('ℹ️  Skipping post-install checks (CI environment)');
     return;
   }
 
-  // Check if better-sqlite3 is working
-  if (checkBetterSqlite3()) {
-    console.log('✅ AgentDB installation successful!\n');
-    return;
+  // Verify core dependency: sql.js
+  try {
+    require('sql.js');
+    console.log('[agentdb] sql.js (WASM SQLite): OK');
+  } catch {
+    console.error('[agentdb] sql.js not found — run: npm install sql.js');
   }
 
-  // Try to rebuild
-  console.log('⚠️  Detected potential installation issue. Attempting automatic fix...\n');
-
-  if (rebuildBetterSqlite3()) {
-    console.log('✅ AgentDB installation fixed!\n');
-    return;
+  // Check optional deps without failing
+  try {
+    require('better-sqlite3');
+    console.log('[agentdb] better-sqlite3: available (optional)');
+  } catch {
+    console.log('[agentdb] better-sqlite3: not installed (optional, sql.js used)');
   }
-
-  // Provide guidance
-  console.log('⚠️  Could not automatically fix installation.\n');
-  provideGuidance();
-
-  console.log('💡 If you continue to have issues, please report at:');
-  console.log('   https://github.com/ruvnet/agentic-flow/issues\n');
-
-  // Don't fail the installation - allow it to proceed
-  // Users can still use sql.js fallback if needed
 }
 
-// Run post-install check
 main();

package/dist/src/cli/tests/agentdb-cli.test.d.ts

@@ -1,8 +0,0 @@
-/**
- * AgentDB CLI Tests
- *
- * Tests main CLI entry point, command routing, and help system.
- * Targets >90% CLI coverage.
- */
-export {};
-//# sourceMappingURL=agentdb-cli.test.d.ts.map

package/dist/src/cli/tests/agentdb-cli.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentdb-cli.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/tests/agentdb-cli.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/src/cli/tests/agentdb-cli.test.js

@@ -1,50 +0,0 @@
-/**
- * AgentDB CLI Tests
- *
- * Tests main CLI entry point, command routing, and help system.
- * Targets >90% CLI coverage.
- */
-import { describe, it, expect } from 'vitest';
-describe('AgentDB CLI', () => {
-    describe('Command Structure', () => {
-        it('should be defined', () => {
-            // Basic smoke test - CLI infrastructure test
-            expect(true).toBe(true);
-        });
-        it('should support simulate command', () => {
-            // Test simulate command availability
-            expect(true).toBe(true);
-        });
-        it('should support wizard command', () => {
-            // Test wizard command availability
-            expect(true).toBe(true);
-        });
-    });
-    describe('Help System', () => {
-        it('should display main help', () => {
-            // Test --help flag
-            expect(true).toBe(true);
-        });
-        it('should display command-specific help', () => {
-            // Test simulate --help
-            expect(true).toBe(true);
-        });
-    });
-    describe('Version', () => {
-        it('should display version', () => {
-            // Test --version flag
-            expect(true).toBe(true);
-        });
-    });
-    describe('Error Handling', () => {
-        it('should handle unknown commands', () => {
-            // Test invalid command
-            expect(true).toBe(true);
-        });
-        it('should handle missing arguments', () => {
-            // Test missing required args
-            expect(true).toBe(true);
-        });
-    });
-});
-//# sourceMappingURL=agentdb-cli.test.js.map

package/dist/src/cli/tests/agentdb-cli.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentdb-cli.test.js","sourceRoot":"","sources":["../../../../src/cli/tests/agentdb-cli.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;YAC3B,6CAA6C;YAC7C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,qCAAqC;YACrC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,mCAAmC;YACnC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,mBAAmB;YACnB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,uBAAuB;YACvB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,sBAAsB;YACtB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,uBAAuB;YACvB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,6BAA6B;YAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/cli/tests/attention-cli.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Tests for Attention CLI Commands
- */
-export {};
-//# sourceMappingURL=attention-cli.test.d.ts.map

package/dist/src/cli/tests/attention-cli.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attention-cli.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/tests/attention-cli.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}