@apralabs/apra-fleet 0.4.3 → 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 (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  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/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. 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>\` : '';
@@ -892,6 +896,17 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
892
896
 
893
897
  renderTreeIncremental(state.tree);
894
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
+
895
910
  if (state.extensions) {
896
911
  for (const [ns, data] of Object.entries(state.extensions)) {
897
912
  const extEvent = new CustomEvent('workflow:state:' + ns, { detail: data });
@@ -959,6 +974,17 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
959
974
  // module). Reads from the LIVE, full-fidelity in-memory `state.tree` (never
960
975
  // the leaned /state payload), which is where an uncapped activity's complete
961
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
+
962
988
  function findActivityById(state, id) {
963
989
  for (const g of state.tree || []) {
964
990
  for (const p of g.phases || []) {
@@ -1085,7 +1111,11 @@ export function createDashboardViewer(workflow, opts = {}) {
1085
1111
  // any workflow -- no fleet-sprint-specific fields.
1086
1112
  pause: { status: 'none', reason: null, since: null, phase: null, group: null, resumeAt: null },
1087
1113
  tree: [],
1088
- 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)
1089
1119
  };
1090
1120
 
1091
1121
  // Note: group/phase tracking is single-run by design (single-tenant usage).
@@ -1102,6 +1132,8 @@ export function createDashboardViewer(workflow, opts = {}) {
1102
1132
  let currentPhase = { title: 'Initialization', phaseStartedAt: startedAtIso, phaseEndedAt: null, events: [] };
1103
1133
  currentGroup.phases.push(currentPhase);
1104
1134
  state.tree.push(currentGroup);
1135
+ const refreshSummary = () => refreshSummaryCore(state.summary, state, currentPhase ? currentPhase.title : null);
1136
+ refreshSummary();
1105
1137
 
1106
1138
  const clients = new Set();
1107
1139
  const broadcast = (data) => {
@@ -1113,6 +1145,10 @@ export function createDashboardViewer(workflow, opts = {}) {
1113
1145
  // mid-run read of the persisted file reflects in-progress state
1114
1146
  // rather than only the terminal snapshot.
1115
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();
1116
1152
  debouncedWriter.schedule();
1117
1153
  };
1118
1154
 
@@ -1229,6 +1265,7 @@ export function createDashboardViewer(workflow, opts = {}) {
1229
1265
  }
1230
1266
  state.endedAt = nowIso();
1231
1267
  state.terminalReason = state.terminalReason || 'SIGINT';
1268
+ refreshSummary();
1232
1269
  persistState();
1233
1270
  // apra-fleet-eft.2.1: flush any coalesced-but-not-yet-written
1234
1271
  // debounced state synchronously before the process actually exits,
@@ -1249,6 +1286,7 @@ export function createDashboardViewer(workflow, opts = {}) {
1249
1286
  }
1250
1287
  state.endedAt = nowIso();
1251
1288
  state.terminalReason = state.terminalReason || 'SIGTERM';
1289
+ refreshSummary();
1252
1290
  persistState();
1253
1291
  debouncedWriter.flushSync();
1254
1292
  moveStateToOldRuns();
@@ -1306,7 +1344,9 @@ export function createDashboardViewer(workflow, opts = {}) {
1306
1344
  }
1307
1345
  }
1308
1346
  }
1309
- 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);
1310
1350
  // apra-fleet-unw.4: `cost` is only added to the running total when
1311
1351
  // it's a known number. When agent() explicitly reported cost: null
1312
1352
  // (fleet result had no usage, or the model wasn't in the pricing
@@ -1326,7 +1366,11 @@ export function createDashboardViewer(workflow, opts = {}) {
1326
1366
 
1327
1367
  workflow.on('state', (stateData) => {
1328
1368
  state.extensions[stateData.namespace] = stateData.data;
1329
- 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 } });
1330
1374
  });
1331
1375
 
1332
1376
  // (apra-fleet-p2to.2.1) Generic pause lifecycle wiring, mirroring how
@@ -1414,6 +1458,12 @@ export function createDashboardViewer(workflow, opts = {}) {
1414
1458
  res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Connection': 'keep-alive', 'Cache-Control': 'no-cache' });
1415
1459
  clients.add(res);
1416
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));
1417
1467
  } else if (req.url.startsWith('/state')) {
1418
1468
  // apra-fleet-eft.27.1: GET /state is the RECURRING poll endpoint
1419
1469
  // (every ~250ms-400ms while a run is live) -- it must never
@@ -1428,7 +1478,12 @@ export function createDashboardViewer(workflow, opts = {}) {
1428
1478
  // the configured snapshot dir and running/<runId>.json, and what
1429
1479
  // the process-free History view embeds) is never mutated by this.
1430
1480
  res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store, no-cache, must-revalidate, proxy-revalidate' });
1431
- 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 }));
1432
1487
  } else if (req.method === 'GET' && /^\/extensions\/[^/]+\/detail\/[^/]+$/.test(req.url)) {
1433
1488
  // apra-fleet-eft.37.4 (M3): the GENERIC on-demand-detail route.
1434
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.
@@ -907,7 +911,17 @@ export class FleetWorkflow extends EventEmitter {
907
911
  // tier. Increments budget._pricedReal/_pricedFallback so
908
912
  // buildCostAnalysis() (runner.js) can honestly report which source
909
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.
910
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
+ }
911
925
  const tier = opts.model;
912
926
  if (tier === 'cheap' || tier === 'standard' || tier === 'premium') {
913
927
  const memberKey = opts.member_id || opts.member_name;
@@ -917,7 +931,18 @@ export class FleetWorkflow extends EventEmitter {
917
931
  if (entry && typeof entry.promptPrice === 'number' && typeof entry.completionPrice === 'number') {
918
932
  const pTokens = usage.input_tokens || 0;
919
933
  const cTokens = usage.output_tokens || 0;
920
- 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;
921
946
  budget._pricedReal++;
922
947
  return cost;
923
948
  }
@@ -1161,6 +1186,8 @@ export class FleetWorkflow extends EventEmitter {
1161
1186
  timeout_s: opts.timeout_s,
1162
1187
  max_total_s: opts.max_total_s,
1163
1188
  max_turns: opts.max_turns,
1189
+ // Opt-in strict permission handling (see AgentOptions).
1190
+ fail_on_permission_denial: opts.fail_on_permission_denial,
1164
1191
  effort: opts.effort,
1165
1192
  agent: opts.agentType,
1166
1193
  // apra-fleet-eft.29.1: pass-through opt-in, see AgentOptions.sprint_id above.
@@ -1238,6 +1265,12 @@ export class FleetWorkflow extends EventEmitter {
1238
1265
  // predate this field.
1239
1266
  const structured = result && result.structuredContent;
1240
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
+ }
1241
1274
 
1242
1275
  // apra-fleet-unw.4: never fabricate usage. If the fleet result
1243
1276
  // didn't report real token usage, both usage and cost are
@@ -1289,8 +1322,32 @@ export class FleetWorkflow extends EventEmitter {
1289
1322
  // the fleet-sprint pause/resume policy can read
1290
1323
  // err.details.usageLimit.resumeAt / err.details.sessionId directly
1291
1324
  // instead of re-parsing the failure text. A permission_denied
1292
- // result forwards its permissionDenied block the same way.
1293
- 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 } : {}) } });
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 } });
1294
1351
  }
1295
1352
 
1296
1353
  // apra-fleet-eft.78.3: surface the resumable session id
@@ -1687,8 +1744,17 @@ export class FleetWorkflow extends EventEmitter {
1687
1744
  throw new MemberNotFoundError(`[Workflow Error] ${outText}`, { details: { text: outText, member: opts.member_name || opts.member_id } });
1688
1745
  }
1689
1746
 
1690
- if (result.isError) {
1691
- 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 } });
1692
1758
  this.emit('activity:end', { ...activityMeta, error: err.message, duration, success: false });
1693
1759
  throw err;
1694
1760
  }
@@ -1,9 +1,9 @@
1
1
  // Estimated per-1M-token prices (USD), prompt/completion split.
2
2
  // These are point-in-time ESTIMATES, not a live pricing feed -- do not treat
3
- // them as authoritative for billing. lastUpdated: 2024 (see apra-fleet-unw.4;
4
- // no new prices were invented when this table was reviewed -- if a model you
5
- // need isn't listed below, calculateCost() returns `null` rather than
6
- // guessing at a price).
3
+ // them as authoritative for billing. Claude rows lastUpdated: 2026-10-06 from
4
+ // Anthropic's published pricing page (see apra-fleet-unw.4; no prices are
5
+ // invented -- if a model you need isn't listed below, calculateCost() returns
6
+ // `null` rather than guessing at a price).
7
7
  //
8
8
  // apra-fleet-dv5.2: this table is now the FALLBACK layer only. Real
9
9
  // per-member pricing (apra-fleet-dv5.5's get_member_model_pricing MCP tool,
@@ -16,9 +16,8 @@
16
16
  // - Tier bands ('cheap'/'standard'/'premium'): what runner.js's
17
17
  // FIXED_ROLE_TIER and the planner's per-bead metadata convention emit by
18
18
  // default (apra-fleet-dv5.1) -- provider-agnostic, resolved to a
19
- // concrete model per member server-side. Seeded from the pre-existing
20
- // haiku/sonnet/opus rows below (same relative ordering), NOT sourced
21
- // from an official published price list.
19
+ // concrete model per member server-side. Priced as the claude
20
+ // provider's default model for that tier (haiku/sonnet/opus rows below).
22
21
  // - Concrete model IDs ('fable'/'opus'/'sonnet'/'haiku' and the
23
22
  // non-fleet rows further below): a fully legitimate, permanent
24
23
  // alternative to a tier keyword -- not a deprecated/legacy convention --
@@ -36,20 +35,65 @@ export const MODEL_PRICING = {
36
35
  'gemini-1.5-flash': { prompt: 0.35, completion: 1.05 },
37
36
 
38
37
  // Tier-band fallback rows (apra-fleet-dv5.2) -- used only when real
39
- // per-member pricing is unavailable. Seeded from the haiku/sonnet/opus
40
- // rows below; keep in sync if those are ever revised.
41
- 'cheap': { prompt: 0.80, completion: 4.00 },
42
- 'standard': { prompt: 3.00, completion: 15.00 },
43
- 'premium': { prompt: 15.00, completion: 75.00 },
38
+ // per-member pricing is unavailable. They match the claude provider's
39
+ // default tier models (cheap = haiku, standard = sonnet, premium = opus);
40
+ // keep in sync with those rows.
41
+ 'cheap': { prompt: 1.00, completion: 5.00, cacheRead: 0.10 },
42
+ 'standard': { prompt: 2.00, completion: 10.00, cacheRead: 0.20 },
43
+ 'premium': { prompt: 4.00, completion: 20.00, cacheRead: 0.20 },
44
44
 
45
- // Concrete fleet model IDs (N10, apra-fleet-unw2.8) -- ESTIMATES, see
46
- // comment above. A legitimate, permanent input form (not legacy).
47
- 'haiku': { prompt: 0.80, completion: 4.00 }, // Claude Haiku 4.5 (estimate) -- cheapest/fastest tier
48
- 'sonnet': { prompt: 3.00, completion: 15.00 }, // Claude Sonnet 5 (estimate) -- mid tier, unchanged from the 2024 sonnet row
49
- 'opus': { prompt: 15.00, completion: 75.00 }, // Claude Opus 4.8 (estimate) -- premium tier, unchanged from the 2024 opus row
50
- 'fable': { prompt: 15.00, completion: 75.00 } // Claude Fable 5 (estimate) -- treated as premium tier, same order of magnitude as opus
45
+ // Concrete fleet model IDs (N10, apra-fleet-unw2.8) -- Anthropic list
46
+ // prices for the model each alias resolves to (checked 2026-10-06,
47
+ // https://platform.claude.com/docs/en/about-claude/pricing). A
48
+ // legitimate, permanent input form (not legacy).
49
+ 'haiku': { prompt: 1.00, completion: 5.00, cacheRead: 0.10 }, // Claude Haiku 4.5
50
+ 'sonnet': { prompt: 2.00, completion: 10.00, cacheRead: 0.20 }, // Claude Sonnet 5.5
51
+ 'opus': { prompt: 4.00, completion: 20.00, cacheRead: 0.20 }, // Claude Opus 5.5 (cache read 0.05x)
52
+ 'fable': { prompt: 10.00, completion: 50.00, cacheRead: 0.25 } // Claude Fable 5.1 (cache read 0.025x)
51
53
  };
52
54
 
55
+ // Prompt-cache rates (apra-fleet cache-token accounting). Anthropic list
56
+ // pricing: a cache read is the row's own `cacheRead` rate (0.1x on most
57
+ // models, 0.05x on Opus 5.5, 0.025x on Fable 5.1 -- not one multiplier;
58
+ // a row without one uses CACHE_READ_MULTIPLIER), and a cache write is priced
59
+ // at the 1-hour rate, 2x the base input price -- the Claude Code CLI writes
60
+ // its cache with the 1-hour TTL. The gpt-*/gemini-* rows' usage never carries
61
+ // Claude's cache fields; those price any cache token at the plain prompt rate
62
+ // (no invented discount). Mirrors src/services/model-pricing.ts on the server.
63
+ // This table is the fallback only: a dispatch whose usage carries the
64
+ // provider's own cost_usd is charged that figure (see FleetWorkflow._resolveCost).
65
+ export const CACHE_READ_MULTIPLIER = 0.1;
66
+ export const CACHE_WRITE_MULTIPLIER = 2;
67
+ const NON_CLAUDE_KEY_RE = /^(gpt-|gemini-)/;
68
+
69
+ /**
70
+ * @param {string} key a MODEL_PRICING key
71
+ * @returns {{ cacheRead: number, cacheWrite: number }} $/1M cache rates
72
+ */
73
+ export function cacheRatesFor(key) {
74
+ const row = MODEL_PRICING[key];
75
+ if (NON_CLAUDE_KEY_RE.test(key)) return { cacheRead: row.prompt, cacheWrite: row.prompt };
76
+ const cacheRead = typeof row.cacheRead === 'number' ? row.cacheRead : row.prompt * CACHE_READ_MULTIPLIER;
77
+ return { cacheRead, cacheWrite: row.prompt * CACHE_WRITE_MULTIPLIER };
78
+ }
79
+
80
+ /**
81
+ * Every billed token count in an execute_prompt usage block: input, output,
82
+ * and the two prompt-cache counts (reported separately from input_tokens;
83
+ * absent = 0). usage.total_tokens is deliberately NOT this -- it stays
84
+ * input+output for context admission.
85
+ * @param {{ input_tokens?: number, output_tokens?: number, total_tokens?: number, cache_read_input_tokens?: number, cache_creation_input_tokens?: number }|null|undefined} usage
86
+ * @returns {number}
87
+ */
88
+ export function billedTokens(usage) {
89
+ if (!usage) return 0;
90
+ // total_tokens (input+output) when reported, else the two parts.
91
+ const base = typeof usage.total_tokens === 'number'
92
+ ? usage.total_tokens
93
+ : (usage.input_tokens || 0) + (usage.output_tokens || 0);
94
+ return base + (usage.cache_read_input_tokens || 0) + (usage.cache_creation_input_tokens || 0);
95
+ }
96
+
53
97
  // Tier-band keys are exact-match only (see calculateCost()) -- excluded
54
98
  // from the substring scan so a near-miss string ('standard-tier') never
55
99
  // silently matches a real tier keyword ('standard').
@@ -57,16 +101,17 @@ const TIER_BAND_KEYS = new Set(['cheap', 'standard', 'premium']);
57
101
 
58
102
  /**
59
103
  * @param {string} modelName
60
- * @param {{ input_tokens?: number, output_tokens?: number }|null} usage
104
+ * @param {{ input_tokens?: number, output_tokens?: number, cache_read_input_tokens?: number, cache_creation_input_tokens?: number }|null} usage
61
105
  * @returns {number|null} the estimated cost in USD, or `null` when usage is
62
106
  * missing/empty, or when `modelName` doesn't match any entry in
63
107
  * MODEL_PRICING (unknown models are never silently priced with a default
64
108
  * -- see apra-fleet-unw.4).
65
109
  */
66
110
  export function calculateCost(modelName, usage) {
67
- if (!usage || (!usage.input_tokens && !usage.output_tokens)) return null;
111
+ if (!usage || (!usage.input_tokens && !usage.output_tokens && !usage.cache_read_input_tokens && !usage.cache_creation_input_tokens)) return null;
68
112
 
69
113
  let pricing = null;
114
+ let pricingKey = null;
70
115
  if (modelName) {
71
116
  const lower = modelName.toLowerCase();
72
117
  // Exact match first (apra-fleet-dv5.2): a tier band ('cheap',
@@ -79,21 +124,26 @@ export function calculateCost(modelName, usage) {
79
124
  // 'haiku'), where a caller legitimately passes a longer real model
80
125
  // string that happens to contain a known short concrete-id key.
81
126
  if (Object.prototype.hasOwnProperty.call(MODEL_PRICING, lower)) {
82
- pricing = MODEL_PRICING[lower];
127
+ pricingKey = lower;
83
128
  } else {
84
- const key = Object.keys(MODEL_PRICING)
129
+ pricingKey = Object.keys(MODEL_PRICING)
85
130
  .filter((k) => !TIER_BAND_KEYS.has(k))
86
- .find((k) => lower.includes(k));
87
- if (key) pricing = MODEL_PRICING[key];
131
+ .find((k) => lower.includes(k)) || null;
88
132
  }
133
+ if (pricingKey) pricing = MODEL_PRICING[pricingKey];
89
134
  }
90
135
  if (!pricing) return null;
91
136
 
92
137
  const pTokens = usage.input_tokens || 0;
93
138
  const cTokens = usage.output_tokens || 0;
94
139
 
140
+ const crTokens = usage.cache_read_input_tokens || 0;
141
+ const cwTokens = usage.cache_creation_input_tokens || 0;
142
+ const { cacheRead, cacheWrite } = cacheRatesFor(pricingKey);
143
+
95
144
  const promptCost = (pTokens / 1000000) * pricing.prompt;
96
145
  const compCost = (cTokens / 1000000) * pricing.completion;
146
+ const cacheCost = (crTokens / 1000000) * cacheRead + (cwTokens / 1000000) * cacheWrite;
97
147
 
98
- return promptCost + compCost;
148
+ return promptCost + compCost + cacheCost;
99
149
  }
@@ -70,6 +70,15 @@ When `execute_prompt` output contains a permission denial, call `compose_permiss
70
70
  For an agy member the failure is structured: `reason: "permission_denied"` with
71
71
  `permissionDenied.suggestedGrants` (primary grant first) - review them and pass them as `grant`.
72
72
 
73
+ Claude denials carry `permissionMode` and `healable`:
74
+ - `healable: true` (acceptEdits session): a missing allow rule - grant from `suggestedGrants` as above.
75
+ - `healable: false` (auto or bypass session): the safety classifier or a deny rule refused the call. `suggestedGrants` is empty on purpose - do NOT grant it. Review the refused call; grant by hand only if the action is really intended.
76
+ - `cause: "policy_deny"` (any session): a fleet tool outside the member allowlist was refused by the member's own deny rules. Always `healable: false` - never grant it; the member must do the work without that tool.
77
+
78
+ By default a complete Claude reply is a success carrying its refusals in `permissionWarning` - check it. Pass `fail_on_permission_denial: true` to execute_prompt to make any refusal fail `permission_denied` instead (fleet-sprint does; a `healable: false` refusal on a complete reply stays a warning). A max_turns / auth / server result keeps its own reason, with the refusals attached.
79
+
80
+ `compose_permissions` with `dry_run: true` returns the composed allow list (JSON, nothing written) - check a grant against it before granting.
81
+
73
82
  The tool validates (wildcard-matched denylist -- blocks sudo/env, `bash -c`, catch-alls and shell chaining; see [Never auto-granted](#never-auto-granted)), expands co-occurrences (docker -> docker-compose), delivers the updated config, and appends to the project ledger for future use.
74
83
 
75
84
  ## Role switch