@apralabs/apra-fleet 0.4.4 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (268) hide show
  1. package/README.md +49 -4
  2. package/dist/agents/backlog-groomer.md +5 -0
  3. package/dist/agents/ci-watcher.md +5 -0
  4. package/dist/agents/deployer.md +20 -2
  5. package/dist/agents/doer.md +38 -2
  6. package/dist/agents/harvester.md +12 -9
  7. package/dist/agents/integ-test-runner.md +5 -0
  8. package/dist/agents/kb-reconciler.md +6 -0
  9. package/dist/agents/plan-reviewer.md +5 -0
  10. package/dist/agents/planner.md +5 -0
  11. package/dist/agents/regression-test-runner.md +5 -0
  12. package/dist/agents/reviewer.md +67 -15
  13. package/dist/agents/schemas/deployer-output.json +5 -0
  14. package/dist/agents/schemas/doer-output.json +78 -2
  15. package/dist/agents/schemas/reviewer-output.json +104 -2
  16. package/dist/cli/auth.js +5 -1
  17. package/dist/cli/beads-pin.js +6 -7
  18. package/dist/cli/claude-mod.d.ts +75 -0
  19. package/dist/cli/claude-mod.js +288 -0
  20. package/dist/cli/dolt-install.d.ts +1 -1
  21. package/dist/cli/dolt-install.js +5 -1
  22. package/dist/cli/fleet-se-guard.d.ts +8 -0
  23. package/dist/cli/fleet-se-guard.js +19 -3
  24. package/dist/cli/install-guard.d.ts +9 -0
  25. package/dist/cli/install-guard.js +24 -0
  26. package/dist/cli/install.d.ts +12 -0
  27. package/dist/cli/install.js +180 -20
  28. package/dist/cli/kb-profile.d.ts +16 -0
  29. package/dist/cli/kb-profile.js +81 -0
  30. package/dist/cli/start.js +3 -0
  31. package/dist/cli/uninstall.js +13 -3
  32. package/dist/cli/update.d.ts +4 -0
  33. package/dist/cli/update.js +19 -3
  34. package/dist/commands/kb-server.d.ts +10 -1
  35. package/dist/commands/kb-server.js +285 -11
  36. package/dist/index.js +22 -1
  37. package/dist/os/git-executable.d.ts +57 -0
  38. package/dist/os/git-executable.js +85 -0
  39. package/dist/os/go-concurrency.d.ts +44 -0
  40. package/dist/os/go-concurrency.js +53 -0
  41. package/dist/os/index.d.ts +1 -0
  42. package/dist/os/index.js +1 -0
  43. package/dist/os/linux.d.ts +2 -0
  44. package/dist/os/linux.js +10 -1
  45. package/dist/os/os-commands.d.ts +25 -0
  46. package/dist/os/os-commands.js +2 -0
  47. package/dist/os/windows-executable.d.ts +53 -0
  48. package/dist/os/windows-executable.js +185 -0
  49. package/dist/os/windows-gitbash.d.ts +23 -14
  50. package/dist/os/windows-gitbash.js +40 -16
  51. package/dist/os/windows.d.ts +2 -0
  52. package/dist/os/windows.js +37 -6
  53. package/dist/paths.d.ts +10 -1
  54. package/dist/paths.js +19 -2
  55. package/dist/services/agy-project.d.ts +7 -1
  56. package/dist/services/agy-project.js +7 -2
  57. package/dist/services/auth-socket.d.ts +18 -0
  58. package/dist/services/auth-socket.js +30 -4
  59. package/dist/services/credential-store.d.ts +33 -0
  60. package/dist/services/credential-store.js +79 -2
  61. package/dist/services/http-transport.d.ts +29 -0
  62. package/dist/services/http-transport.js +166 -37
  63. package/dist/services/kb-tool-profile.d.ts +36 -0
  64. package/dist/services/kb-tool-profile.js +88 -0
  65. package/dist/services/knowledge/bible-blob-id.js +10 -1
  66. package/dist/services/knowledge/bible-import.d.ts +108 -0
  67. package/dist/services/knowledge/bible-import.js +137 -4
  68. package/dist/services/knowledge/file-hash.js +6 -5
  69. package/dist/services/knowledge/http-provider.d.ts +303 -20
  70. package/dist/services/knowledge/http-provider.js +795 -125
  71. package/dist/services/knowledge/kb-config.d.ts +65 -1
  72. package/dist/services/knowledge/kb-config.js +143 -3
  73. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  74. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  75. package/dist/services/knowledge/kb-providers.d.ts +9 -2
  76. package/dist/services/knowledge/kb-providers.js +67 -37
  77. package/dist/services/knowledge/kb-removed-scope-keys.js +1 -1
  78. package/dist/services/knowledge/kb-self.d.ts +122 -9
  79. package/dist/services/knowledge/kb-self.js +196 -36
  80. package/dist/services/knowledge/member-bible-view.js +16 -3
  81. package/dist/services/knowledge/path-validation.d.ts +7 -0
  82. package/dist/services/knowledge/path-validation.js +11 -0
  83. package/dist/services/knowledge/project-slug.js +3 -2
  84. package/dist/services/knowledge/repository-header.d.ts +77 -0
  85. package/dist/services/knowledge/repository-header.js +233 -0
  86. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  87. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  88. package/dist/services/knowledge/sqlite-provider.d.ts +169 -0
  89. package/dist/services/knowledge/sqlite-provider.js +416 -4
  90. package/dist/services/knowledge/types.d.ts +15 -2
  91. package/dist/services/member-busy.d.ts +12 -0
  92. package/dist/services/member-busy.js +20 -0
  93. package/dist/services/member-config-io.d.ts +3 -2
  94. package/dist/services/member-config-io.js +7 -4
  95. package/dist/services/member-fleet-install.js +1 -0
  96. package/dist/services/member-tool-allowlist.d.ts +1 -1
  97. package/dist/services/member-tool-allowlist.js +8 -4
  98. package/dist/services/port-holder.js +2 -1
  99. package/dist/services/service-manager/types.d.ts +17 -1
  100. package/dist/services/service-manager/windows.d.ts +7 -2
  101. package/dist/services/service-manager/windows.js +28 -11
  102. package/dist/services/service-notice.d.ts +7 -0
  103. package/dist/services/service-notice.js +19 -0
  104. package/dist/services/session-registry.d.ts +13 -0
  105. package/dist/services/session-registry.js +13 -0
  106. package/dist/services/session-roots.d.ts +67 -0
  107. package/dist/services/session-roots.js +126 -0
  108. package/dist/services/statusline.d.ts +21 -0
  109. package/dist/services/statusline.js +97 -1
  110. package/dist/services/supervisor-service-cleanup.js +2 -1
  111. package/dist/services/tool-registry.js +108 -20
  112. package/dist/services/tool-scope.d.ts +34 -1
  113. package/dist/services/tool-scope.js +27 -2
  114. package/dist/services/vcs/azure-devops.js +10 -0
  115. package/dist/services/vcs/bitbucket.d.ts +22 -1
  116. package/dist/services/vcs/bitbucket.js +163 -17
  117. package/dist/services/vcs/types.d.ts +25 -2
  118. package/dist/services/watch/project-resolver.js +2 -1
  119. package/dist/skills/pm/cost.md +5 -1
  120. package/dist/skills/pm/index.md +9 -9
  121. package/dist/skills/pm/sprint.md +2 -1
  122. package/dist/tools/check-status.d.ts +51 -0
  123. package/dist/tools/check-status.js +124 -12
  124. package/dist/tools/code-intelligence-freshness.js +1 -1
  125. package/dist/tools/code-intelligence-gitnexus.d.ts +19 -0
  126. package/dist/tools/code-intelligence-gitnexus.js +166 -9
  127. package/dist/tools/code-intelligence-readiness.d.ts +58 -1
  128. package/dist/tools/code-intelligence-readiness.js +93 -8
  129. package/dist/tools/code-intelligence-reindex.d.ts +25 -1
  130. package/dist/tools/code-intelligence-reindex.js +76 -4
  131. package/dist/tools/code-intelligence.d.ts +1 -1
  132. package/dist/tools/code-intelligence.js +1 -1
  133. package/dist/tools/execute-command.js +14 -8
  134. package/dist/tools/execute-prompt.js +6 -2
  135. package/dist/tools/fleet-snapshot.d.ts +21 -0
  136. package/dist/tools/fleet-snapshot.js +78 -0
  137. package/dist/tools/kb-bible-commit.d.ts +25 -11
  138. package/dist/tools/kb-bible-commit.js +142 -33
  139. package/dist/tools/kb-capture.d.ts +2 -2
  140. package/dist/tools/kb-context.js +47 -27
  141. package/dist/tools/kb-demote.d.ts +27 -0
  142. package/dist/tools/kb-demote.js +37 -0
  143. package/dist/tools/kb-export.d.ts +35 -3
  144. package/dist/tools/kb-export.js +56 -13
  145. package/dist/tools/kb-feedback.d.ts +2 -0
  146. package/dist/tools/kb-feedback.js +17 -7
  147. package/dist/tools/kb-harvest.js +28 -9
  148. package/dist/tools/kb-import.d.ts +18 -2
  149. package/dist/tools/kb-import.js +24 -9
  150. package/dist/tools/kb-invalidate.d.ts +11 -3
  151. package/dist/tools/kb-invalidate.js +80 -7
  152. package/dist/tools/kb-list.js +38 -10
  153. package/dist/tools/kb-promote.js +6 -4
  154. package/dist/tools/kb-query.d.ts +3 -0
  155. package/dist/tools/kb-query.js +181 -37
  156. package/dist/tools/kb-session-prime.d.ts +4 -4
  157. package/dist/tools/kb-session-prime.js +89 -9
  158. package/dist/tools/kb-setup.d.ts +20 -0
  159. package/dist/tools/kb-setup.js +149 -11
  160. package/dist/tools/list-members.js +1 -1
  161. package/dist/tools/member-detail.js +7 -3
  162. package/dist/tools/provision-vcs-auth.d.ts +28 -3
  163. package/dist/tools/provision-vcs-auth.js +53 -7
  164. package/dist/tools/receive-files.js +7 -4
  165. package/dist/tools/send-files.js +5 -4
  166. package/dist/tools/send-message.d.ts +3 -0
  167. package/dist/tools/send-message.js +15 -2
  168. package/dist/tools/stop-prompt.js +3 -1
  169. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  170. package/dist/tools/vcs-credential-exec.js +90 -11
  171. package/dist/utils/process-utils.js +5 -1
  172. package/dist/utils/redact-known-secrets.d.ts +17 -0
  173. package/dist/utils/redact-known-secrets.js +70 -0
  174. package/dist/utils/skill-matrix.js +1 -1
  175. package/dist/utils/vcs-provider-detect.js +2 -2
  176. package/dist/workflows/auto-sprint.js +245 -9
  177. package/package.json +10 -7
  178. package/packages/apra-fleet-client/package.json +1 -1
  179. package/packages/apra-fleet-client/src/client/api.mjs +172 -19
  180. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +35 -2
  181. package/packages/apra-fleet-client/src/client/transport.mjs +6 -0
  182. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +5 -0
  183. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +5 -0
  184. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +20 -2
  185. package/packages/apra-fleet-se/apra-pm/agents/doer.md +38 -2
  186. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +12 -9
  187. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +5 -0
  188. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +6 -0
  189. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +5 -0
  190. package/packages/apra-fleet-se/apra-pm/agents/planner.md +5 -0
  191. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +5 -0
  192. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +67 -15
  193. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  194. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +78 -2
  195. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +104 -2
  196. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  197. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +9 -9
  198. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +2 -1
  199. package/packages/apra-fleet-se/bin/cli.mjs +104 -31
  200. package/packages/apra-fleet-se/bin/serve.mjs +46 -8
  201. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +184 -32
  202. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  203. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +21 -0
  204. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  205. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  206. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +158 -1
  207. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +82 -2
  208. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +23 -6
  209. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  210. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  211. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  212. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +44 -11
  213. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +4 -1
  214. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  215. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +314 -19
  216. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +72 -4
  217. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +7 -1
  218. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +112 -1
  219. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +36 -2
  220. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +736 -101
  221. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +1 -1
  222. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +7 -1
  223. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +49 -2
  224. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +206 -3
  225. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +61 -3
  226. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +81 -31
  227. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +7 -3
  228. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +39 -14
  229. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +17 -1
  230. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +18 -3
  231. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +14 -1
  232. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +32 -5
  233. package/packages/apra-fleet-se/fleet-sprint/runner.js +824 -98
  234. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +4 -2
  235. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +54 -1
  236. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +29 -2
  237. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  238. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +3 -2
  239. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +20 -0
  240. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +21 -0
  241. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +9 -0
  242. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +605 -32
  243. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  244. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +89 -1
  245. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +225 -2
  246. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  247. package/packages/apra-fleet-se/src/supervisor/api.mjs +148 -8
  248. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +6 -3
  249. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +30 -10
  250. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +17 -4
  251. package/packages/apra-fleet-se/src/supervisor/history.mjs +8 -1
  252. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +92 -2
  253. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +26 -1
  254. package/packages/apra-fleet-se/src/supervisor/server.mjs +151 -8
  255. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +11 -9
  256. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +7 -1
  257. package/packages/apra-fleet-workflow/package.json +2 -1
  258. package/packages/apra-fleet-workflow/src/viewer/index.mjs +86 -5
  259. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  260. package/packages/apra-fleet-workflow/src/workflow/index.mjs +34 -2
  261. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  262. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  263. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  264. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  265. package/skills/fleet/auth-bitbucket.md +47 -20
  266. package/skills/fleet/onboarding.md +1 -1
  267. package/skills/fleet/skill-matrix.md +3 -3
  268. package/version.json +1 -1
