@apralabs/apra-fleet 0.4.3 → 0.4.5

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 (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -1,3 +1,4 @@
1
+ import { escapePowerShellArgInner } from '../utils/shell-escape.js';
1
2
  import fs from 'node:fs';
2
3
  import os from 'node:os';
3
4
  import path from 'node:path';
@@ -11,13 +12,14 @@ import { getAgentOS, getAgentShell, touchAgent, getStoredPid, isPosixShellMember
11
12
  import { updateAgent } from '../services/registry.js';
12
13
  import { memberIdentifier, resolveMember } from '../utils/resolve-member.js';
13
14
  import { isRetryable, authErrorAdvice, workspaceNotTrustedAdvice } from '../utils/prompt-errors.js';
14
- import { buildAuthEnvPrefix } from '../utils/auth-env.js';
15
+ import { stageAuthEnv, removeMemberSecretFile, SecretDeliveryError } from '../services/member-secret-env.js';
15
16
  import { writeStatusline } from '../services/statusline.js';
16
17
  import { getModelOverride } from '../services/user-config.js';
17
18
  import { ensureCloudReady } from '../services/cloud/lifecycle.js';
18
19
  import { getStallDetector, resolveSessionLogPath } from '../services/stall/index.js';
19
20
  import { getCachedMemberPathContext } from '../services/member-home.js';
20
21
  import { provisionAgents, remoteAgentsDir, loadCanonicalAgentSet } from '../services/agent-provisioner.js';
22
+ import { ensureNoProjectAgentShadows } from '../services/agent-shadow.js';
21
23
  import { escapeWindowsArg, escapeDoubleQuoted } from '../os/os-commands.js';
22
24
  import { resolveTilde } from './execute-command.js';
23
25
  import { clearStoredPid } from '../utils/agent-helpers.js';
@@ -34,17 +36,34 @@ import { getTokenIssuer } from '../services/token-issuer.js';
34
36
  import { resolveExpectedDemand, checkContextAdmission, recordSessionUsage } from '../services/context-admission.js';
35
37
  import { recordKnownSession, isKnownSession } from '../services/known-sessions.js';
36
38
  import { resolveBudgetScope, evaluateBudget, recordAndEvaluate } from '../services/budget-awareness.js';
39
+ import { dispatchCostFromCumulative } from '../services/session-cost.js';
37
40
  import { sendMessage } from './send-message.js';
41
+ import { serverVersion } from '../version.js';
38
42
  import { registerPending } from '../services/pending-responses.js';
43
+ import { inFlightAgents } from '../services/in-flight-agents.js';
39
44
  import { isMaxTurnsResponse } from '../providers/provider.js';
40
45
  import { preflightCheck } from '../services/preflight-check.js';
41
46
  import { ensureAgyProject } from '../services/agy-project.js';
47
+ import { sessionMcpInjectionAvailable, sessionMcpConfigPath, sessionMcpConfigIsPerDispatch, writeSessionMcpConfig, resolveSessionMcpAlwaysLoad } from '../services/session-mcp-config.js';
48
+ export function toStructuredUsage(u) {
49
+ return {
50
+ input_tokens: u.input_tokens,
51
+ output_tokens: u.output_tokens,
52
+ cache_read_input_tokens: u.cache_read_input_tokens ?? 0,
53
+ cache_creation_input_tokens: u.cache_creation_input_tokens ?? 0,
54
+ total_tokens: u.input_tokens + u.output_tokens,
55
+ ...(typeof u.cost_usd === 'number' ? { cost_usd: u.cost_usd } : {}),
56
+ };
57
+ }
58
+ /** Failure classes that win over a permission denial carried in the same
59
+ * result: the caller acts on these (resume, re-provision, retry later). */
60
+ const TYPED_FAILURE_CATEGORIES = new Set(['auth', 'server', 'overloaded', 'workspace_not_trusted', 'max_turns']);
42
61
  export const executePromptSchema = z.object({
43
62
  ...memberIdentifier,
44
63
  prompt: z.string().describe('The prompt to send to the LLM on the remote member'),
45
64
  session_id: z.string().optional().describe('Shorthand for explicit session resume. Equivalent to resume: "<session_id>". If provided, takes precedence over resume.'),
46
65
  resume: z.union([z.boolean(), z.string()]).default(true).describe('Session-resume control (default: true). ' +
47
- 'true = best-effort resume of the member\'s stored last session (a stale/unknown stored session transparently falls back to a fresh session). ' +
66
+ 'true = best-effort resume of the member\'s stored last session (a stale/unknown stored session, or one recorded by a different server build, transparently falls back to a fresh session). ' +
48
67
  'false = always start a fresh session. ' +
49
68
  'A session-id STRING = EXPLICIT resume of exactly that session, preferred over the member\'s stored session -- the caller asserts this prompt depends on that session\'s prior context, so an unknown/expired id is a TERMINAL error ' +
50
69
  '(structured {isError, reason: "session_not_found"}, NO LLM call, and NO fresh-session fallback) rather than a silent wrong-context dispatch.'),
@@ -58,8 +77,9 @@ export const executePromptSchema = z.object({
58
77
  'call. NOTE: this field only covers the schema + the mutual-exclusivity guard; actual fork ' +
59
78
  'MODE RESOLUTION (minting/wiring the forked session) is implemented separately.'),
60
79
  timeout_s: z.number().default(300).describe('Inactivity timeout in seconds -- always drives the stall detector\'s per-dispatch baseline threshold, measured against the member\'s own session transcript activity (default: 300s / 5 minutes). Omitting it yields a 300s baseline, a deliberate change from the previously silent 150s stall-detector default. Per-provider, it ALSO arms the exec-level rolling timer against this dispatch\'s stdout/stderr channel for Codex and Copilot, which have no pollable transcript; Claude and AGY take that exec-channel ceiling from max_total_s instead; and OpenCode keeps BOTH signals armed at once (this exec-channel timer plus coarse log-directory-mtime polling, combined with OR semantics -- either advancing counts as not-stalled), since its transcript signal is directory-level only, not a per-turn file (see ProviderAdapter.execTimeoutSource()).'),
61
- max_total_s: z.number().optional().describe('Hard ceiling in seconds -- the command is killed after this total elapsed time regardless of activity. If omitted, there is no total time limit.'),
80
+ max_total_s: z.number().optional().describe('Hard ceiling in seconds, measured from the moment the call is received (setup such as member readiness and preflight counts) -- the command is killed after this total elapsed time regardless of activity and the call returns reason max_total_time. If omitted, there is no total time limit.'),
62
81
  max_turns: z.number().min(1).max(500).optional().describe('Max turns for claude -p (default: 50)'),
82
+ fail_on_permission_denial: z.boolean().optional().describe('Strict permission handling (default: false). true = a tool call the member CLI refused fails the dispatch with reason "permission_denied" and a permissionDenied block (suggestedGrants to heal it with compose_permissions), even when the reply looks complete -- except a Claude refusal with healable:false (auto/bypass mode: safety classifier or deny rule) on a complete reply, which is only a permissionWarning. Omitted/false = each provider keeps its earlier behaviour: a complete Claude reply is a success carrying the refusals in permissionWarning; AGY refusals still fail permission_denied. Either way a max_turns / auth / server / overloaded result keeps its own reason, with the refusals attached as permissionDenied.'),
63
83
  model: z.string().optional().describe('Model tier ("cheap", "standard", "premium") or a specific model ID for power users. Prefer tier names -- the server resolves them to the correct model per provider. If omitted, defaults to the standard tier. Applies to both new and resumed sessions.'),
64
84
  substitutions: z.record(z.string(), z.string()).optional().describe('Optional map of token name to replacement value. ' +
65
85
  'When provided, every occurrence of {{name}} in the prompt is replaced before the prompt is staged on the member. ' +
@@ -120,6 +140,41 @@ ${output}`;
120
140
  // timeout_s -- is deliberately NOT taken: that is the exact coupling this
121
141
  // removes, and for these providers timeout_s belongs to the StallDetector.
122
142
  const EXEC_TIMER_NEVER_BINDS_MS = 86_400_000;
143
+ const FAILURE_STDERR_TAIL_CHARS = 2000;
144
+ const FAILURE_STDERR_TAIL_LINES = 20;
145
+ const FAILURE_EVENT_CHARS = 1000;
146
+ /**
147
+ * GitHub #585: the diagnostic payload logged when execute_prompt's dispatch
148
+ * exits non-zero -- the TAIL of stderr (the end is where CLIs print the
149
+ * fatal error), capped by lines and characters, plus the last JSON
150
+ * result/error event on stdout, capped. Redaction happens in logLine.
151
+ */
152
+ export function formatPromptFailureTail(result) {
153
+ let stderrTail = (result.stderr ?? '').trimEnd();
154
+ const lines = stderrTail.split('\n');
155
+ if (lines.length > FAILURE_STDERR_TAIL_LINES)
156
+ stderrTail = lines.slice(-FAILURE_STDERR_TAIL_LINES).join('\n');
157
+ if (stderrTail.length > FAILURE_STDERR_TAIL_CHARS)
158
+ stderrTail = stderrTail.slice(-FAILURE_STDERR_TAIL_CHARS);
159
+ let lastEvent;
160
+ const outLines = (result.stdout ?? '').split('\n');
161
+ for (let i = outLines.length - 1; i >= 0 && lastEvent === undefined; i--) {
162
+ const line = outLines[i].trim();
163
+ if (!line.startsWith('{'))
164
+ continue;
165
+ try {
166
+ const ev = JSON.parse(line);
167
+ if (ev.type === 'result' || ev.type === 'error' || ev.is_error === true || ev.error !== undefined) {
168
+ lastEvent = line.length > FAILURE_EVENT_CHARS ? line.slice(0, FAILURE_EVENT_CHARS) + '...[truncated]' : line;
169
+ }
170
+ }
171
+ catch { /* not a JSON event line */ }
172
+ }
173
+ return JSON.stringify({ exit: result.code, stderrTail, ...(lastEvent !== undefined ? { lastEvent } : {}) });
174
+ }
175
+ /** GitHub #563: max_total_s time held back from every attempt for prompt-file
176
+ * cleanup and the response (see cleanupReserveMs in executePrompt). */
177
+ export const EXECUTE_PROMPT_CLEANUP_RESERVE_MS = 5000;
123
178
  const SERVER_RETRY_DELAY_MS = 5000;
124
179
  // A prompt written whole into a single remote exec command line can exceed
125
180
  // the SSH exec channel's / Windows CreateProcess's command-line ceiling once
@@ -165,7 +220,7 @@ async function writePromptFile(agent, strategy, promptFilePath, content) {
165
220
  for (let i = 0; i < chunks.length; i++) {
166
221
  const setup = i === 0 ? `New-Item -Path '${escapedFolder}' -ItemType Directory -Force | Out-Null; ` : '';
167
222
  const cmdlet = i === 0 ? 'Set-Content' : 'Add-Content';
168
- const psScript = `${setup}Set-Location "${escapedFolder}"; ${cmdlet} -Path "${promptFileName}" -Value '${chunks[i].replace(/'/g, "''")}' -NoNewline -Encoding UTF8`;
223
+ const psScript = `${setup}Set-Location "${escapedFolder}"; ${cmdlet} -Path "${promptFileName}" -Value '${escapePowerShellArgInner(chunks[i])}' -NoNewline -Encoding UTF8`;
169
224
  const encoded = Buffer.from(psScript, 'utf16le').toString('base64');
170
225
  // eslint-disable-next-line no-await-in-loop -- each chunk must land before the next appends
171
226
  await strategy.execCommand(`powershell -EncodedCommand ${encoded}`);
@@ -199,12 +254,16 @@ async function deletePromptFile(agent, strategy, promptFilePath, extraPaths = []
199
254
  const promptFileName = path.basename(promptFilePath);
200
255
  const remoteDir = path.dirname(promptFilePath);
201
256
  // apra-fleet-7dir.5.4: gitbash members take the POSIX branch, matching
202
- // writePromptFile above -- and only that branch deletes `extraPaths` (the
203
- // durable stdout mirror), which lives at a POSIX /tmp path PowerShell would
204
- // resolve to a different directory entirely.
257
+ // writePromptFile above -- the durable stdout mirror in `extraPaths` lives
258
+ // at a POSIX /tmp path PowerShell would resolve to a different directory
259
+ // entirely.
205
260
  if (!isPosixShellMember(agent)) {
206
261
  const escapedFolder = escapeWindowsArg(remoteDir);
207
- const psScript = `Set-Location "${escapedFolder}"; Remove-Item "${promptFileName}" -Force -ErrorAction SilentlyContinue`;
262
+ // extraPaths here are only staged credential files (absolute member
263
+ // paths); PowerShell members have no durable stdout mirror.
264
+ // Removed first, by absolute path, independent of the work folder.
265
+ const extras = extraPaths.map(p => `Remove-Item -LiteralPath '${escapePowerShellArgInner(p)}' -Force -ErrorAction SilentlyContinue; `).join('');
266
+ const psScript = `${extras}Set-Location "${escapedFolder}"; Remove-Item "${promptFileName}" -Force -ErrorAction SilentlyContinue`;
208
267
  const encoded = Buffer.from(psScript, 'utf16le').toString('base64');
209
268
  await strategy.execCommand(`powershell -EncodedCommand ${encoded}`).catch(() => { });
210
269
  }
@@ -213,7 +272,10 @@ async function deletePromptFile(agent, strategy, promptFilePath, extraPaths = []
213
272
  // apra-fleet-6z8.1: the durable stdout mirror is cleaned up in the SAME
214
273
  // round trip as the prompt file -- no extra exec per dispatch.
215
274
  const extras = extraPaths.map(p => ` "${escapeDoubleQuoted(p)}"`).join('');
216
- await strategy.execCommand(`cd "${escapedFolder}" && rm -f ${promptFileName}${extras}`).catch(() => { });
275
+ // extraPaths are absolute (durable mirror, staged credential files): removed
276
+ // unconditionally, even when the work folder is gone and the cd fails.
277
+ const extrasRm = extras ? `rm -f${extras}; ` : '';
278
+ await strategy.execCommand(`${extrasRm}cd "${escapedFolder}" && rm -f ${promptFileName}`).catch(() => { });
217
279
  }
218
280
  }
219
281
  export function resolveModelForTier(agent, tier, provider) {
@@ -235,7 +297,7 @@ export { knownRepoRemoteUrl };
235
297
  /**
236
298
  * The sprint id this server process dispatches on behalf of, or undefined when
237
299
  * run outside a sprint (e.g. a manual cli.mjs invocation). Sourced from
238
- * APRA_FLEET_SPRINT_ID, which the auto-sprint spawner stamps into the per-sprint
300
+ * APRA_FLEET_SPRINT_ID, which the fleet-sprint spawner stamps into the per-sprint
239
301
  * server's environment (apra-fleet-eft.10.3). Read on every dispatch so a
240
302
  * reservation set/cleared mid-run is observed without a restart.
241
303
  */
@@ -246,7 +308,7 @@ export function currentSprintId() {
246
308
  const trimmed = raw.trim();
247
309
  return trimmed.length > 0 ? trimmed : undefined;
248
310
  }
249
- export const inFlightAgents = new Set();
311
+ export { inFlightAgents };
250
312
  // Member ids whose remote agent files (planner.md, doer.md, _shared/, schemas/, ...)
251
313
  // have already been probed/refreshed this server process uptime -- the #336
252
314
  // provisioner is a real SSH round trip, so we pay that cost once per member per
@@ -452,6 +514,10 @@ async function executePromptInteractive(agent, renderedPrompt, input, workspaceI
452
514
  }
453
515
  }
454
516
  export async function executePrompt(input, extra) {
517
+ // GitHub #563: max_total_s is measured from HERE, handler entry -- cloud
518
+ // readiness, preflight and agent provisioning are all charged to it, since
519
+ // the client's own deadline (max_total_s + a fixed grace) starts at the call.
520
+ const handlerStartedAt = Date.now();
455
521
  if (hasSecretToken(input.prompt)) {
456
522
  return 'error: execute_prompt prompt contains {{secret.NAME}} token. Secrets must never be passed to LLM prompts. Use execute_command with {{secret.NAME}} instead.';
457
523
  }
@@ -518,7 +584,31 @@ export async function executePrompt(input, extra) {
518
584
  return agentOrError;
519
585
  let agent;
520
586
  try {
521
- agent = await ensureCloudReady(agentOrError); // auto-start if stopped
587
+ // GitHub #563 review: a cold cloud start can take minutes. Bound it by the
588
+ // max_total_s budget (minus the cleanup reserve) so a slow start returns
589
+ // the typed max_total_time error before the client's own deadline. The
590
+ // start itself keeps going in the background; the next call finds the
591
+ // instance running.
592
+ const cloudBudgetMs = input.max_total_s !== undefined
593
+ ? Math.max(0, input.max_total_s * 1000 - Math.min(EXECUTE_PROMPT_CLEANUP_RESERVE_MS, Math.floor(input.max_total_s * 100)) - (Date.now() - handlerStartedAt))
594
+ : undefined;
595
+ const ready = ensureCloudReady(agentOrError); // auto-start if stopped
596
+ if (cloudBudgetMs === undefined) {
597
+ agent = await ready;
598
+ }
599
+ else {
600
+ let budgetTimer;
601
+ const outOfBudget = new Promise((resolve) => { budgetTimer = setTimeout(() => resolve(null), cloudBudgetMs); });
602
+ const raced = await Promise.race([ready, outOfBudget]).finally(() => clearTimeout(budgetTimer));
603
+ if (raced === null) {
604
+ ready.catch(() => { });
605
+ return {
606
+ text: `[FAIL] execute_prompt on "${agentOrError.friendlyName}" exceeded max_total_s (${input.max_total_s}s) while waiting for the cloud member to start -- the start continues in the background; retry shortly.`,
607
+ structuredContent: { isError: true, reason: 'max_total_time', dispatched: false },
608
+ };
609
+ }
610
+ agent = raced;
611
+ }
522
612
  }
523
613
  catch (err) {
524
614
  return `[FAIL] Failed to execute prompt on "${agentOrError.friendlyName}": ${err.message}`;
@@ -671,8 +761,8 @@ export async function executePrompt(input, extra) {
671
761
  // practice, but that is a fact about what each provider adapter currently
672
762
  // advertises, not a name-based pre-filter here -- any provider that
673
763
  // implements the same MCP channel capability is picked up automatically. A
674
- // member CAN still have a live sessionRegistry entry (registerMcpEndpoint
675
- // gives it basic MCP tool access, apra-fleet-fnz.1-3) without that meaning
764
+ // member CAN still have a live sessionRegistry entry (its per-folder
765
+ // apra-fleet MCP entry gives it basic MCP tool access) without that meaning
676
766
  // it can receive or act on this push -- routing to it anyway would silently
677
767
  // spend the full timeout_s waiting for a response that can never arrive.
678
768
  // R2-F3: re-query session registry after the preflight await (10-20s) so
@@ -742,6 +832,14 @@ export async function executePrompt(input, extra) {
742
832
  deadScope.info(`member claude process (pid ${interactivePid}) for "${agent.friendlyName}" is dead -- evicting the stale interactive session and re-dispatching fresh (non-interactive)`);
743
833
  interactiveSession = undefined;
744
834
  }
835
+ // Project-level <workFolder>/.claude/agents files take precedence over the
836
+ // user-level role set; quarantine untracked shadows, report tracked ones on
837
+ // every dispatch. Runs before the interactive/subprocess split so both paths
838
+ // are covered, local members included. Independent of the user-level
839
+ // provisioning below (compares against the canonical set). Never throws.
840
+ const shadowWarning = await ensureNoProjectAgentShadows(agent);
841
+ if (shadowWarning)
842
+ heuristicWarningSuffix += `\n\n[WARN] ${shadowWarning}`;
745
843
  if (interactiveSession?.server) {
746
844
  // Lock already claimed above, before the preflight await -- do not
747
845
  // re-add here (Set.add would be a harmless no-op, but keeping a second
@@ -779,6 +877,9 @@ export async function executePrompt(input, extra) {
779
877
  await ensureAgentFilesProvisioned(agent);
780
878
  const stallDetector = getStallDetector();
781
879
  let clearedByStall = false;
880
+ // GitHub #562: which stall fired -- a frozen transcript, or a session log
881
+ // that never appeared at its authoritative path (the agent never started).
882
+ let stallReason = 'stalled';
782
883
  // apra-fleet-3c9.1: a CONFIRMED stall must not only kill the remote pid but
783
884
  // also cancel the in-flight strategy.execCommand() promise. Before this, the
784
885
  // client kept waiting out its full deriveTimeoutMs deadline after the
@@ -805,7 +906,8 @@ export async function executePrompt(input, extra) {
805
906
  provisional: true,
806
907
  stallReported: false,
807
908
  thresholdMs: stallThresholdMs,
808
- onStall: () => {
909
+ onStall: (reason) => {
910
+ stallReason = reason ?? 'stalled';
809
911
  // Stall detector already wrote 'unknown' to the statusline before calling here.
810
912
  // Our job: clear in-process state so the member can accept new calls.
811
913
  // clearedByStall prevents the eventually-resolving finally block from clobbering
@@ -838,7 +940,6 @@ export async function executePrompt(input, extra) {
838
940
  const strategy = getStrategy(agent);
839
941
  const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
840
942
  const provider = getProvider(agent.llmProvider);
841
- const authPrefix = buildAuthEnvPrefix(agent, getAgentOS(agent));
842
943
  const tiers = provider.modelTiers();
843
944
  let resolvedModel = input.model || 'standard';
844
945
  let resolvedTier;
@@ -903,7 +1004,17 @@ export async function executePrompt(input, extra) {
903
1004
  // fresh session: that is exactly the wrong-context dispatch this feature
904
1005
  // forbids. resume=true/false and fork=true keep their transparent recovery.
905
1006
  const allowFreshSessionFallback = explicitResumeId === undefined && explicitForkId === undefined;
906
- const resuming = !!(resumeRequested && resumeTargetId && provider.supportsResume());
1007
+ // A DEFAULT resume (resume=true) of a stored session recorded under another
1008
+ // server build -- or before builds were stamped -- starts fresh: that
1009
+ // session's transcript lists tools/MCP config this build no longer serves,
1010
+ // and resuming it can end with no tool run yet a "successful" reply.
1011
+ // Explicit-id resumes are the caller's assertion and are left alone.
1012
+ const staleBuildSession = input.resume === true && explicitResumeId === undefined && !forkRequested
1013
+ && !!agent.sessionId && agent.sessionServerVersion !== serverVersion;
1014
+ if (staleBuildSession) {
1015
+ logWarn('execute_prompt', `"${agent.friendlyName}": stored session "${agent.sessionId}" was recorded by server build ${agent.sessionServerVersion ?? '(unrecorded, older build)'}, this server is ${serverVersion} -- starting a fresh session instead of resuming it`, agent);
1016
+ }
1017
+ const resuming = !!(resumeRequested && resumeTargetId && provider.supportsResume()) && !staleBuildSession;
907
1018
  const isCallerMinted = provider.sessionIdStrategy().type === 'caller-minted';
908
1019
  const mintedId = isCallerMinted
909
1020
  ? (resuming ? resumeTargetId : uuid())
@@ -996,6 +1107,14 @@ export async function executePrompt(input, extra) {
996
1107
  const forkDescriptor = forkActive && forkSourceId
997
1108
  ? { sourceSessionId: forkSourceId, newSessionId: mintedId ?? uuid() }
998
1109
  : undefined;
1110
+ // Per-session member MCP config (Claude --mcp-config): the dispatched
1111
+ // session gets the ?member=<uuid> apra-fleet server whatever the folder or
1112
+ // user config says. Path resolved here so every retry (freshOpts spreads
1113
+ // promptOpts) carries it; the file is written with the prompt file below,
1114
+ // and a failed write clears it (fallback: the session's own MCP config).
1115
+ const sessionMcpPath = sessionMcpInjectionAvailable(agent)
1116
+ ? sessionMcpConfigPath(agent, resolvedWorkFolder)
1117
+ : undefined;
999
1118
  const promptOpts = {
1000
1119
  folder: resolvedWorkFolder,
1001
1120
  promptFile: promptFileName,
@@ -1009,6 +1128,7 @@ export async function executePrompt(input, extra) {
1009
1128
  agentName: input.agent,
1010
1129
  fork: forkDescriptor,
1011
1130
  projectId: agyProjectId,
1131
+ ...(sessionMcpPath ? { mcpConfigPath: sessionMcpPath } : {}),
1012
1132
  };
1013
1133
  // apra-fleet issue #390: session log paths live on the MEMBER's machine, under
1014
1134
  // the MEMBER's home directory, joined with the MEMBER's OS convention. Before
@@ -1033,13 +1153,36 @@ export async function executePrompt(input, extra) {
1033
1153
  resolvedLogPath = null;
1034
1154
  }
1035
1155
  }
1156
+ // GitHub #562: a path built from a local or probed home is authoritative --
1157
+ // if it never appears, the agent never started. A username-convention guess
1158
+ // is not, and a missing file there stays a warning.
1159
+ // Known causes of a transcript landing somewhere else make the path a
1160
+ // guess too: a relocated Claude config dir (CLAUDE_CONFIG_DIR, in this
1161
+ // process for a local member or in the member's configured env vars), or a
1162
+ // local POSIX work folder reached through a symlink (the CLI names the
1163
+ // project dir after the physical cwd).
1164
+ const claudeConfigRelocated = (agent.llmProvider ?? 'claude') === 'claude' && (Object.keys(agent.encryptedEnvVars ?? {}).includes('CLAUDE_CONFIG_DIR')
1165
+ || (agent.agentType === 'local' && !!process.env.CLAUDE_CONFIG_DIR));
1166
+ let localCwdIsSymlinked = false;
1167
+ if (agent.agentType === 'local' && process.platform !== 'win32') {
1168
+ try {
1169
+ const real = fs.realpathSync(resolvedWorkFolder);
1170
+ localCwdIsSymlinked = real.replace(/\/+$/, '') !== path.resolve(resolvedWorkFolder).replace(/\/+$/, '');
1171
+ }
1172
+ catch {
1173
+ localCwdIsSymlinked = true; // cannot resolve -> not authoritative
1174
+ }
1175
+ }
1176
+ const logPathAuthoritative = (memberPathCtx.source === 'local' || memberPathCtx.source === 'probe')
1177
+ && !claudeConfigRelocated && !localCwdIsSymlinked;
1036
1178
  stallDetector.update(agent.id, {
1037
1179
  sessionId: activePreSpawnSid,
1038
1180
  logFilePath: resolvedLogPath,
1039
1181
  provisional: !resolvedLogPath,
1040
1182
  thresholdMs: stallThresholdMs,
1183
+ logPathAuthoritative: !!resolvedLogPath && logPathAuthoritative,
1041
1184
  });
1042
- const claudeCmd = authPrefix + cmds.buildAgentPromptCommand(provider, promptOpts);
1185
+ let claudeCmd = cmds.buildAgentPromptCommand(provider, promptOpts);
1043
1186
  // apra-fleet-6z8.1: the per-invocation durable stdout mirror the unix prompt
1044
1187
  // wrapper tees to (see durableOutputPath / buildAgentPromptCommand). A
1045
1188
  // PowerShell Windows member has no such companion tee, so recovery is
@@ -1064,8 +1207,17 @@ export async function executePrompt(input, extra) {
1064
1207
  const durableMirrorSupported = getAgentOS(agent) !== 'windows'
1065
1208
  || (getAgentShell(agent) === 'gitbash' && agent.agentType !== 'local');
1066
1209
  const durablePath = durableMirrorSupported ? durableOutputPath(scope.getInv()) : undefined;
1067
- const dispatchStartedAt = Date.now();
1210
+ // GitHub #563: the shared deadline is anchored at handler entry, not here --
1211
+ // setup awaits above (cloud readiness, preflight, provisioning) count.
1212
+ const dispatchStartedAt = handlerStartedAt;
1068
1213
  const maxTotalMs = input.max_total_s !== undefined ? input.max_total_s * 1000 : undefined;
1214
+ // Time kept back from every attempt's budget for the finally-block prompt
1215
+ // file cleanup and the response, so the whole call settles inside
1216
+ // max_total_s and well within the client's max_total_s + grace window.
1217
+ // Fixed 5s, capped at 10% of a very small max_total_s.
1218
+ const cleanupReserveMs = maxTotalMs !== undefined
1219
+ ? Math.min(EXECUTE_PROMPT_CLEANUP_RESERVE_MS, Math.floor(maxTotalMs / 10))
1220
+ : 0;
1069
1221
  // apra-fleet-25yl.2.1: the exec-level ROLLING (inactivity) deadline handed to
1070
1222
  // strategy.execCommand() is no longer provider-blind. It used to be
1071
1223
  // `timeout_s` for everyone, which is a false kill for the batch-only
@@ -1112,7 +1264,7 @@ export async function executePrompt(input, extra) {
1112
1264
  function retryBudget() {
1113
1265
  if (maxTotalMs === undefined)
1114
1266
  return { timeoutMs, maxTotalMs: undefined, exhausted: false };
1115
- const remaining = Math.max(0, maxTotalMs - (Date.now() - dispatchStartedAt));
1267
+ const remaining = Math.max(0, maxTotalMs - cleanupReserveMs - (Date.now() - dispatchStartedAt));
1116
1268
  return { timeoutMs: Math.min(timeoutMs, remaining), maxTotalMs: remaining, exhausted: remaining <= 0 };
1117
1269
  }
1118
1270
  // Agent file validation -- verify named agent exists before any CLI invocation
@@ -1215,10 +1367,64 @@ export async function executePrompt(input, extra) {
1215
1367
  };
1216
1368
  }
1217
1369
  }
1218
- // Kill any leftover session from a previous (possibly zombie) execute_prompt call
1219
- await tryKillPid(agent, strategy, cmds);
1220
- // Write the rendered prompt (with substitutions applied) to the prompt file before execution
1221
- await writePromptFile(agent, strategy, promptFilePath, renderedPrompt);
1370
+ // Stage the first attempt's credential file BEFORE touching the member
1371
+ // (kill, prompt write, dispatch). A delivery failure (relay member, SFTP
1372
+ // subsystem disabled) is deterministic: a typed failure, never retried.
1373
+ const stagedEnvPaths = [];
1374
+ /** Per-dispatch session MCP config files to remove with the prompt file. */
1375
+ const sessionMcpCleanup = [];
1376
+ let preStaged;
1377
+ try {
1378
+ preStaged = await stageAuthEnv(agent);
1379
+ }
1380
+ catch (err) {
1381
+ if (!(err instanceof SecretDeliveryError))
1382
+ throw err;
1383
+ scope.abort(`secret delivery unavailable (no LLM call)`);
1384
+ inFlightAgents.delete(agent.id);
1385
+ stallDetector.remove(agent.id);
1386
+ writeStatusline(new Map([[agent.id, 'idle']]));
1387
+ return {
1388
+ text: `[FAIL] execute_prompt on "${agent.friendlyName}" rejected -- ${err.message} No LLM call was made.`,
1389
+ structuredContent: { isError: true, reason: 'secret_delivery_unavailable' },
1390
+ };
1391
+ }
1392
+ if (preStaged.path)
1393
+ stagedEnvPaths.push(preStaged.path);
1394
+ try {
1395
+ // Kill any leftover session from a previous (possibly zombie) execute_prompt call
1396
+ await tryKillPid(agent, strategy, cmds);
1397
+ // Write the rendered prompt (with substitutions applied) to the prompt file before execution
1398
+ await writePromptFile(agent, strategy, promptFilePath, renderedPrompt);
1399
+ }
1400
+ catch (err) {
1401
+ if (preStaged.path)
1402
+ await removeMemberSecretFile(agent, preStaged.path);
1403
+ throw err;
1404
+ }
1405
+ if (sessionMcpPath) {
1406
+ const memberExec = (cmd, t) => strategy.execCommand(cmd, t);
1407
+ // Non-deferral of the member's kb_*/code_* tools (Claude: alwaysLoad in
1408
+ // the session config). When it cannot be applied the config is still
1409
+ // attached, the tools stay deferred, and the cause is logged.
1410
+ const loadPolicy = await resolveSessionMcpAlwaysLoad(agent, provider.mcpAlwaysLoadMinVersion?.(), cmds.agentVersion(provider), memberExec);
1411
+ if (loadPolicy.warning)
1412
+ scope.warn(`session MCP config: ${loadPolicy.warning}`);
1413
+ const wrote = await writeSessionMcpConfig(agent, sessionMcpPath, memberExec, { alwaysLoad: loadPolicy.alwaysLoad });
1414
+ if (wrote.ok) {
1415
+ if (sessionMcpConfigIsPerDispatch(agent))
1416
+ sessionMcpCleanup.push(sessionMcpPath);
1417
+ }
1418
+ else {
1419
+ // Fallback, never zero: dispatch without the flag; the session then
1420
+ // uses the per-folder / user-scope apra-fleet entry it would have had.
1421
+ scope.warn(`session MCP config not written (${wrote.detail}); dispatching without --mcp-config`);
1422
+ delete promptOpts.mcpConfigPath;
1423
+ claudeCmd = cmds.buildAgentPromptCommand(provider, promptOpts);
1424
+ if (sessionMcpConfigIsPerDispatch(agent))
1425
+ sessionMcpCleanup.push(sessionMcpPath);
1426
+ }
1427
+ }
1222
1428
  // apra-fleet-6z8.1: remembered for the lease-of-life gate below -- the pid
1223
1429
  // outlives the SSH channel that reported it, and is the only way to tell a
1224
1430
  // fabricated "exit 0 / empty" close apart from a real one.
@@ -1239,6 +1445,7 @@ export async function executePrompt(input, extra) {
1239
1445
  logFilePath: logPath,
1240
1446
  provisional: !logPath,
1241
1447
  thresholdMs: stallThresholdMs,
1448
+ logPathAuthoritative: !!logPath && logPathAuthoritative,
1242
1449
  });
1243
1450
  }
1244
1451
  };
@@ -1255,12 +1462,74 @@ export async function executePrompt(input, extra) {
1255
1462
  const dispatchSignal = extra?.signal
1256
1463
  ? AbortSignal.any([extra.signal, stallAbortController.signal])
1257
1464
  : stallAbortController.signal;
1465
+ // GitHub #563 review: when the inactivity window is as long as the attempt's
1466
+ // remaining max_total_s budget (timeout_s >= max_total_s -- every
1467
+ // fleet-sprint dispatch, and Claude's total-ceiling mode), both timers come
1468
+ // due together and the inactivity one, armed first, wins the tie. That
1469
+ // kill IS the max_total_s ceiling, so it is classified as max_total_time.
1470
+ let lastAttempt;
1471
+ // Stored auth env vars reach the CLI through a per-attempt owner-only file
1472
+ // the command loads and deletes (stageAuthEnv) -- never as inline values in
1473
+ // the command line, which would sit in the member shell's argv (readable
1474
+ // via ps) for the whole dispatch. Each attempt stages its own file because
1475
+ // the prefix deletes it once loaded; any file a failed attempt left behind
1476
+ // is removed with the prompt file at the end.
1477
+ // The first attempt uses the file staged before dispatch (preStaged).
1478
+ // The session whose saved cost total the last dispatched invocation started
1479
+ // from: the resumed session (or a fork's source) for the original command,
1480
+ // nothing for every fresh-session retry. Read by parseDispatch below.
1481
+ // Compared against the UNPREFIXED cmd: the auth-env prefix is added here,
1482
+ // per attempt, so it never affects the resume-cost-delta decision.
1483
+ let lastAttemptContinues;
1484
+ const dispatchAttempt = async (cmd, attemptTimeoutMs, attemptMaxTotalMs) => {
1485
+ lastAttempt = { timeoutMs: attemptTimeoutMs, maxTotalMs: attemptMaxTotalMs };
1486
+ lastAttemptContinues = cmd === claudeCmd
1487
+ ? (forkDescriptor ? forkDescriptor.sourceSessionId : (resuming ? resumeTargetId : undefined))
1488
+ : undefined;
1489
+ let staged = preStaged;
1490
+ preStaged = undefined;
1491
+ if (!staged) {
1492
+ staged = await stageAuthEnv(agent);
1493
+ if (staged.path)
1494
+ stagedEnvPaths.push(staged.path);
1495
+ }
1496
+ return strategy.execCommand(staged.prefix + cmd, attemptTimeoutMs, attemptMaxTotalMs, onPidCaptured, dispatchSignal);
1497
+ };
1498
+ const isMaxTotalKill = (err) => {
1499
+ const msg = err?.message;
1500
+ if (maxTotalMs === undefined || typeof msg !== 'string')
1501
+ return false;
1502
+ if (/exceeded max total time/i.test(msg))
1503
+ return true;
1504
+ return /of inactivity/i.test(msg) && lastAttempt?.maxTotalMs !== undefined
1505
+ && lastAttempt.timeoutMs >= lastAttempt.maxTotalMs;
1506
+ };
1258
1507
  // Mark agent as busy in statusline
1259
1508
  writeStatusline(new Map([[agent.id, 'busy']]));
1260
1509
  let _epExitCode = 'error';
1261
1510
  let _epError;
1262
1511
  let _epUsage;
1263
1512
  let _epOffline = false;
1513
+ // The last session id a provider parse produced. Typed failures that follow a
1514
+ // parse (max_turns_exhausted, empty_response, dispatch_failed) carry it so an
1515
+ // explicit-id resume of that exact session passes isKnownSession.
1516
+ let _epParsedSid;
1517
+ const sessionIdField = (sid) => {
1518
+ if (!sid)
1519
+ return {};
1520
+ recordKnownSession(agent.id, sid);
1521
+ return { sessionId: sid };
1522
+ };
1523
+ // GitHub #563: the typed result for a dispatch that ran out of max_total_s
1524
+ // (measured from handler entry), so callers never see a raw transport timeout.
1525
+ // dispatched=false: the budget ran out before anything was sent to the
1526
+ // member, so callers can skip publishing work that cannot exist.
1527
+ const maxTotalTimeResult = (dispatched = true) => ({
1528
+ text: dispatched
1529
+ ? `[FAIL] execute_prompt on "${agent.friendlyName}" exceeded max_total_s (${input.max_total_s}s, measured from the call, including setup) -- the dispatch was stopped.`
1530
+ : `[FAIL] execute_prompt on "${agent.friendlyName}" exceeded max_total_s (${input.max_total_s}s, measured from the call) during setup -- nothing was dispatched.`,
1531
+ structuredContent: { isError: true, reason: 'max_total_time', ...(dispatched ? {} : { dispatched: false }) },
1532
+ });
1264
1533
  // apra-fleet-6a7.1: gates the exit-0/empty-stdout workspace_not_trusted
1265
1534
  // self-heal-and-retry below to exactly one attempt per call, mirroring
1266
1535
  // runGitStep's authHealAttempted shape (fleet-sprint/runner.js:616) -- a
@@ -1276,7 +1545,126 @@ export async function executePrompt(input, extra) {
1276
1545
  // since a 0-exit result event whose text carries the limit message must not
1277
1546
  // be returned as a success response either.
1278
1547
  // The member's OS reaches the parser (agy's permission-denial hint differs on Windows).
1279
- const parseCtx = { agentOs: agent.os };
1548
+ // unattended + model let the provider tell which permission mode the
1549
+ // session ran in (Claude: a denial in auto mode is never healable).
1550
+ const parseCtx = { agentOs: agent.os, unattended: agent.unattended, model: resolvedModel };
1551
+ // Session-id assertion: the returned id must match the one we minted/resumed.
1552
+ // apra-fleet-lmtg.5: a fork now gets the SAME assertion as any other
1553
+ // caller-minted session. mintedId is explicitly passed to the CLI as
1554
+ // --session-id even in fork mode (provider.forkFlag/buildForkFlag), and the
1555
+ // CLI honors it -- so it is no longer a placeholder the CLI silently
1556
+ // discards, and a genuine mismatch is a real signal worth catching rather
1557
+ // than something to exempt. Shared by the success path and the
1558
+ // permission_denied early return so the two cannot drift apart.
1559
+ const sessionExpectation = (p) => {
1560
+ const expectedSid = resuming ? resumeTargetId : (isCallerMinted ? mintedId : undefined);
1561
+ return { expectedSid, isMismatch: !!(expectedSid && p.sessionId && p.sessionId !== expectedSid) };
1562
+ };
1563
+ // A mismatch on an EXPLICIT resume/fork with no fresh-session fallback is
1564
+ // terminal: the caller asked for that exact session and did not get it.
1565
+ const mismatchIsTerminal = () => !allowFreshSessionFallback && (explicitResumeId !== undefined || explicitForkId !== undefined);
1566
+ // The terminal session_not_found failure for such a mismatch, with the
1567
+ // returned session's usage still recorded. `extra` rides on structuredContent
1568
+ // (the permission_denied path attaches its denial).
1569
+ const terminalMismatchFailure = async (p, expectedSid, extra = {}) => {
1570
+ inFlightAgents.delete(agent.id);
1571
+ stallDetector.remove(agent.id);
1572
+ writeStatusline(new Map([[agent.id, 'idle']]));
1573
+ clearStoredPid(agent.id);
1574
+ if (p.sessionId) {
1575
+ recordKnownSession(agent.id, p.sessionId);
1576
+ }
1577
+ if (p.usage) {
1578
+ const prev = agent.tokenUsage ?? { input: 0, output: 0 };
1579
+ updateAgent(agent.id, {
1580
+ tokenUsage: {
1581
+ input: prev.input + p.usage.input_tokens,
1582
+ output: prev.output + p.usage.output_tokens,
1583
+ },
1584
+ });
1585
+ recordSessionUsage(p.sessionId ?? expectedSid, p.usage);
1586
+ if (budgetScope) {
1587
+ await recordAndEvaluate({ scope: budgetScope, agent, provider, tier: resolvedTier, usage: p.usage });
1588
+ }
1589
+ }
1590
+ return {
1591
+ text: `[FAIL] execute_prompt on "${agent.friendlyName}" failed -- resumed session mismatch. Expected session "${expectedSid}", but provider returned "${p.sessionId}".`,
1592
+ structuredContent: {
1593
+ isError: true,
1594
+ reason: 'session_not_found',
1595
+ sessionId: expectedSid,
1596
+ returnedSessionId: p.sessionId,
1597
+ ...(p.usage ? { usage: toStructuredUsage(p.usage) } : {}),
1598
+ ...extra,
1599
+ },
1600
+ };
1601
+ };
1602
+ // apra-fleet-eft.78.1: mark the session this dispatch actually landed on as
1603
+ // known/resumable for this member (so a later explicit-id resume of it passes
1604
+ // the terminal session_not_found gate), and hand the stall detector the
1605
+ // session's real log path.
1606
+ const recordLandedSession = (finalSid) => {
1607
+ if (!finalSid)
1608
+ return;
1609
+ recordKnownSession(agent.id, finalSid);
1610
+ let postLogPath = null;
1611
+ try {
1612
+ postLogPath = resolveSessionLogPath(agent.llmProvider ?? 'claude', finalSid, resolvedWorkFolder, memberPathCtx.homeDir, memberPathCtx.targetOs);
1613
+ }
1614
+ catch {
1615
+ postLogPath = null;
1616
+ }
1617
+ stallDetector.update(agent.id, {
1618
+ sessionId: finalSid,
1619
+ logFilePath: postLogPath,
1620
+ provisional: !postLogPath,
1621
+ thresholdMs: stallThresholdMs,
1622
+ logPathAuthoritative: !!postLogPath && logPathAuthoritative,
1623
+ });
1624
+ };
1625
+ // The session/usage/budget/PID bookkeeping a dispatch that RAN gets, for an
1626
+ // early return that is not the success path (permission_denied): the
1627
+ // member's stored session advances (a mismatched id is not persisted, as on
1628
+ // the success path) so a later resume continues this turn, the stall
1629
+ // detector learns the landed session, the spend reaches the member total,
1630
+ // the session total and the budget, and the stored PID is cleared. Same
1631
+ // order and side effects as the success path.
1632
+ const recordDispatchBookkeeping = async (p, expectation = sessionExpectation(p)) => {
1633
+ const { expectedSid, isMismatch } = expectation;
1634
+ if (isMismatch)
1635
+ touchAgent(agent.id, undefined);
1636
+ else
1637
+ touchAgent(agent.id, p.sessionId ?? expectedSid);
1638
+ recordLandedSession(p.sessionId ?? expectedSid);
1639
+ clearStoredPid(agent.id);
1640
+ if (p.usage) {
1641
+ const prev = agent.tokenUsage ?? { input: 0, output: 0 };
1642
+ updateAgent(agent.id, {
1643
+ tokenUsage: { input: prev.input + p.usage.input_tokens, output: prev.output + p.usage.output_tokens },
1644
+ });
1645
+ recordSessionUsage(p.sessionId ?? mintedId, p.usage);
1646
+ if (budgetScope)
1647
+ await recordAndEvaluate({ scope: budgetScope, agent, provider, tier: resolvedTier, usage: p.usage });
1648
+ }
1649
+ };
1650
+ // Every provider.parseResponse in the dispatch path goes through this, so
1651
+ // a provider-reported cumulative session cost (Claude total_cost_usd) is
1652
+ // turned into THIS dispatch's cost exactly once per invocation, on every
1653
+ // path (success and failure alike), and the session's baseline advances.
1654
+ // The per-dispatch figure rides on usage.cost_usd; when the baseline of a
1655
+ // continued session is unknown it is left off and cost consumers price the
1656
+ // token counts instead.
1657
+ const parseDispatch = (r) => {
1658
+ const p = provider.parseResponse(r, parseCtx);
1659
+ _epParsedSid = p.sessionId;
1660
+ if (typeof p.sessionCostUsd === 'number') {
1661
+ const landedOn = p.sessionId ?? (lastAttemptContinues && !forkDescriptor ? lastAttemptContinues : undefined);
1662
+ const cost = dispatchCostFromCumulative(p.sessionCostUsd, landedOn, lastAttemptContinues);
1663
+ if (cost !== undefined && p.usage)
1664
+ p.usage = { ...p.usage, cost_usd: cost };
1665
+ }
1666
+ return p;
1667
+ };
1280
1668
  const checkUsageLimit = (r, p) => {
1281
1669
  const signal = provider.detectUsageLimit(r, p);
1282
1670
  if (!signal)
@@ -1300,15 +1688,24 @@ export async function executePrompt(input, extra) {
1300
1688
  reason: 'usage_limit',
1301
1689
  usageLimit: signal,
1302
1690
  ...(p.sessionId ? { sessionId: p.sessionId } : {}),
1303
- ...(p.usage ? { usage: { input_tokens: p.usage.input_tokens, output_tokens: p.usage.output_tokens, total_tokens: p.usage.input_tokens + p.usage.output_tokens } } : {}),
1691
+ ...(p.usage ? { usage: toStructuredUsage(p.usage) } : {}),
1304
1692
  },
1305
1693
  };
1306
1694
  };
1307
1695
  claimGuardActive = false;
1308
1696
  try {
1309
1697
  let result;
1698
+ // GitHub #563: the FIRST attempt is capped by the same shared budget as
1699
+ // any retry (max_total_s since handler entry, minus the cleanup reserve),
1700
+ // not handed a fresh full max_total_s after setup already spent some.
1701
+ const firstBudget = retryBudget();
1702
+ if (firstBudget.exhausted) {
1703
+ _epExitCode = 'error';
1704
+ _epError = 'max_total_s exhausted before dispatch';
1705
+ return maxTotalTimeResult(false);
1706
+ }
1310
1707
  try {
1311
- result = await strategy.execCommand(claudeCmd, timeoutMs, maxTotalMs, onPidCaptured, dispatchSignal);
1708
+ result = await dispatchAttempt(claudeCmd, firstBudget.timeoutMs, firstBudget.maxTotalMs);
1312
1709
  }
1313
1710
  catch (dispatchErr) {
1314
1711
  // apra-fleet-02s.1: a genuine command-execution exception (e.g. an
@@ -1344,10 +1741,10 @@ export async function executePrompt(input, extra) {
1344
1741
  scope.info(`[${resolvedModel}] retrying -- dispatch exception: ${dispatchErr.message}`);
1345
1742
  await tryKillPid(agent, strategy, cmds);
1346
1743
  const freshOpts = { ...promptOpts, sessionId: isCallerMinted ? uuid() : undefined, resuming: false, fork: undefined };
1347
- const retryCmd = authPrefix + cmds.buildAgentPromptCommand(provider, freshOpts);
1348
- result = await strategy.execCommand(retryCmd, budget.timeoutMs, budget.maxTotalMs, onPidCaptured, dispatchSignal);
1744
+ const retryCmd = cmds.buildAgentPromptCommand(provider, freshOpts);
1745
+ result = await dispatchAttempt(retryCmd, budget.timeoutMs, budget.maxTotalMs);
1349
1746
  }
1350
- let parsed = provider.parseResponse(result, parseCtx);
1747
+ let parsed = parseDispatch(result);
1351
1748
  if (parsed.usage)
1352
1749
  _epUsage = parsed.usage;
1353
1750
  {
@@ -1366,7 +1763,8 @@ export async function executePrompt(input, extra) {
1366
1763
  if (result.code !== 0 && provider.classifyError(result.stderr || result.stdout) === 'workspace_not_trusted') {
1367
1764
  return {
1368
1765
  text: `[FAIL] ${workspaceNotTrustedAdvice(agent.friendlyName)}\n${result.stderr || result.stdout}`,
1369
- structuredContent: { isError: true, reason: 'workspace_not_trusted' },
1766
+ // A typed failure keeps its own reason; an incidental refusal rides along.
1767
+ structuredContent: { isError: true, reason: 'workspace_not_trusted', ...(parsed.permissionDenial ? { permissionDenied: parsed.permissionDenial } : {}) },
1370
1768
  };
1371
1769
  }
1372
1770
  // Stale session retry -- fresh session ID, no resume. apra-fleet-eft.78.1:
@@ -1388,9 +1786,9 @@ export async function executePrompt(input, extra) {
1388
1786
  scope.info(`[${resolvedModel}] retrying -- stale session`);
1389
1787
  await tryKillPid(agent, strategy, cmds);
1390
1788
  const freshOpts = { ...promptOpts, sessionId: isCallerMinted ? uuid() : undefined, resuming: false, fork: undefined };
1391
- const retryCmd = authPrefix + cmds.buildAgentPromptCommand(provider, freshOpts);
1392
- result = await strategy.execCommand(retryCmd, staleBudget.timeoutMs, staleBudget.maxTotalMs, onPidCaptured, dispatchSignal);
1393
- parsed = provider.parseResponse(result, parseCtx);
1789
+ const retryCmd = cmds.buildAgentPromptCommand(provider, freshOpts);
1790
+ result = await dispatchAttempt(retryCmd, staleBudget.timeoutMs, staleBudget.maxTotalMs);
1791
+ parsed = parseDispatch(result);
1394
1792
  if (parsed.usage)
1395
1793
  _epUsage = parsed.usage;
1396
1794
  const usageLimitResult = checkUsageLimit(result, parsed);
@@ -1410,9 +1808,9 @@ export async function executePrompt(input, extra) {
1410
1808
  await tryKillPid(agent, strategy, cmds);
1411
1809
  await new Promise(r => setTimeout(r, SERVER_RETRY_DELAY_MS));
1412
1810
  const freshOpts = { ...promptOpts, sessionId: isCallerMinted ? uuid() : undefined, resuming: false, fork: undefined };
1413
- const retryCmd = authPrefix + cmds.buildAgentPromptCommand(provider, freshOpts);
1414
- result = await strategy.execCommand(retryCmd, overloadBudget.timeoutMs, overloadBudget.maxTotalMs, onPidCaptured, dispatchSignal);
1415
- parsed = provider.parseResponse(result, parseCtx);
1811
+ const retryCmd = cmds.buildAgentPromptCommand(provider, freshOpts);
1812
+ result = await dispatchAttempt(retryCmd, overloadBudget.timeoutMs, overloadBudget.maxTotalMs);
1813
+ parsed = parseDispatch(result);
1416
1814
  if (parsed.usage)
1417
1815
  _epUsage = parsed.usage;
1418
1816
  const usageLimitResult = checkUsageLimit(result, parsed);
@@ -1421,27 +1819,76 @@ export async function executePrompt(input, extra) {
1421
1819
  }
1422
1820
  }
1423
1821
  _epExitCode = result.code;
1424
- // The member CLI refused tool calls for lack of a grant (AGY headless mode
1425
- // auto-denies them and still exits 0 with status SUCCESS). Report that as
1426
- // a permission failure the caller can heal via compose_permissions, not
1427
- // as an empty response. Only providers whose parser sets
1428
- // permissionDenial reach this; any partial reply is kept.
1429
- if (parsed.permissionDenial) {
1430
- const denial = parsed.permissionDenial;
1431
- const partial = parsed.result?.trim() ? parsed.result.trim() : undefined;
1432
- return {
1433
- text: `[FAIL] execute_prompt on "${agent.friendlyName}": permission denied -- ${denial.hint}${partial ? `\n[partial response]\n${partial}` : ''}`,
1434
- structuredContent: {
1435
- isError: true,
1436
- reason: 'permission_denied',
1437
- permissionDenied: denial,
1438
- ...(partial ? { response: partial } : {}),
1439
- ...(parsed.sessionId ? { sessionId: parsed.sessionId } : {}),
1440
- ...(_epUsage ? { usage: { input_tokens: _epUsage.input_tokens, output_tokens: _epUsage.output_tokens, total_tokens: _epUsage.input_tokens + _epUsage.output_tokens } } : {}),
1441
- },
1442
- };
1822
+ // Permission refusals (parsed.permissionDenial). Order matters:
1823
+ //
1824
+ // 1. A TYPED failure is classified first and wins: a max_turns-terminated
1825
+ // turn, or a nonzero exit the provider classifies as auth / server /
1826
+ // overloaded / workspace_not_trusted. Its reason is what a caller acts
1827
+ // on (fleet-sprint resumes a max_turns turn, re-provisions on auth);
1828
+ // an incidental refusal inside such a turn rides along as an extra
1829
+ // `permissionDenied` field and never turns it into permission_denied.
1830
+ //
1831
+ // 2. Otherwise the caller's choice decides. `fail_on_permission_denial`
1832
+ // (fleet-sprint passes it) makes any refusal a `permission_denied`
1833
+ // failure the caller can heal with compose_permissions -- except a
1834
+ // denial the provider marks healable:false (Claude auto/bypass mode:
1835
+ // safety classifier or deny rule) on a complete reply, which is only a
1836
+ // warning. Without the flag each provider keeps its v0.4.3 semantics:
1837
+ // Claude's reply stands (a complete reply is a success carrying the
1838
+ // refusals as `permissionWarning`; an incomplete one gets its ordinary
1839
+ // classification with the denial attached), while AGY -- whose headless
1840
+ // denials exit 0 with an empty reply -- still fails permission_denied.
1841
+ const denial = parsed.permissionDenial;
1842
+ const strictDenials = input.fail_on_permission_denial === true || provider.name !== 'claude';
1843
+ const typedFailure = isMaxTurnsResponse(parsed)
1844
+ || (result.code !== 0 && TYPED_FAILURE_CATEGORIES.has(provider.classifyError(result.stderr || result.stdout)));
1845
+ const replyComplete = result.code === 0 && !parsed.isError && !!parsed.result?.trim();
1846
+ let permissionWarning;
1847
+ // A denial carried along on a non-permission outcome (typed failure, or
1848
+ // non-strict Claude whose reply was not complete).
1849
+ let carriedDenial;
1850
+ if (denial) {
1851
+ if (typedFailure) {
1852
+ carriedDenial = denial;
1853
+ }
1854
+ else if (replyComplete && (denial.healable === false || !strictDenials)) {
1855
+ permissionWarning = denial;
1856
+ logWarn('permission_denied_incidental', `"${agent.friendlyName}" (${denial.permissionMode ?? 'unknown'} mode): ${denial.hint} -- reply complete, reported as a warning${denial.healable === false ? '; never auto-granted' : ''}.`);
1857
+ }
1858
+ else if (strictDenials) {
1859
+ const partial = parsed.result?.trim() ? parsed.result.trim() : undefined;
1860
+ // The turn ran: keep the session, usage, budget and PID bookkeeping
1861
+ // a completed dispatch gets, so a later resume continues THIS session
1862
+ // and the spend is recorded.
1863
+ const expectation = sessionExpectation(parsed);
1864
+ if (expectation.isMismatch) {
1865
+ scope.info(`session-id mismatch: expected=${expectation.expectedSid} got=${parsed.sessionId} -- not persisting`);
1866
+ if (mismatchIsTerminal())
1867
+ return await terminalMismatchFailure(parsed, expectation.expectedSid, { permissionDenied: denial });
1868
+ }
1869
+ await recordDispatchBookkeeping(parsed, expectation);
1870
+ return {
1871
+ text: `[FAIL] execute_prompt on "${agent.friendlyName}": permission denied -- ${denial.hint}${partial ? `\n[partial response]\n${partial}` : ''}`,
1872
+ structuredContent: {
1873
+ isError: true,
1874
+ reason: 'permission_denied',
1875
+ permissionDenied: denial,
1876
+ ...(partial ? { response: partial } : {}),
1877
+ ...(parsed.sessionId ? { sessionId: parsed.sessionId } : {}),
1878
+ ...(_epUsage ? { usage: toStructuredUsage(_epUsage) } : {}),
1879
+ },
1880
+ };
1881
+ }
1882
+ else {
1883
+ carriedDenial = denial;
1884
+ }
1443
1885
  }
1886
+ const carriedDenialField = carriedDenial ? { permissionDenied: carriedDenial } : {};
1444
1887
  if (result.code !== 0) {
1888
+ // GitHub #585: a failed dispatch used to log only exit=N. Log a capped
1889
+ // stderr tail plus the last result/error event (logLine applies the
1890
+ // usual secret redaction). Success paths log nothing extra.
1891
+ logLine('prompt_failure_output', formatPromptFailureTail(result), { id: agent.id, friendlyName: agent.friendlyName }, scope.getInv());
1445
1892
  // apra-fleet-391: surface an auth failure as a STRUCTURED reason (not
1446
1893
  // just prose in `text`) so callers -- notably fleet-sprint's
1447
1894
  // isAuthDispatchError -- can key off it directly instead of regexing
@@ -1476,7 +1923,9 @@ export async function executePrompt(input, extra) {
1476
1923
  // 10-hour run with dozens of max_turns exhaustions reporting
1477
1924
  // stats.totalCost of $0). Attach it here whenever it's available so
1478
1925
  // the caller can record the real partial cost instead of nothing.
1479
- ...(_epUsage ? { usage: { input_tokens: _epUsage.input_tokens, output_tokens: _epUsage.output_tokens, total_tokens: _epUsage.input_tokens + _epUsage.output_tokens } } : {}),
1926
+ ...(_epUsage ? { usage: toStructuredUsage(_epUsage) } : {}),
1927
+ ...sessionIdField(parsed.sessionId),
1928
+ ...carriedDenialField,
1480
1929
  },
1481
1930
  };
1482
1931
  }
@@ -1515,7 +1964,7 @@ export async function executePrompt(input, extra) {
1515
1964
  // short-circuits every Windows member: it selects the POSIX
1516
1965
  // `kill -0` / `cat` probes over the PowerShell ones (apra-fleet-7dir.2.4).
1517
1966
  shell: getAgentShell(agent),
1518
- maxWaitMs: maxTotalMs !== undefined ? Math.max(maxTotalMs - (Date.now() - dispatchStartedAt), 0) : undefined,
1967
+ maxWaitMs: maxTotalMs !== undefined ? retryBudget().maxTotalMs : undefined,
1519
1968
  scope,
1520
1969
  });
1521
1970
  if (recovery.status === 'timeout') {
@@ -1529,7 +1978,7 @@ export async function executePrompt(input, extra) {
1529
1978
  // Feed the durable output through the normal provider parse path,
1530
1979
  // exactly as if it had arrived on the original channel.
1531
1980
  const recoveredResult = { stdout: recovery.stdout, stderr: result.stderr ?? '', code: 0 };
1532
- const recoveredParsed = provider.parseResponse(recoveredResult, parseCtx);
1981
+ const recoveredParsed = parseDispatch(recoveredResult);
1533
1982
  if (recoveredParsed.result && recoveredParsed.result.trim() !== '') {
1534
1983
  scope.info(`recovered the real result from the durable output file after a false-alarm empty_response (waited ${Math.round((recovery.waitedMs ?? 0) / 1000)}s)`);
1535
1984
  parsed = recoveredParsed;
@@ -1563,9 +2012,9 @@ export async function executePrompt(input, extra) {
1563
2012
  if (!healBudget.exhausted) {
1564
2013
  await tryKillPid(agent, strategy, cmds);
1565
2014
  const freshOpts = { ...promptOpts, sessionId: isCallerMinted ? uuid() : undefined, resuming: false, fork: undefined };
1566
- const retryCmd = authPrefix + cmds.buildAgentPromptCommand(provider, freshOpts);
1567
- result = await strategy.execCommand(retryCmd, healBudget.timeoutMs, healBudget.maxTotalMs, onPidCaptured, dispatchSignal);
1568
- parsed = provider.parseResponse(result, parseCtx);
2015
+ const retryCmd = cmds.buildAgentPromptCommand(provider, freshOpts);
2016
+ result = await dispatchAttempt(retryCmd, healBudget.timeoutMs, healBudget.maxTotalMs);
2017
+ parsed = parseDispatch(result);
1569
2018
  if (parsed.usage)
1570
2019
  _epUsage = parsed.usage;
1571
2020
  const usageLimitResult = checkUsageLimit(result, parsed);
@@ -1580,79 +2029,22 @@ export async function executePrompt(input, extra) {
1580
2029
  text: trustClassified
1581
2030
  ? `[FAIL] ${workspaceNotTrustedAdvice(agent.friendlyName)}\n${stderrTail}`
1582
2031
  : `[FAIL] execute_prompt on "${agent.friendlyName}" exited 0 but produced no parseable output (empty result -- the member CLI likely died mid-turn without printing its result envelope).${stderrTail ? `\n[stderr tail]\n${stderrTail}` : ''}`,
1583
- structuredContent: { isError: true, reason: trustClassified ? 'workspace_not_trusted' : 'empty_response' },
2032
+ structuredContent: { isError: true, reason: trustClassified ? 'workspace_not_trusted' : 'empty_response', ...(trustClassified ? {} : sessionIdField(parsed.sessionId)), ...carriedDenialField },
1584
2033
  };
1585
2034
  }
1586
2035
  }
1587
- // Session-id assertion: returned id must match the one we minted/resumed.
1588
- // apra-fleet-lmtg.5: a fork now gets the SAME assertion as any other
1589
- // caller-minted session. mintedId is explicitly passed to the CLI as
1590
- // --session-id even in fork mode (provider.forkFlag/buildForkFlag), and the
1591
- // CLI honors it -- so it is no longer a placeholder the CLI silently
1592
- // discards, and a genuine mismatch here is a real signal worth catching
1593
- // rather than something to exempt.
1594
- const expectedSid = resuming ? resumeTargetId : (isCallerMinted ? mintedId : undefined);
1595
- const isMismatch = expectedSid && parsed.sessionId && parsed.sessionId !== expectedSid;
2036
+ // Session-id assertion (see sessionExpectation).
2037
+ const { expectedSid, isMismatch } = sessionExpectation(parsed);
1596
2038
  if (isMismatch) {
1597
2039
  scope.info(`session-id mismatch: expected=${expectedSid} got=${parsed.sessionId} -- not persisting`);
1598
- if (!allowFreshSessionFallback && (explicitResumeId !== undefined || explicitForkId !== undefined)) {
1599
- inFlightAgents.delete(agent.id);
1600
- stallDetector.remove(agent.id);
1601
- writeStatusline(new Map([[agent.id, 'idle']]));
1602
- clearStoredPid(agent.id);
1603
- if (parsed.sessionId) {
1604
- recordKnownSession(agent.id, parsed.sessionId);
1605
- }
1606
- if (parsed.usage) {
1607
- const prev = agent.tokenUsage ?? { input: 0, output: 0 };
1608
- updateAgent(agent.id, {
1609
- tokenUsage: {
1610
- input: prev.input + parsed.usage.input_tokens,
1611
- output: prev.output + parsed.usage.output_tokens,
1612
- },
1613
- });
1614
- recordSessionUsage(parsed.sessionId ?? expectedSid, parsed.usage);
1615
- if (budgetScope) {
1616
- await recordAndEvaluate({ scope: budgetScope, agent, provider, tier: resolvedTier, usage: parsed.usage });
1617
- }
1618
- }
1619
- return {
1620
- text: `[FAIL] execute_prompt on "${agent.friendlyName}" failed -- resumed session mismatch. Expected session "${expectedSid}", but provider returned "${parsed.sessionId}".`,
1621
- structuredContent: {
1622
- isError: true,
1623
- reason: 'session_not_found',
1624
- sessionId: expectedSid,
1625
- returnedSessionId: parsed.sessionId,
1626
- ...(parsed.usage ? { usage: { ...parsed.usage, total_tokens: parsed.usage.input_tokens + parsed.usage.output_tokens } } : {}),
1627
- },
1628
- };
1629
- }
2040
+ if (mismatchIsTerminal())
2041
+ return await terminalMismatchFailure(parsed, expectedSid);
1630
2042
  touchAgent(agent.id, undefined);
1631
2043
  }
1632
2044
  else {
1633
2045
  touchAgent(agent.id, parsed.sessionId ?? expectedSid);
1634
2046
  }
1635
- // apra-fleet-eft.78.1: mark the session this dispatch actually landed on as
1636
- // known/resumable for this member, so a later explicit-id resume of it
1637
- // passes the terminal session_not_found gate above instead of being
1638
- // rejected as unknown.
1639
- const finalSid = parsed.sessionId ?? expectedSid;
1640
- if (finalSid) {
1641
- recordKnownSession(agent.id, finalSid);
1642
- let postLogPath = null;
1643
- try {
1644
- postLogPath = resolveSessionLogPath(agent.llmProvider ?? 'claude', finalSid, resolvedWorkFolder, memberPathCtx.homeDir, memberPathCtx.targetOs);
1645
- }
1646
- catch {
1647
- postLogPath = null;
1648
- }
1649
- stallDetector.update(agent.id, {
1650
- sessionId: finalSid,
1651
- logFilePath: postLogPath,
1652
- provisional: !postLogPath,
1653
- thresholdMs: stallThresholdMs,
1654
- });
1655
- }
2047
+ recordLandedSession(parsed.sessionId ?? expectedSid);
1656
2048
  clearStoredPid(agent.id);
1657
2049
  if (parsed.usage) {
1658
2050
  const prev = agent.tokenUsage ?? { input: 0, output: 0 };
@@ -1723,17 +2115,19 @@ session: ${parsed.sessionId}`;
1723
2115
  // paths at all, and an entry with no basis is refused by design. A high
1724
2116
  // rejected count is the invariant working, not a regression to tune away.
1725
2117
  void import('./kb-harvest.js')
1726
- .then(({ kbHarvest }) => kbHarvest({
1727
- repo_path: resolvedWorkFolder,
1728
- repo_remote_url: knownRepoRemoteUrl(agent),
2118
+ .then(({ kbHarvest }) =>
2119
+ // Explicit in-process anchor (not a tool input): this harvest is for
2120
+ // the dispatched member's repo, not the server's own session.
2121
+ kbHarvest({
1729
2122
  session_transcript: parsed.result,
1730
2123
  session_id: parsed.sessionId,
1731
- }))
2124
+ }, { folder: resolvedWorkFolder, remoteUrl: knownRepoRemoteUrl(agent) }))
1732
2125
  .then((raw) => {
1733
2126
  try {
1734
2127
  const r = JSON.parse(raw);
1735
- if (r.entries_captured || r.entries_updated || r.entries_skipped || r.entries_rejected) {
1736
- logLine('kb_harvest', `auto-harvest: captured=${r.entries_captured} updated=${r.entries_updated} skipped=${r.entries_skipped} rejected=${r.entries_rejected}`);
2128
+ const failed = r.entries_failed ?? 0;
2129
+ if (r.entries_captured || r.entries_updated || r.entries_skipped || r.entries_rejected || failed) {
2130
+ logLine('kb_harvest', `auto-harvest: captured=${r.entries_captured} updated=${r.entries_updated} skipped=${r.entries_skipped} rejected=${r.entries_rejected} failed=${failed}`);
1737
2131
  }
1738
2132
  }
1739
2133
  catch {
@@ -1744,14 +2138,20 @@ session: ${parsed.sessionId}`;
1744
2138
  }
1745
2139
  if (heuristicWarningSuffix)
1746
2140
  output += heuristicWarningSuffix;
2141
+ // A refusal that did not fail the dispatch (incidental, or carried on a
2142
+ // turn that still exited 0) rides on the success as a warning.
2143
+ const successWarning = permissionWarning ?? carriedDenial;
2144
+ if (successWarning)
2145
+ output += `\n\n[WARN] ${successWarning.hint}`;
1747
2146
  return {
1748
2147
  text: output,
1749
2148
  structuredContent: {
1750
2149
  response: parsed.result,
1751
- ...(_epUsage ? { usage: { input_tokens: _epUsage.input_tokens, output_tokens: _epUsage.output_tokens, total_tokens: _epUsage.input_tokens + _epUsage.output_tokens } } : {}),
2150
+ ...(_epUsage ? { usage: toStructuredUsage(_epUsage) } : {}),
1752
2151
  ...(parsed.sessionId ? { sessionId: parsed.sessionId } : {}),
1753
2152
  ...(contextWarning ? { contextWarning } : {}),
1754
2153
  ...(budgetUsage ? { budgetUsage } : {}),
2154
+ ...(successWarning ? { permissionWarning: successWarning } : {}),
1755
2155
  },
1756
2156
  };
1757
2157
  }
@@ -1760,6 +2160,13 @@ session: ${parsed.sessionId}`;
1760
2160
  // NOT the MCP client). Surface it as a typed 'stalled' error so the dispatch
1761
2161
  // settles here -- well under the client hard timeout -- instead of being
1762
2162
  // mislabeled dispatch_failed or waiting out the full deadline.
2163
+ if (stallAbortController.signal.aborted && !extra?.signal?.aborted && stallReason === 'agent_never_started') {
2164
+ _epError = 'dispatch aborted: agent never started (session log never appeared)';
2165
+ return {
2166
+ text: `[FAIL] execute_prompt on "${agent.friendlyName}" was aborted: the agent never started -- its session log never appeared at the expected path within the inactivity threshold (timeout_s). Its process was killed and the dispatch cancelled.`,
2167
+ structuredContent: { isError: true, reason: 'agent_never_started' },
2168
+ };
2169
+ }
1763
2170
  if (stallAbortController.signal.aborted && !extra?.signal?.aborted) {
1764
2171
  _epError = 'dispatch aborted by confirmed stall';
1765
2172
  return {
@@ -1767,17 +2174,22 @@ session: ${parsed.sessionId}`;
1767
2174
  structuredContent: { isError: true, reason: 'stalled' },
1768
2175
  };
1769
2176
  }
2177
+ // GitHub #563: the shared max_total_s ceiling fired -- a typed error.
2178
+ if (isMaxTotalKill(err)) {
2179
+ _epError = err.message;
2180
+ return maxTotalTimeResult();
2181
+ }
1770
2182
  // Only mark offline for genuine SSH/network connection failures, not for cancellations
1771
2183
  _epOffline = !!(err.message && /ssh|network|econnrefused|ehostunreach|connection timed out/i.test(err.message));
1772
2184
  _epError = err.message;
1773
2185
  return {
1774
2186
  text: `[FAIL] Failed to execute prompt on "${agent.friendlyName}": ${err.message}`,
1775
- structuredContent: { isError: true, reason: 'dispatch_failed' },
2187
+ structuredContent: { isError: true, reason: 'dispatch_failed', ...sessionIdField(_epParsedSid) },
1776
2188
  };
1777
2189
  }
1778
2190
  finally {
1779
2191
  extra?.signal?.removeEventListener('abort', abortHandler);
1780
- const _epTok = _epUsage ? ` in=${_epUsage.input_tokens} out=${_epUsage.output_tokens}` : '';
2192
+ const _epTok = _epUsage ? ` in=${_epUsage.input_tokens} out=${_epUsage.output_tokens} cache_read=${_epUsage.cache_read_input_tokens ?? 0} cache_write=${_epUsage.cache_creation_input_tokens ?? 0}` : '';
1781
2193
  if (_epExitCode === 'error')
1782
2194
  scope.abort(`${_epError ?? 'exception'}${_epTok}`);
1783
2195
  else if (_epExitCode !== 0)
@@ -1791,13 +2203,16 @@ session: ${parsed.sessionId}`;
1791
2203
  inFlightAgents.delete(agent.id);
1792
2204
  }
1793
2205
  stallDetector.remove(agent.id);
1794
- await deletePromptFile(agent, strategy, promptFilePath, durablePath ? [durablePath] : []);
2206
+ await deletePromptFile(agent, strategy, promptFilePath, [...(durablePath ? [durablePath] : []), ...stagedEnvPaths, ...sessionMcpCleanup]);
1795
2207
  }
1796
2208
  }
1797
2209
  catch (err) {
1798
2210
  if (claimGuardActive) {
1799
2211
  inFlightAgents.delete(agent.id);
1800
2212
  getStallDetector().remove(agent.id);
2213
+ // The stall detector writes busy(mm:ss) on every tick once its entry
2214
+ // exists; removing the entry alone would leave that busy persisted.
2215
+ writeStatusline(new Map([[agent.id, 'idle']]));
1801
2216
  }
1802
2217
  throw err;
1803
2218
  }