# Agent-Friendly Docs

Machine-readable entry points for code agents, runtime agents, and API explorers.

## Read these first

`/llms.txt` summarizes stable docs and reference URLs for language-model agents. `/llms-full.txt` contains the full Markdown corpus in one file.

Every page is also emitted as Markdown at `/path/index.md`, and HTML responses advertise the Markdown alternate link.

`/api/capabilities.json` is generated from repository-owned capability definitions and excludes internal and admin-only routes from the public developer catalog.

`/api/openapi.json` exposes the same public developer catalog as OpenAPI 3.1 for API clients and code generators.

`https://seachat.ai/api/seagate/v1/capabilities?runtime=true&includeDenied=true` is the live credential-aware capability catalog.


## Decision rules for agents

Prefer capability ids over hard-coded paths when a route appears in the catalog. Read SeaRouter model help before sending multimodal provider parameters. Include request ids for retries. Keep credentials out of prompts and generated files.