@sparkleideas/agentic-flow 2.0.2-alpha-patch.1

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 (641) hide show
  1. package/README.md +2026 -0
  2. package/agentic-flow/.claude/agents/MIGRATION_SUMMARY.md +222 -0
  3. package/agentic-flow/.claude/agents/README.md +89 -0
  4. package/agentic-flow/.claude/agents/analysis/analyze-code-quality.md +180 -0
  5. package/agentic-flow/.claude/agents/analysis/code-analyzer.md +209 -0
  6. package/agentic-flow/.claude/agents/architecture/arch-system-design.md +156 -0
  7. package/agentic-flow/.claude/agents/base-template-generator.md +268 -0
  8. package/agentic-flow/.claude/agents/consensus/README.md +253 -0
  9. package/agentic-flow/.claude/agents/consensus/byzantine-coordinator.md +63 -0
  10. package/agentic-flow/.claude/agents/consensus/crdt-synchronizer.md +997 -0
  11. package/agentic-flow/.claude/agents/consensus/gossip-coordinator.md +63 -0
  12. package/agentic-flow/.claude/agents/consensus/performance-benchmarker.md +851 -0
  13. package/agentic-flow/.claude/agents/consensus/quorum-manager.md +823 -0
  14. package/agentic-flow/.claude/agents/consensus/raft-manager.md +63 -0
  15. package/agentic-flow/.claude/agents/consensus/security-manager.md +622 -0
  16. package/agentic-flow/.claude/agents/core/coder.md +416 -0
  17. package/agentic-flow/.claude/agents/core/planner.md +337 -0
  18. package/agentic-flow/.claude/agents/core/researcher.md +331 -0
  19. package/agentic-flow/.claude/agents/core/reviewer.md +483 -0
  20. package/agentic-flow/.claude/agents/core/tester.md +476 -0
  21. package/agentic-flow/.claude/agents/custom/test-long-runner.md +44 -0
  22. package/agentic-flow/.claude/agents/data/data-ml-model.md +444 -0
  23. package/agentic-flow/.claude/agents/development/dev-backend-api.md +345 -0
  24. package/agentic-flow/.claude/agents/devops/ops-cicd-github.md +164 -0
  25. package/agentic-flow/.claude/agents/documentation/docs-api-openapi.md +354 -0
  26. package/agentic-flow/.claude/agents/flow-nexus/app-store.md +88 -0
  27. package/agentic-flow/.claude/agents/flow-nexus/authentication.md +69 -0
  28. package/agentic-flow/.claude/agents/flow-nexus/challenges.md +81 -0
  29. package/agentic-flow/.claude/agents/flow-nexus/neural-network.md +88 -0
  30. package/agentic-flow/.claude/agents/flow-nexus/payments.md +83 -0
  31. package/agentic-flow/.claude/agents/flow-nexus/sandbox.md +76 -0
  32. package/agentic-flow/.claude/agents/flow-nexus/swarm.md +76 -0
  33. package/agentic-flow/.claude/agents/flow-nexus/user-tools.md +96 -0
  34. package/agentic-flow/.claude/agents/flow-nexus/workflow.md +84 -0
  35. package/agentic-flow/.claude/agents/github/code-review-swarm.md +377 -0
  36. package/agentic-flow/.claude/agents/github/github-modes.md +173 -0
  37. package/agentic-flow/.claude/agents/github/issue-tracker.md +576 -0
  38. package/agentic-flow/.claude/agents/github/multi-repo-swarm.md +553 -0
  39. package/agentic-flow/.claude/agents/github/pr-manager.md +438 -0
  40. package/agentic-flow/.claude/agents/github/project-board-sync.md +509 -0
  41. package/agentic-flow/.claude/agents/github/release-manager.md +605 -0
  42. package/agentic-flow/.claude/agents/github/release-swarm.md +583 -0
  43. package/agentic-flow/.claude/agents/github/repo-architect.md +398 -0
  44. package/agentic-flow/.claude/agents/github/swarm-issue.md +573 -0
  45. package/agentic-flow/.claude/agents/github/swarm-pr.md +428 -0
  46. package/agentic-flow/.claude/agents/github/sync-coordinator.md +452 -0
  47. package/agentic-flow/.claude/agents/github/workflow-automation.md +903 -0
  48. package/agentic-flow/.claude/agents/goal/agent.md +816 -0
  49. package/agentic-flow/.claude/agents/goal/goal-planner.md +73 -0
  50. package/agentic-flow/.claude/agents/optimization/README.md +250 -0
  51. package/agentic-flow/.claude/agents/optimization/benchmark-suite.md +665 -0
  52. package/agentic-flow/.claude/agents/optimization/load-balancer.md +431 -0
  53. package/agentic-flow/.claude/agents/optimization/performance-monitor.md +672 -0
  54. package/agentic-flow/.claude/agents/optimization/resource-allocator.md +674 -0
  55. package/agentic-flow/.claude/agents/optimization/topology-optimizer.md +808 -0
  56. package/agentic-flow/.claude/agents/payments/agentic-payments.md +126 -0
  57. package/agentic-flow/.claude/agents/sona/sona-learning-optimizer.md +496 -0
  58. package/agentic-flow/.claude/agents/sparc/architecture.md +699 -0
  59. package/agentic-flow/.claude/agents/sparc/pseudocode.md +520 -0
  60. package/agentic-flow/.claude/agents/sparc/refinement.md +802 -0
  61. package/agentic-flow/.claude/agents/sparc/specification.md +478 -0
  62. package/agentic-flow/.claude/agents/specialized/spec-mobile-react-native.md +226 -0
  63. package/agentic-flow/.claude/agents/sublinear/consensus-coordinator.md +338 -0
  64. package/agentic-flow/.claude/agents/sublinear/matrix-optimizer.md +185 -0
  65. package/agentic-flow/.claude/agents/sublinear/pagerank-analyzer.md +299 -0
  66. package/agentic-flow/.claude/agents/sublinear/performance-optimizer.md +368 -0
  67. package/agentic-flow/.claude/agents/sublinear/trading-predictor.md +246 -0
  68. package/agentic-flow/.claude/agents/swarm/README.md +190 -0
  69. package/agentic-flow/.claude/agents/swarm/adaptive-coordinator.md +1127 -0
  70. package/agentic-flow/.claude/agents/swarm/hierarchical-coordinator.md +710 -0
  71. package/agentic-flow/.claude/agents/swarm/mesh-coordinator.md +963 -0
  72. package/agentic-flow/.claude/agents/templates/automation-smart-agent.md +205 -0
  73. package/agentic-flow/.claude/agents/templates/coordinator-swarm-init.md +90 -0
  74. package/agentic-flow/.claude/agents/templates/github-pr-manager.md +177 -0
  75. package/agentic-flow/.claude/agents/templates/implementer-sparc-coder.md +259 -0
  76. package/agentic-flow/.claude/agents/templates/memory-coordinator.md +187 -0
  77. package/agentic-flow/.claude/agents/templates/migration-plan.md +746 -0
  78. package/agentic-flow/.claude/agents/templates/orchestrator-task.md +139 -0
  79. package/agentic-flow/.claude/agents/templates/performance-analyzer.md +199 -0
  80. package/agentic-flow/.claude/agents/templates/sparc-coordinator.md +514 -0
  81. package/agentic-flow/.claude/agents/testing/production-validator.md +395 -0
  82. package/agentic-flow/.claude/agents/testing/tdd-london-swarm.md +244 -0
  83. package/agentic-flow/.claude/answer.md +1 -0
  84. package/agentic-flow/.claude/commands/agents/README.md +10 -0
  85. package/agentic-flow/.claude/commands/agents/agent-capabilities.md +21 -0
  86. package/agentic-flow/.claude/commands/agents/agent-coordination.md +28 -0
  87. package/agentic-flow/.claude/commands/agents/agent-spawning.md +28 -0
  88. package/agentic-flow/.claude/commands/agents/agent-types.md +26 -0
  89. package/agentic-flow/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +54 -0
  90. package/agentic-flow/.claude/commands/analysis/README.md +9 -0
  91. package/agentic-flow/.claude/commands/analysis/bottleneck-detect.md +162 -0
  92. package/agentic-flow/.claude/commands/analysis/performance-bottlenecks.md +59 -0
  93. package/agentic-flow/.claude/commands/analysis/performance-report.md +25 -0
  94. package/agentic-flow/.claude/commands/analysis/token-efficiency.md +45 -0
  95. package/agentic-flow/.claude/commands/analysis/token-usage.md +25 -0
  96. package/agentic-flow/.claude/commands/automation/README.md +9 -0
  97. package/agentic-flow/.claude/commands/automation/auto-agent.md +122 -0
  98. package/agentic-flow/.claude/commands/automation/self-healing.md +106 -0
  99. package/agentic-flow/.claude/commands/automation/session-memory.md +90 -0
  100. package/agentic-flow/.claude/commands/automation/smart-agents.md +73 -0
  101. package/agentic-flow/.claude/commands/automation/smart-spawn.md +25 -0
  102. package/agentic-flow/.claude/commands/automation/workflow-select.md +25 -0
  103. package/agentic-flow/.claude/commands/claude-flow-help.md +103 -0
  104. package/agentic-flow/.claude/commands/claude-flow-memory.md +107 -0
  105. package/agentic-flow/.claude/commands/claude-flow-swarm.md +205 -0
  106. package/agentic-flow/.claude/commands/flow-nexus/app-store.md +124 -0
  107. package/agentic-flow/.claude/commands/flow-nexus/challenges.md +120 -0
  108. package/agentic-flow/.claude/commands/flow-nexus/login-registration.md +65 -0
  109. package/agentic-flow/.claude/commands/flow-nexus/neural-network.md +134 -0
  110. package/agentic-flow/.claude/commands/flow-nexus/payments.md +116 -0
  111. package/agentic-flow/.claude/commands/flow-nexus/sandbox.md +83 -0
  112. package/agentic-flow/.claude/commands/flow-nexus/swarm.md +87 -0
  113. package/agentic-flow/.claude/commands/flow-nexus/user-tools.md +152 -0
  114. package/agentic-flow/.claude/commands/flow-nexus/workflow.md +115 -0
  115. package/agentic-flow/.claude/commands/github/README.md +11 -0
  116. package/agentic-flow/.claude/commands/github/code-review-swarm.md +514 -0
  117. package/agentic-flow/.claude/commands/github/code-review.md +25 -0
  118. package/agentic-flow/.claude/commands/github/github-modes.md +147 -0
  119. package/agentic-flow/.claude/commands/github/github-swarm.md +121 -0
  120. package/agentic-flow/.claude/commands/github/issue-tracker.md +292 -0
  121. package/agentic-flow/.claude/commands/github/issue-triage.md +25 -0
  122. package/agentic-flow/.claude/commands/github/multi-repo-swarm.md +519 -0
  123. package/agentic-flow/.claude/commands/github/pr-enhance.md +26 -0
  124. package/agentic-flow/.claude/commands/github/pr-manager.md +170 -0
  125. package/agentic-flow/.claude/commands/github/project-board-sync.md +471 -0
  126. package/agentic-flow/.claude/commands/github/release-manager.md +338 -0
  127. package/agentic-flow/.claude/commands/github/release-swarm.md +544 -0
  128. package/agentic-flow/.claude/commands/github/repo-analyze.md +25 -0
  129. package/agentic-flow/.claude/commands/github/repo-architect.md +367 -0
  130. package/agentic-flow/.claude/commands/github/swarm-issue.md +482 -0
  131. package/agentic-flow/.claude/commands/github/swarm-pr.md +285 -0
  132. package/agentic-flow/.claude/commands/github/sync-coordinator.md +301 -0
  133. package/agentic-flow/.claude/commands/github/workflow-automation.md +442 -0
  134. package/agentic-flow/.claude/commands/hive-mind/README.md +17 -0
  135. package/agentic-flow/.claude/commands/hive-mind/hive-mind-consensus.md +8 -0
  136. package/agentic-flow/.claude/commands/hive-mind/hive-mind-init.md +18 -0
  137. package/agentic-flow/.claude/commands/hive-mind/hive-mind-memory.md +8 -0
  138. package/agentic-flow/.claude/commands/hive-mind/hive-mind-metrics.md +8 -0
  139. package/agentic-flow/.claude/commands/hive-mind/hive-mind-resume.md +8 -0
  140. package/agentic-flow/.claude/commands/hive-mind/hive-mind-sessions.md +8 -0
  141. package/agentic-flow/.claude/commands/hive-mind/hive-mind-spawn.md +21 -0
  142. package/agentic-flow/.claude/commands/hive-mind/hive-mind-status.md +8 -0
  143. package/agentic-flow/.claude/commands/hive-mind/hive-mind-stop.md +8 -0
  144. package/agentic-flow/.claude/commands/hive-mind/hive-mind-wizard.md +8 -0
  145. package/agentic-flow/.claude/commands/hive-mind/hive-mind.md +27 -0
  146. package/agentic-flow/.claude/commands/hooks/README.md +11 -0
  147. package/agentic-flow/.claude/commands/hooks/overview.md +58 -0
  148. package/agentic-flow/.claude/commands/hooks/post-edit.md +117 -0
  149. package/agentic-flow/.claude/commands/hooks/post-task.md +112 -0
  150. package/agentic-flow/.claude/commands/hooks/pre-edit.md +113 -0
  151. package/agentic-flow/.claude/commands/hooks/pre-task.md +111 -0
  152. package/agentic-flow/.claude/commands/hooks/session-end.md +118 -0
  153. package/agentic-flow/.claude/commands/hooks/setup.md +103 -0
  154. package/agentic-flow/.claude/commands/monitoring/README.md +9 -0
  155. package/agentic-flow/.claude/commands/monitoring/agent-metrics.md +25 -0
  156. package/agentic-flow/.claude/commands/monitoring/agents.md +44 -0
  157. package/agentic-flow/.claude/commands/monitoring/real-time-view.md +25 -0
  158. package/agentic-flow/.claude/commands/monitoring/status.md +46 -0
  159. package/agentic-flow/.claude/commands/monitoring/swarm-monitor.md +25 -0
  160. package/agentic-flow/.claude/commands/optimization/README.md +9 -0
  161. package/agentic-flow/.claude/commands/optimization/auto-topology.md +62 -0
  162. package/agentic-flow/.claude/commands/optimization/cache-manage.md +25 -0
  163. package/agentic-flow/.claude/commands/optimization/parallel-execute.md +25 -0
  164. package/agentic-flow/.claude/commands/optimization/parallel-execution.md +50 -0
  165. package/agentic-flow/.claude/commands/optimization/topology-optimize.md +25 -0
  166. package/agentic-flow/.claude/commands/pair/README.md +261 -0
  167. package/agentic-flow/.claude/commands/pair/commands.md +546 -0
  168. package/agentic-flow/.claude/commands/pair/config.md +510 -0
  169. package/agentic-flow/.claude/commands/pair/examples.md +512 -0
  170. package/agentic-flow/.claude/commands/pair/modes.md +348 -0
  171. package/agentic-flow/.claude/commands/pair/session.md +407 -0
  172. package/agentic-flow/.claude/commands/pair/start.md +209 -0
  173. package/agentic-flow/.claude/commands/sparc/analyzer.md +52 -0
  174. package/agentic-flow/.claude/commands/sparc/architect.md +53 -0
  175. package/agentic-flow/.claude/commands/sparc/ask.md +97 -0
  176. package/agentic-flow/.claude/commands/sparc/batch-executor.md +54 -0
  177. package/agentic-flow/.claude/commands/sparc/code.md +89 -0
  178. package/agentic-flow/.claude/commands/sparc/coder.md +54 -0
  179. package/agentic-flow/.claude/commands/sparc/debug.md +83 -0
  180. package/agentic-flow/.claude/commands/sparc/debugger.md +54 -0
  181. package/agentic-flow/.claude/commands/sparc/designer.md +53 -0
  182. package/agentic-flow/.claude/commands/sparc/devops.md +109 -0
  183. package/agentic-flow/.claude/commands/sparc/docs-writer.md +80 -0
  184. package/agentic-flow/.claude/commands/sparc/documenter.md +54 -0
  185. package/agentic-flow/.claude/commands/sparc/innovator.md +54 -0
  186. package/agentic-flow/.claude/commands/sparc/integration.md +83 -0
  187. package/agentic-flow/.claude/commands/sparc/mcp.md +117 -0
  188. package/agentic-flow/.claude/commands/sparc/memory-manager.md +54 -0
  189. package/agentic-flow/.claude/commands/sparc/optimizer.md +54 -0
  190. package/agentic-flow/.claude/commands/sparc/orchestrator.md +132 -0
  191. package/agentic-flow/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -0
  192. package/agentic-flow/.claude/commands/sparc/refinement-optimization-mode.md +83 -0
  193. package/agentic-flow/.claude/commands/sparc/researcher.md +54 -0
  194. package/agentic-flow/.claude/commands/sparc/reviewer.md +54 -0
  195. package/agentic-flow/.claude/commands/sparc/security-review.md +80 -0
  196. package/agentic-flow/.claude/commands/sparc/sparc-modes.md +174 -0
  197. package/agentic-flow/.claude/commands/sparc/sparc.md +111 -0
  198. package/agentic-flow/.claude/commands/sparc/spec-pseudocode.md +80 -0
  199. package/agentic-flow/.claude/commands/sparc/supabase-admin.md +348 -0
  200. package/agentic-flow/.claude/commands/sparc/swarm-coordinator.md +54 -0
  201. package/agentic-flow/.claude/commands/sparc/tdd.md +54 -0
  202. package/agentic-flow/.claude/commands/sparc/tester.md +54 -0
  203. package/agentic-flow/.claude/commands/sparc/tutorial.md +79 -0
  204. package/agentic-flow/.claude/commands/sparc/workflow-manager.md +54 -0
  205. package/agentic-flow/.claude/commands/sparc.md +166 -0
  206. package/agentic-flow/.claude/commands/stream-chain/pipeline.md +121 -0
  207. package/agentic-flow/.claude/commands/stream-chain/run.md +70 -0
  208. package/agentic-flow/.claude/commands/swarm/README.md +15 -0
  209. package/agentic-flow/.claude/commands/swarm/analysis.md +95 -0
  210. package/agentic-flow/.claude/commands/swarm/development.md +96 -0
  211. package/agentic-flow/.claude/commands/swarm/examples.md +168 -0
  212. package/agentic-flow/.claude/commands/swarm/maintenance.md +102 -0
  213. package/agentic-flow/.claude/commands/swarm/optimization.md +117 -0
  214. package/agentic-flow/.claude/commands/swarm/research.md +136 -0
  215. package/agentic-flow/.claude/commands/swarm/swarm-analysis.md +8 -0
  216. package/agentic-flow/.claude/commands/swarm/swarm-background.md +8 -0
  217. package/agentic-flow/.claude/commands/swarm/swarm-init.md +19 -0
  218. package/agentic-flow/.claude/commands/swarm/swarm-modes.md +8 -0
  219. package/agentic-flow/.claude/commands/swarm/swarm-monitor.md +8 -0
  220. package/agentic-flow/.claude/commands/swarm/swarm-spawn.md +19 -0
  221. package/agentic-flow/.claude/commands/swarm/swarm-status.md +8 -0
  222. package/agentic-flow/.claude/commands/swarm/swarm-strategies.md +8 -0
  223. package/agentic-flow/.claude/commands/swarm/swarm.md +27 -0
  224. package/agentic-flow/.claude/commands/swarm/testing.md +131 -0
  225. package/agentic-flow/.claude/commands/training/README.md +9 -0
  226. package/agentic-flow/.claude/commands/training/model-update.md +25 -0
  227. package/agentic-flow/.claude/commands/training/neural-patterns.md +74 -0
  228. package/agentic-flow/.claude/commands/training/neural-train.md +25 -0
  229. package/agentic-flow/.claude/commands/training/pattern-learn.md +25 -0
  230. package/agentic-flow/.claude/commands/training/specialization.md +63 -0
  231. package/agentic-flow/.claude/commands/truth/start.md +143 -0
  232. package/agentic-flow/.claude/commands/verify/check.md +50 -0
  233. package/agentic-flow/.claude/commands/verify/start.md +128 -0
  234. package/agentic-flow/.claude/commands/workflows/README.md +9 -0
  235. package/agentic-flow/.claude/commands/workflows/development.md +78 -0
  236. package/agentic-flow/.claude/commands/workflows/research.md +63 -0
  237. package/agentic-flow/.claude/commands/workflows/workflow-create.md +25 -0
  238. package/agentic-flow/.claude/commands/workflows/workflow-execute.md +25 -0
  239. package/agentic-flow/.claude/commands/workflows/workflow-export.md +25 -0
  240. package/agentic-flow/.claude/helpers/checkpoint-manager.sh +251 -0
  241. package/agentic-flow/.claude/helpers/github-safe.js +106 -0
  242. package/agentic-flow/.claude/helpers/github-setup.sh +28 -0
  243. package/agentic-flow/.claude/helpers/quick-start.sh +19 -0
  244. package/agentic-flow/.claude/helpers/setup-mcp.sh +18 -0
  245. package/agentic-flow/.claude/helpers/standard-checkpoint-hooks.sh +179 -0
  246. package/agentic-flow/.claude/mcp.json +13 -0
  247. package/agentic-flow/.claude/openrouter-models-research.md +411 -0
  248. package/agentic-flow/.claude/openrouter-quick-reference.md +113 -0
  249. package/agentic-flow/.claude/settings-backup.json +130 -0
  250. package/agentic-flow/.claude/settings-optimized.json +116 -0
  251. package/agentic-flow/.claude/settings-simple.json +78 -0
  252. package/agentic-flow/.claude/settings.json +238 -0
  253. package/agentic-flow/.claude/settings.local.json +14 -0
  254. package/agentic-flow/.claude/skills/agentic-flow-quickstart/skill.md +69 -0
  255. package/agentic-flow/.claude/skills/hooks-automation/skill.md +155 -0
  256. package/agentic-flow/.claude/skills/memory-patterns/skill.md +110 -0
  257. package/agentic-flow/.claude/skills/sparc-methodology/skill.md +137 -0
  258. package/agentic-flow/.claude/skills/swarm-coordination/skill.md +94 -0
  259. package/agentic-flow/.claude/skills/worker-benchmarks/skill.md +135 -0
  260. package/agentic-flow/.claude/skills/worker-integration/skill.md +154 -0
  261. package/agentic-flow/.claude/statusline.mjs +109 -0
  262. package/agentic-flow/.claude/statusline.sh +71 -0
  263. package/agentic-flow/CHANGELOG.md +68 -0
  264. package/agentic-flow/README.md +2047 -0
  265. package/agentic-flow/dist/reasoningbank/config/reasoningbank.yaml +145 -0
  266. package/agentic-flow/dist/reasoningbank/prompts/distill-failure.json +111 -0
  267. package/agentic-flow/dist/reasoningbank/prompts/distill-success.json +74 -0
  268. package/agentic-flow/dist/reasoningbank/prompts/judge.json +101 -0
  269. package/agentic-flow/dist/reasoningbank/prompts/matts-aggregate.json +119 -0
  270. package/agentic-flow/docs/CLAUDE.md +352 -0
  271. package/agentic-flow/docs/DOCKER-VERIFICATION.md +207 -0
  272. package/agentic-flow/docs/IMPROVEMENT_ROADMAP.md +184 -0
  273. package/agentic-flow/docs/ISSUE-55-VALIDATION.md +171 -0
  274. package/agentic-flow/docs/LICENSE +21 -0
  275. package/agentic-flow/docs/NPX_AGENTDB_SETUP.md +175 -0
  276. package/agentic-flow/docs/OPTIMIZATIONS.md +460 -0
  277. package/agentic-flow/docs/PUBLISH_GUIDE.md +438 -0
  278. package/agentic-flow/docs/README.md +217 -0
  279. package/agentic-flow/docs/RELEASE-v1.10.0-COMPLETE.md +382 -0
  280. package/agentic-flow/docs/architecture/EXECUTIVE_SUMMARY.md +310 -0
  281. package/agentic-flow/docs/architecture/FEDERATION-DATA-LIFECYCLE.md +520 -0
  282. package/agentic-flow/docs/architecture/IMPROVEMENT_PLAN.md +11 -0
  283. package/agentic-flow/docs/architecture/INTEGRATION-STATUS.md +290 -0
  284. package/agentic-flow/docs/architecture/MULTI_MODEL_ROUTER_PLAN.md +620 -0
  285. package/agentic-flow/docs/architecture/PACKAGE_STRUCTURE.md +199 -0
  286. package/agentic-flow/docs/architecture/QUIC-IMPLEMENTATION-SUMMARY.md +490 -0
  287. package/agentic-flow/docs/architecture/QUIC-SWARM-INTEGRATION.md +593 -0
  288. package/agentic-flow/docs/architecture/QUICK_WINS.md +333 -0
  289. package/agentic-flow/docs/architecture/README.md +15 -0
  290. package/agentic-flow/docs/architecture/RESEARCH_SUMMARY.md +652 -0
  291. package/agentic-flow/docs/archive/.agentdb-instructions.md +66 -0
  292. package/agentic-flow/docs/archive/AGENT-BOOSTER-STATUS.md +292 -0
  293. package/agentic-flow/docs/archive/CHANGELOG-v1.3.0.md +120 -0
  294. package/agentic-flow/docs/archive/COMPLETION_REPORT_v1.7.1.md +335 -0
  295. package/agentic-flow/docs/archive/IMPLEMENTATION_SUMMARY_v1.7.1.md +241 -0
  296. package/agentic-flow/docs/archive/SUPABASE-INTEGRATION-COMPLETE.md +357 -0
  297. package/agentic-flow/docs/archive/TESTING_QUICK_START.md +223 -0
  298. package/agentic-flow/docs/archive/TOOL-EMULATION-INTEGRATION-ISSUE.md +669 -0
  299. package/agentic-flow/docs/archive/VALIDATION_v1.7.1.md +234 -0
  300. package/agentic-flow/docs/archived/COMPLETE_VALIDATION_SUMMARY.md +405 -0
  301. package/agentic-flow/docs/archived/DOCKER_MCP_VALIDATION.md +358 -0
  302. package/agentic-flow/docs/archived/DOCKER_OPENROUTER_VALIDATION.md +443 -0
  303. package/agentic-flow/docs/archived/FASTMCP_COMPLETE.md +428 -0
  304. package/agentic-flow/docs/archived/FASTMCP_INTEGRATION_STATUS.md +288 -0
  305. package/agentic-flow/docs/archived/FINAL_SDK_VALIDATION.md +328 -0
  306. package/agentic-flow/docs/archived/FINAL_SYSTEM_VALIDATION.md +458 -0
  307. package/agentic-flow/docs/archived/FINAL_VALIDATION_SUMMARY.md +409 -0
  308. package/agentic-flow/docs/archived/FIXES-APPLIED-STATUS.md +331 -0
  309. package/agentic-flow/docs/archived/FLOW-NEXUS-COMPLETE.md +269 -0
  310. package/agentic-flow/docs/archived/HOTFIX_1.1.7.md +133 -0
  311. package/agentic-flow/docs/archived/INTEGRATION_CONFIRMED.md +351 -0
  312. package/agentic-flow/docs/archived/MCP_CLI_TOOLS_VALIDATION.md +266 -0
  313. package/agentic-flow/docs/archived/MCP_INTEGRATION_SUCCESS.md +305 -0
  314. package/agentic-flow/docs/archived/MCP_PROXY_VALIDATION.md +185 -0
  315. package/agentic-flow/docs/archived/MODEL_VALIDATION_REPORT.md +386 -0
  316. package/agentic-flow/docs/archived/ONNX_ENV_VARS.md +564 -0
  317. package/agentic-flow/docs/archived/ONNX_FINAL_REPORT.md +312 -0
  318. package/agentic-flow/docs/archived/ONNX_IMPLEMENTATION_COMPLETE.md +215 -0
  319. package/agentic-flow/docs/archived/ONNX_IMPLEMENTATION_SUMMARY.md +197 -0
  320. package/agentic-flow/docs/archived/ONNX_INTEGRATION.md +422 -0
  321. package/agentic-flow/docs/archived/ONNX_OPTIMIZATION_SUMMARY.md +374 -0
  322. package/agentic-flow/docs/archived/ONNX_PHI4_RESEARCH.md +220 -0
  323. package/agentic-flow/docs/archived/ONNX_RUNTIME_INTEGRATION_PLAN.md +866 -0
  324. package/agentic-flow/docs/archived/ONNX_SUCCESS_REPORT.md +271 -0
  325. package/agentic-flow/docs/archived/ONNX_VS_CLAUDE_QUALITY.md +442 -0
  326. package/agentic-flow/docs/archived/OPENROUTER-FIX-VALIDATION.md +333 -0
  327. package/agentic-flow/docs/archived/OPENROUTER-SUCCESS-REPORT.md +520 -0
  328. package/agentic-flow/docs/archived/OPENROUTER_ISSUES_AND_FIXES.md +277 -0
  329. package/agentic-flow/docs/archived/OPENROUTER_PROXY_COMPLETE.md +494 -0
  330. package/agentic-flow/docs/archived/OPENROUTER_VALIDATION_COMPLETE.md +382 -0
  331. package/agentic-flow/docs/archived/OPTIMIZATION_SUMMARY.md +181 -0
  332. package/agentic-flow/docs/archived/PACKAGE-COMPLETE.md +138 -0
  333. package/agentic-flow/docs/archived/PHI4_HYPEROPTIMIZATION_PLAN.md +2488 -0
  334. package/agentic-flow/docs/archived/PROVIDER_INSTRUCTION_OPTIMIZATION.md +139 -0
  335. package/agentic-flow/docs/archived/PROXY_VALIDATION.md +239 -0
  336. package/agentic-flow/docs/archived/README.md +20 -0
  337. package/agentic-flow/docs/archived/README_SDK_VALIDATION.md +356 -0
  338. package/agentic-flow/docs/archived/README_V1.1.11.md +280 -0
  339. package/agentic-flow/docs/archived/RELEASE-NOTES-v1.1.13.md +392 -0
  340. package/agentic-flow/docs/archived/RELEASE-SUMMARY-v1.1.14-beta.1.md +336 -0
  341. package/agentic-flow/docs/archived/RESEARCH_COMPLETE.txt +335 -0
  342. package/agentic-flow/docs/archived/ROUTER_VALIDATION.md +311 -0
  343. package/agentic-flow/docs/archived/SDK-SETUP-COMPLETE.md +252 -0
  344. package/agentic-flow/docs/archived/SDK_INTEGRATION_COMPLETE.md +336 -0
  345. package/agentic-flow/docs/archived/TOOL_INSTRUCTION_ENHANCEMENT.md +200 -0
  346. package/agentic-flow/docs/archived/V1.1.10_VALIDATION.md +194 -0
  347. package/agentic-flow/docs/archived/V1.1.11_COMPLETE_VALIDATION.md +308 -0
  348. package/agentic-flow/docs/archived/V1.1.11_MCP_PROXY_FIX.md +374 -0
  349. package/agentic-flow/docs/archived/V1.1.14-BETA-READY.md +418 -0
  350. package/agentic-flow/docs/archived/VALIDATION-RESULTS.md +279 -0
  351. package/agentic-flow/docs/archived/VALIDATION_COMPLETE.md +178 -0
  352. package/agentic-flow/docs/archived/VALIDATION_SUMMARY.md +224 -0
  353. package/agentic-flow/docs/archived/claude-flow-integration.md +463 -0
  354. package/agentic-flow/docs/archived/docker-cli-validation.md +289 -0
  355. package/agentic-flow/docs/archived/docker-memory-coordination-status.md +261 -0
  356. package/agentic-flow/docs/archived/mcp-validation-summary.md +264 -0
  357. package/agentic-flow/docs/archived/quick-wins-validation.md +377 -0
  358. package/agentic-flow/docs/benchmarks/optimization-guide.md +531 -0
  359. package/agentic-flow/docs/benchmarks/quic-results.md +494 -0
  360. package/agentic-flow/docs/docker-tests/TEST-V1.7.8.Dockerfile +13 -0
  361. package/agentic-flow/docs/docker-tests/TEST-V1.7.9-NODE20.Dockerfile +13 -0
  362. package/agentic-flow/docs/docker-tests/TEST-V1.7.9.Dockerfile +14 -0
  363. package/agentic-flow/docs/embeddings/EMBEDDING_GEOMETRY.md +935 -0
  364. package/agentic-flow/docs/federation/AGENT-DEBUG-STREAMING.md +403 -0
  365. package/agentic-flow/docs/federation/DEBUG-STREAMING-COMPLETE.md +432 -0
  366. package/agentic-flow/docs/federation/DEBUG-STREAMING.md +537 -0
  367. package/agentic-flow/docs/federation/DEPLOYMENT-VALIDATION-SUCCESS.md +394 -0
  368. package/agentic-flow/docs/federation/DOCKER-FEDERATION-DEEP-REVIEW.md +478 -0
  369. package/agentic-flow/docs/guides/ADDING-MCP-SERVERS-CLI.md +515 -0
  370. package/agentic-flow/docs/guides/ADDING-MCP-SERVERS.md +642 -0
  371. package/agentic-flow/docs/guides/AGENT-BOOSTER.md +435 -0
  372. package/agentic-flow/docs/guides/ALTERNATIVE_LLM_MODELS.md +524 -0
  373. package/agentic-flow/docs/guides/CLAUDE-CODE-INTEGRATION.md +403 -0
  374. package/agentic-flow/docs/guides/DEPLOYMENT.md +906 -0
  375. package/agentic-flow/docs/guides/DOCKER_AGENT_USAGE.md +352 -0
  376. package/agentic-flow/docs/guides/IMPLEMENTATION_EXAMPLES.md +960 -0
  377. package/agentic-flow/docs/guides/MCP-TOOLS.md +1166 -0
  378. package/agentic-flow/docs/guides/MODEL-ID-MAPPING.md +193 -0
  379. package/agentic-flow/docs/guides/MULTI-MODEL-ROUTER.md +702 -0
  380. package/agentic-flow/docs/guides/NPM-PUBLISH.md +218 -0
  381. package/agentic-flow/docs/guides/ONNX-PROXY-IMPLEMENTATION.md +254 -0
  382. package/agentic-flow/docs/guides/ONNX_CLI_USAGE.md +344 -0
  383. package/agentic-flow/docs/guides/ONNX_OPTIMIZATION_GUIDE.md +665 -0
  384. package/agentic-flow/docs/guides/OPENROUTER_DEPLOYMENT.md +495 -0
  385. package/agentic-flow/docs/guides/PROXY-ARCHITECTURE-AND-EXTENSION.md +708 -0
  386. package/agentic-flow/docs/guides/QUIC-SWARM-QUICKSTART.md +543 -0
  387. package/agentic-flow/docs/guides/QUICK-START-v1.7.1.md +399 -0
  388. package/agentic-flow/docs/guides/README.md +17 -0
  389. package/agentic-flow/docs/guides/REASONINGBANK.md +721 -0
  390. package/agentic-flow/docs/guides/STANDALONE_PROXY_GUIDE.md +437 -0
  391. package/agentic-flow/docs/guides/agent-sdk.md +234 -0
  392. package/agentic-flow/docs/integration-docs/AGENT-BOOSTER-INTEGRATION.md +379 -0
  393. package/agentic-flow/docs/integration-docs/CLAUDE-FLOW-INTEGRATION-ANALYSIS.md +653 -0
  394. package/agentic-flow/docs/integration-docs/CLI-INTEGRATION-COMPLETE.md +283 -0
  395. package/agentic-flow/docs/integration-docs/IMPLEMENTATION_SUMMARY.md +369 -0
  396. package/agentic-flow/docs/integration-docs/INTEGRATION-COMPLETE.md +291 -0
  397. package/agentic-flow/docs/integration-docs/INTEGRATION-QUICK-SUMMARY.md +249 -0
  398. package/agentic-flow/docs/integration-docs/INTEGRATION-STATUS-CORRECTED.md +488 -0
  399. package/agentic-flow/docs/integration-docs/INTEGRATION_COMPLETE_SUMMARY.md +780 -0
  400. package/agentic-flow/docs/integration-docs/QUIC-WASM-INTEGRATION.md +537 -0
  401. package/agentic-flow/docs/integration-docs/README.md +61 -0
  402. package/agentic-flow/docs/integration-docs/WASM_ESM_FIX.md +180 -0
  403. package/agentic-flow/docs/integration-docs/WASM_INTEGRATION_COMPLETE.md +344 -0
  404. package/agentic-flow/docs/integrations/CLAUDE_AGENTS_INTEGRATION.md +356 -0
  405. package/agentic-flow/docs/integrations/CLAUDE_FLOW_INTEGRATION.md +535 -0
  406. package/agentic-flow/docs/integrations/FASTMCP_CLI_INTEGRATION.md +503 -0
  407. package/agentic-flow/docs/integrations/FLOW-NEXUS-INTEGRATION.md +319 -0
  408. package/agentic-flow/docs/integrations/README.md +18 -0
  409. package/agentic-flow/docs/integrations/fastmcp-implementation-plan.md +2516 -0
  410. package/agentic-flow/docs/integrations/fastmcp-poc-integration.md +198 -0
  411. package/agentic-flow/docs/issues/ISSUE-SUPABASE-INTEGRATION.md +536 -0
  412. package/agentic-flow/docs/issues/ISSUE-xenova-transformers-dependency.md +380 -0
  413. package/agentic-flow/docs/mcp-validation/IMPLEMENTATION-SUMMARY.md +493 -0
  414. package/agentic-flow/docs/mcp-validation/MCP-CLI-VALIDATION-REPORT.md +322 -0
  415. package/agentic-flow/docs/mcp-validation/README.md +43 -0
  416. package/agentic-flow/docs/mcp-validation/strange-loops-test.md +63 -0
  417. package/agentic-flow/docs/plans/QUIC/BUILD_INSTRUCTIONS.md +220 -0
  418. package/agentic-flow/docs/plans/QUIC/IMPLEMENTATION_STATUS.md +234 -0
  419. package/agentic-flow/docs/plans/QUIC/QUIC-INTEGRATION-SUMMARY.md +545 -0
  420. package/agentic-flow/docs/plans/QUIC/QUIC-INTEGRATION.md +502 -0
  421. package/agentic-flow/docs/plans/QUIC/QUIC-README.md +226 -0
  422. package/agentic-flow/docs/plans/QUIC/QUIC_IMPLEMENTATION_SUMMARY.md +607 -0
  423. package/agentic-flow/docs/plans/QUIC/README-CONDENSED.md +447 -0
  424. package/agentic-flow/docs/plans/QUIC/quic-research.md +1415 -0
  425. package/agentic-flow/docs/plans/QUIC/quic-tutorial.md +485 -0
  426. package/agentic-flow/docs/plans/agent-booster/00-INDEX.md +230 -0
  427. package/agentic-flow/docs/plans/agent-booster/00-OVERVIEW.md +454 -0
  428. package/agentic-flow/docs/plans/agent-booster/01-ARCHITECTURE.md +699 -0
  429. package/agentic-flow/docs/plans/agent-booster/02-INTEGRATION.md +771 -0
  430. package/agentic-flow/docs/plans/agent-booster/03-BENCHMARKS.md +616 -0
  431. package/agentic-flow/docs/plans/agent-booster/04-NPM-SDK.md +673 -0
  432. package/agentic-flow/docs/plans/agent-booster/GITHUB-ISSUE.md +523 -0
  433. package/agentic-flow/docs/plans/agent-booster/README.md +576 -0
  434. package/agentic-flow/docs/plans/agent-booster-cli-integration.md +317 -0
  435. package/agentic-flow/docs/plans/requesty/00-overview.md +176 -0
  436. package/agentic-flow/docs/plans/requesty/01-api-research.md +573 -0
  437. package/agentic-flow/docs/plans/requesty/02-architecture.md +1076 -0
  438. package/agentic-flow/docs/plans/requesty/03-implementation-phases.md +1129 -0
  439. package/agentic-flow/docs/plans/requesty/04-testing-strategy.md +905 -0
  440. package/agentic-flow/docs/plans/requesty/05-migration-guide.md +576 -0
  441. package/agentic-flow/docs/plans/requesty/README.md +290 -0
  442. package/agentic-flow/docs/providers/LANDING-PAGE-PROVIDER-CONTENT.md +204 -0
  443. package/agentic-flow/docs/providers/PROVIDER-FALLBACK-GUIDE.md +619 -0
  444. package/agentic-flow/docs/providers/PROVIDER-FALLBACK-SUMMARY.md +418 -0
  445. package/agentic-flow/docs/quantum-goap/DEPENDENCY_GRAPH.mermaid +133 -0
  446. package/agentic-flow/docs/quantum-goap/EXECUTION_SUMMARY.md +199 -0
  447. package/agentic-flow/docs/quantum-goap/GOAP_IMPLEMENTATION_PLAN.md +2406 -0
  448. package/agentic-flow/docs/quantum-goap/QUICK_START.md +301 -0
  449. package/agentic-flow/docs/quantum-research/QUANTUM_RESEARCH_LITERATURE_REVIEW.md +2071 -0
  450. package/agentic-flow/docs/quantum-research/README.md +94 -0
  451. package/agentic-flow/docs/quic/FINAL-VALIDATION.md +336 -0
  452. package/agentic-flow/docs/quic/IMPLEMENTATION-COMPLETE-SUMMARY.md +349 -0
  453. package/agentic-flow/docs/quic/PERFORMANCE-VALIDATION.md +282 -0
  454. package/agentic-flow/docs/quic/QUIC-STATUS-OLD.md +513 -0
  455. package/agentic-flow/docs/quic/QUIC-STATUS.md +451 -0
  456. package/agentic-flow/docs/quic/QUIC-VALIDATION-REPORT.md +370 -0
  457. package/agentic-flow/docs/quic/QUIC_FINAL_STATUS.md +399 -0
  458. package/agentic-flow/docs/quic/README_QUIC_PHASE1.md +117 -0
  459. package/agentic-flow/docs/quic/WASM-INTEGRATION-COMPLETE.md +382 -0
  460. package/agentic-flow/docs/reasoningbank/MEMORY_VALIDATION_REPORT.md +417 -0
  461. package/agentic-flow/docs/reasoningbank/README.md +43 -0
  462. package/agentic-flow/docs/reasoningbank/REASONING-AGENTS.md +482 -0
  463. package/agentic-flow/docs/reasoningbank/REASONINGBANK-BENCHMARK-RESULTS.md +166 -0
  464. package/agentic-flow/docs/reasoningbank/REASONINGBANK-BENCHMARK.md +396 -0
  465. package/agentic-flow/docs/reasoningbank/REASONINGBANK-CLI-INTEGRATION.md +455 -0
  466. package/agentic-flow/docs/reasoningbank/REASONINGBANK-DEMO.md +419 -0
  467. package/agentic-flow/docs/reasoningbank/REASONINGBANK-VALIDATION.md +532 -0
  468. package/agentic-flow/docs/reasoningbank/REASONINGBANK_ARCHITECTURE.md +663 -0
  469. package/agentic-flow/docs/reasoningbank/REASONINGBANK_BACKENDS.md +375 -0
  470. package/agentic-flow/docs/reasoningbank/REASONINGBANK_FIXES.md +455 -0
  471. package/agentic-flow/docs/reasoningbank/REASONINGBANK_IMPLEMENTATION_STATUS.md +478 -0
  472. package/agentic-flow/docs/reasoningbank/REASONINGBANK_INTEGRATION_PLAN.md +1059 -0
  473. package/agentic-flow/docs/reasoningbank/REASONINGBANK_INVESTIGATION.md +380 -0
  474. package/agentic-flow/docs/releases/GITHUB-ISSUE-ADDENDUM-v1.4.6.md +1529 -0
  475. package/agentic-flow/docs/releases/GITHUB-ISSUE-REASONINGBANK-BENCHMARK.md +643 -0
  476. package/agentic-flow/docs/releases/GITHUB-ISSUE-v1.4.6.md +1453 -0
  477. package/agentic-flow/docs/releases/GITHUB-ISSUE-v1.5.0.md +468 -0
  478. package/agentic-flow/docs/releases/HOTFIX-v1.2.1.md +315 -0
  479. package/agentic-flow/docs/releases/NPM-PUBLISH-GUIDE-v1.2.0.md +440 -0
  480. package/agentic-flow/docs/releases/PUBLISH-COMPLETE-v1.2.0.md +308 -0
  481. package/agentic-flow/docs/releases/PUBLISH_CHECKLIST_v1.10.0.md +396 -0
  482. package/agentic-flow/docs/releases/PUBLISH_SUMMARY_v1.7.1.md +198 -0
  483. package/agentic-flow/docs/releases/README.md +18 -0
  484. package/agentic-flow/docs/releases/RELEASE-v1.2.0.md +339 -0
  485. package/agentic-flow/docs/releases/RELEASE-v1.8.13.md +426 -0
  486. package/agentic-flow/docs/releases/RELEASE_NOTES_v1.10.0.md +464 -0
  487. package/agentic-flow/docs/releases/RELEASE_NOTES_v1.7.0.md +297 -0
  488. package/agentic-flow/docs/releases/RELEASE_v1.7.1.md +327 -0
  489. package/agentic-flow/docs/releases/v1.4.6-reasoningbank-release.md +541 -0
  490. package/agentic-flow/docs/releases/v1.4.7-bugfix.md +212 -0
  491. package/agentic-flow/docs/releases/v1.5.14-QUIC-TRANSPORT.md +201 -0
  492. package/agentic-flow/docs/reports/QUIC_PHASE1_COMPLETE.md +409 -0
  493. package/agentic-flow/docs/reports/QUIC_PHASE1_COMPLETION.md +323 -0
  494. package/agentic-flow/docs/reviews/quic-implementation-review.md +1076 -0
  495. package/agentic-flow/docs/router/README.md +552 -0
  496. package/agentic-flow/docs/router/ROUTER_CONFIG_REFERENCE.md +577 -0
  497. package/agentic-flow/docs/router/ROUTER_USER_GUIDE.md +865 -0
  498. package/agentic-flow/docs/router/TOP20_MODELS_MATRIX.md +80 -0
  499. package/agentic-flow/docs/supabase/IMPLEMENTATION-SUMMARY.md +498 -0
  500. package/agentic-flow/docs/supabase/INDEX.md +358 -0
  501. package/agentic-flow/docs/supabase/QUICKSTART.md +365 -0
  502. package/agentic-flow/docs/supabase/README.md +318 -0
  503. package/agentic-flow/docs/supabase/SUPABASE-REALTIME-FEDERATION.md +575 -0
  504. package/agentic-flow/docs/supabase/TEST-REPORT.md +446 -0
  505. package/agentic-flow/docs/supabase/migrations/001_create_federation_tables.sql +339 -0
  506. package/agentic-flow/docs/testing/AGENT-SYSTEM-VALIDATION.md +517 -0
  507. package/agentic-flow/docs/testing/AGENTDB_TESTING.md +411 -0
  508. package/agentic-flow/docs/testing/FINAL-TESTING-SUMMARY.md +362 -0
  509. package/agentic-flow/docs/testing/README.md +46 -0
  510. package/agentic-flow/docs/testing/REGRESSION-TEST-RESULTS.md +269 -0
  511. package/agentic-flow/docs/testing/STREAMING-AND-MCP-VALIDATION.md +517 -0
  512. package/agentic-flow/docs/validation-reports/BENCHMARK_AND_OPTIMIZATION_REPORT.md +470 -0
  513. package/agentic-flow/docs/validation-reports/DOCKER_VALIDATION_RESULTS.md +391 -0
  514. package/agentic-flow/docs/validation-reports/NO_REGRESSIONS_CONFIRMED.md +384 -0
  515. package/agentic-flow/docs/validation-reports/NPM-PACKAGE-ANALYSIS-FINAL.md +543 -0
  516. package/agentic-flow/docs/validation-reports/README.md +43 -0
  517. package/agentic-flow/docs/validation-reports/V2.7.0-ALPHA.10_FINAL_VALIDATION.md +817 -0
  518. package/agentic-flow/docs/validation-reports/V2.7.0-ALPHA.9_VALIDATION.md +546 -0
  519. package/agentic-flow/docs/validation-reports/v1.6.0-QUIC-CLI-VALIDATION.md +558 -0
  520. package/agentic-flow/docs/validation-reports/v1.6.1-NPM-PUBLISH-VALIDATION.md +532 -0
  521. package/agentic-flow/docs/version-releases/PUBLICATION_REPORT_v1.5.11.md +421 -0
  522. package/agentic-flow/docs/version-releases/README.md +82 -0
  523. package/agentic-flow/docs/version-releases/v1.5.9-DOCKER-VERIFICATION.md +263 -0
  524. package/agentic-flow/docs/version-releases/v1.5.9-RELEASE-SUMMARY.md +222 -0
  525. package/agentic-flow/scripts/build.sh +30 -0
  526. package/agentic-flow/scripts/claude +31 -0
  527. package/agentic-flow/scripts/claude-code +56 -0
  528. package/agentic-flow/scripts/claude-flow +81 -0
  529. package/agentic-flow/scripts/claude-flow.bat +18 -0
  530. package/agentic-flow/scripts/claude-flow.ps1 +24 -0
  531. package/agentic-flow/scripts/postinstall.js +139 -0
  532. package/agentic-flow/scripts/run-validation.sh +165 -0
  533. package/agentic-flow/scripts/test-agentdb.sh +153 -0
  534. package/agentic-flow/scripts/test-all-commands.sh +46 -0
  535. package/agentic-flow/scripts/test-claude-flow-sdk.sh +46 -0
  536. package/agentic-flow/scripts/test-fastmcp-docker.sh +132 -0
  537. package/agentic-flow/scripts/test-fastmcp-poc.sh +26 -0
  538. package/agentic-flow/scripts/test-functionality.sh +50 -0
  539. package/agentic-flow/scripts/test-onnx-docker.sh +176 -0
  540. package/agentic-flow/scripts/test-router-docker.sh +105 -0
  541. package/agentic-flow/scripts/validate-mcp-cli-tools.sh +104 -0
  542. package/agentic-flow/scripts/validate-providers.sh +50 -0
  543. package/agentic-flow/wasm/quic/README.md +75 -0
  544. package/agentic-flow/wasm/quic/agentic_flow_quic.js +779 -0
  545. package/agentic-flow/wasm/quic/agentic_flow_quic_bg.wasm +0 -0
  546. package/agentic-flow/wasm/quic/package.json +20 -0
  547. package/agentic-flow/wasm/reasoningbank/package.json +34 -0
  548. package/agentic-flow/wasm/reasoningbank/reasoningbank_wasm.js +5 -0
  549. package/agentic-flow/wasm/reasoningbank/reasoningbank_wasm_bg.js +555 -0
  550. package/agentic-flow/wasm/reasoningbank/reasoningbank_wasm_bg.wasm +0 -0
  551. package/docs/CHANGELOG.md +272 -0
  552. package/docs/LICENSE +21 -0
  553. package/docs/README.md +127 -0
  554. package/package.json +279 -0
  555. package/packages/agentic-jujutsu/.cargo/config.toml +14 -0
  556. package/packages/agentic-jujutsu/BUILD.md +292 -0
  557. package/packages/agentic-jujutsu/CHANGELOG.md +143 -0
  558. package/packages/agentic-jujutsu/CHANGELOG_v2.2.0.md +203 -0
  559. package/packages/agentic-jujutsu/CRATE_README.md +269 -0
  560. package/packages/agentic-jujutsu/Dockerfile +8 -0
  561. package/packages/agentic-jujutsu/Dockerfile.test +81 -0
  562. package/packages/agentic-jujutsu/FUNCTIONALITY_VERIFICATION.md +377 -0
  563. package/packages/agentic-jujutsu/LICENSE +21 -0
  564. package/packages/agentic-jujutsu/NAPI_CI_CD_FILES.txt +162 -0
  565. package/packages/agentic-jujutsu/QUANTUM_INTEGRATION_SUMMARY.txt +67 -0
  566. package/packages/agentic-jujutsu/README.md +2248 -0
  567. package/packages/agentic-jujutsu/README_QUANTUM_INTEGRATION.md +195 -0
  568. package/packages/agentic-jujutsu/agentic-jujutsu-2.0.0.tgz +0 -0
  569. package/packages/agentic-jujutsu/agentic-jujutsu-2.0.1.tgz +0 -0
  570. package/packages/agentic-jujutsu/agentic-jujutsu-2.0.2.tgz +0 -0
  571. package/packages/agentic-jujutsu/agentic-jujutsu-2.0.3.tgz +0 -0
  572. package/packages/agentic-jujutsu/agentic-jujutsu.linux-x64-gnu.node +0 -0
  573. package/packages/agentic-jujutsu/benchmarks/README.md +403 -0
  574. package/packages/agentic-jujutsu/benchmarks/docker/.env.example +24 -0
  575. package/packages/agentic-jujutsu/benchmarks/docker/Dockerfile.git +55 -0
  576. package/packages/agentic-jujutsu/benchmarks/docker/Dockerfile.jujutsu +67 -0
  577. package/packages/agentic-jujutsu/benchmarks/docker/Dockerfile.swarm-coordinator +45 -0
  578. package/packages/agentic-jujutsu/benchmarks/docker/config/prometheus.yml +20 -0
  579. package/packages/agentic-jujutsu/benchmarks/docker/docker-compose.yml +152 -0
  580. package/packages/agentic-jujutsu/benchmarks/docker/scripts/collect-metrics.sh +143 -0
  581. package/packages/agentic-jujutsu/benchmarks/docker/scripts/generate-reports.sh +150 -0
  582. package/packages/agentic-jujutsu/benchmarks/docker/scripts/run-benchmarks.sh +80 -0
  583. package/packages/agentic-jujutsu/benchmarks/docker/scripts/setup-repos.sh +88 -0
  584. package/packages/agentic-jujutsu/bin/cli.js +286 -0
  585. package/packages/agentic-jujutsu/bin/mcp-server.js +20 -0
  586. package/packages/agentic-jujutsu/build.rs +134 -0
  587. package/packages/agentic-jujutsu/check-methods.js +26 -0
  588. package/packages/agentic-jujutsu/helpers/encryption.js +234 -0
  589. package/packages/agentic-jujutsu/index.d.ts +853 -0
  590. package/packages/agentic-jujutsu/index.js +321 -0
  591. package/packages/agentic-jujutsu/package-lock.json +1163 -0
  592. package/packages/agentic-jujutsu/package.json +108 -0
  593. package/packages/agentic-jujutsu/pkg/bundler/LICENSE +21 -0
  594. package/packages/agentic-jujutsu/pkg/bundler/README.md +361 -0
  595. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu.d.ts +554 -0
  596. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu.js +5 -0
  597. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu_bg.js +1821 -0
  598. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu_bg.wasm +0 -0
  599. package/packages/agentic-jujutsu/pkg/bundler/agentic_jujutsu_bg.wasm.d.ts +113 -0
  600. package/packages/agentic-jujutsu/pkg/bundler/package.json +34 -0
  601. package/packages/agentic-jujutsu/pkg/deno/LICENSE +21 -0
  602. package/packages/agentic-jujutsu/pkg/deno/README.md +361 -0
  603. package/packages/agentic-jujutsu/pkg/deno/agentic_jujutsu.d.ts +554 -0
  604. package/packages/agentic-jujutsu/pkg/deno/agentic_jujutsu.js +1802 -0
  605. package/packages/agentic-jujutsu/pkg/deno/agentic_jujutsu_bg.wasm +0 -0
  606. package/packages/agentic-jujutsu/pkg/deno/agentic_jujutsu_bg.wasm.d.ts +113 -0
  607. package/packages/agentic-jujutsu/pkg/node/LICENSE +21 -0
  608. package/packages/agentic-jujutsu/pkg/node/README.md +361 -0
  609. package/packages/agentic-jujutsu/pkg/node/agentic_jujutsu.d.ts +554 -0
  610. package/packages/agentic-jujutsu/pkg/node/agentic_jujutsu.js +1830 -0
  611. package/packages/agentic-jujutsu/pkg/node/agentic_jujutsu_bg.wasm +0 -0
  612. package/packages/agentic-jujutsu/pkg/node/agentic_jujutsu_bg.wasm.d.ts +113 -0
  613. package/packages/agentic-jujutsu/pkg/node/package.json +28 -0
  614. package/packages/agentic-jujutsu/pkg/web/LICENSE +21 -0
  615. package/packages/agentic-jujutsu/pkg/web/README.md +361 -0
  616. package/packages/agentic-jujutsu/pkg/web/agentic_jujutsu.d.ts +691 -0
  617. package/packages/agentic-jujutsu/pkg/web/agentic_jujutsu.js +1913 -0
  618. package/packages/agentic-jujutsu/pkg/web/agentic_jujutsu_bg.wasm +0 -0
  619. package/packages/agentic-jujutsu/pkg/web/agentic_jujutsu_bg.wasm.d.ts +113 -0
  620. package/packages/agentic-jujutsu/pkg/web/package.json +32 -0
  621. package/packages/agentic-jujutsu/quantum-bridge.d.ts +115 -0
  622. package/packages/agentic-jujutsu/scripts/agentic-flow-integration.js +178 -0
  623. package/packages/agentic-jujutsu/scripts/analyze-size.sh +23 -0
  624. package/packages/agentic-jujutsu/scripts/coverage.sh +57 -0
  625. package/packages/agentic-jujutsu/scripts/docker-test.sh +56 -0
  626. package/packages/agentic-jujutsu/scripts/final-validation.sh +85 -0
  627. package/packages/agentic-jujutsu/scripts/install-jj.js +197 -0
  628. package/packages/agentic-jujutsu/scripts/mcp-server.js +98 -0
  629. package/packages/agentic-jujutsu/scripts/test-all.sh +68 -0
  630. package/packages/agentic-jujutsu/scripts/verify-build.sh +32 -0
  631. package/packages/agentic-jujutsu/scripts/verify-napi-config.sh +122 -0
  632. package/packages/agentic-jujutsu/scripts/wasm-pack-build.sh +76 -0
  633. package/packages/agentic-jujutsu/test-agentdb-cli.js +119 -0
  634. package/packages/agentic-jujutsu/test-agentdb.js +105 -0
  635. package/packages/agentic-jujutsu/test-failures.js +53 -0
  636. package/packages/agentic-jujutsu/test-napi.js +40 -0
  637. package/packages/agentic-jujutsu/test-quick.js +61 -0
  638. package/packages/agentic-jujutsu/test-repo/test-file.txt +1 -0
  639. package/packages/agentic-jujutsu/typescript/hooks-integration.ts +370 -0
  640. package/packages/agentic-jujutsu/typescript/index.d.ts +415 -0
  641. package/reasoningbank/README.md +217 -0
