[Workers AI] Add Model Deprecations reference page with redirects

public/__redirects

@@ -2189,7 +2189,26 @@
 /workers-ai/models/translation/ /ai/models/#translation 301
 /workers-ai/models/text-classification/ /ai/models/#text-classification 301
 /workers-ai/models/image-classification/ /ai/models/#image-classification 301
-/workers-ai/models/openchat_3.5-awq/ /workers-ai/models/ 301
+/workers-ai/models/openchat_3.5-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/deepseek-coder-6.7b-base-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/deepseek-coder-6.7b-instruct-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/deepseek-math-7b-instruct/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/discolm-german-7b-v1-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/falcon-7b-instruct/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/llama-2-13b-chat-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/llamaguard-7b-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/mistral-7b-instruct-v0.1-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/neural-chat-7b-v3-1-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/openchat-3.5-0106/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/openhermes-2.5-mistral-7b-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/qwen1.5-0.5b-chat/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/qwen1.5-1.8b-chat/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/qwen1.5-14b-chat-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/qwen1.5-7b-chat-awq/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/starling-lm-7b-beta/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/tinyllama-1.1b-chat-v1.0/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/una-cybertron-7b-v2-bf16/ /workers-ai/platform/model-deprecations/ 301
+/workers-ai/models/zephyr-7b-beta-awq/ /workers-ai/platform/model-deprecations/ 301
 
 /workers-ai/platform/bindings/ /workers-ai/configuration/bindings/ 301
 /workers-ai/get-started/local-dev-setup/ /workers-ai/get-started/workers-wrangler/ 301

src/components/models/DeprecatedModelPage.astro

@@ -0,0 +1,178 @@
+---
+import { Aside } from "~/components";
+import { DEPRECATED_MODELS } from "~/util/deprecated-models";
+
+// Group models by deprecation date
+const deprecated = DEPRECATED_MODELS.filter((m) => m.status === "deprecated");
+const planned = DEPRECATED_MODELS.filter(
+	(m) => m.status === "planned-deprecation",
+);
+
+const byDateDeprecated = deprecated.reduce(
+	(acc, m) => {
+		acc[m.deprecationDate] = acc[m.deprecationDate] || [];
+		acc[m.deprecationDate].push(m);
+		return acc;
+	},
+	{} as Record<string, typeof deprecated>,
+);
+
+const byDatePlanned = planned.reduce(
+	(acc, m) => {
+		acc[m.deprecationDate] = acc[m.deprecationDate] || [];
+		acc[m.deprecationDate].push(m);
+		return acc;
+	},
+	{} as Record<string, typeof planned>,
+);
+
+function fmtDate(dateStr: string): string {
+	return new Date(`${dateStr}T12:00:00Z`).toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "long",
+		day: "numeric",
+		timeZone: "UTC",
+	});
+}
+---
+
+<Aside type="caution">
+	<p>
+		The model you are looking for is no longer available. Refer to the
+		lists below for deprecated models, their status, and recommended
+		replacements.
+		lists below for deprecated models and their status and recommended
+		replacements.
+	</p>
+</Aside>
+
+<p>
+	We refresh the Workers AI model catalog to make room for newer
+	releases and to focus on the best-performing models. When a model is
+	deprecated, it will no longer be available for inference and existing
+	requests will return an error. Please update your applications before the
+	listed dates to avoid disruption.
+</p>
+
+<h2 id="replacements">Recommended replacements</h2>
+
+<p>
+	We recommend migrating to one of the following models, depending on your use
+	case. For the full list of available models, refer to the{" "}
+	<a href="/workers-ai/models/">Workers AI model catalog</a>.
+</p>
+
+<div class="not-content mt-4 grid grid-cols-1 gap-4 md:grid-cols-2">
+	{
+		[
+			{
+				name: "@cf/moonshotai/kimi-k2.6",
+				displayName: "Kimi K2.6",
+				url: "/workers-ai/models/kimi-k2.6/",
+				description:
+					"Flagship multimodal model with advanced reasoning, tool calling, and vision capabilities.",
+			},
+			{
+				name: "@cf/zai-org/glm-4.7-flash",
+				displayName: "GLM 4.7 Flash",
+				url: "/workers-ai/models/glm-4.7-flash/",
+				description:
+					"Fast multilingual model with multi-turn tool calling and coding capabilities.",
+			},
+			{
+				name: "@cf/openai/gpt-oss-120b",
+				displayName: "GPT-OSS 120B",
+				url: "/workers-ai/models/gpt-oss-120b/",
+				description:
+					"Open-source reasoning model with strong performance on complex tasks.",
+			},
+			{
+				name: "@cf/meta/llama-4-scout-17b-16e-instruct",
+				displayName: "Llama 4 Scout 17B 16E Instruct",
+				url: "/workers-ai/models/llama-4-scout-17b-16e-instruct/",
+				description:
+					"Efficient mixture-of-experts model with strong multilingual support.",
+			},
+		].map((replacement) => (
+			<a
+				href={replacement.url}
+				class="flex flex-col rounded-lg border border-gray-200 p-4 no-underline transition-colors hover:bg-gray-50 dark:border-gray-700 dark:hover:bg-gray-800/50"
+			>
+				<span class="text-base font-semibold text-gray-900 dark:text-gray-100">
+					{replacement.displayName}
+				</span>
+				<span class="mt-1 text-xs font-mono text-gray-500">
+					{replacement.name}
+				</span>
+				<span class="mt-2 text-sm text-gray-600 dark:text-gray-400">
+					{replacement.description}
+				</span>
+			</a>
+		))
+	}
+</div>
+
+{
+	Object.keys(byDatePlanned).length > 0 && (
+		<>
+			<h2 id="planned">Planned deprecations</h2>
+			<p>
+				The following models are scheduled for deprecation. Please update your
+				applications before the listed dates to avoid disruption.
+			</p>
+			{Object.entries(byDatePlanned)
+				.sort(([a], [b]) => a.localeCompare(b))
+				.map(([date, models]) => (
+					<div class="mt-4">
+						<h3>
+							<a href="/changelog/post/2026-05-08-planned-model-deprecations/">
+								{fmtDate(date)}
+							</a>
+						</h3>
+						<ul>
+							{models.map((m) => (
+								<li>
+									<code class="text-sm">{m.name}</code>
+									{m.slug === "kimi-k2.5" && (
+										<>
+											{" "}→{" "}
+											<code class="text-sm">
+												@cf/moonshotai/kimi-k2.6
+											</code>{" "}
+											(alias)
+										</>
+										)}
+									</li>
+								))}
+							</ul>
+						</div>
+					))}
+		</>
+	)
+}
+
+{
+	Object.keys(byDateDeprecated).length > 0 && (
+		<>
+			<h2 id="deprecated">Deprecated models</h2>
+			<p>
+				The following models are no longer available. If you still have
+				references to them, migrate to the suggested replacements.
+			</p>
+			{Object.entries(byDateDeprecated)
+				.sort(([a], [b]) => b.localeCompare(a))
+				.map(([date, models]) => (
+					<div class="mt-4">
+						<h3>{fmtDate(date)}</h3>
+						<ul>
+							{models.map((m) => (
+								<li>
+									<code class="text-sm">{m.name}</code>
+								</li>
+								))}
+							</ul>
+						</div>
+					))}
+		</>
+	)
+}

