@chankov/agent-fleet 2.1.0 → 2.1.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 (725) hide show
  1. package/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +9 -25
  2. package/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +31 -13
  3. package/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +2 -1
  4. package/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +70 -0
  5. package/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +9 -4
  6. package/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +22 -17
  7. package/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +2 -2
  8. package/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +1 -1
  9. package/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +30 -8
  10. package/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +4 -4
  11. package/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +3 -1
  12. package/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +1 -1
  13. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +3 -0
  14. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +3 -1
  15. package/.pi/harnesses/agent-hub/index.ts +30 -7
  16. package/.pi/harnesses/agent-hub/no-progress.ts +4 -4
  17. package/.pi/harnesses/agent-hub/package.json +1 -1
  18. package/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  19. package/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  20. package/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  21. package/.pi/harnesses/agent-hub/process-obligations.ts +21 -8
  22. package/.pi/harnesses/agent-hub/runtime-receipts.ts +3 -0
  23. package/.pi/harnesses/agent-hub/runtime-test-check.ts +8 -2
  24. package/.pi/harnesses/agent-hub/task-resume-contract.ts +5 -0
  25. package/.pi/harnesses/agent-hub/tools/action-executors.ts +4 -2
  26. package/.pi/harnesses/agent-hub/tools/context.ts +3 -1
  27. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +14 -12
  28. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +59 -16
  29. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +8 -2
  30. package/.pi/harnesses/coms/package.json +1 -1
  31. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  32. package/.pi/harnesses/lib/fleet-codex-event-bridge.ts +2 -1
  33. package/.pi/harnesses/lib/fleet-connection-control.ts +77 -0
  34. package/.pi/harnesses/lib/fleet-notification-validation.ts +66 -0
  35. package/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  36. package/.versions/2.1.1/.pi/agent-fleet/hermes/README.md +347 -0
  37. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  38. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  39. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  40. package/.versions/2.1.1/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  41. package/.versions/2.1.1/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  42. package/.versions/2.1.1/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  43. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  44. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  45. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  46. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  47. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  48. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  49. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  50. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  51. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  52. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  53. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  54. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  55. package/.versions/2.1.1/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  56. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  57. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  58. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  59. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  60. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  61. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  62. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  63. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  64. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  65. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  66. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  67. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  68. package/.versions/2.1.1/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  69. package/.versions/2.1.1/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  70. package/.versions/2.1.1/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  71. package/.versions/2.1.1/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  72. package/.versions/2.1.1/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  73. package/.versions/2.1.1/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  74. package/.versions/2.1.1/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  75. package/.versions/2.1.1/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  76. package/.versions/2.1.1/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  77. package/.versions/2.1.1/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  78. package/.versions/2.1.1/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +59 -0
  79. package/.versions/2.1.1/.pi/agent-fleet/scripts/fleet.ts +248 -0
  80. package/.versions/2.1.1/.pi/agent-fleet/scripts/flow.ts +166 -0
  81. package/.versions/2.1.1/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  82. package/.versions/2.1.1/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  83. package/.versions/2.1.1/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  84. package/.versions/2.1.1/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  85. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  86. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +106 -0
  87. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +91 -0
  88. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  89. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  90. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +367 -0
  91. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  92. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
  93. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  94. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +70 -0
  95. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
  96. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +116 -0
  97. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  98. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  99. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +173 -0
  100. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +406 -0
  101. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  102. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  103. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  104. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  105. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  106. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +23 -0
  107. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
  108. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  109. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  110. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  111. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/fleet-command.ts +268 -0
  112. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  113. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +238 -0
  114. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  115. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  116. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  117. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  118. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  119. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  120. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  121. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  122. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  123. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  124. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  125. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  126. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  127. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  128. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  129. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  130. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  131. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  132. package/.versions/2.1.1/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  133. package/.versions/2.1.1/.pi/agent-fleet/scripts/package-lock.json +57 -0
  134. package/.versions/2.1.1/.pi/agent-fleet/scripts/package.json +10 -0
  135. package/.versions/2.1.1/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  136. package/.versions/2.1.1/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  137. package/.versions/2.1.1/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  138. package/.versions/2.1.1/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  139. package/.versions/2.1.1/.pi/agent-fleet/scripts/team-up.ts +385 -0
  140. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  141. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  142. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  143. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  144. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  145. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  146. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/git.ts +99 -0
  147. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  148. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  149. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  150. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  151. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  152. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  153. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  154. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  155. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/quality.ts +65 -0
  156. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  157. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  158. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  159. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  160. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  161. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  162. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  163. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  164. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  165. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  166. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  167. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  168. package/.versions/2.1.1/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  169. package/.versions/2.1.1/.pi/agents/dispatch-policy.yaml +32 -0
  170. package/.versions/2.1.1/.pi/agents/model-profiles.yaml +134 -0
  171. package/.versions/2.1.1/.pi/agents/peers.yaml +147 -0
  172. package/.versions/2.1.1/.pi/agents/teams.yaml +41 -0
  173. package/.versions/2.1.1/.pi/agents/voices.yaml +13 -0
  174. package/.versions/2.1.1/.pi/damage-control-rules.yaml +297 -0
  175. package/.versions/2.1.1/.pi/extensions/btw/README.md +120 -0
  176. package/.versions/2.1.1/.pi/extensions/btw/index.ts +916 -0
  177. package/.versions/2.1.1/.pi/extensions/btw/package.json +6 -0
  178. package/.versions/2.1.1/.pi/extensions/btw/state.js +179 -0
  179. package/.versions/2.1.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  180. package/.versions/2.1.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  181. package/.versions/2.1.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  182. package/.versions/2.1.1/.pi/extensions/compact-and-continue/README.md +42 -0
  183. package/.versions/2.1.1/.pi/extensions/compact-and-continue/index.ts +136 -0
  184. package/.versions/2.1.1/.pi/extensions/compact-and-continue/package.json +6 -0
  185. package/.versions/2.1.1/.pi/extensions/mcp-bridge/README.md +46 -0
  186. package/.versions/2.1.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  187. package/.versions/2.1.1/.pi/extensions/mcp-bridge/package.json +6 -0
  188. package/.versions/2.1.1/.pi/extensions/package-lock.json +1175 -0
  189. package/.versions/2.1.1/.pi/extensions/package.json +9 -0
  190. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/README.md +224 -0
  191. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/config.ts +199 -0
  192. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  193. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  194. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  195. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  196. package/.versions/2.1.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  197. package/.versions/2.1.1/.pi/harnesses/agent-hub/README.md +1584 -0
  198. package/.versions/2.1.1/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  199. package/.versions/2.1.1/.pi/harnesses/agent-hub/access-approval.ts +266 -0
  200. package/.versions/2.1.1/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  201. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  202. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  203. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  204. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  205. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  206. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  207. package/.versions/2.1.1/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  208. package/.versions/2.1.1/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  209. package/.versions/2.1.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  210. package/.versions/2.1.1/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  211. package/.versions/2.1.1/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  212. package/.versions/2.1.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  213. package/.versions/2.1.1/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  214. package/.versions/2.1.1/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  215. package/.versions/2.1.1/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  216. package/.versions/2.1.1/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  217. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  218. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  219. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  220. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  221. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  222. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  223. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  224. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  225. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  226. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  227. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  228. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  229. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  230. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  231. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  232. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  233. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/context.ts +47 -0
  234. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  235. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  236. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  237. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  238. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  239. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  240. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  241. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  242. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  243. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  244. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  245. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  246. package/.versions/2.1.1/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  247. package/.versions/2.1.1/.pi/harnesses/agent-hub/config/agents.ts +181 -0
  248. package/.versions/2.1.1/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  249. package/.versions/2.1.1/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  250. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  251. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  252. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  253. package/.versions/2.1.1/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  254. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  255. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  256. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  257. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  258. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  259. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  260. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  261. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  262. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  263. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  264. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  265. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  266. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  267. package/.versions/2.1.1/.pi/harnesses/agent-hub/context-window.js +108 -0
  268. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  269. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  270. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  271. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  272. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  273. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  274. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  275. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  276. package/.versions/2.1.1/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  277. package/.versions/2.1.1/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  278. package/.versions/2.1.1/.pi/harnesses/agent-hub/delegate.ts +478 -0
  279. package/.versions/2.1.1/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  280. package/.versions/2.1.1/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  281. package/.versions/2.1.1/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  282. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  283. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  284. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  285. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +301 -0
  286. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +262 -0
  287. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  288. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  289. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  290. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  291. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  292. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  293. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  294. package/.versions/2.1.1/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  295. package/.versions/2.1.1/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  296. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  297. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  298. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  299. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  300. package/.versions/2.1.1/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  301. package/.versions/2.1.1/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  302. package/.versions/2.1.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  303. package/.versions/2.1.1/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  304. package/.versions/2.1.1/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  305. package/.versions/2.1.1/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  306. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  307. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  308. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  309. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  310. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  311. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  312. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  313. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  314. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  315. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  316. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  317. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  318. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  319. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  320. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  321. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  322. package/.versions/2.1.1/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  323. package/.versions/2.1.1/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  324. package/.versions/2.1.1/.pi/harnesses/agent-hub/fixtures/registration-surface.json +68 -0
  325. package/.versions/2.1.1/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  326. package/.versions/2.1.1/.pi/harnesses/agent-hub/footer.ts +30 -0
  327. package/.versions/2.1.1/.pi/harnesses/agent-hub/helpers.ts +270 -0
  328. package/.versions/2.1.1/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  329. package/.versions/2.1.1/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  330. package/.versions/2.1.1/.pi/harnesses/agent-hub/index.ts +2705 -0
  331. package/.versions/2.1.1/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  332. package/.versions/2.1.1/.pi/harnesses/agent-hub/input/shortcuts.ts +23 -0
  333. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  334. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  335. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +145 -0
  336. package/.versions/2.1.1/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  337. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  338. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  339. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  340. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  341. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  342. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  343. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  344. package/.versions/2.1.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  345. package/.versions/2.1.1/.pi/harnesses/agent-hub/no-progress.ts +622 -0
  346. package/.versions/2.1.1/.pi/harnesses/agent-hub/operator-current-state.ts +53 -0
  347. package/.versions/2.1.1/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  348. package/.versions/2.1.1/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  349. package/.versions/2.1.1/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  350. package/.versions/2.1.1/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  351. package/.versions/2.1.1/.pi/harnesses/agent-hub/package.json +7 -0
  352. package/.versions/2.1.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  353. package/.versions/2.1.1/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  354. package/.versions/2.1.1/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  355. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  356. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  357. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  358. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  359. package/.versions/2.1.1/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  360. package/.versions/2.1.1/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  361. package/.versions/2.1.1/.pi/harnesses/agent-hub/presentation.ts +54 -0
  362. package/.versions/2.1.1/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  363. package/.versions/2.1.1/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  364. package/.versions/2.1.1/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  365. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  366. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  367. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  368. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  369. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  370. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  371. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  372. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  373. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  374. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  375. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  376. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  377. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-snapshot.ts +279 -0
  378. package/.versions/2.1.1/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  379. package/.versions/2.1.1/.pi/harnesses/agent-hub/process-obligations.ts +177 -0
  380. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  381. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  382. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  383. package/.versions/2.1.1/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  384. package/.versions/2.1.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  385. package/.versions/2.1.1/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  386. package/.versions/2.1.1/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  387. package/.versions/2.1.1/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  388. package/.versions/2.1.1/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  389. package/.versions/2.1.1/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  390. package/.versions/2.1.1/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  391. package/.versions/2.1.1/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  392. package/.versions/2.1.1/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  393. package/.versions/2.1.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  394. package/.versions/2.1.1/.pi/harnesses/agent-hub/return-contract.js +371 -0
  395. package/.versions/2.1.1/.pi/harnesses/agent-hub/return-extract.js +77 -0
  396. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  397. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  398. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-findings.js +96 -0
  399. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  400. package/.versions/2.1.1/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  401. package/.versions/2.1.1/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  402. package/.versions/2.1.1/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  403. package/.versions/2.1.1/.pi/harnesses/agent-hub/run-budget.js +342 -0
  404. package/.versions/2.1.1/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  405. package/.versions/2.1.1/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
  406. package/.versions/2.1.1/.pi/harnesses/agent-hub/runtime-test-check.ts +85 -0
  407. package/.versions/2.1.1/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  408. package/.versions/2.1.1/.pi/harnesses/agent-hub/scope-gate.js +233 -0
  409. package/.versions/2.1.1/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  410. package/.versions/2.1.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  411. package/.versions/2.1.1/.pi/harnesses/agent-hub/session-start.ts +42 -0
  412. package/.versions/2.1.1/.pi/harnesses/agent-hub/spawn.ts +702 -0
  413. package/.versions/2.1.1/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  414. package/.versions/2.1.1/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  415. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  416. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  417. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  418. package/.versions/2.1.1/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  419. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  420. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-resume-contract.ts +80 -0
  421. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-authorization.ts +170 -0
  422. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  423. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  424. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  425. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  426. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  427. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  428. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  429. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  430. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  431. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  432. package/.versions/2.1.1/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  433. package/.versions/2.1.1/.pi/harnesses/agent-hub/timeline.ts +72 -0
  434. package/.versions/2.1.1/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  435. package/.versions/2.1.1/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  436. package/.versions/2.1.1/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  437. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/action-executors.ts +216 -0
  438. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  439. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  440. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  441. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/context.ts +147 -0
  442. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +92 -0
  443. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +777 -0
  444. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  445. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  446. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  447. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  448. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/run-flow.ts +146 -0
  449. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  450. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  451. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  452. package/.versions/2.1.1/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  453. package/.versions/2.1.1/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  454. package/.versions/2.1.1/.pi/harnesses/agent-hub/types.ts +66 -0
  455. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  456. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  457. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  458. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  459. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +163 -0
  460. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  461. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  462. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  463. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  464. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  465. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  466. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  467. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  468. package/.versions/2.1.1/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  469. package/.versions/2.1.1/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  470. package/.versions/2.1.1/.pi/harnesses/agent-hub/version.ts +42 -0
  471. package/.versions/2.1.1/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  472. package/.versions/2.1.1/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  473. package/.versions/2.1.1/.pi/harnesses/agent-hub/work-mode.ts +188 -0
  474. package/.versions/2.1.1/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  475. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/README.md +59 -0
  476. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/index.ts +571 -0
  477. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  478. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  479. package/.versions/2.1.1/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  480. package/.versions/2.1.1/.pi/harnesses/coms/README.md +105 -0
  481. package/.versions/2.1.1/.pi/harnesses/coms/index.ts +308 -0
  482. package/.versions/2.1.1/.pi/harnesses/coms/package.json +7 -0
  483. package/.versions/2.1.1/.pi/harnesses/coms/version.ts +42 -0
  484. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/README.md +161 -0
  485. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/index.ts +659 -0
  486. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  487. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  488. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  489. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  490. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  491. package/.versions/2.1.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  492. package/.versions/2.1.1/.pi/harnesses/lib/approval-wait.ts +17 -0
  493. package/.versions/2.1.1/.pi/harnesses/lib/bash-policy-analysis.ts +185 -0
  494. package/.versions/2.1.1/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  495. package/.versions/2.1.1/.pi/harnesses/lib/clarification-policy.ts +9 -0
  496. package/.versions/2.1.1/.pi/harnesses/lib/coms-core-io.ts +422 -0
  497. package/.versions/2.1.1/.pi/harnesses/lib/coms-core.ts +720 -0
  498. package/.versions/2.1.1/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  499. package/.versions/2.1.1/.pi/harnesses/lib/coms-observation.ts +74 -0
  500. package/.versions/2.1.1/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  501. package/.versions/2.1.1/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  502. package/.versions/2.1.1/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  503. package/.versions/2.1.1/.pi/harnesses/lib/context-budget-view.ts +112 -0
  504. package/.versions/2.1.1/.pi/harnesses/lib/context-budget.ts +114 -0
  505. package/.versions/2.1.1/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  506. package/.versions/2.1.1/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  507. package/.versions/2.1.1/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  508. package/.versions/2.1.1/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  509. package/.versions/2.1.1/.pi/harnesses/lib/damage-control-shared.ts +276 -0
  510. package/.versions/2.1.1/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  511. package/.versions/2.1.1/.pi/harnesses/lib/damage-policy.ts +35 -0
  512. package/.versions/2.1.1/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  513. package/.versions/2.1.1/.pi/harnesses/lib/damage-result-view.ts +16 -0
  514. package/.versions/2.1.1/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  515. package/.versions/2.1.1/.pi/harnesses/lib/exact-permission-port.ts +38 -0
  516. package/.versions/2.1.1/.pi/harnesses/lib/execution-trace.ts +45 -0
  517. package/.versions/2.1.1/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  518. package/.versions/2.1.1/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  519. package/.versions/2.1.1/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  520. package/.versions/2.1.1/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
  521. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  522. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  523. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  524. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  525. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  526. package/.versions/2.1.1/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  527. package/.versions/2.1.1/.pi/harnesses/lib/fleet-connection-control.ts +77 -0
  528. package/.versions/2.1.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  529. package/.versions/2.1.1/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  530. package/.versions/2.1.1/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  531. package/.versions/2.1.1/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  532. package/.versions/2.1.1/.pi/harnesses/lib/fleet-notification-validation.ts +66 -0
  533. package/.versions/2.1.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  534. package/.versions/2.1.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  535. package/.versions/2.1.1/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  536. package/.versions/2.1.1/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  537. package/.versions/2.1.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  538. package/.versions/2.1.1/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  539. package/.versions/2.1.1/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  540. package/.versions/2.1.1/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  541. package/.versions/2.1.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  542. package/.versions/2.1.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  543. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  544. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  545. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  546. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  547. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  548. package/.versions/2.1.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  549. package/.versions/2.1.1/.pi/harnesses/lib/identical-dialog.ts +27 -0
  550. package/.versions/2.1.1/.pi/harnesses/lib/installation-state.js +62 -0
  551. package/.versions/2.1.1/.pi/harnesses/lib/peer-target.ts +24 -0
  552. package/.versions/2.1.1/.pi/harnesses/lib/policy-roots.js +117 -0
  553. package/.versions/2.1.1/.pi/harnesses/lib/policy-roots.ts +32 -0
  554. package/.versions/2.1.1/.pi/harnesses/lib/process-shared.ts +9 -0
  555. package/.versions/2.1.1/.pi/harnesses/lib/resource-closure.js +26 -0
  556. package/.versions/2.1.1/.pi/harnesses/lib/safe-source-read.js +29 -0
  557. package/.versions/2.1.1/.pi/harnesses/lib/semantic-approval.ts +80 -0
  558. package/.versions/2.1.1/.pi/harnesses/lib/session-target.ts +62 -0
  559. package/.versions/2.1.1/.pi/harnesses/lib/spawned-peers.js +191 -0
  560. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  561. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  562. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  563. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  564. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-json.js +37 -0
  565. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-loader.js +53 -0
  566. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  567. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-triage.js +42 -0
  568. package/.versions/2.1.1/.pi/harnesses/lib/system1/config-v2.js +112 -0
  569. package/.versions/2.1.1/.pi/harnesses/lib/system1/config.js +50 -0
  570. package/.versions/2.1.1/.pi/harnesses/lib/system1/contracts.ts +154 -0
  571. package/.versions/2.1.1/.pi/harnesses/lib/system1/demo.ts +95 -0
  572. package/.versions/2.1.1/.pi/harnesses/lib/system1/jev.ts +503 -0
  573. package/.versions/2.1.1/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  574. package/.versions/2.1.1/.pi/harnesses/lib/system1/selection.js +11 -0
  575. package/.versions/2.1.1/.pi/harnesses/lib/system1/service.ts +245 -0
  576. package/.versions/2.1.1/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  577. package/.versions/2.1.1/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  578. package/.versions/2.1.1/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  579. package/.versions/2.1.1/.pi/harnesses/lib/target-capabilities.js +7 -0
  580. package/.versions/2.1.1/.pi/harnesses/lib/update-check.ts +227 -0
  581. package/.versions/2.1.1/.pi/harnesses/lib/workspace-context.js +115 -0
  582. package/.versions/2.1.1/.pi/harnesses/lib/workspace-context.ts +22 -0
  583. package/.versions/2.1.1/.pi/harnesses/package-lock.json +2121 -0
  584. package/.versions/2.1.1/.pi/harnesses/package.json +13 -0
  585. package/.versions/2.1.1/.pi/prompts/af-build.md +27 -0
  586. package/.versions/2.1.1/.pi/prompts/af-code-simplify.md +22 -0
  587. package/.versions/2.1.1/.pi/prompts/af-constraints.md +31 -0
  588. package/.versions/2.1.1/.pi/prompts/af-plan.md +17 -0
  589. package/.versions/2.1.1/.pi/prompts/af-review.md +16 -0
  590. package/.versions/2.1.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  591. package/.versions/2.1.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  592. package/.versions/2.1.1/.pi/prompts/af-setup-rules.md +20 -0
  593. package/.versions/2.1.1/.pi/prompts/af-ship.md +17 -0
  594. package/.versions/2.1.1/.pi/prompts/af-spec.md +15 -0
  595. package/.versions/2.1.1/.pi/prompts/af-test.md +19 -0
  596. package/.versions/2.1.1/.pi/skills/bowser/SKILL.md +145 -0
  597. package/.versions/2.1.1/.version +1 -0
  598. package/.versions/2.1.1/agents/architect.md +24 -0
  599. package/.versions/2.1.1/agents/bowser.md +28 -0
  600. package/.versions/2.1.1/agents/builder.md +55 -0
  601. package/.versions/2.1.1/agents/code-reviewer.md +209 -0
  602. package/.versions/2.1.1/agents/deep-researcher.md +32 -0
  603. package/.versions/2.1.1/agents/documenter.md +22 -0
  604. package/.versions/2.1.1/agents/orchestrator.md +22 -0
  605. package/.versions/2.1.1/agents/plan-reviewer.md +83 -0
  606. package/.versions/2.1.1/agents/planner.md +107 -0
  607. package/.versions/2.1.1/agents/releaser.md +24 -0
  608. package/.versions/2.1.1/agents/researcher.md +30 -0
  609. package/.versions/2.1.1/agents/security-auditor.md +167 -0
  610. package/.versions/2.1.1/agents/test-engineer.md +153 -0
  611. package/.versions/2.1.1/agents/web-debugger.md +44 -0
  612. package/.versions/2.1.1/agents/web-performance-auditor.md +194 -0
  613. package/.versions/2.1.1/bin/catalog/harness-runtime-closure.json +85 -0
  614. package/.versions/2.1.1/docs/ARCHITECTURE.md +1187 -0
  615. package/.versions/2.1.1/docs/agent-fleet-setup.md +1143 -0
  616. package/.versions/2.1.1/docs/claude-code-coms-bridge.md +147 -0
  617. package/.versions/2.1.1/docs/codex-local-mcp.md +487 -0
  618. package/.versions/2.1.1/docs/codex-session-bridge.md +44 -0
  619. package/.versions/2.1.1/docs/codex-setup.md +183 -0
  620. package/.versions/2.1.1/docs/coms-hermes-bridge.md +188 -0
  621. package/.versions/2.1.1/docs/fleet-native-voice.md +137 -0
  622. package/.versions/2.1.1/docs/getting-started.md +126 -0
  623. package/.versions/2.1.1/docs/npm-install.md +535 -0
  624. package/.versions/2.1.1/docs/pi-extensions.md +455 -0
  625. package/.versions/2.1.1/docs/pi-setup.md +92 -0
  626. package/.versions/2.1.1/docs/skill-anatomy.md +150 -0
  627. package/.versions/2.1.1/install-manifest.json +3239 -0
  628. package/.versions/2.1.1/justfile +247 -0
  629. package/.versions/2.1.1/manifest-meta.json +1087 -0
  630. package/.versions/2.1.1/references/accessibility-checklist.md +160 -0
  631. package/.versions/2.1.1/references/communication-contract.md +26 -0
  632. package/.versions/2.1.1/references/definition-of-done.md +67 -0
  633. package/.versions/2.1.1/references/fleet-coordination-patterns.md +171 -0
  634. package/.versions/2.1.1/references/observability-checklist.md +92 -0
  635. package/.versions/2.1.1/references/orchestration-patterns.md +370 -0
  636. package/.versions/2.1.1/references/performance-checklist.md +236 -0
  637. package/.versions/2.1.1/references/prompting-patterns.md +380 -0
  638. package/.versions/2.1.1/references/security-checklist.md +245 -0
  639. package/.versions/2.1.1/references/testing-patterns.md +235 -0
  640. package/.versions/2.1.1/references/workflow-authoring.md +304 -0
  641. package/.versions/2.1.1/skills/_internal/grilling.md +59 -0
  642. package/.versions/2.1.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  643. package/.versions/2.1.1/skills/code-review-and-quality/SKILL.md +396 -0
  644. package/.versions/2.1.1/skills/compound-learning/SKILL.md +137 -0
  645. package/.versions/2.1.1/skills/constraint-driven-development/SKILL.md +338 -0
  646. package/.versions/2.1.1/skills/constraint-driven-development/references/floor-guard.md +99 -0
  647. package/.versions/2.1.1/skills/context-engineering/SKILL.md +341 -0
  648. package/.versions/2.1.1/skills/deprecation-and-migration/SKILL.md +247 -0
  649. package/.versions/2.1.1/skills/designing-agents/SKILL.md +394 -0
  650. package/.versions/2.1.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  651. package/.versions/2.1.1/skills/drafting-workflows/SKILL.md +143 -0
  652. package/.versions/2.1.1/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  653. package/.versions/2.1.1/skills/fleet-connect/SKILL.md +25 -0
  654. package/.versions/2.1.1/skills/fleet-native-voice/SKILL.md +79 -0
  655. package/.versions/2.1.1/skills/fleet-native-voice/agents/openai.yaml +4 -0
  656. package/.versions/2.1.1/skills/fleet-native-voice.zip +0 -0
  657. package/.versions/2.1.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  658. package/.versions/2.1.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  659. package/.versions/2.1.1/skills/idea-refine/SKILL.md +182 -0
  660. package/.versions/2.1.1/skills/idea-refine/examples.md +238 -0
  661. package/.versions/2.1.1/skills/idea-refine/frameworks.md +99 -0
  662. package/.versions/2.1.1/skills/idea-refine/refinement-criteria.md +113 -0
  663. package/.versions/2.1.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  664. package/.versions/2.1.1/skills/incremental-implementation/SKILL.md +353 -0
  665. package/.versions/2.1.1/skills/incremental-implementation.zip +0 -0
  666. package/.versions/2.1.1/skills/interview-me/SKILL.md +226 -0
  667. package/.versions/2.1.1/skills/orchestration-verification/SKILL.md +182 -0
  668. package/.versions/2.1.1/skills/peer-coms/SKILL.md +90 -0
  669. package/.versions/2.1.1/skills/performance-optimization/SKILL.md +496 -0
  670. package/.versions/2.1.1/skills/planning-and-task-breakdown/SKILL.md +318 -0
  671. package/.versions/2.1.1/skills/planning-and-task-breakdown.zip +0 -0
  672. package/.versions/2.1.1/skills/repository-ai-setup/SKILL.md +135 -0
  673. package/.versions/2.1.1/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  674. package/.versions/2.1.1/skills/repository-ai-setup/references/apply-contract.md +74 -0
  675. package/.versions/2.1.1/skills/repository-ai-setup/references/provenance-template.md +16 -0
  676. package/.versions/2.1.1/skills/repository-ai-setup/references/setup-flow.md +108 -0
  677. package/.versions/2.1.1/skills/repository-ai-setup/references/verify-setup.md +20 -0
  678. package/.versions/2.1.1/skills/repository-ai-setup.zip +0 -0
  679. package/.versions/2.1.1/skills/security-and-hardening/SKILL.md +524 -0
  680. package/.versions/2.1.1/skills/spec-driven-development/SKILL.md +295 -0
  681. package/.versions/2.1.1/skills/spec-driven-development.zip +0 -0
  682. package/.versions/2.1.1/skills/using-agent-skills/SKILL.md +198 -0
  683. package/.versions/2.1.1/vendor/agent-skills-upstream/LICENSE +21 -0
  684. package/.versions/2.1.1/vendor/agent-skills-upstream/README.md +430 -0
  685. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  686. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  687. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  688. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  689. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  690. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  691. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  692. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  693. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  694. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  695. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  696. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  697. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  698. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  699. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  700. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  701. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  702. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  703. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  704. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  705. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  706. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  707. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  708. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  709. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  710. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  711. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  712. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  713. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  714. package/.versions/2.1.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  715. package/CHANGELOG.md +10 -0
  716. package/docs/ARCHITECTURE.md +30 -1
  717. package/docs/codex-local-mcp.md +55 -2
  718. package/docs/codex-session-bridge.md +2 -2
  719. package/docs/codex-setup.md +1 -1
  720. package/docs/fleet-native-voice.md +9 -7
  721. package/install-manifest.json +24 -1
  722. package/manifest-meta.json +1 -0
  723. package/package.json +1 -1
  724. package/skills/fleet-connect/SKILL.md +25 -0
  725. package/skills/fleet-native-voice.zip +0 -0
