@chankov/agent-fleet 2.0.6 → 2.0.7
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/harnesses/agent-hub/package.json +1 -1
- package/.pi/harnesses/coms/package.json +1 -1
- package/.pi/harnesses/damage-control-continue/README.md +11 -0
- package/.pi/harnesses/damage-control-continue/index.ts +5 -0
- package/.pi/harnesses/damage-control-continue/package.json +1 -1
- package/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.7/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/2.0.7/.pi/agents/model-profiles.yaml +83 -0
- package/.versions/2.0.7/.pi/agents/peers.yaml +145 -0
- package/.versions/2.0.7/.pi/agents/teams.yaml +41 -0
- package/.versions/2.0.7/.pi/agents/voices.yaml +13 -0
- package/.versions/2.0.7/.pi/damage-control-rules.yaml +297 -0
- package/.versions/2.0.7/.pi/extensions/btw/README.md +120 -0
- package/.versions/2.0.7/.pi/extensions/btw/index.ts +914 -0
- package/{.pi/extensions/agent-fleet-update-check → .versions/2.0.7/.pi/extensions/btw}/package.json +1 -1
- package/.versions/2.0.7/.pi/extensions/btw/state.js +179 -0
- package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
- package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
- package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/2.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/2.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/2.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/2.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/package-lock.json +1175 -0
- package/.versions/2.0.7/.pi/extensions/package.json +9 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/README.md +205 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/2.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/README.md +1203 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/acceptance.ts +62 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/backend-policy.js +174 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context.ts +43 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/models.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/config/agents.ts +173 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/debate-command.ts +176 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/delegate.ts +446 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/docs-lane.js +122 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/external-blocker.js +85 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/footer.ts +30 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/helpers.ts +266 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/index.ts +2151 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/input/completions.ts +76 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/no-progress.ts +76 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/package.json +7 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/models.ts +153 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/poll-command.ts +176 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/presentation.ts +48 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research/controls.ts +74 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/review-findings.js +102 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/run-budget.js +537 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/run-namespace.js +87 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/scope-gate.js +123 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/session-start.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/spawn.ts +404 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/timeline.ts +54 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/context.ts +134 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/types.ts +63 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history.ts +234 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/version.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
- package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode.ts +167 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/README.md +59 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/index.ts +558 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/questions.ts +161 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/race-core.js +124 -0
- package/.versions/2.0.7/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
- package/.versions/2.0.7/.pi/harnesses/coms/README.md +100 -0
- package/.versions/2.0.7/.pi/harnesses/coms/index.ts +282 -0
- package/.versions/2.0.7/.pi/harnesses/coms/package.json +7 -0
- package/.versions/2.0.7/.pi/harnesses/coms/version.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/README.md +135 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/index.ts +541 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
- package/.versions/2.0.7/.pi/harnesses/damage-control-continue/version.ts +42 -0
- package/.versions/2.0.7/.pi/harnesses/lib/coms-core-io.ts +385 -0
- package/.versions/2.0.7/.pi/harnesses/lib/coms-core.ts +577 -0
- package/.versions/2.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget-view.ts +107 -0
- package/.versions/2.0.7/.pi/harnesses/lib/context-budget.ts +114 -0
- package/.versions/2.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-overlay.ts +26 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-panel.ts +34 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-read-model.ts +131 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-selection.ts +24 -0
- package/.versions/2.0.7/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
- package/.versions/2.0.7/.pi/harnesses/lib/herdr-client.ts +472 -0
- package/.versions/2.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
- package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
- package/.versions/2.0.7/.pi/harnesses/lib/spawned-peers.js +190 -0
- package/.versions/2.0.7/.pi/harnesses/lib/update-check.ts +222 -0
- package/.versions/2.0.7/.pi/harnesses/package-lock.json +2039 -0
- package/.versions/2.0.7/.pi/harnesses/package.json +10 -0
- package/.versions/2.0.7/.pi/prompts/af-build.md +24 -0
- package/.versions/2.0.7/.pi/prompts/af-code-simplify.md +22 -0
- package/.versions/2.0.7/.pi/prompts/af-plan.md +17 -0
- package/.versions/2.0.7/.pi/prompts/af-review.md +16 -0
- package/.versions/2.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
- package/.versions/2.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
- package/.versions/2.0.7/.pi/prompts/af-ship.md +17 -0
- package/.versions/2.0.7/.pi/prompts/af-spec.md +15 -0
- package/.versions/2.0.7/.pi/prompts/af-test.md +19 -0
- package/.versions/2.0.7/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/2.0.7/.version +1 -0
- package/.versions/2.0.7/agents/architect.md +25 -0
- package/.versions/2.0.7/agents/bowser.md +28 -0
- package/.versions/2.0.7/agents/builder.md +56 -0
- package/.versions/2.0.7/agents/code-reviewer.md +210 -0
- package/.versions/2.0.7/agents/deep-researcher.md +33 -0
- package/.versions/2.0.7/agents/documenter.md +23 -0
- package/.versions/2.0.7/agents/orchestrator.md +23 -0
- package/.versions/2.0.7/agents/plan-reviewer.md +84 -0
- package/.versions/2.0.7/agents/planner.md +106 -0
- package/.versions/2.0.7/agents/releaser.md +25 -0
- package/.versions/2.0.7/agents/researcher.md +31 -0
- package/.versions/2.0.7/agents/security-auditor.md +168 -0
- package/.versions/2.0.7/agents/test-engineer.md +154 -0
- package/.versions/2.0.7/agents/web-debugger.md +44 -0
- package/.versions/2.0.7/agents/web-performance-auditor.md +194 -0
- package/.versions/2.0.7/bin/catalog/harness-runtime-closure.json +31 -0
- package/.versions/2.0.7/codex/fleet-session-client/SKILL.md +34 -0
- package/.versions/2.0.7/codex/fleet-session-client.zip +0 -0
- package/.versions/2.0.7/docs/ARCHITECTURE.md +407 -0
- package/.versions/2.0.7/docs/agent-fleet-setup.md +561 -0
- package/.versions/2.0.7/docs/claude-code-coms-bridge.md +133 -0
- package/.versions/2.0.7/docs/codex-session-bridge.md +219 -0
- package/.versions/2.0.7/docs/coms-hermes-bridge.md +188 -0
- package/.versions/2.0.7/docs/getting-started.md +126 -0
- package/.versions/2.0.7/docs/npm-install.md +327 -0
- package/.versions/2.0.7/docs/pi-extensions.md +446 -0
- package/.versions/2.0.7/docs/pi-setup.md +76 -0
- package/.versions/2.0.7/docs/skill-anatomy.md +150 -0
- package/.versions/2.0.7/hermes/README.md +347 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
- package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
- package/.versions/2.0.7/hermes/gates/gate-o-capability.md +8 -0
- package/.versions/2.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
- package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
- package/.versions/2.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
- package/.versions/2.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
- package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
- package/.versions/2.0.7/hermes/watchdog-tests/__init__.py +0 -0
- package/.versions/2.0.7/hooks/coms-stop-hook.mjs +84 -0
- package/.versions/2.0.7/install-manifest.json +2886 -0
- package/.versions/2.0.7/justfile +247 -0
- package/.versions/2.0.7/manifest-meta.json +958 -0
- package/.versions/2.0.7/references/accessibility-checklist.md +160 -0
- package/.versions/2.0.7/references/communication-contract.md +26 -0
- package/.versions/2.0.7/references/definition-of-done.md +67 -0
- package/.versions/2.0.7/references/fleet-coordination-patterns.md +171 -0
- package/.versions/2.0.7/references/observability-checklist.md +91 -0
- package/.versions/2.0.7/references/orchestration-patterns.md +370 -0
- package/.versions/2.0.7/references/performance-checklist.md +153 -0
- package/.versions/2.0.7/references/prompting-patterns.md +380 -0
- package/.versions/2.0.7/references/security-checklist.md +179 -0
- package/.versions/2.0.7/references/testing-patterns.md +236 -0
- package/.versions/2.0.7/references/workflow-authoring.md +304 -0
- package/.versions/2.0.7/scripts/claude-code-preflight.ts +70 -0
- package/.versions/2.0.7/scripts/coms-claude-bridge.ts +411 -0
- package/.versions/2.0.7/scripts/coms-cli.ts +425 -0
- package/.versions/2.0.7/scripts/coms-hermes-bridge.ts +413 -0
- package/.versions/2.0.7/scripts/fleet-codex-client.ts +69 -0
- package/.versions/2.0.7/scripts/fleet-codex-read.py +146 -0
- package/.versions/2.0.7/scripts/fleet.ts +216 -0
- package/.versions/2.0.7/scripts/flow.ts +137 -0
- package/.versions/2.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
- package/.versions/2.0.7/scripts/hermes-monitor-scenario.ts +474 -0
- package/.versions/2.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
- package/.versions/2.0.7/scripts/install-hermes-plugin.sh +180 -0
- package/.versions/2.0.7/scripts/lib/claude-bridge-core.ts +210 -0
- package/.versions/2.0.7/scripts/lib/coms-envelope.ts +582 -0
- package/.versions/2.0.7/scripts/lib/fake-herdr-server.ts +88 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-catalog.ts +63 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-operations.ts +190 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-session.ts +166 -0
- package/.versions/2.0.7/scripts/lib/fleet-codex-transport.ts +124 -0
- package/.versions/2.0.7/scripts/lib/fleet-command.ts +252 -0
- package/.versions/2.0.7/scripts/lib/flow-command.ts +93 -0
- package/.versions/2.0.7/scripts/lib/flow-maintenance.ts +230 -0
- package/.versions/2.0.7/scripts/lib/herdr-layout.ts +281 -0
- package/.versions/2.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
- package/.versions/2.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
- package/.versions/2.0.7/scripts/lib/monitor-env.ts +146 -0
- package/.versions/2.0.7/scripts/lib/peer-launch.ts +318 -0
- package/.versions/2.0.7/scripts/lib/persona-banner.ts +62 -0
- package/.versions/2.0.7/scripts/lib/runtime-dependencies.js +124 -0
- package/.versions/2.0.7/scripts/lib/spawn-stagger.ts +101 -0
- package/.versions/2.0.7/scripts/lib/team-project.ts +178 -0
- package/.versions/2.0.7/scripts/lib/team-snapshot.ts +147 -0
- package/.versions/2.0.7/scripts/package-lock.json +35 -0
- package/.versions/2.0.7/scripts/package.json +9 -0
- package/.versions/2.0.7/scripts/peer-banner.ts +40 -0
- package/.versions/2.0.7/scripts/peer-launch.ts +285 -0
- package/.versions/2.0.7/scripts/team-snapshot.ts +237 -0
- package/.versions/2.0.7/scripts/team-up.ts +378 -0
- package/.versions/2.0.7/scripts/workflows/lib/agent-phase.ts +133 -0
- package/.versions/2.0.7/scripts/workflows/lib/changes.ts +61 -0
- package/.versions/2.0.7/scripts/workflows/lib/debate.ts +149 -0
- package/.versions/2.0.7/scripts/workflows/lib/env.ts +34 -0
- package/.versions/2.0.7/scripts/workflows/lib/envelopes.ts +169 -0
- package/.versions/2.0.7/scripts/workflows/lib/gates.ts +81 -0
- package/.versions/2.0.7/scripts/workflows/lib/git.ts +96 -0
- package/.versions/2.0.7/scripts/workflows/lib/merge.ts +95 -0
- package/.versions/2.0.7/scripts/workflows/lib/model-profile.ts +22 -0
- package/.versions/2.0.7/scripts/workflows/lib/model-visibility.ts +92 -0
- package/.versions/2.0.7/scripts/workflows/lib/permissions.ts +130 -0
- package/.versions/2.0.7/scripts/workflows/lib/personas.ts +57 -0
- package/.versions/2.0.7/scripts/workflows/lib/poll.ts +86 -0
- package/.versions/2.0.7/scripts/workflows/lib/quality.ts +64 -0
- package/.versions/2.0.7/scripts/workflows/lib/run.ts +108 -0
- package/.versions/2.0.7/scripts/workflows/lib/trace.ts +34 -0
- package/.versions/2.0.7/scripts/workflows/lib/voices.ts +128 -0
- package/.versions/2.0.7/scripts/workflows/lib/writer-lease.ts +112 -0
- package/.versions/2.0.7/scripts/workflows/tsconfig.json +22 -0
- package/.versions/2.0.7/scripts/workflows/wf-build-test.ts +61 -0
- package/.versions/2.0.7/scripts/workflows/wf-debate.ts +87 -0
- package/.versions/2.0.7/scripts/workflows/wf-document.ts +50 -0
- package/.versions/2.0.7/scripts/workflows/wf-poll.ts +95 -0
- package/.versions/2.0.7/scripts/workflows/wf-quality.ts +20 -0
- package/.versions/2.0.7/scripts/workflows/wf-scout.ts +38 -0
- package/.versions/2.0.7/skills/_internal/grilling.md +59 -0
- package/.versions/2.0.7/skills/browser-testing-with-devtools/SKILL.md +351 -0
- package/.versions/2.0.7/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/2.0.7/skills/compound-learning/SKILL.md +137 -0
- package/.versions/2.0.7/skills/context-engineering/SKILL.md +291 -0
- package/.versions/2.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/2.0.7/skills/designing-agents/SKILL.md +394 -0
- package/.versions/2.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
- package/.versions/2.0.7/skills/drafting-workflows/SKILL.md +143 -0
- package/.versions/2.0.7/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
- package/.versions/2.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/2.0.7/skills/idea-refine/SKILL.md +182 -0
- package/.versions/2.0.7/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.7/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.7/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.7/skills/incremental-implementation/SKILL.md +298 -0
- package/.versions/2.0.7/skills/interview-me/SKILL.md +226 -0
- package/.versions/2.0.7/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/2.0.7/skills/peer-coms/SKILL.md +90 -0
- package/.versions/2.0.7/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.7/skills/planning-and-task-breakdown/SKILL.md +265 -0
- package/.versions/2.0.7/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/2.0.7/skills/spec-driven-development/SKILL.md +256 -0
- package/.versions/2.0.7/skills/using-agent-skills/SKILL.md +197 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/2.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +8 -0
- package/README.md +14 -7
- package/bin/cli.js +149 -78
- package/bin/lib/apply.js +53 -62
- package/bin/lib/features.js +2 -2
- package/bin/lib/public-plan.js +17 -0
- package/bin/lib/purge.js +9 -3
- package/bin/lib/reconcile.js +4 -10
- package/bin/lib/repair-desired.js +73 -0
- package/bin/lib/stt-wizard.js +25 -11
- package/bin/lib/transaction.js +118 -108
- package/bin/lib/tui.js +70 -65
- package/bin/lib/update-notifier.js +2 -2
- package/bin/lib/workspace-safety.js +72 -0
- package/docs/npm-install.md +41 -15
- package/docs/pi-extensions.md +3 -3
- package/docs/pi-setup.md +2 -2
- package/install-manifest.json +1 -39
- package/justfile +3 -3
- package/manifest-meta.json +2 -20
- package/package.json +2 -2
- package/scripts/fleet.ts +1 -1
- package/.pi/extensions/agent-fleet-update-check/README.md +0 -57
- package/.pi/extensions/agent-fleet-update-check/index.ts +0 -161
package/bin/lib/apply.js
CHANGED
|
@@ -28,6 +28,7 @@ import { itemsForAgent } from "./manifest.js";
|
|
|
28
28
|
import { expandBinding } from "./verify.js";
|
|
29
29
|
import { extractRegion, replaceRegion, stripRegion, leafPaths, setPath, canonicalJson } from "./merge-forms.js";
|
|
30
30
|
import { runTransaction } from "./transaction.js";
|
|
31
|
+
import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
|
|
31
32
|
import { renderDesired } from "./desired.js";
|
|
32
33
|
import {
|
|
33
34
|
readState, writeState, emptyState, hashFile, hashText, walkTree,
|
|
@@ -35,26 +36,35 @@ import {
|
|
|
35
36
|
} from "./state.js";
|
|
36
37
|
|
|
37
38
|
export const APPLY_SCHEMA_VERSION = 1;
|
|
39
|
+
export const EXEC_TIMEOUT_MS = 120_000;
|
|
38
40
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
+
function manifestExec(manifest, agent, id) {
|
|
42
|
+
const item = itemsForAgent(manifest, agent).find((entry) => entry.id === id);
|
|
43
|
+
if (!item?.exec) throw new Error(`runtime repair ${id} is not authorized by the current manifest`);
|
|
44
|
+
return item.exec;
|
|
45
|
+
}
|
|
46
|
+
export function runTrustedExec({ workspace, spec, output, timeoutMs = EXEC_TIMEOUT_MS }) {
|
|
47
|
+
const display = `${spec.command} ${(spec.args ?? []).join(" ")}`.trim();
|
|
48
|
+
output(`starting ${display} (timeout ${timeoutMs}ms)`);
|
|
49
|
+
const run = spawnSync(spec.command, spec.args ?? [], { cwd: insideWorkspace(workspace, spec.cwd ?? "."), stdio: "pipe", encoding: "utf8", timeout: timeoutMs });
|
|
50
|
+
output(run.status === 0 ? `completed ${display}` : `failed ${display}`);
|
|
51
|
+
return { run, display };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** Retry only action IDs still authorized by the trusted current manifest. */
|
|
55
|
+
export function retryRuntimeRepairs({ workspace, manifest, output = console.log }) {
|
|
41
56
|
const state = readState(workspace);
|
|
42
57
|
const pending = state?.runtimeRepairs ?? [];
|
|
43
58
|
if (pending.length === 0) return { attempted: 0, remaining: [] };
|
|
44
|
-
|
|
45
59
|
const remaining = [];
|
|
46
60
|
for (const repair of pending) {
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
});
|
|
52
|
-
if (run.status !== 0) {
|
|
53
|
-
remaining.push({ ...repair, status: run.status ?? "signal", stderr: (run.stderr ?? "").trim() });
|
|
54
|
-
}
|
|
61
|
+
let spec;
|
|
62
|
+
try { spec = manifestExec(manifest, state.agent, repair.id); }
|
|
63
|
+
catch (error) { remaining.push({ id: repair.id, status: "unauthorized", detail: error.message }); continue; }
|
|
64
|
+
const { run, display } = runTrustedExec({ workspace, spec, output });
|
|
65
|
+
if (run.status !== 0) remaining.push({ id: repair.id, args: spec.args ?? [], cwd: spec.cwd ?? ".", display, status: run.error?.code === "ETIMEDOUT" ? "timeout" : run.status ?? run.signal ?? "failed", stderr: (run.stderr ?? "").trim() });
|
|
55
66
|
}
|
|
56
|
-
state.runtimeRepairs = remaining;
|
|
57
|
-
writeState(workspace, state);
|
|
67
|
+
state.runtimeRepairs = remaining; writeState(workspace, state);
|
|
58
68
|
return { attempted: pending.length, remaining };
|
|
59
69
|
}
|
|
60
70
|
|
|
@@ -68,7 +78,7 @@ export function retryRuntimeRepairs({ workspace, output = console.log }) {
|
|
|
68
78
|
* @param {() => string} [opts.now] injectable clock, for deterministic tests
|
|
69
79
|
* @returns {object} result
|
|
70
80
|
*/
|
|
71
|
-
export function applyPlan({ plan, manifest, allowExec = false, now = () => new Date().toISOString(), output = console.log, failAt = null }) {
|
|
81
|
+
export function applyPlan({ plan, manifest, allowExec = false, now = () => new Date().toISOString(), output = console.log, failAt = null, lockHeld = false }) {
|
|
72
82
|
const validate = () => {
|
|
73
83
|
if (plan.migrationBlocked) throw Object.assign(new Error(plan.migrationError), { exitCode: 1 });
|
|
74
84
|
if (plan.snapshotMetadataError) throw Object.assign(new Error(plan.snapshotMetadataError), { exitCode: 1 });
|
|
@@ -76,37 +86,34 @@ export function applyPlan({ plan, manifest, allowExec = false, now = () => new D
|
|
|
76
86
|
};
|
|
77
87
|
let result;
|
|
78
88
|
try {
|
|
79
|
-
result = runTransaction({ workspace: plan.workspace, plan, manifest, validate, failAt, commit: () => {
|
|
80
|
-
if (plan.writeDesired) writeFileSyncDeep(join(plan.workspace, ".ai", "agent-fleet.json"), renderDesired(plan.desired));
|
|
81
|
-
if (plan.overrides?.write) writeFileSyncDeep(plan.overrides.path, plan.overrides.text);
|
|
82
|
-
if (plan.stt)
|
|
83
|
-
|
|
84
|
-
if (plan.stt.env.missing.length) writeFileSyncDeep(plan.stt.env.path, plan.stt.env.text);
|
|
85
|
-
}
|
|
89
|
+
result = runTransaction({ workspace: plan.workspace, plan, manifest, validate, failAt, lockHeld, commit: () => {
|
|
90
|
+
if (plan.writeDesired) writeFileSyncDeep(join(plan.workspace, ".ai", "agent-fleet.json"), renderDesired(plan.desired), plan.workspace);
|
|
91
|
+
if (plan.overrides?.write) writeFileSyncDeep(plan.overrides.path, plan.overrides.text, plan.workspace);
|
|
92
|
+
if (plan.stt?.write) writeFileSyncDeep(plan.stt.path, plan.stt.text, plan.workspace);
|
|
93
|
+
if (plan.stt?.env?.missing?.length) writeFileSyncDeep(plan.stt.env.path, plan.stt.env.text, plan.workspace);
|
|
86
94
|
return applyImmediate({ plan, manifest, allowExec: false, now });
|
|
87
95
|
} });
|
|
88
96
|
} catch (error) {
|
|
97
|
+
const status = error.postCommit ? "committed-cleanup-incomplete" : error.rollbackFailed ? "rollback-failed" : "rolled-back";
|
|
89
98
|
return { schemaVersion: APPLY_SCHEMA_VERSION, workspace: plan.workspace, verb: plan.verb,
|
|
90
|
-
results: [], conflictFiles: [], failure: { status
|
|
91
|
-
exitCode: error.exitCode ?? 1, summary: { applied: 0, failed: 1 } };
|
|
99
|
+
results: [], conflictFiles: [], failure: { status, detail: error.message },
|
|
100
|
+
exitCode: error.exitCode ?? 1, summary: { applied: 0, failed: 1, notReached: 0 } };
|
|
92
101
|
}
|
|
93
102
|
if (!allowExec) return { ...result, exitCode: 0 };
|
|
94
103
|
|
|
95
104
|
const repairs = [];
|
|
96
105
|
for (const action of plan.actions.filter((entry) => entry.kind === "exec")) {
|
|
97
|
-
const
|
|
98
|
-
const
|
|
99
|
-
if (
|
|
100
|
-
const command = `${spec.command} ${(spec.args ?? []).join(" ")}`.trim();
|
|
101
|
-
output(command);
|
|
102
|
-
const run = spawnSync(spec.command, spec.args ?? [], { cwd: insideWorkspace(plan.workspace, spec.cwd ?? "."), stdio: "pipe", encoding: "utf8" });
|
|
103
|
-
if (run.status !== 0) repairs.push({ id: action.id, command: spec.command, args: spec.args ?? [], cwd: spec.cwd ?? ".", display: command, status: run.status ?? "signal", stderr: (run.stderr ?? "").trim() });
|
|
106
|
+
const spec = manifestExec(manifest, plan.agent, action.id);
|
|
107
|
+
const { run, display } = runTrustedExec({ workspace: plan.workspace, spec, output });
|
|
108
|
+
if (run.status !== 0) repairs.push({ id: action.id, display, status: run.error?.code === "ETIMEDOUT" ? "timeout" : run.status ?? run.signal ?? "failed", stderr: (run.stderr ?? "").trim() });
|
|
104
109
|
}
|
|
105
110
|
if (repairs.length) {
|
|
106
111
|
const state = readState(plan.workspace);
|
|
107
112
|
state.runtimeRepairs = repairs;
|
|
108
113
|
writeState(plan.workspace, state);
|
|
109
|
-
return { ...result, exitCode: 1, runtimeRepairs: repairs
|
|
114
|
+
return { ...result, exitCode: 1, runtimeRepairs: repairs,
|
|
115
|
+
failure: { id: repairs[0].id, status: "runtime-incomplete", detail: `files committed; ${repairs.length} runtime command(s) failed or timed out` },
|
|
116
|
+
summary: { ...result.summary, failed: repairs.length } };
|
|
110
117
|
}
|
|
111
118
|
const results = result.results.map((entry) => plan.actions.some((action) => action.id === entry.id && action.kind === "exec")
|
|
112
119
|
? { ...entry, status: "applied", detail: "command ran after file commit" }
|
|
@@ -114,7 +121,7 @@ export function applyPlan({ plan, manifest, allowExec = false, now = () => new D
|
|
|
114
121
|
return { ...result, results, exitCode: 0, runtimeRepairs: [] };
|
|
115
122
|
}
|
|
116
123
|
|
|
117
|
-
function applyImmediate({ plan, manifest,
|
|
124
|
+
function applyImmediate({ plan, manifest, now = () => new Date().toISOString() }) {
|
|
118
125
|
const { workspace, sourceRoot, agent, method, packageVersion } = plan;
|
|
119
126
|
const catalogue = new Map(itemsForAgent(manifest, agent).map((i) => [i.id, i]));
|
|
120
127
|
const previous = readState(workspace);
|
|
@@ -142,7 +149,7 @@ function applyImmediate({ plan, manifest, allowExec = false, now = () => new Dat
|
|
|
142
149
|
try {
|
|
143
150
|
const outcome = perform({
|
|
144
151
|
action, item: catalogue.get(action.id), state, workspace, sourceRoot,
|
|
145
|
-
method, agent,
|
|
152
|
+
method, agent, now,
|
|
146
153
|
});
|
|
147
154
|
results.push({ id: action.id, action: action.kind, ...outcome });
|
|
148
155
|
if (outcome.conflicts) conflictFiles.push(...outcome.conflicts);
|
|
@@ -202,7 +209,7 @@ function applyImmediate({ plan, manifest, allowExec = false, now = () => new Dat
|
|
|
202
209
|
|
|
203
210
|
// ── one action ──────────────────────────────────────────────────────────────
|
|
204
211
|
|
|
205
|
-
function perform({ action, item, state, workspace, sourceRoot, method, agent,
|
|
212
|
+
function perform({ action, item, state, workspace, sourceRoot, method, agent, now }) {
|
|
206
213
|
switch (action.kind) {
|
|
207
214
|
case "create":
|
|
208
215
|
case "refresh":
|
|
@@ -263,25 +270,10 @@ function perform({ action, item, state, workspace, sourceRoot, method, agent, al
|
|
|
263
270
|
case "remove":
|
|
264
271
|
return removeItem({ id: action.id, state, workspace, sourceRoot });
|
|
265
272
|
|
|
266
|
-
case "exec":
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
const cwd = insideWorkspace(workspace, spec.cwd ?? ".");
|
|
271
|
-
const run = spawnSync(spec.command, spec.args ?? [], { cwd, stdio: "pipe", encoding: "utf8" });
|
|
272
|
-
if (run.status !== 0) {
|
|
273
|
-
throw new Error(
|
|
274
|
-
`${spec.command} ${(spec.args ?? []).join(" ")} exited ${run.status ?? "on signal"}: ` +
|
|
275
|
-
`${(run.stderr ?? "").trim().split("\n").slice(-3).join(" ") || "no output"}`,
|
|
276
|
-
);
|
|
277
|
-
}
|
|
278
|
-
state.items[action.id] = {
|
|
279
|
-
kind: item.kind, strategy: "exec", method: "exec",
|
|
280
|
-
version: state.packageVersion, files: [],
|
|
281
|
-
lastRun: { at: now(), command: `${spec.command} ${(spec.args ?? []).join(" ")}`.trim() },
|
|
282
|
-
};
|
|
283
|
-
return { status: "applied", detail: "command ran" };
|
|
284
|
-
}
|
|
273
|
+
case "exec":
|
|
274
|
+
// Runtime execution happens only after the durable file commit through
|
|
275
|
+
// runTrustedExec(), which owns timeout/progress/failure reporting.
|
|
276
|
+
return { status: "skipped", detail: "exec deferred until after file commit" };
|
|
285
277
|
|
|
286
278
|
case "external": {
|
|
287
279
|
const spec = item?.package;
|
|
@@ -501,7 +493,7 @@ function writeManagedRegion({ binding, workspace, sourceRoot }) {
|
|
|
501
493
|
|
|
502
494
|
const targetAbs = insideWorkspace(workspace, binding.target);
|
|
503
495
|
const existing = existsSync(targetAbs) ? readFileSync(targetAbs, "utf8") : "";
|
|
504
|
-
writeFileSyncDeep(targetAbs, replaceRegion(existing, region.block));
|
|
496
|
+
writeFileSyncDeep(targetAbs, replaceRegion(existing, region.block), workspace);
|
|
505
497
|
|
|
506
498
|
return {
|
|
507
499
|
files: [{
|
|
@@ -537,7 +529,7 @@ function mergeJson({ binding, workspace, sourceRoot }) {
|
|
|
537
529
|
sha256: hashText(canonicalJson(value)),
|
|
538
530
|
});
|
|
539
531
|
}
|
|
540
|
-
writeFileSyncDeep(targetAbs, JSON.stringify(target, null, 2) + "\n");
|
|
532
|
+
writeFileSyncDeep(targetAbs, JSON.stringify(target, null, 2) + "\n", workspace);
|
|
541
533
|
|
|
542
534
|
return { files: [], jsonKeys };
|
|
543
535
|
}
|
|
@@ -555,7 +547,7 @@ function writeConflictCopies({ item, action, workspace, sourceRoot, agent }) {
|
|
|
555
547
|
const emit = (targetRel, contents) => {
|
|
556
548
|
if (!conflicted.has(targetRel)) return;
|
|
557
549
|
const dest = insideWorkspace(workspace, `${targetRel}.new`);
|
|
558
|
-
writeFileSyncDeep(dest, contents);
|
|
550
|
+
writeFileSyncDeep(dest, contents, workspace);
|
|
559
551
|
written.push(`${targetRel}.new`);
|
|
560
552
|
};
|
|
561
553
|
|
|
@@ -673,7 +665,7 @@ updated: ${state.updatedAt.slice(0, 10)}
|
|
|
673
665
|
- No secrets are stored in this file or in ${STATE_REL_PATH}.
|
|
674
666
|
`;
|
|
675
667
|
const path = join(workspace, LEGACY_RECORD_REL_PATH);
|
|
676
|
-
writeFileSyncDeep(path, text);
|
|
668
|
+
writeFileSyncDeep(path, text, workspace);
|
|
677
669
|
return path;
|
|
678
670
|
}
|
|
679
671
|
|
|
@@ -686,13 +678,12 @@ updated: ${state.updatedAt.slice(0, 10)}
|
|
|
686
678
|
*/
|
|
687
679
|
function insideWorkspace(workspace, rel) {
|
|
688
680
|
const abs = resolve(workspace, rel);
|
|
689
|
-
if (!isInside(workspace, abs)) {
|
|
690
|
-
|
|
691
|
-
}
|
|
692
|
-
return abs;
|
|
681
|
+
if (!isInside(workspace, abs)) throw new Error(`refusing to write outside the workspace: ${rel}`);
|
|
682
|
+
return assertSafeWorkspaceTarget(workspace, abs);
|
|
693
683
|
}
|
|
694
684
|
|
|
695
|
-
function writeFileSyncDeep(abs, contents) {
|
|
685
|
+
function writeFileSyncDeep(abs, contents, workspace = null) {
|
|
686
|
+
if (workspace) assertSafeWorkspaceTarget(workspace, abs, { allowLeafSymlink: false });
|
|
696
687
|
mkdirSync(dirname(abs), { recursive: true });
|
|
697
688
|
writeFileSync(abs, contents);
|
|
698
689
|
}
|
package/bin/lib/features.js
CHANGED
|
@@ -16,8 +16,8 @@ export function retiredFeatureError(name) {
|
|
|
16
16
|
export function normalizeFeatureSet(manifest, features) {
|
|
17
17
|
const known = new Set(featureNames(manifest));
|
|
18
18
|
const values = typeof features === "string"
|
|
19
|
-
? (features === "none" ? [] : features.split(",").filter(Boolean))
|
|
20
|
-
: (features ?? []);
|
|
19
|
+
? (features.trim().toLowerCase() === "none" ? [] : features.split(",").map((name) => name.trim()).filter(Boolean))
|
|
20
|
+
: (features ?? []).map((name) => typeof name === "string" ? name.trim() : name).filter(Boolean);
|
|
21
21
|
for (const feature of values) {
|
|
22
22
|
if (!known.has(feature)) throw new Error(retiredFeatureError(feature) ?? `unknown feature "${feature}"`);
|
|
23
23
|
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
// Explicit public serialization boundary: write buffers never cross stdout/stderr.
|
|
2
|
+
const SECRET_BEARING_KEYS = new Set(["text", "original", "replacement", "before", "after", "backup"]);
|
|
3
|
+
export const PUBLIC_PLAN_SCHEMA_VERSION = 1;
|
|
4
|
+
function safe(value, key = "") {
|
|
5
|
+
if (SECRET_BEARING_KEYS.has(key)) return undefined;
|
|
6
|
+
if (Array.isArray(value)) return value.map((item) => safe(item)).filter((item) => item !== undefined);
|
|
7
|
+
if (!value || typeof value !== "object") return value;
|
|
8
|
+
if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) return undefined;
|
|
9
|
+
return Object.fromEntries(Object.entries(value).flatMap(([name, item]) => {
|
|
10
|
+
const cleaned = safe(item, name); return cleaned === undefined ? [] : [[name, cleaned]];
|
|
11
|
+
}));
|
|
12
|
+
}
|
|
13
|
+
export function publicPlan(plan, stage = "preview") { return { ...safe(plan), publicSchemaVersion: PUBLIC_PLAN_SCHEMA_VERSION, stage }; }
|
|
14
|
+
export function publicResult(result, stage = "apply") { return { ...safe(result), publicSchemaVersion: PUBLIC_PLAN_SCHEMA_VERSION, stage }; }
|
|
15
|
+
export function publicRepairPreview(proposal) {
|
|
16
|
+
return { publicSchemaVersion: PUBLIC_PLAN_SCHEMA_VERSION, stage: "config-repair-preview", configRepair: { path: proposal.path, removed: proposal.removed, requiresApproval: true, nextStep: "Run setup interactively, or setup --yes --repair-config. No mutation was applied." } };
|
|
17
|
+
}
|
package/bin/lib/purge.js
CHANGED
|
@@ -1,11 +1,17 @@
|
|
|
1
1
|
// purge.js — explicit human-config boundary for state-owned uninstall.
|
|
2
2
|
import { existsSync, rmSync } from "node:fs";
|
|
3
3
|
import { join } from "node:path";
|
|
4
|
+
import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
|
|
4
5
|
|
|
5
6
|
const HUMAN_CONFIG = [".ai/agent-fleet.json", ".ai/agent-fleet-overrides.md", ".ai/stt.json"];
|
|
6
|
-
export function purgeHumanConfig(workspace, { purgeConfig = false } = {}) {
|
|
7
|
-
|
|
7
|
+
export function purgeHumanConfig(workspace, { purgeConfig = false, dryRun = false } = {}) {
|
|
8
|
+
const present = HUMAN_CONFIG.filter((path) => {
|
|
9
|
+
const target = assertSafeWorkspaceTarget(workspace, path, { allowLeafSymlink: false });
|
|
10
|
+
return existsSync(target);
|
|
11
|
+
});
|
|
12
|
+
if (!purgeConfig) return { removed: [], preserved: present };
|
|
13
|
+
if (dryRun) return { removed: [], wouldRemove: present, preserved: present };
|
|
8
14
|
const removed = [];
|
|
9
|
-
for (const path of
|
|
15
|
+
for (const path of present) { rmSync(join(workspace, path), { force: true }); removed.push(path); }
|
|
10
16
|
return { removed, preserved: [] };
|
|
11
17
|
}
|
package/bin/lib/reconcile.js
CHANGED
|
@@ -8,14 +8,14 @@ import { buildPlan } from "./plan.js";
|
|
|
8
8
|
import { readState } from "./state.js";
|
|
9
9
|
import { scanProject } from "./scan.js";
|
|
10
10
|
import { planOverrides } from "./overrides.js";
|
|
11
|
-
import {
|
|
11
|
+
import { planStt } from "./stt-wizard.js";
|
|
12
12
|
|
|
13
13
|
/** Build one setup plan. This function writes nothing. */
|
|
14
14
|
export function buildReconcilePlan(opts) {
|
|
15
15
|
const { workspace, manifest, sourceRoot, packageVersion, agent = "pi", method,
|
|
16
16
|
preset, features, saveDesired = false, tuiDesired = null, dryRun = false,
|
|
17
17
|
migrate = false, yes = false, accept = null, allowExec = false,
|
|
18
|
-
platform = process.platform } = opts;
|
|
18
|
+
sttProvider = null, sttReplacementApproved = false, platform = process.platform } = opts;
|
|
19
19
|
const state = readState(workspace);
|
|
20
20
|
const desiredPath = join(workspace, DESIRED_FILE);
|
|
21
21
|
const firstMigration = Boolean(state && !existsSync(desiredPath));
|
|
@@ -37,13 +37,7 @@ export function buildReconcilePlan(opts) {
|
|
|
37
37
|
method, items: featureResult.roots, accept, allowExec, platform });
|
|
38
38
|
const wanted = new Set(featureResult.selected);
|
|
39
39
|
const overrides = planOverrides(workspace, scanProject(workspace));
|
|
40
|
-
const
|
|
41
|
-
? { provider: "openai", apiKeyEnv: "OPENAI_API_KEY" }
|
|
42
|
-
: null;
|
|
43
|
-
const stt = sttConfig ? {
|
|
44
|
-
path: join(workspace, ".ai", "stt.json"), text: renderSttConfig(sttConfig),
|
|
45
|
-
env: appendEnvPlaceholders(workspace, sttConfig),
|
|
46
|
-
} : null;
|
|
40
|
+
const stt = featureResult.features.includes("voice") ? planStt(workspace, sttProvider, { replacementApproved: sttReplacementApproved }) : null;
|
|
47
41
|
const recorded = Object.keys(state?.items ?? {});
|
|
48
42
|
const removals = recorded.filter((id) => !wanted.has(id)).sort().map((id) => ({
|
|
49
43
|
kind: "remove", id, itemKind: state.items[id].kind ?? "unknown", consent: "file", state: "owned",
|
|
@@ -60,7 +54,7 @@ export function buildReconcilePlan(opts) {
|
|
|
60
54
|
migrationError: migrationBlocked
|
|
61
55
|
? "first migration requires --migrate --preset <default|full> --features <exact-set> --yes"
|
|
62
56
|
: null,
|
|
63
|
-
selection: { ...base.selection, desired: featureResult, resolved: featureResult.selected },
|
|
57
|
+
selection: { ...base.selection, desired: { ...featureResult, requestedFeatures: Object.entries(desiredResult.desired.features).filter(([, enabled]) => enabled).map(([name]) => name).sort() }, resolved: featureResult.selected },
|
|
64
58
|
actions, conflicts,
|
|
65
59
|
overrides,
|
|
66
60
|
stt,
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
// Explicit, narrowly scoped repair of known retired desired-state features.
|
|
2
|
+
import { existsSync, readFileSync, lstatSync, writeFileSync, renameSync, unlinkSync } from "node:fs";
|
|
3
|
+
import { randomUUID } from "node:crypto";
|
|
4
|
+
import { join } from "node:path";
|
|
5
|
+
import { DESIRED_FILE, validateDesired } from "./desired.js";
|
|
6
|
+
import { retiredFeatureError } from "./features.js";
|
|
7
|
+
import { assertSafeWorkspaceTarget } from "./workspace-safety.js";
|
|
8
|
+
import { publicRepairPreview } from "./public-plan.js";
|
|
9
|
+
|
|
10
|
+
export function inspectDesiredRepair(workspace, manifest) {
|
|
11
|
+
const path = assertSafeWorkspaceTarget(workspace, DESIRED_FILE, { allowLeafSymlink: false });
|
|
12
|
+
if (!existsSync(path)) return null;
|
|
13
|
+
const original = readFileSync(path, "utf8");
|
|
14
|
+
let value;
|
|
15
|
+
try { value = JSON.parse(original); }
|
|
16
|
+
catch { throw new Error(`invalid desired config ${DESIRED_FILE}: invalid JSON; manual repair required`); }
|
|
17
|
+
const candidate = structuredClone(value);
|
|
18
|
+
const removed = [];
|
|
19
|
+
if (candidate?.features && typeof candidate.features === "object" && !Array.isArray(candidate.features)) {
|
|
20
|
+
for (const [name, enabled] of Object.entries(candidate.features)) {
|
|
21
|
+
if (!manifest.features?.[name] && retiredFeatureError(name) && typeof enabled === "boolean") {
|
|
22
|
+
removed.push({ name, value: enabled });
|
|
23
|
+
delete candidate.features[name];
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
// Never offer a partial repair of an otherwise invalid configuration.
|
|
28
|
+
validateDesired(candidate, manifest);
|
|
29
|
+
if (!removed.length) return null;
|
|
30
|
+
if (!lstatSync(path).isFile()) throw new Error(`cannot repair non-regular config ${DESIRED_FILE}`);
|
|
31
|
+
return { path, original, replacement: JSON.stringify(candidate, null, 2) + "\n", removed };
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export function describeDesiredRepair(proposal) {
|
|
35
|
+
return `Retired settings found in ${DESIRED_FILE}:\n${proposal.removed.map(({ name, value }) => `- ${JSON.stringify(name)}: ${value}`).join("\n")}\nProposed repair: remove only these settings. Other settings are preserved.\nchatgpt-client will NOT be enabled automatically.\nA backup will be saved before the repair. This repair is separate from the subsequent setup plan.`;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export function applyDesiredRepair(proposal) {
|
|
39
|
+
const { path, original, replacement } = proposal;
|
|
40
|
+
const unchanged = () => {
|
|
41
|
+
if (!lstatSync(path).isFile() || readFileSync(path, "utf8") !== original) {
|
|
42
|
+
throw new Error("desired config changed since repair was proposed; rerun setup");
|
|
43
|
+
}
|
|
44
|
+
};
|
|
45
|
+
unchanged();
|
|
46
|
+
const id = randomUUID();
|
|
47
|
+
const backup = `${path}.backup-${id}`;
|
|
48
|
+
const temporary = `${path}.repair-${id}`;
|
|
49
|
+
writeFileSync(backup, original, { flag: "wx", mode: 0o600 });
|
|
50
|
+
try {
|
|
51
|
+
writeFileSync(temporary, replacement, { flag: "wx", mode: lstatSync(path).mode & 0o777 });
|
|
52
|
+
unchanged();
|
|
53
|
+
renameSync(temporary, path);
|
|
54
|
+
} finally {
|
|
55
|
+
if (existsSync(temporary)) unlinkSync(temporary);
|
|
56
|
+
}
|
|
57
|
+
return backup;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
export async function prepareDesiredRepair({ workspace, manifest, dryRun, approved, interactive, output, confirm }) {
|
|
61
|
+
const proposal = inspectDesiredRepair(workspace, manifest);
|
|
62
|
+
if (!proposal) return { repaired: false };
|
|
63
|
+
if (dryRun) return { repaired: false, preview: publicRepairPreview(proposal) };
|
|
64
|
+
output.write(describeDesiredRepair(proposal) + "\n");
|
|
65
|
+
if (!approved) {
|
|
66
|
+
if (!interactive) throw new Error("Config repair requires explicit approval: rerun setup interactively or with --yes --repair-config. No mutation was applied.");
|
|
67
|
+
const answer = await confirm("Apply this config repair now? yes/y | no/n; Enter = no (cancel; backup is created only after yes) > ");
|
|
68
|
+
if (answer === null || !/^y(es)?$/i.test(answer.trim())) return { repaired: false, cancelled: true };
|
|
69
|
+
}
|
|
70
|
+
const backup = applyDesiredRepair(proposal);
|
|
71
|
+
output.write(`Config repaired. Original saved to ${backup}\n`);
|
|
72
|
+
return { repaired: true, backup };
|
|
73
|
+
}
|
package/bin/lib/stt-wizard.js
CHANGED
|
@@ -1,28 +1,32 @@
|
|
|
1
|
-
//
|
|
1
|
+
// Human-owned, non-secret STT configuration. Installer prompts for provider/env names, never values.
|
|
2
2
|
import { existsSync, readFileSync } from "node:fs";
|
|
3
3
|
import { join } from "node:path";
|
|
4
4
|
|
|
5
|
-
const
|
|
5
|
+
export const STT_PROVIDERS = {
|
|
6
6
|
openai: { apiKeyEnv: "OPENAI_API_KEY" },
|
|
7
7
|
groq: { apiKeyEnv: "GROQ_API_KEY" },
|
|
8
8
|
azure: { apiKeyEnv: "AZURE_OPENAI_API_KEY", endpointEnv: "AZURE_OPENAI_ENDPOINT" },
|
|
9
9
|
};
|
|
10
|
-
|
|
11
10
|
export function validateSttConfig(value) {
|
|
12
|
-
|
|
13
|
-
if (!
|
|
14
|
-
for (const key of ["apiKeyEnv", ...(
|
|
15
|
-
if (value[key] !==
|
|
11
|
+
if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("STT config must be an object");
|
|
12
|
+
if (!STT_PROVIDERS[value.provider]) throw new Error(`unsupported STT provider "${value.provider}"`);
|
|
13
|
+
for (const key of ["apiKeyEnv", ...(value.provider === "azure" ? ["endpointEnv"] : [])]) {
|
|
14
|
+
if (typeof value[key] !== "string" || !/^[A-Z_][A-Z0-9_]*$/.test(value[key])) throw new Error(`${key} must name an environment variable`);
|
|
16
15
|
}
|
|
17
16
|
for (const [key, item] of Object.entries(value)) {
|
|
18
17
|
if (/key|token|secret|password/i.test(key) && !/Env$/.test(key)) throw new Error(`STT config must not store ${key}`);
|
|
19
|
-
if (typeof item === "string" && /sk-[A-Za-z0-9]|AIza|ghp_/i.test(item)) throw new Error("STT config must not store secret values");
|
|
18
|
+
if (typeof item === "string" && /(?:sk-[A-Za-z0-9]|AIza|ghp_)/i.test(item)) throw new Error("STT config must not store secret values");
|
|
20
19
|
}
|
|
21
|
-
return
|
|
20
|
+
return structuredClone(value); // unknown human-owned fields are valid and preserved.
|
|
22
21
|
}
|
|
23
|
-
|
|
24
22
|
export function renderSttConfig(value) { return JSON.stringify(validateSttConfig(value), null, 2) + "\n"; }
|
|
25
|
-
|
|
23
|
+
export function readSttConfig(workspace) {
|
|
24
|
+
const path = join(workspace, ".ai", "stt.json");
|
|
25
|
+
if (!existsSync(path)) return null;
|
|
26
|
+
const text = readFileSync(path, "utf8");
|
|
27
|
+
try { return { path, text, config: validateSttConfig(JSON.parse(text)) }; }
|
|
28
|
+
catch (error) { throw new Error(`invalid .ai/stt.json: ${error.message}; repair it manually before setup`); }
|
|
29
|
+
}
|
|
26
30
|
/** Append empty placeholders only for variables not already declared. */
|
|
27
31
|
export function appendEnvPlaceholders(workspace, config) {
|
|
28
32
|
const path = join(workspace, ".env");
|
|
@@ -31,3 +35,13 @@ export function appendEnvPlaceholders(workspace, config) {
|
|
|
31
35
|
const missing = names.filter((name) => !new RegExp(`^\\s*(?:export\\s+)?${name}\\s*=`, "m").test(before));
|
|
32
36
|
return { path, text: missing.length ? `${before}${before && !before.endsWith("\n") ? "\n" : ""}${missing.map((name) => `${name}=`).join("\n")}\n` : before, missing };
|
|
33
37
|
}
|
|
38
|
+
export function planStt(workspace, provider, { replacementApproved = false } = {}) {
|
|
39
|
+
const existing = readSttConfig(workspace);
|
|
40
|
+
if (existing && (!provider || provider === existing.config.provider)) {
|
|
41
|
+
return { path: existing.path, write: false, preserved: true, provider: existing.config.provider, env: appendEnvPlaceholders(workspace, existing.config) };
|
|
42
|
+
}
|
|
43
|
+
if (!provider || !STT_PROVIDERS[provider]) throw new Error(`first-time voice setup requires an explicit STT provider: ${Object.keys(STT_PROVIDERS).join(", ")}`);
|
|
44
|
+
if (existing && !replacementApproved) throw new Error(`replacing STT provider ${existing.config.provider} with ${provider} requires explicit approval`);
|
|
45
|
+
const config = validateSttConfig({ ...(existing?.config ?? {}), provider, ...STT_PROVIDERS[provider] });
|
|
46
|
+
return { path: join(workspace, ".ai", "stt.json"), text: renderSttConfig(config), write: true, preserved: false, replacing: existing?.config.provider ?? null, provider, env: appendEnvPlaceholders(workspace, config) };
|
|
47
|
+
}
|