@chankov/agent-fleet 0.0.5 → 0.0.7

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 (695) hide show
  1. package/.claude/commands/set-hermes-watchdog.md +6 -0
  2. package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  3. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  4. package/.pi/extensions/btw/README.md +10 -10
  5. package/.pi/extensions/btw/index.ts +11 -11
  6. package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
  7. package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
  8. package/.pi/extensions/compact-and-continue/README.md +2 -2
  9. package/.pi/extensions/pi-voice-stt/README.md +7 -7
  10. package/.pi/extensions/pi-voice-stt/index.ts +4 -4
  11. package/.pi/harnesses/agent-hub/README.md +133 -74
  12. package/.pi/harnesses/agent-hub/artifacts.js +56 -2
  13. package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  14. package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
  15. package/.pi/harnesses/agent-hub/context-window.js +106 -0
  16. package/.pi/harnesses/agent-hub/delegate.ts +61 -12
  17. package/.pi/harnesses/agent-hub/drift-watchdog.js +55 -9
  18. package/.pi/harnesses/agent-hub/helpers.ts +34 -0
  19. package/.pi/harnesses/agent-hub/index.ts +970 -406
  20. package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  21. package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  22. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
  23. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
  24. package/.pi/harnesses/agent-hub/package.json +1 -1
  25. package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  26. package/.pi/harnesses/agent-hub/return-contract.js +78 -0
  27. package/.pi/harnesses/agent-hub/return-extract.js +75 -0
  28. package/.pi/harnesses/agent-hub/run-budget.js +30 -4
  29. package/.pi/harnesses/agent-hub/session-health.js +110 -0
  30. package/.pi/harnesses/agent-hub/spawn.ts +109 -1
  31. package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  32. package/.pi/harnesses/coms/README.md +6 -5
  33. package/.pi/harnesses/coms/index.ts +92 -70
  34. package/.pi/harnesses/coms/package.json +1 -1
  35. package/.pi/harnesses/damage-control-continue/README.md +9 -9
  36. package/.pi/harnesses/damage-control-continue/index.ts +11 -11
  37. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  38. package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  39. package/.pi/harnesses/lib/herdr-client.ts +7 -2
  40. package/.pi/harnesses/lib/herdr-presence.ts +141 -30
  41. package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  42. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  43. package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
  44. package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
  45. package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
  46. package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  47. package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
  48. package/.versions/0.0.6/.claude/commands/build.md +44 -0
  49. package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
  50. package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
  51. package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
  52. package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
  53. package/.versions/0.0.6/.claude/commands/plan.md +16 -0
  54. package/.versions/0.0.6/.claude/commands/prime.md +22 -0
  55. package/.versions/0.0.6/.claude/commands/review.md +16 -0
  56. package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
  57. package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
  58. package/.versions/0.0.6/.claude/commands/ship.md +72 -0
  59. package/.versions/0.0.6/.claude/commands/spec.md +15 -0
  60. package/.versions/0.0.6/.claude/commands/test.md +19 -0
  61. package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
  62. package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
  63. package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
  64. package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
  65. package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
  66. package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
  67. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  68. package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
  69. package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
  70. package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
  71. package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
  72. package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
  73. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
  74. package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
  75. package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
  76. package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
  77. package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
  78. package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
  79. package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  80. package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
  81. package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
  82. package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
  83. package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
  84. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  85. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  86. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  87. package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
  88. package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
  89. package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
  90. package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
  91. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  92. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  93. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  94. package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  95. package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  96. package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  97. package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  98. package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  99. package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  100. package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
  101. package/.versions/0.0.6/.pi/extensions/package.json +9 -0
  102. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
  103. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  104. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  105. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  106. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  107. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  108. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  109. package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
  110. package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  111. package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
  112. package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  113. package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
  114. package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  115. package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  116. package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
  117. package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
  118. package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
  119. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  120. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  121. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  122. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  123. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  124. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  125. package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  126. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
  127. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  128. package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
  129. package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
  130. package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  131. package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  132. package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
  133. package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
  134. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
  135. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
  136. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  137. package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
  138. package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
  139. package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
  140. package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
  141. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
  142. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  143. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  144. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
  145. package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  146. package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
  147. package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
  148. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  149. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  150. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  151. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  152. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  153. package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
  154. package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
  155. package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
  156. package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
  157. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  158. package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
  159. package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
  160. package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  161. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
  162. package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
  163. package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
  164. package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
  165. package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
  166. package/.versions/0.0.6/.version +1 -0
  167. package/.versions/0.0.6/agents/architect.md +23 -0
  168. package/.versions/0.0.6/agents/bowser.md +26 -0
  169. package/.versions/0.0.6/agents/builder.md +53 -0
  170. package/.versions/0.0.6/agents/code-reviewer.md +205 -0
  171. package/.versions/0.0.6/agents/deep-researcher.md +31 -0
  172. package/.versions/0.0.6/agents/documenter.md +18 -0
  173. package/.versions/0.0.6/agents/orchestrator.md +54 -0
  174. package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
  175. package/.versions/0.0.6/agents/planner.md +69 -0
  176. package/.versions/0.0.6/agents/releaser.md +24 -0
  177. package/.versions/0.0.6/agents/researcher.md +28 -0
  178. package/.versions/0.0.6/agents/security-auditor.md +166 -0
  179. package/.versions/0.0.6/agents/test-engineer.md +151 -0
  180. package/.versions/0.0.6/agents/web-debugger.md +42 -0
  181. package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
  182. package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
  183. package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
  184. package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
  185. package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
  186. package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
  187. package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
  188. package/.versions/0.0.6/docs/getting-started.md +183 -0
  189. package/.versions/0.0.6/docs/npm-install.md +337 -0
  190. package/.versions/0.0.6/docs/opencode-setup.md +249 -0
  191. package/.versions/0.0.6/docs/pi-extensions.md +293 -0
  192. package/.versions/0.0.6/docs/pi-setup.md +476 -0
  193. package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
  194. package/.versions/0.0.6/hermes/README.md +231 -0
  195. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  196. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  197. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  198. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  199. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  200. package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  201. package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  202. package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
  203. package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
  204. package/.versions/0.0.6/hooks/hooks.json +14 -0
  205. package/.versions/0.0.6/hooks/session-start.sh +74 -0
  206. package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
  207. package/.versions/0.0.6/justfile +245 -0
  208. package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
  209. package/.versions/0.0.6/references/definition-of-done.md +67 -0
  210. package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
  211. package/.versions/0.0.6/references/observability-checklist.md +91 -0
  212. package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
  213. package/.versions/0.0.6/references/performance-checklist.md +153 -0
  214. package/.versions/0.0.6/references/prompting-patterns.md +380 -0
  215. package/.versions/0.0.6/references/security-checklist.md +179 -0
  216. package/.versions/0.0.6/references/testing-patterns.md +236 -0
  217. package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
  218. package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
  219. package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
  220. package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
  221. package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
  222. package/.versions/0.0.6/scripts/fleet.ts +141 -0
  223. package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  224. package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
  225. package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
  226. package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
  227. package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
  228. package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
  229. package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  230. package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
  231. package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
  232. package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  233. package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  234. package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  235. package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  236. package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  237. package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  238. package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
  239. package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
  240. package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
  241. package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
  242. package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
  243. package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
  244. package/.versions/0.0.6/scripts/team-up.ts +351 -0
  245. package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
  246. package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
  247. package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  248. package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
  249. package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
  250. package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  251. package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
  252. package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  253. package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  254. package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  255. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
  256. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
  257. package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
  258. package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
  259. package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
  260. package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  261. package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  262. package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
  263. package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
  264. package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
  265. package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
  266. package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
  267. package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
  268. package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
  269. package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
  270. package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
  271. package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  272. package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  273. package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
  274. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  275. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  276. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  277. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  278. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  279. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  280. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  281. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  282. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  283. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  284. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  285. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  286. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  287. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  288. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  289. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  290. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  291. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  292. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  293. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  294. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  295. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  296. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  297. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  298. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  299. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  300. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  301. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  302. package/.versions/0.0.7/.claude/commands/build.md +44 -0
  303. package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
  304. package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
  305. package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
  306. package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
  307. package/.versions/0.0.7/.claude/commands/plan.md +16 -0
  308. package/.versions/0.0.7/.claude/commands/prime.md +22 -0
  309. package/.versions/0.0.7/.claude/commands/review.md +16 -0
  310. package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
  311. package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
  312. package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
  313. package/.versions/0.0.7/.claude/commands/ship.md +72 -0
  314. package/.versions/0.0.7/.claude/commands/spec.md +15 -0
  315. package/.versions/0.0.7/.claude/commands/test.md +19 -0
  316. package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
  317. package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
  318. package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
  319. package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
  320. package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
  321. package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
  322. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  323. package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
  324. package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
  325. package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
  326. package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
  327. package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
  328. package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  329. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
  330. package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
  331. package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
  332. package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
  333. package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
  334. package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
  335. package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  336. package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
  337. package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
  338. package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
  339. package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
  340. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  341. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  342. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  343. package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
  344. package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
  345. package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
  346. package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
  347. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  348. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  349. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  350. package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  351. package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  352. package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  353. package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  354. package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  355. package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  356. package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
  357. package/.versions/0.0.7/.pi/extensions/package.json +9 -0
  358. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
  359. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  360. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  361. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  362. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  363. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  364. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  365. package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
  366. package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  367. package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  368. package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  369. package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  370. package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  371. package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
  372. package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  373. package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  374. package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
  375. package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
  376. package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
  377. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  378. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  379. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  380. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  381. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  382. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  383. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  384. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  385. package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  386. package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  387. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
  388. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  389. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  390. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  391. package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
  392. package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  393. package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  394. package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  395. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
  396. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  397. package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
  398. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
  399. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
  400. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  401. package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
  402. package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
  403. package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
  404. package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
  405. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
  406. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
  407. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  408. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
  409. package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  410. package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  411. package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
  412. package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  413. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  414. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  415. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  416. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  417. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  418. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  419. package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
  420. package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
  421. package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
  422. package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
  423. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  424. package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
  425. package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
  426. package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  427. package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  428. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
  429. package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
  430. package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
  431. package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
  432. package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
  433. package/.versions/0.0.7/.version +1 -0
  434. package/.versions/0.0.7/agents/architect.md +23 -0
  435. package/.versions/0.0.7/agents/bowser.md +26 -0
  436. package/.versions/0.0.7/agents/builder.md +53 -0
  437. package/.versions/0.0.7/agents/code-reviewer.md +205 -0
  438. package/.versions/0.0.7/agents/deep-researcher.md +31 -0
  439. package/.versions/0.0.7/agents/documenter.md +18 -0
  440. package/.versions/0.0.7/agents/orchestrator.md +65 -0
  441. package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
  442. package/.versions/0.0.7/agents/planner.md +69 -0
  443. package/.versions/0.0.7/agents/releaser.md +24 -0
  444. package/.versions/0.0.7/agents/researcher.md +28 -0
  445. package/.versions/0.0.7/agents/security-auditor.md +166 -0
  446. package/.versions/0.0.7/agents/test-engineer.md +151 -0
  447. package/.versions/0.0.7/agents/web-debugger.md +42 -0
  448. package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
  449. package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
  450. package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
  451. package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
  452. package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
  453. package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
  454. package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
  455. package/.versions/0.0.7/docs/getting-started.md +231 -0
  456. package/.versions/0.0.7/docs/npm-install.md +337 -0
  457. package/.versions/0.0.7/docs/opencode-setup.md +249 -0
  458. package/.versions/0.0.7/docs/pi-extensions.md +293 -0
  459. package/.versions/0.0.7/docs/pi-setup.md +476 -0
  460. package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
  461. package/.versions/0.0.7/hermes/README.md +347 -0
  462. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  463. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  464. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  465. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  466. package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
  467. package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  468. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  469. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  470. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  471. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  472. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  473. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  474. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  475. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  476. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  477. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  478. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  479. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  480. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  481. package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  482. package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  483. package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  484. package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  485. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  486. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  487. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  488. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  489. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  490. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  491. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  492. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  493. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  494. package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
  495. package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
  496. package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
  497. package/.versions/0.0.7/hooks/hooks.json +14 -0
  498. package/.versions/0.0.7/hooks/session-start.sh +74 -0
  499. package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
  500. package/.versions/0.0.7/justfile +245 -0
  501. package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
  502. package/.versions/0.0.7/references/definition-of-done.md +67 -0
  503. package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
  504. package/.versions/0.0.7/references/observability-checklist.md +91 -0
  505. package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
  506. package/.versions/0.0.7/references/performance-checklist.md +153 -0
  507. package/.versions/0.0.7/references/prompting-patterns.md +380 -0
  508. package/.versions/0.0.7/references/security-checklist.md +179 -0
  509. package/.versions/0.0.7/references/testing-patterns.md +236 -0
  510. package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
  511. package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
  512. package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
  513. package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
  514. package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
  515. package/.versions/0.0.7/scripts/fleet.ts +149 -0
  516. package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  517. package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  518. package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  519. package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
  520. package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
  521. package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
  522. package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
  523. package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
  524. package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  525. package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
  526. package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
  527. package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  528. package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  529. package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  530. package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  531. package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  532. package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  533. package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  534. package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
  535. package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
  536. package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
  537. package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
  538. package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
  539. package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
  540. package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
  541. package/.versions/0.0.7/scripts/team-up.ts +360 -0
  542. package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
  543. package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
  544. package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  545. package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
  546. package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
  547. package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  548. package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
  549. package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  550. package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  551. package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  552. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
  553. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
  554. package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
  555. package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
  556. package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
  557. package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  558. package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  559. package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
  560. package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
  561. package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
  562. package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
  563. package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
  564. package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
  565. package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
  566. package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
  567. package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
  568. package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  569. package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  570. package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
  571. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  572. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  573. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  574. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  575. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  576. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  577. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  578. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  579. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  580. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  581. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  582. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  583. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  584. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  585. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  586. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  587. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  588. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  589. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  590. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  591. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  592. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  593. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  594. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  595. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  596. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  597. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  598. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  599. package/CHANGELOG.md +140 -0
  600. package/README.md +198 -40
  601. package/agents/code-reviewer.md +2 -2
  602. package/agents/documenter.md +1 -1
  603. package/agents/orchestrator.md +11 -0
  604. package/agents/plan-reviewer.md +1 -1
  605. package/agents/planner.md +1 -1
  606. package/agents/releaser.md +1 -1
  607. package/agents/security-auditor.md +1 -1
  608. package/bin/cli.js +60 -21
  609. package/bin/lib/bootstrap.js +16 -16
  610. package/bin/lib/doctor.js +1 -1
  611. package/bin/lib/hermes-profile-artifact.js +144 -0
  612. package/bin/lib/set-hermes-watchdog.js +173 -0
  613. package/bin/set-hermes-watchdog.js +26 -0
  614. package/docs/ARCHITECTURE.md +67 -15
  615. package/docs/agent-fleet-setup.md +13 -13
  616. package/docs/claude-code-coms-bridge.md +7 -1
  617. package/docs/coms-hermes-bridge.md +18 -8
  618. package/docs/getting-started.md +48 -0
  619. package/docs/hermes-watchdog-supervisor.md +140 -0
  620. package/docs/npm-install.md +21 -21
  621. package/docs/pi-extensions.md +7 -7
  622. package/docs/pi-setup.md +51 -47
  623. package/hermes/README.md +135 -19
  624. package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  625. package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  626. package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  627. package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  628. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  629. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  630. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  631. package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  632. package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  633. package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  634. package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  635. package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  636. package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  637. package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  638. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  639. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
  640. package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  641. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  642. package/hermes/skills/hub-watchdog/SKILL.md +76 -0
  643. package/hermes/skills/hub-watchdog/manifest.json +1 -0
  644. package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  645. package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  646. package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  647. package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  648. package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  649. package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  650. package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  651. package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  652. package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  653. package/hooks/coms-stop-hook.mjs +12 -1
  654. package/package.json +11 -2
  655. package/references/fleet-coordination-patterns.md +2 -2
  656. package/scripts/coms-claude-bridge.ts +154 -39
  657. package/scripts/fleet.ts +9 -1
  658. package/scripts/hermes-watchdog-capability-probe.ts +45 -0
  659. package/scripts/lib/claude-bridge-core.ts +65 -0
  660. package/scripts/lib/coms-envelope.ts +44 -1
  661. package/scripts/lib/hermes-monitor-events.ts +1 -0
  662. package/scripts/lib/monitor-env.ts +120 -0
  663. package/scripts/team-snapshot.ts +1 -1
  664. package/scripts/team-up.ts +10 -1
  665. package/skills/browser-testing-with-devtools/SKILL.md +1 -1
  666. package/skills/compound-learning/SKILL.md +3 -3
  667. package/skills/guided-workspace-setup/SKILL.md +16 -14
  668. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  669. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  670. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  671. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  672. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  673. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  674. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  675. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  676. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  677. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  678. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  679. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  680. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  681. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  682. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  683. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  684. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  685. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  686. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  687. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  688. /package/.pi/prompts/{build.md → af-build.md} +0 -0
  689. /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
  690. /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
  691. /package/.pi/prompts/{review.md → af-review.md} +0 -0
  692. /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
  693. /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
  694. /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
  695. /package/.pi/prompts/{test.md → af-test.md} +0 -0
