npm - @workers-community/workers-types - Versions diffs - 4.20260415.1 → 4.20260417.1 - Mend

@workers-community/workers-types 4.20260415.1 → 4.20260417.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/index.d.ts CHANGED Viewed

@@ -549,6 +549,7 @@ declare abstract class Navigator {
   sendBeacon(url: string, body?: BodyInit): boolean;
   readonly userAgent: string;
   readonly hardwareConcurrency: number;
+  readonly platform: string;
 }
 interface AlarmInvocationInfo {
   readonly isRetry: boolean;
@@ -2330,11 +2331,34 @@ interface KVNamespaceGetWithMetadataResult<Value, Metadata> {
 }
 type QueueContentType = "text" | "bytes" | "json" | "v8";
 interface Queue<Body = unknown> {
-  send(message: Body, options?: QueueSendOptions): Promise<void>;
+  metrics(): Promise<QueueMetrics>;
+  send(message: Body, options?: QueueSendOptions): Promise<QueueSendResponse>;
   sendBatch(
     messages: Iterable<MessageSendRequest<Body>>,
     options?: QueueSendBatchOptions,
-  ): Promise<void>;
+  ): Promise<QueueSendBatchResponse>;
+}
+interface QueueSendMetrics {
+  backlogCount: number;
+  backlogBytes: number;
+  oldestMessageTimestamp?: Date;
+}
+interface QueueSendMetadata {
+  metrics: QueueSendMetrics;
+}
+interface QueueSendResponse {
+  metadata: QueueSendMetadata;
+}
+interface QueueSendBatchMetrics {
+  backlogCount: number;
+  backlogBytes: number;
+  oldestMessageTimestamp?: Date;
+}
+interface QueueSendBatchMetadata {
+  metrics: QueueSendBatchMetrics;
+}
+interface QueueSendBatchResponse {
+  metadata: QueueSendBatchMetadata;
 }
 interface QueueSendOptions {
   contentType?: QueueContentType;
@@ -2348,6 +2372,19 @@ interface MessageSendRequest<Body = unknown> {
   contentType?: QueueContentType;
   delaySeconds?: number;
 }
+interface QueueMetrics {
+  backlogCount: number;
+  backlogBytes: number;
+  oldestMessageTimestamp?: Date;
+}
+interface MessageBatchMetrics {
+  backlogCount: number;
+  backlogBytes: number;
+  oldestMessageTimestamp?: Date;
+}
+interface MessageBatchMetadata {
+  metrics: MessageBatchMetrics;
+}
 interface QueueRetryOptions {
   delaySeconds?: number;
 }
@@ -2362,12 +2399,14 @@ interface Message<Body = unknown> {
 interface QueueEvent<Body = unknown> extends ExtendableEvent {
   readonly messages: readonly Message<Body>[];
   readonly queue: string;
+  readonly metadata: MessageBatchMetadata;
   retryAll(options?: QueueRetryOptions): void;
   ackAll(): void;
 }
 interface MessageBatch<Body = unknown> {
   readonly messages: readonly Message<Body>[];
   readonly queue: string;
+  readonly metadata: MessageBatchMetadata;
   retryAll(options?: QueueRetryOptions): void;
   ackAll(): void;
 }
@@ -3985,73 +4024,145 @@ declare abstract class Performance {
 // ============ AI Search Error Interfaces ============
 interface AiSearchInternalError extends Error {}
 interface AiSearchNotFoundError extends Error {}
-// ============ AI Search 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?: {
-      enabled?: boolean;
-      model?: "@cf/baai/bge-reranker-base" | string;
-      /** Match threshold (0-1, default 0.4) */
-      match_threshold?: number;
-      [key: string]: unknown;
-    };
+// ============ AI Search Common Types ============
+/** A single message in a conversation-style search or chat request. */
+type AiSearchMessage = {
+  role: "system" | "developer" | "user" | "assistant" | "tool";
+  content: string | null;
+};
+/**
+ * Common shape for `ai_search_options` used by both single-instance and multi-instance requests.
+ * Contains retrieval, query rewrite, reranking, and cache sub-options.
+ */
+type AiSearchOptions = {
+  retrieval?: {
+    /** Which retrieval backend to use. Defaults to the instance's configured index_method. */
+    retrieval_type?: "vector" | "keyword" | "hybrid";
+    /** Fusion method for combining vector + keyword results. */
+    fusion_method?: "max" | "rrf";
+    /** How keyword terms are combined: "and" = all terms must match, "or" = any term matches. */
+    keyword_match_mode?: "and" | "or";
+    /** Minimum similarity score (0-1) for a result to be included. Default 0.4. */
+    match_threshold?: number;
+    /** Maximum number of results to return (1-50). Default 10. */
+    max_num_results?: number;
+    /** Vectorize metadata filters applied to the search. */
+    filters?: VectorizeVectorMetadataFilter;
+    /** Number of surrounding chunks to include for context (0-3). Default 0. */
+    context_expansion?: number;
+    /** If true, return only item metadata without chunk text. */
+    metadata_only?: boolean;
+    /** If true (default), return empty results on retrieval failure instead of throwing. */
+    return_on_failure?: boolean;
+    /** Boost results by metadata field values. Max 3 entries. */
+    boost_by?: Array<{
+      field: string;
+      direction?: "asc" | "desc" | "exists" | "not_exists";
+    }>;
+    [key: string]: unknown;
+  };
+  query_rewrite?: {
+    enabled?: boolean;
+    model?: string;
+    rewrite_prompt?: string;
+    [key: string]: unknown;
+  };
+  reranking?: {
+    enabled?: boolean;
+    model?: string;
+    /** Match threshold (0-1, default 0.4) */
+    match_threshold?: number;
     [key: string]: unknown;
   };
+  cache?: {
+    enabled?: boolean;
+    cache_threshold?:
+      | "super_strict_match"
+      | "close_enough"
+      | "flexible_friend"
+      | "anything_goes";
+  };
+  [key: string]: unknown;
 };
+// ============ AI Search Request Types ============
+/**
+ * Request body for single-instance search.
+ * Exactly one of `query` or `messages` must be provided.
+ */
+type AiSearchSearchRequest =
+  | {
+      /** Simple query string. */
+      query: string;
+      messages?: never;
+      ai_search_options?: AiSearchOptions;
+    }
+  | {
+      query?: never;
+      /** Conversation-style input. At least one user message with non-empty content is required. */
+      messages: AiSearchMessage[];
+      ai_search_options?: AiSearchOptions;
+    };
 type AiSearchChatCompletionsRequest = {
-  messages: Array<{
-    role: "system" | "developer" | "user" | "assistant" | "tool";
-    content: string | null;
-    [key: string]: unknown;
-  }>;
+  messages: AiSearchMessage[];
   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" | string;
-      match_threshold?: number;
-      [key: string]: unknown;
-    };
-    [key: string]: unknown;
-  };
+  ai_search_options?: AiSearchOptions;
   [key: string]: unknown;
 };
