🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
feat(neural): use @ruvector/ruvllm 2.5.7 native checkpoints end-to-end (#2549 follow-up) (#2555)
rUv8547df986242
diff --git a/package-lock.json b/package-lock.jsonindex 7868aa8d3f..69fdcbf49d 100644--- a/package-lock.json+++ b/package-lock.json@@ -3038,9 +3038,9 @@}},"node_modules/@ruvector/ruvllm": {- "version": "2.5.5",- "resolved": "https://registry.npmjs.org/@ruvector/ruvllm/-/ruvllm-2.5.5.tgz",- "integrity": "sha512-3WDQkN1EiRlmln6Y3qHIOwIRaRUWwagT1OG+AxohyFgr2UuvWCD5tsiPFtlgwUze4X01lgvBCiHdOsV3u81UWA==",+ "version": "2.5.7",+ "resolved": "https://registry.npmjs.org/@ruvector/ruvllm/-/ruvllm-2.5.7.tgz",+ "integrity": "sha512-XxvUsPZaiIfK5/n1/Vgv3Gz9+cgBbvHbN/4OKHrLcpbw0eY9b9+BsQmvmYGfBwiVumQcgn8wmFiqRTqBrTa3BA==","license": "MIT OR Apache-2.0","optional": true,"dependencies": {@@ -4058,111 +4058,6 @@"sql.js": "^1.11.0"}},- "node_modules/agentic-flow/node_modules/@ruvector/ruvllm": {- "version": "0.2.4",- "resolved": "https://registry.npmjs.org/@ruvector/ruvllm/-/ruvllm-0.2.4.tgz",- "integrity": "sha512-cNAkcKZIqqy+3fxOb1z8bS1cJzJgsUpqNIdMk29RDr+a5g/fLgmHTVEzdBW6kHfDTc5tFUr10Juh9K6w0cKufg==",- "license": "MIT OR Apache-2.0",- "optional": true,- "dependencies": {- "chalk": "^4.1.2",- "commander": "^12.0.0",- "ora": "^5.4.1"- },- "bin": {- "ruvllm": "bin/cli.js"- },- "engines": {- "node": ">= 18"- },- "optionalDependencies": {- "@ruvector/ruvllm-darwin-arm64": "0.2.0",- "@ruvector/ruvllm-darwin-x64": "0.2.0",- "@ruvector/ruvllm-linux-arm64-gnu": "0.2.0",- "@ruvector/ruvllm-linux-x64-gnu": "0.2.0",- "@ruvector/ruvllm-win32-x64-msvc": "0.2.0"- }- },- "node_modules/agentic-flow/node_modules/@ruvector/ruvllm-darwin-arm64": {- "version": "0.2.0",- "resolved": "https://registry.npmjs.org/@ruvector/ruvllm-darwin-arm64/-/ruvllm-darwin-arm64-0.2.0.tgz",- "integrity": "sha512-3oEMNEoGJqfTJXf1Th49HPTlETMxLzlBc1yBY1RqCMoqSrNKsM66+3Npx0O/GdYfFnKRU2wa/mlLPuBY2lUqYQ==",- "cpu": [- "arm64"- ],- "license": "MIT OR Apache-2.0",- "optional": true,- "os": [- "darwin"- ],- "engines": {- "node": ">= 18"- }- },- "node_modules/agentic-flow/node_modules/@ruvector/ruvllm-darwin-x64": {- "version": "0.2.0",- "resolved": "https://registry.npmjs.org/@ruvector/ruvllm-darwin-x64/-/ruvllm-darwin-x64-0.2.0.tgz",- "integrity": "sha512-Niu9oG9hkbDJ1IpfXluRRfO4vwPwCdISW+ff1H+NjmIk8028CIg2w5iq3qbIaj6WzTQ9YqA68V5aMD9t0w8A6g==",- "cpu": [- "x64"- ],- "license": "MIT OR Apache-2.0",- "optional": true,- "os": [- "darwin"- ],- "engines": {- "node": ">= 18"- }- },- "node_modules/agentic-flow/node_modules/@ruvector/ruvllm-linux-arm64-gnu": {- "version": "0.2.0",- "resolved": "https://registry.npmjs.org/@ruvector/ruvllm-linux-arm64-gnu/-/ruvllm-linux-arm64-gnu-0.2.0.tgz",- "integrity": "sha512-ykOqwiqRbf29idXYMmuDdZqOsRMbYgzpWhmk/BcSRVBMUsO4W2Q0UkgLZgt6PIKxSf1k2qt8x8uSmO5tYTD8Iw==",- "cpu": [- "arm64"- ],- "license": "MIT OR Apache-2.0",- "optional": true,- "os": [- "linux"- ],- "engines": {- "node": ">= 18"- }- },- "node_modules/agentic-flow/node_modules/@ruvector/ruvllm-linux-x64-gnu": {- "version": "0.2.0",- "resolved": "https://registry.npmjs.org/@ruvector/ruvllm-linux-x64-gnu/-/ruvllm-linux-x64-gnu-0.2.0.tgz",- "integrity": "sha512-8JHH7ft00rqCRyiP0wuAThOVwSodj0gaTZcG1jBBqtnwApmdmTWN8EpuffrHHhhRO+Uvny6T5r7TiAh+Xu+QuQ==",- "cpu": [- "x64"- ],- "license": "MIT OR Apache-2.0",- "optional": true,- "os": [- "linux"- ],- "engines": {- "node": ">= 18"- }- },- "node_modules/agentic-flow/node_modules/@ruvector/ruvllm-win32-x64-msvc": {- "version": "0.2.0",- "resolved": "https://registry.npmjs.org/@ruvector/ruvllm-win32-x64-msvc/-/ruvllm-win32-x64-msvc-0.2.0.tgz",- "integrity": "sha512-ksm+AZVqkkYLVq2Rbc7Rx+gSH7egFWlcH3E5dQpro98Oslc7jUH+uNDRjDVUS3lZXchV+Ot5WPLM4pClRxFm9w==",- "cpu": [- "x64"- ],- "license": "MIT OR Apache-2.0",- "optional": true,- "os": [- "win32"- ],- "engines": {- "node": ">= 18"- }- },"node_modules/agentic-flow/node_modules/glob": {"version": "13.0.6","resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz",diff --git a/package.json b/package.jsonindex 3d13c6d0f6..3e0d2bb7b4 100644--- a/package.json+++ b/package.json@@ -116,7 +116,8 @@"ws": ">=8.21.0","@grpc/grpc-js": ">=1.14.4","form-data": ">=4.0.6",- "http-proxy-middleware": ">=3.0.7"+ "http-proxy-middleware": ">=3.0.7",+ "@ruvector/ruvllm": ">=2.5.7"},"devDependencies": {"@openai/codex": "^0.98.0",diff --git a/ruflo/package.json b/ruflo/package.jsonindex 695f85efb8..8859e43fe9 100644--- a/ruflo/package.json+++ b/ruflo/package.json@@ -79,7 +79,8 @@"@opentelemetry/otlp-grpc-exporter-base": ">=0.220.0","@opentelemetry/otlp-transformer": ">=0.220.0","agentdb": ">=3.0.0-alpha.17",- "agentic-flow": ">=2.0.14"+ "agentic-flow": ">=2.0.14",+ "@ruvector/ruvllm": ">=2.5.7"},"engines": {"node": ">=20.0.0"diff --git a/v3/@claude-flow/cli/__tests__/neural-status-training-backend-2549.test.ts b/v3/@claude-flow/cli/__tests__/neural-status-training-backend-2549.test.tsindex 4194896e8a..78e4e4099a 100644--- a/v3/@claude-flow/cli/__tests__/neural-status-training-backend-2549.test.ts+++ b/v3/@claude-flow/cli/__tests__/neural-status-training-backend-2549.test.ts@@ -55,3 +55,29 @@ describe('#2549 — training backend capability reporting', () => {expect(stats._contrastiveTrainer).not.toBe('unavailable');});});++describe('#2549 follow-up — native checkpoint capability gate', () => {+ it('nativeCheckpointsSupported reflects the resolved ruvllm version (>=2.5.7)', async () => {+ const { nativeCheckpointsSupported } = await import('../src/ruvector/lora-adapter.js');+ if (!ruvllmResolves()) {+ expect(nativeCheckpointsSupported()).toBe(false);+ return;+ }+ const req = createRequire(import.meta.url);+ const { dirname, join } = await import('node:path');+ const { existsSync, readFileSync } = await import('node:fs');+ let dir = dirname(req.resolve('@ruvector/ruvllm'));+ let version = '0.0.0';+ for (let i = 0; i < 5; i++) {+ const p = join(dir, 'package.json');+ if (existsSync(p)) {+ const pkg = JSON.parse(readFileSync(p, 'utf-8'));+ if (pkg.name === '@ruvector/ruvllm') { version = pkg.version; break; }+ }+ dir = dirname(dir);+ }+ const [maj, min, pat] = version.split('.').map(Number);+ const expected = maj > 2 || (maj === 2 && (min > 5 || (min === 5 && pat >= 7)));+ expect(nativeCheckpointsSupported()).toBe(expected);+ });+});diff --git a/v3/@claude-flow/cli/src/commands/neural.ts b/v3/@claude-flow/cli/src/commands/neural.tsindex 857d32b591..c75f8bf71b 100644--- a/v3/@claude-flow/cli/src/commands/neural.ts+++ b/v3/@claude-flow/cli/src/commands/neural.ts@@ -543,8 +543,19 @@ const statusCommand: Command = {{component: 'Training Pipeline',status: stats._trainingBackend === 'ruvllm' ? output.success('Available') : output.dim(stats._trainingBackend || 'Unavailable'),+ // Checkpoint capability is version-gated: saveCheckpoint(path)+ // was a silent no-op before @ruvector/ruvllm 2.5.7 (#2549).details: stats._trainingBackend === 'ruvllm'- ? 'native @ruvector/ruvllm pipeline'+ ? await (async () => {+ try {+ const { nativeCheckpointsSupported } = await import('../ruvector/lora-adapter.js');+ return nativeCheckpointsSupported()+ ? 'native @ruvector/ruvllm pipeline + disk checkpoints'+ : 'native @ruvector/ruvllm pipeline (checkpoints need >=2.5.7)';+ } catch {+ return 'native @ruvector/ruvllm pipeline';+ }+ })(): 'JS fallback',},await (async () => {diff --git a/v3/@claude-flow/cli/src/ruvector/lora-adapter.ts b/v3/@claude-flow/cli/src/ruvector/lora-adapter.tsindex 3ea2838018..172e2d07cb 100644--- a/v3/@claude-flow/cli/src/ruvector/lora-adapter.ts+++ b/v3/@claude-flow/cli/src/ruvector/lora-adapter.ts@@ -155,6 +155,31 @@ export function resolveTrainingBackend(): 'ruvllm' | 'js-fallback' {}}+/**+ * Whether the resolved @ruvector/ruvllm persists checkpoints to disk.+ * saveCheckpoint(path) was a silent no-op (private, void, wrote 0 bytes)+ * before 2.5.7 — status surfaces must not advertise checkpoints against+ * older versions. Reads the resolved package's version; the package does+ * not export ./package.json, so walk up from the resolved entry instead.+ */+export function nativeCheckpointsSupported(): boolean {+ try {+ const req = createRequire(import.meta.url);+ let dir = dirname(req.resolve('@ruvector/ruvllm'));+ for (let i = 0; i < 5; i++) {+ const pkgPath = join(dir, 'package.json');+ if (existsSync(pkgPath)) {+ const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));+ if (pkg.name !== '@ruvector/ruvllm') { dir = dirname(dir); continue; }+ const [maj, min, pat] = String(pkg.version).split('.').map(Number);+ return maj > 2 || (maj === 2 && (min > 5 || (min === 5 && pat >= 7)));+ }+ dir = dirname(dir);+ }+ } catch { /* unresolved — no native checkpoints */ }+ return false;+}+async function loadTrainingPipeline(adapter: LoRAAdapter): Promise<any> {if (pipelineLoaded) return ruvllmPipeline;pipelineLoaded = true;@@ -529,11 +554,17 @@ export class LoRAAdapter {* Falls back to writing our own weight JSON if ruvllm is unavailable.*/async saveCheckpoint(path: string): Promise<boolean> {+ // Parent dir must exist for BOTH paths: ruvllm <2.5.7 never wrote a+ // file at all, and the JS fallback's writeFileSync throws ENOENT on a+ // missing dir — which the catch silently converted to `false` (#2549).+ try {+ mkdirSync(dirname(path), { recursive: true });+ } catch { /* fs errors surface on write below */ }const pipeline = await loadTrainingPipeline(this);if (pipeline) {try {pipeline.saveCheckpoint(path);- // Verify ruvllm actually wrote the file (some versions are no-op)+ // Verify ruvllm actually wrote the file (<2.5.7 is a silent no-op)const fs = await import('fs');if (fs.existsSync(path)) return true;} catch { /* fall through to JS fallback */ }diff --git a/v3/package.json b/v3/package.jsonindex cd63ffd7af..fbf45c8640 100644--- a/v3/package.json+++ b/v3/package.json@@ -68,7 +68,8 @@"vitest": ">=4.1.0","@vitest/coverage-v8": ">=4.1.0","handlebars": ">=4.7.9",- "protobufjs": ">=8.6.0"+ "protobufjs": ">=8.6.0",+ "@ruvector/ruvllm": ">=2.5.7"}}}diff --git a/v3/pnpm-lock.yaml b/v3/pnpm-lock.yamlindex b7df38c311..667a7c4951 100644--- a/v3/pnpm-lock.yaml+++ b/v3/pnpm-lock.yaml@@ -14,6 +14,7 @@ overrides:'@vitest/coverage-v8': '>=4.1.0'handlebars: '>=4.7.9'protobufjs: '>=8.6.0'+ '@ruvector/ruvllm': '>=2.5.7'importers:@@ -524,8 +525,8 @@ importers:'@claude-flow/providers':dependencies:'@ruvector/ruvllm':- specifier: ^0.2.3- version: 0.2.4+ specifier: '>=2.5.7'+ version: 2.5.7events:specifier: ^3.3.0version: 3.3.0@@ -5584,14 +5585,6 @@ packages:'@ruvector/router-linux-x64-gnu': 0.1.30'@ruvector/router-win32-x64-msvc': 0.1.30- /@ruvector/[email protected]:- resolution: {integrity: sha512-3oEMNEoGJqfTJXf1Th49HPTlETMxLzlBc1yBY1RqCMoqSrNKsM66+3Npx0O/GdYfFnKRU2wa/mlLPuBY2lUqYQ==}- engines: {node: '>= 18'}- cpu: [arm64]- os: [darwin]- requiresBuild: true- optional: true-/@ruvector/[email protected]:resolution: {integrity: sha512-giZb+TbErKLgURLC3CSmJKJl0bnJn+jFZk488ppyzrR6YGft6kO329Twnd+TiJNDxVOMgZefwVdsbF9jrUIgAQ==}engines: {node: '>= 18'}@@ -5600,14 +5593,6 @@ packages:requiresBuild: trueoptional: true- /@ruvector/[email protected]:- resolution: {integrity: sha512-Niu9oG9hkbDJ1IpfXluRRfO4vwPwCdISW+ff1H+NjmIk8028CIg2w5iq3qbIaj6WzTQ9YqA68V5aMD9t0w8A6g==}- engines: {node: '>= 18'}- cpu: [x64]- os: [darwin]- requiresBuild: true- optional: true-/@ruvector/[email protected]:resolution: {integrity: sha512-DpVKFBXFxVPBiCGBw1AeiwsY1YVWfaCh+Eq0+pVLqD4kwwXKhRIWLnTQcuZVE5Gnt1Ku8MxhH2Zs++vKiuq3mA==}engines: {node: '>= 18'}@@ -5616,14 +5601,6 @@ packages:requiresBuild: trueoptional: true- /@ruvector/[email protected]:- resolution: {integrity: sha512-ykOqwiqRbf29idXYMmuDdZqOsRMbYgzpWhmk/BcSRVBMUsO4W2Q0UkgLZgt6PIKxSf1k2qt8x8uSmO5tYTD8Iw==}- engines: {node: '>= 18'}- cpu: [arm64]- os: [linux]- requiresBuild: true- optional: true-/@ruvector/[email protected]:resolution: {integrity: sha512-+u6Fe/Dsy4Y11m9IUmuoUeFtoUWc1ZVXxGB4JYomNDll63D03a0cpeKKaslgwOfFlfXlrFcs/eDrsYr07tQP5g==}engines: {node: '>= 18'}@@ -5632,14 +5609,6 @@ packages:requiresBuild: trueoptional: true- /@ruvector/[email protected]:- resolution: {integrity: sha512-8JHH7ft00rqCRyiP0wuAThOVwSodj0gaTZcG1jBBqtnwApmdmTWN8EpuffrHHhhRO+Uvny6T5r7TiAh+Xu+QuQ==}- engines: {node: '>= 18'}- cpu: [x64]- os: [linux]- requiresBuild: true- optional: true-/@ruvector/[email protected]:resolution: {integrity: sha512-GH9u/SPUZm9KXjSoQZx5PRtJui0hO/OK+OmRHLZc8+IYrlgona6UQAw6uKHJ3cSEZp9f+XBRYgIrLmsEJW3HXA==}engines: {node: '>= 18'}@@ -5654,14 +5623,6 @@ packages:dev: falseoptional: true- /@ruvector/[email protected]:- resolution: {integrity: sha512-ksm+AZVqkkYLVq2Rbc7Rx+gSH7egFWlcH3E5dQpro98Oslc7jUH+uNDRjDVUS3lZXchV+Ot5WPLM4pClRxFm9w==}- engines: {node: '>= 18'}- cpu: [x64]- os: [win32]- requiresBuild: true- optional: true-/@ruvector/[email protected]:resolution: {integrity: sha512-sRGNOMAcyC5p/nITnR0HLFUEObZ9Mh/T1erNiqhKrNUqIPZM1qAYBgN3xmZp02isdiTilRpxQihz3j4EzGPXIw==}engines: {node: '>= 18'}@@ -5670,26 +5631,10 @@ packages:requiresBuild: trueoptional: true- /@ruvector/[email protected]:- resolution: {integrity: sha512-cNAkcKZIqqy+3fxOb1z8bS1cJzJgsUpqNIdMk29RDr+a5g/fLgmHTVEzdBW6kHfDTc5tFUr10Juh9K6w0cKufg==}+ /@ruvector/[email protected]:+ resolution: {integrity: sha512-XxvUsPZaiIfK5/n1/Vgv3Gz9+cgBbvHbN/4OKHrLcpbw0eY9b9+BsQmvmYGfBwiVumQcgn8wmFiqRTqBrTa3BA==}engines: {node: '>= 18'}hasBin: true- dependencies:- chalk: 4.1.2- commander: 12.1.0- ora: 5.4.1- optionalDependencies:- '@ruvector/ruvllm-darwin-arm64': 0.2.0- '@ruvector/ruvllm-darwin-x64': 0.2.0- '@ruvector/ruvllm-linux-arm64-gnu': 0.2.0- '@ruvector/ruvllm-linux-x64-gnu': 0.2.0- '@ruvector/ruvllm-win32-x64-msvc': 0.2.0-- /@ruvector/[email protected]:- resolution: {integrity: sha512-B29ej1aJCNN7UCiIj0wtDMLCe01UWA7KMPTSAriGeey13aNYnstsTD+lz3tkglLSMSdwf9ozQ+N4lVQXvc96+A==}- engines: {node: '>= 18'}- hasBin: true- requiresBuild: truedependencies:chalk: 4.1.2commander: 12.1.0@@ -5700,7 +5645,6 @@ packages:'@ruvector/ruvllm-linux-arm64-gnu': 2.0.1'@ruvector/ruvllm-linux-x64-gnu': 2.0.1'@ruvector/ruvllm-win32-x64-msvc': 2.0.1- optional: true/@ruvector/[email protected]:resolution: {integrity: sha512-zhcnU7XfBEfDwkDFscehq6qGU/TW4LNr287xHHXCuNsaTBPlb8YSnkuMNWg6BBIK/X+UdWAsyYESN5jbNQEaBQ==}@@ -6927,7 +6871,7 @@ packages:'@ruvector/gnn': 0.1.25'@ruvector/graph-node': 0.1.26'@ruvector/router': 0.1.26- '@ruvector/ruvllm': 0.2.4+ '@ruvector/ruvllm': 2.5.7'@ruvector/sona': 0.1.5ajv: 8.17.1chalk: 5.6.2@@ -6988,7 +6932,7 @@ packages:'@ruvector/gnn': 0.1.25'@ruvector/graph-node': 0.1.26'@ruvector/router': 0.1.30- '@ruvector/ruvllm': 0.2.4+ '@ruvector/ruvllm': 2.5.7'@ruvector/sona': 0.1.7ajv: 8.18.0chalk: 5.6.2@@ -7053,7 +6997,7 @@ packages:'@ruvector/gnn': 0.1.25'@ruvector/graph-node': 2.0.3'@ruvector/router': 0.1.30- '@ruvector/ruvllm': 2.5.6+ '@ruvector/ruvllm': 2.5.7'@ruvector/rvf': 0.1.9'@ruvector/rvf-node': 0.1.8'@ruvector/rvf-solver': 0.1.8@@ -7209,7 +7153,7 @@ packages:'@ruvector/core': 0.1.30'@ruvector/edge-full': 0.1.0'@ruvector/router': 0.1.30- '@ruvector/ruvllm': 0.2.4+ '@ruvector/ruvllm': 2.5.7'@ruvector/tiny-dancer': 0.1.22'@supabase/supabase-js': 2.89.0'@xenova/transformers': 2.17.2@@ -7265,7 +7209,7 @@ packages:'@ruvector/core': 0.1.30'@ruvector/edge-full': 0.1.0'@ruvector/router': 0.1.30- '@ruvector/ruvllm': 0.2.4+ '@ruvector/ruvllm': 2.5.7'@ruvector/tiny-dancer': 0.1.18'@supabase/supabase-js': 2.89.0axios: 1.13.2@@ -7322,7 +7266,7 @@ packages:'@ruvector/core': 0.1.30'@ruvector/edge-full': 0.1.0'@ruvector/router': 0.1.26- '@ruvector/ruvllm': 0.2.4+ '@ruvector/ruvllm': 2.5.7'@ruvector/tiny-dancer': 0.1.22'@supabase/supabase-js': 2.89.0'@xenova/transformers': 2.17.2@@ -10470,7 +10414,7 @@ packages:kolorist: 1.8.0prompts: 2.4.2optionalDependencies:- '@ruvector/ruvllm': 2.5.6+ '@ruvector/ruvllm': 2.5.7dev: falseoptional: true@@ -12000,7 +11944,7 @@ packages:'@ruvector/diskann': '>=0.1.0''@ruvector/pi-brain': '>=0.1.0''@ruvector/router': '>=0.1.0'- '@ruvector/ruvllm': '>=2.0.0'+ '@ruvector/ruvllm': '>=2.5.7'peerDependenciesMeta:'@ruvector/diskann':optional: true