src/components/models/ModelDetailPage.astro

@@ -38,6 +38,7 @@ import { authorData } from "~/components/models/data";
 import { hasProperty } from "~/util/model-properties";
 import { getModelAuthor } from "~/util/model-resolver";
 import type { ResolvedModel } from "~/util/model-types";
+import { getDeprecatedModelInfoByName } from "~/util/deprecated-models";
 
 interface Props {
 	model: ResolvedModel;
@@ -227,6 +228,25 @@ const starlightPageProps = {
 
 	<p class="mt-3 mb-2!">{description}</p>
 
+	{
+		(() => {
+			const deprecatedInfo = getDeprecatedModelInfoByName(model.name);
+			if (!deprecatedInfo || deprecatedInfo.status !== "planned-deprecation") {
+				return false;
+			}
+			const fmtDate = new Date(`${deprecatedInfo.deprecationDate}T12:00:00Z`).toLocaleDateString("en-US", { year: "numeric", month: "long", day: "numeric", timeZone: "UTC" });
+			return (
+				<Aside type="caution" title={`Planned deprecation — ${fmtDate}`}>
+					<p>
+						This model is scheduled for deprecation. Refer to{" "}
+						<a href="/workers-ai/platform/model-deprecations/">Model Deprecations</a>{" "}
+						for recommended replacements to avoid disruption.
+					</p>
+				</Aside>
+			);
+		})()
+	}
+
 	{
 		model.name === "@cf/meta/llama-3.2-11b-vision-instruct" && (
 			<Aside>

src/content/docs/workers-ai/platform/model-deprecations.mdx

@@ -0,0 +1,11 @@
+---
+title: Model Deprecations
+pcx_content_type: reference
+description: Reference for deprecated and planned-for-deprecation Workers AI models, with recommended replacements.
+sidebar:
+  order: 11
+---
+
+import DeprecatedModelPage from "~/components/models/DeprecatedModelPage.astro";
+
+<DeprecatedModelPage />