@chankov/agent-fleet 0.0.4 → 0.0.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 (321) hide show
  1. package/.claude/commands/set-hermes-telegram.md +15 -0
  2. package/.opencode/commands/af-set-hermes-telegram.md +15 -0
  3. package/.pi/agents/dispatch-policy.yaml +1 -1
  4. package/.pi/agents/peers.yaml +4 -4
  5. package/.pi/extensions/chrome-devtools-mcp/README.md +1 -1
  6. package/.pi/extensions/mcp-bridge/README.md +1 -1
  7. package/.pi/harnesses/agent-hub/README.md +26 -26
  8. package/.pi/harnesses/agent-hub/index.ts +6 -6
  9. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
  10. package/.pi/harnesses/agent-hub/monitor-publisher.ts +3 -3
  11. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +1 -1
  12. package/.pi/harnesses/agent-hub/package.json +1 -1
  13. package/.pi/harnesses/ask-user-remote/README.md +1 -0
  14. package/.pi/harnesses/ask-user-remote/index.ts +36 -8
  15. package/.pi/harnesses/coms/README.md +5 -5
  16. package/.pi/harnesses/coms/package.json +1 -1
  17. package/.pi/harnesses/damage-control-continue/README.md +7 -7
  18. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  19. package/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  20. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  21. package/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  22. package/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  23. package/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  24. package/.pi/prompts/set-hermes-telegram.md +15 -0
  25. package/.versions/0.0.5/.claude/commands/build.md +44 -0
  26. package/.versions/0.0.5/.claude/commands/code-simplify.md +22 -0
  27. package/.versions/0.0.5/.claude/commands/design-agent.md +14 -0
  28. package/.versions/0.0.5/.claude/commands/doctor-agent-fleet.md +17 -0
  29. package/.versions/0.0.5/.claude/commands/orchestrate.md +112 -0
  30. package/.versions/0.0.5/.claude/commands/plan.md +16 -0
  31. package/.versions/0.0.5/.claude/commands/prime.md +22 -0
  32. package/.versions/0.0.5/.claude/commands/review.md +16 -0
  33. package/.versions/0.0.5/.claude/commands/set-hermes-telegram.md +15 -0
  34. package/.versions/0.0.5/.claude/commands/setup-agent-fleet.md +25 -0
  35. package/.versions/0.0.5/.claude/commands/ship.md +72 -0
  36. package/.versions/0.0.5/.claude/commands/spec.md +15 -0
  37. package/.versions/0.0.5/.claude/commands/test.md +19 -0
  38. package/.versions/0.0.5/.claude/commands/webperf.md +32 -0
  39. package/.versions/0.0.5/.claude/orchestrate-teams.yaml +24 -0
  40. package/.versions/0.0.5/.opencode/commands/af-build.md +17 -0
  41. package/.versions/0.0.5/.opencode/commands/af-code-simplify.md +16 -0
  42. package/.versions/0.0.5/.opencode/commands/af-compound.md +16 -0
  43. package/.versions/0.0.5/.opencode/commands/af-design-agent.md +15 -0
  44. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  45. package/.versions/0.0.5/.opencode/commands/af-orchestrate.md +112 -0
  46. package/.versions/0.0.5/.opencode/commands/af-plan.md +16 -0
  47. package/.versions/0.0.5/.opencode/commands/af-prime.md +22 -0
  48. package/.versions/0.0.5/.opencode/commands/af-review.md +15 -0
  49. package/.versions/0.0.5/.opencode/commands/af-set-hermes-telegram.md +15 -0
  50. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +15 -0
  51. package/.versions/0.0.5/.opencode/commands/af-ship.md +16 -0
  52. package/.versions/0.0.5/.opencode/commands/af-spec.md +16 -0
  53. package/.versions/0.0.5/.opencode/commands/af-test.md +21 -0
  54. package/.versions/0.0.5/.opencode/commands/af-webperf.md +32 -0
  55. package/.versions/0.0.5/.opencode/orchestrate-teams.yaml +24 -0
  56. package/.versions/0.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  57. package/.versions/0.0.5/.pi/agents/model-profiles.yaml +20 -0
  58. package/.versions/0.0.5/.pi/agents/peers.yaml +146 -0
  59. package/.versions/0.0.5/.pi/agents/teams.yaml +39 -0
  60. package/.versions/0.0.5/.pi/damage-control-rules.yaml +297 -0
  61. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  62. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  63. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  64. package/.versions/0.0.5/.pi/extensions/btw/README.md +118 -0
  65. package/.versions/0.0.5/.pi/extensions/btw/index.ts +917 -0
  66. package/.versions/0.0.5/.pi/extensions/btw/package.json +6 -0
  67. package/.versions/0.0.5/.pi/extensions/btw/state.js +179 -0
  68. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  69. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  70. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  71. package/.versions/0.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  72. package/.versions/0.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  73. package/.versions/0.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  74. package/.versions/0.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  75. package/.versions/0.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  76. package/.versions/0.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  77. package/.versions/0.0.5/.pi/extensions/package-lock.json +1143 -0
  78. package/.versions/0.0.5/.pi/extensions/package.json +9 -0
  79. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/README.md +201 -0
  80. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  81. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  82. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  83. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  84. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  85. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  86. package/.versions/0.0.5/.pi/harnesses/agent-hub/README.md +798 -0
  87. package/.versions/0.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  88. package/.versions/0.0.5/.pi/harnesses/agent-hub/artifacts.js +92 -0
  89. package/.versions/0.0.5/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  90. package/.versions/0.0.5/.pi/harnesses/agent-hub/delegate.ts +386 -0
  91. package/.versions/0.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  92. package/.versions/0.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  93. package/.versions/0.0.5/.pi/harnesses/agent-hub/footer.ts +29 -0
  94. package/.versions/0.0.5/.pi/harnesses/agent-hub/helpers.ts +214 -0
  95. package/.versions/0.0.5/.pi/harnesses/agent-hub/index.ts +8045 -0
  96. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  97. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  98. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  99. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  100. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  101. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  102. package/.versions/0.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  103. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-retention.js +34 -0
  104. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  105. package/.versions/0.0.5/.pi/harnesses/agent-hub/return-contract.js +215 -0
  106. package/.versions/0.0.5/.pi/harnesses/agent-hub/run-budget.js +155 -0
  107. package/.versions/0.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  108. package/.versions/0.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  109. package/.versions/0.0.5/.pi/harnesses/agent-hub/spawn.ts +246 -0
  110. package/.versions/0.0.5/.pi/harnesses/agent-hub/version.ts +18 -0
  111. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/README.md +19 -0
  112. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/index.ts +321 -0
  113. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  114. package/.versions/0.0.5/.pi/harnesses/coms/README.md +92 -0
  115. package/.versions/0.0.5/.pi/harnesses/coms/index.ts +1745 -0
  116. package/.versions/0.0.5/.pi/harnesses/coms/package.json +7 -0
  117. package/.versions/0.0.5/.pi/harnesses/coms/version.ts +18 -0
  118. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/README.md +117 -0
  119. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  120. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  121. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/version.ts +18 -0
  122. package/.versions/0.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  123. package/.versions/0.0.5/.pi/harnesses/lib/herdr-client.ts +458 -0
  124. package/.versions/0.0.5/.pi/harnesses/lib/herdr-presence.ts +288 -0
  125. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  126. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  127. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  128. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  129. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  130. package/.versions/0.0.5/.pi/harnesses/package-lock.json +35 -0
  131. package/.versions/0.0.5/.pi/harnesses/package.json +9 -0
  132. package/.versions/0.0.5/.pi/prompts/build.md +24 -0
  133. package/.versions/0.0.5/.pi/prompts/code-simplify.md +22 -0
  134. package/.versions/0.0.5/.pi/prompts/doctor-agent-fleet.md +15 -0
  135. package/.versions/0.0.5/.pi/prompts/plan.md +16 -0
  136. package/.versions/0.0.5/.pi/prompts/review.md +16 -0
  137. package/.versions/0.0.5/.pi/prompts/set-hermes-telegram.md +15 -0
  138. package/.versions/0.0.5/.pi/prompts/setup-agent-fleet.md +27 -0
  139. package/.versions/0.0.5/.pi/prompts/ship.md +17 -0
  140. package/.versions/0.0.5/.pi/prompts/spec.md +15 -0
  141. package/.versions/0.0.5/.pi/prompts/test.md +19 -0
  142. package/.versions/0.0.5/.pi/skills/bowser/SKILL.md +145 -0
  143. package/.versions/0.0.5/.version +1 -0
  144. package/.versions/0.0.5/agents/architect.md +23 -0
  145. package/.versions/0.0.5/agents/bowser.md +26 -0
  146. package/.versions/0.0.5/agents/builder.md +53 -0
  147. package/.versions/0.0.5/agents/code-reviewer.md +205 -0
  148. package/.versions/0.0.5/agents/deep-researcher.md +31 -0
  149. package/.versions/0.0.5/agents/documenter.md +18 -0
  150. package/.versions/0.0.5/agents/orchestrator.md +54 -0
  151. package/.versions/0.0.5/agents/plan-reviewer.md +60 -0
  152. package/.versions/0.0.5/agents/planner.md +69 -0
  153. package/.versions/0.0.5/agents/releaser.md +24 -0
  154. package/.versions/0.0.5/agents/researcher.md +28 -0
  155. package/.versions/0.0.5/agents/security-auditor.md +166 -0
  156. package/.versions/0.0.5/agents/test-engineer.md +151 -0
  157. package/.versions/0.0.5/agents/web-debugger.md +42 -0
  158. package/.versions/0.0.5/agents/web-performance-auditor.md +192 -0
  159. package/.versions/0.0.5/codex/CONDUCTOR.md +148 -0
  160. package/.versions/0.0.5/docs/ARCHITECTURE.md +210 -0
  161. package/.versions/0.0.5/docs/agent-fleet-setup.md +366 -0
  162. package/.versions/0.0.5/docs/claude-code-coms-bridge.md +103 -0
  163. package/.versions/0.0.5/docs/codex-remote-conductor.md +170 -0
  164. package/.versions/0.0.5/docs/coms-hermes-bridge.md +179 -0
  165. package/.versions/0.0.5/docs/getting-started.md +183 -0
  166. package/.versions/0.0.5/docs/npm-install.md +337 -0
  167. package/.versions/0.0.5/docs/opencode-setup.md +249 -0
  168. package/.versions/0.0.5/docs/pi-extensions.md +293 -0
  169. package/.versions/0.0.5/docs/pi-setup.md +472 -0
  170. package/.versions/0.0.5/docs/skill-anatomy.md +150 -0
  171. package/.versions/0.0.5/hermes/README.md +231 -0
  172. package/.versions/0.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  173. package/.versions/0.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  174. package/.versions/0.0.5/hooks/SIMPLIFY-IGNORE.md +90 -0
  175. package/.versions/0.0.5/hooks/coms-stop-hook.mjs +73 -0
  176. package/.versions/0.0.5/hooks/hooks.json +14 -0
  177. package/.versions/0.0.5/hooks/session-start.sh +74 -0
  178. package/.versions/0.0.5/hooks/simplify-ignore.sh +302 -0
  179. package/.versions/0.0.5/justfile +245 -0
  180. package/.versions/0.0.5/references/accessibility-checklist.md +160 -0
  181. package/.versions/0.0.5/references/definition-of-done.md +67 -0
  182. package/.versions/0.0.5/references/fleet-coordination-patterns.md +151 -0
  183. package/.versions/0.0.5/references/observability-checklist.md +91 -0
  184. package/.versions/0.0.5/references/orchestration-patterns.md +370 -0
  185. package/.versions/0.0.5/references/performance-checklist.md +153 -0
  186. package/.versions/0.0.5/references/prompting-patterns.md +380 -0
  187. package/.versions/0.0.5/references/security-checklist.md +179 -0
  188. package/.versions/0.0.5/references/testing-patterns.md +236 -0
  189. package/.versions/0.0.5/scripts/codex-conductor.ts +41 -0
  190. package/.versions/0.0.5/scripts/codex-remote-control.ts +167 -0
  191. package/.versions/0.0.5/scripts/coms-claude-bridge.ts +286 -0
  192. package/.versions/0.0.5/scripts/coms-cli.ts +484 -0
  193. package/.versions/0.0.5/scripts/coms-hermes-bridge.ts +413 -0
  194. package/.versions/0.0.5/scripts/fleet.ts +141 -0
  195. package/.versions/0.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  196. package/.versions/0.0.5/scripts/hermes-monitor-scenario.ts +7 -0
  197. package/.versions/0.0.5/scripts/lib/claude-bridge-core.ts +100 -0
  198. package/.versions/0.0.5/scripts/lib/codex-conductor.ts +88 -0
  199. package/.versions/0.0.5/scripts/lib/codex-remote-control.ts +480 -0
  200. package/.versions/0.0.5/scripts/lib/coms-envelope.ts +539 -0
  201. package/.versions/0.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  202. package/.versions/0.0.5/scripts/lib/fleet-command.ts +109 -0
  203. package/.versions/0.0.5/scripts/lib/herdr-layout.ts +263 -0
  204. package/.versions/0.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  205. package/.versions/0.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  206. package/.versions/0.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  207. package/.versions/0.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  208. package/.versions/0.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  209. package/.versions/0.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  210. package/.versions/0.0.5/scripts/lib/persona-banner.ts +62 -0
  211. package/.versions/0.0.5/scripts/lib/spawn-stagger.ts +101 -0
  212. package/.versions/0.0.5/scripts/lib/team-project.ts +191 -0
  213. package/.versions/0.0.5/scripts/lib/team-snapshot.ts +147 -0
  214. package/.versions/0.0.5/scripts/peer-banner.ts +40 -0
  215. package/.versions/0.0.5/scripts/team-snapshot.ts +237 -0
  216. package/.versions/0.0.5/scripts/team-up.ts +351 -0
  217. package/.versions/0.0.5/skills/_internal/grilling.md +11 -0
  218. package/.versions/0.0.5/skills/browser-testing-with-devtools/SKILL.md +352 -0
  219. package/.versions/0.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  220. package/.versions/0.0.5/skills/compound-learning/SKILL.md +137 -0
  221. package/.versions/0.0.5/skills/context-engineering/SKILL.md +291 -0
  222. package/.versions/0.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  223. package/.versions/0.0.5/skills/designing-agents/SKILL.md +394 -0
  224. package/.versions/0.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  225. package/.versions/0.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  226. package/.versions/0.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  227. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +542 -0
  228. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +35 -0
  229. package/.versions/0.0.5/skills/idea-refine/SKILL.md +182 -0
  230. package/.versions/0.0.5/skills/idea-refine/examples.md +238 -0
  231. package/.versions/0.0.5/skills/idea-refine/frameworks.md +99 -0
  232. package/.versions/0.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  233. package/.versions/0.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  234. package/.versions/0.0.5/skills/incremental-implementation/SKILL.md +287 -0
  235. package/.versions/0.0.5/skills/interview-me/SKILL.md +226 -0
  236. package/.versions/0.0.5/skills/orchestration-verification/SKILL.md +181 -0
  237. package/.versions/0.0.5/skills/peer-coms/SKILL.md +90 -0
  238. package/.versions/0.0.5/skills/performance-optimization/SKILL.md +350 -0
  239. package/.versions/0.0.5/skills/planning-and-task-breakdown/SKILL.md +236 -0
  240. package/.versions/0.0.5/skills/security-and-hardening/SKILL.md +461 -0
  241. package/.versions/0.0.5/skills/spec-driven-development/SKILL.md +245 -0
  242. package/.versions/0.0.5/skills/using-agent-skills/SKILL.md +199 -0
  243. package/.versions/0.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  244. package/.versions/0.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  245. package/.versions/0.0.5/vendor/agent-skills-upstream/README.md +11 -0
  246. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  247. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  248. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  249. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  250. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  251. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  252. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  253. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  254. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  255. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  256. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  257. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  258. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  259. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  260. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  261. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  262. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  263. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  264. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  265. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  266. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  267. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  268. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  269. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  270. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  271. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  272. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  273. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  274. package/CHANGELOG.md +9 -0
  275. package/README.md +14 -13
  276. package/bin/cli.js +83 -1
  277. package/bin/lib/set-hermes-telegram.js +323 -0
  278. package/docs/ARCHITECTURE.md +4 -4
  279. package/docs/agent-fleet-setup.md +1 -1
  280. package/docs/claude-code-coms-bridge.md +4 -4
  281. package/docs/codex-remote-conductor.md +12 -12
  282. package/docs/coms-hermes-bridge.md +62 -4
  283. package/docs/getting-started.md +4 -4
  284. package/docs/opencode-setup.md +1 -0
  285. package/docs/pi-extensions.md +30 -25
  286. package/docs/pi-setup.md +17 -8
  287. package/hermes/README.md +14 -11
  288. package/justfile +141 -152
  289. package/package.json +6 -3
  290. package/references/fleet-coordination-patterns.md +1 -1
  291. package/scripts/coms-hermes-bridge.ts +18 -8
  292. package/scripts/fleet.ts +141 -0
  293. package/scripts/lib/fleet-command.ts +109 -0
  294. package/scripts/lib/hermes-bridge-core.ts +5 -2
  295. package/scripts/lib/hermes-monitor-herdr.ts +2 -28
  296. package/scripts/lib/hermes-monitor-model.ts +3 -9
  297. package/scripts/lib/hermes-monitor-registry.ts +2 -6
  298. package/scripts/lib/hermes-monitor-socket.ts +2 -118
  299. package/scripts/lib/hermes-monitor-store.ts +2 -31
  300. package/scripts/lib/team-project.ts +10 -3
  301. package/scripts/team-snapshot.ts +4 -5
  302. package/scripts/team-up.ts +24 -6
  303. package/skills/guided-workspace-setup/SKILL.md +13 -6
  304. package/skills/guided-workspace-setup/companion-manifest.json +3 -1
  305. package/skills/peer-coms/SKILL.md +1 -1
  306. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -10
  307. /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
  308. /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
  309. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -0
  310. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -0
  311. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -0
  312. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -0
  313. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -0
  314. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -0
  315. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -0
  316. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
  317. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -0
  318. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
  319. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -0
  320. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
  321. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -0
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Install/status the Hermes liaison or turn its Telegram ask_user bridge on/off
3
+ argument-hint: "<install|status|on|off> [telegram-id] [--profile NAME] [--force] [--restart]"
4
+ ---
5
+
6
+ Run the deterministic Agent Fleet controller with the arguments from `$ARGUMENTS`. Supported forms are:
7
+
8
+ ```text
9
+ set-hermes-telegram install [--profile NAME] [--force] [--restart]
10
+ set-hermes-telegram status [--profile NAME]
11
+ set-hermes-telegram on <telegram-id[:topic-id]> [--profile NAME]
12
+ set-hermes-telegram off <telegram-id[:topic-id]> [--profile NAME]
13
+ ```
14
+
15
+ Use `node bin/cli.js set-hermes-telegram ...` when the checkout-local CLI exists; otherwise use `npx --no-install agent-fleet set-hermes-telegram ...`. Pass parsed values as separately quoted shell arguments. If neither CLI exists, report that Agent Fleet must be installed or updated. Do not reproduce installation or Herdr lifecycle with ad-hoc commands, do not bypass a `--force` refusal, and do not send a test Telegram message. Return the controller output verbatim.
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Install/status the Hermes liaison or turn its Telegram ask_user bridge on/off
3
+ argument-hint: "<install|status|on|off> [telegram-id] [--profile NAME] [--force] [--restart]"
4
+ ---
5
+
6
+ Run the deterministic Agent Fleet controller with the arguments from `$ARGUMENTS`. Supported forms are:
7
+
8
+ ```text
9
+ set-hermes-telegram install [--profile NAME] [--force] [--restart]
10
+ set-hermes-telegram status [--profile NAME]
11
+ set-hermes-telegram on <telegram-id[:topic-id]> [--profile NAME]
12
+ set-hermes-telegram off <telegram-id[:topic-id]> [--profile NAME]
13
+ ```
14
+
15
+ Use `node bin/cli.js set-hermes-telegram ...` when the checkout-local CLI exists; otherwise use `npx --no-install agent-fleet set-hermes-telegram ...`. Pass parsed values as separately quoted shell arguments. If neither CLI exists, report that Agent Fleet must be installed or updated. Do not reproduce installation or Herdr lifecycle with ad-hoc commands, do not bypass a `--force` refusal, and do not send a test Telegram message. Return the controller output verbatim.
@@ -1,6 +1,6 @@
1
1
  # Backend routing for the agent-hub dispatcher (dispatch_agent). Decided at
