Repository navigation
docs: document the daemon-hosted A2A server - #1014
Merged
Merged
Conversation
Covers the a2a.server config keys, their defaults, the INFER_A2A_SERVER_* overrides and the token requirement for boot, the server subsystem (agent card, bearer auth, one-at-a-time queue, session continuation via contextId, cancellation), the headless --prompt-only flag, and the agents.yaml headers map with environment expansion. Co-authored-by: Eden Reich <16985712+edenreich@users.noreply.github.com>
inference-gateway-maintainer
Bot
requested a review
from a team
as a code owner
October 19, 2026 12:52
Closed
3 tasks
Contributor
|
🗑️ Preview environment destroyed. |
Contributor
|
@claude CI is failing, can you fix this? |
Contributor
Author
|
Claude finished @edenreich's task in 3m 44s —— View job CI fixed
What was failingOnly the Docs drift job, and not because of anything in this PR. The upstream The fix
Validation: One thing to confirmThe ADK tables need an example model id per provider, and WebWright's model list is neither in the schema nor reachable from CI, so the cell is the placeholder |
Co-authored-by: Eden Reich <16985712+edenreich@users.noreply.github.com>
inference-gateway-releaser Bot
added a commit
that referenced
this pull request
Oct 19, 2026
## [0.9.22](0.9.21...0.9.22) (2026-10-19) ### 📚 Documentation * **a2a:** document per-agent credentials in the CLI ([#987](#987)) ([f61efae](f61efae)) * **a2a:** document token_file, token_command and oidc scopes ([#993](#993)) ([8c41cf2](8c41cf2)) * add llms.txt index for LLM crawlers ([#984](#984)) ([f3f3331](f3f3331)) * add simulate_tool_call to the mock-agent tool surface ([#1003](#1003)) ([f199416](f199416)) * **adk:** document typed A2A client errors ([#990](#990)) ([089ab08](089ab08)) * **cli:** document session working time indicator ([#986](#986)) ([2839b2b](2839b2b)) * **cli:** re-record the subagents demo on v0.227.0 ([#994](#994)) ([c53a8bf](c53a8bf)) * desktop first-run init and silent windows spawns ([#1016](#1016)) ([a893347](a893347)) * document chat.suggestions next-step suggestions ([#1006](#1006)) ([9992201](9992201)) * document message queue backends ([#1009](#1009)) ([68b6d5e](68b6d5e)) * document the daemon-hosted A2A server ([#1014](#1014)) ([27fe040](27fe040)) * drop /install-opentask for the opentask skill ([#1013](#1013)) ([372f56d](372f56d)) * drop removed CLIENT_TIMEOUT, fix two descriptions ([#998](#998)) ([9f90854](9f90854)) * fix contradicting artifact pull-back note ([#1004](#1004)) ([edcf4e4](edcf4e4)) * scope the source label claim to gen_ai and gateway series ([#997](#997)) ([36a214e](36a214e)) ### 🔧 Miscellaneous * **deps-dev:** bump the bun group with 2 updates ([#1002](#1002)) ([f7c0c5a](f7c0c5a)) * **deps-dev:** bump the bun group with 4 updates ([#1011](#1011)) ([b52e290](b52e290)) * **deps:** bump actions/create-github-app-token ([#1010](#1010)) ([c465a28](c465a28)) * **deps:** bump actions/setup-node ([#1001](#1001)) ([c0dcf1d](c0dcf1d)) * **deps:** bump claude-code 2.1.285 -> 2.1.289 ([#988](#988)) ([9f5b494](9f5b494)) * **deps:** bump infer CLI v0.221.1 -> v0.226.0 ([#991](#991)) ([844cd4f](844cd4f))
Contributor
|
🎉 This PR is included in version 0.9.22 🎉 The release is available on GitHub release Your semantic-release bot 📦🚀 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documents the daemon-hosted A2A server the CLI added, across the two pages that own the behavior.
cli.md### Hosting an A2A serversection in the Daemon chapter: thea2a.serverkeys with defaults (enabled: false,host: 127.0.0.1,port: 8090,mode: standard), theirINFER_A2A_SERVER_*overrides, and the token requirement - the daemon refuses to boot when the server is enabled without one, and the token belongs inINFER_A2A_SERVER_TOKENrather thanconfig.yaml./.well-known/agent-card.json, bearer auth,message/sendplustasks/{get,list,cancel}, the in-memory task store, the one-at-a-time queue bounded bya2a.task.agent_mode_max_wait_seconds, session continuation through a reusedcontextId, and cancellation.#### Running the task as a plain prompt (--prompt-only)section underinfer headless, which the A2A handler always sets.a2a.md#### Extra headerssection: theagents.yamlheadersmap,$VAR/${VAR}expansion at load time, an unset variable expanding to empty,authwinning over a hand-writtenAuthorization, and theBearer ${PEER_TOKEN}shape oneinferuses to authenticate to another.Validation
bun run lint:md,bun run format:checkandbun run buildall pass.Closes #1008
Generated with Claude Code