@minionry/minion 0.7.36

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 (476) hide show
  1. package/LICENSE +14 -0
  2. package/PRIVACY.md +357 -0
  3. package/README.md +57 -0
  4. package/THIRD_PARTY_NOTICES.md +245 -0
  5. package/bin/branding.js +4 -0
  6. package/bin/commands/browser-install.js +483 -0
  7. package/bin/commands/create-sandbox.js +542 -0
  8. package/bin/commands/fingerprint.js +101 -0
  9. package/bin/commands/login.js +400 -0
  10. package/bin/commands/logout.js +93 -0
  11. package/bin/commands/minions.js +211 -0
  12. package/bin/commands/sandboxes.js +309 -0
  13. package/bin/commands/status.js +298 -0
  14. package/bin/commands/whoami.js +153 -0
  15. package/bin/launch-env.js +35 -0
  16. package/bin/machine-identity.js +221 -0
  17. package/bin/machine-layout.js +200 -0
  18. package/bin/minion.js +839 -0
  19. package/bin/platform-endpoints.js +8 -0
  20. package/bin/postinstall.js +52 -0
  21. package/bin/pty-doctor.js +326 -0
  22. package/bin/pty-locator.js +110 -0
  23. package/bin/pty-provision.js +186 -0
  24. package/bin/sandbox/Dockerfile +78 -0
  25. package/bin/sandbox/entrypoint.sh +14 -0
  26. package/bin/sandbox/install-repo.sh +53 -0
  27. package/bin/sandbox/seccomp-userns.json +883 -0
  28. package/bin/sandbox-config.js +306 -0
  29. package/dist/bin/machine-identity.js +221 -0
  30. package/dist/bin/machine-layout.js +200 -0
  31. package/dist/electron-host/agent-lease.js +141 -0
  32. package/dist/electron-host/dom-driver.js +642 -0
  33. package/dist/electron-host/ipc-protocol.js +89 -0
  34. package/dist/electron-host/js-driver.js +216 -0
  35. package/dist/electron-host/view-manager.js +254 -0
  36. package/dist/server/cli/engine-resume.js +49 -0
  37. package/dist/server/cli/eta-estimator.js +278 -0
  38. package/dist/server/cli/headless/background-activity.js +109 -0
  39. package/dist/server/cli/headless/claude-invoker-process.js +614 -0
  40. package/dist/server/cli/headless/claude-invoker-stall.js +150 -0
  41. package/dist/server/cli/headless/claude-invoker-stream.js +555 -0
  42. package/dist/server/cli/headless/claude-invoker-tools.js +148 -0
  43. package/dist/server/cli/headless/claude-invoker.js +151 -0
  44. package/dist/server/cli/headless/engine-availability.js +92 -0
  45. package/dist/server/cli/headless/engine-notice.js +185 -0
  46. package/dist/server/cli/headless/haiku-assessments.js +293 -0
  47. package/dist/server/cli/headless/headless-logger.js +75 -0
  48. package/dist/server/cli/headless/index.js +9 -0
  49. package/dist/server/cli/headless/mcp-config.js +314 -0
  50. package/dist/server/cli/headless/native-timeout-detector.js +72 -0
  51. package/dist/server/cli/headless/output-utils.js +71 -0
  52. package/dist/server/cli/headless/prompt-utils.js +82 -0
  53. package/dist/server/cli/headless/resilient-runner.js +326 -0
  54. package/dist/server/cli/headless/retry-strategies.js +292 -0
  55. package/dist/server/cli/headless/runner.js +245 -0
  56. package/dist/server/cli/headless/stall-assessor.js +295 -0
  57. package/dist/server/cli/headless/tool-watchdog.js +447 -0
  58. package/dist/server/cli/headless/types.js +18 -0
  59. package/dist/server/cli/history-portability.js +85 -0
  60. package/dist/server/cli/improvisation-attachments.js +99 -0
  61. package/dist/server/cli/improvisation-history-store.js +121 -0
  62. package/dist/server/cli/improvisation-movements.js +137 -0
  63. package/dist/server/cli/improvisation-output-queue.js +34 -0
  64. package/dist/server/cli/improvisation-retry.js +8 -0
  65. package/dist/server/cli/improvisation-session-manager.js +1016 -0
  66. package/dist/server/cli/improvisation-types.js +31 -0
  67. package/dist/server/cli/plan-lifecycle.js +72 -0
  68. package/dist/server/cli/prompt-builders.js +371 -0
  69. package/dist/server/cli/retry/retry-best-result.js +28 -0
  70. package/dist/server/cli/retry/retry-context-loss.js +75 -0
  71. package/dist/server/cli/retry/retry-recovery-strategies.js +213 -0
  72. package/dist/server/cli/retry/retry-resume-strategy.js +20 -0
  73. package/dist/server/cli/retry/retry-runner-factory.js +92 -0
  74. package/dist/server/cli/retry/retry-tool-results.js +22 -0
  75. package/dist/server/cli/retry/retry-types.js +3 -0
  76. package/dist/server/engines/EngineEvent.js +57 -0
  77. package/dist/server/engines/claude/ClaudeCodeEngine.js +316 -0
  78. package/dist/server/engines/claude/claude-command.js +32 -0
  79. package/dist/server/engines/codex/CodexEngine.js +469 -0
  80. package/dist/server/engines/codex/codex-auth.js +203 -0
  81. package/dist/server/engines/codex/codex-invoker.js +205 -0
  82. package/dist/server/engines/codex/codex-provision.js +215 -0
  83. package/dist/server/engines/credentials/credential-probe.js +88 -0
  84. package/dist/server/engines/credentials/model-profiles.js +249 -0
  85. package/dist/server/engines/credentials/provider-credentials.js +146 -0
  86. package/dist/server/engines/engine-event-stream.js +52 -0
  87. package/dist/server/engines/execution/engine-session.js +380 -0
  88. package/dist/server/engines/factory.js +42 -0
  89. package/dist/server/engines/hermes/HermesEngine.js +628 -0
  90. package/dist/server/engines/hermes/hermes-auth.js +159 -0
  91. package/dist/server/engines/hermes/hermes-gateway-home.js +271 -0
  92. package/dist/server/engines/hermes/hermes-invoker.js +350 -0
  93. package/dist/server/engines/hermes/hermes-provision.js +318 -0
  94. package/dist/server/engines/read-only.js +20 -0
  95. package/dist/server/engines/types.js +27 -0
  96. package/dist/server/handlers/company-execution-registry.js +67 -0
  97. package/dist/server/handlers/company-handlers.js +514 -0
  98. package/dist/server/handlers/company-triggers.js +189 -0
  99. package/dist/server/handlers/company-types.js +3 -0
  100. package/dist/server/index.js +244 -0
  101. package/dist/server/mcp/app-tools-bridge.js +110 -0
  102. package/dist/server/mcp/app-tools-mcp-server.js +99 -0
  103. package/dist/server/mcp/bouncer-integration.js +744 -0
  104. package/dist/server/mcp/browser-mcp-server.js +915 -0
  105. package/dist/server/mcp/browser-redaction.js +103 -0
  106. package/dist/server/mcp/classifier/BouncerClassifier.js +3 -0
  107. package/dist/server/mcp/classifier/ClaudeBouncerClassifier.js +212 -0
  108. package/dist/server/mcp/classifier/factory.js +124 -0
  109. package/dist/server/mcp/classifier/health.js +54 -0
  110. package/dist/server/mcp/classifier/telemetry.js +0 -0
  111. package/dist/server/mcp/company-patterns.js +104 -0
  112. package/dist/server/mcp/department-profiles.js +133 -0
  113. package/dist/server/mcp/quality-bridge.js +153 -0
  114. package/dist/server/mcp/quality-mcp-server.js +105 -0
  115. package/dist/server/mcp/security-analysis.js +384 -0
  116. package/dist/server/mcp/security-audit.js +152 -0
  117. package/dist/server/mcp/security-patterns.js +314 -0
  118. package/dist/server/mcp/server.js +194 -0
  119. package/dist/server/mcp/test-utils/agent-simulator.js +301 -0
  120. package/dist/server/mcp/test-utils/e2e-agent.js +103 -0
  121. package/dist/server/mcp/test-utils/e2e-capture.js +92 -0
  122. package/dist/server/mcp/test-utils/e2e-client.js +116 -0
  123. package/dist/server/mcp/test-utils/e2e-fixtures.js +87 -0
  124. package/dist/server/mcp/test-utils/e2e-gating.js +8 -0
  125. package/dist/server/mcp/test-utils/e2e-harness.js +8 -0
  126. package/dist/server/mcp/test-utils/e2e-scenarios.js +105 -0
  127. package/dist/server/routes/files.js +18 -0
  128. package/dist/server/routes/improvise.js +64 -0
  129. package/dist/server/routes/index.js +7 -0
  130. package/dist/server/routes/instances.js +41 -0
  131. package/dist/server/routes/internal.js +900 -0
  132. package/dist/server/routes/notifications.js +110 -0
  133. package/dist/server/server-setup.js +282 -0
  134. package/dist/server/services/agent-push.js +148 -0
  135. package/dist/server/services/analytics.js +197 -0
  136. package/dist/server/services/apps/build.js +249 -0
  137. package/dist/server/services/apps/greenlight.js +199 -0
  138. package/dist/server/services/apps/install.js +101 -0
  139. package/dist/server/services/apps/layout.js +35 -0
  140. package/dist/server/services/apps/serve.js +665 -0
  141. package/dist/server/services/apps/space-apps.js +248 -0
  142. package/dist/server/services/auth.js +48 -0
  143. package/dist/server/services/browser/chrome-sandbox.js +245 -0
  144. package/dist/server/services/browser/chromium-launch-spec.js +51 -0
  145. package/dist/server/services/browser/claude-reasoner.js +669 -0
  146. package/dist/server/services/browser/debug-log.js +3 -0
  147. package/dist/server/services/browser/driver-state.js +546 -0
  148. package/dist/server/services/browser/electron-provision.js +256 -0
  149. package/dist/server/services/browser/host-internal.js +245 -0
  150. package/dist/server/services/browser/host-mock.js +334 -0
  151. package/dist/server/services/browser/host-types.js +3 -0
  152. package/dist/server/services/browser/host.js +1067 -0
  153. package/dist/server/services/browser/index.js +4 -0
  154. package/dist/server/services/browser/ipc-client.js +354 -0
  155. package/dist/server/services/browser/pipewire-sink.js +199 -0
  156. package/dist/server/services/browser/preflight.js +590 -0
  157. package/dist/server/services/browser/reasoning-agent.js +659 -0
  158. package/dist/server/services/browser/sandbox-policy.js +169 -0
  159. package/dist/server/services/browser/stderr-noise-filter.js +26 -0
  160. package/dist/server/services/browser/telemetry.js +107 -0
  161. package/dist/server/services/browser/xvfb-supervisor.js +139 -0
  162. package/dist/server/services/browser-frame-policy.js +56 -0
  163. package/dist/server/services/client-id.js +32 -0
  164. package/dist/server/services/collab/registry.js +408 -0
  165. package/dist/server/services/collab/session.js +489 -0
  166. package/dist/server/services/collab/text-diff.js +28 -0
  167. package/dist/server/services/collab/types.js +19 -0
  168. package/dist/server/services/e2ee-group-key.js +197 -0
  169. package/dist/server/services/e2ee-identity.js +203 -0
  170. package/dist/server/services/file-explorer-ops.js +328 -0
  171. package/dist/server/services/file-transfer-zip.js +188 -0
  172. package/dist/server/services/files.js +111 -0
  173. package/dist/server/services/git/branch-ops.js +62 -0
  174. package/dist/server/services/git/command.js +68 -0
  175. package/dist/server/services/git/commit-message.js +74 -0
  176. package/dist/server/services/git/diff-ops.js +56 -0
  177. package/dist/server/services/git/haiku.js +76 -0
  178. package/dist/server/services/git/head-watcher.js +226 -0
  179. package/dist/server/services/git/index.js +17 -0
  180. package/dist/server/services/git/log-ops.js +98 -0
  181. package/dist/server/services/git/merge-ops.js +314 -0
  182. package/dist/server/services/git/parsers.js +401 -0
  183. package/dist/server/services/git/remote-ops.js +192 -0
  184. package/dist/server/services/git/status-ops.js +105 -0
  185. package/dist/server/services/git/suggestion-ops.js +80 -0
  186. package/dist/server/services/git/tag-ops.js +36 -0
  187. package/dist/server/services/git/types.js +4 -0
  188. package/dist/server/services/git/worktree-ops.js +114 -0
  189. package/dist/server/services/instances.js +337 -0
  190. package/dist/server/services/model-catalog.js +247 -0
  191. package/dist/server/services/observability/posthog.js +153 -0
  192. package/dist/server/services/pathUtils.js +114 -0
  193. package/dist/server/services/plan/agent-loader.js +97 -0
  194. package/dist/server/services/plan/agent-manager.js +363 -0
  195. package/dist/server/services/plan/agent-resolver.js +74 -0
  196. package/dist/server/services/plan/agents/assess-stall.md +33 -0
  197. package/dist/server/services/plan/agents/browser-planner.md +53 -0
  198. package/dist/server/services/plan/agents/browser-reasoner.md +114 -0
  199. package/dist/server/services/plan/agents/check-injection.md +95 -0
  200. package/dist/server/services/plan/agents/classify-error.md +30 -0
  201. package/dist/server/services/plan/agents/code-review.md +142 -0
  202. package/dist/server/services/plan/agents/commit-message.md +28 -0
  203. package/dist/server/services/plan/agents/detect-context-loss.md +30 -0
  204. package/dist/server/services/plan/agents/execute-issue.md +58 -0
  205. package/dist/server/services/plan/agents/fix-quality.md +25 -0
  206. package/dist/server/services/plan/agents/plan-coordinator.md +72 -0
  207. package/dist/server/services/plan/agents/pr-description.md +29 -0
  208. package/dist/server/services/plan/agents/retry-task.md +27 -0
  209. package/dist/server/services/plan/agents/review-code.md +38 -0
  210. package/dist/server/services/plan/agents/review-quality.md +45 -0
  211. package/dist/server/services/plan/agents/triage-findings.md +78 -0
  212. package/dist/server/services/plan/agents/verify-review.md +57 -0
  213. package/dist/server/services/plan/approval-evaluator.js +143 -0
  214. package/dist/server/services/plan/board-archive.js +102 -0
  215. package/dist/server/services/plan/board-config.js +108 -0
  216. package/dist/server/services/plan/board-export.js +214 -0
  217. package/dist/server/services/plan/composer-prompt.js +115 -0
  218. package/dist/server/services/plan/composer.js +664 -0
  219. package/dist/server/services/plan/config-installer.js +103 -0
  220. package/dist/server/services/plan/dependency-resolver.js +137 -0
  221. package/dist/server/services/plan/executor.js +696 -0
  222. package/dist/server/services/plan/front-matter.js +43 -0
  223. package/dist/server/services/plan/issue-classification.js +10 -0
  224. package/dist/server/services/plan/issue-effort.js +182 -0
  225. package/dist/server/services/plan/issue-loader.js +35 -0
  226. package/dist/server/services/plan/issue-prompt-builder.js +152 -0
  227. package/dist/server/services/plan/issue-retry.js +42 -0
  228. package/dist/server/services/plan/issue-writer.js +102 -0
  229. package/dist/server/services/plan/metrics-collector.js +272 -0
  230. package/dist/server/services/plan/output-manager.js +77 -0
  231. package/dist/server/services/plan/parser-core.js +435 -0
  232. package/dist/server/services/plan/parser-migration.js +108 -0
  233. package/dist/server/services/plan/parser.js +258 -0
  234. package/dist/server/services/plan/plan-runner-factory.js +68 -0
  235. package/dist/server/services/plan/pm-timeline.js +320 -0
  236. package/dist/server/services/plan/progress-log.js +101 -0
  237. package/dist/server/services/plan/prompt-builder.js +142 -0
  238. package/dist/server/services/plan/quality-delta.js +274 -0
  239. package/dist/server/services/plan/readiness-planner.js +34 -0
  240. package/dist/server/services/plan/review-gate.js +409 -0
  241. package/dist/server/services/plan/review-report.js +134 -0
  242. package/dist/server/services/plan/review-verdict-stream.js +161 -0
  243. package/dist/server/services/plan/state-reconciler.js +238 -0
  244. package/dist/server/services/plan/template-diff.js +175 -0
  245. package/dist/server/services/plan/template-instantiator.js +516 -0
  246. package/dist/server/services/plan/template-manifest.js +56 -0
  247. package/dist/server/services/plan/template-types.js +3 -0
  248. package/dist/server/services/plan/trigger-evaluator.js +211 -0
  249. package/dist/server/services/plan/types.js +3 -0
  250. package/dist/server/services/plan/watcher.js +73 -0
  251. package/dist/server/services/platform-credentials.js +56 -0
  252. package/dist/server/services/platform-e2ee.js +421 -0
  253. package/dist/server/services/platform-envelope.js +102 -0
  254. package/dist/server/services/platform-heartbeat.js +88 -0
  255. package/dist/server/services/platform-reconnect.js +60 -0
  256. package/dist/server/services/platform-token-lifecycle.js +95 -0
  257. package/dist/server/services/platform-url.js +17 -0
  258. package/dist/server/services/platform.js +656 -0
  259. package/dist/server/services/runtime-info.js +9 -0
  260. package/dist/server/services/schedule/agent-schedule-store.js +232 -0
  261. package/dist/server/services/schedule/agent-scheduler.js +323 -0
  262. package/dist/server/services/schedule/daily-timing.js +105 -0
  263. package/dist/server/services/schedule/quality-schedule-launch.js +11 -0
  264. package/dist/server/services/schedule/quality-schedule-store.js +211 -0
  265. package/dist/server/services/schedule/quality-scheduler.js +215 -0
  266. package/dist/server/services/schedule/run-bootstrap.js +329 -0
  267. package/dist/server/services/schedule/schedule-store.js +238 -0
  268. package/dist/server/services/schedule/schedule-wire.js +77 -0
  269. package/dist/server/services/schedule/scheduler.js +310 -0
  270. package/dist/server/services/schedule/template-source.js +97 -0
  271. package/dist/server/services/sdk/agent-sessions.js +264 -0
  272. package/dist/server/services/sdk/agents.js +557 -0
  273. package/dist/server/services/sdk/app-endpoints.js +48 -0
  274. package/dist/server/services/sdk/app-tools.js +303 -0
  275. package/dist/server/services/sdk/audit.js +48 -0
  276. package/dist/server/services/sdk/browser-transport.js +188 -0
  277. package/dist/server/services/sdk/browser.js +605 -0
  278. package/dist/server/services/sdk/composer.js +129 -0
  279. package/dist/server/services/sdk/connect.js +273 -0
  280. package/dist/server/services/sdk/consent-cooldown.js +31 -0
  281. package/dist/server/services/sdk/endpoint-url.js +141 -0
  282. package/dist/server/services/sdk/endpoints.js +314 -0
  283. package/dist/server/services/sdk/file-change-notify.js +36 -0
  284. package/dist/server/services/sdk/files-app.js +163 -0
  285. package/dist/server/services/sdk/files-search.js +131 -0
  286. package/dist/server/services/sdk/files-transfer.js +279 -0
  287. package/dist/server/services/sdk/files-workspace.js +233 -0
  288. package/dist/server/services/sdk/git.js +520 -0
  289. package/dist/server/services/sdk/grant-store.js +318 -0
  290. package/dist/server/services/sdk/host-ops.js +84 -0
  291. package/dist/server/services/sdk/inference-claude.js +214 -0
  292. package/dist/server/services/sdk/inference.js +247 -0
  293. package/dist/server/services/sdk/live-registry.js +42 -0
  294. package/dist/server/services/sdk/local-app-bindings.js +71 -0
  295. package/dist/server/services/sdk/pipeline.js +190 -0
  296. package/dist/server/services/sdk/pm-execute.js +228 -0
  297. package/dist/server/services/sdk/pm-planning-tap.js +29 -0
  298. package/dist/server/services/sdk/pm-schedule.js +165 -0
  299. package/dist/server/services/sdk/pm.js +634 -0
  300. package/dist/server/services/sdk/quality-change-notify.js +20 -0
  301. package/dist/server/services/sdk/quality-schedule.js +165 -0
  302. package/dist/server/services/sdk/quality.js +602 -0
  303. package/dist/server/services/sdk/rate-limits.js +198 -0
  304. package/dist/server/services/sdk/registry.js +597 -0
  305. package/dist/server/services/sdk/revoke.js +86 -0
  306. package/dist/server/services/sdk/run-profile.js +41 -0
  307. package/dist/server/services/sdk/sandbox.js +89 -0
  308. package/dist/server/services/sdk/storage.js +110 -0
  309. package/dist/server/services/sdk/streams.js +147 -0
  310. package/dist/server/services/sdk/terminal.js +201 -0
  311. package/dist/server/services/sdk/test-utils/workshop-browser-app.js +466 -0
  312. package/dist/server/services/sentry.js +99 -0
  313. package/dist/server/services/settings.js +374 -0
  314. package/dist/server/services/snippets/expander.js +87 -0
  315. package/dist/server/services/snippets/index.js +6 -0
  316. package/dist/server/services/snippets/loader.js +119 -0
  317. package/dist/server/services/snippets/parser.js +52 -0
  318. package/dist/server/services/snippets/types.js +3 -0
  319. package/dist/server/services/snippets/watcher.js +60 -0
  320. package/dist/server/services/space-layout.js +80 -0
  321. package/dist/server/services/system-prompts.js +219 -0
  322. package/dist/server/services/terminal/pty-manager.js +206 -0
  323. package/dist/server/services/terminal/pty-utils.js +150 -0
  324. package/dist/server/services/timeline/assembler.js +890 -0
  325. package/dist/server/services/timeline/contract.js +196 -0
  326. package/dist/server/services/timeline/index.js +4 -0
  327. package/dist/server/services/websocket/agent-schedule-handlers.js +217 -0
  328. package/dist/server/services/websocket/apps-handlers.js +399 -0
  329. package/dist/server/services/websocket/ask-user-question-bridge.js +112 -0
  330. package/dist/server/services/websocket/autocomplete-index.js +415 -0
  331. package/dist/server/services/websocket/autocomplete-match.js +243 -0
  332. package/dist/server/services/websocket/autocomplete.js +407 -0
  333. package/dist/server/services/websocket/browser-agent-runtime.js +208 -0
  334. package/dist/server/services/websocket/browser-device-profile.js +46 -0
  335. package/dist/server/services/websocket/browser-handlers.js +377 -0
  336. package/dist/server/services/websocket/browser-host-broadcast.js +179 -0
  337. package/dist/server/services/websocket/browser-ice-config.js +121 -0
  338. package/dist/server/services/websocket/browser-payloads.js +222 -0
  339. package/dist/server/services/websocket/browser-viewer-lifecycle.js +84 -0
  340. package/dist/server/services/websocket/browser-viewer-registry.js +118 -0
  341. package/dist/server/services/websocket/collab-broadcast.js +11 -0
  342. package/dist/server/services/websocket/collab-handlers.js +116 -0
  343. package/dist/server/services/websocket/commit-suggestion-service.js +132 -0
  344. package/dist/server/services/websocket/debug-log.js +38 -0
  345. package/dist/server/services/websocket/dispatch-util.js +10 -0
  346. package/dist/server/services/websocket/engine-auth-handlers.js +323 -0
  347. package/dist/server/services/websocket/engine-credential-watcher.js +83 -0
  348. package/dist/server/services/websocket/engine-profile-handlers.js +92 -0
  349. package/dist/server/services/websocket/file-definition-handlers.js +180 -0
  350. package/dist/server/services/websocket/file-download-handler.js +291 -0
  351. package/dist/server/services/websocket/file-explorer-handlers.js +291 -0
  352. package/dist/server/services/websocket/file-search-handlers.js +267 -0
  353. package/dist/server/services/websocket/file-share-handlers.js +328 -0
  354. package/dist/server/services/websocket/file-transfer-http.js +361 -0
  355. package/dist/server/services/websocket/file-upload-handler.js +267 -0
  356. package/dist/server/services/websocket/file-utils.js +346 -0
  357. package/dist/server/services/websocket/git-branch-handlers.js +90 -0
  358. package/dist/server/services/websocket/git-diff-handlers.js +59 -0
  359. package/dist/server/services/websocket/git-handlers.js +212 -0
  360. package/dist/server/services/websocket/git-head-watcher.js +85 -0
  361. package/dist/server/services/websocket/git-log-handlers.js +104 -0
  362. package/dist/server/services/websocket/git-pr-handlers.js +56 -0
  363. package/dist/server/services/websocket/git-tag-handlers.js +53 -0
  364. package/dist/server/services/websocket/git-utils.js +11 -0
  365. package/dist/server/services/websocket/git-worktree-handlers.js +521 -0
  366. package/dist/server/services/websocket/handler-context.js +113 -0
  367. package/dist/server/services/websocket/handler.js +1197 -0
  368. package/dist/server/services/websocket/index.js +5 -0
  369. package/dist/server/services/websocket/movement-written-files.js +26 -0
  370. package/dist/server/services/websocket/msg-id-tracker.js +48 -0
  371. package/dist/server/services/websocket/plan-board-handlers.js +410 -0
  372. package/dist/server/services/websocket/plan-execution-handlers.js +244 -0
  373. package/dist/server/services/websocket/plan-handlers.js +67 -0
  374. package/dist/server/services/websocket/plan-helpers.js +161 -0
  375. package/dist/server/services/websocket/plan-issue-handlers.js +168 -0
  376. package/dist/server/services/websocket/plan-sprint-handlers.js +190 -0
  377. package/dist/server/services/websocket/plan-transfer-handlers.js +310 -0
  378. package/dist/server/services/websocket/pm-timeline-broadcast.js +28 -0
  379. package/dist/server/services/websocket/post-session-scan.js +132 -0
  380. package/dist/server/services/websocket/prompt-queue-handlers.js +96 -0
  381. package/dist/server/services/websocket/quality-agent-cost.js +229 -0
  382. package/dist/server/services/websocket/quality-agent-notes.js +113 -0
  383. package/dist/server/services/websocket/quality-change-activity.js +187 -0
  384. package/dist/server/services/websocket/quality-complexity.js +345 -0
  385. package/dist/server/services/websocket/quality-dependencies.js +445 -0
  386. package/dist/server/services/websocket/quality-duplication.js +162 -0
  387. package/dist/server/services/websocket/quality-eta.js +65 -0
  388. package/dist/server/services/websocket/quality-fingerprint.js +104 -0
  389. package/dist/server/services/websocket/quality-grading.js +575 -0
  390. package/dist/server/services/websocket/quality-handlers.js +48 -0
  391. package/dist/server/services/websocket/quality-linting.js +270 -0
  392. package/dist/server/services/websocket/quality-operations.js +54 -0
  393. package/dist/server/services/websocket/quality-persistence.js +410 -0
  394. package/dist/server/services/websocket/quality-review-agent.js +526 -0
  395. package/dist/server/services/websocket/quality-run.js +220 -0
  396. package/dist/server/services/websocket/quality-secrets.js +0 -0
  397. package/dist/server/services/websocket/quality-service.js +775 -0
  398. package/dist/server/services/websocket/quality-tools.js +383 -0
  399. package/dist/server/services/websocket/quality-triage-agent.js +101 -0
  400. package/dist/server/services/websocket/quality-types.js +149 -0
  401. package/dist/server/services/websocket/recommended-answers.js +28 -0
  402. package/dist/server/services/websocket/schedule-handlers.js +197 -0
  403. package/dist/server/services/websocket/sdk-agent-host.js +569 -0
  404. package/dist/server/services/websocket/sdk-browser-host.js +459 -0
  405. package/dist/server/services/websocket/sdk-composer-host.js +10 -0
  406. package/dist/server/services/websocket/sdk-git-host.js +115 -0
  407. package/dist/server/services/websocket/sdk-handlers.js +242 -0
  408. package/dist/server/services/websocket/sdk-pm-execution-host.js +63 -0
  409. package/dist/server/services/websocket/sdk-pm-schedule-host.js +21 -0
  410. package/dist/server/services/websocket/sdk-quality-schedule-host.js +34 -0
  411. package/dist/server/services/websocket/sdk-terminal-host.js +140 -0
  412. package/dist/server/services/websocket/session-handlers.js +565 -0
  413. package/dist/server/services/websocket/session-history.js +335 -0
  414. package/dist/server/services/websocket/session-initialization.js +315 -0
  415. package/dist/server/services/websocket/session-registry.js +340 -0
  416. package/dist/server/services/websocket/session-role-directory.js +39 -0
  417. package/dist/server/services/websocket/settings-handlers.js +276 -0
  418. package/dist/server/services/websocket/skill-handlers.js +324 -0
  419. package/dist/server/services/websocket/skill-watcher.js +83 -0
  420. package/dist/server/services/websocket/snippet-handlers.js +261 -0
  421. package/dist/server/services/websocket/tab-broadcast.js +35 -0
  422. package/dist/server/services/websocket/tab-event-buffer.js +110 -0
  423. package/dist/server/services/websocket/tab-event-replay.js +47 -0
  424. package/dist/server/services/websocket/tab-handlers.js +211 -0
  425. package/dist/server/services/websocket/terminal-handlers.js +268 -0
  426. package/dist/server/services/websocket/types.js +96 -0
  427. package/dist/server/types/company-messages.js +102 -0
  428. package/dist/server/utils/agent-manager.js +202 -0
  429. package/dist/server/utils/console-timestamps.js +24 -0
  430. package/dist/server/utils/file-store.js +112 -0
  431. package/dist/server/utils/paths.js +28 -0
  432. package/dist/server/utils/port-manager.js +43 -0
  433. package/dist/server/utils/port.js +204 -0
  434. package/electron-host/dist/agent-lease.js +141 -0
  435. package/electron-host/dist/capture-recovery.js +77 -0
  436. package/electron-host/dist/codec-policy.js +37 -0
  437. package/electron-host/dist/controller-channel.js +60 -0
  438. package/electron-host/dist/controller-handlers.js +153 -0
  439. package/electron-host/dist/device-emulator.js +106 -0
  440. package/electron-host/dist/dom-driver.js +642 -0
  441. package/electron-host/dist/domain-registry.js +159 -0
  442. package/electron-host/dist/domain-validators.js +308 -0
  443. package/electron-host/dist/editable-focus-reporter.js +143 -0
  444. package/electron-host/dist/fake-peer.test-util.js +105 -0
  445. package/electron-host/dist/host-log.js +31 -0
  446. package/electron-host/dist/host-wire.js +11 -0
  447. package/electron-host/dist/input-router.js +421 -0
  448. package/electron-host/dist/ipc-protocol.js +89 -0
  449. package/electron-host/dist/ipc-server.js +193 -0
  450. package/electron-host/dist/js-driver.js +216 -0
  451. package/electron-host/dist/main-guards.js +70 -0
  452. package/electron-host/dist/main.js +716 -0
  453. package/electron-host/dist/roster-sync.js +87 -0
  454. package/electron-host/dist/rpc-context.js +1 -0
  455. package/electron-host/dist/rpc-tab-methods.js +138 -0
  456. package/electron-host/dist/rpc-webrtc-methods.js +121 -0
  457. package/electron-host/dist/screen-capture-cache.js +147 -0
  458. package/electron-host/dist/sdk-injector.js +166 -0
  459. package/electron-host/dist/sdp.js +102 -0
  460. package/electron-host/dist/session-surface.js +78 -0
  461. package/electron-host/dist/surface-sizing.js +59 -0
  462. package/electron-host/dist/view-manager.js +254 -0
  463. package/electron-host/dist/viewer-registry.js +46 -0
  464. package/electron-host/dist/viewer-session.js +288 -0
  465. package/electron-host/dist/webrtc-channels.js +14 -0
  466. package/electron-host/dist/webrtc-controller.js +57 -0
  467. package/electron-host/dist/webrtc-ice-filter.js +13 -0
  468. package/electron-host/dist/webrtc-peer.js +45 -0
  469. package/electron-host/package.json +12 -0
  470. package/electron-host/tsconfig.json +23 -0
  471. package/electron-host/webrtc-controller-preload.cjs +3 -0
  472. package/electron-host/webrtc-controller.html +14 -0
  473. package/package.json +85 -0
  474. package/vendor/e2ee/LICENSE +14 -0
  475. package/vendor/e2ee/package.json +14 -0
  476. package/vendor/e2ee/src/index.js +310 -0
