@chankov/agent-fleet 2.0.8 → 2.0.9

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 (453) hide show
  1. package/.pi/harnesses/agent-hub/README.md +20 -6
  2. package/.pi/harnesses/agent-hub/footer.ts +1 -1
  3. package/.pi/harnesses/agent-hub/index.ts +47 -66
  4. package/.pi/harnesses/agent-hub/input/shortcuts.ts +2 -0
  5. package/.pi/harnesses/agent-hub/package.json +1 -1
  6. package/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  7. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +16 -42
  8. package/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  9. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  10. package/.pi/harnesses/agent-hub/ui/grid.ts +145 -33
  11. package/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -139
  12. package/.pi/harnesses/coms/package.json +1 -1
  13. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  14. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +17 -0
  15. package/.pi/harnesses/lib/fleet-dashboard-view.ts +22 -36
  16. package/.pi/harnesses/lib/fleet-read-model.ts +109 -27
  17. package/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  18. package/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  19. package/.versions/2.0.9/.pi/agent-fleet/hermes/README.md +347 -0
  20. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  21. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  22. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  23. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  24. package/.versions/2.0.9/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  25. package/.versions/2.0.9/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  26. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  27. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  28. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  29. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  30. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  31. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  32. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  33. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  34. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  35. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  36. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  37. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  38. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  39. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  40. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  41. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  42. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  43. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  44. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  45. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  46. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  47. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  48. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  49. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  50. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  51. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  52. package/.versions/2.0.9/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  53. package/.versions/2.0.9/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  54. package/.versions/2.0.9/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  55. package/.versions/2.0.9/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  56. package/.versions/2.0.9/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  57. package/.versions/2.0.9/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  58. package/.versions/2.0.9/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  59. package/.versions/2.0.9/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  60. package/.versions/2.0.9/.pi/agent-fleet/scripts/fleet.ts +216 -0
  61. package/.versions/2.0.9/.pi/agent-fleet/scripts/flow.ts +137 -0
  62. package/.versions/2.0.9/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  63. package/.versions/2.0.9/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  64. package/.versions/2.0.9/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  65. package/.versions/2.0.9/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  66. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  67. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  68. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  69. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  70. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  71. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  72. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  73. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  74. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  75. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  76. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  77. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  78. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  79. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  80. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  81. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  82. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  83. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  84. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  85. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  86. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  87. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  88. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  89. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  90. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  91. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  92. package/.versions/2.0.9/.pi/agent-fleet/scripts/package-lock.json +35 -0
  93. package/.versions/2.0.9/.pi/agent-fleet/scripts/package.json +9 -0
  94. package/.versions/2.0.9/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  95. package/.versions/2.0.9/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  96. package/.versions/2.0.9/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  97. package/.versions/2.0.9/.pi/agent-fleet/scripts/team-up.ts +378 -0
  98. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  99. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  100. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  101. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  102. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  103. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  104. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  105. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  106. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  107. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  108. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  109. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  110. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  111. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  112. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  113. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  114. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  115. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  116. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  117. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  118. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  119. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  120. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  121. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  122. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  123. package/.versions/2.0.9/.pi/agents/dispatch-policy.yaml +32 -0
  124. package/.versions/2.0.9/.pi/agents/model-profiles.yaml +83 -0
  125. package/.versions/2.0.9/.pi/agents/peers.yaml +147 -0
  126. package/.versions/2.0.9/.pi/agents/teams.yaml +41 -0
  127. package/.versions/2.0.9/.pi/agents/voices.yaml +13 -0
  128. package/.versions/2.0.9/.pi/damage-control-rules.yaml +297 -0
  129. package/.versions/2.0.9/.pi/extensions/btw/README.md +120 -0
  130. package/.versions/2.0.9/.pi/extensions/btw/index.ts +914 -0
  131. package/.versions/2.0.9/.pi/extensions/btw/package.json +6 -0
  132. package/.versions/2.0.9/.pi/extensions/btw/state.js +179 -0
  133. package/.versions/2.0.9/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  134. package/.versions/2.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  135. package/.versions/2.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  136. package/.versions/2.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
  137. package/.versions/2.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
  138. package/.versions/2.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
  139. package/.versions/2.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
  140. package/.versions/2.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
  141. package/.versions/2.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
  142. package/.versions/2.0.9/.pi/extensions/package-lock.json +1175 -0
  143. package/.versions/2.0.9/.pi/extensions/package.json +9 -0
  144. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/README.md +205 -0
  145. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
  146. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  147. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
  148. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
  149. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  150. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  151. package/.versions/2.0.9/.pi/harnesses/agent-hub/README.md +1217 -0
  152. package/.versions/2.0.9/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  153. package/.versions/2.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  154. package/.versions/2.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
  155. package/.versions/2.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  156. package/.versions/2.0.9/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  157. package/.versions/2.0.9/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  158. package/.versions/2.0.9/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  159. package/.versions/2.0.9/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  160. package/.versions/2.0.9/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  161. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  162. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  163. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  164. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  165. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  166. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  167. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  168. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  169. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  170. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  171. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  172. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  173. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  174. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  175. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  176. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  177. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  178. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  179. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  180. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  181. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  182. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  183. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  184. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  185. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  186. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  187. package/.versions/2.0.9/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  188. package/.versions/2.0.9/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  189. package/.versions/2.0.9/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  190. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  191. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  192. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  193. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  194. package/.versions/2.0.9/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  195. package/.versions/2.0.9/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  196. package/.versions/2.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
  197. package/.versions/2.0.9/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  198. package/.versions/2.0.9/.pi/harnesses/agent-hub/delegate.ts +446 -0
  199. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  200. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  201. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  202. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  203. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  204. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  205. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  206. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  207. package/.versions/2.0.9/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  208. package/.versions/2.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  209. package/.versions/2.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  210. package/.versions/2.0.9/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  211. package/.versions/2.0.9/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  212. package/.versions/2.0.9/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  213. package/.versions/2.0.9/.pi/harnesses/agent-hub/footer.ts +30 -0
  214. package/.versions/2.0.9/.pi/harnesses/agent-hub/helpers.ts +266 -0
  215. package/.versions/2.0.9/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  216. package/.versions/2.0.9/.pi/harnesses/agent-hub/index.ts +2132 -0
  217. package/.versions/2.0.9/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  218. package/.versions/2.0.9/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  219. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  220. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  221. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  222. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  223. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  224. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  225. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  226. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  227. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  228. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  229. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  230. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  231. package/.versions/2.0.9/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  232. package/.versions/2.0.9/.pi/harnesses/agent-hub/package.json +7 -0
  233. package/.versions/2.0.9/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  234. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  235. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  236. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  237. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  238. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  239. package/.versions/2.0.9/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  240. package/.versions/2.0.9/.pi/harnesses/agent-hub/presentation.ts +48 -0
  241. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  242. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  243. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  244. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  245. package/.versions/2.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  246. package/.versions/2.0.9/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  247. package/.versions/2.0.9/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  248. package/.versions/2.0.9/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  249. package/.versions/2.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  250. package/.versions/2.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
  251. package/.versions/2.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
  252. package/.versions/2.0.9/.pi/harnesses/agent-hub/review-findings.js +102 -0
  253. package/.versions/2.0.9/.pi/harnesses/agent-hub/run-budget.js +537 -0
  254. package/.versions/2.0.9/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  255. package/.versions/2.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  256. package/.versions/2.0.9/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  257. package/.versions/2.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
  258. package/.versions/2.0.9/.pi/harnesses/agent-hub/session-start.ts +42 -0
  259. package/.versions/2.0.9/.pi/harnesses/agent-hub/spawn.ts +404 -0
  260. package/.versions/2.0.9/.pi/harnesses/agent-hub/timeline.ts +54 -0
  261. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  262. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  263. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  264. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  265. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  266. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  267. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  268. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  269. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  270. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  271. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  272. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  273. package/.versions/2.0.9/.pi/harnesses/agent-hub/types.ts +63 -0
  274. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  275. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  276. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  277. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  278. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  279. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  280. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  281. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  282. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  283. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  284. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  285. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  286. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  287. package/.versions/2.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
  288. package/.versions/2.0.9/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  289. package/.versions/2.0.9/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  290. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/README.md +59 -0
  291. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/index.ts +558 -0
  292. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  293. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  294. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  295. package/.versions/2.0.9/.pi/harnesses/coms/README.md +100 -0
  296. package/.versions/2.0.9/.pi/harnesses/coms/index.ts +282 -0
  297. package/.versions/2.0.9/.pi/harnesses/coms/package.json +7 -0
  298. package/.versions/2.0.9/.pi/harnesses/coms/version.ts +42 -0
  299. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/README.md +135 -0
  300. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/index.ts +541 -0
  301. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
  302. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
  303. package/.versions/2.0.9/.pi/harnesses/lib/coms-core-io.ts +385 -0
  304. package/.versions/2.0.9/.pi/harnesses/lib/coms-core.ts +577 -0
  305. package/.versions/2.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  306. package/.versions/2.0.9/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  307. package/.versions/2.0.9/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  308. package/.versions/2.0.9/.pi/harnesses/lib/context-budget-view.ts +107 -0
  309. package/.versions/2.0.9/.pi/harnesses/lib/context-budget.ts +114 -0
  310. package/.versions/2.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  311. package/.versions/2.0.9/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  312. package/.versions/2.0.9/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  313. package/.versions/2.0.9/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  314. package/.versions/2.0.9/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  315. package/.versions/2.0.9/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  316. package/.versions/2.0.9/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  317. package/.versions/2.0.9/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  318. package/.versions/2.0.9/.pi/harnesses/lib/fleet-panel.ts +34 -0
  319. package/.versions/2.0.9/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  320. package/.versions/2.0.9/.pi/harnesses/lib/fleet-selection.ts +24 -0
  321. package/.versions/2.0.9/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  322. package/.versions/2.0.9/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  323. package/.versions/2.0.9/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  324. package/.versions/2.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
  325. package/.versions/2.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
  326. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  327. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  328. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  329. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  330. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  331. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  332. package/.versions/2.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
  333. package/.versions/2.0.9/.pi/harnesses/lib/update-check.ts +222 -0
  334. package/.versions/2.0.9/.pi/harnesses/package-lock.json +2039 -0
  335. package/.versions/2.0.9/.pi/harnesses/package.json +10 -0
  336. package/.versions/2.0.9/.pi/prompts/af-build.md +24 -0
  337. package/.versions/2.0.9/.pi/prompts/af-code-simplify.md +22 -0
  338. package/.versions/2.0.9/.pi/prompts/af-constraints.md +31 -0
  339. package/.versions/2.0.9/.pi/prompts/af-plan.md +17 -0
  340. package/.versions/2.0.9/.pi/prompts/af-review.md +16 -0
  341. package/.versions/2.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
  342. package/.versions/2.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  343. package/.versions/2.0.9/.pi/prompts/af-ship.md +17 -0
  344. package/.versions/2.0.9/.pi/prompts/af-spec.md +15 -0
  345. package/.versions/2.0.9/.pi/prompts/af-test.md +19 -0
  346. package/.versions/2.0.9/.pi/skills/bowser/SKILL.md +145 -0
  347. package/.versions/2.0.9/.version +1 -0
  348. package/.versions/2.0.9/agents/architect.md +25 -0
  349. package/.versions/2.0.9/agents/bowser.md +28 -0
  350. package/.versions/2.0.9/agents/builder.md +56 -0
  351. package/.versions/2.0.9/agents/code-reviewer.md +210 -0
  352. package/.versions/2.0.9/agents/deep-researcher.md +33 -0
  353. package/.versions/2.0.9/agents/documenter.md +23 -0
  354. package/.versions/2.0.9/agents/orchestrator.md +23 -0
  355. package/.versions/2.0.9/agents/plan-reviewer.md +84 -0
  356. package/.versions/2.0.9/agents/planner.md +106 -0
  357. package/.versions/2.0.9/agents/releaser.md +25 -0
  358. package/.versions/2.0.9/agents/researcher.md +31 -0
  359. package/.versions/2.0.9/agents/security-auditor.md +168 -0
  360. package/.versions/2.0.9/agents/test-engineer.md +154 -0
  361. package/.versions/2.0.9/agents/web-debugger.md +44 -0
  362. package/.versions/2.0.9/agents/web-performance-auditor.md +194 -0
  363. package/.versions/2.0.9/bin/catalog/harness-runtime-closure.json +32 -0
  364. package/.versions/2.0.9/codex/fleet-session-client/SKILL.md +34 -0
  365. package/.versions/2.0.9/codex/fleet-session-client.zip +0 -0
  366. package/.versions/2.0.9/docs/ARCHITECTURE.md +416 -0
  367. package/.versions/2.0.9/docs/agent-fleet-setup.md +568 -0
  368. package/.versions/2.0.9/docs/claude-code-coms-bridge.md +134 -0
  369. package/.versions/2.0.9/docs/codex-session-bridge.md +219 -0
  370. package/.versions/2.0.9/docs/coms-hermes-bridge.md +188 -0
  371. package/.versions/2.0.9/docs/getting-started.md +126 -0
  372. package/.versions/2.0.9/docs/npm-install.md +356 -0
  373. package/.versions/2.0.9/docs/pi-extensions.md +449 -0
  374. package/.versions/2.0.9/docs/pi-setup.md +76 -0
  375. package/.versions/2.0.9/docs/skill-anatomy.md +150 -0
  376. package/.versions/2.0.9/install-manifest.json +2991 -0
  377. package/.versions/2.0.9/justfile +247 -0
  378. package/.versions/2.0.9/manifest-meta.json +970 -0
  379. package/.versions/2.0.9/references/accessibility-checklist.md +160 -0
  380. package/.versions/2.0.9/references/communication-contract.md +26 -0
  381. package/.versions/2.0.9/references/definition-of-done.md +67 -0
  382. package/.versions/2.0.9/references/fleet-coordination-patterns.md +171 -0
  383. package/.versions/2.0.9/references/observability-checklist.md +92 -0
  384. package/.versions/2.0.9/references/orchestration-patterns.md +370 -0
  385. package/.versions/2.0.9/references/performance-checklist.md +236 -0
  386. package/.versions/2.0.9/references/prompting-patterns.md +380 -0
  387. package/.versions/2.0.9/references/security-checklist.md +245 -0
  388. package/.versions/2.0.9/references/testing-patterns.md +235 -0
  389. package/.versions/2.0.9/references/workflow-authoring.md +304 -0
  390. package/.versions/2.0.9/skills/_internal/grilling.md +59 -0
  391. package/.versions/2.0.9/skills/browser-testing-with-devtools/SKILL.md +351 -0
  392. package/.versions/2.0.9/skills/code-review-and-quality/SKILL.md +396 -0
  393. package/.versions/2.0.9/skills/compound-learning/SKILL.md +137 -0
  394. package/.versions/2.0.9/skills/constraint-driven-development/SKILL.md +338 -0
  395. package/.versions/2.0.9/skills/constraint-driven-development/references/floor-guard.md +99 -0
  396. package/.versions/2.0.9/skills/context-engineering/SKILL.md +341 -0
  397. package/.versions/2.0.9/skills/deprecation-and-migration/SKILL.md +247 -0
  398. package/.versions/2.0.9/skills/designing-agents/SKILL.md +394 -0
  399. package/.versions/2.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
  400. package/.versions/2.0.9/skills/drafting-workflows/SKILL.md +143 -0
  401. package/.versions/2.0.9/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  402. package/.versions/2.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
  403. package/.versions/2.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
  404. package/.versions/2.0.9/skills/idea-refine/SKILL.md +182 -0
  405. package/.versions/2.0.9/skills/idea-refine/examples.md +238 -0
  406. package/.versions/2.0.9/skills/idea-refine/frameworks.md +99 -0
  407. package/.versions/2.0.9/skills/idea-refine/refinement-criteria.md +113 -0
  408. package/.versions/2.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
  409. package/.versions/2.0.9/skills/incremental-implementation/SKILL.md +302 -0
  410. package/.versions/2.0.9/skills/interview-me/SKILL.md +226 -0
  411. package/.versions/2.0.9/skills/orchestration-verification/SKILL.md +181 -0
  412. package/.versions/2.0.9/skills/peer-coms/SKILL.md +90 -0
  413. package/.versions/2.0.9/skills/performance-optimization/SKILL.md +496 -0
  414. package/.versions/2.0.9/skills/planning-and-task-breakdown/SKILL.md +289 -0
  415. package/.versions/2.0.9/skills/security-and-hardening/SKILL.md +524 -0
  416. package/.versions/2.0.9/skills/spec-driven-development/SKILL.md +295 -0
  417. package/.versions/2.0.9/skills/using-agent-skills/SKILL.md +198 -0
  418. package/.versions/2.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
  419. package/.versions/2.0.9/vendor/agent-skills-upstream/README.md +430 -0
  420. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  421. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  422. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  423. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  424. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  425. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  426. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  427. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  428. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  429. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  430. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  431. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  432. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  433. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  434. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  435. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  436. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  437. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  438. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  439. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  440. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  441. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  442. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  443. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  444. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  445. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  446. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  447. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  448. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  449. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  450. package/CHANGELOG.md +24 -0
  451. package/docs/pi-extensions.md +3 -0
  452. package/install-manifest.json +1 -1
  453. package/package.json +34 -12
