agentic-flow 1.9.0 → 1.9.2

package/package.json

@@ -1,57 +1,182 @@
 {
   "name": "agentic-flow",
-  "version": "1.9.0",
-  "description": "Multi-agent coordination framework with QUIC transport",
+  "version": "1.9.2",
+  "description": "Production-ready AI agent orchestration platform with 66 specialized agents, 213 MCP tools, ReasoningBank learning memory, and autonomous multi-agent swarms. Built by @ruvnet with Claude Agent SDK, neural networks, memory persistence, GitHub integration, and distributed consensus protocols.",
+  "type": "module",
   "main": "dist/index.js",
+  "bin": {
+    "agentic-flow": "dist/cli-proxy.js",
+    "agentdb": "dist/agentdb/cli/agentdb-cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./reasoningbank": {
+      "node": "./dist/reasoningbank/index.js",
+      "browser": "./dist/reasoningbank/wasm-adapter.js",
+      "default": "./dist/reasoningbank/index.js"
+    },
+    "./reasoningbank/backend-selector": "./dist/reasoningbank/backend-selector.js",
+    "./reasoningbank/wasm-adapter": "./dist/reasoningbank/wasm-adapter.js",
+    "./router": "./dist/router/index.js",
+    "./agent-booster": "./dist/agent-booster/index.js",
+    "./transport/quic": "./dist/transport/quic.js"
+  },
   "scripts": {
-    "build": "tsc",
-    "test": "jest",
-    "test:parallel": "node tests/parallel/benchmark-suite.js",
-    "test:mesh": "node tests/parallel/mesh-swarm-test.js",
-    "test:hierarchical": "node tests/parallel/hierarchical-swarm-test.js",
-    "test:ring": "node tests/parallel/ring-swarm-test.js",
-    "bench:quic": "node benchmarks/quic-transport.bench.js",
-    "bench:report": "node scripts/generate-benchmark-report.js",
-    "bench:parallel": "BENCHMARK_MODE=true ITERATIONS=10 node tests/parallel/benchmark-suite.js",
-    "docker:test": "cd tests/docker && docker-compose -f docker-compose.parallel.yml up --build",
-    "docker:bench": "cd tests/docker && docker-compose -f docker-compose.parallel.yml up --build benchmark",
-    "profile": "0x -- node benchmarks/quic-transport.bench.js",
-    "lint": "eslint . --ext .ts,.js",
-    "typecheck": "tsc --noEmit"
+    "postinstall": "node scripts/postinstall.js || true",
+    "start": "node --enable-source-maps dist/index.js",
+    "build": "npm run build:wasm && tsc -p config/tsconfig.json --skipLibCheck || true && cp -r src/reasoningbank/prompts dist/reasoningbank/ && cp -r src/reasoningbank/config dist/reasoningbank/",
+    "build:wasm": "cd ../reasoningbank && wasm-pack build --target bundler --out-dir pkg/bundler crates/reasoningbank-wasm && wasm-pack build --target web --out-dir pkg/web crates/reasoningbank-wasm && mkdir -p ../agentic-flow/wasm/reasoningbank && cp -r crates/reasoningbank-wasm/pkg/bundler/* ../agentic-flow/wasm/reasoningbank/ && cp -r crates/reasoningbank-wasm/pkg/web ../agentic-flow/wasm/reasoningbank/",
+    "build:wasm:clean": "rm -rf ../reasoningbank/crates/reasoningbank-wasm/pkg && rm -rf wasm/reasoningbank",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build",
+    "test": "npm run test:retry && npm run test:logging",
+    "test:retry": "tsx validation/quick-wins/test-retry.ts",
+    "test:logging": "tsx validation/quick-wins/test-logging.ts",
+    "test:wasm:e2e": "tsx validation/test-wasm-e2e.ts",
+    "test:wasm:docker": "docker build -f Dockerfile.e2e -t agentic-flow-e2e . && docker run --rm agentic-flow-e2e",
+    "validate": "tsx validation/quick-wins/validate-all.ts",
+    "validate:sdk": "tsx validation/sdk-validation.ts",
+    "validate:health": "bash validation/quick-wins/test-health.sh",
+    "validate:openrouter": "tsx validation/test-openrouter-fixes.ts",
+    "validate:claude-flow": "npm run test:memory && npm run test:coordination && npm run test:hybrid",
+    "test:memory": "tsx validation/claude-flow/test-memory.ts",
+    "test:coordination": "tsx validation/claude-flow/test-coordination.ts",
+    "test:hybrid": "tsx validation/claude-flow/test-hybrid.ts",
+    "test:fastmcp": "bash scripts/test-fastmcp-poc.sh",
+    "test:quic": "tsx validation/test-quic-integration.ts",
+    "test:quic:wasm": "tsx validation/test-quic-wasm.ts",
+    "mcp:fastmcp-poc": "node dist/mcp/fastmcp/servers/poc-stdio.js",
+    "mcp:http": "node dist/mcp/fastmcp/servers/http-sse.js",
+    "mcp:stdio": "node dist/mcp/standalone-stdio.js",
+    "claude-code": "node dist/cli/claude-code-wrapper.js",
+    "example:goal-planner": "tsx src/examples/use-goal-planner.ts",
+    "example:multi-agent": "tsx src/examples/multi-agent-orchestration.ts",
+    "proxy": "node dist/proxy/anthropic-to-openrouter.js",
+    "proxy:dev": "tsx src/proxy/anthropic-to-openrouter.ts",
+    "proxy:quic": "node dist/proxy/quic-proxy.js",
+    "proxy:quic:dev": "tsx src/proxy/quic-proxy.ts"
   },
   "keywords": [
-    "quic",
+    "ai",
+    "ai-agents",
+    "ai-orchestration",
+    "agentic",
+    "agents",
+    "agent-swarm",
+    "anthropic",
+    "anthropic-claude",
+    "automation",
+    "autonomous-agents",
+    "byzantine-consensus",
+    "claude",
+    "claude-agent-sdk",
+    "claude-code",
+    "reasoning-memory",
+    "reasoningbank",
+    "agent-learning",
+    "memory-system",
+    "consensus-protocols",
+    "coordination",
+    "crdt",
+    "devops",
+    "distributed-systems",
+    "docker",
+    "fastmcp",
+    "flow-nexus",
+    "github",
+    "github-integration",
+    "goal-planning",
+    "goap",
+    "hive-mind",
+    "huggingface",
+    "llm",
+    "llm-orchestration",
+    "machine-learning",
+    "mcp",
+    "mcp-server",
+    "mcp-tools",
+    "memory-persistence",
+    "mesh-network",
     "multi-agent",
-    "performance",
-    "benchmark"
+    "multi-agent-systems",
+    "neural-networks",
+    "onnx",
+    "onnxruntime",
+    "orchestration",
+    "pagerank",
+    "parallel-processing",
+    "raft",
+    "ruv",
+    "ruvnet",
+    "sparc",
+    "sublinear-algorithms",
+    "swarm",
+    "swarm-intelligence",
+    "task-orchestration",
+    "typescript",
+    "workflow",
+    "workflow-automation"
+  ],
+  "author": {
+    "name": "ruv",
+    "url": "https://github.com/ruvnet"
+  },
+  "contributors": [
+    {
+      "name": "ruv",
+      "url": "https://github.com/ruvnet"
+    }
   ],
-  "author": "Performance Benchmarker Agent",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/agentic-flow.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ruvnet/agentic-flow/issues"
+  },
+  "homepage": "https://github.com/ruvnet/agentic-flow#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "dependencies": {
-    "@fails-components/webtransport": "^0.3.0",
-    "@types/react": "^19.2.2",
-    "@types/react-dom": "^19.2.2",
-    "@vitejs/plugin-react-swc": "^4.2.0",
-    "autoprefixer": "^10.4.21",
-    "lucide-react": "^0.548.0",
-    "postcss": "^8.5.6",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "react-router-dom": "^7.9.4",
-    "tailwindcss": "^4.1.16",
-    "tailwindcss-animate": "^1.0.7",
-    "vite": "^7.1.12",
-    "ws": "^8.14.2"
+    "@anthropic-ai/claude-agent-sdk": "^0.1.5",
+    "@anthropic-ai/sdk": "^0.65.0",
+    "@google/genai": "^1.22.0",
+    "@supabase/supabase-js": "^2.78.0",
+    "@xenova/transformers": "^2.17.2",
+    "agentdb": "^1.4.3",
+    "axios": "^1.12.2",
+    "better-sqlite3": "^11.10.0",
+    "dotenv": "^16.4.5",
+    "express": "^5.1.0",
+    "fastmcp": "^3.19.0",
+    "http-proxy-middleware": "^3.0.5",
+    "tiktoken": "^1.0.22",
+    "ulid": "^3.0.1",
+    "ws": "^8.18.3",
+    "yaml": "^2.8.1",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.8",
-    "@types/node": "^20.9.0",
-    "@types/ws": "^8.5.8",
-    "@typescript-eslint/eslint-plugin": "^6.11.0",
-    "@typescript-eslint/parser": "^6.11.0",
-    "0x": "^5.6.0",
-    "eslint": "^8.53.0",
-    "jest": "^29.7.0",
-    "typescript": "^5.9.3"
-  }
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/express": "^5.0.3",
+    "@types/node": "^20.19.19",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.3"
+  },
+  "files": [
+    "dist",
+    "docs",
+    ".claude",
+    "validation",
+    "scripts",
+    "wasm",
+    "certs",
+    "README.md",
+    "LICENSE",
+    "VALIDATION-RESULTS.md",
+    "CHANGELOG.md"
+  ]
 }

