@chankov/agent-fleet 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/agents/model-profiles.yaml +2 -2
- package/.pi/harnesses/agent-hub/README.md +12 -3
- package/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
- package/.pi/harnesses/agent-hub/index.ts +121 -57
- package/.pi/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/agent-hub/run-budget.js +61 -0
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/fleet-dashboard-ops.ts +37 -0
- package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
- package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
- package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
- package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
- package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
- package/.versions/1.0.1/.pi/extensions/package.json +9 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
- package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
- package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
- package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
- package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
- package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
- package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
- package/.versions/1.0.1/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/1.0.1/.pi/prompts/af-plan.md +16 -0
- package/.versions/1.0.1/.pi/prompts/af-review.md +16 -0
- package/.versions/1.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
- package/.versions/1.0.1/.pi/prompts/af-spec.md +15 -0
- package/.versions/1.0.1/.pi/prompts/af-test.md +19 -0
- package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/1.0.1/.version +1 -0
- package/.versions/1.0.1/agents/architect.md +24 -0
- package/.versions/1.0.1/agents/bowser.md +27 -0
- package/.versions/1.0.1/agents/builder.md +54 -0
- package/.versions/1.0.1/agents/code-reviewer.md +208 -0
- package/.versions/1.0.1/agents/deep-researcher.md +32 -0
- package/.versions/1.0.1/agents/documenter.md +18 -0
- package/.versions/1.0.1/agents/orchestrator.md +72 -0
- package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
- package/.versions/1.0.1/agents/planner.md +70 -0
- package/.versions/1.0.1/agents/releaser.md +24 -0
- package/.versions/1.0.1/agents/researcher.md +28 -0
- package/.versions/1.0.1/agents/security-auditor.md +167 -0
- package/.versions/1.0.1/agents/test-engineer.md +153 -0
- package/.versions/1.0.1/agents/web-debugger.md +43 -0
- package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
- package/.versions/1.0.1/bin/catalog/harness-runtime-closure.json +38 -0
- package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
- package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
- package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
- package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
- package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
- package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
- package/.versions/1.0.1/docs/getting-started.md +98 -0
- package/.versions/1.0.1/docs/npm-install.md +292 -0
- package/.versions/1.0.1/docs/pi-extensions.md +412 -0
- package/.versions/1.0.1/docs/pi-setup.md +74 -0
- package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
- package/.versions/1.0.1/hermes/README.md +347 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/1.0.1/install-manifest.json +2745 -0
- package/.versions/1.0.1/justfile +272 -0
- package/.versions/1.0.1/manifest-meta.json +882 -0
- package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/1.0.1/references/definition-of-done.md +67 -0
- package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/1.0.1/references/observability-checklist.md +91 -0
- package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/1.0.1/references/performance-checklist.md +153 -0
- package/.versions/1.0.1/references/prompting-patterns.md +380 -0
- package/.versions/1.0.1/references/security-checklist.md +179 -0
- package/.versions/1.0.1/references/testing-patterns.md +236 -0
- package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
- package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
- package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
- package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/1.0.1/scripts/fleet.ts +185 -0
- package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
- package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
- package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
- package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
- package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
- package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
- package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
- package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
- package/.versions/1.0.1/scripts/team-up.ts +406 -0
- package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
- package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
- package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
- package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
- package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +6 -0
- package/agents/code-reviewer.md +1 -1
- package/agents/deep-researcher.md +1 -1
- package/agents/plan-reviewer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/security-auditor.md +1 -1
- package/agents/test-engineer.md +1 -1
- package/install-manifest.json +1 -1
- package/package.json +2 -2
|
@@ -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'}
|