Skip to content

ADR 0004: Native providers

Status: accepted, 2026-07-22.

OpenAI Responses, Azure OpenAI Responses, Anthropic Messages, Google Gemini generateContent, and a scripted fake implement one provider-neutral internal interface. Capabilities are negotiated before execution; provider SDK/HTTP shapes never enter durable core state.

“OpenAI-compatible” shims are rejected as a support claim because they hide native tool, continuation, reasoning, error, and usage differences. Every provider requires mock protocol coverage; live credentials are optional evidence only.

Canonical source: docs/adr/0004-native-provider-adapters.md. Verified against agentctl commit 2aeaa88fba71162206b5f08f5bda4f0150247e4f.