@@ -0,0 +1,163 @@
1
+ import * as crypto from "node:crypto";
2
+ import * as fs from "node:fs";
3
+ import * as net from "node:net";
4
+ import * as path from "node:path";
5
+
6
+ import type { MonitorRegistration } from "./hermes-monitor-registry.ts";
7
+
8
+ export const MAX_SOCKET_FRAME_BYTES = 64 * 1024;
9
+ export const MAX_SNAPSHOT_BYTES = 256 * 1024;
10
+ export const MAX_CANCEL_RESPONSE_BYTES = 16 * 1024;
11
+ export const PARTIAL_FRAME_TIMEOUT_MS = 1000;
12
+ export const MAX_SOCKET_CONNECTIONS = 32;
13
+ export const MAX_TASK_ID_LENGTH = 128;
14
+ export const MAX_AFTER_SEQUENCE = 1_000_000_000;
15
+ /** 2 MiB covers the 256 KiB retained UTF-8 output after worst-case JSON escaping plus its envelope. */
16
+ export const MAX_OUTPUT_RESPONSE_BYTES = 2 * 1024 * 1024;
17
+ export const MAX_EVENT_WAITERS = 8;
18
+ export const MAX_EVENT_WAIT_MS = 25_000;
19
+
20
+ interface SnapshotRequest {
21
+ type: "snapshot";
22
+ token: string;
23
+ }
24
+
25
+ function authorized(actual: string, expected: string): boolean {
26
+ const actualBytes = Buffer.from(actual);
27
+ const expectedBytes = Buffer.from(expected);
28
+ return actualBytes.length === expectedBytes.length && crypto.timingSafeEqual(actualBytes, expectedBytes);
29
+ }
30
+
31
+ function validTaskRequest(taskId: unknown, generation: unknown, afterSequence?: unknown): boolean { return typeof taskId === "string" && /^[A-Za-z0-9][A-Za-z0-9._:-]*$/.test(taskId) && taskId.length <= MAX_TASK_ID_LENGTH && Number.isInteger(generation) && (generation as number) >= 1 && (afterSequence === undefined || (Number.isInteger(afterSequence) && (afterSequence as number) >= 0 && (afterSequence as number) <= MAX_AFTER_SEQUENCE)); }
32
+
33
+ function parseRequest(frame: string): SnapshotRequest | null {
34
+ try {
35
+ const value = JSON.parse(frame) as Partial<SnapshotRequest>;
36
+ if (value.type !== "snapshot" || typeof value.token !== "string") return null;
37
+ return { type: "snapshot", token: value.token };
38
+ } catch {
39
+ return null;
40
+ }
41
+ }
42
+
43
+ export class MonitorSocketServer {
44
+ private readonly registration: MonitorRegistration;
45
+ private readonly server: net.Server;
46
+ private connections = 0;
47
+ private eventWaiters = 0;
48
+ private readonly sockets = new Set<net.Socket>();
49
+
50
+ constructor(registration: MonitorRegistration) {
51
+ this.registration = registration;
52
+ // Consumers are documented to half-close after writing their single frame.
53
+ // Without allowHalfOpen the runtime would end our writable side on that FIN,
54
+ // silently dropping any response that settles later than the current turn —
55
+ // every long-poll `events` reply, and any cancel that waits on a real exit.
56
+ this.server = net.createServer({ allowHalfOpen: true }, (socket) => {
57
+ if (this.connections >= MAX_SOCKET_CONNECTIONS) { socket.destroy(); return; }
58
+ this.connections += 1;
59
+ this.sockets.add(socket);
60
+ socket.once("close", () => { this.connections -= 1; this.sockets.delete(socket); });
61
+ this.handle(socket);
62
+ });
63
+ }
64
+
65
+ private assertOwnedSocketPath(): void {
66
+ if (!this.registration.socketDir || path.resolve(this.registration.socketPath) !== path.join(path.resolve(this.registration.socketDir), "s")) throw new Error("monitor socket path is not registry-owned");
67
+ if (fs.lstatSync(this.registration.socketDir).isSymbolicLink() || (fs.statSync(this.registration.socketDir).mode & 0o777) !== 0o700) throw new Error("monitor socket directory is unsafe");
68
+ }
69
+ private async removeVerifiedStaleSocket(): Promise<void> {
70
+ this.assertOwnedSocketPath(); if (!fs.existsSync(this.registration.socketPath)) return;
71
+ const active=await new Promise<boolean>(resolve=>{const probe=net.createConnection(this.registration.socketPath);probe.once("connect",()=>{probe.destroy();resolve(true);});probe.once("error",()=>resolve(false));});
72
+ if (active) throw new Error("monitor socket is already active");
73
+ if (fs.lstatSync(this.registration.socketPath).isSymbolicLink()) throw new Error("monitor socket must not be a symlink"); fs.unlinkSync(this.registration.socketPath);
74
+ }
75
+ async listen(): Promise<void> {
76
+ await this.removeVerifiedStaleSocket(); return new Promise((resolve, reject) => { this.server.once("error", reject); this.server.listen(this.registration.socketPath, () => { this.server.off("error", reject); fs.chmodSync(this.registration.socketPath, 0o600); resolve(); }); });
77
+ }
78
+
79
+ async close(): Promise<void> {
80
+ for (const socket of this.sockets) socket.destroy();
81
+ await new Promise<void>((resolve, reject) => this.server.close((error) => error ? reject(error) : resolve()));
82
+ this.assertOwnedSocketPath(); try { fs.unlinkSync(this.registration.socketPath); } catch (error: any) { if (error?.code !== "ENOENT") throw error; }
83
+ }
84
+
85
+ mode(): number {
86
+ return fs.statSync(this.registration.socketPath).mode & 0o777;
87
+ }
88
+
89
+ private handle(socket: net.Socket): void {
90
+ // A long-poll callback may settle after its peer disconnects. Keep that
91
+ // late write local to this connection instead of emitting an unhandled error.
92
+ socket.on("error", () => {});
93
+ let buffer = "";
94
+ let handled = false;
95
+ const deadline = setTimeout(() => { if (!handled) socket.destroy(); }, PARTIAL_FRAME_TIMEOUT_MS);
96
+ socket.on("data", (chunk) => {
97
+ if (handled) return;
98
+ buffer += chunk.toString("utf8");
99
+ if (Buffer.byteLength(buffer, "utf8") > MAX_SOCKET_FRAME_BYTES) {
100
+ socket.destroy();
101
+ return;
102
+ }
103
+ const newline = buffer.indexOf("\n");
104
+ if (newline < 0) return;
105
+ handled = true;
106
+ const request = parseRequest(buffer.slice(0, newline));
107
+ clearTimeout(deadline);
108
+ let value: { type?: string; token?: string; taskId?: string; generation?: number };
109
+ try { value = JSON.parse(buffer.slice(0, newline)) as typeof value; } catch { socket.destroy(); return; }
110
+ if (value.type === "events") {
111
+ if (!authorized(String(value.token ?? ""), this.registration.token)) { socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n"); return; }
112
+ const afterSequence=(value as any).afterSequence, limit=(value as any).limit, waitMs=(value as any).waitMs;
113
+ if (!this.registration.events || !Number.isInteger(afterSequence) || afterSequence < 0 || afterSequence > MAX_AFTER_SEQUENCE || !Number.isInteger(limit) || limit < 1 || limit > 100 || !Number.isInteger(waitMs) || waitMs < 0 || waitMs > MAX_EVENT_WAIT_MS) { socket.destroy(); return; }
114
+ if (waitMs > 0 && this.eventWaiters >= MAX_EVENT_WAITERS) { socket.end(JSON.stringify({ ok: false, error: "too_many_waiters" }) + "\n"); return; }
115
+ let waiterReleased = false;
116
+ const releaseWaiter = () => {
117
+ if (waitMs > 0 && !waiterReleased) { waiterReleased = true; this.eventWaiters--; }
118
+ };
119
+ const abort = new AbortController();
120
+ if (waitMs > 0) {
121
+ this.eventWaiters++;
122
+ // Release on FIN as well as close: with allowHalfOpen a gone peer is
123
+ // otherwise indistinguishable from a live one, and a parked waiter
124
+ // would hold a slot for the full wait window. A client that wants to
125
+ // park on a long poll keeps its write side open (as the watcher does);
126
+ // one that half-closes gets an immediate bounded reply instead.
127
+ const release = () => { abort.abort(); releaseWaiter(); };
128
+ socket.once("close", release);
129
+ socket.once("end", release);
130
+ }
131
+ Promise.resolve().then(()=>this.registration.events!({afterSequence,limit,waitMs,signal:abort.signal})).then((events:any)=>{
132
+ if (events?.error === "cursor_too_old") socket.end(JSON.stringify({ ok: false, error: "cursor_too_old", snapshotRequired: true, firstAvailableSequence: events.firstAvailableSequence, latestSequence: events.latestSequence }) + "\n");
133
+ else socket.end(JSON.stringify({ok:true,events})+"\n");
134
+ }).catch(()=>socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n")).finally(releaseWaiter); return;
135
+ }
136
+ if (value.type === "invoke") {
137
+ if (!authorized(String(value.token ?? ""), this.registration.token)) { socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n"); return; }
138
+ if (!this.registration.invoke) { socket.end(JSON.stringify({ ok: false, error: "unsupported" }) + "\n"); return; }
139
+ const request={...(value as any)}; delete (request as any).token; delete (request as any).type;
140
+ Promise.resolve().then(()=>this.registration.invoke!(request)).then(result=>socket.end(JSON.stringify({ok:true,result})+"\n")).catch(()=>socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n")); return;
141
+ }
142
+ if (value.type === "output") {
143
+ if (!authorized(String(value.token ?? ""), this.registration.token)) { socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n"); return; }
144
+ if (!this.registration.output || (value as any).afterSequence === undefined || !validTaskRequest(value.taskId, value.generation, (value as any).afterSequence)) { socket.destroy(); return; }
145
+ Promise.resolve().then(()=>this.registration.output!({ taskId: value.taskId!, generation: value.generation!, afterSequence: (value as any).afterSequence })).then((output) => { const body=JSON.stringify({ ok:true, output }); if(Buffer.byteLength(body)>MAX_OUTPUT_RESPONSE_BYTES) socket.end(JSON.stringify({ok:false,error:"response_too_large"})+"\n"); else socket.end(body+"\n"); }).catch(()=>socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n")); return;
146
+ }
147
+ if (value.type === "cancel") {
148
+ if (!authorized(String(value.token ?? ""), this.registration.token)) { socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n"); return; }
149
+ if (!this.registration.cancel || !validTaskRequest(value.taskId, value.generation)) { socket.destroy(); return; }
150
+ Promise.resolve().then(()=>this.registration.cancel!({ taskId: value.taskId!, generation: value.generation! })).then((result) => { const body=JSON.stringify({ ok: true, result }); if (Buffer.byteLength(body, "utf8") > MAX_CANCEL_RESPONSE_BYTES) socket.end(JSON.stringify({ok:false,error:"response_too_large"})+"\n"); else socket.end(body + "\n"); }).catch(()=>socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n")); return;
151
+ }
152
+ if (!request || !authorized(request.token, this.registration.token)) {
153
+ if (request) socket.end(JSON.stringify({ ok: false, error: "unauthorized" }) + "\n");
154
+ else socket.destroy();
155
+ return;
156
+ }
157
+ try { const response = JSON.stringify({ ok: true, snapshot: this.registration.snapshot() }); if (Buffer.byteLength(response, "utf8") > MAX_SNAPSHOT_BYTES) socket.end(JSON.stringify({ok:false,error:"response_too_large"})+"\n"); else socket.end(response + "\n"); } catch { socket.end(JSON.stringify({ok:false,error:"monitor_unavailable"})+"\n"); }
158
+ });
159
+ socket.on("end", () => {
160
+ if (!handled) socket.destroy();
161
+ });
162
+ }
163
+ }
@@ -0,0 +1,31 @@
1
+ import { createChildTask, createParentTask, type CreateChildTaskInput, type CreateParentTaskInput, type MonitorTask } from "./hermes-monitor-model.ts";
2
+ export const MAX_OUTPUT_BYTES=256*1024;
3
+ export const MONITOR_RETENTION_MS=7*24*60*60*1000;
4
+ export const MONITOR_RETENTION_MAX=200;
5
+ const terminal=new Set(["completed","blocked","failed","cancelled","orphaned","done"]);
6
+ const active=(state:string)=>state==="starting"||state==="running"||state==="cancelling"||state==="recovering";
7
+ export function pruneMonitorTasks<T extends {state:string;updatedAt?:string}>(options:{now:Date;tasks:T[]}):T[]{const cutoff=options.now.getTime()-MONITOR_RETENTION_MS;const running=options.tasks.filter(t=>active(t.state));const terminalTasks=options.tasks.filter(t=>!active(t.state)&&(!t.updatedAt||new Date(t.updatedAt).getTime()>=cutoff)).sort((a,b)=>new Date(a.updatedAt??0).getTime()-new Date(b.updatedAt??0).getTime()).slice(-MONITOR_RETENTION_MAX);return [...running,...terminalTasks];}
8
+ export interface MonitorOutput{text:string;sequence:number;firstSequence:number;truncated:boolean}
9
+ interface StoredOutput{chunks:{sequence:number;text:string}[];sequence:number;truncated:boolean}
10
+ interface StoredTask{task:MonitorTask;output:StoredOutput;createdAt:string;updatedAt:string}
11
+ function suffix(text:string,limit:number){let bytes=0;const chars:string[]=[];for(const char of Array.from(text).reverse()){const size=Buffer.byteLength(char);if(bytes+size>limit)break;chars.push(char);bytes+=size;}return chars.reverse().join("");}
12
+
13
+ export class MonitorStore {
14
+ private readonly tasks=new Map<string,StoredTask>(); private readonly now:()=>Date;
15
+ constructor(options:{now?:()=>Date}={}){this.now=options.now??(()=>new Date());}
16
+ private key(id:string,generation:number){return `${id}:${generation}`;} private stamp(){return this.now().toISOString();}
17
+ createParent(input:CreateParentTaskInput){return this.add(createParentTask(input));}
18
+ createChild(input:CreateChildTaskInput){if(![...this.tasks.values()].some(s=>s.task.id===input.parentId&&s.task.generation===input.parentGeneration&&s.task.kind==="parent"))throw new Error(`parent task ${input.parentId} was not found`);return this.add(createChildTask(input));}
19
+ patch(id:string,generation:number,values:any){const stored=this.require(id,generation);Object.assign(stored.task,values);stored.updatedAt=this.stamp();return stored.task;}
20
+ transition(id:string,generation:number,state:any){const stored=this.require(id,generation);if(terminal.has(stored.task.state))throw new Error("terminal transition");stored.task.state=state;stored.updatedAt=this.stamp();return stored.task;}
21
+ get(id:string,generation?:number){return generation===undefined?[...this.tasks.values()].find(s=>s.task.id===id)?.task:this.tasks.get(this.key(id,generation))?.task;}
22
+ appendPublicOutput(id:string,generation:number,text:string){const stored=this.require(id,generation);if(terminal.has(stored.task.state))throw new Error("terminal output");const sequence=stored.output.sequence+1, chunk=suffix(text,MAX_OUTPUT_BYTES),chunks=[...stored.output.chunks,{sequence,text:chunk}];let bytes=chunks.reduce((n,c)=>n+Buffer.byteLength(c.text),0),truncated=stored.output.truncated||bytes<Buffer.byteLength(text);while(bytes>MAX_OUTPUT_BYTES&&chunks.length>1){bytes-=Buffer.byteLength(chunks.shift()!.text);truncated=true;}stored.output={chunks,sequence,truncated};stored.updatedAt=this.stamp();return this.outputAfter(stored.output,0);}
23
+ readOutput(id:string,generation:number,afterSequence:number){return this.outputAfter(this.require(id,generation).output,afterSequence);}
24
+ snapshot(){return {tasks:[...this.tasks.values()].map(s=>this.publicTask(s))};} durableSnapshot(){return{tasks:[...this.tasks.values()].map(s=>({...this.publicTask(s),outputChunks:s.output.chunks.map(c=>({...c}),),outputLatestSequence:s.output.sequence,outputFirstSequence:s.output.chunks[0]?.sequence??0,outputTruncated:s.output.truncated}))};} restore(rows:any[]){for(const row of rows){const key=this.key(row.id,row.generation);if(this.tasks.has(key))continue;const output=row.output??"";this.tasks.set(key,{task:{...row},output:{chunks:Array.isArray(row.outputChunks)?row.outputChunks.map((c:any)=>({sequence:c.sequence,text:c.text})):output?[{sequence:row.outputSequence??1,text:output}]:[],sequence:row.outputLatestSequence??row.outputSequence??0,truncated:row.outputTruncated??!!row.truncated},createdAt:row.createdAt??this.stamp(),updatedAt:row.updatedAt??this.stamp()});}}
25
+ prune(now=this.now()){const cutoff=now.getTime()-MONITOR_RETENTION_MS;const values=[...this.tasks.values()];const protectedIds=new Set<string>();for(const s of values)if(active(s.task.state)){protectedIds.add(this.key(s.task.id,s.task.generation));if(s.task.parentId)for(const p of values)if(p.task.id===s.task.parentId)protectedIds.add(this.key(p.task.id,p.task.generation));for(const c of values)if(c.task.parentId===s.task.id)protectedIds.add(this.key(c.task.id,c.task.generation));}const candidates=values.filter(s=>!active(s.task.state)&&!protectedIds.has(this.key(s.task.id,s.task.generation))).sort((a,b)=>Date.parse(a.updatedAt)-Date.parse(b.updatedAt));const expired=candidates.filter(s=>Date.parse(s.updatedAt)<cutoff);for(const s of expired)this.tasks.delete(this.key(s.task.id,s.task.generation));const remaining=[...this.tasks.values()].filter(s=>!active(s.task.state)&&!protectedIds.has(this.key(s.task.id,s.task.generation))).sort((a,b)=>Date.parse(a.updatedAt)-Date.parse(b.updatedAt));while(remaining.length>MONITOR_RETENTION_MAX){const oldest=remaining.shift()!;this.tasks.delete(this.key(oldest.task.id,oldest.task.generation));}return this.snapshot();}
26
+ private add(task:MonitorTask){const key=this.key(task.id,task.generation);if(this.tasks.has(key))throw new Error(`task ${task.id} generation ${task.generation} already exists`);const stamp=this.stamp();this.tasks.set(key,{task,output:{chunks:[],sequence:0,truncated:false},createdAt:stamp,updatedAt:stamp});return task;}
27
+ private publicTask(s:StoredTask){const output=this.outputAfter(s.output,0);return {...s.task,createdAt:s.createdAt,updatedAt:s.updatedAt,outputSequence:output.sequence,firstSequence:output.firstSequence,truncated:output.truncated};}
28
+ private outputAfter(output:StoredOutput,after:number):MonitorOutput{return{text:output.chunks.filter(c=>c.sequence>after).map(c=>c.text).join(""),sequence:output.sequence,firstSequence:output.chunks[0]?.sequence??0,truncated:output.truncated};}
29
+ private require(id:string,generation:number){const stored=this.tasks.get(this.key(id,generation));if(!stored)throw new Error(`task ${id} generation ${generation} was not found`);return stored;}
30
+ }
31
+ export function createMonitorStore(options:{now:()=>Date}){const store=new MonitorStore(options);const baseSnapshot=store.snapshot.bind(store);return Object.assign(store,{snapshot(){const all=(baseSnapshot() as any).tasks;return{tasks:all.filter((t:any)=>t.kind==='parent').map((parent:any)=>({id:parent.id,generation:parent.generation,children:all.filter((child:any)=>child.parentId===parent.id).map((child:any)=>({id:child.id,generation:child.generation,state:child.state,workspaceId:child.workspaceId,hubPaneId:child.hubPaneId,outputSequence:child.outputSequence,updatedAt:child.updatedAt}))}))};}});}
@@ -0,0 +1,27 @@
1
+ import {createHash} from 'node:crypto';
2
+ import {processShared} from './process-shared.ts';
3
+
4
+ export type DialogDecision='allow'|'deny';
5
+ export type DialogOutcome=DialogDecision|'cancel';
6
+ interface DialogState { remembered:Map<string,DialogDecision>; inflight:Map<string,Promise<DialogOutcome>>; generation:number; }
7
+ const state=processShared<DialogState>('agent-fleet.identical-dialog.v1',()=>({remembered:new Map(),inflight:new Map(),generation:0}));
8
+ const {remembered,inflight}=state;
9
+
10
+ /** Stable identity of the human-visible dialog. Callers must omit volatile ids. */
11
+ export function identicalDialogKey(parts:readonly unknown[]):string {
12
+ return createHash('sha256').update(JSON.stringify(parts)).digest('hex');
13
+ }
14
+ export function resetIdenticalDialogs():void {
15
+ state.generation++;remembered.clear();inflight.clear();
16
+ }
17
+ /** A completed identical dialog is not shown again. Cancellation is not a decision. Fresh dialogs ignore memory but still coalesce. */
18
+ export function decideIdenticalDialog(key:string,ask:()=>Promise<DialogOutcome>,options?:{fresh?:boolean}):Promise<DialogOutcome> {
19
+ if(!options?.fresh){const prior=remembered.get(key);if(prior)return Promise.resolve(prior);}
20
+ const flight=options?.fresh?`${key}:fresh`:key,existing=inflight.get(flight);if(existing)return existing;
21
+ const generation=state.generation;
22
+ const pending=(async()=>{const decision=await ask();if(generation!==state.generation)return 'cancel' as const;if(!options?.fresh&&decision!=='cancel')remembered.set(key,decision);return decision;})();
23
+ inflight.set(flight,pending);
24
+ const cleanup=()=>{if(inflight.get(flight)===pending)inflight.delete(flight);};
25
+ void pending.then(cleanup,cleanup);
26
+ return pending;
27
+ }
@@ -0,0 +1,62 @@
1
+ // Workspace-local installation evidence, shared by the CLI and runtime.
2
+ // @ts-nocheck
3
+ import { lstatSync, realpathSync } from 'node:fs';
4
+ import { join } from 'node:path';
5
+ import { safeSourceRead } from './safe-source-read.js';
6
+
7
+ export const INSTALLATION_STATE_MAX_BYTES = 1024 * 1024;
8
+ export const INVALID_DESIRED_MESSAGE = '.ai/agent-fleet.json is not a JSON object; fix or remove that human configuration file. Installation state was not read.';
9
+ export const RETIRED_INSTALLATION_OWNER_MESSAGE = 'installationOwner is no longer supported; use a standalone installation in the workspace (for multiple repositories, install at their common parent). No state is redirected or migrated automatically.';
10
+ export function rejectInstallationOwner(config) {
11
+ if (config && Object.hasOwn(config, 'installationOwner')) throw Error(RETIRED_INSTALLATION_OWNER_MESSAGE);
12
+ }
13
+ function present(path) {
14
+ try { lstatSync(path); return true; } catch (error) { if (error.code === 'ENOENT') return false; throw error; }
15
+ }
16
+ function desired(root) {
17
+ const path = join(root, '.ai/agent-fleet.json');
18
+ if (!present(path)) return null;
19
+ const bytes = safeSourceRead(root, path, 64 * 1024);
20
+ let value;
21
+ // The human configuration, not the installation evidence, is broken here.
22
+ try { value = JSON.parse(bytes.toString('utf8')); } catch { throw Error('invalid_desired'); }
23
+ if (!value || typeof value !== 'object' || Array.isArray(value)) throw Error('invalid_desired');
24
+ rejectInstallationOwner(value);
25
+ return value;
26
+ }
27
+ /** Read afresh at each boundary. Invalid evidence never returns a state payload.
28
+ * @returns {{status: string, workspaceRoot?: string, statePath?: string, reason?: string, state?: any}}
29
+ */
30
+ export function readInstallationState(workspace, { afterStateRead = () => {}, readState = true } = {}) {
31
+ const result = { status: 'invalid' };
32
+ try {
33
+ if (!present(workspace)) return { status: 'missing', reason: 'missing_state' };
34
+ const root = realpathSync(workspace);
35
+ result.workspaceRoot = root;
36
+ result.statePath = join(root, '.ai/agent-fleet-state.json');
37
+ // Linked human configuration must never become consent, even without state.
38
+ if (present(join(root, '.ai')) && !lstatSync(join(root, '.ai')).isDirectory()) throw Error('source_denied');
39
+ const configIdentity = JSON.stringify(desired(root));
40
+ if (!readState) return { ...result, status: 'local' };
41
+ if (!present(result.statePath)) return { ...result, status: 'missing', reason: 'missing_state' };
42
+ const check = () => {
43
+ if (JSON.stringify(desired(root)) !== configIdentity) throw Error('source_changed');
44
+ };
45
+ const state = JSON.parse(safeSourceRead(root, result.statePath, INSTALLATION_STATE_MAX_BYTES, check, afterStateRead).toString('utf8'));
46
+ if (!state || typeof state !== 'object' || Array.isArray(state) || ![1, 2].includes(state.schemaVersion)) throw Error('unsupported_state_schema');
47
+ if (state.taskTriageSelected !== undefined && typeof state.taskTriageSelected !== 'boolean') throw Error('invalid_selection');
48
+ return { ...result, status: 'local', state };
49
+ } catch (error) {
50
+ // JSON errors may expose private fragments; return only known codes.
51
+ const reason = error.message === RETIRED_INSTALLATION_OWNER_MESSAGE ? 'installation_owner_removed'
52
+ : ['source_denied', 'source_changed', 'state_too_large', 'unsupported_state_schema', 'invalid_selection', 'invalid_desired'].includes(error.message) ? error.message : 'invalid_installation_evidence';
53
+ return { ...result, status: 'invalid', reason };
54
+ }
55
+ }
56
+
57
+ /** Refuse retired/unsafe layouts before mutation, without blocking state recovery. */
58
+ export function assertLocalInstallation(workspace, operation = 'installation operation') {
59
+ const result = readInstallationState(workspace, { readState: false });
60
+ if (result.status !== 'invalid') return;
61
+ throw Error(`${operation}: ${result.reason === 'installation_owner_removed' ? RETIRED_INSTALLATION_OWNER_MESSAGE : result.reason === 'invalid_desired' ? INVALID_DESIRED_MESSAGE : `invalid local installation evidence (${result.reason})`}`);
62
+ }
@@ -0,0 +1,24 @@
1
+ import {join} from 'node:path';
2
+ import type {LayoutNode} from './herdr-client.ts';
3
+ import {sessionRootsFromEnv,validateSessionRoots,projectForSession,targetProject,type SessionRoots} from './workspace-context.ts';
4
+ export function peerTarget(project:string,baseProject?:string){
5
+ const roots=sessionRootsFromEnv();if(roots?.mode!=='targeted')return undefined;
6
+ if(baseProject&&targetProject(baseProject,roots)!==project)throw Error('peer_target_project_mismatch');
7
+ return {roots,...(baseProject?{baseProject,project}:projectForSession(project,roots))};
8
+ }
9
+ export function targetPaneEnv(env:Record<string,string>|undefined,roots:SessionRoots,baseProject:string,project:string){
10
+ validateSessionRoots(roots);
11
+ if(targetProject(baseProject,roots)!==project)throw Error('peer_target_project_mismatch');
12
+ const routing={AF_SESSION_ROOTS:JSON.stringify(roots),AF_TARGET_BASE_PROJECT:baseProject,AF_TARGET_EFFECTIVE_PROJECT:project};
13
+ for(const [key,value] of Object.entries(env??{}))if(key.startsWith('GIT_')||key in routing&&value!==routing[key as keyof typeof routing])throw Error(`peer_context_override:${key}`);
14
+ return {...env,...routing};
15
+ }
16
+ export function targetPeerCommand(command:string[],roots:SessionRoots){
17
+ validateSessionRoots(roots);
18
+ return command[0]==='just'?['just','--justfile',join(roots.workspaceRoot,'justfile'),'--working-directory',roots.workspaceRoot,...command.slice(1)]:command;
19
+ }
20
+ export function bindTargetLayout(node:LayoutNode,target:ReturnType<typeof peerTarget>):LayoutNode {
21
+ if(!target)return node;
22
+ if(node.type==='split')return {...node,first:bindTargetLayout(node.first,target),second:bindTargetLayout(node.second,target)};
23
+ return {...node,cwd:target.roots.executionRoot,command:targetPeerCommand(node.command??[],target.roots),env:targetPaneEnv(node.env,target.roots,target.baseProject,target.project)};
24
+ }
@@ -0,0 +1,117 @@
1
+ // Shared runtime for Hub and the JavaScript-only CLI. Types live in policy-roots.ts.
2
+ import { existsSync, realpathSync, statSync } from "node:fs";
3
+ import { isAbsolute, relative, resolve, sep } from "node:path";
4
+
5
+ const deniedSegment = /^(?:\.git|\.pi|node_modules|vendor|dist|build|coverage|\.env(?:\..*)?|credentials?|secrets?)$/i;
6
+ const denied = path => path.split(/[\\/]/).some(part => deniedSegment.test(part));
7
+ function inside(root, target) {
8
+ const rel = relative(root, target);
9
+ return rel === "" || (!isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`));
10
+ }
11
+ function covers(root, target, base = root.canonicalPath) {
12
+ return root.kind === "file" ? target === base : inside(base, target);
13
+ }
14
+ function currentRoot(root) {
15
+ let canonical;
16
+ try { canonical = realpathSync(root.lexicalPath); }
17
+ catch { throw new Error(`root_changed:${root.configuredPath}`); }
18
+ if (canonical !== root.canonicalPath) throw new Error(`root_changed:${root.configuredPath}`);
19
+ const stat = statSync(root.lexicalPath);
20
+ if (root.kind === "directory" ? !stat.isDirectory() : !stat.isFile()) throw new Error(`root_changed:${root.configuredPath}`);
21
+ }
22
+
23
+ /** Explicit read grants only; not capture consent, registration or write ownership. */
24
+ export function resolvePolicyRoots(checkout, config, configurationBase = checkout) {
25
+ const workspace = realpathSync(checkout);
26
+ const configBase = realpathSync(configurationBase);
27
+ const roots = [Object.freeze({ id: "workspace", role: "workspace", configuredPath: ".", lexicalPath: resolve(checkout), canonicalPath: workspace, kind: "directory" })];
28
+ const diagnostics = [];
29
+ const note = (code, path) => diagnostics.push(Object.freeze({ code, path, message: `${code}:${path}` }));
30
+ for (const [role, paths] of [["rules", config.rulesDirs ?? []], ["docs", config.docsPaths ?? []]]) {
31
+ for (const configuredPath of paths) {
32
+ if (!configuredPath || isAbsolute(configuredPath) || configuredPath.includes("\\")) { note("invalid_root", configuredPath); continue; }
33
+ const lexicalPath = resolve(configurationBase, configuredPath);
34
+ if (denied(configuredPath)) { note("denied_path", configuredPath); continue; }
35
+ let canonicalPath;
36
+ try { canonicalPath = realpathSync(lexicalPath); }
37
+ catch { note("missing_root", configuredPath); continue; }
38
+ if (denied(canonicalPath)) { note("denied_path", configuredPath); continue; }
39
+ if (canonicalPath !== workspace && inside(canonicalPath, workspace)) { note("unsafe_root", configuredPath); continue; }
40
+ const stat = statSync(canonicalPath);
41
+ if ((!stat.isDirectory() && !stat.isFile()) || (role === "rules" && !stat.isDirectory())) { note("invalid_root_type", configuredPath); continue; }
42
+ if (roots.some(root => root.role === role && root.canonicalPath === canonicalPath)) { note("duplicate_root", configuredPath); continue; }
43
+ const root = Object.freeze({ id: `${role}:${canonicalPath}`, role, configuredPath, lexicalPath, canonicalPath, kind: stat.isDirectory() ? "directory" : "file" });
44
+ for (const existing of roots.filter(r => r.role !== "workspace")) {
45
+ if (covers(existing, canonicalPath) || covers(root, existing.canonicalPath)) note("overlapping_roots", configuredPath);
46
+ }
47
+ roots.push(root);
48
+ }
49
+ }
50
+ // Local Fleet rules retain their existing read-only role, without granting the
51
+ // entire configuration workspace or considering target-local rule overrides.
52
+ if (configBase !== workspace) {
53
+ const path = resolve(configBase, '.ai/rules');
54
+ if (existsSync(path) && !roots.some(root => root.role === 'rules' && root.lexicalPath === path)) {
55
+ const canonicalPath=realpathSync(path);
56
+ if (!denied(canonicalPath) && statSync(canonicalPath).isDirectory()) roots.push(Object.freeze({id:`rules:${canonicalPath}`,role:'rules',configuredPath:'.ai/rules',lexicalPath:path,canonicalPath,kind:'directory'}));
57
+ }
58
+ }
59
+ return Object.freeze({ workspace, ...(configBase !== workspace ? {configBase} : {}), roots: Object.freeze(roots), diagnostics: Object.freeze(diagnostics) });
60
+ }
61
+
62
+ /** Revalidate lexical/canonical containment and root identity before every access. */
63
+ export function authorizePolicyPath(table, path, operation = "read") {
64
+ const target = resolve(table.workspace, path);
65
+ if (denied(path)) throw new Error(`denied_path:${path}`);
66
+ const candidates = table.roots.filter(root => covers(root, target, root.lexicalPath) || covers(root, target));
67
+ candidates.sort((a, b) => (a.role === "workspace" ? 1 : 0) - (b.role === "workspace" ? 1 : 0) || b.canonicalPath.length - a.canonicalPath.length || a.id.localeCompare(b.id));
68
+ const root = candidates[0];
69
+ if (!root) throw new Error(`ungranted_path:${path}`);
70
+ currentRoot(root);
71
+ let canonical;
72
+ try { canonical = realpathSync(target); }
73
+ catch { throw new Error(`missing_path:${path}`); }
74
+ if (!covers(root, canonical)) throw new Error(`canonical_escape:${path}`);
75
+ if (denied(canonical)) throw new Error(`denied_path:${path}`);
76
+ if (operation === "inventory" && (root.kind !== "directory" || !statSync(canonical).isDirectory())) throw new Error(`inventory_requires_directory:${path}`);
77
+ return { root, path: canonical };
78
+ }
79
+ export function resolvePolicyReferences(table, paths, role) {
80
+ return paths.map(path => {
81
+ const target = resolve(table.configBase ?? table.workspace, path);
82
+ if (!table.configBase && inside(table.workspace, target)) return path;
83
+ const source = authorizePolicyPath(table, target);
84
+ if (source.root.role !== role && source.root.role !== 'workspace') throw new Error(`ungranted_reference:${path}`);
85
+ return source.path;
86
+ });
87
+ }
88
+ export function policyRootValidationContext(table) {
89
+ return { externalIncludeAllowed: include => {
90
+ const subtree = include.endsWith("/**");
91
+ const path = subtree ? include.slice(0, -3) : include;
92
+ try {
93
+ const source = authorizePolicyPath(table, path, subtree ? "inventory" : "read");
94
+ return source.root.role !== "workspace";
95
+ } catch { return false; }
96
+ } };
97
+ }
98
+ /** Legacy logical identities never select ambiguous sources or approve a changed pin. */
99
+ export function resolveRuleBinding(table, logicalPath) {
100
+ if (!logicalPath.startsWith(".ai/rules/") || logicalPath.includes("\\") || logicalPath.split("/").some(part => !part || part === "." || part === "..") || denied(logicalPath)) throw new Error(`invalid_binding:${logicalPath}`);
101
+ const suffix = logicalPath.slice(".ai/rules/".length);
102
+ const candidates = [];
103
+ const paths = [resolve(table.configBase ?? table.workspace, logicalPath), ...table.roots.filter(root => root.role === "rules").map(root => resolve(root.lexicalPath, suffix))];
104
+ for (const path of paths) {
105
+ if (table.configBase && !existsSync(path)) continue;
106
+ let candidate;
107
+ try { candidate = authorizePolicyPath(table, path); }
108
+ catch (error) {
109
+ if (error instanceof Error && error.message.startsWith("missing_path:")) continue;
110
+ throw error;
111
+ }
112
+ if (!statSync(candidate.path).isFile()) throw new Error(`invalid_binding_type:${logicalPath}`);
113
+ if (!candidates.some(item => item.path === candidate.path)) candidates.push(candidate);
114
+ }
115
+ if (candidates.length !== 1) throw new Error(`${candidates.length ? "ambiguous_binding" : "missing_binding"}:${logicalPath}`);
116
+ return candidates[0];
117
+ }
@@ -0,0 +1,32 @@
1
+ // Typed facade over the runtime shared with the JavaScript-only CLI.
2
+ import * as runtime from "./policy-roots.js";
3
+
4
+ export type PolicyRole = "workspace" | "rules" | "docs";
5
+ export interface PolicyRoot {
6
+ readonly id: string;
7
+ readonly role: PolicyRole;
8
+ readonly configuredPath: string;
9
+ readonly lexicalPath: string;
10
+ readonly canonicalPath: string;
11
+ readonly kind: "directory" | "file";
12
+ }
13
+ export interface PolicyRootDiagnostic {
14
+ readonly code: string;
15
+ readonly path: string;
16
+ readonly message: string;
17
+ }
18
+ export interface PolicyRootTable {
19
+ readonly workspace: string;
20
+ readonly configBase?: string;
21
+ readonly roots: readonly PolicyRoot[];
22
+ readonly diagnostics: readonly PolicyRootDiagnostic[];
23
+ }
24
+ export interface AuthorizedPolicyPath {
25
+ readonly root: PolicyRoot;
26
+ readonly path: string;
27
+ }
28
+ export const resolvePolicyRoots = runtime.resolvePolicyRoots as (checkout: string, config: { rulesDirs?: readonly string[]; docsPaths?: readonly string[] }, configurationBase?: string) => PolicyRootTable;
29
+ export const authorizePolicyPath = runtime.authorizePolicyPath as (table: PolicyRootTable, path: string, operation?: "read" | "inventory") => AuthorizedPolicyPath;
30
+ export const resolvePolicyReferences = runtime.resolvePolicyReferences as (table: PolicyRootTable, paths: readonly string[], role: "rules" | "docs") => string[];
31
+ export const policyRootValidationContext = runtime.policyRootValidationContext as (table: PolicyRootTable) => { externalIncludeAllowed(include: string): boolean };
32
+ export const resolveRuleBinding = runtime.resolveRuleBinding as (table: PolicyRootTable, logicalPath: string) => AuthorizedPolicyPath;
@@ -0,0 +1,9 @@
1
+ /** Pi loads every `-e` extension through its own jiti instance with moduleCache:false,
2
+ * so a module-local singleton exists once per extension, not once per process.
3
+ * State that several extensions must observe lives on the process realm under a
4
+ * versioned Symbol.for key; bump the version whenever the stored shape changes. */
5
+ export function processShared<T>(key: string, init: () => T): T {
6
+ const realm = globalThis as typeof globalThis & { [key: symbol]: unknown };
7
+ const symbol = Symbol.for(key);
8
+ return (realm[symbol] ??= init()) as T;
9
+ }
@@ -0,0 +1,26 @@
1
+ // Read-only health preflight for Fleet's workspace-owned local module closure.
2
+ // External package health is checked separately by runtime-dependencies.js.
3
+ import {existsSync,readFileSync,realpathSync,statSync} from 'node:fs';
4
+ import {dirname,isAbsolute,join,resolve} from 'node:path';
5
+ export function resourceClosureGaps(workspace,entries,additionalRoots=[]){
6
+ const root=realpathSync(workspace),allowed=[root,...additionalRoots.map(path=>realpathSync(path))],seen=new Set(),gaps=[];const queue=[...entries];
7
+ while(queue.length){
8
+ if(seen.size>1024){gaps.push('resource_closure_limit');break;}
9
+ const input=queue.pop(),candidate=resolve(root,input);
10
+ if(!existsSync(candidate)){gaps.push(`missing_resource:${input}`);continue;}
11
+ const path=realpathSync(candidate);
12
+ if(!allowed.some(owner=>path.startsWith(owner+'/'))){gaps.push(`foreign_resource:${input}`);continue;}
13
+ if(seen.has(path))continue;seen.add(path);
14
+ const stat=statSync(path);if(!stat.isFile()||stat.size>1024*1024){gaps.push(`invalid_resource:${input}`);continue;}
15
+ if(!/\.[cm]?[jt]s$/.test(path))continue;
16
+ const text=readFileSync(path,'utf8').replace(/\/\*[\s\S]*?\*\/|^\s*\/\/.*$/gm,'');
17
+ const imports=/\b(?:import|export)\s+(?:type\s+)?(?:[^'";]*?\sfrom\s*)?['"]([^'"]+)['"]|\b(?:import|require)\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
18
+ for(const match of text.matchAll(imports)){
19
+ const specifier=match[1]??match[2];if(!specifier.startsWith('.')&&!isAbsolute(specifier))continue;
20
+ let target=resolve(dirname(path),specifier);
21
+ if(!existsSync(target))target=[target+'.ts',target+'.js',join(target,'index.ts'),join(target,'index.js')].find(existsSync)??target;
22
+ queue.push(target);
23
+ }
24
+ }
25
+ return [...new Set(gaps)].sort();
26
+ }
@@ -0,0 +1,29 @@
1
+ // @ts-nocheck
2
+ import {closeSync,constants,fstatSync,lstatSync,openSync,readSync,realpathSync} from 'node:fs';
3
+ import {isAbsolute,join,relative,resolve} from 'node:path';
4
+ export function checkedSourcePath(root,path) {
5
+ const realRoot=realpathSync(root), full=resolve(path), rel=relative(realRoot,full);
6
+ if(!rel||rel.startsWith('..')||isAbsolute(rel))throw Error('source_denied');
7
+ let cursor=realRoot;
8
+ for(const part of rel.split('/')) {cursor=join(cursor,part);if(lstatSync(cursor).isSymbolicLink())throw Error('source_denied');}
9
+ if(realpathSync(full)!==full)throw Error('source_denied');
10
+ return full;
11
+ }
12
+ export function safeSourceRead(root,path,maxBytes,check=()=>{},afterFirstRead=()=>{}) {
13
+ check();const full=checkedSourcePath(root,path), fd=openSync(full,constants.O_RDONLY|constants.O_NOFOLLOW|constants.O_NONBLOCK);
14
+ try {
15
+ const before=fstatSync(fd);
16
+ if(!before.isFile())throw Error('source_denied');
17
+ if(before.size>maxBytes)throw Error('state_too_large');
18
+ // Recheck the opened descriptor against the fenced pathname before any bytes
19
+ // are read, including an ancestor swapped between the preflight and open.
20
+ checkedSourcePath(root,full);const opened=lstatSync(full);
21
+ if(opened.ino!==before.ino||opened.dev!==before.dev)throw Error('source_changed');
22
+ const read=()=>{const b=Buffer.alloc(before.size);let offset=0;while(offset<b.length){check();const n=readSync(fd,b,offset,b.length-offset,offset);if(!n)throw Error('source_changed');offset+=n;}return b;};
23
+ const bytes=read();afterFirstRead();const confirm=read(),after=fstatSync(fd);checkedSourcePath(root,full);const final=lstatSync(full);
24
+ if(!bytes.equals(confirm)||['size','mtimeMs','ctimeMs','ino','dev'].some(k=>before[k]!==after[k])||final.ino!==after.ino||final.dev!==after.dev)throw Error('source_changed');
25
+ if(bytes.includes(0))throw Error('source_denied');
26
+ try{new TextDecoder('utf-8',{fatal:true}).decode(bytes);}catch{throw Error('source_denied');}
27
+ check();return bytes;
28
+ }finally{closeSync(fd);}
29
+ }
@@ -0,0 +1,80 @@
1
+ import {processShared} from './process-shared.ts';
2
+ export type SemanticDecision='allow'|'deny';
3
+ interface SemanticState { decisions: Map<string,SemanticDecision>; scope: {taskId:string;revision:string}|null; }
4
+ const state=processShared<SemanticState>('agent-fleet.semantic-approval.v1',()=>({decisions:new Map(),scope:null}));
5
+ const decisions=state.decisions;
6
+ export const semanticScope=()=>state.scope;
7
+ const key=(taskId:string,revision:string,path:string)=>JSON.stringify([taskId,revision,path]);
8
+
9
+ export function resetSemanticApprovals():void {
10
+ decisions.clear();state.scope=null;
11
+ }
12
+ export function bindSemanticScope(taskId:string,revision:string):void {
13
+ if(!taskId||!revision){resetSemanticApprovals();return;}
14
+ if(state.scope?.taskId===taskId&&state.scope.revision===revision)return;
15
+ decisions.clear();state.scope={taskId,revision};
16
+ }
17
+ export function noteSemanticDecision(taskId:string,revision:string,path:string,decision:SemanticDecision):void {
18
+ const normalized=normalizeDecisionPath(path);
19
+ if(!taskId||!revision||!normalized)return;
20
+ decisions.set(key(taskId,revision,normalized),decision);
21
+ }
22
+ export function semanticDecision(taskId:string,revision:string,path:string):SemanticDecision|undefined {
23
+ const normalized=normalizeDecisionPath(path);
24
+ return normalized?decisions.get(key(taskId,revision,normalized)):undefined;
25
+ }
26
+ export function normalizeDecisionPath(value:string):string|null {
27
+ const trimmed=value.trim().replace(/^['"`]|['"`]$/g, '');
28
+ if(!trimmed||trimmed.length>512||trimmed.includes('\0')||trimmed.includes('..')||trimmed.startsWith('/')||trimmed.startsWith('~')||trimmed.endsWith('/'))return null;
29
+ const normalized=trimmed.replace(/^\.\//, '').replace(/\/+/g, '/');
30
+ return /^[A-Za-z0-9._@+-][A-Za-z0-9._@+/-]*$/.test(normalized)?normalized:null;
31
+ }
32
+ function tokens(command:string):string[] {
33
+ const out:string[]=[];const re=/"([^"]*)"|'([^']*)'|(\S+)/g;let match:RegExpExecArray|null;
34
+ while((match=re.exec(command)))out.push(match[1]??match[2]??match[3]);
35
+ return out;
36
+ }
37
+ // An inner newline separates Bash commands just like `;`, so no control character may hide a second command.
38
+ const controlText=/[\x00-\x1f\x7f-\x9f]/;
39
+ export function inspectionBash(command:string):boolean {
40
+ const segments=command.split(/&&|\|\||;/).map(segment=>segment.trim()).filter(Boolean);
41
+ if(!segments.length||controlText.test(command.trim())||/[|`$<>]/.test(command.replace(/\s+2>\s*\/dev\/null\b/g, ''))||command.includes('$('))return false;
42
+ return segments.every(segment=>{
43
+ const argv=tokens(segment.replace(/\s+2>\s*\/dev\/null\b/g, ''));
44
+ return ['pwd','ls','test','stat','wc','file'].includes(argv[0]??'')&&argv.every(token=>!/[|&`;<>]/.test(token));
45
+ });
46
+ }
47
+ export function exactDeletePath(command:string):string|null {
48
+ const trimmed=command.trim();
49
+ if(!trimmed||controlText.test(trimmed)||/[;&|`$<>]/.test(trimmed)||trimmed.includes('$('))return null;
50
+ const argv=tokens(trimmed);
51
+ if(argv[0]!=='rm')return null;
52
+ const paths:string[]=[];
53
+ for(const token of argv.slice(1)){
54
+ if(token==='--'||token==='-f'||token==='--force')continue;
55
+ if(token.startsWith('-'))return null;
56
+ paths.push(token);
57
+ }
58
+ return paths.length===1?normalizeDecisionPath(paths[0]):null;
59
+ }
60
+ /** One exact delete plus inspection checks is still the same delete, not a new command. */
61
+ export function coveredDeletePath(command:string):string|null {
62
+ if(!command.trim()||controlText.test(command.trim())||/[|`$<>]/.test(command)||command.includes('$('))return null;
63
+ const segments=command.split(/&&|\|\||;/).map(segment=>segment.trim()).filter(Boolean);
64
+ const deletes=new Set<string>();
65
+ for(const segment of segments){
66
+ if(inspectionBash(segment))continue;
67
+ const path=exactDeletePath(segment);
68
+ if(!path)return null;
69
+ deletes.add(path);
70
+ }
71
+ return deletes.size===1?[...deletes][0]:null;
72
+ }
73
+ /**
74
+ * Only an exact-action dialog that showed the human the command records a decision.
75
+ * Free-form ask_user prose cannot: its polarity and target are not machine-checkable.
76
+ */
77
+ export function noteBashDecision(taskId:string,revision:string,command:string,decision:SemanticDecision):void {
78
+ const path=coveredDeletePath(command);
79
+ if(path)noteSemanticDecision(taskId,revision,path,decision);
80
+ }