@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,350 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ import { hlog } from '../../cli/headless/headless-logger.js';
4
+ function asRecord(value) {
5
+ return typeof value === 'object' && value !== null
6
+ ? value
7
+ : undefined;
8
+ }
9
+ function asString(value) {
10
+ return typeof value === 'string' ? value : undefined;
11
+ }
12
+ function asNumber(value) {
13
+ return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
14
+ }
15
+ function asResultString(value) {
16
+ if (typeof value === 'string')
17
+ return value;
18
+ if (value === undefined || value === null)
19
+ return '';
20
+ const partsText = contentPartsText(value);
21
+ if (partsText !== undefined)
22
+ return partsText;
23
+ try {
24
+ return JSON.stringify(value);
25
+ }
26
+ catch {
27
+ return String(value);
28
+ }
29
+ }
30
+ function contentPartsText(value) {
31
+ if (!Array.isArray(value) || value.length === 0)
32
+ return undefined;
33
+ const texts = [];
34
+ for (const part of value) {
35
+ const text = asString(asRecord(part)?.text);
36
+ if (text === undefined)
37
+ return undefined;
38
+ texts.push(text);
39
+ }
40
+ return texts.join('');
41
+ }
42
+ function asTokenCount(value) {
43
+ const count = asNumber(value);
44
+ return count === undefined ? undefined : Math.max(0, count);
45
+ }
46
+ function parseToolArguments(value) {
47
+ const record = asRecord(value);
48
+ if (record)
49
+ return record;
50
+ const str = asString(value);
51
+ if (!str)
52
+ return {};
53
+ try {
54
+ return asRecord(JSON.parse(str)) ?? {};
55
+ }
56
+ catch {
57
+ return {};
58
+ }
59
+ }
60
+ export const HERMES_TRANSPORT_CAPABILITIES = {
61
+ transport: 'responses-sse',
62
+ reportsUsage: true,
63
+ usageGranularity: 'per-turn',
64
+ produces: {
65
+ 'message.delta': true,
66
+ 'message.thinking': true,
67
+ 'tool.start': true,
68
+ 'tool.end': true,
69
+ 'usage.update': true,
70
+ 'session.idle': true,
71
+ 'engine.error': true,
72
+ },
73
+ declaredAbsent: {
74
+ 'permission.request': true,
75
+ 'question.request': true,
76
+ streamingToolInput: true,
77
+ },
78
+ };
79
+ export class HermesEventMapper {
80
+ sessionId;
81
+ now;
82
+ usage;
83
+ _lastResponseId;
84
+ pendingTools = new Map();
85
+ startedTools = new Set();
86
+ endedTools = new Set();
87
+ syntheticToolCounter = 0;
88
+ constructor(options) {
89
+ this.sessionId = options.sessionId;
90
+ this.now = options.now ?? Date.now;
91
+ this.usage = {
92
+ inputTokens: 0,
93
+ outputTokens: 0,
94
+ cacheCreationTokens: 0,
95
+ cacheReadTokens: 0,
96
+ lastUpdatedAt: this.now(),
97
+ };
98
+ }
99
+ get lastResponseId() {
100
+ return this._lastResponseId;
101
+ }
102
+ getUsage() {
103
+ return { ...this.usage };
104
+ }
105
+ ingestFrame(frame) {
106
+ const parsed = parseSseFrame(frame);
107
+ if (!parsed) {
108
+ if (carriesPayload(frame))
109
+ hlog(`[hermes] skipping malformed SSE frame: ${frame.slice(0, 120)}`);
110
+ return [];
111
+ }
112
+ const { type, data } = parsed;
113
+ switch (type) {
114
+ case 'response.created':
115
+ this.captureResponseId(data);
116
+ return [];
117
+ case 'response.output_text.delta':
118
+ return this.mapTextDelta(data);
119
+ case 'response.reasoning_text.delta':
120
+ case 'response.reasoning_summary_text.delta':
121
+ return this.mapThinkingDelta(data);
122
+ case 'response.output_item.added':
123
+ case 'response.output_item.done':
124
+ return this.mapOutputItem(asRecord(data.item));
125
+ case 'response.completed':
126
+ case 'response.incomplete':
127
+ return this.mapCompleted(data);
128
+ case 'response.failed':
129
+ return this.mapFailed(data);
130
+ case 'error':
131
+ return [this.errorEvent(data)];
132
+ case 'response.in_progress':
133
+ case 'response.output_text.done':
134
+ case 'response.content_part.added':
135
+ case 'response.content_part.done':
136
+ return [];
137
+ default:
138
+ hlog(`[hermes] dropping unmapped SSE event type: ${type ?? '(none)'}`);
139
+ return [];
140
+ }
141
+ }
142
+ stampSessionId() {
143
+ return this.sessionId;
144
+ }
145
+ captureResponseId(data) {
146
+ const id = asString(asRecord(data.response)?.id) ?? asString(data.id);
147
+ if (id)
148
+ this._lastResponseId = id;
149
+ }
150
+ mapTextDelta(data) {
151
+ const text = asString(data.delta) ?? asString(data.text);
152
+ if (!text)
153
+ return [];
154
+ return [
155
+ { kind: 'message.delta', sessionId: this.stampSessionId(), timestamp: this.now(), text },
156
+ ];
157
+ }
158
+ mapThinkingDelta(data) {
159
+ const text = asString(data.delta) ?? asString(data.text);
160
+ if (!text)
161
+ return [];
162
+ return [
163
+ { kind: 'message.thinking', sessionId: this.stampSessionId(), timestamp: this.now(), text },
164
+ ];
165
+ }
166
+ mapOutputItem(item) {
167
+ if (!item)
168
+ return [];
169
+ const itemType = asString(item.type);
170
+ if (itemType === 'function_call')
171
+ return this.startTool(item);
172
+ if (itemType === 'function_call_output')
173
+ return this.endTool(item);
174
+ return [];
175
+ }
176
+ startTool(item) {
177
+ const callId = asString(item.call_id) ?? asString(item.id) ?? `hermes-tool-${++this.syntheticToolCounter}`;
178
+ const toolName = asString(item.name) ?? 'function_call';
179
+ const input = parseToolArguments(item.arguments);
180
+ const startedAt = this.pendingTools.get(callId)?.startedAt ?? this.now();
181
+ this.pendingTools.set(callId, { toolName, input, startedAt });
182
+ if (this.startedTools.has(callId))
183
+ return [];
184
+ this.startedTools.add(callId);
185
+ return [
186
+ {
187
+ kind: 'tool.start',
188
+ sessionId: this.stampSessionId(),
189
+ timestamp: startedAt,
190
+ toolCallId: callId,
191
+ toolName,
192
+ input,
193
+ },
194
+ ];
195
+ }
196
+ endTool(item) {
197
+ const callId = asString(item.call_id) ?? asString(item.id) ?? `hermes-tool-${++this.syntheticToolCounter}`;
198
+ if (this.endedTools.has(callId))
199
+ return [];
200
+ this.endedTools.add(callId);
201
+ const pending = this.pendingTools.get(callId);
202
+ const toolName = pending?.toolName ?? asString(item.name) ?? 'function_call';
203
+ const input = pending?.input ?? {};
204
+ const timestamp = this.now();
205
+ const durationMs = Math.max(0, timestamp - (pending?.startedAt ?? timestamp));
206
+ const isError = item.error !== undefined || asString(item.status) === 'failed';
207
+ const events = [];
208
+ if (!this.startedTools.has(callId)) {
209
+ this.startedTools.add(callId);
210
+ events.push({
211
+ kind: 'tool.start',
212
+ sessionId: this.stampSessionId(),
213
+ timestamp,
214
+ toolCallId: callId,
215
+ toolName,
216
+ input,
217
+ });
218
+ }
219
+ events.push({
220
+ kind: 'tool.end',
221
+ sessionId: this.stampSessionId(),
222
+ timestamp,
223
+ toolCallId: callId,
224
+ toolName,
225
+ input,
226
+ result: asResultString(item.output ?? item.result ?? item.error),
227
+ isError,
228
+ durationMs,
229
+ });
230
+ this.pendingTools.delete(callId);
231
+ return events;
232
+ }
233
+ mapCompleted(data) {
234
+ const resp = asRecord(data.response) ?? data;
235
+ this.captureResponseId(data);
236
+ const events = this.mapUsage(resp, data);
237
+ const status = asString(resp.status);
238
+ const notice = status === 'incomplete' ? incompleteNotice(resp) : undefined;
239
+ events.push({
240
+ kind: 'session.idle',
241
+ sessionId: this.stampSessionId(),
242
+ timestamp: this.now(),
243
+ stopReason: status ?? 'end_turn',
244
+ ...(notice ? { notice } : {}),
245
+ raw: data,
246
+ });
247
+ return events;
248
+ }
249
+ mapFailed(data) {
250
+ const resp = asRecord(data.response) ?? data;
251
+ this.captureResponseId(data);
252
+ return [
253
+ ...this.mapUsage(resp, data),
254
+ this.errorEvent(data),
255
+ {
256
+ kind: 'session.idle',
257
+ sessionId: this.stampSessionId(),
258
+ timestamp: this.now(),
259
+ stopReason: 'error',
260
+ raw: data,
261
+ },
262
+ ];
263
+ }
264
+ errorEvent(data) {
265
+ const errObj = asRecord(data.error) ?? asRecord(asRecord(data.response)?.error);
266
+ return {
267
+ kind: 'engine.error',
268
+ sessionId: this.stampSessionId(),
269
+ timestamp: this.now(),
270
+ code: 'HERMES_STREAM_ERROR',
271
+ message: asString(errObj?.message) ?? asString(data.message) ?? 'Hermes reported an error',
272
+ fatal: false,
273
+ raw: data,
274
+ };
275
+ }
276
+ mapUsage(resp, data) {
277
+ if (!this.foldUsage(asRecord(resp.usage) ?? asRecord(data.usage)))
278
+ return [];
279
+ return [
280
+ {
281
+ kind: 'usage.update',
282
+ sessionId: this.stampSessionId(),
283
+ timestamp: this.now(),
284
+ inputTokens: this.usage.inputTokens,
285
+ outputTokens: this.usage.outputTokens,
286
+ cacheCreationTokens: this.usage.cacheCreationTokens,
287
+ cacheReadTokens: this.usage.cacheReadTokens,
288
+ },
289
+ ];
290
+ }
291
+ foldUsage(usage) {
292
+ if (!usage)
293
+ return false;
294
+ const input = asTokenCount(usage.input_tokens) ??
295
+ asTokenCount(usage.prompt_tokens) ??
296
+ asTokenCount(usage.inputTokens);
297
+ const output = asTokenCount(usage.output_tokens) ??
298
+ asTokenCount(usage.completion_tokens) ??
299
+ asTokenCount(usage.outputTokens);
300
+ const cacheRead = asTokenCount(usage.cached_input_tokens) ?? asTokenCount(usage.cacheReadTokens);
301
+ if (input === undefined && output === undefined && cacheRead === undefined) {
302
+ return false;
303
+ }
304
+ const cur = this.usage;
305
+ this.usage = {
306
+ inputTokens: cur.inputTokens + (input ?? 0),
307
+ outputTokens: cur.outputTokens + (output ?? 0),
308
+ cacheCreationTokens: cur.cacheCreationTokens,
309
+ cacheReadTokens: (cur.cacheReadTokens ?? 0) + (cacheRead ?? 0),
310
+ lastUpdatedAt: this.now(),
311
+ };
312
+ return true;
313
+ }
314
+ }
315
+ function carriesPayload(frame) {
316
+ return frame
317
+ .split('\n')
318
+ .some((line) => line.startsWith('data:') && line.slice('data:'.length).trim() !== '[DONE]');
319
+ }
320
+ function incompleteNotice(resp) {
321
+ const reason = asString(asRecord(resp.incomplete_details)?.reason);
322
+ return reason ? `The run stopped early: ${reason}.` : 'The run stopped early at a limit.';
323
+ }
324
+ export function parseSseFrame(frame) {
325
+ let eventType;
326
+ const dataLines = [];
327
+ for (const rawLine of frame.split('\n')) {
328
+ const line = rawLine.replace(/\r$/, '');
329
+ if (line.startsWith(':'))
330
+ continue;
331
+ if (line.startsWith('event:')) {
332
+ eventType = line.slice('event:'.length).trim();
333
+ }
334
+ else if (line.startsWith('data:')) {
335
+ dataLines.push(line.slice('data:'.length).replace(/^ /, ''));
336
+ }
337
+ }
338
+ const dataStr = dataLines.join('\n').trim();
339
+ if (!dataStr || dataStr === '[DONE]')
340
+ return undefined;
341
+ try {
342
+ const data = asRecord(JSON.parse(dataStr));
343
+ if (!data)
344
+ return undefined;
345
+ return { type: eventType ?? asString(data.type), data };
346
+ }
347
+ catch {
348
+ return undefined;
349
+ }
350
+ }
@@ -0,0 +1,318 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ import { spawn } from 'node:child_process';
4
+ import { existsSync, mkdtempSync, rmSync } from 'node:fs';
5
+ import { homedir, tmpdir } from 'node:os';
6
+ import { delimiter, join } from 'node:path';
7
+ import { getSettings } from '../../services/settings.js';
8
+ import { HERMES_ALL_TOOLSETS, hermesAppRunBaseEnv } from './hermes-gateway-home.js';
9
+ export const HERMES_INSTALL_URL = 'https://hermes-agent.nousresearch.com/install.sh';
10
+ export const HERMES_INSTALL_COMMAND = `curl -fsSL ${HERMES_INSTALL_URL} | bash`;
11
+ export const MINIMUM_HERMES_VERSION = '0.19.0';
12
+ export const MINIMUM_HERMES_APP_RUN_VERSION = '0.20.5';
13
+ const HERMES_EXE = process.platform === 'win32' ? 'hermes.exe' : 'hermes';
14
+ function defaultResolveHermesBinary(pathExists, pathValue, home) {
15
+ const dirs = [];
16
+ for (const dir of pathValue.split(delimiter)) {
17
+ if (dir.trim().length > 0)
18
+ dirs.push(dir);
19
+ }
20
+ dirs.push(join(home, '.local', 'bin'));
21
+ dirs.push(join(home, '.hermes', 'bin'));
22
+ for (const dir of dirs) {
23
+ const candidate = join(dir, HERMES_EXE);
24
+ if (pathExists(candidate))
25
+ return candidate;
26
+ }
27
+ return null;
28
+ }
29
+ function defaultHasInstallConsent() {
30
+ if (process.env.HERMES_INSTALL_CONSENT === '1')
31
+ return true;
32
+ try {
33
+ const settings = getSettings();
34
+ return settings.hermesInstallConsent === true;
35
+ }
36
+ catch {
37
+ return false;
38
+ }
39
+ }
40
+ const defaultSpawn = (cmd, args, opts) => new Promise((resolveExit) => {
41
+ const child = spawn(cmd, args, {
42
+ cwd: opts.cwd,
43
+ stdio: ['ignore', 'pipe', 'pipe'],
44
+ env: opts.env ?? process.env,
45
+ windowsHide: true,
46
+ });
47
+ let tail = '';
48
+ const TAIL_CAP = 4_000;
49
+ const append = (chunk) => {
50
+ const text = chunk.toString('utf8');
51
+ tail = (tail + text).slice(-TAIL_CAP);
52
+ if (opts.onLine) {
53
+ for (const line of text.split('\n')) {
54
+ if (line.trim().length > 0)
55
+ opts.onLine(line);
56
+ }
57
+ }
58
+ };
59
+ child.stdout?.on('data', append);
60
+ child.stderr?.on('data', append);
61
+ child.on('error', (err) => {
62
+ tail = `${tail}\nspawn error: ${err.message}`.slice(-TAIL_CAP);
63
+ resolveExit({ ok: false, code: null, tail });
64
+ });
65
+ child.on('exit', (code) => resolveExit({ ok: code === 0, code, tail }));
66
+ });
67
+ export function parseHermesVersion(output) {
68
+ const m = output.match(/(\d+)\.(\d+)\.(\d+)/);
69
+ return m ? `${m[1]}.${m[2]}.${m[3]}` : null;
70
+ }
71
+ export function isHermesVersionTooOld(version, minimum) {
72
+ const v = parseHermesVersion(version);
73
+ const min = parseHermesVersion(minimum);
74
+ if (!v || !min)
75
+ return false;
76
+ const [va, vb, vc] = v.split('.').map(Number);
77
+ const [ma, mb, mc] = min.split('.').map(Number);
78
+ if (va !== ma)
79
+ return va < ma;
80
+ if (vb !== mb)
81
+ return vb < mb;
82
+ return vc < mc;
83
+ }
84
+ export class HermesRuntimeProvisioner {
85
+ resolveHermesBinary;
86
+ pathExists;
87
+ probeVersion;
88
+ spawnFn;
89
+ hasInstallConsent;
90
+ env;
91
+ home;
92
+ constructor(deps = {}) {
93
+ this.env = deps.env ?? process.env;
94
+ this.home = deps.home ?? homedir();
95
+ this.pathExists = deps.pathExists ?? existsSync;
96
+ this.spawnFn = deps.spawn ?? defaultSpawn;
97
+ this.hasInstallConsent = deps.hasInstallConsent ?? defaultHasInstallConsent;
98
+ const pathValue = deps.pathValue ?? this.env.PATH ?? this.env.Path ?? '';
99
+ this.resolveHermesBinary =
100
+ deps.resolveHermesBinary ??
101
+ (() => defaultResolveHermesBinary(this.pathExists, pathValue, this.home));
102
+ this.probeVersion = deps.probeVersion ?? ((binary) => this.defaultProbeVersion(binary));
103
+ }
104
+ async defaultProbeVersion(binary) {
105
+ const r = await this.spawnFn(binary, ['--version'], { cwd: this.home, env: this.env });
106
+ if (!r.ok)
107
+ return null;
108
+ return parseHermesVersion(r.tail);
109
+ }
110
+ async detect() {
111
+ const binaryPath = this.resolveHermesBinary();
112
+ if (!binaryPath) {
113
+ return { provisioned: false, binaryPath: null, version: null, state: 'missing' };
114
+ }
115
+ const version = await this.probeVersion(binaryPath);
116
+ if (version && isHermesVersionTooOld(version, MINIMUM_HERMES_VERSION)) {
117
+ return { provisioned: false, binaryPath, version, state: 'too-old' };
118
+ }
119
+ return { provisioned: true, binaryPath, version, state: 'ok' };
120
+ }
121
+ async provision(onLine) {
122
+ const log = onLine ?? (() => { });
123
+ const before = await this.detect();
124
+ if (before.state === 'ok') {
125
+ return { ok: true, status: before, action: 'noop' };
126
+ }
127
+ if (!this.hasInstallConsent()) {
128
+ return { ok: false, status: before, action: 'offered', error: this.describeOffer(before) };
129
+ }
130
+ await this.runInstaller(log);
131
+ const after = await this.detect();
132
+ if (after.state === 'ok') {
133
+ return { ok: true, status: after, action: 'installed' };
134
+ }
135
+ return { ok: false, status: after, action: 'failed', error: this.describeFailure(after) };
136
+ }
137
+ async runInstaller(log) {
138
+ log(`Installing Hermes via the official installer: ${HERMES_INSTALL_COMMAND}`);
139
+ const r = await this.spawnFn('bash', ['-c', HERMES_INSTALL_COMMAND], {
140
+ cwd: this.home,
141
+ onLine: log,
142
+ env: this.env,
143
+ });
144
+ if (!r.ok) {
145
+ log(`Hermes installer exited with code ${r.code ?? 'null'}.`);
146
+ }
147
+ return r;
148
+ }
149
+ describeOffer(status) {
150
+ if (status.state === 'too-old') {
151
+ return (`Hermes ${status.version ?? '(unknown)'} is installed but Minionry requires ` +
152
+ `v${MINIMUM_HERMES_VERSION} or newer. Update it with the official installer:\n ` +
153
+ `${HERMES_INSTALL_COMMAND}`);
154
+ }
155
+ return (`Hermes is not installed. Install it with the official installer:\n ` +
156
+ `${HERMES_INSTALL_COMMAND}\n` +
157
+ `Then retry, or set HERMES_COMMAND to an existing hermes binary.`);
158
+ }
159
+ describeFailure(status) {
160
+ if (status.state === 'too-old') {
161
+ return (`Hermes is still on ${status.version ?? '(unknown)'} after running the installer ` +
162
+ `(requires v${MINIMUM_HERMES_VERSION}+). Update it manually:\n ${HERMES_INSTALL_COMMAND}`);
163
+ }
164
+ return (`The Hermes installer ran but no usable \`hermes\` binary could be found afterward. ` +
165
+ `Install it manually:\n ${HERMES_INSTALL_COMMAND}\n` +
166
+ `Then set HERMES_COMMAND if it is not on PATH.`);
167
+ }
168
+ }
169
+ let inFlight = null;
170
+ let lastFailureAt = 0;
171
+ let lastFailureResult = null;
172
+ export const PROVISION_FAILURE_COOLDOWN_MS = 60_000;
173
+ export function ensureHermesProvisioned(onLine, deps) {
174
+ if (inFlight)
175
+ return inFlight;
176
+ if (lastFailureResult && now() - lastFailureAt < PROVISION_FAILURE_COOLDOWN_MS) {
177
+ return Promise.resolve(lastFailureResult);
178
+ }
179
+ const run = new HermesRuntimeProvisioner(deps)
180
+ .provision(onLine)
181
+ .then((result) => {
182
+ if (result.action === 'failed') {
183
+ lastFailureResult = result;
184
+ lastFailureAt = now();
185
+ }
186
+ else {
187
+ lastFailureResult = null;
188
+ }
189
+ return result;
190
+ })
191
+ .finally(() => {
192
+ inFlight = null;
193
+ });
194
+ inFlight = run;
195
+ return run;
196
+ }
197
+ export async function resolveHermesCommand(onLine, deps) {
198
+ const override = process.env.HERMES_COMMAND;
199
+ if (override && override.trim().length > 0) {
200
+ return override;
201
+ }
202
+ const result = await ensureHermesProvisioned(onLine, deps);
203
+ if (result.ok && result.status.binaryPath) {
204
+ return result.status.binaryPath;
205
+ }
206
+ throw new Error(result.error ??
207
+ `Hermes is not installed and could not be provisioned. Install it with:\n ` +
208
+ `${HERMES_INSTALL_COMMAND}\nThen set HERMES_COMMAND if it is not on PATH.`);
209
+ }
210
+ export function isHermesProvisioning() {
211
+ return inFlight !== null;
212
+ }
213
+ export const HERMES_AVAILABILITY_TTL_MS = 60_000;
214
+ let availabilityCache = null;
215
+ export function parseHermesToolsetNames(output) {
216
+ const names = [];
217
+ for (const line of output.split('\n')) {
218
+ const match = line.match(/^\s*\S+\s+(?:enabled|disabled)\s+(\S+)/);
219
+ if (match)
220
+ names.push(match[1]);
221
+ }
222
+ return names;
223
+ }
224
+ async function defaultListToolsets(binary, spawnFn, env) {
225
+ let home;
226
+ try {
227
+ home = mkdtempSync(join(tmpdir(), 'minionry-hermes-tools-'));
228
+ }
229
+ catch {
230
+ return null;
231
+ }
232
+ try {
233
+ const lines = [];
234
+ const result = await spawnFn(binary, ['tools', 'list', '--platform', 'api_server'], {
235
+ cwd: home,
236
+ env: { ...hermesAppRunBaseEnv(env), HERMES_HOME: home },
237
+ onLine: (line) => lines.push(line),
238
+ });
239
+ if (!result.ok)
240
+ return null;
241
+ return parseHermesToolsetNames(lines.join('\n'));
242
+ }
243
+ finally {
244
+ rmSync(home, { recursive: true, force: true });
245
+ }
246
+ }
247
+ async function computeHermesAvailability(deps) {
248
+ const env = deps.env ?? process.env;
249
+ const override = env.HERMES_COMMAND?.trim();
250
+ const provisioner = new HermesRuntimeProvisioner({
251
+ ...deps,
252
+ ...(override ? { resolveHermesBinary: () => override } : {}),
253
+ });
254
+ const detected = await provisioner.detect();
255
+ const base = { binaryPath: detected.binaryPath, version: detected.version, unknownToolsets: [] };
256
+ if (!detected.binaryPath) {
257
+ return {
258
+ ...base,
259
+ available: false,
260
+ state: 'missing',
261
+ reason: `Hermes is not installed. Install it with the official installer:\n ${HERMES_INSTALL_COMMAND}`,
262
+ };
263
+ }
264
+ if (!detected.version || isHermesVersionTooOld(detected.version, MINIMUM_HERMES_APP_RUN_VERSION)) {
265
+ return {
266
+ ...base,
267
+ available: false,
268
+ state: 'too-old',
269
+ reason: `Hermes ${detected.version ?? '(unknown version)'} cannot run app sessions; ` +
270
+ `v${MINIMUM_HERMES_APP_RUN_VERSION} or newer is required. Update it with:\n ${HERMES_INSTALL_COMMAND}`,
271
+ };
272
+ }
273
+ const spawnFn = deps.spawn ?? defaultSpawn;
274
+ const listed = await (deps.listToolsets ?? ((binary) => defaultListToolsets(binary, spawnFn, env)))(detected.binaryPath);
275
+ if (!listed || listed.length === 0) {
276
+ return {
277
+ ...base,
278
+ available: false,
279
+ state: 'unknown-toolsets',
280
+ reason: 'Hermes did not list its toolsets, so an app session cannot be confirmed tool-free.',
281
+ };
282
+ }
283
+ const known = new Set(HERMES_ALL_TOOLSETS);
284
+ const unknownToolsets = [...new Set(listed.filter((name) => !known.has(name)))];
285
+ if (unknownToolsets.length > 0) {
286
+ return {
287
+ ...base,
288
+ unknownToolsets,
289
+ available: false,
290
+ state: 'unknown-toolsets',
291
+ reason: `Hermes lists toolsets an app session cannot disable yet: ${unknownToolsets.join(', ')}.`,
292
+ };
293
+ }
294
+ return { ...base, available: true, state: 'ok' };
295
+ }
296
+ export function hermesAvailability(deps = {}) {
297
+ const at = now();
298
+ if (availabilityCache && at - availabilityCache.at < HERMES_AVAILABILITY_TTL_MS) {
299
+ return availabilityCache.result;
300
+ }
301
+ const result = computeHermesAvailability(deps);
302
+ const entry = { at, result };
303
+ availabilityCache = entry;
304
+ result.catch(() => {
305
+ if (availabilityCache === entry)
306
+ availabilityCache = null;
307
+ });
308
+ return result;
309
+ }
310
+ function now() {
311
+ return Date.now();
312
+ }
313
+ export function resetHermesProvisionStateForTests() {
314
+ inFlight = null;
315
+ lastFailureAt = 0;
316
+ lastFailureResult = null;
317
+ availabilityCache = null;
318
+ }
@@ -0,0 +1,20 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ import { WORKSPACE_WRITE_TOOLS } from '../services/sdk/run-profile.js';
4
+ export function sessionIsReadOnly(options) {
5
+ const disallowed = options.disallowedTools ?? [];
6
+ return WORKSPACE_WRITE_TOOLS.some((tool) => disallowed.includes(tool));
7
+ }
8
+ export function readOnlyDisallowedTools() {
9
+ return [...WORKSPACE_WRITE_TOOLS];
10
+ }
11
+ export const READ_ONLY_UNSUPPORTED = 'READ_ONLY_UNSUPPORTED';
12
+ export const HERMES_READ_ONLY_REFUSAL = 'Hermes cannot run a read-only session: its file tools can always write. Choose Claude Code or Codex for this.';
13
+ const READ_ONLY_REFUSALS = {
14
+ 'claude-code': null,
15
+ codex: null,
16
+ hermes: HERMES_READ_ONLY_REFUSAL,
17
+ };
18
+ export function readOnlyRefusal(engineId) {
19
+ return READ_ONLY_REFUSALS[engineId] ?? null;
20
+ }