agentic-flow 1.7.2 → 1.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/.claude/agents/test-neural.md +0 -5
  2. package/.claude/answer.md +1 -0
  3. package/.claude/settings.json +19 -20
  4. package/CHANGELOG.md +0 -91
  5. package/README.md +17 -81
  6. package/dist/agentdb/benchmarks/comprehensive-benchmark.js +664 -0
  7. package/dist/agentdb/benchmarks/frontier-benchmark.js +419 -0
  8. package/dist/agentdb/benchmarks/reflexion-benchmark.js +370 -0
  9. package/dist/agentdb/cli/agentdb-cli.js +717 -0
  10. package/dist/agentdb/controllers/CausalMemoryGraph.js +322 -0
  11. package/dist/agentdb/controllers/CausalRecall.js +281 -0
  12. package/dist/agentdb/controllers/EmbeddingService.js +118 -0
  13. package/dist/agentdb/controllers/ExplainableRecall.js +387 -0
  14. package/dist/agentdb/controllers/NightlyLearner.js +382 -0
  15. package/dist/agentdb/controllers/ReflexionMemory.js +239 -0
  16. package/dist/agentdb/controllers/SkillLibrary.js +276 -0
  17. package/dist/agentdb/controllers/frontier-index.js +9 -0
  18. package/dist/agentdb/controllers/index.js +8 -0
  19. package/dist/agentdb/index.js +32 -0
  20. package/dist/agentdb/optimizations/BatchOperations.js +198 -0
  21. package/dist/agentdb/optimizations/QueryOptimizer.js +225 -0
  22. package/dist/agentdb/optimizations/index.js +7 -0
  23. package/dist/agentdb/tests/frontier-features.test.js +665 -0
  24. package/dist/cli/skills-manager.js +3 -1
  25. package/dist/cli-proxy.js +2 -33
  26. package/dist/mcp/standalone-stdio.js +200 -4
  27. package/dist/memory/SharedMemoryPool.js +211 -0
  28. package/dist/memory/index.js +6 -0
  29. package/dist/reasoningbank/AdvancedMemory.js +239 -0
  30. package/dist/reasoningbank/HybridBackend.js +305 -0
  31. package/dist/reasoningbank/index-new.js +87 -0
  32. package/dist/reasoningbank/index.js +23 -44
  33. package/dist/utils/cli.js +0 -22
  34. package/docs/AGENTDB_TESTING.md +411 -0
  35. package/docs/v1.7.1-QUICK-START.md +399 -0
  36. package/package.json +4 -4
  37. package/scripts/run-validation.sh +165 -0
  38. package/scripts/test-agentdb.sh +153 -0
  39. package/.claude/skills/agentdb-memory-patterns/SKILL.md +0 -166
  40. package/.claude/skills/agentdb-vector-search/SKILL.md +0 -126
  41. package/.claude/skills/agentic-flow/agentdb-memory-patterns/SKILL.md +0 -166
  42. package/.claude/skills/agentic-flow/agentdb-vector-search/SKILL.md +0 -126
  43. package/.claude/skills/agentic-flow/reasoningbank-intelligence/SKILL.md +0 -201
  44. package/.claude/skills/agentic-flow/swarm-orchestration/SKILL.md +0 -179
  45. package/.claude/skills/reasoningbank-intelligence/SKILL.md +0 -201
  46. package/.claude/skills/skill-builder/README.md +0 -308
  47. package/.claude/skills/skill-builder/SKILL.md +0 -910
  48. package/.claude/skills/skill-builder/docs/SPECIFICATION.md +0 -358
  49. package/.claude/skills/skill-builder/resources/schemas/skill-frontmatter.schema.json +0 -41
  50. package/.claude/skills/skill-builder/resources/templates/full-skill.template +0 -118
  51. package/.claude/skills/skill-builder/resources/templates/minimal-skill.template +0 -38
  52. package/.claude/skills/skill-builder/scripts/generate-skill.sh +0 -334
  53. package/.claude/skills/skill-builder/scripts/validate-skill.sh +0 -198
  54. package/.claude/skills/swarm-orchestration/SKILL.md +0 -179
  55. package/docs/AGENTDB_INTEGRATION.md +0 -379
