@pentoshi/clai 4.19.0 → 5.0.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 (570) hide show
  1. package/CHANGELOG.md +73 -0
  2. package/PROVIDERS.md +2 -2
  3. package/REA.md +96 -0
  4. package/README.md +2 -0
  5. package/dist/agent/compaction/compaction-prompt.d.ts +49 -0
  6. package/dist/agent/compaction/compaction-prompt.js +163 -0
  7. package/dist/agent/compaction/compaction-prompt.js.map +1 -0
  8. package/dist/agent/compaction/memory-sections.d.ts +27 -0
  9. package/dist/agent/compaction/memory-sections.js +144 -0
  10. package/dist/agent/compaction/memory-sections.js.map +1 -0
  11. package/dist/agent/compaction-summary.d.ts +2 -33
  12. package/dist/agent/compaction-summary.js +3 -113
  13. package/dist/agent/compaction-summary.js.map +1 -1
  14. package/dist/agent/context/compact-with-summary.d.ts +2 -4
  15. package/dist/agent/context/compact-with-summary.js +42 -68
  16. package/dist/agent/context/compact-with-summary.js.map +1 -1
  17. package/dist/agent/context/compaction-recent-history.d.ts +4 -3
  18. package/dist/agent/context/compaction-recent-history.js +30 -52
  19. package/dist/agent/context/compaction-recent-history.js.map +1 -1
  20. package/dist/agent/context/compaction-user-instructions.d.ts +5 -6
  21. package/dist/agent/context/compaction-user-instructions.js +156 -231
  22. package/dist/agent/context/compaction-user-instructions.js.map +1 -1
  23. package/dist/agent/context-manager.js +17 -8
  24. package/dist/agent/context-manager.js.map +1 -1
  25. package/dist/agent/events.d.ts +6 -0
  26. package/dist/agent/parser/dsml.d.ts +30 -0
  27. package/dist/agent/parser/dsml.js +233 -0
  28. package/dist/agent/parser/dsml.js.map +1 -0
  29. package/dist/agent/parser/vendor-protocols.d.ts +2 -5
  30. package/dist/agent/parser/vendor-protocols.js +4 -93
  31. package/dist/agent/parser/vendor-protocols.js.map +1 -1
  32. package/dist/agent/plan-implement-compact.js +1 -2
  33. package/dist/agent/plan-implement-compact.js.map +1 -1
  34. package/dist/agent/reliability-policy.d.ts +1 -0
  35. package/dist/agent/reliability-policy.js +14 -15
  36. package/dist/agent/reliability-policy.js.map +1 -1
  37. package/dist/agent/runner.js +12 -1
  38. package/dist/agent/runner.js.map +1 -1
  39. package/dist/agent/tool-call-parser.js +6 -8
  40. package/dist/agent/tool-call-parser.js.map +1 -1
  41. package/dist/agent/turn/event-emitter.js +2 -0
  42. package/dist/agent/turn/event-emitter.js.map +1 -1
  43. package/dist/agent/turn/loop/answer-path.js +3 -1
  44. package/dist/agent/turn/loop/answer-path.js.map +1 -1
  45. package/dist/agent/turn/loop/canonicalize-turn-call.js +5 -3
  46. package/dist/agent/turn/loop/canonicalize-turn-call.js.map +1 -1
  47. package/dist/agent/turn/loop/output-budget.d.ts +0 -1
  48. package/dist/agent/turn/loop/output-budget.js +5 -13
  49. package/dist/agent/turn/loop/output-budget.js.map +1 -1
  50. package/dist/agent/turn/loop/request-assembly.js +39 -33
  51. package/dist/agent/turn/loop/request-assembly.js.map +1 -1
  52. package/dist/agent/turn/loop/round-request.js +31 -18
  53. package/dist/agent/turn/loop/round-request.js.map +1 -1
  54. package/dist/agent/turn/loop/run-rounds.js +0 -2
  55. package/dist/agent/turn/loop/run-rounds.js.map +1 -1
  56. package/dist/agent/turn/loop/tool-call-recovery.d.ts +2 -0
  57. package/dist/agent/turn/loop/tool-call-recovery.js +26 -11
  58. package/dist/agent/turn/loop/tool-call-recovery.js.map +1 -1
  59. package/dist/agent/turn/mcp-agent-tools.d.ts +3 -0
  60. package/dist/agent/turn/mcp-agent-tools.js +11 -2
  61. package/dist/agent/turn/mcp-agent-tools.js.map +1 -1
  62. package/dist/agent/turn/prompt-sections.js +1 -0
  63. package/dist/agent/turn/prompt-sections.js.map +1 -1
  64. package/dist/agent/turn/scaffold-preflight.d.ts +6 -1
  65. package/dist/agent/turn/scaffold-preflight.js +10 -2
  66. package/dist/agent/turn/scaffold-preflight.js.map +1 -1
  67. package/dist/agent/turn/setup/mcp-agent-ports.d.ts +5 -1
  68. package/dist/agent/turn/setup/mcp-agent-ports.js +2 -0
  69. package/dist/agent/turn/setup/mcp-agent-ports.js.map +1 -1
  70. package/dist/agent/turn/system-sections.d.ts +2 -0
  71. package/dist/agent/turn/system-sections.js +12 -8
  72. package/dist/agent/turn/system-sections.js.map +1 -1
  73. package/dist/agent/turn/tool-execution/deps.d.ts +2 -0
  74. package/dist/agent/turn/tool-execution/single-tool.js +4 -1
  75. package/dist/agent/turn/tool-execution/single-tool.js.map +1 -1
  76. package/dist/agent/turn/turn-counters.d.ts +1 -0
  77. package/dist/agent/turn/turn-counters.js +2 -0
  78. package/dist/agent/turn/turn-counters.js.map +1 -1
  79. package/dist/agent/turn/workspace-setup.d.ts +7 -2
  80. package/dist/agent/turn/workspace-setup.js +45 -30
  81. package/dist/agent/turn/workspace-setup.js.map +1 -1
  82. package/dist/agent/workspace-orient.d.ts +4 -0
  83. package/dist/agent/workspace-orient.js +83 -37
  84. package/dist/agent/workspace-orient.js.map +1 -1
  85. package/dist/app/adapters/agent-event-adapter.d.ts +1 -0
  86. package/dist/app/adapters/agent-event-adapter.js +17 -2
  87. package/dist/app/adapters/agent-event-adapter.js.map +1 -1
  88. package/dist/app/adapters/current-agent-adapter.js +1 -0
  89. package/dist/app/adapters/current-agent-adapter.js.map +1 -1
  90. package/dist/app/adapters/current-store-adapter.js +3 -0
  91. package/dist/app/adapters/current-store-adapter.js.map +1 -1
  92. package/dist/app/commands/catalog.js +9 -4
  93. package/dist/app/commands/catalog.js.map +1 -1
  94. package/dist/app/controllers/session-compact-helper.js +2 -5
  95. package/dist/app/controllers/session-compact-helper.js.map +1 -1
  96. package/dist/app/controllers/session-controller.js +34 -3
  97. package/dist/app/controllers/session-controller.js.map +1 -1
  98. package/dist/app/controllers/session-prompt-queue.d.ts +13 -1
  99. package/dist/app/controllers/session-prompt-queue.js +96 -24
  100. package/dist/app/controllers/session-prompt-queue.js.map +1 -1
  101. package/dist/app/controllers/turn-controller.d.ts +1 -0
  102. package/dist/app/controllers/turn-controller.js +14 -1
  103. package/dist/app/controllers/turn-controller.js.map +1 -1
  104. package/dist/app/events/app-event.d.ts +4 -0
  105. package/dist/app/events/app-event.js.map +1 -1
  106. package/dist/app/ports/agent-port.d.ts +1 -0
  107. package/dist/app/ports/persistence-port.d.ts +7 -0
  108. package/dist/app/ports/transcript-item.d.ts +2 -0
  109. package/dist/classic/app/app-wiring.d.ts +5 -2
  110. package/dist/classic/app/app-wiring.js +7 -3
  111. package/dist/classic/app/app-wiring.js.map +1 -1
  112. package/dist/classic/app/paint-pacing.js +2 -2
  113. package/dist/classic/app/paint-pacing.js.map +1 -1
  114. package/dist/classic/app/use-feed.js +7 -9
  115. package/dist/classic/app/use-feed.js.map +1 -1
  116. package/dist/classic/app/wiring-disclosure.js +1 -1
  117. package/dist/classic/app/wiring-disclosure.js.map +1 -1
  118. package/dist/classic/app/wiring-feed-scroll.d.ts +5 -0
  119. package/dist/classic/app/wiring-feed-scroll.js +39 -0
  120. package/dist/classic/app/wiring-feed-scroll.js.map +1 -0
  121. package/dist/classic/app/wiring-interactions.d.ts +0 -3
  122. package/dist/classic/app/wiring-interactions.js +6 -28
  123. package/dist/classic/app/wiring-interactions.js.map +1 -1
  124. package/dist/classic/app/wiring-lifecycle.d.ts +1 -0
  125. package/dist/classic/app/wiring-lifecycle.js +11 -1
  126. package/dist/classic/app/wiring-lifecycle.js.map +1 -1
  127. package/dist/classic/app/wiring-selection.js +46 -37
  128. package/dist/classic/app/wiring-selection.js.map +1 -1
  129. package/dist/classic/app/wiring-types.d.ts +5 -2
  130. package/dist/classic/blocks/intro-lines.js +1 -0
  131. package/dist/classic/blocks/intro-lines.js.map +1 -1
  132. package/dist/classic/blocks/thinking-lines.d.ts +6 -0
  133. package/dist/classic/blocks/thinking-lines.js +21 -7
  134. package/dist/classic/blocks/thinking-lines.js.map +1 -1
  135. package/dist/classic/blocks/tool-lines.js +1 -1
  136. package/dist/classic/blocks/tool-lines.js.map +1 -1
  137. package/dist/classic/blocks/turn-summary-lines.d.ts +1 -1
  138. package/dist/classic/blocks/turn-summary-lines.js +5 -3
  139. package/dist/classic/blocks/turn-summary-lines.js.map +1 -1
  140. package/dist/classic/bootstrap/start-classic.js +4 -1
  141. package/dist/classic/bootstrap/start-classic.js.map +1 -1
  142. package/dist/classic/chrome/composer-mentions.js +2 -1
  143. package/dist/classic/chrome/composer-mentions.js.map +1 -1
  144. package/dist/classic/chrome/directory-row.js +5 -5
  145. package/dist/classic/chrome/directory-row.js.map +1 -1
  146. package/dist/classic/chrome/status-rows.d.ts +2 -1
  147. package/dist/classic/chrome/status-rows.js +18 -8
  148. package/dist/classic/chrome/status-rows.js.map +1 -1
  149. package/dist/classic/feed/feed-blocks.js +6 -4
  150. package/dist/classic/feed/feed-blocks.js.map +1 -1
  151. package/dist/classic/feed/transcript-selection.d.ts +2 -1
  152. package/dist/classic/feed/transcript-selection.js +15 -10
  153. package/dist/classic/feed/transcript-selection.js.map +1 -1
  154. package/dist/classic/panels/confirm-panel.js +1 -0
  155. package/dist/classic/panels/confirm-panel.js.map +1 -1
  156. package/dist/classic/panels/jobs-panel.js +1 -1
  157. package/dist/classic/panels/jobs-panel.js.map +1 -1
  158. package/dist/classic/render/shell-width.js +1 -1
  159. package/dist/classic/render/shell-width.js.map +1 -1
  160. package/dist/classic/render/widest-line.d.ts +1 -0
  161. package/dist/classic/render/widest-line.js +5 -0
  162. package/dist/classic/render/widest-line.js.map +1 -0
  163. package/dist/commands/doctor.js +2 -1
  164. package/dist/commands/doctor.js.map +1 -1
  165. package/dist/index.js +5 -4
  166. package/dist/index.js.map +1 -1
  167. package/dist/instructions/scaffold.js +2 -1
  168. package/dist/instructions/scaffold.js.map +1 -1
  169. package/dist/llm/agentrouter.js +6 -11
  170. package/dist/llm/agentrouter.js.map +1 -1
  171. package/dist/llm/anthropic.js +6 -8
  172. package/dist/llm/anthropic.js.map +1 -1
  173. package/dist/llm/bynara.js +6 -10
  174. package/dist/llm/bynara.js.map +1 -1
  175. package/dist/llm/cline.js +3 -2
  176. package/dist/llm/cline.js.map +1 -1
  177. package/dist/llm/codex-models.d.ts +1 -1
  178. package/dist/llm/codex-models.js +11 -6
  179. package/dist/llm/codex-models.js.map +1 -1
  180. package/dist/llm/codex.js +2 -1
  181. package/dist/llm/codex.js.map +1 -1
  182. package/dist/llm/constellation.js +5 -0
  183. package/dist/llm/constellation.js.map +1 -1
  184. package/dist/llm/context-windows.js +17 -13
  185. package/dist/llm/context-windows.js.map +1 -1
  186. package/dist/llm/copilot.js +19 -21
  187. package/dist/llm/copilot.js.map +1 -1
  188. package/dist/llm/custom-providers.d.ts +2 -1
  189. package/dist/llm/custom-providers.js +16 -10
  190. package/dist/llm/custom-providers.js.map +1 -1
  191. package/dist/llm/deepseek.js +6 -11
  192. package/dist/llm/deepseek.js.map +1 -1
  193. package/dist/llm/explabs.js +8 -9
  194. package/dist/llm/explabs.js.map +1 -1
  195. package/dist/llm/fireworks.js +9 -11
  196. package/dist/llm/fireworks.js.map +1 -1
  197. package/dist/llm/free-default-model.js +5 -3
  198. package/dist/llm/free-default-model.js.map +1 -1
  199. package/dist/llm/free-model-limits.js +2 -1
  200. package/dist/llm/free-model-limits.js.map +1 -1
  201. package/dist/llm/free.js +20 -23
  202. package/dist/llm/free.js.map +1 -1
  203. package/dist/llm/freebuff-models.js +11 -2
  204. package/dist/llm/freebuff-models.js.map +1 -1
  205. package/dist/llm/freebuff.js +2 -1
  206. package/dist/llm/freebuff.js.map +1 -1
  207. package/dist/llm/generation-metrics.d.ts +11 -0
  208. package/dist/llm/generation-metrics.js +54 -0
  209. package/dist/llm/generation-metrics.js.map +1 -0
  210. package/dist/llm/generation-submission.d.ts +2 -0
  211. package/dist/llm/generation-submission.js +13 -0
  212. package/dist/llm/generation-submission.js.map +1 -0
  213. package/dist/llm/glm.js +6 -11
  214. package/dist/llm/glm.js.map +1 -1
  215. package/dist/llm/hetzner.js +9 -11
  216. package/dist/llm/hetzner.js.map +1 -1
  217. package/dist/llm/kimi.js +6 -11
  218. package/dist/llm/kimi.js.map +1 -1
  219. package/dist/llm/kiro.js +11 -10
  220. package/dist/llm/kiro.js.map +1 -1
  221. package/dist/llm/lightning.js +6 -10
  222. package/dist/llm/lightning.js.map +1 -1
  223. package/dist/llm/merge-gateway.js +9 -10
  224. package/dist/llm/merge-gateway.js.map +1 -1
  225. package/dist/llm/meta.js +6 -10
  226. package/dist/llm/meta.js.map +1 -1
  227. package/dist/llm/mimo.js +6 -11
  228. package/dist/llm/mimo.js.map +1 -1
  229. package/dist/llm/minimax.js +6 -11
  230. package/dist/llm/minimax.js.map +1 -1
  231. package/dist/llm/mistral.js +10 -5
  232. package/dist/llm/mistral.js.map +1 -1
  233. package/dist/llm/modal.js +6 -11
  234. package/dist/llm/modal.js.map +1 -1
  235. package/dist/llm/model-discovery.d.ts +4 -1
  236. package/dist/llm/model-discovery.js +5 -2
  237. package/dist/llm/model-discovery.js.map +1 -1
  238. package/dist/llm/model-limit-store.d.ts +2 -0
  239. package/dist/llm/model-limit-store.js +44 -12
  240. package/dist/llm/model-limit-store.js.map +1 -1
  241. package/dist/llm/model-list-cache.d.ts +15 -0
  242. package/dist/llm/model-list-cache.js +55 -0
  243. package/dist/llm/model-list-cache.js.map +1 -0
  244. package/dist/llm/nvidia.js +9 -10
  245. package/dist/llm/nvidia.js.map +1 -1
  246. package/dist/llm/ollama.js +4 -0
  247. package/dist/llm/ollama.js.map +1 -1
  248. package/dist/llm/omnirush.js +10 -14
  249. package/dist/llm/omnirush.js.map +1 -1
  250. package/dist/llm/openrouter.js +6 -11
  251. package/dist/llm/openrouter.js.map +1 -1
  252. package/dist/llm/operation-usage.js +22 -5
  253. package/dist/llm/operation-usage.js.map +1 -1
  254. package/dist/llm/orcarouter.js +9 -13
  255. package/dist/llm/orcarouter.js.map +1 -1
  256. package/dist/llm/provider-info-text.js +2 -1
  257. package/dist/llm/provider-info-text.js.map +1 -1
  258. package/dist/llm/provider-model-layers.js +4 -0
  259. package/dist/llm/provider-model-layers.js.map +1 -1
  260. package/dist/llm/provider-profile-layers.js +2 -1
  261. package/dist/llm/provider-profile-layers.js.map +1 -1
  262. package/dist/llm/provider-profiles.d.ts +1 -0
  263. package/dist/llm/provider-profiles.js +4 -0
  264. package/dist/llm/provider-profiles.js.map +1 -1
  265. package/dist/llm/qoder/qoder.js +6 -10
  266. package/dist/llm/qoder/qoder.js.map +1 -1
  267. package/dist/llm/qwen-cloud.js +6 -9
  268. package/dist/llm/qwen-cloud.js.map +1 -1
  269. package/dist/llm/request-plan.js +4 -2
  270. package/dist/llm/request-plan.js.map +1 -1
  271. package/dist/llm/river-models.d.ts +1 -0
  272. package/dist/llm/river-models.js +3 -0
  273. package/dist/llm/river-models.js.map +1 -1
  274. package/dist/llm/routing/request-option-fallback.d.ts +6 -0
  275. package/dist/llm/routing/request-option-fallback.js +63 -3
  276. package/dist/llm/routing/request-option-fallback.js.map +1 -1
  277. package/dist/llm/token-usage.js +7 -2
  278. package/dist/llm/token-usage.js.map +1 -1
  279. package/dist/llm/tokenharbor.js +10 -13
  280. package/dist/llm/tokenharbor.js.map +1 -1
  281. package/dist/llm/tokenrouter.js +10 -14
  282. package/dist/llm/tokenrouter.js.map +1 -1
  283. package/dist/llm/vercel.js +12 -12
  284. package/dist/llm/vercel.js.map +1 -1
  285. package/dist/llm/wire/chat-body.js +3 -1
  286. package/dist/llm/wire/chat-body.js.map +1 -1
  287. package/dist/llm/zen-catalog.d.ts +3 -1
  288. package/dist/llm/zen-catalog.js +9 -3
  289. package/dist/llm/zen-catalog.js.map +1 -1
  290. package/dist/mcp/argument-hint.d.ts +9 -0
  291. package/dist/mcp/argument-hint.js +17 -0
  292. package/dist/mcp/argument-hint.js.map +1 -0
  293. package/dist/mcp/catalog.js +5 -5
  294. package/dist/mcp/catalog.js.map +1 -1
  295. package/dist/mcp/manager.d.ts +2 -0
  296. package/dist/mcp/manager.js +21 -1
  297. package/dist/mcp/manager.js.map +1 -1
  298. package/dist/mcp/runtime.d.ts +5 -1
  299. package/dist/mcp/runtime.js +33 -2
  300. package/dist/mcp/runtime.js.map +1 -1
  301. package/dist/noninteractive/stream-renderer.js +2 -0
  302. package/dist/noninteractive/stream-renderer.js.map +1 -1
  303. package/dist/os/runtime-error.d.ts +2 -0
  304. package/dist/os/runtime-error.js +39 -0
  305. package/dist/os/runtime-error.js.map +1 -0
  306. package/dist/prompts/embedded.js +1 -1
  307. package/dist/prompts/embedded.js.map +1 -1
  308. package/dist/prompts/index.js +21 -18
  309. package/dist/prompts/index.js.map +1 -1
  310. package/dist/prompts/system.agent.md +10 -9
  311. package/dist/rea/availability.d.ts +22 -0
  312. package/dist/rea/availability.js +82 -0
  313. package/dist/rea/availability.js.map +1 -0
  314. package/dist/rea/connection.d.ts +8 -0
  315. package/dist/rea/connection.js +12 -0
  316. package/dist/rea/connection.js.map +1 -0
  317. package/dist/rea/distribution.d.ts +13 -0
  318. package/dist/rea/distribution.js +140 -0
  319. package/dist/rea/distribution.js.map +1 -0
  320. package/dist/rea/download.d.ts +22 -0
  321. package/dist/rea/download.js +198 -0
  322. package/dist/rea/download.js.map +1 -0
  323. package/dist/rea/engine-report.d.ts +4 -0
  324. package/dist/rea/engine-report.js +77 -0
  325. package/dist/rea/engine-report.js.map +1 -0
  326. package/dist/rea/engine-status.d.ts +24 -0
  327. package/dist/rea/engine-status.js +103 -0
  328. package/dist/rea/engine-status.js.map +1 -0
  329. package/dist/rea/engines.d.ts +43 -0
  330. package/dist/rea/engines.js +160 -0
  331. package/dist/rea/engines.js.map +1 -0
  332. package/dist/rea/ghidra.d.ts +83 -0
  333. package/dist/rea/ghidra.js +316 -0
  334. package/dist/rea/ghidra.js.map +1 -0
  335. package/dist/rea/guide.d.ts +14 -0
  336. package/dist/rea/guide.js +178 -0
  337. package/dist/rea/guide.js.map +1 -0
  338. package/dist/rea/hints.d.ts +3 -0
  339. package/dist/rea/hints.js +99 -0
  340. package/dist/rea/hints.js.map +1 -0
  341. package/dist/rea/install.d.ts +10 -0
  342. package/dist/rea/install.js +173 -0
  343. package/dist/rea/install.js.map +1 -0
  344. package/dist/rea/jdk.d.ts +50 -0
  345. package/dist/rea/jdk.js +171 -0
  346. package/dist/rea/jdk.js.map +1 -0
  347. package/dist/rea/node.d.ts +22 -0
  348. package/dist/rea/node.js +150 -0
  349. package/dist/rea/node.js.map +1 -0
  350. package/dist/rea/runtime.d.ts +11 -0
  351. package/dist/rea/runtime.js +186 -0
  352. package/dist/rea/runtime.js.map +1 -0
  353. package/dist/rea/tool-index.d.ts +7 -0
  354. package/dist/rea/tool-index.js +105 -0
  355. package/dist/rea/tool-index.js.map +1 -0
  356. package/dist/rea/types.d.ts +36 -0
  357. package/dist/rea/types.js +2 -0
  358. package/dist/rea/types.js.map +1 -0
  359. package/dist/rea/workflow.d.ts +14 -0
  360. package/dist/rea/workflow.js +60 -0
  361. package/dist/rea/workflow.js.map +1 -0
  362. package/dist/rea/zip.d.ts +19 -0
  363. package/dist/rea/zip.js +257 -0
  364. package/dist/rea/zip.js.map +1 -0
  365. package/dist/safety/tool-classification.js +6 -0
  366. package/dist/safety/tool-classification.js.map +1 -1
  367. package/dist/store/history/jsonl-backend.d.ts +0 -1
  368. package/dist/store/history/jsonl-backend.js +3 -136
  369. package/dist/store/history/jsonl-backend.js.map +1 -1
  370. package/dist/store/history/legacy-migration.d.ts +6 -0
  371. package/dist/store/history/legacy-migration.js +127 -0
  372. package/dist/store/history/legacy-migration.js.map +1 -0
  373. package/dist/store/history/lifecycle.js +11 -2
  374. package/dist/store/history/lifecycle.js.map +1 -1
  375. package/dist/store/history/recovery.js +6 -1
  376. package/dist/store/history/recovery.js.map +1 -1
  377. package/dist/store/history/session-frames.d.ts +74 -0
  378. package/dist/store/history/session-frames.js +234 -0
  379. package/dist/store/history/session-frames.js.map +1 -0
  380. package/dist/store/history/session-index.d.ts +13 -0
  381. package/dist/store/history/session-index.js +135 -0
  382. package/dist/store/history/session-index.js.map +1 -0
  383. package/dist/store/history/session-log.d.ts +44 -0
  384. package/dist/store/history/session-log.js +386 -0
  385. package/dist/store/history/session-log.js.map +1 -0
  386. package/dist/store/history/session-paths.d.ts +11 -0
  387. package/dist/store/history/session-paths.js +35 -0
  388. package/dist/store/history/session-paths.js.map +1 -0
  389. package/dist/store/history/session-queries.js +34 -16
  390. package/dist/store/history/session-queries.js.map +1 -1
  391. package/dist/store/history/session-store.d.ts +11 -0
  392. package/dist/store/history/session-store.js +202 -0
  393. package/dist/store/history/session-store.js.map +1 -0
  394. package/dist/store/history-index.d.ts +0 -2
  395. package/dist/store/history-index.js +0 -16
  396. package/dist/store/history-index.js.map +1 -1
  397. package/dist/store/history.d.ts +2 -0
  398. package/dist/store/history.js +76 -56
  399. package/dist/store/history.js.map +1 -1
  400. package/dist/store/session-queue.d.ts +4 -0
  401. package/dist/store/session-queue.js +62 -0
  402. package/dist/store/session-queue.js.map +1 -0
  403. package/dist/store/session-workspace-activity.d.ts +4 -0
  404. package/dist/store/session-workspace-activity.js +69 -0
  405. package/dist/store/session-workspace-activity.js.map +1 -0
  406. package/dist/store/session-workspace-cleanup.d.ts +4 -0
  407. package/dist/store/session-workspace-cleanup.js +246 -0
  408. package/dist/store/session-workspace-cleanup.js.map +1 -0
  409. package/dist/store/session-workspace.js +6 -0
  410. package/dist/store/session-workspace.js.map +1 -1
  411. package/dist/tools/definitions/aggregate.js +8 -0
  412. package/dist/tools/definitions/aggregate.js.map +1 -1
  413. package/dist/tools/definitions/files.js +4 -4
  414. package/dist/tools/definitions/files.js.map +1 -1
  415. package/dist/tools/definitions/shell.js +2 -2
  416. package/dist/tools/definitions/shell.js.map +1 -1
  417. package/dist/tools/definitions.js +2 -1
  418. package/dist/tools/definitions.js.map +1 -1
  419. package/dist/tools/fs/mutations.js +1 -1
  420. package/dist/tools/fs/mutations.js.map +1 -1
  421. package/dist/tools/handlers/files-2.js +1 -1
  422. package/dist/tools/handlers/files-2.js.map +1 -1
  423. package/dist/tools/http/agents.d.ts +4 -5
  424. package/dist/tools/http/agents.js +4 -12
  425. package/dist/tools/http/agents.js.map +1 -1
  426. package/dist/tools/http/fetch.js +3 -10
  427. package/dist/tools/http/fetch.js.map +1 -1
  428. package/dist/tools/registry.d.ts +1 -0
  429. package/dist/tools/registry.js +3 -0
  430. package/dist/tools/registry.js.map +1 -1
  431. package/dist/tools/shell/artifact.d.ts +7 -0
  432. package/dist/tools/shell/artifact.js +85 -0
  433. package/dist/tools/shell/artifact.js.map +1 -0
  434. package/dist/tools/shell/capture.d.ts +1 -5
  435. package/dist/tools/shell/capture.js +1 -18
  436. package/dist/tools/shell/capture.js.map +1 -1
  437. package/dist/tools/shell/exec-attempt.js +9 -27
  438. package/dist/tools/shell/exec-attempt.js.map +1 -1
  439. package/dist/tools/shell/spawn-argv.js +7 -21
  440. package/dist/tools/shell/spawn-argv.js.map +1 -1
  441. package/dist/tui-v2/app/App.js +3 -7
  442. package/dist/tui-v2/app/App.js.map +1 -1
  443. package/dist/tui-v2/app/layout-widths.js +2 -1
  444. package/dist/tui-v2/app/layout-widths.js.map +1 -1
  445. package/dist/tui-v2/bootstrap/patch-opentui-selection.d.ts +6 -0
  446. package/dist/tui-v2/bootstrap/patch-opentui-selection.js +27 -0
  447. package/dist/tui-v2/bootstrap/patch-opentui-selection.js.map +1 -0
  448. package/dist/tui-v2/bootstrap/runtime-view.js +2 -0
  449. package/dist/tui-v2/bootstrap/runtime-view.js.map +1 -1
  450. package/dist/tui-v2/bootstrap/start-tui-v2.js +6 -1
  451. package/dist/tui-v2/bootstrap/start-tui-v2.js.map +1 -1
  452. package/dist/tui-v2/components/jobs/jobs-panel.js +1 -9
  453. package/dist/tui-v2/components/jobs/jobs-panel.js.map +1 -1
  454. package/dist/tui-v2/components/modal/confirm-modal.js +1 -0
  455. package/dist/tui-v2/components/modal/confirm-modal.js.map +1 -1
  456. package/dist/tui-v2/components/pager/pager.js +2 -2
  457. package/dist/tui-v2/components/pager/pager.js.map +1 -1
  458. package/dist/tui-v2/components/plan/plan-view.js +24 -4
  459. package/dist/tui-v2/components/plan/plan-view.js.map +1 -1
  460. package/dist/tui-v2/components/status/context-limit-chip.js +2 -2
  461. package/dist/tui-v2/components/status/status-line.js +13 -12
  462. package/dist/tui-v2/components/status/status-line.js.map +1 -1
  463. package/dist/tui-v2/components/transcript/compacted-row.js +3 -1
  464. package/dist/tui-v2/components/transcript/compacted-row.js.map +1 -1
  465. package/dist/tui-v2/components/transcript/intro-card.js +5 -8
  466. package/dist/tui-v2/components/transcript/intro-card.js.map +1 -1
  467. package/dist/tui-v2/components/transcript/selection-snap.d.ts +43 -0
  468. package/dist/tui-v2/components/transcript/selection-snap.js +68 -0
  469. package/dist/tui-v2/components/transcript/selection-snap.js.map +1 -0
  470. package/dist/tui-v2/components/transcript/thinking-block.d.ts +2 -0
  471. package/dist/tui-v2/components/transcript/thinking-block.js +36 -19
  472. package/dist/tui-v2/components/transcript/thinking-block.js.map +1 -1
  473. package/dist/tui-v2/components/transcript/thinking-presentation.d.ts +0 -2
  474. package/dist/tui-v2/components/transcript/thinking-presentation.js +0 -52
  475. package/dist/tui-v2/components/transcript/thinking-presentation.js.map +1 -1
  476. package/dist/tui-v2/components/transcript/transcript-row.js +20 -6
  477. package/dist/tui-v2/components/transcript/transcript-row.js.map +1 -1
  478. package/dist/tui-v2/components/transcript/transcript-scroll-port.d.ts +2 -0
  479. package/dist/tui-v2/components/transcript/transcript-scroll-port.js +35 -0
  480. package/dist/tui-v2/components/transcript/transcript-scroll-port.js.map +1 -1
  481. package/dist/tui-v2/components/transcript/transcript-view.js +159 -109
  482. package/dist/tui-v2/components/transcript/transcript-view.js.map +1 -1
  483. package/dist/tui-v2/composer/composer-editor.js +2 -4
  484. package/dist/tui-v2/composer/composer-editor.js.map +1 -1
  485. package/dist/tui-v2/composer/composer-highlight.js +2 -1
  486. package/dist/tui-v2/composer/composer-highlight.js.map +1 -1
  487. package/dist/tui-v2/composer/composer-wheel.d.ts +1 -1
  488. package/dist/tui-v2/composer/composer-wheel.js +4 -4
  489. package/dist/tui-v2/composer/composer-wheel.js.map +1 -1
  490. package/dist/tui-v2/rendering/ansi-to-styled.js +16 -20
  491. package/dist/tui-v2/rendering/ansi-to-styled.js.map +1 -1
  492. package/dist/types.d.ts +4 -7
  493. package/dist/types.js.map +1 -1
  494. package/dist/ui/mentions/expand.js +4 -0
  495. package/dist/ui/mentions/expand.js.map +1 -1
  496. package/dist/ui-core/bootstrap/fatal-diagnostics.d.ts +1 -0
  497. package/dist/ui-core/bootstrap/fatal-diagnostics.js +9 -0
  498. package/dist/ui-core/bootstrap/fatal-diagnostics.js.map +1 -0
  499. package/dist/ui-core/bootstrap/lifecycle.d.ts +4 -0
  500. package/dist/ui-core/bootstrap/lifecycle.js +27 -4
  501. package/dist/ui-core/bootstrap/lifecycle.js.map +1 -1
  502. package/dist/ui-core/commands/command-handlers.js +2 -0
  503. package/dist/ui-core/commands/command-handlers.js.map +1 -1
  504. package/dist/ui-core/commands/picker-commands.d.ts +6 -2
  505. package/dist/ui-core/commands/picker-commands.js +30 -17
  506. package/dist/ui-core/commands/picker-commands.js.map +1 -1
  507. package/dist/ui-core/commands/rea-commands.d.ts +3 -0
  508. package/dist/ui-core/commands/rea-commands.js +176 -0
  509. package/dist/ui-core/commands/rea-commands.js.map +1 -0
  510. package/dist/ui-core/commands/rea-engines-commands.d.ts +37 -0
  511. package/dist/ui-core/commands/rea-engines-commands.js +433 -0
  512. package/dist/ui-core/commands/rea-engines-commands.js.map +1 -0
  513. package/dist/ui-core/composer/completion.js +3 -0
  514. package/dist/ui-core/composer/completion.js.map +1 -1
  515. package/dist/ui-core/controllers/overlay-controller.d.ts +1 -1
  516. package/dist/ui-core/controllers/selection-controller.d.ts +2 -1
  517. package/dist/ui-core/controllers/selection-controller.js +27 -0
  518. package/dist/ui-core/controllers/selection-controller.js.map +1 -1
  519. package/dist/ui-core/motion/wheel-scroll.d.ts +7 -0
  520. package/dist/ui-core/motion/wheel-scroll.js +24 -0
  521. package/dist/ui-core/motion/wheel-scroll.js.map +1 -0
  522. package/dist/ui-core/rendering/compaction-pager-source.d.ts +4 -0
  523. package/dist/ui-core/rendering/compaction-pager-source.js +65 -0
  524. package/dist/ui-core/rendering/compaction-pager-source.js.map +1 -0
  525. package/dist/ui-core/rendering/duration.d.ts +3 -1
  526. package/dist/ui-core/rendering/duration.js +12 -3
  527. package/dist/ui-core/rendering/duration.js.map +1 -1
  528. package/dist/ui-core/rendering/incremental-strip.js +4 -1
  529. package/dist/ui-core/rendering/incremental-strip.js.map +1 -1
  530. package/dist/ui-core/rendering/intro-header.d.ts +3 -0
  531. package/dist/ui-core/rendering/intro-header.js +145 -161
  532. package/dist/ui-core/rendering/intro-header.js.map +1 -1
  533. package/dist/ui-core/rendering/job-tail-source.js +30 -2
  534. package/dist/ui-core/rendering/job-tail-source.js.map +1 -1
  535. package/dist/ui-core/rendering/open-tool-output.d.ts +1 -0
  536. package/dist/ui-core/rendering/open-tool-output.js +8 -0
  537. package/dist/ui-core/rendering/open-tool-output.js.map +1 -1
  538. package/dist/ui-core/rendering/strip-tool-surfaces.js +7 -7
  539. package/dist/ui-core/rendering/strip-tool-surfaces.js.map +1 -1
  540. package/dist/ui-core/rendering/text-width.d.ts +1 -0
  541. package/dist/ui-core/rendering/text-width.js +22 -2
  542. package/dist/ui-core/rendering/text-width.js.map +1 -1
  543. package/dist/ui-core/rendering/thinking-tail.js +6 -2
  544. package/dist/ui-core/rendering/thinking-tail.js.map +1 -1
  545. package/dist/ui-core/rendering/tool-output-pager-source.d.ts +4 -0
  546. package/dist/ui-core/rendering/tool-output-pager-source.js +94 -0
  547. package/dist/ui-core/rendering/tool-output-pager-source.js.map +1 -0
  548. package/dist/ui-core/state/hydrate/classic-transcript.js +2 -0
  549. package/dist/ui-core/state/hydrate/classic-transcript.js.map +1 -1
  550. package/dist/ui-core/state/semantic-document.d.ts +4 -0
  551. package/dist/ui-core/state/semantic-document.js.map +1 -1
  552. package/dist/ui-core/state/transcript/apply-app-event.js +1 -0
  553. package/dist/ui-core/state/transcript/apply-app-event.js.map +1 -1
  554. package/dist/ui-core/state/transcript-hydrate.js +1 -0
  555. package/dist/ui-core/state/transcript-hydrate.js.map +1 -1
  556. package/dist/ui-core/state/transcript-types.d.ts +2 -0
  557. package/dist/ui-core/state/transcript-types.js.map +1 -1
  558. package/dist/ui-core/state/transcript-window.d.ts +9 -0
  559. package/dist/ui-core/state/transcript-window.js +9 -0
  560. package/dist/ui-core/state/transcript-window.js.map +1 -1
  561. package/dist/version.generated.d.ts +2 -2
  562. package/dist/version.generated.js +2 -2
  563. package/dist/version.generated.js.map +1 -1
  564. package/package.json +5 -2
  565. package/dist/agent/context/compaction-work-history.d.ts +0 -13
  566. package/dist/agent/context/compaction-work-history.js +0 -150
  567. package/dist/agent/context/compaction-work-history.js.map +0 -1
  568. package/dist/tui-v2/components/transcript/transcript-scrollbar.d.ts +0 -29
  569. package/dist/tui-v2/components/transcript/transcript-scrollbar.js +0 -211
  570. package/dist/tui-v2/components/transcript/transcript-scrollbar.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/rea/download.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { ReaBlockedGroup } from "./availability.js";