2
2
  # DISPATCH time, never at team activation — the hub and its peers boot in
3
- # parallel (`just hub-team <team>`), so a member's coms peer may register
3
+ # parallel (`just fleet team <team>`), so a member's coms peer may register
4
4
  # after the session starts.
5
5
  #
6
6
  # default: native | coms — coms substitutes ANY active-team member that has
@@ -1,8 +1,8 @@
1
1
  # Reusable coms peers, grouped into named teams (parallels teams.yaml).
2
2
  #
3
- # `just team-up <name>` spawns each peer of a team in its own herdr pane
3
+ # `just fleet team <name> --no-hub` spawns each peer in its own Herdr pane
4
4
  # (requires a running herdr server — https://herdr.dev),
5
- # using the hidden `_peer` helper (coms + compact-and-continue + the persona).
5
+ # using the hidden `_peer` helper (guarded Fleet Core + coms + the persona).
6
6
  #
7
7
  # Each peer entry:
8
8
  # name — coms identity (the addressable peer name); overrides persona frontmatter
@@ -26,7 +26,7 @@
26
26
  # runner: claude-code
27
27
  # model: opus
28
28
 
29
- # Hub-only workspace: `just hub-team base --project <name>` creates a Herdr
29
+ # Hub-only workspace: `just fleet team base --project <name>` creates a Herdr
30
30
  # workspace containing only the guarded hub, with no reusable coms peer panes.
