@chankov/agent-fleet 1.0.0 → 1.0.1

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 (292) hide show
  1. package/.pi/agents/model-profiles.yaml +2 -2
  2. package/.pi/harnesses/agent-hub/README.md +12 -3
  3. package/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  4. package/.pi/harnesses/agent-hub/index.ts +121 -57
  5. package/.pi/harnesses/agent-hub/package.json +1 -1
  6. package/.pi/harnesses/agent-hub/run-budget.js +61 -0
  7. package/.pi/harnesses/coms/package.json +1 -1
  8. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  9. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +37 -0
  10. package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  11. package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
  12. package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
  13. package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
  14. package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
  15. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  16. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  17. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  18. package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
  19. package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
  20. package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
  21. package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
  22. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  23. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  24. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  25. package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  26. package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  27. package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  28. package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  29. package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  30. package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  31. package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
  32. package/.versions/1.0.1/.pi/extensions/package.json +9 -0
  33. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  34. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  35. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  36. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  37. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  38. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  39. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  40. package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
  41. package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  42. package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  43. package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  44. package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  45. package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  46. package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
  47. package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  48. package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  49. package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  50. package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  51. package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
  52. package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  53. package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  54. package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
  55. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  56. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  57. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  58. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  59. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  60. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  61. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  62. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  63. package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  64. package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  65. package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
  66. package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  67. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  68. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  69. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  70. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  71. package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  72. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
  73. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  74. package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  75. package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  76. package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  77. package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
  78. package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  79. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  80. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
  81. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  82. package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
  83. package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
  84. package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
  85. package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
  86. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  87. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  88. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  89. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  90. package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  91. package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  92. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  93. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  94. package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  95. package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  96. package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  97. package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  98. package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  99. package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  100. package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  101. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  102. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  103. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  104. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  105. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  106. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  107. package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  108. package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
  109. package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
  110. package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
  111. package/.versions/1.0.1/.pi/prompts/af-code-simplify.md +22 -0
  112. package/.versions/1.0.1/.pi/prompts/af-plan.md +16 -0
  113. package/.versions/1.0.1/.pi/prompts/af-review.md +16 -0
  114. package/.versions/1.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  115. package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  116. package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
  117. package/.versions/1.0.1/.pi/prompts/af-spec.md +15 -0
  118. package/.versions/1.0.1/.pi/prompts/af-test.md +19 -0
  119. package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
  120. package/.versions/1.0.1/.version +1 -0
  121. package/.versions/1.0.1/agents/architect.md +24 -0
  122. package/.versions/1.0.1/agents/bowser.md +27 -0
  123. package/.versions/1.0.1/agents/builder.md +54 -0
  124. package/.versions/1.0.1/agents/code-reviewer.md +208 -0
  125. package/.versions/1.0.1/agents/deep-researcher.md +32 -0
  126. package/.versions/1.0.1/agents/documenter.md +18 -0
  127. package/.versions/1.0.1/agents/orchestrator.md +72 -0
  128. package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
  129. package/.versions/1.0.1/agents/planner.md +70 -0
  130. package/.versions/1.0.1/agents/releaser.md +24 -0
  131. package/.versions/1.0.1/agents/researcher.md +28 -0
  132. package/.versions/1.0.1/agents/security-auditor.md +167 -0
  133. package/.versions/1.0.1/agents/test-engineer.md +153 -0
  134. package/.versions/1.0.1/agents/web-debugger.md +43 -0
  135. package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
  136. package/.versions/1.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  137. package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
  138. package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
  139. package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
  140. package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
  141. package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
  142. package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
  143. package/.versions/1.0.1/docs/getting-started.md +98 -0
  144. package/.versions/1.0.1/docs/npm-install.md +292 -0
  145. package/.versions/1.0.1/docs/pi-extensions.md +412 -0
  146. package/.versions/1.0.1/docs/pi-setup.md +74 -0
  147. package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
  148. package/.versions/1.0.1/hermes/README.md +347 -0
  149. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  150. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  151. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  152. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  153. package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
  154. package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  155. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  156. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  157. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  158. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  159. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  160. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  161. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  162. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  163. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  164. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  165. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  166. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  167. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  168. package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  169. package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  170. package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  171. package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  172. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  173. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  174. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  175. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  176. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  177. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  178. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  179. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  180. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  181. package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
  182. package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
  183. package/.versions/1.0.1/install-manifest.json +2745 -0
  184. package/.versions/1.0.1/justfile +272 -0
  185. package/.versions/1.0.1/manifest-meta.json +882 -0
  186. package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
  187. package/.versions/1.0.1/references/definition-of-done.md +67 -0
  188. package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
  189. package/.versions/1.0.1/references/observability-checklist.md +91 -0
  190. package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
  191. package/.versions/1.0.1/references/performance-checklist.md +153 -0
  192. package/.versions/1.0.1/references/prompting-patterns.md +380 -0
  193. package/.versions/1.0.1/references/security-checklist.md +179 -0
  194. package/.versions/1.0.1/references/testing-patterns.md +236 -0
  195. package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
  196. package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
  197. package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
  198. package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
  199. package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
  200. package/.versions/1.0.1/scripts/fleet.ts +185 -0
  201. package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  202. package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  203. package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  204. package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
  205. package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  206. package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
  207. package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
  208. package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
  209. package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  210. package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
  211. package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
  212. package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  213. package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  214. package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  215. package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  216. package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  217. package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  218. package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  219. package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
  220. package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
  221. package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
  222. package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
  223. package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
  224. package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
  225. package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
  226. package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
  227. package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
  228. package/.versions/1.0.1/scripts/team-up.ts +406 -0
  229. package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
  230. package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  231. package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  232. package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
  233. package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
  234. package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  235. package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
  236. package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  237. package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  238. package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  239. package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
  240. package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
  241. package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
  242. package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  243. package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  244. package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
  245. package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
  246. package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
  247. package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
  248. package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
  249. package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
  250. package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
  251. package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
  252. package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
  253. package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  254. package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  255. package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
  256. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  257. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  258. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  259. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  260. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  261. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  262. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  263. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  264. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  265. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  266. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  267. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  268. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  269. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  270. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  271. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  272. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  273. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  274. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  275. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  276. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  277. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  278. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  279. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  280. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  281. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  282. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  283. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  284. package/CHANGELOG.md +6 -0
  285. package/agents/code-reviewer.md +1 -1
  286. package/agents/deep-researcher.md +1 -1
  287. package/agents/plan-reviewer.md +1 -1
  288. package/agents/planner.md +1 -1
  289. package/agents/security-auditor.md +1 -1
  290. package/agents/test-engineer.md +1 -1
  291. package/install-manifest.json +1 -1
  292. package/package.json +2 -2