+// ============ AI Search Multi-Instance Types (Namespace-Scoped) ============
+/** `ai_search_options` shape for multi-instance requests — requires `instance_ids`. */
+type AiSearchMultiSearchOptions = AiSearchOptions & {
+  /** Instance IDs to search across (1-10). */
+  instance_ids: string[];
+};
+/**
+ * Request for searching across multiple instances within a namespace.
+ * `ai_search_options` is required and must include `instance_ids`.
+ * Exactly one of `query` or `messages` must be provided.
+ */
+type AiSearchMultiSearchRequest =
+  | {
+      /** Simple query string. */
+      query: string;
+      messages?: never;
+      ai_search_options: AiSearchMultiSearchOptions;
+    }
+  | {
+      query?: never;
+      /** Conversation-style input. */
+      messages: AiSearchMessage[];
+      ai_search_options: AiSearchMultiSearchOptions;
+    };
+/** A search result chunk tagged with the instance it originated from. */
+type AiSearchMultiSearchChunk = AiSearchSearchResponse["chunks"][number] & {
+  instance_id: string;
+};
+/** Describes a per-instance error during a multi-instance operation. */
+type AiSearchMultiSearchError = {
+  instance_id: string;
+  message: string;
+};
+/** Response from a multi-instance search, with chunks tagged by instance and optional partial-failure errors. */
+type AiSearchMultiSearchResponse = {
+  search_query: string;
+  chunks: AiSearchMultiSearchChunk[];
+  errors?: AiSearchMultiSearchError[];
+};
+/** Request for chat completions across multiple instances within a namespace. `ai_search_options` is required and must include `instance_ids`. */
+type AiSearchMultiChatCompletionsRequest = Omit<
+  AiSearchChatCompletionsRequest,
+  "ai_search_options"
+> & {
+  ai_search_options: AiSearchMultiSearchOptions;
+};
+/** Response from multi-instance chat completions, with chunks tagged by instance and optional partial-failure errors. */
+type AiSearchMultiChatCompletionsResponse = Omit<
+  AiSearchChatCompletionsResponse,
+  "chunks"
+> & {
+  chunks: AiSearchMultiSearchChunk[];
+  errors?: AiSearchMultiSearchError[];
+};
 // ============ AI Search Response Types ============
 type AiSearchSearchResponse = {
   search_query: string;
@@ -4071,6 +4182,14 @@ type AiSearchSearchResponse = {
       keyword_score?: number;
       /** Vector similarity score (0-1) */
       vector_score?: number;
+      /** Keyword rank position */
+      keyword_rank?: number;
+      /** Vector rank position */
+      vector_rank?: number;
+      /** Reranking model score */
+      reranking_score?: number;
+      /** Fusion method used to combine results */
+      fusion_method?: "rrf" | "max";
       [key: string]: unknown;
     };
   }>;
