anomalyco · Tangerg · Jun 1, 2026 · Jun 1, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -72,4 +72,5 @@
 | `attachment`, `reasoning`, `tool_call`, `open_weights` | Yes | Boolean capabilities |
 | `cost`, `limit`, `modalities` | Yes | Objects with their own required fields |
 | `family`, `knowledge`, `temperature`, `structured_output` | No | Optional metadata |
+| `retirement_date` | No | Date the model is/will be retired (no longer served), `YYYY-MM` or `YYYY-MM-DD` |
 | `status` | No | Use for `"alpha"`, `"beta"`, `"deprecated"` lifecycle |
diff --git a/README.md b/README.md
@@ -96,6 +96,7 @@ temperature = true          # or false - supports temperature control
 knowledge = "2024-04"       # Knowledge-cutoff date
 release_date = "2025-02-19" # First public release date
 last_updated = "2025-02-19" # Most recent update date
+retirement_date = "2027-02-19" # Optional - date the model is/will be retired
 open_weights = true         # or false  - model’s trained weights are publicly available
 
 [cost]
@@ -192,6 +193,7 @@ Models must conform to the following schema, as defined in `packages/core/src/sc
 - `knowledge` _(optional)_: String — Knowledge-cutoff date in `YYYY-MM` or `YYYY-MM-DD` format
 - `release_date`: String — First public release date in `YYYY-MM` or `YYYY-MM-DD`
 - `last_updated`: String — Most recent update date in `YYYY-MM` or `YYYY-MM-DD`
+- `retirement_date` _(optional)_: String — Date the model is (or will be) retired and no longer served by the provider, in `YYYY-MM` or `YYYY-MM-DD` format
 - `open_weights`: Boolean - Indicate the model's trained weights are publicly available
 - `interleaved` _(optional)_: Boolean or Object — Supports interleaved reasoning. Use `true` for general support or an object with `field` to specify the format
 - `interleaved.field`: String — Name of the interleaved field (`"reasoning_content"` or `"reasoning_details"`)
@@ -210,7 +212,7 @@ Models must conform to the following schema, as defined in `packages/core/src/sc
 - `status` _(optional)_: String — Supported status:
   - `alpha` - Indicate the model is in alpha testing
   - `beta` - Indicate the model is in beta testing
-  - `deprecated` - Indicate the model is no longer served by the provider's public API
+  - `deprecated` - Indicate the model is deprecated and no longer recommended; see `retirement_date` for when it is/was retired
 
 ### Examples
 

