provider-adapter

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

1. Add or update provider schema.
2. Declare capabilities explicitly.
3. Normalize streaming and tool calls into internal events.
4. Keep provider secrets in keychain or env references only.
5. Add conformance tests with recorded fake responses.
6. 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.