@workers-community/workers-types 4.20260131.0 → 4.20260329.1

package/index.d.ts

@@ -477,54 +477,69 @@ interface ExecutionContext<Props = unknown> {
   passThroughOnException(): void;
   readonly props: Props;
 }
-type ExportedHandlerFetchHandler<Env = unknown, CfHostMetadata = unknown> = (
+type ExportedHandlerFetchHandler<
+  Env = unknown,
+  CfHostMetadata = unknown,
+  Props = unknown,
+> = (
   request: Request<CfHostMetadata, IncomingRequestCfProperties<CfHostMetadata>>,
   env: Env,
-  ctx: ExecutionContext,
+  ctx: ExecutionContext<Props>,
 ) => Response | Promise<Response>;
-type ExportedHandlerTailHandler<Env = unknown> = (
+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,
-  ctx: ExecutionContext,
+  ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
-type ExportedHandlerTraceHandler<Env = unknown> = (
+type ExportedHandlerTraceHandler<Env = unknown, Props = unknown> = (
   traces: TraceItem[],
   env: Env,
-  ctx: ExecutionContext,
+  ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
-type ExportedHandlerTailStreamHandler<Env = unknown> = (
+type ExportedHandlerTailStreamHandler<Env = unknown, Props = unknown> = (
   event: TailStream.TailEvent<TailStream.Onset>,
   env: Env,
-  ctx: ExecutionContext,
+  ctx: ExecutionContext<Props>,
 ) => TailStream.TailEventHandlerType | Promise<TailStream.TailEventHandlerType>;
-type ExportedHandlerScheduledHandler<Env = unknown> = (
+type ExportedHandlerScheduledHandler<Env = unknown, Props = unknown> = (
   controller: ScheduledController,
   env: Env,
-  ctx: ExecutionContext,
+  ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
-type ExportedHandlerQueueHandler<Env = unknown, Message = unknown> = (
+type ExportedHandlerQueueHandler<
+  Env = unknown,
+  Message = unknown,
+  Props = unknown,
+> = (
   batch: MessageBatch<Message>,
   env: Env,
-  ctx: ExecutionContext,
+  ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
-type ExportedHandlerTestHandler<Env = unknown> = (
+type ExportedHandlerTestHandler<Env = unknown, Props = unknown> = (
   controller: TestController,
   env: Env,
-  ctx: ExecutionContext,
+  ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
 interface ExportedHandler<
   Env = unknown,
   QueueHandlerMessage = unknown,
   CfHostMetadata = unknown,
+  Props = unknown,
 > {
-  fetch?: ExportedHandlerFetchHandler<Env, CfHostMetadata>;
-  tail?: ExportedHandlerTailHandler<Env>;
-  trace?: ExportedHandlerTraceHandler<Env>;
-  tailStream?: ExportedHandlerTailStreamHandler<Env>;
-  scheduled?: ExportedHandlerScheduledHandler<Env>;
-  test?: ExportedHandlerTestHandler<Env>;
-  email?: EmailExportedHandler<Env>;
-  queue?: ExportedHandlerQueueHandler<Env, QueueHandlerMessage>;
+  fetch?: ExportedHandlerFetchHandler<Env, CfHostMetadata, Props>;
+  connect?: ExportedHandlerConnectHandler<Env, Props>;
+  tail?: ExportedHandlerTailHandler<Env, Props>;
+  trace?: ExportedHandlerTraceHandler<Env, Props>;
+  tailStream?: ExportedHandlerTailStreamHandler<Env, Props>;
+  scheduled?: ExportedHandlerScheduledHandler<Env, Props>;
+  test?: ExportedHandlerTestHandler<Env, Props>;
+  email?: EmailExportedHandler<Env, Props>;
+  queue?: ExportedHandlerQueueHandler<Env, QueueHandlerMessage, Props>;
 }
 interface StructuredSerializeOptions {
   transfer?: any[];
@@ -537,12 +552,14 @@ declare abstract class Navigator {
 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,
@@ -560,7 +577,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;
@@ -569,6 +586,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,
@@ -3099,6 +3117,7 @@ interface TraceItem {
     | (
         | TraceItemFetchEventInfo
         | TraceItemJsRpcEventInfo
+        | TraceItemConnectEventInfo
         | TraceItemScheduledEventInfo
         | TraceItemAlarmEventInfo
         | TraceItemQueueEventInfo
@@ -3117,6 +3136,7 @@ interface TraceItem {
   readonly scriptVersion?: ScriptVersion;
   readonly dispatchNamespace?: string;
   readonly scriptTags?: string[];
+  readonly tailAttributes?: Record<string, boolean | number | string>;
   readonly durableObjectId?: string;
   readonly outcome: string;
   readonly executionModel: string;
@@ -3127,6 +3147,7 @@ interface TraceItem {
 interface TraceItemAlarmEventInfo {
   readonly scheduledTime: Date;
 }
+interface TraceItemConnectEventInfo {}
 interface TraceItemCustomEventInfo {}
 interface TraceItemScheduledEventInfo {
   readonly scheduledTime: number;
@@ -3561,7 +3582,7 @@ declare var WebSocket: {
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
  */
 interface WebSocket extends EventTarget<WebSocketEventMap> {
-  accept(): void;
+  accept(options?: WebSocketAcceptOptions): void;
   /**
    * The **`WebSocket.send()`** method enqueues the specified data to be transmitted to the server over the WebSocket connection, increasing the value of `bufferedAmount` by the number of bytes needed to contain the data.
    *
@@ -3600,6 +3621,22 @@ interface WebSocket extends EventTarget<WebSocketEventMap> {
    * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/extensions)
    */
   extensions: string | null;
+  /**
+   * The **`WebSocket.binaryType`** property controls the type of binary data being received over the WebSocket connection.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/binaryType)
+   */
+  binaryType: "blob" | "arraybuffer";
+}
+interface WebSocketAcceptOptions {
+  /**
+   * When set to `true`, receiving a server-initiated WebSocket Close frame will not
+   * automatically send a reciprocal Close frame, leaving the connection in a half-open
+   * state. This is useful for proxying scenarios where you need to coordinate closing
+   * both sides independently. Defaults to `false` when the
+   * `no_web_socket_half_open_by_default` compatibility flag is enabled.
+   */
+  allowHalfOpen?: boolean;
 }
 declare const WebSocketPair: {
   new (): {
@@ -3724,19 +3761,21 @@ interface Container {
   signal(signo: number): void;
   getTcpPort(port: number): Fetcher;
   setInactivityTimeout(durationMs: number | bigint): Promise<void>;
+  interceptOutboundHttp(addr: string, binding: Fetcher): Promise<void>;
+  interceptAllOutboundHttp(binding: Fetcher): Promise<void>;
 }
 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.
  *
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort)
  */
-interface MessagePort extends EventTarget {
+declare abstract class MessagePort extends EventTarget {
   /**
    * The **`postMessage()`** method of the transfers ownership of objects to other browsing contexts.
    *
@@ -3816,6 +3855,7 @@ interface WorkerLoader {
     name: string | null,
     getCode: () => WorkerLoaderWorkerCode | Promise<WorkerLoaderWorkerCode>,
   ): WorkerStub;
+  load(code: WorkerLoaderWorkerCode): WorkerStub;
 }
 interface WorkerLoaderModule {
   js?: string;
@@ -3848,6 +3888,180 @@ declare abstract class Performance {
   get timeOrigin(): number;
   /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancenow) */
   now(): number;
+  /**
+   * The **`toJSON()`** method of the Performance interface is a Serialization; it returns a JSON representation of the Performance object.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/toJSON)
+   */
+  toJSON(): object;
+}
+// AI Search V2 API Error Interfaces
+interface AiSearchInternalError extends Error {}
+interface AiSearchNotFoundError extends Error {}
+interface AiSearchNameNotSetError extends Error {}
+// AI Search V2 Request Types
+type AiSearchSearchRequest = {
+  messages: Array<{
+    role: "system" | "developer" | "user" | "assistant" | "tool";
+    content: string | null;
+  }>;
+  ai_search_options?: {
+    retrieval?: {
+      retrieval_type?: "vector" | "keyword" | "hybrid";
+      /** Match threshold (0-1, default 0.4) */
+      match_threshold?: number;
+      /** Maximum number of results (1-50, default 10) */
+      max_num_results?: number;
+      filters?: VectorizeVectorMetadataFilter;
+      /** Context expansion (0-3, default 0) */
+      context_expansion?: number;
+      [key: string]: unknown;
+    };
+    query_rewrite?: {
+      enabled?: boolean;
+      model?: string;
+      rewrite_prompt?: string;
+      [key: string]: unknown;
+    };
+    reranking?: {
+      /** Enable reranking (default false) */
+      enabled?: boolean;
+      model?: "@cf/baai/bge-reranker-base" | "";
+      /** Match threshold (0-1, default 0.4) */
+      match_threshold?: number;
+      [key: string]: unknown;
+    };
+    [key: string]: unknown;
+  };
+};
+type AiSearchChatCompletionsRequest = {
+  messages: Array<{
+    role: "system" | "developer" | "user" | "assistant" | "tool";
+    content: string | null;
+  }>;
+  model?: string;
+  stream?: boolean;
+  ai_search_options?: {
+    retrieval?: {
+      retrieval_type?: "vector" | "keyword" | "hybrid";
+      match_threshold?: number;
+      max_num_results?: number;
+      filters?: VectorizeVectorMetadataFilter;
+      context_expansion?: number;
+      [key: string]: unknown;
+    };
+    query_rewrite?: {
+      enabled?: boolean;
+      model?: string;
+      rewrite_prompt?: string;
+      [key: string]: unknown;
+    };
+    reranking?: {
+      enabled?: boolean;
+      model?: "@cf/baai/bge-reranker-base" | "";
+      match_threshold?: number;
+      [key: string]: unknown;
+    };
+    [key: string]: unknown;
+  };
+  [key: string]: unknown;
+};
+// AI Search V2 Response Types
+type AiSearchSearchResponse = {
+  search_query: string;
+  chunks: Array<{
+    id: string;
+    type: string;
+    /** Match score (0-1) */
+    score: number;
+    text: string;
+    item: {
+      timestamp?: number;
+      key: string;
+      metadata?: Record<string, unknown>;
+    };
+    scoring_details?: {
+      /** Keyword match score (0-1) */
+      keyword_score?: number;
+      /** Vector similarity score (0-1) */
+      vector_score?: number;
+    };
+  }>;
+};
+type AiSearchListResponse = Array<{
+  id: string;
+  internal_id?: string;
+  account_id?: string;
+  account_tag?: string;
+  /** Whether the instance is enabled (default true) */
+  enable?: boolean;
+  type?: "r2" | "web-crawler";
+  source?: string;
+  [key: string]: unknown;
+}>;
+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;
+  /** Token ID (UUID format) */
+  token_id?: string;
+  ai_gateway_id?: string;
+  /** Enable query rewriting (default false) */
+  rewrite_query?: boolean;
+  /** Enable reranking (default false) */
+  reranking?: boolean;
+  embedding_model?: string;
+  ai_search_model?: string;
+};
+type AiSearchInstance = {
+  id: string;
+  enable?: boolean;
+  type?: "r2" | "web-crawler";
+  source?: string;
+  [key: string]: unknown;
+};
+// AI Search Instance Service - Instance-level operations
+declare abstract class AiSearchInstanceService {
+  /**
+   * Search the AI Search instance for relevant chunks.
+   * @param params Search request with messages and AI search options
+   * @returns Search response with matching chunks
+   */
+  search(params: AiSearchSearchRequest): Promise<AiSearchSearchResponse>;
+  /**
+   * Generate chat completions with AI Search context.
+   * @param params Chat completions request with optional streaming
+   * @returns Response object (if streaming) or chat completion result
+   */
+  chatCompletions(
+    params: AiSearchChatCompletionsRequest,
+  ): Promise<Response | object>;
+  /**
+   * Delete this AI Search instance.
+   */
+  delete(): Promise<void>;
+}
+// AI Search Account Service - Account-level operations
+declare abstract class AiSearchAccountService {
+  /**
+   * List all AI Search instances in the account.
+   * @returns Array of AI Search instances
+   */
+  list(): Promise<AiSearchListResponse>;
+  /**
+   * Get an AI Search instance by ID.
+   * @param name Instance ID
+   * @returns Instance service for performing operations
+   */
+  get(name: string): AiSearchInstanceService;
+  /**
+   * Create a new AI Search instance.
+   * @param config Instance configuration
+   * @returns Instance service for performing operations
+   */
+  create(config: AiSearchConfig): Promise<AiSearchInstanceService>;
 }
 type AiImageClassificationInput = {
   image: number[];
@@ -4123,6 +4337,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
@@ -4544,6 +5152,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[];
@@ -4836,10 +5450,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'.
    */
@@ -4857,9 +5473,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?: {
@@ -5006,11 +5646,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
@@ -5030,7 +5670,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
@@ -5135,7 +5775,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?:
@@ -5390,10 +6030,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;
@@ -6049,7 +6697,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?:
@@ -6176,7 +6824,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;
   /**
@@ -6450,7 +7098,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;
   /**
@@ -6543,7 +7191,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;
   /**
@@ -6707,7 +7355,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;
   /**
@@ -6988,7 +7636,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;
   /**
@@ -7227,7 +7875,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;
   /**
@@ -7392,10 +8040,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;
@@ -7607,10 +8263,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;
@@ -8178,12 +8842,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 {
   /**
@@ -8315,7 +8979,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"
@@ -8431,10 +9095,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;
@@ -8646,10 +9318,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;
@@ -9204,6 +9884,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;
@@ -9222,7 +9962,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;
@@ -9289,6 +10028,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 = {
   /**
@@ -9340,12 +10085,64 @@ 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>;
 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'
+   * });
+   * ```
+   */
+  aiSearch(): AiSearchAccountService;
+  /**
+   * @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(...)`
+   *
+   * 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)
+   */
   autorag(autoragId: string): AutoRAG;
   run<
     Name extends keyof AiModelList,
@@ -9502,9 +10299,24 @@ declare abstract class AiGateway {
   ): Promise<Response>;
   getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
 }
+/**
+ * @deprecated AutoRAG has been replaced by AI Search. Use AiSearchInternalError instead.
+ * @see AiSearchInternalError
+ */
 interface AutoRAGInternalError extends Error {}
+/**
+ * @deprecated AutoRAG has been replaced by AI Search. Use AiSearchNotFoundError instead.
+ * @see AiSearchNotFoundError
+ */
 interface AutoRAGNotFoundError extends Error {}
+/**
+ * @deprecated This error type is no longer used in the AI Search API.
+ */
 interface AutoRAGUnauthorizedError extends Error {}
+/**
+ * @deprecated AutoRAG has been replaced by AI Search. Use AiSearchNameNotSetError instead.
+ * @see AiSearchNameNotSetError
+ */
 interface AutoRAGNameNotSetError extends Error {}
 type ComparisonFilter = {
   key: string;
@@ -9515,6 +10327,11 @@ type CompoundFilter = {
   type: "and" | "or";
   filters: ComparisonFilter[];
 };
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * Use AiSearchSearchRequest with the new API instead.
+ * @see AiSearchSearchRequest
+ */
 type AutoRagSearchRequest = {
   query: string;
   filters?: CompoundFilter | ComparisonFilter;
@@ -9529,16 +10346,31 @@ type AutoRagSearchRequest = {
   };
   rewrite_query?: boolean;
 };
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * Use AiSearchChatCompletionsRequest with the new API instead.
+ * @see AiSearchChatCompletionsRequest
+ */
 type AutoRagAiSearchRequest = AutoRagSearchRequest & {
   stream?: boolean;
   system_prompt?: string;
 };
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * Use AiSearchChatCompletionsRequest with stream: true instead.
+ * @see AiSearchChatCompletionsRequest
+ */
 type AutoRagAiSearchRequestStreaming = Omit<
   AutoRagAiSearchRequest,
   "stream"
 > & {
   stream: true;
 };
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * Use AiSearchSearchResponse with the new API instead.
+ * @see AiSearchSearchResponse
+ */
 type AutoRagSearchResponse = {
   object: "vector_store.search_results.page";
   search_query: string;
@@ -9555,6 +10387,11 @@ type AutoRagSearchResponse = {
   has_more: boolean;
   next_page: string | null;
 };
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * Use AiSearchListResponse with the new API instead.
+ * @see AiSearchListResponse
+ */
 type AutoRagListResponse = {
   id: string;
   enable: boolean;
@@ -9564,14 +10401,51 @@ type AutoRagListResponse = {
   paused: boolean;
   status: string;
 }[];
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * The new API returns different response formats for chat completions.
+ */
 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
+ */
 declare abstract class AutoRAG {
+  /**
+   * @deprecated Use `env.AI.aiSearch.list()` instead.
+   * @see AiSearchAccountService.list
+   */
   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
+   */
   search(params: AutoRagSearchRequest): Promise<AutoRagSearchResponse>;
+  /**
+   * @deprecated Use `env.AI.aiSearch.get(id).chatCompletions(...)` instead.
+   * @see AiSearchInstanceService.chatCompletions
+   */
   aiSearch(params: AutoRagAiSearchRequestStreaming): Promise<Response>;
+  /**
+   * @deprecated Use `env.AI.aiSearch.get(id).chatCompletions(...)` instead.
+   * @see AiSearchInstanceService.chatCompletions
+   */
   aiSearch(params: AutoRagAiSearchRequest): Promise<AutoRagAiSearchResponse>;
+  /**
+   * @deprecated Use `env.AI.aiSearch.get(id).chatCompletions(...)` instead.
+   * @see AiSearchInstanceService.chatCompletions
+   */
   aiSearch(
     params: AutoRagAiSearchRequest,
   ): Promise<AutoRagAiSearchResponse | Response>;
@@ -9695,6 +10569,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;
@@ -10799,10 +11708,10 @@ interface SendEmail {
 declare abstract class EmailEvent extends ExtendableEvent {
   readonly message: ForwardableEmailMessage;
 }
-declare type EmailExportedHandler<Env = unknown> = (
+declare type EmailExportedHandler<Env = unknown, Props = unknown> = (
   message: ForwardableEmailMessage,
   env: Env,
-  ctx: ExecutionContext,
+  ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
 declare module "cloudflare:email" {
   let _EmailMessage: {
@@ -10968,6 +11877,86 @@ type ImageOutputOptions = {
   background?: string;
   anim?: boolean;
 };
+interface ImageMetadata {
+  id: string;
+  filename?: string;
+  uploaded?: string;
+  requireSignedURLs: boolean;
+  meta?: Record<string, unknown>;
+  variants: string[];
+  draft?: boolean;
+  creator?: string;
+}
+interface ImageUploadOptions {
+  id?: string;
+  filename?: string;
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+  encoding?: "base64";
+}
+interface ImageUpdateOptions {
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+}
+interface ImageListOptions {
+  limit?: number;
+  cursor?: string;
+  sortOrder?: "asc" | "desc";
+  creator?: string;
+}
+interface ImageList {
+  images: ImageMetadata[];
+  cursor?: string;
+  listComplete: boolean;
+}
+interface HostedImagesBinding {
+  /**
+   * Get detailed metadata for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns Image metadata, or null if not found
+   */
+  details(imageId: string): Promise<ImageMetadata | null>;
+  /**
+   * Get the raw image data for a hosted image
+   * @param imageId The ID of the image (UUID or custom ID)
+   * @returns ReadableStream of image bytes, or null if not found
+   */
+  image(imageId: string): Promise<ReadableStream<Uint8Array> | null>;
+  /**
+   * Upload a new hosted image
+   * @param image The image file to upload
+   * @param options Upload configuration
+   * @returns Metadata for the uploaded image
+   * @throws {@link ImagesError} if upload fails
+   */
+  upload(
+    image: ReadableStream<Uint8Array> | ArrayBuffer,
+    options?: ImageUploadOptions,
+  ): Promise<ImageMetadata>;
+  /**
+   * Update hosted image metadata
+   * @param imageId The ID of the image
+   * @param options Properties to update
+   * @returns Updated image metadata
+   * @throws {@link ImagesError} if update fails
+   */
+  update(imageId: string, options: ImageUpdateOptions): Promise<ImageMetadata>;
+  /**
+   * Delete a hosted image
+   * @param imageId The ID of the image
+   * @returns True if deleted, false if not found
+   */
+  delete(imageId: string): Promise<boolean>;
+  /**
+   * List hosted images with pagination
+   * @param options List configuration
+   * @returns List of images with pagination info
+   * @throws {@link ImagesError} if list fails
+   */
+  list(options?: ImageListOptions): Promise<ImageList>;
+}
 interface ImagesBinding {
   /**
    * Get image metadata (type, width and height)
@@ -10987,6 +11976,10 @@ interface ImagesBinding {
     stream: ReadableStream<Uint8Array>,
     options?: ImageInputOptions,
   ): ImageTransformer;
+  /**
+   * Access hosted images CRUD operations
+   */
+  readonly hosted: HostedImagesBinding;
 }
 interface ImageTransformer {
   /**
@@ -11057,8 +12050,14 @@ interface MediaTransformer {
    * @returns A generator for producing the transformed media output
    */
   transform(
-    transform: MediaTransformationInputOptions,
+    transform?: MediaTransformationInputOptions,
   ): MediaTransformationGenerator;
+  /**
+   * Generates the final media output with specified options.
+   * @param output - Configuration for the output format and parameters
+   * @returns The final transformation result containing the transformed media
+   */
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Generator for producing media transformation results.
@@ -11070,7 +12069,7 @@ interface MediaTransformationGenerator {
    * @param output - Configuration for the output format and parameters
    * @returns The final transformation result containing the transformed media
    */
-  output(output: MediaTransformationOutputOptions): MediaTransformationResult;
+  output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Result of a media transformation operation.
@@ -11079,19 +12078,19 @@ interface MediaTransformationGenerator {
 interface MediaTransformationResult {
   /**
    * Returns the transformed media as a readable stream of bytes.
-   * @returns A stream containing the transformed media data
+   * @returns A promise containing a readable stream with the transformed media
    */
-  media(): ReadableStream<Uint8Array>;
+  media(): Promise<ReadableStream<Uint8Array>>;
   /**
    * Returns the transformed media as an HTTP response object.
-   * @returns The transformed media as a Response, ready to store in cache or return to users
+   * @returns The transformed media as a Promise<Response>, ready to store in cache or return to users
    */
-  response(): Response;
+  response(): Promise<Response>;
   /**
    * Returns the MIME type of the transformed media.
-   * @returns The content type string (e.g., 'image/jpeg', 'video/mp4')
+   * @returns A promise containing the content type string (e.g., 'image/jpeg', 'video/mp4')
    */
-  contentType(): string;
+  contentType(): Promise<string>;
 }
 /**
  * Configuration options for transforming media input.
@@ -11517,6 +12516,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>;
@@ -11537,6 +12537,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,
@@ -11582,15 +12583,18 @@ declare namespace CloudflareWorkersModule {
     timestamp: Date;
     type: string;
   };
+  export type WorkflowStepContext = {
+    attempt: number;
+  };
   export abstract class WorkflowStep {
     do<T extends Rpc.Serializable<T>>(
       name: string,
-      callback: () => Promise<T>,
+      callback: (ctx: WorkflowStepContext) => Promise<T>,
     ): Promise<T>;
     do<T extends Rpc.Serializable<T>>(
       name: string,
       config: WorkflowStepConfig,
-      callback: () => Promise<T>,
+      callback: (ctx: WorkflowStepContext) => Promise<T>,
     ): Promise<T>;
     sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
     sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
@@ -11602,6 +12606,16 @@ declare namespace CloudflareWorkersModule {
       },
     ): Promise<WorkflowStepEvent<T>>;
   }
+  export type WorkflowInstanceStatus =
+    | "queued"
+    | "running"
+    | "paused"
+    | "errored"
+    | "terminated"
+    | "complete"
+    | "waiting"
+    | "waitingForPause"
+    | "unknown";
   export abstract class WorkflowEntrypoint<
     Env = unknown,
     T extends Rpc.Serializable<T> | unknown = unknown,
@@ -11645,12 +12659,763 @@ declare module "cloudflare:sockets" {
   ): Socket;
   export { _connect as connect };
 }
+/**
+ * Binding entrypoint for Cloudflare Stream.
+ *
+ * Usage:
+ * - Binding-level operations:
+ *   `await env.STREAM.videos.upload`
+ *   `await env.STREAM.videos.createDirectUpload`
+ *   `await env.STREAM.videos.*`
+ *   `await env.STREAM.watermarks.*`
+ * - Per-video operations:
+ *   `await env.STREAM.video(id).downloads.*`
+ *   `await env.STREAM.video(id).captions.*`
+ *
+ * Example usage:
+ * ```ts
+ * await env.STREAM.video(id).downloads.generate();
+ *
+ * const video = env.STREAM.video(id)
+ * const captions = video.captions.list();
+ * const videoDetails = video.details()
+ * ```
+ */
+interface StreamBinding {
+  /**
+   * Returns a handle scoped to a single video for per-video operations.
+   * @param id The unique identifier for the video.
+   * @returns A handle for per-video operations.
+   */
+  video(id: string): StreamVideoHandle;
+  /**
+   * Uploads a new video from a provided URL.
+   * @param url The URL to upload from.
+   * @param params Optional upload parameters.
+   * @returns The uploaded video details.
+   * @throws {BadRequestError} if the upload parameter is invalid or the URL 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 {AlreadyUploadedError} if a video was already uploaded to this URL
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  upload(url: string, params?: StreamUrlUploadParams): Promise<StreamVideo>;
+  /**
+   * Creates a direct upload that allows video uploads without an API key.
+   * @param params Parameters for the direct upload
+   * @returns The direct upload details.
+   * @throws {BadRequestError} if the parameters are invalid
+   * @throws {RateLimitedError} if the server received too many requests
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  createDirectUpload(
+    params: StreamDirectUploadCreateParams,
+  ): Promise<StreamDirectUpload>;
+  videos: StreamVideos;
+  watermarks: StreamWatermarks;
+}
+/**
+ * Handle for operations scoped to a single Stream video.
+ */
+interface StreamVideoHandle {
+  /**
+   * The unique identifier for the video.
+   */
+  id: string;
+  /**
+   * Get a full videos details
+   * @returns The full video details.
+   * @throws {NotFoundError} if the video is not found
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  details(): Promise<StreamVideo>;
+  /**
+   * Update details for a single video.
+   * @param params The fields to update for the video.
+   * @returns The updated video details.
+   * @throws {NotFoundError} if the video is not found
+   * @throws {BadRequestError} if the parameters are invalid
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  update(params: StreamUpdateVideoParams): Promise<StreamVideo>;
+  /**
+   * Deletes a video and its copies from Cloudflare Stream.
+   * @returns A promise that resolves when deletion completes.
+   * @throws {NotFoundError} if the video is not found
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  delete(): Promise<void>;
+  /**
+   * Creates a signed URL token for a video.
+   * @returns The signed token that was created.
+   * @throws {InternalError} if the signing key cannot be retrieved or the token cannot be signed
+   */
+  generateToken(): Promise<string>;
+  downloads: StreamScopedDownloads;
+  captions: StreamScopedCaptions;
+}
+interface StreamVideo {
+  /**
+   * The unique identifier for the video.
+   */
+  id: string;
+  /**
+   * A user-defined identifier for the media creator.
+   */
+  creator: string | null;
+  /**
+   * The thumbnail URL for the video.
+   */
+  thumbnail: string;
+  /**
+   * The thumbnail timestamp percentage.
+   */
+  thumbnailTimestampPct: number;
+  /**
+   * Indicates whether the video is ready to stream.
+   */
+  readyToStream: boolean;
+  /**
+   * The date and time the video became ready to stream.
+   */
+  readyToStreamAt: string | null;
+  /**
+   * Processing status information.
+   */
+  status: StreamVideoStatus;
+  /**
+   * A user modifiable key-value store.
+   */
+  meta: Record<string, string>;
+  /**
+   * The date and time the video was created.
+   */
+  created: string;
+  /**
+   * The date and time the video was last modified.
+   */
+  modified: string;
+  /**
+   * The date and time at which the video will be deleted.
+   */
+  scheduledDeletion: string | null;
+  /**
+   * The size of the video in bytes.
+   */
+  size: number;
+  /**
+   * The preview URL for the video.
+   */
+  preview?: string;
+  /**
+   * Origins allowed to display the video.
+   */
+  allowedOrigins: Array<string>;
+  /**
+   * Indicates whether signed URLs are required.
+   */
+  requireSignedURLs: boolean | null;
+  /**
+   * The date and time the video was uploaded.
+   */
+  uploaded: string | null;
+  /**
+   * The date and time when the upload URL expires.
+   */
+  uploadExpiry: string | null;
+  /**
+   * The maximum size in bytes for direct uploads.
+   */
+  maxSizeBytes: number | null;
+  /**
+   * The maximum duration in seconds for direct uploads.
+   */
+  maxDurationSeconds: number | null;
+  /**
+   * The video duration in seconds. -1 indicates unknown.
+   */
+  duration: number;
+  /**
+   * Input metadata for the original upload.
+   */
+  input: StreamVideoInput;
+  /**
+   * Playback URLs for the video.
+   */
+  hlsPlaybackUrl: string;
+  dashPlaybackUrl: string;
+  /**
+   * The watermark applied to the video, if any.
+   */
+  watermark: StreamWatermark | null;
+  /**
+   * The live input id associated with the video, if any.
+   */
+  liveInputId?: string | null;
+  /**
+   * The source video id if this is a clip.
+   */
+  clippedFromId: string | null;
+  /**
+   * Public details associated with the video.
+   */
+  publicDetails: StreamPublicDetails | null;
+}
+type StreamVideoStatus = {
+  /**
+   * The current processing state.
+   */
+  state: string;
+  /**
+   * The current processing step.
+   */
+  step?: string;
+  /**
+   * The percent complete as a string.
+   */
+  pctComplete?: string;
+  /**
+   * An error reason code, if applicable.
+   */
+  errorReasonCode: string;
+  /**
+   * An error reason text, if applicable.
+   */
+  errorReasonText: string;
+};
+type StreamVideoInput = {
+  /**
+   * The input width in pixels.
+   */
+  width: number;
+  /**
+   * The input height in pixels.
+   */
+  height: number;
+};
+type StreamPublicDetails = {
+  /**
+   * The public title for the video.
+   */
+  title: string | null;
+  /**
+   * The public share link.
+   */
+  share_link: string | null;
+  /**
+   * The public channel link.
+   */
+  channel_link: string | null;
+  /**
+   * The public logo URL.
+   */
+  logo: string | null;
+};
+type StreamDirectUpload = {
+  /**
+   * The URL an unauthenticated upload can use for a single multipart request.
+   */
+  uploadURL: string;
+  /**
+   * A Cloudflare-generated unique identifier for a media item.
+   */
+  id: string;
+  /**
+   * The watermark profile applied to the upload.
+   */
+  watermark: StreamWatermark | null;
+  /**
+   * The scheduled deletion time, if any.
+   */
+  scheduledDeletion: string | null;
+};
+type StreamDirectUploadCreateParams = {
+  /**
+   * The maximum duration in seconds for a video upload.
+   */
+  maxDurationSeconds: number;
+  /**
+   * The date and time after upload when videos will not be accepted.
+   */
+  expiry?: string;
+  /**
+   * A user-defined identifier for the media creator.
+   */
+  creator?: string;
+  /**
+   * A user modifiable key-value store used to reference other systems of record for
+   * managing videos.
+   */
+  meta?: Record<string, string>;
+  /**
+   * Lists the origins allowed to display the video.
+   */
+  allowedOrigins?: Array<string>;
+  /**
+   * Indicates whether the video can be accessed using the id. When set to `true`,
+   * a signed token must be generated with a signing key to view the video.
+   */
+  requireSignedURLs?: boolean;
+  /**
+   * The thumbnail timestamp percentage.
+   */
+  thumbnailTimestampPct?: number;
+  /**
+   * The date and time at which the video will be deleted. Include `null` to remove
+   * a scheduled deletion.
+   */
+  scheduledDeletion?: string | null;
+  /**
+   * The watermark profile to apply.
+   */
+  watermark?: StreamDirectUploadWatermark;
+};
+type StreamDirectUploadWatermark = {
+  /**
+   * The unique identifier for the watermark profile.
+   */
+  id: string;
+};
+type StreamUrlUploadParams = {
+  /**
+   * Lists the origins allowed to display the video. Enter allowed origin
+   * domains in an array and use `*` for wildcard subdomains. Empty arrays allow the
+   * video to be viewed on any origin.
+   */
+  allowedOrigins?: Array<string>;
+  /**
+   * A user-defined identifier for the media creator.
+   */
+  creator?: string;
+  /**
+   * A user modifiable key-value store used to reference other systems of
+   * record for managing videos.
+   */
+  meta?: Record<string, string>;
+  /**
+   * Indicates whether the video can be a accessed using the id. When
+   * set to `true`, a signed token must be generated with a signing key to view the
+   * video.
+   */
+  requireSignedURLs?: boolean;
+  /**
+   * Indicates the date and time at which the video will be deleted. Omit
+   * the field to indicate no change, or include with a `null` value to remove an
+   * existing scheduled deletion. If specified, must be at least 30 days from upload
+   * time.
+   */
+  scheduledDeletion?: string | null;
+  /**
+   * The timestamp for a thumbnail image calculated as a percentage value
+   * of the video's duration. To convert from a second-wise timestamp to a
+   * percentage, divide the desired timestamp by the total duration of the video. If
+   * this value is not set, the default thumbnail image is taken from 0s of the
+   * video.
+   */
+  thumbnailTimestampPct?: number;
+  /**
+   * The identifier for the watermark profile
+   */
+  watermarkId?: string;
+};
+interface StreamScopedCaptions {
+  /**
+   * Uploads the caption or subtitle file to the endpoint for a specific BCP47 language.
+   * One caption or subtitle file per language is allowed.
+   * @param language The BCP 47 language tag for the caption or subtitle.
+   * @param file The caption or subtitle file to upload.
+   * @returns The created caption entry.
+   * @throws {NotFoundError} if the video is not found
+   * @throws {BadRequestError} if the language or file is invalid
+   * @throws {MaxFileSizeError} if the file size is too large
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  upload(language: string, file: File): Promise<StreamCaption>;
+  /**
+   * Generate captions or subtitles for the provided language via AI.
+   * @param language The BCP 47 language tag to generate.
+   * @returns The generated caption entry.
+   * @throws {NotFoundError} if the video is not found
+   * @throws {BadRequestError} if the language is invalid
+   * @throws {StreamError} if a generated caption already exists
+   * @throws {StreamError} if the video duration is too long
+   * @throws {StreamError} if the video is missing audio
+   * @throws {StreamError} if the requested language is not supported
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  generate(language: string): Promise<StreamCaption>;
+  /**
+   * Lists the captions or subtitles.
+   * Use the language parameter to filter by a specific language.
+   * @param language The optional BCP 47 language tag to filter by.
+   * @returns The list of captions or subtitles.
+   * @throws {NotFoundError} if the video or caption is not found
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  list(language?: string): Promise<StreamCaption[]>;
+  /**
+   * Removes the captions or subtitles from a video.
+   * @param language The BCP 47 language tag to remove.
+   * @returns A promise that resolves when deletion completes.
+   * @throws {NotFoundError} if the video or caption is not found
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  delete(language: string): Promise<void>;
+}
+interface StreamScopedDownloads {
+  /**
+   * Generates a download for a video when a video is ready to view. Available
+   * types are `default` and `audio`. Defaults to `default` when omitted.
+   * @param downloadType The download type to create.
+   * @returns The current downloads for the video.
+   * @throws {NotFoundError} if the video is not found
+   * @throws {BadRequestError} if the download type is invalid
+   * @throws {StreamError} if the video duration is too long to generate a download
+   * @throws {StreamError} if the video is not ready to stream
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  generate(
+    downloadType?: StreamDownloadType,
+  ): Promise<StreamDownloadGetResponse>;
+  /**
+   * Lists the downloads created for a video.
+   * @returns The current downloads for the video.
+   * @throws {NotFoundError} if the video or downloads are not found
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  get(): Promise<StreamDownloadGetResponse>;
+  /**
+   * Delete the downloads for a video. Available types are `default` and `audio`.
+   * Defaults to `default` when omitted.
+   * @param downloadType The download type to delete.
+   * @returns A promise that resolves when deletion completes.
+   * @throws {NotFoundError} if the video or downloads are not found
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  delete(downloadType?: StreamDownloadType): Promise<void>;
+}
+interface StreamVideos {
+  /**
+   * Lists all videos in a users account.
+   * @returns The list of videos.
+   * @throws {BadRequestError} if the parameters are invalid
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  list(params?: StreamVideosListParams): Promise<StreamVideo[]>;
+}
+interface StreamWatermarks {
+  /**
+   * Generate a new watermark profile
+   * @param file The image file to upload
+   * @param params The watermark creation parameters.
+   * @returns The created watermark profile.
+   * @throws {BadRequestError} if the parameters are invalid
+   * @throws {InvalidURLError} if the URL is invalid
+   * @throws {MaxFileSizeError} if the file size is too large
+   * @throws {TooManyWatermarksError} if the number of allowed watermarks is reached
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  generate(
+    file: File,
+    params: StreamWatermarkCreateParams,
+  ): Promise<StreamWatermark>;
+  /**
+   * Generate a new watermark profile
+   * @param url The image url to upload
+   * @param params The watermark creation parameters.
+   * @returns The created watermark profile.
+   * @throws {BadRequestError} if the parameters are invalid
+   * @throws {InvalidURLError} if the URL is invalid
+   * @throws {MaxFileSizeError} if the file size is too large
+   * @throws {TooManyWatermarksError} if the number of allowed watermarks is reached
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  generate(
+    url: string,
+    params: StreamWatermarkCreateParams,
+  ): Promise<StreamWatermark>;
+  /**
+   * Lists all watermark profiles for an account.
+   * @returns The list of watermark profiles.
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  list(): Promise<StreamWatermark[]>;
+  /**
+   * Retrieves details for a single watermark profile.
+   * @param watermarkId The watermark profile identifier.
+   * @returns The watermark profile details.
+   * @throws {NotFoundError} if the watermark is not found
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  get(watermarkId: string): Promise<StreamWatermark>;
+  /**
+   * Deletes a watermark profile.
+   * @param watermarkId The watermark profile identifier.
+   * @returns A promise that resolves when deletion completes.
+   * @throws {NotFoundError} if the watermark is not found
+   * @throws {InternalError} if an unexpected error occurs
+   */
+  delete(watermarkId: string): Promise<void>;
+}
+type StreamUpdateVideoParams = {
+  /**
+   * Lists the origins allowed to display the video. Enter allowed origin
+   * domains in an array and use `*` for wildcard subdomains. Empty arrays allow the
+   * video to be viewed on any origin.
+   */
+  allowedOrigins?: Array<string>;
+  /**
+   * A user-defined identifier for the media creator.
+   */
+  creator?: string;
+  /**
+   * The maximum duration in seconds for a video upload. Can be set for a
+   * video that is not yet uploaded to limit its duration. Uploads that exceed the
+   * specified duration will fail during processing. A value of `-1` means the value
+   * is unknown.
+   */
+  maxDurationSeconds?: number;
+  /**
+   * A user modifiable key-value store used to reference other systems of
+   * record for managing videos.
+   */
+  meta?: Record<string, string>;
+  /**
+   * Indicates whether the video can be a accessed using the id. When
+   * set to `true`, a signed token must be generated with a signing key to view the
+   * video.
+   */
+  requireSignedURLs?: boolean;
+  /**
+   * Indicates the date and time at which the video will be deleted. Omit
+   * the field to indicate no change, or include with a `null` value to remove an
+   * existing scheduled deletion. If specified, must be at least 30 days from upload
+   * time.
+   */
+  scheduledDeletion?: string | null;
+  /**
+   * The timestamp for a thumbnail image calculated as a percentage value
+   * of the video's duration. To convert from a second-wise timestamp to a
+   * percentage, divide the desired timestamp by the total duration of the video. If
+   * this value is not set, the default thumbnail image is taken from 0s of the
+   * video.
+   */
+  thumbnailTimestampPct?: number;
+};
+type StreamCaption = {
+  /**
+   * Whether the caption was generated via AI.
+   */
+  generated?: boolean;
+  /**
+   * The language label displayed in the native language to users.
+   */
+  label: string;
+  /**
+   * The language tag in BCP 47 format.
+   */
+  language: string;
+  /**
+   * The status of a generated caption.
+   */
+  status?: "ready" | "inprogress" | "error";
+};
+type StreamDownloadStatus = "ready" | "inprogress" | "error";
+type StreamDownloadType = "default" | "audio";
+type StreamDownload = {
+  /**
+   * Indicates the progress as a percentage between 0 and 100.
+   */
+  percentComplete: number;
+  /**
+   * The status of a generated download.
+   */
+  status: StreamDownloadStatus;
+  /**
+   * The URL to access the generated download.
+   */
+  url?: string;
+};
+/**
+ * An object with download type keys. Each key is optional and only present if that
+ * download type has been created.
+ */
+type StreamDownloadGetResponse = {
+  /**
+   * The audio-only download. Only present if this download type has been created.
+   */
+  audio?: StreamDownload;
+  /**
+   * The default video download. Only present if this download type has been created.
+   */
+  default?: StreamDownload;
+};
+type StreamWatermarkPosition =
+  | "upperRight"
+  | "upperLeft"
+  | "lowerLeft"
+  | "lowerRight"
+  | "center";
+type StreamWatermark = {
+  /**
+   * The unique identifier for a watermark profile.
+   */
+  id: string;
+  /**
+   * The size of the image in bytes.
+   */
+  size: number;
+  /**
+   * The height of the image in pixels.
+   */
+  height: number;
+  /**
+   * The width of the image in pixels.
+   */
+  width: number;
+  /**
+   * The date and a time a watermark profile was created.
+   */
+  created: string;
+  /**
+   * The source URL for a downloaded image. If the watermark profile was created via
+   * direct upload, this field is null.
+   */
+  downloadedFrom: string | null;
+  /**
+   * A short description of the watermark profile.
+   */
+  name: string;
+  /**
+   * The translucency of the image. A value of `0.0` makes the image completely
+   * transparent, and `1.0` makes the image completely opaque. Note that if the image
+   * is already semi-transparent, setting this to `1.0` will not make the image
+   * completely opaque.
+   */
+  opacity: number;
+  /**
+   * The whitespace between the adjacent edges (determined by position) of the video
+   * and the image. `0.0` indicates no padding, and `1.0` indicates a fully padded
+   * video width or length, as determined by the algorithm.
+   */
+  padding: number;
+  /**
+   * The size of the image relative to the overall size of the video. This parameter
+   * will adapt to horizontal and vertical videos automatically. `0.0` indicates no
+   * scaling (use the size of the image as-is), and `1.0 `fills the entire video.
+   */
+  scale: number;
+  /**
+   * The location of the image. Valid positions are: `upperRight`, `upperLeft`,
+   * `lowerLeft`, `lowerRight`, and `center`. Note that `center` ignores the
+   * `padding` parameter.
+   */
+  position: StreamWatermarkPosition;
+};
+type StreamWatermarkCreateParams = {
+  /**
+   * A short description of the watermark profile.
+   */
+  name?: string;
+  /**
+   * The translucency of the image. A value of `0.0` makes the image completely
+   * transparent, and `1.0` makes the image completely opaque. Note that if the
+   * image is already semi-transparent, setting this to `1.0` will not make the
+   * image completely opaque.
+   */
+  opacity?: number;
+  /**
+   * The whitespace between the adjacent edges (determined by position) of the
+   * video and the image. `0.0` indicates no padding, and `1.0` indicates a fully
+   * padded video width or length, as determined by the algorithm.
+   */
+  padding?: number;
+  /**
+   * The size of the image relative to the overall size of the video. This
+   * parameter will adapt to horizontal and vertical videos automatically. `0.0`
+   * indicates no scaling (use the size of the image as-is), and `1.0 `fills the
+   * entire video.
+   */
+  scale?: number;
+  /**
+   * The location of the image.
+   */
+  position?: StreamWatermarkPosition;
+};
+type StreamVideosListParams = {
+  /**
+   * The maximum number of videos to return.
+   */
+  limit?: number;
+  /**
+   * Return videos created before this timestamp.
+   * (RFC3339/RFC3339Nano)
+   */
+  before?: string;
+  /**
+   * Comparison operator for the `before` field.
+   * @default 'lt'
+   */
+  beforeComp?: StreamPaginationComparison;
+  /**
+   * Return videos created after this timestamp.
+   * (RFC3339/RFC3339Nano)
+   */
+  after?: string;
+  /**
+   * Comparison operator for the `after` field.
+   * @default 'gte'
+   */
+  afterComp?: StreamPaginationComparison;
+};
+type StreamPaginationComparison = "eq" | "gt" | "gte" | "lt" | "lte";
+/**
+ * Error object for Stream binding operations.
+ */
+interface StreamError extends Error {
+  readonly code: number;
+  readonly statusCode: number;
+  readonly message: string;
+  readonly stack?: string;
+}
+interface InternalError extends StreamError {
+  name: "InternalError";
+}
+interface BadRequestError extends StreamError {
+  name: "BadRequestError";
+}
+interface NotFoundError extends StreamError {
+  name: "NotFoundError";
+}
+interface ForbiddenError extends StreamError {
+  name: "ForbiddenError";
+}
+interface RateLimitedError extends StreamError {
+  name: "RateLimitedError";
+}
+interface QuotaReachedError extends StreamError {
+  name: "QuotaReachedError";
+}
+interface MaxFileSizeError extends StreamError {
+  name: "MaxFileSizeError";
+}
+interface InvalidURLError extends StreamError {
+  name: "InvalidURLError";
+}
+interface AlreadyUploadedError extends StreamError {
+  name: "AlreadyUploadedError";
+}
+interface TooManyWatermarksError extends StreamError {
+  name: "TooManyWatermarksError";
+}
 type MarkdownDocument = {
   name: string;
   blob: Blob;
 };
 type ConversionResponse =
   | {
+      id: string;
       name: string;
       mimeType: string;
       format: "markdown";
@@ -11658,6 +13423,7 @@ type ConversionResponse =
       data: string;
     }
   | {
+      id: string;
       name: string;
       mimeType: string;
       format: "error";
@@ -11675,6 +13441,8 @@ type ConversionOptions = {
     images?: EmbeddedImageConversionOptions & {
       convertOGImage?: boolean;
     };
+    hostname?: string;
+    cssSelector?: string;
   };
   docx?: {
     images?: EmbeddedImageConversionOptions;
@@ -11769,6 +13537,9 @@ declare namespace TailStream {
     readonly type: "fetch";
     readonly statusCode: number;
   }
+  interface ConnectEventInfo {
+    readonly type: "connect";
+  }
   type EventOutcome =
     | "ok"
     | "canceled"
@@ -11799,6 +13570,7 @@ declare namespace TailStream {
     readonly scriptVersion?: ScriptVersion;
     readonly info:
       | FetchEventInfo
+      | ConnectEventInfo
       | JsRpcEventInfo
       | ScheduledEventInfo
       | AlarmEventInfo