@@ -0,0 +1,326 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ import { resolveClaudeCommand } from '../../engines/claude/claude-command.js';
4
+ import { runEngineOnce, shouldRouteToEngine } from '../../engines/execution/engine-session.js';
5
+ import { getEngine } from '../../services/settings.js';
6
+ import { hlog, runWithFileLogger } from './headless-logger.js';
7
+ import { isAgentBrowserSurfaceAvailable } from './mcp-config.js';
8
+ import { chooseBestAttempt, createRetryState, extractNoticeMarkers, isResponseAbandoned, isTerminalEngineNotice, pickPreferredResult, scoreResult, tryContextLoss, tryServerError, trySignalCrash, tryToolTimeout, } from './retry-strategies.js';
9
+ import { HeadlessRunner } from './runner.js';
10
+ export const RETRY_BACKOFF_MS = [1000, 5000, 30000];
11
+ function resolveRetryConfig(policy, verbose) {
12
+ switch (policy) {
13
+ case 'FULL':
14
+ return { enableContextLossDetection: true, enableBestResultSelection: true, verbose };
15
+ case 'STANDARD':
16
+ return { enableContextLossDetection: false, enableBestResultSelection: false, verbose };
17
+ case 'NONE':
18
+ return { enableContextLossDetection: false, enableBestResultSelection: false, verbose };
19
+ }
20
+ }
21
+ function wireAbortSignal(runner, abortSignal) {
22
+ if (!abortSignal)
23
+ return null;
24
+ const handler = () => { runner.cleanup(); };
25
+ abortSignal.addEventListener('abort', handler, { once: true });
26
+ return () => abortSignal.removeEventListener('abort', handler);
27
+ }
28
+ function abortedFallback(bestResult) {
29
+ return bestResult ?? {
30
+ completed: false,
31
+ needsHandoff: false,
32
+ totalTokens: 0,
33
+ sessionId: '',
34
+ error: 'Execution stopped by user',
35
+ };
36
+ }
37
+ function sleep(ms, abortSignal) {
38
+ if (ms <= 0 || abortSignal?.aborted)
39
+ return Promise.resolve();
40
+ return new Promise((resolve) => {
41
+ const timer = setTimeout(done, ms);
42
+ function done() {
43
+ clearTimeout(timer);
44
+ abortSignal?.removeEventListener('abort', done);
45
+ resolve();
46
+ }
47
+ abortSignal?.addEventListener('abort', done, { once: true });
48
+ });
49
+ }
50
+ export class ResilientRunner {
51
+ config;
52
+ notices = [];
53
+ retryLog = [];
54
+ attempts = 0;
55
+ assessments = [];
56
+ assessorFailed = false;
57
+ constructor(config) {
58
+ this.config = config;
59
+ }
60
+ get outputCallback() {
61
+ const inner = this.config.outputCallback;
62
+ return (text) => {
63
+ for (const marker of extractNoticeMarkers(text))
64
+ this.notices.push(marker);
65
+ inner?.(text);
66
+ };
67
+ }
68
+ decorate(result, isAutoContinue = false) {
69
+ return {
70
+ ...result,
71
+ ...(this.retryLog && this.retryLog.length > 0 ? { retryLog: [...this.retryLog] } : {}),
72
+ ...(this.notices.length > 0 ? { notices: [...this.notices] } : {}),
73
+ ...(this.assessments.length > 0 ? { assessments: [...this.assessments] } : {}),
74
+ ...(this.assessorFailed ? { assessorFailed: true } : {}),
75
+ ...(isAutoContinue ? { isAutoContinue: true } : {}),
76
+ attempts: this.attempts,
77
+ };
78
+ }
79
+ absorbState(state) {
80
+ this.assessments.push(...state.assessments);
81
+ if (state.assessorFailed)
82
+ this.assessorFailed = true;
83
+ }
84
+ async run() {
85
+ const { logLabel, logDir } = this.config;
86
+ if (logLabel) {
87
+ return runWithFileLogger(logLabel, () => this.execute(), logDir);
88
+ }
89
+ return this.execute();
90
+ }
91
+ async execute() {
92
+ const engineId = this.config.engineId ?? getEngine();
93
+ if (shouldRouteToEngine(engineId)) {
94
+ return this.runViaEngine(engineId);
95
+ }
96
+ const policy = this.config.policy ?? 'STANDARD';
97
+ const maxRetries = this.config.maxRetries ?? 3;
98
+ const verbose = this.config.verbose ?? true;
99
+ const maxAutoContinues = this.config.maxAutoContinues ?? (policy === 'NONE' ? 0 : 1);
100
+ const retryConfig = resolveRetryConfig(policy, verbose);
101
+ if (policy === 'NONE') {
102
+ return this.decorate(await this.runSingle(this.config.prompt, false, undefined));
103
+ }
104
+ const state = createRetryState(this.config.prompt, maxRetries);
105
+ const loopResult = await this.retryLoop(state, retryConfig, policy, maxRetries);
106
+ this.absorbState(state);
107
+ let result;
108
+ if (!this.config.abortSignal?.aborted &&
109
+ retryConfig.enableBestResultSelection && state.retryNumber > 0 && state.bestResult && loopResult) {
110
+ result = await this.selectBestResult(state.bestResult, loopResult, this.config.prompt);
111
+ }
112
+ else {
113
+ result = loopResult ?? abortedFallback(state.bestResult);
114
+ }
115
+ return this.autoContinue(result, retryConfig, policy, maxRetries, maxAutoContinues);
116
+ }
117
+ async runViaEngine(engineId) {
118
+ hlog(`[RESILIENT] engine=${engineId}: single-turn engine path (retry/stall policy bypassed)`);
119
+ return runEngineOnce({
120
+ engineId,
121
+ workingDir: this.config.workingDir,
122
+ prompt: this.config.prompt,
123
+ model: this.config.model,
124
+ effortLevel: this.config.effortLevel,
125
+ fastMode: this.config.fastMode,
126
+ imageAttachments: this.config.imageAttachments,
127
+ extraEnv: this.config.extraEnv,
128
+ disallowedTools: this.config.disallowedTools,
129
+ browserMcp: (await isAgentBrowserSurfaceAvailable()) ? this.config.browserMcp : undefined,
130
+ abortSignal: this.config.abortSignal,
131
+ callbacks: {
132
+ outputCallback: this.config.outputCallback,
133
+ thinkingCallback: this.config.thinkingCallback,
134
+ toolUseCallback: this.config.toolUseCallback,
135
+ tokenUsageCallback: this.config.tokenUsageCallback,
136
+ },
137
+ });
138
+ }
139
+ async retryLoop(state, retryConfig, policy, maxRetries, initialPrompt, initialResumeSessionId) {
140
+ let lastResult;
141
+ let currentPrompt = initialPrompt ?? this.config.prompt;
142
+ let resumeSessionId = initialResumeSessionId;
143
+ let useResume = !!initialResumeSessionId;
144
+ let attemptsInLoop = 0;
145
+ while (state.retryNumber <= maxRetries) {
146
+ if (this.config.abortSignal?.aborted)
147
+ return undefined;
148
+ await this.backoffBefore(attemptsInLoop);
149
+ if (this.config.abortSignal?.aborted)
150
+ return state.bestResult ?? lastResult;
151
+ attemptsInLoop++;
152
+ this.attempts++;
153
+ state.checkpoint = null;
154
+ state.lastUseResume = useResume;
155
+ const result = await this.runAttempt(currentPrompt, useResume, resumeSessionId, state);
156
+ if (this.config.abortSignal?.aborted)
157
+ return state.bestResult ?? result;
158
+ state.bestResult = state.bestResult ? pickPreferredResult(state.bestResult, result) : result;
159
+ lastResult = result;
160
+ const decision = await this.evaluateStrategies(result, state, retryConfig, policy);
161
+ if (!decision)
162
+ break;
163
+ state.checkpoint = null;
164
+ currentPrompt = decision.nextPrompt;
165
+ resumeSessionId = decision.resumeSessionId;
166
+ useResume = decision.useResume;
167
+ hlog(`[RESILIENT] Retry ${state.retryNumber}/${maxRetries}: ${decision.path} — ${decision.reason}`);
168
+ this.retryLog?.push({ retryNumber: state.retryNumber, path: decision.path, reason: decision.reason, timestamp: Date.now() });
169
+ this.config.onRetry?.({
170
+ retryNumber: state.retryNumber,
171
+ maxRetries,
172
+ path: decision.path,
173
+ reason: decision.reason,
174
+ });
175
+ }
176
+ return lastResult;
177
+ }
178
+ backoffBefore(attemptsInLoop) {
179
+ if (attemptsInLoop === 0)
180
+ return Promise.resolve();
181
+ const delay = RETRY_BACKOFF_MS[Math.min(attemptsInLoop - 1, RETRY_BACKOFF_MS.length - 1)];
182
+ return sleep(delay, this.config.abortSignal);
183
+ }
184
+ async runAttempt(prompt, useResume, resumeSessionId, state) {
185
+ const runner = this.createHeadlessRunner(prompt, useResume, resumeSessionId, state);
186
+ const removeAbortListener = wireAbortSignal(runner, this.config.abortSignal);
187
+ const result = await runner.run();
188
+ removeAbortListener?.();
189
+ return result;
190
+ }
191
+ createHeadlessRunner(prompt, continueSession, claudeSessionId, state) {
192
+ return new HeadlessRunner({
193
+ workingDir: this.config.workingDir,
194
+ directPrompt: prompt,
195
+ tabId: this.config.tabId,
196
+ stallWarningMs: this.config.stallWarningMs,
197
+ stallKillMs: this.config.stallKillMs,
198
+ stallHardCapMs: this.config.stallHardCapMs,
199
+ stallMaxExtensions: this.config.stallMaxExtensions,
200
+ verbose: this.config.verbose ?? true,
201
+ continueSession: continueSession || undefined,
202
+ claudeSessionId,
203
+ outputCallback: this.outputCallback,
204
+ thinkingCallback: this.config.thinkingCallback,
205
+ toolUseCallback: this.config.toolUseCallback,
206
+ tokenUsageCallback: this.config.tokenUsageCallback,
207
+ model: this.config.model,
208
+ effortLevel: this.config.effortLevel,
209
+ fastMode: this.config.fastMode,
210
+ extraEnv: this.config.extraEnv,
211
+ disallowedTools: this.config.disallowedTools,
212
+ inferenceOnly: this.config.inferenceOnly,
213
+ imageAttachments: this.config.imageAttachments,
214
+ appTools: this.config.appTools,
215
+ onBackgroundActivity: this.config.onBackgroundActivity,
216
+ onToolTimeout: (cp) => {
217
+ state.checkpoint = cp;
218
+ },
219
+ });
220
+ }
221
+ async evaluateStrategies(result, state, retryConfig, policy) {
222
+ if (isTerminalEngineNotice(result)) {
223
+ hlog(`[RESILIENT] No retry: engine notice (${result.engineNotice?.kind}) — ${result.engineNotice?.text.slice(0, 120)}`);
224
+ return null;
225
+ }
226
+ const serverError = tryServerError(result, state);
227
+ if (serverError)
228
+ return serverError;
229
+ const toolTimeout = tryToolTimeout(result, state);
230
+ if (toolTimeout)
231
+ return toolTimeout;
232
+ const signalCrash = trySignalCrash(result, state);
233
+ if (signalCrash)
234
+ return signalCrash;
235
+ if (policy === 'FULL') {
236
+ const contextLoss = await tryContextLoss(result, state, retryConfig);
237
+ if (contextLoss)
238
+ return contextLoss;
239
+ }
240
+ return null;
241
+ }
242
+ async selectBestResult(bestResult, finalResult, originalPrompt) {
243
+ if (bestResult === finalResult)
244
+ return finalResult;
245
+ const { chosen, assessment } = await chooseBestAttempt(bestResult, finalResult, originalPrompt, resolveClaudeCommand(), this.config.verbose ?? true);
246
+ this.assessments.push(assessment);
247
+ if (!assessment.assessed)
248
+ this.assessorFailed = true;
249
+ hlog(`[RESILIENT] Best result selection: ${assessment.verdict} — ${assessment.reason}`);
250
+ return chosen;
251
+ }
252
+ shouldAutoContinue(result) {
253
+ if (!result.claudeSessionId)
254
+ return false;
255
+ if (isTerminalEngineNotice(result) || result.startupTimedOut)
256
+ return false;
257
+ if (result.signalName || result.interrupted)
258
+ return true;
259
+ if (result.completed && !result.signalName && result.stopReason === 'end_turn') {
260
+ return isResponseAbandoned(result);
261
+ }
262
+ return false;
263
+ }
264
+ async autoContinue(initialResult, retryConfig, policy, maxRetries, maxAutoContinues) {
265
+ let result = initialResult;
266
+ let continued = false;
267
+ for (let count = 0; count < maxAutoContinues; count++) {
268
+ if (this.config.abortSignal?.aborted)
269
+ break;
270
+ if (!this.shouldAutoContinue(result))
271
+ break;
272
+ const reason = result.signalName
273
+ ? 'Process stalled'
274
+ : result.interrupted ? 'Execution interrupted' : 'Response appears incomplete';
275
+ hlog(`[RESILIENT] Auto-continue ${count + 1}/${maxAutoContinues}: ${reason}`);
276
+ this.retryLog?.push({ retryNumber: count + 1, path: 'AutoContinue', reason, timestamp: Date.now() });
277
+ this.config.onRetry?.({
278
+ retryNumber: count + 1,
279
+ maxRetries: maxAutoContinues,
280
+ path: 'AutoContinue',
281
+ reason,
282
+ });
283
+ const continueState = createRetryState('continue', maxRetries);
284
+ const continueResult = await this.retryLoop(continueState, retryConfig, policy, maxRetries, 'continue', result.claudeSessionId);
285
+ this.absorbState(continueState);
286
+ if (!continueResult)
287
+ break;
288
+ if (pickPreferredResult(result, continueResult) === continueResult || scoreResult(continueResult) >= scoreResult(result)) {
289
+ result = continueResult;
290
+ continued = true;
291
+ }
292
+ }
293
+ return this.decorate(result, continued);
294
+ }
295
+ async runSingle(prompt, continueSession, claudeSessionId) {
296
+ const runner = new HeadlessRunner({
297
+ workingDir: this.config.workingDir,
298
+ directPrompt: prompt,
299
+ stallWarningMs: this.config.stallWarningMs,
300
+ stallKillMs: this.config.stallKillMs,
301
+ stallHardCapMs: this.config.stallHardCapMs,
302
+ stallMaxExtensions: this.config.stallMaxExtensions,
303
+ verbose: this.config.verbose ?? true,
304
+ continueSession: continueSession || undefined,
305
+ claudeSessionId,
306
+ outputCallback: this.outputCallback,
307
+ thinkingCallback: this.config.thinkingCallback,
308
+ toolUseCallback: this.config.toolUseCallback,
309
+ tokenUsageCallback: this.config.tokenUsageCallback,
310
+ model: this.config.model,
311
+ effortLevel: this.config.effortLevel,
312
+ fastMode: this.config.fastMode,
313
+ extraEnv: this.config.extraEnv,
314
+ disallowedTools: this.config.disallowedTools,
315
+ inferenceOnly: this.config.inferenceOnly,
316
+ imageAttachments: this.config.imageAttachments,
317
+ appTools: this.config.appTools,
318
+ onBackgroundActivity: this.config.onBackgroundActivity,
319
+ });
320
+ this.attempts++;
321
+ const removeAbortListener = wireAbortSignal(runner, this.config.abortSignal);
322
+ const result = await runner.run();
323
+ removeAbortListener?.();
324
+ return result;
325
+ }
326
+ }
@@ -0,0 +1,292 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ import { resolveClaudeCommand } from '../../engines/claude/claude-command.js';
4
+ import { buildFreshRecoveryPrompt, buildResumeRetryPrompt, buildRetryPrompt, buildServerErrorRetryPrompt, buildSignalCrashRecoveryPrompt, } from '../prompt-builders.js';
5
+ import { hlog } from './headless-logger.js';
6
+ import { assessBestResult, assessContextLoss } from './stall-assessor.js';
7
+ export const MAX_SERVER_ERROR_RETRIES = 2;
8
+ export function isCompletedAttempt(r) {
9
+ return r.completed && !r.signalName && !r.interrupted && !r.engineNotice && !r.startupTimedOut;
10
+ }
11
+ export function attemptsAreComparable(a, b) {
12
+ return isCompletedAttempt(a) === isCompletedAttempt(b);
13
+ }
14
+ export function pickPreferredResult(earlier, later) {
15
+ if (!attemptsAreComparable(earlier, later))
16
+ return isCompletedAttempt(earlier) ? earlier : later;
17
+ return scoreResult(later) >= scoreResult(earlier) ? later : earlier;
18
+ }
19
+ export async function chooseBestAttempt(earlier, later, originalPrompt, claudeCommand, verbose) {
20
+ const at = Date.now();
21
+ if (!attemptsAreComparable(earlier, later)) {
22
+ const chosen = pickPreferredResult(earlier, later);
23
+ return {
24
+ chosen,
25
+ assessment: { kind: 'best-result', verdict: chosen === earlier ? 'A' : 'B', reason: 'rule: a completed attempt is preferred over a killed or errored one', assessed: true, at },
26
+ };
27
+ }
28
+ const verdict = await assessBestResult({
29
+ originalPrompt,
30
+ resultA: summarizeAttempt(earlier),
31
+ resultB: summarizeAttempt(later),
32
+ }, claudeCommand, verbose);
33
+ if (verdict.assessed && verdict.winner) {
34
+ return {
35
+ chosen: verdict.winner === 'A' ? earlier : later,
36
+ assessment: { kind: 'best-result', verdict: verdict.winner, reason: verdict.reason, assessed: true, at },
37
+ };
38
+ }
39
+ const chosen = pickPreferredResult(earlier, later);
40
+ return {
41
+ chosen,
42
+ assessment: { kind: 'best-result', verdict: chosen === earlier ? 'A' : 'B', reason: `fallback (${verdict.reason}): numeric score`, assessed: false, at },
43
+ };
44
+ }
45
+ function summarizeAttempt(r) {
46
+ return {
47
+ successfulToolCalls: r.toolUseHistory?.filter(t => t.result !== undefined && !t.isError).length ?? 0,
48
+ responseLength: r.assistantResponse?.length ?? 0,
49
+ hasThinking: !!r.thinkingOutput,
50
+ responseTail: (r.assistantResponse ?? '').slice(-500),
51
+ };
52
+ }
53
+ const NOTICE_MARKER_RE = /\[\[MINIONRY_[A-Z_]+(?::[A-Z_0-9]+)?\]\][^\n]*/g;
54
+ export function extractNoticeMarkers(text) {
55
+ const found = [];
56
+ for (const match of text.matchAll(NOTICE_MARKER_RE))
57
+ found.push(match[0].slice(0, 300));
58
+ return found;
59
+ }
60
+ export function summarizeRetryLog(retryLog) {
61
+ if (!retryLog || retryLog.length === 0)
62
+ return undefined;
63
+ return {
64
+ count: retryLog.length,
65
+ paths: Array.from(new Set(retryLog.map((r) => r.path))),
66
+ lastReason: retryLog[retryLog.length - 1]?.reason.slice(0, 200),
67
+ };
68
+ }
69
+ const MAX_ACCUMULATED_RESULTS = 50;
70
+ export function createRetryState(originalPrompt, maxRetries) {
71
+ return {
72
+ retryNumber: 0,
73
+ maxRetries,
74
+ originalPrompt,
75
+ accumulatedToolResults: [],
76
+ timedOutTools: [],
77
+ checkpoint: null,
78
+ bestResult: null,
79
+ lastUseResume: false,
80
+ serverErrorRetries: 0,
81
+ retryLog: [],
82
+ assessments: [],
83
+ assessorFailed: false,
84
+ };
85
+ }
86
+ export function isTerminalEngineNotice(result) {
87
+ return !!result.engineNotice && result.engineNotice.kind !== 'server_error';
88
+ }
89
+ export function tryServerError(result, state) {
90
+ if (result.engineNotice?.kind !== 'server_error')
91
+ return null;
92
+ if (state.checkpoint || state.retryNumber >= state.maxRetries)
93
+ return null;
94
+ if (state.serverErrorRetries >= MAX_SERVER_ERROR_RETRIES)
95
+ return null;
96
+ accumulateToolResults(result, state);
97
+ state.serverErrorRetries++;
98
+ state.retryNumber++;
99
+ const useResume = !!result.claudeSessionId;
100
+ const reason = `Transient API error (${result.engineNotice.text.slice(0, 80)}), ${useResume ? 'resuming' : 'fresh start'} (server-error retry ${state.serverErrorRetries}/${MAX_SERVER_ERROR_RETRIES})`;
101
+ hlog(`[RETRY] Server error: ${reason} (retry ${state.retryNumber}/${state.maxRetries})`);
102
+ return {
103
+ nextPrompt: buildServerErrorRetryPrompt(state.originalPrompt, useResume, state.accumulatedToolResults),
104
+ useResume,
105
+ resumeSessionId: useResume ? result.claudeSessionId : undefined,
106
+ path: 'ServerError',
107
+ reason,
108
+ };
109
+ }
110
+ export function accumulateToolResults(result, state) {
111
+ if (!result.toolUseHistory)
112
+ return;
113
+ for (const t of result.toolUseHistory) {
114
+ if (t.result !== undefined) {
115
+ state.accumulatedToolResults.push({
116
+ toolName: t.toolName,
117
+ toolId: t.toolId,
118
+ toolInput: t.toolInput,
119
+ result: t.result,
120
+ isError: t.isError,
121
+ duration: t.duration,
122
+ });
123
+ }
124
+ }
125
+ if (state.accumulatedToolResults.length > MAX_ACCUMULATED_RESULTS) {
126
+ state.accumulatedToolResults = state.accumulatedToolResults.slice(-MAX_ACCUMULATED_RESULTS);
127
+ }
128
+ }
129
+ export function scoreResult(r) {
130
+ const toolCount = r.toolUseHistory?.filter(t => t.result !== undefined && !t.isError).length ?? 0;
131
+ const responseLen = Math.min((r.assistantResponse?.length ?? 0) / 50, 100);
132
+ const hasThinking = r.thinkingOutput ? 20 : 0;
133
+ return toolCount * 10 + responseLen + hasThinking;
134
+ }
135
+ export function isResponseAbandoned(result) {
136
+ const thinkingLen = result.thinkingOutput?.length ?? 0;
137
+ const responseLen = result.assistantResponse?.length ?? 0;
138
+ const toolCallsInResponse = result.toolUseHistory?.filter(t => t.result !== undefined).length ?? 0;
139
+ if (thinkingLen < 500 || responseLen > 1000)
140
+ return false;
141
+ if (toolCallsInResponse > 0 && responseLen > 200)
142
+ return false;
143
+ return thinkingLen >= responseLen * 3;
144
+ }
145
+ export function tryToolTimeout(_result, state) {
146
+ if (!state.checkpoint || state.retryNumber >= state.maxRetries)
147
+ return null;
148
+ const cp = state.checkpoint;
149
+ state.retryNumber++;
150
+ state.timedOutTools.push({
151
+ toolName: cp.hungTool.toolName,
152
+ input: cp.hungTool.input ?? {},
153
+ timeoutMs: cp.hungTool.timeoutMs,
154
+ });
155
+ const canResume = !!cp.claudeSessionId;
156
+ const reason = `${cp.hungTool.toolName} timed out after ${Math.round(cp.hungTool.timeoutMs / 1000)}s, ${cp.completedTools.length} tools completed${cp.inProgressTools.length > 0 ? `, ${cp.inProgressTools.length} in flight` : ''}, ${canResume ? 'resuming' : 'fresh start'}`;
157
+ hlog(`[RETRY] Tool timeout: ${reason} (retry ${state.retryNumber}/${state.maxRetries})`);
158
+ if (canResume) {
159
+ return {
160
+ nextPrompt: buildResumeRetryPrompt(cp, state.timedOutTools),
161
+ useResume: true,
162
+ resumeSessionId: cp.claudeSessionId,
163
+ path: 'ToolTimeout',
164
+ reason,
165
+ };
166
+ }
167
+ return {
168
+ nextPrompt: buildRetryPrompt(cp, state.originalPrompt, state.timedOutTools),
169
+ useResume: false,
170
+ path: 'ToolTimeout',
171
+ reason,
172
+ };
173
+ }
174
+ export function trySignalCrash(result, state) {
175
+ const isSignalCrash = !!result.signalName || (!!result.interrupted && !result.completed);
176
+ const exitCodeSignal = !result.completed && !result.signalName && result.error?.match(/exited with code (1[2-9]\d|[2-9]\d{2})/);
177
+ if (!isSignalCrash && !exitCodeSignal)
178
+ return null;
179
+ if (isTerminalEngineNotice(result))
180
+ return null;
181
+ if (state.retryNumber >= state.maxRetries)
182
+ return null;
183
+ if (state.checkpoint)
184
+ return null;
185
+ accumulateToolResults(result, state);
186
+ state.retryNumber++;
187
+ const signalInfo = result.signalName || (result.interrupted ? 'interrupted' : 'unknown signal');
188
+ const useResume = !!result.claudeSessionId && state.retryNumber === 1;
189
+ const backgroundWorkLost = !!result.backgroundTasksPendingAtExit;
190
+ const reason = `Process killed (${signalInfo}), ${state.accumulatedToolResults.length} tools preserved, ${useResume ? 'resuming' : 'fresh start'}${backgroundWorkLost ? `, ${result.backgroundTasksPendingAtExit} background task(s) lost` : ''}`;
191
+ hlog(`[RETRY] Signal crash: ${reason} (retry ${state.retryNumber}/${state.maxRetries})`);
192
+ if (useResume) {
193
+ return {
194
+ nextPrompt: buildSignalCrashRecoveryPrompt(state.originalPrompt, true, undefined, backgroundWorkLost),
195
+ useResume: true,
196
+ resumeSessionId: result.claudeSessionId,
197
+ path: 'SignalCrash',
198
+ reason,
199
+ };
200
+ }
201
+ return {
202
+ nextPrompt: buildSignalCrashRecoveryPrompt(state.originalPrompt, false, state.accumulatedToolResults, backgroundWorkLost),
203
+ useResume: false,
204
+ path: 'SignalCrash',
205
+ reason,
206
+ };
207
+ }
208
+ export function detectContextLossHeuristic(result, verbose, onResumeTurn = true) {
209
+ if (result.engineNotice || result.startupTimedOut)
210
+ return false;
211
+ if (!result.assistantResponse || result.assistantResponse.trim().length === 0) {
212
+ if (verbose)
213
+ hlog('[RETRY] Context loss heuristic: null/empty response');
214
+ return true;
215
+ }
216
+ if (result.resumeBufferedOutput !== undefined) {
217
+ if (verbose)
218
+ hlog('[RETRY] Context loss heuristic: buffer never flushed (no thinking/tools)');
219
+ return true;
220
+ }
221
+ if (onResumeTurn &&
222
+ (!result.toolUseHistory || result.toolUseHistory.length === 0) &&
223
+ !result.thinkingOutput &&
224
+ result.assistantResponse.length < 500) {
225
+ if (verbose)
226
+ hlog('[RETRY] Context loss heuristic: no tools, no thinking, short response');
227
+ return true;
228
+ }
229
+ return false;
230
+ }
231
+ function computeEffectiveTimeouts(result) {
232
+ const nativeTimeouts = result.nativeTimeoutCount ?? 0;
233
+ if (nativeTimeouts === 0)
234
+ return 0;
235
+ const succeededIds = new Set();
236
+ const allIds = new Set();
237
+ for (const t of result.toolUseHistory ?? []) {
238
+ allIds.add(t.toolId);
239
+ if (t.result !== undefined)
240
+ succeededIds.add(t.toolId);
241
+ }
242
+ const toolsWithoutResult = Array.from(allIds).filter(id => !succeededIds.has(id)).length;
243
+ return Math.max(nativeTimeouts, toolsWithoutResult);
244
+ }
245
+ async function detectContextLossViaHaiku(result, effectiveTimeouts, verbose) {
246
+ if (effectiveTimeouts === 0 || !result.assistantResponse)
247
+ return false;
248
+ const writeToolNames = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
249
+ const claudeCmd = resolveClaudeCommand();
250
+ try {
251
+ const verdict = await assessContextLoss({
252
+ assistantResponse: result.assistantResponse,
253
+ effectiveTimeouts,
254
+ nativeTimeoutCount: result.nativeTimeoutCount ?? 0,
255
+ successfulToolCalls: result.toolUseHistory?.filter(t => t.result !== undefined && !t.isError).length ?? 0,
256
+ thinkingOutputLength: result.thinkingOutput?.length ?? 0,
257
+ hasSuccessfulWrite: result.toolUseHistory?.some(t => writeToolNames.has(t.toolName) && t.result !== undefined && !t.isError) ?? false,
258
+ }, claudeCmd, verbose);
259
+ if (verbose)
260
+ hlog(`[RETRY] Haiku context loss verdict: ${verdict.contextLost ? 'LOST' : 'OK'} — ${verdict.reason}`);
261
+ return verdict.contextLost;
262
+ }
263
+ catch {
264
+ if (verbose)
265
+ hlog('[RETRY] Haiku context loss assessment failed, assuming OK');
266
+ return false;
267
+ }
268
+ }
269
+ export async function tryContextLoss(result, state, config) {
270
+ if (!config.enableContextLossDetection)
271
+ return null;
272
+ if (state.checkpoint || state.retryNumber >= state.maxRetries)
273
+ return null;
274
+ if (isTerminalEngineNotice(result))
275
+ return null;
276
+ const heuristicLost = detectContextLossHeuristic(result, config.verbose, state.lastUseResume);
277
+ const haikuLost = heuristicLost
278
+ ? false
279
+ : await detectContextLossViaHaiku(result, computeEffectiveTimeouts(result), config.verbose);
280
+ if (!heuristicLost && !haikuLost)
281
+ return null;
282
+ accumulateToolResults(result, state);
283
+ state.retryNumber++;
284
+ const reason = `Context lost, ${state.accumulatedToolResults.length} tools preserved`;
285
+ hlog(`[RETRY] Context loss: ${reason} (retry ${state.retryNumber}/${state.maxRetries})`);
286
+ return {
287
+ nextPrompt: buildFreshRecoveryPrompt(state.originalPrompt, state.accumulatedToolResults, state.timedOutTools),
288
+ useResume: false,
289
+ path: 'ContextLoss',
290
+ reason,
291
+ };
292
+ }