@claude-flow/cli 3.10.45 → 3.11.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 (560) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  2. package/.claude/agents/analysis/code-analyzer.md +209 -209
  3. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  4. package/.claude/agents/architecture/arch-system-design.md +156 -156
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/browser/browser-agent.yaml +182 -182
  7. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  8. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  9. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  10. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  11. package/.claude/agents/consensus/quorum-manager.md +822 -822
  12. package/.claude/agents/consensus/raft-manager.md +62 -62
  13. package/.claude/agents/consensus/security-manager.md +621 -621
  14. package/.claude/agents/core/planner.md +374 -374
  15. package/.claude/agents/custom/test-long-runner.md +44 -44
  16. package/.claude/agents/data/data-ml-model.md +444 -444
  17. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  18. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  19. package/.claude/agents/development/dev-backend-api.md +344 -344
  20. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  21. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  22. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  23. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  24. package/.claude/agents/flow-nexus/app-store.md +87 -87
  25. package/.claude/agents/flow-nexus/authentication.md +68 -68
  26. package/.claude/agents/flow-nexus/challenges.md +80 -80
  27. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  28. package/.claude/agents/flow-nexus/payments.md +82 -82
  29. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  30. package/.claude/agents/flow-nexus/swarm.md +75 -75
  31. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  32. package/.claude/agents/flow-nexus/workflow.md +83 -83
  33. package/.claude/agents/github/code-review-swarm.md +377 -377
  34. package/.claude/agents/github/github-modes.md +172 -172
  35. package/.claude/agents/github/issue-tracker.md +575 -575
  36. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  37. package/.claude/agents/github/pr-manager.md +437 -437
  38. package/.claude/agents/github/project-board-sync.md +508 -508
  39. package/.claude/agents/github/release-manager.md +604 -604
  40. package/.claude/agents/github/release-swarm.md +582 -582
  41. package/.claude/agents/github/repo-architect.md +397 -397
  42. package/.claude/agents/github/swarm-issue.md +572 -572
  43. package/.claude/agents/github/swarm-pr.md +427 -427
  44. package/.claude/agents/github/sync-coordinator.md +451 -451
  45. package/.claude/agents/github/workflow-automation.md +902 -902
  46. package/.claude/agents/goal/agent.md +815 -815
  47. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  48. package/.claude/agents/optimization/load-balancer.md +430 -430
  49. package/.claude/agents/optimization/performance-monitor.md +671 -671
  50. package/.claude/agents/optimization/resource-allocator.md +673 -673
  51. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  52. package/.claude/agents/payments/agentic-payments.md +126 -126
  53. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  54. package/.claude/agents/sparc/architecture.md +698 -698
  55. package/.claude/agents/sparc/pseudocode.md +519 -519
  56. package/.claude/agents/sparc/refinement.md +801 -801
  57. package/.claude/agents/sparc/specification.md +477 -477
  58. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  59. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  60. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  61. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  62. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  63. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  64. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  65. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  66. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  67. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  68. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  69. package/.claude/agents/templates/base-template-generator.md +289 -289
  70. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  71. package/.claude/agents/templates/github-pr-manager.md +176 -176
  72. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  73. package/.claude/agents/templates/memory-coordinator.md +186 -186
  74. package/.claude/agents/templates/orchestrator-task.md +138 -138
  75. package/.claude/agents/templates/performance-analyzer.md +198 -198
  76. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  77. package/.claude/agents/testing/production-validator.md +394 -394
  78. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  79. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  80. package/.claude/agents/v3/claims-authorizer.md +208 -208
  81. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  82. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  83. package/.claude/agents/v3/injection-analyst.md +236 -236
  84. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  85. package/.claude/agents/v3/pii-detector.md +151 -151
  86. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  87. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  88. package/.claude/agents/v3/security-architect.md +867 -867
  89. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  90. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  91. package/.claude/commands/agents/README.md +50 -50
  92. package/.claude/commands/agents/agent-capabilities.md +140 -140
  93. package/.claude/commands/agents/agent-coordination.md +28 -28
  94. package/.claude/commands/agents/agent-spawning.md +28 -28
  95. package/.claude/commands/agents/agent-types.md +216 -216
  96. package/.claude/commands/agents/health.md +139 -139
  97. package/.claude/commands/agents/list.md +100 -100
  98. package/.claude/commands/agents/logs.md +130 -130
  99. package/.claude/commands/agents/metrics.md +122 -122
  100. package/.claude/commands/agents/pool.md +127 -127
  101. package/.claude/commands/agents/spawn.md +140 -140
  102. package/.claude/commands/agents/status.md +115 -115
  103. package/.claude/commands/agents/stop.md +102 -102
  104. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  105. package/.claude/commands/analysis/README.md +9 -9
  106. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  107. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  108. package/.claude/commands/analysis/performance-report.md +25 -25
  109. package/.claude/commands/analysis/token-efficiency.md +44 -44
  110. package/.claude/commands/analysis/token-usage.md +25 -25
  111. package/.claude/commands/automation/README.md +9 -9
  112. package/.claude/commands/automation/auto-agent.md +122 -122
  113. package/.claude/commands/automation/self-healing.md +105 -105
  114. package/.claude/commands/automation/session-memory.md +89 -89
  115. package/.claude/commands/automation/smart-agents.md +72 -72
  116. package/.claude/commands/automation/smart-spawn.md +25 -25
  117. package/.claude/commands/automation/workflow-select.md +25 -25
  118. package/.claude/commands/claude-flow-help.md +103 -103
  119. package/.claude/commands/claude-flow-memory.md +107 -107
  120. package/.claude/commands/claude-flow-swarm.md +205 -205
  121. package/.claude/commands/coordination/README.md +9 -9
  122. package/.claude/commands/coordination/agent-spawn.md +25 -25
  123. package/.claude/commands/coordination/init.md +44 -44
  124. package/.claude/commands/coordination/orchestrate.md +43 -43
  125. package/.claude/commands/coordination/spawn.md +45 -45
  126. package/.claude/commands/coordination/swarm-init.md +85 -85
  127. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  128. package/.claude/commands/github/README.md +11 -11
  129. package/.claude/commands/github/code-review-swarm.md +513 -513
  130. package/.claude/commands/github/code-review.md +25 -25
  131. package/.claude/commands/github/github-modes.md +146 -146
  132. package/.claude/commands/github/github-swarm.md +121 -121
  133. package/.claude/commands/github/issue-tracker.md +291 -291
  134. package/.claude/commands/github/issue-triage.md +25 -25
  135. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  136. package/.claude/commands/github/pr-enhance.md +26 -26
  137. package/.claude/commands/github/pr-manager.md +169 -169
  138. package/.claude/commands/github/project-board-sync.md +470 -470
  139. package/.claude/commands/github/release-manager.md +339 -339
  140. package/.claude/commands/github/release-swarm.md +543 -543
  141. package/.claude/commands/github/repo-analyze.md +25 -25
  142. package/.claude/commands/github/repo-architect.md +366 -366
  143. package/.claude/commands/github/swarm-issue.md +484 -484
  144. package/.claude/commands/github/swarm-pr.md +287 -287
  145. package/.claude/commands/github/sync-coordinator.md +302 -302
  146. package/.claude/commands/github/workflow-automation.md +441 -441
  147. package/.claude/commands/hive-mind/README.md +17 -17
  148. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  149. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  150. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  151. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  152. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  153. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  154. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  155. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  156. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  157. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  159. package/.claude/commands/hooks/README.md +11 -11
  160. package/.claude/commands/hooks/overview.md +57 -57
  161. package/.claude/commands/hooks/post-edit.md +117 -117
  162. package/.claude/commands/hooks/post-task.md +112 -112
  163. package/.claude/commands/hooks/pre-edit.md +113 -113
  164. package/.claude/commands/hooks/pre-task.md +111 -111
  165. package/.claude/commands/hooks/session-end.md +118 -118
  166. package/.claude/commands/hooks/setup.md +102 -102
  167. package/.claude/commands/memory/README.md +9 -9
  168. package/.claude/commands/memory/memory-persist.md +25 -25
  169. package/.claude/commands/memory/memory-search.md +25 -25
  170. package/.claude/commands/memory/memory-usage.md +25 -25
  171. package/.claude/commands/memory/neural.md +47 -47
  172. package/.claude/commands/monitoring/README.md +9 -9
  173. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  174. package/.claude/commands/monitoring/agents.md +44 -44
  175. package/.claude/commands/monitoring/real-time-view.md +25 -25
  176. package/.claude/commands/monitoring/status.md +46 -46
  177. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  178. package/.claude/commands/optimization/README.md +9 -9
  179. package/.claude/commands/optimization/auto-topology.md +61 -61
  180. package/.claude/commands/optimization/cache-manage.md +25 -25
  181. package/.claude/commands/optimization/parallel-execute.md +25 -25
  182. package/.claude/commands/optimization/parallel-execution.md +49 -49
  183. package/.claude/commands/optimization/topology-optimize.md +25 -25
  184. package/.claude/commands/pair/README.md +260 -260
  185. package/.claude/commands/pair/commands.md +545 -545
  186. package/.claude/commands/pair/config.md +509 -509
  187. package/.claude/commands/pair/examples.md +511 -511
  188. package/.claude/commands/pair/modes.md +347 -347
  189. package/.claude/commands/pair/session.md +406 -406
  190. package/.claude/commands/pair/start.md +208 -208
  191. package/.claude/commands/sparc/analyzer.md +51 -51
  192. package/.claude/commands/sparc/architect.md +53 -53
  193. package/.claude/commands/sparc/ask.md +97 -97
  194. package/.claude/commands/sparc/batch-executor.md +54 -54
  195. package/.claude/commands/sparc/code.md +89 -89
  196. package/.claude/commands/sparc/coder.md +54 -54
  197. package/.claude/commands/sparc/debug.md +83 -83
  198. package/.claude/commands/sparc/debugger.md +54 -54
  199. package/.claude/commands/sparc/designer.md +53 -53
  200. package/.claude/commands/sparc/devops.md +109 -109
  201. package/.claude/commands/sparc/docs-writer.md +80 -80
  202. package/.claude/commands/sparc/documenter.md +54 -54
  203. package/.claude/commands/sparc/innovator.md +54 -54
  204. package/.claude/commands/sparc/integration.md +83 -83
  205. package/.claude/commands/sparc/mcp.md +117 -117
  206. package/.claude/commands/sparc/memory-manager.md +54 -54
  207. package/.claude/commands/sparc/optimizer.md +54 -54
  208. package/.claude/commands/sparc/orchestrator.md +131 -131
  209. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  210. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  211. package/.claude/commands/sparc/researcher.md +54 -54
  212. package/.claude/commands/sparc/reviewer.md +54 -54
  213. package/.claude/commands/sparc/security-review.md +80 -80
  214. package/.claude/commands/sparc/sparc-modes.md +174 -174
  215. package/.claude/commands/sparc/sparc.md +111 -111
  216. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  217. package/.claude/commands/sparc/supabase-admin.md +348 -348
  218. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  219. package/.claude/commands/sparc/tdd.md +54 -54
  220. package/.claude/commands/sparc/tester.md +54 -54
  221. package/.claude/commands/sparc/tutorial.md +79 -79
  222. package/.claude/commands/sparc/workflow-manager.md +54 -54
  223. package/.claude/commands/sparc.md +166 -166
  224. package/.claude/commands/stream-chain/pipeline.md +120 -120
  225. package/.claude/commands/stream-chain/run.md +69 -69
  226. package/.claude/commands/swarm/README.md +15 -15
  227. package/.claude/commands/swarm/analysis.md +95 -95
  228. package/.claude/commands/swarm/development.md +96 -96
  229. package/.claude/commands/swarm/examples.md +168 -168
  230. package/.claude/commands/swarm/maintenance.md +102 -102
  231. package/.claude/commands/swarm/optimization.md +117 -117
  232. package/.claude/commands/swarm/research.md +136 -136
  233. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  234. package/.claude/commands/swarm/swarm-background.md +8 -8
  235. package/.claude/commands/swarm/swarm-init.md +19 -19
  236. package/.claude/commands/swarm/swarm-modes.md +8 -8
  237. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  238. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  239. package/.claude/commands/swarm/swarm-status.md +8 -8
  240. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  241. package/.claude/commands/swarm/swarm.md +87 -87
  242. package/.claude/commands/swarm/testing.md +131 -131
  243. package/.claude/commands/training/README.md +9 -9
  244. package/.claude/commands/training/model-update.md +25 -25
  245. package/.claude/commands/training/neural-patterns.md +107 -107
  246. package/.claude/commands/training/neural-train.md +75 -75
  247. package/.claude/commands/training/pattern-learn.md +25 -25
  248. package/.claude/commands/training/specialization.md +62 -62
  249. package/.claude/commands/truth/start.md +142 -142
  250. package/.claude/commands/verify/check.md +49 -49
  251. package/.claude/commands/verify/start.md +127 -127
  252. package/.claude/commands/workflows/README.md +9 -9
  253. package/.claude/commands/workflows/development.md +77 -77
  254. package/.claude/commands/workflows/research.md +62 -62
  255. package/.claude/commands/workflows/workflow-create.md +25 -25
  256. package/.claude/commands/workflows/workflow-execute.md +25 -25
  257. package/.claude/commands/workflows/workflow-export.md +25 -25
  258. package/.claude/helpers/README.md +96 -96
  259. package/.claude/helpers/adr-compliance.sh +186 -186
  260. package/.claude/helpers/auto-commit.sh +178 -178
  261. package/.claude/helpers/auto-memory-hook.mjs +368 -368
  262. package/.claude/helpers/checkpoint-manager.sh +251 -251
  263. package/.claude/helpers/daemon-manager.sh +252 -252
  264. package/.claude/helpers/ddd-tracker.sh +144 -144
  265. package/.claude/helpers/github-safe.js +156 -156
  266. package/.claude/helpers/github-setup.sh +45 -45
  267. package/.claude/helpers/guidance-hook.sh +13 -13
  268. package/.claude/helpers/guidance-hooks.sh +102 -102
  269. package/.claude/helpers/health-monitor.sh +108 -108
  270. package/.claude/helpers/hook-handler.cjs +286 -286
  271. package/.claude/helpers/intelligence.cjs +1031 -1031
  272. package/.claude/helpers/learning-hooks.sh +329 -329
  273. package/.claude/helpers/learning-optimizer.sh +127 -127
  274. package/.claude/helpers/learning-service.mjs +1144 -1144
  275. package/.claude/helpers/memory.js +83 -83
  276. package/.claude/helpers/metrics-db.mjs +488 -488
  277. package/.claude/helpers/pattern-consolidator.sh +86 -86
  278. package/.claude/helpers/perf-worker.sh +160 -160
  279. package/.claude/helpers/post-commit +16 -16
  280. package/.claude/helpers/pre-commit +26 -26
  281. package/.claude/helpers/quick-start.sh +19 -19
  282. package/.claude/helpers/router.js +105 -105
  283. package/.claude/helpers/security-scanner.sh +127 -127
  284. package/.claude/helpers/session.js +157 -157
  285. package/.claude/helpers/setup-mcp.sh +18 -18
  286. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  287. package/.claude/helpers/statusline-hook.sh +21 -21
  288. package/.claude/helpers/statusline.cjs +604 -604
  289. package/.claude/helpers/statusline.js +352 -352
  290. package/.claude/helpers/swarm-comms.sh +353 -353
  291. package/.claude/helpers/swarm-hooks.sh +761 -761
  292. package/.claude/helpers/swarm-monitor.sh +210 -210
  293. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  294. package/.claude/helpers/update-v3-progress.sh +165 -165
  295. package/.claude/helpers/v3-quick-status.sh +57 -57
  296. package/.claude/helpers/v3.sh +110 -110
  297. package/.claude/helpers/validate-v3-config.sh +215 -215
  298. package/.claude/helpers/worker-manager.sh +170 -170
  299. package/.claude/settings.json +182 -182
  300. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  301. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  302. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  303. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  304. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  305. package/.claude/skills/browser/SKILL.md +204 -204
  306. package/.claude/skills/dual-mode/README.md +71 -71
  307. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  308. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  309. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  310. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  311. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  312. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  313. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  314. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  315. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  316. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  317. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  318. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  319. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  320. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  321. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  322. package/.claude/skills/skill-builder/SKILL.md +910 -910
  323. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  324. package/.claude/skills/stream-chain/SKILL.md +560 -560
  325. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  326. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  327. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  328. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  329. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  330. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  331. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  332. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  333. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  334. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  335. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  336. package/.claude/skills/verification-quality/SKILL.md +691 -691
  337. package/README.md +412 -412
  338. package/bin/cli.js +314 -314
  339. package/bin/mcp-server.js +224 -224
  340. package/bin/preinstall.cjs +2 -2
  341. package/dist/src/benchmarks/capability-tasks.d.ts +126 -0
  342. package/dist/src/benchmarks/capability-tasks.d.ts.map +1 -0
  343. package/dist/src/benchmarks/capability-tasks.js +147 -0
  344. package/dist/src/benchmarks/capability-tasks.js.map +1 -0
  345. package/dist/src/benchmarks/gaia-agent-contrastive.d.ts +53 -0
  346. package/dist/src/benchmarks/gaia-agent-contrastive.d.ts.map +1 -0
  347. package/dist/src/benchmarks/gaia-agent-contrastive.js +177 -0
  348. package/dist/src/benchmarks/gaia-agent-contrastive.js.map +1 -0
  349. package/dist/src/benchmarks/gaia-agent-gemini.d.ts +51 -0
  350. package/dist/src/benchmarks/gaia-agent-gemini.d.ts.map +1 -0
  351. package/dist/src/benchmarks/gaia-agent-gemini.js +352 -0
  352. package/dist/src/benchmarks/gaia-agent-gemini.js.map +1 -0
  353. package/dist/src/benchmarks/gaia-claude-p.d.ts +105 -0
  354. package/dist/src/benchmarks/gaia-claude-p.d.ts.map +1 -0
  355. package/dist/src/benchmarks/gaia-claude-p.js +269 -0
  356. package/dist/src/benchmarks/gaia-claude-p.js.map +1 -0
  357. package/dist/src/benchmarks/gaia-claude-p.smoke.d.ts +20 -0
  358. package/dist/src/benchmarks/gaia-claude-p.smoke.d.ts.map +1 -0
  359. package/dist/src/benchmarks/gaia-claude-p.smoke.js +168 -0
  360. package/dist/src/benchmarks/gaia-claude-p.smoke.js.map +1 -0
  361. package/dist/src/benchmarks/gaia-codeagent-runner.py +556 -0
  362. package/dist/src/benchmarks/gaia-codeagent.d.ts +129 -0
  363. package/dist/src/benchmarks/gaia-codeagent.d.ts.map +1 -0
  364. package/dist/src/benchmarks/gaia-codeagent.js +590 -0
  365. package/dist/src/benchmarks/gaia-codeagent.js.map +1 -0
  366. package/dist/src/benchmarks/gaia-codeagent.smoke.d.ts +33 -0
  367. package/dist/src/benchmarks/gaia-codeagent.smoke.d.ts.map +1 -0
  368. package/dist/src/benchmarks/gaia-codeagent.smoke.js +241 -0
  369. package/dist/src/benchmarks/gaia-codeagent.smoke.js.map +1 -0
  370. package/dist/src/benchmarks/gaia-critic.js +24 -24
  371. package/dist/src/benchmarks/gaia-dag-pilot.d.ts +22 -0
  372. package/dist/src/benchmarks/gaia-dag-pilot.d.ts.map +1 -0
  373. package/dist/src/benchmarks/gaia-dag-pilot.js +158 -0
  374. package/dist/src/benchmarks/gaia-dag-pilot.js.map +1 -0
  375. package/dist/src/benchmarks/gaia-dag.d.ts +110 -0
  376. package/dist/src/benchmarks/gaia-dag.d.ts.map +1 -0
  377. package/dist/src/benchmarks/gaia-dag.js +658 -0
  378. package/dist/src/benchmarks/gaia-dag.js.map +1 -0
  379. package/dist/src/benchmarks/gaia-dag.smoke.d.ts +21 -0
  380. package/dist/src/benchmarks/gaia-dag.smoke.d.ts.map +1 -0
  381. package/dist/src/benchmarks/gaia-dag.smoke.js +290 -0
  382. package/dist/src/benchmarks/gaia-dag.smoke.js.map +1 -0
  383. package/dist/src/benchmarks/gaia-ensemble-pilot.d.ts +17 -0
  384. package/dist/src/benchmarks/gaia-ensemble-pilot.d.ts.map +1 -0
  385. package/dist/src/benchmarks/gaia-ensemble-pilot.js +106 -0
  386. package/dist/src/benchmarks/gaia-ensemble-pilot.js.map +1 -0
  387. package/dist/src/benchmarks/gaia-ensemble.d.ts +103 -0
  388. package/dist/src/benchmarks/gaia-ensemble.d.ts.map +1 -0
  389. package/dist/src/benchmarks/gaia-ensemble.js +462 -0
  390. package/dist/src/benchmarks/gaia-ensemble.js.map +1 -0
  391. package/dist/src/benchmarks/gaia-gemini-pilot.d.ts +17 -0
  392. package/dist/src/benchmarks/gaia-gemini-pilot.d.ts.map +1 -0
  393. package/dist/src/benchmarks/gaia-gemini-pilot.js +168 -0
  394. package/dist/src/benchmarks/gaia-gemini-pilot.js.map +1 -0
  395. package/dist/src/benchmarks/gaia-mode-router.d.ts +67 -0
  396. package/dist/src/benchmarks/gaia-mode-router.d.ts.map +1 -0
  397. package/dist/src/benchmarks/gaia-mode-router.js +126 -0
  398. package/dist/src/benchmarks/gaia-mode-router.js.map +1 -0
  399. package/dist/src/benchmarks/gaia-mode-router.smoke.d.ts +15 -0
  400. package/dist/src/benchmarks/gaia-mode-router.smoke.d.ts.map +1 -0
  401. package/dist/src/benchmarks/gaia-mode-router.smoke.js +131 -0
  402. package/dist/src/benchmarks/gaia-mode-router.smoke.js.map +1 -0
  403. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.d.ts +24 -0
  404. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.d.ts.map +1 -0
  405. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.js +276 -0
  406. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.js.map +1 -0
  407. package/dist/src/benchmarks/gaia-tools/image_describe.d.ts +45 -0
  408. package/dist/src/benchmarks/gaia-tools/image_describe.d.ts.map +1 -0
  409. package/dist/src/benchmarks/gaia-tools/image_describe.js +222 -0
  410. package/dist/src/benchmarks/gaia-tools/image_describe.js.map +1 -0
  411. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.d.ts +24 -0
  412. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.d.ts.map +1 -0
  413. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.js +169 -0
  414. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.js.map +1 -0
  415. package/dist/src/benchmarks/gaia-tools/pdf_read.d.ts +27 -0
  416. package/dist/src/benchmarks/gaia-tools/pdf_read.d.ts.map +1 -0
  417. package/dist/src/benchmarks/gaia-tools/pdf_read.js +226 -0
  418. package/dist/src/benchmarks/gaia-tools/pdf_read.js.map +1 -0
  419. package/dist/src/benchmarks/gaia-tools/python_exec.d.ts +31 -0
  420. package/dist/src/benchmarks/gaia-tools/python_exec.d.ts.map +1 -0
  421. package/dist/src/benchmarks/gaia-tools/python_exec.js +94 -0
  422. package/dist/src/benchmarks/gaia-tools/python_exec.js.map +1 -0
  423. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.d.ts +13 -0
  424. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.d.ts.map +1 -0
  425. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.js +98 -0
  426. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.js.map +1 -0
  427. package/dist/src/benchmarks/gaia-tools/visit_webpage.d.ts +52 -0
  428. package/dist/src/benchmarks/gaia-tools/visit_webpage.d.ts.map +1 -0
  429. package/dist/src/benchmarks/gaia-tools/visit_webpage.js +304 -0
  430. package/dist/src/benchmarks/gaia-tools/visit_webpage.js.map +1 -0
  431. package/dist/src/benchmarks/gaia-tools/web_browse.d.ts +61 -0
  432. package/dist/src/benchmarks/gaia-tools/web_browse.d.ts.map +1 -0
  433. package/dist/src/benchmarks/gaia-tools/web_browse.js +217 -0
  434. package/dist/src/benchmarks/gaia-tools/web_browse.js.map +1 -0
  435. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.d.ts +26 -0
  436. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.d.ts.map +1 -0
  437. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.js +152 -0
  438. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.js.map +1 -0
  439. package/dist/src/benchmarks/gaia-tools/web_search.smoke.d.ts +24 -0
  440. package/dist/src/benchmarks/gaia-tools/web_search.smoke.d.ts.map +1 -0
  441. package/dist/src/benchmarks/gaia-tools/web_search.smoke.js +311 -0
  442. package/dist/src/benchmarks/gaia-tools/web_search.smoke.js.map +1 -0
  443. package/dist/src/benchmarks/gaia-visit-webpage.smoke.d.ts +25 -0
  444. package/dist/src/benchmarks/gaia-visit-webpage.smoke.d.ts.map +1 -0
  445. package/dist/src/benchmarks/gaia-visit-webpage.smoke.js +304 -0
  446. package/dist/src/benchmarks/gaia-visit-webpage.smoke.js.map +1 -0
  447. package/dist/src/commands/completions.js +409 -409
  448. package/dist/src/commands/daemon.js +44 -44
  449. package/dist/src/commands/embeddings.js +26 -26
  450. package/dist/src/commands/hive-mind.js +97 -97
  451. package/dist/src/commands/hooks.js +9 -9
  452. package/dist/src/commands/neural.d.ts.map +1 -1
  453. package/dist/src/commands/neural.js +2351 -1
  454. package/dist/src/commands/neural.js.map +1 -1
  455. package/dist/src/commands/performance-capability.d.ts +30 -0
  456. package/dist/src/commands/performance-capability.d.ts.map +1 -0
  457. package/dist/src/commands/performance-capability.js +349 -0
  458. package/dist/src/commands/performance-capability.js.map +1 -0
  459. package/dist/src/commands/ruvector/backup.js +23 -23
  460. package/dist/src/commands/ruvector/benchmark.js +31 -31
  461. package/dist/src/commands/ruvector/import.js +14 -14
  462. package/dist/src/commands/ruvector/init.js +115 -115
  463. package/dist/src/commands/ruvector/migrate.js +99 -99
  464. package/dist/src/commands/ruvector/optimize.js +51 -51
  465. package/dist/src/commands/ruvector/setup.js +624 -624
  466. package/dist/src/commands/ruvector/status.js +38 -38
  467. package/dist/src/commands/swarm.d.ts.map +1 -1
  468. package/dist/src/commands/swarm.js +5 -1
  469. package/dist/src/commands/swarm.js.map +1 -1
  470. package/dist/src/init/claudemd-generator.js +231 -231
  471. package/dist/src/init/executor.d.ts.map +1 -1
  472. package/dist/src/init/executor.js +487 -455
  473. package/dist/src/init/executor.js.map +1 -1
  474. package/dist/src/init/helpers-generator.js +727 -727
  475. package/dist/src/init/statusline-generator.js +717 -717
  476. package/dist/src/mcp-tools/agent-execute-core.d.ts +23 -1
  477. package/dist/src/mcp-tools/agent-execute-core.d.ts.map +1 -1
  478. package/dist/src/mcp-tools/agent-execute-core.js +136 -9
  479. package/dist/src/mcp-tools/agent-execute-core.js.map +1 -1
  480. package/dist/src/mcp-tools/agent-tools.d.ts.map +1 -1
  481. package/dist/src/mcp-tools/agent-tools.js +48 -4
  482. package/dist/src/mcp-tools/agent-tools.js.map +1 -1
  483. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  484. package/dist/src/mcp-tools/hooks-tools.d.ts.map +1 -1
  485. package/dist/src/mcp-tools/hooks-tools.js +196 -0
  486. package/dist/src/mcp-tools/hooks-tools.js.map +1 -1
  487. package/dist/src/memory/graph-edge-writer.js +18 -18
  488. package/dist/src/memory/memory-bridge.js +84 -84
  489. package/dist/src/memory/memory-initializer.js +393 -393
  490. package/dist/src/memory/rabitq-index.js +5 -5
  491. package/dist/src/runtime/headless.js +28 -28
  492. package/dist/src/ruvector/enhanced-model-router.d.ts +5 -0
  493. package/dist/src/ruvector/enhanced-model-router.d.ts.map +1 -1
  494. package/dist/src/ruvector/enhanced-model-router.js +18 -1
  495. package/dist/src/ruvector/enhanced-model-router.js.map +1 -1
  496. package/dist/src/ruvector/model-prices.d.ts +50 -0
  497. package/dist/src/ruvector/model-prices.d.ts.map +1 -0
  498. package/dist/src/ruvector/model-prices.js +72 -0
  499. package/dist/src/ruvector/model-prices.js.map +1 -0
  500. package/dist/src/ruvector/model-router.d.ts +147 -8
  501. package/dist/src/ruvector/model-router.d.ts.map +1 -1
  502. package/dist/src/ruvector/model-router.js +418 -18
  503. package/dist/src/ruvector/model-router.js.map +1 -1
  504. package/dist/src/ruvector/neural-router.d.ts +172 -39
  505. package/dist/src/ruvector/neural-router.d.ts.map +1 -1
  506. package/dist/src/ruvector/neural-router.js +780 -91
  507. package/dist/src/ruvector/neural-router.js.map +1 -1
  508. package/dist/src/ruvector/router-calibrator.d.ts +65 -0
  509. package/dist/src/ruvector/router-calibrator.d.ts.map +1 -0
  510. package/dist/src/ruvector/router-calibrator.js +120 -0
  511. package/dist/src/ruvector/router-calibrator.js.map +1 -0
  512. package/dist/src/ruvector/router-trajectory.d.ts +137 -45
  513. package/dist/src/ruvector/router-trajectory.d.ts.map +1 -1
  514. package/dist/src/ruvector/router-trajectory.js +226 -63
  515. package/dist/src/ruvector/router-trajectory.js.map +1 -1
  516. package/dist/src/ruvector/task-embedder.d.ts +56 -0
  517. package/dist/src/ruvector/task-embedder.d.ts.map +1 -0
  518. package/dist/src/ruvector/task-embedder.js +237 -0
  519. package/dist/src/ruvector/task-embedder.js.map +1 -0
  520. package/dist/src/services/container-worker-pool.d.ts +8 -1
  521. package/dist/src/services/container-worker-pool.d.ts.map +1 -1
  522. package/dist/src/services/container-worker-pool.js +9 -3
  523. package/dist/src/services/container-worker-pool.js.map +1 -1
  524. package/dist/src/services/headless-worker-executor.js +84 -84
  525. package/dist/src/transfer/deploy-seraphine.js +23 -23
  526. package/dist/tsconfig.tsbuildinfo +1 -1
  527. package/package.json +136 -134
  528. package/scripts/beir-bootstrap-significance.mjs +162 -162
  529. package/scripts/bench-rvagent.mjs +312 -312
  530. package/scripts/benchmark-codemods.mjs +127 -127
  531. package/scripts/benchmark-cross-repo.mjs +206 -206
  532. package/scripts/benchmark-pretrained-retrieval.mjs +305 -305
  533. package/scripts/benchmark-self-learning.mjs +241 -241
  534. package/scripts/benchmark-trajectory-mrr.mjs +191 -191
  535. package/scripts/deploy-ipfs-node.sh +153 -153
  536. package/scripts/grid-search-retrieval.mjs +216 -216
  537. package/scripts/postinstall.cjs +153 -153
  538. package/scripts/pretrain-from-github.mjs +358 -358
  539. package/scripts/publish-registry.ts +345 -345
  540. package/scripts/publish.sh +57 -57
  541. package/scripts/run-beir-bge.mjs +324 -324
  542. package/scripts/run-beir-hybrid.mjs +261 -261
  543. package/scripts/run-beir-lucene-bm25.mjs +154 -154
  544. package/scripts/run-beir-nfcorpus.mjs +231 -231
  545. package/scripts/run-beir-rrf-ablation.mjs +221 -221
  546. package/scripts/setup-ipfs-registry.md +366 -366
  547. package/dist/src/ruvector/flash-attention.d.ts +0 -195
  548. package/dist/src/ruvector/flash-attention.d.ts.map +0 -1
  549. package/dist/src/ruvector/flash-attention.js +0 -643
  550. package/dist/src/ruvector/flash-attention.js.map +0 -1
  551. package/dist/src/ruvector/moe-router.d.ts +0 -206
  552. package/dist/src/ruvector/moe-router.d.ts.map +0 -1
  553. package/dist/src/ruvector/moe-router.js +0 -626
  554. package/dist/src/ruvector/moe-router.js.map +0 -1
  555. package/dist/src/services/event-stream.d.ts +0 -25
  556. package/dist/src/services/event-stream.js +0 -27
  557. package/dist/src/services/loop-worker-runner.d.ts +0 -16
  558. package/dist/src/services/loop-worker-runner.js +0 -34
  559. package/dist/src/services/runtime-capabilities.d.ts +0 -22
  560. package/dist/src/services/runtime-capabilities.js +0 -45