@@ -4099,19 +4218,88 @@ type AiSearchStatsResponse = {
   skipped?: number;
   outdated?: number;
   last_activity?: string;
+  /** Storage engine statistics. */
+  engine?: {
+    vectorize?: {
+      vectorsCount: number;
+      dimensions: number;
+    };
+    r2?: {
+      payloadSizeBytes: number;
+      metadataSizeBytes: number;
+      objectCount: number;
+    };
+  };
 };
 // ============ AI Search Instance Info Types ============
 type AiSearchInstanceInfo = {
   id: string;
   type?: "r2" | "web-crawler" | string;
   source?: string;
+  source_params?: unknown;
   paused?: boolean;
   status?: string;
   namespace?: string;
   created_at?: string;
   modified_at?: string;
+  token_id?: string;
+  ai_gateway_id?: string;
+  rewrite_query?: boolean;
+  reranking?: boolean;
+  embedding_model?: string;
+  ai_search_model?: string;
+  rewrite_model?: string;
+  reranking_model?: string;
+  /** @deprecated Use index_method instead. */
+  hybrid_search_enabled?: boolean;
+  /** Controls which storage backends are active. */
+  index_method?: {
+    vector?: boolean;
+    keyword?: boolean;
+  };
+  /** Fusion method for combining vector and keyword results. */
+  fusion_method?: "max" | "rrf";
+  indexing_options?: {
+    keyword_tokenizer?: "porter" | "trigram";
+  } | null;
+  retrieval_options?: {
+    keyword_match_mode?: "and" | "or";
+    boost_by?: Array<{
+      field: string;
+      direction?: "asc" | "desc" | "exists" | "not_exists";
+    }>;
+  } | null;
+  chunk?: boolean;
+  chunk_size?: number;
+  chunk_overlap?: number;
+  score_threshold?: number;
+  max_num_results?: number;
+  cache?: boolean;
+  cache_threshold?:
+    | "super_strict_match"
+    | "close_enough"
+    | "flexible_friend"
+    | "anything_goes";
+  custom_metadata?: Array<{
+    field_name: string;
+    data_type: "text" | "number" | "boolean" | "datetime";
+  }>;
+  /** Sync interval in seconds. */
+  sync_interval?: 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
+  metadata?: Record<string, unknown>;
   [key: string]: unknown;
 };
