mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-08 03:01:47 +00:00
9022804d78
Every provider profile is now a self-contained plugin under plugins/model-providers/<name>/, mirroring the plugins/platforms/ pattern established for IRC and Teams. The ProviderProfile ABC stays in providers/; the per-provider profile data moves out. - plugins/model-providers/<name>/__init__.py calls register_provider() - plugins/model-providers/<name>/plugin.yaml declares kind: model-provider - providers/__init__.py._discover_providers() lazily scans bundled plugins then $HERMES_HOME/plugins/model-providers/<name>/ (user override path) - User plugins with the same name override bundled ones (last-writer-wins in register_provider) - Legacy providers/<name>.py layout still supported for back-compat with out-of-tree editable installs - Hermes PluginManager: new kind=model-provider; skipped like memory plugins (providers/ discovery owns them); standalone plugins with register_provider+ProviderProfile in their __init__.py auto-coerce to this kind (same heuristic as memory providers) - skip_names extended to include 'model-providers' so the general PluginManager doesn't double-scan the category - 4 new tests in tests/providers/test_plugin_discovery.py covering bundled discovery, user override, and general-loader isolation - Docs updated: website/docs/developer-guide/adding-providers.md, provider-runtime.md, providers/README.md, plugins/model-providers/README.md No API break: auth.py / config.py / doctor.py / models.py / runtime_provider.py / model_metadata.py / auxiliary_client.py / chat_completions.py / run_agent.py all still consume providers via get_provider_profile() / list_providers() — they just now see plugin-discovered entries instead of pkgutil-iterated ones. Third parties can now drop a single directory into ~/.hermes/plugins/model-providers/<name>/ to add or override an inference provider without touching the repo.
58 lines
2 KiB
Python
58 lines
2 KiB
Python
"""Copilot / GitHub Models provider profile.
|
|
|
|
Copilot uses per-model api_mode routing:
|
|
- GPT-5+ / Codex models → codex_responses
|
|
- Claude models → anthropic_messages
|
|
- Everything else → chat_completions (this profile covers that subset)
|
|
|
|
Key quirks for the chat_completions subset:
|
|
- Editor attribution headers (via copilot_default_headers())
|
|
- GitHub Models reasoning extra_body (model-catalog gated)
|
|
"""
|
|
|
|
from typing import Any
|
|
|
|
from providers import register_provider
|
|
from providers.base import ProviderProfile
|
|
|
|
|
|
class CopilotProfile(ProviderProfile):
|
|
"""GitHub Copilot / GitHub Models — editor headers + reasoning."""
|
|
|
|
def build_api_kwargs_extras(
|
|
self,
|
|
*,
|
|
model: str | None = None,
|
|
reasoning_config: dict | None = None,
|
|
supports_reasoning: bool = False,
|
|
**ctx,
|
|
) -> tuple[dict[str, Any], dict[str, Any]]:
|
|
extra_body: dict[str, Any] = {}
|
|
if supports_reasoning and model:
|
|
try:
|
|
from hermes_cli.models import github_model_reasoning_efforts
|
|
|
|
supported_efforts = github_model_reasoning_efforts(model)
|
|
if supported_efforts and reasoning_config:
|
|
effort = reasoning_config.get("effort", "medium")
|
|
# Normalize non-standard effort levels to the nearest supported
|
|
if effort == "xhigh":
|
|
effort = "high"
|
|
if effort in supported_efforts:
|
|
extra_body["reasoning"] = {"effort": effort}
|
|
elif supported_efforts:
|
|
extra_body["reasoning"] = {"effort": "medium"}
|
|
except Exception:
|
|
pass
|
|
return extra_body, {}
|
|
|
|
|
|
copilot = CopilotProfile(
|
|
name="copilot",
|
|
aliases=("github-copilot", "github-models", "github-model", "github"),
|
|
env_vars=("COPILOT_GITHUB_TOKEN", "GH_TOKEN", "GITHUB_TOKEN"),
|
|
base_url="https://api.githubcopilot.com",
|
|
auth_type="copilot",
|
|
)
|
|
|
|
register_provider(copilot)
|