@cloudflare/workers-types 4.20260409.1 → 4.20260411.1

package/2022-03-21/index.d.ts

@@ -471,6 +471,7 @@ interface ExecutionContext<Props = unknown> {
   waitUntil(promise: Promise<any>): void;
   passThroughOnException(): void;
   readonly props: Props;
+  cache?: CacheContext;
 }
 type ExportedHandlerFetchHandler<
   Env = unknown,
@@ -552,6 +553,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;
 }
@@ -10266,6 +10284,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;
@@ -10421,6 +10443,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;
@@ -10437,29 +10462,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(
@@ -10588,6 +10636,7 @@ declare abstract class AiGateway {
     options?: {
       gateway?: UniversalGatewayOptions;
       extraHeaders?: object;
+      signal?: AbortSignal;
     },
   ): Promise<Response>;
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
@@ -12935,7 +12984,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/2022-03-21/index.ts

@@ -473,6 +473,7 @@ export interface ExecutionContext<Props = unknown> {
   waitUntil(promise: Promise<any>): void;
   passThroughOnException(): void;
   readonly props: Props;
+  cache?: CacheContext;
 }
 export type ExportedHandlerFetchHandler<
   Env = unknown,
@@ -554,6 +555,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;
 }
@@ -10275,6 +10293,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;
@@ -10430,6 +10452,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,
 > {
@@ -10448,29 +10473,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(
@@ -10599,6 +10647,7 @@ export declare abstract class AiGateway {
     options?: {
       gateway?: UniversalGatewayOptions;
       extraHeaders?: object;
+      signal?: AbortSignal;
     },
   ): Promise<Response>;
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
@@ -12902,7 +12951,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/2022-08-04/index.d.ts

@@ -471,6 +471,7 @@ interface ExecutionContext<Props = unknown> {
   waitUntil(promise: Promise<any>): void;
   passThroughOnException(): void;
   readonly props: Props;
+  cache?: CacheContext;
 }
 type ExportedHandlerFetchHandler<
   Env = unknown,
@@ -552,6 +553,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;
 }
@@ -10267,6 +10285,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;
@@ -10422,6 +10444,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;
@@ -10438,29 +10463,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(
@@ -10589,6 +10637,7 @@ declare abstract class AiGateway {
     options?: {
       gateway?: UniversalGatewayOptions;
       extraHeaders?: object;
+      signal?: AbortSignal;
     },
   ): Promise<Response>;
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
@@ -12936,7 +12985,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/2022-08-04/index.ts

@@ -473,6 +473,7 @@ export interface ExecutionContext<Props = unknown> {
   waitUntil(promise: Promise<any>): void;
   passThroughOnException(): void;
   readonly props: Props;
+  cache?: CacheContext;
 }
 export type ExportedHandlerFetchHandler<
   Env = unknown,
@@ -554,6 +555,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;
 }
@@ -10276,6 +10294,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;
@@ -10431,6 +10453,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,
 > {
@@ -10449,29 +10474,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(
@@ -10600,6 +10648,7 @@ export declare abstract class AiGateway {
     options?: {
       gateway?: UniversalGatewayOptions;
       extraHeaders?: object;
+      signal?: AbortSignal;
     },
   ): Promise<Response>;
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
@@ -12903,7 +12952,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?(