diff --git a/packages/core/src/schema.ts b/packages/core/src/schema.ts
@@ -97,6 +97,12 @@ const ModelBase = z.object({
   last_updated: z.string().regex(/^\d{4}-\d{2}(-\d{2})?$/, {
     message: "Must be in YYYY-MM or YYYY-MM-DD format",
   }),
+  retirement_date: z
+    .string()
+    .regex(/^\d{4}-\d{2}(-\d{2})?$/, {
+      message: "Must be in YYYY-MM or YYYY-MM-DD format",
+    })
+    .optional(),
   modalities: z.object({
     input: z.array(z.enum(["text", "audio", "image", "video", "pdf"])),
     output: z.array(z.enum(["text", "audio", "image", "video", "pdf"])),

diff --git a/providers/anthropic/models/claude-3-5-haiku-20241022.toml b/providers/anthropic/models/claude-3-5-haiku-20241022.toml
@@ -2,6 +2,8 @@ name = "Claude Haiku 3.5"
 family = "claude-haiku"
 release_date = "2024-10-22"
 last_updated = "2024-10-22"
+retirement_date = "2026-02-19"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/anthropic/models/claude-3-5-sonnet-20240620.toml b/providers/anthropic/models/claude-3-5-sonnet-20240620.toml
@@ -2,6 +2,8 @@ name = "Claude Sonnet 3.5"
 family = "claude-sonnet"
 release_date = "2024-06-20"
 last_updated = "2024-06-20"
+retirement_date = "2025-10-28"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/anthropic/models/claude-3-5-sonnet-20241022.toml b/providers/anthropic/models/claude-3-5-sonnet-20241022.toml
@@ -2,6 +2,8 @@ name = "Claude Sonnet 3.5 v2"
 family = "claude-sonnet"
 release_date = "2024-10-22"
 last_updated = "2024-10-22"
+retirement_date = "2025-10-28"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/anthropic/models/claude-3-7-sonnet-20250219.toml b/providers/anthropic/models/claude-3-7-sonnet-20250219.toml
@@ -2,6 +2,8 @@ name = "Claude Sonnet 3.7"
 family = "claude-sonnet"
 release_date = "2025-02-19"
 last_updated = "2025-02-19"
+retirement_date = "2026-02-19"
+status = "deprecated"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/anthropic/models/claude-3-haiku-20240307.toml b/providers/anthropic/models/claude-3-haiku-20240307.toml
@@ -2,6 +2,8 @@ name = "Claude Haiku 3"
 family = "claude-haiku"
 release_date = "2024-03-13"
 last_updated = "2024-03-13"
+retirement_date = "2026-04-20"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/anthropic/models/claude-3-opus-20240229.toml b/providers/anthropic/models/claude-3-opus-20240229.toml
@@ -2,6 +2,8 @@ name = "Claude Opus 3"
 family = "claude-opus"
 release_date = "2024-02-29"
 last_updated = "2024-02-29"
+retirement_date = "2026-01-05"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/anthropic/models/claude-3-sonnet-20240229.toml b/providers/anthropic/models/claude-3-sonnet-20240229.toml
@@ -2,6 +2,8 @@ name = "Claude Sonnet 3"
 family = "claude-sonnet"
 release_date = "2024-03-04"
 last_updated = "2024-03-04"
+retirement_date = "2025-07-21"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/anthropic/models/claude-opus-4-20250514.toml b/providers/anthropic/models/claude-opus-4-20250514.toml
@@ -2,6 +2,8 @@ name = "Claude Opus 4"
 family = "claude-opus"
 release_date = "2025-05-22"
 last_updated = "2025-05-22"
+retirement_date = "2026-06-15"
+status = "deprecated"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/anthropic/models/claude-sonnet-4-20250514.toml b/providers/anthropic/models/claude-sonnet-4-20250514.toml
@@ -2,6 +2,8 @@ name = "Claude Sonnet 4"
 family = "claude-sonnet"
 release_date = "2025-05-22"
 last_updated = "2025-05-22"
+retirement_date = "2026-06-15"
+status = "deprecated"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/cohere/models/c4ai-aya-expanse-8b.toml b/providers/cohere/models/c4ai-aya-expanse-8b.toml
@@ -1,6 +1,8 @@
 name = "Aya Expanse 8B"
 release_date = "2024-10-24"
 last_updated = "2024-10-24"
+retirement_date = "2026-04-04"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/cohere/models/c4ai-aya-vision-8b.toml b/providers/cohere/models/c4ai-aya-vision-8b.toml
@@ -1,6 +1,8 @@
 name = "Aya Vision 8B"
 release_date = "2025-03-04"
 last_updated = "2025-05-14"
+retirement_date = "2026-04-04"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/deepseek/models/deepseek-chat.toml b/providers/deepseek/models/deepseek-chat.toml
@@ -2,6 +2,8 @@ name = "DeepSeek Chat"
 family = "deepseek"
 release_date = "2025-12-01"
 last_updated = "2026-02-28"
+retirement_date = "2026-07-24"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/deepseek/models/deepseek-reasoner.toml b/providers/deepseek/models/deepseek-reasoner.toml
@@ -2,6 +2,8 @@ name = "DeepSeek Reasoner"
 family = "deepseek-thinking"
 release_date = "2025-12-01"
 last_updated = "2026-02-28"
+retirement_date = "2026-07-24"
+status = "deprecated"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/google/models/gemini-2.0-flash-lite.toml b/providers/google/models/gemini-2.0-flash-lite.toml
@@ -2,6 +2,8 @@ name = "Gemini 2.0 Flash-Lite"
 family = "gemini-flash-lite"
 release_date = "2024-12-11"
 last_updated = "2024-12-11"
+retirement_date = "2026-06-01"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/google/models/gemini-2.0-flash.toml b/providers/google/models/gemini-2.0-flash.toml
@@ -2,6 +2,8 @@ name = "Gemini 2.0 Flash"
 family = "gemini-flash"
 release_date = "2024-12-11"
 last_updated = "2024-12-11"
+retirement_date = "2026-06-01"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/google/models/gemini-2.5-flash-image.toml b/providers/google/models/gemini-2.5-flash-image.toml
@@ -2,6 +2,7 @@ name = "Nano Banana"
 family = "gemini-flash"
 release_date = "2025-08-26"
 last_updated = "2025-08-26"
+retirement_date = "2026-10-02"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/google/models/gemini-2.5-flash-lite.toml b/providers/google/models/gemini-2.5-flash-lite.toml
@@ -2,6 +2,7 @@ name = "Gemini 2.5 Flash-Lite"
 family = "gemini-flash-lite"
 release_date = "2025-06-17"
 last_updated = "2025-06-17"
+retirement_date = "2026-10-16"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/google/models/gemini-2.5-flash.toml b/providers/google/models/gemini-2.5-flash.toml
@@ -2,6 +2,7 @@ name = "Gemini 2.5 Flash"
 family = "gemini-flash"
 release_date = "2025-03-20"
 last_updated = "2025-06-05"
+retirement_date = "2026-10-16"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/google/models/gemini-2.5-pro.toml b/providers/google/models/gemini-2.5-pro.toml
@@ -2,6 +2,7 @@ name = "Gemini 2.5 Pro"
 family = "gemini-pro"
 release_date = "2025-03-20"
 last_updated = "2025-06-05"
+retirement_date = "2026-10-16"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/google/models/gemini-3-pro-preview.toml b/providers/google/models/gemini-3-pro-preview.toml
@@ -2,6 +2,8 @@ name = "Gemini 3 Pro Preview"
 family = "gemini-pro"
 release_date = "2025-11-18"
 last_updated = "2025-11-18"
+retirement_date = "2026-03-09"
+status = "deprecated"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/google/models/gemini-3.1-flash-image-preview.toml b/providers/google/models/gemini-3.1-flash-image-preview.toml
@@ -2,6 +2,7 @@ name = "Nano Banana 2"
 family = "gemini-flash"
 release_date = "2026-02-26"
 last_updated = "2026-02-26"
+retirement_date = "2026-06-25"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/google/models/gemini-3.1-flash-lite-preview.toml b/providers/google/models/gemini-3.1-flash-lite-preview.toml
@@ -2,6 +2,8 @@ name = "Gemini 3.1 Flash Lite Preview"
 family = "gemini-flash-lite"
 release_date = "2026-03-03"
 last_updated = "2026-03-03"
+retirement_date = "2026-05-25"
+status = "deprecated"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/google/models/gemini-3.1-flash-lite.toml b/providers/google/models/gemini-3.1-flash-lite.toml
@@ -2,6 +2,7 @@ name = "Gemini 3.1 Flash Lite"
 family = "gemini-flash-lite"
 release_date = "2026-05-07"
 last_updated = "2026-05-07"
+retirement_date = "2027-05-07"
 attachment = true
 reasoning = true
 temperature = true

diff --git a/providers/google/models/gemini-embedding-001.toml b/providers/google/models/gemini-embedding-001.toml
@@ -2,6 +2,7 @@ name = "Gemini Embedding 001"
 family = "gemini"
 release_date = "2025-05-20"
 last_updated = "2025-05-20"
+retirement_date = "2026-07-14"
 attachment = false
 reasoning = false
 temperature = false

diff --git a/providers/mistral/models/devstral-2512.toml b/providers/mistral/models/devstral-2512.toml
@@ -2,6 +2,8 @@ name = "Devstral 2"
 family = "devstral"
 release_date = "2025-12-09"
 last_updated = "2025-12-09"
+retirement_date = "2026-07-31"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/devstral-medium-2507.toml b/providers/mistral/models/devstral-medium-2507.toml
@@ -2,6 +2,8 @@ name = "Devstral Medium"
 family = "devstral"
 release_date = "2025-07-10"
 last_updated = "2025-07-10"
+retirement_date = "2026-03-31"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/devstral-small-2505.toml b/providers/mistral/models/devstral-small-2505.toml
@@ -2,6 +2,8 @@ name = "Devstral Small 2505"
 family = "devstral"
 release_date = "2025-05-07"
 last_updated = "2025-05-07"
+retirement_date = "2025-11-30"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/devstral-small-2507.toml b/providers/mistral/models/devstral-small-2507.toml
@@ -2,6 +2,8 @@ name = "Devstral Small"
 family = "devstral"
 release_date = "2025-07-10"
 last_updated = "2025-07-10"
+retirement_date = "2026-03-31"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/labs-devstral-small-2512.toml b/providers/mistral/models/labs-devstral-small-2512.toml
@@ -2,6 +2,8 @@ name = "Devstral Small 2"
 family = "devstral"
 release_date = "2025-12-09"
 last_updated = "2025-12-09"
+retirement_date = "2026-03-31"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/mistral-large-2411.toml b/providers/mistral/models/mistral-large-2411.toml
@@ -2,6 +2,8 @@ name = "Mistral Large 2.1"
 family = "mistral-large"
 release_date = "2024-11-01"
 last_updated = "2024-11-04"
+retirement_date = "2026-05-31"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/mistral-medium-2505.toml b/providers/mistral/models/mistral-medium-2505.toml
@@ -2,6 +2,8 @@ name = "Mistral Medium 3"
 family = "mistral-medium"
 release_date = "2025-05-07"
 last_updated = "2025-05-07"
+retirement_date = "2026-08-31"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/mistral-medium-2508.toml b/providers/mistral/models/mistral-medium-2508.toml
@@ -2,6 +2,8 @@ name = "Mistral Medium 3.1"
 family = "mistral-medium"
 release_date = "2025-08-12"
 last_updated = "2025-08-12"
+retirement_date = "2026-08-31"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/mistral-nemo.toml b/providers/mistral/models/mistral-nemo.toml
@@ -2,6 +2,8 @@ name = "Mistral Nemo"
 family = "mistral-nemo"
 release_date = "2024-07-01"
 last_updated = "2024-07-01"
+retirement_date = "2026-07-31"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/mistral-small-2506.toml b/providers/mistral/models/mistral-small-2506.toml
@@ -2,6 +2,8 @@ name = "Mistral Small 3.2"
 family = "mistral-small"
 release_date = "2025-06-20"
 last_updated = "2025-06-20"
+retirement_date = "2026-07-31"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/open-mistral-7b.toml b/providers/mistral/models/open-mistral-7b.toml
@@ -2,6 +2,8 @@ name = "Mistral 7B"
 family = "mistral"
 release_date = "2023-09-27"
 last_updated = "2023-09-27"
+retirement_date = "2025-03-30"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/open-mixtral-8x22b.toml b/providers/mistral/models/open-mixtral-8x22b.toml
@@ -2,6 +2,8 @@ name = "Mixtral 8x22B"
 family = "mixtral"
 release_date = "2024-04-17"
 last_updated = "2024-04-17"
+retirement_date = "2025-03-30"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/open-mixtral-8x7b.toml b/providers/mistral/models/open-mixtral-8x7b.toml
@@ -2,6 +2,8 @@ name = "Mixtral 8x7B"
 family = "mixtral"
 release_date = "2023-12-11"
 last_updated = "2023-12-11"
+retirement_date = "2025-03-30"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/mistral/models/pixtral-12b.toml b/providers/mistral/models/pixtral-12b.toml
@@ -2,6 +2,8 @@ name = "Pixtral 12B"
 family = "pixtral"
 release_date = "2024-09-01"
 last_updated = "2024-09-01"
+retirement_date = "2025-12-31"
+status = "deprecated"
 attachment = true
 reasoning = false
 temperature = true

diff --git a/providers/moonshotai/models/kimi-k2-0711-preview.toml b/providers/moonshotai/models/kimi-k2-0711-preview.toml
@@ -2,6 +2,8 @@ name = "Kimi K2 0711"
 family = "kimi"
 release_date = "2025-07-14"
 last_updated = "2025-07-14"
+retirement_date = "2026-05-25"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true

diff --git a/providers/moonshotai/models/kimi-k2-0905-preview.toml b/providers/moonshotai/models/kimi-k2-0905-preview.toml
@@ -2,6 +2,8 @@ name = "Kimi K2 0905"
 family = "kimi"
 release_date = "2025-09-05"
 last_updated = "2025-09-05"
+retirement_date = "2026-05-25"
+status = "deprecated"
 attachment = false
 reasoning = false
 temperature = true