@cloudflare/workers-types 4.20260409.1 → 4.20260411.1

package/latest/index.d.ts

@@ -479,6 +479,7 @@ interface ExecutionContext<Props = unknown> {
   passThroughOnException(): void;
   readonly exports: Cloudflare.Exports;
   readonly props: Props;
+  cache?: CacheContext;
 }
 type ExportedHandlerFetchHandler<
   Env = unknown,
@@ -562,6 +563,23 @@ interface AlarmInvocationInfo {
 interface Cloudflare {
   readonly compatibilityFlags: Record<string, boolean>;
 }
+interface CachePurgeError {
+  code: number;
+  message: string;
+}
+interface CachePurgeResult {
+  success: boolean;
+  zoneTag: string;
+  errors: CachePurgeError[];
+}
+interface CachePurgeOptions {
+  tags?: string[];
+  pathPrefixes?: string[];
+  purgeEverything?: boolean;
+}
+interface CacheContext {
+  purge(options: CachePurgeOptions): Promise<CachePurgeResult>;
+}
 declare abstract class ColoLocalActorNamespace {
   get(actorId: string): Fetcher;
 }
@@ -10331,6 +10349,10 @@ declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
   inputs: ChatCompletionsInput;
   postProcessedOutputs: ChatCompletionsOutput;
 }
+declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
+  inputs: ChatCompletionsInput;
+  postProcessedOutputs: ChatCompletionsOutput;
+}
 interface AiModels {
   "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
   "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
@@ -10486,6 +10508,9 @@ type ChatCompletionsInput = XOR<
 interface InferenceUpstreamError extends Error {}
 interface AiInternalError extends Error {}
 type AiModelListType = Record<string, any>;
+type AiAsyncBatchResponse = {
+  request_id: string;
+};
 declare abstract class Ai<AiModelList extends AiModelListType = AiModels> {
   aiGatewayLogId: string | null;
   gateway(gatewayId: string): AiGateway;
@@ -10502,29 +10527,52 @@ declare abstract class Ai<AiModelList extends AiModelListType = AiModels> {
    * @param autoragId Instance ID
    */
   autorag(autoragId: string): AutoRAG;
-  run<
-    Name extends keyof AiModelList,
-    Options extends AiOptions,
-    InputOptions extends AiModelList[Name]["inputs"],
-  >(
+  // Batch request
+  run<Name extends keyof AiModelList>(
     model: Name,
-    inputs: InputOptions,
-    options?: Options,
-  ): Promise<
-    Options extends
-      | {
-          returnRawResponse: true;
-        }
-      | {
-          websocket: true;
-        }
-      ? Response
-      : InputOptions extends {
-            stream: true;
-          }
-        ? ReadableStream
-        : AiModelList[Name]["postProcessedOutputs"]
-  >;
+    inputs: {
+      requests: AiModelList[Name]["inputs"][];
+    },
+    options: AiOptions & {
+      queueRequest: true;
+    },
+  ): Promise<AiAsyncBatchResponse>;
+  // Raw response
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options: AiOptions & {
+      returnRawResponse: true;
+    },
+  ): Promise<Response>;
+  // WebSocket
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options: AiOptions & {
+      websocket: true;
+    },
+  ): Promise<Response>;
+  // Streaming
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"] & {
+      stream: true;
+    },
+    options?: AiOptions,
+  ): Promise<ReadableStream>;
+  // Normal (default) - known model
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options?: AiOptions,
+  ): Promise<AiModelList[Name]["postProcessedOutputs"]>;
+  // Unknown model (gateway fallback)
+  run(
+    model: string & {},
+    inputs: Record<string, unknown>,
+    options?: AiOptions,
+  ): Promise<Record<string, unknown>>;
   models(params?: AiModelsSearchParams): Promise<AiModelsSearchObject[]>;
   toMarkdown(): ToMarkdownService;
   toMarkdown(
@@ -10653,6 +10701,7 @@ declare abstract class AiGateway {
     options?: {
       gateway?: UniversalGatewayOptions;
       extraHeaders?: object;
+      signal?: AbortSignal;
     },
   ): Promise<Response>;
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
@@ -13000,7 +13049,7 @@ declare namespace CloudflareWorkersModule {
     email?(message: ForwardableEmailMessage): void | Promise<void>;
     fetch?(request: Request): Response | Promise<Response>;
     connect?(socket: Socket): void | Promise<void>;
-    queue?(batch: MessageBatch<unknown>): void | Promise<void>;
+    queue?(batch: MessageBatch): void | Promise<void>;
     scheduled?(controller: ScheduledController): void | Promise<void>;
     tail?(events: TraceItem[]): void | Promise<void>;
     tailStream?(

package/latest/index.ts

@@ -481,6 +481,7 @@ export interface ExecutionContext<Props = unknown> {
   passThroughOnException(): void;
   readonly exports: Cloudflare.Exports;
   readonly props: Props;
+  cache?: CacheContext;
 }
 export type ExportedHandlerFetchHandler<
   Env = unknown,
@@ -564,6 +565,23 @@ export interface AlarmInvocationInfo {
 export interface Cloudflare {
   readonly compatibilityFlags: Record<string, boolean>;
 }
+export interface CachePurgeError {
+  code: number;
+  message: string;
+}
+export interface CachePurgeResult {
+  success: boolean;
+  zoneTag: string;
+  errors: CachePurgeError[];
+}
+export interface CachePurgeOptions {
+  tags?: string[];
+  pathPrefixes?: string[];
+  purgeEverything?: boolean;
+}
+export interface CacheContext {
+  purge(options: CachePurgeOptions): Promise<CachePurgeResult>;
+}
 export declare abstract class ColoLocalActorNamespace {
   get(actorId: string): Fetcher;
 }
@@ -10340,6 +10358,10 @@ export declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
   inputs: ChatCompletionsInput;
   postProcessedOutputs: ChatCompletionsOutput;
 }
+export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
+  inputs: ChatCompletionsInput;
+  postProcessedOutputs: ChatCompletionsOutput;
+}
 export interface AiModels {
   "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
   "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
@@ -10495,6 +10517,9 @@ export type ChatCompletionsInput = XOR<
 export interface InferenceUpstreamError extends Error {}
 export interface AiInternalError extends Error {}
 export type AiModelListType = Record<string, any>;
+export type AiAsyncBatchResponse = {
+  request_id: string;
+};
 export declare abstract class Ai<
   AiModelList extends AiModelListType = AiModels,
 > {
@@ -10513,29 +10538,52 @@ export declare abstract class Ai<
    * @param autoragId Instance ID
    */
   autorag(autoragId: string): AutoRAG;
-  run<
-    Name extends keyof AiModelList,
-    Options extends AiOptions,
-    InputOptions extends AiModelList[Name]["inputs"],
-  >(
+  // Batch request
+  run<Name extends keyof AiModelList>(
     model: Name,
-    inputs: InputOptions,
-    options?: Options,
-  ): Promise<
-    Options extends
-      | {
-          returnRawResponse: true;
-        }
-      | {
-          websocket: true;
-        }
-      ? Response
-      : InputOptions extends {
-            stream: true;
-          }
-        ? ReadableStream
-        : AiModelList[Name]["postProcessedOutputs"]
-  >;
+    inputs: {
+      requests: AiModelList[Name]["inputs"][];
+    },
+    options: AiOptions & {
+      queueRequest: true;
+    },
+  ): Promise<AiAsyncBatchResponse>;
+  // Raw response
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options: AiOptions & {
+      returnRawResponse: true;
+    },
+  ): Promise<Response>;
+  // WebSocket
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options: AiOptions & {
+      websocket: true;
+    },
+  ): Promise<Response>;
+  // Streaming
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"] & {
+      stream: true;
+    },
+    options?: AiOptions,
+  ): Promise<ReadableStream>;
+  // Normal (default) - known model
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options?: AiOptions,
+  ): Promise<AiModelList[Name]["postProcessedOutputs"]>;
+  // Unknown model (gateway fallback)
+  run(
+    model: string & {},
+    inputs: Record<string, unknown>,
+    options?: AiOptions,
+  ): Promise<Record<string, unknown>>;
   models(params?: AiModelsSearchParams): Promise<AiModelsSearchObject[]>;
   toMarkdown(): ToMarkdownService;
   toMarkdown(
@@ -10664,6 +10712,7 @@ export declare abstract class AiGateway {
     options?: {
       gateway?: UniversalGatewayOptions;
       extraHeaders?: object;
+      signal?: AbortSignal;
     },
   ): Promise<Response>;
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
@@ -12967,7 +13016,7 @@ export declare namespace CloudflareWorkersModule {
     email?(message: ForwardableEmailMessage): void | Promise<void>;
     fetch?(request: Request): Response | Promise<Response>;
     connect?(socket: Socket): void | Promise<void>;
-    queue?(batch: MessageBatch<unknown>): void | Promise<void>;
+    queue?(batch: MessageBatch): void | Promise<void>;
     scheduled?(controller: ScheduledController): void | Promise<void>;
     tail?(events: TraceItem[]): void | Promise<void>;
     tailStream?(

package/oldest/index.d.ts

@@ -468,6 +468,7 @@ interface ExecutionContext<Props = unknown> {
   waitUntil(promise: Promise<any>): void;
   passThroughOnException(): void;
   readonly props: Props;
+  cache?: CacheContext;
 }
 type ExportedHandlerFetchHandler<
   Env = unknown,
@@ -544,6 +545,23 @@ interface AlarmInvocationInfo {
 interface Cloudflare {
   readonly compatibilityFlags: Record<string, boolean>;
 }
+interface CachePurgeError {
+  code: number;
+  message: string;
+}
+interface CachePurgeResult {
+  success: boolean;
+  zoneTag: string;
+  errors: CachePurgeError[];
+}
+interface CachePurgeOptions {
+  tags?: string[];
+  pathPrefixes?: string[];
+  purgeEverything?: boolean;
+}
+interface CacheContext {
+  purge(options: CachePurgeOptions): Promise<CachePurgeResult>;
+}
 declare abstract class ColoLocalActorNamespace {
   get(actorId: string): Fetcher;
 }
@@ -10191,6 +10209,10 @@ declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
   inputs: ChatCompletionsInput;
   postProcessedOutputs: ChatCompletionsOutput;
 }
+declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
+  inputs: ChatCompletionsInput;
+  postProcessedOutputs: ChatCompletionsOutput;
+}
 interface AiModels {
   "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
   "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
@@ -10346,6 +10368,9 @@ type ChatCompletionsInput = XOR<
 interface InferenceUpstreamError extends Error {}
 interface AiInternalError extends Error {}
 type AiModelListType = Record<string, any>;
+type AiAsyncBatchResponse = {
+  request_id: string;
+};
 declare abstract class Ai<AiModelList extends AiModelListType = AiModels> {
   aiGatewayLogId: string | null;
   gateway(gatewayId: string): AiGateway;
@@ -10362,29 +10387,52 @@ declare abstract class Ai<AiModelList extends AiModelListType = AiModels> {
    * @param autoragId Instance ID
    */
   autorag(autoragId: string): AutoRAG;
-  run<
-    Name extends keyof AiModelList,
-    Options extends AiOptions,
-    InputOptions extends AiModelList[Name]["inputs"],
-  >(
+  // Batch request
+  run<Name extends keyof AiModelList>(
     model: Name,
-    inputs: InputOptions,
-    options?: Options,
-  ): Promise<
-    Options extends
-      | {
-          returnRawResponse: true;
-        }
-      | {
-          websocket: true;
-        }
-      ? Response
-      : InputOptions extends {
-            stream: true;
-          }
-        ? ReadableStream
-        : AiModelList[Name]["postProcessedOutputs"]
-  >;
+    inputs: {
+      requests: AiModelList[Name]["inputs"][];
+    },
+    options: AiOptions & {
+      queueRequest: true;
+    },
+  ): Promise<AiAsyncBatchResponse>;
+  // Raw response
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options: AiOptions & {
+      returnRawResponse: true;
+    },
+  ): Promise<Response>;
+  // WebSocket
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options: AiOptions & {
+      websocket: true;
+    },
+  ): Promise<Response>;
+  // Streaming
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"] & {
+      stream: true;
+    },
+    options?: AiOptions,
+  ): Promise<ReadableStream>;
+  // Normal (default) - known model
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options?: AiOptions,
+  ): Promise<AiModelList[Name]["postProcessedOutputs"]>;
+  // Unknown model (gateway fallback)
+  run(
+    model: string & {},
+    inputs: Record<string, unknown>,
+    options?: AiOptions,
+  ): Promise<Record<string, unknown>>;
   models(params?: AiModelsSearchParams): Promise<AiModelsSearchObject[]>;
   toMarkdown(): ToMarkdownService;
   toMarkdown(
@@ -10513,6 +10561,7 @@ declare abstract class AiGateway {
     options?: {
       gateway?: UniversalGatewayOptions;
       extraHeaders?: object;
+      signal?: AbortSignal;
     },
   ): Promise<Response>;
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
@@ -12860,7 +12909,7 @@ declare namespace CloudflareWorkersModule {
     email?(message: ForwardableEmailMessage): void | Promise<void>;
     fetch?(request: Request): Response | Promise<Response>;
     connect?(socket: Socket): void | Promise<void>;
-    queue?(batch: MessageBatch<unknown>): void | Promise<void>;
+    queue?(batch: MessageBatch): void | Promise<void>;
     scheduled?(controller: ScheduledController): void | Promise<void>;
     tail?(events: TraceItem[]): void | Promise<void>;
     tailStream?(

package/oldest/index.ts

@@ -470,6 +470,7 @@ export interface ExecutionContext<Props = unknown> {
   waitUntil(promise: Promise<any>): void;
   passThroughOnException(): void;
   readonly props: Props;
+  cache?: CacheContext;
 }
 export type ExportedHandlerFetchHandler<
   Env = unknown,
@@ -546,6 +547,23 @@ export interface AlarmInvocationInfo {
 export interface Cloudflare {
   readonly compatibilityFlags: Record<string, boolean>;
 }
+export interface CachePurgeError {
+  code: number;
+  message: string;
+}
+export interface CachePurgeResult {
+  success: boolean;
+  zoneTag: string;
+  errors: CachePurgeError[];
+}
+export interface CachePurgeOptions {
+  tags?: string[];
+  pathPrefixes?: string[];
+  purgeEverything?: boolean;
+}
+export interface CacheContext {
+  purge(options: CachePurgeOptions): Promise<CachePurgeResult>;
+}
 export declare abstract class ColoLocalActorNamespace {
   get(actorId: string): Fetcher;
 }
@@ -10200,6 +10218,10 @@ export declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
   inputs: ChatCompletionsInput;
   postProcessedOutputs: ChatCompletionsOutput;
 }
+export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
+  inputs: ChatCompletionsInput;
+  postProcessedOutputs: ChatCompletionsOutput;
+}
 export interface AiModels {
   "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
   "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
@@ -10355,6 +10377,9 @@ export type ChatCompletionsInput = XOR<
 export interface InferenceUpstreamError extends Error {}
 export interface AiInternalError extends Error {}
 export type AiModelListType = Record<string, any>;
+export type AiAsyncBatchResponse = {
+  request_id: string;
+};
 export declare abstract class Ai<
   AiModelList extends AiModelListType = AiModels,
 > {
@@ -10373,29 +10398,52 @@ export declare abstract class Ai<
    * @param autoragId Instance ID
    */
   autorag(autoragId: string): AutoRAG;
-  run<
-    Name extends keyof AiModelList,
-    Options extends AiOptions,
-    InputOptions extends AiModelList[Name]["inputs"],
-  >(
+  // Batch request
+  run<Name extends keyof AiModelList>(
     model: Name,
-    inputs: InputOptions,
-    options?: Options,
-  ): Promise<
-    Options extends
-      | {
-          returnRawResponse: true;
-        }
-      | {
-          websocket: true;
-        }
-      ? Response
-      : InputOptions extends {
-            stream: true;
-          }
-        ? ReadableStream
-        : AiModelList[Name]["postProcessedOutputs"]
-  >;
+    inputs: {
+      requests: AiModelList[Name]["inputs"][];
+    },
+    options: AiOptions & {
+      queueRequest: true;
+    },
+  ): Promise<AiAsyncBatchResponse>;
+  // Raw response
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options: AiOptions & {
+      returnRawResponse: true;
+    },
+  ): Promise<Response>;
+  // WebSocket
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options: AiOptions & {
+      websocket: true;
+    },
+  ): Promise<Response>;
+  // Streaming
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"] & {
+      stream: true;
+    },
+    options?: AiOptions,
+  ): Promise<ReadableStream>;
+  // Normal (default) - known model
+  run<Name extends keyof AiModelList>(
+    model: Name,
+    inputs: AiModelList[Name]["inputs"],
+    options?: AiOptions,
+  ): Promise<AiModelList[Name]["postProcessedOutputs"]>;
+  // Unknown model (gateway fallback)
+  run(
+    model: string & {},
+    inputs: Record<string, unknown>,
+    options?: AiOptions,
+  ): Promise<Record<string, unknown>>;
   models(params?: AiModelsSearchParams): Promise<AiModelsSearchObject[]>;
   toMarkdown(): ToMarkdownService;
   toMarkdown(
@@ -10524,6 +10572,7 @@ export declare abstract class AiGateway {
     options?: {
       gateway?: UniversalGatewayOptions;
       extraHeaders?: object;
+      signal?: AbortSignal;
     },
   ): Promise<Response>;
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
@@ -12827,7 +12876,7 @@ export declare namespace CloudflareWorkersModule {
     email?(message: ForwardableEmailMessage): void | Promise<void>;
     fetch?(request: Request): Response | Promise<Response>;
     connect?(socket: Socket): void | Promise<void>;
-    queue?(batch: MessageBatch<unknown>): void | Promise<void>;
+    queue?(batch: MessageBatch): void | Promise<void>;
     scheduled?(controller: ScheduledController): void | Promise<void>;
     tail?(events: TraceItem[]): void | Promise<void>;
     tailStream?(

package/package.json

@@ -7,5 +7,5 @@
   },
   "author": "Cloudflare Workers DevProd Team <workers-devprod@cloudflare.com> (https://workers.cloudflare.com)",
   "license": "MIT OR Apache-2.0",
-  "version": "4.20260409.1"
+  "version": "4.20260411.1"
 }