mstro-app 0.4.3 → 0.4.10

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 (306) hide show
  1. package/dist/server/cli/headless/claude-invoker-process.d.ts +11 -0
  2. package/dist/server/cli/headless/claude-invoker-process.d.ts.map +1 -0
  3. package/dist/server/cli/headless/claude-invoker-process.js +140 -0
  4. package/dist/server/cli/headless/claude-invoker-process.js.map +1 -0
  5. package/dist/server/cli/headless/claude-invoker-stall.d.ts +40 -0
  6. package/dist/server/cli/headless/claude-invoker-stall.d.ts.map +1 -0
  7. package/dist/server/cli/headless/claude-invoker-stall.js +98 -0
  8. package/dist/server/cli/headless/claude-invoker-stall.js.map +1 -0
  9. package/dist/server/cli/headless/claude-invoker-stream.d.ts +44 -0
  10. package/dist/server/cli/headless/claude-invoker-stream.d.ts.map +1 -0
  11. package/dist/server/cli/headless/claude-invoker-stream.js +276 -0
  12. package/dist/server/cli/headless/claude-invoker-stream.js.map +1 -0
  13. package/dist/server/cli/headless/claude-invoker-tools.d.ts +21 -0
  14. package/dist/server/cli/headless/claude-invoker-tools.d.ts.map +1 -0
  15. package/dist/server/cli/headless/claude-invoker-tools.js +137 -0
  16. package/dist/server/cli/headless/claude-invoker-tools.js.map +1 -0
  17. package/dist/server/cli/headless/claude-invoker.d.ts +6 -4
  18. package/dist/server/cli/headless/claude-invoker.d.ts.map +1 -1
  19. package/dist/server/cli/headless/claude-invoker.js +10 -807
  20. package/dist/server/cli/headless/claude-invoker.js.map +1 -1
  21. package/dist/server/cli/headless/haiku-assessments.d.ts +62 -0
  22. package/dist/server/cli/headless/haiku-assessments.d.ts.map +1 -0
  23. package/dist/server/cli/headless/haiku-assessments.js +281 -0
  24. package/dist/server/cli/headless/haiku-assessments.js.map +1 -0
  25. package/dist/server/cli/headless/headless-logger.d.ts +3 -2
  26. package/dist/server/cli/headless/headless-logger.d.ts.map +1 -1
  27. package/dist/server/cli/headless/headless-logger.js +28 -5
  28. package/dist/server/cli/headless/headless-logger.js.map +1 -1
  29. package/dist/server/cli/headless/native-timeout-detector.d.ts +44 -0
  30. package/dist/server/cli/headless/native-timeout-detector.d.ts.map +1 -0
  31. package/dist/server/cli/headless/native-timeout-detector.js +99 -0
  32. package/dist/server/cli/headless/native-timeout-detector.js.map +1 -0
  33. package/dist/server/cli/headless/stall-assessor.d.ts +2 -110
  34. package/dist/server/cli/headless/stall-assessor.d.ts.map +1 -1
  35. package/dist/server/cli/headless/stall-assessor.js +65 -457
  36. package/dist/server/cli/headless/stall-assessor.js.map +1 -1
  37. package/dist/server/cli/improvisation-attachments.d.ts +21 -0
  38. package/dist/server/cli/improvisation-attachments.d.ts.map +1 -0
  39. package/dist/server/cli/improvisation-attachments.js +116 -0
  40. package/dist/server/cli/improvisation-attachments.js.map +1 -0
  41. package/dist/server/cli/improvisation-retry.d.ts +52 -0
  42. package/dist/server/cli/improvisation-retry.d.ts.map +1 -0
  43. package/dist/server/cli/improvisation-retry.js +434 -0
  44. package/dist/server/cli/improvisation-retry.js.map +1 -0
  45. package/dist/server/cli/improvisation-session-manager.d.ts +10 -266
  46. package/dist/server/cli/improvisation-session-manager.d.ts.map +1 -1
  47. package/dist/server/cli/improvisation-session-manager.js +117 -1079
  48. package/dist/server/cli/improvisation-session-manager.js.map +1 -1
  49. package/dist/server/cli/improvisation-types.d.ts +86 -0
  50. package/dist/server/cli/improvisation-types.d.ts.map +1 -0
  51. package/dist/server/cli/improvisation-types.js +10 -0
  52. package/dist/server/cli/improvisation-types.js.map +1 -0
  53. package/dist/server/cli/prompt-builders.d.ts +68 -0
  54. package/dist/server/cli/prompt-builders.d.ts.map +1 -0
  55. package/dist/server/cli/prompt-builders.js +312 -0
  56. package/dist/server/cli/prompt-builders.js.map +1 -0
  57. package/dist/server/index.js +33 -212
  58. package/dist/server/index.js.map +1 -1
  59. package/dist/server/mcp/bouncer-haiku.d.ts +10 -0
  60. package/dist/server/mcp/bouncer-haiku.d.ts.map +1 -0
  61. package/dist/server/mcp/bouncer-haiku.js +152 -0
  62. package/dist/server/mcp/bouncer-haiku.js.map +1 -0
  63. package/dist/server/mcp/bouncer-integration.d.ts +3 -4
  64. package/dist/server/mcp/bouncer-integration.d.ts.map +1 -1
  65. package/dist/server/mcp/bouncer-integration.js +50 -196
  66. package/dist/server/mcp/bouncer-integration.js.map +1 -1
  67. package/dist/server/mcp/security-analysis.d.ts +38 -0
  68. package/dist/server/mcp/security-analysis.d.ts.map +1 -0
  69. package/dist/server/mcp/security-analysis.js +183 -0
  70. package/dist/server/mcp/security-analysis.js.map +1 -0
  71. package/dist/server/mcp/security-audit.d.ts +1 -1
  72. package/dist/server/mcp/security-audit.d.ts.map +1 -1
  73. package/dist/server/mcp/security-patterns.d.ts +1 -25
  74. package/dist/server/mcp/security-patterns.d.ts.map +1 -1
  75. package/dist/server/mcp/security-patterns.js +55 -260
  76. package/dist/server/mcp/security-patterns.js.map +1 -1
  77. package/dist/server/server-setup.d.ts +22 -0
  78. package/dist/server/server-setup.d.ts.map +1 -0
  79. package/dist/server/server-setup.js +101 -0
  80. package/dist/server/server-setup.js.map +1 -0
  81. package/dist/server/services/file-explorer-ops.d.ts +24 -0
  82. package/dist/server/services/file-explorer-ops.d.ts.map +1 -0
  83. package/dist/server/services/file-explorer-ops.js +211 -0
  84. package/dist/server/services/file-explorer-ops.js.map +1 -0
  85. package/dist/server/services/files.d.ts +2 -85
  86. package/dist/server/services/files.d.ts.map +1 -1
  87. package/dist/server/services/files.js +7 -427
  88. package/dist/server/services/files.js.map +1 -1
  89. package/dist/server/services/plan/composer.d.ts.map +1 -1
  90. package/dist/server/services/plan/composer.js +2 -1
  91. package/dist/server/services/plan/composer.js.map +1 -1
  92. package/dist/server/services/plan/executor.d.ts.map +1 -1
  93. package/dist/server/services/plan/executor.js +3 -1
  94. package/dist/server/services/plan/executor.js.map +1 -1
  95. package/dist/server/services/plan/parser-core.d.ts +20 -0
  96. package/dist/server/services/plan/parser-core.d.ts.map +1 -0
  97. package/dist/server/services/plan/parser-core.js +350 -0
  98. package/dist/server/services/plan/parser-core.js.map +1 -0
  99. package/dist/server/services/plan/parser-migration.d.ts +5 -0
  100. package/dist/server/services/plan/parser-migration.d.ts.map +1 -0
  101. package/dist/server/services/plan/parser-migration.js +124 -0
  102. package/dist/server/services/plan/parser-migration.js.map +1 -0
  103. package/dist/server/services/plan/parser.d.ts +0 -8
  104. package/dist/server/services/plan/parser.d.ts.map +1 -1
  105. package/dist/server/services/plan/parser.js +50 -569
  106. package/dist/server/services/plan/parser.js.map +1 -1
  107. package/dist/server/services/plan/review-gate.d.ts +2 -0
  108. package/dist/server/services/plan/review-gate.d.ts.map +1 -1
  109. package/dist/server/services/plan/review-gate.js +2 -2
  110. package/dist/server/services/plan/review-gate.js.map +1 -1
  111. package/dist/server/services/plan/types.d.ts +2 -0
  112. package/dist/server/services/plan/types.d.ts.map +1 -1
  113. package/dist/server/services/platform-credentials.d.ts +24 -0
  114. package/dist/server/services/platform-credentials.d.ts.map +1 -0
  115. package/dist/server/services/platform-credentials.js +68 -0
  116. package/dist/server/services/platform-credentials.js.map +1 -0
  117. package/dist/server/services/platform.d.ts +1 -31
  118. package/dist/server/services/platform.d.ts.map +1 -1
  119. package/dist/server/services/platform.js +10 -119
  120. package/dist/server/services/platform.js.map +1 -1
  121. package/dist/server/services/terminal/pty-manager.d.ts +7 -97
  122. package/dist/server/services/terminal/pty-manager.d.ts.map +1 -1
  123. package/dist/server/services/terminal/pty-manager.js +53 -266
  124. package/dist/server/services/terminal/pty-manager.js.map +1 -1
  125. package/dist/server/services/terminal/pty-utils.d.ts +57 -0
  126. package/dist/server/services/terminal/pty-utils.d.ts.map +1 -0
  127. package/dist/server/services/terminal/pty-utils.js +141 -0
  128. package/dist/server/services/terminal/pty-utils.js.map +1 -0
  129. package/dist/server/services/websocket/file-definition-handlers.d.ts +4 -0
  130. package/dist/server/services/websocket/file-definition-handlers.d.ts.map +1 -0
  131. package/dist/server/services/websocket/file-definition-handlers.js +153 -0
  132. package/dist/server/services/websocket/file-definition-handlers.js.map +1 -0
  133. package/dist/server/services/websocket/file-explorer-handlers.d.ts.map +1 -1
  134. package/dist/server/services/websocket/file-explorer-handlers.js +52 -391
  135. package/dist/server/services/websocket/file-explorer-handlers.js.map +1 -1
  136. package/dist/server/services/websocket/file-search-handlers.d.ts +5 -0
  137. package/dist/server/services/websocket/file-search-handlers.d.ts.map +1 -0
  138. package/dist/server/services/websocket/file-search-handlers.js +238 -0
  139. package/dist/server/services/websocket/file-search-handlers.js.map +1 -0
  140. package/dist/server/services/websocket/file-utils.js +3 -3
  141. package/dist/server/services/websocket/file-utils.js.map +1 -1
  142. package/dist/server/services/websocket/git-branch-handlers.d.ts +7 -0
  143. package/dist/server/services/websocket/git-branch-handlers.d.ts.map +1 -0
  144. package/dist/server/services/websocket/git-branch-handlers.js +110 -0
  145. package/dist/server/services/websocket/git-branch-handlers.js.map +1 -0
  146. package/dist/server/services/websocket/git-diff-handlers.d.ts +6 -0
  147. package/dist/server/services/websocket/git-diff-handlers.d.ts.map +1 -0
  148. package/dist/server/services/websocket/git-diff-handlers.js +123 -0
  149. package/dist/server/services/websocket/git-diff-handlers.js.map +1 -0
  150. package/dist/server/services/websocket/git-handlers.d.ts +2 -31
  151. package/dist/server/services/websocket/git-handlers.d.ts.map +1 -1
  152. package/dist/server/services/websocket/git-handlers.js +35 -541
  153. package/dist/server/services/websocket/git-handlers.js.map +1 -1
  154. package/dist/server/services/websocket/git-log-handlers.d.ts +6 -0
  155. package/dist/server/services/websocket/git-log-handlers.d.ts.map +1 -0
  156. package/dist/server/services/websocket/git-log-handlers.js +128 -0
  157. package/dist/server/services/websocket/git-log-handlers.js.map +1 -0
  158. package/dist/server/services/websocket/git-pr-handlers.d.ts.map +1 -1
  159. package/dist/server/services/websocket/git-pr-handlers.js +13 -53
  160. package/dist/server/services/websocket/git-pr-handlers.js.map +1 -1
  161. package/dist/server/services/websocket/git-tag-handlers.d.ts +6 -0
  162. package/dist/server/services/websocket/git-tag-handlers.d.ts.map +1 -0
  163. package/dist/server/services/websocket/git-tag-handlers.js +76 -0
  164. package/dist/server/services/websocket/git-tag-handlers.js.map +1 -0
  165. package/dist/server/services/websocket/git-utils.d.ts +43 -0
  166. package/dist/server/services/websocket/git-utils.d.ts.map +1 -0
  167. package/dist/server/services/websocket/git-utils.js +201 -0
  168. package/dist/server/services/websocket/git-utils.js.map +1 -0
  169. package/dist/server/services/websocket/handler.d.ts +2 -0
  170. package/dist/server/services/websocket/handler.d.ts.map +1 -1
  171. package/dist/server/services/websocket/handler.js +37 -126
  172. package/dist/server/services/websocket/handler.js.map +1 -1
  173. package/dist/server/services/websocket/plan-board-handlers.d.ts +11 -0
  174. package/dist/server/services/websocket/plan-board-handlers.d.ts.map +1 -0
  175. package/dist/server/services/websocket/plan-board-handlers.js +218 -0
  176. package/dist/server/services/websocket/plan-board-handlers.js.map +1 -0
  177. package/dist/server/services/websocket/plan-execution-handlers.d.ts +9 -0
  178. package/dist/server/services/websocket/plan-execution-handlers.d.ts.map +1 -0
  179. package/dist/server/services/websocket/plan-execution-handlers.js +142 -0
  180. package/dist/server/services/websocket/plan-execution-handlers.js.map +1 -0
  181. package/dist/server/services/websocket/plan-handlers.d.ts +7 -2
  182. package/dist/server/services/websocket/plan-handlers.d.ts.map +1 -1
  183. package/dist/server/services/websocket/plan-handlers.js +6 -925
  184. package/dist/server/services/websocket/plan-handlers.js.map +1 -1
  185. package/dist/server/services/websocket/plan-helpers.d.ts +19 -0
  186. package/dist/server/services/websocket/plan-helpers.d.ts.map +1 -0
  187. package/dist/server/services/websocket/plan-helpers.js +199 -0
  188. package/dist/server/services/websocket/plan-helpers.js.map +1 -0
  189. package/dist/server/services/websocket/plan-issue-handlers.d.ts +12 -0
  190. package/dist/server/services/websocket/plan-issue-handlers.d.ts.map +1 -0
  191. package/dist/server/services/websocket/plan-issue-handlers.js +162 -0
  192. package/dist/server/services/websocket/plan-issue-handlers.js.map +1 -0
  193. package/dist/server/services/websocket/plan-sprint-handlers.d.ts +7 -0
  194. package/dist/server/services/websocket/plan-sprint-handlers.d.ts.map +1 -0
  195. package/dist/server/services/websocket/plan-sprint-handlers.js +206 -0
  196. package/dist/server/services/websocket/plan-sprint-handlers.js.map +1 -0
  197. package/dist/server/services/websocket/quality-complexity.d.ts +14 -0
  198. package/dist/server/services/websocket/quality-complexity.d.ts.map +1 -0
  199. package/dist/server/services/websocket/quality-complexity.js +262 -0
  200. package/dist/server/services/websocket/quality-complexity.js.map +1 -0
  201. package/dist/server/services/websocket/quality-fix-agent.d.ts +16 -0
  202. package/dist/server/services/websocket/quality-fix-agent.d.ts.map +1 -0
  203. package/dist/server/services/websocket/quality-fix-agent.js +140 -0
  204. package/dist/server/services/websocket/quality-fix-agent.js.map +1 -0
  205. package/dist/server/services/websocket/quality-handlers.d.ts.map +1 -1
  206. package/dist/server/services/websocket/quality-handlers.js +34 -346
  207. package/dist/server/services/websocket/quality-handlers.js.map +1 -1
  208. package/dist/server/services/websocket/quality-linting.d.ts +9 -0
  209. package/dist/server/services/websocket/quality-linting.d.ts.map +1 -0
  210. package/dist/server/services/websocket/quality-linting.js +178 -0
  211. package/dist/server/services/websocket/quality-linting.js.map +1 -0
  212. package/dist/server/services/websocket/quality-review-agent.d.ts +19 -0
  213. package/dist/server/services/websocket/quality-review-agent.d.ts.map +1 -0
  214. package/dist/server/services/websocket/quality-review-agent.js +206 -0
  215. package/dist/server/services/websocket/quality-review-agent.js.map +1 -0
  216. package/dist/server/services/websocket/quality-service.d.ts +3 -51
  217. package/dist/server/services/websocket/quality-service.d.ts.map +1 -1
  218. package/dist/server/services/websocket/quality-service.js +9 -651
  219. package/dist/server/services/websocket/quality-service.js.map +1 -1
  220. package/dist/server/services/websocket/quality-tools.d.ts +23 -0
  221. package/dist/server/services/websocket/quality-tools.d.ts.map +1 -0
  222. package/dist/server/services/websocket/quality-tools.js +208 -0
  223. package/dist/server/services/websocket/quality-tools.js.map +1 -0
  224. package/dist/server/services/websocket/quality-types.d.ts +59 -0
  225. package/dist/server/services/websocket/quality-types.d.ts.map +1 -0
  226. package/dist/server/services/websocket/quality-types.js +101 -0
  227. package/dist/server/services/websocket/quality-types.js.map +1 -0
  228. package/dist/server/services/websocket/session-handlers.d.ts +3 -4
  229. package/dist/server/services/websocket/session-handlers.d.ts.map +1 -1
  230. package/dist/server/services/websocket/session-handlers.js +3 -378
  231. package/dist/server/services/websocket/session-handlers.js.map +1 -1
  232. package/dist/server/services/websocket/session-history.d.ts +4 -0
  233. package/dist/server/services/websocket/session-history.d.ts.map +1 -0
  234. package/dist/server/services/websocket/session-history.js +208 -0
  235. package/dist/server/services/websocket/session-history.js.map +1 -0
  236. package/dist/server/services/websocket/session-initialization.d.ts +5 -0
  237. package/dist/server/services/websocket/session-initialization.d.ts.map +1 -0
  238. package/dist/server/services/websocket/session-initialization.js +163 -0
  239. package/dist/server/services/websocket/session-initialization.js.map +1 -0
  240. package/dist/server/services/websocket/types.d.ts +12 -2
  241. package/dist/server/services/websocket/types.d.ts.map +1 -1
  242. package/package.json +1 -1
  243. package/server/cli/headless/claude-invoker-process.ts +204 -0
  244. package/server/cli/headless/claude-invoker-stall.ts +164 -0
  245. package/server/cli/headless/claude-invoker-stream.ts +353 -0
  246. package/server/cli/headless/claude-invoker-tools.ts +187 -0
  247. package/server/cli/headless/claude-invoker.ts +15 -1096
  248. package/server/cli/headless/haiku-assessments.ts +365 -0
  249. package/server/cli/headless/headless-logger.ts +26 -5
  250. package/server/cli/headless/native-timeout-detector.ts +117 -0
  251. package/server/cli/headless/stall-assessor.ts +65 -618
  252. package/server/cli/improvisation-attachments.ts +148 -0
  253. package/server/cli/improvisation-retry.ts +602 -0
  254. package/server/cli/improvisation-session-manager.ts +140 -1349
  255. package/server/cli/improvisation-types.ts +98 -0
  256. package/server/cli/prompt-builders.ts +370 -0
  257. package/server/index.ts +35 -246
  258. package/server/mcp/bouncer-haiku.ts +182 -0
  259. package/server/mcp/bouncer-integration.ts +87 -248
  260. package/server/mcp/security-analysis.ts +217 -0
  261. package/server/mcp/security-audit.ts +1 -1
  262. package/server/mcp/security-patterns.ts +60 -283
  263. package/server/server-setup.ts +114 -0
  264. package/server/services/file-explorer-ops.ts +293 -0
  265. package/server/services/files.ts +20 -532
  266. package/server/services/plan/composer.ts +2 -1
  267. package/server/services/plan/executor.ts +3 -1
  268. package/server/services/plan/parser-core.ts +406 -0
  269. package/server/services/plan/parser-migration.ts +128 -0
  270. package/server/services/plan/parser.ts +52 -620
  271. package/server/services/plan/review-gate.ts +4 -2
  272. package/server/services/plan/types.ts +2 -0
  273. package/server/services/platform-credentials.ts +83 -0
  274. package/server/services/platform.ts +15 -141
  275. package/server/services/terminal/pty-manager.ts +66 -313
  276. package/server/services/terminal/pty-utils.ts +176 -0
  277. package/server/services/websocket/file-definition-handlers.ts +165 -0
  278. package/server/services/websocket/file-explorer-handlers.ts +37 -452
  279. package/server/services/websocket/file-search-handlers.ts +291 -0
  280. package/server/services/websocket/file-utils.ts +3 -3
  281. package/server/services/websocket/git-branch-handlers.ts +130 -0
  282. package/server/services/websocket/git-diff-handlers.ts +140 -0
  283. package/server/services/websocket/git-handlers.ts +40 -625
  284. package/server/services/websocket/git-log-handlers.ts +149 -0
  285. package/server/services/websocket/git-pr-handlers.ts +17 -62
  286. package/server/services/websocket/git-tag-handlers.ts +91 -0
  287. package/server/services/websocket/git-utils.ts +230 -0
  288. package/server/services/websocket/handler.ts +39 -126
  289. package/server/services/websocket/plan-board-handlers.ts +277 -0
  290. package/server/services/websocket/plan-execution-handlers.ts +184 -0
  291. package/server/services/websocket/plan-handlers.ts +8 -1114
  292. package/server/services/websocket/plan-helpers.ts +215 -0
  293. package/server/services/websocket/plan-issue-handlers.ts +204 -0
  294. package/server/services/websocket/plan-sprint-handlers.ts +252 -0
  295. package/server/services/websocket/quality-complexity.ts +294 -0
  296. package/server/services/websocket/quality-fix-agent.ts +181 -0
  297. package/server/services/websocket/quality-handlers.ts +36 -404
  298. package/server/services/websocket/quality-linting.ts +187 -0
  299. package/server/services/websocket/quality-review-agent.ts +246 -0
  300. package/server/services/websocket/quality-service.ts +11 -762
  301. package/server/services/websocket/quality-tools.ts +209 -0
  302. package/server/services/websocket/quality-types.ts +169 -0
  303. package/server/services/websocket/session-handlers.ts +5 -437
  304. package/server/services/websocket/session-history.ts +222 -0
  305. package/server/services/websocket/session-initialization.ts +209 -0
  306. package/server/services/websocket/types.ts +17 -0