@@ -1,8 +1,3 @@
1
- ---
2
- name: test-neural
3
- description: Test agent for validating neural network tool access
4
- ---
5
-
6
1
  # Test Neural Agent
7
2
 
8
3
  Test agent for validating neural network tool access.
@@ -0,0 +1 @@
1
+ A program walks into a bar and orders a beer. As it is waiting for its drink, it hears a guy next to it say, 'Wow, the bartender can brew beer in just 5 minutes!' The program turns to the man and says, 'I don't know, I'm still trying to debug my couple of weeks old code and I still can't tell what it's doing. A 5 minute beer?
@@ -9,33 +9,32 @@
9
9
  },
10
10
  "permissions": {
11
11
  "allow": [
12
- "Bash(npx claude-flow:*)",
12
+ "Bash(npx claude-flow *)",
13
13
  "Bash(npm run lint)",
14
14
  "Bash(npm run test:*)",
15
- "Bash(npm test:*)",
15
+ "Bash(npm test *)",
16
16
  "Bash(git status)",
17
- "Bash(git diff:*)",
18
- "Bash(git log:*)",
19
- "Bash(git add:*)",
20
- "Bash(git commit:*)",
17
+ "Bash(git diff *)",
18
+ "Bash(git log *)",
19
+ "Bash(git add *)",
20
+ "Bash(git commit *)",
21
21
  "Bash(git push)",
22
- "Bash(git config:*)",
23
- "Bash(git tag:*)",
24
- "Bash(git branch:*)",
25
- "Bash(git checkout:*)",
26
- "Bash(git stash:*)",
27
- "Bash(jq:*)",
28
- "Bash(node:*)",
29
- "Bash(which:*)",
22
+ "Bash(git config *)",
23
+ "Bash(git tag *)",
24
+ "Bash(git branch *)",
25
+ "Bash(git checkout *)",
26
+ "Bash(git stash *)",
27
+ "Bash(jq *)",
28
+ "Bash(node *)",
29
+ "Bash(which *)",
30
30
  "Bash(pwd)",
31
- "Bash(ls:*)",
32
- "mcp__ruv-swarm",
33
- "mcp__claude-flow@alpha",
34
- "mcp__flow-nexus",
35
- "WebSearch"
31
+ "Bash(ls *)"
36
32
  ],
37
33
  "deny": [
38
- "Bash(rm -rf /)"
34
+ "Bash(rm -rf /)",
35
+ "Bash(curl * | bash)",
36
+ "Bash(wget * | sh)",
37
+ "Bash(eval *)"
39
38
  ]
40
39
  },
