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.
Files changed (49) hide show
  1. package/CHANGELOG.md +298 -0
  2. package/dist/cli-proxy.js +19 -1
  3. package/dist/core/long-running-agent.js +219 -0
  4. package/dist/core/provider-manager.js +434 -0
  5. package/dist/examples/use-provider-fallback.js +176 -0
  6. package/dist/proxy/adaptive-proxy.js +224 -0
  7. package/dist/proxy/anthropic-to-gemini.js +2 -2
  8. package/dist/proxy/http2-proxy-optimized.js +191 -0
  9. package/dist/proxy/http2-proxy.js +381 -0
  10. package/dist/proxy/http3-proxy-old.js +331 -0
  11. package/dist/proxy/http3-proxy.js +51 -0
  12. package/dist/proxy/websocket-proxy.js +406 -0
  13. package/dist/utils/auth.js +52 -0
  14. package/dist/utils/compression-middleware.js +149 -0
  15. package/dist/utils/connection-pool.js +184 -0
  16. package/dist/utils/rate-limiter.js +48 -0
  17. package/dist/utils/response-cache.js +211 -0
  18. package/dist/utils/streaming-optimizer.js +141 -0
  19. package/docs/.claude-flow/metrics/performance.json +3 -3
  20. package/docs/.claude-flow/metrics/task-metrics.json +3 -3
  21. package/docs/ISSUE-55-VALIDATION.md +152 -0
  22. package/docs/OPTIMIZATIONS.md +460 -0
  23. package/docs/README.md +217 -0
  24. package/docs/issues/ISSUE-xenova-transformers-dependency.md +380 -0
  25. package/docs/providers/LANDING-PAGE-PROVIDER-CONTENT.md +204 -0
  26. package/docs/providers/PROVIDER-FALLBACK-GUIDE.md +619 -0
  27. package/docs/providers/PROVIDER-FALLBACK-SUMMARY.md +418 -0
  28. package/package.json +1 -1
  29. package/scripts/claude +31 -0
  30. package/validation/test-gemini-exclusiveMinimum-fix.ts +142 -0
  31. package/validation/test-provider-fallback.ts +285 -0
  32. package/validation/validate-v1.10.0-docker.sh +296 -0
  33. package/wasm/reasoningbank/reasoningbank_wasm_bg.js +2 -2
  34. package/wasm/reasoningbank/reasoningbank_wasm_bg.wasm +0 -0
  35. package/docs/INDEX.md +0 -279
  36. package/docs/guides/.claude-flow/metrics/agent-metrics.json +0 -1
  37. package/docs/guides/.claude-flow/metrics/performance.json +0 -9
  38. package/docs/guides/.claude-flow/metrics/task-metrics.json +0 -10
  39. package/docs/router/.claude-flow/metrics/agent-metrics.json +0 -1
  40. package/docs/router/.claude-flow/metrics/performance.json +0 -9
  41. package/docs/router/.claude-flow/metrics/task-metrics.json +0 -10
  42. /package/docs/{TEST-V1.7.8.Dockerfile → docker-tests/TEST-V1.7.8.Dockerfile} +0 -0
  43. /package/docs/{TEST-V1.7.9-NODE20.Dockerfile → docker-tests/TEST-V1.7.9-NODE20.Dockerfile} +0 -0
  44. /package/docs/{TEST-V1.7.9.Dockerfile → docker-tests/TEST-V1.7.9.Dockerfile} +0 -0
  45. /package/docs/{v1.7.1-QUICK-START.md → guides/QUICK-START-v1.7.1.md} +0 -0
  46. /package/docs/{INTEGRATION-COMPLETE.md → integration-docs/INTEGRATION-COMPLETE.md} +0 -0
  47. /package/docs/{QUIC_FINAL_STATUS.md → quic/QUIC_FINAL_STATUS.md} +0 -0
  48. /package/docs/{README_QUIC_PHASE1.md → quic/README_QUIC_PHASE1.md} +0 -0
  49. /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,9 +0,0 @@
1
- {
2
- "startTime": 1759674877006,
3
- "totalTasks": 1,
4
- "successfulTasks": 1,
5
- "failedTasks": 0,
6
- "totalAgents": 0,
7
- "activeAgents": 0,
8
- "neuralEvents": 0
9
- }
@@ -1,10 +0,0 @@
1
- [
2
- {
3
- "id": "cmd-hooks-1759674877140",
4
- "type": "hooks",
5
- "success": true,
6
- "duration": 7.498020000000054,
7
- "timestamp": 1759674877147,
8
- "metadata": {}
9
- }
10
- ]
@@ -1,9 +0,0 @@
1
- {
2
- "startTime": 1759674801537,
3
- "totalTasks": 1,
4
- "successfulTasks": 1,
5
- "failedTasks": 0,
6
- "totalAgents": 0,
7
- "activeAgents": 0,
8
- "neuralEvents": 0
9
- }
@@ -1,10 +0,0 @@
1
- [
2
- {
3
- "id": "cmd-hooks-1759674801675",
4
- "type": "hooks",
5
- "success": true,
6
- "duration": 6.8613129999999956,
7
- "timestamp": 1759674801682,
8
- "metadata": {}
9
- }
10
- ]