add localBindingsOnly option to getPlatformProxy to disable the remote aspect of remote bindings

Author: dario-piotrowicz

.changeset/modern-foxes-dream.md

@@ -0,0 +1,5 @@
+---
+"wrangler": minor
+---
+
+add a `localBindingsOnly` option to `getPlatformProxy` to disable the remote aspect of remote bindings

fixtures/get-platform-proxy-remote-bindings/tests/local-bindings-only.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, test } from "vitest";
+import { getPlatformProxy } from "wrangler";
+import type { Ai } from "@cloudflare/workers-types/experimental";
+
+describe(
+	"getPlatformProxy - remote bindings with localBindingsOnly",
+	{ timeout: 50_000 },
+	() => {
+		test("getPlatformProxy works with remote bindings", async () => {
+			const { env, dispose } = await getPlatformProxy<{
+				AI: Ai;
+			}>({
+				configPath: "./wrangler.local-bindings-only.jsonc",
+				localBindingsOnly: true,
+			});
+
+			await expect(
+				(async () => {
+					await env.AI.run("@cf/meta/llama-3.1-8b-instruct-fp8", {
+						messages: [],
+					});
+				})()
+			).rejects.toThrowErrorMatchingInlineSnapshot(
+				`[Error: Binding AI needs to be run remotely]`
+			);
+
+			await dispose();
+		});
+	}
+);

fixtures/get-platform-proxy-remote-bindings/wrangler.local-bindings-only.jsonc

@@ -0,0 +1,8 @@
+{
+	"name": "get-platform-proxy-remote-bindings-with-local-bindings-only-test",
+	"compatibility_date": "2025-05-07",
+	"ai": {
+		"binding": "AI",
+		"remote": true,
+	},
+}

packages/wrangler/src/api/integrations/platform/index.ts

@@ -85,6 +85,11 @@ export type GetPlatformProxyOptions = {
 	 * If `false` is specified no data is persisted on the filesystem.
 	 */
 	persist?: boolean | { path: string };
+	/**
+	 * Wether only local bindings should be used. This effectively disables the remote aspect of remote bindings
+	 * (exactly as if their `remote` configuration was changed from `true` to `false`)
+	 */
+	localBindingsOnly?: boolean;
 };
 
 /**
@@ -138,7 +143,7 @@ export async function getPlatformProxy<
 	});
 
 	let remoteProxySession: RemoteProxySession | undefined = undefined;
-	if (config.configPath) {
+	if (config.configPath && !options.localBindingsOnly) {
 		remoteProxySession = (
 			(await maybeStartOrUpdateRemoteProxySession({
 				path: config.configPath,