Back to Ruflo

Agentic-Flow Integration

v2/docs/integrations/agentic-flow/README.md

3.6.307.4 KB
Original Source

Agentic-Flow Integration

Integration Status: ✅ Active & Released Latest Version: v1.7.4 (Export Issues RESOLVED!) npm Package: https://www.npmjs.com/package/agentic-flow/v/1.7.4 Integration Type: npm dependency Backwards Compatibility: 100% guaranteed

🎉 v1.7.4 Update: Export configuration issue from v1.7.1 is now FIXED! All advanced features (HybridReasoningBank, AdvancedMemorySystem) are now accessible via standard imports. See v1.7.4 Verification Report for details.


📚 Documentation

Release Information

Integration Guides

Technical Reports


🚀 Quick Start

Installation

bash
# Install agentic-flow (automatically included in claude-flow)
npm install agentic-flow@^1.7.0

# Or update existing installation
npm update agentic-flow

Basic Usage

typescript
import { ReasoningBankEngine } from 'agentic-flow/reasoningbank';
import { ReflexionMemory } from 'agentic-flow/agentdb';

// Initialize ReasoningBank
const rb = new ReasoningBankEngine();

// Store patterns
await rb.storePattern({
  sessionId: 'session-1',
  task: 'implement authentication',
  success: true,
  reward: 0.95
});

// Retrieve patterns
const patterns = await rb.retrievePatterns('authentication', { k: 5 });

🎯 What's New in v1.7.1 (Latest!)

🚀 ALL Advanced Features Now Available!

  1. WASM-Accelerated HybridReasoningBank

    • 116x Faster Search: WASM-accelerated similarity computation
    • CausalRecall Ranking: Utility-based pattern reranking
    • Strategy Learning: Evidence-based recommendations
    • Query Caching: 60s TTL, 90%+ hit rate
    • Auto-Consolidation: Patterns → skills automatically
  2. Advanced Memory System

    • Episodic Replay: Learn from past failures
    • What-If Analysis: Causal impact predictions
    • Skill Composition: Intelligent skill combining
    • NightlyLearner: Doubly robust learning
    • Automated Learning Cycles: Background optimization
  3. Complete AgentDB Integration

    • API Alignment: All controllers working
    • Import Resolution: Automatic patch applied
    • CausalMemoryGraph: Automatic edge tracking
    • 29 MCP Tools: Full Claude Desktop support
  4. Infrastructure

    • 56% Memory Reduction: SharedMemoryPool
    • 100% Backwards Compatible: All v1.7.0 code works
    • Production Ready: Docker validated, 100% test pass

See RELEASE-v1.7.1.md for complete details and API examples.


📊 Performance Benefits

Metricv1.6.xv1.7.0v1.7.1Improvement
Bundle Size5.2MB4.8MB4.8MB-7.7%
Memory (4 agents)800MB350MB350MB-56%
Cold Start3.5s1.2s1.2s-65%
Vector Search580ms580ms5ms116x faster
Query CachingNoneNone60s TTL90%+ hit rate
Causal RankingNoneBasicCausalRecallEnhanced

Claude-Flow Integration

Upstream Resources


💡 Best Practices

For Claude-Flow Users

  1. Automatic Benefits: Claude-flow uses "agentic-flow": "*" dependency

    • Always gets latest agentic-flow version
    • No manual updates needed
    • All performance improvements automatic
  2. Recommended Approach: Let claude-flow manage integration

    • Don't pin agentic-flow version
    • Trust semver for backwards compatibility
    • Update claude-flow to get agentic-flow updates
  3. Advanced Usage: Optional direct usage

    typescript
    // Use advanced features directly
    import { HybridReasoningBank } from 'agentic-flow/reasoningbank';
    import { AdvancedMemorySystem } from 'agentic-flow/reasoningbank';
    import { SharedMemoryPool } from 'agentic-flow/memory';
    

🧪 Testing

Run Integration Tests

bash
# Claude-flow integration tests
npm run test:integration

# Agentic-flow backwards compatibility
npx vitest tests/backwards-compatibility.test.ts

# Performance benchmarks
npm run bench:memory -- --agents 4
npm run bench:search -- --vectors 100000

📈 Roadmap

Upcoming Features (agentic-flow)

  • Phase 2 (Week 2): Code cleanup and tree-shaking
  • Phase 3 (Week 3): Hybrid backend with fallback
  • Phase 4 (Week 4): Final optimization and documentation

See agentic-flow#34 for details.

Claude-Flow Impact

All improvements automatically benefit claude-flow users:

  • No code changes required
  • Seamless updates via npm
  • 100% backwards compatibility guaranteed

🆘 Support

Issues and Questions

Documentation


✅ Migration Checklist

For users upgrading from v1.6.x to v1.7.0:

  • Read RELEASE-v1.7.0.md
  • Review MIGRATION_v1.7.0.md
  • Update package: npm update agentic-flow
  • Run tests: npm test
  • Verify performance: npm run bench:*
  • Update documentation if using new APIs

Note: For claude-flow users, run npm update in the claude-flow directory.


📞 Contact


Last Updated: 2025-01-24 This documentation is part of the claude-flow project.