Merge branch 'cloudflare:production' into production

Author: coffee-mug

.github/CODEOWNERS

@@ -44,7 +44,7 @@
 
 # Browser Rendering API
 
-/src/content/docs/browser-rendering/ @mchenco @cloudflare/pcx-technical-writing @celso @meddulla @danielgek
+/src/content/docs/browser-rendering/ @mchenco @cloudflare/pcx-technical-writing @celso @meddulla @danielgek @kathayl
 
 # Changelogs
 

.github/workflows/image-audit.yml

@@ -21,7 +21,7 @@ jobs:
         id: find-files
         run: |
           # Find all .png and .svg files, but only look in the ./src/assets/images directory
-          FILES=$(find . -type f \( -name "*.png" -o -name "*.svg" \) -path "./src/assets/images/*" -not -path "./src/assets/images/workers-ai/*.svg" -not -path "./src/assets/images/workers/ai/*.png" -not -path "./src/assets/images/changelog-next/*")
+          FILES=$(find . -type f \( -name "*.png" -o -name "*.svg" \) -path "./src/assets/images/*" -not -path "./src/assets/images/workers-ai/*.svg" -not -path "./src/assets/images/workers/ai/*.png" -not -path "./src/assets/images/changelog/*")
 
           # Check if files are referenced in any markdown file
           UNUSED_FILES=""

package-lock.json

@@ -36,7 +36,7 @@
 		"@astrojs/starlight-docsearch": "0.6.0",
 		"@astrojs/starlight-tailwind": "3.0.1",
 		"@astrojs/tailwind": "5.1.5",
-		"@cloudflare/vitest-pool-workers": "0.8.6",
+		"@cloudflare/vitest-pool-workers": "0.8.8",
 		"@cloudflare/workers-types": "4.20250327.0",
 		"@codingheads/sticky-header": "1.0.2",
 		"@expressive-code/plugin-collapsible-sections": "0.40.2",
@@ -47,12 +47,12 @@
 		"@stoplight/json-schema-tree": "4.0.0",
 		"@types/hast": "3.0.4",
 		"@types/he": "1.2.3",
-		"@types/node": "22.13.14",
+		"@types/node": "22.13.17",
 		"@types/react": "19.0.7",
 		"@types/react-dom": "19.0.4",
-		"@typescript-eslint/parser": "8.28.0",
-		"algoliasearch": "5.23.0",
-		"astro": "5.5.5",
+		"@typescript-eslint/parser": "8.29.0",
+		"algoliasearch": "5.23.1",
+		"astro": "5.5.6",
 		"astro-breadcrumbs": "3.3.1",
 		"astro-icon": "1.1.5",
 		"astro-live-code": "0.0.5",
@@ -116,7 +116,7 @@
 		"ts-blank-space": "0.6.1",
 		"tsx": "4.19.3",
 		"typescript": "5.8.2",
-		"typescript-eslint": "8.28.0",
+		"typescript-eslint": "8.29.0",
 		"unified": "11.0.5",
 		"unist-util-visit": "5.0.0",
 		"vite-tsconfig-paths": "5.1.4",

package.json

@@ -1110,6 +1110,7 @@
 /support/more-dashboard-apps/cloudflare-apps/reporting-bugs-or-feature-requests-for-cloudflare-apps/ /workers/ 301
 /support/more-dashboard-apps/cloudflare-apps/troubleshooting-issues-with-cloudflare-apps/ /workers/ 301
 /support/more-dashboard-apps/cloudflare-apps/will-cloudflare-apps-make-my-site-slower/ /workers/ 301
+/support/more-dashboard-apps/cloudflare-stream/delivering-videos-with-cloudflare/ /fundamentals/reference/policies-compliances/delivering-videos-with-cloudflare/ 301
 /support/network/ /network/ 301
 /support/network/configuring-ip-geolocation/ /network/ip-geolocation/ 301
 /support/network/setting-up-response-buffering/ /network/response-buffering/ 301
