mstro-app 0.4.2 → 0.4.4

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 (342) hide show
  1. package/bin/mstro.js +119 -40
  2. package/dist/server/cli/headless/claude-invoker-process.d.ts +11 -0
  3. package/dist/server/cli/headless/claude-invoker-process.d.ts.map +1 -0
  4. package/dist/server/cli/headless/claude-invoker-process.js +140 -0
  5. package/dist/server/cli/headless/claude-invoker-process.js.map +1 -0
  6. package/dist/server/cli/headless/claude-invoker-stall.d.ts +40 -0
  7. package/dist/server/cli/headless/claude-invoker-stall.d.ts.map +1 -0
  8. package/dist/server/cli/headless/claude-invoker-stall.js +98 -0
  9. package/dist/server/cli/headless/claude-invoker-stall.js.map +1 -0
  10. package/dist/server/cli/headless/claude-invoker-stream.d.ts +44 -0
  11. package/dist/server/cli/headless/claude-invoker-stream.d.ts.map +1 -0
  12. package/dist/server/cli/headless/claude-invoker-stream.js +276 -0
  13. package/dist/server/cli/headless/claude-invoker-stream.js.map +1 -0
  14. package/dist/server/cli/headless/claude-invoker-tools.d.ts +21 -0
  15. package/dist/server/cli/headless/claude-invoker-tools.d.ts.map +1 -0
  16. package/dist/server/cli/headless/claude-invoker-tools.js +137 -0
  17. package/dist/server/cli/headless/claude-invoker-tools.js.map +1 -0
  18. package/dist/server/cli/headless/claude-invoker.d.ts +6 -4
  19. package/dist/server/cli/headless/claude-invoker.d.ts.map +1 -1
  20. package/dist/server/cli/headless/claude-invoker.js +10 -804
  21. package/dist/server/cli/headless/claude-invoker.js.map +1 -1
  22. package/dist/server/cli/headless/haiku-assessments.d.ts +62 -0
  23. package/dist/server/cli/headless/haiku-assessments.d.ts.map +1 -0
  24. package/dist/server/cli/headless/haiku-assessments.js +281 -0
  25. package/dist/server/cli/headless/haiku-assessments.js.map +1 -0
  26. package/dist/server/cli/headless/headless-logger.d.ts +3 -2
  27. package/dist/server/cli/headless/headless-logger.d.ts.map +1 -1
  28. package/dist/server/cli/headless/headless-logger.js +28 -5
  29. package/dist/server/cli/headless/headless-logger.js.map +1 -1
  30. package/dist/server/cli/headless/native-timeout-detector.d.ts +44 -0
  31. package/dist/server/cli/headless/native-timeout-detector.d.ts.map +1 -0
  32. package/dist/server/cli/headless/native-timeout-detector.js +99 -0
  33. package/dist/server/cli/headless/native-timeout-detector.js.map +1 -0
  34. package/dist/server/cli/headless/stall-assessor.d.ts +2 -110
  35. package/dist/server/cli/headless/stall-assessor.d.ts.map +1 -1
  36. package/dist/server/cli/headless/stall-assessor.js +65 -457
  37. package/dist/server/cli/headless/stall-assessor.js.map +1 -1
  38. package/dist/server/cli/headless/types.d.ts +4 -1
  39. package/dist/server/cli/headless/types.d.ts.map +1 -1
  40. package/dist/server/cli/improvisation-attachments.d.ts +21 -0
  41. package/dist/server/cli/improvisation-attachments.d.ts.map +1 -0
  42. package/dist/server/cli/improvisation-attachments.js +116 -0
  43. package/dist/server/cli/improvisation-attachments.js.map +1 -0
  44. package/dist/server/cli/improvisation-retry.d.ts +52 -0
  45. package/dist/server/cli/improvisation-retry.d.ts.map +1 -0
  46. package/dist/server/cli/improvisation-retry.js +434 -0
  47. package/dist/server/cli/improvisation-retry.js.map +1 -0
  48. package/dist/server/cli/improvisation-session-manager.d.ts +10 -266
  49. package/dist/server/cli/improvisation-session-manager.d.ts.map +1 -1
  50. package/dist/server/cli/improvisation-session-manager.js +117 -1079
  51. package/dist/server/cli/improvisation-session-manager.js.map +1 -1
  52. package/dist/server/cli/improvisation-types.d.ts +86 -0
  53. package/dist/server/cli/improvisation-types.d.ts.map +1 -0
  54. package/dist/server/cli/improvisation-types.js +10 -0
  55. package/dist/server/cli/improvisation-types.js.map +1 -0
  56. package/dist/server/cli/prompt-builders.d.ts +68 -0
  57. package/dist/server/cli/prompt-builders.d.ts.map +1 -0
  58. package/dist/server/cli/prompt-builders.js +312 -0
  59. package/dist/server/cli/prompt-builders.js.map +1 -0
  60. package/dist/server/index.js +33 -212
  61. package/dist/server/index.js.map +1 -1
  62. package/dist/server/mcp/bouncer-haiku.d.ts +10 -0
  63. package/dist/server/mcp/bouncer-haiku.d.ts.map +1 -0
  64. package/dist/server/mcp/bouncer-haiku.js +152 -0
  65. package/dist/server/mcp/bouncer-haiku.js.map +1 -0
  66. package/dist/server/mcp/bouncer-integration.d.ts +3 -4
  67. package/dist/server/mcp/bouncer-integration.d.ts.map +1 -1
  68. package/dist/server/mcp/bouncer-integration.js +50 -196
  69. package/dist/server/mcp/bouncer-integration.js.map +1 -1
  70. package/dist/server/mcp/security-analysis.d.ts +38 -0
  71. package/dist/server/mcp/security-analysis.d.ts.map +1 -0
  72. package/dist/server/mcp/security-analysis.js +183 -0
  73. package/dist/server/mcp/security-analysis.js.map +1 -0
  74. package/dist/server/mcp/security-audit.d.ts +1 -1
  75. package/dist/server/mcp/security-audit.d.ts.map +1 -1
  76. package/dist/server/mcp/security-patterns.d.ts +1 -25
  77. package/dist/server/mcp/security-patterns.d.ts.map +1 -1
  78. package/dist/server/mcp/security-patterns.js +55 -260
  79. package/dist/server/mcp/security-patterns.js.map +1 -1
  80. package/dist/server/server-setup.d.ts +22 -0
  81. package/dist/server/server-setup.d.ts.map +1 -0
  82. package/dist/server/server-setup.js +101 -0
  83. package/dist/server/server-setup.js.map +1 -0
  84. package/dist/server/services/file-explorer-ops.d.ts +24 -0
  85. package/dist/server/services/file-explorer-ops.d.ts.map +1 -0
  86. package/dist/server/services/file-explorer-ops.js +211 -0
  87. package/dist/server/services/file-explorer-ops.js.map +1 -0
  88. package/dist/server/services/files.d.ts +2 -85
  89. package/dist/server/services/files.d.ts.map +1 -1
  90. package/dist/server/services/files.js +7 -427
  91. package/dist/server/services/files.js.map +1 -1
  92. package/dist/server/services/plan/composer.d.ts +1 -1
  93. package/dist/server/services/plan/composer.d.ts.map +1 -1
  94. package/dist/server/services/plan/composer.js +118 -32
  95. package/dist/server/services/plan/composer.js.map +1 -1
  96. package/dist/server/services/plan/config-installer.d.ts +25 -0
  97. package/dist/server/services/plan/config-installer.d.ts.map +1 -0
  98. package/dist/server/services/plan/config-installer.js +182 -0
  99. package/dist/server/services/plan/config-installer.js.map +1 -0
  100. package/dist/server/services/plan/dependency-resolver.d.ts +1 -1
  101. package/dist/server/services/plan/dependency-resolver.d.ts.map +1 -1
  102. package/dist/server/services/plan/dependency-resolver.js +4 -1
  103. package/dist/server/services/plan/dependency-resolver.js.map +1 -1
  104. package/dist/server/services/plan/executor.d.ts +38 -74
  105. package/dist/server/services/plan/executor.d.ts.map +1 -1
  106. package/dist/server/services/plan/executor.js +274 -460
  107. package/dist/server/services/plan/executor.js.map +1 -1
  108. package/dist/server/services/plan/front-matter.d.ts +18 -0
  109. package/dist/server/services/plan/front-matter.d.ts.map +1 -0
  110. package/dist/server/services/plan/front-matter.js +44 -0
  111. package/dist/server/services/plan/front-matter.js.map +1 -0
  112. package/dist/server/services/plan/output-manager.d.ts +22 -0
  113. package/dist/server/services/plan/output-manager.d.ts.map +1 -0
  114. package/dist/server/services/plan/output-manager.js +97 -0
  115. package/dist/server/services/plan/output-manager.js.map +1 -0
  116. package/dist/server/services/plan/parser-core.d.ts +20 -0
  117. package/dist/server/services/plan/parser-core.d.ts.map +1 -0
  118. package/dist/server/services/plan/parser-core.js +350 -0
  119. package/dist/server/services/plan/parser-core.js.map +1 -0
  120. package/dist/server/services/plan/parser-migration.d.ts +5 -0
  121. package/dist/server/services/plan/parser-migration.d.ts.map +1 -0
  122. package/dist/server/services/plan/parser-migration.js +124 -0
  123. package/dist/server/services/plan/parser-migration.js.map +1 -0
  124. package/dist/server/services/plan/parser.d.ts +11 -3
  125. package/dist/server/services/plan/parser.d.ts.map +1 -1
  126. package/dist/server/services/plan/parser.js +184 -369
  127. package/dist/server/services/plan/parser.js.map +1 -1
  128. package/dist/server/services/plan/prompt-builder.d.ts +17 -0
  129. package/dist/server/services/plan/prompt-builder.d.ts.map +1 -0
  130. package/dist/server/services/plan/prompt-builder.js +137 -0
  131. package/dist/server/services/plan/prompt-builder.js.map +1 -0
  132. package/dist/server/services/plan/review-gate.d.ts +28 -0
  133. package/dist/server/services/plan/review-gate.d.ts.map +1 -0
  134. package/dist/server/services/plan/review-gate.js +191 -0
  135. package/dist/server/services/plan/review-gate.js.map +1 -0
  136. package/dist/server/services/plan/state-reconciler.d.ts +1 -1
  137. package/dist/server/services/plan/state-reconciler.d.ts.map +1 -1
  138. package/dist/server/services/plan/state-reconciler.js +59 -7
  139. package/dist/server/services/plan/state-reconciler.js.map +1 -1
  140. package/dist/server/services/plan/types.d.ts +68 -0
  141. package/dist/server/services/plan/types.d.ts.map +1 -1
  142. package/dist/server/services/platform-credentials.d.ts +24 -0
  143. package/dist/server/services/platform-credentials.d.ts.map +1 -0
  144. package/dist/server/services/platform-credentials.js +68 -0
  145. package/dist/server/services/platform-credentials.js.map +1 -0
  146. package/dist/server/services/platform.d.ts +1 -31
  147. package/dist/server/services/platform.d.ts.map +1 -1
  148. package/dist/server/services/platform.js +11 -109
  149. package/dist/server/services/platform.js.map +1 -1
  150. package/dist/server/services/terminal/pty-manager.d.ts +7 -97
  151. package/dist/server/services/terminal/pty-manager.d.ts.map +1 -1
  152. package/dist/server/services/terminal/pty-manager.js +53 -266
  153. package/dist/server/services/terminal/pty-manager.js.map +1 -1
  154. package/dist/server/services/terminal/pty-utils.d.ts +57 -0
  155. package/dist/server/services/terminal/pty-utils.d.ts.map +1 -0
  156. package/dist/server/services/terminal/pty-utils.js +141 -0
  157. package/dist/server/services/terminal/pty-utils.js.map +1 -0
  158. package/dist/server/services/websocket/file-definition-handlers.d.ts +4 -0
  159. package/dist/server/services/websocket/file-definition-handlers.d.ts.map +1 -0
  160. package/dist/server/services/websocket/file-definition-handlers.js +153 -0
  161. package/dist/server/services/websocket/file-definition-handlers.js.map +1 -0
  162. package/dist/server/services/websocket/file-explorer-handlers.d.ts.map +1 -1
  163. package/dist/server/services/websocket/file-explorer-handlers.js +52 -391
  164. package/dist/server/services/websocket/file-explorer-handlers.js.map +1 -1
  165. package/dist/server/services/websocket/file-search-handlers.d.ts +5 -0
  166. package/dist/server/services/websocket/file-search-handlers.d.ts.map +1 -0
  167. package/dist/server/services/websocket/file-search-handlers.js +238 -0
  168. package/dist/server/services/websocket/file-search-handlers.js.map +1 -0
  169. package/dist/server/services/websocket/file-utils.js +3 -3
  170. package/dist/server/services/websocket/file-utils.js.map +1 -1
  171. package/dist/server/services/websocket/git-branch-handlers.d.ts +7 -0
  172. package/dist/server/services/websocket/git-branch-handlers.d.ts.map +1 -0
  173. package/dist/server/services/websocket/git-branch-handlers.js +110 -0
  174. package/dist/server/services/websocket/git-branch-handlers.js.map +1 -0
  175. package/dist/server/services/websocket/git-diff-handlers.d.ts +6 -0
  176. package/dist/server/services/websocket/git-diff-handlers.d.ts.map +1 -0
  177. package/dist/server/services/websocket/git-diff-handlers.js +123 -0
  178. package/dist/server/services/websocket/git-diff-handlers.js.map +1 -0
  179. package/dist/server/services/websocket/git-handlers.d.ts +2 -31
  180. package/dist/server/services/websocket/git-handlers.d.ts.map +1 -1
  181. package/dist/server/services/websocket/git-handlers.js +35 -541
  182. package/dist/server/services/websocket/git-handlers.js.map +1 -1
  183. package/dist/server/services/websocket/git-log-handlers.d.ts +6 -0
  184. package/dist/server/services/websocket/git-log-handlers.d.ts.map +1 -0
  185. package/dist/server/services/websocket/git-log-handlers.js +128 -0
  186. package/dist/server/services/websocket/git-log-handlers.js.map +1 -0
  187. package/dist/server/services/websocket/git-pr-handlers.d.ts.map +1 -1
  188. package/dist/server/services/websocket/git-pr-handlers.js +13 -53
  189. package/dist/server/services/websocket/git-pr-handlers.js.map +1 -1
  190. package/dist/server/services/websocket/git-tag-handlers.d.ts +6 -0
  191. package/dist/server/services/websocket/git-tag-handlers.d.ts.map +1 -0
  192. package/dist/server/services/websocket/git-tag-handlers.js +76 -0
  193. package/dist/server/services/websocket/git-tag-handlers.js.map +1 -0
  194. package/dist/server/services/websocket/git-utils.d.ts +43 -0
  195. package/dist/server/services/websocket/git-utils.d.ts.map +1 -0
  196. package/dist/server/services/websocket/git-utils.js +201 -0
  197. package/dist/server/services/websocket/git-utils.js.map +1 -0
  198. package/dist/server/services/websocket/handler.d.ts +2 -0
  199. package/dist/server/services/websocket/handler.d.ts.map +1 -1
  200. package/dist/server/services/websocket/handler.js +37 -112
  201. package/dist/server/services/websocket/handler.js.map +1 -1
  202. package/dist/server/services/websocket/plan-board-handlers.d.ts +11 -0
  203. package/dist/server/services/websocket/plan-board-handlers.d.ts.map +1 -0
  204. package/dist/server/services/websocket/plan-board-handlers.js +218 -0
  205. package/dist/server/services/websocket/plan-board-handlers.js.map +1 -0
  206. package/dist/server/services/websocket/plan-execution-handlers.d.ts +9 -0
  207. package/dist/server/services/websocket/plan-execution-handlers.d.ts.map +1 -0
  208. package/dist/server/services/websocket/plan-execution-handlers.js +142 -0
  209. package/dist/server/services/websocket/plan-execution-handlers.js.map +1 -0
  210. package/dist/server/services/websocket/plan-handlers.d.ts +7 -2
  211. package/dist/server/services/websocket/plan-handlers.d.ts.map +1 -1
  212. package/dist/server/services/websocket/plan-handlers.js +21 -462
  213. package/dist/server/services/websocket/plan-handlers.js.map +1 -1
  214. package/dist/server/services/websocket/plan-helpers.d.ts +19 -0
  215. package/dist/server/services/websocket/plan-helpers.d.ts.map +1 -0
  216. package/dist/server/services/websocket/plan-helpers.js +199 -0
  217. package/dist/server/services/websocket/plan-helpers.js.map +1 -0
  218. package/dist/server/services/websocket/plan-issue-handlers.d.ts +12 -0
  219. package/dist/server/services/websocket/plan-issue-handlers.d.ts.map +1 -0
  220. package/dist/server/services/websocket/plan-issue-handlers.js +162 -0
  221. package/dist/server/services/websocket/plan-issue-handlers.js.map +1 -0
  222. package/dist/server/services/websocket/plan-sprint-handlers.d.ts +7 -0
  223. package/dist/server/services/websocket/plan-sprint-handlers.d.ts.map +1 -0
  224. package/dist/server/services/websocket/plan-sprint-handlers.js +206 -0
  225. package/dist/server/services/websocket/plan-sprint-handlers.js.map +1 -0
  226. package/dist/server/services/websocket/quality-complexity.d.ts +14 -0
  227. package/dist/server/services/websocket/quality-complexity.d.ts.map +1 -0
  228. package/dist/server/services/websocket/quality-complexity.js +262 -0
  229. package/dist/server/services/websocket/quality-complexity.js.map +1 -0
  230. package/dist/server/services/websocket/quality-fix-agent.d.ts +16 -0
  231. package/dist/server/services/websocket/quality-fix-agent.d.ts.map +1 -0
  232. package/dist/server/services/websocket/quality-fix-agent.js +140 -0
  233. package/dist/server/services/websocket/quality-fix-agent.js.map +1 -0
  234. package/dist/server/services/websocket/quality-handlers.d.ts.map +1 -1
  235. package/dist/server/services/websocket/quality-handlers.js +34 -346
  236. package/dist/server/services/websocket/quality-handlers.js.map +1 -1
  237. package/dist/server/services/websocket/quality-linting.d.ts +9 -0
  238. package/dist/server/services/websocket/quality-linting.d.ts.map +1 -0
  239. package/dist/server/services/websocket/quality-linting.js +178 -0
  240. package/dist/server/services/websocket/quality-linting.js.map +1 -0
  241. package/dist/server/services/websocket/quality-review-agent.d.ts +19 -0
  242. package/dist/server/services/websocket/quality-review-agent.d.ts.map +1 -0
  243. package/dist/server/services/websocket/quality-review-agent.js +206 -0
  244. package/dist/server/services/websocket/quality-review-agent.js.map +1 -0
  245. package/dist/server/services/websocket/quality-service.d.ts +3 -51
  246. package/dist/server/services/websocket/quality-service.d.ts.map +1 -1
  247. package/dist/server/services/websocket/quality-service.js +9 -651
  248. package/dist/server/services/websocket/quality-service.js.map +1 -1
  249. package/dist/server/services/websocket/quality-tools.d.ts +23 -0
  250. package/dist/server/services/websocket/quality-tools.d.ts.map +1 -0
  251. package/dist/server/services/websocket/quality-tools.js +208 -0
  252. package/dist/server/services/websocket/quality-tools.js.map +1 -0
  253. package/dist/server/services/websocket/quality-types.d.ts +59 -0
  254. package/dist/server/services/websocket/quality-types.d.ts.map +1 -0
  255. package/dist/server/services/websocket/quality-types.js +101 -0
  256. package/dist/server/services/websocket/quality-types.js.map +1 -0
  257. package/dist/server/services/websocket/session-handlers.d.ts +3 -4
  258. package/dist/server/services/websocket/session-handlers.d.ts.map +1 -1
  259. package/dist/server/services/websocket/session-handlers.js +3 -378
  260. package/dist/server/services/websocket/session-handlers.js.map +1 -1
  261. package/dist/server/services/websocket/session-history.d.ts +4 -0
  262. package/dist/server/services/websocket/session-history.d.ts.map +1 -0
  263. package/dist/server/services/websocket/session-history.js +208 -0
  264. package/dist/server/services/websocket/session-history.js.map +1 -0
  265. package/dist/server/services/websocket/session-initialization.d.ts +5 -0
  266. package/dist/server/services/websocket/session-initialization.d.ts.map +1 -0
  267. package/dist/server/services/websocket/session-initialization.js +163 -0
  268. package/dist/server/services/websocket/session-initialization.js.map +1 -0
  269. package/dist/server/services/websocket/types.d.ts +12 -2
  270. package/dist/server/services/websocket/types.d.ts.map +1 -1
  271. package/package.json +1 -2
  272. package/server/cli/headless/claude-invoker-process.ts +204 -0
  273. package/server/cli/headless/claude-invoker-stall.ts +164 -0
  274. package/server/cli/headless/claude-invoker-stream.ts +353 -0
  275. package/server/cli/headless/claude-invoker-tools.ts +187 -0
  276. package/server/cli/headless/claude-invoker.ts +15 -1092
  277. package/server/cli/headless/haiku-assessments.ts +365 -0
  278. package/server/cli/headless/headless-logger.ts +26 -5
  279. package/server/cli/headless/native-timeout-detector.ts +117 -0
  280. package/server/cli/headless/stall-assessor.ts +65 -618
  281. package/server/cli/headless/types.ts +4 -1
  282. package/server/cli/improvisation-attachments.ts +148 -0
  283. package/server/cli/improvisation-retry.ts +602 -0
  284. package/server/cli/improvisation-session-manager.ts +140 -1349
  285. package/server/cli/improvisation-types.ts +98 -0
  286. package/server/cli/prompt-builders.ts +370 -0
  287. package/server/index.ts +35 -246
  288. package/server/mcp/bouncer-haiku.ts +182 -0
  289. package/server/mcp/bouncer-integration.ts +87 -248
  290. package/server/mcp/security-analysis.ts +217 -0
  291. package/server/mcp/security-audit.ts +1 -1
  292. package/server/mcp/security-patterns.ts +60 -283
  293. package/server/server-setup.ts +114 -0
  294. package/server/services/file-explorer-ops.ts +293 -0
  295. package/server/services/files.ts +20 -532
  296. package/server/services/plan/composer.ts +140 -35
  297. package/server/services/plan/config-installer.ts +187 -0
  298. package/server/services/plan/dependency-resolver.ts +4 -1
  299. package/server/services/plan/executor.ts +281 -488
  300. package/server/services/plan/front-matter.ts +48 -0
  301. package/server/services/plan/output-manager.ts +113 -0
  302. package/server/services/plan/parser-core.ts +406 -0
  303. package/server/services/plan/parser-migration.ts +128 -0
  304. package/server/services/plan/parser.ts +188 -394
  305. package/server/services/plan/prompt-builder.ts +161 -0
  306. package/server/services/plan/review-gate.ts +212 -0
  307. package/server/services/plan/state-reconciler.ts +68 -7
  308. package/server/services/plan/types.ts +101 -1
  309. package/server/services/platform-credentials.ts +83 -0
  310. package/server/services/platform.ts +16 -131
  311. package/server/services/terminal/pty-manager.ts +66 -313
  312. package/server/services/terminal/pty-utils.ts +176 -0
  313. package/server/services/websocket/file-definition-handlers.ts +165 -0
  314. package/server/services/websocket/file-explorer-handlers.ts +37 -452
  315. package/server/services/websocket/file-search-handlers.ts +291 -0
  316. package/server/services/websocket/file-utils.ts +3 -3
  317. package/server/services/websocket/git-branch-handlers.ts +130 -0
  318. package/server/services/websocket/git-diff-handlers.ts +140 -0
  319. package/server/services/websocket/git-handlers.ts +40 -625
  320. package/server/services/websocket/git-log-handlers.ts +149 -0
  321. package/server/services/websocket/git-pr-handlers.ts +17 -62
  322. package/server/services/websocket/git-tag-handlers.ts +91 -0
  323. package/server/services/websocket/git-utils.ts +230 -0
  324. package/server/services/websocket/handler.ts +39 -112
  325. package/server/services/websocket/plan-board-handlers.ts +277 -0
  326. package/server/services/websocket/plan-execution-handlers.ts +184 -0
  327. package/server/services/websocket/plan-handlers.ts +23 -544
  328. package/server/services/websocket/plan-helpers.ts +215 -0
  329. package/server/services/websocket/plan-issue-handlers.ts +204 -0
  330. package/server/services/websocket/plan-sprint-handlers.ts +252 -0
  331. package/server/services/websocket/quality-complexity.ts +294 -0
  332. package/server/services/websocket/quality-fix-agent.ts +181 -0
  333. package/server/services/websocket/quality-handlers.ts +36 -404
  334. package/server/services/websocket/quality-linting.ts +187 -0
  335. package/server/services/websocket/quality-review-agent.ts +246 -0
  336. package/server/services/websocket/quality-service.ts +11 -762
  337. package/server/services/websocket/quality-tools.ts +209 -0
  338. package/server/services/websocket/quality-types.ts +169 -0
  339. package/server/services/websocket/session-handlers.ts +5 -437
  340. package/server/services/websocket/session-history.ts +222 -0
  341. package/server/services/websocket/session-initialization.ts +209 -0
  342. package/server/services/websocket/types.ts +46 -2