@@ -0,0 +1,74 @@
1
+ // Hub-spawned coms peers: readiness policy and the never-addressed sweep.
2
+ //
3
+ // Root cause this encodes: `herdr_spawn_peer` launches a REUSABLE coms peer —
4
+ // it boots idle and waits for a `coms_send`. Spawning it delivers no work. One
5
+ // session spawned `repair-builder` and `final-test-worker`, sent all twelve of
6
+ // its messages to a third peer, and left two empty panes named like workers.
7
+ // The spawns were a sound reaction to a broken session; nothing told the
8
+ // dispatcher when the peers became addressable, and nothing noticed they never
9
+ // were addressed.
10
+ //
11
+ // Two answers: the spawn returns a readiness verdict instead of a bare pane id,
12
+ // and an unaddressed hub-spawned peer is named at the end of the session.
13
+
14
+ /** Longest we wait for a spawned peer to register in the coms pool. */
15
+ export const PEER_READY_TIMEOUT_MS = 45_000;
16
+
17
+ /** Poll backoff while waiting for registration, in ms; the last step repeats. */
18
+ export const PEER_READY_BACKOFF_MS = [250, 500, 1_000, 2_000, 3_000];
19
+
20
+ /** Backoff delay for the nth readiness poll (0-based); the last step repeats. */
21
+ export function peerReadyDelayMs(attempt) {
22
+ const i = Math.max(0, Math.min(Math.floor(attempt) || 0, PEER_READY_BACKOFF_MS.length - 1));
23
+ return PEER_READY_BACKOFF_MS[i];
24
+ }
25
+
26
+ /**
27
+ * The verdict a spawn reports back. `ready` means the peer is in the pool and
28
+ * `coms_send` will reach it; otherwise it is still booting and the caller is
29
+ * told how long we waited rather than being left to guess.
30
+ */
31
+ export function peerReadyVerdict({ name, paneId, found, waitedMs, timeoutMs = PEER_READY_TIMEOUT_MS }) {
32
+ if (found) {
33
+ return {
34
+ peer_ready: true,
35
+ peer_name: name,
36
+ pane_id: paneId,
37
+ waited_ms: waitedMs,
38
+ message:
39
+ `Peer "${name}" is ready in pane ${paneId} after ${Math.round(waitedMs / 1000)}s — ` +
40
+ `address it with coms_send(target: "${name}", ...). It boots idle and does no work until you send.`,
41
+ };
42
+ }
43
+ return {
44
+ peer_ready: false,
45
+ peer_name: name,
46
+ pane_id: paneId,
47
+ waited_ms: waitedMs,
48
+ message:
49
+ `Peer "${name}" is still booting in pane ${paneId} — it did not register in the coms pool within ` +
50
+ `${Math.round(timeoutMs / 1000)}s. Check coms_list before sending; if it never appears, read the pane ` +
51
+ "to see why it failed to start, and close it if it is dead.",
52
+ };
53
+ }
54
+
55
+ /**
56
+ * Sweep report for peers this hub spawned. `entries` carry
57
+ * { name, paneId, addressed } — `addressed` is true once any coms_send targeted
58
+ * that peer. Returns null when every spawned peer got work (the common case).
59
+ */
60
+ export function unaddressedPeerSweep(entries) {
61
+ const idle = (Array.isArray(entries) ? entries : []).filter((e) => e && !e.addressed);
62
+ if (idle.length === 0) return null;
63
+ const rows = idle.map((e) => ` ${e.name} (pane ${e.paneId ?? "?"}) — spawned, never sent to`);
64
+ return {
65
+ count: idle.length,
66
+ peers: idle.map((e) => ({ name: e.name, pane_id: e.paneId ?? null })),
67
+ message: [
68
+ `⚠ ${idle.length} hub-spawned peer(s) never received a message:`,
69
+ ...rows,
70
+ "A spawned peer boots idle and waits — it is holding a pane and a model session for nothing.",
71
+ `Close them with herdr_close_pane (asks for your confirmation) or send them work.`,
72
+ ].join("\n"),
73
+ };
74
+ }
@@ -30,8 +30,9 @@ tools, and pool-scope boundary are identical in both**:
30
30
 
