@cloudflare/workers-utils 0.21.0 → 0.22.0

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { T as TailConsumer, au as WorkerMetadata, R as RawConfig } from './config-CeDY2o0q.mjs';
+import { T as TailConsumer, az as WorkerMetadata, R as RawConfig } from './config-CXobNAeT.mjs';
 import { AssetConfig } from '@cloudflare/workers-shared';
 import { Cloudflare } from 'cloudflare';
 

package/dist/browser.mjs

@@ -1,3 +1,3 @@
-export { constructWranglerConfig } from './chunk-BLWXWFJK.mjs';
+export { constructWranglerConfig } from './chunk-AKFE3ND4.mjs';
 import './chunk-OZQVB3L3.mjs';
 import './chunk-DCOBXSFB.mjs';

package/dist/{chunk-BLWXWFJK.mjs → chunk-AKFE3ND4.mjs}

@@ -300,6 +300,23 @@ function mapWorkerMetadataBindings(bindings) {
           }
         ];
         break;
+      case "web_search":
+        {
+          configObj.web_search = {
+            binding: binding.name
+          };
+        }
+        break;
+      case "agent_memory": {
+        configObj.agent_memory = [
+          ...configObj.agent_memory ?? [],
+          {
+            binding: binding.name,
+            namespace: binding.namespace
+          }
+        ];
+        break;
+      }
       case "hyperdrive":
         configObj.hyperdrive = [
           ...configObj.hyperdrive ?? [],
@@ -323,7 +340,9 @@ function mapWorkerMetadataBindings(bindings) {
           ...configObj.pipelines ?? [],
           {
             binding: binding.name,
-            pipeline: binding.pipeline
+            // NOTE: stream is the primary field, but we also support pipeline for backward compatibility
+            ...binding.stream && { stream: binding.stream },
+            ...binding.pipeline && { pipeline: binding.pipeline }
           }
         ];
         break;

package/dist/{chunk-XXCQEG76.mjs → chunk-GMTGAG26.mjs}

@@ -2821,8 +2821,12 @@ function findRedirectedWranglerConfig(cwd, userConfigPath) {
   };
 }
 __name(findRedirectedWranglerConfig, "findRedirectedWranglerConfig");
+function isRedirectedConfig(config) {
+  return config.configPath !== void 0 && config.configPath !== config.userConfigPath;
+}
+__name(isRedirectedConfig, "isRedirectedConfig");
 function isRedirectedRawConfig(rawConfig, configPath, userConfigPath) {
-  return configPath !== void 0 && configPath !== userConfigPath;
+  return isRedirectedConfig({ configPath, userConfigPath });
 }
 __name(isRedirectedRawConfig, "isRedirectedRawConfig");
 
@@ -3175,4 +3179,4 @@ smol-toml/dist/index.js:
    *)
 */
 
-export { APIError, CommandLineArgsError, DeprecationError, FatalError, JsonFriendlyFatalError, MissingConfigError, ParseError, UserError, applyEdits, configFileName, configFormat, createFatalError, dedent, dist_default, experimental_readRawConfig, findWranglerConfig, format2 as format, formatConfigSnippet, indexLocation, isDirectory, isRedirectedRawConfig, modify, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation };
+export { APIError, CommandLineArgsError, DeprecationError, FatalError, JsonFriendlyFatalError, MissingConfigError, ParseError, UserError, applyEdits, configFileName, configFormat, createFatalError, dedent, dist_default, experimental_readRawConfig, findWranglerConfig, format2 as format, formatConfigSnippet, indexLocation, isDirectory, isRedirectedConfig, isRedirectedRawConfig, modify, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation };

package/dist/{config-CeDY2o0q.d.mts → config-CXobNAeT.d.mts}

