@chankov/agent-fleet 0.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/.claude/commands/build.md +44 -0
- package/.claude/commands/code-simplify.md +22 -0
- package/.claude/commands/design-agent.md +14 -0
- package/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.claude/commands/orchestrate.md +112 -0
- package/.claude/commands/plan.md +16 -0
- package/.claude/commands/prime.md +22 -0
- package/.claude/commands/review.md +16 -0
- package/.claude/commands/setup-agent-fleet.md +25 -0
- package/.claude/commands/ship.md +72 -0
- package/.claude/commands/spec.md +15 -0
- package/.claude/commands/test.md +19 -0
- package/.claude/commands/webperf.md +32 -0
- package/.claude/orchestrate-teams.yaml +24 -0
- package/.opencode/commands/af-build.md +17 -0
- package/.opencode/commands/af-code-simplify.md +16 -0
- package/.opencode/commands/af-compound.md +16 -0
- package/.opencode/commands/af-design-agent.md +15 -0
- package/.opencode/commands/af-doctor-agent-fleet.md +15 -0
- package/.opencode/commands/af-orchestrate.md +112 -0
- package/.opencode/commands/af-plan.md +16 -0
- package/.opencode/commands/af-prime.md +22 -0
- package/.opencode/commands/af-review.md +15 -0
- package/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.opencode/commands/af-ship.md +16 -0
- package/.opencode/commands/af-spec.md +16 -0
- package/.opencode/commands/af-test.md +21 -0
- package/.opencode/commands/af-webperf.md +32 -0
- package/.opencode/orchestrate-teams.yaml +24 -0
- package/.pi/agents/dispatch-policy.yaml +32 -0
- package/.pi/agents/model-profiles.yaml +20 -0
- package/.pi/agents/peers.yaml +142 -0
- package/.pi/agents/teams.yaml +39 -0
- package/.pi/damage-control-rules.yaml +297 -0
- package/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.pi/extensions/btw/README.md +118 -0
- package/.pi/extensions/btw/index.ts +917 -0
- package/.pi/extensions/btw/package.json +6 -0
- package/.pi/extensions/btw/state.js +179 -0
- package/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.pi/extensions/package-lock.json +1143 -0
- package/.pi/extensions/package.json +9 -0
- package/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.pi/harnesses/agent-hub/README.md +562 -0
- package/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.pi/harnesses/agent-hub/delegate.ts +363 -0
- package/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.pi/harnesses/agent-hub/helpers.ts +165 -0
- package/.pi/harnesses/agent-hub/index.ts +7098 -0
- package/.pi/harnesses/agent-hub/package.json +6 -0
- package/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.pi/harnesses/agent-hub/spawn.ts +179 -0
- package/.pi/harnesses/ask-user-remote/README.md +10 -0
- package/.pi/harnesses/ask-user-remote/index.ts +253 -0
- package/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.pi/harnesses/coms/README.md +71 -0
- package/.pi/harnesses/coms/index.ts +1743 -0
- package/.pi/harnesses/coms/package.json +6 -0
- package/.pi/harnesses/damage-control/README.md +65 -0
- package/.pi/harnesses/damage-control/index.ts +250 -0
- package/.pi/harnesses/damage-control/package.json +6 -0
- package/.pi/harnesses/damage-control/shared.ts +183 -0
- package/.pi/harnesses/damage-control-continue/README.md +116 -0
- package/.pi/harnesses/damage-control-continue/index.ts +522 -0
- package/.pi/harnesses/damage-control-continue/package.json +6 -0
- package/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.pi/harnesses/package-lock.json +35 -0
- package/.pi/harnesses/package.json +9 -0
- package/.pi/prompts/build.md +24 -0
- package/.pi/prompts/code-simplify.md +22 -0
- package/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.pi/prompts/plan.md +16 -0
- package/.pi/prompts/review.md +16 -0
- package/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.pi/prompts/ship.md +17 -0
- package/.pi/prompts/spec.md +15 -0
- package/.pi/prompts/test.md +19 -0
- package/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.1/.claude/commands/build.md +44 -0
- package/.versions/0.0.1/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.1/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.1/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.1/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.1/.claude/commands/plan.md +16 -0
- package/.versions/0.0.1/.claude/commands/prime.md +22 -0
- package/.versions/0.0.1/.claude/commands/review.md +16 -0
- package/.versions/0.0.1/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.1/.claude/commands/ship.md +72 -0
- package/.versions/0.0.1/.claude/commands/spec.md +15 -0
- package/.versions/0.0.1/.claude/commands/test.md +19 -0
- package/.versions/0.0.1/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.1/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.1/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.1/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.1/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.1/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.1/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.1/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.1/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.1/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.1/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.1/.pi/extensions/package.json +9 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/README.md +562 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/delegate.ts +363 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/helpers.ts +165 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/index.ts +7098 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/spawn.ts +179 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/README.md +10 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/index.ts +253 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.1/.pi/harnesses/coms/README.md +71 -0
- package/.versions/0.0.1/.pi/harnesses/coms/index.ts +1743 -0
- package/.versions/0.0.1/.pi/harnesses/coms/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/README.md +65 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/index.ts +250 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/shared.ts +183 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/README.md +116 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/index.ts +522 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.1/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.1/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.1/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.1/.pi/prompts/build.md +24 -0
- package/.versions/0.0.1/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.1/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.1/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.1/.pi/prompts/review.md +16 -0
- package/.versions/0.0.1/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.1/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.1/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.1/.pi/prompts/test.md +19 -0
- package/.versions/0.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.1/.version +1 -0
- package/.versions/0.0.1/agents/architect.md +21 -0
- package/.versions/0.0.1/agents/bowser.md +25 -0
- package/.versions/0.0.1/agents/builder.md +52 -0
- package/.versions/0.0.1/agents/code-reviewer.md +205 -0
- package/.versions/0.0.1/agents/deep-researcher.md +31 -0
- package/.versions/0.0.1/agents/documenter.md +16 -0
- package/.versions/0.0.1/agents/orchestrator.md +43 -0
- package/.versions/0.0.1/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.1/agents/planner.md +69 -0
- package/.versions/0.0.1/agents/releaser.md +22 -0
- package/.versions/0.0.1/agents/researcher.md +28 -0
- package/.versions/0.0.1/agents/security-auditor.md +166 -0
- package/.versions/0.0.1/agents/test-engineer.md +144 -0
- package/.versions/0.0.1/agents/web-debugger.md +42 -0
- package/.versions/0.0.1/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.1/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.1/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.1/hooks/hooks.json +14 -0
- package/.versions/0.0.1/hooks/session-start.sh +74 -0
- package/.versions/0.0.1/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.1/justfile +143 -0
- package/.versions/0.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.1/references/definition-of-done.md +67 -0
- package/.versions/0.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.1/references/observability-checklist.md +91 -0
- package/.versions/0.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.1/references/performance-checklist.md +153 -0
- package/.versions/0.0.1/references/prompting-patterns.md +380 -0
- package/.versions/0.0.1/references/security-checklist.md +179 -0
- package/.versions/0.0.1/references/testing-patterns.md +236 -0
- package/.versions/0.0.1/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.1/scripts/coms-cli.ts +372 -0
- package/.versions/0.0.1/scripts/coms-hermes-bridge.ts +399 -0
- package/.versions/0.0.1/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.1/scripts/lib/coms-envelope.ts +494 -0
- package/.versions/0.0.1/scripts/lib/herdr-layout.ts +235 -0
- package/.versions/0.0.1/scripts/lib/hermes-bridge-core.ts +238 -0
- package/.versions/0.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.1/scripts/lib/team-project.ts +75 -0
- package/.versions/0.0.1/scripts/lib/team-snapshot.ts +146 -0
- package/.versions/0.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.1/scripts/team-snapshot.ts +221 -0
- package/.versions/0.0.1/scripts/team-up.ts +245 -0
- package/.versions/0.0.1/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.1/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.1/skills/designing-agents/pi-harness-authoring.md +209 -0
- package/.versions/0.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +506 -0
- package/.versions/0.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.1/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.1/skills/peer-coms/SKILL.md +81 -0
- package/.versions/0.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.1/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.1/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.1/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +65 -0
- package/LICENSE +21 -0
- package/README.md +458 -0
- package/agents/architect.md +21 -0
- package/agents/bowser.md +25 -0
- package/agents/builder.md +52 -0
- package/agents/code-reviewer.md +205 -0
- package/agents/deep-researcher.md +31 -0
- package/agents/documenter.md +16 -0
- package/agents/orchestrator.md +43 -0
- package/agents/plan-reviewer.md +60 -0
- package/agents/planner.md +69 -0
- package/agents/releaser.md +22 -0
- package/agents/researcher.md +28 -0
- package/agents/security-auditor.md +166 -0
- package/agents/test-engineer.md +144 -0
- package/agents/web-debugger.md +42 -0
- package/agents/web-performance-auditor.md +192 -0
- package/bin/cli.js +633 -0
- package/bin/force-patch-changesets.js +44 -0
- package/bin/lib/bootstrap.js +323 -0
- package/bin/lib/detect-agent.js +49 -0
- package/bin/lib/doctor.js +302 -0
- package/bin/lib/transform-persona.js +180 -0
- package/bin/lib/update-notifier.js +195 -0
- package/bin/lib/validate-overrides.js +229 -0
- package/bin/snapshot-version.js +91 -0
- package/docs/agent-fleet-setup.md +355 -0
- package/docs/claude-code-coms-bridge.md +93 -0
- package/docs/getting-started.md +169 -0
- package/docs/npm-install.md +335 -0
- package/docs/opencode-setup.md +248 -0
- package/docs/pi-extensions.md +237 -0
- package/docs/pi-setup.md +455 -0
- package/docs/skill-anatomy.md +150 -0
- package/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/hooks/coms-stop-hook.mjs +73 -0
- package/hooks/hooks.json +14 -0
- package/hooks/session-start.sh +74 -0
- package/hooks/simplify-ignore.sh +302 -0
- package/justfile +143 -0
- package/node_modules/pi-ask-user/LICENSE +21 -0
- package/node_modules/pi-ask-user/README.md +156 -0
- package/node_modules/pi-ask-user/index.ts +1795 -0
- package/node_modules/pi-ask-user/package.json +51 -0
- package/node_modules/pi-ask-user/single-select-layout.ts +203 -0
- package/node_modules/pi-ask-user/skills/ask-user/SKILL.md +162 -0
- package/node_modules/pi-ask-user/skills/ask-user/references/ask-user-skill-extension-spec.md +96 -0
- package/package.json +121 -0
- package/references/accessibility-checklist.md +160 -0
- package/references/definition-of-done.md +67 -0
- package/references/fleet-coordination-patterns.md +151 -0
- package/references/observability-checklist.md +91 -0
- package/references/orchestration-patterns.md +370 -0
- package/references/performance-checklist.md +153 -0
- package/references/prompting-patterns.md +380 -0
- package/references/security-checklist.md +179 -0
- package/references/testing-patterns.md +236 -0
- package/scripts/coms-claude-bridge.ts +286 -0
- package/scripts/coms-cli.ts +372 -0
- package/scripts/coms-hermes-bridge.ts +399 -0
- package/scripts/lib/claude-bridge-core.ts +100 -0
- package/scripts/lib/coms-envelope.ts +494 -0
- package/scripts/lib/herdr-layout.ts +235 -0
- package/scripts/lib/hermes-bridge-core.ts +238 -0
- package/scripts/lib/persona-banner.ts +62 -0
- package/scripts/lib/team-project.ts +75 -0
- package/scripts/lib/team-snapshot.ts +146 -0
- package/scripts/peer-banner.ts +40 -0
- package/scripts/team-snapshot.ts +221 -0
- package/scripts/team-up.ts +245 -0
- package/skills/_internal/grilling.md +11 -0
- package/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/skills/code-review-and-quality/SKILL.md +381 -0
- package/skills/compound-learning/SKILL.md +137 -0
- package/skills/context-engineering/SKILL.md +291 -0
- package/skills/deprecation-and-migration/SKILL.md +206 -0
- package/skills/designing-agents/SKILL.md +394 -0
- package/skills/designing-agents/pi-harness-authoring.md +209 -0
- package/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/skills/guided-workspace-setup/SKILL.md +506 -0
- package/skills/idea-refine/SKILL.md +182 -0
- package/skills/idea-refine/examples.md +238 -0
- package/skills/idea-refine/frameworks.md +99 -0
- package/skills/idea-refine/refinement-criteria.md +113 -0
- package/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/skills/incremental-implementation/SKILL.md +287 -0
- package/skills/interview-me/SKILL.md +226 -0
- package/skills/orchestration-verification/SKILL.md +181 -0
- package/skills/peer-coms/SKILL.md +81 -0
- package/skills/performance-optimization/SKILL.md +350 -0
- package/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/skills/security-and-hardening/SKILL.md +461 -0
- package/skills/spec-driven-development/SKILL.md +245 -0
- package/skills/using-agent-skills/SKILL.md +199 -0
- package/vendor/agent-skills-upstream/LICENSE +21 -0
- package/vendor/agent-skills-upstream/README.md +11 -0
- package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
// ask-user-remote harness
|
|
2
|
+
//
|
|
3
|
+
// Captures the stock pi-ask-user `ask_user` tool, then registers a wrapper with
|
|
4
|
+
// the same schema/renderers/result shape. With no live `user-remote` coms peer
|
|
5
|
+
// it delegates to stock execute with the original arguments unchanged. When the
|
|
6
|
+
// peer is live, it races the stock local UI against a remote coms round trip.
|
|
7
|
+
|
|
8
|
+
import * as fs from "node:fs";
|
|
9
|
+
|
|
10
|
+
import { raceAskUser } from "./race-core.js";
|
|
11
|
+
|
|
12
|
+
interface ToolRegistration {
|
|
13
|
+
name: string;
|
|
14
|
+
execute?: (...args: any[]) => Promise<any> | any;
|
|
15
|
+
[key: string]: any;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
interface ExtensionLike {
|
|
19
|
+
registerTool: (tool: ToolRegistration) => void;
|
|
20
|
+
[key: string]: any;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
interface InstallOptions {
|
|
24
|
+
stockFactory?: (pi: ExtensionLike) => void;
|
|
25
|
+
startRemote?: (params: any, ctx?: any) => Promise<{ qid: string; result: Promise<any> } | null> | { qid: string; result: Promise<any> } | null;
|
|
26
|
+
cancelRemote?: (qid: string, reason: string) => Promise<void> | void;
|
|
27
|
+
warn?: (message: string) => void;
|
|
28
|
+
createAbortController?: () => AbortController;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export function captureAskUserTool(stockFactory: (pi: ExtensionLike) => void, pi: ExtensionLike): ToolRegistration {
|
|
32
|
+
let captured: ToolRegistration | null = null;
|
|
33
|
+
const proxy = new Proxy(pi, {
|
|
34
|
+
get(target, prop, receiver) {
|
|
35
|
+
if (prop === "registerTool") {
|
|
36
|
+
return (tool: ToolRegistration) => {
|
|
37
|
+
if (tool?.name === "ask_user") {
|
|
38
|
+
captured = tool;
|
|
39
|
+
return;
|
|
40
|
+
}
|
|
41
|
+
return target.registerTool(tool);
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
return Reflect.get(target, prop, receiver);
|
|
45
|
+
},
|
|
46
|
+
}) as ExtensionLike;
|
|
47
|
+
|
|
48
|
+
stockFactory(proxy);
|
|
49
|
+
if (!captured) throw new Error("ask-user-remote: stock pi-ask-user did not register ask_user");
|
|
50
|
+
return captured;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function warn(pi: ExtensionLike, options: InstallOptions, message: string): void {
|
|
54
|
+
if (typeof options.warn === "function") {
|
|
55
|
+
options.warn(message);
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
if (typeof pi.logger?.warn === "function") {
|
|
59
|
+
pi.logger.warn(message);
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
if (typeof pi.log?.warn === "function") {
|
|
63
|
+
pi.log.warn(message);
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
console.warn(message);
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
function linkAbortSignal(parent: AbortSignal | undefined, child: AbortController): void {
|
|
70
|
+
if (!parent) return;
|
|
71
|
+
if (parent.aborted) {
|
|
72
|
+
child.abort();
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
parent.addEventListener("abort", () => child.abort(), { once: true });
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function stockResultFromRemote(params: any, response: any): any {
|
|
79
|
+
const summary = response?.kind === "selection"
|
|
80
|
+
? (Array.isArray(response.selections) ? response.selections.join(", ") : "")
|
|
81
|
+
: response?.kind === "freeform"
|
|
82
|
+
? String(response.text ?? "")
|
|
83
|
+
: typeof response === "string"
|
|
84
|
+
? response
|
|
85
|
+
: JSON.stringify(response);
|
|
86
|
+
return {
|
|
87
|
+
content: [{ type: "text", text: `User answered: ${summary}` }],
|
|
88
|
+
details: {
|
|
89
|
+
question: params?.question,
|
|
90
|
+
context: params?.context?.trim?.() || params?.context,
|
|
91
|
+
options: normalizeOptions(params?.options ?? []),
|
|
92
|
+
response,
|
|
93
|
+
cancelled: false,
|
|
94
|
+
},
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
function normalizeOptions(options: any[]): Array<{ title: string; description?: string }> {
|
|
99
|
+
return (Array.isArray(options) ? options : [])
|
|
100
|
+
.map((option) => {
|
|
101
|
+
if (typeof option === "string") return { title: option };
|
|
102
|
+
if (option && typeof option === "object" && typeof option.title === "string") {
|
|
103
|
+
return typeof option.description === "string"
|
|
104
|
+
? { title: option.title, description: option.description }
|
|
105
|
+
: { title: option.title };
|
|
106
|
+
}
|
|
107
|
+
return null;
|
|
108
|
+
})
|
|
109
|
+
.filter(Boolean) as Array<{ title: string; description?: string }>;
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
// Live remote questions started by defaultStartRemote, keyed by qid. A cancel
|
|
113
|
+
// must settle the pending result so the per-question endpoint server is closed;
|
|
114
|
+
// otherwise every locally-answered race leaks a bound socket until process exit.
|
|
115
|
+
const activeRemote = new Map<string, (error: Error) => void>();
|
|
116
|
+
|
|
117
|
+
export function activeRemoteCount(): number {
|
|
118
|
+
return activeRemote.size;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
async function defaultStartRemote(params: any): Promise<{ qid: string; result: Promise<any> } | null> {
|
|
122
|
+
const coms = await import("../../../scripts/lib/coms-envelope.ts");
|
|
123
|
+
const project = process.env.PI_COMS_PROJECT || "default";
|
|
124
|
+
const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
|
|
125
|
+
const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
|
|
126
|
+
if (!peer) return null;
|
|
127
|
+
|
|
128
|
+
coms.ensureComsDirs(project);
|
|
129
|
+
const id = {
|
|
130
|
+
session_id: coms.ulid(),
|
|
131
|
+
name: "ask-user-remote",
|
|
132
|
+
endpoint: "",
|
|
133
|
+
cwd: process.cwd(),
|
|
134
|
+
};
|
|
135
|
+
id.endpoint = coms.makeEndpoint(id.session_id);
|
|
136
|
+
|
|
137
|
+
let resolveResult!: (value: any) => void;
|
|
138
|
+
let rejectResult!: (error: Error) => void;
|
|
139
|
+
const rawResult = new Promise<any>((resolve, reject) => {
|
|
140
|
+
resolveResult = resolve;
|
|
141
|
+
rejectResult = reject;
|
|
142
|
+
});
|
|
143
|
+
const server = await coms.bindEndpoint(
|
|
144
|
+
id.endpoint,
|
|
145
|
+
coms.makeConnHandler((env: Record<string, unknown>, socket: any) => {
|
|
146
|
+
if (coms.isResponseEnvelope(env)) {
|
|
147
|
+
coms.writeAck(socket, env.msg_id);
|
|
148
|
+
if (env.error) rejectResult(new Error(String(env.error)));
|
|
149
|
+
else resolveResult(stockResultFromRemote(params, env.response));
|
|
150
|
+
return;
|
|
151
|
+
}
|
|
152
|
+
coms.writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "ask-user-remote awaits responses only");
|
|
153
|
+
}),
|
|
154
|
+
);
|
|
155
|
+
const cleanup = () => {
|
|
156
|
+
try { server.close(); } catch { /* ignore */ }
|
|
157
|
+
try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
|
|
158
|
+
};
|
|
159
|
+
|
|
160
|
+
const promptPayload = JSON.stringify({
|
|
161
|
+
question: params?.question,
|
|
162
|
+
context: params?.context,
|
|
163
|
+
options: params?.options ?? [],
|
|
164
|
+
});
|
|
165
|
+
const env = coms.makePromptEnvelope(id, promptPayload);
|
|
166
|
+
activeRemote.set(env.msg_id, rejectResult);
|
|
167
|
+
const result = rawResult.finally(() => {
|
|
168
|
+
activeRemote.delete(env.msg_id);
|
|
169
|
+
cleanup();
|
|
170
|
+
});
|
|
171
|
+
try {
|
|
172
|
+
await coms.sendEnvelope(peer.endpoint, env);
|
|
173
|
+
} catch (error) {
|
|
174
|
+
rejectResult(error instanceof Error ? error : new Error(String(error)));
|
|
175
|
+
}
|
|
176
|
+
return { qid: env.msg_id, result };
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
async function defaultCancelRemote(qid: string, reason: string): Promise<void> {
|
|
180
|
+
try {
|
|
181
|
+
const coms = await import("../../../scripts/lib/coms-envelope.ts");
|
|
182
|
+
const project = process.env.PI_COMS_PROJECT || "default";
|
|
183
|
+
const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
|
|
184
|
+
const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
|
|
185
|
+
if (peer) {
|
|
186
|
+
await coms.sendEnvelope(peer.endpoint, coms.makeCancelEnvelope({
|
|
187
|
+
from: "ask-user-remote",
|
|
188
|
+
to: peer.name,
|
|
189
|
+
ref_msg_id: qid,
|
|
190
|
+
}));
|
|
191
|
+
}
|
|
192
|
+
} finally {
|
|
193
|
+
// The bridge sends no response for a cancelled qid, so settle the pending
|
|
194
|
+
// result here to release the per-question endpoint server.
|
|
195
|
+
activeRemote.get(qid)?.(new Error(`ask-user-remote: cancelled (${reason})`));
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOptions = {}): ToolRegistration {
|
|
200
|
+
return {
|
|
201
|
+
...stockTool,
|
|
202
|
+
async execute(toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: any, ctx?: any) {
|
|
203
|
+
const startRemote = options.startRemote ?? defaultStartRemote;
|
|
204
|
+
let remoteStart: { qid: string; result: Promise<any> } | null = null;
|
|
205
|
+
try {
|
|
206
|
+
remoteStart = await startRemote(params, ctx);
|
|
207
|
+
} catch {
|
|
208
|
+
remoteStart = null;
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
if (!remoteStart) {
|
|
212
|
+
return await stockTool.execute?.(toolCallId, params, signal, onUpdate, ctx);
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
return await raceAskUser({
|
|
216
|
+
runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, params, localSignal, onUpdate, ctx),
|
|
217
|
+
startRemote: () => remoteStart,
|
|
218
|
+
cancelRemote: options.cancelRemote ?? defaultCancelRemote,
|
|
219
|
+
createAbortController: () => {
|
|
220
|
+
const controller = options.createAbortController?.() ?? new AbortController();
|
|
221
|
+
linkAbortSignal(signal, controller);
|
|
222
|
+
return controller;
|
|
223
|
+
},
|
|
224
|
+
signal,
|
|
225
|
+
});
|
|
226
|
+
},
|
|
227
|
+
};
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions = {}): { registered: boolean; tool?: ToolRegistration } {
|
|
231
|
+
if (!options.stockFactory) throw new Error("ask-user-remote: stockFactory is required for synchronous install");
|
|
232
|
+
const stockTool = captureAskUserTool(options.stockFactory, pi);
|
|
233
|
+
const wrapped = wrapAskUserTool(stockTool, options);
|
|
234
|
+
try {
|
|
235
|
+
pi.registerTool(wrapped);
|
|
236
|
+
return { registered: true, tool: wrapped };
|
|
237
|
+
} catch (error) {
|
|
238
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
239
|
+
warn(pi, options, `ask-user-remote: ask_user already registered; wrapper not installed (${message})`);
|
|
240
|
+
return { registered: false };
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
async function loadStockFactory(): Promise<(pi: ExtensionLike) => void> {
|
|
245
|
+
const mod = await import("../../../node_modules/pi-ask-user/index.ts");
|
|
246
|
+
return mod.default as (pi: ExtensionLike) => void;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
export default function askUserRemote(pi: ExtensionLike): void {
|
|
250
|
+
void loadStockFactory()
|
|
251
|
+
.then((stockFactory) => installAskUserRemote(pi, { stockFactory }))
|
|
252
|
+
.catch((error) => warn(pi, {}, `ask-user-remote: failed to load pi-ask-user (${error instanceof Error ? error.message : String(error)})`));
|
|
253
|
+
}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
// Pure race arbitration for the ask-user-remote harness.
|
|
2
|
+
//
|
|
3
|
+
// The wrapper supplies the side-effecting pieces:
|
|
4
|
+
// - runLocal(signal): stock pi-ask-user execute with an AbortSignal
|
|
5
|
+
// - startRemote(): starts a user-remote coms request and returns
|
|
6
|
+
// { qid, result: Promise<stock-shaped ask_user result> }, or null when no peer
|
|
7
|
+
// - cancelRemote(qid, reason): best-effort cancel envelope for local-first wins
|
|
8
|
+
//
|
|
9
|
+
// This module owns only the first-answer-wins latch and exactly-once cancel/
|
|
10
|
+
// abort decisions; it has no pi, socket, or filesystem imports.
|
|
11
|
+
|
|
12
|
+
export async function raceAskUser({
|
|
13
|
+
runLocal,
|
|
14
|
+
startRemote,
|
|
15
|
+
cancelRemote,
|
|
16
|
+
createAbortController = () => new AbortController(),
|
|
17
|
+
signal,
|
|
18
|
+
}) {
|
|
19
|
+
if (typeof runLocal !== "function") throw new TypeError("runLocal is required");
|
|
20
|
+
|
|
21
|
+
const controller = createAbortController();
|
|
22
|
+
let settled = false;
|
|
23
|
+
let remotePending = false;
|
|
24
|
+
let remoteQid = null;
|
|
25
|
+
let cancelSent = false;
|
|
26
|
+
|
|
27
|
+
async function emitCancel(reason) {
|
|
28
|
+
if (cancelSent || !remotePending || !remoteQid || typeof cancelRemote !== "function") return;
|
|
29
|
+
cancelSent = true;
|
|
30
|
+
try {
|
|
31
|
+
await cancelRemote(remoteQid, reason);
|
|
32
|
+
} catch {
|
|
33
|
+
// Cancel is best-effort; the winning local answer must not fail because
|
|
34
|
+
// the losing remote channel is already unhealthy.
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
const localPromise = Promise.resolve().then(() => runLocal(controller.signal));
|
|
39
|
+
|
|
40
|
+
let remoteStart = null;
|
|
41
|
+
if (typeof startRemote === "function") {
|
|
42
|
+
try {
|
|
43
|
+
remoteStart = await Promise.resolve().then(() => startRemote());
|
|
44
|
+
} catch {
|
|
45
|
+
remoteStart = null;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
// No live user-remote peer, or remote startup failed before a qid existed:
|
|
50
|
+
// preserve stock pi-ask-user behavior exactly by returning the local result.
|
|
51
|
+
if (!remoteStart) return await localPromise;
|
|
52
|
+
|
|
53
|
+
remoteQid = typeof remoteStart.qid === "string" ? remoteStart.qid : null;
|
|
54
|
+
remotePending = !!remoteQid;
|
|
55
|
+
const remotePromise = Promise.resolve(remoteStart.result);
|
|
56
|
+
|
|
57
|
+
// If the whole tool call is aborted (turn cancelled), withdraw the remote
|
|
58
|
+
// question instead of leaving it live on the phone until timeout.
|
|
59
|
+
if (signal) {
|
|
60
|
+
if (signal.aborted) void emitCancel("aborted");
|
|
61
|
+
else signal.addEventListener("abort", () => { void emitCancel("aborted"); }, { once: true });
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
return await new Promise((resolve, reject) => {
|
|
65
|
+
let localRejected = false;
|
|
66
|
+
let localError;
|
|
67
|
+
let remoteRejected = false;
|
|
68
|
+
|
|
69
|
+
localPromise.then(
|
|
70
|
+
async (result) => {
|
|
71
|
+
if (settled) return;
|
|
72
|
+
settled = true;
|
|
73
|
+
await emitCancel("local_answered");
|
|
74
|
+
resolve(result);
|
|
75
|
+
},
|
|
76
|
+
(error) => {
|
|
77
|
+
if (settled) return;
|
|
78
|
+
localRejected = true;
|
|
79
|
+
localError = error;
|
|
80
|
+
if (remoteRejected) {
|
|
81
|
+
settled = true;
|
|
82
|
+
reject(localError);
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
);
|
|
86
|
+
|
|
87
|
+
remotePromise.then(
|
|
88
|
+
(result) => {
|
|
89
|
+
remotePending = false;
|
|
90
|
+
if (settled) return;
|
|
91
|
+
settled = true;
|
|
92
|
+
controller.abort?.();
|
|
93
|
+
resolve(result);
|
|
94
|
+
},
|
|
95
|
+
() => {
|
|
96
|
+
remotePending = false;
|
|
97
|
+
remoteRejected = true;
|
|
98
|
+
// Remote errors are non-fatal: keep waiting for stock local behavior.
|
|
99
|
+
if (localRejected) {
|
|
100
|
+
settled = true;
|
|
101
|
+
reject(localError);
|
|
102
|
+
}
|
|
103
|
+
},
|
|
104
|
+
);
|
|
105
|
+
});
|
|
106
|
+
}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# coms
|
|
2
|
+
|
|
3
|
+
Peer-to-peer messaging between pi agents on the same machine.
|
|
4
|
+
|
|
5
|
+
> Ported from [`pi-vs-claude-code`](https://github.com/disler/pi-vs-claude-code) by [disler](https://github.com/disler) (MIT). See the [extension catalog](../../../docs/pi-extensions.md).
|
|
6
|
+
|
|
7
|
+
## What it does
|
|
8
|
+
|
|
9
|
+
Lets multiple pi agents running on the same machine talk to each other. Each agent listens
|
|
10
|
+
on a single endpoint — a unix socket on POSIX, a named pipe on Windows — and discovers
|
|
11
|
+
peers through per-project registry files under `~/.pi/coms/projects/<project>/agents/`.
|
|
12
|
+
|
|
13
|
+
Surfaces a live "pool" widget of connected peers, with ping and keepalive cycles and a
|
|
14
|
+
clean shutdown lifecycle.
|
|
15
|
+
|
|
16
|
+
## Presence backends: herdr vs files
|
|
17
|
+
|
|
18
|
+
Presence (who's alive, what state they're in) is pluggable; the **envelope transport,
|
|
19
|
+
tools, and pool-scope boundary are identical in both**:
|
|
20
|
+
|
|
21
|
+
- **herdr** — active automatically when the session runs inside a [herdr](https://herdr.dev)
|
|
22
|
+
pane (`HERDR_ENV=1`) and the server answers ping. Presence goes push: this peer reports
|
|
23
|
+
itself via `pane.report_agent` + `pane.report_metadata` (`custom_status` =
|
|
24
|
+
`<name> <pct>% q<depth>`, capped at 32 chars by herdr), and the pool widget populates
|
|
25
|
+
from `agent.list` + `events.subscribe` — **no periodic ping traffic**; peer state
|
|
26
|
+
changes arrive within ~1s and dead panes disappear on `pane.exited`. Turn state
|
|
27
|
+
(idle/working) in the herdr sidebar comes from herdr's own pi integration when
|
|
28
|
+
installed (`herdr integration install`); coms adds the name/context/queue annotation.
|
|
29
|
+
- **files** — everywhere else: the original 10s ping cycle over the peer endpoints,
|
|
30
|
+
byte-for-byte today's behavior.
|
|
31
|
+
|
|
32
|
+
The file registry keeps being written in BOTH backends (it carries the full agent card
|
|
33
|
+
that herdr's 32-char `custom_status` cannot, and keeps this peer discoverable to peers
|
|
34
|
+
running outside herdr panes). Peers outside herdr panes appear as dimmed "pending" rows
|
|
35
|
+
when you are on the herdr backend.
|
|
36
|
+
|
|
37
|
+
## Commands & tools
|
|
38
|
+
|
|
39
|
+
- `/coms` — open the coms control surface; `--project <name>` retargets the pool (use `*` for
|
|
40
|
+
every project) and `--all` toggles private (`--explicit`) peers into view
|
|
41
|
+
- `coms_list` / `coms_send` / `coms_get` / `coms_await` tools — discover peers and
|
|
42
|
+
exchange messages
|
|
43
|
+
|
|
44
|
+
## Pool scope is the reach boundary
|
|
45
|
+
|
|
46
|
+
The pool widget defines who you can reach: `coms_list` and `coms_send` resolve targets through one
|
|
47
|
+
`peersInScope()` helper, so a peer is reachable only if it is in the pool. By default the
|
|
48
|
+
pool is your own project and excludes `--explicit` peers. **Widening is a human-only action** — the
|
|
49
|
+
`coms_list` tool cannot widen scope; only `/coms --project` / `/coms --all` can. This prevents an
|
|
50
|
+
agent from messaging a cross-project peer that the widget never showed.
|
|
51
|
+
|
|
52
|
+
## Requires
|
|
53
|
+
|
|
54
|
+
Nothing in-repo — the peer registry lives at `~/.pi/coms/` and is created at runtime.
|
|
55
|
+
|
|
56
|
+
## Usage
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
pi -e .pi/harnesses/coms/index.ts
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
For a guarded coms node that also keeps every auto-discovered local extension (MCP bridges,
|
|
63
|
+
project-specific extensions) and command, use the `just safe-coms <name>` recipe — it loads
|
|
64
|
+
`damage-control-continue` + `coms` *on top of* normal extension discovery (no `--no-extensions`), so the
|
|
65
|
+
local-only tools stay scoped to that dispatcher process and never leak into the `--no-extensions`
|
|
66
|
+
specialists an `agent-hub` session spawns.
|
|
67
|
+
|
|
68
|
+
## Upstream changes
|
|
69
|
+
|
|
70
|
+
- Theme integration removed — the `themeMap.ts` import and the `applyExtensionDefaults()`
|
|
71
|
+
call were stripped (this repo does not ship pi themes).
|