@@ -1182,6 +1183,7 @@
 /support/more-dashboard-apps/cloudflare-apps/managing-cloudflare-apps/ /workers/ 301
 /support/more-dashboard-apps/cloudflare-apps/removing-cloudflare-apps/ /workers/ 301
 /support/troubleshooting/http-status-codes/http-status-codes/ /support/troubleshooting/http-status-codes/ 301
+/support/troubleshooting/cloudflare-errors/troubleshooting-other-errors/ /speed/optimization/protocol/http2/#err_http2_protocol_error 301
 
 # r2
 /r2/platform/s3-compatibility/api/ /r2/api/s3/api/ 301

public/__redirects

@@ -8,13 +8,15 @@ import Details from "./Details.astro";
 
 type Props = z.input<typeof props>;
 
+const Record = z.record(z.string(), z.any());
+
 const props = z
 	.object({
 		path: z.string(),
 		method: z.enum(["GET", "HEAD", "POST", "PUT", "DELETE", "PATCH"]),
 		parameters: z.record(z.string(), z.any()).optional(),
-		json: z.record(z.string(), z.any()).optional(),
-		form: z.record(z.string(), z.any()).optional(),
+		json: z.union([Record, z.array(Record)]).optional(),
+		form: Record.optional(),
 	})
 	.strict();
 