@@ -0,0 +1,249 @@
1
+ #!/usr/bin/env python3
2
+ """Foreground fail-closed watchdog entrypoint; no daemon/service lifecycle."""
3
+ import argparse
4
+ import hashlib
5
+ import json
6
+ import os
7
+ import selectors
8
+ import signal
9
+ import sys
10
+ import time
11
+ from pathlib import Path
12
+
13
+ from watchdog_actions import MAXIMUM_ACTION, admit
14
+ from watchdog_contract import gate_o_valid
15
+ from watchdog_delivery import deliver, delivery_state
16
+ from watchdog_engine import bulgarian_summary, due_deviations, reduce_event
17
+ from watchdog_judgment import request as judgment_request, response as judgment_response
18
+ from watchdog_recovery import recover
19
+ from watchdog_state import atomic_json, audit, load_json, profile_root
20
+ from watchdog_transport import MonitorTransport, TransportError, discover, reconcile
21
+
22
+ LEVELS = ('observe', 'shadow', 'steer', 'surgical')
23
+
24
+
25
+ def request_id(record, profile_key, owner_session_id, hub_instance_id):
26
+ """Canonical owner/profile/generation identity for a single Hub invoke."""
27
+ ref = record['taskRef']
28
+ payload = json.dumps({'deviation': record.get('candidateDeviation'), 'taskId': ref['taskId'],
29
+ 'generation': ref['generation'], 'profileKey': profile_key,
30
+ 'ownerSessionId': owner_session_id, 'hubInstanceId': hub_instance_id},
31
+ sort_keys=True, separators=(',', ':')).encode()
32
+ return 'watchdog:' + hashlib.sha256(payload).hexdigest()
33
+
34
+
35
+ def safe_invocation(raw):
36
+ try:
37
+ value = json.loads(raw or '{}')
38
+ except json.JSONDecodeError as error:
39
+ raise ValueError('invalid_invocation') from error
40
+ if not isinstance(value, dict):
41
+ raise ValueError('invalid_invocation')
42
+ requested = value.get('autonomy', 'observe')
43
+ maximum = value.get('maximumAutonomy', 'observe')
44
+ if requested not in LEVELS or maximum not in LEVELS:
45
+ raise ValueError('invalid_autonomy')
46
+ level = LEVELS[min(LEVELS.index(requested), LEVELS.index(maximum))]
47
+ if not delivery_state(value.get('gateO'))['originDelivery'] and level in ('steer', 'surgical'):
48
+ level = 'observe'
49
+ return value, level
50
+
51
+
52
+ def _lock(invocation):
53
+ root = Path(invocation.get('lockDir') or os.environ.get('XDG_RUNTIME_DIR', '/tmp'))
54
+ # is_symlink() uses lstat: reject even a dangling link before any operation
55
+ # that could follow it (exists, mkdir, chmod, or stat).
56
+ if root.is_symlink():
57
+ raise ValueError('unsafe_lock')
58
+ root.mkdir(mode=0o700, parents=True, exist_ok=True)
59
+ if not root.is_dir() or root.stat().st_mode & 0o077:
60
+ raise ValueError('unsafe_lock')
61
+ root = root.resolve(strict=True)
62
+ path = root / 'agent-fleet-hermes-watchdog' / profile_root('', invocation.get('profileId', 'default')).name / 'watch.lock'
63
+ # Refuse a pre-existing symlink before mkdir/chmod can follow it.
64
+ for parent in (path.parent.parent, path.parent):
65
+ if parent.is_symlink() or (parent.exists() and (not parent.is_dir() or root not in (parent.resolve(), *parent.resolve().parents))):
66
+ raise ValueError('unsafe_lock')
67
+ parent.mkdir(mode=0o700, exist_ok=True)
68
+ if parent.is_symlink() or not parent.is_dir() or root not in (parent.resolve(), *parent.resolve().parents):
69
+ raise ValueError('unsafe_lock')
70
+ os.chmod(parent, 0o700)
71
+ if parent.stat().st_mode & 0o077:
72
+ raise ValueError('unsafe_lock')
73
+ try:
74
+ descriptor = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY | os.O_NOFOLLOW, 0o600)
75
+ except FileExistsError:
76
+ try:
77
+ contents = path.read_text(encoding='ascii').strip()
78
+ if path.is_symlink() or not contents.isdecimal() or int(contents) <= 0:
79
+ raise ValueError('unsafe_lock')
80
+ os.kill(int(contents), 0)
81
+ except ProcessLookupError:
82
+ path.unlink()
83
+ return _lock(invocation)
84
+ except (OSError, UnicodeError, ValueError) as error:
85
+ raise ValueError('watcher_locked') from error
86
+ raise ValueError('watcher_locked')
87
+ os.write(descriptor, str(os.getpid()).encode())
88
+ return path, descriptor
89
+
90
+
91
+ def _audit_path(invocation):
92
+ base = invocation.get('stateDir') or os.environ.get('XDG_STATE_HOME') or str(Path.home() / '.local/state')
93
+ return profile_root(Path(base) / 'agent-fleet/hermes-watchdog', invocation.get('profileId', 'default')) / 'audit.ndjson'
94
+
95
+
96
+ def _recovery_path(invocation):
97
+ return _audit_path(invocation).with_name('recovery.json')
98
+
99
+
100
+ def _recovery_key(task_ref):
101
+ return json.dumps([task_ref['taskId'], task_ref['generation']], separators=(',', ':'))
102
+
103
+
104
+ def _load_recovery(invocation):
105
+ path = _recovery_path(invocation)
106
+ try:
107
+ value = load_json(path) if path.exists() else {}
108
+ return value if isinstance(value, dict) and all(isinstance(tx, dict) for tx in value.values()) else {}
109
+ except (OSError, ValueError, json.JSONDecodeError):
110
+ return {}
111
+
112
+
113
+ def _save_recovery(invocation, transaction):
114
+ try:
115
+ atomic_json(_recovery_path(invocation), transaction)
116
+ return True
117
+ except (OSError, ValueError):
118
+ return False
119
+
120
+
121
+ def _safe_audit(path, record):
122
+ """Offline/corrupt local audit is fail-closed but must not crash the watcher."""
123
+ try:
124
+ audit(path, record)
125
+ return True
126
+ except (OSError, ValueError):
127
+ return False
128
+
129
+
130
+ def _action_for(record, invocation):
131
+ """Only a validated judgment may confirm an invoke; it can never escalate the table action."""
132
+ deviation = record.get('candidateDeviation')
133
+ maximum = MAXIMUM_ACTION.get(deviation, 'none')
134
+ adapter = invocation.get('judgmentAdapter')
135
+ if maximum == 'none' or not adapter:
136
+ return 'none', None
137
+ try:
138
+ verdict = judgment_response(adapter(judgment_request(
139
+ deviation, [record['eventId']], task_ref=record['taskRef'])), deviation, [record['eventId']])
140
+ recommended = verdict['recommendedAction']
141
+ return (recommended, verdict['verdict']) if recommended == maximum and verdict['verdict'] == 'confirmed' else ('none', None)
142
+ except (ValueError, TypeError, KeyError):
143
+ return 'none', None
144
+
145
+
146
+ def run_watch(invocation, level, *, once=False, transport_factory=None):
147
+ """Run the foreground polling/event loop. Dependencies are injectable only for tests."""
148
+ lock_path, lock_fd = _lock(invocation)
149
+ state, cursor, stopped = {}, 0, False
150
+ recovery_transactions = _load_recovery(invocation)
151
+ selector = selectors.DefaultSelector()
152
+ read_fd, write_fd = os.pipe()
153
+ os.set_blocking(read_fd, False)
154
+ selector.register(read_fd, selectors.EVENT_READ)
155
+ old_handler = signal.getsignal(signal.SIGINT)
156
+
157
+ def stop(*_):
158
+ nonlocal stopped
159
+ stopped = True
160
+ try: os.write(write_fd, b'x')
161
+ except OSError: pass
162
+
163
+ audit_path = _audit_path(invocation)
164
+ try:
165
+ signal.signal(signal.SIGINT, stop)
166
+ while not stopped:
167
+ try:
168
+ factory = transport_factory or (lambda: MonitorTransport(discover(
169
+ invocation['runtimeDir'], invocation['profileKey'], invocation['hubKey'],
170
+ invocation.get('now') or time.strftime('%Y-%m-%dT%H:%M:%SZ', time.gmtime()))))
171
+ transport = factory()
172
+ batch = reconcile(transport, cursor)
173
+ if batch.get('snapshot'):
174
+ cursor = 0
175
+ _safe_audit(audit_path, {'decision': 'snapshot_reconciled', 'hubInstanceId': invocation.get('hubInstanceId')})
176
+ events = batch.get('items', batch.get('events', []))
177
+ for event in events:
178
+ state, records = reduce_event(state, event, time.monotonic(), online=True)
179
+ cursor = max(cursor, event.get('eventSequence', cursor))
180
+ for record in records:
181
+ _safe_audit(audit_path, {'decision': 'material_event', 'hubInstanceId': invocation.get('hubInstanceId'),
182
+ 'taskRef': record['taskRef'], 'eventIds': [record['eventId']],
183
+ 'deviation': record.get('candidateDeviation'), 'tier': level})
184
+ action, judgment = _action_for(record, invocation)
185
+ # Gate O is the hard boundary: otherwise journal-only and no invoke/cancel.
186
+ if level in ('steer', 'surgical') and action != 'none' and judgment == 'confirmed':
187
+ request = {'requestId': request_id(record, invocation.get('profileKey'), transport.owner, invocation.get('hubInstanceId')), 'action': action,
188
+ 'taskId': record['taskRef']['taskId'], 'generation': record['taskRef']['generation'],
189
+ 'profileKey': invocation.get('profileKey'), 'ownerSessionId': transport.owner,
190
+ 'hubInstanceId': invocation.get('hubInstanceId'),
191
+ 'parameters': {'assertionIds': [], 'evidenceEventIds': [record['eventId']],
192
+ 'instruction': 'Изпълни ограничената проверка и докладвай доказателства.'},
193
+ 'basis': {'deviation': record['candidateDeviation'], 'judgment': judgment}}
194
+ admit({**invocation, 'autonomy': level, 'ownerSessionId': transport.owner}, request, transport,
195
+ persist=lambda row: _safe_audit(audit_path, row))
196
+ if delivery_state(invocation.get('gateO'))['originDelivery'] and invocation.get('origin'):
197
+ try:
198
+ deliver(invocation['gateO'], invocation['origin'], bulgarian_summary(record), invocation.get('deliveryAdapter'))
199
+ except RuntimeError:
200
+ _safe_audit(audit_path, {'decision': 'delivery_refused', 'hubInstanceId': invocation.get('hubInstanceId'),
201
+ 'taskRef': record['taskRef'], 'tier': level})
202
+ for record in due_deviations(state, time.monotonic()):
203
+ _safe_audit(audit_path, {'decision': 'due_deviation', 'hubInstanceId': invocation.get('hubInstanceId'),
204
+ 'taskRef': record['taskRef'], 'deviation': record['candidateDeviation'], 'tier': level})
205
+ # Due deviations use the same exact table and recovery gate as event candidates.
206
+ if level == 'surgical' and gate_o_valid(invocation.get('gateO')) and record['candidateDeviation'] == 'stalled_progress':
207
+ key = _recovery_key(record['taskRef'])
208
+ transaction = recovery_transactions.get(key, {'taskId': record['taskRef']['taskId'], 'generation': record['taskRef']['generation'],
209
+ 'kind': 'native', 'ownerSessionId': transport.owner, 'profileKey': invocation.get('profileKey'),
210
+ 'hubInstanceId': invocation.get('hubInstanceId'), 'state': 'proposed'})
211
+ recovery = recover(transaction, transport, invocation.get('surgicalAllowlist', []), True,
212
+ persist=lambda row: _safe_audit(audit_path, row))
213
+ recovery_transactions[key] = recovery
214
+ _save_recovery(invocation, recovery_transactions)
215
+ _safe_audit(audit_path, {'decision': 'recovery_checked', 'hubInstanceId': invocation.get('hubInstanceId'),
216
+ 'taskRef': {'taskId': recovery['taskId'], 'generation': recovery['generation']}, 'recoveryState': recovery['state'], 'tier': level})
217
+ except (KeyError, TransportError, ValueError, OSError) as error:
218
+ _safe_audit(audit_path, {'decision': 'offline', 'hubInstanceId': invocation.get('hubInstanceId'),
219
+ 'deviation': 'route_unavailable'})
220
+ if once:
221
+ return {'foreground': True, 'offline': True, 'autonomy': level}
222
+ selector.select(timeout=.25)
223
+ if once:
224
+ return {'foreground': True, 'offline': False, 'autonomy': level, 'cursor': cursor}
225
+ return {'foreground': True, 'stopped': True, 'autonomy': level}
226
+ finally:
227
+ signal.signal(signal.SIGINT, old_handler)
228
+ selector.close(); os.close(read_fd); os.close(write_fd); os.close(lock_fd)
229
+ try: lock_path.unlink()
230
+ except FileNotFoundError: pass
231
+
232
+
233
+ def main(argv=None):
234
+ parser = argparse.ArgumentParser()
235
+ parser.add_argument('command', choices=['status', 'validate-config', 'watch'])
236
+ parser.add_argument('--invocation-json')
237
+ parser.add_argument('--once', action='store_true', help=argparse.SUPPRESS)
238
+ args = parser.parse_args(argv)
239
+ try:
240
+ invocation, level = safe_invocation(args.invocation_json)
241
+ result = {'ok': True, 'autonomy': level, **delivery_state(invocation.get('gateO'))}
242
+ if args.command == 'watch':
243
+ result.update(run_watch(invocation, level, once=args.once))
244
+ except ValueError as error:
245
+ print(json.dumps({'ok': False, 'error': str(error)}, sort_keys=True)); return 2
246
+ print(json.dumps(result, sort_keys=True)); return 0
247
+
248
+ if __name__ == '__main__':
249
+ raise SystemExit(main())
@@ -0,0 +1,124 @@
1
+ """Closed typed invoke admission; watcher never calls tools or shell."""
2
+ import hashlib
3
+ import json
4
+
5
+ from watchdog_contract import gate_o_valid
6
+
7
+ # Exact plan table: a deviation can only request its declared maximum action.
8
+ MAXIMUM_ACTION = {
9
+ 'stalled_progress': 'request_status', 'silent_progress': 'request_status',
10
+ 'blocked_waiting_human': 'none', 'verification_gap': 'request_verification',
11
+ 'scope_drift': 'narrow_scope', 'repeated_failure': 'request_specialist',
12
+ 'research_gap': 'request_research', 'queue_starvation': 'request_status',
13
+ 'capacity_mismatch': 'none', 'recovery_loop': 'none', 'owner_offline': 'none',
14
+ 'stale_generation': 'none', 'route_unavailable': 'none', 'unsafe_action_request': 'none',
15
+ }
16
+ ACTIONS = set(MAXIMUM_ACTION.values()) - {'none'}
17
+ IDENTITY_KEYS = ('profileKey', 'ownerSessionId', 'hubInstanceId')
18
+ TERMINAL_STATES = {'completed', 'failed', 'cancelled', 'orphaned'}
19
+ # Authority a typed request must never carry, whatever the caller supplies.
20
+ FORBIDDEN_REQUEST_KEYS = ('token', 'origin', 'route', 'routeId', 'prompt', 'command', 'shell', 'herdr', 'tool')
21
+
22
+
23
+ def request_digest(request):
24
+ """Canonical digest over the exact request that will be transported."""
25
+ canonical = json.dumps(request, sort_keys=True, separators=(',', ':')).encode()
26
+ return 'sha256:' + hashlib.sha256(canonical).hexdigest()
27
+
28
+
29
+ def transport_identity(transport):
30
+ """Identity as the live discovery/transport reports it, not as a caller claims."""
31
+ return {
32
+ 'profileKey': getattr(transport, 'profile_key', None),
33
+ 'ownerSessionId': getattr(transport, 'owner', None),
34
+ 'hubInstanceId': getattr(transport, 'hub_instance_id', None),
35
+ }
36
+
37
+
38
+ def _identity_matches(config, request, identity):
39
+ """Config, request, and the live transport must agree on every identity key."""
40
+ for key in IDENTITY_KEYS:
41
+ expected = config.get(key)
42
+ if not isinstance(expected, str) or not expected:
43
+ return False
44
+ if request.get(key) != expected:
45
+ return False
46
+ if identity.get(key) != expected:
47
+ return False
48
+ return True
49
+
50
+
51
+ def allow(config, request, transport, online=True):
52
+ """Pure admission check. Makes no transport call, so observe/shadow stay silent."""
53
+ if not online or not gate_o_valid(config.get('gateO')):
54
+ return False
55
+ autonomy = config.get('autonomy', 'observe')
56
+ maximum = config.get('maximumAutonomy', 'observe')
57
+ if autonomy not in ('steer', 'surgical') or maximum not in ('steer', 'surgical'):
58
+ return False
59
+ if request.get('action') not in ACTIONS or request.get('cancel'):
60
+ return False
61
+ basis = request.get('basis')
62
+ if not isinstance(basis, dict) or basis.get('deviation') not in MAXIMUM_ACTION:
63
+ return False
64
+ if request['action'] != MAXIMUM_ACTION[basis['deviation']]:
65
+ return False
66
+ if not isinstance(request.get('taskId'), str) or not request['taskId']:
67
+ return False
68
+ if not isinstance(request.get('generation'), int) or request['generation'] <= 0:
69
+ return False
70
+ parameters = request.get('parameters')
71
+ if not isinstance(parameters, dict) or set(parameters) - {'assertionIds', 'evidenceEventIds', 'instruction'}:
72
+ return False
73
+ for key, maximum in (('assertionIds', 20), ('evidenceEventIds', 20)):
74
+ values = parameters.get(key)
75
+ if not isinstance(values, list) or len(values) > maximum or not all(isinstance(value, str) and 0 < len(value) <= 128 for value in values):
76
+ return False
77
+ if not isinstance(parameters.get('instruction'), str) or not parameters['instruction'] or len(parameters['instruction']) > 1024:
78
+ return False
79
+ if any(key in request for key in FORBIDDEN_REQUEST_KEYS):
80
+ return False
81
+ return _identity_matches(config, request, transport_identity(transport))
82
+
83
+
84
+ def _target_current(transport, request):
85
+ """Fresh read: the exact generation must still exist, be owned, and not be terminal."""
86
+ try:
87
+ rows = transport.snapshot(request['taskId'])
88
+ except Exception:
89
+ return False
90
+ if not isinstance(rows, list):
91
+ return False
92
+ if any(isinstance(row, dict) and row.get('generation', 0) > request['generation'] for row in rows):
93
+ return False
94
+ exact = next((row for row in rows if isinstance(row, dict) and row.get('generation') == request['generation']), None)
95
+ if not isinstance(exact, dict) or exact.get('state') in TERMINAL_STATES:
96
+ return False
97
+ # Snapshot rows name the Hub-authoritative owner session explicitly. Never
98
+ # accept a similarly named caller-provided `ownerId`.
99
+ return exact.get('ownerSessionId') == request['ownerSessionId']
100
+
101
+
102
+ def admit(config, request, transport, online=True, persist=None):
103
+ """
104
+ Durability precedes transport: the canonical digest and the proposed decision
105
+ are persisted before the first transport call. Ambiguous failure is refusal,
106
+ never a retry.
107
+ """
108
+ if not allow(config, request, transport, online):
109
+ return {'status': 'refused'}
110
+ if persist is None:
111
+ return {'status': 'refused'}
112
+ try:
113
+ persist({'decision': 'invoke_proposed', 'requestId': request.get('requestId'),
114
+ 'parametersDigest': request_digest(request), 'hubInstanceId': request['hubInstanceId'],
115
+ 'taskRef': {'taskId': request['taskId'], 'generation': request['generation']}})
116
+ except Exception:
117
+ return {'status': 'refused'}
118
+ if not _target_current(transport, request):
119
+ return {'status': 'refused'}
120
+ try:
121
+ result = transport.invoke(request)
122
+ except Exception:
123
+ return {'status': 'refused'}
124
+ return result if isinstance(result, dict) else {'status': 'refused'}
@@ -0,0 +1,76 @@
1
+ """Closed, stdlib-only contracts for the fail-closed watchdog."""
2
+ import hashlib
3
+ import json
4
+ import re
5
+ import stat
6
+ from datetime import datetime, timezone
7
+ from pathlib import Path
8
+
9
+ MAX_FRAME = 65536
10
+ SECRET_MARKER = re.compile(r'(?:token|bearer|secret|password|authorization|api[_-]?key)\s*[=:]', re.I)
11
+
12
+ REQUIRED_GATE_O_OBSERVATIONS = frozenset({
13
+ 'opaqueOrigin', 'threeIncrementalUpdates', 'wakeReconnect',
14
+ 'profileIsolation', 'twoChatIsolation', 'structuredInvocation',
15
+ })
16
+
17
+ def safe_file(path: Path, root: Path):
18
+ root = root.resolve(strict=True)
19
+ if path.is_symlink():
20
+ raise ValueError('unsafe_file')
21
+ path = path.resolve(strict=True)
22
+ if root not in (path, *path.parents):
23
+ raise ValueError('path_escape')
24
+ value = path.stat()
25
+ if not stat.S_ISREG(value.st_mode) or value.st_mode & 0o077:
26
+ raise ValueError('unsafe_file')
27
+ return path
28
+
29
+ def _parse_time(value):
30
+ if not isinstance(value, str):
31
+ raise ValueError('expired')
32
+ try:
33
+ return datetime.fromisoformat(value.replace('Z', '+00:00')).astimezone(timezone.utc)
34
+ except ValueError as error:
35
+ raise ValueError('expired') from error
36
+
37
+ def validate_discovery(root, value, now):
38
+ if not isinstance(value, dict) or set(value) != {'owner', 'socket', 'token', 'lease'}:
39
+ raise ValueError('discovery')
40
+ if not isinstance(value['owner'], str) or not value['owner']:
41
+ raise ValueError('discovery')
42
+ if not isinstance(value['socket'], str) or not value['socket'].startswith('@runtime/s/') or not value['socket'].endswith('/s'):
43
+ raise ValueError('discovery')
44
+ if not isinstance(value['token'], str) or not value['token'].startswith('token-'):
45
+ raise ValueError('discovery')
46
+ lease = value['lease']
47
+ if not isinstance(lease, dict) or not isinstance(lease.get('hub'), str):
48
+ raise ValueError('discovery')
49
+ current = _parse_time(now) if isinstance(now, str) else now.astimezone(timezone.utc)
50
+ if _parse_time(lease.get('expiresAt')) <= current:
51
+ raise ValueError('expired')
52
+ return value
53
+
54
+ def route_hash(profile, origin):
55
+ if not isinstance(origin, dict) or not {'channel', 'chatId', 'sessionId'} <= set(origin):
56
+ raise ValueError('origin')
57
+ return 'sha256:' + hashlib.sha256((profile + '\0' + json.dumps(origin, sort_keys=True, separators=(',', ':'))).encode()).hexdigest()
58
+
59
+ def gate_o_valid(artifact):
60
+ """Match the TypeScript Gate O validator; self-declared validity is not trust."""
61
+ if not isinstance(artifact, dict) or artifact.get('unsupported') is True or artifact.get('synthetic') is True:
62
+ return False
63
+ api = artifact.get('api')
64
+ observations = artifact.get('observations')
65
+ evidence_ids = artifact.get('evidenceIds')
66
+ def safe(value, maximum):
67
+ return (isinstance(value, str) and value == value.strip() and 0 < len(value) <= maximum
68
+ and SECRET_MARKER.search(value) is None)
69
+ api_safe = (isinstance(api, dict) and safe(api.get('kind'), 64) and safe(api.get('name'), 128)
70
+ and safe(api.get('argumentShape'), 256) and not re.search(r'\bsend\s+--to\b', api['name'], re.I))
71
+ evidence_safe = (isinstance(evidence_ids, list) and len(evidence_ids) >= 2
72
+ and all(safe(item, 256) for item in evidence_ids))
73
+ return bool(api_safe and isinstance(observations, dict)
74
+ and all(observations.get(key) is True for key in REQUIRED_GATE_O_OBSERVATIONS)
75
+ and evidence_safe and artifact.get('originDelivery') is True
76
+ and safe(artifact.get('liveRunId'), 256))
@@ -0,0 +1,10 @@
1
+ from watchdog_contract import gate_o_valid
2
+
3
+ def delivery_state(artifact):
4
+ valid=gate_o_valid(artifact)
5
+ return {'originDelivery':valid,'disposition':'origin-delivery-enabled' if valid else 'journal-only-no-steering'}
6
+ def deliver(artifact,route,message,adapter=None):
7
+ # There is intentionally no built-in Hermes API. A live-proven adapter is required.
8
+ if not gate_o_valid(artifact) or adapter is None: raise RuntimeError('origin delivery unavailable without live Gate O')
9
+ if not isinstance(route,dict) or not {'channel','chatId','sessionId'}<=set(route): raise RuntimeError('invalid_origin_route')
10
+ return adapter(route,message)
@@ -0,0 +1,128 @@
1
+ """Pure deterministic material-event reducer; it never selects an action."""
2
+ from collections import deque
3
+ from datetime import datetime, timezone
4
+ import time
5
+
6
+ TRANSITIONS = {'task.state_changed', 'task.started', 'hub.turn_started', 'hub.turn_completed',
7
+ 'owner.lease_changed', 'action.accepted', 'action.rejected'}
8
+ # The complete plan deviation table. These names are facts/candidates only, never actions.
9
+ DEVIATIONS = frozenset({'stalled_progress', 'silent_progress', 'blocked_waiting_human',
10
+ 'verification_gap', 'scope_drift', 'repeated_failure', 'research_gap', 'queue_starvation',
11
+ 'capacity_mismatch', 'recovery_loop', 'owner_offline', 'stale_generation',
12
+ 'route_unavailable', 'unsafe_action_request'})
13
+ CRITICAL = frozenset({'owner_offline', 'route_unavailable', 'unsafe_action_request', 'recovery_loop'})
14
+
15
+
16
+ def _state(value):
17
+ value = dict(value)
18
+ value.setdefault('seen_ids', deque(maxlen=4096)); value.setdefault('seen_set', set(value['seen_ids']))
19
+ value.setdefault('latest_generation', {}); value.setdefault('last_material', {}); value.setdefault('last_output', {})
20
+ value.setdefault('task_state', {}); value.setdefault('cooldowns', {}); value.setdefault('route_times', deque())
21
+ value.setdefault('offline', deque()); value.setdefault('offline_bytes', 0); value.setdefault('last_monotonic', float('-inf'))
22
+ return value
23
+
24
+
25
+ def _candidate(event, task, newest):
26
+ kind, target = event.get('kind'), task.get('toState')
27
+ if task.get('generation', 0) < newest or kind == 'task.generation_superseded': return 'stale_generation'
28
+ if kind == 'task.state_changed' and target == 'blocked': return 'blocked_waiting_human'
29
+ if kind == 'task.state_changed' and target == 'failed': return 'repeated_failure'
30
+ if kind == 'hub.capability_changed': return 'capacity_mismatch'
31
+ if kind == 'owner.orphaned': return 'owner_offline'
32
+ if kind == 'owner.recovering': return 'recovery_loop'
33
+ if kind == 'action.rejected': return 'unsafe_action_request'
34
+ if kind == 'hub.queue_depth_changed' and event.get('queueDepth', 0) > 0: return 'queue_starvation'
35
+ if kind == 'task.output_advanced' and event.get('completionIntent') and not event.get('assertionEvidence'): return 'verification_gap'
36
+ if kind == 'task.output_advanced' and event.get('scopeWatchdog'): return 'scope_drift'
37
+ if kind == 'task.output_advanced' and event.get('researchMissing'): return 'research_gap'
38
+ if kind == 'route.unavailable': return 'route_unavailable'
39
+ return None
40
+
41
+
42
+ def _allowed(state, record, now):
43
+ deviation = record.get('candidateDeviation')
44
+ if not deviation: return True
45
+ severity = 'critical' if deviation in CRITICAL else 'info' if deviation == 'blocked_waiting_human' else 'warning'
46
+ task = record['taskRef']; key = (task['taskId'], task['generation'], deviation)
47
+ # per-task policy: info 60s, warning 15s, critical duplicate 5m
48
+ floor = 300 if severity == 'critical' else 60 if severity == 'info' else 15
49
+ if now - state['cooldowns'].get(key, float('-inf')) < floor: return False
50
+ route = state['route_times']
51
+ while route and now - route[0] > 3600: route.popleft()
52
+ if len(route) >= 30 or sum(item > now - 60 for item in route) >= 6: return False
53
+ state['cooldowns'][key] = now; route.append(now); record['severity'] = severity
54
+ return True
55
+
56
+
57
+ def _buffer_offline(state, record):
58
+ raw = str(record).encode('utf-8')
59
+ if len(raw) > 262144: return
60
+ state['offline'].append(record); state['offline_bytes'] += len(raw)
61
+ while len(state['offline']) > 100 or state['offline_bytes'] > 262144:
62
+ state['offline_bytes'] -= len(str(state['offline'].popleft()).encode('utf-8'))
63
+
64
+
65
+ def drain_offline(value):
66
+ state = _state(value); records = list(state['offline'])
67
+ state['offline'].clear(); state['offline_bytes'] = 0
68
+ return state, records
69
+
70
+
71
+ def reduce_event(value, event, now, online=True):
72
+ state = _state(value)
73
+ # monotonic rollback must never reopen cooldowns/timers.
74
+ now = max(now, state['last_monotonic']); state['last_monotonic'] = now
75
+ sequence, event_id = event.get('eventSequence'), event.get('eventId')
76
+ if not isinstance(sequence, int) or sequence <= state.get('sequence', 0) or not isinstance(event_id, str) or event_id in state['seen_set']:
77
+ return state, []
78
+ state['sequence'] = sequence
79
+ if len(state['seen_ids']) == state['seen_ids'].maxlen: state['seen_set'].discard(state['seen_ids'][0])
80
+ state['seen_ids'].append(event_id); state['seen_set'].add(event_id)
81
+ task = event.get('task') or {}; task_id, generation = task.get('id'), task.get('generation')
82
+ if not isinstance(task_id, str) or not isinstance(generation, int): return state, []
83
+ key = (task_id, generation); newest = max(state['latest_generation'].get(task_id, 0), generation)
84
+ state['latest_generation'][task_id] = newest
85
+ occurred = event.get('occurredAt')
86
+ try:
87
+ occurred_at = datetime.fromisoformat(occurred.replace('Z', '+00:00')).astimezone(timezone.utc).timestamp()
88
+ except (AttributeError, ValueError):
89
+ # Missing/malformed Hub time is history only: never an actionable candidate.
90
+ occurred_at = float('-inf')
91
+ age = max(0, time.time() - occurred_at)
92
+ material = event.get('kind') in TRANSITIONS or event.get('kind') in {'hub.capability_changed', 'owner.orphaned', 'owner.recovering', 'task.generation_superseded', 'route.unavailable', 'hub.queue_depth_changed'}
93
+ if event.get('kind') == 'task.output_advanced':
94
+ material = now - state['last_output'].get(key, float('-inf')) >= 2
95
+ state['last_output'][key] = now
96
+ if not material: return state, []
97
+ target_state = task.get('toState', state['task_state'].get(key))
98
+ state['task_state'][key] = target_state
99
+ if event.get('kind') == 'task.state_changed' and target_state in {'completed', 'blocked', 'failed', 'cancelled', 'orphaned'}:
100
+ # Terminal generations cannot stall; retaining them grows this state forever.
101
+ state['last_material'].pop(key, None)
102
+ state['last_output'].pop(key, None)
103
+ else:
104
+ state['last_material'][key] = now
105
+ candidate = _candidate(event, task, newest)
106
+ stale = age > 120 or generation < newest
107
+ if stale: candidate = None
108
+ record = {'eventId': event_id, 'taskRef': {'taskId': task_id, 'generation': generation}, 'candidateDeviation': candidate, 'stale': stale}
109
+ if not _allowed(state, record, now): return state, []
110
+ if not online: _buffer_offline(state, record); return state, []
111
+ return state, [record]
112
+
113
+
114
+ def due_deviations(value, now, stall_seconds=600, online=True):
115
+ state = _state(value); now = max(now, state['last_monotonic']); state['last_monotonic'] = now; output = []
116
+ for key, last in state['last_material'].items():
117
+ candidate = 'silent_progress' if key in state['last_output'] and now - state['last_output'][key] >= 300 and state['last_output'][key] >= last else 'stalled_progress'
118
+ if now - last >= stall_seconds:
119
+ record = {'taskRef': {'taskId': key[0], 'generation': key[1]}, 'candidateDeviation': candidate}
120
+ if _allowed(state, record, now):
121
+ if online: output.append(record)
122
+ else: _buffer_offline(state, record)
123
+ return output
124
+
125
+
126
+ def bulgarian_summary(record):
127
+ ref = record.get('taskRef', {})
128
+ return f"ℹ️ задача `{ref.get('taskId', '?')}`, поколение {ref.get('generation', '?')}: {record.get('candidateDeviation') or 'съществена промяна'}."
@@ -0,0 +1,41 @@
1
+ """Bounded semantic classification contract; invalid answers are no-ops."""
2
+ import json
3
+
4
+ from watchdog_actions import MAXIMUM_ACTION
5
+ ACTIONS = {'none', 'request_status', 'request_verification', 'narrow_scope', 'request_research', 'request_specialist'}
6
+ FORBIDDEN = ('token', 'route', 'prompt', 'transcript', 'toolarg', 'chatid', 'sessionid')
7
+
8
+
9
+ def request(candidate, events, output='', task_ref=None):
10
+ if not isinstance(candidate, str) or not isinstance(events, list) or len(events) > 20:
11
+ raise ValueError('evidence_bounds')
12
+ if not isinstance(output, str) or len(output.encode()) > 4096:
13
+ raise ValueError('evidence_bounds')
14
+ if not isinstance(task_ref or {}, dict) or not isinstance((task_ref or {}).get('generation'), (int, type(None))):
15
+ raise ValueError('evidence_bounds')
16
+ if any(not isinstance(item, str) or any(word in item.lower() for word in FORBIDDEN) for item in events):
17
+ raise ValueError('unsafe_evidence')
18
+ evidence = json.dumps(events, separators=(',', ':')).encode()
19
+ if len(evidence) > 8192 or any(word in output.lower() for word in FORBIDDEN):
20
+ raise ValueError('evidence_bounds')
21
+ return {'schema': 'agent-fleet.watchdog-judgment-request', 'schemaVersion': 1,
22
+ 'candidateDeviation': candidate, 'taskRef': task_ref or {},
23
+ 'evidence': {'events': events, 'publicOutputSuffix': output, 'truncated': False},
24
+ 'allowedRecommendations': sorted({'none', MAXIMUM_ACTION.get(candidate, 'none')})}
25
+
26
+
27
+ def response(value, deviation, event_ids):
28
+ try:
29
+ parsed = json.loads(value) if isinstance(value, str) else value
30
+ confidence = parsed.get('confidence') if isinstance(parsed, dict) else None
31
+ supplied = parsed.get('evidenceEventIds') if isinstance(parsed, dict) else None
32
+ if (not isinstance(parsed, dict) or parsed.get('deviation') != deviation or
33
+ parsed.get('verdict') != 'confirmed' or parsed.get('recommendedAction') not in ACTIONS or
34
+ parsed.get('recommendedAction') not in {'none', MAXIMUM_ACTION.get(deviation, 'none')} or
35
+ isinstance(confidence, bool) or not isinstance(confidence, (float, int)) or confidence < .8 or
36
+ not isinstance(supplied, list) or not supplied or not all(isinstance(item, str) for item in supplied) or
37
+ not set(supplied).issubset(set(event_ids))):
38
+ raise ValueError('invalid_judgment')
39
+ return parsed
40
+ except Exception:
41
+ return {'verdict': 'none', 'recommendedAction': 'none'}