package/validation/docker/Dockerfile.reasoningbank-local

@@ -0,0 +1,24 @@
+# Dockerfile for testing local agentic-flow build
+FROM node:20-slim
+
+# Install dependencies
+RUN apt-get update && apt-get install -y \
+    git \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /test
+
+# Copy package tarball (must be created with npm pack first)
+COPY agentic-flow-*.tgz /test/package.tgz
+
+# Copy validation script
+COPY validation/docker/test-reasoningbank-npx.mjs /test/
+
+# Set environment
+ENV NODE_ENV=production
+ENV NPM_CONFIG_UPDATE_NOTIFIER=false
+ENV PACKAGE_VERSION=file:/test/package.tgz
+
+# Default command
+CMD ["node", "--experimental-wasm-modules", "/test/test-reasoningbank-npx.mjs"]

package/validation/docker/Dockerfile.reasoningbank-test

@@ -0,0 +1,21 @@
+# Dockerfile for validating agentic-flow ReasoningBank in clean environment
+FROM node:20-slim
+
+# Install necessary dependencies
+RUN apt-get update && apt-get install -y \
+    git \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create working directory
+WORKDIR /test
+
+# Copy validation scripts
+COPY validation/docker/test-reasoningbank-npx.mjs /test/
+
+# Set environment variables
+ENV NODE_ENV=production
+ENV NPM_CONFIG_UPDATE_NOTIFIER=false
+
+# Default command runs validation
+CMD ["node", "--experimental-wasm-modules", "/test/test-reasoningbank-npx.mjs"]