41
40
  "hooks": {
package/CHANGELOG.md CHANGED
@@ -5,97 +5,6 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
- ## [1.7.2] - 2025-10-19
9
-
10
- ### Added
11
- - **Skills System Integration** - Full CLI support for Claude Code Skills management
12
- - `npx agentic-flow skills list` - List all installed skills (personal + project)
13
- - `npx agentic-flow skills init` - Initialize skills directories (~/.claude/skills and .claude/skills)
14
- - `npx agentic-flow skills create` - Create agentic-flow example skills (AgentDB, swarm, reasoningbank)
15
- - `npx agentic-flow skills init-builder` - Install skill-builder framework for creating custom skills
16
- - `npx agentic-flow skills help` - Show comprehensive skills command documentation
17
- - Skills automatically discovered by Claude Code across all surfaces (Claude.ai, CLI, SDK, API)
18
-
19
- ### Changed
20
- - **README Updates** - Added comprehensive Skills System documentation
21
- - New Skills System section with Quick Start guide
22
- - Updated Quick Navigation table to highlight Skills
23
- - Updated CLI Commands section with all 5 skills commands
24
- - Added skill structure examples with YAML frontmatter
25
- - Listed 5 built-in skills: skill-builder, agentdb-memory-patterns, agentdb-vector-search, reasoningbank-intelligence, swarm-orchestration
26
-
27
- ### Documentation
28
- - Updated both main README.md and npm package README.md with identical Skills documentation
29
- - Added skills to Quick Navigation for easy discovery
30
- - Included benefits: reusable, discoverable, structured, progressive, validated
31
-
32
- ## [1.7.1] - 2025-10-19
33
-
34
- ### Fixed
35
- - **CRITICAL: Skills Top-Level Installation** - Fixed skills to install at top level for Claude Code discovery
36
- - **Claude Code requires**: `~/.claude/skills/[skill-name]/` (top level)
37
- - **NOT supported**: `~/.claude/skills/namespace/[skill-name]/` (nested subdirectories)
38
- - All skills now correctly install at top level: `~/.claude/skills/skill-builder/`, `~/.claude/skills/swarm-orchestration/`, etc.
39
- - Skills are now properly discovered by Claude Code after restart
40
- - Reverted incorrect v1.7.0 namespace changes that broke skill discovery
41
-
42
- ### Changed
43
- - Updated `skills-manager.ts` to install all skills at top level (removed nested namespace)
44
- - Moved skill source files from `agentic-flow/` subdirectory to top level in `.claude/skills/`
45
- - Simplified source detection paths
46
-
47
- ### Documentation
48
- - Added `docs/plans/skills/SKILLS_TOP_LEVEL_FIX.md` - Explanation of fix and testing
49
- - Updated `docs/plans/skills/SKILL_INSTALLATION_ANALYSIS.md` - Corrected with top-level requirement
50
- - Deprecated `docs/plans/skills/MIGRATION_v1.7.0.md` - Namespace approach was incorrect
51
-
52
- ### Migration
53
- If you installed skills with v1.7.0:
54
- ```bash
55
- # Move skills from namespace to top level
56
- cd ~/.claude/skills
57
- for skill in agentic-flow/*; do
58
- mv "agentic-flow/$skill" "$(basename $skill)"
59
- done
60
- rm -rf agentic-flow
61
- # Restart Claude Code
62
- ```
63
-
64
- Or simply reinstall:
65
- ```bash
66
- npx agentic-flow skills init personal --with-builder
67
- ```
68
-
69
- ## [1.6.6] - 2025-10-18
70
-
71
- ### Changed
72
-
73
- - **AgentDB v1.0.5** - Updated to latest version with browser bundle support
74
- - Now includes `dist/agentdb.min.js` (196KB) and `dist/agentdb.js` (380KB) for CDN usage
75
- - Browser bundles support direct import via unpkg/jsDelivr
76
- - Source maps included for debugging
77
- - WASM backend fully functional in browser environments
78
-
79
- ## [1.6.5] - 2025-10-18
80
-
81
- ### Changed
82
-
83
- - **AgentDB Dependency** - Updated to use published npm package instead of local file reference
84
- - Changed from `"agentdb": "file:../packages/agentdb"` to `"agentdb": "^1.0.4"`
85
- - Now uses stable published version from npm registry
86
- - Includes all 20 MCP tools (10 core AgentDB + 10 learning tools)
87
- - Easier installation and dependency management for end users
88
-
89
- ### Added
90
-
91
- - **AgentDB v1.0.4 Integration** - Complete MCP learning system now available
92
- - 10 learning tools: learning_start_session, learning_end_session, learning_predict, learning_feedback, learning_train, learning_metrics, learning_transfer, learning_explain, experience_record, reward_signal
93
- - Q-learning with epsilon-greedy exploration
94
- - Multi-dimensional reward system (success 40%, efficiency 30%, quality 20%, cost 10%)
95
- - Experience replay buffer with prioritized sampling
96
- - Transfer learning between similar tasks
97
- - Session management with state persistence
98
-
99
8
  ## [1.6.4] - 2025-10-16
100
9
 
101
10
  ### 🚀 QUIC Transport - Production Ready (100% Complete)
package/README.md CHANGED
@@ -17,7 +17,7 @@
17
17
  |-------------|---------------|---------------|
18
18
  | [Quick Start](#-quick-start) | [Agent Booster](#-core-components) | [Agent List](#-agent-types) |
19
19
  | [Deployment Options](#-deployment-options) | [ReasoningBank](#-core-components) | [MCP Tools](#-mcp-tools-213-total) |
20
- | [Model Optimization](#-model-optimization) | [Skills System](#-skills-system-claude-code-integration) | [Complete Docs](https://github.com/ruvnet/agentic-flow/tree/main/docs) |
20
+ | [Model Optimization](#-model-optimization) | [Multi-Model Router](#-using-the-multi-model-router) | [Complete Docs](https://github.com/ruvnet/agentic-flow/tree/main/docs) |
21
21
 
22
22
  ---
23
23
 
@@ -53,19 +53,33 @@ Most AI coding agents are **painfully slow** and **frustratingly forgetful**. Th
53
53
  | Component | Description | Performance | Documentation |
54
54
  |-----------|-------------|-------------|---------------|
55
55
  | **Agent Booster** | Ultra-fast local code transformations via Rust/WASM (auto-detects edits) | 352x faster, $0 cost | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agent-booster) |
56
+ | **AgentDB** | State-of-the-art memory with causal reasoning, reflexion, and skill learning | p95 < 50ms, 80% hit rate | [Docs](./src/agentdb/README.md) |
56
57
  | **ReasoningBank** | Persistent learning memory system with semantic search | 46% faster, 100% success | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agentic-flow/src/reasoningbank) |
57
58
  | **Multi-Model Router** | Intelligent cost optimization across 100+ LLMs | 85-99% cost savings | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agentic-flow/src/router) |
58
59
  | **QUIC Transport** | Ultra-low latency agent communication via Rust/WASM QUIC protocol | 50-70% faster than TCP, 0-RTT | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/crates/agentic-flow-quic) |
59
60
 
60
- **CLI Usage**: Multi-Model Router via `--optimize`, Agent Booster (automatic), ReasoningBank (API only), QUIC Transport (API only)
61
- **Programmatic**: All components importable: `agentic-flow/router`, `agentic-flow/reasoningbank`, `agentic-flow/agent-booster`, `agentic-flow/transport/quic`
61
+ **CLI Usage**:
62
+ - **AgentDB**: Full CLI with 17 commands (`npx agentdb <command>`)
63
+ - **Multi-Model Router**: Via `--optimize` flag
64
+ - **Agent Booster**: Automatic on code edits
65
+ - **ReasoningBank**: API only
66
+ - **QUIC Transport**: API only
67
+
68
+ **Programmatic**: All components importable: `agentic-flow/agentdb`, `agentic-flow/router`, `agentic-flow/reasoningbank`, `agentic-flow/agent-booster`, `agentic-flow/transport/quic`
62
69
 
63
70
  **Get Started:**
64
71
  ```bash
72
+ # CLI: AgentDB memory operations
73
+ npx agentdb reflexion store "session-1" "implement_auth" 0.95 true "Success!"
74
+ npx agentdb skill search "authentication" 10
75
+ npx agentdb causal query "" "code_quality" 0.8
76
+ npx agentdb learner run
77
+
65
78
  # CLI: Auto-optimization (Agent Booster runs automatically on code edits)
66
79
  npx agentic-flow --agent coder --task "Build a REST API" --optimize
67
80
 
68
81
  # Programmatic: Import any component
82
+ import { ReflexionMemory, SkillLibrary, CausalMemoryGraph } from 'agentic-flow/agentdb';
69
83
  import { ModelRouter } from 'agentic-flow/router';
70
84
  import * as reasoningbank from 'agentic-flow/reasoningbank';
71
85
  import { AgentBooster } from 'agentic-flow/agent-booster';
@@ -248,18 +262,10 @@ npx agentic-flow mcp status # Check server status
248
262
  npx agentic-flow --list # List all 79 agents
249
263
  npx agentic-flow agent info coder # Get agent details
250
264
  npx agentic-flow agent create # Create custom agent
251
-
252
- # Skills management (NEW in v1.5.11+)
253
- npx agentic-flow skills list # List all installed skills
254
- npx agentic-flow skills init # Initialize skills directories
255
- npx agentic-flow skills create # Create agentic-flow example skills
256
- npx agentic-flow skills init-builder # Install skill-builder framework
257
- npx agentic-flow skills help # Show skills help
258
265
  ```
259
266
 
260
267
  **Built-in MCP Tools** (7): agent execution, list agents, create agent, agent info, conflicts check, model optimizer, list all agents
261
268
  **External MCP Servers**: claude-flow (101 tools), flow-nexus (96 tools), agentic-payments (10 tools)
262
- **Skills System**: Create reusable AI workflows with YAML frontmatter and progressive disclosure
263
269
 
264
270
  ---
265
271
 
@@ -375,76 +381,6 @@ for (const file of files) {
375
381
 
376
382
  ---
377
383
 
378
- ## 🎓 Skills System (Claude Code Integration)
379
-
380
- **NEW in v1.5.11+**: Create reusable AI workflows with proper YAML frontmatter, progressive disclosure, and Claude Code integration.
381
-
382
- ### What Are Skills?
383
-
384
- Skills are structured AI workflows that Claude can autonomously discover and execute across all surfaces (Claude.ai, Claude Code, SDK, API). Each skill is a self-contained SKILL.md file with YAML frontmatter defining its capabilities.
385
-
386
- ### Quick Start
387
-
388
- ```bash
389
- # Initialize skills directories
390
- npx agentic-flow skills init # Creates ~/.claude/skills and .claude/skills
391
-
392
- # Install skill-builder framework (for creating custom skills)
393
- npx agentic-flow skills init-builder # Adds skill-builder to your project
394
-
395
- # Create example agentic-flow skills
396
- npx agentic-flow skills create # Creates AgentDB, swarm, reasoningbank skills
397
-
398
- # List all installed skills
399
- npx agentic-flow skills list # Shows personal and project skills
400
-
401
- # Get help
402
- npx agentic-flow skills help # Show all commands and usage
403
- ```
404
-
405
- ### Skill Structure
406
-
407
- Every skill requires a SKILL.md file with YAML frontmatter:
408
-
409
- ```yaml
410
- ---
411
- name: "Skill Name" # REQUIRED: Max 64 chars
412
- description: "What this skill does # REQUIRED: Max 1024 chars
413
- and when Claude should use it." # Include BOTH what & when
414
- ---
415
-
416
- # Skill Name
417
-
418
- ## What This Skill Does
419
- [Instructions for Claude]
420
-
421
- ## Quick Start
422
- [Basic usage examples]
423
-
424
- ## Prerequisites
425
- [Requirements]
426
- ```
427
-
428
- ### Built-in Skills
429
-
430
- - **skill-builder** - Create new Claude Code Skills with proper structure
431
- - **agentdb-memory-patterns** - Persistent memory patterns for AI agents
432
- - **agentdb-vector-search** - Semantic search with AgentDB
433
- - **reasoningbank-intelligence** - Adaptive learning and pattern recognition
434
- - **swarm-orchestration** - Multi-agent coordination workflows
435
-
436
- ### Benefits
437
-
438
- - ✅ **Reusable**: Share skills across projects and teams
439
- - ✅ **Discoverable**: Claude finds and uses skills automatically
440
- - ✅ **Structured**: YAML frontmatter ensures consistency
441
- - ✅ **Progressive**: Expand details only when needed
442
- - ✅ **Validated**: Built-in validation catches errors early
443
-
444
- **Learn More:** [Skills Documentation](https://github.com/ruvnet/agentic-flow/tree/main/agentic-flow/.claude/skills)
445
-
446
- ---
447
-
448
384
  ## 🎛️ Programmatic API
449
385
 
450
386
  ### Multi-Model Router