@@ -1,788 +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 (config.disallowedTools && config.disallowedTools.length > 0) {
549
- args.push('--disallowedTools', config.disallowedTools.join(','));
550
- }
551
- if (mcpConfigPath) {
552
- args.push('--mcp-config', mcpConfigPath);
553
- args.push('--permission-prompt-tool', 'mcp__mstro-bouncer__approval_prompt');
554
- }
555
- else {
556
- // Bouncer unavailable: use acceptEdits so file operations work without stdin prompts.
557
- // Bash still requires approval — Claude Code will skip tools it can't get permission for,
558
- // which is better than hanging on a stdin prompt that can never be answered.
559
- args.push('--permission-mode', 'acceptEdits');
560
- }
561
- if (!hasImageAttachments) {
562
- args.push(prompt);
563
- }
564
- return args;
565
- }
566
- /** Write image attachments to the Claude process stdin as stream-json */
567
- function writeImageAttachmentsToStdin(claudeProcess, prompt, config) {
568
- claudeProcess.stdin.on('error', (err) => {
569
- if (config.verbose) {
570
- herror('[STDIN] Write error:', err.message);
571
- }
572
- config.outputCallback?.(`\n[[MSTRO_ERROR:STDIN_WRITE_FAILED]] Failed to send image data to Claude: ${err.message}\n`);
573
- });
574
- const multimodalMessage = buildMultimodalMessage(prompt, config.imageAttachments);
575
- claudeProcess.stdin.write(multimodalMessage);
576
- claudeProcess.stdin.end();
577
- }
578
- /** Run a single stall-check tick. Extracted to reduce cognitive complexity of executeClaudeCommand. */
579
- async function runStallCheckTick(state, opts) {
580
- const now = Date.now();
581
- const silenceMs = now - state.lastActivityTime;
582
- const totalElapsed = now - opts.perfStart;
583
- const tokenSilenceMs = now - opts.lastTokenActivityTime;
584
- if (totalElapsed >= opts.stallHardCapMs) {
585
- 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`);
586
- return;
587
- }
588
- // Token activity pushes the kill deadline forward — tokens flowing means
589
- // the process is alive even if stdout is silent (e.g. silent thinking).
590
- if (tokenSilenceMs < 60_000 && now < state.currentKillDeadline) {
591
- const killMs = opts.config.stallKillMs ?? 1_800_000;
592
- state.currentKillDeadline = Math.max(state.currentKillDeadline, now + killMs);
593
- }
594
- if (now >= state.currentKillDeadline) {
595
- terminateStallProcess(opts.claudeProcess, opts.stallCheckInterval, opts.config, `\n[[MSTRO_ERROR:EXECUTION_STALLED]] No output for ${Math.round(silenceMs / 60_000)} minutes. Terminating process.\n`);
596
- return;
597
- }
598
- if (silenceMs < opts.stallWarningMs || state.stallWarningEmitted || now < state.nextWarningAfter || state.assessmentInProgress)
599
- return;
600
- const stallCtx = {
601
- originalPrompt: opts.prompt,
602
- silenceMs,
603
- lastToolName: opts.pendingTools.size > 0 ? Array.from(opts.pendingTools.values()).pop() : undefined,
604
- lastToolInputSummary: opts.lastToolInputSummary,
605
- pendingToolCount: opts.pendingTools.size,
606
- pendingToolNames: new Set(opts.pendingTools.values()),
607
- totalToolCalls: opts.totalToolCalls,
608
- elapsedTotalMs: totalElapsed,
609
- tokenSilenceMs,
610
- };
611
- if (opts.stallAssessEnabled && state.extensionsGranted < opts.maxExtensions) {
612
- state.assessmentInProgress = true;
613
- const result = await runStallAssessment({ stallCtx, config: opts.config, now, extensionsGranted: state.extensionsGranted, maxExtensions: opts.maxExtensions, toolWatchdogActive: opts.toolWatchdogActive });
614
- state.assessmentInProgress = false;
615
- if (result) {
616
- state.extensionsGranted = result.extensionsGranted;
617
- state.currentKillDeadline = result.currentKillDeadline;
618
- state.nextWarningAfter = now + opts.stallWarningMs;
619
- return;
620
- }
621
- }
622
- state.stallWarningEmitted = true;
623
- const killIn = Math.round((state.currentKillDeadline - now) / 60_000);
624
- 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`);
625
- }
626
- /** Handle tool_start events. Extracted to reduce cognitive complexity. */
627
- function onToolStart(event, s) {
628
- const id = event.toolId;
629
- s.pendingTools.set(id, event.toolName);
630
- s.counters.totalToolCalls++;
631
- s.toolIdToName.set(id, event.toolName);
632
- if (s.watchdog) {
633
- s.watchdog.startWatch(id, event.toolName, {}, () => { s.onTimeout(id); });
634
- }
635
- }
636
- /** Handle tool_complete events. Extracted to reduce cognitive complexity. */
637
- function onToolComplete(event, s) {
638
- const id = event.toolId;
639
- const input = event.completeInput ?? {};
640
- s.counters.lastToolInputSummary = summarizeToolInput(input);
641
- s.toolIdToInput.set(id, input);
642
- if (!s.watchdog)
643
- return;
644
- const toolName = s.toolIdToName.get(id);
645
- if (toolName) {
646
- s.watchdog.startWatch(id, toolName, input, () => { s.onTimeout(id); });
647
- }
648
- }
649
- /** Handle tool_result events. Extracted to reduce cognitive complexity. */
650
- function onToolResult(event, s) {
651
- const id = event.toolId;
652
- s.pendingTools.delete(id);
653
- s.stallState.stallWarningEmitted = false;
654
- s.stallState.lastActivityTime = Date.now();
655
- const toolEntry = s.ctx.accumulatedToolUse.find(t => t.toolId === id);
656
- if (!s.watchdog || !toolEntry)
657
- return;
658
- const toolName = s.toolIdToName.get(id);
659
- if (toolName && toolEntry.duration) {
660
- s.watchdog.recordCompletion(toolName, toolEntry.duration);
661
- }
662
- s.watchdog.clearWatch(id);
663
- }
664
- /** Resolve a display URL from tool input for timeout messages */
665
- function resolveToolUrl(toolInput) {
666
- if (toolInput.url)
667
- return String(toolInput.url);
668
- if (toolInput.query)
669
- return String(toolInput.query);
670
- return undefined;
671
- }
672
- /** Handle a tool timeout by building a checkpoint and killing the process. */
673
- function executeToolTimeout(hungToolId, watchdog, killCtx, s, config, prompt, sessionCapture, perfStart) {
674
- const checkpoint = watchdog.buildCheckpoint(prompt, s.ctx.accumulatedAssistantResponse, s.ctx.accumulatedThinking, s.ctx.accumulatedToolUse, hungToolId, sessionCapture.claudeSessionId, perfStart);
675
- const toolName = s.toolIdToName.get(hungToolId) || 'unknown';
676
- const toolInput = s.toolIdToInput.get(hungToolId) || {};
677
- const timeoutMs = watchdog.getTimeout(toolName);
678
- const url = resolveToolUrl(toolInput);
679
- 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`);
680
- if (checkpoint) {
681
- config.onToolTimeout?.(checkpoint);
682
- }
683
- verboseLog(config.verbose, `[WATCHDOG] Killing process due to ${toolName} timeout`);
684
- watchdog.clearAll();
685
- clearInterval(killCtx.stallCheckInterval);
686
- if (killCtx.claudeProcess.pid)
687
- killProcessGroup(killCtx.claudeProcess.pid, 'SIGTERM');
688
- const proc = killCtx.claudeProcess;
689
- setTimeout(() => { if (!proc.killed && proc.pid)
690
- killProcessGroup(proc.pid, 'SIGKILL'); }, 5000);
691
- }
692
- /** Set up tool activity tracking and watchdog. Extracted to reduce cognitive complexity. */
693
- function setupToolTracking(config, stallState, ctx, sessionCapture, prompt, perfStart) {
694
- const pendingTools = new Map();
695
- const counters = { lastToolInputSummary: undefined, totalToolCalls: 0 };
696
- const toolWatchdogActive = config.enableToolWatchdog !== false;
697
- const watchdog = toolWatchdogActive
698
- ? new ToolWatchdog({
699
- profiles: config.toolTimeoutProfiles,
700
- verbose: config.verbose,
701
- onTiebreaker: async (toolName, toolInput, elapsedMs, tokenSilenceMs) => {
702
- return assessToolTimeout(toolName, toolInput, elapsedMs, config.claudeCommand, config.verbose, tokenSilenceMs);
703
- },
704
- getTokenSilenceMs: () => {
705
- const last = ctx.lastTokenActivityTime;
706
- return last > 0 ? Date.now() - last : undefined;
707
- },
708
- })
709
- : null;
710
- // Deferred kill context — set after stallCheckInterval is created
711
- let killCtx = null;
712
- const trackingState = {
713
- pendingTools, counters,
714
- toolIdToName: new Map(), toolIdToInput: new Map(),
715
- watchdog, stallState, ctx,
716
- onTimeout: (hungToolId) => {
717
- if (!watchdog || !killCtx)
718
- return;
719
- executeToolTimeout(hungToolId, watchdog, killCtx, trackingState, config, prompt, sessionCapture, perfStart);
720
- },
721
- };
722
- const origToolUseCallback = config.toolUseCallback;
723
- config.toolUseCallback = (event) => {
724
- if (event.type === 'tool_start' && event.toolName && event.toolId) {
725
- onToolStart(event, trackingState);
726
- }
727
- else if (event.type === 'tool_complete' && event.completeInput && event.toolId) {
728
- onToolComplete(event, trackingState);
729
- }
730
- else if (event.type === 'tool_result' && event.toolId) {
731
- onToolResult(event, trackingState);
732
- }
733
- origToolUseCallback?.(event);
734
- };
735
- return {
736
- pendingTools, watchdog, toolWatchdogActive, counters,
737
- setKillContext: (claudeProcess, stallCheckInterval) => {
738
- killCtx = { claudeProcess, stallCheckInterval };
739
- },
740
- };
741
- }
742
- /** Log messages when verbose mode is enabled. Extracted to reduce cognitive complexity. */
743
- function verboseLog(verbose, ...msgs) {
744
- if (verbose) {
745
- for (const msg of msgs)
746
- hlog(msg);
747
- }
748
- }
749
- /** Spawn the Claude CLI process and register it. Extracted to reduce cognitive complexity. */
750
- function spawnAndRegister(config, prompt, hasImageAttachments, useStreamJson, runningProcesses, perfStart) {
751
- const mcpConfigPath = generateMcpConfig(config.workingDir, config.verbose);
752
- if (!mcpConfigPath && config.outputCallback) {
753
- 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');
754
- }
755
- const args = buildClaudeArgs(config, prompt, hasImageAttachments, useStreamJson, mcpConfigPath);
756
- verboseLog(config.verbose, `[PERF] About to spawn: ${Date.now() - perfStart}ms`, `[PERF] Command: ${config.claudeCommand} ${args.join(' ')}`);
757
- const baseEnv = config.sandboxed
758
- ? sanitizeEnvForSandbox(process.env, config.workingDir)
759
- : { ...process.env };
760
- const spawnEnv = config.extraEnv
761
- ? { ...baseEnv, ...config.extraEnv }
762
- : baseEnv;
763
- const claudeProcess = spawn(config.claudeCommand, args, {
764
- cwd: config.workingDir,
765
- detached: true,
766
- env: spawnEnv,
767
- stdio: [hasImageAttachments ? 'pipe' : 'ignore', 'pipe', 'pipe']
768
- });
769
- if (hasImageAttachments && claudeProcess.stdin) {
770
- writeImageAttachmentsToStdin(claudeProcess, prompt, config);
771
- }
772
- if (claudeProcess.pid) {
773
- runningProcesses.set(claudeProcess.pid, claudeProcess);
774
- }
775
- verboseLog(config.verbose, `[PERF] Spawned: ${Date.now() - perfStart}ms`);
776
- return claudeProcess;
777
- }
778
- /**
779
- * Execute a Claude CLI command for a single movement
780
- * 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.
781
12
  */
782
13
  export async function executeClaudeCommand(prompt, _movementId, _sessionNumber, options) {
783
14
  const { config, runningProcesses } = options;
784
15
  const perfStart = Date.now();
785
- verboseLog(config.verbose, `[PERF] executeMovement started`);
16
+ verboseLog(config.verbose, '[PERF] executeMovement started');
786
17
  const hasImageAttachments = config.imageAttachments && config.imageAttachments.length > 0;
787
18
  const useStreamJson = hasImageAttachments || config.thinkingCallback || config.outputCallback || config.toolUseCallback;
788
19
  const claudeProcess = spawnAndRegister(config, prompt, !!hasImageAttachments, !!useStreamJson, runningProcesses, perfStart);
@@ -792,8 +23,6 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
792
23
  let firstStdoutReceived = false;
793
24
  let errorAlreadySurfaced = false;
794
25
  const sessionCapture = {};
795
- // Activate resume assessment buffering when resuming a session.
796
- // Text is held until thinking/tool activity confirms Claude has context.
797
26
  const isResumeMode = !!(config.continueSession && config.claudeSessionId);
798
27
  const ctx = {
799
28
  config,
@@ -808,7 +37,6 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
808
37
  currentStepOutputTokens: 0,
809
38
  lastTokenActivityTime: Date.now(),
810
39
  };
811
- // Stall detection state (mutable object shared with runStallCheckTick)
812
40
  const stallState = {
813
41
  lastActivityTime: Date.now(),
814
42
  stallWarningEmitted: false,
@@ -817,16 +45,13 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
817
45
  currentKillDeadline: Date.now() + (config.stallKillMs ?? 1_800_000),
818
46
  nextWarningAfter: 0,
819
47
  };
820
- // Tool activity tracking for stall assessment context
821
48
  const toolTracking = setupToolTracking(config, stallState, ctx, sessionCapture, prompt, perfStart);
822
49
  const { pendingTools, watchdog, toolWatchdogActive } = toolTracking;
823
- // Mutable counters accessed by stall check tick
824
50
  const toolCounters = toolTracking.counters;
825
51
  claudeProcess.stdout.on('data', (data) => {
826
52
  stallState.lastActivityTime = Date.now();
827
53
  stallState.stallWarningEmitted = false;
828
- stallState.nextWarningAfter = 0; // Real activity resets throttle
829
- // Push kill deadline forward on any activity
54
+ stallState.nextWarningAfter = 0;
830
55
  const killMs = config.stallKillMs ?? 1_800_000;
831
56
  stallState.currentKillDeadline = Date.now() + killMs;
832
57
  if (!firstStdoutReceived) {
@@ -866,7 +91,6 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
866
91
  claudeProcess, stallCheckInterval, config, lastTokenActivityTime: ctx.lastTokenActivityTime,
867
92
  });
868
93
  }, 10_000);
869
- // Wire up the kill context now that stallCheckInterval exists
870
94
  toolTracking.setKillContext(claudeProcess, stallCheckInterval);
871
95
  return new Promise((resolve, reject) => {
872
96
  claudeProcess.on('close', async (code, signal) => {
@@ -886,25 +110,4 @@ export async function executeClaudeCommand(prompt, _movementId, _sessionNumber,
886
110
  });
887
111
  });
888
112
  }
889
- function buildCloseResult(ctx, stdout, stderr, code, signal, sessionCapture) {
890
- const postTimeout = flushNativeTimeoutBuffers(ctx);
891
- const resumeBuffered = ctx.resumeAssessmentActive ? (ctx.resumeAssessmentBuffer || undefined) : undefined;
892
- const exitCode = code ?? (signal ? 128 + (signalToNumber(signal) ?? 0) : 0);
893
- const hasTokenUsage = ctx.apiTokenUsage.inputTokens > 0 || ctx.apiTokenUsage.outputTokens > 0;
894
- return {
895
- output: stdout,
896
- error: stderr || undefined,
897
- exitCode,
898
- signalName: signal || undefined,
899
- assistantResponse: ctx.accumulatedAssistantResponse || undefined,
900
- thinkingOutput: ctx.accumulatedThinking || undefined,
901
- toolUseHistory: ctx.accumulatedToolUse.length > 0 ? ctx.accumulatedToolUse : undefined,
902
- claudeSessionId: sessionCapture.claudeSessionId,
903
- nativeTimeoutCount: ctx.nativeTimeoutDetector.timeoutCount || undefined,
904
- postTimeoutOutput: postTimeout,
905
- resumeBufferedOutput: resumeBuffered,
906
- apiTokenUsage: hasTokenUsage ? { ...ctx.apiTokenUsage } : undefined,
907
- stopReason: ctx.stopReason,
908
- };
909
- }
910
113
  //# sourceMappingURL=claude-invoker.js.map