2
+ import type { EngineReport } from "./engine-status.js";
3
+ export declare function describeEngines(report: EngineReport, blocked?: readonly ReaBlockedGroup[]): string;
4
+ export declare function engineSummary(report: EngineReport): string;
@@ -0,0 +1,77 @@
1
+ import { bundlesDecompiler, ghidraHostProblem, GHIDRA_SERIES } from "./ghidra.js";
2
+ const LABELS = { ghidra: "Ghidra", hopper: "Hopper", ida: "IDA", kuna: "Kuna" };
3
+ const FALLBACK_ENGINES = ["ghidra", "hopper", "ida", "kuna"];
4
+ const MAX_BLOCKED_LINES = 8;
5
+ const code = (text) => `\`${text}\``;
6
+ function hint(engine, report) {
7
+ const { host, settings, found } = report;
8
+ const windows = host.platform === "win32";
9
+ if (engine === "ghidra") {
10
+ const lines = [];
11
+ if (settings.ghidra)
12
+ lines.push(`configured: ${code(settings.ghidra.dir)} (${settings.ghidra.managed ? "installed by clai" : "your own installation"}${settings.ghidra.version ? `, ${settings.ghidra.version}` : ""})`);
13
+ const existing = found.find((entry) => entry.dir !== settings.ghidra?.dir);
14
+ if (existing) {
15
+ lines.push(`found ${existing.version} at ${code(existing.dir)}${existing.decompiler ? "" : " (no native decompiler for this machine)"}`);
16
+ if (existing.decompiler)
17
+ lines.push(code(`/rea engines use ghidra ${existing.dir}`));
18
+ }
19
+ const unsupported = ghidraHostProblem(host);
20
+ if (unsupported)
21
+ lines.push(unsupported);
22
+ else
23
+ lines.push(`${code("/rea engines install ghidra")} official Ghidra ${GHIDRA_SERIES}.x from github.com, about 570 MB, checksum verified${bundlesDecompiler(host) ? "" : ", then builds its native decompiler once (needs make, a C++ compiler and bison)"}`);
24
+ lines.push(`${code("/rea engines use ghidra <folder>")} point at an extracted Ghidra you already have`);
25
+ if (windows)
26
+ lines.push("REA's Windows Ghidra support is experimental (x64 only)");
27
+ return lines;
28
+ }
29
+ if (engine === "hopper") {
30
+ return windows
31
+ ? ["Hopper is not available on Windows"]
32
+ : [`commercial app: install it yourself (hopperapp.com), then ${code("/rea engines use hopper <launcher path>")}`];
33
+ }
34
+ if (engine === "ida")
35
+ return [`needs your IDA installation plus an MCP registration: ${code("/rea engines use ida <registration.json>")}`];
36
+ if (engine === "kuna") {
37
+ return windows
38
+ ? ["Kuna is not supported on Windows"]
39
+ : [`bring your own executable: ${code("/rea engines use kuna <executable>")} (ELF and thin Mach-O only)`];
40
+ }
41
+ return [];
42
+ }
43
+ function engineLines(engine, report) {
44
+ const head = `${engine.ready ? "✓" : "✗"} ${LABELS[engine.id] ?? engine.name}${engine.ready ? " · ready" : engine.reason ? ` · ${engine.reason}` : " · not available"}`;
45
+ return [head, ...(engine.ready ? [] : hint(engine.id, report).map((line) => ` ${line}`))];
46
+ }
47
+ export function describeEngines(report, blocked = []) {
48
+ const lines = [];
49
+ if (report.rea.state === "ready")
50
+ lines.push(`REA ${report.rea.installation.version} is installed.`);
51
+ else
52
+ lines.push(`REA is not installed: run ${code("/rea setup")} first, then ${code("/rea engines")}.`);
53
+ lines.push("", "Native decompilation (procedures, pseudocode, strings, cross-references) needs one analysis engine:", "");
54
+ const engines = report.availability?.engines.length
55
+ ? report.availability.engines
56
+ : FALLBACK_ENGINES.map((id) => ({ id, name: LABELS[id], ready: false, reason: report.failure }));
57
+ for (const engine of engines)
58
+ lines.push(...engineLines(engine, report));
59
+ if (report.failure && report.rea.state === "ready")
60
+ lines.push("", `Could not read REA's engine report: ${report.failure}`);
61
+ lines.push("", "Without an engine REA still handles JavaScript and Electron apps, .NET assemblies, archives, Mach-O headers, plists and signatures.", `Engines are installed only when you run ${code("/rea engines install")}; the agent never installs or configures them.`);
62
+ if (blocked.length > 0) {
63
+ lines.push("", "Other tasks that need extra tools on this machine:");
64
+ for (const group of blocked.slice(0, MAX_BLOCKED_LINES))
65
+ lines.push(` ${group.tools.slice(0, 3).join(", ")}${group.tools.length > 3 ? ", …" : ""}: ${group.remediation}`);
66
+ if (blocked.length > MAX_BLOCKED_LINES)
67
+ lines.push(` … and ${blocked.length - MAX_BLOCKED_LINES} more`);
68
+ }
69
+ return lines.join("\n");
70
+ }
71
+ export function engineSummary(report) {
72
+ const ready = report.availability?.engines.filter((engine) => engine.ready) ?? [];
73
+ if (ready.length > 0)
74
+ return `engine ready: ${ready.map((engine) => LABELS[engine.id] ?? engine.name).join(", ")}`;
75
+ return "no analysis engine ready · /rea engines";
76
+ }
77
+ //# sourceMappingURL=engine-report.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine-report.js","sourceRoot":"","sources":["../../src/rea/engine-report.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { type ReaAvailability } from "./availability.js";
2
+ import { type EngineSettings } from "./engines.js";
3
+ import { type EngineHost, type GhidraInspection } from "./ghidra.js";
4
+ import type { ReaStatus } from "./types.js";
5
+ export interface EngineReport {
6
+ readonly rea: ReaStatus;
7
+ readonly settings: EngineSettings;
8
+ readonly availability: ReaAvailability | undefined;
9
+ readonly failure: string | undefined;
10
+ readonly found: readonly Extract<GhidraInspection, {
11
+ ok: true;
12
+ }>[];
13
+ readonly host: EngineHost;
14
+ }
15
+ export declare function ghidraSearchPatterns(host: EngineHost, home: string, env?: NodeJS.ProcessEnv): string[];
16
+ export declare function discoverGhidra(host?: EngineHost, patterns?: readonly string[]): Promise<Array<Extract<GhidraInspection, {
17
+ ok: true;
18
+ }>>>;
19
+ export declare function collectEngineReport(options?: {
20
+ root?: string;
21
+ signal?: AbortSignal;
22
+ host?: EngineHost;
23
+ patterns?: readonly string[];
24
+ }): Promise<EngineReport>;
@@ -0,0 +1,103 @@
1
+ import { readdir } from "node:fs/promises";
2
+ import { homedir } from "node:os";
3
+ import { join, posix, win32 } from "node:path";
4
+ import { parseReaAvailability } from "./availability.js";
5
+ import { engineEnvironment, readEngineSettings } from "./engines.js";
6
+ import { compareVersions, currentHost, inspectGhidraDirectory } from "./ghidra.js";
7
+ import { detectRea, reaRoot } from "./install.js";
8
+ import { runReaNode } from "./node.js";
9
+ const MAX_EXPANSIONS = 200;
10
+ function pathModule(host) {
11
+ return host.platform === "win32" ? win32 : posix;
12
+ }
13
+ export function ghidraSearchPatterns(host, home, env = process.env) {
14
+ const path = pathModule(host);
15
+ const names = ["ghidra*", "Ghidra*", "ghidra_*_PUBLIC"];
16
+ const under = (...bases) => bases.flatMap((base) => names.map((name) => path.join(base, name)));
17
+ if (host.platform === "darwin") {
18
+ return [
19
+ ...under("/Applications", path.join(home, "Applications"), "/opt", "/usr/local", home, path.join(home, "Downloads"), path.join(home, "tools"), path.join(home, "Tools")),
20
+ path.join("/opt/homebrew/Caskroom/ghidra", "*", "ghidra_*_PUBLIC"),
21
+ path.join("/usr/local/Caskroom/ghidra", "*", "ghidra_*_PUBLIC"),
22
+ ];
23
+ }
24
+ if (host.platform === "win32") {
25
+ const roots = [env.SystemDrive ? `${env.SystemDrive}\\` : "C:\\", env.ProgramFiles, env["ProgramFiles(x86)"], env.LOCALAPPDATA ? path.join(env.LOCALAPPDATA, "Programs") : undefined, home, path.join(home, "Downloads"), path.join(home, "tools")]
26
+ .filter((entry) => !!entry);
27
+ return under(...roots);
28
+ }
29
+ return under("/opt", "/usr/local", "/usr/share", "/usr/lib", home, path.join(home, "Downloads"), path.join(home, "tools"), path.join(home, ".local", "share"));
30
+ }
31
+ async function expand(pattern, host) {
32
+ const path = pathModule(host);
33
+ const { root } = path.parse(pattern);
34
+ let current = [root || "."];
35
+ for (const part of pattern.slice(root.length).split(/[\\/]/).filter(Boolean)) {
36
+ const next = [];
37
+ for (const base of current) {
38
+ if (!part.includes("*")) {
39
+ next.push(path.join(base, part));
40
+ continue;
41
+ }
42
+ const matcher = new RegExp(`^${part.split("*").map((piece) => piece.replace(/[.+?^${}()|[\]\\]/g, "\\$&")).join(".*")}$`, host.platform === "linux" ? "" : "i");
43
+ const entries = await readdir(base, { withFileTypes: true }).catch(() => []);
44
+ for (const entry of entries) {
45
+ if (entry.isDirectory() && matcher.test(entry.name))
46
+ next.push(path.join(base, entry.name));
47
+ if (next.length >= MAX_EXPANSIONS)
48
+ break;
49
+ }
50
+ }
51
+ current = next.slice(0, MAX_EXPANSIONS);
52
+ }
53
+ return current;
54
+ }
55
+ export async function discoverGhidra(host = currentHost(), patterns = ghidraSearchPatterns(host, homedir())) {
56
+ const candidates = new Set();
57
+ for (const pattern of patterns) {
58
+ for (const path of await expand(pattern, host))
59
+ candidates.add(path);
60
+ }
61
+ const found = [];
62
+ for (const directory of candidates) {
63
+ for (const candidate of [directory, join(directory, "libexec")]) {
64
+ const inspection = await inspectGhidraDirectory(candidate, host);
65
+ if (inspection.ok) {
66
+ found.push(inspection);
67
+ break;
68
+ }
69
+ }
70
+ }
71
+ return found.sort((left, right) => Number(right.decompiler) - Number(left.decompiler) || compareVersions(right.version, left.version));
72
+ }
73
+ function jsonObjectText(text) {
74
+ const start = text.indexOf("{");
75
+ return start >= 0 ? text.slice(start) : text;
76
+ }
77
+ export async function collectEngineReport(options = {}) {
78
+ const root = options.root ?? reaRoot();
79
+ const host = options.host ?? currentHost();
80
+ const [rea, settings, found] = await Promise.all([
81
+ detectRea(root),
82
+ readEngineSettings(root),
83
+ discoverGhidra(host, options.patterns),
84
+ ]);
85
+ let availability;
86
+ let failure;
87
+ if (rea.state === "ready") {
88
+ try {
89
+ const output = await runReaNode(rea.installation.node, [rea.installation.entry, "providers", "--json"], {
90
+ timeout: 90_000, maxBuffer: 16 * 1024 * 1024, env: engineEnvironment(settings),
91
+ ...(options.signal ? { signal: options.signal } : {}),
92
+ });
93
+ availability = parseReaAvailability(jsonObjectText(output));
94
+ if (!availability)
95
+ failure = "REA returned an unexpected provider report";
96
+ }
97
+ catch (error) {
98
+ failure = error instanceof Error ? error.message.split("\n")[0] : String(error);
99
+ }
100
+ }
101
+ return { rea, settings, availability, failure, found, host };
102
+ }
103
+ //# sourceMappingURL=engine-status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine-status.js","sourceRoot":"","sources":["../../src/rea/engine-status.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ export declare const ENGINE_IDS: readonly ["ghidra", "hopper", "ida", "kuna"];
2
+ export type EngineId = typeof ENGINE_IDS[number];
3
+ export interface EngineSettings {
4
+ readonly ghidra?: {
5
+ readonly dir: string;
6
+ readonly managed: boolean;
7
+ readonly version?: string;
8
+ };
9
+ readonly java?: {
10
+ readonly home: string;
11
+ readonly managed: boolean;
12
+ readonly version?: string;
13
+ };
14
+ readonly hopper?: {
15
+ readonly launcher: string;
16
+ };
17
+ readonly ida?: {
18
+ readonly config: string;
19
+ };
20
+ readonly kuna?: {
21
+ readonly command: string;
22
+ };
23
+ }
24
+ export interface EngineRoots {
25
+ readonly settings: string;
26
+ readonly ghidra: string;
27
+ readonly java: string;
28
+ }
29
+ export declare function engineRoots(root?: string): EngineRoots;
30
+ export declare function stagingName(): string;
31
+ export declare function clearStaging(directory: string): Promise<void>;
32
+ export declare function removeTree(path: string): Promise<void>;
33
+ export interface DiscardOptions {
34
+ readonly platform?: NodeJS.Platform | undefined;
35
+ readonly attempts?: number | undefined;
36
+ readonly delayMs?: number | undefined;
37
+ }
38
+ export declare function discardTree(path: string, options?: DiscardOptions): Promise<"removed" | "busy">;
39
+ export declare function windowsPathProblem(platform: NodeJS.Platform, directory: string, deepestEntry: number): string | undefined;
40
+ export declare function parseEngineSettings(text: string): EngineSettings;
41
+ export declare function readEngineSettings(root?: string): Promise<EngineSettings>;
42
+ export declare function updateEngineSettings(change: (current: EngineSettings) => EngineSettings, root?: string, signal?: AbortSignal): Promise<EngineSettings>;
43
+ export declare function engineEnvironment(settings: EngineSettings, base?: NodeJS.ProcessEnv): Record<string, string>;
@@ -0,0 +1,160 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
3
+ import { dirname, isAbsolute, join, resolve } from "node:path";
4
+ import { setTimeout as delay } from "node:timers/promises";
5
+ import { withMcpStorageLock } from "../mcp/storage-lock.js";
6
+ import { publish, reaRoot } from "./install.js";
7
+ export const ENGINE_IDS = ["ghidra", "hopper", "ida", "kuna"];
8
+ const MAX_PATH_CHARS = 1_024;
9
+ const VERSION = /^[0-9A-Za-z._+-]{1,40}$/;
10
+ const WINDOWS_PATH_LIMIT = 259;
11
+ const IN_USE_CODES = new Set(["EPERM", "EACCES", "EBUSY"]);
12
+ const STAGING_NAME = /^\.(?:staging-[0-9a-f-]{36}|s-[0-9a-f]{8})$/;
13
+ export function engineRoots(root = reaRoot()) {
14
+ const base = resolve(root);
15
+ return {
16
+ settings: join(base, "engines.json"),
17
+ ghidra: join(dirname(base), "ghidra"),
18
+ java: join(dirname(base), "jdk"),
19
+ };
20
+ }
21
+ export function stagingName() {
22
+ return `.s-${randomUUID().slice(0, 8)}`;
23
+ }
24
+ export async function clearStaging(directory) {
25
+ const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
26
+ await Promise.all(entries
27
+ .filter((entry) => entry.isDirectory() && STAGING_NAME.test(entry.name))
28
+ .map((entry) => removeTree(join(directory, entry.name)).catch(() => undefined)));
29
+ }
30
+ export function removeTree(path) {
31
+ return rm(path, { recursive: true, force: true, maxRetries: 8, retryDelay: 100 });
32
+ }
33
+ export async function discardTree(path, options = {}) {
34
+ const { platform = process.platform, attempts = 20, delayMs = 250 } = options;
35
+ const trash = join(dirname(path), stagingName());
36
+ for (let attempt = 0;; attempt += 1) {
37
+ try {
38
+ await rename(path, trash);
39
+ break;
40
+ }
41
+ catch (error) {
42
+ const code = error.code ?? "";
43
+ if (code === "ENOENT")
44
+ return "removed";
45
+ if (platform !== "win32" || !IN_USE_CODES.has(code))
46
+ throw error;
47
+ if (attempt >= attempts)
48
+ return "busy";
49
+ await delay(delayMs);
50
+ }
51
+ }
52
+ await removeTree(trash);
53
+ return "removed";
54
+ }
55
+ export function windowsPathProblem(platform, directory, deepestEntry) {
56
+ if (platform !== "win32")
57
+ return undefined;
58
+ const longest = join(directory, stagingName(), "t").length + 1 + deepestEntry;
59
+ if (longest <= WINDOWS_PATH_LIMIT)
60
+ return undefined;
61
+ return `${directory} is too deep for Windows, whose path limit is ${WINDOWS_PATH_LIMIT + 1} characters (this install needs ${longest}). Move clai's data folder somewhere shorter by setting CLAI_DATA_DIR, for example C:\\clai, then run the command again.`;
62
+ }
63
+ function isRecord(value) {
64
+ return typeof value === "object" && value !== null && !Array.isArray(value);
65
+ }
66
+ function absolutePath(value) {
67
+ if (typeof value !== "string" || value.length === 0 || value.length > MAX_PATH_CHARS || value.includes("\0"))
68
+ return undefined;
69
+ return isAbsolute(value) ? value : undefined;
70
+ }
71
+ function version(value) {
72
+ return typeof value === "string" && VERSION.test(value) ? { version: value } : {};
73
+ }
74
+ export function parseEngineSettings(text) {
75
+ let parsed;
76
+ try {
77
+ parsed = JSON.parse(text);
78
+ }
79
+ catch {
80
+ return {};
81
+ }
82
+ if (!isRecord(parsed))
83
+ return {};
84
+ const settings = {};
85
+ if (isRecord(parsed.ghidra)) {
86
+ const dir = absolutePath(parsed.ghidra.dir);
87
+ if (dir)
88
+ settings.ghidra = { dir, managed: parsed.ghidra.managed === true, ...version(parsed.ghidra.version) };
89
+ }
90
+ if (isRecord(parsed.java)) {
91
+ const home = absolutePath(parsed.java.home);
92
+ if (home)
93
+ settings.java = { home, managed: parsed.java.managed === true, ...version(parsed.java.version) };
94
+ }
95
+ if (isRecord(parsed.hopper)) {
96
+ const launcher = absolutePath(parsed.hopper.launcher);
97
+ if (launcher)
98
+ settings.hopper = { launcher };
99
+ }
100
+ if (isRecord(parsed.ida)) {
101
+ const config = absolutePath(parsed.ida.config);
102
+ if (config)
103
+ settings.ida = { config };
104
+ }
105
+ if (isRecord(parsed.kuna)) {
106
+ const command = absolutePath(parsed.kuna.command);
107
+ if (command)
108
+ settings.kuna = { command };
109
+ }
110
+ return settings;
111
+ }
112
+ export async function readEngineSettings(root = reaRoot()) {
113
+ try {
114
+ return parseEngineSettings(await readFile(engineRoots(root).settings, "utf8"));
115
+ }
116
+ catch {
117
+ return {};
118
+ }
119
+ }
120
+ async function writeEngineSettings(settings, root) {
121
+ const file = engineRoots(root).settings;
122
+ await mkdir(dirname(file), { recursive: true, mode: 0o700 });
123
+ const temporary = join(dirname(file), `engines-${randomUUID()}.tmp`);
124
+ try {
125
+ await writeFile(temporary, `${JSON.stringify({ v: 1, ...settings }, null, 2)}\n`, { mode: 0o600, flag: "wx" });
126
+ await publish(temporary, file);
127
+ }
128
+ finally {
129
+ await rm(temporary, { force: true }).catch(() => undefined);
130
+ }
131
+ }
132
+ export async function updateEngineSettings(change, root = reaRoot(), signal) {
133
+ return withMcpStorageLock(`rea-engines:${resolve(root)}`, async () => {
134
+ const next = change(await readEngineSettings(root));
135
+ await writeEngineSettings(next, resolve(root));
136
+ return next;
137
+ }, signal);
138
+ }
139
+ function environmentKey(env, key) {
140
+ if (process.platform !== "win32")
141
+ return key;
142
+ const wanted = key.toLowerCase();
143
+ return Object.keys(env).find((name) => name.toLowerCase() === wanted) ?? key;
144
+ }
145
+ export function engineEnvironment(settings, base = process.env) {
146
+ const wanted = [
147
+ ["GHIDRA_INSTALL_DIR", settings.ghidra?.dir],
148
+ ["JAVA_HOME", settings.java?.home],
149
+ ["HOPPER_LAUNCHER_PATH", settings.hopper?.launcher],
150
+ ["REA_IDA_MCP_CONFIG", settings.ida?.config],
151
+ ["REA_KUNA_COMMAND", settings.kuna?.command],
152
+ ];
153
+ const env = {};
154
+ for (const [key, value] of wanted) {
155
+ if (value)
156
+ env[environmentKey(base, key)] = value;
157
+ }
158
+ return env;
159
+ }
160
+ //# sourceMappingURL=engines.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engines.js","sourceRoot":"","sources":["../../src/rea/engines.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,83 @@
1
+ import { type FetchFunction } from "./download.js";
2
+ export declare const GHIDRA_SERIES = "12.1";
3
+ export declare const GHIDRA_INSTALLED_BYTES = 900000000;
4
+ export interface EngineHost {
5
+ readonly platform: NodeJS.Platform;
6
+ readonly arch: string;
7
+ readonly musl?: boolean | undefined;
8
+ }
9
+ export interface EngineProgress {
10
+ readonly phase: "resolving" | "downloading" | "extracting" | "building" | "verifying";
11
+ readonly message: string;
12
+ readonly receivedBytes?: number;
13
+ readonly totalBytes?: number;
14
+ }
15
+ export interface GhidraRelease {
16
+ readonly version: string;
17
+ readonly tag: string;
18
+ readonly name: string;
19
+ readonly url: string;
20
+ readonly bytes: number;
21
+ readonly sha256: string;
22
+ }
23
+ export type GhidraInspection = {
24
+ readonly ok: true;
25
+ readonly dir: string;
26
+ readonly version: string;
27
+ readonly decompiler: boolean;
28
+ } | {
29
+ readonly ok: false;
30
+ readonly reason: string;
31
+ };
32
+ export interface InstallGhidraOptions {
33
+ readonly root?: string;
34
+ readonly release?: GhidraRelease;
35
+ readonly host?: EngineHost;
36
+ readonly signal?: AbortSignal | undefined;
37
+ readonly onProgress?: ((progress: EngineProgress) => void) | undefined;
38
+ readonly fetch?: FetchFunction | undefined;
39
+ readonly build?: DecompilerBuilder | undefined;
40
+ }
41
+ export type InstallGhidraResult = {
42
+ readonly ok: true;
43
+ readonly dir: string;
44
+ readonly version: string;
45
+ readonly built: boolean;
46
+ readonly changed: boolean;
47
+ } | {
48
+ readonly ok: false;
49
+ readonly reason: string;
50
+ };
51
+ export type DecompilerBuilder = (request: {
52
+ readonly tree: string;
53
+ readonly host: EngineHost;
54
+ readonly signal: AbortSignal | undefined;
55
+ readonly onProgress: ((progress: EngineProgress) => void) | undefined;
56
+ readonly missing?: ((host: EngineHost) => Promise<readonly string[]>) | undefined;
57
+ }) => Promise<void>;
58
+ export declare function isMuslLinux(): boolean;
59
+ export declare function currentHost(): EngineHost;
60
+ export declare function decompilerDirectory(host: EngineHost): string | undefined;
61
+ export declare function ghidraHostProblem(host: EngineHost): string | undefined;
62
+ export declare function bundlesDecompiler(host: EngineHost): boolean;
63
+ export declare function versionParts(version: string): number[];
64
+ export declare function compareVersions(left: string, right: string): number;
65
+ export declare function supportedGhidraVersion(version: string): boolean;
66
+ export declare function selectGhidraRelease(releases: unknown): GhidraRelease;
67
+ export declare function resolveGhidraRelease(options?: {
68
+ signal?: AbortSignal | undefined;
69
+ fetch?: FetchFunction | undefined;
70
+ }): Promise<GhidraRelease>;
71
+ export declare function ghidraDiskBytes(release: GhidraRelease): number;
72
+ export declare function inspectGhidraDirectory(dir: string, host?: EngineHost): Promise<GhidraInspection>;
73
+ export interface BuildTarget {
74
+ readonly directory: string;
75
+ readonly arguments: readonly string[];
76
+ }
77
+ export declare function decompilerBuildTarget(host: EngineHost): BuildTarget | undefined;
78
+ export declare function buildToolsHelp(host: EngineHost): string;
79
+ export declare function missingBuildTools(host: EngineHost): Promise<string[]>;
80
+ export declare const buildGhidraDecompiler: DecompilerBuilder;
81
+ export declare function installGhidra(options: InstallGhidraOptions & {
82
+ release: GhidraRelease;
83
+ }): Promise<InstallGhidraResult>;