@@ -0,0 +1,905 @@
1
+ # Requesty.ai Integration - Testing Strategy
2
+
3
+ ## Testing Overview
4
+
5
+ This document outlines a comprehensive testing strategy for the Requesty.ai integration, covering unit tests, integration tests, end-to-end scenarios, and validation criteria.
6
+
7
+ ## Test Categories
8
+
9
+ | Category | Scope | Duration | Automation |
10
+ |----------|-------|----------|------------|
11
+ | Unit Tests | Proxy functions | 30 min | Jest/Vitest |
12
+ | Integration Tests | CLI → Proxy → API | 60 min | Manual + Script |
13
+ | E2E Tests | Full user workflows | 45 min | Manual |
14
+ | Performance Tests | Latency, throughput | 30 min | Script |
15
+ | Security Tests | API key handling | 15 min | Manual |
16
+ | **Total** | | **3 hours** | |
17
+
18
+ ---
19
+
20
+ ## 1. Unit Tests
21
+
22
+ ### Test File: `src/proxy/anthropic-to-requesty.test.ts`
23
+
24
+ #### 1.1 Proxy Initialization
25
+
26
+ ```typescript
27
+ describe('AnthropicToRequestyProxy - Initialization', () => {
28
+ it('should initialize with default configuration', () => {
29
+ const proxy = new AnthropicToRequestyProxy({
30
+ requestyApiKey: 'test-key'
31
+ });
32
+
33
+ expect(proxy.requestyBaseUrl).toBe('https://router.requesty.ai/v1');
34
+ expect(proxy.defaultModel).toBe('openai/gpt-4o-mini');
35
+ });
36
+
37
+ it('should accept custom base URL', () => {
38
+ const proxy = new AnthropicToRequestyProxy({
39
+ requestyApiKey: 'test-key',
40
+ requestyBaseUrl: 'https://custom.requesty.ai/v1'
41
+ });
42
+
43
+ expect(proxy.requestyBaseUrl).toBe('https://custom.requesty.ai/v1');
44
+ });
45
+
46
+ it('should accept custom default model', () => {
47
+ const proxy = new AnthropicToRequestyProxy({
48
+ requestyApiKey: 'test-key',
49
+ defaultModel: 'anthropic/claude-3.5-sonnet'
50
+ });
51
+
52
+ expect(proxy.defaultModel).toBe('anthropic/claude-3.5-sonnet');
53
+ });
54
+ });
55
+ ```
56
+
57
+ #### 1.2 Format Conversion (Anthropic → OpenAI)
58
+
59
+ ```typescript
60
+ describe('AnthropicToRequestyProxy - Request Conversion', () => {
61
+ let proxy: AnthropicToRequestyProxy;
62
+
63
+ beforeEach(() => {
64
+ proxy = new AnthropicToRequestyProxy({
65
+ requestyApiKey: 'test-key'
66
+ });
67
+ });
68
+
69
+ it('should convert simple message', () => {
70
+ const anthropicReq = {
71
+ model: 'openai/gpt-4o-mini',
72
+ messages: [
73
+ { role: 'user', content: 'Hello' }
74
+ ]
75
+ };
76
+
77
+ const openaiReq = proxy.convertAnthropicToOpenAI(anthropicReq);
78
+
79
+ expect(openaiReq.model).toBe('openai/gpt-4o-mini');
80
+ expect(openaiReq.messages).toHaveLength(2); // system + user
81
+ expect(openaiReq.messages[1].content).toBe('Hello');
82
+ });
83
+
84
+ it('should convert system prompt (string)', () => {
85
+ const anthropicReq = {
86
+ model: 'openai/gpt-4o-mini',
87
+ system: 'You are a helpful assistant',
88
+ messages: [{ role: 'user', content: 'Hi' }]
89
+ };
90
+
91
+ const openaiReq = proxy.convertAnthropicToOpenAI(anthropicReq);
92
+
93
+ expect(openaiReq.messages[0].role).toBe('system');
94
+ expect(openaiReq.messages[0].content).toContain('You are a helpful assistant');
95
+ });
96
+
97
+ it('should convert system prompt (array)', () => {
98
+ const anthropicReq = {
99
+ model: 'openai/gpt-4o-mini',
100
+ system: [
101
+ { type: 'text', text: 'You are helpful' },
102
+ { type: 'text', text: 'Be concise' }
103
+ ],
104
+ messages: [{ role: 'user', content: 'Hi' }]
105
+ };
106
+
107
+ const openaiReq = proxy.convertAnthropicToOpenAI(anthropicReq);
108
+
109
+ expect(openaiReq.messages[0].content).toContain('You are helpful');
110
+ expect(openaiReq.messages[0].content).toContain('Be concise');
111
+ });
112
+
113
+ it('should convert tools to OpenAI format', () => {
114
+ const anthropicReq = {
115
+ model: 'openai/gpt-4o-mini',
116
+ messages: [{ role: 'user', content: 'Read file' }],
117
+ tools: [{
118
+ name: 'Read',
119
+ description: 'Read a file',
120
+ input_schema: {
121
+ type: 'object',
122
+ properties: {
123
+ file_path: { type: 'string' }
124
+ },
125
+ required: ['file_path']
126
+ }
127
+ }]
128
+ };
129
+
130
+ const openaiReq = proxy.convertAnthropicToOpenAI(anthropicReq);
131
+
132
+ expect(openaiReq.tools).toHaveLength(1);
133
+ expect(openaiReq.tools[0].type).toBe('function');
134
+ expect(openaiReq.tools[0].function.name).toBe('Read');
135
+ expect(openaiReq.tools[0].function.parameters).toEqual(anthropicReq.tools[0].input_schema);
136
+ });
137
+ });
138
+ ```
139
+
140
+ #### 1.3 Format Conversion (OpenAI → Anthropic)
141
+
142
+ ```typescript
143
+ describe('AnthropicToRequestyProxy - Response Conversion', () => {
144
+ it('should convert text response', () => {
145
+ const openaiRes = {
146
+ id: 'chatcmpl-123',
147
+ model: 'openai/gpt-4o-mini',
148
+ choices: [{
149
+ index: 0,
150
+ message: {
151
+ role: 'assistant',
152
+ content: 'Hello, how can I help?'
153
+ },
154
+ finish_reason: 'stop'
155
+ }],
156
+ usage: {
157
+ prompt_tokens: 10,
158
+ completion_tokens: 20,
159
+ total_tokens: 30
160
+ }
161
+ };
162
+
163
+ const anthropicRes = proxy.convertOpenAIToAnthropic(openaiRes);
164
+
165
+ expect(anthropicRes.id).toBe('chatcmpl-123');
166
+ expect(anthropicRes.role).toBe('assistant');
167
+ expect(anthropicRes.content).toHaveLength(1);
168
+ expect(anthropicRes.content[0].type).toBe('text');
169
+ expect(anthropicRes.content[0].text).toBe('Hello, how can I help?');
170
+ expect(anthropicRes.stop_reason).toBe('end_turn');
171
+ expect(anthropicRes.usage.input_tokens).toBe(10);
172
+ expect(anthropicRes.usage.output_tokens).toBe(20);
173
+ });
174
+
175
+ it('should convert tool_calls response', () => {
176
+ const openaiRes = {
177
+ id: 'chatcmpl-123',
178
+ model: 'openai/gpt-4o-mini',
179
+ choices: [{
180
+ message: {
181
+ role: 'assistant',
182
+ content: null,
183
+ tool_calls: [{
184
+ id: 'call_abc123',
185
+ type: 'function',
186
+ function: {
187
+ name: 'Read',
188
+ arguments: '{"file_path": "/test.txt"}'
189
+ }
190
+ }]
191
+ },
192
+ finish_reason: 'tool_calls'
193
+ }],
194
+ usage: { prompt_tokens: 10, completion_tokens: 20, total_tokens: 30 }
195
+ };
196
+
197
+ const anthropicRes = proxy.convertOpenAIToAnthropic(openaiRes);
198
+
199
+ expect(anthropicRes.content).toHaveLength(1);
200
+ expect(anthropicRes.content[0].type).toBe('tool_use');
201
+ expect(anthropicRes.content[0].id).toBe('call_abc123');
202
+ expect(anthropicRes.content[0].name).toBe('Read');
203
+ expect(anthropicRes.content[0].input).toEqual({ file_path: '/test.txt' });
204
+ expect(anthropicRes.stop_reason).toBe('tool_use');
205
+ });
206
+
207
+ it('should convert mixed content response', () => {
208
+ const openaiRes = {
209
+ id: 'chatcmpl-123',
210
+ model: 'openai/gpt-4o-mini',
211
+ choices: [{
212
+ message: {
213
+ role: 'assistant',
214
+ content: 'Let me read that file',
215
+ tool_calls: [{
216
+ id: 'call_abc123',
217
+ type: 'function',
218
+ function: {
219
+ name: 'Read',
220
+ arguments: '{"file_path": "/test.txt"}'
221
+ }
222
+ }]
223
+ },
224
+ finish_reason: 'tool_calls'
225
+ }],
226
+ usage: { prompt_tokens: 10, completion_tokens: 20, total_tokens: 30 }
227
+ };
228
+
229
+ const anthropicRes = proxy.convertOpenAIToAnthropic(openaiRes);
230
+
231
+ expect(anthropicRes.content).toHaveLength(2); // tool_use + text
232
+ expect(anthropicRes.content[0].type).toBe('tool_use');
233
+ expect(anthropicRes.content[1].type).toBe('text');
234
+ });
235
+ });
236
+ ```
237
+
238
+ #### 1.4 Error Handling
239
+
240
+ ```typescript
241
+ describe('AnthropicToRequestyProxy - Error Handling', () => {
242
+ it('should handle invalid API key', async () => {
243
+ const proxy = new AnthropicToRequestyProxy({
244
+ requestyApiKey: 'invalid-key'
245
+ });
246
+
247
+ await expect(proxy.handleRequest(validRequest, mockRes))
248
+ .rejects.toThrow('Invalid API key');
249
+ });
250
+
251
+ it('should handle rate limit errors', async () => {
252
+ // Mock 429 response
253
+ global.fetch = jest.fn().mockResolvedValue({
254
+ ok: false,
255
+ status: 429,
256
+ headers: new Map([['Retry-After', '60']]),
257
+ text: async () => 'Rate limit exceeded'
258
+ });
259
+
260
+ await expect(proxy.handleRequest(validRequest, mockRes))
261
+ .rejects.toThrow('Rate limit exceeded');
262
+ });
263
+
264
+ it('should handle model not found', async () => {
265
+ const req = {
266
+ model: 'invalid/model',
267
+ messages: [{ role: 'user', content: 'Test' }]
268
+ };
269
+
270
+ await expect(proxy.handleRequest(req, mockRes))
271
+ .rejects.toThrow('Model not found');
272
+ });
273
+ });
274
+ ```
275
+
276
+ ### Unit Test Coverage Goals
277
+
278
+ - [ ] Proxy initialization: 100%
279
+ - [ ] Request conversion: 95%
280
+ - [ ] Response conversion: 95%
281
+ - [ ] Tool calling: 100%
282
+ - [ ] Error handling: 90%
283
+ - [ ] **Overall: >90%**
284
+
285
+ ---
286
+
287
+ ## 2. Integration Tests
288
+
289
+ ### 2.1 CLI to Proxy Integration
290
+
291
+ ```bash
292
+ #!/bin/bash
293
+ # tests/integration/requesty-cli.sh
294
+
295
+ echo "=== Requesty CLI Integration Tests ==="
296
+
297
+ # Test 1: Basic provider detection
298
+ echo "Test 1: Provider detection via flag"
299
+ npx agentic-flow --agent coder \
300
+ --task "Say hello" \
301
+ --provider requesty \
302
+ --model "openai/gpt-4o-mini" | grep "Requesty"
303
+
304
+ # Test 2: Provider detection via env var
305
+ echo "Test 2: Provider detection via USE_REQUESTY"
306
+ USE_REQUESTY=true npx agentic-flow --agent coder \
307
+ --task "Say hello" | grep "Requesty"
308
+
309
+ # Test 3: API key validation (missing key)
310
+ echo "Test 3: Missing API key error"
311
+ REQUESTY_API_KEY= npx agentic-flow --agent coder \
312
+ --task "Test" \
313
+ --provider requesty 2>&1 | grep "REQUESTY_API_KEY required"
314
+
315
+ # Test 4: Proxy startup
316
+ echo "Test 4: Proxy starts on port 3000"
317
+ npx agentic-flow --agent coder \
318
+ --task "Test" \
319
+ --provider requesty 2>&1 | grep "http://localhost:3000"
320
+
321
+ # Test 5: Model override
322
+ echo "Test 5: Model override works"
323
+ npx agentic-flow --agent coder \
324
+ --task "Test" \
325
+ --provider requesty \
326
+ --model "anthropic/claude-3.5-sonnet" 2>&1 | grep "claude-3.5-sonnet"
327
+ ```
328
+
329
+ ### 2.2 Proxy to Requesty API Integration
330
+
331
+ ```bash
332
+ #!/bin/bash
333
+ # tests/integration/requesty-api.sh
334
+
335
+ echo "=== Requesty API Integration Tests ==="
336
+
337
+ # Test 1: Chat completions endpoint
338
+ curl -X POST http://localhost:3000/v1/messages \
339
+ -H "Content-Type: application/json" \
340
+ -H "x-api-key: test-key" \
341
+ -d '{
342
+ "model": "openai/gpt-4o-mini",
343
+ "messages": [{"role": "user", "content": "Hello"}]
344
+ }'
345
+
346
+ # Test 2: Tool calling
347
+ curl -X POST http://localhost:3000/v1/messages \
348
+ -H "Content-Type: application/json" \
349
+ -H "x-api-key: test-key" \
350
+ -d '{
351
+ "model": "openai/gpt-4o-mini",
352
+ "messages": [{"role": "user", "content": "Read file.txt"}],
353
+ "tools": [{
354
+ "name": "Read",
355
+ "input_schema": {
356
+ "type": "object",
357
+ "properties": {"file_path": {"type": "string"}},
358
+ "required": ["file_path"]
359
+ }
360
+ }]
361
+ }'
362
+
363
+ # Test 3: Health check
364
+ curl http://localhost:3000/health
365
+ ```
366
+
367
+ ### 2.3 End-to-End User Workflows
368
+
369
+ #### Workflow 1: Simple Code Generation
370
+
371
+ ```bash
372
+ npx agentic-flow --agent coder \
373
+ --task "Create a Python function that adds two numbers" \
374
+ --provider requesty \
375
+ --model "openai/gpt-4o-mini"
376
+ ```
377
+
378
+ **Expected:**
379
+ - Proxy starts
380
+ - Request sent to Requesty
381
+ - Python function generated
382
+ - Exit code 0
383
+
384
+ #### Workflow 2: File Operations with Tools
385
+
386
+ ```bash
387
+ npx agentic-flow --agent coder \
388
+ --task "Create a file hello.py with a hello world function" \
389
+ --provider requesty
390
+ ```
391
+
392
+ **Expected:**
393
+ - Tool calling works
394
+ - File created: `hello.py`
395
+ - Function is valid Python
396
+ - Exit code 0
397
+
398
+ #### Workflow 3: Research with Streaming
399
+
400
+ ```bash
401
+ npx agentic-flow --agent researcher \
402
+ --task "Explain machine learning in simple terms" \
403
+ --provider requesty \
404
+ --model "anthropic/claude-3.5-sonnet" \
405
+ --stream
406
+ ```
407
+
408
+ **Expected:**
409
+ - Streaming output (real-time)
410
+ - Coherent explanation
411
+ - Exit code 0
412
+
413
+ #### Workflow 4: Multi-Step Task
414
+
415
+ ```bash
416
+ npx agentic-flow --agent coder \
417
+ --task "Create a REST API with Express.js - include routes for GET /users and POST /users" \
418
+ --provider requesty \
419
+ --model "openai/gpt-4o"
420
+ ```
421
+
422
+ **Expected:**
423
+ - Multiple files created
424
+ - Valid Express.js code
425
+ - Includes route handlers
426
+ - Exit code 0
427
+
428
+ ### Integration Test Matrix
429
+
430
+ | Test ID | Component | Input | Expected Output | Status |
431
+ |---------|-----------|-------|-----------------|--------|
432
+ | INT-01 | CLI Detection | `--provider requesty` | Proxy starts | [ ] |
433
+ | INT-02 | CLI Detection | `USE_REQUESTY=true` | Proxy starts | [ ] |
434
+ | INT-03 | CLI Validation | Missing API key | Error message | [ ] |
435
+ | INT-04 | Proxy Startup | Start proxy | Port 3000 listening | [ ] |
436
+ | INT-05 | Proxy Health | GET /health | 200 OK | [ ] |
437
+ | INT-06 | API Request | Simple chat | Valid response | [ ] |
438
+ | INT-07 | Tool Calling | Request with tools | Tool use response | [ ] |
439
+ | INT-08 | Streaming | Stream flag | SSE events | [ ] |
440
+ | INT-09 | Model Override | Different model | Model changed | [ ] |
441
+ | INT-10 | Error Handling | Invalid key | 401 error | [ ] |
442
+
443
+ ---
444
+
445
+ ## 3. Model-Specific Tests
446
+
447
+ ### Test Different Model Families
448
+
449
+ #### 3.1 OpenAI Models
450
+
451
+ ```bash
452
+ # GPT-4o Mini (fast, cheap)
453
+ npx agentic-flow --agent coder \
454
+ --task "Create a hello function" \
455
+ --provider requesty \
456
+ --model "openai/gpt-4o-mini"
457
+
458
+ # GPT-4o (premium quality)
459
+ npx agentic-flow --agent coder \
460
+ --task "Create a complex sorting algorithm" \
461
+ --provider requesty \
462
+ --model "openai/gpt-4o"
463
+
464
+ # GPT-4 Turbo
465
+ npx agentic-flow --agent researcher \
466
+ --task "Research quantum computing" \
467
+ --provider requesty \
468
+ --model "openai/gpt-4-turbo"
469
+ ```
470
+
471
+ #### 3.2 Anthropic Models
472
+
473
+ ```bash
474
+ # Claude 3.5 Sonnet
475
+ npx agentic-flow --agent coder \
476
+ --task "Write a file parser" \
477
+ --provider requesty \
478
+ --model "anthropic/claude-3.5-sonnet"
479
+
480
+ # Claude 3 Haiku (fast)
481
+ npx agentic-flow --agent coder \
482
+ --task "Simple function" \
483
+ --provider requesty \
484
+ --model "anthropic/claude-3-haiku"
485
+ ```
486
+
487
+ #### 3.3 Google Models
488
+
489
+ ```bash
490
+ # Gemini 2.5 Flash (FREE)
491
+ npx agentic-flow --agent coder \
492
+ --task "Create a calculator" \
493
+ --provider requesty \
494
+ --model "google/gemini-2.5-flash"
495
+
496
+ # Gemini 2.5 Pro
497
+ npx agentic-flow --agent researcher \
498
+ --task "Analyze AI trends" \
499
+ --provider requesty \
500
+ --model "google/gemini-2.5-pro"
501
+ ```
502
+
503
+ #### 3.4 DeepSeek Models
504
+
505
+ ```bash
506
+ # DeepSeek Chat V3 (cheap)
507
+ npx agentic-flow --agent coder \
508
+ --task "Create API endpoint" \
509
+ --provider requesty \
510
+ --model "deepseek/deepseek-chat-v3"
511
+
512
+ # DeepSeek Coder
513
+ npx agentic-flow --agent coder \
514
+ --task "Write Python script" \
515
+ --provider requesty \
516
+ --model "deepseek/deepseek-coder"
517
+ ```
518
+
519
+ #### 3.5 Meta/Llama Models
520
+
521
+ ```bash
522
+ # Llama 3.3 70B
523
+ npx agentic-flow --agent coder \
524
+ --task "Create function" \
525
+ --provider requesty \
526
+ --model "meta-llama/llama-3.3-70b-instruct"
527
+
528
+ # Llama 3.3 8B (fast)
529
+ npx agentic-flow --agent coder \
530
+ --task "Simple task" \
531
+ --provider requesty \
532
+ --model "meta-llama/llama-3.3-8b-instruct"
533
+ ```
534
+
535
+ ### Model Test Matrix
536
+
537
+ | Model | Provider | Tools | Stream | Expected Time | Status |
538
+ |-------|----------|-------|--------|---------------|--------|
539
+ | gpt-4o-mini | OpenAI | ✓ | ✓ | <5s | [ ] |
540
+ | gpt-4o | OpenAI | ✓ | ✓ | <10s | [ ] |
541
+ | claude-3.5-sonnet | Anthropic | ✓ | ✓ | <15s | [ ] |
542
+ | claude-3-haiku | Anthropic | ✓ | ✓ | <5s | [ ] |
543
+ | gemini-2.5-flash | Google | ✓ | ✓ | <3s | [ ] |
544
+ | gemini-2.5-pro | Google | ✓ | ✓ | <10s | [ ] |
545
+ | deepseek-chat-v3 | DeepSeek | ✓ | ✓ | <8s | [ ] |
546
+ | llama-3.3-70b | Meta | ✓ | ✓ | <12s | [ ] |
547
+
548
+ ---
549
+
550
+ ## 4. Performance Tests
551
+
552
+ ### 4.1 Latency Testing
553
+
554
+ ```bash
555
+ #!/bin/bash
556
+ # tests/performance/latency.sh
557
+
558
+ echo "=== Requesty Performance Tests ==="
559
+
560
+ for i in {1..10}; do
561
+ start=$(date +%s%N)
562
+
563
+ npx agentic-flow --agent coder \
564
+ --task "Say hello" \
565
+ --provider requesty \
566
+ --model "openai/gpt-4o-mini" > /dev/null
567
+
568
+ end=$(date +%s%N)
569
+ duration=$(( (end - start) / 1000000 ))
570
+
571
+ echo "Request $i: ${duration}ms"
572
+ done
573
+ ```
574
+
575
+ **Success Criteria:**
576
+ - Average latency < 3000ms
577
+ - P95 latency < 5000ms
578
+ - No timeouts
579
+
580
+ ### 4.2 Concurrent Requests
581
+
582
+ ```bash
583
+ #!/bin/bash
584
+ # tests/performance/concurrent.sh
585
+
586
+ echo "=== Concurrent Request Test ==="
587
+
588
+ for i in {1..5}; do
589
+ npx agentic-flow --agent coder \
590
+ --task "Task $i" \
591
+ --provider requesty &
592
+ done
593
+
594
+ wait
595
+ echo "All concurrent requests completed"
596
+ ```
597
+
598
+ **Success Criteria:**
599
+ - All requests complete successfully
600
+ - No proxy crashes
601
+ - No rate limit errors (or proper retry)
602
+
603
+ ### 4.3 Large Context Test
604
+
605
+ ```bash
606
+ # Test with large system prompt
607
+ npx agentic-flow --agent coder \
608
+ --task "$(cat large-context.txt)" \
609
+ --provider requesty \
610
+ --model "google/gemini-2.5-pro" # Large context window
611
+ ```
612
+
613
+ **Success Criteria:**
614
+ - Request succeeds
615
+ - No context truncation errors
616
+ - Response is relevant
617
+
618
+ ---
619
+
620
+ ## 5. Security Tests
621
+
622
+ ### 5.1 API Key Handling
623
+
624
+ **Test:** Verify API key is not logged
625
+
626
+ ```bash
627
+ # Run with verbose logging
628
+ VERBOSE=true npx agentic-flow --agent coder \
629
+ --task "Test" \
630
+ --provider requesty 2>&1 | grep -c "requesty-"
631
+ ```
632
+
633
+ **Expected:** 0 matches (only prefix should be logged)
634
+
635
+ ### 5.2 API Key Validation
636
+
637
+ ```bash
638
+ # Test invalid key format
639
+ REQUESTY_API_KEY="invalid" npx agentic-flow --agent coder \
640
+ --task "Test" \
641
+ --provider requesty
642
+ ```
643
+
644
+ **Expected:** Error message about invalid key
645
+
646
+ ### 5.3 Environment Isolation
647
+
648
+ ```bash
649
+ # Verify proxy doesn't leak API key to client
650
+ curl http://localhost:3000/v1/messages \
651
+ -H "Content-Type: application/json" \
652
+ -d '{"model": "openai/gpt-4o-mini", "messages": [{"role": "user", "content": "Hello"}]}' \
653
+ | grep -c "requesty-"
654
+ ```
655
+
656
+ **Expected:** 0 matches (API key should not be in response)
657
+
658
+ ---
659
+
660
+ ## 6. Error Handling Tests
661
+
662
+ ### 6.1 Invalid API Key
663
+
664
+ ```bash
665
+ REQUESTY_API_KEY="requesty-invalid" npx agentic-flow --agent coder \
666
+ --task "Test" \
667
+ --provider requesty
668
+ ```
669
+
670
+ **Expected:**
671
+ - HTTP 401 Unauthorized
672
+ - Clear error message
673
+ - Exit code 1
674
+
675
+ ### 6.2 Rate Limiting
676
+
677
+ ```bash
678
+ # Send many requests quickly
679
+ for i in {1..50}; do
680
+ npx agentic-flow --agent coder \
681
+ --task "Test $i" \
682
+ --provider requesty &
683
+ done
684
+ wait
685
+ ```
686
+
687
+ **Expected:**
688
+ - Some requests succeed
689
+ - Some requests retry (429 errors)
690
+ - All eventually complete or fail gracefully
691
+
692
+ ### 6.3 Model Not Found
693
+
694
+ ```bash
695
+ npx agentic-flow --agent coder \
696
+ --task "Test" \
697
+ --provider requesty \
698
+ --model "invalid/model-123"
699
+ ```
700
+
701
+ **Expected:**
702
+ - HTTP 404 or 400
703
+ - Clear error message
704
+ - Exit code 1
705
+
706
+ ### 6.4 Network Timeout
707
+
708
+ ```bash
709
+ # Mock network timeout (requires proxy modification for testing)
710
+ REQUESTY_TIMEOUT=1 npx agentic-flow --agent coder \
711
+ --task "Long task" \
712
+ --provider requesty
713
+ ```
714
+
715
+ **Expected:**
716
+ - Timeout error
717
+ - Retry attempt
718
+ - Clear error message
719
+
720
+ ---
721
+
722
+ ## 7. Compatibility Tests
723
+
724
+ ### 7.1 Cross-Platform
725
+
726
+ Test on multiple OS:
727
+
728
+ - [ ] Linux (Ubuntu 22.04)
729
+ - [ ] macOS (Ventura+)
730
+ - [ ] Windows (WSL2)
731
+
732
+ ### 7.2 Node.js Versions
733
+
734
+ Test with different Node versions:
735
+
736
+ - [ ] Node.js 18.x
737
+ - [ ] Node.js 20.x
738
+ - [ ] Node.js 22.x
739
+
740
+ ### 7.3 Package Managers
741
+
742
+ Test with different package managers:
743
+
744
+ - [ ] npm
745
+ - [ ] yarn
746
+ - [ ] pnpm
747
+
748
+ ---
749
+
750
+ ## 8. Regression Tests
751
+
752
+ ### 8.1 Existing Functionality
753
+
754
+ Verify Requesty doesn't break existing providers:
755
+
756
+ ```bash
757
+ # Test Anthropic (should still work)
758
+ npx agentic-flow --agent coder \
759
+ --task "Test" \
760
+ --provider anthropic
761
+
762
+ # Test OpenRouter (should still work)
763
+ npx agentic-flow --agent coder \
764
+ --task "Test" \
765
+ --provider openrouter
766
+
767
+ # Test Gemini (should still work)
768
+ npx agentic-flow --agent coder \
769
+ --task "Test" \
770
+ --provider gemini
771
+
772
+ # Test ONNX (should still work)
773
+ npx agentic-flow --agent coder \
774
+ --task "Test" \
775
+ --provider onnx
776
+ ```
777
+
778
+ **Success Criteria:**
779
+ - All providers still work
780
+ - No interference between providers
781
+ - Proxy ports don't conflict
782
+
783
+ ---
784
+
785
+ ## 9. Acceptance Criteria
786
+
787
+ ### Must Pass (MVP)
788
+
789
+ - [ ] Unit tests: >90% coverage
790
+ - [ ] At least 5 models tested successfully
791
+ - [ ] Tool calling works (1+ model)
792
+ - [ ] Streaming works (1+ model)
793
+ - [ ] Error handling for invalid API key
794
+ - [ ] No regressions in existing providers
795
+ - [ ] Documentation complete
796
+
797
+ ### Should Pass (V1)
798
+
799
+ - [ ] 10+ models tested
800
+ - [ ] Performance tests pass
801
+ - [ ] Security tests pass
802
+ - [ ] Cross-platform tested
803
+ - [ ] Concurrent requests work
804
+ - [ ] Rate limiting handled
805
+
806
+ ### Nice to Have (Future)
807
+
808
+ - [ ] 20+ models tested
809
+ - [ ] Load testing (100+ concurrent)
810
+ - [ ] Automated test suite
811
+ - [ ] CI/CD integration
812
+
813
+ ---
814
+
815
+ ## 10. Test Execution Plan
816
+
817
+ ### Day 1: Unit Tests
818
+ - Write test files
819
+ - Run unit tests
820
+ - Fix any failures
821
+ - Achieve >90% coverage
822
+
823
+ ### Day 2: Integration Tests
824
+ - Test CLI integration
825
+ - Test proxy integration
826
+ - Test API integration
827
+ - Document results
828
+
829
+ ### Day 3: Model Testing
830
+ - Test 5+ models
831
+ - Test tool calling
832
+ - Test streaming
833
+ - Document results
834
+
835
+ ### Day 4: Final Validation
836
+ - Run all tests
837
+ - Fix any regressions
838
+ - Update documentation
839
+ - Sign off
840
+
841
+ ---
842
+
843
+ ## 11. Bug Reporting Template
844
+
845
+ When filing bugs, use this template:
846
+
847
+ ```markdown
848
+ ## Bug Report: Requesty Integration
849
+
850
+ **Test Category:** [Unit/Integration/E2E/Performance/Security]
851
+ **Test ID:** [e.g., INT-07]
852
+
853
+ **Description:**
854
+ [Clear description of the issue]
855
+
856
+ **Steps to Reproduce:**
857
+ 1. Step 1
858
+ 2. Step 2
859
+ 3. Step 3
860
+
861
+ **Expected Behavior:**
862
+ [What should happen]
863
+
864
+ **Actual Behavior:**
865
+ [What actually happened]
866
+
867
+ **Environment:**
868
+ - OS: [e.g., Ubuntu 22.04]
869
+ - Node.js: [e.g., 20.10.0]
870
+ - agentic-flow: [e.g., 1.3.0]
871
+ - Requesty Model: [e.g., openai/gpt-4o-mini]
872
+
873
+ **Logs:**
874
+ [Paste relevant logs]
875
+
876
+ **Screenshots:**
877
+ [If applicable]
878
+ ```
879
+
880
+ ---
881
+
882
+ ## 12. Test Results Dashboard
883
+
884
+ ### Summary
885
+
886
+ | Category | Total Tests | Passed | Failed | Skipped | Coverage |
887
+ |----------|-------------|--------|--------|---------|----------|
888
+ | Unit | 0 | 0 | 0 | 0 | 0% |
889
+ | Integration | 0 | 0 | 0 | 0 | N/A |
890
+ | E2E | 0 | 0 | 0 | 0 | N/A |
891
+ | Performance | 0 | 0 | 0 | 0 | N/A |
892
+ | Security | 0 | 0 | 0 | 0 | N/A |
893
+ | **Total** | **0** | **0** | **0** | **0** | **0%** |
894
+
895
+ *(To be filled during testing)*
896
+
897
+ ---
898
+
899
+ ## Conclusion
900
+
901
+ This testing strategy ensures comprehensive validation of the Requesty integration across all critical dimensions: functionality, performance, security, and compatibility. By following this plan, we can confidently release the Requesty provider to users.
902
+
903
+ **Total Testing Time:** ~3 hours
904
+ **Test Coverage Goal:** >90%
905
+ **Model Coverage Goal:** 5+ models (MVP), 10+ models (V1)