@@ -1,785 +1,19 @@
1
1
  // Copyright (c) 2025-present Mstro, Inc. All rights reserved.
2
2
  // Licensed under the MIT License. See LICENSE file for details.
3
+ import { buildCloseResult, handleSpawnError, spawnAndRegister } from './claude-invoker-process.js';
4
+ import { runStallCheckTick } from './claude-invoker-stall.js';
5
+ import { classifyUnmatchedStderr, processStreamLines, verboseLog } from './claude-invoker-stream.js';
6
+ import { setupToolTracking } from './claude-invoker-tools.js';
7
+ import { NativeTimeoutDetector } from './native-timeout-detector.js';
8
+ import { detectErrorInStderr } from './output-utils.js';
3
9
  /**
4
- * Claude Invoker
5
- *
6
- * Handles spawning and managing Claude CLI processes.
7
- */
8
- import { spawn } from 'node:child_process';
9
- import { sanitizeEnvForSandbox } from '../../services/sandbox-utils.js';
10
- import { herror, hlog } from './headless-logger.js';
11
- import { generateMcpConfig } from './mcp-config.js';
12
- import { detectErrorInStderr, } from './output-utils.js';
13
- import { buildMultimodalMessage } from './prompt-utils.js';
14
- import { killProcessGroup } from './runner.js';
15
- import { assessStall, assessToolTimeout, classifyError } from './stall-assessor.js';
16
- import { ToolWatchdog } from './tool-watchdog.js';
17
- // ========== Signal Helpers ==========
18
- /** Map a Node.js signal name to its numeric value for exit code computation */
19
- function signalToNumber(signal) {
20
- const map = {
21
- SIGHUP: 1, SIGINT: 2, SIGQUIT: 3, SIGABRT: 6,
22
- SIGKILL: 9, SIGTERM: 15, SIGUSR1: 10, SIGUSR2: 12,
23
- };
24
- return map[signal];
25
- }
26
- // ========== Stall Detection Helpers ==========
27
- /** Summarize a tool's input for stall assessment context */
28
- function summarizeToolInput(input) {
29
- try {
30
- if (input.description) {
31
- return String(input.description).slice(0, 200);
32
- }
33
- if (input.prompt) {
34
- return String(input.prompt).slice(0, 200);
35
- }
36
- if (input.command) {
37
- return String(input.command).slice(0, 200);
38
- }
39
- if (input.pattern) {
40
- return `pattern: ${String(input.pattern).slice(0, 100)}`;
41
- }
42
- return JSON.stringify(input).slice(0, 200);
43
- }
44
- catch {
45
- return undefined;
46
- }
47
- }
48
- /** Terminate a stalled process: SIGTERM then SIGKILL after 5s */
49
- function terminateStallProcess(claudeProcess, interval, config, message) {
50
- clearInterval(interval);
51
- config.outputCallback?.(message);
52
- if (claudeProcess.pid)
53
- killProcessGroup(claudeProcess.pid, 'SIGTERM');
54
- setTimeout(() => {
55
- if (!claudeProcess.killed && claudeProcess.pid) {
56
- killProcessGroup(claudeProcess.pid, 'SIGKILL');
57
- }
58
- }, 5000);
59
- }
60
- /** Run stall assessment and return updated state if extended, null otherwise */
61
- async function runStallAssessment(params) {
62
- const { stallCtx, config, now, extensionsGranted, maxExtensions, toolWatchdogActive } = params;
63
- try {
64
- const verdict = await assessStall(stallCtx, config.claudeCommand, config.verbose, toolWatchdogActive);
65
- if (verdict.action === 'extend') {
66
- const newExtensions = extensionsGranted + 1;
67
- const elapsedMin = Math.round(stallCtx.elapsedTotalMs / 60_000);
68
- const pendingNames = stallCtx.pendingToolNames ?? new Set();
69
- // Emit a progress message instead of a scary stall warning.
70
- // Task subagents and Agent Teams leads get friendlier messages since long silence is expected.
71
- const isAgentTeamsLead = verdict.reason.includes('Agent Teams lead');
72
- if (pendingNames.has('Task') || isAgentTeamsLead) {
73
- config.outputCallback?.(`\n[[MSTRO_STALL_EXTENDED]] ${isAgentTeamsLead ? 'Teammates still working' : 'Task subagent still running'} (${elapsedMin} min elapsed). ${verdict.reason}.\n`);
74
- }
75
- else {
76
- config.outputCallback?.(`\n[[MSTRO_STALL_EXTENDED]] Process still working (${elapsedMin} min elapsed). ${verdict.reason}. Extension ${newExtensions}/${maxExtensions}.\n`);
77
- }
78
- if (config.verbose) {
79
- hlog(`[STALL] Extended by ${Math.round(verdict.extensionMs / 60_000)} min: ${verdict.reason}`);
80
- }
81
- return { extensionsGranted: newExtensions, currentKillDeadline: now + verdict.extensionMs };
82
- }
83
- config.outputCallback?.(`\n[[MSTRO_STALL_CONFIRMED]] Assessment: process likely stalled. ${verdict.reason}.\n`);
84
- if (config.verbose) {
85
- hlog(`[STALL] Assessment says stalled: ${verdict.reason}`);
86
- }
87
- }
88
- catch (err) {
89
- if (config.verbose) {
90
- hlog(`[STALL] Assessment error: ${err}`);
91
- }
92
- }
93
- return null;
94
- }
95
- // ========== Native Timeout Detection ==========
96
- /** Regex matching Claude Code's internal tool timeout messages */
97
- const NATIVE_TIMEOUT_PATTERN = /^(\w+) timed out — (continuing|retrying) with (\d+) results? preserved$/;
98
- /** Quick prefix check: does incomplete text look like it might be a timeout?
99
- * Matches any capitalized tool name followed by " timed" — no hardcoded set
100
- * needed because the full NATIVE_TIMEOUT_PATTERN validates on the next chunk. */
101
- const TIMEOUT_PREFIX_PATTERN = /^[A-Z]\w* timed/;
102
- /**
103
- * Detects Claude Code's internal tool timeout messages in the text stream.
104
- *
105
- * Buffers text at newline boundaries to detect complete timeout lines.
106
- * Non-matching text is forwarded immediately to minimize streaming latency.
107
- */
108
- class NativeTimeoutDetector {
109
- lineBuffer = '';
110
- detectedTimeouts = [];
111
- /** Text buffered after native timeouts — held back from streaming until context is assessed */
112
- postTimeoutBuffer = '';
113
- /**
114
- * Process a text_delta chunk.
115
- * Returns passthrough text (for outputCallback) and any detected timeouts.
116
- *
117
- * After the first native timeout is detected, subsequent passthrough text
118
- * is held in postTimeoutBuffer instead of returned as passthrough. This
119
- * prevents confused "What were you working on?" responses from streaming
120
- * to the user before context loss can be assessed.
121
- */
122
- processChunk(text) {
123
- const timeouts = [];
124
- let passthrough = '';
125
- this.lineBuffer += text;
126
- const lines = this.lineBuffer.split('\n');
127
- const incomplete = lines.pop() ?? '';
128
- for (const line of lines) {
129
- const trimmed = line.trim();
130
- const match = trimmed.match(NATIVE_TIMEOUT_PATTERN);
131
- if (match) {
132
- const event = {
133
- toolName: match[1],
134
- action: match[2],
135
- preservedCount: parseInt(match[3], 10),
136
- };
137
- timeouts.push(event);
138
- this.detectedTimeouts.push(event);
139
- // Suppress this line from passthrough — replaced by structured marker
140
- }
141
- else {
142
- passthrough += `${line}\n`;
143
- }
144
- }
145
- // Handle incomplete trailing text
146
- if (incomplete) {
147
- if (TIMEOUT_PREFIX_PATTERN.test(incomplete)) {
148
- // Looks like the start of a timeout message — hold it
149
- this.lineBuffer = incomplete;
150
- }
151
- else {
152
- passthrough += incomplete;
153
- this.lineBuffer = '';
154
- }
155
- }
156
- else {
157
- this.lineBuffer = '';
158
- }
159
- // After native timeouts, buffer passthrough text instead of returning it.
160
- // The session manager will assess context loss and either flush or discard.
161
- if (this.detectedTimeouts.length > 0 && passthrough) {
162
- this.postTimeoutBuffer += passthrough;
163
- passthrough = '';
164
- }
165
- return { passthrough, timeouts };
166
- }
167
- /** Flush any held buffer (call on stream end).
168
- * Also checks remaining buffer for timeout patterns so the last
169
- * timeout message (without trailing newline) is always counted.
170
- */
171
- flush() {
172
- const remaining = this.lineBuffer;
173
- this.lineBuffer = '';
174
- // Check if the unflushed buffer IS a timeout message
175
- if (remaining) {
176
- const trimmed = remaining.trim();
177
- const match = trimmed.match(NATIVE_TIMEOUT_PATTERN);
178
- if (match) {
179
- this.detectedTimeouts.push({
180
- toolName: match[1],
181
- action: match[2],
182
- preservedCount: parseInt(match[3], 10),
183
- });
184
- // Return empty — this was a timeout message, not user-visible text
185
- return '';
186
- }
187
- }
188
- return remaining;
189
- }
190
- /** Get count of detected timeouts */
191
- get timeoutCount() {
192
- return this.detectedTimeouts.length;
193
- }
194
- /** Get buffered post-timeout text (for session manager to flush or discard) */
195
- get bufferedPostTimeoutOutput() {
196
- return this.postTimeoutBuffer;
197
- }
198
- }
199
- function handleSessionCapture(parsed, captured) {
200
- if (parsed.type === 'system' && parsed.subtype === 'init' && parsed.session_id) {
201
- captured.claudeSessionId = parsed.session_id;
202
- }
203
- if (parsed.type === 'result' && parsed.session_id && !captured.claudeSessionId) {
204
- captured.claudeSessionId = parsed.session_id;
205
- }
206
- }
207
- function handleThinkingDelta(event, ctx) {
208
- if (event.type !== 'content_block_delta' ||
209
- event.delta?.type !== 'thinking_delta' ||
210
- !event.delta?.thinking) {
211
- return ctx.accumulatedThinking;
212
- }
213
- // Thinking activity confirms Claude has context — flush resume buffer
214
- if (ctx.resumeAssessmentActive) {
215
- ctx.resumeAssessmentActive = false;
216
- if (ctx.resumeAssessmentBuffer) {
217
- ctx.config.outputCallback?.(ctx.resumeAssessmentBuffer);
218
- ctx.resumeAssessmentBuffer = '';
219
- }
220
- }
221
- const thinking = event.delta.thinking;
222
- const updated = ctx.accumulatedThinking + thinking;
223
- if (ctx.config.thinkingCallback) {
224
- ctx.config.thinkingCallback(thinking);
225
- }
226
- else if (ctx.config.outputCallback) {
227
- ctx.config.outputCallback(thinking);
228
- }
229
- else {
230
- process.stdout.write(thinking);
231
- }
232
- return updated;
233
- }
234
- function handleTextDelta(event, ctx) {
235
- if (event.type !== 'content_block_delta' ||
236
- event.delta?.type !== 'text_delta' ||
237
- !event.delta?.text) {
238
- return ctx.accumulatedAssistantResponse;
239
- }
240
- const text = event.delta.text;
241
- // Always accumulate raw text for checkpoint context
242
- const updated = ctx.accumulatedAssistantResponse + text;
243
- // Route through native timeout detector to intercept Claude Code's internal timeout messages
244
- const { passthrough, timeouts } = ctx.nativeTimeoutDetector.processChunk(text);
245
- // Emit structured markers for detected native timeouts
246
- for (const timeout of timeouts) {
247
- ctx.config.outputCallback?.(`\n[[MSTRO_NATIVE_TIMEOUT]] ${timeout.toolName} timed out \u2014 ${timeout.action} with ${timeout.preservedCount} results preserved\n`);
248
- }
249
- // When resume assessment is active, buffer text instead of forwarding.
250
- // This prevents confused "What were you working on?" responses from streaming
251
- // to the user before we can assess whether Claude retained context.
252
- if (ctx.resumeAssessmentActive) {
253
- if (passthrough) {
254
- ctx.resumeAssessmentBuffer += passthrough;
255
- }
256
- return updated;
257
- }
258
- // Forward non-timeout text to output
259
- if (passthrough && ctx.config.outputCallback) {
260
- ctx.config.outputCallback(passthrough);
261
- }
262
- return updated;
263
- }
264
- function handleToolStart(event, ctx) {
265
- if (event.type !== 'content_block_start' ||
266
- event.content_block?.type !== 'tool_use') {
267
- return;
268
- }
269
- // Tool activity confirms Claude has context — flush resume buffer
270
- if (ctx.resumeAssessmentActive) {
271
- ctx.resumeAssessmentActive = false;
272
- if (ctx.resumeAssessmentBuffer) {
273
- ctx.config.outputCallback?.(ctx.resumeAssessmentBuffer);
274
- ctx.resumeAssessmentBuffer = '';
275
- }
276
- }
277
- const toolName = event.content_block.name;
278
- const toolId = event.content_block.id;
279
- const index = event.index;
280
- ctx.toolInputBuffers.set(index, {
281
- name: toolName,
282
- id: toolId,
283
- inputJson: '',
284
- startTime: Date.now()
285
- });
286
- if (ctx.config.toolUseCallback) {
287
- ctx.config.toolUseCallback({ type: 'tool_start', toolName, toolId, index });
288
- }
289
- }
290
- function handleToolInputDelta(event, ctx) {
291
- if (event.type !== 'content_block_delta' ||
292
- event.delta?.type !== 'input_json_delta') {
293
- return;
294
- }
295
- const index = event.index;
296
- const partialJson = event.delta.partial_json;
297
- const toolBuffer = ctx.toolInputBuffers.get(index);
298
- if (toolBuffer) {
299
- toolBuffer.inputJson += partialJson;
300
- }
301
- if (ctx.config.toolUseCallback) {
302
- ctx.config.toolUseCallback({ type: 'tool_input_delta', partialJson, index });
303
- }
304
- }
305
- function handleToolComplete(event, ctx) {
306
- if (event.type !== 'content_block_stop') {
307
- return;
308
- }
309
- const index = event.index;
310
- const toolBuffer = ctx.toolInputBuffers.get(index);
311
- if (!toolBuffer) {
312
- return;
313
- }
314
- let completeInput = {};
315
- try {
316
- completeInput = JSON.parse(toolBuffer.inputJson);
317
- }
318
- catch (_e) {
319
- // Input might not be valid JSON yet
320
- }
321
- ctx.accumulatedToolUse.push({
322
- toolName: toolBuffer.name,
323
- toolId: toolBuffer.id,
324
- toolInput: completeInput,
325
- startTime: toolBuffer.startTime
326
- });
327
- // Clean up the input buffer — it's no longer needed after accumulation
328
- ctx.toolInputBuffers.delete(index);
329
- if (ctx.config.toolUseCallback) {
330
- ctx.config.toolUseCallback({
331
- type: 'tool_complete',
332
- toolName: toolBuffer.name,
333
- toolId: toolBuffer.id,
334
- index,
335
- completeInput
336
- });
337
- }
338
- }
339
- /** Accumulate input tokens from a message_start event. Returns true if any tokens were added. */
340
- function handleMessageStartTokens(event, ctx) {
341
- if (event.type !== 'message_start' || !event.message?.usage)
342
- return false;
343
- const usage = event.message.usage;
344
- ctx.currentStepOutputTokens = 0;
345
- let changed = false;
346
- if (typeof usage.input_tokens === 'number') {
347
- ctx.apiTokenUsage.inputTokens += usage.input_tokens;
348
- changed = true;
349
- }
350
- if (typeof usage.cache_creation_input_tokens === 'number') {
351
- ctx.apiTokenUsage.inputTokens += usage.cache_creation_input_tokens;
352
- changed = true;
353
- }
354
- if (typeof usage.cache_read_input_tokens === 'number') {
355
- ctx.apiTokenUsage.inputTokens += usage.cache_read_input_tokens;
356
- changed = true;
357
- }
358
- verboseLog(ctx.config.verbose, `[TOKENS] message_start: input=${usage.input_tokens ?? 0} cache_create=${usage.cache_creation_input_tokens ?? 0} cache_read=${usage.cache_read_input_tokens ?? 0} → total_input=${ctx.apiTokenUsage.inputTokens}`);
359
- return changed;
360
- }
361
- /** Accumulate output tokens from a message_delta event. Returns true if any tokens were added.
362
- * message_delta carries CUMULATIVE output token count for the current step.
363
- * Per Anthropic docs: "The token counts shown in the usage field of the
364
- * message_delta event are cumulative" and there can be "one or more message_delta
365
- * events" per message. We track the delta from the previous value to avoid
366
- * double-counting when multiple message_delta events fire per step. */
367
- function handleMessageDeltaTokens(event, ctx) {
368
- if (event.type !== 'message_delta' || !event.usage)
369
- return false;
370
- if (typeof event.usage.output_tokens !== 'number')
371
- return false;
372
- const increment = event.usage.output_tokens - ctx.currentStepOutputTokens;
373
- verboseLog(ctx.config.verbose, `[TOKENS] message_delta: output=${event.usage.output_tokens} (step_prev=${ctx.currentStepOutputTokens} increment=${increment}) → total_output=${ctx.apiTokenUsage.outputTokens + Math.max(increment, 0)}`);
374
- if (increment <= 0)
375
- return false;
376
- ctx.apiTokenUsage.outputTokens += increment;
377
- ctx.currentStepOutputTokens = event.usage.output_tokens;
378
- return true;
379
- }
380
- function handleTokenUsage(event, ctx) {
381
- const changed = handleMessageStartTokens(event, ctx) || handleMessageDeltaTokens(event, ctx);
382
- if (changed) {
383
- ctx.lastTokenActivityTime = Date.now();
384
- ctx.config.tokenUsageCallback?.({ ...ctx.apiTokenUsage });
385
- }
386
- }
387
- /**
388
- * Extract definitive token usage from the result event emitted at the end of a Claude session.
389
- * The result event's `usage` field contains the authoritative total — it overrides any
390
- * accumulated stream-based counts which may be incomplete (e.g., when extended thinking
391
- * suppresses stream_event emissions).
392
- */
393
- function handleResultTokenUsage(parsed, ctx) {
394
- if (!parsed.usage)
395
- return;
396
- const u = parsed.usage;
397
- const input = (typeof u.input_tokens === 'number' ? u.input_tokens : 0)
398
- + (typeof u.cache_creation_input_tokens === 'number' ? u.cache_creation_input_tokens : 0)
399
- + (typeof u.cache_read_input_tokens === 'number' ? u.cache_read_input_tokens : 0);
400
- const output = typeof u.output_tokens === 'number' ? u.output_tokens : 0;
401
- if (input > 0 || output > 0) {
402
- verboseLog(ctx.config.verbose, `[TOKENS] Result event usage: input=${input} output=${output} ` +
403
- `(stream accumulated: input=${ctx.apiTokenUsage.inputTokens} output=${ctx.apiTokenUsage.outputTokens})`);
404
- // Replace with authoritative counts from the result event
405
- ctx.apiTokenUsage = { inputTokens: input, outputTokens: output };
406
- ctx.lastTokenActivityTime = Date.now();
407
- ctx.config.tokenUsageCallback?.({ ...ctx.apiTokenUsage });
408
- }
409
- }
410
- function handleToolResult(parsed, ctx) {
411
- if (parsed.type !== 'user' || !parsed.message?.content) {
412
- return;
413
- }
414
- for (const content of parsed.message.content) {
415
- if (content.type !== 'tool_result') {
416
- continue;
417
- }
418
- const toolId = content.tool_use_id;
419
- const result = content.content;
420
- const isError = content.is_error || false;
421
- const resultStr = typeof result === 'string' ? result : JSON.stringify(result);
422
- const toolEntry = ctx.accumulatedToolUse.find(t => t.toolId === toolId);
423
- if (toolEntry) {
424
- toolEntry.result = resultStr;
425
- toolEntry.isError = isError;
426
- toolEntry.duration = Date.now() - toolEntry.startTime;
427
- }
428
- if (ctx.config.toolUseCallback) {
429
- ctx.config.toolUseCallback({ type: 'tool_result', toolId, result: resultStr, isError });
430
- }
431
- }
432
- }
433
- function processStreamLines(buffer, sessionCapture, ctx) {
434
- const lines = buffer.split('\n');
435
- const remainder = lines.pop() || '';
436
- for (const line of lines) {
437
- if (!line.trim())
438
- continue;
439
- try {
440
- const parsed = JSON.parse(line);
441
- handleSessionCapture(parsed, sessionCapture);
442
- processStreamEvent(parsed, ctx);
443
- }
444
- catch (_e) {
445
- // Ignore parse errors
446
- }
447
- }
448
- return remainder;
449
- }
450
- function processStreamEvent(parsed, ctx) {
451
- // Handle error events from Claude CLI (API errors, model errors, etc.)
452
- if (parsed.type === 'error') {
453
- const errorMessage = parsed.error?.message || parsed.message || JSON.stringify(parsed);
454
- ctx.config.outputCallback?.(`\n[[MSTRO_ERROR:CLAUDE_ERROR]] ${errorMessage}\n`);
455
- return;
456
- }
457
- // Handle result events — extract definitive token usage, stop_reason, and surface errors
458
- if (parsed.type === 'result') {
459
- handleResultTokenUsage(parsed, ctx);
460
- if (parsed.stop_reason) {
461
- ctx.stopReason = parsed.stop_reason;
462
- }
463
- if (parsed.is_error) {
464
- const errorMessage = parsed.error || parsed.result || 'Unknown error in result';
465
- ctx.config.outputCallback?.(`\n[[MSTRO_ERROR:CLAUDE_RESULT_ERROR]] ${errorMessage}\n`);
466
- return;
467
- }
468
- }
469
- if (parsed.type === 'stream_event' && parsed.event) {
470
- const event = parsed.event;
471
- ctx.accumulatedThinking = handleThinkingDelta(event, ctx);
472
- ctx.accumulatedAssistantResponse = handleTextDelta(event, ctx);
473
- handleToolStart(event, ctx);
474
- handleToolInputDelta(event, ctx);
475
- handleToolComplete(event, ctx);
476
- handleTokenUsage(event, ctx);
477
- }
478
- handleToolResult(parsed, ctx);
479
- }
480
- // ========== Close Handler Helpers ==========
481
- /** Flush native timeout detector buffers and return post-timeout output if any */
482
- function flushNativeTimeoutBuffers(ctx) {
483
- const remaining = ctx.nativeTimeoutDetector.flush();
484
- const buffered = ctx.nativeTimeoutDetector.bufferedPostTimeoutOutput;
485
- const postTimeout = (buffered + remaining) || undefined;
486
- // Only flush remaining text if there were no native timeouts
487
- // (when there are timeouts, the session manager decides what to show)
488
- if (!postTimeout && remaining) {
489
- ctx.config.outputCallback?.(remaining);
490
- }
491
- return postTimeout;
492
- }
493
- /** Classify unmatched stderr via Haiku when process exits with error */
494
- async function classifyUnmatchedStderr(stderr, errorAlreadySurfaced, code, config) {
495
- if (!stderr || errorAlreadySurfaced || code === 0)
496
- return;
497
- try {
498
- const classified = await classifyError(stderr, config.claudeCommand, config.verbose);
499
- if (classified) {
500
- config.outputCallback?.(`\n[[MSTRO_ERROR:${classified.errorCode}]] ${classified.message}\n`);
501
- }
502
- }
503
- catch {
504
- // Haiku classification failed — proceed without it
505
- }
506
- }
507
- // ========== Error Handling ==========
508
- const SPAWN_ERROR_MAP = {
509
- ENOENT: {
510
- code: 'CLAUDE_NOT_INSTALLED',
511
- message: 'Claude Code is not installed or not in PATH. Please install Claude Code: npm install -g @anthropic-ai/claude-code'
512
- },
513
- EACCES: {
514
- code: 'PERMISSION_DENIED',
515
- message: 'Permission denied when running Claude Code. Please check file permissions.'
516
- }
517
- };
518
- function handleSpawnError(error, config, reject) {
519
- const mapped = error.code ? SPAWN_ERROR_MAP[error.code] : undefined;
520
- if (!mapped) {
521
- reject(error);
522
- return;
523
- }
524
- const formatted = `[[MSTRO_ERROR:${mapped.code}]] ${mapped.message}`;
525
- if (config.outputCallback) {
526
- config.outputCallback(`\n${formatted}\n`);
527
- }
528
- reject(new Error(formatted));
529
- }
530
- // ========== Argument Building ==========
531
- function buildClaudeArgs(config, prompt, hasImageAttachments, useStreamJson, mcpConfigPath) {
532
- const args = ['--print'];
533
- if (config.model && config.model !== 'default') {
534
- args.push('--model', config.model);
535
- }
536
- if (useStreamJson) {
537
- args.push('--output-format', 'stream-json', '--include-partial-messages', '--verbose');
538
- }
539
- if (hasImageAttachments) {
540
- args.push('--input-format', 'stream-json');
541
- }
542
- if (config.claudeSessionId) {
543
- args.push('--resume', config.claudeSessionId);
544
- }
545
- else if (config.continueSession) {
546
- args.push('--continue');
547
- }
548
- if (mcpConfigPath) {
549
- args.push('--mcp-config', mcpConfigPath);
550
- args.push('--permission-prompt-tool', 'mcp__mstro-bouncer__approval_prompt');
551
- }
552
- else {
553
- // Bouncer unavailable: use acceptEdits so file operations work without stdin prompts.
554
- // Bash still requires approval — Claude Code will skip tools it can't get permission for,
555
- // which is better than hanging on a stdin prompt that can never be answered.
556
- args.push('--permission-mode', 'acceptEdits');
557
- }
558
- if (!hasImageAttachments) {
559
- args.push(prompt);
560
- }
561
- return args;
562
- }
563
- /** Write image attachments to the Claude process stdin as stream-json */
564
- function writeImageAttachmentsToStdin(claudeProcess, prompt, config) {
565
- claudeProcess.stdin.on('error', (err) => {
566
- if (config.verbose) {
567
- herror('[STDIN] Write error:', err.message);
568
- }
569
- config.outputCallback?.(`\n[[MSTRO_ERROR:STDIN_WRITE_FAILED]] Failed to send image data to Claude: ${err.message}\n`);
570
- });
571
- const multimodalMessage = buildMultimodalMessage(prompt, config.imageAttachments);
572
- claudeProcess.stdin.write(multimodalMessage);
573
- claudeProcess.stdin.end();
574
- }
575
- /** Run a single stall-check tick. Extracted to reduce cognitive complexity of executeClaudeCommand. */
576
- async function runStallCheckTick(state, opts) {
577
- const now = Date.now();
578
- const silenceMs = now - state.lastActivityTime;
579
- const totalElapsed = now - opts.perfStart;
580
- const tokenSilenceMs = now - opts.lastTokenActivityTime;
581
- if (totalElapsed >= opts.stallHardCapMs) {
582
- terminateStallProcess(opts.claudeProcess, opts.stallCheckInterval, opts.config, `\n[[MSTRO_ERROR:EXECUTION_STALLED]] Hard time limit reached (${Math.round(opts.stallHardCapMs / 60000)} min total). Terminating process.\n`);
583
- return;
584
- }
585
- // Token activity pushes the kill deadline forward — tokens flowing means
586
- // the process is alive even if stdout is silent (e.g. silent thinking).
587
- if (tokenSilenceMs < 60_000 && now < state.currentKillDeadline) {
588
- const killMs = opts.config.stallKillMs ?? 1_800_000;
589
- state.currentKillDeadline = Math.max(state.currentKillDeadline, now + killMs);
590
- }
591
- if (now >= state.currentKillDeadline) {
592
- terminateStallProcess(opts.claudeProcess, opts.stallCheckInterval, opts.config, `\n[[MSTRO_ERROR:EXECUTION_STALLED]] No output for ${Math.round(silenceMs / 60_000)} minutes. Terminating process.\n`);
593
- return;
594
- }
595
- if (silenceMs < opts.stallWarningMs || state.stallWarningEmitted || now < state.nextWarningAfter || state.assessmentInProgress)
596
- return;
597
- const stallCtx = {
598
- originalPrompt: opts.prompt,
599
- silenceMs,
600
- lastToolName: opts.pendingTools.size > 0 ? Array.from(opts.pendingTools.values()).pop() : undefined,
601
- lastToolInputSummary: opts.lastToolInputSummary,
602
- pendingToolCount: opts.pendingTools.size,
603
- pendingToolNames: new Set(opts.pendingTools.values()),
604
- totalToolCalls: opts.totalToolCalls,
605
- elapsedTotalMs: totalElapsed,
606
- tokenSilenceMs,
607
- };
608
- if (opts.stallAssessEnabled && state.extensionsGranted < opts.maxExtensions) {
609
- state.assessmentInProgress = true;
610
- const result = await runStallAssessment({ stallCtx, config: opts.config, now, extensionsGranted: state.extensionsGranted, maxExtensions: opts.maxExtensions, toolWatchdogActive: opts.toolWatchdogActive });
611
- state.assessmentInProgress = false;
612
- if (result) {
613
- state.extensionsGranted = result.extensionsGranted;
614
- state.currentKillDeadline = result.currentKillDeadline;
615
- state.nextWarningAfter = now + opts.stallWarningMs;
616
- return;
617
- }
618
- }
619
- state.stallWarningEmitted = true;
620
- const killIn = Math.round((state.currentKillDeadline - now) / 60_000);
621
- opts.config.outputCallback?.(`\n[[MSTRO_ERROR:EXECUTION_STALLED]] No output for ${Math.round(silenceMs / 60_000)} minutes. Will terminate in ${killIn} minutes if no activity.\n`);
622
- }
623
- /** Handle tool_start events. Extracted to reduce cognitive complexity. */
624
- function onToolStart(event, s) {
625
- const id = event.toolId;
626
- s.pendingTools.set(id, event.toolName);
627
- s.counters.totalToolCalls++;
628
- s.toolIdToName.set(id, event.toolName);
629
- if (s.watchdog) {
630
- s.watchdog.startWatch(id, event.toolName, {}, () => { s.onTimeout(id); });
631
- }
632
- }
633
- /** Handle tool_complete events. Extracted to reduce cognitive complexity. */
634
- function onToolComplete(event, s) {
635
- const id = event.toolId;
636
- const input = event.completeInput ?? {};
637
- s.counters.lastToolInputSummary = summarizeToolInput(input);
638
- s.toolIdToInput.set(id, input);
639
- if (!s.watchdog)
640
- return;
641
- const toolName = s.toolIdToName.get(id);
642
- if (toolName) {
643
- s.watchdog.startWatch(id, toolName, input, () => { s.onTimeout(id); });
644
- }
645
- }
646
- /** Handle tool_result events. Extracted to reduce cognitive complexity. */
647
- function onToolResult(event, s) {
648
- const id = event.toolId;
649
- s.pendingTools.delete(id);
650
- s.stallState.stallWarningEmitted = false;
651
- s.stallState.lastActivityTime = Date.now();
652
- const toolEntry = s.ctx.accumulatedToolUse.find(t => t.toolId === id);
653
- if (!s.watchdog || !toolEntry)
654
- return;
655
- const toolName = s.toolIdToName.get(id);
656
- if (toolName && toolEntry.duration) {
657
- s.watchdog.recordCompletion(toolName, toolEntry.duration);
658
- }
659
- s.watchdog.clearWatch(id);
660
- }
661
- /** Resolve a display URL from tool input for timeout messages */
662
- function resolveToolUrl(toolInput) {
663
- if (toolInput.url)
664
- return String(toolInput.url);
665
- if (toolInput.query)
666
- return String(toolInput.query);
667
- return undefined;
668
- }
669
- /** Handle a tool timeout by building a checkpoint and killing the process. */
670
- function executeToolTimeout(hungToolId, watchdog, killCtx, s, config, prompt, sessionCapture, perfStart) {
671
- const checkpoint = watchdog.buildCheckpoint(prompt, s.ctx.accumulatedAssistantResponse, s.ctx.accumulatedThinking, s.ctx.accumulatedToolUse, hungToolId, sessionCapture.claudeSessionId, perfStart);
672
- const toolName = s.toolIdToName.get(hungToolId) || 'unknown';
673
- const toolInput = s.toolIdToInput.get(hungToolId) || {};
674
- const timeoutMs = watchdog.getTimeout(toolName);
675
- const url = resolveToolUrl(toolInput);
676
- config.outputCallback?.(`\n[[MSTRO_TOOL_TIMEOUT]] ${toolName} timed out after ${Math.round(timeoutMs / 1000)}s${url ? ` fetching: ${url.slice(0, 100)}` : ''}. ${s.ctx.accumulatedToolUse.filter(t => t.result !== undefined).length} completed results preserved.\n`);
677
- if (checkpoint) {
678
- config.onToolTimeout?.(checkpoint);
679
- }
680
- verboseLog(config.verbose, `[WATCHDOG] Killing process due to ${toolName} timeout`);
681
- watchdog.clearAll();
682
- clearInterval(killCtx.stallCheckInterval);
683
- if (killCtx.claudeProcess.pid)
684
- killProcessGroup(killCtx.claudeProcess.pid, 'SIGTERM');
685
- const proc = killCtx.claudeProcess;
686
- setTimeout(() => { if (!proc.killed && proc.pid)
687
- killProcessGroup(proc.pid, 'SIGKILL'); }, 5000);
688
- }
689
- /** Set up tool activity tracking and watchdog. Extracted to reduce cognitive complexity. */
690
- function setupToolTracking(config, stallState, ctx, sessionCapture, prompt, perfStart) {
691
- const pendingTools = new Map();
692
- const counters = { lastToolInputSummary: undefined, totalToolCalls: 0 };
693
- const toolWatchdogActive = config.enableToolWatchdog !== false;
694
- const watchdog = toolWatchdogActive
695
- ? new ToolWatchdog({
696
- profiles: config.toolTimeoutProfiles,
697
- verbose: config.verbose,
698
- onTiebreaker: async (toolName, toolInput, elapsedMs, tokenSilenceMs) => {
699
- return assessToolTimeout(toolName, toolInput, elapsedMs, config.claudeCommand, config.verbose, tokenSilenceMs);
700
- },
701
- getTokenSilenceMs: () => {
702
- const last = ctx.lastTokenActivityTime;
703
- return last > 0 ? Date.now() - last : undefined;
704
- },
705
- })
706
- : null;
707
- // Deferred kill context — set after stallCheckInterval is created
708
- let killCtx = null;
709
- const trackingState = {
710
- pendingTools, counters,
711
- toolIdToName: new Map(), toolIdToInput: new Map(),
712
- watchdog, stallState, ctx,
713
- onTimeout: (hungToolId) => {
714
- if (!watchdog || !killCtx)
715
- return;
716
- executeToolTimeout(hungToolId, watchdog, killCtx, trackingState, config, prompt, sessionCapture, perfStart);
717
- },
718
- };
719
- const origToolUseCallback = config.toolUseCallback;
720
- config.toolUseCallback = (event) => {
721
- if (event.type === 'tool_start' && event.toolName && event.toolId) {
722
- onToolStart(event, trackingState);
723
- }
724
- else if (event.type === 'tool_complete' && event.completeInput && event.toolId) {
725
- onToolComplete(event, trackingState);
726
- }
727
- else if (event.type === 'tool_result' && event.toolId) {
728
- onToolResult(event, trackingState);
729
- }
730
- origToolUseCallback?.(event);
731
- };
732
- return {
733
- pendingTools, watchdog, toolWatchdogActive, counters,
734
- setKillContext: (claudeProcess, stallCheckInterval) => {
735
- killCtx = { claudeProcess, stallCheckInterval };
736
- },
737
- };
738
- }
739
- /** Log messages when verbose mode is enabled. Extracted to reduce cognitive complexity. */
740
- function verboseLog(verbose, ...msgs) {
741
- if (verbose) {
742
- for (const msg of msgs)
743
- hlog(msg);
744
- }
745
- }
746
- /** Spawn the Claude CLI process and register it. Extracted to reduce cognitive complexity. */
747
- function spawnAndRegister(config, prompt, hasImageAttachments, useStreamJson, runningProcesses, perfStart) {
748
- const mcpConfigPath = generateMcpConfig(config.workingDir, config.verbose);
749
- if (!mcpConfigPath && config.outputCallback) {
750
- config.outputCallback('\n[[MSTRO_ERROR:BOUNCER_UNAVAILABLE]] Security bouncer not available. Running with limited permissions — file edits allowed, but shell commands may be restricted.\n');
751
- }
752
- const args = buildClaudeArgs(config, prompt, hasImageAttachments, useStreamJson, mcpConfigPath);
753
- verboseLog(config.verbose, `[PERF] About to spawn: ${Date.now() - perfStart}ms`, `[PERF] Command: ${config.claudeCommand} ${args.join(' ')}`);
754
- const baseEnv = config.sandboxed
755
- ? sanitizeEnvForSandbox(process.env, config.workingDir)
756
- : { ...process.env };
757
- const spawnEnv = config.extraEnv
758
- ? { ...baseEnv, ...config.extraEnv }
759
- : baseEnv;
760
- const claudeProcess = spawn(config.claudeCommand, args, {
761
- cwd: config.workingDir,
762
- detached: true,
763
- env: spawnEnv,
764
- stdio: [hasImageAttachments ? 'pipe' : 'ignore', 'pipe', 'pipe']
765
- });
766
- if (hasImageAttachments && claudeProcess.stdin) {
767
- writeImageAttachmentsToStdin(claudeProcess, prompt, config);
768
- }
769
- if (claudeProcess.pid) {
770
- runningProcesses.set(claudeProcess.pid, claudeProcess);
771
- }
772
- verboseLog(config.verbose, `[PERF] Spawned: ${Date.now() - perfStart}ms`);
773
- return claudeProcess;
774
- }
775
- /**
776
- * Execute a Claude CLI command for a single movement
777
- * Supports multimodal prompts via --input-format stream-json when image attachments are present
10
+ * Execute a Claude CLI command for a single movement.
11
+ * Supports multimodal prompts via --input-format stream-json when image attachments are present.
778
12
  */
