cloudflare 5.2.0 → 6.0.0-beta.2

package/src/resources/workers/scripts/versions.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../resource';
+import { isRequestOptions } from '../../../core';
 import * as Core from '../../../core';
 import { V4PagePagination, type V4PagePaginationParams } from '../../../pagination';
 
@@ -27,11 +28,16 @@ export class Versions extends APIResource {
     params: VersionCreateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<VersionCreateResponse> {
-    const { account_id, ...body } = params;
+    const { account_id = this._client.accountId, bindings_inherit, ...body } = params;
     return (
       this._client.post(
         `/accounts/${account_id}/workers/scripts/${scriptName}/versions`,
-        Core.multipartFormRequestOptions({ body, ...options, __multipartSyntax: 'json' }),
+        Core.multipartFormRequestOptions({
+          query: { bindings_inherit },
+          body,
+          ...options,
+          __multipartSyntax: 'json',
+        }),
       ) as Core.APIPromise<{ result: VersionCreateResponse }>
     )._thenUnwrap((obj) => obj.result);
   }
@@ -52,10 +58,22 @@ export class Versions extends APIResource {
    */
   list(
     scriptName: string,
-    params: VersionListParams,
+    params?: VersionListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<VersionListResponsesV4PagePagination, VersionListResponse>;
+  list(
+    scriptName: string,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<VersionListResponsesV4PagePagination, VersionListResponse>;
+  list(
+    scriptName: string,
+    params: VersionListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.PagePromise<VersionListResponsesV4PagePagination, VersionListResponse> {
-    const { account_id, ...query } = params;
+    if (isRequestOptions(params)) {
+      return this.list(scriptName, {}, params);
+    }
+    const { account_id = this._client.accountId, ...query } = params;
     return this._client.getAPIList(
       `/accounts/${account_id}/workers/scripts/${scriptName}/versions`,
       VersionListResponsesV4PagePagination,
@@ -64,7 +82,7 @@ export class Versions extends APIResource {
   }
 
   /**
-   * Get Version Detail
+   * Retrieves detailed information about a specific version of a Workers script.
    *
    * @example
    * ```ts
@@ -78,10 +96,24 @@ export class Versions extends APIResource {
   get(
     scriptName: string,
     versionId: string,
-    params: VersionGetParams,
+    params?: VersionGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<VersionGetResponse>;
+  get(
+    scriptName: string,
+    versionId: string,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<VersionGetResponse>;
+  get(
+    scriptName: string,
+    versionId: string,
+    params: VersionGetParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<VersionGetResponse> {
-    const { account_id } = params;
+    if (isRequestOptions(params)) {
+      return this.get(scriptName, versionId, {}, params);
+    }
+    const { account_id = this._client.accountId } = params;
     return (
       this._client.get(
         `/accounts/${account_id}/workers/scripts/${scriptName}/versions/${versionId}`,
@@ -96,12 +128,22 @@ export class VersionListResponsesV4PagePagination extends V4PagePagination<Versi
 export interface VersionCreateResponse {
   resources: VersionCreateResponse.Resources;
 
+  /**
+   * Unique identifier for the version.
+   */
   id?: string;
 
   metadata?: VersionCreateResponse.Metadata;
 
+  /**
+   * Sequential version number.
+   */
   number?: number;
 
+  /**
+   * Time in milliseconds spent on
+   * [Worker startup](https://developers.cloudflare.com/workers/platform/limits/#worker-startup-time).
+   */
   startup_time_ms?: number;
 }
 
@@ -114,6 +156,8 @@ export namespace VersionCreateResponse {
      */
     bindings?: Array<
       | Resources.WorkersBindingKindAI
+      | Resources.WorkersBindingKindAISearch
+      | Resources.WorkersBindingKindAISearchNamespace
       | Resources.WorkersBindingKindAnalyticsEngine
       | Resources.WorkersBindingKindAssets
       | Resources.WorkersBindingKindBrowser
@@ -126,26 +170,33 @@ export namespace VersionCreateResponse {
       | Resources.WorkersBindingKindImages
       | Resources.WorkersBindingKindJson
       | Resources.WorkersBindingKindKVNamespace
+      | Resources.WorkersBindingKindMedia
       | Resources.WorkersBindingKindMTLSCertificate
       | Resources.WorkersBindingKindPlainText
       | Resources.WorkersBindingKindPipelines
       | Resources.WorkersBindingKindQueue
+      | Resources.WorkersBindingKindRatelimit
       | Resources.WorkersBindingKindR2Bucket
       | Resources.WorkersBindingKindSecretText
       | Resources.WorkersBindingKindSendEmail
       | Resources.WorkersBindingKindService
-      | Resources.WorkersBindingKindTailConsumer
       | Resources.WorkersBindingKindTextBlob
       | Resources.WorkersBindingKindVectorize
       | Resources.WorkersBindingKindVersionMetadata
       | Resources.WorkersBindingKindSecretsStoreSecret
+      | Resources.WorkersBindingKindFlagship
       | Resources.WorkersBindingKindSecretKey
       | Resources.WorkersBindingKindWorkflow
       | Resources.WorkersBindingKindWasmModule
+      | Resources.WorkersBindingKindVPCService
+      | Resources.WorkersBindingKindVPCNetwork
     >;
 
     script?: Resources.Script;
 
+    /**
+     * Runtime configuration for the Worker.
+     */
     script_runtime?: Resources.ScriptRuntime;
   }
 
@@ -162,6 +213,50 @@ export namespace VersionCreateResponse {
       type: 'ai';
     }
 
+    export interface WorkersBindingKindAISearch {
+      /**
+       * The user-chosen instance name. Must exist at deploy time. The worker can search,
+       * chat, update, and manage items/jobs on this instance.
+       */
+      instance_name: string;
+
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'ai_search';
+
+      /**
+       * The namespace the instance belongs to. Defaults to "default" if omitted.
+       * Customers who don't use namespaces can simply omit this field.
+       */
+      namespace?: string;
+    }
+
+    export interface WorkersBindingKindAISearchNamespace {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The user-chosen namespace name. Must exist before deploy -- Wrangler handles
+       * auto-creation on deploy failure (R2 bucket pattern). The "default" namespace is
+       * auto-created by config-api for new accounts. Grants full access (CRUD + search +
+       * chat) to all instances within the namespace.
+       */
+      namespace: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'ai_search_namespace';
+    }
+
     export interface WorkersBindingKindAnalyticsEngine {
       /**
        * The name of the dataset to bind to.
@@ -207,7 +302,7 @@ export namespace VersionCreateResponse {
       /**
        * Identifier of the D1 database to bind to.
        */
-      id: string;
+      database_id: string;
 
       /**
        * A JavaScript variable name for the binding.
@@ -218,6 +313,11 @@ export namespace VersionCreateResponse {
        * The kind of resource that the binding provides.
        */
       type: 'd1';
+
+      /**
+       * @deprecated This property has been renamed to `database_id`.
+       */
+      id?: string;
     }
 
     export interface WorkersBindingKindDataBlob {
@@ -245,7 +345,7 @@ export namespace VersionCreateResponse {
       name: string;
 
       /**
-       * Namespace to bind to.
+       * The name of the dispatch namespace.
        */
       namespace: string;
 
@@ -269,7 +369,7 @@ export namespace VersionCreateResponse {
          * Pass information from the Dispatch Worker to the Outbound Worker through the
          * parameters.
          */
-        params?: Array<string>;
+        params?: Array<Outbound.Param>;
 
         /**
          * Outbound worker.
@@ -278,10 +378,22 @@ export namespace VersionCreateResponse {
       }
 
       export namespace Outbound {
+        export interface Param {
+          /**
+           * Name of the parameter.
+           */
+          name: string;
+        }
+
         /**
          * Outbound worker.
          */
         export interface Worker {
+          /**
+           * Entrypoint to invoke on the outbound worker.
+           */
+          entrypoint?: string;
+
           /**
            * Environment of the outbound worker.
            */
@@ -311,6 +423,11 @@ export namespace VersionCreateResponse {
        */
       class_name?: string;
 
+      /**
+       * The dispatch namespace the Durable Object script belongs to.
+       */
+      dispatch_namespace?: string;
+
       /**
        * The environment of the script_name to bind to.
        */
@@ -387,7 +504,7 @@ export namespace VersionCreateResponse {
       /**
        * JSON data to use.
        */
-      json: string;
+      json: unknown;
 
       /**
        * A JavaScript variable name for the binding.
@@ -417,6 +534,18 @@ export namespace VersionCreateResponse {
       type: 'kv_namespace';
     }
 
+    export interface WorkersBindingKindMedia {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'media';
+    }
+
     export interface WorkersBindingKindMTLSCertificate {
       /**
        * Identifier of the certificate to bind to.
@@ -485,6 +614,45 @@ export namespace VersionCreateResponse {
       type: 'queue';
     }
 
+    export interface WorkersBindingKindRatelimit {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * Identifier of the rate limit namespace to bind to.
+       */
+      namespace_id: string;
+
+      /**
+       * The rate limit configuration.
+       */
+      simple: WorkersBindingKindRatelimit.Simple;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'ratelimit';
+    }
+
+    export namespace WorkersBindingKindRatelimit {
+      /**
+       * The rate limit configuration.
+       */
+      export interface Simple {
+        /**
+         * The limit (requests per period).
+         */
+        limit: number;
+
+        /**
+         * The period in seconds.
+         */
+        period: number;
+      }
+    }
+
     export interface WorkersBindingKindR2Bucket {
       /**
        * R2 bucket to bind to.
@@ -506,7 +674,7 @@ export namespace VersionCreateResponse {
        * [jurisdiction](https://developers.cloudflare.com/r2/reference/data-location/#jurisdictional-restrictions)
        * of the R2 bucket.
        */
-      jurisdiction?: 'eu' | 'fedramp';
+      jurisdiction?: 'eu' | 'fedramp' | 'fedramp-high';
     }
 
     export interface WorkersBindingKindSecretText {
@@ -565,26 +733,14 @@ export namespace VersionCreateResponse {
       type: 'service';
 
       /**
-       * Optional environment if the Worker utilizes one.
-       */
-      environment?: string;
-    }
-
-    export interface WorkersBindingKindTailConsumer {
-      /**
-       * A JavaScript variable name for the binding.
-       */
-      name: string;
-
-      /**
-       * Name of Tail Worker to bind to.
+       * Entrypoint to invoke on the target Worker.
        */
-      service: string;
+      entrypoint?: string;
 
       /**
-       * The kind of resource that the binding provides.
+       * Optional environment if the Worker utilizes one.
        */
-      type: 'tail_consumer';
+      environment?: string;
     }
 
     export interface WorkersBindingKindTextBlob {
@@ -656,6 +812,23 @@ export namespace VersionCreateResponse {
       type: 'secrets_store_secret';
     }
 
+    export interface WorkersBindingKindFlagship {
+      /**
+       * ID of the Flagship app to bind to for feature flag evaluation.
+       */
+      app_id: string;
+
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'flagship';
+    }
+
     export interface WorkersBindingKindSecretKey {
       /**
        * Algorithm-specific key parameters.
@@ -735,54 +908,157 @@ export namespace VersionCreateResponse {
       type: 'wasm_module';
     }
 
+    export interface WorkersBindingKindVPCService {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * Identifier of the VPC service to bind to.
+       */
+      service_id: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'vpc_service';
+    }
+
+    export interface WorkersBindingKindVPCNetwork {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'vpc_network';
+
+      /**
+       * Identifier of the network to bind to. Only "cf1:network" is currently supported.
+       * Mutually exclusive with tunnel_id.
+       */
+      network_id?: string;
+
+      /**
+       * UUID of the Cloudflare Tunnel to bind to. Mutually exclusive with network_id.
+       */
+      tunnel_id?: string;
+    }
+
     export interface Script {
+      /**
+       * Hashed script content
+       */
       etag?: string;
 
+      /**
+       * The names of handlers exported as part of the default export.
+       */
       handlers?: Array<string>;
 
+      /**
+       * The client most recently used to deploy this Worker.
+       */
       last_deployed_from?: string;
 
+      /**
+       * Named exports, such as Durable Object class implementations and named
+       * entrypoints.
+       */
       named_handlers?: Array<Script.NamedHandler>;
     }
 
     export namespace Script {
       export interface NamedHandler {
+        /**
+         * The names of handlers exported as part of the named export.
+         */
         handlers?: Array<string>;
 
+        /**
+         * The name of the exported class or entrypoint.
+         */
         name?: string;
       }
     }
 
+    /**
+     * Runtime configuration for the Worker.
+     */
     export interface ScriptRuntime {
+      /**
+       * Date indicating targeted support in the Workers runtime. Backwards incompatible
+       * fixes to the runtime following this date will not affect this Worker.
+       */
       compatibility_date?: string;
 
+      /**
+       * Flags that enable or disable certain features in the Workers runtime.
+       */
       compatibility_flags?: Array<string>;
 
+      /**
+       * Resource limits for the Worker.
+       */
       limits?: ScriptRuntime.Limits;
 
+      /**
+       * The tag of the Durable Object migration that was most recently applied for this
+       * Worker.
+       */
       migration_tag?: string;
 
+      /**
+       * Usage model for the Worker invocations.
+       */
       usage_model?: 'bundled' | 'unbound' | 'standard';
     }
 
     export namespace ScriptRuntime {
+      /**
+       * Resource limits for the Worker.
+       */
       export interface Limits {
+        /**
+         * The amount of CPU time this Worker can use in milliseconds.
+         */
         cpu_ms?: number;
       }
     }
   }
 
   export interface Metadata {
+    /**
+     * Email of the user who created the version.
+     */
     author_email?: string;
 
+    /**
+     * Identifier of the user who created the version.
+     */
     author_id?: string;
 
+    /**
+     * When the version was created.
+     */
     created_on?: string;
 
+    /**
+     * Whether the version can be previewed.
+     */
     hasPreview?: boolean;
 
+    /**
+     * When the version was last modified.
+     */
     modified_on?: string;
 
+    /**
+     * The source of the version upload.
+     */
     source?:
       | 'unknown'
       | 'api'
@@ -798,25 +1074,49 @@ export namespace VersionCreateResponse {
 }
 
 export interface VersionListResponse {
+  /**
+   * Unique identifier for the version.
+   */
   id?: string;
 
   metadata?: VersionListResponse.Metadata;
 
+  /**
+   * Sequential version number.
+   */
   number?: number;
 }
 
 export namespace VersionListResponse {
   export interface Metadata {
+    /**
+     * Email of the user who created the version.
+     */
     author_email?: string;
 
+    /**
+     * Identifier of the user who created the version.
+     */
     author_id?: string;
 
+    /**
+     * When the version was created.
+     */
     created_on?: string;
 
+    /**
+     * Whether the version can be previewed.
+     */
     hasPreview?: boolean;
 
+    /**
+     * When the version was last modified.
+     */
     modified_on?: string;
 
+    /**
+     * The source of the version upload.
+     */
     source?:
       | 'unknown'
       | 'api'
@@ -834,10 +1134,16 @@ export namespace VersionListResponse {
 export interface VersionGetResponse {
   resources: VersionGetResponse.Resources;
 
+  /**
+   * Unique identifier for the version.
+   */
   id?: string;
 
   metadata?: VersionGetResponse.Metadata;
 
+  /**
+   * Sequential version number.
+   */
   number?: number;
 }
 
@@ -850,6 +1156,8 @@ export namespace VersionGetResponse {
      */
     bindings?: Array<
       | Resources.WorkersBindingKindAI
+      | Resources.WorkersBindingKindAISearch
+      | Resources.WorkersBindingKindAISearchNamespace
       | Resources.WorkersBindingKindAnalyticsEngine
       | Resources.WorkersBindingKindAssets
       | Resources.WorkersBindingKindBrowser
@@ -862,26 +1170,33 @@ export namespace VersionGetResponse {
       | Resources.WorkersBindingKindImages
       | Resources.WorkersBindingKindJson
       | Resources.WorkersBindingKindKVNamespace
+      | Resources.WorkersBindingKindMedia
       | Resources.WorkersBindingKindMTLSCertificate
       | Resources.WorkersBindingKindPlainText
       | Resources.WorkersBindingKindPipelines
       | Resources.WorkersBindingKindQueue
+      | Resources.WorkersBindingKindRatelimit
       | Resources.WorkersBindingKindR2Bucket
       | Resources.WorkersBindingKindSecretText
       | Resources.WorkersBindingKindSendEmail
       | Resources.WorkersBindingKindService
-      | Resources.WorkersBindingKindTailConsumer
       | Resources.WorkersBindingKindTextBlob
       | Resources.WorkersBindingKindVectorize
       | Resources.WorkersBindingKindVersionMetadata
       | Resources.WorkersBindingKindSecretsStoreSecret
+      | Resources.WorkersBindingKindFlagship
       | Resources.WorkersBindingKindSecretKey
       | Resources.WorkersBindingKindWorkflow
       | Resources.WorkersBindingKindWasmModule
+      | Resources.WorkersBindingKindVPCService
+      | Resources.WorkersBindingKindVPCNetwork
     >;
 
     script?: Resources.Script;
 
+    /**
+     * Runtime configuration for the Worker.
+     */
     script_runtime?: Resources.ScriptRuntime;
   }
 
@@ -898,6 +1213,50 @@ export namespace VersionGetResponse {
       type: 'ai';
     }
 
+    export interface WorkersBindingKindAISearch {
+      /**
+       * The user-chosen instance name. Must exist at deploy time. The worker can search,
+       * chat, update, and manage items/jobs on this instance.
+       */
+      instance_name: string;
+
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'ai_search';
+
+      /**
+       * The namespace the instance belongs to. Defaults to "default" if omitted.
+       * Customers who don't use namespaces can simply omit this field.
+       */
+      namespace?: string;
+    }
+
+    export interface WorkersBindingKindAISearchNamespace {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The user-chosen namespace name. Must exist before deploy -- Wrangler handles
+       * auto-creation on deploy failure (R2 bucket pattern). The "default" namespace is
+       * auto-created by config-api for new accounts. Grants full access (CRUD + search +
+       * chat) to all instances within the namespace.
+       */
+      namespace: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'ai_search_namespace';
+    }
+
     export interface WorkersBindingKindAnalyticsEngine {
       /**
        * The name of the dataset to bind to.
@@ -943,7 +1302,7 @@ export namespace VersionGetResponse {
       /**
        * Identifier of the D1 database to bind to.
        */
-      id: string;
+      database_id: string;
 
       /**
        * A JavaScript variable name for the binding.
@@ -954,6 +1313,11 @@ export namespace VersionGetResponse {
        * The kind of resource that the binding provides.
        */
       type: 'd1';
+
+      /**
+       * @deprecated This property has been renamed to `database_id`.
+       */
+      id?: string;
     }
 
     export interface WorkersBindingKindDataBlob {
@@ -981,7 +1345,7 @@ export namespace VersionGetResponse {
       name: string;
 
       /**
-       * Namespace to bind to.
+       * The name of the dispatch namespace.
        */
       namespace: string;
 
@@ -1005,7 +1369,7 @@ export namespace VersionGetResponse {
          * Pass information from the Dispatch Worker to the Outbound Worker through the
          * parameters.
          */
-        params?: Array<string>;
+        params?: Array<Outbound.Param>;
 
         /**
          * Outbound worker.
@@ -1014,10 +1378,22 @@ export namespace VersionGetResponse {
       }
 
       export namespace Outbound {
+        export interface Param {
+          /**
+           * Name of the parameter.
+           */
+          name: string;
+        }
+
         /**
          * Outbound worker.
          */
         export interface Worker {
+          /**
+           * Entrypoint to invoke on the outbound worker.
+           */
+          entrypoint?: string;
+
           /**
            * Environment of the outbound worker.
            */
@@ -1047,6 +1423,11 @@ export namespace VersionGetResponse {
        */
       class_name?: string;
 
+      /**
+       * The dispatch namespace the Durable Object script belongs to.
+       */
+      dispatch_namespace?: string;
+
       /**
        * The environment of the script_name to bind to.
        */
@@ -1123,7 +1504,7 @@ export namespace VersionGetResponse {
       /**
        * JSON data to use.
        */
-      json: string;
+      json: unknown;
 
       /**
        * A JavaScript variable name for the binding.
@@ -1153,6 +1534,18 @@ export namespace VersionGetResponse {
       type: 'kv_namespace';
     }
 
+    export interface WorkersBindingKindMedia {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'media';
+    }
+
     export interface WorkersBindingKindMTLSCertificate {
       /**
        * Identifier of the certificate to bind to.
@@ -1206,19 +1599,58 @@ export namespace VersionGetResponse {
 
     export interface WorkersBindingKindQueue {
       /**
-       * A JavaScript variable name for the binding.
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * Name of the Queue to bind to.
+       */
+      queue_name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'queue';
+    }
+
+    export interface WorkersBindingKindRatelimit {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * Identifier of the rate limit namespace to bind to.
+       */
+      namespace_id: string;
+
+      /**
+       * The rate limit configuration.
        */
-      name: string;
+      simple: WorkersBindingKindRatelimit.Simple;
 
       /**
-       * Name of the Queue to bind to.
+       * The kind of resource that the binding provides.
        */
-      queue_name: string;
+      type: 'ratelimit';
+    }
 
+    export namespace WorkersBindingKindRatelimit {
       /**
-       * The kind of resource that the binding provides.
+       * The rate limit configuration.
        */
-      type: 'queue';
+      export interface Simple {
+        /**
+         * The limit (requests per period).
+         */
+        limit: number;
+
+        /**
+         * The period in seconds.
+         */
+        period: number;
+      }
     }
 
     export interface WorkersBindingKindR2Bucket {
@@ -1242,7 +1674,7 @@ export namespace VersionGetResponse {
        * [jurisdiction](https://developers.cloudflare.com/r2/reference/data-location/#jurisdictional-restrictions)
        * of the R2 bucket.
        */
-      jurisdiction?: 'eu' | 'fedramp';
+      jurisdiction?: 'eu' | 'fedramp' | 'fedramp-high';
     }
 
     export interface WorkersBindingKindSecretText {
@@ -1301,26 +1733,14 @@ export namespace VersionGetResponse {
       type: 'service';
 
       /**
-       * Optional environment if the Worker utilizes one.
-       */
-      environment?: string;
-    }
-
-    export interface WorkersBindingKindTailConsumer {
-      /**
-       * A JavaScript variable name for the binding.
-       */
-      name: string;
-
-      /**
-       * Name of Tail Worker to bind to.
+       * Entrypoint to invoke on the target Worker.
        */
-      service: string;
+      entrypoint?: string;
 
       /**
-       * The kind of resource that the binding provides.
+       * Optional environment if the Worker utilizes one.
        */
-      type: 'tail_consumer';
+      environment?: string;
     }
 
     export interface WorkersBindingKindTextBlob {
@@ -1392,6 +1812,23 @@ export namespace VersionGetResponse {
       type: 'secrets_store_secret';
     }
 
+    export interface WorkersBindingKindFlagship {
+      /**
+       * ID of the Flagship app to bind to for feature flag evaluation.
+       */
+      app_id: string;
+
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'flagship';
+    }
+
     export interface WorkersBindingKindSecretKey {
       /**
        * Algorithm-specific key parameters.
@@ -1471,54 +1908,157 @@ export namespace VersionGetResponse {
       type: 'wasm_module';
     }
 
+    export interface WorkersBindingKindVPCService {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * Identifier of the VPC service to bind to.
+       */
+      service_id: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'vpc_service';
+    }
+
+    export interface WorkersBindingKindVPCNetwork {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'vpc_network';
+
+      /**
+       * Identifier of the network to bind to. Only "cf1:network" is currently supported.
+       * Mutually exclusive with tunnel_id.
+       */
+      network_id?: string;
+
+      /**
+       * UUID of the Cloudflare Tunnel to bind to. Mutually exclusive with network_id.
+       */
+      tunnel_id?: string;
+    }
+
     export interface Script {
+      /**
+       * Hashed script content
+       */
       etag?: string;
 
+      /**
+       * The names of handlers exported as part of the default export.
+       */
       handlers?: Array<string>;
 
+      /**
+       * The client most recently used to deploy this Worker.
+       */
       last_deployed_from?: string;
 
+      /**
+       * Named exports, such as Durable Object class implementations and named
+       * entrypoints.
+       */
       named_handlers?: Array<Script.NamedHandler>;
     }
 
     export namespace Script {
       export interface NamedHandler {
+        /**
+         * The names of handlers exported as part of the named export.
+         */
         handlers?: Array<string>;
 
+        /**
+         * The name of the exported class or entrypoint.
+         */
         name?: string;
       }
     }
 
+    /**
+     * Runtime configuration for the Worker.
+     */
     export interface ScriptRuntime {
+      /**
+       * Date indicating targeted support in the Workers runtime. Backwards incompatible
+       * fixes to the runtime following this date will not affect this Worker.
+       */
       compatibility_date?: string;
 
+      /**
+       * Flags that enable or disable certain features in the Workers runtime.
+       */
       compatibility_flags?: Array<string>;
 
+      /**
+       * Resource limits for the Worker.
+       */
       limits?: ScriptRuntime.Limits;
 
+      /**
+       * The tag of the Durable Object migration that was most recently applied for this
+       * Worker.
+       */
       migration_tag?: string;
 
+      /**
+       * Usage model for the Worker invocations.
+       */
       usage_model?: 'bundled' | 'unbound' | 'standard';
     }
 
     export namespace ScriptRuntime {
+      /**
+       * Resource limits for the Worker.
+       */
       export interface Limits {
+        /**
+         * The amount of CPU time this Worker can use in milliseconds.
+         */
         cpu_ms?: number;
       }
     }
   }
 
   export interface Metadata {
+    /**
+     * Email of the user who created the version.
+     */
     author_email?: string;
 
+    /**
+     * Identifier of the user who created the version.
+     */
     author_id?: string;
 
+    /**
+     * When the version was created.
+     */
     created_on?: string;
 
+    /**
+     * Whether the version can be previewed.
+     */
     hasPreview?: boolean;
 
+    /**
+     * When the version was last modified.
+     */
     modified_on?: string;
 
+    /**
+     * The source of the version upload.
+     */
     source?:
       | 'unknown'
       | 'api'
@@ -1537,7 +2077,7 @@ export interface VersionCreateParams {
   /**
    * Path param: Identifier.
    */
-  account_id: string;
+  account_id?: string;
 
   /**
    * Body param: JSON-encoded metadata about the uploaded parts and Worker
@@ -1545,6 +2085,13 @@ export interface VersionCreateParams {
    */
   metadata: VersionCreateParams.Metadata;
 
+  /**
+   * Query param: When set to "strict", the upload will fail if any `inherit` type
+   * bindings cannot be resolved against the previous version of the Worker. Without
+   * this, unresolvable inherit bindings are silently dropped.
+   */
+  bindings_inherit?: 'strict';
+
   /**
    * Body param: An array of modules (often JavaScript files) comprising a Worker
    * script. At least one module must be present and referenced in the metadata as
@@ -1578,6 +2125,8 @@ export namespace VersionCreateParams {
      */
     bindings?: Array<
       | Metadata.WorkersBindingKindAI
+      | Metadata.WorkersBindingKindAISearch
+      | Metadata.WorkersBindingKindAISearchNamespace
       | Metadata.WorkersBindingKindAnalyticsEngine
       | Metadata.WorkersBindingKindAssets
       | Metadata.WorkersBindingKindBrowser
@@ -1590,22 +2139,26 @@ export namespace VersionCreateParams {
       | Metadata.WorkersBindingKindImages
       | Metadata.WorkersBindingKindJson
       | Metadata.WorkersBindingKindKVNamespace
+      | Metadata.WorkersBindingKindMedia
       | Metadata.WorkersBindingKindMTLSCertificate
       | Metadata.WorkersBindingKindPlainText
       | Metadata.WorkersBindingKindPipelines
       | Metadata.WorkersBindingKindQueue
+      | Metadata.WorkersBindingKindRatelimit
       | Metadata.WorkersBindingKindR2Bucket
       | Metadata.WorkersBindingKindSecretText
       | Metadata.WorkersBindingKindSendEmail
       | Metadata.WorkersBindingKindService
-      | Metadata.WorkersBindingKindTailConsumer
       | Metadata.WorkersBindingKindTextBlob
       | Metadata.WorkersBindingKindVectorize
       | Metadata.WorkersBindingKindVersionMetadata
       | Metadata.WorkersBindingKindSecretsStoreSecret
+      | Metadata.WorkersBindingKindFlagship
       | Metadata.WorkersBindingKindSecretKey
       | Metadata.WorkersBindingKindWorkflow
       | Metadata.WorkersBindingKindWasmModule
+      | Metadata.WorkersBindingKindVPCService
+      | Metadata.WorkersBindingKindVPCNetwork
     >;
 
     /**
@@ -1635,12 +2188,17 @@ export namespace VersionCreateParams {
   export namespace Metadata {
     export interface Annotations {
       /**
-       * Human-readable message about the version. Truncated to 100 bytes.
+       * Associated alias for a version.
+       */
+      'workers/alias'?: string;
+
+      /**
+       * Human-readable message about the version. Truncated to 1000 bytes if longer.
        */
       'workers/message'?: string;
 
       /**
-       * User-provided identifier for the version.
+       * User-provided identifier for the version. Maximum 100 bytes.
        */
       'workers/tag'?: string;
     }
@@ -1657,6 +2215,50 @@ export namespace VersionCreateParams {
       type: 'ai';
     }
 
+    export interface WorkersBindingKindAISearch {
+      /**
+       * The user-chosen instance name. Must exist at deploy time. The worker can search,
+       * chat, update, and manage items/jobs on this instance.
+       */
+      instance_name: string;
+
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'ai_search';
+
+      /**
+       * The namespace the instance belongs to. Defaults to "default" if omitted.
+       * Customers who don't use namespaces can simply omit this field.
+       */
+      namespace?: string;
+    }
+
+    export interface WorkersBindingKindAISearchNamespace {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The user-chosen namespace name. Must exist before deploy -- Wrangler handles
+       * auto-creation on deploy failure (R2 bucket pattern). The "default" namespace is
+       * auto-created by config-api for new accounts. Grants full access (CRUD + search +
+       * chat) to all instances within the namespace.
+       */
+      namespace: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'ai_search_namespace';
+    }
+
     export interface WorkersBindingKindAnalyticsEngine {
       /**
        * The name of the dataset to bind to.
@@ -1702,7 +2304,7 @@ export namespace VersionCreateParams {
       /**
        * Identifier of the D1 database to bind to.
        */
-      id: string;
+      database_id: string;
 
       /**
        * A JavaScript variable name for the binding.
@@ -1713,6 +2315,11 @@ export namespace VersionCreateParams {
        * The kind of resource that the binding provides.
        */
       type: 'd1';
+
+      /**
+       * @deprecated This property has been renamed to `database_id`.
+       */
+      id?: string;
     }
 
     export interface WorkersBindingKindDataBlob {
@@ -1740,7 +2347,7 @@ export namespace VersionCreateParams {
       name: string;
 
       /**
-       * Namespace to bind to.
+       * The name of the dispatch namespace.
        */
       namespace: string;
 
@@ -1764,7 +2371,7 @@ export namespace VersionCreateParams {
          * Pass information from the Dispatch Worker to the Outbound Worker through the
          * parameters.
          */
-        params?: Array<string>;
+        params?: Array<Outbound.Param>;
 
         /**
          * Outbound worker.
@@ -1773,10 +2380,22 @@ export namespace VersionCreateParams {
       }
 
       export namespace Outbound {
+        export interface Param {
+          /**
+           * Name of the parameter.
+           */
+          name: string;
+        }
+
         /**
          * Outbound worker.
          */
         export interface Worker {
+          /**
+           * Entrypoint to invoke on the outbound worker.
+           */
+          entrypoint?: string;
+
           /**
            * Environment of the outbound worker.
            */
@@ -1806,6 +2425,11 @@ export namespace VersionCreateParams {
        */
       class_name?: string;
 
+      /**
+       * The dispatch namespace the Durable Object script belongs to.
+       */
+      dispatch_namespace?: string;
+
       /**
        * The environment of the script_name to bind to.
        */
@@ -1882,7 +2506,7 @@ export namespace VersionCreateParams {
       /**
        * JSON data to use.
        */
-      json: string;
+      json: unknown;
 
       /**
        * A JavaScript variable name for the binding.
@@ -1912,6 +2536,18 @@ export namespace VersionCreateParams {
       type: 'kv_namespace';
     }
 
+    export interface WorkersBindingKindMedia {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'media';
+    }
+
     export interface WorkersBindingKindMTLSCertificate {
       /**
        * Identifier of the certificate to bind to.
@@ -1980,6 +2616,45 @@ export namespace VersionCreateParams {
       type: 'queue';
     }
 
+    export interface WorkersBindingKindRatelimit {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * Identifier of the rate limit namespace to bind to.
+       */
+      namespace_id: string;
+
+      /**
+       * The rate limit configuration.
+       */
+      simple: WorkersBindingKindRatelimit.Simple;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'ratelimit';
+    }
+
+    export namespace WorkersBindingKindRatelimit {
+      /**
+       * The rate limit configuration.
+       */
+      export interface Simple {
+        /**
+         * The limit (requests per period).
+         */
+        limit: number;
+
+        /**
+         * The period in seconds.
+         */
+        period: number;
+      }
+    }
+
     export interface WorkersBindingKindR2Bucket {
       /**
        * R2 bucket to bind to.
@@ -2001,7 +2676,7 @@ export namespace VersionCreateParams {
        * [jurisdiction](https://developers.cloudflare.com/r2/reference/data-location/#jurisdictional-restrictions)
        * of the R2 bucket.
        */
-      jurisdiction?: 'eu' | 'fedramp';
+      jurisdiction?: 'eu' | 'fedramp' | 'fedramp-high';
     }
 
     export interface WorkersBindingKindSecretText {
@@ -2065,26 +2740,14 @@ export namespace VersionCreateParams {
       type: 'service';
 
       /**
-       * Optional environment if the Worker utilizes one.
-       */
-      environment?: string;
-    }
-
-    export interface WorkersBindingKindTailConsumer {
-      /**
-       * A JavaScript variable name for the binding.
-       */
-      name: string;
-
-      /**
-       * Name of Tail Worker to bind to.
+       * Entrypoint to invoke on the target Worker.
        */
-      service: string;
+      entrypoint?: string;
 
       /**
-       * The kind of resource that the binding provides.
+       * Optional environment if the Worker utilizes one.
        */
-      type: 'tail_consumer';
+      environment?: string;
     }
 
     export interface WorkersBindingKindTextBlob {
@@ -2156,6 +2819,23 @@ export namespace VersionCreateParams {
       type: 'secrets_store_secret';
     }
 
+    export interface WorkersBindingKindFlagship {
+      /**
+       * ID of the Flagship app to bind to for feature flag evaluation.
+       */
+      app_id: string;
+
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'flagship';
+    }
+
     export interface WorkersBindingKindSecretKey {
       /**
        * Algorithm-specific key parameters.
@@ -2246,6 +2926,46 @@ export namespace VersionCreateParams {
        */
       type: 'wasm_module';
     }
+
+    export interface WorkersBindingKindVPCService {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * Identifier of the VPC service to bind to.
+       */
+      service_id: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'vpc_service';
+    }
+
+    export interface WorkersBindingKindVPCNetwork {
+      /**
+       * A JavaScript variable name for the binding.
+       */
+      name: string;
+
+      /**
+       * The kind of resource that the binding provides.
+       */
+      type: 'vpc_network';
+
+      /**
+       * Identifier of the network to bind to. Only "cf1:network" is currently supported.
+       * Mutually exclusive with tunnel_id.
+       */
+      network_id?: string;
+
+      /**
+       * UUID of the Cloudflare Tunnel to bind to. Mutually exclusive with network_id.
+       */
+      tunnel_id?: string;
+    }
   }
 }
 
@@ -2253,7 +2973,7 @@ export interface VersionListParams extends V4PagePaginationParams {
   /**
    * Path param: Identifier.
    */
-  account_id: string;
+  account_id?: string;
 
   /**
    * Query param: Only return versions that can be used in a deployment. Ignores
@@ -2266,7 +2986,7 @@ export interface VersionGetParams {
   /**
    * Identifier.
    */
-  account_id: string;
+  account_id?: string;
 }
 
 Versions.VersionListResponsesV4PagePagination = VersionListResponsesV4PagePagination;