@@ -174,6 +174,7 @@ interface CfWorkflow {
     limits?: {
         steps?: number;
     };
+    schedules?: string | string[];
 }
 interface CfQueue {
     binding: string;
@@ -216,6 +217,15 @@ interface CfAISearch {
     instance_name: string;
     remote?: boolean;
 }
+interface CfWebSearch {
+    binding: string;
+    remote?: boolean;
+}
+interface CfAgentMemory {
+    binding: string;
+    namespace: string | typeof INHERIT_SYMBOL;
+    remote?: boolean;
+}
 interface CfSecretsStoreSecrets {
     binding: string;
     store_id: string;
@@ -302,7 +312,8 @@ interface CfAssetsBinding {
 }
 interface CfPipeline {
     binding: string;
-    pipeline: string;
+    stream?: string;
+    pipeline?: string;
     remote?: boolean;
 }
 interface CfUnsafeBinding {
@@ -514,6 +525,13 @@ type WorkerMetadataBinding = {
     type: "ai_search";
     name: string;
     instance_name: string;
+} | {
+    type: "web_search";
+    name: string;
+} | {
+    type: "agent_memory";
+    name: string;
+    namespace: string;
 } | {
     type: "kv_namespace";
     name: string;
@@ -601,7 +619,8 @@ type WorkerMetadataBinding = {
 } | {
     type: "pipelines";
     name: string;
-    pipeline: string;
+    stream?: string;
+    pipeline?: string;
 } | {
     type: "secrets_store_secret";
     name: string;
@@ -654,6 +673,38 @@ type AssetConfigMetadata = {
     _redirects?: string;
     _headers?: string;
 };
+type AssetsOptions = {
+    directory: string;
+    binding?: string;
+    routerConfig: RouterConfig;
+    assetConfig: AssetConfig;
+    _redirects?: string;
+    _headers?: string;
+    run_worker_first?: boolean | string[];
+};
+/**
+ * Information about the assets that should be uploaded
+ */
+interface LegacyAssetPaths {
+    /**
+     * Absolute path to the root of the project.
+     *
+     * This is the directory containing wrangler.toml or cwd if no config.
+     */
+    baseDirectory: string;
+    /**
+     * The path to the assets directory, relative to the `baseDirectory`.
+     */
+    assetDirectory: string;
+    /**
+     * An array of patterns that match files that should be uploaded.
+     */
+    includePatterns: string[];
+    /**
+     * An array of patterns that match files that should not be uploaded.
+     */
+    excludePatterns: string[];
+}
 type WorkerMetadataPut = {
     /** The name of the entry point module. Only exists when the worker is in the ES module format */
     main_module?: string;
@@ -807,6 +858,10 @@ type Binding = {
 } & BindingOmit<CfAISearchNamespace>) | ({
     type: "ai_search";
 } & BindingOmit<CfAISearch>) | ({
+    type: "web_search";
+} & BindingOmit<CfWebSearch>) | ({
+    type: "agent_memory";
+} & BindingOmit<CfAgentMemory>) | ({
     type: "hyperdrive";
 } & BindingOmit<CfHyperdrive>) | ({
     type: "service";
@@ -848,6 +903,29 @@ type Binding = {
 } | {
     type: "inherit";
 };
+/**
+ * An entry point for the Worker.
+ *
+ * It consists not just of a `file`, but also of a `directory` that is used to resolve relative paths.
+ */
+type Entry = {
+    /** A worker's entrypoint */
+    file: string;
+    /** A worker's directory. Usually where the Wrangler configuration file is located */
+    projectRoot: string;
+    /** The path to the config file, if it exists. */
+    configPath: string | undefined;
+    /** Is this a module worker or a service worker? */
+    format: CfScriptFormat;
+    /** The directory that contains all of a `--no-bundle` worker's modules. Usually `${directory}/src`. Defaults to path.dirname(file) */
+    moduleRoot: string;
+    /**
+     * A worker's name
+     */
+    name?: string | undefined;
+    /** Export from a Worker's entrypoint */
+    exports: string[];
+};
 
 /**
  * The `Environment` interface declares all the configuration fields that
@@ -1497,6 +1575,8 @@ type WorkflowBinding = {
         /** Maximum number of steps a Workflow instance can execute */
         steps?: number;
     };
+    /** Optional cron schedule(s) for automatically triggering workflow instances */
+    schedules?: string | string[];
 };
 /**
  * The `EnvironmentNonInheritable` interface declares all the configuration fields for an environment
@@ -1794,6 +1874,40 @@ interface EnvironmentNonInheritable {
         /** Whether the AI Search instance binding should be remote in local development */
         remote?: boolean;
     }[];
+    /**
+     * Specifies Agent Memory namespace bindings that are bound to this Worker environment.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default []
+     * @nonInheritable
+     */
+    agent_memory: {
+        /** The binding name used to refer to the Agent Memory namespace in the Worker. */
+        binding: string;
+        /** The user-chosen namespace name. Must exist in Cloudflare at deploy time. */
+        namespace: string;
+        /** Whether the Agent Memory binding should be remote in local development */
+        remote?: boolean;
+    }[];
+    /**
+     * Cloudflare Web Search binding. There is exactly one shared web corpus, so the
+     * binding is zero-config -- only the variable name is required, declared as a
+     * single object (not an array).
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default {}
+     * @nonInheritable
+     */
+    web_search: {
+        /** The binding name used to refer to Web Search in the Worker. */
+        binding: string;
+        /** Whether the Web Search binding should be remote or not in local development */
+        remote?: boolean;
+    } | undefined;
     /**
      * Specifies Hyperdrive configs that are bound to this Worker environment.
      *
@@ -2055,8 +2169,13 @@ interface EnvironmentNonInheritable {
     pipelines: {
         /** The binding name used to refer to the bound service. */
         binding: string;
-        /** Name of the Pipeline to bind */
-        pipeline: string;
+        /** Id of the Stream to bind */
+        stream?: string;
+        /**
+         * Id of the Stream to bind
+         * @deprecated Use `stream` instead.
+         */
+        pipeline?: string;
         /** Whether the pipeline should be remote or not in local development */
         remote?: boolean;
     }[];
@@ -2580,4 +2699,4 @@ interface EnvironmentMap {
 }
 declare const defaultWranglerConfig: Config;
 
-export { type CfAISearchNamespace as $, type Assets as A, type Binding as B, type Config as C, type DurableObjectMigration as D, type Environment as E, type CfTextBlobBindings as F, type CfBrowserBinding as G, type CfAIBinding as H, type CfImagesBinding as I, type CfMediaBinding as J, type CfStreamBinding as K, type CfVersionMetadataBinding as L, type CfDataBlobBindings as M, type CfDurableObject as N, type Observability as O, type PreviewsConfig as P, type CfWorkflow as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfQueue as V, type WorkerMetadataBinding as W, type CfR2Bucket as X, type CfD1Database as Y, type ZoneIdRoute as Z, type CfVectorize as _, type RedirectedRawConfig as a, type CfAISearch as a0, type CfSecretsStoreSecrets as a1, type CfArtifacts as a2, type CfHelloWorld as a3, type CfFlagship as a4, type CfWorkerLoader as a5, type CfRateLimit as a6, type CfHyperdrive as a7, type CfService as a8, type CfVpcService as a9, INHERIT_SYMBOL as aA, SERVICE_TAG_PREFIX as aB, ENVIRONMENT_TAG_PREFIX as aC, PATH_TO_DEPLOY_CONFIG as aD, JSON_CONFIG_FORMATS as aE, type CfVpcNetwork as aa, type CfAnalyticsEngineDataset as ab, type CfDispatchNamespace as ac, type CfMTlsCertificate as ad, type CfLogfwdr as ae, type CfLogfwdrBinding as af, type CfAssetsBinding as ag, type CfPipeline as ah, type CfUnsafeBinding as ai, type CfCapnp as aj, type CfUnsafe as ak, type CfDurableObjectMigrations as al, type CfPlacement as am, type CfTailConsumer as an, type CfUserLimits as ao, type CfWorkerInit as ap, type CfWorkerContext as aq, type CfWorkerSourceMap as ar, type Json as as, type AssetConfigMetadata as at, type WorkerMetadata as au, type ServiceMetadataRes as av, type ServiceFetch as aw, type File as ax, type BinaryFile as ay, type Trigger as az, type RawDevConfig as b, type ConfigFields as c, type RawEnvironment as d, defaultWranglerConfig as e, type ZoneNameRoute as f, type CustomDomainRoute as g, type Route as h, type CloudchamberConfig as i, type ContainerApp as j, type DurableObjectBindings as k, type WorkflowBinding as l, type EnvironmentNonInheritable as m, type Rule as n, type ConfigModuleRuleType as o, type DispatchNamespaceOutbound as p, type CacheOptions as q, type DockerConfiguration as r, type ContainerEngine as s, type CfScriptFormat as t, type CfModuleType as u, type CfModule as v, type CfVars as w, type CfKvNamespace as x, type CfSendEmailBindings as y, type CfWasmModuleBindings as z };
+export { type CfVectorize as $, type Assets as A, type Binding as B, type ComputedFields as C, type DurableObjectMigration as D, type Environment as E, type CfWasmModuleBindings as F, type CfTextBlobBindings as G, type CfBrowserBinding as H, type CfAIBinding as I, type CfImagesBinding as J, type CfMediaBinding as K, type CfStreamBinding as L, type CfVersionMetadataBinding as M, type CfDataBlobBindings as N, type Observability as O, type PreviewsConfig as P, type CfDurableObject as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfWorkflow as V, type WorkerMetadataBinding as W, type CfQueue as X, type CfR2Bucket as Y, type ZoneIdRoute as Z, type CfD1Database as _, type RedirectedRawConfig as a, type CfAISearchNamespace as a0, type CfAISearch as a1, type CfWebSearch as a2, type CfAgentMemory as a3, type CfSecretsStoreSecrets as a4, type CfArtifacts as a5, type CfHelloWorld as a6, type CfFlagship as a7, type CfWorkerLoader as a8, type CfRateLimit as a9, type ServiceMetadataRes as aA, type ServiceFetch as aB, type File as aC, type BinaryFile as aD, type Trigger as aE, type Entry as aF, INHERIT_SYMBOL as aG, SERVICE_TAG_PREFIX as aH, ENVIRONMENT_TAG_PREFIX as aI, PATH_TO_DEPLOY_CONFIG as aJ, JSON_CONFIG_FORMATS as aK, type CfHyperdrive as aa, type CfService as ab, type CfVpcService as ac, type CfVpcNetwork as ad, type CfAnalyticsEngineDataset as ae, type CfDispatchNamespace as af, type CfMTlsCertificate as ag, type CfLogfwdr as ah, type CfLogfwdrBinding as ai, type CfAssetsBinding as aj, type CfPipeline as ak, type CfUnsafeBinding as al, type CfCapnp as am, type CfUnsafe as an, type CfDurableObjectMigrations as ao, type CfPlacement as ap, type CfTailConsumer as aq, type CfUserLimits as ar, type CfWorkerInit as as, type CfWorkerContext as at, type CfWorkerSourceMap as au, type Json as av, type AssetConfigMetadata as aw, type AssetsOptions as ax, type LegacyAssetPaths as ay, type WorkerMetadata as az, type Config as b, type RawDevConfig as c, type ConfigFields as d, type RawEnvironment as e, defaultWranglerConfig as f, type ZoneNameRoute as g, type CustomDomainRoute as h, type Route as i, type CloudchamberConfig as j, type ContainerApp as k, type DurableObjectBindings as l, type WorkflowBinding as m, type EnvironmentNonInheritable as n, type Rule as o, type ConfigModuleRuleType as p, type DispatchNamespaceOutbound as q, type CacheOptions as r, type DockerConfiguration as s, type ContainerEngine as t, type CfScriptFormat as u, type CfModuleType as v, type CfModule as w, type CfVars as x, type CfKvNamespace as y, type CfSendEmailBindings as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { B as Binding, R as RawConfig, C as Config, W as WorkerMetadataBinding } from './config-CeDY2o0q.mjs';
-export { at as AssetConfigMetadata, A as Assets, ay as BinaryFile, q as CacheOptions, H as CfAIBinding, a0 as CfAISearch, $ as CfAISearchNamespace, ab as CfAnalyticsEngineDataset, a2 as CfArtifacts, ag as CfAssetsBinding, G as CfBrowserBinding, aj as CfCapnp, Y as CfD1Database, M as CfDataBlobBindings, ac as CfDispatchNamespace, N as CfDurableObject, al as CfDurableObjectMigrations, a4 as CfFlagship, a3 as CfHelloWorld, a7 as CfHyperdrive, I as CfImagesBinding, x as CfKvNamespace, ae as CfLogfwdr, af as CfLogfwdrBinding, ad as CfMTlsCertificate, J as CfMediaBinding, v as CfModule, u as CfModuleType, ah as CfPipeline, am as CfPlacement, V as CfQueue, X as CfR2Bucket, a6 as CfRateLimit, t as CfScriptFormat, a1 as CfSecretsStoreSecrets, y as CfSendEmailBindings, a8 as CfService, K as CfStreamBinding, an as CfTailConsumer, F as CfTextBlobBindings, ak as CfUnsafe, ai as CfUnsafeBinding, ao as CfUserLimits, w as CfVars, _ as CfVectorize, L as CfVersionMetadataBinding, aa as CfVpcNetwork, a9 as CfVpcService, z as CfWasmModuleBindings, aq as CfWorkerContext, ap as CfWorkerInit, a5 as CfWorkerLoader, ar as CfWorkerSourceMap, Q as CfWorkflow, i as CloudchamberConfig, c as ConfigFields, o as ConfigModuleRuleType, j as ContainerApp, s as ContainerEngine, g as CustomDomainRoute, p as DispatchNamespaceOutbound, r as DockerConfiguration, k as DurableObjectBindings, D as DurableObjectMigration, aC as ENVIRONMENT_TAG_PREFIX, E as Environment, m as EnvironmentNonInheritable, ax as File, aA as INHERIT_SYMBOL, aE as JSON_CONFIG_FORMATS, as as Json, O as Observability, aD as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, b as RawDevConfig, d as RawEnvironment, a as RedirectedRawConfig, h as Route, n as Rule, aB as SERVICE_TAG_PREFIX, aw as ServiceFetch, av as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, az as Trigger, U as UserLimits, au as WorkerMetadata, l as WorkflowBinding, Z as ZoneIdRoute, f as ZoneNameRoute, e as defaultWranglerConfig } from './config-CeDY2o0q.mjs';
+import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, W as WorkerMetadataBinding } from './config-CXobNAeT.mjs';
+export { aw as AssetConfigMetadata, A as Assets, ax as AssetsOptions, aD as BinaryFile, r as CacheOptions, I as CfAIBinding, a1 as CfAISearch, a0 as CfAISearchNamespace, a3 as CfAgentMemory, ae as CfAnalyticsEngineDataset, a5 as CfArtifacts, aj as CfAssetsBinding, H as CfBrowserBinding, am as CfCapnp, _ as CfD1Database, N as CfDataBlobBindings, af as CfDispatchNamespace, Q as CfDurableObject, ao as CfDurableObjectMigrations, a7 as CfFlagship, a6 as CfHelloWorld, aa as CfHyperdrive, J as CfImagesBinding, y as CfKvNamespace, ah as CfLogfwdr, ai as CfLogfwdrBinding, ag as CfMTlsCertificate, K as CfMediaBinding, w as CfModule, v as CfModuleType, ak as CfPipeline, ap as CfPlacement, X as CfQueue, Y as CfR2Bucket, a9 as CfRateLimit, u as CfScriptFormat, a4 as CfSecretsStoreSecrets, z as CfSendEmailBindings, ab as CfService, L as CfStreamBinding, aq as CfTailConsumer, G as CfTextBlobBindings, an as CfUnsafe, al as CfUnsafeBinding, ar as CfUserLimits, x as CfVars, $ as CfVectorize, M as CfVersionMetadataBinding, ad as CfVpcNetwork, ac as CfVpcService, F as CfWasmModuleBindings, a2 as CfWebSearch, at as CfWorkerContext, as as CfWorkerInit, a8 as CfWorkerLoader, au as CfWorkerSourceMap, V as CfWorkflow, j as CloudchamberConfig, d as ConfigFields, p as ConfigModuleRuleType, k as ContainerApp, t as ContainerEngine, h as CustomDomainRoute, q as DispatchNamespaceOutbound, s as DockerConfiguration, l as DurableObjectBindings, D as DurableObjectMigration, aI as ENVIRONMENT_TAG_PREFIX, aF as Entry, E as Environment, n as EnvironmentNonInheritable, aC as File, aG as INHERIT_SYMBOL, aK as JSON_CONFIG_FORMATS, av as Json, ay as LegacyAssetPaths, O as Observability, aJ as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, c as RawDevConfig, e as RawEnvironment, a as RedirectedRawConfig, i as Route, o as Rule, aH as SERVICE_TAG_PREFIX, aB as ServiceFetch, aA as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, aE as Trigger, U as UserLimits, az as WorkerMetadata, m as WorkflowBinding, Z as ZoneIdRoute, g as ZoneNameRoute, f as defaultWranglerConfig } from './config-CXobNAeT.mjs';
 import * as jsoncParser from 'jsonc-parser';
 export { constructWranglerConfig } from './browser.mjs';
 export { Counter, MetricsRegistry } from './prometheus-metrics.mjs';
@@ -39,6 +39,7 @@ declare function resolveWranglerConfigPath({ config, script, }: {
 declare function findWranglerConfig(referencePath?: string, { useRedirectIfAvailable }?: {
     useRedirectIfAvailable?: boolean | undefined;
 }): ConfigPaths;
+declare function isRedirectedConfig(config: Pick<ComputedFields, "configPath" | "userConfigPath">): boolean;
 
 /**
  * Diagnostic errors and warnings.
@@ -89,7 +90,7 @@ declare const bucketFormatMessage = "Bucket names must begin and end with an alp
  * Config field names for bindings (e.g., "kv_namespaces", "d1_databases").
  * These are the keys used in Wrangler's config file
  */
-type ConfigBindingFieldName = "data_blobs" | "durable_objects" | "kv_namespaces" | "send_email" | "queues" | "d1_databases" | "vectorize" | "ai_search_namespaces" | "ai_search" | "hyperdrive" | "r2_buckets" | "logfwdr" | "services" | "analytics_engine_datasets" | "text_blobs" | "browser" | "ai" | "images" | "stream" | "media" | "version_metadata" | "unsafe" | "vars" | "wasm_modules" | "dispatch_namespaces" | "mtls_certificates" | "workflows" | "pipelines" | "secrets_store_secrets" | "artifacts" | "ratelimits" | "assets" | "unsafe_hello_world" | "flagship" | "worker_loaders" | "vpc_services" | "vpc_networks";
+type ConfigBindingFieldName = "data_blobs" | "durable_objects" | "kv_namespaces" | "send_email" | "queues" | "d1_databases" | "vectorize" | "ai_search_namespaces" | "ai_search" | "web_search" | "agent_memory" | "hyperdrive" | "r2_buckets" | "logfwdr" | "services" | "analytics_engine_datasets" | "text_blobs" | "browser" | "ai" | "images" | "stream" | "media" | "version_metadata" | "unsafe" | "vars" | "wasm_modules" | "dispatch_namespaces" | "mtls_certificates" | "workflows" | "pipelines" | "secrets_store_secrets" | "artifacts" | "ratelimits" | "assets" | "unsafe_hello_world" | "flagship" | "worker_loaders" | "vpc_services" | "vpc_networks";
 /**
  * @deprecated new code should use getBindingTypeFriendlyName() instead
  */
@@ -328,6 +329,22 @@ declare function parseHumanDuration(s: string): number;
 declare function parseNonHyphenedUuid(uuid: string | null): string | null;
 declare function parseByteSize(s: string, base?: number | undefined): number;
 
+/**
+ * Local-dev capability of each binding type. Source of truth for
+ * `pickRemoteBindings()` and `warnOrError()`.
+ *
+ * - `local-and-remote`: local simulator; `remote: true` opts into proxying.
+ * - `local-only`: local simulator only; `remote: true` is a config error.
+ * - `remote`: no local simulator *yet* — requires explicit `remote: true`.
+ *   Move to `local-and-remote` once a simulator lands.
+ * - `DO-NOT-USE-this-resource-will-never-have-a-local-simulator`: no local
+ *   simulator, *ever* — fundamentally remote-only. Always auto-routed; user
+ *   is warned about usage charges. Adding here is permanent; prefer any
+ *   other variant if a simulator is plausible.
+ */
+type BindingLocalSupport = "local-and-remote" | "local-only" | "remote" | "DO-NOT-USE-this-resource-will-never-have-a-local-simulator";
+declare function getBindingLocalSupport(type: Binding["type"]): BindingLocalSupport;
+
 /**
  * Pages now supports configuration via a Wrangler configuration file. As opposed to
  * Workers however, Pages only supports a limited subset of all available
@@ -568,9 +585,12 @@ declare const getC3CommandFromEnv: () => string;
  */
 declare const getWranglerSendMetricsFromEnv: () => boolean | undefined;
 /**
- * `WRANGLER_SEND_ERROR_REPORTS` can override whether we attempt to send error reports to Sentry.
+ * `WRANGLER_SEND_ERROR_REPORTS` controls whether we attempt to send error reports to Sentry.
+ *
+ * Defaults to `false` to avoid noisy false-positive reports. Users can opt in
+ * by setting `WRANGLER_SEND_ERROR_REPORTS=true`.
  */
-declare const getWranglerSendErrorReportsFromEnv: () => boolean | undefined;
+declare const getWranglerSendErrorReportsFromEnv: () => boolean;
 /**
  * Set `WRANGLER_API_ENVIRONMENT` environment variable to "staging" to tell Wrangler to hit the staging APIs rather than production.
  */
@@ -837,6 +857,35 @@ declare function removeDir(dirPath: string, options?: {
  */
 declare function removeDirSync(dirPath: string): void;
 
+/**
+ * A short-lived directory. Automatically removed when the process exits, but
+ * can be removed earlier by calling `remove()`.
+ */
+interface EphemeralDirectory {
+    path: string;
+    remove(): void;
+}
+/**
+ * Gets the path to the project's `.wrangler` folder.
+ */
+declare function getWranglerHiddenDirPath(projectRoot: string | undefined): string;
+/**
+ * Removes stale `.wrangler/tmp/*` entries left behind by previous wrangler
+ * sessions that exited abnormally (SIGKILL, OOM, host crash) and so missed
+ * the `signal-exit` cleanup. Runs at most once per tmp root per process.
+ *
+ * Exported for tests.
+ */
+declare function sweepStaleWranglerTmpDirs(tmpRoot: string): void;
+/**
+ * Gets a temporary directory in the project's `.wrangler` folder with the
+ * specified prefix. We create temporary directories in `.wrangler` as opposed
+ * to the OS's temporary directory to avoid issues with different drive letters
+ * on Windows. For example, when `esbuild` outputs a file to a different drive
+ * than the input sources, the generated source maps are incorrect.
+ */
+declare function getWranglerTmpDir(projectRoot: string | undefined, prefix: string, cleanup?: boolean): EphemeralDirectory;
+
 /**
  * cloudflared binary management for Wrangler tunnel commands.
  *
@@ -861,16 +910,23 @@ declare function spawnCloudflared(args: string[], options?: {
     logger?: Logger;
 }): Promise<ChildProcess>;
 
-interface TunnelResult {
+interface QuickTunnelResult {
+    mode: "quick";
     publicUrl: URL;
 }
+interface NamedTunnelResult {
+    mode: "named";
+}
+type TunnelResult = QuickTunnelResult | NamedTunnelResult;
 interface Tunnel {
     ready: () => Promise<TunnelResult>;
+    isOpen: () => boolean;
     dispose: () => void;
     extendExpiry: (ms?: number) => void;
 }
 interface TunnelOptions {
     origin: URL;
+    token?: string;
     timeoutMs?: number;
     expiryMs?: number;
     reminderIntervalMs?: number;
@@ -887,4 +943,28 @@ interface TunnelOptions {
  */
 declare function startTunnel(options: TunnelOptions): Tunnel;
 
-export { APIError, Binding, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, CommandLineArgsError, type CompatDate, type ComplianceConfig, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, FatalError, JsonFriendlyFatalError, type Location, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerMetadataBinding, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, findWranglerConfig, formatConfigSnippet, friendlyBindingNames, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getBrowserRenderingHeadfulFromEnv, getBuildConditionsFromEnv, getBuildPlatformFromEnv, getC3CommandFromEnv, getCIGeneratePreviewAlias, getCIMatchTag, getCIOverrideName, getCIOverrideNetworkModeHost, getCfFetchEnabledFromEnv, getCfFetchPathFromEnv, getCloudflareApiBaseUrl, getCloudflareApiEnvironmentFromEnv, getCloudflareComplianceRegion, getCloudflareEnv, getCloudflareIncludeProcessEnvFromEnv, getCloudflareLoadDevVarsFromDotEnv, getCloudflaredPathFromEnv, getComplianceRegionSubdomain, getD1ExtraLocationChoices, getDisableConfigWatching, getDockerPath, getEnvironmentVariableFactory, getGlobalWranglerConfigPath, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTodaysCompatDate, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation, spawnCloudflared, startTunnel, validatePagesConfig };
+type NpmVersionCheckResult = {
+    status: "up-to-date";
+} | {
+    status: "update-available";
+    latest: string;
+} | {
+    status: "failed";
+};
+/**
+ * Checks if a newer version of a package is available on npm.
+ *
+ * Uses the `update-check` library to query the npm registry for the latest
+ * version. The dist tag used for comparison depends on the current version —
+ * "beta" for pre-release versions (0.0.0-*) and "latest" for stable versions.
+ *
+ * @param name - The npm package name to check
+ * @param version - The current version to compare against
+ * @returns A discriminated result:
+ *   - `{ status: "update-available", latest: string }` if a newer version exists
+ *   - `{ status: "up-to-date" }` if the installed version is already the latest
+ *   - `{ status: "failed" }` if the check could not be completed (network error, timeout, etc.)
+ */
+declare function fetchLatestNpmVersion(name: string, version: string): Promise<NpmVersionCheckResult>;
+
+export { APIError, Binding, type BindingLocalSupport, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, CommandLineArgsError, type CompatDate, type ComplianceConfig, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, type EphemeralDirectory, FatalError, JsonFriendlyFatalError, type Location, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type NpmVersionCheckResult, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerMetadataBinding, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, fetchLatestNpmVersion, findWranglerConfig, formatConfigSnippet, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getBrowserRenderingHeadfulFromEnv, getBuildConditionsFromEnv, getBuildPlatformFromEnv, getC3CommandFromEnv, getCIGeneratePreviewAlias, getCIMatchTag, getCIOverrideName, getCIOverrideNetworkModeHost, getCfFetchEnabledFromEnv, getCfFetchPathFromEnv, getCloudflareApiBaseUrl, getCloudflareApiEnvironmentFromEnv, getCloudflareComplianceRegion, getCloudflareEnv, getCloudflareIncludeProcessEnvFromEnv, getCloudflareLoadDevVarsFromDotEnv, getCloudflaredPathFromEnv, getComplianceRegionSubdomain, getD1ExtraLocationChoices, getDisableConfigWatching, getDockerPath, getEnvironmentVariableFactory, getGlobalWranglerConfigPath, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTodaysCompatDate, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHiddenDirPath, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, getWranglerTmpDir, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, validatePagesConfig };