@cloudflare/workers-types 4.20260227.0 → 4.20260228.1

package/latest/index.ts

@@ -3890,6 +3890,190 @@ export 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
+export interface AiSearchInternalError extends Error {}
+export interface AiSearchNotFoundError extends Error {}
+export interface AiSearchNameNotSetError extends Error {}
+// Filter types (shared with AutoRAG for compatibility)
+export type ComparisonFilter = {
+  key: string;
+  type: "eq" | "ne" | "gt" | "gte" | "lt" | "lte";
+  value: string | number | boolean;
+};
+export type CompoundFilter = {
+  type: "and" | "or";
+  filters: ComparisonFilter[];
+};
+// AI Search V2 Request Types
+export 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?: CompoundFilter | ComparisonFilter;
+      /** 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;
+  };
+};
+export 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?: CompoundFilter | ComparisonFilter;
+      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
+export 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;
+    };
+  }>;
+};
+export 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;
+}>;
+export 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;
+};
+export type AiSearchInstance = {
+  id: string;
+  enable?: boolean;
+  type?: "r2" | "web-crawler";
+  source?: string;
+  [key: string]: unknown;
+};
+// AI Search Instance Service - Instance-level operations
+export 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
+export 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>;
 }
 export type AiImageClassificationInput = {
   image: number[];
@@ -9391,6 +9575,48 @@ export declare abstract class Ai<
 > {
   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,
@@ -9547,19 +9773,30 @@ export 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
+ */
 export interface AutoRAGInternalError extends Error {}
+/**
+ * @deprecated AutoRAG has been replaced by AI Search. Use AiSearchNotFoundError instead.
+ * @see AiSearchNotFoundError
+ */
 export interface AutoRAGNotFoundError extends Error {}
+/**
+ * @deprecated This error type is no longer used in the AI Search API.
+ */
 export interface AutoRAGUnauthorizedError extends Error {}
+/**
+ * @deprecated AutoRAG has been replaced by AI Search. Use AiSearchNameNotSetError instead.
+ * @see AiSearchNameNotSetError
+ */
 export interface AutoRAGNameNotSetError extends Error {}
-export type ComparisonFilter = {
-  key: string;
-  type: "eq" | "ne" | "gt" | "gte" | "lt" | "lte";
-  value: string | number | boolean;
-};
-export type CompoundFilter = {
-  type: "and" | "or";
-  filters: ComparisonFilter[];
-};
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * Use AiSearchSearchRequest with the new API instead.
+ * @see AiSearchSearchRequest
+ */
 export type AutoRagSearchRequest = {
   query: string;
   filters?: CompoundFilter | ComparisonFilter;
@@ -9574,16 +9811,31 @@ export type AutoRagSearchRequest = {
   };
   rewrite_query?: boolean;
 };
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * Use AiSearchChatCompletionsRequest with the new API instead.
+ * @see AiSearchChatCompletionsRequest
+ */
 export type AutoRagAiSearchRequest = AutoRagSearchRequest & {
   stream?: boolean;
   system_prompt?: string;
 };
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * Use AiSearchChatCompletionsRequest with stream: true instead.
+ * @see AiSearchChatCompletionsRequest
+ */
 export type AutoRagAiSearchRequestStreaming = Omit<
   AutoRagAiSearchRequest,
   "stream"
 > & {
   stream: true;
 };
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * Use AiSearchSearchResponse with the new API instead.
+ * @see AiSearchSearchResponse
+ */
 export type AutoRagSearchResponse = {
   object: "vector_store.search_results.page";
   search_query: string;
@@ -9600,6 +9852,11 @@ export 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
+ */
 export type AutoRagListResponse = {
   id: string;
   enable: boolean;
@@ -9609,14 +9866,51 @@ export type AutoRagListResponse = {
   paused: boolean;
   status: string;
 }[];
+/**
+ * @deprecated AutoRAG has been replaced by AI Search.
+ * The new API returns different response formats for chat completions.
+ */
 export 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
+ */
 export 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>;
@@ -11018,6 +11312,86 @@ export type ImageOutputOptions = {
   background?: string;
   anim?: boolean;
 };
+export interface ImageMetadata {
+  id: string;
+  filename?: string;
+  uploaded?: string;
+  requireSignedURLs: boolean;
+  meta?: Record<string, unknown>;
+  variants: string[];
+  draft?: boolean;
+  creator?: string;
+}
+export interface ImageUploadOptions {
+  id?: string;
+  filename?: string;
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+  encoding?: "base64";
+}
+export interface ImageUpdateOptions {
+  requireSignedURLs?: boolean;
+  metadata?: Record<string, unknown>;
+  creator?: string;
+}
+export interface ImageListOptions {
+  limit?: number;
+  cursor?: string;
+  sortOrder?: "asc" | "desc";
+  creator?: string;
+}
+export interface ImageList {
+  images: ImageMetadata[];
+  cursor?: string;
+  listComplete: boolean;
+}
+export 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>;
+}
 export interface ImagesBinding {
   /**
    * Get image metadata (type, width and height)
@@ -11037,6 +11411,10 @@ export interface ImagesBinding {
     stream: ReadableStream<Uint8Array>,
     options?: ImageInputOptions,
   ): ImageTransformer;
+  /**
+   * Access hosted images CRUD operations
+   */
+  readonly hosted: HostedImagesBinding;
 }
 export interface ImageTransformer {
   /**
@@ -11107,8 +11485,14 @@ export 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.
@@ -11120,7 +11504,7 @@ export 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.
@@ -11129,19 +11513,19 @@ export interface MediaTransformationGenerator {
 export 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.