31
31
  base:
32
32
 
@@ -56,7 +56,7 @@ docs:
56
56
  persona: researcher
57
57
  model: openai-codex/gpt-5.6-luna
58
58
 
59
- # Mirrored from .pi/agents/teams.yaml for `just team-up <team>`.
59
+ # Mirrored from .pi/agents/teams.yaml for `just fleet team <team>`.
60
60
  default:
61
61
  - name: planner
62
62
  persona: planner
@@ -39,7 +39,7 @@ ln -s /path/to/agent-fleet/.pi/extensions/mcp-bridge .pi/extensions/mcp
39
39
  ln -s /path/to/agent-fleet/.pi/extensions/chrome-devtools-mcp .pi/extensions/chrome-devtools-mcp
40
40
  ```
41
41
 
42
- `mcp-bridge` is a sibling library; `chrome-devtools-mcp` imports it via the relative path. Runtime dependencies are hoisted to `.pi/extensions/package.json` — run `npm ci` there once after cloning `agent-fleet` (see [docs/pi-setup.md](../../../docs/pi-setup.md#optional-pi-extensions)).
42
+ `mcp-bridge` is a sibling library; `chrome-devtools-mcp` imports it via the relative path. Runtime dependencies live in `.pi/extensions/package.json` for cloned/copy installs and are also root production dependencies of the published package so npm-package symlink installs resolve them from the real package path. Run `npm ci` in `.pi/extensions/` once after cloning `agent-fleet` (see [docs/pi-setup.md](../../../docs/pi-setup.md#optional-pi-extensions)); a normal `@chankov/agent-fleet` package install needs no nested install.
43
43
 
44
44
  ## Verify
45
45
 
@@ -43,4 +43,4 @@ pi does not yet have first-class MCP support. This bridge is a **stopgap**: it l
43
43
 
44
44
  ## Dependencies
45
45
 
46
- Runtime dependencies (`@modelcontextprotocol/sdk`, `typebox`) are declared once at `.pi/extensions/package.json` and installed via `npm ci` in the cloned `agent-fleet` repo. Wrapper extensions resolve them from the hoisted `node_modules/` — no per-wrapper install required. `@mariozechner/pi-coding-agent` is supplied by the pi runtime that loads the extension.
46
+ Runtime dependencies (`@modelcontextprotocol/sdk`, `typebox`) are declared at `.pi/extensions/package.json` for cloned/copy installs and duplicated in the root package's production `dependencies` for published-package symlink installs. The duplication is intentional: Node resolves a symlinked extension from its real path inside `@chankov/agent-fleet`, while npm does not install dependencies from a nested `.pi/extensions/package.json`. Run `npm ci` in `.pi/extensions/` for a clone or copied install; a normal `@chankov/agent-fleet` package install supplies the same dependencies at package root. No per-wrapper install is required. `@mariozechner/pi-coding-agent` is supplied by the pi runtime that loads the extension.
@@ -1,10 +1,11 @@
1
1
  # agent-hub
2
2
 
3
3
  A multi-agent dispatcher with [`coms`](../coms/README.md) **embedded** — so the dispatcher is
4
- *also* a peer-to-peer node. The bundled `just hub` recipes load
5
- [`damage-control-continue`](../damage-control-continue/README.md) first, then
6
- [`ask-user-remote`](../ask-user-remote/README.md), so the dispatcher has guardrails and an
7
- `ask_user` handoff tool before `agent-hub` starts. It combines local specialist
4
+ *also* a peer-to-peer node. The recommended `just fleet hub` mode loads Fleet Core
5
+ first: [`damage-control-continue`](../damage-control-continue/README.md),
6
+ [`ask-user-remote`](../ask-user-remote/README.md), STT, Compact & Continue, BTW, and the
7
+ update checker. The dispatcher therefore has guardrails and an `ask_user` handoff tool
8
+ before `agent-hub` starts. It combines local specialist
8
9
  orchestration (fixed specialist grid, read-only research helpers, `/zoom`, kill/restart, per-agent
9
10
  model, dispatcher persona gate) with peer-to-peer collaboration: it can **hand a session off to
10
11
  another main agent** and **use a coms peer as a subagent**.
@@ -15,7 +16,7 @@ another main agent** and **use a coms peer as a subagent**.
15
16
  > [extension catalog](../../../docs/pi-extensions.md) and the
16
17
  > [design plan](../../../docs/plans/agent-hub/).
17
18
 
18
- **Optional phone control:** `just hub-team <team> --project <name>` can supply the live peers for the experimental [Codex Android conductor](../../../docs/codex-remote-conductor.md). Configure Codex for the same project; do not also launch a second `conductor-codex <team>` peer workspace. Hermes remains the inbound `ask_user` route, while Codex performs only human-confirmed, approval-gated outbound delegation.
19
+ **Optional phone control:** `just fleet team <team> --project <name>` can supply the live peers for the experimental [Codex Android conductor](../../../docs/codex-remote-conductor.md). Configure Codex for the same project; do not also launch `just fleet conductor codex <team>` for the same peers. Hermes remains the inbound `ask_user` route, while Codex performs only human-confirmed, approval-gated outbound delegation.
19
20
 
20
21
  ## What it does
21
22
 
@@ -207,7 +208,7 @@ Every borrowed idea from another harness passes one test before it lands: *does
207
208
  test writing is never delegated.
208
209
  - **Dispatcher persona gate** — optional `persona-gate: on` can require an orchestrator persona at
209
210
  session start; by default the dispatcher starts without the gate.
210
- - **Default damage-control guardrails** — `just hub` and `just hub-solo` load the
211
+ - **Default damage-control guardrails** — `just fleet hub` and `just fleet hub --solo` load the
211
212
  `damage-control-continue` harness before `agent-hub`, so dispatcher tool calls are checked against
212
213
  `.pi/damage-control-rules.yaml` and a blocked call feeds back instead of aborting the turn. A
213
214
  guardrail is also re-loaded into every native specialist, research helper, and nested delegate
@@ -583,7 +584,7 @@ onward, hops accumulating up to `MAX_HOPS` (5).
583
584
 
584
585
  ### Coms-backed dispatch (dispatch-policy.yaml)
585
586
 
586
- `just hub-team <team>` boots the hub next to standing peers from `.pi/agents/peers.yaml` — and some
587
+ `just fleet team <team>` boots the Hub next to standing peers from `.pi/agents/peers.yaml` — and some
587
588
  of them (e.g. `code-reviewer`, `plan-reviewer` with `runner: claude-code`) intentionally share a name
588
589
  with a team member. `.pi/agents/dispatch-policy.yaml` tells the dispatcher to serve such members
589
590
  **through the peer** instead of spawning a native subagent:
@@ -695,7 +696,7 @@ export AGENT_FLEET_MONITOR_RUNTIME_DIR="/absolute/owner-only/runtime-root"
695
696
  Both are required for monitor startup; the runtime root must be absolute and owner-only, and the
696
697
  profile ID must be a safe identifier. The monitor also starts only for a Herdr-backed hub with
697
698
  `HERDR_WORKSPACE_ID` and `HERDR_PANE_ID`; retain those values and `HERDR_SOCKET_PATH` in the
698
- standard `just hub-team <team>` flow. Workspace labels are display metadata, not monitor identity.
699
+ standard `just fleet team <team>` flow. Workspace labels are display metadata, not monitor identity.
699
700
 
700
701
  The live contract exposes three authenticated newline-delimited JSON requests: `snapshot`, cursor-
701
702
  based `output`, and exact-generation `cancel`. The monitor is local-only and fails closed when its
@@ -710,7 +711,7 @@ monitor_runtime="${XDG_RUNTIME_DIR:?}/agent-fleet-monitor"
710
711
  install -d -m 700 "$monitor_runtime"
711
712
  AGENT_FLEET_PROFILE_ID=dev \
712
713
  AGENT_FLEET_MONITOR_RUNTIME_DIR="$monitor_runtime" \
713
- just hub-team default
714
+ just fleet team default
714
715
  ```