@@ -109,17 +111,27 @@ const jsonSchema = requestBody?.content?.["application/json"]?.schema as
 	| undefined;
 
 if (jsonSchema?.required) {
-	const providedProperties = Object.keys(json ?? {});
-	const requiredProperties = jsonSchema.required;
-
-	const missingProperties = requiredProperties.filter(
-		(property) => !providedProperties.includes(property),
-	);
+	const checkProperties = (obj?: object) => {
+		const providedProperties = Object.keys(obj ?? {});
+		const requiredProperties = jsonSchema.required!;
 
-	if (missingProperties.length > 0) {
-		throw new Error(
-			`[APIRequest] Missing the following required properties for ${method} ${path}: ${missingProperties.join(", ")}`,
+		const missingProperties = requiredProperties.filter(
+			(property) => !providedProperties.includes(property),
 		);
+
+		if (missingProperties.length > 0) {
+			throw new Error(
+				`[APIRequest] Missing the following required properties for ${method} ${path}: ${missingProperties.join(", ")}`,
+			);
+		}
+	};
+
+	if (Array.isArray(json)) {
+		for (const obj of json) {
+			checkProperties(obj);
+		}
+	} else {
+		checkProperties(json);
 	}
 }
 
@@ -136,7 +148,9 @@ const tokenGroups = operation["x-api-token-group"];
 			</span>
 			<ul>
 				{tokenGroups.map((group) => (
-					<li><code>{group}</code></li>
+					<li>
+						<code>{group}</code>
+					</li>
 				))}
 			</ul>
 		</Details>

src/assets/images/magic-transit/ipv6.png

@@ -5,14 +5,16 @@ import { Code } from "@astrojs/starlight/components";
 
 type Props = z.input<typeof props>;
 
+const Record = z.record(z.string(), z.any());
+
 const props = z.object({
 	method: z
 		.enum(["GET", "HEAD", "POST", "PUT", "DELETE", "OPTIONS", "PATCH"])
 		.default("GET"),
 	url: z.string().url(),
 	headers: z.record(z.string(), z.string()).default({}),
-	json: z.record(z.string(), z.any()).optional(),
-	form: z.record(z.string(), z.any()).optional(),
+	json: z.union([Record, z.array(Record)]).optional(),
+	form: Record.optional(),
 	code: z
 		.custom<Omit<ComponentProps<typeof Code>, "code" | "lang">>()
 		.optional(),
@@ -41,7 +43,8 @@ if (json) {
 
 if (form) {
 	const formLines = Object.entries(form).map(
-		([key, value]) => `\t--form "${key}=${value}"`,
+		([key, value]) =>
+			`\t--form "${key}=${value.toString().replaceAll('"', '\\"')}"`,
 	);
 	lines.push(...formLines);
 }

src/assets/images/pulumi/hello-world-tutorial/sn2.png

@@ -1,4 +1,4 @@
-import { useEffect, useState } from "react";
+import { useEffect, useState, useMemo } from "react";
 import ModelInfo from "./models/ModelInfo";
 import ModelBadges from "./models/ModelBadges";
 import { authorData } from "./models/data";
@@ -19,6 +19,37 @@ const ModelCatalog = ({ models }: { models: WorkersAIModelsSchema[] }) => {
 		capabilities: [],
 	});
 
+	// List of model names to pin at the top
+	const pinnedModelNames = [
+		"@cf/meta/llama-3.3-70b-instruct-fp8-fast",
+		"@cf/meta/llama-3.1-8b-instruct-fast",
+	];
+
+	// Sort models by pinned status first, then by created_at date
+	const sortedModels = useMemo(() => {
+		return [...models].sort((a, b) => {
+			// First check if either model is pinned
+			const isPinnedA = pinnedModelNames.includes(a.name);
+			const isPinnedB = pinnedModelNames.includes(b.name);
+
+			// If pinned status differs, prioritize pinned models
+			if (isPinnedA && !isPinnedB) return -1;
+			if (!isPinnedA && isPinnedB) return 1;
+
+			// If both are pinned, sort by position in pinnedModelNames array (for manual ordering)
+			if (isPinnedA && isPinnedB) {
+				return (
+					pinnedModelNames.indexOf(a.name) - pinnedModelNames.indexOf(b.name)
+				);
+			}
+
+			// If neither is pinned, sort by created_at date (newest first)
+			const dateA = a.created_at ? new Date(a.created_at) : new Date(0);
+			const dateB = b.created_at ? new Date(b.created_at) : new Date(0);
+			return dateB.getTime() - dateA.getTime();
+		});
+	}, [models]);
+
 	useEffect(() => {
 		const params = new URLSearchParams(window.location.search);
 
@@ -35,7 +66,7 @@ const ModelCatalog = ({ models }: { models: WorkersAIModelsSchema[] }) => {
 		});
 	}, []);
 
-	const mapped = models.map((model) => ({
+	const mapped = sortedModels.map((model) => ({
 		model: {
 			...model,
 			capabilities: model.properties
@@ -237,13 +268,19 @@ const ModelCatalog = ({ models }: { models: WorkersAIModelsSchema[] }) => {
 
 					const author = model.model.name.split("/")[1];
 					const authorInfo = authorData[author];
+					const isPinned = pinnedModelNames.includes(model.model.name);
 
 					return (
 						<a
 							key={model.model.id}
-							className="mb-3 block w-full self-start rounded-md border border-solid border-gray-200 p-3 !text-inherit no-underline hover:bg-gray-50 dark:border-gray-700 dark:hover:bg-gray-800 lg:w-[48%]"
+							className="relative mb-3 block w-full self-start rounded-md border border-solid border-gray-200 p-3 !text-inherit no-underline hover:bg-gray-50 dark:border-gray-700 dark:hover:bg-gray-800 lg:w-[48%]"
 							href={`/workers-ai/models/${model.model_display_name}`}
 						>
+							{isPinned && (
+								<span className="absolute right-2 top-1" title="Pinned model">
+									📌
+								</span>
+							)}
 							<div className="-mb-1 flex items-center">
 								{authorInfo?.logo ? (
 									<img

src/assets/images/pulumi/hello-world-tutorial/sn3.png

@@ -17,7 +17,7 @@ const ModelBadges = ({ model }: { model: WorkersAIModelsSchema }) => {
 		}
 
 		if (property_id === "planned_deprecation_date") {
-			const timestamp = Math.floor(new Date(value).getTime() / 1000);
+			const timestamp = Math.floor(new Date(value as string).getTime() / 1000);
 
 			if (Date.now() > timestamp) {
 				return { variant: "danger", text: "Deprecated" };

src/assets/images/pulumi/hello-world-tutorial/sn4.png

@@ -2,6 +2,11 @@ import type { WorkersAIModelsSchema } from "~/schemas";
 
 const ModelFeatures = ({ model }: { model: WorkersAIModelsSchema }) => {
 	const nf = new Intl.NumberFormat("en-US");
+	const currencyFormatter = new Intl.NumberFormat("en-US", {
+		style: "currency",
+		currency: "USD",
+		maximumFractionDigits: 10,
+	});
 	const properties: any = {};
 	model.properties.forEach((property: any) => {
 		properties[property.property_id] = property.value;
@@ -15,7 +20,7 @@ const ModelFeatures = ({ model }: { model: WorkersAIModelsSchema }) => {
 						<thead>
 							<tr>
 								<>
-									<th>Features</th>
+									<th>Model Info</th>
 									<th />
 								</>
 							</tr>
@@ -105,6 +110,19 @@ const ModelFeatures = ({ model }: { model: WorkersAIModelsSchema }) => {
 									<td>Yes</td>
 								</tr>
 							)}
+							{properties.price && properties.price.length > 0 && (
+								<tr>
+									<td>Unit Pricing</td>
+									<td>
+										{properties.price
+											.map(
+												(price: { price: number; unit: string }) =>
+													`${currencyFormatter.format(price.price)} ${price.unit}`,
+											)
+											.join(", ")}
+									</td>
+								</tr>
+							)}
 						</tbody>
 					</table>
 				</>

src/assets/images/pulumi/hello-world-tutorial/sn5.png

@@ -5,6 +5,9 @@ import mistral from "../../assets/images/workers-ai/mistralai.svg";
 import stabilityai from "../../assets/images/workers-ai/stabilityai.svg";
 import huggingface from "../../assets/images/workers-ai/huggingface.svg";
 import google from "../../assets/images/workers-ai/google.svg";
+import deepseek from "../../assets/images/workers-ai/deepseek.svg";
+import qwen from "../../assets/images/workers-ai/qwen.svg";
+import blackforestlabs from "../../assets/images/workers-ai/blackforestlabs.svg";
 
 export const authorData: Record<string, { name: string; logo: string }> = {
 	openai: {
@@ -39,4 +42,16 @@ export const authorData: Record<string, { name: string; logo: string }> = {
 		name: "Google",
 		logo: google.src,
 	},
+	"deepseek-ai": {
+		name: "DeepSeek",
+		logo: deepseek.src,
+	},
+	qwen: {
+		name: "Qwen",
+		logo: qwen.src,
+	},
+	"black-forest-labs": {
+		name: "Black Forest Labs",
+		logo: blackforestlabs.src,
+	},
 };

src/assets/images/pulumi/hello-world-tutorial/sn6.png

@@ -0,0 +1,14 @@
+---
+_build:
+  publishResources: false
+  render: never
+  list: never
+
+name: "Override cache rules cache settings in `request.cf` object for Fetch API"
+sort_date: "2023-08-01"
+enable_date: "2025-04-02"
+enable_flag: "request_cf_overrides_cache_rules"
+disable_flag: "no_request_cf_overrides_cache_rules"
+---
+
+This flag changes the behavior of cache when requesting assets via the [Fetch API](/workers/runtime-apis/fetch). Cache settings specified in the `request.cf` object, such as `cacheEverything` and `cacheTtl`, are now given precedence over any [Cache Rules](/cache/how-to/cache-rules/) set.

src/assets/images/reference-architecture/storing-user-generated-content/ai-generated-content-in-r2.svg

@@ -73,7 +73,7 @@ sequenceDiagram
     Note over C,M: Begin standard MCP message exchange
 ```
 
-Remember — [authentication is different from authorization](https://www.cloudflare.com/learning/access-management/authn-vs-authz/). Your MCP Server can handle authorization itself, while still relying on an external authentication service to first authenticate users. The [example](/agents/guides/remote-mcp-server) in getting started provides a mock authentdcation flow. You will need to implement your own authentication handler — either handling authentication yourself, or using an external authentication services.
+Remember — [authentication is different from authorization](https://www.cloudflare.com/learning/access-management/authn-vs-authz/). Your MCP Server can handle authorization itself, while still relying on an external authentication service to first authenticate users. The [example](/agents/guides/remote-mcp-server) in getting started provides a mock authentication flow. You will need to implement your own authentication handler — either handling authentication yourself, or using an external authentication services.
 
 ### (2) Third-party OAuth Provider