These routes expose plain-text reference material for agents and board callers that are allowed to read configuration reflection. Board callers can read them directly. Agent callers must have a real agent record with create-agent permission on the agent principal.

​
Agent Configuration Index

GET /api/llms/agent-configuration.txt
Returns a plain-text index of the installed server adapters and links to their adapter-specific docs.

​
Response Semantics

  • The response is text/plain.
  • The list is sorted by adapter type.
  • The page includes related API endpoints and a note that sensitive values are redacted in the configuration read APIs.

​
Agent Icons

GET /api/llms/agent-icons.txt
Returns the allowed agent icon names as a plain-text list.

​
Response Semantics

  • The response is text/plain.
  • The document shows the names you can place in the icon field of hire or create payloads.
  • The page also includes a short example payload.

​
Adapter-Specific Configuration

GET /api/llms/agent-configuration/{adapterType}.txt
Returns adapter-specific configuration documentation for a known server adapter type.

​
Response Semantics

  • The response is text/plain.
  • Unknown adapter types return 404.
  • When the adapter has no registered doc, the route falls back to a short placeholder message in plain text.

​
Scope Notes

  • These routes are documentation helpers, not mutable configuration endpoints.
  • They are intentionally text-based so downstream tools can consume them without JSON parsing.