715
716
 
716
717
  No Desktop/backend plugin installation is required or provided. Consumers must re-discover after
@@ -720,16 +721,16 @@ lease or socket loss and must never persist or log the token.
720
721
 
721
722
  - `.pi/agents/teams.yaml` for fixed specialist teams, the referenced persona `.md` files, and
722
723
  (strongly recommended) [`pi-ask-user`](https://github.com/edlsh/pi-ask-user).
723
- - `.pi/damage-control-rules.yaml` for the default guarded `just hub` / `just hub-solo` recipes.
724
+ - `.pi/damage-control-rules.yaml` for every guarded `just fleet` Pi mode.
724
725
  - Nothing extra in-repo for coms — the peer registry lives at `~/.pi/coms/` and is created at
725
726
  runtime.
726
727
 
727
728
  ## Usage
728
729
 
729
730
  ```bash
730
- # via the justfile (loads damage-control-continue first; accepts coms identity flags)
731
- just hub
732
- just hub --name architect --purpose "owns the migration design" --project myrepo
731
+ # Unified Fleet interface (Fleet Core is loaded first)
732
+ just fleet hub
733
+ just fleet hub --name architect --purpose "owns the migration design" --project myrepo
733
734
 
734
735
  # equivalent direct guarded launch
735
736
  pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts
@@ -743,7 +744,7 @@ Identity flags: `--name`, `--purpose`, `--project`, `--color`, `--explicit`.
743
744
 
744
745
  ### Safety scope
745
746
 
746
- `just hub` and `just hub-solo` load `damage-control-continue` and `ask-user-remote` before `agent-hub`, so guardrails and `ask_user` apply
747
+ `just fleet hub` and `just fleet hub --solo` load Fleet Core before `agent-hub`, so guardrails and `ask_user` apply
747
748
  to hub/dispatcher tool calls in that parent pi process — and because it is the *continue* variant, a
748
749
  blocked dispatcher call feeds back and the turn keeps going rather than aborting. Specialist and
749
750
  research agents are spawned as separate pi subprocesses with `--no-extensions` — but `agent-hub`
@@ -761,21 +762,20 @@ additionally read-only by construction. Guided setup enforces `agent-hub` ⇒
761
762
  ### Related recipes
762
763
 
763
764
  ```bash
764
- # the hub without the coms layer (fixed specialists + research only — lighter)
765
- just hub-solo
765
+ # Hub without coms (fixed specialists + research only)
766
+ just fleet hub --solo
766
767
 
767
- # spawn every peer of a team from .pi/agents/peers.yaml into a tiled herdr workspace
768
- # (requires a running herdr server — https://herdr.dev)
769
- just team-up full # launch
770
- just team-up-dry full # print the resolved layout + peer-launch commands without herdr
768
+ # Guarded peers only in a tiled Herdr workspace
769
+ just fleet team full --no-hub
770
+ just fleet team full --no-hub --dry-run
771
771
 
772
- # hub + team in ONE workspace: guarded hub in a larger main pane, peers tiled beside it
773
- just hub-team docs
772
+ # Guarded Hub + peers in one workspace
773
+ just fleet team docs
774
774
 
775
- # fleet resume: snapshot session refs / close cleanly / rebuild with conversations restored
776
- just team-snapshot docs # proactive snapshot while the team runs (crash insurance)
777
- just team-down docs # snapshot + close the workspace (peers get SIGTERM)
778
- just team-resume docs # rebuild the grid; pi peers continue via `pi --session <ref>`
775
+ # Snapshot refs / close cleanly / restore conversations
776
+ just fleet snapshot docs
777
+ just fleet down docs
778
+ just fleet resume docs
779
779
  ```
780
780
 
781
781
  `peers.yaml` groups reusable peers into named teams; each entry is `name` / `persona`
@@ -58,7 +58,7 @@
58
58
  *
59
59
  * Identity flags (coms): --name --purpose --project --color --explicit
60
60
  *
61
- * Usage: just hub
61
+ * Usage: just fleet hub
62
62
  * Direct guarded launch: pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/agent-hub/index.ts
63
63
  */
64
64
 
@@ -76,8 +76,8 @@ import { renderHubFooterLeft } from "./footer.ts";
76
76
  import { HARNESS_VERSION, registerVersionStatus } from "./version.ts";
77
77
  import { cancelLocalOwnedProcess, cancelLocalWaitOnly, monitorKeyForAgent } from "./monitor-control.ts";
78
78
  import { createMonitorLifecycle, monitorLifecycleConfig } from "./monitor-lifecycle.ts";
79
- import { MonitorRegistry } from "../../../scripts/lib/hermes-monitor-registry.ts";
80
- import { MonitorStore } from "../../../scripts/lib/hermes-monitor-store.ts";
79
+ import { MonitorRegistry } from "../lib/hermes-monitor-registry.ts";
80
+ import { MonitorStore } from "../lib/hermes-monitor-store.ts";
81
81
  import { createMonitorSessionBridge } from "./monitor-session-bridge.ts";
82
82
  import { MonitorRuntime } from "./monitor-runtime.ts";
83
83
  import { monitorReconcileEvidence, stableMonitorHubId } from "./monitor-recovery.ts";
@@ -1755,7 +1755,7 @@ export default function (pi: ExtensionAPI) {
1755
1755
  pi.registerFlag("project", { description: "Coms: project namespace for peer discovery", type: "string", default: "default" });
1756
1756
  pi.registerFlag("color", { description: "Coms: hex color #RRGGBB (else frontmatter or palette fallback)", type: "string", default: undefined });
1757
1757
  pi.registerFlag("explicit", { description: "Coms: hide from auto-discovery; addressable only by exact name", type: "boolean", default: false });
1758
- pi.registerFlag("solo", { description: "Run without the coms layer (fixed specialists + research only — `just hub-solo`)", type: "boolean", default: false });
1758
+ pi.registerFlag("solo", { description: "Run without the coms layer (fixed specialists + research only — `just fleet hub --solo`)", type: "boolean", default: false });
1759
1759
 
1760
1760
  // ── Embedded coms: peer state ──
1761
1761
  let identity: {
@@ -3220,7 +3220,7 @@ You are serving a dispatched task as a standing peer; the dispatcher only receiv
3220
3220
 
3221
3221
  // ── Backend routing (dispatch-policy.yaml) ──
3222
3222
  // Decided per dispatch, never at team activation: the hub and its peers
3223
- // boot in parallel (`just hub-team`), so a member's coms peer may register
3223
+ // boot in parallel (`just fleet team`), so a member's coms peer may register
3224
3224
  // at any point. A coms-preferring member with a live same-name pool peer
3225
3225
  // is served by that peer; everything downstream (return contract, ASK_USER,
3226
3226
  // research pipe, history) consumes the same result shape either way.
@@ -7544,7 +7544,7 @@ ${researchCatalog}`;
7544
7544
  // pi's built-in `--name` (session display name) shadows the `--name` flag
7545
7545
  // the embedded coms layer registers, so `flags.name` (getFlag) stays empty
7546
7546
  // when a user passes `--name`. Recover it via getSessionName() — it ranks
7547
- // like the CLI flag (above frontmatter), so `just hub --name foo` is honored.
7547
+ // like the CLI flag (above frontmatter), so `just fleet hub --name foo` is honored.
7548
7548
  const sessionName = typeof pi.getSessionName === "function" ? (pi.getSessionName() || undefined) : undefined;
7549
7549
  const desiredName = flags.name || sessionName || fm.name || defaultName;
7550
7550
  const name = resolveUniqueName(project, desiredName);
@@ -1,5 +1,5 @@
1
1
  import * as path from "node:path";
2
- import { MonitorSocketServer } from "../../../scripts/lib/hermes-monitor-socket.ts";
2
+ import { MonitorSocketServer } from "../lib/hermes-monitor-socket.ts";
3
3
  import { createOwnedHandleRegistry, recordWaitOnlyCancellation } from "./monitor-control.ts";
4
4
  export interface MonitorLifecycleConfig { runtimeDir:string; profileId:string; profilePath:string; }
5
5
  export function monitorLifecycleConfig(env:NodeJS.ProcessEnv):MonitorLifecycleConfig|null{const profileId=env.AGENT_FLEET_PROFILE_ID,runtimeDir=env.AGENT_FLEET_MONITOR_RUNTIME_DIR;if(!profileId||!runtimeDir||!path.isAbsolute(runtimeDir)||!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(profileId)||profileId.includes(".."))return null;return{runtimeDir,profileId,profilePath:path.join(runtimeDir,"profiles",profileId)};}
@@ -2,9 +2,9 @@ import {
2
2
  type CreateChildTaskInput,
3
3
  type CreateParentTaskInput,
4
4
  type MonitorTask,
5
- } from "../../../scripts/lib/hermes-monitor-model.ts";
6
- import { MonitorStore, type MonitorOutput } from "../../../scripts/lib/hermes-monitor-store.ts";
7
- import { correlateHubPane } from "../../../scripts/lib/hermes-monitor-herdr.ts";
5
+ } from "../lib/hermes-monitor-model.ts";
6
+ import { MonitorStore, type MonitorOutput } from "../lib/hermes-monitor-store.ts";
7
+ import { correlateHubPane } from "../lib/hermes-monitor-herdr.ts";
8
8
 