779
13
  export async function executeClaudeCommand(prompt, _movementId, _sessionNumber, options) {
780
14
  const { config, runningProcesses } = options;
781
15
  const perfStart = Date.now();
782
- verboseLog(config.verbose, `[PERF] executeMovement started`);
16
+ verboseLog(config.verbose, '[PERF] executeMovement started');
783
17
  const hasImageAttachments = config.imageAttachments && config.imageAttachments.length > 0;
784
18
  const useStreamJson = hasImageAttachments || config.thinkingCallback || config.outputCallback || config.toolUseCallback;
785
19
  const claudeProcess = spawnAndRegister(config, prompt, !!hasImageAttachments, !!useStreamJson, runningProcesses, perfStart);
@@ -789,8 +23,6 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
789
23
  let firstStdoutReceived = false;
790
24
  let errorAlreadySurfaced = false;
791
25
  const sessionCapture = {};
792
- // Activate resume assessment buffering when resuming a session.
793
- // Text is held until thinking/tool activity confirms Claude has context.
794
26
  const isResumeMode = !!(config.continueSession && config.claudeSessionId);
795
27
  const ctx = {
796
28
  config,
@@ -805,7 +37,6 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
805
37
  currentStepOutputTokens: 0,
806
38
  lastTokenActivityTime: Date.now(),
807
39
  };
808
- // Stall detection state (mutable object shared with runStallCheckTick)
809
40
  const stallState = {
810
41
  lastActivityTime: Date.now(),
811
42
  stallWarningEmitted: false,
@@ -814,16 +45,13 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
814
45
  currentKillDeadline: Date.now() + (config.stallKillMs ?? 1_800_000),
815
46
  nextWarningAfter: 0,
816
47
  };
817
- // Tool activity tracking for stall assessment context
818
48
  const toolTracking = setupToolTracking(config, stallState, ctx, sessionCapture, prompt, perfStart);
819
49
  const { pendingTools, watchdog, toolWatchdogActive } = toolTracking;
820
- // Mutable counters accessed by stall check tick
821
50
  const toolCounters = toolTracking.counters;
822
51
  claudeProcess.stdout.on('data', (data) => {
823
52
  stallState.lastActivityTime = Date.now();
824
53
  stallState.stallWarningEmitted = false;
825
- stallState.nextWarningAfter = 0; // Real activity resets throttle
826
- // Push kill deadline forward on any activity
54
+ stallState.nextWarningAfter = 0;
827
55
  const killMs = config.stallKillMs ?? 1_800_000;
828
56
  stallState.currentKillDeadline = Date.now() + killMs;
829
57
  if (!firstStdoutReceived) {
@@ -863,7 +91,6 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
863
91
  claudeProcess, stallCheckInterval, config, lastTokenActivityTime: ctx.lastTokenActivityTime,
864
92
  });
865
93
  }, 10_000);
