@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,278 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ import { promises as fsp } from 'node:fs';
4
+ import { join } from 'node:path';
5
+ const ELAPSED_CHECKPOINTS_MS = [
6
+ 0,
7
+ 10_000,
8
+ 30_000,
9
+ 60_000,
10
+ 120_000,
11
+ 300_000,
12
+ 600_000,
13
+ 900_000,
14
+ 1_500_000,
15
+ 2_400_000,
16
+ 3_600_000,
17
+ ];
18
+ const MAX_SAMPLE_FILES = 200;
19
+ const MIN_SAMPLES = 30;
20
+ const SANITY_FLOOR_MS = 1_000;
21
+ const SANITY_CEILING_MS = 6 * 60 * 60_000;
22
+ const SPEED_FACTORS = {
23
+ 'claude-code': {
24
+ unknownModel: 1.0,
25
+ models: { opus: 1.0, fable: 1.05, sonnet: 0.85, haiku: 0.65 },
26
+ },
27
+ codex: {
28
+ unknownModel: 0.95,
29
+ models: { 'gpt-5.1-codex-max': 0.95, 'gpt-5-codex': 0.9 },
30
+ },
31
+ hermes: {
32
+ unknownModel: 1.1,
33
+ models: {
34
+ 'z-ai/glm-5.2': 1.0,
35
+ 'moonshotai/kimi-k3': 1.3,
36
+ 'anthropic/claude-fable-5.1': 1.15,
37
+ 'anthropic/claude-fable-5': 1.1,
38
+ 'anthropic/claude-opus-5': 1.1,
39
+ 'anthropic/claude-opus-4.8': 1.1,
40
+ 'anthropic/claude-sonnet-5': 0.9,
41
+ 'anthropic/claude-haiku-4.5': 0.7,
42
+ 'openai/gpt-5.6-sol': 1.05,
43
+ 'openai/gpt-5.6-sol-pro': 1.35,
44
+ 'openai/gpt-5.6-terra': 1.0,
45
+ 'openai/gpt-5.6-terra-pro': 1.3,
46
+ 'openai/gpt-5.6-luna': 0.75,
47
+ 'openai/gpt-5.6-luna-pro': 1.0,
48
+ 'openai/gpt-5.5': 1.15,
49
+ 'openai/gpt-5.5-pro': 1.5,
50
+ 'openai/gpt-5.4-mini': 0.7,
51
+ 'google/gemini-3.1-pro-preview': 0.85,
52
+ 'google/gemini-3.7-flash': 0.7,
53
+ 'x-ai/grok-4.6': 1.0,
54
+ 'deepseek/deepseek-v4-pro': 1.0,
55
+ 'deepseek/deepseek-v4-pro-0813': 1.0,
56
+ 'deepseek/deepseek-v4-flash': 0.8,
57
+ 'deepseek/deepseek-v4-flash-0731': 0.8,
58
+ 'qwen/qwen3.8-max': 1.25,
59
+ 'qwen/qwen3.8-flash': 0.8,
60
+ 'minimax/minimax-m3': 1.05,
61
+ 'z-ai/glm-5.3': 1.05,
62
+ 'z-ai/glm-5.3-flash': 0.75,
63
+ 'xiaomi/mimo-v2.5-pro': 1.05,
64
+ 'tencent/hy4-preview': 1.1,
65
+ 'tencent/hy3': 0.9,
66
+ 'stepfun/step-3.7-flash': 0.8,
67
+ 'nvidia/nemotron-3-super-120b-a12b': 0.85,
68
+ 'sakana/fugu-ultra': 1.6,
69
+ },
70
+ },
71
+ };
72
+ const FAST_MODE_FACTOR = 0.75;
73
+ function resolveModelKey(engine, model) {
74
+ const table = SPEED_FACTORS[engine];
75
+ if (!table)
76
+ return '*';
77
+ if (engine === 'claude-code') {
78
+ const m = (model ?? 'default').toLowerCase();
79
+ if (/haiku/.test(m))
80
+ return 'haiku';
81
+ if (/sonnet/.test(m))
82
+ return 'sonnet';
83
+ if (/fable|mythos/.test(m))
84
+ return 'fable';
85
+ return 'opus';
86
+ }
87
+ const key = (model ?? '').toLowerCase();
88
+ return key in table.models ? key : '*';
89
+ }
90
+ export function durationFactor(target) {
91
+ if (!target)
92
+ return 1;
93
+ const engine = target.engine && SPEED_FACTORS[target.engine] ? target.engine : 'claude-code';
94
+ const table = SPEED_FACTORS[engine];
95
+ const key = resolveModelKey(engine, target.model);
96
+ const base = table.models[key] ?? table.unknownModel;
97
+ return target.fastMode && engine === 'claude-code' ? base * FAST_MODE_FACTOR : base;
98
+ }
99
+ export function etaTargetKey(target) {
100
+ const engine = target?.engine && SPEED_FACTORS[target.engine] ? target.engine : 'claude-code';
101
+ const fast = target?.fastMode && engine === 'claude-code';
102
+ return `${engine}::${resolveModelKey(engine, target?.model)}${fast ? '::fast' : ''}`;
103
+ }
104
+ export async function buildEtaProfile(historyDir, opts = {}) {
105
+ const maxFiles = opts.maxFiles ?? MAX_SAMPLE_FILES;
106
+ const samples = await collectRecentSamples(historyDir, maxFiles);
107
+ return buildProfileFromSamples(samples, opts.target);
108
+ }
109
+ const SAMPLES_CACHE_TTL_MS = 5 * 60_000;
110
+ const samplesCache = new Map();
111
+ export async function getEtaProfileCached(historyDir, target) {
112
+ const samples = await getSamplesCached(historyDir);
113
+ const profile = buildProfileFromSamples(samples, target);
114
+ return profile ?? scaleProfile(BASELINE_ETA_PROFILE, durationFactor(target));
115
+ }
116
+ async function getSamplesCached(historyDir) {
117
+ const now = Date.now();
118
+ const hit = samplesCache.get(historyDir);
119
+ if (hit && hit.expiresAt > now && hit.samples)
120
+ return hit.samples;
121
+ if (hit?.pending)
122
+ return hit.pending;
123
+ const pending = collectRecentSamples(historyDir, MAX_SAMPLE_FILES).then(samples => {
124
+ samplesCache.set(historyDir, { samples, expiresAt: Date.now() + SAMPLES_CACHE_TTL_MS });
125
+ return samples;
126
+ }).catch(() => {
127
+ samplesCache.set(historyDir, { samples: [], expiresAt: Date.now() + SAMPLES_CACHE_TTL_MS });
128
+ return [];
129
+ });
130
+ samplesCache.set(historyDir, { samples: hit?.samples ?? null, expiresAt: hit?.expiresAt ?? 0, pending });
131
+ return pending;
132
+ }
133
+ export function _clearEtaCache() { samplesCache.clear(); }
134
+ export const BASELINE_ETA_PROFILE = {
135
+ buckets: [
136
+ { elapsedMs: 0, p50TotalMs: 108_000, p90TotalMs: 768_000, n: 379 },
137
+ { elapsedMs: 10_000, p50TotalMs: 117_000, p90TotalMs: 769_000, n: 368 },
138
+ { elapsedMs: 30_000, p50TotalMs: 155_000, p90TotalMs: 860_000, n: 328 },
139
+ { elapsedMs: 60_000, p50TotalMs: 245_000, p90TotalMs: 1_013_000, n: 252 },
140
+ { elapsedMs: 120_000, p50TotalMs: 392_000, p90TotalMs: 1_171_000, n: 182 },
141
+ { elapsedMs: 300_000, p50TotalMs: 605_000, p90TotalMs: 1_412_000, n: 116 },
142
+ { elapsedMs: 600_000, p50TotalMs: 945_000, p90TotalMs: 1_679_000, n: 58 },
143
+ { elapsedMs: 900_000, p50TotalMs: 1_265_000, p90TotalMs: 1_845_000, n: 30 },
144
+ { elapsedMs: 1_500_000, p50TotalMs: 1_728_000, p90TotalMs: 1_986_000, n: 10 },
145
+ ],
146
+ sampleSize: 379,
147
+ computedAt: '2026-05-06T00:00:00.000Z',
148
+ };
149
+ export function scaleProfile(profile, factor) {
150
+ if (Math.abs(factor - 1) < 1e-9)
151
+ return profile;
152
+ return {
153
+ buckets: profile.buckets.map(b => ({
154
+ elapsedMs: Math.round(b.elapsedMs * factor),
155
+ p50TotalMs: Math.round(b.p50TotalMs * factor),
156
+ p90TotalMs: Math.round(b.p90TotalMs * factor),
157
+ n: b.n,
158
+ })),
159
+ sampleSize: profile.sampleSize,
160
+ computedAt: profile.computedAt,
161
+ };
162
+ }
163
+ export function buildProfileFromSamples(samples, target) {
164
+ const usable = samples.filter(s => Number.isFinite(s.durationMs) && s.durationMs >= SANITY_FLOOR_MS && s.durationMs <= SANITY_CEILING_MS);
165
+ const key = etaTargetKey(target);
166
+ const segment = usable.filter(s => etaTargetKey(s) === key).map(s => s.durationMs);
167
+ if (segment.length >= MIN_SAMPLES)
168
+ return orNullIfEmpty(buildProfileFromDurations(segment));
169
+ if (usable.length >= MIN_SAMPLES) {
170
+ const normalized = usable.map(s => s.durationMs / durationFactor(s));
171
+ return orNullIfEmpty(scaleProfile(buildProfileFromDurations(normalized), durationFactor(target)));
172
+ }
173
+ return null;
174
+ }
175
+ function orNullIfEmpty(profile) {
176
+ return profile.buckets.length > 0 ? profile : null;
177
+ }
178
+ export function buildProfileFromDurations(durationsMs) {
179
+ const cleaned = durationsMs
180
+ .filter(d => Number.isFinite(d) && d >= SANITY_FLOOR_MS && d <= SANITY_CEILING_MS)
181
+ .sort((a, b) => a - b);
182
+ const buckets = [];
183
+ for (const elapsedMs of ELAPSED_CHECKPOINTS_MS) {
184
+ const stillRunning = cleaned.filter(d => d > elapsedMs);
185
+ if (stillRunning.length === 0)
186
+ break;
187
+ buckets.push({
188
+ elapsedMs,
189
+ p50TotalMs: quantile(stillRunning, 0.5),
190
+ p90TotalMs: quantile(stillRunning, 0.9),
191
+ n: stillRunning.length,
192
+ });
193
+ }
194
+ return {
195
+ buckets,
196
+ sampleSize: cleaned.length,
197
+ computedAt: new Date().toISOString(),
198
+ };
199
+ }
200
+ export function predictEta(profile, elapsedMs) {
201
+ if (profile.buckets.length === 0)
202
+ return null;
203
+ let bucket = profile.buckets[0];
204
+ for (const b of profile.buckets) {
205
+ if (b.elapsedMs <= elapsedMs)
206
+ bucket = b;
207
+ else
208
+ break;
209
+ }
210
+ const p50TotalMs = Math.max(bucket.p50TotalMs, elapsedMs);
211
+ const p90TotalMs = Math.max(bucket.p90TotalMs, p50TotalMs);
212
+ return { p50TotalMs, p90TotalMs, n: bucket.n };
213
+ }
214
+ async function collectRecentSamples(historyDir, maxFiles) {
215
+ let entries;
216
+ try {
217
+ entries = (await fsp.readdir(historyDir)).filter(f => f.endsWith('.json'));
218
+ }
219
+ catch {
220
+ return [];
221
+ }
222
+ if (entries.length === 0)
223
+ return [];
224
+ const stats = await Promise.all(entries.map(async (name) => {
225
+ try {
226
+ const full = join(historyDir, name);
227
+ const s = await fsp.stat(full);
228
+ return { full, mtime: s.mtimeMs };
229
+ }
230
+ catch {
231
+ return null;
232
+ }
233
+ }));
234
+ const ordered = stats
235
+ .filter((x) => x !== null)
236
+ .sort((a, b) => b.mtime - a.mtime)
237
+ .slice(0, maxFiles);
238
+ const samples = [];
239
+ for (const { full } of ordered) {
240
+ let raw;
241
+ try {
242
+ raw = await fsp.readFile(full, 'utf-8');
243
+ }
244
+ catch {
245
+ continue;
246
+ }
247
+ let data;
248
+ try {
249
+ data = JSON.parse(raw);
250
+ }
251
+ catch {
252
+ continue;
253
+ }
254
+ collectSessionSamples(data, samples);
255
+ }
256
+ return samples;
257
+ }
258
+ function collectSessionSamples(data, out) {
259
+ if (!Array.isArray(data.movements))
260
+ return;
261
+ for (const m of data.movements) {
262
+ const d = m.durationMs;
263
+ if (typeof d !== 'number' || !Number.isFinite(d))
264
+ continue;
265
+ out.push({
266
+ durationMs: d,
267
+ engine: m.engine ?? data.engine ?? 'claude-code',
268
+ model: m.model,
269
+ fastMode: m.fastMode,
270
+ });
271
+ }
272
+ }
273
+ function quantile(sortedAsc, q) {
274
+ if (sortedAsc.length === 0)
275
+ return 0;
276
+ const idx = Math.min(sortedAsc.length - 1, Math.floor(sortedAsc.length * q));
277
+ return sortedAsc[idx];
278
+ }
@@ -0,0 +1,109 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ const WAKEUP_MIN_DELAY_S = 60;
4
+ const WAKEUP_MAX_DELAY_S = 3600;
5
+ const TERMINAL_TASK_STATUSES = new Set(['completed', 'failed', 'killed', 'stopped', 'error', 'cancelled']);
6
+ export function createBackgroundActivityState() {
7
+ return {
8
+ pendingTasks: new Map(),
9
+ wakeup: null,
10
+ lastEvidenceAt: 0,
11
+ waitNoticeEmitted: false,
12
+ waitStartedAt: null,
13
+ lastWaitNoticeAt: 0,
14
+ };
15
+ }
16
+ function trackWaitEpisode(state, now) {
17
+ if (state.pendingTasks.size > 0) {
18
+ if (state.waitStartedAt === null)
19
+ state.waitStartedAt = now;
20
+ }
21
+ else {
22
+ state.waitStartedAt = null;
23
+ }
24
+ }
25
+ export function applyStreamEventToBackground(state, event) {
26
+ if (event.type !== 'system' || !event.subtype || !event.task_id)
27
+ return;
28
+ const now = Date.now();
29
+ switch (event.subtype) {
30
+ case 'task_started':
31
+ state.pendingTasks.set(event.task_id, {
32
+ taskId: event.task_id,
33
+ description: event.description,
34
+ taskType: event.task_type,
35
+ startedAt: now,
36
+ });
37
+ state.lastEvidenceAt = now;
38
+ state.waitNoticeEmitted = false;
39
+ trackWaitEpisode(state, now);
40
+ return;
41
+ case 'task_progress':
42
+ state.lastEvidenceAt = now;
43
+ return;
44
+ case 'task_updated': {
45
+ const status = event.patch?.status;
46
+ if (status && TERMINAL_TASK_STATUSES.has(status)) {
47
+ state.pendingTasks.delete(event.task_id);
48
+ }
49
+ state.lastEvidenceAt = now;
50
+ trackWaitEpisode(state, now);
51
+ return;
52
+ }
53
+ case 'task_notification':
54
+ state.pendingTasks.delete(event.task_id);
55
+ state.lastEvidenceAt = now;
56
+ trackWaitEpisode(state, now);
57
+ return;
58
+ }
59
+ }
60
+ export function applyToolEventToBackground(state, event) {
61
+ if (event.type !== 'tool_complete' || event.toolName !== 'ScheduleWakeup' || !event.completeInput)
62
+ return;
63
+ const delaySeconds = event.completeInput.delaySeconds;
64
+ if (typeof delaySeconds !== 'number' || !Number.isFinite(delaySeconds))
65
+ return;
66
+ const clamped = Math.min(WAKEUP_MAX_DELAY_S, Math.max(WAKEUP_MIN_DELAY_S, delaySeconds));
67
+ const prompt = typeof event.completeInput.prompt === 'string' ? event.completeInput.prompt : undefined;
68
+ const reason = typeof event.completeInput.reason === 'string' ? event.completeInput.reason : undefined;
69
+ state.wakeup = { fireAtMs: Date.now() + clamped * 1000, prompt, reason };
70
+ state.waitNoticeEmitted = false;
71
+ }
72
+ export function backgroundIdleDeadline(state, now, graceMs, capMs, absoluteCapMs = Number.POSITIVE_INFINITY) {
73
+ let deadline = null;
74
+ if (state.wakeup) {
75
+ const wakeupDeadline = state.wakeup.fireAtMs + graceMs;
76
+ if (now <= wakeupDeadline)
77
+ deadline = wakeupDeadline;
78
+ }
79
+ if (state.pendingTasks.size > 0) {
80
+ const absoluteDeadline = state.waitStartedAt !== null ? state.waitStartedAt + absoluteCapMs : Number.POSITIVE_INFINITY;
81
+ const taskDeadline = Math.min(state.lastEvidenceAt + capMs, absoluteDeadline);
82
+ if (now <= taskDeadline)
83
+ deadline = Math.max(deadline ?? 0, taskDeadline);
84
+ }
85
+ return deadline;
86
+ }
87
+ export function backgroundWaitExceededAbsoluteCap(state, now, absoluteCapMs) {
88
+ if (state.pendingTasks.size === 0 || state.waitStartedAt === null)
89
+ return false;
90
+ return now >= state.waitStartedAt + absoluteCapMs;
91
+ }
92
+ export function hasPendingBackgroundWork(state, now) {
93
+ return state.pendingTasks.size > 0 || (state.wakeup !== null && state.wakeup.fireAtMs > now);
94
+ }
95
+ export function describeBackgroundWait(state, now) {
96
+ const parts = [];
97
+ if (state.pendingTasks.size > 0) {
98
+ const names = Array.from(state.pendingTasks.values())
99
+ .slice(0, 3)
100
+ .map(t => t.description || t.taskType || t.taskId)
101
+ .join(', ');
102
+ parts.push(`${state.pendingTasks.size} background task(s) running (${names})`);
103
+ }
104
+ if (state.wakeup && state.wakeup.fireAtMs > now) {
105
+ const inMin = Math.max(1, Math.round((state.wakeup.fireAtMs - now) / 60_000));
106
+ parts.push(`next scheduled self-check in ~${inMin} min${state.wakeup.reason ? ` (${state.wakeup.reason})` : ''}`);
107
+ }
108
+ return parts.join('; ');
109
+ }