@chankov/agent-fleet 2.0.13 → 2.0.14

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 (530) hide show
  1. package/.pi/harnesses/agent-hub/README.md +9 -0
  2. package/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
  3. package/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +75 -0
  4. package/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  5. package/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +53 -0
  6. package/.pi/harnesses/agent-hub/dispatch-triage-state.ts +15 -0
  7. package/.pi/harnesses/agent-hub/index.ts +40 -6
  8. package/.pi/harnesses/agent-hub/package.json +1 -1
  9. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -0
  10. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +8 -1
  11. package/.pi/harnesses/agent-hub/system1-communication-store.ts +95 -0
  12. package/.pi/harnesses/agent-hub/system1-runtime.ts +5 -2
  13. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  14. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +9 -3
  15. package/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  16. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +29 -1
  17. package/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  18. package/.pi/harnesses/agent-hub/work-mode.ts +2 -1
  19. package/.pi/harnesses/coms/package.json +1 -1
  20. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  21. package/.pi/harnesses/lib/fleet-dashboard-view.ts +1 -1
  22. package/.pi/harnesses/lib/fleet-strip-controller.ts +2 -1
  23. package/.pi/harnesses/lib/fleet-strip-view.ts +1 -1
  24. package/.versions/2.0.14/.pi/agent-fleet/hermes/README.md +347 -0
  25. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  26. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  27. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  28. package/.versions/2.0.14/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  29. package/.versions/2.0.14/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  30. package/.versions/2.0.14/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  31. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  32. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  33. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  34. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  35. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  36. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  37. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  38. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  39. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  40. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  41. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  42. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  43. package/.versions/2.0.14/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  44. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  45. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  46. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  47. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  48. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  49. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  50. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  51. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  52. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  53. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  54. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  55. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  56. package/.versions/2.0.14/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  57. package/.versions/2.0.14/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  58. package/.versions/2.0.14/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  59. package/.versions/2.0.14/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  60. package/.versions/2.0.14/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  61. package/.versions/2.0.14/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  62. package/.versions/2.0.14/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  63. package/.versions/2.0.14/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  64. package/.versions/2.0.14/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  65. package/.versions/2.0.14/.pi/agent-fleet/scripts/fleet.ts +216 -0
  66. package/.versions/2.0.14/.pi/agent-fleet/scripts/flow.ts +157 -0
  67. package/.versions/2.0.14/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  68. package/.versions/2.0.14/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  69. package/.versions/2.0.14/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  70. package/.versions/2.0.14/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  71. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  72. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  73. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  74. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  75. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  76. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  77. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  78. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  79. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  80. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  81. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  82. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  83. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  84. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  85. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  86. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  87. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  88. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  89. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  90. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  91. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  92. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  93. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  94. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  95. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  96. package/.versions/2.0.14/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  97. package/.versions/2.0.14/.pi/agent-fleet/scripts/package-lock.json +35 -0
  98. package/.versions/2.0.14/.pi/agent-fleet/scripts/package.json +9 -0
  99. package/.versions/2.0.14/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  100. package/.versions/2.0.14/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  101. package/.versions/2.0.14/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  102. package/.versions/2.0.14/.pi/agent-fleet/scripts/team-up.ts +378 -0
  103. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  104. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  105. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  106. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  107. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  108. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  109. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  110. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  111. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  112. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  113. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  114. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  115. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  116. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  117. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +34 -0
  118. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  119. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  120. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  121. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  122. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  123. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  124. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  125. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  126. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  127. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  128. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  129. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  130. package/.versions/2.0.14/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  131. package/.versions/2.0.14/.pi/agents/dispatch-policy.yaml +32 -0
  132. package/.versions/2.0.14/.pi/agents/model-profiles.yaml +134 -0
  133. package/.versions/2.0.14/.pi/agents/peers.yaml +147 -0
  134. package/.versions/2.0.14/.pi/agents/teams.yaml +41 -0
  135. package/.versions/2.0.14/.pi/agents/voices.yaml +13 -0
  136. package/.versions/2.0.14/.pi/damage-control-rules.yaml +297 -0
  137. package/.versions/2.0.14/.pi/extensions/btw/README.md +120 -0
  138. package/.versions/2.0.14/.pi/extensions/btw/index.ts +914 -0
  139. package/.versions/2.0.14/.pi/extensions/btw/package.json +6 -0
  140. package/.versions/2.0.14/.pi/extensions/btw/state.js +179 -0
  141. package/.versions/2.0.14/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  142. package/.versions/2.0.14/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  143. package/.versions/2.0.14/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  144. package/.versions/2.0.14/.pi/extensions/compact-and-continue/README.md +42 -0
  145. package/.versions/2.0.14/.pi/extensions/compact-and-continue/index.ts +120 -0
  146. package/.versions/2.0.14/.pi/extensions/compact-and-continue/package.json +6 -0
  147. package/.versions/2.0.14/.pi/extensions/mcp-bridge/README.md +46 -0
  148. package/.versions/2.0.14/.pi/extensions/mcp-bridge/index.ts +206 -0
  149. package/.versions/2.0.14/.pi/extensions/mcp-bridge/package.json +6 -0
  150. package/.versions/2.0.14/.pi/extensions/package-lock.json +1175 -0
  151. package/.versions/2.0.14/.pi/extensions/package.json +9 -0
  152. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/README.md +224 -0
  153. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/config.ts +198 -0
  154. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  155. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/index.ts +248 -0
  156. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/package.json +6 -0
  157. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  158. package/.versions/2.0.14/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  159. package/.versions/2.0.14/.pi/harnesses/agent-hub/README.md +1369 -0
  160. package/.versions/2.0.14/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  161. package/.versions/2.0.14/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  162. package/.versions/2.0.14/.pi/harnesses/agent-hub/artifacts.js +146 -0
  163. package/.versions/2.0.14/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  164. package/.versions/2.0.14/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  165. package/.versions/2.0.14/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  166. package/.versions/2.0.14/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  167. package/.versions/2.0.14/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  168. package/.versions/2.0.14/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  169. package/.versions/2.0.14/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  170. package/.versions/2.0.14/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  171. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  172. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  173. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  174. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  175. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  176. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  177. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  178. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  179. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  180. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  181. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  182. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  183. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  184. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  185. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  186. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  187. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/context.ts +45 -0
  188. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  189. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  190. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  191. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  192. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  193. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  194. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  195. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  196. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  197. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  198. package/.versions/2.0.14/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  199. package/.versions/2.0.14/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  200. package/.versions/2.0.14/.pi/harnesses/agent-hub/config/model-profiles.ts +236 -0
  201. package/.versions/2.0.14/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  202. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  203. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  204. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  205. package/.versions/2.0.14/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  206. package/.versions/2.0.14/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  207. package/.versions/2.0.14/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  208. package/.versions/2.0.14/.pi/harnesses/agent-hub/context-window.js +108 -0
  209. package/.versions/2.0.14/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  210. package/.versions/2.0.14/.pi/harnesses/agent-hub/delegate.ts +467 -0
  211. package/.versions/2.0.14/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  212. package/.versions/2.0.14/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  213. package/.versions/2.0.14/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  214. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  215. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  216. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
  217. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +248 -0
  218. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +231 -0
  219. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native-types.ts +257 -0
  220. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  221. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  222. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +38 -0
  223. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +75 -0
  224. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  225. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +53 -0
  226. package/.versions/2.0.14/.pi/harnesses/agent-hub/dispatch-triage-state.ts +15 -0
  227. package/.versions/2.0.14/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  228. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  229. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  230. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  231. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  232. package/.versions/2.0.14/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  233. package/.versions/2.0.14/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  234. package/.versions/2.0.14/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  235. package/.versions/2.0.14/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  236. package/.versions/2.0.14/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  237. package/.versions/2.0.14/.pi/harnesses/agent-hub/fixtures/registration-surface.json +62 -0
  238. package/.versions/2.0.14/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  239. package/.versions/2.0.14/.pi/harnesses/agent-hub/footer.ts +30 -0
  240. package/.versions/2.0.14/.pi/harnesses/agent-hub/helpers.ts +270 -0
  241. package/.versions/2.0.14/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  242. package/.versions/2.0.14/.pi/harnesses/agent-hub/index.ts +2370 -0
  243. package/.versions/2.0.14/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  244. package/.versions/2.0.14/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  245. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
  246. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  247. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  248. package/.versions/2.0.14/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  249. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  250. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  251. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  252. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  253. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  254. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  255. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  256. package/.versions/2.0.14/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  257. package/.versions/2.0.14/.pi/harnesses/agent-hub/no-progress.ts +359 -0
  258. package/.versions/2.0.14/.pi/harnesses/agent-hub/package.json +7 -0
  259. package/.versions/2.0.14/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  260. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  261. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  262. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  263. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  264. package/.versions/2.0.14/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  265. package/.versions/2.0.14/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  266. package/.versions/2.0.14/.pi/harnesses/agent-hub/presentation.ts +48 -0
  267. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-config.ts +40 -0
  268. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  269. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  270. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  271. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-local.ts +88 -0
  272. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-observer.ts +105 -0
  273. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-rules.ts +143 -0
  274. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-runtime.ts +316 -0
  275. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  276. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  277. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-snapshot.ts +243 -0
  278. package/.versions/2.0.14/.pi/harnesses/agent-hub/proactive-types.ts +63 -0
  279. package/.versions/2.0.14/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  280. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/context.ts +54 -0
  281. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  282. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  283. package/.versions/2.0.14/.pi/harnesses/agent-hub/prompts/system-prompt.ts +122 -0
  284. package/.versions/2.0.14/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  285. package/.versions/2.0.14/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  286. package/.versions/2.0.14/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  287. package/.versions/2.0.14/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  288. package/.versions/2.0.14/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  289. package/.versions/2.0.14/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  290. package/.versions/2.0.14/.pi/harnesses/agent-hub/research/runtime.ts +195 -0
  291. package/.versions/2.0.14/.pi/harnesses/agent-hub/research/spawn-run.ts +174 -0
  292. package/.versions/2.0.14/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  293. package/.versions/2.0.14/.pi/harnesses/agent-hub/return-contract.js +327 -0
  294. package/.versions/2.0.14/.pi/harnesses/agent-hub/return-extract.js +77 -0
  295. package/.versions/2.0.14/.pi/harnesses/agent-hub/review-findings.js +104 -0
  296. package/.versions/2.0.14/.pi/harnesses/agent-hub/run-budget.js +542 -0
  297. package/.versions/2.0.14/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  298. package/.versions/2.0.14/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  299. package/.versions/2.0.14/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  300. package/.versions/2.0.14/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  301. package/.versions/2.0.14/.pi/harnesses/agent-hub/session-audit.ts +227 -0
  302. package/.versions/2.0.14/.pi/harnesses/agent-hub/session-health.js +110 -0
  303. package/.versions/2.0.14/.pi/harnesses/agent-hub/session-start.ts +42 -0
  304. package/.versions/2.0.14/.pi/harnesses/agent-hub/spawn.ts +526 -0
  305. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-activity.ts +510 -0
  306. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-communication-store.ts +95 -0
  307. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-report.ts +225 -0
  308. package/.versions/2.0.14/.pi/harnesses/agent-hub/system1-runtime.ts +279 -0
  309. package/.versions/2.0.14/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  310. package/.versions/2.0.14/.pi/harnesses/agent-hub/timeline.ts +72 -0
  311. package/.versions/2.0.14/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  312. package/.versions/2.0.14/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  313. package/.versions/2.0.14/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  314. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  315. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  316. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  317. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  318. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
  319. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  320. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  321. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  322. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  323. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  324. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  325. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  326. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  327. package/.versions/2.0.14/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  328. package/.versions/2.0.14/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  329. package/.versions/2.0.14/.pi/harnesses/agent-hub/types.ts +66 -0
  330. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  331. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  332. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  333. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  334. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +152 -0
  335. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  336. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/fleet-source.ts +175 -0
  337. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  338. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  339. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  340. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  341. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  342. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  343. package/.versions/2.0.14/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  344. package/.versions/2.0.14/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  345. package/.versions/2.0.14/.pi/harnesses/agent-hub/version.ts +42 -0
  346. package/.versions/2.0.14/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  347. package/.versions/2.0.14/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  348. package/.versions/2.0.14/.pi/harnesses/agent-hub/work-mode.ts +174 -0
  349. package/.versions/2.0.14/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  350. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/README.md +59 -0
  351. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/index.ts +558 -0
  352. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  353. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  354. package/.versions/2.0.14/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  355. package/.versions/2.0.14/.pi/harnesses/coms/README.md +100 -0
  356. package/.versions/2.0.14/.pi/harnesses/coms/index.ts +282 -0
  357. package/.versions/2.0.14/.pi/harnesses/coms/package.json +7 -0
  358. package/.versions/2.0.14/.pi/harnesses/coms/version.ts +42 -0
  359. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/README.md +135 -0
  360. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/index.ts +550 -0
  361. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/package.json +7 -0
  362. package/.versions/2.0.14/.pi/harnesses/damage-control-continue/version.ts +42 -0
  363. package/.versions/2.0.14/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  364. package/.versions/2.0.14/.pi/harnesses/lib/coms-core-io.ts +385 -0
  365. package/.versions/2.0.14/.pi/harnesses/lib/coms-core.ts +577 -0
  366. package/.versions/2.0.14/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  367. package/.versions/2.0.14/.pi/harnesses/lib/context-budget-child-prompt.ts +219 -0
  368. package/.versions/2.0.14/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  369. package/.versions/2.0.14/.pi/harnesses/lib/context-budget-view.ts +107 -0
  370. package/.versions/2.0.14/.pi/harnesses/lib/context-budget.ts +114 -0
  371. package/.versions/2.0.14/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  372. package/.versions/2.0.14/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  373. package/.versions/2.0.14/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  374. package/.versions/2.0.14/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  375. package/.versions/2.0.14/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  376. package/.versions/2.0.14/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  377. package/.versions/2.0.14/.pi/harnesses/lib/fleet-dashboard-view.ts +147 -0
  378. package/.versions/2.0.14/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  379. package/.versions/2.0.14/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  380. package/.versions/2.0.14/.pi/harnesses/lib/fleet-panel.ts +34 -0
  381. package/.versions/2.0.14/.pi/harnesses/lib/fleet-read-model.ts +536 -0
  382. package/.versions/2.0.14/.pi/harnesses/lib/fleet-selection.ts +24 -0
  383. package/.versions/2.0.14/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  384. package/.versions/2.0.14/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  385. package/.versions/2.0.14/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  386. package/.versions/2.0.14/.pi/harnesses/lib/herdr-client.ts +472 -0
  387. package/.versions/2.0.14/.pi/harnesses/lib/herdr-presence.ts +399 -0
  388. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  389. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  390. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  391. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  392. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  393. package/.versions/2.0.14/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  394. package/.versions/2.0.14/.pi/harnesses/lib/spawned-peers.js +191 -0
  395. package/.versions/2.0.14/.pi/harnesses/lib/system1/config.js +61 -0
  396. package/.versions/2.0.14/.pi/harnesses/lib/system1/contracts.ts +152 -0
  397. package/.versions/2.0.14/.pi/harnesses/lib/system1/demo.ts +106 -0
  398. package/.versions/2.0.14/.pi/harnesses/lib/system1/jev.ts +503 -0
  399. package/.versions/2.0.14/.pi/harnesses/lib/system1/service.ts +245 -0
  400. package/.versions/2.0.14/.pi/harnesses/lib/update-check.ts +222 -0
  401. package/.versions/2.0.14/.pi/harnesses/package-lock.json +2039 -0
  402. package/.versions/2.0.14/.pi/harnesses/package.json +10 -0
  403. package/.versions/2.0.14/.pi/prompts/af-build.md +24 -0
  404. package/.versions/2.0.14/.pi/prompts/af-code-simplify.md +22 -0
  405. package/.versions/2.0.14/.pi/prompts/af-constraints.md +31 -0
  406. package/.versions/2.0.14/.pi/prompts/af-plan.md +17 -0
  407. package/.versions/2.0.14/.pi/prompts/af-review.md +16 -0
  408. package/.versions/2.0.14/.pi/prompts/af-set-hermes-telegram.md +15 -0
  409. package/.versions/2.0.14/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  410. package/.versions/2.0.14/.pi/prompts/af-setup-rules.md +20 -0
  411. package/.versions/2.0.14/.pi/prompts/af-ship.md +17 -0
  412. package/.versions/2.0.14/.pi/prompts/af-spec.md +15 -0
  413. package/.versions/2.0.14/.pi/prompts/af-test.md +19 -0
  414. package/.versions/2.0.14/.pi/skills/bowser/SKILL.md +145 -0
  415. package/.versions/2.0.14/.version +1 -0
  416. package/.versions/2.0.14/agents/architect.md +24 -0
  417. package/.versions/2.0.14/agents/bowser.md +28 -0
  418. package/.versions/2.0.14/agents/builder.md +55 -0
  419. package/.versions/2.0.14/agents/code-reviewer.md +209 -0
  420. package/.versions/2.0.14/agents/deep-researcher.md +32 -0
  421. package/.versions/2.0.14/agents/documenter.md +22 -0
  422. package/.versions/2.0.14/agents/orchestrator.md +22 -0
  423. package/.versions/2.0.14/agents/plan-reviewer.md +83 -0
  424. package/.versions/2.0.14/agents/planner.md +105 -0
  425. package/.versions/2.0.14/agents/releaser.md +24 -0
  426. package/.versions/2.0.14/agents/researcher.md +30 -0
  427. package/.versions/2.0.14/agents/security-auditor.md +167 -0
  428. package/.versions/2.0.14/agents/test-engineer.md +153 -0
  429. package/.versions/2.0.14/agents/web-debugger.md +44 -0
  430. package/.versions/2.0.14/agents/web-performance-auditor.md +194 -0
  431. package/.versions/2.0.14/bin/catalog/harness-runtime-closure.json +73 -0
  432. package/.versions/2.0.14/codex/fleet-session-client/SKILL.md +34 -0
  433. package/.versions/2.0.14/codex/fleet-session-client.zip +0 -0
  434. package/.versions/2.0.14/docs/ARCHITECTURE.md +754 -0
  435. package/.versions/2.0.14/docs/agent-fleet-setup.md +917 -0
  436. package/.versions/2.0.14/docs/claude-code-coms-bridge.md +134 -0
  437. package/.versions/2.0.14/docs/codex-session-bridge.md +219 -0
  438. package/.versions/2.0.14/docs/coms-hermes-bridge.md +188 -0
  439. package/.versions/2.0.14/docs/getting-started.md +126 -0
  440. package/.versions/2.0.14/docs/npm-install.md +476 -0
  441. package/.versions/2.0.14/docs/pi-extensions.md +454 -0
  442. package/.versions/2.0.14/docs/pi-setup.md +92 -0
  443. package/.versions/2.0.14/docs/skill-anatomy.md +150 -0
  444. package/.versions/2.0.14/install-manifest.json +3183 -0
  445. package/.versions/2.0.14/justfile +247 -0
  446. package/.versions/2.0.14/manifest-meta.json +1065 -0
  447. package/.versions/2.0.14/references/accessibility-checklist.md +160 -0
  448. package/.versions/2.0.14/references/communication-contract.md +26 -0
  449. package/.versions/2.0.14/references/definition-of-done.md +67 -0
  450. package/.versions/2.0.14/references/fleet-coordination-patterns.md +171 -0
  451. package/.versions/2.0.14/references/observability-checklist.md +92 -0
  452. package/.versions/2.0.14/references/orchestration-patterns.md +370 -0
  453. package/.versions/2.0.14/references/performance-checklist.md +236 -0
  454. package/.versions/2.0.14/references/prompting-patterns.md +380 -0
  455. package/.versions/2.0.14/references/security-checklist.md +245 -0
  456. package/.versions/2.0.14/references/testing-patterns.md +235 -0
  457. package/.versions/2.0.14/references/workflow-authoring.md +304 -0
  458. package/.versions/2.0.14/skills/_internal/grilling.md +59 -0
  459. package/.versions/2.0.14/skills/browser-testing-with-devtools/SKILL.md +351 -0
  460. package/.versions/2.0.14/skills/code-review-and-quality/SKILL.md +396 -0
  461. package/.versions/2.0.14/skills/compound-learning/SKILL.md +137 -0
  462. package/.versions/2.0.14/skills/constraint-driven-development/SKILL.md +338 -0
  463. package/.versions/2.0.14/skills/constraint-driven-development/references/floor-guard.md +99 -0
  464. package/.versions/2.0.14/skills/context-engineering/SKILL.md +341 -0
  465. package/.versions/2.0.14/skills/deprecation-and-migration/SKILL.md +247 -0
  466. package/.versions/2.0.14/skills/designing-agents/SKILL.md +394 -0
  467. package/.versions/2.0.14/skills/designing-agents/pi-harness-authoring.md +222 -0
  468. package/.versions/2.0.14/skills/drafting-workflows/SKILL.md +143 -0
  469. package/.versions/2.0.14/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  470. package/.versions/2.0.14/skills/frontend-ui-engineering/SKILL.md +328 -0
  471. package/.versions/2.0.14/skills/git-workflow-and-versioning/SKILL.md +316 -0
  472. package/.versions/2.0.14/skills/idea-refine/SKILL.md +182 -0
  473. package/.versions/2.0.14/skills/idea-refine/examples.md +238 -0
  474. package/.versions/2.0.14/skills/idea-refine/frameworks.md +99 -0
  475. package/.versions/2.0.14/skills/idea-refine/refinement-criteria.md +113 -0
  476. package/.versions/2.0.14/skills/idea-refine/scripts/idea-refine.sh +15 -0
  477. package/.versions/2.0.14/skills/incremental-implementation/SKILL.md +302 -0
  478. package/.versions/2.0.14/skills/interview-me/SKILL.md +226 -0
  479. package/.versions/2.0.14/skills/orchestration-verification/SKILL.md +182 -0
  480. package/.versions/2.0.14/skills/peer-coms/SKILL.md +90 -0
  481. package/.versions/2.0.14/skills/performance-optimization/SKILL.md +496 -0
  482. package/.versions/2.0.14/skills/planning-and-task-breakdown/SKILL.md +289 -0
  483. package/.versions/2.0.14/skills/repository-ai-setup/SKILL.md +117 -0
  484. package/.versions/2.0.14/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  485. package/.versions/2.0.14/skills/repository-ai-setup/references/apply-contract.md +74 -0
  486. package/.versions/2.0.14/skills/repository-ai-setup/references/provenance-template.md +16 -0
  487. package/.versions/2.0.14/skills/repository-ai-setup/references/setup-flow.md +108 -0
  488. package/.versions/2.0.14/skills/repository-ai-setup/references/verify-setup.md +20 -0
  489. package/.versions/2.0.14/skills/security-and-hardening/SKILL.md +524 -0
  490. package/.versions/2.0.14/skills/spec-driven-development/SKILL.md +295 -0
  491. package/.versions/2.0.14/skills/using-agent-skills/SKILL.md +198 -0
  492. package/.versions/2.0.14/vendor/agent-skills-upstream/LICENSE +21 -0
  493. package/.versions/2.0.14/vendor/agent-skills-upstream/README.md +430 -0
  494. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  495. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  496. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  497. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  498. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  499. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  500. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  501. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  502. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  503. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  504. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  505. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  506. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  507. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  508. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  509. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  510. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  511. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  512. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  513. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  514. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  515. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  516. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  517. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  518. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  519. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  520. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  521. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  522. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  523. package/.versions/2.0.14/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  524. package/CHANGELOG.md +6 -0
  525. package/docs/ARCHITECTURE.md +1 -0
  526. package/docs/agent-fleet-setup.md +17 -0
  527. package/docs/npm-install.md +8 -0
  528. package/install-manifest.json +9 -1
  529. package/manifest-meta.json +8 -0
  530. package/package.json +3 -2