package/validation/docker/README.md

@@ -0,0 +1,234 @@
+# Docker Validation for ReasoningBank
+
+This directory contains Docker-based validation scripts to test agentic-flow package in clean, isolated environments.
+
+## Purpose
+
+Validates that agentic-flow works correctly when installed via npm/npx in a fresh Node.js environment, testing:
+
+1. **Package Installation** - npm install works correctly
+2. **Backend Selector** - Environment detection functions properly
+3. **Node.js Backend** - SQLite backend initializes and works
+4. **WASM Backend** - WASM module loads and functions in Node.js
+5. **Package Exports** - All export paths resolve correctly
+
+## Quick Start
+
+### Test Local Build
+
+```bash
+# From agentic-flow root directory
+
+# 1. Build the package
+npm run build
+
+# 2. Create package tarball
+npm pack
+
+# 3. Run Docker validation
+cd validation/docker
+docker build -f Dockerfile.reasoningbank-local -t agentic-flow-test:local ../..
+docker run --rm agentic-flow-test:local
+```
+
+### Test Published Version
+
+```bash
+# Test latest published version from npm
+docker build -f Dockerfile.reasoningbank-test -t agentic-flow-test:latest ../..
+docker run --rm agentic-flow-test:latest
+
+# Or use docker-compose
+docker-compose up reasoningbank-test-latest
+```
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `Dockerfile.reasoningbank-test` | Tests published npm package |
+| `Dockerfile.reasoningbank-local` | Tests local build (npm pack) |
+| `test-reasoningbank-npx.mjs` | Validation test suite |
+| `docker-compose.yml` | Orchestrates multiple test scenarios |
+| `README.md` | This file |
+
+## Test Suite
+
+The validation script (`test-reasoningbank-npx.mjs`) runs:
+
+### Test 1: Package Installation
+- Initializes package.json
+- Installs agentic-flow via npm
+- Verifies installation success
+
+### Test 2: Backend Selector
+- Imports backend-selector module
+- Tests environment detection (expects 'nodejs')
+- Validates backend info structure
+- Checks environment validation
+
+### Test 3: Node.js Backend (SQLite)
+- Creates ReasoningBank with optimal backend
+- Verifies Node.js backend selected
+- Checks db module is present
+- Tests database initialization
+
+### Test 4: WASM Backend
+- Imports WASM adapter
+- Creates WASM ReasoningBank instance
+- Stores test pattern
+- Performs category search
+- Runs semantic similarity search
+- Validates similarity scores
+- Checks stats reporting
+
+### Test 5: Package Exports
+- Tests main export (`agentic-flow`)
+- Tests reasoningbank export (conditional)
+- Tests backend-selector export
+- Tests wasm-adapter export
+
+## Expected Output
+
+```
+🐳 Docker Validation: agentic-flow ReasoningBank
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Created test directory: /test/validation-workspace
+
+📦 Test 1: Package Installation via npm
+
+   Installing agentic-flow@latest...
+✅ Package installation
+   Installed agentic-flow@1.5.13
+
+🔍 Test 2: Backend Selector Environment Detection
+
+✅ Backend selector import
+   Detected: nodejs
+
+✅ Environment detection
+   Expected nodejs, got nodejs
+
+💾 Test 3: Node.js Backend (SQLite)
+
+✅ Node.js backend initialization
+   SQLite backend loaded
+
+✅ Node.js backend detection
+   db module present
+
+⚡ Test 4: WASM Backend (In-Memory)
+
+✅ WASM backend initialization
+   WASM module loaded
+
+✅ WASM pattern storage
+   In-memory storage works
+
+✅ WASM semantic search
+   Similarity matching works
+
+✅ WASM similarity scoring
+   Score: 0.5401
+
+📦 Test 5: Package Exports
+
+✅ Package exports
+   All import paths valid
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 VALIDATION SUMMARY
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Total Tests: 10
+✅ Passed: 10
+❌ Failed: 0
+⏱️  Duration: 45.23s
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🎉 All tests passed! Package is working correctly.
+```
+
+## Troubleshooting
+
+### Test Failures
+
+If tests fail, check:
+
+1. **Package installation fails**
+   - Verify network connectivity
+   - Check npm registry is accessible
+   - Try with `--registry https://registry.npmjs.org`
+
+2. **Backend selector fails**
+   - Check package.json exports field
+   - Verify conditional exports syntax
+   - Test with `node --experimental-modules`
+
+3. **WASM backend fails**
+   - Ensure `--experimental-wasm-modules` flag is set
+   - Check WASM binary is included in dist/
+   - Verify wasm-pack build completed
+
+4. **SQLite backend fails**
+   - Check better-sqlite3 is in dependencies
+   - Verify native module compilation
+   - Test on matching Node.js version
+
+### Local Testing
+
+To test locally without Docker:
+
+```bash
+cd /tmp
+mkdir reasoningbank-test && cd reasoningbank-test
+npm init -y
+npm install agentic-flow@latest
+
+# Run individual tests
+node --experimental-wasm-modules <<EOF
+import { getRecommendedBackend } from 'agentic-flow/reasoningbank/backend-selector';
+console.log('Backend:', getRecommendedBackend());
+EOF
+```
+
+## CI/CD Integration
+
+Add to GitHub Actions:
+
+```yaml
+- name: Validate agentic-flow in Docker
+  run: |
+    cd validation/docker
+    docker build -f Dockerfile.reasoningbank-local -t test ../..
+    docker run --rm test
+```
+
+## Performance Benchmarks
+
+Expected performance in Docker:
+
+| Operation | Time |
+|-----------|------|
+| Package install | 15-30s |
+| Backend detection | <100ms |
+| WASM initialization | 50-100ms |
+| Pattern storage | 1-5ms |
+| Semantic search | 50-100ms |
+
+## Environment Details
+
+- **Base Image**: `node:20-slim`
+- **Node.js Version**: 20.x LTS
+- **Architecture**: linux/amd64
+- **Dependencies**: git, curl
+
+## Support
+
+If validation fails:
+
+1. Check the [REASONINGBANK_BACKENDS.md](../../docs/REASONINGBANK_BACKENDS.md) guide
+2. Review [IMPLEMENTATION_SUMMARY.md](../../docs/IMPLEMENTATION_SUMMARY.md)
+3. Open an issue at https://github.com/ruvnet/agentic-flow/issues

package/validation/docker/docker-compose.yml

@@ -0,0 +1,29 @@
+version: '3.8'
+
+services:
+  # Test with latest published version from npm
+  reasoningbank-test-latest:
+    build:
+      context: ../..
+      dockerfile: validation/docker/Dockerfile.reasoningbank-test
+    environment:
+      - PACKAGE_VERSION=latest
+      - NODE_ENV=production
+    command: node --experimental-wasm-modules /test/test-reasoningbank-npx.mjs
+    networks:
+      - test-network
+
+  # Test with local build (after npm pack)
+  reasoningbank-test-local:
+    build:
+      context: ../..
+      dockerfile: validation/docker/Dockerfile.reasoningbank-local
+    environment:
+      - NODE_ENV=production
+    command: node --experimental-wasm-modules /test/test-reasoningbank-npx.mjs
+    networks:
+      - test-network
+
+networks:
+  test-network:
+    driver: bridge