agentdb 3.0.0-alpha.8 → 3.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentdb",
-  "version": "3.0.0-alpha.8",
-  "description": "AgentDB v3 — Proof-gated graph intelligence for AI agents. Every state mutation requires cryptographic proof. Native Rust performance via @ruvector/graph-transformer with 8 verified graph modules, HNSW search, causal reasoning, and reflexion memory.",
+  "version": "3.0.0",
+  "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",
@@ -10,33 +10,29 @@
   },
   "exports": {
     ".": {
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js",
-      "require": "./dist/src/index.cjs",
       "default": "./dist/src/index.js"
     },
+    "./wasm": "./dist/src/wasm-loader.js",
     "./package.json": "./package.json",
-    "./cli": "./dist/cli/agentdb-cli.js",
-    "./controllers": {
-      "import": "./dist/src/controllers/index.js",
-      "require": "./dist/src/controllers/index.cjs",
-      "default": "./dist/src/controllers/index.js"
-    },
-    "./backends": {
-      "import": "./dist/src/backends/index.js",
-      "require": "./dist/src/backends/index.cjs",
-      "default": "./dist/src/backends/index.js"
-    },
-    "./security": {
-      "import": "./dist/src/security/index.js",
-      "require": "./dist/src/security/index.cjs",
-      "default": "./dist/src/security/index.js"
-    },
+    "./cli": "./dist/src/cli/agentdb-cli.js",
+    "./cli/commands/migrate": "./dist/src/cli/commands/migrate.js",
+    "./db-fallback": "./dist/src/db-fallback.js",
+    "./backends": "./dist/src/backends/index.js",
+    "./backends/self-learning": "./dist/src/backends/rvf/SelfLearningRvfBackend.js",
+    "./backends/native-accelerator": "./dist/src/backends/rvf/NativeAccelerator.js",
+    "./security": "./dist/src/security/input-validation.js",
+    "./wrappers": "./dist/src/wrappers/index.js",
+    "./wrappers/gnn": "./dist/src/wrappers/gnn-wrapper.js",
+    "./wrappers/agentdb-fast": "./dist/src/wrappers/agentdb-fast.js",
+    "./wrappers/attention": "./dist/src/wrappers/attention-fallbacks.js",
+    "./wrappers/embedding": "./dist/src/wrappers/embedding-service.js",
+    "./controllers": "./dist/src/controllers/index.js",
     "./controllers/CausalMemoryGraph": "./dist/src/controllers/CausalMemoryGraph.js",
     "./controllers/CausalRecall": "./dist/src/controllers/CausalRecall.js",
     "./controllers/ExplainableRecall": "./dist/src/controllers/ExplainableRecall.js",
     "./controllers/NightlyLearner": "./dist/src/controllers/NightlyLearner.js",
-    "./controllers/LearningSystem": "./dist/src/controllers/LearningSystem.js",
-    "./controllers/ReasoningBank": "./dist/src/controllers/ReasoningBank.js",
     "./controllers/ReflexionMemory": "./dist/src/controllers/ReflexionMemory.js",
     "./controllers/SkillLibrary": "./dist/src/controllers/SkillLibrary.js",
     "./controllers/EmbeddingService": "./dist/src/controllers/EmbeddingService.js",
@@ -49,14 +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 build:cjs && npm run copy:schemas && npm run build:browser",
+    "build": "npm run build:ts && npm run copy:schemas && npm run build:browser",
     "build:ts": "tsc",
-    "build:cjs": "node scripts/build-cjs.js",
     "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",
@@ -65,9 +65,10 @@
     "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/cli/agentdb-cli.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",
     "benchmark": "tsx benchmarks/simple-benchmark.ts",
     "benchmark:full": "tsx benchmarks/benchmark-runner.ts",
@@ -75,100 +76,149 @@
     "benchmark:attention": "tsx benchmarks/attention-performance.ts",
     "benchmark:backends": "tsx benchmarks/compare-backends.ts",
     "benchmark:profile": "tsx scripts/profile-hot-paths.ts",
-    "benchmark:all": "npm run benchmark:attention && npm run benchmark:backends && npm run benchmark:profile"
+    "benchmark:ruvector": "tsx benchmarks/ruvector-benchmark.ts",
+    "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",
-    "proof-gated",
-    "graph-transformer",
-    "attestation",
-    "verified-training",
-    "causal-attention",
-    "mutation-guard"
+    "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"
-  },
-  "homepage": "https://agentdb.ruv.io",
-  "peerDependencies": {
-    "@xenova/transformers": "^2.17.2",
-    "better-sqlite3": "^11.8.1",
-    "sqlite3": "^5.1.7"
-  },
-  "peerDependenciesMeta": {
-    "@xenova/transformers": {
-      "optional": true
-    },
-    "better-sqlite3": {
-      "optional": true
-    },
-    "sqlite3": {
-      "optional": true
-    }
+    "url": "https://github.com/ruvnet/agentdb/issues"
   },
+  "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.17.1",
-    "ruvector": "^0.1.99",
-    "sql.js": "^1.13.0",
-    "zod": "^3.25.76"
-  },
-  "optionalDependencies": {
-    "@ruvector/attention": "^0.1.31",
-    "@ruvector/gnn": "^0.1.24",
-    "@ruvector/graph-node": "^2.0.2",
-    "@ruvector/router": "^0.1.28",
-    "@ruvector/sona": "^0.1.5",
-    "chalk": "^5.3.0",
-    "cli-table3": "^0.6.0",
-    "commander": "^12.1.0",
-    "dotenv": "^16.4.7",
-    "hnswlib-node": "^3.0.0",
-    "inquirer": "^9.3.8",
-    "marked-terminal": "^6.0.0",
-    "ora": "^7.0.0",
-    "ruvector-attention-wasm": "^0.1.0",
-    "ruvector-graph-transformer-wasm": "^2.0.4",
-    "sqlite": "^5.1.1"
+    "ajv": "^8.18.0",
+    "sql.js": "^1.13.0"
   },
   "devDependencies": {
+    "@playwright/test": "^1.58.2",
     "@types/node": "^22.10.2",
-    "@xenova/transformers": "^2.17.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": "^2.1.8"
+    "vitest": "^4.0.15"
   },
   "engines": {
     "node": ">=18.0.0"
   },
   "files": [
-    "dist",
+    "dist/src/",
+    "dist/schemas/",
+    "dist/models/",
     "scripts/postinstall.cjs",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "optionalDependencies": {
+    "@huggingface/transformers": "^4.2.0",
+    "@opentelemetry/resources": "^2.8.0",
+    "@opentelemetry/sdk-node": "^0.220.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.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",
+    "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.2.40",
+    "ruvector-attention-wasm": "^0.1.32",
+    "ruvector-graph-transformer-wasm": "^2.0.4"
+  },
+  "overrides": {
+    "@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"
+  }
 }

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();