feat: integrate GitHub Copilot providers across Hermes

[mchzimm]

Summary

This PR adds first-class GitHub Copilot integration across Hermes' main CLI/app flows and the messaging gateway stack.

What changed

• adds copilot as a first-class provider with live GitHub Copilot model catalog support
• adds copilot-acp as a first-class provider backed by a new OpenAI-compatible copilot --acp shim
• makes hermes model and hermes setup show real model pickers for Copilot and Copilot ACP
• normalizes Copilot model IDs and selects the correct runtime API mode (chat_completions vs codex_responses)
• propagates ACP runtime metadata through CLI sessions, smart routing, delegated subagents, cron jobs, the ACP adapter, and the Telegram gateway
• trims Copilot Responses API payloads to a safer Copilot-compatible shape
• fixes gateway/service-mode Copilot auth by resolving Homebrew-installed gh binaries under launchd
• updates user-facing docs for the new providers and environment variables

Why

This makes GitHub Copilot usable end-to-end in Hermes:

• the main Hermes app can select and run Copilot models cleanly
• the Telegram bot and other gateway flows can use the same Copilot runtime reliably
• Copilot ACP sessions can run as a native Hermes provider instead of a one-off local hack

Release metadata

• semver: 0.4.0
• tag: v2026.3.18

Testing

./venv/bin/pytest -q \
  tests/test_cli_provider_resolution.py \
  tests/test_runtime_provider_resolution.py \
  tests/test_api_key_providers.py \
  tests/test_model_provider_persistence.py \
  tests/hermes_cli/test_model_validation.py \
  tests/hermes_cli/test_setup_model_provider.py \
  tests/test_run_agent.py \
  tests/test_run_agent_codex_responses.py \
  tests/agent/test_auxiliary_client.py \
  tests/tools/test_delegate.py \
  tests/cron/test_scheduler.py

Passed: 523 passed

[Copilot]

Pull request overview

This PR integrates GitHub Copilot as a first-class inference provider across Hermes’ CLI, runtime provider resolution, agent execution paths, and gateway/cron routing—adding both a direct Copilot API provider (copilot) and a local external-process-backed ACP provider (copilot-acp).

Changes:

• Add new providers (copilot, copilot-acp) with live Copilot model catalog support, model-id normalization, and API mode selection (chat_completions vs codex_responses).
• Propagate ACP runtime metadata (command, args) through CLI sessions, smart routing, delegation, cron jobs, and gateway flows; add an OpenAI-compatible ACP client shim.
• Update docs and expand test coverage to validate provider resolution, persisted config, and Copilot-specific request shaping.

Reviewed changes

Copilot reviewed 26 out of 26 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
website/docs/user-guide/configuration.md	Documents Copilot/Copilot ACP setup and provider usage in config.
website/docs/reference/environment-variables.md	Updates provider override documentation for the new provider.
website/docs/reference/cli-commands.md	Updates CLI --provider reference to reflect provider additions.
tools/delegate_tool.py	Propagates ACP runtime details to delegated child agents; fixes tool-name restoration handling.
tests/test_run_agent_codex_responses.py	Adds Copilot Responses payload-shaping tests.
tests/test_run_agent.py	Adds reasoning/Copilot ACP client selection tests.
tests/test_model_provider_persistence.py	Ensures Copilot/Copilot ACP selections persist correctly to config.
tests/test_api_key_providers.py	Adds registry, aliasing, auth-status, and runtime-resolution tests for Copilot providers.
tests/hermes_cli/test_setup_model_provider.py	Verifies hermes setup flows for Copilot and Copilot ACP model pickers.
tests/hermes_cli/test_model_validation.py	Adds Copilot catalog probing, reasoning-effort, normalization, and API-mode tests.
tests/agent/test_auxiliary_client.py	Confirms auxiliary client uses Copilot runtime credentials/headers.
run_agent.py	Adds ACP client wiring and Copilot-specific payload adjustments for Responses/reasoning.
pyproject.toml	Bumps project version to 0.4.0.
hermes_cli/setup.py	Adds Copilot/Copilot ACP setup flows, model picker integration, and reasoning selection.
hermes_cli/runtime_provider.py	Adds Copilot ACP runtime resolver + Copilot dynamic API-mode selection.
hermes_cli/models.py	Introduces Copilot catalog fetch, model normalization, API-mode inference, and reasoning-effort helpers.
hermes_cli/main.py	Adds hermes model flows for Copilot and Copilot ACP, plus reasoning-effort selection.
hermes_cli/auth.py	Registers providers; adds gh auth token fallback + external-process provider credential resolution.
hermes_cli/init.py	Bumps Hermes CLI version/date metadata.
gateway/run.py	Propagates ACP command/args into gateway runtime kwargs.
cron/scheduler.py	Propagates ACP command/args into cron job agent construction.
cli.py	Adds Copilot model normalization + API-mode adjustment and propagates ACP metadata.
agent/smart_model_routing.py	Extends routing signatures/runtime payloads to include ACP command/args.
agent/copilot_acp_client.py	Adds Copilot ACP OpenAI-compatible client shim that spawns copilot --acp --stdio.
agent/auxiliary_client.py	Uses runtime credential resolver for API-key providers; adds Copilot default headers.
acp_adapter/session.py	Propagates ACP runtime metadata through ACP adapter session creation.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.