@@ -0,0 +1,62 @@
1
+ import { hasExplicitDispatcher, isCompleteProfile, parseCompleteProfile, profileModels, dispatcherSelection, validateProfile, type ModelProfile, type ModelSelection, type ProfileAgentDef } from '../config/model-profiles.ts';
2
+ import { setActiveProfile } from './profile-runtime.ts';
3
+ export interface ProfileActivationPorts {
4
+ busy(): boolean;
5
+ defs(): readonly ProfileAgentDef[];
6
+ available(): Promise<readonly string[]>;
7
+ dispatcher(): ModelSelection | undefined;
8
+ setDispatcher(selection: ModelSelection): Promise<boolean>;
9
+ apply(profile: ModelProfile): string[];
10
+ env?: NodeJS.ProcessEnv;
11
+ }
12
+ export function createProfileActivation(ports: ProfileActivationPorts) {
13
+ let baseline: ModelSelection | undefined;
14
+ let completeActive = false;
15
+ let switching = false;
16
+ return {
17
+ switching: () => switching,
18
+ reset() { baseline = undefined; completeActive = false; setActiveProfile(undefined, ports.env); },
19
+ async activate(name: string, input: ModelProfile): Promise<string[]> {
20
+ if (switching || ports.busy())
21
+ throw new Error('Model profile switch refused: wait for the dispatcher, agents and workflows to finish.');
22
+ switching = true;
23
+ try {
24
+ const profile = isCompleteProfile(input) ? parseCompleteProfile(input) : input;
25
+ const errors = validateProfile(profile, ports.defs());
26
+ if (errors.length)
27
+ throw new Error(errors.join('\n'));
28
+ const target = isCompleteProfile(profile) ? (hasExplicitDispatcher(profile) ? dispatcherSelection(profile) : undefined) : completeActive ? baseline : undefined;
29
+ const available = new Set(await ports.available());
30
+ const required = [...profileModels(profile), ...(target ? [target.model] : [])];
31
+ const missing = [...new Set(required.filter(model => !available.has(model)))];
32
+ if (missing.length)
33
+ throw new Error(`Profile "${name}" not activated; models unavailable in Pi: ${missing.join(', ')}. No settings changed.`);
34
+ if (ports.busy())
35
+ throw new Error('Model profile switch refused: work started during validation.');
36
+ const previous = ports.dispatcher();
37
+ if (target) {
38
+ try {
39
+ if (!await ports.setDispatcher(target))
40
+ throw new Error(`Could not select dispatcher model ${target.model}`);
41
+ }
42
+ catch (error) {
43
+ if (previous)
44
+ await ports.setDispatcher(previous);
45
+ throw error;
46
+ }
47
+ }
48
+ if (isCompleteProfile(profile) && !completeActive)
49
+ baseline = previous;
50
+ const applied = ports.apply(profile);
51
+ completeActive = isCompleteProfile(profile);
52
+ setActiveProfile(completeActive ? { name, profile: profile as any } : undefined, ports.env);
53
+ if (!completeActive)
54
+ baseline = undefined;
55
+ return applied;
56
+ }
57
+ finally {
58
+ switching = false;
59
+ }
60
+ },
61
+ };
62
+ }
@@ -0,0 +1,120 @@
1
+ import { parseCompleteProfile, agentSelection, childSelection, serviceSelection, type CompleteModelProfile } from '../config/model-profiles.ts';
2
+ export const PROFILE_ENV = 'AGENT_FLEET_ACTIVE_MODEL_PROFILE';
3
+ export interface ActiveModelProfile {
4
+ name: string;
5
+ profile: CompleteModelProfile;
6
+ }
7
+ let activeRuns = 0;
8
+ export function profileWorkInFlight(): number { return activeRuns; }
9
+ export async function withProfileWork<T>(run: () => Promise<T>): Promise<T> { activeRuns++; try {
10
+ return await run();
11
+ }
12
+ finally {
13
+ activeRuns--;
14
+ } }
15
+ export function readActiveProfile(env: NodeJS.ProcessEnv = process.env): ActiveModelProfile | undefined {
16
+ const raw = env[PROFILE_ENV];
17
+ if (!raw)
18
+ return undefined;
19
+ try {
20
+ const value = JSON.parse(raw);
21
+ if (typeof value.name !== 'string' || !value.name)
22
+ throw new Error('missing name');
23
+ return { name: value.name, profile: parseCompleteProfile(value.profile) };
24
+ }
25
+ catch (error) {
26
+ throw new Error(`Invalid active model profile: ${error instanceof Error ? error.message : String(error)}`);
27
+ }
28
+ }
29
+ export function setActiveProfile(active: ActiveModelProfile | undefined, env: NodeJS.ProcessEnv = process.env): void {
30
+ if (active)
31
+ env[PROFILE_ENV] = JSON.stringify(active);
32
+ else
33
+ delete env[PROFILE_ENV];
34
+ }
35
+ export function assertProfileModel(model: string, active = readActiveProfile()): void {
36
+ if (active?.profile['allowed-models'] && !active.profile['allowed-models'].includes(model))
37
+ throw new Error(`Profile "${active.name}" refuses model "${model}"; allowed-models: ${active.profile['allowed-models'].join(', ')}`);
38
+ }
39
+ export function profileFallback(candidate: string | undefined, active = readActiveProfile()): string | undefined {
40
+ if (active?.profile.fallback === 'none')
41
+ return undefined;
42
+ if (candidate)
43
+ assertProfileModel(candidate, active);
44
+ return candidate;
45
+ }
46
+ export function profileAgent(name: string, active = readActiveProfile()) { return active ? agentSelection(active.profile, name) : undefined; }
47
+ export function profileChild(parent: string, role: string, active = readActiveProfile()) { return active ? childSelection(active.profile, parent, role) : undefined; }
48
+ export function profileService(service: 'watchdog' | 'return-extractor', active = readActiveProfile()) { return active ? serviceSelection(active.profile, service) : undefined; }
49
+ export function profilePanel(name: string, active = readActiveProfile()) {
50
+ if (!active)
51
+ return undefined;
52
+ if (name !== active.name)
53
+ throw new Error(`Profile "${active.name}" owns the poll/debate panel; select --panel ${active.name}.`);
54
+ const voices = active.profile.panel ?? [
55
+ { name: 'first', model: active.profile.defaults.model, integrator: true },
56
+ { name: 'second', model: active.profile.defaults.model },
57
+ ];
58
+ return voices.map(v => ({ thinking: active.profile.defaults.thinking ?? 'off', ...v }));
59
+ }
60
+ export type ProfilePeerRefusal = {
61
+ isError: true;
62
+ content: [{ type: 'text'; text: string }];
63
+ details: { error: 'model-profile-native' | 'model-profile-allowlist' };
64
+ };
65
+
66
+ function refusal(text: string, error: ProfilePeerRefusal['details']['error']): ProfilePeerRefusal {
67
+ return { isError: true, content: [{ type: 'text', text }], details: { error } };
68
+ }
69
+
70
+ const BLANKET_NATIVE = 'Active model profile requires native agents; peer execution is disabled. Use dispatch_agent or leave this profile.';
71
+
72
+ /** True when native routing has no allowlist: standing peers are banned outright. */
73
+ export function profileForcesNativePeers(active = readActiveProfile()): boolean {
74
+ return !!active && active.profile.routing === 'native' && !active.profile['allowed-models']?.length;
75
+ }
76
+
77
+ /** Exact allowlist hit, or a unique provider-less suffix match. Ambiguous suffixes fail. */
78
+ export function modelAllowedByProfile(model: string, allowed: readonly string[]): boolean {
79
+ const value = model.trim();
80
+ if (!value || value === 'unknown')
81
+ return false;
82
+ if (allowed.includes(value))
83
+ return true;
84
+ if (value.includes('/'))
85
+ return false;
86
+ return allowed.filter(entry => entry.split('/').pop() === value).length === 1;
87
+ }
88
+
89
+ export function profilePeerGate(opts?: { peerModel?: string; targetResolved?: boolean }, active = readActiveProfile()): ProfilePeerRefusal | null {
90
+ if (!active || active.profile.routing !== 'native')
91
+ return null;
92
+ const allowed = active.profile['allowed-models'];
93
+ if (!allowed?.length)
94
+ return refusal(BLANKET_NATIVE, 'model-profile-native');
95
+ if (opts?.targetResolved === false)
96
+ return null;
97
+ const model = opts?.peerModel?.trim();
98
+ if (!model || model === 'unknown')
99
+ return refusal(`Active model profile "${active.name}" refuses unverified peers; advertised model is missing or unknown. Use a peer on allowed-models: ${allowed.join(', ')}, dispatch_agent native, or leave this profile.`, 'model-profile-allowlist');
100
+ if (modelAllowedByProfile(model, allowed))
101
+ return null;
102
+ return refusal(`Active model profile "${active.name}" refuses peer model "${model}"; allowed-models: ${allowed.join(', ')}. Use a peer on an allowed model, dispatch_agent native, or leave this profile.`, 'model-profile-allowlist');
103
+ }
104
+
105
+ export function profileSpawnPeerRefusal(plan: { runner: string; model?: string; persona?: string; name: string }, active = readActiveProfile()): ProfilePeerRefusal | null {
106
+ const early = profilePeerGate({ targetResolved: false }, active);
107
+ if (early)
108
+ return early;
109
+ if (!active || active.profile.routing !== 'native' || !active.profile['allowed-models']?.length)
110
+ return null;
111
+ if (plan.runner === 'claude-code')
112
+ return refusal(`Active model profile "${active.name}" refuses claude-code peers; allowed-models: ${active.profile['allowed-models'].join(', ')}. Spawn a pi peer on an allowed model or leave this profile.`, 'model-profile-allowlist');
113
+ const planned = plan.model ?? profileAgent(plan.persona ?? plan.name, active)?.model;
114
+ return profilePeerGate({ peerModel: planned, targetResolved: true }, active);
115
+ }
116
+
117
+ /** @deprecated Prefer profilePeerGate with the resolved peer model. */
118
+ export function profilePeerRefusal() {
119
+ return profilePeerGate();
120
+ }
@@ -0,0 +1,94 @@
1
+ import { resolveSessionRoster } from "../work-mode.ts";
2
+
3
+ export interface RosterDef { name: string }
4
+ export interface RosterState<TDef extends RosterDef> { def: TDef; status: string }
5
+ export interface RosterMutationResult { ok: boolean; message: string }
6
+ export interface SessionAdoption { file: string | null; quarantined: string | null; reason: string | null }
7
+
8
+ export interface RosterPolicyPorts<TDef extends RosterDef, TState extends RosterState<TDef>> {
9
+ getTeams(): Readonly<Record<string, readonly string[]>>;
10
+ getAllDefs(): readonly TDef[];
11
+ getStates(): Map<string, TState>;
12
+ getActiveTeamName(): string;
13
+ setActiveTeamName(name: string): void;
14
+ clearBackendNotices(): void;
15
+ createFreshState(def: TDef, adoption?: SessionAdoption): TState;
16
+ adoptSession(def: TDef): SessionAdoption;
17
+ quarantineSession(def: TDef): { usable: boolean; quarantined: string | null; reason: string | null };
18
+ persist(teamName: string): void;
19
+ recompute(): void;
20
+ refreshUi(): void;
21
+ displayName(name: string): string;
22
+ orchestratorNeedsRosterAfterDrop(size: number): boolean;
23
+ }
24
+
25
+ export interface RosterPolicy<TDef extends RosterDef> {
26
+ activateTeam(teamName: string): void;
27
+ activateFirstValidTeam(): boolean;
28
+ persistActiveRoster(): void;
29
+ add(name: string): RosterMutationResult;
30
+ drop(name: string): RosterMutationResult;
31
+ }
32
+
33
+ export function createRosterPolicy<TDef extends RosterDef, TState extends RosterState<TDef>>(ports: RosterPolicyPorts<TDef, TState>): RosterPolicy<TDef> {
34
+ function activateTeam(teamName: string): void {
35
+ ports.setActiveTeamName(teamName);
36
+ const members = ports.getTeams()[teamName] || [];
37
+ const defsByName = new Map(ports.getAllDefs().map(def => [def.name.toLowerCase(), def]));
38
+ const states = ports.getStates();
39
+ states.clear();
40
+ ports.clearBackendNotices();
41
+ for (const member of members) {
42
+ const def = defsByName.get(member.toLowerCase());
43
+ if (def) states.set(def.name.toLowerCase(), ports.createFreshState(def, ports.adoptSession(def)));
44
+ }
45
+ ports.recompute();
46
+ }
47
+ function activateFirstValidTeam(): boolean {
48
+ if (ports.getStates().size > 0) return true;
49
+ const teams = ports.getTeams();
50
+ const availablePersonas = ports.getAllDefs().map(def => def.name);
51
+ for (const name of Object.keys(teams)) {
52
+ const selected = resolveSessionRoster({ teams, entries: [], explicitRoster: name, availablePersonas });
53
+ if (!selected.roster) continue;
54
+ activateTeam(selected.roster.name);
55
+ return true;
56
+ }
57
+ return false;
58
+ }
59
+ function persistActiveRoster(): void {
60
+ const team = ports.getActiveTeamName();
61
+ if (team && ports.getStates().size > 0) ports.persist(team);
62
+ }
63
+ function add(name: string): RosterMutationResult {
64
+ const key = String(name || "").trim().toLowerCase();
65
+ const def = ports.getAllDefs().find(candidate => candidate.name.toLowerCase() === key);
66
+ if (!def) {
67
+ const available = ports.getAllDefs().map(candidate => candidate.name).sort().join(", ") || "(none)";
68
+ return { ok: false, message: `No persona "${name}". Available: ${available}` };
69
+ }
70
+ const states = ports.getStates();
71
+ if (states.has(def.name.toLowerCase())) return { ok: false, message: `${ports.displayName(def.name)} is already in the active team` };
72
+ const adoption = ports.adoptSession(def);
73
+ states.set(def.name.toLowerCase(), ports.createFreshState(def, adoption));
74
+ if (!ports.getActiveTeamName()) ports.setActiveTeamName("ad-hoc");
75
+ ports.recompute(); ports.refreshUi();
76
+ const note = adoption.quarantined ? ` — its previous session file was unusable (${adoption.reason}) and was quarantined to ${adoption.quarantined}; it starts clean` : "";
77
+ return { ok: true, message: `${ports.displayName(def.name)} added to the active team${note}` };
78
+ }
79
+ function drop(name: string): RosterMutationResult {
80
+ const key = String(name || "").trim().toLowerCase();
81
+ const states = ports.getStates();
82
+ const state = states.get(key);
83
+ if (!state) return { ok: false, message: `"${name}" is not in the active team (${Array.from(states.values()).map(item => item.def.name).join(", ") || "empty"})` };
84
+ if (state.status === "running") return { ok: false, message: `${ports.displayName(state.def.name)} is running — wait for it to finish or /af-agents-kill it first` };
85
+ if (ports.orchestratorNeedsRosterAfterDrop(states.size - 1)) return { ok: false, message: `${ports.displayName(state.def.name)} is the last team member — switch to operator work mode or add a replacement before dropping it` };
86
+ states.delete(key);
87
+ if (states.size === 0) ports.setActiveTeamName("");
88
+ ports.recompute(); ports.refreshUi();
89
+ const health = ports.quarantineSession(state.def);
90
+ const note = health.usable ? " (its session file is kept for re-adding)" : health.quarantined ? ` (its session file was unusable — ${health.reason} — and was quarantined to ${health.quarantined}; re-adding starts clean)` : " (it has no session file; re-adding starts clean)";
91
+ return { ok: true, message: `${ports.displayName(state.def.name)} dropped from the active team${note}` };
92
+ }
93
+ return { activateTeam, activateFirstValidTeam, persistActiveRoster, add, drop };
94
+ }
@@ -0,0 +1,126 @@
1
+ import { CAPABILITY_PACKS, persistedCapabilityState, resolveCapabilityPacks, type CapabilityPack, type CapabilityResolution, type ContextState, type PendingOperation } from "../capability-packs.ts";
2
+ import { confirmationGate, type CapabilityConfirmationState, type ConfirmableCapabilityPack } from "../capability-confirmation.ts";
3
+ import { orchestratorNeedsRoster } from "../helpers.ts";
4
+ import { WORK_MODE_ENTRY_TYPE, resolveWorkModeTools, type WorkMode } from "../work-mode.ts";
5
+ import { selectedPickerValue, workModeChangeBlockedByRoster, workModePickerOptions } from "../work-mode-controls.ts";
6
+
7
+ export interface WorkModeUiPort {
8
+ hasUI?: boolean;
9
+ ui: { notify(message: string, level: "error" | "warning" | "info"): void; setStatus(key: string, value: string | undefined): void; select(title: string, options: string[]): Promise<string | undefined> };
10
+ }
11
+ export interface PersistedCapabilityRestore { taskPacks: CapabilityPack[]; provisional: CapabilityPack[]; confirmation: CapabilityConfirmationState }
12
+ export interface WorkModePolicyPorts {
13
+ getBaselineTools(): readonly string[];
14
+ getRosterSize(): number;
15
+ activateFallbackRoster(ctx: WorkModeUiPort): void;
16
+ getActiveTeamName(): string;
17
+ getComsReady(): boolean;
18
+ getHerdrReady(): boolean;
19
+ getAskUserAvailable(): boolean;
20
+ getDeterministicToolsEnabled?(): boolean;
21
+ getIdentityLabel(): string | null;
22
+ getTaskTier(): string | null;
23
+ getPendingOperations(): PendingOperation[];
24
+ getContextState(): ContextState;
25
+ getActiveTools?(): readonly string[];
26
+ setActiveTools(tools: string[]): void;
27
+ recordToolCatalog?(change: { fromMode: WorkMode; toMode: WorkMode; previous: readonly string[]; next: readonly string[]; reason: "refresh" | "mode_switch" }): void;
28
+ persist(type: string, data: unknown): void;
29
+ replayDeferredInputs(): void;
30
+ watchdogArmed(workMode: WorkMode): boolean;
31
+ }
32
+ export interface WorkModePolicy {
33
+ getWorkMode(): WorkMode;
34
+ setRestoredWorkMode(mode: WorkMode): void;
35
+ getCapabilityResolution(): CapabilityResolution;
36
+ getCapabilityConfirmation(): CapabilityConfirmationState;
37
+ setCapabilityConfirmation(pack: ConfirmableCapabilityPack, status: CapabilityConfirmationState[ConfirmableCapabilityPack]): void;
38
+ restoreCapabilities(state: PersistedCapabilityRestore): void;
39
+ resetCapabilities(): void;
40
+ resolveIncomingCapabilities(userText: string, newTask?: boolean): void;
41
+ provisionalCapabilityRefusal(pack: ConfirmableCapabilityPack): { content: { type: "text"; text: string }[]; details: { status: string; confirmation: string; pack: ConfirmableCapabilityPack } } | null;
42
+ applyWorkModeTools(): void;
43
+ updateStatus(ctx: WorkModeUiPort): void;
44
+ statusText(): string;
45
+ modelWorkBlockedByRosterRecovery(ctx: WorkModeUiPort): boolean;
46
+ setRosterRecovery(required: boolean, diagnostic?: string): void;
47
+ clearRosterRecovery(): void;
48
+ commit(next: WorkMode, ctx: WorkModeUiPort): Promise<"ok" | "unchanged" | "roster">;
49
+ applySelection(next: WorkMode, ctx: WorkModeUiPort): Promise<void>;
50
+ openPicker(ctx: WorkModeUiPort): Promise<void>;
51
+ }
52
+
53
+ export function createWorkModePolicy(ports: WorkModePolicyPorts, initial: WorkMode = "operator"): WorkModePolicy {
54
+ let workMode = initial;
55
+ let rosterRecoveryRequired = false;
56
+ let rosterRecoveryDiagnostic = "";
57
+ let taskPacks: CapabilityPack[] = [];
58
+ let provisionalPacks: CapabilityPack[] = [];
59
+ let confirmation: CapabilityConfirmationState = {};
60
+ let resolution = resolveCapabilityPacks({ workMode, userText: "", taskPacks: [], comsReady: false, herdrReady: false, pendingOperations: [], contextState: "normal" });
61
+
62
+ function resolveIncomingCapabilities(userText: string, newTask = false): void {
63
+ resolution = resolveCapabilityPacks({
64
+ workMode, userText,
65
+ taskTier: (["trivial", "small", "feature", "project"] as const).find(tier => tier === ports.getTaskTier()),
66
+ taskPacks, provisionalPacks,
67
+ comsReady: ports.getComsReady(), herdrReady: ports.getHerdrReady(),
68
+ pendingOperations: ports.getPendingOperations(), contextState: ports.getContextState(), newTask,
69
+ });
70
+ for (const pack of ["fleet", "peer", "workspace"] as const) {
71
+ if (confirmation[pack] === "promoted" || confirmation[pack] === "declined") {
72
+ resolution.provisional = resolution.provisional.filter(candidate => candidate !== pack);
73
+ resolution.confirmationRequired = resolution.confirmationRequired.filter(candidate => candidate !== pack);
74
+ if (confirmation[pack] === "promoted" && !resolution.active.includes(pack)) resolution.active.push(pack);
75
+ }
76
+ }
77
+ taskPacks = resolution.nextTaskPacks = CAPABILITY_PACKS.filter(pack => pack !== "core" && pack !== "compaction" && resolution.active.includes(pack));
78
+ provisionalPacks = resolution.provisional.filter(pack => confirmation[pack as ConfirmableCapabilityPack] !== "declined");
79
+ try { ports.persist("agent-hub-capability-packs", persistedCapabilityState(resolution, confirmation)); } catch { /* best effort */ }
80
+ }
81
+ function applyWorkModeTools(fromMode: WorkMode = workMode, reason: "refresh" | "mode_switch" = "refresh"): void {
82
+ const previous = [...(ports.getActiveTools?.() ?? [])];
83
+ const requested = resolveWorkModeTools({ workMode, baselineTools: ports.getBaselineTools(), comsReady: ports.getComsReady(), herdrReady: ports.getHerdrReady(), askUserAvailable: ports.getAskUserAvailable(), deterministicTools: ports.getDeterministicToolsEnabled?.() === true, capabilityPacks: [...resolution.active, ...resolution.provisional] });
84
+ ports.setActiveTools(requested);
85
+ ports.recordToolCatalog?.({ fromMode, toMode: workMode, previous, next: [...(ports.getActiveTools?.() ?? requested)], reason });
86
+ }
87
+ function statusText(): string {
88
+ return [`Work Mode: ${workMode}`, `Direct tools: ${workMode === "operator" ? "enabled" : "disabled"}`, `Native roster: ${ports.getActiveTeamName() || "(none)"} (${ports.getRosterSize()})`, `Coms: ${ports.getComsReady() ? `ready${ports.getIdentityLabel() ? ` (${ports.getIdentityLabel()})` : ""}` : "unavailable"}`, `Herdr: ${ports.getHerdrReady() ? "ready" : "unavailable"}`].join("\n");
89
+ }
90
+ function refusalMessage(): string { return "Orchestrator work mode requires at least one native specialist. No valid configured team is available. Add one with /af-agents-add or fix .pi/agents/teams.yaml and select /af-agents-team."; }
91
+ function watchdogNote(next: WorkMode): string { return next === "orchestrator" ? ports.watchdogArmed(next) ? "\nDrift watchdog: armed (orchestrator auto). /af-watchdog off to disarm." : "\nDrift watchdog: off (explicit hub setting)." : ""; }
92
+ async function commit(next: WorkMode, ctx: WorkModeUiPort): Promise<"ok" | "unchanged" | "roster"> {
93
+ if (workModeChangeBlockedByRoster(workMode, next, ports.getRosterSize())) ports.activateFallbackRoster(ctx);
94
+ if (orchestratorNeedsRoster(next, ports.getRosterSize())) return "roster";
95
+ if (next === workMode) return "unchanged";
96
+ const previousMode = workMode;
97
+ workMode = next;
98
+ if (workMode === "operator") { rosterRecoveryRequired = false; rosterRecoveryDiagnostic = ""; setTimeout(ports.replayDeferredInputs, 0); }
99
+ resolveIncomingCapabilities(""); applyWorkModeTools(previousMode, "mode_switch"); ctx.ui.setStatus("hub-work-mode", `Work Mode: ${workMode}`); ports.persist(WORK_MODE_ENTRY_TYPE, { workMode });
100
+ return "ok";
101
+ }
102
+ async function applySelection(next: WorkMode, ctx: WorkModeUiPort): Promise<void> {
103
+ const result = await commit(next, ctx);
104
+ if (result === "roster") { ctx.ui.notify(refusalMessage(), "warning"); return; }
105
+ ctx.ui.notify(`${statusText()}\nPrompt and tools update on the next model call.${watchdogNote(next)}`, "info");
106
+ }
107
+ async function openPicker(ctx: WorkModeUiPort): Promise<void> {
108
+ const picker = workModePickerOptions(workMode);
109
+ const choice = await ctx.ui.select(picker.title, [...picker.options]);
110
+ const next = selectedPickerValue(picker.options, choice, picker.workModes);
111
+ if (next) await applySelection(next, ctx);
112
+ }
113
+ return {
114
+ getWorkMode: () => workMode, setRestoredWorkMode: mode => { workMode = mode; },
115
+ getCapabilityResolution: () => resolution, getCapabilityConfirmation: () => confirmation,
116
+ setCapabilityConfirmation: (pack, status) => { if (status) confirmation[pack] = status; else delete confirmation[pack]; },
117
+ restoreCapabilities: state => { taskPacks = [...state.taskPacks]; provisionalPacks = [...state.provisional]; confirmation = { ...state.confirmation }; },
118
+ resetCapabilities: () => { taskPacks = []; provisionalPacks = []; confirmation = {}; },
119
+ resolveIncomingCapabilities,
120
+ provisionalCapabilityRefusal: pack => { const gate = confirmationGate(confirmation, pack, resolution.provisional.includes(pack)); return gate.allowed ? null : { content: [{ type: "text", text: gate.message }], details: { status: "provisional_confirmation_required", confirmation: gate.status, pack } }; },
121
+ applyWorkModeTools, updateStatus: ctx => ctx.ui.setStatus("hub-work-mode", `Work Mode: ${workMode}`), statusText,
122
+ modelWorkBlockedByRosterRecovery: ctx => { if (workMode !== "orchestrator" || !rosterRecoveryRequired) return false; const message = `${rosterRecoveryDiagnostic || "No valid native roster is active."} Select one with /af-agents-team, restart with --agent-team <name>, or switch explicitly with /af-work-mode operator.`; ctx.ui.notify(message, "error"); if (!ctx.hasUI) console.error(`[agent-hub] ${message}`); return true; },
123
+ setRosterRecovery: (required, diagnostic = "") => { rosterRecoveryRequired = required; rosterRecoveryDiagnostic = required ? diagnostic : ""; }, clearRosterRecovery: () => { rosterRecoveryRequired = false; rosterRecoveryDiagnostic = ""; },
124
+ commit, applySelection, openPicker,
125
+ };
126
+ }
@@ -0,0 +1,176 @@
1
+ /** Pure `/af-poll` argument, panel, and digest helpers. The hub command is a thin consumer. */
2
+
3
+ export const HUB_POLL_DEFAULT_PERSONA = "researcher";
4
+
5
+ export interface ParsedAfPollArgs {
6
+ panel?: string;
7
+ persona: string;
8
+ question: string;
9
+ error?: string;
10
+ }
11
+
12
+ export interface AfPollVoiceDigest {
13
+ name: string;
14
+ model: string;
15
+ ok: boolean;
16
+ position?: string;
17
+ confidence?: string;
18
+ reason?: string;
19
+ }
20
+
21
+ export interface AfPollDigestInput {
22
+ panel: string;
23
+ directory: string;
24
+ voices: AfPollVoiceDigest[];
25
+ recommendation?: string;
26
+ integrator?: string;
27
+ }
28
+
29
+ export interface AfPollHandleInput {
30
+ args: string;
31
+ cwd: string;
32
+ pollPanelOverride?: string | null;
33
+ listPanels: (cwd: string) => string[] | Promise<string[]>;
34
+ preflight?: (options: { panel: string; persona: string; cwd: string }) => string | null | Promise<string | null>;
35
+ checkBudget: () => string | null | Promise<string | null>;
36
+ chargeBudget: () => void;
37
+ onAccepted?: (info: { panel: string; persona: string; question: string }) => void | Promise<void>;
38
+ execute: (options: { panel: string; persona: string; question: string; cwd: string }) => Promise<AfPollDigestInput>;
39
+ }
40
+
41
+ export interface AfPollHandleResult {
42
+ ok: boolean;
43
+ message: string;
44
+ digest?: string;
45
+ dispatcherNote?: string;
46
+ }
47
+
48
+ function tokenize(args: string): string[] {
49
+ const tokens: string[] = [];
50
+ const input = args.trim();
51
+ let current = "";
52
+ let quote: string | null = null;
53
+ for (let i = 0; i < input.length; i++) {
54
+ const ch = input[i];
55
+ if (quote) {
56
+ if (ch === quote) quote = null;
57
+ else current += ch;
58
+ continue;
59
+ }
60
+ if (ch === "\"" || ch === "'") { quote = ch; continue; }
61
+ if (/\s/.test(ch)) {
62
+ if (current) { tokens.push(current); current = ""; }
63
+ continue;
64
+ }
65
+ current += ch;
66
+ }
67
+ if (current) tokens.push(current);
68
+ return tokens;
69
+ }
70
+
71
+ export function parseAfPollArgs(args: string): ParsedAfPollArgs {
72
+ const tokens = tokenize(args ?? "");
73
+ let panel: string | undefined;
74
+ let persona: string | undefined;
75
+ const rest: string[] = [];
76
+ for (let i = 0; i < tokens.length; i++) {
77
+ const token = tokens[i];
78
+ if (token === "--panel") {
79
+ const value = tokens[++i];
80
+ if (!value || value.startsWith("--")) return { persona: HUB_POLL_DEFAULT_PERSONA, question: "", error: "/af-poll --panel requires a panel name" };
81
+ panel = value;
82
+ continue;
83
+ }
84
+ if (token === "--persona") {
85
+ const value = tokens[++i];
86
+ if (!value || value.startsWith("--")) return { persona: HUB_POLL_DEFAULT_PERSONA, question: "", error: "/af-poll --persona requires a persona name" };
87
+ persona = value;
88
+ continue;
89
+ }
90
+ rest.push(token);
91
+ }
92
+ const question = rest.join(" ").trim();
93
+ if (!question) {
94
+ return {
95
+ panel, persona: persona ?? HUB_POLL_DEFAULT_PERSONA, question: "",
96
+ error: "Usage: /af-poll [--panel NAME] [--persona NAME] <question>",
97
+ };
98
+ }
99
+ return { panel, persona: persona ?? HUB_POLL_DEFAULT_PERSONA, question };
100
+ }
101
+
102
+ export function resolveAfPollPanel(flag: string | undefined, override: string | null | undefined, available: string[]): { panel: string } | { error: string } {
103
+ const named = flag?.trim() || override?.trim() || "";
104
+ const list = available.length ? available.join(", ") : "(none)";
105
+ if (!named) {
106
+ return { error: `--panel is required (or set poll-panel: in ## agent-hub). Available panels: ${list}` };
107
+ }
108
+ if (available.length > 0 && !available.includes(named)) {
109
+ return { error: `Unknown panel "${named}". Available panels: ${list}` };
110
+ }
111
+ return { panel: named };
112
+ }
113
+
114
+ export function formatAfPollDigest(input: AfPollDigestInput): string {
115
+ const blocks = input.voices.map(voice => {
116
+ const header = `${voice.name} · ${voice.model}`;
117
+ if (!voice.ok) return `${header}\n failed: ${voice.reason ?? "unknown error"}`;
118
+ return `${header}\n position: ${voice.position ?? ""}\n confidence: ${voice.confidence ?? ""}`;
119
+ });
120
+ const merge = input.recommendation
121
+ ? `\nmerge${input.integrator ? ` · ${input.integrator}` : ""}\n recommendation: ${input.recommendation}`
122
+ : "";
123
+ return `${blocks.join("\n\n")}${merge}\n\nFull opinions: ${input.directory}`;
124
+ }
125
+
126
+ export function formatAfPollStarted(info: { panel: string; persona: string; question: string; voices?: { name: string; model: string }[] }): string {
127
+ const roster = info.voices?.length
128
+ ? info.voices.map(voice => `${voice.name} · ${voice.model}`).join("\n")
129
+ : "(voices loading)";
130
+ return [
131
+ `POLL STARTED (panel ${info.panel}, persona ${info.persona})`,
132
+ "",
133
+ `Question: ${info.question}`,
134
+ "",
135
+ "Voices:",
136
+ roster,
137
+ "",
138
+ "Running read-only. Full opinions stay on disk; a digest follows when every voice and the merge finish.",
139
+ ].join("\n");
140
+ }
141
+
142
+ export function formatAfPollVoiceProgress(voice: AfPollVoiceDigest): string {
143
+ if (!voice.ok) return `POLL VOICE ${voice.name} · ${voice.model}\n failed: ${voice.reason ?? "unknown error"}`;
144
+ return `POLL VOICE ${voice.name} · ${voice.model}\n position: ${voice.position ?? ""}\n confidence: ${voice.confidence ?? ""}`;
145
+ }
146
+
147
+ export function formatAfPollDispatcherNote(input: AfPollDigestInput, digest: string): string {
148
+ return [
149
+ `POLL RESULT (panel ${input.panel})`,
150
+ "",
151
+ digest,
152
+ "",
153
+ "The digest above is the whole payload. Do not paste full voice opinions into this session; cite the path if you need more.",
154
+ ].join("\n");
155
+ }
156
+
157
+ export async function handleAfPoll(input: AfPollHandleInput): Promise<AfPollHandleResult> {
158
+ const parsed = parseAfPollArgs(input.args);
159
+ if (parsed.error) return { ok: false, message: parsed.error };
160
+ const available = await input.listPanels(input.cwd);
161
+ const panel = resolveAfPollPanel(parsed.panel, input.pollPanelOverride, available);
162
+ if ("error" in panel) return { ok: false, message: panel.error };
163
+ const blocked = await input.preflight?.({ panel: panel.panel, persona: parsed.persona, cwd: input.cwd });
164
+ if (blocked) return { ok: false, message: blocked };
165
+ const budget = await input.checkBudget();
166
+ if (budget) return { ok: false, message: budget };
167
+ input.chargeBudget();
168
+ try { await input.onAccepted?.({ panel: panel.panel, persona: parsed.persona, question: parsed.question }); } catch { /* progress is best-effort */ }
169
+ try {
170
+ const digestInput = await input.execute({ panel: panel.panel, persona: parsed.persona, question: parsed.question, cwd: input.cwd });
171
+ const digest = formatAfPollDigest(digestInput);
172
+ return { ok: true, message: digest, digest, dispatcherNote: formatAfPollDispatcherNote(digestInput, digest) };
173
+ } catch (error) {
174
+ return { ok: false, message: error instanceof Error ? error.message : String(error) };
175
+ }
176
+ }
@@ -0,0 +1,48 @@
1
+ import { existsSync } from "node:fs";
2
+ import { fileURLToPath } from "node:url";
3
+ import { join } from "node:path";
4
+
5
+ const VALID_THINKING_LEVELS = new Set(["off", "minimal", "low", "medium", "high", "xhigh"]);
6
+ const THINKING_ABBREV: Record<string, string> = { off: "", minimal: "min", low: "low", medium: "med", high: "hi", xhigh: "xh" };
7
+
8
+ export function displayName(name: string): string {
9
+ return name.split("-").map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
10
+ }
11
+
12
+ export function extractAskUserQuestions(output: string): string[] {
13
+ return extractMarkers(output, "ASK_USER");
14
+ }
15
+
16
+ export function extractNeedsResearch(output: string): string[] {
17
+ return extractMarkers(output, "NEEDS_RESEARCH");
18
+ }
19
+
20
+ function extractMarkers(output: string, marker: string): string[] {
21
+ const questions: string[] = [];
22
+ const pattern = new RegExp(`^${marker}\\s*:\\s*(.+)$`, "i");
23
+ for (const rawLine of output.split("\n")) {
24
+ const question = rawLine.trim().match(pattern)?.[1]?.trim();
25
+ if (question && !questions.includes(question)) questions.push(question);
26
+ }
27
+ return questions;
28
+ }
29
+
30
+ export function resolveThinkingLevel(raw?: string): string {
31
+ if (!raw) return "off";
32
+ const value = raw.trim().toLowerCase();
33
+ if (VALID_THINKING_LEVELS.has(value)) return value;
34
+ return ["on", "true", "yes", "1"].includes(value) ? "low" : "off";
35
+ }
36
+
37
+ export function abbrevThinking(level: string): string {
38
+ return THINKING_ABBREV[level] ?? "";
39
+ }
40
+
41
+ export function resolveDelegateExtension(cwd: string): string | null {
42
+ try {
43
+ const extension = fileURLToPath(new URL("./delegate.ts", import.meta.url));
44
+ if (existsSync(extension)) return extension;
45
+ } catch {}
46
+ const local = join(cwd, ".pi", "harnesses", "agent-hub", "delegate.ts");
47
+ return existsSync(local) ? local : null;
48
+ }