| name | provider-adapter |
| description | Use when adding or modifying model provider support, model profiles, streaming, tool-call normalization, reasoning effort, cost accounting, retries, rate limits, or secret handling. |
Provider Adapter
Build providers as capability-based adapters.
Steps
- Add or update provider schema.
- Declare capabilities explicitly.
- Normalize streaming and tool calls into internal events.
- Keep provider secrets in keychain or env references only.
- Add conformance tests with recorded fake responses.
- Add error mapping and retry policy.
Avoid
- Hardcoding model-specific behavior outside capability metadata.
- Logging request headers or secrets.
- Assuming OpenAI-compatible APIs all behave identically.