@@ -0,0 +1,556 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ GAIA CodeAgent Python Step Runner — ADR-138 iter 54
4
+
5
+ This script is invoked by gaia-codeagent.ts for each agent step.
6
+ It pre-defines tool functions as Python callables, then exec()s the agent's
7
+ code in that context.
8
+
9
+ Protocol (via environment variables):
10
+ GAIA_CODE_FILE : path to a temp file containing the agent's Python code
11
+ GAIA_RESULT_FILE : path where this runner writes final_answer JSON sentinel
12
+ ANTHROPIC_API_KEY : passed through to claude -p tool backends
13
+ GAIA_ATTACHMENT_PATH: optional attachment file path for this question
14
+
15
+ Tool dispatch strategy:
16
+ web_search(query) -> claude -p with WebSearch (best web coverage)
17
+ visit_webpage(url) -> requests + bs4 HTML extraction (no claude -p overhead)
18
+ grounded_query(query) -> ruflo TS grounded_query via node subprocess
19
+ read_file(path) -> direct Python (text/csv/json/xlsx/pptx) or requests+bs4 for PDF
20
+ describe_image(path) -> claude -p with --allowedTools Read (Claude vision)
21
+ final_answer(answer) -> writes GAIA_RESULT_FILE JSON and sys.exit(0)
22
+
23
+ Authorized imports (pre-loaded):
24
+ math, re, json, datetime, collections, itertools, statistics,
25
+ fractions, decimal, string, unicodedata, operator, sys, os, pathlib,
26
+ urllib.parse, pandas (optional), numpy (optional), sympy (optional),
27
+ requests (optional), bs4 (optional), openpyxl (optional)
28
+
29
+ Refs: ADR-138, HAL-DEEP-STUDY.md, #2156, iter 54
30
+ """
31
+
32
+ import sys
33
+ import os
34
+ import json
35
+ import subprocess
36
+ import tempfile
37
+ import math
38
+ import re
39
+ import datetime
40
+ from datetime import date, timedelta
41
+ from collections import Counter, defaultdict, OrderedDict
42
+ import itertools
43
+ import statistics
44
+ import fractions
45
+ import decimal
46
+ import operator
47
+ import string
48
+ import unicodedata
49
+ from urllib.parse import urlparse, quote, unquote
50
+ from pathlib import Path
51
+
52
+ # Optional heavy imports — graceful fallback
53
+ try:
54
+ import pandas as pd
55
+ import numpy as np
56
+ except ImportError:
57
+ pd = None
58
+ np = None
59
+
60
+ try:
61
+ import sympy
62
+ except ImportError:
63
+ sympy = None
64
+
65
+ try:
66
+ import requests
67
+ from bs4 import BeautifulSoup
68
+ HAS_REQUESTS = True
69
+ except ImportError:
70
+ requests = None
71
+ BeautifulSoup = None
72
+ HAS_REQUESTS = False
73
+
74
+ try:
75
+ import openpyxl
76
+ HAS_OPENPYXL = True
77
+ except ImportError:
78
+ HAS_OPENPYXL = False
79
+
80
+ try:
81
+ from pptx import Presentation as PptxPresentation
82
+ HAS_PPTX = True
83
+ except ImportError:
84
+ HAS_PPTX = False
85
+
86
+
87
+ # ---------------------------------------------------------------------------
88
+ # Configuration
89
+ # ---------------------------------------------------------------------------
90
+
91
+ ANTHROPIC_API_KEY = os.environ.get("ANTHROPIC_API_KEY", "")
92
+ GAIA_RESULT_FILE = os.environ.get("GAIA_RESULT_FILE", "")
93
+ GAIA_CODE_FILE = os.environ.get("GAIA_CODE_FILE", "")
94
+ GAIA_ATTACHMENT_PATH = os.environ.get("GAIA_ATTACHMENT_PATH", "")
95
+
96
+ CLAUDE_CMD = "claude"
97
+ TOOL_TIMEOUT = 30 # seconds per tool call
98
+
99
+
100
+ # ---------------------------------------------------------------------------
101
+ # Tool: web_search
102
+ # Dispatches to claude -p with WebSearch for best web coverage
103
+ # ---------------------------------------------------------------------------
104
+
105
+ def web_search(query: str) -> str:
106
+ """Search the web and return relevant snippets."""
107
+ if not query or not query.strip():
108
+ return "[web_search: empty query]"
109
+ try:
110
+ result = subprocess.run(
111
+ [
112
+ CLAUDE_CMD, "-p",
113
+ "--allowedTools", "WebSearch",
114
+ "--output-format", "text",
115
+ f"Search the web for: {query}\n\nReturn the top results with titles, URLs, and key snippets. Be concise.",
116
+ ],
117
+ capture_output=True,
118
+ text=True,
119
+ timeout=TOOL_TIMEOUT,
120
+ env={**os.environ, "ANTHROPIC_API_KEY": ANTHROPIC_API_KEY},
121
+ )
122
+ output = result.stdout.strip()
123
+ if output:
124
+ return output[:4000]
125
+ if result.stderr:
126
+ return f"[web_search: {result.stderr.strip()[:200]}]"
127
+ return "[web_search: no results]"
128
+ except subprocess.TimeoutExpired:
129
+ return f"[web_search: timed out after {TOOL_TIMEOUT}s]"
130
+ except FileNotFoundError:
131
+ # claude CLI not available — fall back to DuckDuckGo scraping
132
+ return _ddg_fallback(query)
133
+ except Exception as e:
134
+ return f"[web_search error: {e}]"
135
+
136
+
137
+ def _ddg_fallback(query: str) -> str:
138
+ """Fallback web search via DuckDuckGo HTML scraping."""
139
+ if not HAS_REQUESTS:
140
+ return "[web_search: requests not available]"
141
+ try:
142
+ headers = {"User-Agent": "Mozilla/5.0 (compatible; ruflo-gaia/1.0)"}
143
+ resp = requests.post(
144
+ "https://html.duckduckgo.com/html/",
145
+ data={"q": query},
146
+ headers=headers,
147
+ timeout=15,
148
+ )
149
+ soup = BeautifulSoup(resp.text, "html.parser")
150
+ results = []
151
+ for r in soup.select(".result")[:5]:
152
+ title_el = r.select_one(".result__title")
153
+ snip_el = r.select_one(".result__snippet")
154
+ title = title_el.get_text(strip=True) if title_el else ""
155
+ snip = snip_el.get_text(strip=True) if snip_el else ""
156
+ if title:
157
+ results.append(f"{title}: {snip}")
158
+ return "\n".join(results) if results else "[web_search: no results]"
159
+ except Exception as e:
160
+ return f"[web_search: {e}]"
161
+
162
+
163
+ # ---------------------------------------------------------------------------
164
+ # Tool: visit_webpage
165
+ # Fetches full page content via requests + bs4
166
+ # ---------------------------------------------------------------------------
167
+
168
+ def visit_webpage(url: str) -> str:
169
+ """Fetch the full text content of a webpage."""
170
+ if not url or not url.strip():
171
+ return "[visit_webpage: empty URL]"
172
+ url = url.strip()
173
+ if not url.startswith("http"):
174
+ url = "https://" + url
175
+ if HAS_REQUESTS:
176
+ return _visit_with_requests(url)
177
+ else:
178
+ return _visit_with_claude(url)
179
+
180
+
181
+ def _visit_with_requests(url: str) -> str:
182
+ """Fetch page via requests + bs4 text extraction."""
183
+ try:
184
+ headers = {"User-Agent": "Mozilla/5.0 (compatible; ruflo-gaia/1.0)"}
185
+ resp = requests.get(url, headers=headers, timeout=20, allow_redirects=True)
186
+ if resp.status_code != 200:
187
+ return f"[visit_webpage: HTTP {resp.status_code} for {url}]"
188
+
189
+ soup = BeautifulSoup(resp.text, "html.parser")
190
+ # Remove noise
191
+ for tag in soup(["script", "style", "nav", "footer", "header", "aside", "noscript"]):
192
+ tag.decompose()
193
+
194
+ # Extract main content
195
+ text = soup.get_text(separator="\n", strip=True)
196
+ # Collapse blank lines
197
+ lines = [l.strip() for l in text.splitlines() if l.strip()]
198
+ content = "\n".join(lines)
199
+
200
+ if len(content) > 8000:
201
+ content = content[:8000] + "\n[... truncated ...]"
202
+ return content if content else "[visit_webpage: no text content extracted]"
203
+ except requests.exceptions.Timeout:
204
+ return f"[visit_webpage: timed out fetching {url}]"
205
+ except Exception as e:
206
+ return f"[visit_webpage error: {e}]"
207
+
208
+
209
+ def _visit_with_claude(url: str) -> str:
210
+ """Fallback: fetch webpage via claude -p with WebFetch."""
211
+ try:
212
+ result = subprocess.run(
213
+ [
214
+ CLAUDE_CMD, "-p",
215
+ "--allowedTools", "WebFetch",
216
+ "--output-format", "text",
217
+ f"Fetch the content of this URL and return the full text: {url}",
218
+ ],
219
+ capture_output=True,
220
+ text=True,
221
+ timeout=TOOL_TIMEOUT,
222
+ env={**os.environ, "ANTHROPIC_API_KEY": ANTHROPIC_API_KEY},
223
+ )
224
+ output = result.stdout.strip()
225
+ return output[:8000] if output else f"[visit_webpage: no content from {url}]"
226
+ except Exception as e:
227
+ return f"[visit_webpage: {e}]"
228
+
229
+
230
+ # ---------------------------------------------------------------------------
231
+ # Tool: grounded_query
232
+ # Calls Gemini with Google Search grounding (ruflo's unique advantage)
233
+ # ---------------------------------------------------------------------------
234
+
235
+ def grounded_query(query: str) -> str:
236
+ """Ask Gemini with Google Search grounding — returns synthesized answer with citations."""
237
+ if not query or not query.strip():
238
+ return "[grounded_query: empty query]"
239
+
240
+ google_key = os.environ.get("GOOGLE_AI_API_KEY", "")
241
+ if not google_key:
242
+ # Fall back to web_search if no Google key
243
+ return web_search(query)
244
+
245
+ try:
246
+ import urllib.request
247
+ import urllib.error
248
+
249
+ url = "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent"
250
+ payload = {
251
+ "contents": [{"parts": [{"text": query}]}],
252
+ "tools": [{"google_search": {}}],
253
+ "generationConfig": {"maxOutputTokens": 1024},
254
+ }
255
+ data = json.dumps(payload).encode("utf-8")
256
+ req = urllib.request.Request(
257
+ f"{url}?key={google_key}",
258
+ data=data,
259
+ headers={"Content-Type": "application/json"},
260
+ )
261
+ with urllib.request.urlopen(req, timeout=20) as resp:
262
+ body = json.loads(resp.read().decode("utf-8"))
263
+
264
+ # Extract text
265
+ candidates = body.get("candidates", [])
266
+ if not candidates:
267
+ return "[grounded_query: no candidates]"
268
+ parts = candidates[0].get("content", {}).get("parts", [])
269
+ text = " ".join(p.get("text", "") for p in parts).strip()
270
+
271
+ # Extract sources
272
+ sources = []
273
+ grounding = candidates[0].get("groundingMetadata", {})
274
+ for chunk in grounding.get("groundingChunks", [])[:4]:
275
+ web = chunk.get("web", {})
276
+ title = web.get("title", "")
277
+ src_uri = web.get("uri", "")
278
+ if title and src_uri:
279
+ sources.append(f"- {title}: {src_uri}")
280
+
281
+ result = text
282
+ if sources:
283
+ result += "\n\nSources:\n" + "\n".join(sources)
284
+ return result[:4000] if result else "[grounded_query: empty response]"
285
+
286
+ except Exception as e:
287
+ # Fall back to web_search
288
+ return web_search(query)
289
+
290
+
291
+ # ---------------------------------------------------------------------------
292
+ # Tool: read_file
293
+ # Supports: txt, csv, json, xlsx, pptx, pdf (via pdfminer.six if available)
294
+ # ---------------------------------------------------------------------------
295
+
296
+ def read_file(path: str) -> str:
297
+ """Read a file and return its text content."""
298
+ if not path or not path.strip():
299
+ return "[read_file: empty path]"
300
+ path = path.strip()
301
+ if not os.path.exists(path):
302
+ return f"[read_file: file not found: {path}]"
303
+
304
+ ext = Path(path).suffix.lower()
305
+
306
+ # Text-based formats — direct read
307
+ if ext in (".txt", ".md", ".log", ".xml", ".html", ".htm"):
308
+ try:
309
+ with open(path, "r", encoding="utf-8", errors="replace") as f:
310
+ content = f.read(50_000)
311
+ return content if content else "[read_file: empty file]"
312
+ except Exception as e:
313
+ return f"[read_file: {e}]"
314
+
315
+ # JSON
316
+ if ext == ".json":
317
+ try:
318
+ with open(path, "r", encoding="utf-8") as f:
319
+ data = json.load(f)
320
+ return json.dumps(data, indent=2)[:8000]
321
+ except Exception as e:
322
+ return f"[read_file json: {e}]"
323
+
324
+ # CSV
325
+ if ext == ".csv":
326
+ if pd is not None:
327
+ try:
328
+ df = pd.read_csv(path)
329
+ return f"Shape: {df.shape}\nColumns: {list(df.columns)}\n\nFirst rows:\n{df.head(10).to_string()}"
330
+ except Exception as e:
331
+ return f"[read_file csv: {e}]"
332
+ else:
333
+ try:
334
+ with open(path, "r", encoding="utf-8", errors="replace") as f:
335
+ return f.read(8000)
336
+ except Exception as e:
337
+ return f"[read_file csv: {e}]"
338
+
339
+ # Excel
340
+ if ext in (".xlsx", ".xls"):
341
+ if pd is not None:
342
+ try:
343
+ df = pd.read_excel(path, sheet_name=None)
344
+ parts = []
345
+ for sheet_name, sheet_df in df.items():
346
+ parts.append(f"Sheet: {sheet_name}")
347
+ parts.append(sheet_df.head(20).to_string())
348
+ return "\n\n".join(parts)[:8000]
349
+ except Exception as e:
350
+ return f"[read_file excel: {e}]"
351
+ elif HAS_OPENPYXL:
352
+ try:
353
+ wb = openpyxl.load_workbook(path, read_only=True, data_only=True)
354
+ parts = []
355
+ for ws in wb.worksheets:
356
+ rows = []
357
+ for row in ws.iter_rows(max_row=20, values_only=True):
358
+ rows.append("\t".join(str(c) if c is not None else "" for c in row))
359
+ parts.append(f"Sheet: {ws.title}\n" + "\n".join(rows))
360
+ return "\n\n".join(parts)[:8000]
361
+ except Exception as e:
362
+ return f"[read_file excel: {e}]"
363
+ return "[read_file: pandas/openpyxl not available for Excel]"
364
+
365
+ # PPTX
366
+ if ext == ".pptx":
367
+ if HAS_PPTX:
368
+ try:
369
+ prs = PptxPresentation(path)
370
+ parts = []
371
+ for i, slide in enumerate(prs.slides):
372
+ texts = [shape.text for shape in slide.shapes if shape.has_text_frame]
373
+ parts.append(f"Slide {i+1}: " + " | ".join(texts))
374
+ return "\n".join(parts)[:8000]
375
+ except Exception as e:
376
+ return f"[read_file pptx: {e}]"
377
+ return "[read_file: python-pptx not available]"
378
+
379
+ # PDF — try pdfminer.six, then fallback to pdftotext subprocess
380
+ if ext == ".pdf":
381
+ return _read_pdf(path)
382
+
383
+ # Images — use describe_image
384
+ if ext in (".png", ".jpg", ".jpeg", ".gif", ".webp", ".bmp", ".tiff"):
385
+ return describe_image(path)
386
+
387
+ # Unknown — try as text
388
+ try:
389
+ with open(path, "r", encoding="utf-8", errors="replace") as f:
390
+ return f.read(8000)
391
+ except Exception as e:
392
+ return f"[read_file: unsupported format {ext}: {e}]"
393
+
394
+
395
+ def _read_pdf(path: str) -> str:
396
+ """Extract text from a PDF file."""
397
+ # Try pdfminer.six
398
+ try:
399
+ from pdfminer.high_level import extract_text as pdfminer_extract
400
+ text = pdfminer_extract(path)
401
+ if text and text.strip():
402
+ return text.strip()[:8000]
403
+ except ImportError:
404
+ pass
405
+ except Exception:
406
+ pass
407
+
408
+ # Try pdftotext subprocess
409
+ try:
410
+ result = subprocess.run(
411
+ ["pdftotext", path, "-"],
412
+ capture_output=True, text=True, timeout=15
413
+ )
414
+ if result.stdout.strip():
415
+ return result.stdout.strip()[:8000]
416
+ except (FileNotFoundError, subprocess.TimeoutExpired, Exception):
417
+ pass
418
+
419
+ # Last resort: claude -p with Read (vision for scanned PDFs)
420
+ if ANTHROPIC_API_KEY:
421
+ try:
422
+ result = subprocess.run(
423
+ [
424
+ CLAUDE_CMD, "-p",
425
+ "--allowedTools", "Read",
426
+ "--output-format", "text",
427
+ f"Read and extract all text from this file: {path}",
428
+ ],
429
+ capture_output=True, text=True, timeout=30,
430
+ env={**os.environ, "ANTHROPIC_API_KEY": ANTHROPIC_API_KEY},
431
+ )
432
+ if result.stdout.strip():
433
+ return result.stdout.strip()[:8000]
434
+ except Exception:
435
+ pass
436
+
437
+ return f"[read_file: could not extract text from PDF at {path}]"
438
+
439
+
440
+ # ---------------------------------------------------------------------------
441
+ # Tool: describe_image
442
+ # Uses claude -p with vision capability
443
+ # ---------------------------------------------------------------------------
444
+
445
+ def describe_image(path: str) -> str:
446
+ """Describe the contents of an image using Claude vision."""
447
+ if not path or not os.path.exists(path):
448
+ return f"[describe_image: file not found: {path}]"
449
+ if not ANTHROPIC_API_KEY:
450
+ return "[describe_image: ANTHROPIC_API_KEY not set]"
451
+ try:
452
+ result = subprocess.run(
453
+ [
454
+ CLAUDE_CMD, "-p",
455
+ "--allowedTools", "Read",
456
+ "--output-format", "text",
457
+ f"Describe this image in detail, including any text, numbers, charts, or data visible: {path}",
458
+ ],
459
+ capture_output=True, text=True, timeout=30,
460
+ env={**os.environ, "ANTHROPIC_API_KEY": ANTHROPIC_API_KEY},
461
+ )
462
+ output = result.stdout.strip()
463
+ return output[:4000] if output else "[describe_image: no description generated]"
464
+ except Exception as e:
465
+ return f"[describe_image: {e}]"
466
+
467
+
468
+ # ---------------------------------------------------------------------------
469
+ # Tool: final_answer
470
+ # Writes sentinel JSON and exits
471
+ # ---------------------------------------------------------------------------
472
+
473
+ def final_answer(answer) -> None:
474
+ """Submit the final answer. This ends the agent loop."""
475
+ answer_str = str(answer).strip()
476
+
477
+ # Write sentinel JSON
478
+ if GAIA_RESULT_FILE:
479
+ try:
480
+ with open(GAIA_RESULT_FILE, "w", encoding="utf-8") as f:
481
+ json.dump({"answer": answer_str}, f)
482
+ except Exception as e:
483
+ print(f"[final_answer: could not write result file: {e}]", file=sys.stderr)
484
+
485
+ print(f"[GAIA_FINAL_ANSWER]: {answer_str}")
486
+ sys.exit(0)
487
+
488
+
489
+ # ---------------------------------------------------------------------------
490
+ # Main execution
491
+ # ---------------------------------------------------------------------------
492
+
493
+ def main():
494
+ # Read agent code
495
+ if not GAIA_CODE_FILE or not os.path.exists(GAIA_CODE_FILE):
496
+ print("[CodeAgent runner: GAIA_CODE_FILE not set or not found]", file=sys.stderr)
497
+ sys.exit(1)
498
+
499
+ with open(GAIA_CODE_FILE, "r", encoding="utf-8") as f:
500
+ agent_code = f.read()
501
+
502
+ # Build execution globals with all tool functions pre-defined
503
+ exec_globals = {
504
+ "__builtins__": __builtins__,
505
+ # Math / standard lib
506
+ "math": math,
507
+ "re": re,
508
+ "json": json,
509
+ "datetime": datetime,
510
+ "date": date,
511
+ "timedelta": timedelta,
512
+ "Counter": Counter,
513
+ "defaultdict": defaultdict,
514
+ "OrderedDict": OrderedDict,
515
+ "itertools": itertools,
516
+ "statistics": statistics,
517
+ "fractions": fractions,
518
+ "decimal": decimal,
519
+ "operator": operator,
520
+ "string": string,
521
+ "unicodedata": unicodedata,
522
+ "urlparse": urlparse,
523
+ "quote": quote,
524
+ "unquote": unquote,
525
+ "Path": Path,
526
+ "os": os,
527
+ "sys": sys,
528
+ "pd": pd,
529
+ "np": np,
530
+ "sympy": sympy,
531
+ "requests": requests,
532
+ # Tool functions
533
+ "web_search": web_search,
534
+ "visit_webpage": visit_webpage,
535
+ "grounded_query": grounded_query,
536
+ "read_file": read_file,
537
+ "describe_image": describe_image,
538
+ "final_answer": final_answer,
539
+ # Attachment path hint
540
+ "ATTACHMENT_PATH": GAIA_ATTACHMENT_PATH,
541
+ }
542
+
543
+ # Execute
544
+ try:
545
+ exec(agent_code, exec_globals)
546
+ except SystemExit:
547
+ # final_answer() calls sys.exit(0) — expected
548
+ raise
549
+ except Exception as e:
550
+ import traceback
551
+ print(f"[CodeAgent execution error]\n{traceback.format_exc()}", file=sys.stderr)
552
+ sys.exit(2)
553
+
554
+
555
+ if __name__ == "__main__":
556
+ main()
@@ -0,0 +1,129 @@
1
+ /**
2
+ * GAIA CodeAgent — ADR-138 iter 54 (FINAL design)
3
+ *
4
+ * smolagents-style CodeAgent harness for the GAIA L1 benchmark.
5
+ * NOT the smolagents library — this is the PATTERN implemented natively in ruflo TS.
6
+ *
7
+ * Architecture (HAL replication):
8
+ * Instead of Anthropic native tool_use blocks (JSON → execute → repeat),
9
+ * the agent writes Python code that calls tools as functions. The code is
10
+ * parsed from markdown code blocks, executed in gaia-codeagent-runner.py,
11
+ * and the stdout is fed back as the next user turn. The agent commits its
12
+ * answer by calling final_answer("value") in Python.
13
+ *
14
+ * Why this beats ToolCallingAgent on GAIA (from HAL-DEEP-STUDY.md):
15
+ * - 30% fewer steps for the same task (Python is more expressive than JSON)
16
+ * - Variables persist across steps in the agent's mental model
17
+ * - Complex control flow (loops, try/except) is native
18
+ * - final_answer() is deterministic — no regex extraction fragility
19
+ *
20
+ * Loop algorithm:
21
+ * 1. Build system prompt with tool signatures and GAIA instruction template.
22
+ * 2. Call Anthropic Messages API (text-in / text-out — NO tools array).
23
+ * 3. Parse the response for a ```python ... ``` code block.
24
+ * 4. If code block found: run gaia-codeagent-runner.py subprocess.
25
+ * - Runner pre-defines tool functions (web_search, visit_webpage, etc.)
26
+ * - If final_answer("X") is called in the code: extract X, return result.
27
+ * - Otherwise: feed stdout back as user turn, continue.
28
+ * 5. If no code block: prompt agent to produce one (max 3 retries).
29
+ * 6. If maxTurns exceeded: return timedOut=true.
30
+ * 7. Every planningInterval turns: inject a planning checkpoint.
31
+ *
32
+ * Tool routing (via gaia-codeagent-runner.py):
33
+ * web_search(query) → claude -p with WebSearch (best web coverage)
34
+ * visit_webpage(url) → requests + bs4 HTML extraction
35
+ * grounded_query(query) → Gemini with Google Search grounding (ruflo unique)
36
+ * read_file(path) → Python direct (text/csv/json/xlsx) or subprocess
37
+ * describe_image(path) → claude -p with vision
38
+ * final_answer(x) → writes sentinel JSON and exits runner
39
+ *
40
+ * Key parameters:
41
+ * model: claude-sonnet-4-6 (default; ADR-138 targets Sonnet 4.5+)
42
+ * maxTurns: 20 (HAL uses 200; 20 is cost-controlled for L1)
43
+ * planningInterval: 4 (match HAL's planning_interval=4)
44
+ * maxTokensPerTurn: 4096 (code generation needs more space than ToolCalling)
45
+ *
46
+ * Refs: ADR-138, HAL-DEEP-STUDY.md, smolagents CodeAgent, #2156, iter 54
47
+ */
48
+ import { GaiaQuestion } from './gaia-loader.js';
49
+ import { isAnswerCorrect } from './gaia-agent.js';
50
+ export { isAnswerCorrect };
51
+ export interface CodeAgentResult {
52
+ questionId: string;
53
+ finalAnswer: string | null;
54
+ turns: number;
55
+ toolCallsByName: Record<string, number>;
56
+ totalInputTokens: number;
57
+ totalOutputTokens: number;
58
+ wallMs: number;
59
+ replanCount: number;
60
+ timedOut?: boolean;
61
+ error?: string;
62
+ /** Steps log for debugging — each entry is one turn's code + output. */
63
+ steps?: Array<{
64
+ code: string;
65
+ output: string;
66
+ }>;
67
+ }
68
+ export interface CodeAgentOptions {
69
+ model?: string;
70
+ maxTurns?: number;
71
+ maxTokensPerTurn?: number;
72
+ perTurnTimeoutMs?: number;
73
+ /** Timeout for each Python step execution (default: 30s). */
74
+ perStepTimeoutMs?: number;
75
+ planningInterval?: number;
76
+ apiKey?: string;
77
+ /** If true, include step-by-step code/output log in the result. */
78
+ verbose?: boolean;
79
+ /**
80
+ * Optional tool catalogue override — used by unit tests to inject mock tools.
81
+ * In production (Python runner mode) this is ignored; the runner defines its own tools.
82
+ */
83
+ catalogue?: unknown[];
84
+ }
85
+ /**
86
+ * Extract the first ```python ... ``` code block from assistant output.
87
+ * Returns null if no code block is found.
88
+ *
89
+ * Exported for use in unit tests (gaia-codeagent.smoke.ts T1).
90
+ */
91
+ export declare function extractCodeBlock(text: string): string | null;
92
+ /**
93
+ * Execute a single Python code step via the gaia-codeagent-runner.py subprocess.
94
+ *
95
+ * This is a thin public wrapper around `executeAgentCodeStep` that:
96
+ * - Exposes a clean typed signature for unit tests (gaia-codeagent.smoke.ts T2-T4)
97
+ * - Renames `output` → `observation` to match the smolagents naming convention
98
+ *
99
+ * @param code Python code to execute
100
+ * @param attachmentPath Path to attached file, or null
101
+ * @param timeoutMs Subprocess timeout in ms (default: 30s)
102
+ * @param apiKey Anthropic API key (passed to runner for claude -p tool calls)
103
+ */
104
+ export declare function runCodeAgentStep(code: string, attachmentPath: string | null, timeoutMs?: number, apiKey?: string): {
105
+ observation: string;
106
+ finalAnswer: string | null;
107
+ };
108
+ /**
109
+ * Run a GAIA question through the smolagents-style CodeAgent harness.
110
+ *
111
+ * The agent writes Python code, we execute it with tool stubs, and feed
112
+ * the output back. The loop continues until final_answer() is called
113
+ * or maxTurns is exhausted.
114
+ */
115
+ export declare function runGaiaCodeAgent(question: GaiaQuestion, options?: CodeAgentOptions): Promise<CodeAgentResult>;
116
+ /**
117
+ * Run all 5 SMOKE_FIXTURE questions through the CodeAgent harness.
118
+ * Pass criteria: ≥3/5 correct (60%).
119
+ */
120
+ export declare function runCodeAgentSmokeTest(opts?: {
121
+ verbose?: boolean;
122
+ apiKey?: string;
123
+ model?: string;
124
+ }): Promise<{
125
+ passRate: number;
126
+ passed: number;
127
+ total: number;
128
+ }>;
129
+ //# sourceMappingURL=gaia-codeagent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gaia-codeagent.d.ts","sourceRoot":"","sources":["../../../src/benchmarks/gaia-codeagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAOH,OAAO,EACL,YAAY,EAEb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAA0B,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAM1E,OAAO,EAAE,eAAe,EAAE,CAAC;AAwD3B,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AA0GD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU5D;AAkHD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,SAAS,SAA8B,EACvC,MAAM,SAAK,GACV;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAIrD;AAkDD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAsL1B;AA8CD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,GAAE;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAuDpE"}