+/** Pagination, search, and ordering parameters for listing instances within a namespace. */
+type AiSearchListInstancesParams = {
+  page?: number;
+  per_page?: number;
+  /** Search instances by ID. */
+  search?: string;
+  /** Field to sort by. */
+  order_by?: "created_at";
+  /** Sort direction. */
+  order_by_direction?: "asc" | "desc";
+};
 type AiSearchListResponse = {
   result: AiSearchInstanceInfo[];
   result_info?: {
@@ -4139,19 +4327,64 @@ type AiSearchConfig = {
   reranking?: boolean;
   embedding_model?: string;
   ai_search_model?: string;
+  rewrite_model?: string;
+  reranking_model?: string;
+  /** @deprecated Use index_method instead. */
+  hybrid_search_enabled?: boolean;
+  /** Controls which storage backends are used during indexing. Defaults to vector-only. */
+  index_method?: {
+    vector?: boolean;
+    keyword?: boolean;
+  };
+  /** Fusion method for combining vector and keyword results. "rrf" = reciprocal rank fusion (default), "max" = maximum score. */
+  fusion_method?: "max" | "rrf";
+  indexing_options?: {
+    keyword_tokenizer?: "porter" | "trigram";
+  } | null;
+  retrieval_options?: {
+    keyword_match_mode?: "and" | "or";
+    boost_by?: Array<{
+      field: string;
+      direction?: "asc" | "desc" | "exists" | "not_exists";
+    }>;
+  } | null;
+  chunk?: boolean;
+  chunk_size?: number;
+  chunk_overlap?: number;
+  /** Minimum similarity score (0-1) for a result to be included. */
+  score_threshold?: number;
+  max_num_results?: number;
+  cache?: boolean;
+  /** Similarity threshold for cache hits. Stricter = fewer cache hits but higher relevance. */
+  cache_threshold?:
+    | "super_strict_match"
+    | "close_enough"
+    | "flexible_friend"
+    | "anything_goes";
+  custom_metadata?: Array<{
+    field_name: string;
+    data_type: "text" | "number" | "boolean" | "datetime";
+  }>;
+  namespace?: string;
+  /** Sync interval in seconds. 3600=1h, 7200=2h, 14400=4h, 21600=6h, 43200=12h, 86400=24h. */
+  sync_interval?: 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
+  metadata?: Record<string, unknown>;
   [key: string]: unknown;
 };
 // ============ AI Search Item Types ============
 type AiSearchItemInfo = {
   id: string;
   key: string;
-  status:
-    | "completed"
-    | "error"
-    | "skipped"
-    | "queued"
-    | "processing"
-    | "outdated";
+  status: "completed" | "error" | "skipped" | "queued" | "running" | "outdated";
+  next_action?: "INDEX" | "DELETE" | null;
+  error?: string;
+  checksum?: string;
+  namespace?: string;
+  chunks_count?: number | null;
+  file_size?: number | null;
+  source_id?: string | null;
+  last_seen_at?: string;
+  created_at?: string;
   metadata?: Record<string, unknown>;
   [key: string]: unknown;
 };
@@ -4167,6 +4400,22 @@ type AiSearchUploadItemOptions = {
 type AiSearchListItemsParams = {
   page?: number;
   per_page?: number;
+  /** Search items by key name. */
+  search?: string;
+  /** Sort order for results. */
+  sort_by?: "status" | "modified_at";
+  /** Filter items by processing status. */
+  status?:
+    | "queued"
+    | "running"
+    | "completed"
+    | "error"
+    | "skipped"
+    | "outdated";
+  /** Filter items by source (e.g. "builtin" or "web-crawler:https://example.com"). */
+  source?: string;
+  /** JSON-encoded Vectorize filter for metadata filtering. */
+  metadata_filter?: string;
 };
 type AiSearchListItemsResponse = {
   result: AiSearchItemInfo[];
@@ -4177,6 +4426,61 @@ type AiSearchListItemsResponse = {
     total_count: number;
   };
 };
+// ============ AI Search Item Logs Types ============
+type AiSearchItemLogsParams = {
+  /** Maximum number of log entries to return (1-100, default 50). */
+  limit?: number;
+  /** Opaque cursor for pagination. Pass the `cursor` value from a previous response. */
+  cursor?: string;
+};
+type AiSearchItemLog = {
+  timestamp: string;
+  action: string;
+  message: string;
+  fileKey?: string;
+  chunkCount?: number;
+  processingTimeMs?: number;
+  errorType?: string;
+};
+/** Paginated response for item processing logs (cursor-based). */
+type AiSearchItemLogsResponse = {
+  result: AiSearchItemLog[];
+  result_info: {
+    count: number;
+    per_page: number;
+    cursor: string | null;
+    truncated: boolean;
+  };
+};
+// ============ AI Search Item Chunks Types ============
+type AiSearchItemChunksParams = {
+  /** Maximum number of chunks to return (1-100, default 20). */
+  limit?: number;
+  /** Offset into the chunks list (default 0). */
+  offset?: number;
+};
+/** A single indexed chunk belonging to an item, including its text content and byte range. */
+type AiSearchItemChunk = {
+  id: string;
+  text: string;
+  start_byte: number;
+  end_byte: number;
+  item?: {
+    timestamp?: number;
+    key: string;
+    metadata?: Record<string, unknown>;
+  };
+};
+/** Paginated response for item chunks (offset-based). */
+type AiSearchItemChunksResponse = {
+  result: AiSearchItemChunk[];
+  result_info: {
+    count: number;
+    total: number;
+    limit: number;
+    offset: number;
+  };
+};
 // ============ AI Search Job Types ============
 type AiSearchJobInfo = {
   id: string;
@@ -4225,7 +4529,7 @@ type AiSearchJobLogsResponse = {
 // ============ AI Search Sub-Service Classes ============
 /**
  * Single item service for an AI Search instance.
- * Provides info, delete, and download operations on a specific item.
+ * Provides info, download, sync, logs, and chunks operations on a specific item.
  */
 declare abstract class AiSearchItem {
   /** Get metadata about this item. */
@@ -4235,6 +4539,25 @@ declare abstract class AiSearchItem {
    * @returns Object with body stream, content type, filename, and size.
    */
   download(): Promise<AiSearchItemContentResult>;
+  /**
+   * Trigger re-indexing of this item.
+   * @returns The updated item info.
+   */
+  sync(): Promise<AiSearchItemInfo>;
+  /**
+   * Retrieve processing logs for this item (cursor-based pagination).
+   * @param params Optional pagination parameters (limit, cursor).
+   * @returns Paginated log entries for this item.
+   */
+  logs(params?: AiSearchItemLogsParams): Promise<AiSearchItemLogsResponse>;
+  /**
+   * List indexed chunks for this item (offset-based pagination).
+   * @param params Optional pagination parameters (limit, offset).
+   * @returns Paginated chunk entries for this item.
+   */
+  chunks(
+    params?: AiSearchItemChunksParams,
+  ): Promise<AiSearchItemChunksResponse>;
 }
 /**
  * Items collection service for an AI Search instance.
@@ -4244,49 +4567,64 @@ declare abstract class AiSearchItems {
   /** List items in this instance. */
   list(params?: AiSearchListItemsParams): Promise<AiSearchListItemsResponse>;
   /**
-   * Upload a file as an item.
+   * Upload a file as an item. Behaves as an upsert: if an item with the same
+   * filename already exists, it is overwritten and re-indexed.
    * @param name Filename for the uploaded item.
-   * @param content File content as a ReadableStream, ArrayBuffer, or string.
+   * @param content File content as a ReadableStream, Blob, or string.
    * @param options Optional metadata to attach to the item.
    * @returns The created item info.
    */
   upload(
     name: string,
-    content: ReadableStream | ArrayBuffer | string,
+    content: ReadableStream | Blob | string,
     options?: AiSearchUploadItemOptions,
   ): Promise<AiSearchItemInfo>;
   /**
    * Upload a file and poll until processing completes.
+   * Behaves as an upsert: if an item with the same filename already exists,
+   * it is overwritten and re-indexed.
    * @param name Filename for the uploaded item.
-   * @param content File content as a ReadableStream, ArrayBuffer, or string.
-   * @param options Optional metadata to attach to the item.
+   * @param content File content as a ReadableStream, Blob, or string.
+   * @param options Optional metadata and polling configuration.
    * @returns The item info after processing completes (or timeout).
    */
   uploadAndPoll(
     name: string,
-    content: ReadableStream | ArrayBuffer | string,
-    options?: AiSearchUploadItemOptions,
+    content: ReadableStream | Blob | string,
+    options?: AiSearchUploadItemOptions & {
+      /** Polling interval in milliseconds (default 1000). */
+      pollIntervalMs?: number;
+      /** Maximum time to wait in milliseconds (default 30000). */
+      timeoutMs?: number;
+    },
   ): Promise<AiSearchItemInfo>;
   /**
    * Get an item by ID.
    * @param itemId The item identifier.
-   * @returns Item service for info, delete, and download operations.
+   * @returns Item service for info, download, sync, logs, and chunks operations.
    */
   get(itemId: string): AiSearchItem;
-  /** Delete this item from the instance.
+  /**
+   * Delete an item from the instance.
    * @param itemId The item identifier.
    */
   delete(itemId: string): Promise<void>;
 }
 /**
  * Single job service for an AI Search instance.
- * Provides info and logs for a specific job.
+ * Provides info, logs, and cancel operations for a specific job.
  */
 declare abstract class AiSearchJob {
   /** Get metadata about this job. */
   info(): Promise<AiSearchJobInfo>;
   /** Get logs for this job. */
   logs(params?: AiSearchJobLogsParams): Promise<AiSearchJobLogsResponse>;
+  /**
+   * Cancel a running job.
+   * @returns The updated job info.
+   * @throws AiSearchNotFoundError if the job does not exist.
+   */
+  cancel(): Promise<AiSearchJobInfo>;
 }
 /**
  * Jobs collection service for an AI Search instance.
@@ -4304,7 +4642,7 @@ declare abstract class AiSearchJobs {
   /**
    * Get a job by ID.
    * @param jobId The job identifier.
-   * @returns Job service for info and logs operations.
+   * @returns Job service for info, logs, and cancel operations.
    */
   get(jobId: string): AiSearchJob;
 }
@@ -4323,7 +4661,7 @@ declare abstract class AiSearchJobs {
  * // Via namespace binding
  * const instance = env.AI_SEARCH.get("blog");
  * const results = await instance.search({
- *   messages: [{ role: "user", content: "How does caching work?" }],
+ *   query: "How does caching work?",
  * });
  *
  * // Via single instance binding
@@ -4335,7 +4673,7 @@ declare abstract class AiSearchJobs {
 declare abstract class AiSearchInstance {
   /**
    * Search the AI Search instance for relevant chunks.
-   * @param params Search request with messages and optional AI search options.
+   * @param params Search request with query or messages and optional AI search options.
    * @returns Search response with matching chunks and search query.
    */
   search(params: AiSearchSearchRequest): Promise<AiSearchSearchResponse>;
@@ -4367,7 +4705,7 @@ declare abstract class AiSearchInstance {
   info(): Promise<AiSearchInstanceInfo>;
   /**
    * Get instance statistics (item count, indexing status, etc.).
-   * @returns Statistics with counts per status and last activity time.
+   * @returns Statistics with counts per status, last activity time, and engine details.
    */
   stats(): Promise<AiSearchStatsResponse>;
   /** Items collection — list, upload, and manage items in this instance. */
@@ -4379,27 +4717,30 @@ declare abstract class AiSearchInstance {
  * Namespace-level AI Search service.
  *
  * Used as the type of `env.AI_SEARCH` (namespace binding via `ai_search_namespaces`).
- * Scoped to a single namespace. Provides dynamic instance access, creation, and deletion.
+ * Scoped to a single namespace. Provides dynamic instance access, creation, deletion,
+ * and multi-instance search/chat operations.
  *
  * @example
  * ```ts
  * // Access an instance within the namespace
  * const blog = env.AI_SEARCH.get("blog");
- * const results = await blog.search({
- *   messages: [{ role: "user", content: "How does caching work?" }],
- * });
+ * const results = await blog.search({ query: "How does caching work?" });
  *
  * // List all instances in the namespace
  * const instances = await env.AI_SEARCH.list();
  *
  * // Create a new instance with built-in storage
- * const tenant = await env.AI_SEARCH.create({
- *   id: "tenant-123",
- * });
+ * const tenant = await env.AI_SEARCH.create({ id: "tenant-123" });
  *
  * // Upload items into the instance
  * await tenant.items.upload("doc.pdf", fileContent);
  *
+ * // Search across multiple instances
+ * const multi = await env.AI_SEARCH.search({
+ *   query: "caching",
+ *   ai_search_options: { instance_ids: ["blog", "docs"] },
+ * });
+ *
  * // Delete an instance
  * await env.AI_SEARCH.delete("tenant-123");
  * ```
@@ -4412,10 +4753,11 @@ declare abstract class AiSearchNamespace {
    */
   get(name: string): AiSearchInstance;
   /**
-   * List all instances in the bound namespace.
-   * @returns Array of instance metadata.
+   * List instances in the bound namespace.
+   * @param params Optional pagination, search, and ordering parameters.
+   * @returns Array of instance metadata with pagination info.
    */
-  list(): Promise<AiSearchListResponse>;
+  list(params?: AiSearchListInstancesParams): Promise<AiSearchListResponse>;
   /**
    * Create a new instance within the bound namespace.
    * @param config Instance configuration. Only `id` is required — omit `type` and `source` to create with built-in storage.
@@ -4440,6 +4782,35 @@ declare abstract class AiSearchNamespace {
    * @param name Instance name to delete.
    */
   delete(name: string): Promise<void>;
+  /**
+   * Search across multiple instances within the bound namespace.
+   * Fans out to the specified instance_ids and merges results.
+   * @param params Search request with required `ai_search_options.instance_ids`.
+   * @returns Search response with chunks tagged by instance_id and optional partial-failure errors.
+   */
+  search(
+    params: AiSearchMultiSearchRequest,
+  ): Promise<AiSearchMultiSearchResponse>;
+  /**
+   * Generate chat completions across multiple instances within the bound namespace (streaming).
+   * Fans out to the specified instance_ids, merges context, and generates a response.
+   * @param params Chat completions request with stream: true and required `ai_search_options.instance_ids`.
+   * @returns ReadableStream of server-sent events.
+   */
+  chatCompletions(
+    params: AiSearchMultiChatCompletionsRequest & {
+      stream: true;
+    },
+  ): Promise<ReadableStream>;
+  /**
+   * Generate chat completions across multiple instances within the bound namespace.
+   * Fans out to the specified instance_ids, merges context, and generates a response.
+   * @param params Chat completions request with required `ai_search_options.instance_ids`.
+   * @returns Chat completion response with choices, chunks tagged by instance_id, and optional partial-failure errors.
+   */
+  chatCompletions(
+    params: AiSearchMultiChatCompletionsRequest,
+  ): Promise<AiSearchMultiChatCompletionsResponse>;
 }
 type AiImageClassificationInput = {
   image: number[];
@@ -12091,8 +12462,8 @@ declare module "cloudflare:email" {
  * Evaluation context for targeting rules.
  * Keys are attribute names (e.g. "userId", "country"), values are the attribute values.
  */
-type EvaluationContext = Record<string, string | number | boolean>;
-interface EvaluationDetails<T> {
+type FlagshipEvaluationContext = Record<string, string | number | boolean>;
+interface FlagshipEvaluationDetails<T> {
   flagKey: string;
   value: T;
   variant?: string | undefined;
@@ -12100,7 +12471,7 @@ interface EvaluationDetails<T> {
   errorCode?: string | undefined;
   errorMessage?: string | undefined;
 }
-interface FlagEvaluationError extends Error {}
+interface FlagshipEvaluationError extends Error {}
 /**
  * Feature flags binding for evaluating feature flags from a Cloudflare Workers script.
  *
@@ -12120,7 +12491,7 @@ interface FlagEvaluationError extends Error {}
  * console.log(details.variant, details.reason);
  * ```
  */
-declare abstract class Flags {
+declare abstract class Flagship {
   /**
    * Get a flag value without type checking.
    * @param flagKey The key of the flag to evaluate.
@@ -12130,7 +12501,7 @@ declare abstract class Flags {
   get(
     flagKey: string,
     defaultValue?: unknown,
-    context?: EvaluationContext,
+    context?: FlagshipEvaluationContext,
   ): Promise<unknown>;
   /**
    * Get a boolean flag value.
@@ -12141,7 +12512,7 @@ declare abstract class Flags {
   getBooleanValue(
     flagKey: string,
     defaultValue: boolean,
-    context?: EvaluationContext,
+    context?: FlagshipEvaluationContext,
   ): Promise<boolean>;
   /**
    * Get a string flag value.
@@ -12152,7 +12523,7 @@ declare abstract class Flags {
   getStringValue(
     flagKey: string,
     defaultValue: string,
-    context?: EvaluationContext,
+    context?: FlagshipEvaluationContext,
   ): Promise<string>;
   /**
    * Get a number flag value.
@@ -12163,7 +12534,7 @@ declare abstract class Flags {
   getNumberValue(
     flagKey: string,
     defaultValue: number,
-    context?: EvaluationContext,
+    context?: FlagshipEvaluationContext,
   ): Promise<number>;
   /**
    * Get an object flag value.
@@ -12174,7 +12545,7 @@ declare abstract class Flags {
   getObjectValue<T extends object>(
     flagKey: string,
     defaultValue: T,
-    context?: EvaluationContext,
+    context?: FlagshipEvaluationContext,
   ): Promise<T>;
   /**
    * Get a boolean flag value with full evaluation details.
@@ -12185,8 +12556,8 @@ declare abstract class Flags {
   getBooleanDetails(
     flagKey: string,
     defaultValue: boolean,
-    context?: EvaluationContext,
-  ): Promise<EvaluationDetails<boolean>>;
+    context?: FlagshipEvaluationContext,
+  ): Promise<FlagshipEvaluationDetails<boolean>>;
   /**
    * Get a string flag value with full evaluation details.
    * @param flagKey The key of the flag to evaluate.
@@ -12196,8 +12567,8 @@ declare abstract class Flags {
   getStringDetails(
     flagKey: string,
     defaultValue: string,
-    context?: EvaluationContext,
-  ): Promise<EvaluationDetails<string>>;
+    context?: FlagshipEvaluationContext,
+  ): Promise<FlagshipEvaluationDetails<string>>;
   /**
    * Get a number flag value with full evaluation details.
    * @param flagKey The key of the flag to evaluate.
@@ -12207,8 +12578,8 @@ declare abstract class Flags {
   getNumberDetails(
     flagKey: string,
     defaultValue: number,
-    context?: EvaluationContext,
-  ): Promise<EvaluationDetails<number>>;
+    context?: FlagshipEvaluationContext,
+  ): Promise<FlagshipEvaluationDetails<number>>;
   /**
    * Get an object flag value with full evaluation details.
    * @param flagKey The key of the flag to evaluate.
@@ -12218,8 +12589,8 @@ declare abstract class Flags {
   getObjectDetails<T extends object>(
     flagKey: string,
     defaultValue: T,
-    context?: EvaluationContext,
-  ): Promise<EvaluationDetails<T>>;
+    context?: FlagshipEvaluationContext,
+  ): Promise<FlagshipEvaluationDetails<T>>;
 }
 /**
  * Hello World binding to serve as an explanatory example. DO NOT USE