@@ -0,0 +1,131 @@
1
+ export type FleetKind = "specialist" | "research" | "delegate" | "peer";
2
+ export type FleetStatus = "idle" | "running" | "done" | "error" | "pending" | "stale";
3
+
4
+ export interface FleetRow {
5
+ key: string;
6
+ kind: FleetKind;
7
+ name: string;
8
+ parentKey?: string;
9
+ depth: number;
10
+ status: FleetStatus;
11
+ model: string;
12
+ backend: "native" | "coms";
13
+ contextPct: number | null;
14
+ contextTokens: number | null;
15
+ elapsed: number;
16
+ startedAt?: number;
17
+ toolCount: number | null;
18
+ lastWork: string;
19
+ hasTimeline: boolean;
20
+ colorHex?: string;
21
+ }
22
+
23
+ export interface DelegateInput extends Omit<FleetRow, "kind" | "parentKey" | "depth" | "backend" | "hasTimeline"> {
24
+ children?: readonly DelegateInput[];
25
+ }
26
+ export interface SpecialistInput extends Omit<FleetRow, "kind" | "parentKey" | "depth"> {
27
+ delegates?: readonly DelegateInput[];
28
+ }
29
+ export interface ResearchInput extends Omit<FleetRow, "kind" | "parentKey" | "depth"> {}
30
+ export interface PeerInput extends Omit<FleetRow, "kind" | "parentKey" | "depth" | "backend" | "hasTimeline" | "status" | "contextPct" | "contextTokens" | "toolCount" | "elapsed"> {
31
+ /** Registry-only entries have not answered a ping. */
32
+ pending?: boolean;
33
+ staleCount?: number;
34
+ status?: FleetStatus;
35
+ elapsed?: number;
36
+ }
37
+ export interface FleetSource {
38
+ specialists: readonly SpecialistInput[];
39
+ research: readonly ResearchInput[];
40
+ peers: readonly PeerInput[];
41
+ }
42
+ export interface FleetFilter { showFinished: boolean; query?: string; }
43
+
44
+ /** Convert an authoritative run interval into row timing without re-anchoring completed work. */
45
+ export function fleetTiming(interval: { startedAt: number; endedAt: number | null } | undefined, now = Date.now()): Pick<FleetRow, "startedAt" | "elapsed"> {
46
+ if (!interval) return { startedAt: undefined, elapsed: 0 };
47
+ const endedAt = interval.endedAt ?? now;
48
+ return { startedAt: interval.startedAt, elapsed: Math.max(0, endedAt - interval.startedAt) };
49
+ }
50
+
51
+ const statusOrder: Record<FleetStatus, number> = { running: 0, pending: 1, error: 2, done: 3, idle: 3, stale: 3 };
52
+ // A roster member is idle until dispatched, not finished; keep it visible by default.
53
+ const hiddenWhenFinished = new Set<FleetStatus>(["done", "stale"]);
54
+
55
+ function compareRows(a: FleetRow, b: FleetRow): number {
56
+ return statusOrder[a.status] - statusOrder[b.status]
57
+ || (a.startedAt ?? Number.MAX_SAFE_INTEGER) - (b.startedAt ?? Number.MAX_SAFE_INTEGER)
58
+ || a.key.localeCompare(b.key);
59
+ }
60
+
61
+ function matches(row: FleetRow, query: string): boolean {
62
+ return `${row.name} ${row.model} ${row.lastWork}`.toLowerCase().includes(query);
63
+ }
64
+
65
+ interface FleetNode { row: FleetRow; children: FleetNode[]; }
66
+
67
+ /** Collapse local specialists, delegate trees, research, and coms peers into stable display rows. */
68
+ export function buildFleetRows(src: FleetSource, filter: FleetFilter): FleetRow[] {
69
+ const query = filter.query?.trim().toLowerCase() ?? "";
70
+ const roots: FleetNode[] = [];
71
+ const delegate = (input: DelegateInput, parentKey: string, depth: number): FleetNode => ({
72
+ row: { ...input, kind: "delegate", parentKey, depth, backend: "native", hasTimeline: true },
73
+ children: (input.children ?? []).map(child => delegate(child, input.key, depth + 1)).sort((a, b) => compareRows(a.row, b.row)),
74
+ });
75
+ for (const input of src.specialists) roots.push({
76
+ row: { ...input, kind: "specialist", depth: 0 },
77
+ children: (input.delegates ?? []).map(child => delegate(child, input.key, 1)).sort((a, b) => compareRows(a.row, b.row)),
78
+ });
79
+ for (const input of src.research) roots.push({ row: { ...input, kind: "research", depth: 0 }, children: [] });
80
+ for (const input of src.peers) {
81
+ const status: FleetStatus = input.pending ? "pending" : (input.staleCount ?? 0) >= 3 ? "stale" : (input.status ?? "idle");
82
+ roots.push({ row: { ...input, kind: "peer", depth: 0, status, backend: "coms", contextPct: null, contextTokens: null, toolCount: null, elapsed: input.elapsed ?? 0, hasTimeline: false }, children: [] });
83
+ }
84
+ roots.sort((a, b) => compareRows(a.row, b.row));
85
+ const visible = (node: FleetNode): boolean => {
86
+ const children = node.children.filter(visible);
87
+ node.children = children;
88
+ const own = (filter.showFinished || !hiddenWhenFinished.has(node.row.status)) && (!query || matches(node.row, query));
89
+ return own || children.length > 0;
90
+ };
91
+ const out: FleetRow[] = [];
92
+ const emit = (node: FleetNode) => {
93
+ out.push(node.row);
94
+ for (const child of node.children) emit(child);
95
+ };
96
+ for (const root of roots) if (visible(root)) emit(root);
97
+ return out;
98
+ }
99
+
100
+ /** Total covered length of possibly overlapping intervals. */
101
+ export function unionMs(intervals: readonly [number, number][]): number {
102
+ if (intervals.length === 0) return 0;
103
+ const sorted = intervals.slice().sort((a, b) => a[0] - b[0]);
104
+ let total = 0;
105
+ let start = sorted[0][0];
106
+ let end = sorted[0][1];
107
+ for (let i = 1; i < sorted.length; i++) {
108
+ const [nextStart, nextEnd] = sorted[i];
109
+ if (nextStart > end) {
110
+ total += end - start;
111
+ [start, end] = [nextStart, nextEnd];
112
+ } else if (nextEnd > end) {
113
+ end = nextEnd;
114
+ }
115
+ }
116
+ return total + end - start;
117
+ }
118
+
119
+ /** Aggregate visible rows; callers use unionMs(intervals) for overlap-aware wall time. */
120
+ export function summarise(rows: readonly FleetRow[]): { running: number; done: number; failed: number; totalTokens: number; intervals: Array<[number, number]> } {
121
+ const intervals: Array<[number, number]> = [];
122
+ let running = 0, done = 0, failed = 0, totalTokens = 0;
123
+ for (const row of rows) {
124
+ if (row.status === "running") running++;
125
+ if (row.status === "done") done++;
126
+ if (row.status === "error") failed++;
127
+ if (row.contextTokens != null) totalTokens += row.contextTokens;
128
+ if (row.startedAt != null) intervals.push([row.startedAt, row.startedAt + Math.max(0, row.elapsed)]);
129
+ }
130
+ return { running, done, failed, totalTokens, intervals };
131
+ }
@@ -0,0 +1,24 @@
1
+ export interface Selection {
2
+ key?: string;
3
+ index: number;
4
+ }
5
+
6
+ /** Keep selection on its stable key where possible, otherwise clamp its index. */
7
+ export function reconcileSelection(sel: Selection, rows: readonly { key: string }[]): void {
8
+ if (rows.length === 0) {
9
+ sel.index = 0;
10
+ sel.key = undefined;
11
+ return;
12
+ }
13
+ const keyedIndex = sel.key === undefined ? -1 : rows.findIndex((row) => row.key === sel.key);
14
+ sel.index = keyedIndex >= 0 ? keyedIndex : Math.max(0, Math.min(sel.index, rows.length - 1));
15
+ sel.key = rows[sel.index].key;
16
+ }
17
+
18
+ /** Move selection by delta, clamped without wraparound. */
19
+ export function moveSelection(sel: Selection, rows: readonly { key: string }[], delta: number): void {
20
+ reconcileSelection(sel, rows);
21
+ if (rows.length === 0) return;
22
+ sel.index = Math.max(0, Math.min(rows.length - 1, sel.index + delta));
23
+ sel.key = rows[sel.index].key;
24
+ }
@@ -0,0 +1,472 @@
1
+ // .pi/harnesses/lib/herdr-client.ts
2
+ //
3
+ // The one shared client for the herdr socket API (https://herdr.dev/docs/socket-api/).
4
+ // Every file in this repo that talks to herdr goes through this module — no other
5
+ // file opens the socket directly.
6
+ //
7
+ // Wire facts this client is built on (validated live against herdr 0.7.1,
8
+ // protocol 14 — see docs/plans/herdr/spike-notes.md):
9
+ // - ndjson over a unix socket; the server closes the connection after each
10
+ // response, so request() opens a fresh connection per call.
11
+ // - events.subscribe is the exception: the connection stays open and streams
12
+ // `{"event":…,"data":…}` lines after a `subscription_started` ack.
13
+ // - Unknown request params are SILENTLY IGNORED by the server (e.g. `pane_id`
14
+ // instead of `target_pane_id` on pane.split retargets the focused pane) —
15
+ // the typed wrappers below exist so callers never hand-write param names.
16
+ // - Parse-level errors come back with an empty id; with one request in flight
17
+ // per connection they are safely attributed to that request.
18
+ //
19
+ // No pi imports; plain Node stdlib; erasable-TS only (runs under node --test).
20
+
21
+ import * as net from "node:net";
22
+ import * as os from "node:os";
23
+ import * as path from "node:path";
24
+
25
+ export interface HerdrErrorShape {
26
+ code: string;
27
+ message: string;
28
+ }
29
+
30
+ export class HerdrRequestError extends Error {
31
+ code: string;
32
+ constructor(err: HerdrErrorShape) {
33
+ super(`herdr: ${err.code}: ${err.message}`);
34
+ this.name = "HerdrRequestError";
35
+ this.code = err.code;
36
+ }
37
+ }
38
+
39
+ export class HerdrUnavailableError extends Error {
40
+ socketPath: string;
41
+ constructor(socketPath: string, cause: string) {
42
+ super(
43
+ `herdr is not running or unreachable (socket: ${socketPath}): ${cause}\n` +
44
+ `Start herdr first (run \`herdr\` in a terminal), or point HERDR_SOCKET_PATH at a running server.`,
45
+ );
46
+ this.name = "HerdrUnavailableError";
47
+ this.socketPath = socketPath;
48
+ }
49
+ }
50
+
51
+ export interface HerdrClientOptions {
52
+ socketPath?: string;
53
+ timeoutMs?: number;
54
+ }
55
+
56
+ export interface PongInfo {
57
+ type: "pong";
58
+ version: string;
59
+ protocol: number;
60
+ capabilities?: Record<string, unknown>;
61
+ [key: string]: unknown;
62
+ }
63
+
64
+ // Minimum server the fleet features are validated against (spike: 0.7.1 / protocol 14).
65
+ export const MIN_PROTOCOL = 14;
66
+ const DEFAULT_TIMEOUT_MS = 5000;
67
+
68
+ // Resolution order: explicit arg → HERDR_SOCKET_PATH (set inside every herdr
69
+ // pane) → the default-session socket. Named sessions always export
70
+ // HERDR_SOCKET_PATH into their panes, so the env var covers them.
71
+ export function resolveSocketPath(explicit?: string): string {
72
+ if (explicit) return explicit;
73
+ if (process.env.HERDR_SOCKET_PATH) return process.env.HERDR_SOCKET_PATH;
74
+ return path.join(os.homedir(), ".config", "herdr", "herdr.sock");
75
+ }
76
+
77
+ interface WireResponse {
78
+ id?: string;
79
+ result?: Record<string, unknown>;
80
+ error?: HerdrErrorShape;
81
+ event?: string;
82
+ data?: unknown;
83
+ }
84
+
85
+ let nextId = 0;
86
+
87
+ // One request → one connection → one response line. Resolves with the raw
88
+ // `result` object (unknown fields pass through untouched); rejects with
89
+ // HerdrRequestError on an error envelope, HerdrUnavailableError when the
90
+ // socket cannot be reached, and a plain Error on timeout.
91
+ export function request<T = Record<string, unknown>>(
92
+ method: string,
93
+ params: Record<string, unknown> = {},
94
+ opts: HerdrClientOptions = {},
95
+ ): Promise<T> {
96
+ const socketPath = resolveSocketPath(opts.socketPath);
97
+ const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
98
+ const id = `as-${process.pid}-${++nextId}`;
99
+
100
+ return new Promise<T>((resolve, reject) => {
101
+ const sock = net.createConnection(socketPath);
102
+ let buf = "";
103
+ let settled = false;
104
+ const timer = setTimeout(() => {
105
+ finish(() => reject(new Error(`herdr: timeout after ${timeoutMs}ms waiting for ${method}`)));
106
+ }, timeoutMs);
107
+
108
+ function finish(f: () => void): void {
109
+ if (settled) return;
110
+ settled = true;
111
+ clearTimeout(timer);
112
+ sock.destroy();
113
+ f();
114
+ }
115
+
116
+ sock.on("connect", () => {
117
+ sock.write(JSON.stringify({ id, method, params }) + "\n");
118
+ });
119
+ sock.on("data", (chunk) => {
120
+ buf += chunk.toString();
121
+ let nl: number;
122
+ while ((nl = buf.indexOf("\n")) !== -1) {
123
+ const line = buf.slice(0, nl).trim();
124
+ buf = buf.slice(nl + 1);
125
+ if (!line) continue;
126
+ let msg: WireResponse;
127
+ try {
128
+ msg = JSON.parse(line);
129
+ } catch {
130
+ continue; // not ours; keep reading until timeout
131
+ }
132
+ // Parse errors arrive with an empty id — with one in-flight request
133
+ // per connection they belong to us. Ignore lines for other ids.
134
+ if (msg.error && (msg.id === id || msg.id === "" || msg.id === undefined)) {
135
+ finish(() => reject(new HerdrRequestError(msg.error as HerdrErrorShape)));
136
+ return;
137
+ }
138
+ if (msg.id === id && msg.result !== undefined) {
139
+ finish(() => resolve(msg.result as T));
140
+ return;
141
+ }
142
+ }
143
+ });
144
+ sock.on("error", (err) => {
145
+ finish(() => reject(new HerdrUnavailableError(socketPath, err.message)));
146
+ });
147
+ sock.on("close", () => {
148
+ finish(() => reject(new Error(`herdr: connection closed before a response to ${method}`)));
149
+ });
150
+ });
151
+ }
152
+
153
+ // Ping and return server info, or null when herdr is not reachable/answering.
154
+ export async function herdrAvailable(opts: HerdrClientOptions = {}): Promise<PongInfo | null> {
155
+ try {
156
+ const pong = await request<PongInfo>("ping", {}, { timeoutMs: 2000, ...opts });
157
+ return pong && pong.type === "pong" ? pong : null;
158
+ } catch {
159
+ return null;
160
+ }
161
+ }
162
+
163
+ // Fail-fast helper used by every fleet entrypoint: resolves with the pong,
164
+ // throws HerdrUnavailableError with an actionable message otherwise.
165
+ export async function requireHerdr(opts: HerdrClientOptions = {}): Promise<PongInfo> {
166
+ const socketPath = resolveSocketPath(opts.socketPath);
167
+ const pong = await herdrAvailable(opts);
168
+ if (!pong) throw new HerdrUnavailableError(socketPath, "no server answered ping");
169
+ if (typeof pong.protocol === "number" && pong.protocol < MIN_PROTOCOL) {
170
+ throw new HerdrUnavailableError(
171
+ socketPath,
172
+ `server protocol ${pong.protocol} is older than the minimum tested protocol ${MIN_PROTOCOL} — update herdr`,
173
+ );
174
+ }
175
+ return pong;
176
+ }
177
+
178
+ // ---------------------------------------------------------------- events
179
+
180
+ // Global topics subscribe as {type}; pane.agent_status_changed and
181
+ // pane.output_matched additionally REQUIRE a concrete pane_id (no wildcard).
182
+ export type Subscription = { type: string; [key: string]: unknown };
183
+
184
+ export interface HerdrEvent {
185
+ event: string;
186
+ data: Record<string, unknown>;
187
+ }
188
+
189
+ export interface SubscribeHandle {
190
+ close(): void;
191
+ }
192
+
193
+ export interface SubscribeOptions extends HerdrClientOptions {
194
+ // Called when the stream (re)establishes — subscriptions are re-sent
195
+ // automatically; use this to reconcile state missed while disconnected.
196
+ onConnect?: () => void;
197
+ onError?: (err: Error) => void;
198
+ reconnectDelayMs?: number;
199
+ }
200
+
201
+ // Long-lived event stream with auto-reconnect. The returned handle's close()
202
+ // stops both the stream and any pending reconnect.
203
+ export function subscribe(
204
+ subscriptions: Subscription[],
205
+ onEvent: (ev: HerdrEvent) => void,
206
+ opts: SubscribeOptions = {},
207
+ ): SubscribeHandle {
208
+ const socketPath = resolveSocketPath(opts.socketPath);
209
+ const reconnectDelayMs = opts.reconnectDelayMs ?? 1000;
210
+ let sock: net.Socket | null = null;
211
+ let closed = false;
212
+ let retryTimer: ReturnType<typeof setTimeout> | null = null;
213
+
214
+ function connect(): void {
215
+ if (closed) return;
216
+ let buf = "";
217
+ let acked = false;
218
+ sock = net.createConnection(socketPath);
219
+ sock.on("connect", () => {
220
+ sock?.write(
221
+ JSON.stringify({ id: "sub", method: "events.subscribe", params: { subscriptions } }) + "\n",
222
+ );
223
+ });
224
+ sock.on("data", (chunk) => {
225
+ buf += chunk.toString();
226
+ let nl: number;
227
+ while ((nl = buf.indexOf("\n")) !== -1) {
228
+ const line = buf.slice(0, nl).trim();
229
+ buf = buf.slice(nl + 1);
230
+ if (!line) continue;
231
+ let msg: WireResponse;
232
+ try {
233
+ msg = JSON.parse(line);
234
+ } catch {
235
+ continue;
236
+ }
237
+ if (!acked && msg.result && (msg.result as { type?: string }).type === "subscription_started") {
238
+ acked = true;
239
+ opts.onConnect?.();
240
+ continue;
241
+ }
242
+ if (!acked && msg.error) {
243
+ opts.onError?.(new HerdrRequestError(msg.error));
244
+ // A rejected subscription will not fix itself by retrying.
245
+ closed = true;
246
+ sock?.destroy();
247
+ return;
248
+ }
249
+ if (msg.event) {
250
+ onEvent({ event: msg.event, data: (msg.data ?? {}) as Record<string, unknown> });
251
+ }
252
+ }
253
+ });
254
+ const scheduleReconnect = () => {
255
+ if (closed || retryTimer) return;
256
+ retryTimer = setTimeout(() => {
257
+ retryTimer = null;
258
+ connect();
259
+ }, reconnectDelayMs);
260
+ };
261
+ sock.on("error", (err) => {
262
+ opts.onError?.(err);
263
+ sock?.destroy();
264
+ scheduleReconnect();
265
+ });
266
+ sock.on("close", scheduleReconnect);
267
+ }
268
+
269
+ connect();
270
+ return {
271
+ close() {
272
+ closed = true;
273
+ if (retryTimer) clearTimeout(retryTimer);
274
+ retryTimer = null;
275
+ sock?.destroy();
276
+ sock = null;
277
+ },
278
+ };
279
+ }
280
+
281
+ // ---------------------------------------------------------------- typed wrappers
282
+ //
283
+ // Thin, param-name-exact wrappers for the methods this repo uses. Response
284
+ // types capture the fields we rely on; everything else passes through.
285
+
286
+ export interface WorkspaceInfo {
287
+ workspace_id: string;
288
+ number?: number;
289
+ label?: string;
290
+ focused?: boolean;
291
+ pane_count?: number;
292
+ tab_count?: number;
293
+ active_tab_id?: string;
294
+ agent_status?: string;
295
+ [key: string]: unknown;
296
+ }
297
+
298
+ export interface PaneInfo {
299
+ pane_id: string;
300
+ terminal_id?: string;
301
+ workspace_id?: string;
302
+ tab_id?: string;
303
+ focused?: boolean;
304
+ cwd?: string;
305
+ label?: string;
306
+ agent?: string;
307
+ agent_status?: string;
308
+ agent_session?: { source?: string; agent?: string; kind?: string; value?: string };
309
+ [key: string]: unknown;
310
+ }
311
+
312
+ // Layout tree nodes for layout.apply: `command` is an ARGV ARRAY (a string is
313
+ // rejected by the server); layout.apply creates a NEW tab in the workspace.
314
+ export type LayoutNode =
315
+ | {
316
+ type: "pane";
317
+ command?: string[];
318
+ cwd?: string;
319
+ label?: string;
320
+ env?: Record<string, string>;
321
+ pane_id?: string;
322
+ }
323
+ | {
324
+ type: "split";
325
+ direction: "right" | "down";
326
+ ratio?: number;
327
+ first: LayoutNode;
328
+ second: LayoutNode;
329
+ };
330
+
331
+ export const herdr = {
332
+ ping: (opts?: HerdrClientOptions) => request<PongInfo>("ping", {}, opts),
333
+
334
+ workspaceCreate: (
335
+ params: { label?: string; cwd?: string; env?: Record<string, string>; focus?: boolean },
336
+ opts?: HerdrClientOptions,
337
+ ) =>
338
+ request<{ workspace: WorkspaceInfo; tab: Record<string, unknown>; root_pane: PaneInfo }>(
339
+ "workspace.create",
340
+ params,
341
+ opts,
342
+ ),
343
+ workspaceList: (opts?: HerdrClientOptions) =>
344
+ request<{ workspaces: WorkspaceInfo[] }>("workspace.list", {}, opts),
345
+ workspaceFocus: (workspace_id: string, opts?: HerdrClientOptions) =>
346
+ request("workspace.focus", { workspace_id }, opts),
347
+ workspaceRename: (workspace_id: string, label: string, opts?: HerdrClientOptions) =>
348
+ request("workspace.rename", { workspace_id, label }, opts),
349
+ workspaceClose: (workspace_id: string, opts?: HerdrClientOptions) =>
350
+ request("workspace.close", { workspace_id }, opts),
351
+
352
+ // NOTE: the target field is `target_pane_id` — `pane_id` would be silently
353
+ // ignored and the FOCUSED pane split instead (spike finding).
354
+ //
355
+ // There is NO `command` param: a split always opens a plain interactive
356
+ // shell in `cwd`. Verified against herdr 0.7.5 — `PaneSplitParams` is
357
+ // {target_pane_id, direction, ratio, cwd, env, focus} and `herdr pane split
358
+ // --help` exposes no command flag. Only `layout.apply` pane nodes carry
359
+ // `command: [argv…]`. This type used to advertise `command?: string[]`;
360
+ // because unknown params are silently ignored, callers got a bare shell
361
+ // pane and a success response. To launch something in a split pane, send
362
+ // the command line as input once the pane is at its shell prompt
363
+ // (paneSendText) — see the herdr_spawn_peer tool in agent-hub.
364
+ paneSplit: (
365
+ params: {
366
+ target_pane_id: string;
367
+ direction: "right" | "down";
368
+ ratio?: number;
369
+ cwd?: string;
370
+ env?: Record<string, string>;
371
+ focus?: boolean;
372
+ },
373
+ opts?: HerdrClientOptions,
374
+ ) => request<{ pane: PaneInfo }>("pane.split", params, opts),
375
+ paneRename: (pane_id: string, label: string, opts?: HerdrClientOptions) =>
376
+ request<{ pane: PaneInfo }>("pane.rename", { pane_id, label }, opts),
377
+ paneSendText: (pane_id: string, text: string, opts?: HerdrClientOptions) =>
378
+ request("pane.send_text", { pane_id, text }, opts),
379
+ paneSendKeys: (pane_id: string, keys: string[], opts?: HerdrClientOptions) =>
380
+ request("pane.send_keys", { pane_id, keys }, opts),
381
+ paneRead: (
382
+ params: {
383
+ pane_id: string;
384
+ source?: "visible" | "recent" | "recent_unwrapped" | "detection";
385
+ lines?: number;
386
+ format?: "text" | "ansi";
387
+ strip_ansi?: boolean;
388
+ },
389
+ opts?: HerdrClientOptions,
390
+ ) =>
391
+ request<{ read: { pane_id: string; text: string; truncated?: boolean; [key: string]: unknown } }>(
392
+ "pane.read",
393
+ { source: "recent", format: "text", strip_ansi: true, ...params },
394
+ opts,
395
+ ),
396
+ paneGet: (pane_id: string, opts?: HerdrClientOptions) =>
397
+ request<{ pane: PaneInfo }>("pane.get", { pane_id }, opts),
398
+ paneList: (params: { workspace_id?: string } = {}, opts?: HerdrClientOptions) =>
399
+ request<{ panes: PaneInfo[] }>("pane.list", params, opts),
400
+ paneClose: (pane_id: string, opts?: HerdrClientOptions) =>
401
+ request("pane.close", { pane_id }, opts),
402
+ // `source` is REQUIRED (client identity herdr uses to arbitrate authority).
403
+ paneReportAgent: (
404
+ params: {
405
+ pane_id: string;
406
+ source: string;
407
+ agent: string;
408
+ state: "idle" | "working" | "blocked" | "unknown";
409
+ message?: string;
410
+ custom_status?: string;
411
+ seq?: number;
412
+ agent_session_id?: string;
413
+ agent_session_path?: string;
414
+ },
415
+ opts?: HerdrClientOptions,
416
+ ) => request("pane.report_agent", params, opts),
417
+ paneReleaseAgent: (
418
+ params: { pane_id: string; source: string; agent: string; seq?: number },
419
+ opts?: HerdrClientOptions,
420
+ ) => request("pane.release_agent", params, opts),
421
+ // Metadata annotations for a pane whose agent authority is held by herdr's
422
+ // built-in detection (report_agent is silently ignored there — spike
423
+ // finding). What shows in the sidebar is `tokens` on herdr >= 0.7.4 and
424
+ // `custom_status` on <= 0.7.3; the field was REMOVED from the params in
425
+ // 0.7.4, so sending it there fails the whole request. herdr-presence.ts
426
+ // negotiates which one to send. ttl_ms lets stale annotations expire if the
427
+ // reporter dies.
428
+ paneReportMetadata: (
429
+ params: {
430
+ pane_id: string;
431
+ source: string;
432
+ agent?: string;
433
+ tokens?: Record<string, string>;
434
+ state_labels?: Record<string, string>;
435
+ custom_status?: string;
436
+ title?: string;
437
+ display_agent?: string;
438
+ ttl_ms?: number;
439
+ seq?: number;
440
+ },
441
+ opts?: HerdrClientOptions,
442
+ ) => request("pane.report_metadata", params, opts),
443
+
444
+ tabClose: (tab_id: string, opts?: HerdrClientOptions) =>
445
+ request("tab.close", { tab_id }, opts),
446
+
447
+ agentList: (opts?: HerdrClientOptions) =>
448
+ request<{ agents: Array<Record<string, unknown>> }>("agent.list", {}, opts),
449
+ agentRead: (
450
+ params: { target: string; source?: string; lines?: number },
451
+ opts?: HerdrClientOptions,
452
+ ) => request("agent.read", params, opts),
453
+
454
+ layoutApply: (
455
+ params: { workspace_id?: string; root: LayoutNode },
456
+ opts?: HerdrClientOptions,
457
+ ) =>
458
+ request<{ layout: { workspace_id: string; tab_id: string; root: unknown } }>(
459
+ "layout.apply",
460
+ params,
461
+ opts,
462
+ ),
463
+ layoutExport: (params: Record<string, unknown> = {}, opts?: HerdrClientOptions) =>
464
+ request<{ layout: Record<string, unknown> }>("layout.export", params, opts),
465
+
466
+ notificationShow: (
467
+ params: { title?: string; body?: string; [key: string]: unknown },
468
+ opts?: HerdrClientOptions,
469
+ ) => request("notification.show", params, opts),
470
+
471
+ subscribe,
472
+ };