Squash Odysseus development history

specs/model-providers/azure-openai.md

@@ -0,0 +1,26 @@
+# Azure OpenAI Provider Shape
+
+Last updated: dev@28d27ee | 2026-07-17
+
+## Scope
+
+Canonical provider ID `azure_openai`; Azure deployment-scoped OpenAI dialects;
+custom endpoints use explicit configuration.
+
+## Shape
+
+Azure commonly identifies deployments rather than globally stable model IDs.
+Preserve endpoint, deployment ID, API version, and underlying model/version as
+separate structured identity when returned. A standard OpenAI-compatible model
+list is identity-only until an Azure-specific reader intentionally maps its
+deployment fields.
+
+Request paths and authentication can be deployment/API-version specific; do
+not blindly append public OpenAI paths or copy provider quirks. Capability and
+limits are deployment scoped.
+
+## Fallback And Current Gaps
+
+Known `*.openai.azure.com` hosts select Azure OpenAI; other Azure gateways need
+explicit kind. Odysseus lacks a native Azure deployment catalog reader and
+structured API-version persistence in the canonical record.