@apralabs/apra-fleet 0.4.2 → 0.4.4

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 (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  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 +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  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 +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -18,7 +18,7 @@
18
18
  "./viewer/lean-state": "./src/viewer/lean-state.mjs"
19
19
  },
20
20
  "scripts": {
21
- "test": "node --test --test-timeout=60000 test/*.test.mjs"
21
+ "test": "node ../../scripts/with-test-sandbox.mjs node --test --test-timeout=60000 test/*.test.mjs"
22
22
  },
23
23
  "type": "module",
24
24
  "dependencies": {
@@ -8,6 +8,8 @@ import { getRunningRunStatePath, getTerminalRunStatePath } from './run-state-pat
8
8
  import { buildListStatePayload, resolveStringRefs } from './lean-state.mjs';
9
9
  import { capCommandActivityMeta, getFullOutput } from './command-output-cap.mjs';
10
10
  import { buildRunTitle } from './run-title.mjs';
11
+ import { billedTokens } from '../workflow/pricing.mjs';
12
+ import { createRunSummary, refreshSummaryCore, applyExtensionSummary, backfillExtensionSummaries } from './run-summary.mjs';
11
13
 
12
14
  // apra-fleet-eft.6.5: the SAME template serves both the live view and the
13
15
  // process-free History view -- `opts.history` (true) feeds a FROZEN state
@@ -21,7 +23,7 @@ import { buildRunTitle } from './run-title.mjs';
21
23
  const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
22
24
  const isHistory = !!opts.history;
23
25
  const frozenStateLiteral = isHistory
24
- ? JSON.stringify(opts.state ?? null).replace(/</g, '\\u003c')
26
+ ? JSON.stringify(backfillExtensionSummaries(opts.state ?? null, dashboardExtensions) ?? null).replace(/</g, '\\u003c')
25
27
  : 'null';
26
28
  return `<!DOCTYPE html>
27
29
  <html lang="en">
@@ -237,7 +239,7 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
237
239
  <div class="content-area">
238
240
  <div class="tab-bar" id="tab-bar">
239
241
  <button class="tab-btn active" onclick="switchTab('core')">Activity Tree</button>
240
- ${dashboardExtensions.map(ext => `<button class="tab-btn" onclick="switchTab('${ext.id}')">${ext.title}</button>`).join('\\n')}
242
+ ${dashboardExtensions.map(ext => `<button class="tab-btn" onclick="switchTab('${ext.id}')">${ext.title}</button>`).join('\n')}
241
243
  </div>
242
244
  <div id="tab-core" class="tab-content active panel">
243
245
  <div class="panel-header" style="display: flex; justify-content: space-between; align-items: center;">
@@ -254,10 +256,10 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
254
256
  </div>
255
257
  <div id="extension-${ext.id}" style="flex: 1; min-height: 0; padding: 12px; overflow-y: auto;"></div>
256
258
  </div>
257
- `).join('\\n')}
259
+ `).join('\n')}
258
260
  </div>
259
261
  </div>
260
- ${dashboardExtensions.map(ext => `<script>\n${ext.js}\n</script>`).join('\\n')}
262
+ ${dashboardExtensions.map(ext => `<script>\n${ext.js}\n</script>`).join('\n')}
261
263
  <script>
262
264
  let globalState = null;
263
265
  function switchTab(id) {
@@ -487,6 +489,8 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
487
489
  source.onmessage = (e) => {
488
490
  const ev = JSON.parse(e.data);
489
491
  if (ev.type === 'state') {
492
+ // Summary first, then state (same order as renderState's hand-off).
493
+ document.dispatchEvent(new CustomEvent('workflow:summary:' + ev.payload.namespace, { detail: ev.payload.summary ?? null }));
490
494
  const extEvent = new CustomEvent('workflow:state:' + ev.payload.namespace, { detail: ev.payload.data });
491
495
  document.dispatchEvent(extEvent);
492
496
  }
@@ -739,7 +743,7 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
739
743
  // tier was never displayed at all. modelHtml surfaces
740
744
  // act.model (e.g. "premium"/"standard", already
741
745
  // present on every agent activity) explicitly.
742
- let tokensHtml = act.usage ? \`<span style="color:var(--text-muted)">\${act.usage.total_tokens.toLocaleString()} tkns</span>\` : (act.type === 'agent' && !act.isRunning ? \`<span style="color:var(--text-muted)">n/a</span>\` : '');
746
+ let tokensHtml = act.usage ? \`<span style="color:var(--text-muted)">\${((act.usage.total_tokens || 0) + (act.usage.cache_read_input_tokens || 0) + (act.usage.cache_creation_input_tokens || 0)).toLocaleString()} tkns</span>\` : (act.type === 'agent' && !act.isRunning ? \`<span style="color:var(--text-muted)">n/a</span>\` : '');
743
747
  const modelHtml = (act.type === 'agent' && act.model) ? \`<span style="color:var(--text-muted)">[\${escapeHtml(act.model)}]</span>\` : '';
744
748
  const memberDisplay = act.member ? escapeHtml(act.member) : (act.type === 'transform' ? 'js' : '');
745
749
  const memberHtml = memberDisplay ? \`<span class="muted">(\${memberDisplay})</span>\` : '';
@@ -843,7 +847,12 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
843
847
  const sinceStr = pause.since ? new Date(pause.since).toLocaleTimeString([], { hour12: false }) : '-';
844
848
  const reasonHtml = pause.reason ? \`<span>Reason: <strong>\${escapeHtml(pause.reason)}</strong></span>\` : '';
845
849
  const phaseHtml = pause.phase ? \`<span>Phase: <strong>\${escapeHtml(pause.phase)}</strong></span>\` : '';
846
- pauseBanner.innerHTML = \`<span>Paused since <strong>\${sinceStr}</strong></span>\${phaseHtml}\${reasonHtml}\`;
850
+ // (apra-fleet-hzeb.3) Only present for a script-initiated pause
851
+ // that supplied resumeAt (e.g. a provider usage-limit reset
852
+ // time via ctx.requestPause(reason, { resumeAt })) -- an
853
+ // operator-initiated /pause never sets it, so this stays absent.
854
+ const resumeAtHtml = pause.resumeAt ? \`<span>Expected resume: <strong>\${escapeHtml(pause.resumeAt)}</strong></span>\` : '';
855
+ pauseBanner.innerHTML = \`<span>Paused since <strong>\${sinceStr}</strong></span>\${phaseHtml}\${reasonHtml}\${resumeAtHtml}\`;
847
856
  pauseBanner.style.display = 'flex';
848
857
  } else {
849
858
  pauseBanner.innerHTML = '';
@@ -887,6 +896,17 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
887
896
 
888
897
  renderTreeIncremental(state.tree);
889
898
 
899
+ // Generic per-namespace summary hand-off (GET /state?summary=1's
900
+ // extensions map, computed server-side once per publish): dispatched
901
+ // BEFORE the matching workflow:state:NS event so an extension can
902
+ // cache it and render from it on that event. detail is null when
903
+ // the namespace has no summary yet.
904
+ const summaryExts = (state.summary && state.summary.extensions) || {};
905
+ const summaryNamespaces = new Set([...Object.keys(state.extensions || {}), ...Object.keys(summaryExts)]);
906
+ for (const ns of summaryNamespaces) {
907
+ document.dispatchEvent(new CustomEvent('workflow:summary:' + ns, { detail: summaryExts[ns] || null }));
908
+ }
909
+
890
910
  if (state.extensions) {
891
911
  for (const [ns, data] of Object.entries(state.extensions)) {
892
912
  const extEvent = new CustomEvent('workflow:state:' + ns, { detail: data });
@@ -954,6 +974,17 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
954
974
  // module). Reads from the LIVE, full-fidelity in-memory `state.tree` (never
955
975
  // the leaned /state payload), which is where an uncapped activity's complete
956
976
  // output/error text still lives.
977
+ // True for GET /state?summary=1 (any extra query params, e.g. a _t
978
+ // cache-buster, allowed); false for plain /state and /state?_t=....
979
+ function isSummaryRequest(url) {
980
+ try {
981
+ const u = new URL(url, 'http://localhost');
982
+ return u.pathname === '/state' && u.searchParams.get('summary') === '1';
983
+ } catch {
984
+ return false;
985
+ }
986
+ }
987
+
957
988
  function findActivityById(state, id) {
958
989
  for (const g of state.tree || []) {
959
990
  for (const p of g.phases || []) {
@@ -1078,9 +1109,13 @@ export function createDashboardViewer(workflow, opts = {}) {
1078
1109
  // timestamp). `phase`/`group` mirror wherever the run was when the
1079
1110
  // pause was requested, for the dashboard's reason card. Generic to
1080
1111
  // any workflow -- no fleet-sprint-specific fields.
1081
- pause: { status: 'none', reason: null, since: null, phase: null, group: null },
1112
+ pause: { status: 'none', reason: null, since: null, phase: null, group: null, resumeAt: null },
1082
1113
  tree: [],
1083
- extensions: {}
1114
+ extensions: {},
1115
+ // Small, fixed-shape progress summary served at GET /state?summary=1
1116
+ // (run-summary.mjs). Core fields are refreshed on every broadcast;
1117
+ // extensions.<ns> is recomputed only when <ns> is published.
1118
+ summary: createRunSummary(runId)
1084
1119
  };
1085
1120
 
1086
1121
  // Note: group/phase tracking is single-run by design (single-tenant usage).
@@ -1097,6 +1132,8 @@ export function createDashboardViewer(workflow, opts = {}) {
1097
1132
  let currentPhase = { title: 'Initialization', phaseStartedAt: startedAtIso, phaseEndedAt: null, events: [] };
1098
1133
  currentGroup.phases.push(currentPhase);
1099
1134
  state.tree.push(currentGroup);
1135
+ const refreshSummary = () => refreshSummaryCore(state.summary, state, currentPhase ? currentPhase.title : null);
1136
+ refreshSummary();
1100
1137
 
1101
1138
  const clients = new Set();
1102
1139
  const broadcast = (data) => {
@@ -1108,6 +1145,10 @@ export function createDashboardViewer(workflow, opts = {}) {
1108
1145
  // mid-run read of the persisted file reflects in-progress state
1109
1146
  // rather than only the terminal snapshot.
1110
1147
  state.updatedAt = nowIso();
1148
+ // Every lifecycle change (end, pause events, phase, activity
1149
+ // stats) reaches here, so the summary's core fields stay current
1150
+ // without any extension hook being called.
1151
+ refreshSummary();
1111
1152
  debouncedWriter.schedule();
1112
1153
  };
1113
1154
 
@@ -1224,6 +1265,7 @@ export function createDashboardViewer(workflow, opts = {}) {
1224
1265
  }
1225
1266
  state.endedAt = nowIso();
1226
1267
  state.terminalReason = state.terminalReason || 'SIGINT';
1268
+ refreshSummary();
1227
1269
  persistState();
1228
1270
  // apra-fleet-eft.2.1: flush any coalesced-but-not-yet-written
1229
1271
  // debounced state synchronously before the process actually exits,
@@ -1244,6 +1286,7 @@ export function createDashboardViewer(workflow, opts = {}) {
1244
1286
  }
1245
1287
  state.endedAt = nowIso();
1246
1288
  state.terminalReason = state.terminalReason || 'SIGTERM';
1289
+ refreshSummary();
1247
1290
  persistState();
1248
1291
  debouncedWriter.flushSync();
1249
1292
  moveStateToOldRuns();
@@ -1301,7 +1344,9 @@ export function createDashboardViewer(workflow, opts = {}) {
1301
1344
  }
1302
1345
  }
1303
1346
  }
1304
- if (meta.usage?.total_tokens) state.stats.totalTokens += meta.usage.total_tokens;
1347
+ // Every billed token, including prompt-cache reads/writes (which
1348
+ // usage.total_tokens -- the context-admission figure -- excludes).
1349
+ if (meta.usage) state.stats.totalTokens += billedTokens(meta.usage);
1305
1350
  // apra-fleet-unw.4: `cost` is only added to the running total when
1306
1351
  // it's a known number. When agent() explicitly reported cost: null
1307
1352
  // (fleet result had no usage, or the model wasn't in the pricing
@@ -1321,7 +1366,11 @@ export function createDashboardViewer(workflow, opts = {}) {
1321
1366
 
1322
1367
  workflow.on('state', (stateData) => {
1323
1368
  state.extensions[stateData.namespace] = stateData.data;
1324
- broadcast({ type: 'state', payload: stateData });
1369
+ // Once-per-publish: only the extension registered for THIS
1370
+ // namespace (if it opts in with summarize()) is asked to summarize;
1371
+ // a throwing hook is logged and its previous summary kept.
1372
+ applyExtensionSummary(state.summary, dashboardExtensions, stateData.namespace, stateData.data, nowIso());
1373
+ broadcast({ type: 'state', payload: { ...stateData, summary: state.summary.extensions[stateData.namespace] ?? null } });
1325
1374
  });
1326
1375
 
1327
1376
  // (apra-fleet-p2to.2.1) Generic pause lifecycle wiring, mirroring how
@@ -1338,13 +1387,18 @@ export function createDashboardViewer(workflow, opts = {}) {
1338
1387
  reason: payload.reason ?? null,
1339
1388
  since: null,
1340
1389
  phase: payload.phase ?? null,
1341
- group: payload.group ?? null
1390
+ group: payload.group ?? null,
1391
+ // (apra-fleet-hzeb.3) Set by a script-initiated pause (e.g. a
1392
+ // detected provider usage-limit signal) via ctx.requestPause(reason,
1393
+ // { resumeAt }) -- an operator-initiated pause via the dashboard's
1394
+ // /pause route never sets this, so it stays null there.
1395
+ resumeAt: payload.resumeAt ?? null
1342
1396
  };
1343
1397
  broadcast({ type: 'update' });
1344
1398
  });
1345
1399
 
1346
1400
  workflow.on('paused', (payload) => {
1347
- // The 'paused' event itself carries no reason (see
1401
+ // The 'paused' event itself carries no reason/resumeAt (see
1348
1402
  // FleetWorkflow._maybeEngagePause) -- preserve whatever
1349
1403
  // 'pause:requested' set, and only stamp `since` now, at the moment
1350
1404
  // the pause actually engaged.
@@ -1353,13 +1407,14 @@ export function createDashboardViewer(workflow, opts = {}) {
1353
1407
  reason: state.pause.reason,
1354
1408
  since: nowIso(),
1355
1409
  phase: payload.phase ?? state.pause.phase,
1356
- group: payload.group ?? state.pause.group
1410
+ group: payload.group ?? state.pause.group,
1411
+ resumeAt: state.pause.resumeAt
1357
1412
  };
1358
1413
  broadcast({ type: 'update' });
1359
1414
  });
1360
1415
 
1361
1416
  workflow.on('resumed', () => {
1362
- state.pause = { status: 'none', reason: null, since: null, phase: null, group: null };
1417
+ state.pause = { status: 'none', reason: null, since: null, phase: null, group: null, resumeAt: null };
1363
1418
  broadcast({ type: 'update' });
1364
1419
  });
1365
1420
 
@@ -1403,6 +1458,12 @@ export function createDashboardViewer(workflow, opts = {}) {
1403
1458
  res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Connection': 'keep-alive', 'Cache-Control': 'no-cache' });
1404
1459
  clients.add(res);
1405
1460
  req.on('close', () => clients.delete(res));
1461
+ } else if (req.url.startsWith('/state') && isSummaryRequest(req.url)) {
1462
+ // GET /state?summary=1: the small precomputed run summary only
1463
+ // (run-summary.mjs) -- no tree, no string table, no raw
1464
+ // extension data. Never calls any summarize() hook.
1465
+ res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store, no-cache, must-revalidate, proxy-revalidate' });
1466
+ res.end(JSON.stringify(state.summary));
1406
1467
  } else if (req.url.startsWith('/state')) {
1407
1468
  // apra-fleet-eft.27.1: GET /state is the RECURRING poll endpoint
1408
1469
  // (every ~250ms-400ms while a run is live) -- it must never
@@ -1417,7 +1478,12 @@ export function createDashboardViewer(workflow, opts = {}) {
1417
1478
  // the configured snapshot dir and running/<runId>.json, and what
1418
1479
  // the process-free History view embeds) is never mutated by this.
1419
1480
  res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store, no-cache, must-revalidate, proxy-revalidate' });
1420
- res.end(JSON.stringify(buildListStatePayload(state)));
1481
+ // The small top-level `summary` is attached AFTER the
1482
+ // leanify/dedupe pass: it repeats short top-level strings
1483
+ // (runId, updatedAt, ...) and must not turn them into $ref
1484
+ // markers for consumers that read the plain payload unresolved.
1485
+ const { summary, ...rest } = state;
1486
+ res.end(JSON.stringify({ ...buildListStatePayload(rest), summary }));
1421
1487
  } else if (req.method === 'GET' && /^\/extensions\/[^/]+\/detail\/[^/]+$/.test(req.url)) {
1422
1488
  // apra-fleet-eft.37.4 (M3): the GENERIC on-demand-detail route.
1423
1489
  // Any dashboard extension may register a `detailLookup(state, id)`
@@ -0,0 +1,127 @@
1
+ // Generic, extension-agnostic run progress summary served at
2
+ // GET /state?summary=1 (see createDashboardViewer in ./index.mjs).
3
+ //
4
+ // The summary is a small, fixed-shape object kept in memory as
5
+ // `state.summary`. Its CORE fields mirror top-level run state and are
6
+ // refreshed whenever that state changes (every broadcast, which every
7
+ // lifecycle handler -- 'end', pause events, phase transitions -- already
8
+ // performs); refreshing them never calls any extension hook. Its
9
+ // `extensions` map holds, per published namespace, whatever the dashboard
10
+ // extension registered for that namespace returns from its optional
11
+ // `summarize(data)` hook -- computed ONCE per publish of that namespace,
12
+ // never per request. Core knows nothing about any extension's data shape.
13
+
14
+ export const SUMMARY_VERSION = 1;
15
+
16
+ /**
17
+ * Builds the initial summary object for a run.
18
+ * @param {string} runId
19
+ */
20
+ export function createRunSummary(runId) {
21
+ return {
22
+ summaryVersion: SUMMARY_VERSION,
23
+ runId,
24
+ status: 'running',
25
+ phase: null,
26
+ pause: { status: 'none', reason: null, since: null, phase: null, group: null, resumeAt: null },
27
+ terminalReason: null,
28
+ updatedAt: null,
29
+ endedAt: null,
30
+ stats: { totalCost: 0, totalTokens: 0 },
31
+ extensions: {}
32
+ };
33
+ }
34
+
35
+ /**
36
+ * Copies the core fields from the live run state into `summary` in place.
37
+ * O(1); never calls any extension hook.
38
+ * @param {object} summary - the object built by createRunSummary()
39
+ * @param {object} state - the viewer's live state object
40
+ * @param {string|null} phaseTitle - title of the current phase, or null
41
+ */
42
+ export function refreshSummaryCore(summary, state, phaseTitle) {
43
+ summary.status = state.status;
44
+ summary.phase = phaseTitle ?? null;
45
+ const p = state.pause || {};
46
+ summary.pause = {
47
+ status: p.status || 'none',
48
+ reason: p.reason ?? null,
49
+ since: p.since ?? null,
50
+ phase: p.phase ?? null,
51
+ group: p.group ?? null,
52
+ resumeAt: p.resumeAt ?? null
53
+ };
54
+ summary.terminalReason = state.terminalReason ?? null;
55
+ summary.updatedAt = state.updatedAt ?? null;
56
+ summary.endedAt = state.endedAt ?? null;
57
+ summary.stats = {
58
+ totalCost: state.stats?.totalCost ?? 0,
59
+ totalTokens: state.stats?.totalTokens ?? 0
60
+ };
61
+ }
62
+
63
+ /**
64
+ * Recomputes the summary entry for one published namespace. Calls
65
+ * `summarize(data)` only on the extension whose id equals `namespace` AND
66
+ * which defines a summarize function; any other namespace gets no entry.
67
+ * A throwing summarize() is caught and logged, and the previous entry for
68
+ * that namespace is kept.
69
+ * @param {object} summary
70
+ * @param {Array} extensions - dashboard extensions
71
+ * @param {string} namespace
72
+ * @param {*} data - the published data for that namespace
73
+ * @param {string} publishedAt - ISO timestamp stamped by core
74
+ * @param {{warn: Function}} [logger]
75
+ */
76
+ export function applyExtensionSummary(summary, extensions, namespace, data, publishedAt, logger = console) {
77
+ const ext = (extensions || []).find((e) => e && e.id === namespace);
78
+ if (!ext || typeof ext.summarize !== 'function') return;
79
+ let result;
80
+ try {
81
+ result = ext.summarize(data);
82
+ } catch (e) {
83
+ logger.warn(`[Viewer] Warning: summarize() for namespace '${namespace}' threw: ${e && e.message ? e.message : e}`);
84
+ return;
85
+ }
86
+ const body = (result && typeof result === 'object' && !Array.isArray(result)) ? result : {};
87
+ summary.extensions[namespace] = { publishedAt, ...body };
88
+ }
89
+
90
+ /**
91
+ * Returns a NEW state object in which every namespace present in
92
+ * `state.extensions` that lacks a `state.summary.extensions[ns]` entry, and
93
+ * whose registered extension defines summarize(), gets one computed via
94
+ * applyExtensionSummary(). Used when rendering a frozen (archived) state
95
+ * that was persisted before the run summary existed. `publishedAt` for a
96
+ * backfilled entry is the frozen state's endedAt, else updatedAt, else
97
+ * null. Existing entries are never overwritten and the input is never
98
+ * mutated. A throwing summarize() is logged and that namespace gets no
99
+ * entry.
100
+ * @param {object|null} state - a frozen run state
101
+ * @param {Array} extensions - dashboard extensions
102
+ * @param {{warn: Function}} [logger]
103
+ */
104
+ export function backfillExtensionSummaries(state, extensions, logger = console) {
105
+ if (!state || typeof state !== 'object' || Array.isArray(state)) return state;
106
+ const data = state.extensions;
107
+ if (!data || typeof data !== 'object' || Array.isArray(data)) return state;
108
+ const existing = (state.summary && state.summary.extensions && typeof state.summary.extensions === 'object')
109
+ ? state.summary.extensions
110
+ : {};
111
+ const publishedAt = state.endedAt ?? state.updatedAt ?? null;
112
+ const scratch = { extensions: {} };
113
+ for (const ns of Object.keys(data)) {
114
+ if (Object.prototype.hasOwnProperty.call(existing, ns)) continue;
115
+ applyExtensionSummary(scratch, extensions, ns, data[ns], publishedAt, logger);
116
+ }
117
+ if (Object.keys(scratch.extensions).length === 0) return state;
118
+ let summary;
119
+ if (state.summary && typeof state.summary === 'object') {
120
+ summary = { ...state.summary, extensions: { ...existing, ...scratch.extensions } };
121
+ } else {
122
+ summary = createRunSummary(state.runId ?? null);
123
+ refreshSummaryCore(summary, state, null);
124
+ summary.extensions = scratch.extensions;
125
+ }
126
+ return { ...state, summary };
127
+ }
@@ -5,6 +5,7 @@ import { AsyncLocalStorage } from 'async_hooks';
5
5
  import { calculateCost } from './pricing.mjs';
6
6
  import { WorkflowError, MemberNotFoundError, AgentOutputError, AgentDispatchError, CommandError, FleetTransportError, BudgetExceededError, CancelledError } from './errors.mjs';
7
7
  import { hashText, computeActivityKey } from './journal.mjs';
8
+ import { fleetToolFailureOf, commandFailureOf } from '@apralabs/apra-fleet-client';
8
9
 
9
10
  export { WorkflowError, MemberNotFoundError, AgentOutputError, AgentDispatchError, CommandError, FleetTransportError, BudgetExceededError, CancelledError } from './errors.mjs';
10
11
 
@@ -325,6 +326,9 @@ function buildRepairPrompt(errorsText, initialPrompt) {
325
326
  * legitimate 15+ minute reviewer dispatch was client-timed-out at 930s while the remote
326
327
  * session kept running.
327
328
  * @property {number} [max_turns] - Max turns for conversational tools
329
+ * @property {boolean} [fail_on_permission_denial] - Passed to execute_prompt: a tool call the
330
+ * member CLI refused fails the dispatch (reason 'permission_denied') instead of riding on a
331
+ * successful reply as permissionWarning. fleet-sprint sets it on every role dispatch.
328
332
  * @property {'low'|'medium'|'high'|'xhigh'|'max'} [effort] - Effort parameter for fleet routing
329
333
  * @property {string} [agentType] - Agent persona to activate on the member
330
334
  * @property {boolean|string} [resume] - Resume the previous session on the member if one exists.
@@ -657,12 +661,37 @@ export class FleetWorkflow extends EventEmitter {
657
661
  * guard is set, that guard returning truthy. Calling it while already
658
662
  * paused or pause-requested is a no-op.
659
663
  *
664
+ * (apra-fleet-hzeb.3) Also exposed on the script context (see
665
+ * _bindPrimitives), so a running workflow script can initiate a pause
666
+ * for a condition only IT can detect (e.g. a provider usage/rate limit
667
+ * signal) -- not just the dashboard/operator via requestStop()'s sibling
668
+ * instance-level API. A script-initiated pause is indistinguishable from
669
+ * an operator-initiated one downstream: it fires the exact same
670
+ * 'pause:requested'/'paused'/'resumed' events, so any existing listener
671
+ * (the dashboard viewer's state.pause wiring, fleet-sprint's
672
+ * cli.mjs `on('paused', releaseForPause)` /
673
+ * `setPreResumeHook(reReserveForResume)`) engages for it unchanged.
674
+ *
660
675
  * @param {string} [reason]
676
+ * @param {{ resumeAt?: string, source?: string }} [opts] - Optional
677
+ * metadata carried on the 'pause:requested' payload (apra-fleet-hzeb.3):
678
+ * `resumeAt` is an ISO-8601 timestamp (or any caller-defined string) the
679
+ * caller expects the condition to clear by -- e.g. a provider's
680
+ * usage-limit reset time -- surfaced by the dashboard viewer in the
681
+ * paused banner. `source` identifies what requested the pause (e.g.
682
+ * `'usage_limit'`) for the same display purpose. Both are purely
683
+ * informational to the engine, which does not interpret or act on
684
+ * them. Omitting `opts` is fully backwards compatible with existing
685
+ * single-arg callers.
661
686
  */
662
- requestPause(reason = 'Workflow run paused via requestPause()') {
687
+ requestPause(reason = 'Workflow run paused via requestPause()', opts = {}) {
663
688
  if (this._paused || this._pauseRequested) return;
664
689
  this._pauseRequested = true;
665
- this.emit('pause:requested', this._pauseEventPayload({ reason }));
690
+ this.emit('pause:requested', this._pauseEventPayload({
691
+ reason,
692
+ resumeAt: opts.resumeAt ?? null,
693
+ source: opts.source ?? null
694
+ }));
666
695
  // If we're already quiescent (nothing in flight, guard permits), the
667
696
  // pause engages right now; otherwise it engages later as in-flight
668
697
  // work drains (_exitActivity) or the guard opens (setPauseGuard).
@@ -882,7 +911,17 @@ export class FleetWorkflow extends EventEmitter {
882
911
  // tier. Increments budget._pricedReal/_pricedFallback so
883
912
  // buildCostAnalysis() (runner.js) can honestly report which source
884
913
  // priced a run's total.
914
+ //
915
+ // A usage block that carries the provider's own per-dispatch cost
916
+ // (usage.cost_usd: the Claude CLI's list-price figure, already reduced
917
+ // to this dispatch's share by the server) is charged exactly that -- no
918
+ // recompute. Token pricing is only the fallback for a provider or result
919
+ // that reports no cost.
885
920
  async _resolveCost(opts, usage, budget) {
921
+ if (usage && typeof usage.cost_usd === 'number' && Number.isFinite(usage.cost_usd)) {
922
+ budget._pricedReal++;
923
+ return usage.cost_usd;
924
+ }
886
925
  const tier = opts.model;
887
926
  if (tier === 'cheap' || tier === 'standard' || tier === 'premium') {
888
927
  const memberKey = opts.member_id || opts.member_name;
@@ -892,7 +931,18 @@ export class FleetWorkflow extends EventEmitter {
892
931
  if (entry && typeof entry.promptPrice === 'number' && typeof entry.completionPrice === 'number') {
893
932
  const pTokens = usage.input_tokens || 0;
894
933
  const cTokens = usage.output_tokens || 0;
895
- const cost = (pTokens / 1_000_000) * entry.promptPrice + (cTokens / 1_000_000) * entry.completionPrice;
934
+ // Prompt-cache tokens are billed separately from (not inside)
935
+ // input_tokens and must be priced too, or a cache-heavy run
936
+ // is undercounted several-fold. An older server whose
937
+ // pricing entry has no cache rates prices them at the plain
938
+ // prompt rate: an over- rather than under-estimate, so a
939
+ // budget ceiling still holds.
940
+ const crTokens = usage.cache_read_input_tokens || 0;
941
+ const cwTokens = usage.cache_creation_input_tokens || 0;
942
+ const cacheReadPrice = typeof entry.cacheReadPrice === 'number' ? entry.cacheReadPrice : entry.promptPrice;
943
+ const cacheWritePrice = typeof entry.cacheWritePrice === 'number' ? entry.cacheWritePrice : entry.promptPrice;
944
+ const cost = (pTokens / 1_000_000) * entry.promptPrice + (cTokens / 1_000_000) * entry.completionPrice
945
+ + (crTokens / 1_000_000) * cacheReadPrice + (cwTokens / 1_000_000) * cacheWritePrice;
896
946
  budget._pricedReal++;
897
947
  return cost;
898
948
  }
@@ -1136,6 +1186,8 @@ export class FleetWorkflow extends EventEmitter {
1136
1186
  timeout_s: opts.timeout_s,
1137
1187
  max_total_s: opts.max_total_s,
1138
1188
  max_turns: opts.max_turns,
1189
+ // Opt-in strict permission handling (see AgentOptions).
1190
+ fail_on_permission_denial: opts.fail_on_permission_denial,
1139
1191
  effort: opts.effort,
1140
1192
  agent: opts.agentType,
1141
1193
  // apra-fleet-eft.29.1: pass-through opt-in, see AgentOptions.sprint_id above.
@@ -1213,6 +1265,12 @@ export class FleetWorkflow extends EventEmitter {
1213
1265
  // predate this field.
1214
1266
  const structured = result && result.structuredContent;
1215
1267
  const reportedUsage = (structured && structured.usage) || result.usage;
1268
+ // A successful dispatch whose session refused tool calls that
1269
+ // must never be granted (Claude auto mode: classifier or deny
1270
+ // rule). The reply is complete; this is a warning only.
1271
+ if (structured && !structured.isError && structured.permissionWarning && typeof structured.permissionWarning.hint === 'string') {
1272
+ console.error(`[Agent Permission Warning] member '${opts.member_name || opts.member_id}': ${structured.permissionWarning.hint}`);
1273
+ }
1216
1274
 
1217
1275
  // apra-fleet-unw.4: never fabricate usage. If the fleet result
1218
1276
  // didn't report real token usage, both usage and cost are
@@ -1257,7 +1315,39 @@ export class FleetWorkflow extends EventEmitter {
1257
1315
  // result.usage is null and cost is null -- the viewer then
1258
1316
  // tallies it as an unknown-cost activity rather than fiction.
1259
1317
  this.emit('activity:end', { ...activityMeta, error: text, duration, usage: result.usage, cost, success: false });
1260
- throw new AgentDispatchError(`[Workflow Error] Agent dispatch failed (${structured.reason || 'unknown'}): ${text}`, { details: { text, reason: structured.reason, member: opts.member_name || opts.member_id } });
1318
+ // apra-fleet-hzeb.2: pure pass-through, no policy decisions here --
1319
+ // when execute_prompt relayed a provider usage-limit signal
1320
+ // (reason: 'usage_limit'), forward its usageLimit block and the
1321
+ // in-flight sessionId onto AgentDispatchError.details unchanged, so
1322
+ // the fleet-sprint pause/resume policy can read
1323
+ // err.details.usageLimit.resumeAt / err.details.sessionId directly
1324
+ // instead of re-parsing the failure text. A permission_denied
1325
+ // result forwards its permissionDenied block the same way, and
1326
+ // dispatched:false (nothing was sent to the member) is kept so a
1327
+ // caller can tell a setup-time failure from one where the agent ran.
1328
+ throw new AgentDispatchError(`[Workflow Error] Agent dispatch failed (${structured.reason || 'unknown'}): ${text}`, { details: { text, reason: structured.reason, member: opts.member_name || opts.member_id, ...(structured.usageLimit ? { usageLimit: structured.usageLimit } : {}), ...(structured.permissionDenied ? { permissionDenied: structured.permissionDenied } : {}), ...(structured.sessionId ? { sessionId: structured.sessionId } : {}), ...(structured.dispatched === false ? { dispatched: false } : {}) } });
1329
+ }
1330
+
1331
+ // A fleet TOOL/TRANSPORT failure that carries no
1332
+ // structuredContent classification: the MCP server turns a
1333
+ // tool handler that THREW (e.g. an SSH channel that could not
1334
+ // be opened) into `{content:[{text: err.message}], isError:
1335
+ // true}`, so the text is the bare transport error, never the
1336
+ // LLM's answer. Classify it as a dispatch failure HERE, before
1337
+ // any schema extraction, so it is never fed to the bounded
1338
+ // schema-repair loop (which can only re-ask the model and
1339
+ // cannot fix a broken channel). The caller's own retry ladder
1340
+ // decides whether to re-dispatch. Structured `result.isError`
1341
+ // first; an anchored text shape only as a fallback (see
1342
+ // fleetToolFailureOf in the fleet client).
1343
+ const toolFailure = fleetToolFailureOf(result);
1344
+ if (toolFailure) {
1345
+ const memberLabel = opts.member_name || opts.member_id;
1346
+ const text = toolFailure.text || 'no error text reported';
1347
+ const transportMsg = `transport failure dispatching to member '${memberLabel}': ${text}`;
1348
+ console.error(`[Agent API Error]`, transportMsg);
1349
+ this.emit('activity:end', { ...activityMeta, error: transportMsg, duration, usage: result.usage, cost, success: false });
1350
+ throw new AgentDispatchError(`[Workflow Error] Agent dispatch failed (transport_failure): ${transportMsg}`, { details: { text, reason: 'transport_failure', signal: toolFailure.source, member: memberLabel } });
1261
1351
  }
1262
1352
 
1263
1353
  // apra-fleet-eft.78.3: surface the resumable session id
@@ -1654,8 +1744,17 @@ export class FleetWorkflow extends EventEmitter {
1654
1744
  throw new MemberNotFoundError(`[Workflow Error] ${outText}`, { details: { text: outText, member: opts.member_name || opts.member_id } });
1655
1745
  }
1656
1746
 
1657
- if (result.isError) {
1658
- const err = new CommandError(`[Command Failed] ${outText}`, { details: { text: outText, command: finalCmd } });
1747
+ // A command that never produced an exit code -- the exec timed
1748
+ // out, the transport failed, the member could not be started --
1749
+ // is a failure, never a success. The server flags it with
1750
+ // structuredContent.isError + reason (exitCode -1); older servers
1751
+ // sent only the bare "Failed to execute command on ..." text, which
1752
+ // commandFailureOf() also recognizes. The MCP-level result.isError
1753
+ // flag is covered by the same helper. The reason rides on
1754
+ // err.details so callers can tell a timeout from a transport error.
1755
+ const failure = commandFailureOf(result);
1756
+ if (failure) {
1757
+ const err = new CommandError(`[Command Failed] ${failure.message}`, { details: { text: outText, command: finalCmd, reason: failure.reason } });
1659
1758
  this.emit('activity:end', { ...activityMeta, error: err.message, duration, success: false });
1660
1759
  throw err;
1661
1760
  }
@@ -1988,10 +2087,19 @@ export class FleetWorkflow extends EventEmitter {
1988
2087
  endGroup: this.endGroup.bind(this),
1989
2088
  // (apra-fleet-p2to.1) Script-facing: lets the workflow declare
1990
2089
  // where a clean-state boundary is so a deferred pause engages
1991
- // there. requestPause()/requestResume()/requestStop() stay
1992
- // instance-only (driven by the viewer/orchestrator, like
1993
- // requestStop() already is), not part of the script context.
1994
- setPauseGuard: this.setPauseGuard.bind(this)
2090
+ // there.
2091
+ setPauseGuard: this.setPauseGuard.bind(this),
2092
+ // (apra-fleet-hzeb.3) Script-facing pause/resume: a running
2093
+ // script may PARK ITSELF on a condition only it can detect (a
2094
+ // provider usage/rate limit, an external gate) by calling these
2095
+ // directly -- they are the exact same requestPause()/
2096
+ // requestResume() the dashboard/operator use, so a
2097
+ // script-initiated pause fires the identical 'pause:requested'/
2098
+ // 'paused'/'resumed' lifecycle events as an operator-initiated
2099
+ // one. requestStop() remains instance-only/operator-only -- a
2100
+ // script has no business tearing down its own run.
2101
+ requestPause: this.requestPause.bind(this),
2102
+ requestResume: this.requestResume.bind(this)
1995
2103
  };
1996
2104
  }
1997
2105