9
9
  export interface ViewerGatedMonitor {
10
10
  setViewers(count: number): void;
@@ -1,4 +1,4 @@
1
- import { MonitorStore } from '../../../scripts/lib/hermes-monitor-store.ts'; import { MonitorPublisher } from './monitor-publisher.ts';
1
+ import { MonitorStore } from '../lib/hermes-monitor-store.ts'; import { MonitorPublisher } from './monitor-publisher.ts';
2
2
  const terminal=(state:any)=>["completed","blocked","failed","cancelled","orphaned","done"].includes(state);
3
3
  export function createMonitorSessionBridge(deps:any={}){const store=deps.store??new MonitorStore({now:deps.now}),pub=deps.publisher??new MonitorPublisher(store),keys=new Map(),ready=new Map(),late=new Map(),finalized=new Map(),cancellable=new Set(),waitAborts=new Map(),recovering=new Map(),monitorKeyByTask=new Map(),lateByGeneration=new Map();let currentOwner:any=deps.currentOwner??{};const runtime=deps.runtime;try{if(runtime){const restored=runtime.load().tasks??[];store.restore(restored);for(const task of restored){if(task.monitorKey){const id=`${task.id}:${task.generation}`;monitorKeyByTask.set(id,task.monitorKey);if(task.lateHistory)lateByGeneration.set(`${task.monitorKey}:${task.generation}`,task.lateHistory);const prior=keys.get(task.monitorKey);if(!prior||prior.generation<task.generation){keys.set(task.monitorKey,{id:task.id,generation:task.generation});ready.set(task.monitorKey,Promise.resolve(task));}}}}}catch(error){throw error}const persist=()=>runtime?.save({tasks:(store.durableSnapshot?.().tasks??records()).map((task:any)=>({...task,monitorKey:monitorKeyByTask.get(`${task.id}:${task.generation}`),lateHistory:lateByGeneration.get(`${monitorKeyByTask.get(`${task.id}:${task.generation}`)}:${task.generation}`)??[]}))});const records=()=>store.snapshot().tasks as any[];const lateEvent=(key:string,event:any,generation?:number)=>{generation??=keys.get(key)?.generation;const lateKey=generation===undefined?key:`${key}:${generation}`;const h=lateByGeneration.get(lateKey)??[];h.push(event);if(h.length>200)h.splice(0,h.length-200);lateByGeneration.set(lateKey,h);late.set(key,h);persist();return{state:'cancelled',history:h};};const after=(key:string,work:(v:any)=>any)=>{const pending=ready.get(key);if(!pending)return Promise.reject(new Error(`child ${key} is not registered`));const chained=pending.then(()=>{const v:any=keys.get(key);return work(v);}).then(value=>{persist();return value;});ready.set(key,chained.catch(()=>undefined));return chained;};return{
4
4
  setCurrentOwner(owner:any){currentOwner={...owner};if(owner.updateActive){for(const task of records())if(!terminal(task.state)){if(!task.ownerSessionId)store.patch(task.id,task.generation,{ownerSessionId:owner.ownerSessionId,ownerLeaseExpiresAt:owner.ownerLeaseExpiresAt});else if(task.ownerSessionId===owner.ownerSessionId)store.patch(task.id,task.generation,{ownerLeaseExpiresAt:owner.ownerLeaseExpiresAt});}persist();}}, startParent(v:any){const task=pub.publishParent({...v,...currentOwner,generation:v.generation??1});keys.set(`parent:${task.id}`,{id:task.id,generation:task.generation});monitorKeyByTask.set(`${task.id}:${task.generation}`,`parent:${task.id}`);persist();return task},
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.4"
6
+ "version": "0.0.5"
7
7
  }
@@ -6,6 +6,7 @@ The experimental Codex Remote-Control conductor is **not** an inbound `ask_user`
6
6
 
7
7
  - The stock `pi-ask-user` extension is loaded through a capture proxy; its `ask_user` tool is not registered directly.
8
8
  - If no live `user-remote` peer is present at call time, the wrapper calls stock `execute` with the original arguments and signal unchanged.
9
+ - Remote lookup follows the explicit Pi `--project <name>` flag at tool-execution time (then `pi.getFlag`, `PI_COMS_PROJECT`, and finally `default`), so a hub and bridge in the same non-default pool can race correctly even though Pi finishes CLI parsing after extension factories load.
9
10
  - If `user-remote` is present, the wrapper races local stock UI against the remote coms request using `race-core.js`; first answer wins and local-first emits one best-effort cancel.
10
11
  - If another extension already registered `ask_user`, registration failure is caught and logged as a warning instead of crashing the session.
11
12
 
@@ -8,6 +8,7 @@
8
8
  import * as fs from "node:fs";
9
9
  import * as os from "node:os";
10
10
  import * as path from "node:path";
11
+ import { fileURLToPath, pathToFileURL } from "node:url";
11
12
 
12
13
  import { raceAskUser } from "./race-core.js";
13
14
 
@@ -29,6 +30,7 @@ interface InstallOptions {
29
30
  warn?: (message: string) => void;
30
31
  createAbortController?: () => AbortController;
31
32
  settingsPaths?: string[];
33
+ remoteProject?: string | (() => string);
32
34
  }
33
35
 
34
36
  // A stock `pi-ask-user` package listed in pi settings is loaded by pi core
@@ -99,6 +101,20 @@ function warn(pi: ExtensionLike, options: InstallOptions, message: string): void
99
101
  console.warn(message);
100
102
  }
101
103
 
104
+ export function resolveRemoteProject(pi: ExtensionLike, argv: string[] = process.argv): string {
105
+ for (let i = argv.length - 2; i >= 0; i--) {
106
+ if (argv[i] === "--project" && typeof argv[i + 1] === "string" && argv[i + 1].trim()) {
107
+ return argv[i + 1].trim();
108
+ }
109
+ }
110
+ const inlineProject = [...argv].reverse().find((arg) => arg.startsWith("--project="))?.slice("--project=".length).trim();
111
+ if (inlineProject) return inlineProject;
112
+ const cliProject = typeof pi.getFlag === "function" ? pi.getFlag("project") : undefined;
113
+ if (typeof cliProject === "string" && cliProject.trim()) return cliProject.trim();
114
+ const envProject = process.env.PI_COMS_PROJECT;
115
+ return envProject?.trim() || "default";
116
+ }
117
+
102
118
  function linkAbortSignal(parent: AbortSignal | undefined, child: AbortController): void {
103
119
  if (!parent) return;
104
120
  if (parent.aborted) {
@@ -151,9 +167,8 @@ export function activeRemoteCount(): number {
151
167
  return activeRemote.size;
152
168
  }
153
169
 
154
- async function defaultStartRemote(params: any): Promise<{ qid: string; result: Promise<any> } | null> {
170
+ async function defaultStartRemote(params: any, project: string): Promise<{ qid: string; result: Promise<any> } | null> {
155
171
  const coms = await import("../../../scripts/lib/coms-envelope.ts");
156
- const project = process.env.PI_COMS_PROJECT || "default";
157
172
  const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
158
173
  const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
159
174
  if (!peer) return null;
@@ -209,10 +224,9 @@ async function defaultStartRemote(params: any): Promise<{ qid: string; result: P
209
224
  return { qid: env.msg_id, result };
210
225
  }
211
226
 
212
- async function defaultCancelRemote(qid: string, reason: string): Promise<void> {
227
+ async function defaultCancelRemote(qid: string, reason: string, project: string): Promise<void> {
213
228
  try {
214
229
  const coms = await import("../../../scripts/lib/coms-envelope.ts");
215
- const project = process.env.PI_COMS_PROJECT || "default";
216
230
  const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
217
231
  const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
218
232
  if (peer) {
@@ -233,7 +247,9 @@ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOpt
233
247
  return {
234
248
  ...stockTool,
235
249
  async execute(toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: any, ctx?: any) {
236
- const startRemote = options.startRemote ?? defaultStartRemote;
250
+ const configuredProject = typeof options.remoteProject === "function" ? options.remoteProject() : options.remoteProject;
251
+ const remoteProject = configuredProject ?? process.env.PI_COMS_PROJECT?.trim() ?? "default";
252
+ const startRemote = options.startRemote ?? ((remoteParams: any) => defaultStartRemote(remoteParams, remoteProject));
237
253
  let remoteStart: { qid: string; result: Promise<any> } | null = null;
238
254
  try {
239
255
  remoteStart = await startRemote(params, ctx);
@@ -248,7 +264,7 @@ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOpt
248
264
  return await raceAskUser({
249
265
  runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, params, localSignal, onUpdate, ctx),
250
266
  startRemote: () => remoteStart,
251
- cancelRemote: options.cancelRemote ?? defaultCancelRemote,
267
+ cancelRemote: options.cancelRemote ?? ((qid: string, reason: string) => defaultCancelRemote(qid, reason, remoteProject)),
252
268
  createAbortController: () => {
253
269
  const controller = options.createAbortController?.() ?? new AbortController();
254
270
  linkAbortSignal(signal, controller);
@@ -270,7 +286,10 @@ export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions
270
286
  }
271
287
  if (!options.stockFactory) throw new Error("ask-user-remote: stockFactory is required for synchronous install");
272
288
  const stockTool = captureAskUserTool(options.stockFactory, pi);
273
- const wrapped = wrapAskUserTool(stockTool, options);
289
+ const wrapped = wrapAskUserTool(stockTool, {
290
+ ...options,
291
+ remoteProject: options.remoteProject ?? (() => resolveRemoteProject(pi)),
292
+ });
274
293
  try {
275
294
  pi.registerTool(wrapped);
276
295
  return { registered: true, tool: wrapped };
@@ -281,8 +300,17 @@ export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions
281
300
  }
282
301
  }
283
302
 
303
+ export function resolveStockAskUserModule(moduleUrl: string = import.meta.url): string {
304
+ // Pi's jiti loader preserves the workspace-facing path of a symlinked
305
+ // harness. Canonicalize this module first so the bundled dependency is
306
+ // resolved beside the actual Agent Fleet package, not at workspace root.
307
+ const realModulePath = fs.realpathSync(fileURLToPath(moduleUrl));
308
+ const stockModulePath = path.resolve(path.dirname(realModulePath), "../../../node_modules/pi-ask-user/index.ts");
309
+ return pathToFileURL(stockModulePath).href;
310
+ }
311
+
284
312
  async function loadStockFactory(): Promise<(pi: ExtensionLike) => void> {
285
- const mod = await import("../../../node_modules/pi-ask-user/index.ts");
313
+ const mod = await import(resolveStockAskUserModule());
286
314
  return mod.default as (pi: ExtensionLike) => void;
287
315
  }
288
316
 
@@ -80,11 +80,11 @@ Nothing in-repo — the peer registry lives at `~/.pi/coms/` and is created at r
80
80
  pi -e .pi/harnesses/coms/index.ts
81
81
  ```
82
82
 
83
- For a guarded coms node that also keeps every auto-discovered local extension (MCP bridges,
84
- project-specific extensions) and command, use the `just safe-coms <name>` recipe — it loads
85
- `damage-control-continue` + `coms` *on top of* normal extension discovery (no `--no-extensions`), so the
86
- local-only tools stay scoped to that dispatcher process and never leak into the `--no-extensions`
87
- specialists an `agent-hub` session spawns.
83
+ For a guarded coms node, use `just fleet peer <name>`. It loads Fleet Core plus `coms`
84
+ with deterministic extension discovery. Add `--browser` for Chrome DevTools or
85
+ `--all-extensions` when the peer intentionally needs arbitrary project/global extensions;
86
+ those tools stay scoped to that process and never leak into Agent Hub's
87
+ `--no-extensions` specialists.
88
88
 
89
89
  ## Upstream changes
90
90
 
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.4"
6
+ "version": "0.0.5"
7
7
  }
@@ -69,9 +69,9 @@ outcomes) is logged to the `damage-control-log` session entries.
69
69
 
70
70
  ## When it's used (this repo)
71
71
 
72
- `just hub` / `just hub-solo` load this harness for the **orchestrator/dispatcher
73
- main session**, and Agent Hub re-loads it into every native **specialist, research
74
- helper, and nested delegate**. If the harness cannot be resolved, Agent Hub
72
+ Every `just fleet` Pi mode loads this harness: the default interactive session,
73
+ standalone peers, Hub, and Herdr Pi peers. Agent Hub additionally re-loads it into
74
+ every native **specialist, research helper, and nested delegate**. If the harness cannot be resolved, Agent Hub
75
75
  refuses guarded child dispatch rather than launching an unprotected process.
76
76
 
77
77
  ## Commands & tools
@@ -94,12 +94,12 @@ Blocking itself runs passively on the `tool_call` event.
94
94
 
95
95
  ```bash
96
96
  # standalone continue-mode guardrail session
97
- just ext-damage-control-continue
97
+ just fleet
98
98
  pi -e .pi/harnesses/damage-control-continue/index.ts
99
99
 
100
- # the hub recipes load this variant for the main agent by default
101
- just hub
102
- just hub-solo
100
+ # Hub variants
101
+ just fleet hub
102
+ just fleet hub --solo
103
103
 
104
104
  # direct continue-guarded hub launch
105
105
  pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/agent-hub/index.ts
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.4"
6
+ "version": "0.0.5"
7
7
  }
@@ -0,0 +1,28 @@
1
+ import { herdr, subscribe, type HerdrClientOptions, type SubscribeHandle } from "./herdr-client.ts";
2
+
3
+ export interface HubCorrelation { workspaceId?: string; hubPaneId?: string; status: "correlated" | "uncorrelated" | "reconnecting"; }
4
+
5
+ export async function correlateHubPane(env: NodeJS.ProcessEnv = process.env, opts: HerdrClientOptions = {}): Promise<HubCorrelation> {
6
+ const hubPaneId = env.HERDR_PANE_ID;
7
+ if (env.HERDR_ENV !== "1" || !hubPaneId) return { status: "uncorrelated" };
8
+ try { const { pane } = await herdr.paneGet(hubPaneId, { socketPath: env.HERDR_SOCKET_PATH, ...opts }); return { workspaceId: pane.workspace_id, hubPaneId, status: "correlated" }; }
9
+ catch { return { hubPaneId, status: "reconnecting" }; }
10
+ }
11
+
12
+ export function watchHubMonitor(options: { env?: NodeJS.ProcessEnv; onStatus: (value: HubCorrelation) => void; onOutput?: (output: { sequence: number; text: string }) => void; initialCursor?: number; reconnectDelayMs?: number }): SubscribeHandle | null {
13
+ const env = options.env ?? process.env;
14
+ const paneId = env.HERDR_PANE_ID;
15
+ if (env.HERDR_ENV !== "1" || !paneId) { options.onStatus({ status: "uncorrelated" }); return null; }
16
+ let cursor = options.initialCursor ?? 0;
17
+ const refresh = async () => {
18
+ try {
19
+ const { pane } = await herdr.paneGet(paneId, { socketPath: env.HERDR_SOCKET_PATH });
20
+ options.onStatus({ workspaceId: pane.workspace_id, hubPaneId: paneId, status: "correlated" });
21
+ const output = (pane as { monitor_resync_output?: { sequence?: number; text?: string } }).monitor_resync_output;
22
+ if (output && typeof output.sequence === "number" && output.sequence > cursor && typeof output.text === "string") { cursor = output.sequence; options.onOutput?.({ sequence: output.sequence, text: output.text }); }
23
+ } catch { options.onStatus({ hubPaneId: paneId, status: "reconnecting" }); }
24
+ };
25
+ void refresh();
26
+ let connected = false;
27
+ return subscribe([{ type: "pane.agent_status_changed", pane_id: paneId }], () => void refresh(), { socketPath: env.HERDR_SOCKET_PATH, reconnectDelayMs: options.reconnectDelayMs, onConnect: () => { if (connected) options.onStatus({ hubPaneId: paneId, status: "reconnecting" }); connected = true; void refresh(); }, onError: () => options.onStatus({ hubPaneId: paneId, status: "reconnecting" }) });
28
+ }
@@ -0,0 +1,9 @@
1
+ export type MonitorTaskState = "starting" | "running" | "cancelling" | "completed" | "blocked" | "failed" | "cancelled" | "orphaned" | "recovering";
2
+ export const TERMINAL_TASK_STATES = new Set<MonitorTaskState>(["completed","blocked","failed","cancelled","orphaned"]);export type MonitorTaskKind="parent"|"child";
3
+ export interface MonitorTask{id:string;generation:number;kind:MonitorTaskKind;state:MonitorTaskState;parentId?:string;parentGeneration?:number;hubInstanceId?:string;checkoutId?:string;specialist?:string;workspaceId?:string;hubPaneId?:string;ownerSessionId?:string;ownerLeaseExpiresAt?:string;}
4
+ export interface CreateParentTaskInput{id:string;generation:number;hubInstanceId:string;checkoutId:string;ownerSessionId?:string;ownerLeaseExpiresAt?:string;}
5
+ export interface CreateChildTaskInput{id:string;generation:number;parentId:string;parentGeneration:number;specialist:string;workspaceId?:string;hubPaneId?:string;ownerSessionId?:string;ownerLeaseExpiresAt?:string;}
6
+ function requireStableIdentity(id:string,generation:number){if(!id)throw Error("task id is required");if(!Number.isInteger(generation)||generation<1)throw Error("task generation must be a positive integer");}const owner=(i:any)=>({...((i.ownerSessionId)?{ownerSessionId:i.ownerSessionId}:{}),...((i.ownerLeaseExpiresAt)?{ownerLeaseExpiresAt:i.ownerLeaseExpiresAt}:{})});
7
+ export function createParentTask(input:CreateParentTaskInput):MonitorTask{requireStableIdentity(input.id,input.generation);if(!input.hubInstanceId||!input.checkoutId)throw Error("parent correlation is required");return{id:input.id,generation:input.generation,kind:"parent",state:"starting",hubInstanceId:input.hubInstanceId,checkoutId:input.checkoutId,...owner(input)};}
8
+ export function createChildTask(input:CreateChildTaskInput):MonitorTask{requireStableIdentity(input.id,input.generation);if(!input.parentId||!Number.isInteger(input.parentGeneration)||input.parentGeneration<1||!input.specialist)throw Error("child hierarchy is required");return{id:input.id,generation:input.generation,kind:"child",state:"starting",parentId:input.parentId,parentGeneration:input.parentGeneration,specialist:input.specialist,...(input.workspaceId?{workspaceId:input.workspaceId}:{}),...(input.hubPaneId?{hubPaneId:input.hubPaneId}:{}),...owner(input)};}
9
+ export function transitionTask(task:MonitorTask,state:MonitorTaskState):MonitorTask{if(TERMINAL_TASK_STATES.has(task.state))throw Error(`terminal task ${task.id} cannot mutate`);if(state==="starting")throw Error("tasks cannot transition back to starting");return{...task,state};}export function continueTask(task:MonitorTask):MonitorTask{if(task.state!=="blocked")throw Error(`only blocked task ${task.id} can continue`);return{...task,generation:task.generation+1,state:"starting"};}
@@ -0,0 +1,6 @@
1
+ import * as crypto from "node:crypto"; import * as fs from "node:fs"; import * as path from "node:path";
2
+ export interface MonitorRegistration {profileKey:string;namespacePath:string;socketPath:string;socketDir:string;token:string;namespaceMode:number;tokenMode:number;discoveryPath:string;snapshot():unknown;cancel?(r:{taskId:string;generation:number}):unknown|Promise<unknown>;output?(r:{taskId:string;generation:number;afterSequence:number}):unknown|Promise<unknown>;cleanup():void;renew():void;leaseMs:number;ownerId?:string;leaseExpiresAt?:string;}
3
+ export interface MonitorRegistryOptions {runtimeDir:string;now?:()=>Date;pid?:number;leaseMs?:number;beforeRenewPublish?:()=>void;} export interface RegisterMonitorInput {profilePath:string;profileId?:string;hubInstanceId:string;snapshot:()=>unknown;}
4
+ const D=0o700,F=0o600;const validDiscovery=(d:any)=>typeof d?.owner==="string"&&/^[0-9a-f-]{36}$/i.test(d.owner)&&typeof d.token==="string"&&/^token-[0-9a-f-]{36}$/i.test(d.token)&&typeof d.socket==="string"&&/^@runtime\/s\/[a-f0-9]+\/s$/.test(d.socket)&&typeof d.lease?.hub==="string"&&/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(d.lease.hub)&&Number.isInteger(d.lease?.pid)&&d.lease.pid>0&&typeof d.lease?.startedAt==="string"&&!Number.isNaN(Date.parse(d.lease.startedAt))&&typeof d.lease?.expiresAt==="string"&&!Number.isNaN(Date.parse(d.lease.expiresAt));const mode=(p:string)=>fs.statSync(p).mode&0o777;function dir(p:string){if(!path.isAbsolute(p))throw Error("monitor runtime directory must be absolute");fs.mkdirSync(p,{recursive:true,mode:D});if(fs.lstatSync(p).isSymbolicLink())throw Error("monitor runtime directory must not be a symlink");fs.chmodSync(p,D);}export function canonicalMonitorProfileId(id:string){if(!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(id)||id.includes(".."))throw Error("monitor profile id is unsafe");return crypto.createHash("sha256").update(id).digest("hex");}function profile(p:string,id?:string){if(id)return canonicalMonitorProfileId(id);const real=fs.realpathSync(p);if(!fs.statSync(real).isDirectory())throw Error("monitor profile path must be a directory");return crypto.createHash("sha256").update(real).digest("hex");}function hub(id:string){if(!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(id)||id.includes(".."))throw Error("hub instance id is unsafe");return crypto.createHash("sha256").update(id).digest("hex");}function atomic(p:string,s:string){const t=`${p}.${process.pid}.${crypto.randomBytes(4).toString("hex")}.tmp`;fs.writeFileSync(t,s,{mode:F,flag:"wx"});fs.chmodSync(t,F);fs.renameSync(t,p);}
5
+ export class MonitorRegistry {private runtimeDir:string;private now:()=>Date;private pid:number;private leaseMs:number;private beforeRenewPublish?:()=>void;constructor(o:MonitorRegistryOptions){this.runtimeDir=o.runtimeDir;this.now=o.now??(()=>new Date());this.pid=o.pid??process.pid;this.leaseMs=o.leaseMs??30_000;this.beforeRenewPublish=o.beforeRenewPublish;dir(this.runtimeDir);}register(input:RegisterMonitorInput):MonitorRegistration{const key=profile(input.profilePath,input.profileId),h=hub(input.hubInstanceId),ns=path.join(this.runtimeDir,key,h);dir(path.join(this.runtimeDir,key));dir(ns);for(const file of fs.readdirSync(ns).filter(x=>x.startsWith("discovery-"))){const discoveryPath=path.join(ns,file);try{const d=JSON.parse(fs.readFileSync(discoveryPath,"utf8"));if(!validDiscovery(d)||d.token!==`token-${d.owner}`||d.socket!==`@runtime/s/${crypto.createHash("sha256").update(`${key}:${h}:${d.owner}`).digest("hex").slice(0,32)}/s`)throw new Error("monitor discovery metadata is malformed");if(new Date(d.lease?.expiresAt).getTime()>this.now().getTime()){const error:any=Error("monitor namespace is owned by an active lease");error.leaseExpiresAt=d.lease.expiresAt;throw error;}const tokenName=d.token;if(typeof tokenName==="string"&&/^token-[0-9a-f-]+$/.test(tokenName))try{fs.unlinkSync(path.join(ns,tokenName))}catch(e:any){if(e?.code!=="ENOENT")throw e;}fs.unlinkSync(discoveryPath);const socket=typeof d.socket==="string"?d.socket:"";if(socket.startsWith("@runtime/s/")&&socket.endsWith("/s")){const socketDir=path.join(this.runtimeDir,socket.slice("@runtime/".length,-2));if(socketDir.startsWith(path.join(this.runtimeDir,"s")+path.sep))try{fs.rmSync(socketDir,{recursive:true,force:true})}catch{}}}catch(e:any){if(/active lease|malformed/.test(String(e)))throw e;if(e instanceof SyntaxError||e instanceof TypeError||e instanceof RangeError)throw new Error("monitor discovery metadata is malformed");}}
6
+ const owner=crypto.randomUUID(),socketDir=path.join(this.runtimeDir,"s",crypto.createHash("sha256").update(`${key}:${h}:${owner}`).digest("hex").slice(0,32));dir(socketDir);const tokenPath=path.join(ns,`token-${owner}`),discoveryPath=path.join(ns,`discovery-${owner}.json`),socketPath=path.join(socketDir,"s"),token=crypto.randomBytes(32).toString("hex"),started=this.now();atomic(tokenPath,token);const tokenFd=fs.openSync(tokenPath,"r");const write=(issued:Date)=>atomic(discoveryPath,JSON.stringify({owner,socket:`@runtime/s/${path.basename(socketDir)}/s`,token:path.basename(tokenPath),lease:{hub:input.hubInstanceId,pid:this.pid,startedAt:started.toISOString(),expiresAt:new Date(issued.getTime()+this.leaseMs).toISOString()}}));write(started);const owns=()=>{try{return fs.fstatSync(tokenFd).nlink===1&&fs.readFileSync(tokenPath,"utf8")===token&&JSON.parse(fs.readFileSync(discoveryPath,"utf8")).owner===owner;}catch{return false;}};const cleanup=()=>{if(!owns())return;for(const p of [tokenPath,discoveryPath])try{fs.unlinkSync(p)}catch(e:any){if(e?.code!=="ENOENT")throw e;}finally{try{fs.closeSync(tokenFd)}catch{}}};return{profileKey:key,ownerId:owner,leaseExpiresAt:new Date(started.getTime()+this.leaseMs).toISOString(),namespacePath:ns,socketPath,socketDir,token,namespaceMode:mode(ns),tokenMode:mode(tokenPath),discoveryPath,snapshot:input.snapshot,cleanup,renew:()=>{if(!owns())throw Error("monitor ownership lost");this.beforeRenewPublish?.();if(!owns())throw Error("monitor ownership lost");const renewedAt=this.now();write(renewedAt);if(!owns()){try{if(JSON.parse(fs.readFileSync(discoveryPath,"utf8")).owner===owner)fs.unlinkSync(discoveryPath)}catch{}throw Error("monitor ownership lost");}return{leaseExpiresAt:new Date(renewedAt.getTime()+this.leaseMs).toISOString()};},leaseMs:this.leaseMs};} evidenceForOwner(ownerId:string,hubInstanceId:string){try{if(!/^[0-9a-f-]{36}$/i.test(ownerId))throw Error("malformed");const h=hub(hubInstanceId);for(const profileKey of fs.readdirSync(this.runtimeDir)){const p=path.join(this.runtimeDir,profileKey,h,`discovery-${ownerId}.json`);if(!fs.existsSync(p))continue;const d=JSON.parse(fs.readFileSync(p,"utf8"));if(!validDiscovery(d)||d.owner!==ownerId||d.token!==`token-${ownerId}`)throw Error("malformed");const token=path.join(path.dirname(p),d.token),socket=path.join(this.runtimeDir,d.socket.slice("@runtime/".length));return{owner:fs.existsSync(token),socket:fs.existsSync(socket),session:fs.existsSync(token),expired:new Date(d.lease.expiresAt).getTime()<=this.now().getTime()};}return{owner:false,socket:false,session:false,expired:true};}catch(error){return{transient:true,error};}}}