866
- // Wire up the kill context now that stallCheckInterval exists
867
94
  toolTracking.setKillContext(claudeProcess, stallCheckInterval);
868
95
  return new Promise((resolve, reject) => {
869
96
  claudeProcess.on('close', async (code, signal) => {
@@ -883,25 +110,4 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
883
110
  });
884
111
  });
885
112
  }
886
- function buildCloseResult(ctx, stdout, stderr, code, signal, sessionCapture) {
887
- const postTimeout = flushNativeTimeoutBuffers(ctx);
888
- const resumeBuffered = ctx.resumeAssessmentActive ? (ctx.resumeAssessmentBuffer || undefined) : undefined;
889
- const exitCode = code ?? (signal ? 128 + (signalToNumber(signal) ?? 0) : 0);
890
- const hasTokenUsage = ctx.apiTokenUsage.inputTokens > 0 || ctx.apiTokenUsage.outputTokens > 0;
891
- return {
892
- output: stdout,
893
- error: stderr || undefined,
894
- exitCode,
895
- signalName: signal || undefined,
896
- assistantResponse: ctx.accumulatedAssistantResponse || undefined,
897
- thinkingOutput: ctx.accumulatedThinking || undefined,
898
- toolUseHistory: ctx.accumulatedToolUse.length > 0 ? ctx.accumulatedToolUse : undefined,
899
- claudeSessionId: sessionCapture.claudeSessionId,
900
- nativeTimeoutCount: ctx.nativeTimeoutDetector.timeoutCount || undefined,
901
- postTimeoutOutput: postTimeout,
902
- resumeBufferedOutput: resumeBuffered,
903
- apiTokenUsage: hasTokenUsage ? { ...ctx.apiTokenUsage } : undefined,
904
- stopReason: ctx.stopReason,
905
- };
906
- }
907
113
  //# sourceMappingURL=claude-invoker.js.map