@@ -0,0 +1,906 @@
1
+ // fleet-status: apra-fleet at a glance inside Claude Code.
2
+ //
3
+ // - A status line entry, kept fresh: busy and stalled members by name, the
4
+ // rest counted ("<busy> alice 02:14 <idle> 3 <offline> 1").
5
+ // - /fleet-status opens a pane listing every member by category, each with
6
+ // a Remove control (remove_member after a confirm press; never forced, so
7
+ // the server still refuses a busy or held member).
8
+ // - A Secrets section in the pane: list, add or replace, and delete the
9
+ // secrets in apra-fleet's credential store.
10
+ //
11
+ // Data comes from apra-fleet's MCP tools, called over this session's own
12
+ // connection to the apra-fleet server (so it carries whatever credentials
13
+ // that connection has): fleet_snapshot and credential_store_list, polled
14
+ // every 30s and re-read after any other apra-fleet tool call.
15
+ //
16
+ // A secret's VALUE never passes through this mod, Claude Code or the model.
17
+ // Adding one asks the server (credential_store_set with return_url) for a
18
+ // one-time link to its own entry form, where the value is typed into a
19
+ // masked field and goes from the browser straight to the server; or the
20
+ // person runs `apra-fleet secret --set` in another terminal, which prompts
21
+ // with input hidden. The mod only ever sends names and settings, and only
22
+ // ever holds the link. Claude Code's own Input is never used for a value:
23
+ // it has no masking and other plugins' ui.input hooks would see the text.
24
+ // Claude Code 2.1.300 puts the call through the permission check like any
25
+ // tool call (observed: a prompt per poll without a rule), so it relies on the
26
+ // mcp__apra-fleet__* allow rule `apra-fleet install --llm claude` writes. A
27
+ // plugin's own hooks never answer for its own calls (the engine skips
28
+ // re-entry), so the mod cannot approve itself.
29
+ //
30
+ // Source is ASCII only: glyphs are written as \u escapes.
31
+
32
+ import { atom, read, update } from 'claude-code'
33
+ import type { EngineInterface, Register, RenderChildren, UiPressArgument } from 'claude-code'
34
+
35
+ import type { FleetMember, FleetMemberStatus, FleetView, MemberAction, PaneLayout, SecretForm, SecretRow, SecretsView } from '../types'
36
+
37
+ const SERVER = 'apra-fleet'
38
+ const TOOL_PREFIX = 'mcp__apra-fleet__'
39
+ const SNAPSHOT_TOOL = 'fleet_snapshot'
40
+ const PANE = 'fleet-status'
41
+ const POLL_MS = 30_000
42
+ const BUSY_RECHECK_MS = 2_000
43
+ const STATUS_NAMES_MAX = 3
44
+ const CONNECTING = 'connecting...'
45
+ const UNREACHABLE = 'server not reachable'
46
+ const RETRY_MS = 3_000
47
+ // While a read fails this soon after session start the server is presumed
48
+ // to be starting: retried every RETRY_MS, shown as CONNECTING.
49
+ const STARTUP_MS = 60_000
50
+
51
+ const LIST_TOOL = 'credential_store_list'
52
+ const SET_TOOL = 'credential_store_set'
53
+ const UPDATE_TOOL = 'credential_store_update'
54
+ const DELETE_TOOL = 'credential_store_delete'
55
+ const REMOVE_TOOL = 'remove_member'
56
+ const SECRET_NAME = /^[a-zA-Z0-9_-]{1,64}$/
57
+ const KEY = '\uD83D\uDD11'
58
+
59
+ const view = atom({ plugin: 'fleet-status', key: 'view' } as const, { members: [], fetchedAt: 0 } as FleetView)
60
+ const secrets = atom({ plugin: 'fleet-status', key: 'secrets' } as const, { items: [], fetchedAt: 0 } as SecretsView)
61
+ const CLOSED_FORM: SecretForm = { mode: 'closed', name: '', members: '', keep: 'persistent', ttl: 'none' }
62
+ const secretForm = atom({ plugin: 'fleet-status', key: 'secretForm' } as const, CLOSED_FORM)
63
+ // Members open, secrets folded; the less-used fields behind "more". Kept
64
+ // across sessions in $.store.
65
+ export const DEFAULT_LAYOUT: PaneLayout = { membersOpen: true, secretsOpen: false, moreMembers: false, moreSecrets: false, moreOptions: false }
66
+ const LAYOUT_KEY = 'layout'
67
+ const layout = atom({ plugin: 'fleet-status', key: 'layout' } as const, DEFAULT_LAYOUT)
68
+ const memberAction = atom({ plugin: 'fleet-status', key: 'memberAction' } as const, {} as MemberAction)
69
+
70
+ const GLYPH: Record<FleetMemberStatus, string> = {
71
+ busy: '\u26A1',
72
+ idle: '\uD83D\uDCA4',
73
+ offline: '\u274C',
74
+ unknown: '\u2753',
75
+ }
76
+ const COLOR: Record<FleetMemberStatus, string> = {
77
+ busy: 'warning',
78
+ idle: 'success',
79
+ offline: 'error',
80
+ unknown: 'permission',
81
+ }
82
+ // Needs-attention first.
83
+ const PRIORITY: Record<FleetMemberStatus, number> = { unknown: 0, busy: 1, idle: 2, offline: 3 }
84
+ const DOT = '\u00B7'
85
+ const RULE = '\u2500'
86
+ // One-glyph remove/delete control: a narrow x, one column wide on every
87
+ // terminal (the wastebasket emoji's width varies and would break columns).
88
+ const CROSS = '\u2715'
89
+ const OPEN = '\u25BE'
90
+ const CLOSED = '\u25B8'
91
+ const MORE = '\u2026'
92
+
93
+ /** 134 -> "02:14", 3725 -> "1:02:05". */
94
+ export function clock(s: number): string {
95
+ const two = (n: number) => String(n).padStart(2, '0')
96
+ const h = Math.floor(s / 3600)
97
+ const m = Math.floor((s % 3600) / 60)
98
+ const sec = s % 60
99
+ return h > 0 ? `${h}:${two(m)}:${two(sec)}` : `${two(m)}:${two(sec)}`
100
+ }
101
+
102
+ function asStatus(raw: unknown): FleetMemberStatus {
103
+ return raw === 'busy' || raw === 'idle' || raw === 'offline' ? raw : 'unknown'
104
+ }
105
+
106
+ /** The fleet_snapshot result text -> members, or throws with a short reason. */
107
+ export function parseSnapshot(texts: string[]): { version?: string; members: FleetMember[] } {
108
+ for (const text of texts) {
109
+ let data: unknown
110
+ try {
111
+ data = JSON.parse(text)
112
+ } catch {
113
+ continue
114
+ }
115
+ const d = data as { version?: unknown; members?: unknown }
116
+ if (!d || !Array.isArray(d.members)) continue
117
+ const members = d.members.map((raw): FleetMember => {
118
+ const m = raw as Record<string, unknown>
119
+ const member: FleetMember = {
120
+ id: String(m.id ?? ''),
121
+ name: String(m.name ?? m.id ?? '?'),
122
+ icon: typeof m.icon === 'string' ? m.icon : '',
123
+ category: typeof m.category === 'string' && m.category ? m.category : null,
124
+ status: asStatus(m.status),
125
+ }
126
+ if (typeof m.quietForS === 'number' && Number.isFinite(m.quietForS) && m.quietForS >= 0) member.quietForS = Math.round(m.quietForS)
127
+ if (typeof m.reservedBy === 'string' && m.reservedBy) member.reservedBy = m.reservedBy
128
+ return member
129
+ })
130
+ return { version: typeof d.version === 'string' ? d.version : undefined, members }
131
+ }
132
+ throw new Error('unexpected fleet_snapshot reply')
133
+ }
134
+
135
+ function byAttention(a: FleetMember, b: FleetMember): number {
136
+ return PRIORITY[a.status] - PRIORITY[b.status] || a.name.localeCompare(b.name)
137
+ }
138
+
139
+ /** The one-line status entry for a view. */
140
+ export function statusLine(v: FleetView): string | undefined {
141
+ if (v.fetchedAt === 0) return undefined
142
+ if (v.error) return v.error
143
+ if (v.members.length === 0) return 'no members'
144
+ const named = v.members.filter(m => m.status === 'busy' || m.status === 'unknown').sort(byAttention)
145
+ const parts = named.slice(0, STATUS_NAMES_MAX).map(m => {
146
+ const t = m.status === 'busy' && m.quietForS !== undefined ? ` ${clock(m.quietForS)}` : ''
147
+ return `${GLYPH[m.status]} ${m.name}${t}`
148
+ })
149
+ if (named.length > STATUS_NAMES_MAX) parts.push(`+${named.length - STATUS_NAMES_MAX}`)
150
+ for (const s of ['idle', 'offline'] as const) {
151
+ const n = v.members.filter(m => m.status === s).length
152
+ if (n > 0) parts.push(`${GLYPH[s]} ${n}`)
153
+ }
154
+ return parts.join(' ')
155
+ }
156
+
157
+ /** The fleet line with the secrets part appended when there is one. */
158
+ export function withSecrets(line: string | undefined, s: SecretsView): string | undefined {
159
+ const extra = secretsStatus(s)
160
+ if (!extra) return line
161
+ return line ? `${line} ${extra}` : extra
162
+ }
163
+
164
+ /**
165
+ * Body rows the pane draws for the members part: title, rule, section header,
166
+ * the error line, then (open) a label per category and a row per member, or
167
+ * the empty/error lines; and the footer.
168
+ */
169
+ export function paneRows(v: FleetView, l: PaneLayout = DEFAULT_LAYOUT): number {
170
+ const fixed = 4
171
+ if (!l.membersOpen) return fixed + (v.error && v.members.length > 0 ? 1 : 0)
172
+ if (v.members.length === 0) return fixed + 1 + (v.error?.startsWith(UNREACHABLE) ? 1 : 0)
173
+ const categories = new Set(v.members.map(m => m.category ?? '')).size
174
+ const labelled = categories > 1 || v.members.some(m => m.category !== null)
175
+ return fixed + (v.error ? 1 : 0) + v.members.length + (labelled ? categories : 0)
176
+ }
177
+
178
+ /** Plain-text summary, the /fleet-status transcript line. */
179
+ export function summaryText(v: FleetView): string {
180
+ if (v.error) return v.error
181
+ if (v.members.length === 0) return 'no members registered'
182
+ const count = (s: FleetMemberStatus) => v.members.filter(m => m.status === s).length
183
+ const bits = (['busy', 'unknown', 'idle', 'offline'] as const)
184
+ .filter(s => count(s) > 0)
185
+ .map(s => `${count(s)} ${s}`)
186
+ return `${v.members.length} member${v.members.length === 1 ? '' : 's'}: ${bits.join(', ')}`
187
+ }
188
+
189
+ /**
190
+ * Why a fleet_snapshot read failed, for the status line. Claude Code reports
191
+ * a server that is still starting and one that is down the same way (`no tool
192
+ * "fleet_snapshot" on a server named "apra-fleet"; servers with tools: none`),
193
+ * so time since session start tells them apart; a connected apra-fleet that
194
+ * lacks the tool is an older server.
195
+ */
196
+ export function classifyError(text: string, sinceStartMs: number): string {
197
+ const withTools = /servers with tools:\s*(.*)$/i.exec(text)?.[1] ?? ''
198
+ if (withTools.split(/[,\s]+/).includes(SERVER)) return 'server too old: update apra-fleet'
199
+ if (sinceStartMs < STARTUP_MS) return CONNECTING
200
+ // Newer wording: the server's tools are not in this session at all -- down,
201
+ // or hidden by a permissions.deny rule.
202
+ const hidden = HIDDEN_TOOL.exec(text)?.[1]
203
+ if (hidden) return `${UNREACHABLE} (or ${TOOL_PREFIX}${hidden} denied)`
204
+ return UNREACHABLE
205
+ }
206
+
207
+ /**
208
+ * The `no connected MCP tool "X"` wording Claude Code uses when a tool is not
209
+ * in this session: the server is down, or a permissions.deny rule hides it.
210
+ */
211
+ const HIDDEN_TOOL = /no connected MCP tool "([\w-]+)"/
212
+
213
+ /**
214
+ * A failed $.mcp.call -> the line the pane shows. When fleet_snapshot still
215
+ * answers, the server is up, so a tool it says is missing is hidden from this
216
+ * session (a permissions.deny rule): say so, rather than echo the raw error.
217
+ */
218
+ export function callErrorText(text: string, snapshotOk: boolean): string {
219
+ const tool = HIDDEN_TOOL.exec(text)?.[1]
220
+ if (tool && snapshotOk) {
221
+ const what = tool.startsWith('credential_store_') ? 'credential tools' : tool
222
+ return `${what} hidden in this session (permission deny rule ${TOOL_PREFIX}${tool}?)`
223
+ }
224
+ return text.replace(/^\$\.mcp\.call:\s*/, '')
225
+ }
226
+
227
+ async function errorText($: EngineInterface, err: unknown): Promise<string> {
228
+ const v = await read($, view)
229
+ return callErrorText(err instanceof Error ? err.message : String(err), v.fetchedAt > 0 && !v.error)
230
+ }
231
+
232
+
233
+ // --- Secrets ---------------------------------------------------------------
234
+
235
+ const TTL_SECONDS: Record<SecretForm['ttl'], number | undefined> = { none: undefined, '1h': 3600, '1d': 86400, '7d': 604800 }
236
+
237
+ function texts(res: { content: Array<{ type: string; text?: unknown }> }): string[] {
238
+ return res.content.flatMap(b => (b.type === 'text' && typeof b.text === 'string' ? [b.text] : []))
239
+ }
240
+
241
+ /** credential_store_list's reply -> rows (names and settings only; it never carries a value). */
242
+ export function parseSecrets(replies: string[]): SecretRow[] {
243
+ for (const text of replies) {
244
+ let data: unknown
245
+ try {
246
+ data = JSON.parse(text)
247
+ } catch {
248
+ continue
249
+ }
250
+ if (!Array.isArray(data)) continue
251
+ return data.map((raw): SecretRow => {
252
+ const r = raw as Record<string, unknown>
253
+ return {
254
+ name: String(r.name ?? '?'),
255
+ scope: String(r.scope ?? ''),
256
+ members: String(r.members ?? '*'),
257
+ expiry: String(r.expiry ?? 'none'),
258
+ }
259
+ }).sort((a, b) => a.name.localeCompare(b.name))
260
+ }
261
+ throw new Error('unexpected credential_store_list reply')
262
+ }
263
+
264
+ /** Expired, or due within the hour ("12m 3s remaining": no hours left). */
265
+ export function expiresSoon(row: SecretRow): boolean {
266
+ if (row.expiry === 'expired') return true
267
+ return row.expiry.endsWith('remaining') && !/\dh\b/.test(row.expiry)
268
+ }
269
+
270
+ /** credential_store_list's expiry, compact for the pane: "167h 59m remaining" -> "6d left". */
271
+ export function expiryLabel(expiry: string): string {
272
+ if (expiry === 'none') return 'no expiry'
273
+ const hm = /^(\d+)h (\d+)m remaining$/.exec(expiry)
274
+ if (hm) {
275
+ const h = Number(hm[1])
276
+ return h >= 48 ? `${Math.floor(h / 24)}d left` : `${h}h ${hm[2]}m left`
277
+ }
278
+ const m = /^(\d+)m \d+s remaining$/.exec(expiry)
279
+ if (m) return `${m[1]}m left`
280
+ return expiry.replace(/ remaining$/, ' left')
281
+ }
282
+
283
+ /** The status line's secrets part: only when some secret needs attention. */
284
+ export function secretsStatus(s: SecretsView): string | undefined {
285
+ const n = s.items.filter(expiresSoon).length
286
+ return n > 0 ? `${KEY} ${n} expiring` : undefined
287
+ }
288
+
289
+ /**
290
+ * Why an entry link is unsafe to open as given, or undefined when it is fine:
291
+ * https, or a loopback address (the value never leaves this machine).
292
+ */
293
+ export function entryLinkWarning(link: string): string | undefined {
294
+ let u: URL
295
+ try {
296
+ u = new URL(link)
297
+ } catch {
298
+ return 'not a link this mod can check'
299
+ }
300
+ if (u.protocol === 'https:') return undefined
301
+ const host = u.hostname.replace(/^\[|\]$/g, '')
302
+ if (host === '127.0.0.1' || host === 'localhost' || host === '::1') return undefined
303
+ return `plain http to ${u.host}: the value would cross the network unencrypted. Use an SSH tunnel or https, or the terminal command.`
304
+ }
305
+
306
+ /**
307
+ * credential_store_set's return_url reply -> the link and its expiry, or a
308
+ * failure line. The server sends both a text block and structuredContent
309
+ * ({ absoluteUrl, expiresAt }); Claude Code 2.1.301 hands a plugin the
310
+ * structured form as the only text block, so JSON is read first.
311
+ * A server without return_url (0.4.x) ignores it and collects the value out of
312
+ * band itself (a hidden-input terminal); its "NAME stored" reply is `stored`.
313
+ */
314
+ export function parseEntryLink(replies: string[], structured?: unknown): { link: string; expires?: string } | { stored: true } | { error: string } {
315
+ const fromJson = (d: unknown) => {
316
+ const o = d as { absoluteUrl?: unknown; url?: unknown; expiresAt?: unknown } | null
317
+ const link = typeof o?.absoluteUrl === 'string' ? o.absoluteUrl : typeof o?.url === 'string' && /^https?:/.test(o.url) ? o.url : undefined
318
+ if (!link) return undefined
319
+ return typeof o?.expiresAt === 'string' ? { link, expires: o.expiresAt } : { link }
320
+ }
321
+ const s = fromJson(structured)
322
+ if (s) return s
323
+ for (const text of replies) {
324
+ try {
325
+ const j = fromJson(JSON.parse(text))
326
+ if (j) return j
327
+ } catch {
328
+ // not JSON: the human-readable reply, read below
329
+ }
330
+ }
331
+ const all = replies.join('\n')
332
+ if (/^\s*\[FAIL\]/.test(all)) return { error: all.trim().split('\n')[0]!.replace(/^\s*\[FAIL\]\s*/, '') }
333
+ const link = /(https?:\/\/[^\s"'<>]+)/.exec(all)?.[1]
334
+ if (!link && /^\W*[\w-]+ stored\b/m.test(all)) return { stored: true }
335
+ if (!link) return { error: 'the server did not return an entry link' }
336
+ const expires = /\(expires ([^)]+)\)/.exec(all)?.[1]
337
+ return expires ? { link, expires } : { link }
338
+ }
339
+
340
+ // --- Removing a member ------------------------------------------------------
341
+
342
+ /**
343
+ * remove_member's reply -> the note line. The server refuses a busy or held
344
+ * member unless forced; the pane never forces, it shows the refusal.
345
+ */
346
+ export function removeNote(name: string, replies: string[], isError?: boolean): string {
347
+ const first = replies.join('\n').trim().split('\n')[0] ?? ''
348
+ if (!isError && /has been removed/.test(first)) return `Removed ${name}.`
349
+ const why = first.replace(/^\W+/, '').replace(/\s*(or\s+)?set force=true.*$/i, '').replace(/\s*Error code: [\w-]+\.?/, '')
350
+ .replace(/^Cannot remove member "[^"]*":\s*/, '')
351
+ return `Not removed: ${why || 'no reply from the server'}`
352
+ }
353
+
354
+ async function removeMember($: EngineInterface, name: string): Promise<void> {
355
+ let note: string
356
+ try {
357
+ const res = await $.mcp.call(SERVER, REMOVE_TOOL, { member_name: name })
358
+ note = removeNote(name, texts(res), res.isError)
359
+ } catch (err) {
360
+ note = `Not removed: ${await errorText($, err)}`
361
+ }
362
+ await update($, memberAction, () => ({ note }))
363
+ await refresh($)
364
+ }
365
+
366
+ /** Rows the remove confirm and its outcome take under the member list. */
367
+ export function memberActionRows(a: MemberAction): number {
368
+ return (a.confirmRemove ? 1 : 0) + (a.note ? 1 : 0)
369
+ }
370
+
371
+ /** The command that stores a value from another terminal, its input hidden. */
372
+ export function cliCommand(name: string): string {
373
+ return `apra-fleet secret --set ${name} --persist`
374
+ }
375
+
376
+ let secretsInFlight: Promise<void> | undefined
377
+
378
+ /** One credential_store_list read into the secrets view. */
379
+ function refreshSecrets($: EngineInterface): Promise<void> {
380
+ if (secretsInFlight) return secretsInFlight
381
+ secretsInFlight = (async () => {
382
+ let fresh: SecretsView
383
+ try {
384
+ const res = await $.mcp.call(SERVER, LIST_TOOL, {})
385
+ if (res.isError) throw new Error(texts(res).join(' ') || 'tool error')
386
+ fresh = { items: parseSecrets(texts(res)), fetchedAt: Date.now() }
387
+ } catch (err) {
388
+ const prev = await read($, secrets)
389
+ fresh = { ...prev, fetchedAt: Date.now(), error: await errorText($, err) }
390
+ }
391
+ await update($, secrets, () => fresh)
392
+ // A delete or apply changes the expiring count: keep the status line in step.
393
+ const v = await read($, view)
394
+ if (v.fetchedAt) $.ui.status(withSecrets(statusLine(v), fresh))
395
+ })().finally(() => {
396
+ secretsInFlight = undefined
397
+ })
398
+ return secretsInFlight
399
+ }
400
+
401
+ async function setNote($: EngineInterface, note: string | undefined): Promise<void> {
402
+ await update($, secretForm, f => ({ ...f, note }))
403
+ }
404
+
405
+ /** Ask the server for a one-time entry link; the value is typed on its form, never here. */
406
+ async function requestEntryLink($: EngineInterface): Promise<void> {
407
+ const f = await read($, secretForm)
408
+ if (!SECRET_NAME.test(f.name)) return setNote($, 'Name: letters, digits, _ and -, up to 64 characters.')
409
+ const args: Record<string, unknown> = {
410
+ name: f.name,
411
+ prompt: `Value for ${f.name}`,
412
+ persist: f.keep === 'persistent',
413
+ members: f.members.trim() || '*',
414
+ return_url: true,
415
+ }
416
+ const ttl = TTL_SECONDS[f.ttl]
417
+ if (ttl !== undefined) args.ttl_seconds = ttl
418
+ await setNote($, 'Asking the server for a secure entry\u2026')
419
+ try {
420
+ const res = await $.mcp.call(SERVER, SET_TOOL, args)
421
+ const got = parseEntryLink(texts(res), res.structuredContent)
422
+ if ('stored' in got) {
423
+ await update($, secretForm, () => ({ ...CLOSED_FORM, note: `${f.name} stored.` }))
424
+ return refreshSecrets($)
425
+ }
426
+ if ('error' in got) return setNote($, `No browser link from this server; use the command above. (${got.error})`)
427
+ await update($, secretForm, cur => ({
428
+ ...cur,
429
+ mode: 'link' as const,
430
+ link: got.link,
431
+ linkExpires: got.expires && !Number.isNaN(Date.parse(got.expires)) ? new Date(got.expires).toTimeString().slice(0, 5) : got.expires,
432
+ warning: entryLinkWarning(got.link),
433
+ note: undefined,
434
+ }))
435
+ } catch (err) {
436
+ await setNote($, `No link: ${await errorText($, err)}`)
437
+ }
438
+ }
439
+
440
+ /** After `apra-fleet secret --set`: apply the members and expiry picked here (settings only). */
441
+ async function applySettings($: EngineInterface): Promise<void> {
442
+ const f = await read($, secretForm)
443
+ const args: Record<string, unknown> = { name: f.name, members: f.members.trim() || '*' }
444
+ const ttl = TTL_SECONDS[f.ttl]
445
+ if (ttl !== undefined) args.ttl_seconds = ttl
446
+ try {
447
+ const res = await $.mcp.call(SERVER, UPDATE_TOOL, args)
448
+ const line = texts(res).join(' ').trim()
449
+ await setNote($, res.isError || /not found/i.test(line) ? `Not applied: ${line || 'no such secret yet'}` : `Settings applied to ${f.name}.`)
450
+ } catch (err) {
451
+ await setNote($, `Not applied: ${await errorText($, err)}`)
452
+ }
453
+ await refreshSecrets($)
454
+ }
455
+
456
+ async function deleteSecret($: EngineInterface, name: string): Promise<void> {
457
+ try {
458
+ const res = await $.mcp.call(SERVER, DELETE_TOOL, { name })
459
+ const line = texts(res).join(' ')
460
+ await update($, secretForm, f => ({
461
+ ...f,
462
+ confirmDelete: undefined,
463
+ note: res.isError || /not found/i.test(line) ? `Could not delete ${name}.` : `Deleted ${name}.`,
464
+ }))
465
+ } catch (err) {
466
+ const why = await errorText($, err)
467
+ await update($, secretForm, f => ({ ...f, confirmDelete: undefined, note: `Could not delete ${name}: ${why}` }))
468
+ }
469
+ await refreshSecrets($)
470
+ }
471
+
472
+ /** Rows the Secrets section takes in the pane: rule and header, then (open) the list, confirm, form and note. */
473
+ export function secretsRows(s: SecretsView, f: SecretForm, l: PaneLayout = DEFAULT_LAYOUT): number {
474
+ if (!l.secretsOpen) return 2
475
+ // With an error the empty-state line is not drawn: the error stands alone.
476
+ const list = s.error ? 1 + s.items.length : Math.max(1, s.items.length)
477
+ const form = f.mode === 'form' ? 4 + (l.moreOptions ? 3 : 0) : f.mode === 'link' ? 3 + (f.warning ? 1 : 0) : 0
478
+ return 2 + list + form + (f.note ? 1 : 0) + (f.confirmDelete ? 1 : 0)
479
+ }
480
+
481
+ /** The token the fleet resolves to a secret's value inside a member-bound command. */
482
+ export function secretToken(name: string): string {
483
+ return `{{secret.${name}}}`
484
+ }
485
+
486
+ // --- Pane size ---------------------------------------------------------------
487
+
488
+ /**
489
+ * Cells kept free at the body's right edge. The terminal surface does not
490
+ * draw the last two body columns (observed: every row, the rule included),
491
+ * so the tree is laid out that much narrower and right-aligned controls
492
+ * (x, more, less, add) land in cells that show.
493
+ */
494
+ export const GUTTER = 2
495
+ const MIN_COLUMNS = 40
496
+ const MAX_COLUMNS = 72
497
+ // Member row: status glyph, icon and state columns, the x control.
498
+ const MEMBER_FIXED = 3 + 3 + 9 + 1
499
+ export const FOOTER = `refresh ${POLL_MS / 1000}s ${DOT} press name to insert token`
500
+
501
+ /** Terminal cells a string takes: astral and the status emoji are two wide. */
502
+ export function cells(text: string): number {
503
+ let n = 0
504
+ for (const ch of text) n += ch.codePointAt(0)! >= 0x1f000 || ch === GLYPH.busy || ch === GLYPH.offline || ch === GLYPH.unknown ? 2 : 1
505
+ return n
506
+ }
507
+
508
+ /** What a member row shows behind "more": always something, whatever the state. */
509
+ export function memberExtras(m: FleetMember): string {
510
+ const bits = [
511
+ m.status === 'busy' ? (m.quietForS !== undefined ? `quiet ${clock(m.quietForS)}` : 'working') : '',
512
+ m.status === 'unknown' ? 'no activity -- may be stalled' : '',
513
+ m.status === 'idle' && !m.reservedBy ? 'free for work' : '',
514
+ m.status === 'offline' ? 'not reachable' : '',
515
+ m.reservedBy ? `held by ${m.reservedBy}` : '',
516
+ m.id && m.id !== m.name ? `id ${m.id.slice(0, 8)}` : '',
517
+ ]
518
+ return bits.filter(Boolean).join(` ${DOT} `)
519
+ }
520
+
521
+ /** The widest member name the row can give its full length, at `width` body cells. */
522
+ export function nameCap(width: number, indent: number): number {
523
+ return Math.max(10, width - MEMBER_FIXED - indent)
524
+ }
525
+
526
+ function counted(v: FleetView): Array<{ s: FleetMemberStatus; n: number }> {
527
+ return (['busy', 'unknown', 'idle', 'offline'] as const)
528
+ .map(c => ({ s: c, n: v.members.filter(m => m.status === c).length }))
529
+ .filter(c => c.n > 0)
530
+ }
531
+
532
+ /**
533
+ * Body columns the pane's content takes (header, section headers, member and
534
+ * secret rows, the open form, the footer), clamped to 40-72, plus GUTTER.
535
+ */
536
+ export function paneColumns(v: FleetView, s: SecretsView, l: PaneLayout = DEFAULT_LAYOUT, f: SecretForm = CLOSED_FORM): number {
537
+ const widths: number[] = [cells(FOOTER)]
538
+ widths.push(10 + (v.version ? 3 + v.version.replace(/^v/, '').length : 0) + 2 + 14)
539
+ const summary = counted(v).reduce((w, c, i) => w + cells(`${GLYPH[c.s]} ${c.n}`) + (i ? 2 : 0), 0)
540
+ widths.push(cells(`${OPEN} Members ${v.members.length}`) + (summary ? 2 + summary : 0) + 2 + 5)
541
+ if (l.membersOpen && v.members.length > 0) {
542
+ const indent = new Set(v.members.map(m => m.category ?? '')).size > 1 || v.members.some(m => m.category !== null) ? 1 : 0
543
+ const name = Math.max(...v.members.map(m => m.name.length)) + 2
544
+ for (const m of v.members) {
545
+ const extra = l.moreMembers ? cells(memberExtras(m)) + 1 : 0
546
+ widths.push(indent + MEMBER_FIXED + name + extra)
547
+ }
548
+ }
549
+ const expiring = s.items.filter(expiresSoon).length
550
+ widths.push(cells(`${OPEN} ${KEY} Secrets ${s.items.length}`) + (expiring ? 2 + cells(`${expiring} expiring`) : 0) + 2 + (s.items.length ? 7 : 0) + 3)
551
+ if (l.secretsOpen) {
552
+ const name = Math.min(28, Math.max(0, ...s.items.map(r => r.name.length)) + 2)
553
+ for (const r of s.items) {
554
+ const expiry = l.moreSecrets || expiresSoon(r) ? cells(expiryLabel(r.expiry)) : 0
555
+ widths.push(name + (l.moreSecrets ? 28 : 0) + expiry + 1 + 'replace'.length + 2)
556
+ }
557
+ if (f.mode === 'form') {
558
+ widths.push(1 + cliCommand(f.name || '<NAME>').length + 1 + 6)
559
+ widths.push(1 + (l.moreOptions ? 27 : 0) + 19 + 1 + (l.moreOptions ? 13 : 14) + 1 + 7)
560
+ }
561
+ }
562
+ return Math.min(MAX_COLUMNS, Math.max(MIN_COLUMNS, ...widths)) + GUTTER
563
+ }
564
+
565
+ /** Open (or resize) the pane to what its content takes now. */
566
+ async function openPane($: EngineInterface): Promise<void> {
567
+ const v = await read($, view)
568
+ const l = await read($, layout)
569
+ const s = await read($, secrets)
570
+ const f = await read($, secretForm)
571
+ // Inline (above the prompt) the pane asks for the rows its content takes;
572
+ // docked beside the transcript, for the columns.
573
+ const rows = paneRows(v, l) + (l.membersOpen ? memberActionRows(await read($, memberAction)) : 0) + secretsRows(s, f, l)
574
+ await $.ui.open({ id: PANE, title: 'Fleet', rows, columns: paneColumns(v, s, l, f) })
575
+ }
576
+
577
+ async function setLayout($: EngineInterface, patch: Partial<PaneLayout>): Promise<void> {
578
+ const next = await update($, layout, cur => ({ ...cur, ...patch }))
579
+ // Remembering the layout is a convenience: a store that refuses must not undo the toggle.
580
+ await $.store.set(LAYOUT_KEY, next).catch(() => undefined)
581
+ // A toggle is a press inside the open pane: re-ask its size for the new content.
582
+ await openPane($).catch(() => undefined)
583
+ }
584
+
585
+ let inFlight: Promise<void> | undefined
586
+ let startedAt = Date.now()
587
+ let poll: { cancel: () => void } | undefined
588
+
589
+ /** One fleet_snapshot read into the view and the status line; calls overlap into one. */
590
+ function refresh($: EngineInterface): Promise<void> {
591
+ if (inFlight) return inFlight
592
+ inFlight = (async () => {
593
+ let fresh: FleetView
594
+ try {
595
+ const res = await $.mcp.call(SERVER, SNAPSHOT_TOOL, {})
596
+ const texts = res.content.flatMap(b => (b.type === 'text' && typeof b.text === 'string' ? [b.text] : []))
597
+ if (res.isError) throw new Error(texts.join(' ') || 'tool error')
598
+ const snap = parseSnapshot(texts)
599
+ fresh = { version: snap.version, members: snap.members, fetchedAt: Date.now() }
600
+ } catch (err) {
601
+ // Keep the last good members: the pane shows them under the error.
602
+ const prev = await read($, view)
603
+ const text = err instanceof Error ? err.message : String(err)
604
+ fresh = { ...prev, fetchedAt: Date.now(), error: classifyError(text, Date.now() - startedAt) }
605
+ }
606
+ await update($, view, () => fresh)
607
+ await refreshSecrets($)
608
+ $.ui.status(withSecrets(statusLine(fresh), await read($, secrets)))
609
+ // Bounded by STARTUP_MS: after it a failure is no longer CONNECTING and
610
+ // reads settle to the 30s poll.
611
+ if (fresh.error === CONNECTING) $.clock.after(RETRY_MS, () => void refresh($))
612
+ })().finally(() => {
613
+ inFlight = undefined
614
+ })
615
+ return inFlight
616
+ }
617
+
618
+ export const register: Register = on => {
619
+ on('session.start', async ($, e, next) => {
620
+ await $.command.register({
621
+ name: 'fleet-status',
622
+ description: 'Show every apra-fleet member and what it is doing',
623
+ })
624
+ startedAt = Date.now()
625
+ const saved = (await $.store.get(LAYOUT_KEY)) as Partial<PaneLayout> | undefined
626
+ if (saved && typeof saved === 'object') await update($, layout, () => ({ ...DEFAULT_LAYOUT, ...saved }))
627
+ poll?.cancel()
628
+ poll = $.clock.every(POLL_MS, () => void refresh($))
629
+ void refresh($)
630
+ return next(e)
631
+ })
632
+
633
+ on('command.run', { command: 'fleet-status' }, async $ => {
634
+ await refresh($)
635
+ await openPane($)
636
+ return { text: summaryText(await read($, view)) }
637
+ })
638
+
639
+ // Any other apra-fleet tool call may change a member's state: re-read
640
+ // shortly after it starts (execute_prompt marks the member busy at
641
+ // dispatch) and again once it settles.
642
+ on('tool.call', { tool: /^mcp__apra-fleet__/ }, async ($, e, next) => {
643
+ if (e.tool === TOOL_PREFIX + SNAPSHOT_TOOL) return next(e)
644
+ const early = $.clock.after(BUSY_RECHECK_MS, () => void refresh($))
645
+ try {
646
+ return await next(e)
647
+ } finally {
648
+ early.cancel()
649
+ void refresh($)
650
+ }
651
+ }).catch(($, e, next) => next(e))
652
+
653
+ on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
654
+ const ui = $.ui.resolve(e)
655
+ const { Box, Text, Button, Link } = ui
656
+ // Mobile draws no Input or Select: the form then shows its values as text.
657
+ const Input = 'Input' in ui ? ui.Input : undefined
658
+ const Select = 'Select' in ui ? ui.Select : undefined
659
+ const v = await read($, view)
660
+ const act = await read($, memberAction)
661
+ const s = await read($, secrets)
662
+ const f = await read($, secretForm)
663
+ // GUTTER: the last body cells do not show on the terminal; lay out short of them.
664
+ const width = Math.max(20, (e.props.bodyColumns ?? 60) - GUTTER)
665
+ const rule = <Text dimColor>{RULE.repeat(width)}</Text>
666
+ const asOf = v.fetchedAt ? new Date(v.fetchedAt).toTimeString().slice(0, 8) : '--:--:--'
667
+ const copy = (text: string) => (p: UiPressArgument) => void $.ui.copy({ text, surface: p.surface })
668
+ const setForm = (fn: (cur: SecretForm) => SecretForm) => void update($, secretForm, fn)
669
+
670
+ const header = (
671
+ <Box flexDirection="row" justifyContent="space-between">
672
+ <Text>
673
+ <Text bold color="claude">apra-fleet</Text>
674
+ {v.version ? <Text dimColor>{` v${v.version.replace(/^v/, "")}`}</Text> : null}
675
+ </Text>
676
+ <Text dimColor>{`as of ${asOf}`}</Text>
677
+ </Box>
678
+ )
679
+
680
+ const l = await read($, layout)
681
+ const toggle = (patch: Partial<PaneLayout>) => () => void setLayout($, patch)
682
+ // A section header: the fold control, a summary, then the section's own controls.
683
+ const sectionHeader = (key: string, open: boolean, title: string, summary: RenderChildren, controls: RenderChildren) => (
684
+ <Box flexDirection="row" justifyContent="space-between">
685
+ <Box flexDirection="row" gap={2}>
686
+ <Button key={key} label={`${open ? OPEN : CLOSED} ${title}`} plain onPress={toggle(key === 'fold-members' ? { membersOpen: !open } : { secretsOpen: !open })} />
687
+ {summary}
688
+ </Box>
689
+ <Box flexDirection="row" gap={2}>{controls}</Box>
690
+ </Box>
691
+ )
692
+ const moreButton = (key: string, shown: boolean, patch: Partial<PaneLayout>) => (
693
+ <Button key={key} label={shown ? 'less' : `more${MORE}`} plain dimColor onPress={toggle(patch)} />
694
+ )
695
+
696
+ // --- Members ---
697
+ const counts = counted(v)
698
+ const memberSummary = (
699
+ <Box flexDirection="row" gap={2}>
700
+ {counts.map(c => (
701
+ <Text color={COLOR[c.s]}>{`${GLYPH[c.s]} ${c.n}`}</Text>
702
+ ))}
703
+ </Box>
704
+ )
705
+ let memberBody
706
+ const hint = v.error?.startsWith(UNREACHABLE) ? 'Start it with `apra-fleet start`, then /mcp to reconnect.' : undefined
707
+ if (v.error && v.members.length === 0) {
708
+ memberBody = (
709
+ <Box flexDirection="column">
710
+ <Text color={v.error === CONNECTING ? 'subtle' : 'error'}>{v.error}</Text>
711
+ {hint ? <Text dimColor>{hint}</Text> : null}
712
+ </Box>
713
+ )
714
+ } else if (v.members.length === 0) {
715
+ memberBody = <Text dimColor>No members yet. Ask Claude to register one.</Text>
716
+ } else {
717
+ const groups = new Map<string, FleetMember[]>()
718
+ for (const m of v.members) {
719
+ const key = m.category ?? ''
720
+ groups.set(key, [...(groups.get(key) ?? []), m])
721
+ }
722
+ const keys = [...groups.keys()].sort((a, b) => (a === '' ? 1 : b === '' ? -1 : a.localeCompare(b)))
723
+ const showCategories = keys.length > 1 || keys[0] !== ''
724
+ // The cap is what the row leaves after its fixed columns, not a constant.
725
+ const nameWidth = Math.min(nameCap(width, showCategories ? 1 : 0), Math.max(...v.members.map(m => m.name.length)) + 2)
726
+ memberBody = (
727
+ <Box flexDirection="column">
728
+ {keys.map(key => (
729
+ <Box flexDirection="column">
730
+ {showCategories ? <Text bold dimColor>{key === '' ? 'uncategorized' : key}</Text> : null}
731
+ {groups.get(key)!.sort(byAttention).map(m => (
732
+ <Box flexDirection="row" paddingLeft={showCategories ? 1 : 0}>
733
+ <Box width={3}><Text>{GLYPH[m.status]}</Text></Box>
734
+ <Box width={3}><Text>{m.icon}</Text></Box>
735
+ <Box width={nameWidth}><Text bold wrap="truncate-end">{m.name}</Text></Box>
736
+ <Box width={9}><Text color={COLOR[m.status]}>{m.status}</Text></Box>
737
+ <Box flexGrow={1}>
738
+ {l.moreMembers ? <Text dimColor wrap="truncate-end">{memberExtras(m)}</Text> : null}
739
+ </Box>
740
+ <Button key={`remove:${m.name}`} label={CROSS} plain dimColor
741
+ onPress={() => void update($, memberAction, () => ({ confirmRemove: m.name }))} />
742
+ </Box>
743
+ ))}
744
+ </Box>
745
+ ))}
746
+ {act.confirmRemove ? (
747
+ <Box flexDirection="row" gap={1}>
748
+ <Text color="warning">{`Remove ${act.confirmRemove} from the fleet?`}</Text>
749
+ <Button key="remove-confirm" label="Remove" variant="primary"
750
+ onPress={() => void removeMember($, act.confirmRemove!)} />
751
+ <Button key="remove-cancel" label="Cancel" onPress={() => void update($, memberAction, () => ({}))} />
752
+ </Box>
753
+ ) : null}
754
+ {act.note ? <Text color={act.note.startsWith('Removed') ? 'success' : 'error'}>{act.note}</Text> : null}
755
+ </Box>
756
+ )
757
+ }
758
+ const membersBlock = (
759
+ <Box flexDirection="column">
760
+ {rule}
761
+ {sectionHeader('fold-members', l.membersOpen, `Members ${v.members.length}`, memberSummary,
762
+ l.membersOpen && v.members.length > 0 ? moreButton('more-members', l.moreMembers, { moreMembers: !l.moreMembers }) : null)}
763
+ {v.error && v.members.length > 0 ? <Text color="error">{`${v.error} -- last known below`}</Text> : null}
764
+ {l.membersOpen ? memberBody : null}
765
+ </Box>
766
+ )
767
+
768
+ // --- Secrets ---
769
+ const openForm = (row?: SecretRow) => {
770
+ // The form is wider than the list: re-ask the pane's size once it is drawn.
771
+ void update($, secretForm, (): SecretForm => ({
772
+ ...CLOSED_FORM,
773
+ mode: 'form',
774
+ name: row?.name ?? '',
775
+ members: row && row.members !== '*' ? row.members : '',
776
+ keep: row && row.scope !== 'persistent' ? 'session' : 'persistent',
777
+ replacing: row ? true : undefined,
778
+ })).then(() => (l.secretsOpen ? openPane($) : setLayout($, { secretsOpen: true }))).catch(() => undefined)
779
+ }
780
+ const closeForm = () => {
781
+ setForm(cur => ({ ...CLOSED_FORM, note: cur.note }))
782
+ void refreshSecrets($)
783
+ }
784
+ // Pressing a secret's name puts its token (never its value) at the prompt's cursor.
785
+ const insertToken = async (name: string) => {
786
+ const got = await $.prompt.fill({ text: secretToken(name), mode: 'insert' })
787
+ await setNote($, got.isFilled ? `Inserted ${secretToken(name)} at the cursor.` : `Could not insert: the prompt box is not taking text right now.`)
788
+ }
789
+ const formBlock = f.mode === 'form' ? (
790
+ <Box flexDirection="column" paddingLeft={1}>
791
+ {f.replacing || !Input
792
+ ? <Text>{`Name: ${f.name || '(type a name)'}`}{f.replacing ? <Text dimColor> (replacing its value)</Text> : null}</Text>
793
+ : <Input key="secret-name" label="Name" autoFocus placeholder="GITHUB_TOKEN" value={f.name} submitLabel="ok"
794
+ onInput={(t: string) => setForm(cur => ({ ...cur, name: t.trim() }))}
795
+ onSubmit={(t: string) => setForm(cur => ({ ...cur, name: t.trim() }))} />}
796
+ {l.moreOptions ? (
797
+ <Box flexDirection="column">
798
+ {Input
799
+ ? <Input key="secret-members" label="Members" placeholder="* (all)" value={f.members} submitLabel="ok"
800
+ onInput={(t: string) => setForm(cur => ({ ...cur, members: t }))}
801
+ onSubmit={(t: string) => setForm(cur => ({ ...cur, members: t }))} />
802
+ : <Text>{`Members: ${f.members.trim() || '* (all)'}`}</Text>}
803
+ {Select
804
+ ? <Select key="secret-keep" label="Keep" value={f.keep}
805
+ options={[{ value: 'persistent', label: 'persistent (survives restart)' }, { value: 'session', label: 'this server session only' }]}
806
+ onSelect={(k: string) => setForm(cur => ({ ...cur, keep: k as SecretForm['keep'] }))} />
807
+ : <Text>{`Keep: ${f.keep}`}</Text>}
808
+ {Select
809
+ ? <Select key="secret-ttl" label="Expires" value={f.ttl}
810
+ options={[{ value: 'none', label: 'never' }, { value: '1h', label: 'in 1 hour' }, { value: '1d', label: 'in 1 day' }, { value: '7d', label: 'in 7 days' }]}
811
+ onSelect={(t: string) => setForm(cur => ({ ...cur, ttl: t as SecretForm['ttl'] }))} />
812
+ : <Text>{`Expires: ${f.ttl}`}</Text>}
813
+ </Box>
814
+ ) : null}
815
+ <Text dimColor>
816
+ {f.keep === 'session'
817
+ ? 'Session-only: use the browser link (the command always persists).'
818
+ : l.moreOptions
819
+ ? 'Run in ANOTHER terminal (the value is typed hidden), then Apply:'
820
+ : 'Run in ANOTHER terminal (the value is typed hidden):'}
821
+ </Text>
822
+ <Box flexDirection="row" gap={1}>
823
+ <Text color="claude">{cliCommand(f.name || '<NAME>')}</Text>
824
+ <Button key="secret-copy-cmd" label="Copy" onPress={copy(cliCommand(f.name || '<NAME>'))} />
825
+ </Box>
826
+ <Box flexDirection="row" gap={1}>
827
+ {l.moreOptions ? <Button key="secret-apply" label="Apply members and expiry" variant="primary" onPress={() => void applySettings($)} /> : null}
828
+ <Button key="secret-link" label="Get browser link" onPress={() => void requestEntryLink($)} />
829
+ <Button key="secret-options" label={l.moreOptions ? 'fewer options' : `more options${MORE}`} plain dimColor onPress={toggle({ moreOptions: !l.moreOptions })} />
830
+ <Button key="secret-cancel" label="Close" onPress={closeForm} />
831
+ </Box>
832
+ </Box>
833
+ ) : f.mode === 'link' && f.link ? (
834
+ <Box flexDirection="column" paddingLeft={1}>
835
+ <Text dimColor>{`Open once and type the value for ${f.name} there${f.linkExpires ? ` (expires ${f.linkExpires})` : ''}:`}</Text>
836
+ <Box flexDirection="row" gap={1}>
837
+ <Link href={f.link} />
838
+ <Button key="secret-copy-link" label="Copy" onPress={copy(f.link)} />
839
+ </Box>
840
+ {f.warning ? <Text color="error">{`Careful: ${f.warning}`}</Text> : null}
841
+ <Box flexDirection="row" gap={1}>
842
+ <Button key="secret-done" label="Done" variant="primary" onPress={closeForm} />
843
+ </Box>
844
+ </Box>
845
+ ) : null
846
+
847
+ const expiring = s.items.filter(expiresSoon).length
848
+ const nameWidth = Math.min(28, Math.max(0, ...s.items.map(r => r.name.length)) + 2)
849
+ const secretsBlock = (
850
+ <Box flexDirection="column">
851
+ {rule}
852
+ {sectionHeader('fold-secrets', l.secretsOpen, `${KEY} Secrets ${s.items.length}`,
853
+ expiring > 0 ? <Text color="warning">{`${expiring} expiring`}</Text> : null,
854
+ <Box flexDirection="row" gap={2}>
855
+ {l.secretsOpen && s.items.length > 0 ? moreButton('more-secrets', l.moreSecrets, { moreSecrets: !l.moreSecrets }) : null}
856
+ {/* Always drawn: a pressed control that vanished would drop the pane's focus back to the prompt. */}
857
+ <Button key="secret-add" label="add" plain onPress={() => openForm()} />
858
+ </Box>)}
859
+ {l.secretsOpen ? (
860
+ <Box flexDirection="column">
861
+ {s.error ? <Text color="error">{`secrets: ${s.error}`}</Text> : null}
862
+ {s.items.length === 0
863
+ ? (s.error ? null : <Text dimColor>No secrets stored.</Text>)
864
+ : s.items.map(row => (
865
+ <Box flexDirection="row">
866
+ <Box width={nameWidth}>
867
+ <Button key={`secret-insert:${row.name}`} label={row.name} plain onPress={() => void insertToken(row.name)} />
868
+ </Box>
869
+ {l.moreSecrets ? <Box width={12}><Text dimColor>{row.scope}</Text></Box> : null}
870
+ {l.moreSecrets ? <Box width={16}><Text dimColor wrap="truncate-end">{row.members === '*' ? 'all members' : row.members}</Text></Box> : null}
871
+ <Box flexGrow={1} marginRight={1}>
872
+ {l.moreSecrets || expiresSoon(row)
873
+ ? <Text color={expiresSoon(row) ? 'warning' : undefined} dimColor={!expiresSoon(row)} wrap="truncate-end">{expiryLabel(row.expiry)}</Text>
874
+ : null}
875
+ </Box>
876
+ <Box flexDirection="row" gap={1}>
877
+ <Button key={`secret-replace:${row.name}`} label="replace" plain dimColor onPress={() => openForm(row)} />
878
+ <Button key={`secret-delete:${row.name}`} label={CROSS} plain dimColor
879
+ onPress={() => setForm(cur => ({ ...cur, confirmDelete: row.name, note: undefined }))} />
880
+ </Box>
881
+ </Box>
882
+ ))}
883
+ {f.confirmDelete ? (
884
+ <Box flexDirection="row" gap={1}>
885
+ <Text color="warning">{`Delete secret ${f.confirmDelete}?`}</Text>
886
+ <Button key="secret-delete-confirm" label="Delete" variant="primary" onPress={() => void deleteSecret($, f.confirmDelete!)} />
887
+ <Button key="secret-delete-cancel" label="Cancel" onPress={() => setForm(cur => ({ ...cur, confirmDelete: undefined }))} />
888
+ </Box>
889
+ ) : null}
890
+ {formBlock}
891
+ {f.note ? <Text color={/^(No link|Not applied|Could not)/.test(f.note) ? 'error' : 'success'}>{f.note}</Text> : null}
892
+ </Box>
893
+ ) : null}
894
+ </Box>
895
+ )
896
+
897
+ return (
898
+ <Box flexDirection="column" width={width}>
899
+ {header}
900
+ {membersBlock}
901
+ {secretsBlock}
902
+ <Text dimColor>{FOOTER}</Text>
903
+ </Box>
904
+ )
905
+ })
906
+ }