@cloudflare/workers-types 4.20260317.1 → 4.20260331.1

package/2021-11-03/index.d.ts

@@ -478,6 +478,11 @@ type ExportedHandlerFetchHandler<
   env: Env,
   ctx: ExecutionContext<Props>,
 ) => Response | Promise<Response>;
+type ExportedHandlerConnectHandler<Env = unknown, Props = unknown> = (
+  socket: Socket,
+  env: Env,
+  ctx: ExecutionContext<Props>,
+) => void | Promise<void>;
 type ExportedHandlerTailHandler<Env = unknown, Props = unknown> = (
   events: TraceItem[],
   env: Env,
@@ -519,6 +524,7 @@ interface ExportedHandler<
   Props = unknown,
 > {
   fetch?: ExportedHandlerFetchHandler<Env, CfHostMetadata, Props>;
+  connect?: ExportedHandlerConnectHandler<Env, Props>;
   tail?: ExportedHandlerTailHandler<Env, Props>;
   trace?: ExportedHandlerTraceHandler<Env, Props>;
   tailStream?: ExportedHandlerTailStreamHandler<Env, Props>;
@@ -533,12 +539,14 @@ interface StructuredSerializeOptions {
 interface AlarmInvocationInfo {
   readonly isRetry: boolean;
   readonly retryCount: number;
+  readonly scheduledTime: number;
 }
 interface Cloudflare {
   readonly compatibilityFlags: Record<string, boolean>;
 }
 interface DurableObject {
   fetch(request: Request): Response | Promise<Response>;
+  connect?(socket: Socket): void | Promise<void>;
   alarm?(alarmInfo?: AlarmInvocationInfo): void | Promise<void>;
   webSocketMessage?(
     ws: WebSocket,
@@ -556,7 +564,7 @@ type DurableObjectStub<
   T extends Rpc.DurableObjectBranded | undefined = undefined,
 > = Fetcher<
   T,
-  "alarm" | "webSocketMessage" | "webSocketClose" | "webSocketError"
+  "alarm" | "connect" | "webSocketMessage" | "webSocketClose" | "webSocketError"
 > & {
   readonly id: DurableObjectId;
   readonly name?: string;
@@ -565,6 +573,7 @@ interface DurableObjectId {
   toString(): string;
   equals(other: DurableObjectId): boolean;
   readonly name?: string;
+  readonly jurisdiction?: string;
 }
 declare abstract class DurableObjectNamespace<
   T extends Rpc.DurableObjectBranded | undefined = undefined,
@@ -3067,6 +3076,11 @@ interface QueuingStrategyInit {
    */
   highWaterMark: number;
 }
+interface TracePreviewInfo {
+  id: string;
+  slug: string;
+  name: string;
+}
 interface ScriptVersion {
   id?: string;
   tag?: string;
@@ -3081,6 +3095,7 @@ interface TraceItem {
     | (
         | TraceItemFetchEventInfo
         | TraceItemJsRpcEventInfo
+        | TraceItemConnectEventInfo
         | TraceItemScheduledEventInfo
         | TraceItemAlarmEventInfo
         | TraceItemQueueEventInfo
@@ -3099,6 +3114,8 @@ interface TraceItem {
   readonly scriptVersion?: ScriptVersion;
   readonly dispatchNamespace?: string;
   readonly scriptTags?: string[];
+  readonly tailAttributes?: Record<string, boolean | number | string>;
+  readonly preview?: TracePreviewInfo;
   readonly durableObjectId?: string;
   readonly outcome: string;
   readonly executionModel: string;
@@ -3109,6 +3126,7 @@ interface TraceItem {
 interface TraceItemAlarmEventInfo {
   readonly scheduledTime: Date;
 }
+interface TraceItemConnectEventInfo {}
 interface TraceItemCustomEventInfo {}
 interface TraceItemScheduledEventInfo {
   readonly scheduledTime: number;
@@ -3649,7 +3667,7 @@ interface ContainerStartupOptions {
   entrypoint?: string[];
   enableInternet: boolean;
   env?: Record<string, string>;
-  hardTimeout?: number | bigint;
+  labels?: Record<string, string>;
 }
 /**
  * The **`MessagePort`** interface of the Channel Messaging API represents one of the two ports of a MessageChannel, allowing messages to be sent from one port and listening out for them arriving at the other.
@@ -3776,11 +3794,10 @@ declare abstract class Performance {
    */
   toJSON(): object;
 }
-// AI Search V2 API Error Interfaces
+// ============ AI Search Error Interfaces ============
 interface AiSearchInternalError extends Error {}
 interface AiSearchNotFoundError extends Error {}
-interface AiSearchNameNotSetError extends Error {}
-// AI Search V2 Request Types
+// ============ AI Search Request Types ============
 type AiSearchSearchRequest = {
   messages: Array<{
     role: "system" | "developer" | "user" | "assistant" | "tool";
@@ -3805,9 +3822,8 @@ type AiSearchSearchRequest = {
       [key: string]: unknown;
     };
     reranking?: {
-      /** Enable reranking (default false) */
       enabled?: boolean;
-      model?: "@cf/baai/bge-reranker-base" | "";
+      model?: "@cf/baai/bge-reranker-base" | string;
       /** Match threshold (0-1, default 0.4) */
       match_threshold?: number;
       [key: string]: unknown;
@@ -3819,6 +3835,7 @@ type AiSearchChatCompletionsRequest = {
   messages: Array<{
     role: "system" | "developer" | "user" | "assistant" | "tool";
     content: string | null;
+    [key: string]: unknown;
   }>;
   model?: string;
   stream?: boolean;
@@ -3839,7 +3856,7 @@ type AiSearchChatCompletionsRequest = {
     };
     reranking?: {
       enabled?: boolean;
-      model?: "@cf/baai/bge-reranker-base" | "";
+      model?: "@cf/baai/bge-reranker-base" | string;
       match_threshold?: number;
       [key: string]: unknown;
     };
@@ -3847,7 +3864,7 @@ type AiSearchChatCompletionsRequest = {
   };
   [key: string]: unknown;
 };
-// AI Search V2 Response Types
+// ============ AI Search Response Types ============
 type AiSearchSearchResponse = {
   search_query: string;
   chunks: Array<{
@@ -3866,26 +3883,65 @@ type AiSearchSearchResponse = {
       keyword_score?: number;
       /** Vector similarity score (0-1) */
       vector_score?: number;
+      [key: string]: unknown;
+    };
+  }>;
+};
+type AiSearchChatCompletionsResponse = {
+  id?: string;
+  object?: string;
+  model?: string;
+  choices: Array<{
+    index?: number;
+    message: {
+      role: "system" | "developer" | "user" | "assistant" | "tool";
+      content: string | null;
+      [key: string]: unknown;
     };
+    [key: string]: unknown;
   }>;
+  chunks: AiSearchSearchResponse["chunks"];
+  [key: string]: unknown;
 };
-type AiSearchListResponse = Array<{
+type AiSearchStatsResponse = {
+  queued?: number;
+  running?: number;
+  completed?: number;
+  error?: number;
+  skipped?: number;
+  outdated?: number;
+  last_activity?: string;
+};
+// ============ AI Search Instance Info Types ============
+type AiSearchInstanceInfo = {
   id: string;
-  internal_id?: string;
-  account_id?: string;
-  account_tag?: string;
-  /** Whether the instance is enabled (default true) */
-  enable?: boolean;
-  type?: "r2" | "web-crawler";
+  type?: "r2" | "web-crawler" | string;
   source?: string;
+  paused?: boolean;
+  status?: string;
+  namespace?: string;
+  created_at?: string;
+  modified_at?: string;
   [key: string]: unknown;
-}>;
+};
+type AiSearchListResponse = {
+  result: AiSearchInstanceInfo[];
+  result_info?: {
+    count: number;
+    page: number;
+    per_page: number;
+    total_count: number;
+  };
+};
+// ============ AI Search Config Types ============
 type AiSearchConfig = {
   /** Instance ID (1-32 chars, pattern: ^[a-z0-9_]+(?:-[a-z0-9_]+)*$) */
   id: string;
-  type: "r2" | "web-crawler";
-  source: string;
-  source_params?: object;
+  /** Instance type. Omit to create with built-in storage. */
+  type?: "r2" | "web-crawler" | string;
+  /** Source URL (required for web-crawler type). */
+  source?: string;
+  source_params?: unknown;
   /** Token ID (UUID format) */
   token_id?: string;
   ai_gateway_id?: string;
@@ -3895,54 +3951,307 @@ type AiSearchConfig = {
   reranking?: boolean;
   embedding_model?: string;
   ai_search_model?: string;
+  [key: string]: unknown;
 };
-type AiSearchInstance = {
+// ============ AI Search Item Types ============
+type AiSearchItemInfo = {
   id: string;
-  enable?: boolean;
-  type?: "r2" | "web-crawler";
-  source?: string;
+  key: string;
+  status:
+    | "completed"
+    | "error"
+    | "skipped"
+    | "queued"
+    | "processing"
+    | "outdated";
+  metadata?: Record<string, unknown>;
   [key: string]: unknown;
 };
-// AI Search Instance Service - Instance-level operations
-declare abstract class AiSearchInstanceService {
+type AiSearchItemContentResult = {
+  body: ReadableStream;
+  contentType: string;
+  filename: string;
+  size: number;
+};
+type AiSearchUploadItemOptions = {
+  metadata?: Record<string, unknown>;
+};
+type AiSearchListItemsParams = {
+  page?: number;
+  per_page?: number;
+};
+type AiSearchListItemsResponse = {
+  result: AiSearchItemInfo[];
+  result_info?: {
+    count: number;
+    page: number;
+    per_page: number;
+    total_count: number;
+  };
+};
+// ============ AI Search Job Types ============
+type AiSearchJobInfo = {
+  id: string;
+  source: "user" | "schedule";
+  description?: string;
+  last_seen_at?: string;
+  started_at?: string;
+  ended_at?: string;
+  end_reason?: string;
+};
+type AiSearchJobLog = {
+  id: number;
+  message: string;
+  message_type: number;
+  created_at: number;
+};
+type AiSearchCreateJobParams = {
+  description?: string;
+};
+type AiSearchListJobsParams = {
+  page?: number;
+  per_page?: number;
+};
+type AiSearchListJobsResponse = {
+  result: AiSearchJobInfo[];
+  result_info?: {
+    count: number;
+    page: number;
+    per_page: number;
+    total_count: number;
+  };
+};
+type AiSearchJobLogsParams = {
+  page?: number;
+  per_page?: number;
+};
+type AiSearchJobLogsResponse = {
+  result: AiSearchJobLog[];
+  result_info?: {
+    count: number;
+    page: number;
+    per_page: number;
+    total_count: number;
+  };
+};
+// ============ AI Search Sub-Service Classes ============
+/**
+ * Single item service for an AI Search instance.
+ * Provides info, delete, and download operations on a specific item.
+ */
+declare abstract class AiSearchItem {
+  /** Get metadata about this item. */
+  info(): Promise<AiSearchItemInfo>;
+  /**
+   * Download the item's content.
+   * @returns Object with body stream, content type, filename, and size.
+   */
+  download(): Promise<AiSearchItemContentResult>;
+}
+/**
+ * Items collection service for an AI Search instance.
+ * Provides list, upload, and access to individual items.
+ */
+declare abstract class AiSearchItems {
+  /** List items in this instance. */
+  list(params?: AiSearchListItemsParams): Promise<AiSearchListItemsResponse>;
+  /**
+   * Upload a file as an item.
+   * @param name Filename for the uploaded item.
+   * @param content File content as a ReadableStream, ArrayBuffer, or string.
+   * @param options Optional metadata to attach to the item.
+   * @returns The created item info.
+   */
+  upload(
+    name: string,
+    content: ReadableStream | ArrayBuffer | string,
+    options?: AiSearchUploadItemOptions,
+  ): Promise<AiSearchItemInfo>;
+  /**
+   * Upload a file and poll until processing completes.
+   * @param name Filename for the uploaded item.
+   * @param content File content as a ReadableStream, ArrayBuffer, or string.
+   * @param options Optional metadata to attach to the item.
+   * @returns The item info after processing completes (or timeout).
+   */
+  uploadAndPoll(
+    name: string,
+    content: ReadableStream | ArrayBuffer | string,
+    options?: AiSearchUploadItemOptions,
+  ): Promise<AiSearchItemInfo>;
+  /**
+   * Get an item by ID.
+   * @param itemId The item identifier.
+   * @returns Item service for info, delete, and download operations.
+   */
+  get(itemId: string): AiSearchItem;
+  /** Delete this item from the instance.
+   * @param itemId The item identifier.
+   */
+  delete(itemId: string): Promise<void>;
+}
+/**
+ * Single job service for an AI Search instance.
+ * Provides info and logs for a specific job.
+ */
+declare abstract class AiSearchJob {
+  /** Get metadata about this job. */
+  info(): Promise<AiSearchJobInfo>;
+  /** Get logs for this job. */
+  logs(params?: AiSearchJobLogsParams): Promise<AiSearchJobLogsResponse>;
+}
+/**
+ * Jobs collection service for an AI Search instance.
+ * Provides list, create, and access to individual jobs.
+ */
+declare abstract class AiSearchJobs {
+  /** List jobs for this instance. */
+  list(params?: AiSearchListJobsParams): Promise<AiSearchListJobsResponse>;
+  /**
+   * Create a new indexing job.
+   * @param params Optional job parameters.
+   * @returns The created job info.
+   */
+  create(params?: AiSearchCreateJobParams): Promise<AiSearchJobInfo>;
+  /**
+   * Get a job by ID.
+   * @param jobId The job identifier.
+   * @returns Job service for info and logs operations.
+   */
+  get(jobId: string): AiSearchJob;
+}
+// ============ AI Search Binding Classes ============
+/**
+ * Instance-level AI Search service.
+ *
+ * Used as:
+ * - The return type of `AiSearchNamespace.get(name)` (namespace binding)
+ * - The type of `env.BLOG_SEARCH` (single instance binding via `ai_search`)
+ *
+ * Provides search, chat, update, stats, items, and jobs operations.
+ *
+ * @example
+ * ```ts
+ * // Via namespace binding
+ * const instance = env.AI_SEARCH.get("blog");
+ * const results = await instance.search({
+ *   messages: [{ role: "user", content: "How does caching work?" }],
+ * });
+ *
+ * // Via single instance binding
+ * const results = await env.BLOG_SEARCH.search({
+ *   messages: [{ role: "user", content: "How does caching work?" }],
+ * });
+ * ```
+ */
+declare abstract class AiSearchInstance {
   /**
    * Search the AI Search instance for relevant chunks.
-   * @param params Search request with messages and AI search options
-   * @returns Search response with matching chunks
+   * @param params Search request with messages and optional AI search options.
+   * @returns Search response with matching chunks and search query.
    */
   search(params: AiSearchSearchRequest): Promise<AiSearchSearchResponse>;
+  /**
+   * Generate chat completions with AI Search context (streaming).
+   * @param params Chat completions request with stream: true.
+   * @returns ReadableStream of server-sent events.
+   */
+  chatCompletions(
+    params: AiSearchChatCompletionsRequest & {
+      stream: true;
+    },
+  ): Promise<ReadableStream>;
   /**
    * Generate chat completions with AI Search context.
-   * @param params Chat completions request with optional streaming
-   * @returns Response object (if streaming) or chat completion result
+   * @param params Chat completions request.
+   * @returns Chat completion response with choices and RAG chunks.
    */
   chatCompletions(
     params: AiSearchChatCompletionsRequest,
-  ): Promise<Response | object>;
+  ): Promise<AiSearchChatCompletionsResponse>;
   /**
-   * Delete this AI Search instance.
+   * Update the instance configuration.
+   * @param config Partial configuration to update.
+   * @returns Updated instance info.
    */
-  delete(): Promise<void>;
+  update(config: Partial<AiSearchConfig>): Promise<AiSearchInstanceInfo>;
+  /** Get metadata about this instance. */
+  info(): Promise<AiSearchInstanceInfo>;
+  /**
+   * Get instance statistics (item count, indexing status, etc.).
+   * @returns Statistics with counts per status and last activity time.
+   */
+  stats(): Promise<AiSearchStatsResponse>;
+  /** Items collection — list, upload, and manage items in this instance. */
+  get items(): AiSearchItems;
+  /** Jobs collection — list, create, and inspect indexing jobs. */
+  get jobs(): AiSearchJobs;
 }
-// AI Search Account Service - Account-level operations
-declare abstract class AiSearchAccountService {
+/**
+ * Namespace-level AI Search service.
+ *
+ * Used as the type of `env.AI_SEARCH` (namespace binding via `ai_search_namespaces`).
+ * Scoped to a single namespace. Provides dynamic instance access, creation, and deletion.
+ *
+ * @example
+ * ```ts
+ * // Access an instance within the namespace
+ * const blog = env.AI_SEARCH.get("blog");
+ * const results = await blog.search({
+ *   messages: [{ role: "user", content: "How does caching work?" }],
+ * });
+ *
+ * // List all instances in the namespace
+ * const instances = await env.AI_SEARCH.list();
+ *
+ * // Create a new instance with built-in storage
+ * const tenant = await env.AI_SEARCH.create({
+ *   id: "tenant-123",
+ * });
+ *
+ * // Upload items into the instance
+ * await tenant.items.upload("doc.pdf", fileContent);
+ *
+ * // Delete an instance
+ * await env.AI_SEARCH.delete("tenant-123");
+ * ```
+ */
+declare abstract class AiSearchNamespace {
   /**
-   * List all AI Search instances in the account.
-   * @returns Array of AI Search instances
+   * Get an instance by name within the bound namespace.
+   * @param name Instance name.
+   * @returns Instance service for search, chat, update, stats, items, and jobs.
+   */
+  get(name: string): AiSearchInstance;
+  /**
+   * List all instances in the bound namespace.
+   * @returns Array of instance metadata.
    */
   list(): Promise<AiSearchListResponse>;
   /**
-   * Get an AI Search instance by ID.
-   * @param name Instance ID
-   * @returns Instance service for performing operations
+   * Create a new instance within the bound namespace.
+   * @param config Instance configuration. Only `id` is required — omit `type` and `source` to create with built-in storage.
+   * @returns Instance service for the newly created instance.
+   *
+   * @example
+   * ```ts
+   * // Create with built-in storage (upload items manually)
+   * const instance = await env.AI_SEARCH.create({ id: "my-search" });
+   *
+   * // Create with web crawler source
+   * const instance = await env.AI_SEARCH.create({
+   *   id: "docs-search",
+   *   type: "web-crawler",
+   *   source: "https://developers.cloudflare.com",
+   * });
+   * ```
    */
-  get(name: string): AiSearchInstanceService;
+  create(config: AiSearchConfig): Promise<AiSearchInstance>;
   /**
-   * Create a new AI Search instance.
-   * @param config Instance configuration
-   * @returns Instance service for performing operations
+   * Delete an instance from the bound namespace.
+   * @param name Instance name to delete.
    */
-  create(config: AiSearchConfig): Promise<AiSearchInstanceService>;
+  delete(name: string): Promise<void>;
 }
 type AiImageClassificationInput = {
   image: number[];
@@ -4218,6 +4527,400 @@ declare abstract class BaseAiTranslation {
   inputs: AiTranslationInput;
   postProcessedOutputs: AiTranslationOutput;
 }
+/**
+ * Workers AI support for OpenAI's Chat Completions API
+ */
+type ChatCompletionContentPartText = {
+  type: "text";
+  text: string;
+};
+type ChatCompletionContentPartImage = {
+  type: "image_url";
+  image_url: {
+    url: string;
+    detail?: "auto" | "low" | "high";
+  };
+};
+type ChatCompletionContentPartInputAudio = {
+  type: "input_audio";
+  input_audio: {
+    /** Base64 encoded audio data. */
+    data: string;
+    format: "wav" | "mp3";
+  };
+};
+type ChatCompletionContentPartFile = {
+  type: "file";
+  file: {
+    /** Base64 encoded file data. */
+    file_data?: string;
+    /** The ID of an uploaded file. */
+    file_id?: string;
+    filename?: string;
+  };
+};
+type ChatCompletionContentPartRefusal = {
+  type: "refusal";
+  refusal: string;
+};
+type ChatCompletionContentPart =
+  | ChatCompletionContentPartText
+  | ChatCompletionContentPartImage
+  | ChatCompletionContentPartInputAudio
+  | ChatCompletionContentPartFile;
+type FunctionDefinition = {
+  name: string;
+  description?: string;
+  parameters?: Record<string, unknown>;
+  strict?: boolean | null;
+};
+type ChatCompletionFunctionTool = {
+  type: "function";
+  function: FunctionDefinition;
+};
+type ChatCompletionCustomToolGrammarFormat = {
+  type: "grammar";
+  grammar: {
+    definition: string;
+    syntax: "lark" | "regex";
+  };
+};
+type ChatCompletionCustomToolTextFormat = {
+  type: "text";
+};
+type ChatCompletionCustomToolFormat =
+  | ChatCompletionCustomToolTextFormat
+  | ChatCompletionCustomToolGrammarFormat;
+type ChatCompletionCustomTool = {
+  type: "custom";
+  custom: {
+    name: string;
+    description?: string;
+    format?: ChatCompletionCustomToolFormat;
+  };
+};
+type ChatCompletionTool = ChatCompletionFunctionTool | ChatCompletionCustomTool;
+type ChatCompletionMessageFunctionToolCall = {
+  id: string;
+  type: "function";
+  function: {
+    name: string;
+    /** JSON-encoded arguments string. */
+    arguments: string;
+  };
+};
+type ChatCompletionMessageCustomToolCall = {
+  id: string;
+  type: "custom";
+  custom: {
+    name: string;
+    input: string;
+  };
+};
+type ChatCompletionMessageToolCall =
+  | ChatCompletionMessageFunctionToolCall
+  | ChatCompletionMessageCustomToolCall;
+type ChatCompletionToolChoiceFunction = {
+  type: "function";
+  function: {
+    name: string;
+  };
+};
+type ChatCompletionToolChoiceCustom = {
+  type: "custom";
+  custom: {
+    name: string;
+  };
+};
+type ChatCompletionToolChoiceAllowedTools = {
+  type: "allowed_tools";
+  allowed_tools: {
+    mode: "auto" | "required";
+    tools: Array<Record<string, unknown>>;
+  };
+};
+type ChatCompletionToolChoiceOption =
+  | "none"
+  | "auto"
+  | "required"
+  | ChatCompletionToolChoiceFunction
+  | ChatCompletionToolChoiceCustom
+  | ChatCompletionToolChoiceAllowedTools;
+type DeveloperMessage = {
+  role: "developer";
+  content:
+    | string
+    | Array<{
+        type: "text";
+        text: string;
+      }>;
+  name?: string;
+};
+type SystemMessage = {
+  role: "system";
+  content:
+    | string
+    | Array<{
+        type: "text";
+        text: string;
+      }>;
+  name?: string;
+};
+/**
+ * Permissive merged content part used inside UserMessage arrays.
+ *
+ * Cabidela has a limitation where anyOf/oneOf with enum-based discrimination
+ * inside nested array items does not correctly match different branches for
+ * different array elements, so the schema uses a single merged object.
+ */
+type UserMessageContentPart = {
+  type: "text" | "image_url" | "input_audio" | "file";
+  text?: string;
+  image_url?: {
+    url?: string;
+    detail?: "auto" | "low" | "high";
+  };
+  input_audio?: {
+    data?: string;
+    format?: "wav" | "mp3";
+  };
+  file?: {
+    file_data?: string;
+    file_id?: string;
+    filename?: string;
+  };
+};
+type UserMessage = {
+  role: "user";
+  content: string | Array<UserMessageContentPart>;
+  name?: string;
+};
+type AssistantMessageContentPart = {
+  type: "text" | "refusal";
+  text?: string;
+  refusal?: string;
+};
+type AssistantMessage = {
+  role: "assistant";
+  content?: string | null | Array<AssistantMessageContentPart>;
+  refusal?: string | null;
+  name?: string;
+  audio?: {
+    id: string;
+  };
+  tool_calls?: Array<ChatCompletionMessageToolCall>;
+  function_call?: {
+    name: string;
+    arguments: string;
+  };
+};
+type ToolMessage = {
+  role: "tool";
+  content:
+    | string
+    | Array<{
+        type: "text";
+        text: string;
+      }>;
+  tool_call_id: string;
+};
+type FunctionMessage = {
+  role: "function";
+  content: string;
+  name: string;
+};
+type ChatCompletionMessageParam =
+  | DeveloperMessage
+  | SystemMessage
+  | UserMessage
+  | AssistantMessage
+  | ToolMessage
+  | FunctionMessage;
+type ChatCompletionsResponseFormatText = {
+  type: "text";
+};
+type ChatCompletionsResponseFormatJSONObject = {
+  type: "json_object";
+};
+type ResponseFormatJSONSchema = {
+  type: "json_schema";
+  json_schema: {
+    name: string;
+    description?: string;
+    schema?: Record<string, unknown>;
+    strict?: boolean | null;
+  };
+};
+type ResponseFormat =
+  | ChatCompletionsResponseFormatText
+  | ChatCompletionsResponseFormatJSONObject
+  | ResponseFormatJSONSchema;
+type ChatCompletionsStreamOptions = {
+  include_usage?: boolean;
+  include_obfuscation?: boolean;
+};
+type PredictionContent = {
+  type: "content";
+  content:
+    | string
+    | Array<{
+        type: "text";
+        text: string;
+      }>;
+};
+type AudioParams = {
+  voice:
+    | string
+    | {
+        id: string;
+      };
+  format: "wav" | "aac" | "mp3" | "flac" | "opus" | "pcm16";
+};
+type WebSearchUserLocation = {
+  type: "approximate";
+  approximate: {
+    city?: string;
+    country?: string;
+    region?: string;
+    timezone?: string;
+  };
+};
+type WebSearchOptions = {
+  search_context_size?: "low" | "medium" | "high";
+  user_location?: WebSearchUserLocation;
+};
+type ChatTemplateKwargs = {
+  /** Whether to enable reasoning, enabled by default. */
+  enable_thinking?: boolean;
+  /** If false, preserves reasoning context between turns. */
+  clear_thinking?: boolean;
+};
+/** Shared optional properties used by both Prompt and Messages input branches. */
+type ChatCompletionsCommonOptions = {
+  model?: string;
+  audio?: AudioParams;
+  frequency_penalty?: number | null;
+  logit_bias?: Record<string, unknown> | null;
+  logprobs?: boolean | null;
+  top_logprobs?: number | null;
+  max_tokens?: number | null;
+  max_completion_tokens?: number | null;
+  metadata?: Record<string, unknown> | null;
+  modalities?: Array<"text" | "audio"> | null;
+  n?: number | null;
+  parallel_tool_calls?: boolean;
+  prediction?: PredictionContent;
+  presence_penalty?: number | null;
+  reasoning_effort?: "low" | "medium" | "high" | null;
+  chat_template_kwargs?: ChatTemplateKwargs;
+  response_format?: ResponseFormat;
+  seed?: number | null;
+  service_tier?: "auto" | "default" | "flex" | "scale" | "priority" | null;
+  stop?: string | Array<string> | null;
+  store?: boolean | null;
+  stream?: boolean | null;
+  stream_options?: ChatCompletionsStreamOptions;
+  temperature?: number | null;
+  tool_choice?: ChatCompletionToolChoiceOption;
+  tools?: Array<ChatCompletionTool>;
+  top_p?: number | null;
+  user?: string;
+  web_search_options?: WebSearchOptions;
+  function_call?:
+    | "none"
+    | "auto"
+    | {
+        name: string;
+      };
+  functions?: Array<FunctionDefinition>;
+};
+type PromptTokensDetails = {
+  cached_tokens?: number;
+  audio_tokens?: number;
+};
+type CompletionTokensDetails = {
+  reasoning_tokens?: number;
+  audio_tokens?: number;
+  accepted_prediction_tokens?: number;
+  rejected_prediction_tokens?: number;
+};
+type CompletionUsage = {
+  prompt_tokens: number;
+  completion_tokens: number;
+  total_tokens: number;
+  prompt_tokens_details?: PromptTokensDetails;
+  completion_tokens_details?: CompletionTokensDetails;
+};
+type ChatCompletionTopLogprob = {
+  token: string;
+  logprob: number;
+  bytes: Array<number> | null;
+};
+type ChatCompletionTokenLogprob = {
+  token: string;
+  logprob: number;
+  bytes: Array<number> | null;
+  top_logprobs: Array<ChatCompletionTopLogprob>;
+};
+type ChatCompletionAudio = {
+  id: string;
+  /** Base64 encoded audio bytes. */
+  data: string;
+  expires_at: number;
+  transcript: string;
+};
+type ChatCompletionUrlCitation = {
+  type: "url_citation";
+  url_citation: {
+    url: string;
+    title: string;
+    start_index: number;
+    end_index: number;
+  };
+};
+type ChatCompletionResponseMessage = {
+  role: "assistant";
+  content: string | null;
+  refusal: string | null;
+  annotations?: Array<ChatCompletionUrlCitation>;
+  audio?: ChatCompletionAudio;
+  tool_calls?: Array<ChatCompletionMessageToolCall>;
+  function_call?: {
+    name: string;
+    arguments: string;
+  } | null;
+};
+type ChatCompletionLogprobs = {
+  content: Array<ChatCompletionTokenLogprob> | null;
+  refusal?: Array<ChatCompletionTokenLogprob> | null;
+};
+type ChatCompletionChoice = {
+  index: number;
+  message: ChatCompletionResponseMessage;
+  finish_reason:
+    | "stop"
+    | "length"
+    | "tool_calls"
+    | "content_filter"
+    | "function_call";
+  logprobs: ChatCompletionLogprobs | null;
+};
+type ChatCompletionsPromptInput = {
+  prompt: string;
+} & ChatCompletionsCommonOptions;
+type ChatCompletionsMessagesInput = {
+  messages: Array<ChatCompletionMessageParam>;
+} & ChatCompletionsCommonOptions;
+type ChatCompletionsOutput = {
+  id: string;
+  object: string;
+  created: number;
+  model: string;
+  choices: Array<ChatCompletionChoice>;
+  usage?: CompletionUsage;
+  system_fingerprint?: string | null;
+  service_tier?: "auto" | "default" | "flex" | "scale" | "priority" | null;
+};
 /**
  * Workers AI support for OpenAI's Responses API
  * Reference: https://github.com/openai/openai-node/blob/master/src/resources/responses/responses.ts
@@ -4639,6 +5342,12 @@ type ReasoningEffort = "minimal" | "low" | "medium" | "high" | null;
 type StreamOptions = {
   include_obfuscation?: boolean;
 };
+/** Marks keys from T that aren't in U as optional never */
+type Without<T, U> = {
+  [P in Exclude<keyof T, keyof U>]?: never;
+};
+/** Either T or U, but not both (mutually exclusive) */
+type XOR<T, U> = (T & Without<U, T>) | (U & Without<T, U>);
 type Ai_Cf_Baai_Bge_Base_En_V1_5_Input =
   | {
       text: string | string[];
@@ -4931,10 +5640,12 @@ declare abstract class Base_Ai_Cf_Openai_Whisper_Tiny_En {
   postProcessedOutputs: Ai_Cf_Openai_Whisper_Tiny_En_Output;
 }
 interface Ai_Cf_Openai_Whisper_Large_V3_Turbo_Input {
-  /**
-   * Base64 encoded value of the audio data.
-   */
-  audio: string;
+  audio:
+    | string
+    | {
+        body?: object;
+        contentType?: string;
+      };
   /**
    * Supported tasks are 'translate' or 'transcribe'.
    */
@@ -4952,9 +5663,33 @@ interface Ai_Cf_Openai_Whisper_Large_V3_Turbo_Input {
    */
   initial_prompt?: string;
   /**
-   * The prefix it appended the the beginning of the output of the transcription and can guide the transcription result.
+   * The prefix appended to the beginning of the output of the transcription and can guide the transcription result.
    */
   prefix?: string;
+  /**
+   * The number of beams to use in beam search decoding. Higher values may improve accuracy at the cost of speed.
+   */
+  beam_size?: number;
+  /**
+   * Whether to condition on previous text during transcription. Setting to false may help prevent hallucination loops.
+   */
+  condition_on_previous_text?: boolean;
+  /**
+   * Threshold for detecting no-speech segments. Segments with no-speech probability above this value are skipped.
+   */
+  no_speech_threshold?: number;
+  /**
+   * Threshold for filtering out segments with high compression ratio, which often indicate repetitive or hallucinated text.
+   */
+  compression_ratio_threshold?: number;
+  /**
+   * Threshold for filtering out segments with low average log probability, indicating low confidence.
+   */
+  log_prob_threshold?: number;
+  /**
+   * Optional threshold (in seconds) to skip silent periods that may cause hallucinations.
+   */
+  hallucination_silence_threshold?: number;
 }
 interface Ai_Cf_Openai_Whisper_Large_V3_Turbo_Output {
   transcription_info?: {
@@ -5101,11 +5836,11 @@ interface Ai_Cf_Baai_Bge_M3_Input_Embedding_1 {
   truncate_inputs?: boolean;
 }
 type Ai_Cf_Baai_Bge_M3_Output =
-  | Ai_Cf_Baai_Bge_M3_Ouput_Query
+  | Ai_Cf_Baai_Bge_M3_Output_Query
   | Ai_Cf_Baai_Bge_M3_Output_EmbeddingFor_Contexts
-  | Ai_Cf_Baai_Bge_M3_Ouput_Embedding
+  | Ai_Cf_Baai_Bge_M3_Output_Embedding
   | Ai_Cf_Baai_Bge_M3_AsyncResponse;
-interface Ai_Cf_Baai_Bge_M3_Ouput_Query {
+interface Ai_Cf_Baai_Bge_M3_Output_Query {
   response?: {
     /**
      * Index of the context in the request
@@ -5125,7 +5860,7 @@ interface Ai_Cf_Baai_Bge_M3_Output_EmbeddingFor_Contexts {
    */
   pooling?: "mean" | "cls";
 }
-interface Ai_Cf_Baai_Bge_M3_Ouput_Embedding {
+interface Ai_Cf_Baai_Bge_M3_Output_Embedding {
   shape?: number[];
   /**
    * Embeddings of the requested text values
@@ -5230,7 +5965,7 @@ interface Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Messages {
      */
     role?: string;
     /**
-     * The tool call id. Must be supplied for tool calls for Mistral-3. If you don't know what to put here you can fall back to 000000001
+     * The tool call id. If you don't know what to put here you can fall back to 000000001
      */
     tool_call_id?: string;
     content?:
@@ -5485,10 +6220,18 @@ interface Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Messages {
      * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
      */
     role: string;
-    /**
-     * The content of the message as a string.
-     */
-    content: string;
+    content:
+      | string
+      | {
+          /**
+           * Type of the content (text)
+           */
+          type?: string;
+          /**
+           * Text content
+           */
+          text?: string;
+        }[];
   }[];
   functions?: {
     name: string;
@@ -6144,7 +6887,7 @@ interface Ai_Cf_Qwen_Qwq_32B_Messages {
      */
     role?: string;
     /**
-     * The tool call id. Must be supplied for tool calls for Mistral-3. If you don't know what to put here you can fall back to 000000001
+     * The tool call id. If you don't know what to put here you can fall back to 000000001
      */
     tool_call_id?: string;
     content?:
@@ -6271,7 +7014,7 @@ interface Ai_Cf_Qwen_Qwq_32B_Messages {
       }
   )[];
   /**
-   * JSON schema that should be fulfilled for the response.
+   * JSON schema that should be fufilled for the response.
    */
   guided_json?: object;
   /**
@@ -6545,7 +7288,7 @@ interface Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Messages {
       }
   )[];
   /**
-   * JSON schema that should be fulfilled for the response.
+   * JSON schema that should be fufilled for the response.
    */
   guided_json?: object;
   /**
@@ -6638,7 +7381,7 @@ interface Ai_Cf_Google_Gemma_3_12B_It_Prompt {
    */
   prompt: string;
   /**
-   * JSON schema that should be fulfilled for the response.
+   * JSON schema that should be fufilled for the response.
    */
   guided_json?: object;
   /**
@@ -6802,7 +7545,7 @@ interface Ai_Cf_Google_Gemma_3_12B_It_Messages {
       }
   )[];
   /**
-   * JSON schema that should be fulfilled for the response.
+   * JSON schema that should be fufilled for the response.
    */
   guided_json?: object;
   /**
@@ -7083,7 +7826,7 @@ interface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Messages {
   )[];
   response_format?: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_JSON_Mode;
   /**
-   * JSON schema that should be fulfilled for the response.
+   * JSON schema that should be fufilled for the response.
    */
   guided_json?: object;
   /**
@@ -7322,7 +8065,7 @@ interface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Messages_Inner {
   )[];
   response_format?: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_JSON_Mode;
   /**
-   * JSON schema that should be fulfilled for the response.
+   * JSON schema that should be fufilled for the response.
    */
   guided_json?: object;
   /**
@@ -7487,10 +8230,18 @@ interface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Messages {
      * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
      */
     role: string;
-    /**
-     * The content of the message as a string.
-     */
-    content: string;
+    content:
+      | string
+      | {
+          /**
+           * Type of the content (text)
+           */
+          type?: string;
+          /**
+           * Text content
+           */
+          text?: string;
+        }[];
   }[];
   functions?: {
     name: string;
@@ -7702,10 +8453,18 @@ interface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Messages_1 {
      * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
      */
     role: string;
-    /**
-     * The content of the message as a string.
-     */
-    content: string;
+    content:
+      | string
+      | {
+          /**
+           * Type of the content (text)
+           */
+          type?: string;
+          /**
+           * Text content
+           */
+          text?: string;
+        }[];
   }[];
   functions?: {
     name: string;
@@ -8273,12 +9032,12 @@ declare abstract class Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2 {
   postProcessedOutputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output;
 }
 declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_120B {
-  inputs: ResponsesInput;
-  postProcessedOutputs: ResponsesOutput;
+  inputs: XOR<ResponsesInput, ChatCompletionsInput>;
+  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
 }
 declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_20B {
-  inputs: ResponsesInput;
-  postProcessedOutputs: ResponsesOutput;
+  inputs: XOR<ResponsesInput, ChatCompletionsInput>;
+  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
 }
 interface Ai_Cf_Leonardo_Phoenix_1_0_Input {
   /**
@@ -8410,7 +9169,7 @@ interface Ai_Cf_Ai4Bharat_Indictrans2_En_Indic_1B_Input {
    */
   text: string | string[];
   /**
-   * Target language to translate to
+   * Target langauge to translate to
    */
   target_language:
     | "asm_Beng"
@@ -8526,10 +9285,18 @@ interface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Messages {
      * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
      */
     role: string;
-    /**
-     * The content of the message as a string.
-     */
-    content: string;
+    content:
+      | string
+      | {
+          /**
+           * Type of the content (text)
+           */
+          type?: string;
+          /**
+           * Text content
+           */
+          text?: string;
+        }[];
   }[];
   functions?: {
     name: string;
@@ -8741,10 +9508,18 @@ interface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Messages_1 {
      * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
      */
     role: string;
-    /**
-     * The content of the message as a string.
-     */
-    content: string;
+    content:
+      | string
+      | {
+          /**
+           * Type of the content (text)
+           */
+          type?: string;
+          /**
+           * Text content
+           */
+          text?: string;
+        }[];
   }[];
   functions?: {
     name: string;
@@ -9299,6 +10074,66 @@ declare abstract class Base_Ai_Cf_Deepgram_Aura_2_Es {
   inputs: Ai_Cf_Deepgram_Aura_2_Es_Input;
   postProcessedOutputs: Ai_Cf_Deepgram_Aura_2_Es_Output;
 }
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Dev_Input {
+  multipart: {
+    body?: object;
+    contentType?: string;
+  };
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Dev_Output {
+  /**
+   * Generated image as Base64 string.
+   */
+  image?: string;
+}
+declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Dev {
+  inputs: Ai_Cf_Black_Forest_Labs_Flux_2_Dev_Input;
+  postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Dev_Output;
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B_Input {
+  multipart: {
+    body?: object;
+    contentType?: string;
+  };
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B_Output {
+  /**
+   * Generated image as Base64 string.
+   */
+  image?: string;
+}
+declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B {
+  inputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B_Input;
+  postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B_Output;
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Input {
+  multipart: {
+    body?: object;
+    contentType?: string;
+  };
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output {
+  /**
+   * Generated image as Base64 string.
+   */
+  image?: string;
+}
+declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B {
+  inputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Input;
+  postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output;
+}
+declare abstract class Base_Ai_Cf_Zai_Org_Glm_4_7_Flash {
+  inputs: ChatCompletionsInput;
+  postProcessedOutputs: ChatCompletionsOutput;
+}
+declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
+  inputs: ChatCompletionsInput;
+  postProcessedOutputs: ChatCompletionsOutput;
+}
+declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
+  inputs: ChatCompletionsInput;
+  postProcessedOutputs: ChatCompletionsOutput;
+}
 interface AiModels {
   "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
   "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
@@ -9317,7 +10152,6 @@ interface AiModels {
   "@hf/thebloke/zephyr-7b-beta-awq": BaseAiTextGeneration;
   "@hf/thebloke/openhermes-2.5-mistral-7b-awq": BaseAiTextGeneration;
   "@hf/thebloke/neural-chat-7b-v3-1-awq": BaseAiTextGeneration;
-  "@hf/thebloke/llamaguard-7b-awq": BaseAiTextGeneration;
   "@hf/thebloke/deepseek-coder-6.7b-base-awq": BaseAiTextGeneration;
   "@hf/thebloke/deepseek-coder-6.7b-instruct-awq": BaseAiTextGeneration;
   "@cf/deepseek-ai/deepseek-math-7b-instruct": BaseAiTextGeneration;
@@ -9384,6 +10218,12 @@ interface AiModels {
   "@cf/deepgram/flux": Base_Ai_Cf_Deepgram_Flux;
   "@cf/deepgram/aura-2-en": Base_Ai_Cf_Deepgram_Aura_2_En;
   "@cf/deepgram/aura-2-es": Base_Ai_Cf_Deepgram_Aura_2_Es;
+  "@cf/black-forest-labs/flux-2-dev": Base_Ai_Cf_Black_Forest_Labs_Flux_2_Dev;
+  "@cf/black-forest-labs/flux-2-klein-4b": Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B;
+  "@cf/black-forest-labs/flux-2-klein-9b": Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B;
+  "@cf/zai-org/glm-4.7-flash": Base_Ai_Cf_Zai_Org_Glm_4_7_Flash;
+  "@cf/moonshotai/kimi-k2.5": Base_Ai_Cf_Moonshotai_Kimi_K2_5;
+  "@cf/nvidia/nemotron-3-120b-a12b": Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B;
 }
 type AiOptions = {
   /**
@@ -9409,6 +10249,7 @@ type AiOptions = {
   returnRawResponse?: boolean;
   prefix?: string;
   extraHeaders?: object;
+  signal?: AbortSignal;
 };
 type AiModelsSearchParams = {
   author?: string;
@@ -9435,6 +10276,16 @@ type AiModelsSearchObject = {
     value: string;
   }[];
 };
+type ChatCompletionsBase = XOR<
+  ChatCompletionsPromptInput,
+  ChatCompletionsMessagesInput
+>;
+type ChatCompletionsInput = XOR<
+  ChatCompletionsBase,
+  {
+    requests: ChatCompletionsBase[];
+  }
+>;
 interface InferenceUpstreamError extends Error {}
 interface AiInternalError extends Error {}
 type AiModelListType = Record<string, any>;
@@ -9442,46 +10293,16 @@ declare abstract class Ai<AiModelList extends AiModelListType = AiModels> {
   aiGatewayLogId: string | null;
   gateway(gatewayId: string): AiGateway;
   /**
-   * Access the AI Search API for managing AI-powered search instances.
-   *
-   * This is the new API that replaces AutoRAG with better namespace separation:
-   * - Account-level operations: `list()`, `create()`
-   * - Instance-level operations: `get(id).search()`, `get(id).chatCompletions()`, `get(id).delete()`
-   *
-   * @example
-   * ```typescript
-   * // List all AI Search instances
-   * const instances = await env.AI.aiSearch.list();
-   *
-   * // Search an instance
-   * const results = await env.AI.aiSearch.get('my-search').search({
-   *   messages: [{ role: 'user', content: 'What is the policy?' }],
-   *   ai_search_options: {
-   *     retrieval: { max_num_results: 10 }
-   *   }
-   * });
-   *
-   * // Generate chat completions with AI Search context
-   * const response = await env.AI.aiSearch.get('my-search').chatCompletions({
-   *   messages: [{ role: 'user', content: 'What is the policy?' }],
-   *   model: '@cf/meta/llama-3.3-70b-instruct-fp8-fast'
-   * });
-   * ```
+   * @deprecated Use the standalone `ai_search_namespaces` or `ai_search` Workers bindings instead.
+   * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
    */
-  aiSearch(): AiSearchAccountService;
+  aiSearch(): AiSearchNamespace;
   /**
    * @deprecated AutoRAG has been replaced by AI Search.
-   * Use `env.AI.aiSearch` instead for better API design and new features.
-   *
-   * Migration guide:
-   * - `env.AI.autorag().list()` → `env.AI.aiSearch.list()`
-   * - `env.AI.autorag('id').search({ query: '...' })` → `env.AI.aiSearch.get('id').search({ messages: [{ role: 'user', content: '...' }] })`
-   * - `env.AI.autorag('id').aiSearch(...)` → `env.AI.aiSearch.get('id').chatCompletions(...)`
+   * Use the standalone `ai_search_namespaces` or `ai_search` Workers bindings instead.
+   * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
    *
-   * Note: The old API continues to work for backwards compatibility, but new projects should use AI Search.
-   *
-   * @see AiSearchAccountService
-   * @param autoragId Optional instance ID (omit for account-level operations)
+   * @param autoragId Instance ID
    */
   autorag(autoragId: string): AutoRAG;
   run<
@@ -9640,22 +10461,23 @@ declare abstract class AiGateway {
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
 }
 /**
- * @deprecated AutoRAG has been replaced by AI Search. Use AiSearchInternalError instead.
- * @see AiSearchInternalError
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 interface AutoRAGInternalError extends Error {}
 /**
- * @deprecated AutoRAG has been replaced by AI Search. Use AiSearchNotFoundError instead.
- * @see AiSearchNotFoundError
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 interface AutoRAGNotFoundError extends Error {}
 /**
- * @deprecated This error type is no longer used in the AI Search API.
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 interface AutoRAGUnauthorizedError extends Error {}
 /**
- * @deprecated AutoRAG has been replaced by AI Search. Use AiSearchNameNotSetError instead.
- * @see AiSearchNameNotSetError
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 interface AutoRAGNameNotSetError extends Error {}
 type ComparisonFilter = {
@@ -9668,9 +10490,8 @@ type CompoundFilter = {
   filters: ComparisonFilter[];
 };
 /**
- * @deprecated AutoRAG has been replaced by AI Search.
- * Use AiSearchSearchRequest with the new API instead.
- * @see AiSearchSearchRequest
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 type AutoRagSearchRequest = {
   query: string;
@@ -9687,18 +10508,16 @@ type AutoRagSearchRequest = {
   rewrite_query?: boolean;
 };
 /**
- * @deprecated AutoRAG has been replaced by AI Search.
- * Use AiSearchChatCompletionsRequest with the new API instead.
- * @see AiSearchChatCompletionsRequest
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 type AutoRagAiSearchRequest = AutoRagSearchRequest & {
   stream?: boolean;
   system_prompt?: string;
 };
 /**
- * @deprecated AutoRAG has been replaced by AI Search.
- * Use AiSearchChatCompletionsRequest with stream: true instead.
- * @see AiSearchChatCompletionsRequest
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 type AutoRagAiSearchRequestStreaming = Omit<
   AutoRagAiSearchRequest,
@@ -9707,9 +10526,8 @@ type AutoRagAiSearchRequestStreaming = Omit<
   stream: true;
 };
 /**
- * @deprecated AutoRAG has been replaced by AI Search.
- * Use AiSearchSearchResponse with the new API instead.
- * @see AiSearchSearchResponse
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 type AutoRagSearchResponse = {
   object: "vector_store.search_results.page";
@@ -9728,9 +10546,8 @@ type AutoRagSearchResponse = {
   next_page: string | null;
 };
 /**
- * @deprecated AutoRAG has been replaced by AI Search.
- * Use AiSearchListResponse with the new API instead.
- * @see AiSearchListResponse
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 type AutoRagListResponse = {
   id: string;
@@ -9742,49 +10559,40 @@ type AutoRagListResponse = {
   status: string;
 }[];
 /**
- * @deprecated AutoRAG has been replaced by AI Search.
- * The new API returns different response formats for chat completions.
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 type AutoRagAiSearchResponse = AutoRagSearchResponse & {
   response: string;
 };
 /**
- * @deprecated AutoRAG has been replaced by AI Search.
- * Use the new AI Search API instead: `env.AI.aiSearch`
- *
- * Migration guide:
- * - `env.AI.autorag().list()` → `env.AI.aiSearch.list()`
- * - `env.AI.autorag('id').search(...)` → `env.AI.aiSearch.get('id').search(...)`
- * - `env.AI.autorag('id').aiSearch(...)` → `env.AI.aiSearch.get('id').chatCompletions(...)`
- *
- * @see AiSearchAccountService
- * @see AiSearchInstanceService
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
  */
 declare abstract class AutoRAG {
   /**
-   * @deprecated Use `env.AI.aiSearch.list()` instead.
-   * @see AiSearchAccountService.list
+   * @deprecated Use the standalone AI Search Workers binding instead.
+   * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
    */
   list(): Promise<AutoRagListResponse>;
   /**
-   * @deprecated Use `env.AI.aiSearch.get(id).search(...)` instead.
-   * Note: The new API uses a messages array instead of a query string.
-   * @see AiSearchInstanceService.search
+   * @deprecated Use the standalone AI Search Workers binding instead.
+   * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
    */
   search(params: AutoRagSearchRequest): Promise<AutoRagSearchResponse>;
   /**
-   * @deprecated Use `env.AI.aiSearch.get(id).chatCompletions(...)` instead.
-   * @see AiSearchInstanceService.chatCompletions
+   * @deprecated Use the standalone AI Search Workers binding instead.
+   * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
    */
   aiSearch(params: AutoRagAiSearchRequestStreaming): Promise<Response>;
   /**
-   * @deprecated Use `env.AI.aiSearch.get(id).chatCompletions(...)` instead.
-   * @see AiSearchInstanceService.chatCompletions
+   * @deprecated Use the standalone AI Search Workers binding instead.
+   * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
    */
   aiSearch(params: AutoRagAiSearchRequest): Promise<AutoRagAiSearchResponse>;
   /**
-   * @deprecated Use `env.AI.aiSearch.get(id).chatCompletions(...)` instead.
-   * @see AiSearchInstanceService.chatCompletions
+   * @deprecated Use the standalone AI Search Workers binding instead.
+   * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
    */
   aiSearch(
     params: AutoRagAiSearchRequest,
@@ -9909,6 +10717,41 @@ interface RequestInitCfProperties extends Record<string, unknown> {
    * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
    */
   cacheTtlByStatus?: Record<string, number>;
+  /**
+   * Explicit Cache-Control header value to set on the response stored in cache.
+   * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
+   *
+   * Cannot be used together with `cacheTtl` or the `cache` request option (`no-store`/`no-cache`),
+   * as these are mutually exclusive cache control mechanisms. Setting both will throw a TypeError.
+   *
+   * Can be used together with `cacheTtlByStatus`.
+   */
+  cacheControl?: string;
+  /**
+   * Whether the response should be eligible for Cache Reserve storage.
+   */
+  cacheReserveEligible?: boolean;
+  /**
+   * Whether to respect strong ETags (as opposed to weak ETags) from the origin.
+   */
+  respectStrongEtag?: boolean;
+  /**
+   * Whether to strip ETag headers from the origin response before caching.
+   */
+  stripEtags?: boolean;
+  /**
+   * Whether to strip Last-Modified headers from the origin response before caching.
+   */
+  stripLastModified?: boolean;
+  /**
+   * Whether to enable Cache Deception Armor, which protects against web cache
+   * deception attacks by verifying the Content-Type matches the URL extension.
+   */
+  cacheDeceptionArmor?: boolean;
+  /**
+   * Minimum file size in bytes for a response to be eligible for Cache Reserve storage.
+   */
+  cacheReserveMinimumFileSize?: number;
   scrapeShield?: boolean;
   apps?: boolean;
   image?: RequestInitCfPropertiesImage;
@@ -11821,6 +12664,7 @@ declare namespace CloudflareWorkersModule {
     constructor(ctx: ExecutionContext, env: Env);
     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>;
     scheduled?(controller: ScheduledController): void | Promise<void>;
     tail?(events: TraceItem[]): void | Promise<void>;
@@ -11841,6 +12685,7 @@ declare namespace CloudflareWorkersModule {
     constructor(ctx: DurableObjectState, env: Env);
     alarm?(alarmInfo?: AlarmInvocationInfo): void | Promise<void>;
     fetch?(request: Request): Response | Promise<Response>;
+    connect?(socket: Socket): void | Promise<void>;
     webSocketMessage?(
       ws: WebSocket,
       message: string | ArrayBuffer,
@@ -11991,17 +12836,6 @@ interface StreamBinding {
    * @returns A handle for per-video operations.
    */
   video(id: string): StreamVideoHandle;
-  /**
-   * Uploads a new video from a File.
-   * @param file The video file to upload.
-   * @returns The uploaded video details.
-   * @throws {BadRequestError} if the upload parameter is invalid
-   * @throws {QuotaReachedError} if the account storage capacity is exceeded
-   * @throws {MaxFileSizeError} if the file size is too large
-   * @throws {RateLimitedError} if the server received too many requests
-   * @throws {InternalError} if an unexpected error occurs
-   */
-  upload(file: File): Promise<StreamVideo>;
   /**
    * Uploads a new video from a provided URL.
    * @param url The URL to upload from.
@@ -12851,6 +13685,9 @@ declare namespace TailStream {
     readonly type: "fetch";
     readonly statusCode: number;
   }
+  interface ConnectEventInfo {
+    readonly type: "connect";
+  }
   type EventOutcome =
     | "ok"
     | "canceled"
@@ -12881,6 +13718,7 @@ declare namespace TailStream {
     readonly scriptVersion?: ScriptVersion;
     readonly info:
       | FetchEventInfo
+      | ConnectEventInfo
       | JsRpcEventInfo
       | ScheduledEventInfo
       | AlarmEventInfo