agentic-flow 1.9.3 → 1.10.0
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.
- package/CHANGELOG.md +298 -0
- package/dist/cli-proxy.js +19 -1
- package/dist/core/long-running-agent.js +219 -0
- package/dist/core/provider-manager.js +434 -0
- package/dist/examples/use-provider-fallback.js +176 -0
- package/dist/proxy/adaptive-proxy.js +224 -0
- package/dist/proxy/anthropic-to-gemini.js +2 -2
- package/dist/proxy/http2-proxy-optimized.js +191 -0
- package/dist/proxy/http2-proxy.js +381 -0
- package/dist/proxy/http3-proxy-old.js +331 -0
- package/dist/proxy/http3-proxy.js +51 -0
- package/dist/proxy/websocket-proxy.js +406 -0
- package/dist/utils/auth.js +52 -0
- package/dist/utils/compression-middleware.js +149 -0
- package/dist/utils/connection-pool.js +184 -0
- package/dist/utils/rate-limiter.js +48 -0
- package/dist/utils/response-cache.js +211 -0
- package/dist/utils/streaming-optimizer.js +141 -0
- package/docs/.claude-flow/metrics/performance.json +3 -3
- package/docs/.claude-flow/metrics/task-metrics.json +3 -3
- package/docs/ISSUE-55-VALIDATION.md +152 -0
- package/docs/OPTIMIZATIONS.md +460 -0
- package/docs/README.md +217 -0
- package/docs/issues/ISSUE-xenova-transformers-dependency.md +380 -0
- package/docs/providers/LANDING-PAGE-PROVIDER-CONTENT.md +204 -0
- package/docs/providers/PROVIDER-FALLBACK-GUIDE.md +619 -0
- package/docs/providers/PROVIDER-FALLBACK-SUMMARY.md +418 -0
- package/package.json +1 -1
- package/scripts/claude +31 -0
- package/validation/test-gemini-exclusiveMinimum-fix.ts +142 -0
- package/validation/test-provider-fallback.ts +285 -0
- package/validation/validate-v1.10.0-docker.sh +296 -0
- package/wasm/reasoningbank/reasoningbank_wasm_bg.js +2 -2
- package/wasm/reasoningbank/reasoningbank_wasm_bg.wasm +0 -0
- package/docs/INDEX.md +0 -279
- package/docs/guides/.claude-flow/metrics/agent-metrics.json +0 -1
- package/docs/guides/.claude-flow/metrics/performance.json +0 -9
- package/docs/guides/.claude-flow/metrics/task-metrics.json +0 -10
- package/docs/router/.claude-flow/metrics/agent-metrics.json +0 -1
- package/docs/router/.claude-flow/metrics/performance.json +0 -9
- package/docs/router/.claude-flow/metrics/task-metrics.json +0 -10
- /package/docs/{TEST-V1.7.8.Dockerfile → docker-tests/TEST-V1.7.8.Dockerfile} +0 -0
- /package/docs/{TEST-V1.7.9-NODE20.Dockerfile → docker-tests/TEST-V1.7.9-NODE20.Dockerfile} +0 -0
- /package/docs/{TEST-V1.7.9.Dockerfile → docker-tests/TEST-V1.7.9.Dockerfile} +0 -0
- /package/docs/{v1.7.1-QUICK-START.md → guides/QUICK-START-v1.7.1.md} +0 -0
- /package/docs/{INTEGRATION-COMPLETE.md → integration-docs/INTEGRATION-COMPLETE.md} +0 -0
- /package/docs/{QUIC_FINAL_STATUS.md → quic/QUIC_FINAL_STATUS.md} +0 -0
- /package/docs/{README_QUIC_PHASE1.md → quic/README_QUIC_PHASE1.md} +0 -0
- /package/docs/{AGENTDB_TESTING.md → testing/AGENTDB_TESTING.md} +0 -0
package/docs/INDEX.md
DELETED
|
@@ -1,279 +0,0 @@
|
|
|
1
|
-
# Agentic Flow Documentation Index
|
|
2
|
-
|
|
3
|
-
Complete documentation for the Agentic Flow multi-agent orchestration system.
|
|
4
|
-
|
|
5
|
-
## 📋 Quick Navigation
|
|
6
|
-
|
|
7
|
-
### 🚀 Start Here
|
|
8
|
-
- **[README](../README.md)** - Project overview and getting started
|
|
9
|
-
- **[CLAUDE.md](CLAUDE.md)** - Claude Code configuration and SPARC methodology
|
|
10
|
-
- **[PACKAGE_STRUCTURE.md](architecture/PACKAGE_STRUCTURE.md)** - Package organization and structure
|
|
11
|
-
- **[STANDALONE_PROXY_GUIDE.md](guides/STANDALONE_PROXY_GUIDE.md)** - Standalone proxy server setup
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
## 📚 Documentation Categories
|
|
16
|
-
|
|
17
|
-
### 📖 [User Guides](guides/)
|
|
18
|
-
Practical guides and tutorials for using the system.
|
|
19
|
-
|
|
20
|
-
- [Agent SDK Guide](guides/agent-sdk.md) - Building custom agents
|
|
21
|
-
- [Docker Agent Usage](guides/DOCKER_AGENT_USAGE.md) - Running agents in containers
|
|
22
|
-
- [Alternative LLM Models](guides/ALTERNATIVE_LLM_MODELS.md) - Using different language models
|
|
23
|
-
- [Implementation Examples](guides/IMPLEMENTATION_EXAMPLES.md) - Real-world patterns
|
|
24
|
-
- [NPM Publishing Guide](guides/NPM-PUBLISH.md) - Package publishing
|
|
25
|
-
- [ONNX CLI Usage](guides/ONNX_CLI_USAGE.md) - ONNX command-line interface
|
|
26
|
-
- [ONNX Optimization Guide](guides/ONNX_OPTIMIZATION_GUIDE.md) - Performance optimization
|
|
27
|
-
- [OpenRouter Deployment](guides/OPENROUTER_DEPLOYMENT.md) - OpenRouter setup
|
|
28
|
-
|
|
29
|
-
### 🏗️ [Architecture](architecture/)
|
|
30
|
-
System design, planning, and technical architecture.
|
|
31
|
-
|
|
32
|
-
- [Executive Summary](architecture/EXECUTIVE_SUMMARY.md) - High-level overview
|
|
33
|
-
- [Integration Status](architecture/INTEGRATION-STATUS.md) - Current integration status
|
|
34
|
-
- [Research Summary](architecture/RESEARCH_SUMMARY.md) - Technical research findings
|
|
35
|
-
- [Multi-Model Router Plan](architecture/MULTI_MODEL_ROUTER_PLAN.md) - Router architecture
|
|
36
|
-
- [Improvement Plan](architecture/IMPROVEMENT_PLAN.md) - System improvement roadmap
|
|
37
|
-
- [Quick Wins](architecture/QUICK_WINS.md) - High-impact improvements
|
|
38
|
-
|
|
39
|
-
### 🔌 [Integrations](integrations/)
|
|
40
|
-
Integration guides for external services and frameworks.
|
|
41
|
-
|
|
42
|
-
- [Claude Agents Integration](integrations/CLAUDE_AGENTS_INTEGRATION.md) - Claude agents setup
|
|
43
|
-
- [Claude Flow Integration](integrations/CLAUDE_FLOW_INTEGRATION.md) - Claude Flow orchestration
|
|
44
|
-
- [Flow Nexus Integration](integrations/FLOW-NEXUS-INTEGRATION.md) - Cloud platform integration
|
|
45
|
-
- [FastMCP CLI Integration](integrations/FASTMCP_CLI_INTEGRATION.md) - MCP command-line tools
|
|
46
|
-
- [FastMCP Implementation Plan](integrations/fastmcp-implementation-plan.md) - Detailed MCP strategy
|
|
47
|
-
- [FastMCP POC Integration](integrations/fastmcp-poc-integration.md) - Proof of concept
|
|
48
|
-
|
|
49
|
-
### 🔧 [Router Documentation](router/)
|
|
50
|
-
Multi-model router configuration and usage.
|
|
51
|
-
|
|
52
|
-
- [Router Overview](router/README.md) - Router system overview
|
|
53
|
-
- [Router User Guide](router/ROUTER_USER_GUIDE.md) - Using the router
|
|
54
|
-
- [Router Config Reference](router/ROUTER_CONFIG_REFERENCE.md) - Configuration options
|
|
55
|
-
- [Top 20 Models Matrix](router/TOP20_MODELS_MATRIX.md) - Model comparison guide
|
|
56
|
-
|
|
57
|
-
### ✅ [Testing & Validation](testing/)
|
|
58
|
-
Current test results and development testing documentation.
|
|
59
|
-
|
|
60
|
-
- [Testing Overview](testing/README.md) - Current testing documentation
|
|
61
|
-
- [Agent System Validation](testing/AGENT-SYSTEM-VALIDATION.md) - Multi-agent testing
|
|
62
|
-
- [Final Testing Summary](testing/FINAL-TESTING-SUMMARY.md) - Comprehensive coverage
|
|
63
|
-
- [Regression Test Results](testing/REGRESSION-TEST-RESULTS.md) - Regression testing
|
|
64
|
-
- [Streaming & MCP Validation](testing/STREAMING-AND-MCP-VALIDATION.md) - Integration tests
|
|
65
|
-
|
|
66
|
-
For production validation reports, see [Validation Reports](validation-reports/)
|
|
67
|
-
|
|
68
|
-
### 🔍 [MCP Validation](mcp-validation/)
|
|
69
|
-
Model Context Protocol implementation and validation.
|
|
70
|
-
|
|
71
|
-
- [MCP Validation Overview](mcp-validation/README.md) - MCP testing documentation
|
|
72
|
-
- [Implementation Summary](mcp-validation/IMPLEMENTATION-SUMMARY.md) - MCP implementation
|
|
73
|
-
- [CLI Validation Report](mcp-validation/MCP-CLI-VALIDATION-REPORT.md) - CLI tool testing
|
|
74
|
-
- [Strange Loops Test](mcp-validation/strange-loops-test.md) - Advanced patterns
|
|
75
|
-
|
|
76
|
-
### 📦 [Version Releases](version-releases/)
|
|
77
|
-
Version-specific release notes and publishing documentation.
|
|
78
|
-
|
|
79
|
-
- [Release Overview](version-releases/README.md) - Release documentation index
|
|
80
|
-
- [v1.5.11 Publication Report](version-releases/PUBLICATION_REPORT_v1.5.11.md) - Latest release
|
|
81
|
-
- [v1.5.9 Release Summary](version-releases/v1.5.9-RELEASE-SUMMARY.md) - Previous release
|
|
82
|
-
- [v1.5.9 Docker Verification](version-releases/v1.5.9-DOCKER-VERIFICATION.md) - Docker validation
|
|
83
|
-
|
|
84
|
-
### 🧠 [ReasoningBank](reasoningbank/)
|
|
85
|
-
Cognitive memory system with pattern recognition and adaptive learning.
|
|
86
|
-
|
|
87
|
-
- [ReasoningBank Overview](reasoningbank/README.md) - Feature documentation index
|
|
88
|
-
- [Architecture](reasoningbank/REASONINGBANK_ARCHITECTURE.md) - System architecture
|
|
89
|
-
- [Backends](reasoningbank/REASONINGBANK_BACKENDS.md) - Storage backend options
|
|
90
|
-
- [Validation](reasoningbank/REASONINGBANK_VALIDATION.md) - Testing and validation
|
|
91
|
-
- [Benchmarks](reasoningbank/REASONINGBANK-BENCHMARK-RESULTS.md) - Performance metrics
|
|
92
|
-
|
|
93
|
-
### ✅ [Validation Reports](validation-reports/)
|
|
94
|
-
Comprehensive testing, benchmarking, and quality assurance reports.
|
|
95
|
-
|
|
96
|
-
- [Validation Overview](validation-reports/README.md) - Testing documentation index
|
|
97
|
-
- [Performance Benchmarks](validation-reports/BENCHMARK_AND_OPTIMIZATION_REPORT.md) - Optimization analysis
|
|
98
|
-
- [Docker Validation](validation-reports/DOCKER_VALIDATION_RESULTS.md) - Container testing
|
|
99
|
-
- [Regression Tests](validation-reports/NO_REGRESSIONS_CONFIRMED.md) - Stability verification
|
|
100
|
-
- [Alpha Validation](validation-reports/V2.7.0-ALPHA.10_FINAL_VALIDATION.md) - Release validation
|
|
101
|
-
|
|
102
|
-
### 🔌 [Integration Documentation](integration-docs/)
|
|
103
|
-
System integrations, implementations, and compatibility reports.
|
|
104
|
-
|
|
105
|
-
- [Integration Overview](integration-docs/README.md) - Integration documentation index
|
|
106
|
-
- [Agent Booster](integration-docs/AGENT-BOOSTER-INTEGRATION.md) - Ultra-fast code editing
|
|
107
|
-
- [Claude Flow](integration-docs/CLAUDE-FLOW-INTEGRATION-ANALYSIS.md) - Orchestration integration
|
|
108
|
-
- [WASM Integration](integration-docs/WASM_INTEGRATION_COMPLETE.md) - WebAssembly support
|
|
109
|
-
- [CLI Tools](integration-docs/CLI-INTEGRATION-COMPLETE.md) - Command-line integration
|
|
110
|
-
|
|
111
|
-
### 🔬 [Quantum Research](quantum-research/)
|
|
112
|
-
Quantum computing research, literature reviews, and experimental plans.
|
|
113
|
-
|
|
114
|
-
- [Quantum Overview](quantum-research/README.md) - Research documentation index
|
|
115
|
-
- [Literature Review](quantum-research/QUANTUM_RESEARCH_LITERATURE_REVIEW.md) - Comprehensive research
|
|
116
|
-
- [Observer-Agnostic Experiment](../examples/Observer-Agnostic%20Measurement%20and%20No-Retrocausal%20Marginals%20Theorem/) - Quantum measurement testing
|
|
117
|
-
|
|
118
|
-
### 🗄️ [Validation Archive](validation/)
|
|
119
|
-
Historical validation reports and test archives.
|
|
120
|
-
|
|
121
|
-
- [Validation Archive](validation/README.md) - Archived test reports
|
|
122
|
-
|
|
123
|
-
### 📦 [Archived](archived/)
|
|
124
|
-
Historical documentation, completed implementations, and validation reports.
|
|
125
|
-
|
|
126
|
-
#### Validation Reports (Archived)
|
|
127
|
-
- Version-specific validation (v1.1.10, v1.1.11)
|
|
128
|
-
- MCP proxy validation
|
|
129
|
-
- OpenRouter integration validation
|
|
130
|
-
- Docker deployment validation
|
|
131
|
-
- SDK integration reports
|
|
132
|
-
- Model validation reports
|
|
133
|
-
|
|
134
|
-
#### Completed Implementations
|
|
135
|
-
- [Research Complete](archived/RESEARCH_COMPLETE.txt) - Historical research
|
|
136
|
-
- [FastMCP Complete](archived/FASTMCP_COMPLETE.md) - FastMCP completion
|
|
137
|
-
- [Flow Nexus Complete](archived/FLOW-NEXUS-COMPLETE.md) - Flow Nexus completion
|
|
138
|
-
- [OpenRouter Proxy Complete](archived/OPENROUTER_PROXY_COMPLETE.md) - OpenRouter completion
|
|
139
|
-
- [Package Complete](archived/PACKAGE-COMPLETE.md) - Package completion
|
|
140
|
-
- [SDK Setup Complete](archived/SDK-SETUP-COMPLETE.md) - SDK setup completion
|
|
141
|
-
- ONNX implementation reports
|
|
142
|
-
- Integration confirmation reports
|
|
143
|
-
|
|
144
|
-
#### Historical Guides
|
|
145
|
-
- ONNX integration guides (superseded by current guides)
|
|
146
|
-
- Optimization summaries (superseded)
|
|
147
|
-
- Provider instruction optimization
|
|
148
|
-
- Tool instruction enhancements
|
|
149
|
-
|
|
150
|
-
#### Research & Planning
|
|
151
|
-
- ONNX Phi4 research
|
|
152
|
-
- ONNX Runtime integration planning
|
|
153
|
-
- Phi4 hyperoptimization plans
|
|
154
|
-
|
|
155
|
-
---
|
|
156
|
-
|
|
157
|
-
## 🎯 Reading Paths
|
|
158
|
-
|
|
159
|
-
### Path 1: New Users (30 minutes)
|
|
160
|
-
1. [Main README](../README.md) - Project overview (10 min)
|
|
161
|
-
2. [Claude Config](CLAUDE.md) - Development setup (10 min)
|
|
162
|
-
3. [User Guides](guides/) - Practical tutorials (10 min)
|
|
163
|
-
|
|
164
|
-
### Path 2: Developers (1.5 hours)
|
|
165
|
-
1. [Architecture Overview](architecture/EXECUTIVE_SUMMARY.md) - System design (20 min)
|
|
166
|
-
2. [Implementation Examples](guides/IMPLEMENTATION_EXAMPLES.md) - Code patterns (40 min)
|
|
167
|
-
3. [Integration Guides](integrations/) - External services (20 min)
|
|
168
|
-
4. [Testing Documentation](testing/) - Quality assurance (10 min)
|
|
169
|
-
|
|
170
|
-
### Path 3: System Architects (2 hours)
|
|
171
|
-
1. [Research Summary](architecture/RESEARCH_SUMMARY.md) - Technical findings (30 min)
|
|
172
|
-
2. [Multi-Model Router Plan](architecture/MULTI_MODEL_ROUTER_PLAN.md) - Router architecture (45 min)
|
|
173
|
-
3. [Integration Status](architecture/INTEGRATION-STATUS.md) - Current state (20 min)
|
|
174
|
-
4. [Router Documentation](router/) - Configuration and usage (15 min)
|
|
175
|
-
5. [MCP Validation](mcp-validation/) - Protocol implementation (10 min)
|
|
176
|
-
|
|
177
|
-
---
|
|
178
|
-
|
|
179
|
-
## 📊 Key Features
|
|
180
|
-
|
|
181
|
-
### Multi-Agent Orchestration
|
|
182
|
-
- Hierarchical, mesh, and hybrid topologies
|
|
183
|
-
- Parallel and sequential execution patterns
|
|
184
|
-
- Claude Flow integration for coordination
|
|
185
|
-
- 54+ specialized agent types
|
|
186
|
-
|
|
187
|
-
### SPARC Methodology
|
|
188
|
-
- Specification → Pseudocode → Architecture → Refinement → Completion
|
|
189
|
-
- Test-driven development workflow
|
|
190
|
-
- Automated task orchestration
|
|
191
|
-
- Neural pattern learning
|
|
192
|
-
|
|
193
|
-
### Model Router
|
|
194
|
-
- Multi-model support (Claude, OpenRouter, ONNX, Gemini)
|
|
195
|
-
- Intelligent model selection
|
|
196
|
-
- Cost optimization
|
|
197
|
-
- Performance monitoring
|
|
198
|
-
|
|
199
|
-
### Cloud Integration
|
|
200
|
-
- Flow Nexus platform support
|
|
201
|
-
- E2B sandbox execution
|
|
202
|
-
- Real-time streaming and monitoring
|
|
203
|
-
- 70+ MCP orchestration tools
|
|
204
|
-
|
|
205
|
-
---
|
|
206
|
-
|
|
207
|
-
## 🔗 External Resources
|
|
208
|
-
|
|
209
|
-
### Official Documentation
|
|
210
|
-
- [Claude Agent SDK](https://docs.claude.com/en/api/agent-sdk/overview)
|
|
211
|
-
- [Model Context Protocol](https://modelcontextprotocol.io/)
|
|
212
|
-
- [Agentic Flow GitHub](https://github.com/ruvnet/agentic-flow)
|
|
213
|
-
- [Flow Nexus Platform](https://flow-nexus.ruv.io)
|
|
214
|
-
|
|
215
|
-
### Community
|
|
216
|
-
- [GitHub Issues](https://github.com/ruvnet/agentic-flow/issues)
|
|
217
|
-
|
|
218
|
-
---
|
|
219
|
-
|
|
220
|
-
## 📞 Getting Help
|
|
221
|
-
|
|
222
|
-
### Documentation Questions
|
|
223
|
-
1. Check the relevant category above
|
|
224
|
-
2. Review the README for each section
|
|
225
|
-
3. Search for specific topics in the index
|
|
226
|
-
|
|
227
|
-
### Implementation Support
|
|
228
|
-
1. Review [Implementation Examples](guides/IMPLEMENTATION_EXAMPLES.md)
|
|
229
|
-
2. Check [Integration Guides](integrations/)
|
|
230
|
-
3. Consult [Router Documentation](router/)
|
|
231
|
-
|
|
232
|
-
### Architecture Questions
|
|
233
|
-
1. Read [Architecture Documentation](architecture/)
|
|
234
|
-
2. Review [Router Documentation](router/)
|
|
235
|
-
3. Check [Integration Status](architecture/INTEGRATION-STATUS.md)
|
|
236
|
-
|
|
237
|
-
---
|
|
238
|
-
|
|
239
|
-
## 🎯 Quick Links
|
|
240
|
-
|
|
241
|
-
- **License**: [MIT License](LICENSE)
|
|
242
|
-
- **Changelog**: [CHANGELOG.md](../CHANGELOG.md)
|
|
243
|
-
- **Contributing**: See main [README](../README.md)
|
|
244
|
-
- **Issues**: [GitHub Issues](https://github.com/ruvnet/agentic-flow/issues)
|
|
245
|
-
|
|
246
|
-
---
|
|
247
|
-
|
|
248
|
-
## 📂 Documentation Organization
|
|
249
|
-
|
|
250
|
-
### Active Documentation
|
|
251
|
-
All current and actively maintained documentation is organized in the category directories above.
|
|
252
|
-
|
|
253
|
-
### Archived Content
|
|
254
|
-
Historical reports, completed implementations, and superseded guides are in the [archived/](archived/) directory for reference.
|
|
255
|
-
|
|
256
|
-
---
|
|
257
|
-
|
|
258
|
-
**Documentation Status**: ✅ Reorganized and up-to-date
|
|
259
|
-
**Last Updated**: October 14, 2025
|
|
260
|
-
|
|
261
|
-
## 📋 Recent Documentation Updates
|
|
262
|
-
|
|
263
|
-
**v2.7.0 Reorganization (Oct 14, 2025)**:
|
|
264
|
-
- Created `reasoningbank/` for all ReasoningBank feature documentation
|
|
265
|
-
- Created `validation-reports/` for production testing and validation
|
|
266
|
-
- Created `integration-docs/` for system integration documentation
|
|
267
|
-
- Created `quantum-research/` for quantum computing research
|
|
268
|
-
- Created `version-releases/` for release notes and changelogs
|
|
269
|
-
- Added comprehensive README files to all new categories
|
|
270
|
-
- Consolidated loose files into organized subdirectories
|
|
271
|
-
- Improved navigation and discoverability
|
|
272
|
-
|
|
273
|
-
**v2.0 Reorganization (Oct 6, 2025)**:
|
|
274
|
-
- Created dedicated `releases/` directory for version-specific documentation
|
|
275
|
-
- Consolidated testing reports into `testing/` directory
|
|
276
|
-
- Separated MCP validation into dedicated `mcp-validation/` section
|
|
277
|
-
- Added comprehensive READMEs to all major sections
|
|
278
|
-
- Archived historical v1.1.x releases for cleaner navigation
|
|
279
|
-
- Improved documentation index with better categorization
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{}
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|