Skip to content

docs(delegation): document api_mode wire-protocol override from #26824#27109

Closed
r266-tech wants to merge 2 commits into
NousResearch:mainfrom
r266-tech:docs-delegation-api-mode-26824
Closed

docs(delegation): document api_mode wire-protocol override from #26824#27109
r266-tech wants to merge 2 commits into
NousResearch:mainfrom
r266-tech:docs-delegation-api-mode-26824

Conversation

@r266-tech

Copy link
Copy Markdown
Contributor

Summary

#26824 (salvage of #10273, merged 2026-05-16) added a new delegation.api_mode config key so subagent delegation can honor an explicit wire-protocol override when _detect_api_mode_for_url() can't classify a custom base_url (Azure AI Foundry, MiniMax, Zhipu GLM, LiteLLM proxies, …). hermes_cli/config.py documents the key inline, but the user-facing website docs still only mention model, provider, base_url, and api_key for the direct-endpoint path, so users hitting the 404 #26824 fixes have no docs to point at.

This patch surfaces api_mode in the two user-guide pages that already enumerate the delegation YAML keys.

Changes

  • website/docs/user-guide/configuration.md (Delegation section): add the # api_mode: "" line to the commented YAML example next to api_key, and a new Wire protocol (api_mode) paragraph after Direct endpoint override that paraphrases the auto-detect rules and lists the three valid values.
  • website/docs/user-guide/features/delegation.md (Configuration subsection): add a commented api_mode line to the "Or use a direct custom endpoint" YAML block so the example matches the one in configuration.md.

Value set (chat_completions, codex_responses, anthropic_messages) and auto-detect behavior are taken verbatim from the hermes_cli/config.py docstring written by #26824. No claim is made about auto-detect handling endpoints beyond the URL/known-host heuristics in _detect_api_mode_for_url().

4 LOC additive total; no source-code change.

Test plan

@cardtest15-coder

This comment was marked as spam.

@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have comp/agent Core agent loop, run_agent.py, prompt builder tool/delegate Subagent delegation labels May 16, 2026
@cardtest15-coder

This comment was marked as spam.

@teknium1

Copy link
Copy Markdown
Contributor

Merged via PR #27247 — your commit was cherry-picked onto current main as part of a batch salvage of low-risk new-contributor PRs. Authorship preserved (docs(delegation): document api_mode wire-protocol override from #26824). Thanks for the contribution — appreciate it.

@teknium1 teknium1 closed this May 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/agent Core agent loop, run_agent.py, prompt builder P3 Low — cosmetic, nice to have tool/delegate Subagent delegation type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants