vercel 53.3.2 → 54.0.0

package/dist/chunks/{chunk-Z2O2S6ZA.js → chunk-KAC4IO5S.js}

@@ -14,7 +14,7 @@ import {
   getPreservedArgsForEnvPull,
   outputActionRequired,
   outputAgentError
-} from "./chunk-AXQNAI65.js";
+} from "./chunk-V6BFG564.js";
 import {
   require_ms,
   stamp_default
@@ -28,7 +28,7 @@ import {
   require_string_width,
   require_strip_ansi,
   yesOption
-} from "./chunk-GQLARSTH.js";
+} from "./chunk-P5NASM3L.js";
 import {
   APIError,
   CantParseJSONFile,
@@ -43,7 +43,7 @@ import {
   isAPIError,
   packageName,
   require_lib
-} from "./chunk-EBEBY45K.js";
+} from "./chunk-4XB5UFP4.js";
 import {
   emoji,
   eraseLines,
@@ -15966,6 +15966,40 @@ var require_frameworks = __commonJS({
           }
         ]
       },
+      {
+        name: "Ash",
+        slug: "ash",
+        logo: "https://api-frameworks.vercel.sh/framework-logos/ash.svg",
+        darkModeLogo: "https://api-frameworks.vercel.sh/framework-logos/ash-dark.svg",
+        tagline: "A filesystem-first framework for durable backend agents on Vercel.",
+        description: "An Ash app: agents authored as a directory of files, compiled and served on Vercel.",
+        detectors: {
+          every: [
+            {
+              path: "package.json",
+              matchContent: '"(dev)?(d|D)ependencies":\\s*{[^}]*"experimental-ash":\\s*".+?"[^}]*}'
+            }
+          ]
+        },
+        settings: {
+          installCommand: {
+            placeholder: "`pnpm install`, `yarn install`, or `npm install`"
+          },
+          buildCommand: {
+            value: "ash build",
+            placeholder: "`npm run build` or `ash build`"
+          },
+          devCommand: {
+            value: "ash dev",
+            placeholder: "ash dev"
+          },
+          outputDirectory: {
+            value: ".output"
+          }
+        },
+        getOutputDirName: async () => ".output",
+        experimental: true
+      },
       {
         name: "Sanity (v3)",
         slug: "sanity-v3",
@@ -22640,9 +22674,11 @@ var require_utils3 = __commonJS({
       inferRuntimeFromFramework: () => inferRuntimeFromFramework,
       inferServiceRuntime: () => inferServiceRuntime,
       isFrontendFramework: () => isFrontendFramework,
+      isPublicServicesEnabled: () => isPublicServicesEnabled2,
       isRouteOwningBuilder: () => isRouteOwningBuilder2,
       isStaticBuild: () => isStaticBuild2,
-      readVercelConfig: () => readVercelConfig
+      readVercelConfig: () => readVercelConfig,
+      validateServicesConfigGate: () => validateServicesConfigGate
     });
     module.exports = __toCommonJS2(utils_exports);
     var import_framework_helpers = __require("@vercel/build-utils/dist/framework-helpers");
@@ -22655,6 +22691,18 @@ var require_utils3 = __commonJS({
         return false;
       }
     }
+    function isPublicServicesEnabled2() {
+      return process.env.VERCEL_USE_SERVICES === "1" || process.env.VERCEL_USE_SERVICES?.toLowerCase() === "true";
+    }
+    function validateServicesConfigGate(config) {
+      if (config?.services !== void 0 && !isPublicServicesEnabled2()) {
+        return {
+          code: "INVALID_VERCEL_CONFIG",
+          message: "Invalid vercel.json - should NOT have additional property `services`. Please remove it."
+        };
+      }
+      return null;
+    }
     var INTERNAL_QUEUES_PREFIX = "/_svc/_queues";
     function normalizeInternalServiceEntrypoint(entrypoint) {
       const normalized = entrypoint.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\.[^/.]+$/, "");
@@ -22739,6 +22787,10 @@ var require_utils3 = __commonJS({
         try {
           const content = await fs5.readFile("vercel.json");
           const config = JSON.parse(content.toString());
+          const gateError = validateServicesConfigGate(config);
+          if (gateError) {
+            return { config: null, error: gateError };
+          }
           return { config, error: null };
         } catch {
           return {
@@ -22756,6 +22808,10 @@ var require_utils3 = __commonJS({
           const { parse: tomlParse3 } = await import("smol-toml");
           const content = await fs5.readFile("vercel.toml");
           const config = tomlParse3(content.toString());
+          const gateError = validateServicesConfigGate(config);
+          if (gateError) {
+            return { config: null, error: gateError };
+          }
           return { config, error: null };
         } catch {
           return {
@@ -23074,7 +23130,12 @@ var require_resolve2 = __commonJS({
     }
     var SERVICE_NAME_REGEX = /^[a-zA-Z]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$/;
     var DNS_LABEL_RE = /^(?!-)[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/i;
-    var ENV_PREFIX_RE = /^[A-Z][A-Z0-9_]*_$/;
+    var ENV_VAR_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+    var ENTRYPOINT_REQUIRED_RUNTIMES = /* @__PURE__ */ new Set([
+      "node",
+      "python",
+      "go"
+    ]);
     async function getServiceFs(fs5, serviceName, root) {
       if (!root) {
         return { fs: fs5 };
@@ -23106,6 +23167,38 @@ var require_resolve2 = __commonJS({
       const normalized = import_path11.posix.normalize(entrypoint);
       return normalized === "" ? "." : normalized;
     }
+    function getEffectiveServiceTrigger(config) {
+      if (config.type === "cron") {
+        return "schedule";
+      }
+      if (config.type === "worker") {
+        return "queue";
+      }
+      if (config.type !== "job") {
+        return void 0;
+      }
+      return config.trigger;
+    }
+    function getEntrypointRequiredRuntime(config) {
+      if (config.runtime && config.runtime in import_types.RUNTIME_BUILDERS) {
+        return config.runtime;
+      }
+      return (0, import_utils4.inferRuntimeFromFramework)(config.framework);
+    }
+    function validateBackendFileEntrypoint(name, config, resolvedEntrypoint, options) {
+      if (!options.requireFileEntrypointForBackendRuntimes || !resolvedEntrypoint?.isDirectory) {
+        return null;
+      }
+      const runtime = getEntrypointRequiredRuntime(config);
+      if (!runtime || !ENTRYPOINT_REQUIRED_RUNTIMES.has(runtime)) {
+        return null;
+      }
+      return {
+        code: "INVALID_ENTRYPOINT",
+        message: `Service "${name}" must specify a file "entrypoint" when using "${config.runtime ? "runtime" : "framework"}" "${config.runtime || config.framework}".`,
+        serviceName: name
+      };
+    }
     async function resolveEntrypointPath({
       fs: fs5,
       serviceName,
@@ -23200,7 +23293,7 @@ var require_resolve2 = __commonJS({
         return {
           error: {
             code: "MULTIPLE_FRAMEWORKS_SERVICE",
-            message: `Multiple frameworks detected in ${workspace === "." ? "project root" : `${workspace}/`}: ${frameworkNames}. Specify "framework" explicitly in experimentalServices.`,
+            message: `Multiple frameworks detected in ${workspace === "." ? "project root" : `${workspace}/`}: ${frameworkNames}. Specify "framework" explicitly in services.`,
             serviceName
           }
         };
@@ -23294,7 +23387,7 @@ var require_resolve2 = __commonJS({
         }
       };
     }
-    function validateServiceConfig(name, config) {
+    function validateServiceConfig(name, config, options = {}) {
       if (!SERVICE_NAME_REGEX.test(name)) {
         return {
           code: "INVALID_SERVICE_NAME",
@@ -23310,13 +23403,15 @@ var require_resolve2 = __commonJS({
         };
       }
       const serviceType = config.type || "web";
-      const isJobService = serviceType === "job" || serviceType === "cron";
-      const isScheduleJobService = (0, import_build_utils5.isScheduleTriggeredService)({
+      const effectiveTrigger = getEffectiveServiceTrigger(config);
+      const effectiveService = {
         type: serviceType,
-        trigger: config.trigger
-      });
-      const isQueueJobService = serviceType === "job" && config.trigger === "queue";
-      const isWorkflowService = serviceType === "job" && config.trigger === "workflow";
+        trigger: effectiveTrigger
+      };
+      const isJobService = serviceType === "job" || serviceType === "cron";
+      const isScheduleJobService = (0, import_build_utils5.isScheduleTriggeredService)(effectiveService);
+      const isQueueJobService = serviceType === "job" && (0, import_build_utils5.isQueueTriggeredService)(effectiveService);
+      const isWorkflowService = serviceType === "job" && effectiveTrigger === "workflow";
       const isNonWebService = serviceType === "worker" || isJobService;
       const serviceTypeLabel = isJobService ? "Job" : serviceType === "worker" ? "Worker" : "Web";
       const routingResult = resolveServiceRoutingConfig(name, config);
@@ -23362,17 +23457,17 @@ var require_resolve2 = __commonJS({
           serviceName: name
         };
       }
-      if (serviceType === "job" && config.trigger === void 0) {
+      if (serviceType === "job" && effectiveTrigger === void 0) {
         return {
           code: "MISSING_JOB_TRIGGER",
           message: `Job service "${name}" is missing required "trigger" field.`,
           serviceName: name
         };
       }
-      if (serviceType === "job" && config.trigger && !import_build_utils5.JOB_TRIGGERS.includes(config.trigger)) {
+      if (serviceType === "job" && effectiveTrigger && !import_build_utils5.JOB_TRIGGERS.includes(effectiveTrigger)) {
         return {
           code: "INVALID_JOB_TRIGGER",
-          message: `Job service "${name}" has invalid trigger "${config.trigger}". Expected ${import_build_utils5.JOB_TRIGGERS.map((t) => `"${t}"`).join(", ")}.`,
+          message: `Job service "${name}" has invalid trigger "${effectiveTrigger}". Expected ${import_build_utils5.JOB_TRIGGERS.map((t) => `"${t}"`).join(", ")}.`,
           serviceName: name
         };
       }
@@ -23414,14 +23509,46 @@ var require_resolve2 = __commonJS({
           };
         }
       }
-      if (config.envPrefix !== void 0) {
-        if (!ENV_PREFIX_RE.test(config.envPrefix)) {
+      if (config.env !== void 0) {
+        if (typeof config.env !== "object" || Array.isArray(config.env)) {
           return {
-            code: "INVALID_ENV_PREFIX",
-            message: `Service "${name}" has invalid envPrefix "${config.envPrefix}". Must start with an uppercase letter, contain only uppercase letters, digits, and underscores, and end with "_" (e.g., "MY_SERVICE_").`,
+            code: "INVALID_ENV_VARS",
+            message: `Service "${name}" has invalid "env". Must be an object keyed by environment variable name.`,
             serviceName: name
           };
         }
+        for (const [envVarName, envVar] of Object.entries(config.env)) {
+          if (!ENV_VAR_NAME_RE.test(envVarName)) {
+            return {
+              code: "INVALID_ENV_VAR_NAME",
+              message: `Service "${name}" has invalid env key "${envVarName}". Must match /^[A-Za-z_][A-Za-z0-9_]*$/.`,
+              serviceName: name
+            };
+          }
+          if (!envVar || typeof envVar !== "object" || Array.isArray(envVar)) {
+            return {
+              code: "INVALID_ENV_VAR",
+              message: `Service "${name}" has invalid env["${envVarName}"]. Must be an object with a "type" discriminator.`,
+              serviceName: name
+            };
+          }
+          const envVarType = envVar.type;
+          if (envVarType !== "service-ref") {
+            return {
+              code: "INVALID_ENV_VAR_TYPE",
+              message: `Service "${name}" env["${envVarName}"] has unknown type "${envVarType}".`,
+              serviceName: name
+            };
+          }
+          const refService = envVar.service;
+          if (typeof refService !== "string" || refService.length === 0) {
+            return {
+              code: "INVALID_ENV_VAR_REF",
+              message: `Service "${name}" env["${envVarName}"] must specify "service" as a non-empty string.`,
+              serviceName: name
+            };
+          }
+        }
       }
       if (config.runtime && !(config.runtime in import_types.RUNTIME_BUILDERS)) {
         return {
@@ -23450,6 +23577,7 @@ var require_resolve2 = __commonJS({
       const hasFramework = Boolean(config.framework);
       const hasBuilderOrRuntime = Boolean(config.builder || config.runtime);
       const hasEntrypoint = Boolean(config.entrypoint);
+      const entrypointRequiredRuntime = getEntrypointRequiredRuntime(config);
       if (!hasFramework && !hasBuilderOrRuntime && !hasEntrypoint) {
         return {
           code: "MISSING_SERVICE_CONFIG",
@@ -23457,6 +23585,13 @@ var require_resolve2 = __commonJS({
           serviceName: name
         };
       }
+      if (options.requireFileEntrypointForBackendRuntimes && !hasEntrypoint && entrypointRequiredRuntime && ENTRYPOINT_REQUIRED_RUNTIMES.has(entrypointRequiredRuntime)) {
+        return {
+          code: "MISSING_ENTRYPOINT",
+          message: `Service "${name}" must specify "entrypoint" when using "${config.runtime ? "runtime" : "framework"}" "${config.runtime || config.framework}".`,
+          serviceName: name
+        };
+      }
       if (hasBuilderOrRuntime && !hasFramework && !hasEntrypoint) {
         return {
           code: "MISSING_ENTRYPOINT",
@@ -23494,7 +23629,7 @@ var require_resolve2 = __commonJS({
         routePrefixSource = "configured"
       } = options;
       const type = config.type || "web";
-      const trigger = type === "cron" ? "schedule" : type === "job" ? config.trigger : void 0;
+      const trigger = getEffectiveServiceTrigger(config);
       const rawEntrypoint = config.entrypoint;
       const moduleAttrParsed = typeof rawEntrypoint === "string" ? parsePyModuleAttrEntrypoint(rawEntrypoint) : null;
       const routingResult = resolveServiceRoutingConfig(name, config);
@@ -23637,16 +23772,16 @@ var require_resolve2 = __commonJS({
         schedule: config.schedule,
         handlerFunction: moduleAttrParsed?.attrName,
         topics,
-        envPrefix: config.envPrefix
+        env: config.env
       };
     }
-    async function resolveAllConfiguredServices(services, fs5, routePrefixSource = "configured") {
+    async function resolveAllConfiguredServices(services, fs5, routePrefixSource = "configured", options = {}) {
       const resolved = [];
       const errors = [];
       const webServicesByRoutePrefix = /* @__PURE__ */ new Map();
       for (const name of Object.keys(services)) {
         const serviceConfig = services[name];
-        const validationError = validateServiceConfig(name, serviceConfig);
+        const validationError = validateServiceConfig(name, serviceConfig, options);
         if (validationError) {
           errors.push(validationError);
           continue;
@@ -23684,6 +23819,16 @@ var require_resolve2 = __commonJS({
             continue;
           }
         }
+        const explicitBackendEntrypointError = validateBackendFileEntrypoint(
+          name,
+          serviceConfig,
+          resolvedEntrypoint,
+          options
+        );
+        if (explicitBackendEntrypointError) {
+          errors.push(explicitBackendEntrypointError);
+          continue;
+        }
         let resolvedConfig = serviceConfig;
         if (!serviceConfig.framework && resolvedEntrypoint) {
           if (resolvedEntrypoint.isDirectory) {
@@ -23740,6 +23885,16 @@ var require_resolve2 = __commonJS({
             }
           }
         }
+        const backendEntrypointError = validateBackendFileEntrypoint(
+          name,
+          resolvedConfig,
+          resolvedEntrypoint,
+          options
+        );
+        if (backendEntrypointError) {
+          errors.push(backendEntrypointError);
+          continue;
+        }
         const service = await resolveConfiguredService({
           name,
           config: resolvedConfig,
@@ -23765,8 +23920,49 @@ var require_resolve2 = __commonJS({
         }
         resolved.push(service);
       }
+      const servicesByName = new Map(resolved.map((s) => [s.name, s]));
+      for (const service of resolved) {
+        if (!service.env)
+          continue;
+        validateEnvRefs(
+          service.env,
+          `Service "${service.name}" env`,
+          servicesByName,
+          errors,
+          service.name
+        );
+      }
+      if (options.rootEnv) {
+        validateEnvRefs(options.rootEnv, "env", servicesByName, errors);
+        for (const service of resolved) {
+          service.env = { ...options.rootEnv, ...service.env ?? {} };
+        }
+      }
       return { services: resolved, errors };
     }
+    function validateEnvRefs(env, pathPrefix, servicesByName, errors, serviceName) {
+      for (const [envVarName, envVar] of Object.entries(env)) {
+        if (envVar.type !== "service-ref")
+          continue;
+        const refName = envVar.service;
+        const target = servicesByName.get(refName);
+        if (!target) {
+          errors.push({
+            code: "UNKNOWN_SERVICE_REF",
+            message: `${pathPrefix}["${envVarName}"] references unknown service "${refName}".`,
+            ...serviceName ? { serviceName } : {}
+          });
+          continue;
+        }
+        if (target.type !== "web") {
+          errors.push({
+            code: "INVALID_SERVICE_REF_TYPE",
+            message: `${pathPrefix}["${envVarName}"] references service "${refName}" which is a ${target.type} service and has no URL. Only web services can be referenced.`,
+            ...serviceName ? { serviceName } : {}
+          });
+        }
+      }
+    }
   }
 });
 
@@ -23819,7 +24015,7 @@ var require_auto_detect = __commonJS({
           errors: [
             {
               code: "MULTIPLE_FRAMEWORKS_ROOT",
-              message: `Multiple frameworks detected at root: ${frameworkNames}. Use explicit experimentalServices config.`
+              message: `Multiple frameworks detected at root: ${frameworkNames}. Use explicit services config.`
             }
           ]
         };
@@ -23844,7 +24040,7 @@ var require_auto_detect = __commonJS({
             errors: [
               {
                 code: "MULTIPLE_FRAMEWORKS_SERVICE",
-                message: `Multiple frameworks detected in ${frontendLocation}/: ${frameworkNames}. Use explicit experimentalServices config.`
+                message: `Multiple frameworks detected in ${frontendLocation}/: ${frameworkNames}. Use explicit services config.`
               }
             ]
           };
@@ -23862,7 +24058,7 @@ var require_auto_detect = __commonJS({
         errors: [
           {
             code: "NO_SERVICES_CONFIGURED",
-            message: "No services detected. Configure experimentalServices in vercel.json or ensure a framework exists at project root, frontend/, or apps/web/."
+            message: "No services detected. Configure services in vercel.json or ensure a framework exists at project root, frontend/, or apps/web/."
           }
         ]
       };
@@ -23943,7 +24139,7 @@ var require_auto_detect = __commonJS({
             services: {},
             error: {
               code: "SERVICE_NAME_CONFLICT",
-              message: `Service name conflict: "${serviceName}" exists in both ${BACKEND_DIR}/ and ${SERVICES_DIR}/${serviceName}/. Rename one of the directories or use explicit experimentalServices config.`,
+              message: `Service name conflict: "${serviceName}" exists in both ${BACKEND_DIR}/ and ${SERVICES_DIR}/${serviceName}/. Rename one of the directories or use explicit services config.`,
               serviceName
             }
           };
@@ -23992,7 +24188,7 @@ var require_auto_detect = __commonJS({
         return {
           error: {
             code: "MULTIPLE_FRAMEWORKS_SERVICE",
-            message: `Multiple frameworks detected in ${dirPath}/: ${frameworkNames}. Use explicit experimentalServices config.`,
+            message: `Multiple frameworks detected in ${dirPath}/: ${frameworkNames}. Use explicit services config.`,
             serviceName
           }
         };
@@ -24126,7 +24322,7 @@ var require_detect_railway = __commonJS({
         if (frameworks.length === 0) {
           warnings.push({
             code: "SERVICE_SKIPPED",
-            message: `Skipped service in ${dirLabel}/: no framework detected. Configure it manually in experimentalServices.`
+            message: `Skipped service in ${dirLabel}/: no framework detected. Configure it manually in services.`
           });
           continue;
         }
@@ -24134,7 +24330,7 @@ var require_detect_railway = __commonJS({
           const names = frameworks.map((f) => f.name).join(", ");
           errors.push({
             code: "MULTIPLE_FRAMEWORKS_SERVICE",
-            message: `Multiple frameworks detected in ${dirLabel}/: ${names}. Use explicit experimentalServices config.`,
+            message: `Multiple frameworks detected in ${dirLabel}/: ${names}. Use explicit services config.`,
             serviceName
           });
           continue;
@@ -24332,10 +24528,17 @@ var require_detect_services = __commonJS({
         workers: []
       };
     }
+    function isEnvVars(env) {
+      if (!env)
+        return false;
+      const first = Object.values(env)[0];
+      return typeof first === "object" && first !== null;
+    }
     function withResolvedResult(resolved, inferred = null) {
       return {
         services: resolved.services,
         source: resolved.source,
+        useImplicitEnvInjection: resolved.useImplicitEnvInjection,
         routes: resolved.routes,
         errors: resolved.errors,
         warnings: resolved.warnings,
@@ -24371,12 +24574,14 @@ var require_detect_services = __commonJS({
         return withResolvedResult({
           services: [],
           source: "configured",
+          useImplicitEnvInjection: true,
           routes: emptyRoutes(),
           errors: [configError],
           warnings: []
         });
       }
-      const configuredServices = vercelConfig?.experimentalServices;
+      const hasNonEmptyPublicServicesConfig = vercelConfig?.services && Object.keys(vercelConfig.services).length > 0;
+      const configuredServices = hasNonEmptyPublicServicesConfig ? vercelConfig.services : vercelConfig?.experimentalServices;
       const hasConfiguredServices = configuredServices && Object.keys(configuredServices).length > 0;
       if (!hasConfiguredServices) {
         const railwayResult = await (0, import_detect_railway.detectRailwayServices)({ fs: scopedFs });
@@ -24384,6 +24589,7 @@ var require_detect_services = __commonJS({
           return withResolvedResult({
             services: [],
             source: "auto-detected",
+            useImplicitEnvInjection: true,
             routes: emptyRoutes(),
             errors: railwayResult.errors,
             warnings: railwayResult.warnings
@@ -24405,6 +24611,7 @@ var require_detect_services = __commonJS({
             {
               services: [],
               source: "auto-detected",
+              useImplicitEnvInjection: true,
               routes: emptyRoutes(),
               errors: result2.errors,
               warnings: railwayResult.warnings
@@ -24423,6 +24630,7 @@ var require_detect_services = __commonJS({
           const resolved = {
             services: result2.services,
             source: "auto-detected",
+            useImplicitEnvInjection: true,
             routes: routes2,
             errors: result2.errors,
             warnings: []
@@ -24441,6 +24649,7 @@ var require_detect_services = __commonJS({
           return withResolvedResult({
             services: [],
             source: "auto-detected",
+            useImplicitEnvInjection: true,
             routes: emptyRoutes(),
             errors: autoResult.errors,
             warnings: []
@@ -24449,11 +24658,12 @@ var require_detect_services = __commonJS({
         return withResolvedResult({
           services: [],
           source: "auto-detected",
+          useImplicitEnvInjection: true,
           routes: emptyRoutes(),
           errors: [
             {
               code: "NO_SERVICES_CONFIGURED",
-              message: "No services configured. Add `experimentalServices` to vercel.json."
+              message: "No services configured. Add `services` to vercel.json."
             }
           ],
           warnings: []
@@ -24462,12 +24672,21 @@ var require_detect_services = __commonJS({
       const result = await (0, import_resolve.resolveAllConfiguredServices)(
         configuredServices,
         scopedFs,
-        "configured"
+        "configured",
+        {
+          requireFileEntrypointForBackendRuntimes: Boolean(
+            hasNonEmptyPublicServicesConfig
+          ),
+          rootEnv: isEnvVars(vercelConfig?.env) ? vercelConfig?.env : void 0
+        }
       );
       const routes = generateServicesRoutes2(result.services);
       return withResolvedResult({
         services: result.services,
         source: "configured",
+        // GA `services` opts into explicit `env`; experimentalServices keeps
+        // the legacy `{NAME}_URL` injection.
+        useImplicitEnvInjection: !hasNonEmptyPublicServicesConfig,
         routes,
         errors: result.errors,
         warnings: []
@@ -24890,7 +25109,7 @@ var require_get_services_builders = __commonJS({
           errors: [
             {
               code: "NO_SERVICES_CONFIGURED",
-              message: "No services configured. Add `experimentalServices` to vercel.json."
+              message: "No services configured. Add `services` to vercel.json."
             }
           ],
           warnings: warningResponses,
@@ -24917,7 +25136,8 @@ var require_get_services_builders = __commonJS({
           ...result.routes.crons
         ] : null,
         errorRoutes: [],
-        services: result.services
+        services: result.services,
+        useImplicitEnvInjection: result.useImplicitEnvInjection
       };
     }
   }
@@ -25020,13 +25240,14 @@ var require_detect_builders = __commonJS({
       return publicBuilder ? publicBuilder.src.replace("/**/*", "") : null;
     }
     async function detectBuilders2(files, pkg, options = {}) {
-      const { experimentalServices: services, projectSettings = {} } = options;
+      const { services, experimentalServices, projectSettings = {} } = options;
       const { framework } = projectSettings;
-      const hasServicesConfig = services != null && typeof services === "object";
+      const configuredServices = services ?? experimentalServices;
+      const hasServicesConfig = configuredServices != null && typeof configuredServices === "object";
       if (hasServicesConfig || framework === "services") {
         return (0, import_get_services_builders.getServicesBuilders)({
           workPath: options.workPath,
-          configuredServices: services,
+          configuredServices,
           projectFramework: framework
         });
       }
@@ -38908,7 +39129,7 @@ var require_package = __commonJS({
   "../client/package.json"(exports, module) {
     module.exports = {
       name: "@vercel/client",
-      version: "17.4.2",
+      version: "17.5.0",
       main: "dist/index.js",
       typings: "dist/index.d.ts",
       homepage: "https://vercel.com",
@@ -55073,7 +55294,13 @@ var parseEnv = (env) => {
       return o;
     }, startingDict);
   }
-  return env;
+  const result = {};
+  for (const [key, value] of Object.entries(env)) {
+    if (typeof value === "string") {
+      result[key] = value;
+    }
+  }
+  return result;
 };
 
 // src/util/env/diff-env-files.ts
@@ -55193,6 +55420,9 @@ var envTargetChoices = import_constants.PROJECT_ENV_TARGET.map((t) => ({
   name: (0, import_title.default)(t),
   value: t
 }));
+function isValidEnvTarget(target) {
+  return typeof target === "undefined" || envTargetChoices.map((c) => c.value).includes(target);
+}
 function getEnvTargetPlaceholder() {
   return `<${envTargetChoices.map((c) => c.value).join(" | ")}>`;
 }
@@ -55965,7 +56195,7 @@ var cronsSchema = {
     }
   }
 };
-var serviceMountSchema = {
+var experimentalServicesMountSchema = {
   oneOf: [
     {
       type: "string",
@@ -55991,10 +56221,46 @@ var serviceMountSchema = {
     }
   ]
 };
-var serviceScheduleSchema = {
+var servicesMountSchema = {
+  oneOf: [
+    {
+      type: "string",
+      minLength: 1,
+      maxLength: 512
+    },
+    {
+      type: "object",
+      additionalProperties: false,
+      required: ["path"],
+      properties: {
+        path: {
+          type: "string",
+          minLength: 1,
+          maxLength: 512
+        }
+      }
+    }
+  ]
+};
+var staticServiceScheduleSchema = {
   type: "string",
   minLength: 9,
-  maxLength: 256
+  maxLength: 256,
+  not: { const: "<dynamic>" }
+};
+var serviceScheduleSchema = {
+  oneOf: [
+    {
+      type: "string",
+      minLength: 9,
+      maxLength: 256
+    },
+    {
+      type: "array",
+      minItems: 1,
+      items: staticServiceScheduleSchema
+    }
+  ]
 };
 var serviceQueueTopicSchema = {
   type: "object",
@@ -56036,13 +56302,55 @@ var serviceTopicsSchema = {
     }
   ]
 };
-var serviceCommonProperties = {
+var envVarNamesSchema = {
+  pattern: "^[A-Za-z_][A-Za-z0-9_]*$",
+  maxLength: 256
+};
+var envVarSchema = {
+  oneOf: [
+    {
+      type: "object",
+      additionalProperties: false,
+      required: ["type", "service"],
+      properties: {
+        type: { const: "service-ref" },
+        service: {
+          type: "string",
+          minLength: 1,
+          maxLength: 64,
+          pattern: "^[a-zA-Z]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$"
+        }
+      }
+    }
+  ]
+};
+var envVarRecordSchema = {
+  type: "object",
+  additionalProperties: envVarSchema,
+  propertyNames: envVarNamesSchema
+};
+var topLevelEnvSchema = {
+  oneOf: [
+    {
+      type: "object",
+      additionalProperties: { type: "string" },
+      propertyNames: envVarNamesSchema
+    },
+    envVarRecordSchema
+  ]
+};
+var experimentalServicesCommonProperties = {
+  entrypoint: {
+    type: "string",
+    minLength: 1,
+    maxLength: 512
+  },
   root: {
     type: "string",
     minLength: 1,
     maxLength: 512
   },
-  entrypoint: {
+  workspace: {
     type: "string",
     minLength: 1,
     maxLength: 512
@@ -56072,6 +56380,11 @@ var serviceCommonProperties = {
     minLength: 1,
     maxLength: 2048
   },
+  preDeployCommand: {
+    type: "string",
+    minLength: 1,
+    maxLength: 2048
+  },
   memory: {
     type: "integer",
     minimum: 128,
@@ -56102,8 +56415,8 @@ var serviceCommonProperties = {
     ]
   }
 };
-var serviceRoutableProperties = {
-  mount: serviceMountSchema,
+var experimentalServicesRoutableProperties = {
+  mount: experimentalServicesMountSchema,
   routePrefix: {
     type: "string",
     minLength: 1,
@@ -56115,14 +56428,31 @@ var serviceRoutableProperties = {
     maxLength: 63
   }
 };
-var serviceConfigSchema = {
+var servicesCommonProperties = {
+  entrypoint: experimentalServicesCommonProperties.entrypoint,
+  root: experimentalServicesCommonProperties.root,
+  framework: experimentalServicesCommonProperties.framework,
+  runtime: experimentalServicesCommonProperties.runtime,
+  buildCommand: experimentalServicesCommonProperties.buildCommand,
+  preDeployCommand: experimentalServicesCommonProperties.preDeployCommand,
+  memory: experimentalServicesCommonProperties.memory,
+  maxDuration: experimentalServicesCommonProperties.maxDuration,
+  includeFiles: experimentalServicesCommonProperties.includeFiles,
+  excludeFiles: experimentalServicesCommonProperties.excludeFiles,
+  env: envVarRecordSchema
+};
+var servicesRoutableProperties = {
+  mount: servicesMountSchema
+};
+var servicesRequiredProperties = ["type", "root"];
+var experimentalServicesServiceConfigSchema = {
   oneOf: [
     {
       type: "object",
       additionalProperties: false,
       properties: {
-        ...serviceCommonProperties,
-        ...serviceRoutableProperties,
+        ...experimentalServicesCommonProperties,
+        ...experimentalServicesRoutableProperties,
         type: {
           enum: ["web"]
         }
@@ -56133,7 +56463,7 @@ var serviceConfigSchema = {
       additionalProperties: false,
       required: ["type", "trigger", "schedule"],
       properties: {
-        ...serviceCommonProperties,
+        ...experimentalServicesCommonProperties,
         type: {
           const: "job"
         },
@@ -56148,7 +56478,7 @@ var serviceConfigSchema = {
       additionalProperties: false,
       required: ["type", "trigger", "topics"],
       properties: {
-        ...serviceCommonProperties,
+        ...experimentalServicesCommonProperties,
         type: {
           const: "job"
         },
@@ -56168,7 +56498,7 @@ var serviceConfigSchema = {
       additionalProperties: false,
       required: ["type", "trigger", "entrypoint"],
       properties: {
-        ...serviceCommonProperties,
+        ...experimentalServicesCommonProperties,
         type: {
           const: "job"
         },
@@ -56182,7 +56512,7 @@ var serviceConfigSchema = {
       additionalProperties: false,
       required: ["type"],
       properties: {
-        ...serviceCommonProperties,
+        ...experimentalServicesCommonProperties,
         type: {
           const: "worker"
         },
@@ -56207,7 +56537,7 @@ var serviceConfigSchema = {
       additionalProperties: false,
       required: ["type", "schedule"],
       properties: {
-        ...serviceCommonProperties,
+        ...experimentalServicesCommonProperties,
         type: {
           const: "cron"
         },
@@ -56216,13 +56546,81 @@ var serviceConfigSchema = {
     }
   ]
 };
+var servicesServiceConfigSchema = {
+  oneOf: [
+    {
+      type: "object",
+      additionalProperties: false,
+      required: servicesRequiredProperties,
+      properties: {
+        ...servicesCommonProperties,
+        ...servicesRoutableProperties,
+        type: {
+          enum: ["web"]
+        }
+      }
+    },
+    {
+      type: "object",
+      additionalProperties: false,
+      required: [...servicesRequiredProperties, "trigger", "schedule"],
+      properties: {
+        ...servicesCommonProperties,
+        type: {
+          const: "job"
+        },
+        trigger: {
+          const: "schedule"
+        },
+        schedule: serviceScheduleSchema
+      }
+    },
+    {
+      type: "object",
+      additionalProperties: false,
+      required: [...servicesRequiredProperties, "trigger", "topics"],
+      properties: {
+        ...servicesCommonProperties,
+        type: {
+          const: "job"
+        },
+        trigger: {
+          const: "queue"
+        },
+        topics: serviceTopicsSchema
+      }
+    },
+    {
+      type: "object",
+      additionalProperties: false,
+      required: [...servicesRequiredProperties, "trigger", "entrypoint"],
+      properties: {
+        ...servicesCommonProperties,
+        type: {
+          const: "job"
+        },
+        trigger: {
+          const: "workflow"
+        }
+      }
+    }
+  ]
+};
+var servicesSchema = {
+  type: "object",
+  propertyNames: {
+    pattern: "^[a-zA-Z]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$",
+    maxLength: 64
+  },
+  additionalProperties: servicesServiceConfigSchema
+};
 var experimentalServicesSchema = {
   type: "object",
   propertyNames: {
     pattern: "^[a-zA-Z]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$",
     maxLength: 64
   },
-  additionalProperties: serviceConfigSchema
+  additionalProperties: experimentalServicesServiceConfigSchema
 };
 var experimentalServiceGroupsSchema = {
   type: "object",
@@ -56256,13 +56654,27 @@ var vercelConfigSchema = {
     images: imagesSchema,
     crons: cronsSchema,
     bunVersion: { type: "string" },
+    env: topLevelEnvSchema,
+    services: servicesSchema,
     experimentalServices: experimentalServicesSchema,
     experimentalServiceGroups: experimentalServiceGroupsSchema
   }
 };
 var ajv = new import_ajv.default();
 var validate = ajv.compile(vercelConfigSchema);
+function isPublicServicesEnabled() {
+  return process.env.VERCEL_USE_SERVICES === "1" || process.env.VERCEL_USE_SERVICES?.toLowerCase() === "true";
+}
 function validateConfig(config) {
+  if (Object.prototype.hasOwnProperty.call(config, "services") && !isPublicServicesEnabled()) {
+    const fileName = config[import_client.fileNameSymbol] || "vercel.json";
+    const niceError = getPrettyError({
+      dataPath: "",
+      params: { additionalProperty: "services" }
+    });
+    niceError.message = `Invalid ${fileName} - ${niceError.message}`;
+    return niceError;
+  }
   if (!validate(config)) {
     if (validate.errors && validate.errors[0]) {
       const error = validate.errors[0];
@@ -56279,16 +56691,24 @@ function validateConfig(config) {
       link: "https://vercel.link/functions-and-builds"
     });
   }
-  if (config.experimentalServices && config.builds) {
+  const hasServices = Boolean(config.services);
+  const hasExperimentalServices = Boolean(config.experimentalServices);
+  if (hasServices && hasExperimentalServices) {
+    return new NowBuildError({
+      code: "SERVICES_AND_EXPERIMENTAL_SERVICES",
+      message: "The `services` property cannot be used in conjunction with the `experimentalServices` property. Please remove one of them."
+    });
+  }
+  if ((hasServices || hasExperimentalServices) && config.builds) {
     return new NowBuildError({
       code: "SERVICES_AND_BUILDS",
-      message: "The `experimentalServices` property cannot be used in conjunction with the `builds` property. Please remove one of them."
+      message: "The `services` property cannot be used in conjunction with the `builds` property. Please remove one of them."
     });
   }
-  if (config.experimentalServices && config.functions) {
+  if ((hasServices || hasExperimentalServices) && config.functions) {
     return new NowBuildError({
       code: "SERVICES_AND_FUNCTIONS",
-      message: "The `experimentalServices` property cannot be used in conjunction with the `functions` property. Please remove one of them."
+      message: "The `services` property cannot be used in conjunction with the `functions` property. Please remove one of them."
     });
   }
   if (config.experimentalServiceGroups && !config.experimentalServices) {
@@ -56314,7 +56734,7 @@ async function hasExperimentalServicesConfig(cwd) {
     );
     if (!config || config instanceof Error)
       return false;
-    return config.experimentalServices != null && typeof config.experimentalServices === "object";
+    return config.services != null && typeof config.services === "object" || config.experimentalServices != null && typeof config.experimentalServices === "object";
   } catch {
     return false;
   }
@@ -57135,6 +57555,7 @@ export {
   require_lib2 as require_lib,
   humanizePath,
   envTargetChoices,
+  isValidEnvTarget,
   getEnvTargetPlaceholder,
   listSubcommand,
   addSubcommand,