31
31
  - **herdr** — active automatically when the session runs inside a [herdr](https://herdr.dev)
32
32
  pane (`HERDR_ENV=1`) and the server answers ping. Presence goes push: this peer reports
33
- itself via `pane.report_agent` + `pane.report_metadata` (`custom_status` =
34
- `<name> <pct>% q<depth>`, capped at 32 chars by herdr), and the pool widget populates
33
+ itself via `pane.report_agent` + `pane.report_metadata` (`tokens` = `coms`/`proj`/
34
+ `ctx`/`q` on herdr >= 0.7.4, one latched fallback to the legacy 32-char
35
+ `custom_status` = `<name> <pct>% q<depth>`), and the pool widget populates
35
36
  from `agent.list` + `events.subscribe` — **no periodic ping traffic**; peer state
36
37
  changes arrive within ~1s and dead panes disappear on `pane.exited`. Turn state
37
38
  (idle/working) in the herdr sidebar comes from herdr's own pi integration when
@@ -40,13 +41,13 @@ tools, and pool-scope boundary are identical in both**:
40
41
  byte-for-byte today's behavior.
41
42
 
42
43
  The file registry keeps being written in BOTH backends (it carries the full agent card
43
- that herdr's 32-char `custom_status` cannot, and keeps this peer discoverable to peers
44
+ that a pane annotation cannot, and keeps this peer discoverable to peers
44
45
  running outside herdr panes). Peers outside herdr panes appear as dimmed "pending" rows
45
46
  when you are on the herdr backend.
46
47
 
47
48
  ## Commands & tools
48
49
 
49
- - `/coms` — open the coms control surface; `--project <name>` retargets the pool (use `*` for
50
+ - `/af-coms` — open the coms control surface; `--project <name>` retargets the pool (use `*` for
50
51
  every project) and `--all` toggles private (`--explicit`) peers into view
51
52
  - `coms_list` / `coms_send` / `coms_get` / `coms_await` tools — discover peers and
52
53
  exchange messages
@@ -67,7 +68,7 @@ Standalone `coms-cli` queues are project-scoped under `~/.pi/coms/cli/projects/<
67
68
  The pool widget defines who you can reach: `coms_list` and `coms_send` resolve targets through one
68
69
  `peersInScope()` helper, so a peer is reachable only if it is in the pool. By default the
69
70
  pool is your own project and excludes `--explicit` peers. **Widening is a human-only action** — the
70
- `coms_list` tool cannot widen scope; only `/coms --project` / `/coms --all` can. This prevents an
71
+ `coms_list` tool cannot widen scope; only `/af-coms --project` / `/af-coms --all` can. This prevents an
71
72
  agent from messaging a cross-project peer that the widget never showed.
72
73
 
73
74
  ## Requires
@@ -7,7 +7,7 @@
7
7
  *
8
8
  * Phase A (foundation): identity resolution, registry I/O, transport bind/send,
9
9
  * connection handlers. Phase B: tools (coms_list/send/get/await), agent_end
10
- * response capture. Phase C: live pool widget, ping + keepalive cycles, /coms
10
+ * response capture. Phase C: live pool widget, ping + keepalive cycles, /af-coms
11
11
  * slash command, clean shutdown lifecycle.
12
12
  *
13
13
  * Usage: pi -e extensions/coms.ts
@@ -25,13 +25,13 @@ import * as os from "node:os";
25
25
  import * as crypto from "node:crypto";
26
26
  import { registerVersionStatus } from "./version.ts";
27
27
 
28
+ import { buildLiveRegistryEntry, type ComsRegistryEntry } from "../lib/coms-registry-entry.ts";
28
29
  import {
29
- formatPeerStatus,
30
30
  HerdrAgentWatch,
31
31
  HerdrPresence,
32
32
  herdrPaneId,
33
33
  herdrPresenceAvailable,
34
- parsePeerName,
34
+ peerNameFrom,
35
35
  type HerdrAgentInfo,
36
36
  } from "../lib/herdr-presence.ts";
37
37
 
@@ -69,6 +69,8 @@ interface PromptEnvelope extends Envelope {
69
69
  sender_cwd: string;
70
70
  conversation_id?: string | null;
71
71
  response_schema?: object | null;
72
+ /** How long the sender will wait; receivers driving an interactive agent use it. */
73
+ reply_timeout_ms?: number | null;
72
74
  }
73
75
 
74
76
  interface ResponseEnvelope extends Envelope {
@@ -81,6 +83,9 @@ interface PingEnvelope extends Envelope {
81
83
  type: "ping";
82
84
  }
83
85
 
86
+ /** Addressability of a peer right now — see scripts/lib/coms-envelope.ts. */
87
+ type PeerStatus = "idle" | "working" | "booting";
88
+
84
89
  interface AgentCard {
85
90
  name: string;
86
91
  purpose: string;
@@ -88,6 +93,10 @@ interface AgentCard {
88
93
  color: string;
89
94
  context_used_pct: number;
90
95
  queue_depth: number;
96
+ /** herdr pane hosting this peer, when it runs in one. */
97
+ pane_id?: string | null;
98
+ /** idle | working | booting. Absent from peers older than this field. */
99
+ status?: PeerStatus;
91
100
  }
92
101
 
93
102
  interface Pong {
@@ -96,24 +105,10 @@ interface Pong {
96
105
  agent_card: AgentCard;
97
106
  }
98
107
 
99
- interface RegistryEntry {
100
- session_id: string;
101
- name: string;
102
- purpose: string;
103
- model: string;
104
- color: string;
105
- pid: number;
106
- endpoint: string;
107
- cwd: string;
108
- started_at: string;
109
- explicit: boolean;
110
- version: number;
111
- // Live status snapshot — refreshed every KEEPALIVE_INTERVAL_MS by the heartbeat.
112
- // Optional so older entries (pre-heartbeat-refresh) still parse cleanly.
113
- context_used_pct?: number;
114
- queue_depth?: number;
115
- heartbeat_at?: string;
116
- }
108
+ // The registry shape and the heartbeat builder are shared with agent-hub —
109
+ // see ../lib/coms-registry-entry.ts. Both harnesses used to keep their own
110
+ // copy of this literal, and both refreshed `started_at` every 30 seconds.
111
+ type RegistryEntry = ComsRegistryEntry;
117
112
 
118
113
  interface PendingReply {
119
114
  resolve: (value: any) => void;
@@ -580,6 +575,8 @@ export default function (pi: ExtensionAPI) {
580
575
  model: string;
581
576
  endpoint: string;
582
577
  registryFile: string;
578
+ // Set once, at registration. The heartbeat reads it; nothing rewrites it.
579
+ started_at: string;
583
580
  } | null = null;
584
581
  const peerCards: Map<string, AgentCard & { staleCount: number }> = new Map();
585
582
  const pendingReplies: Map<string, PendingReply> = new Map();
@@ -711,6 +708,10 @@ export default function (pi: ExtensionAPI) {
711
708
  color: ident?.color ?? "#36F9F6",
712
709
  context_used_pct: pct,
713
710
  queue_depth: inboundQueue.size,
711
+ pane_id: herdrPaneId() ?? null,
712
+ // A queued inbound prompt counts as busy even between turns: the peer
713
+ // owes someone an answer before it can take another.
714
+ status: (turnState === "working" || inboundQueue.size > 0 ? "working" : "idle") as PeerStatus,
714
715
  };
715
716
  const pong: Pong = { type: "pong", msg_id: env.msg_id, agent_card: card };
716
717
  try {
@@ -846,6 +847,7 @@ export default function (pi: ExtensionAPI) {
846
847
  }
847
848
 
848
849
  // 4. Build + write registry entry atomically.
850
+ const started_at = nowIso();
849
851
  const entry: RegistryEntry = {
850
852
  session_id,
851
853
  name,
@@ -855,7 +857,7 @@ export default function (pi: ExtensionAPI) {
855
857
  pid: process.pid,
856
858
  endpoint,
857
859
  cwd,
858
- started_at: nowIso(),
860
+ started_at,
859
861
  explicit,
860
862
  version: 1,
861
863
  };
@@ -879,6 +881,7 @@ export default function (pi: ExtensionAPI) {
879
881
  model,
880
882
  endpoint,
881
883
  registryFile,
884
+ started_at,
882
885
  };
883
886
  includeExplicit = false;
884
887
  displayProject = project;
@@ -905,14 +908,25 @@ export default function (pi: ExtensionAPI) {
905
908
  // 7. Presence backend: herdr (push events, no polling) when this
906
909
  // session runs inside a herdr pane with a live server; the files ping
907
910
  // loop otherwise. The registry keepalive below runs in BOTH backends —
908
- // it carries the full agent card (context %, queue depth) that herdr's
909
- // 32-char custom_status cannot, and keeps us discoverable to peers
911
+ // it carries the full agent card (purpose, model, colour) that a pane
912
+ // annotation is no place for, and keeps us discoverable to peers
910
913
  // running outside herdr panes.
911
914
  const useHerdr = await herdrPresenceAvailable();
912
915
  if (useHerdr) {
913
916
  const paneId = herdrPaneId()!;
914
- herdrPresence = new HerdrPresence({ paneId, source: `coms:${session_id}` });
915
- void herdrPresence.report("idle", formatPeerStatus(name, 0, 0));
917
+ herdrPresence = new HerdrPresence({
918
+ paneId,
919
+ source: `coms:${session_id}`,
920
+ // A herdr that rejects our annotation dialect used to be
921
+ // invisible: presence swallows errors, so the sidebar simply
922
+ // stayed blank and every watcher saw "detached" forever.
923
+ onError: (err, dialect) => {
924
+ try {
925
+ pi.appendEntry("coms-log", { event: "presence_dialect_rejected", dialect, reason: err?.message ?? String(err) });
926
+ } catch { /* best-effort */ }
927
+ },
928
+ });
929
+ void herdrPresence.report("idle", { name, project, contextUsedPct: 0, queueDepth: 0 });
916
930
  herdrWatch = new HerdrAgentWatch({
917
931
  ownPaneId: paneId,
918
932
  onChange: (agents) => herdrSyncPeerCards(agents),
@@ -932,22 +946,13 @@ export default function (pi: ExtensionAPI) {
932
946
  // Detect missing-registry BEFORE writing so the self_heal audit only
933
947
  // fires when something actually went wrong (file unlinked under us).
934
948
  const missingBeforeWrite = !fs.existsSync(identity.registryFile);
935
- const live: RegistryEntry = {
936
- session_id: identity.session_id,
937
- name: identity.name,
938
- purpose: identity.purpose,
939
- model: ctx?.model?.id ?? identity.model,
940
- color: identity.color,
949
+ const live: RegistryEntry = buildLiveRegistryEntry(identity, {
950
+ now: nowIso(),
941
951
  pid: process.pid,
942
- endpoint: identity.endpoint,
943
- cwd: identity.cwd,
944
- started_at: nowIso(),
945
- explicit: identity.explicit,
946
- version: 1,
947
- context_used_pct: Math.round(ctx?.getContextUsage()?.percent ?? 0),
948
- queue_depth: inboundQueue.size,
949
- heartbeat_at: nowIso(),
950
- };
952
+ model: ctx?.model?.id,
953
+ contextUsedPct: ctx?.getContextUsage()?.percent,
954
+ queueDepth: inboundQueue.size,
955
+ });
951
956
  // Unconditional atomic write: handles BOTH the live-status refresh
952
957
  // (file present → overwrite with fresh values) AND self-heal (file
953
958
  // missing → re-create entry). The atomic write also bumps mtime, so
@@ -967,7 +972,7 @@ export default function (pi: ExtensionAPI) {
967
972
  // registry heartbeats just written by the other peers.
968
973
  if (herdrPresence && identity) {
969
974
  const pct = Math.round(currentCtx?.getContextUsage()?.percent ?? 0);
970
- void herdrPresence.report(turnState, formatPeerStatus(identity.name, pct, inboundQueue.size));
975
+ void herdrPresence.report(turnState, { name: identity.name, project: identity.project, contextUsedPct: pct, queueDepth: inboundQueue.size });
971
976
  }
972
977
  if (herdrWatch) herdrSyncPeerCards(herdrWatch.current());
973
978
  }, KEEPALIVE_INTERVAL_MS);
@@ -985,7 +990,7 @@ export default function (pi: ExtensionAPI) {
985
990
  turnState = "working";
986
991
  if (herdrPresence && identity) {
987
992
  const pct = Math.round(currentCtx?.getContextUsage()?.percent ?? 0);
988
- void herdrPresence.report("working", formatPeerStatus(identity.name, pct, inboundQueue.size));
993
+ void herdrPresence.report("working", { name: identity.name, project: identity.project, contextUsedPct: pct, queueDepth: inboundQueue.size });
989
994
  }
990
995
  });
991
996
 
@@ -993,13 +998,13 @@ export default function (pi: ExtensionAPI) {
993
998
  turnState = "idle";
994
999
  if (herdrPresence && identity) {
995
1000
  const pct = Math.round(currentCtx?.getContextUsage()?.percent ?? 0);
996
- void herdrPresence.report("idle", formatPeerStatus(identity.name, pct, inboundQueue.size));
1001
+ void herdrPresence.report("idle", { name: identity.name, project: identity.project, contextUsedPct: pct, queueDepth: inboundQueue.size });
997
1002
  }
998
1003
  });
999
1004
 
1000
1005
  // Join herdr's live pane states back to the coms registry: a herdr agent
1001
- // whose custom_status leads with a peer name maps to that peer's registry
1002
- // entry (which carries the full card the 32-char custom_status cannot).
1006
+ // that advertises a coms peer name maps to that peer's registry entry
1007
+ // (which carries the full card a pane annotation has no room for).
1003
1008
  // Pool-scope semantics are preserved — only entries from peersInScope()
1004
1009
  // become cards; peers outside herdr panes stay visible as registry-only
1005
1010
  // "pending" rows exactly like an unpinged peer in the files backend.
@@ -1007,7 +1012,7 @@ export default function (pi: ExtensionAPI) {
1007
1012
  if (!identity) return;
1008
1013
  const liveNames = new Set<string>();
1009
1014
  for (const a of agents) {
1010
- const peerName = parsePeerName(a.custom_status as string | undefined);
1015
+ const peerName = peerNameFrom(a);
1011
1016
  if (peerName) liveNames.add(peerName);
1012
1017
  }
1013
1018
  let changed = false;
@@ -1279,7 +1284,7 @@ export default function (pi: ExtensionAPI) {
1279
1284
  // Scoped to the connected pool only (peersInScope): you can reach exactly the
1280
1285
  // peers the widget shows. Match by name first (preferred, human-facing), then by
1281
1286
  // session_id. A peer outside the current scope is intentionally NOT resolved — the
1282
- // human must widen scope via /coms --project / --all first. This closes the old
1287
+ // human must widen scope via /af-coms --project / --all first. This closes the old
1283
1288
  // cross-project leak where a name match fell through to scanning every project.
1284
1289
  const scope = peersInScope();
1285
1290
  const byName = scope.find((e) => e.name === target);
@@ -1294,11 +1299,14 @@ export default function (pi: ExtensionAPI) {
1294
1299
  label: "Coms List",
1295
1300
  description:
1296
1301
  "List the peer agents in your current coms pool — the ones shown in the pool widget. Returns " +
1297
- "names, models, and live context-window usage. Discovery is scoped to what the human displays " +
1298
- "via /coms; you CANNOT widen it to other projects or reveal --explicit peers yourself.",
1302
+ "names, models, live context-window usage, the herdr pane_id, and status (idle | working | " +
1303
+ "booting). CHECK STATUS BEFORE SENDING: `working` means the peer is mid-turn and your send " +
1304
+ "will wait for it; `booting` means it registered but is not addressable yet. Use this instead " +
1305
+ "of reading the peer's pane to guess whether it is busy. Discovery is scoped to what the human " +
1306
+ "displays via /af-coms; you CANNOT widen it to other projects or reveal --explicit peers yourself.",
1299
1307
  parameters: Type.Object({
1300
- project: Type.Optional(Type.String({ description: "Narrow to a project WITHIN the current pool scope. Cannot widen beyond what /coms displays — a widening request is ignored." })),
1301
- include_explicit: Type.Optional(Type.Boolean({ description: "Only narrows: pass false to hide explicit peers. Cannot reveal them unless the human ran /coms --all." })),
1308
+ project: Type.Optional(Type.String({ description: "Narrow to a project WITHIN the current pool scope. Cannot widen beyond what /af-coms displays — a widening request is ignored." })),
1309
+ include_explicit: Type.Optional(Type.Boolean({ description: "Only narrows: pass false to hide explicit peers. Cannot reveal them unless the human ran /af-coms --all." })),
1302
1310
  }),
1303
1311
  async execute(_callId, params) {
1304
1312
  if (!identity) {
@@ -1308,9 +1316,9 @@ export default function (pi: ExtensionAPI) {
1308
1316
  };
1309
1317
  }
1310
1318
  // Clamp discovery to the human-set pool scope (displayProject + includeExplicit,
1311
- // driven by /coms). The LLM's project/include_explicit may NARROW within that
1319
+ // driven by /af-coms). The LLM's project/include_explicit may NARROW within that
1312
1320
  // scope but can never widen it — cross-project or explicit discovery requires a
1313
- // deliberate /coms --project / --all from the human. So coms_list returns exactly
1321
+ // deliberate /af-coms --project / --all from the human. So coms_list returns exactly
1314
1322
  // the pool, the same boundary coms_send enforces.
1315
1323
  const scopeProject = displayProject ?? identity.project;
1316
1324
  let projects: string[];
@@ -1322,7 +1330,7 @@ export default function (pi: ExtensionAPI) {
1322
1330
  if (params.project && params.project !== scopeProject) widened = true;
1323
1331
  }
1324
1332
  // include_explicit may only narrow (turn OFF); it cannot reveal explicit peers
1325
- // unless the human already did via /coms --all.
1333
+ // unless the human already did via /af-coms --all.
1326
1334
  const includeExp = includeExplicit && params.include_explicit !== false;
1327
1335
  if (params.include_explicit === true && !includeExplicit) widened = true;
1328
1336
 
@@ -1350,6 +1358,12 @@ export default function (pi: ExtensionAPI) {
1350
1358
  project: c.project,
1351
1359
  alive: pong != null,
1352
1360
  context_used_pct: pong ? pong.context_used_pct : null,
1361
+ // Check these BEFORE sending: a `working` peer will make the send
1362
+ // wait, and a `booting` one is not addressable yet. Reading the
1363
+ // pane to find this out is the thing they replace.
1364
+ pane_id: pong?.pane_id ?? null,
1365
+ status: pong?.status ?? null,
1366
+ queue_depth: pong ? pong.queue_depth : null,
1353
1367
  color: c.entry.color,
1354
1368
  };
1355
1369
  });
@@ -1357,7 +1371,7 @@ export default function (pi: ExtensionAPI) {
1357
1371
  const notice = widened
1358
1372
  ? `\n\n(Discovery is scoped to "${scopeProject}"${includeExplicit ? "" : ", explicit peers hidden"}. ` +
1359
1373
  `Widening to other projects or revealing --explicit peers is a human action via ` +
1360
- `/coms --project <name> or /coms --all.)`
1374
+ `/af-coms --project <name> or /af-coms --all.)`
1361
1375
  : "";
1362
1376
 
1363
1377
  const lines = agents.length === 0
@@ -1365,7 +1379,8 @@ export default function (pi: ExtensionAPI) {
1365
1379
  : agents.map((a) => {
1366
1380
  const ctxStr = a.context_used_pct != null ? ` ${a.context_used_pct}%` : " ?%";
1367
1381
  const live = a.alive ? "●" : "✗";
1368
- return `${live} ${a.name} (${a.model})${ctxStr}${a.purpose ? ` — ${a.purpose}` : ""}`;
1382
+ const state = ` [${a.alive ? (a.status ?? "unknown") : "unreachable"}${a.pane_id ? ` pane ${a.pane_id}` : ""}]`;
1383
+ return `${live} ${a.name} (${a.model})${ctxStr}${state}${a.purpose ? ` — ${a.purpose}` : ""}`;
1369
1384
  }).join("\n");
1370
1385
 
1371
1386
  return {
@@ -1391,7 +1406,10 @@ export default function (pi: ExtensionAPI) {
1391
1406
  const rows = agents.map((a) => {
1392
1407
  const dot = a.alive ? theme.fg("success", "●") : theme.fg("error", "✗");
1393
1408
  const pct = a.context_used_pct != null ? `${a.context_used_pct}%` : "?%";
1394
- return `${dot} ${theme.fg("accent", a.name)} ${theme.fg("dim", a.model)} ${theme.fg("warning", pct)}`;
1409
+ const state = a.alive ? (a.status ?? "unknown") : "unreachable";
1410
+ const stateFg = state === "idle" ? "success" : state === "working" ? "warning" : "dim";
1411
+ return `${dot} ${theme.fg("accent", a.name)} ${theme.fg("dim", a.model)} ${theme.fg("warning", pct)} ` +
1412
+ `${theme.fg(stateFg as any, state)}${a.pane_id ? theme.fg("dim", ` ${a.pane_id}`) : ""}`;
1395
1413
  }).join("\n");
1396
1414
  return new Text(header + "\n" + rows, 0, 0);
1397
1415
  },
@@ -1405,10 +1423,11 @@ export default function (pi: ExtensionAPI) {
1405
1423
  "Use coms_get (non-blocking) or coms_await (blocking) with the msg_id to retrieve the response. " +
1406
1424
  "Throws if the receiver is unreachable or rejects the envelope.",
1407
1425
  parameters: Type.Object({
1408
- target: Type.String({ description: "Peer name (preferred) or session_id — must be a peer currently in your coms pool (shown in the widget). Out-of-pool targets are refused; ask the human to widen scope with /coms --project or /coms --all." }),
1426
+ target: Type.String({ description: "Peer name (preferred) or session_id — must be a peer currently in your coms pool (shown in the widget). Out-of-pool targets are refused; ask the human to widen scope with /af-coms --project or /af-coms --all." }),
1409
1427
  prompt: Type.String({ description: "The prompt to send." }),
1410
1428
  conversation_id: Type.Optional(Type.String()),
1411
1429
  response_schema: Type.Optional(Type.Any({ description: "Optional JSON Schema describing the expected response shape." })),
1430
+ reply_timeout_ms: Type.Optional(Type.Number({ description: "How long you will wait for the reply (ms). Pass the same value you intend to give coms_await: a receiver that drives an interactive agent (e.g. a Claude Code pane) uses this instead of its own default, so long reviews are not cut short. Clamped to 1 hour." })),
1412
1431
  }),
1413
1432
  async execute(_callId, params) {
1414
1433
  if (!identity) {
@@ -1423,7 +1442,7 @@ export default function (pi: ExtensionAPI) {
1423
1442
  throw new Error(
1424
1443
  `coms: no connected peer "${params.target}" in your pool (project ${scope}). ` +
1425
1444
  `Only peers shown in the coms pool are reachable. If you expected this peer, ask the ` +
1426
- `human to widen scope with /coms --project <name> or /coms --all, then retry.`,
1445
+ `human to widen scope with /af-coms --project <name> or /af-coms --all, then retry.`,
1427
1446
  );
1428
1447
  }
1429
1448
  const hops = currentInbound ? currentInbound.hops + 1 : 0;
@@ -1443,6 +1462,7 @@ export default function (pi: ExtensionAPI) {
1443
1462
  prompt: params.prompt,
1444
1463
  conversation_id: params.conversation_id ?? null,
1445
1464
  response_schema: (params.response_schema as object | undefined) ?? null,
1465
+ reply_timeout_ms: params.reply_timeout_ms ?? null,
1446
1466
  };
1447
1467
 
1448
1468
  // Send the envelope synchronously and wait for the receiver's ack.
@@ -1464,13 +1484,8 @@ export default function (pi: ExtensionAPI) {
1464
1484
  target_name: target.name,
1465
1485
  created_at: nowIso(),
1466
1486
  };
1467
- entry.timer = setTimeout(() => {
1468
- if (entry.result) return;
1469
- entry.result = { error: "timeout" };
1470
- try { entry.resolve(entry.result); } catch { /* ignore */ }
1471
- }, TIMEOUT_MS);
1472
- // Don't keep the event loop alive solely for this timer.
1473
- try { (entry.timer as any).unref?.(); } catch { /* ignore */ }
1487
+ // A local wait deadline does not convert unfinished remote work into an
1488
+ // error. Keep the entry pending so a later await can collect the response.
1474
1489
  pendingReplies.set(msg_id, entry);
1475
1490
 
1476
1491
  try {
@@ -1590,10 +1605,16 @@ export default function (pi: ExtensionAPI) {
1590
1605
  });
1591
1606
 
1592
1607
  const winner = await Promise.race([entry.promise, timed]);
1608
+ if ((winner as any).error === "timeout") {
1609
+ return {
1610
+ content: [{ type: "text" as const, text: "coms_await: pending — wait budget exhausted; the peer may still complete" }],
1611
+ details: { status: "pending" },
1612
+ };
1613
+ }
1593
1614
  if ((winner as any).error) {
1594
1615
  return {
1595
1616
  content: [{ type: "text" as const, text: `coms_await: error — ${(winner as any).error}` }],
1596
- details: { error: (winner as any).error },
1617
+ details: { status: "error", error: (winner as any).error },
1597
1618
  };
1598
1619
  }
1599
1620
  const resp = (winner as any).response;
@@ -1612,6 +1633,7 @@ export default function (pi: ExtensionAPI) {
1612
1633
  renderResult(result, _options, theme) {
1613
1634
  const d = result.details as any;
1614
1635
  if (d?.error) return new Text(theme.fg("error", `✗ ${d.error}`), 0, 0);
1636
+ if (d?.status === "pending") return new Text(theme.fg("warning", "⏳ pending"), 0, 0);
1615
1637
  return new Text(theme.fg("success", "✓ response received"), 0, 0);
1616
1638
  },
1617
1639
  });
@@ -1690,8 +1712,8 @@ export default function (pi: ExtensionAPI) {
1690
1712
  }
1691
1713
  });
1692
1714
 
1693
- // ━━ /coms slash command ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1694
- pi.registerCommand("coms", {
1715
+ // ━━ /af-coms slash command ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1716
+ pi.registerCommand("af-coms", {
1695
1717
  description: "Force-refresh the coms pool widget (or filter with --all / --project <name>)",
1696
1718
  handler: async (args, ctx) => {
1697
1719
  const trimmed = (args ?? "").trim();
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.5"
6
+ "version": "0.0.7"
7
7
  }
@@ -37,10 +37,10 @@ They apply to the **path categories only** — `zeroAccessPaths`, `readOnlyPaths
37
37
  **Pre-authorize** (when you know the agent will need it):
38
38
 
39
39
  ```
40
- /allow .env # exempt for the rest of the session (default)
41
- /allow .env turn # exempt until the end of the current/next turn
42
- /allowed # list active exemptions
43
- /revoke .env # remove an exemption
40
+ /af-allow .env # exempt for the rest of the session (default)
41
+ /af-allow .env turn # exempt until the end of the current/next turn
42
+ /af-allowed # list active exemptions
43
+ /af-revoke .env # remove an exemption
44
44
  ```
45
45
 
46
46
  **Block-time dialog** (when you forgot): in an interactive session a path block
@@ -60,7 +60,7 @@ timeout. At most 3 escalations per child run; denials are cached.
60
60
 
61
61
  **Shared exemptions file**: agent-hub keeps one session-scoped file
62
62
  (`~/.pi/coms/exemptions/<session>.json`, deleted on shutdown) and passes it to
63
- every spawned child via `AGENT_HUB_EXEMPTIONS_FILE`. `/allow <pattern> session`
63
+ every spawned child via `AGENT_HUB_EXEMPTIONS_FILE`. `/af-allow <pattern> session`
64
64
  in the hub lands there, so it covers the whole team. Every native specialist,
65
65
  research helper, and nested delegate uses this harness and re-reads the file on
66
66
  every block, so mid-session grants reach already-running children. Everything
@@ -76,9 +76,9 @@ refuses guarded child dispatch rather than launching an unprotected process.
76
76
 
77
77
  ## Commands & tools
78
78
 
79
- - `/allow <pattern> [turn|session]` — exempt a protected path pattern
80
- - `/allowed` — list active exemptions
81
- - `/revoke <pattern>` — remove an exemption
79
+ - `/af-allow <pattern> [turn|session]` — exempt a protected path pattern
80
+ - `/af-allowed` — list active exemptions
81
+ - `/af-revoke <pattern>` — remove an exemption
82
82
 
83
83
  Blocking itself runs passively on the `tool_call` event.
84
84
 
@@ -111,7 +111,7 @@ pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/agent-hub/
111
111
  call were stripped (this repo does not ship pi themes).
112
112
  - The `find` tool's `pattern` is matched against `zeroAccessPaths`, closing a gap
113
113
  where `find` could still locate secret files.
114
- - Exemption layer added (not in upstream): `/allow`/`/allowed`/`/revoke`,
114
+ - Exemption layer added (not in upstream): `/af-allow`/`/af-allowed`/`/af-revoke`,
115
115
  block-time approval dialog, and escalation from headless agent-hub children to
116
116
  the dispatcher — see the Exemptions section above. Shared plumbing lives in
117
117
  [`../lib/damage-control-shared.ts`](../lib/damage-control-shared.ts).
@@ -12,8 +12,8 @@
12
12
  * On top of the rule engine this variant supports runtime EXEMPTIONS for the
13
13
  * path categories (zeroAccessPaths / readOnlyPaths / noDeletePaths) — never
14
14
  * for the destructive bashToolPatterns:
15
- * - /allow <pattern> [turn|session] pre-authorizes a protected pattern
16
- * (/allowed lists, /revoke removes). Session grants are mirrored into the
15
+ * - /af-allow <pattern> [turn|session] pre-authorizes a protected pattern
16
+ * (/af-allowed lists, /af-revoke removes). Session grants are mirrored into the
17
17
  * shared exemptions file when agent-hub provides one, so spawned children
18
18
  * inherit them.
19
19
  * - In interactive sessions a path block opens a dialog (keep blocked /
@@ -191,8 +191,8 @@ export default function (pi: ExtensionAPI) {
191
191
  : `🛡️ Damage-Control (continue): ${total} Rules`;
192
192
  }
193
193
 
194
- pi.registerCommand("allow", {
195
- description: "Damage-control: exempt a protected path pattern — /allow <pattern> [turn|session]",
194
+ pi.registerCommand("af-allow", {
195
+ description: "Damage-control: exempt a protected path pattern — /af-allow <pattern> [turn|session]",
196
196
  handler: async (args, ctx) => {
197
197
  const parts = args.trim().split(/\s+/).filter(Boolean);
198
198
  let scope: ExemptionScope = "session";
@@ -203,7 +203,7 @@ export default function (pi: ExtensionAPI) {
203
203
  }
204
204
  const pattern = parts.join(" ");
205
205
  if (!pattern) {
206
- ctx.ui.notify("Usage: /allow <pattern> [turn|session] — e.g. /allow .env turn", "warning");
206
+ ctx.ui.notify("Usage: /af-allow <pattern> [turn|session] — e.g. /af-allow .env turn", "warning");
207
207
  return;
208
208
  }
209
209
  const already = activeExemptions().some((e) => e.pattern === pattern && (e.scope === scope || e.scope === "session"));
@@ -217,7 +217,7 @@ export default function (pi: ExtensionAPI) {
217
217
  },
218
218
  });
219
219
 
220
- pi.registerCommand("allowed", {
220
+ pi.registerCommand("af-allowed", {
221
221
  description: "Damage-control: list active exemptions",
222
222
  handler: async (_args, ctx) => {
223
223
  const lines: string[] = [];
@@ -230,12 +230,12 @@ export default function (pi: ExtensionAPI) {
230
230
  },
231
231
  });
232
232
 
233
- pi.registerCommand("revoke", {
234
- description: "Damage-control: revoke an exemption — /revoke <pattern>",
233
+ pi.registerCommand("af-revoke", {
234
+ description: "Damage-control: revoke an exemption — /af-revoke <pattern>",
235
235
  handler: async (args, ctx) => {
236
236
  const pattern = args.trim();
237
237
  if (!pattern) {
238
- ctx.ui.notify("Usage: /revoke <pattern>", "warning");
238
+ ctx.ui.notify("Usage: /af-revoke <pattern>", "warning");
239
239
  return;
240
240
  }
241
241
  let removed = false;
@@ -458,7 +458,7 @@ export default function (pi: ExtensionAPI) {
458
458
  }
459
459
  const note = choice === KEEP
460
460
  ? `The user reviewed this call and kept the block in place.`
461
- : `The user did not answer the approval dialog in time (auto-kept blocked). They can pre-authorize with /allow ${matchedPattern} [turn|session].`;
461
+ : `The user did not answer the approval dialog in time (auto-kept blocked). They can pre-authorize with /af-allow ${matchedPattern} [turn|session].`;
462
462
  if (choice === KEEP) deniedThisTurn.add(matchedPattern);
463
463
  ctx.ui.setStatus("damage-control", `⚠️ Last Violation: ${violationReason.slice(0, 30)}...`);
464
464
  pi.appendEntry("damage-control-log", { tool: event.toolName, input: event.input, rule: violationReason, action: choice === KEEP ? "blocked_by_user" : "blocked_prompt_timeout" });
@@ -525,7 +525,7 @@ export default function (pi: ExtensionAPI) {
525
525
  }
526
526
  } else {
527
527
  const note = matchedPattern
528
- ? `The user can pre-authorize this path with /allow ${matchedPattern} [turn|session] in a damage-control-continue session.`
528
+ ? `The user can pre-authorize this path with /af-allow ${matchedPattern} [turn|session] in a damage-control-continue session.`
529
529
  : undefined;
530
530
  ctx.ui.notify(`🛑 Damage-Control: Blocked ${event.toolName} (${violationReason}) — agent will adapt and continue.`);
531
531
  ctx.ui.setStatus("damage-control", `⚠️ Last Violation: ${violationReason.slice(0, 30)}...`);
@@ -3,5 +3,5 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "main": "index.ts",
6
- "version": "0.0.5"
6
+ "version": "0.0.7"
7
7
  }