vercel 56.3.1 → 56.4.0

package/dist/commands-bulk.js

@@ -5,8 +5,15 @@ const require = __createRequire(import.meta.url);
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
+  computeGranularity,
+  formatText,
+  toGranularityMsFromDuration
+} from "./chunks/chunk-F5OMERHI.js";
+import {
+  getRollupColumnName,
+  handleApiError,
   indent_default
-} from "./chunks/chunk-A3NYPUKZ.js";
+} from "./chunks/chunk-Z7NPYIZ6.js";
 import {
   RoutesAddTelemetryClient,
   RoutesTelemetryClient
@@ -31,7 +38,7 @@ import {
   runInteractiveEditLoop,
   stripQuotes,
   validateActionFlags
-} from "./chunks/chunk-5R5FS7WB.js";
+} from "./chunks/chunk-VZGX4CKB.js";
 import {
   getRouteVersions
 } from "./chunks/chunk-AHU7WNL2.js";
@@ -51,10 +58,12 @@ import {
   requireProjectContext,
   validateRequiredArguments,
   withGlobalFlags as withGlobalFlags2
-} from "./chunks/chunk-ETWY3HX7.js";
+} from "./chunks/chunk-ORMDX3GR.js";
 import {
   normalizeRepeatableStringFilters,
-  parseTimeFlag
+  outputError,
+  parseTimeFlag,
+  resolveTimeRange
 } from "./chunks/chunk-BUZRVER7.js";
 import {
   OpenApiCache,
@@ -68,11 +77,11 @@ import {
   resolveOpenApiTagForTeamsCli,
   setAutoUpdate,
   tryOpenApiFallback
-} from "./chunks/chunk-IAEXF3FY.js";
+} from "./chunks/chunk-PEC4ROHM.js";
 import {
   getUpdateCommand,
   isGlobal
-} from "./chunks/chunk-26VWIAO5.js";
+} from "./chunks/chunk-IN3RG4AU.js";
 import {
   Now,
   addDomain,
@@ -94,14 +103,14 @@ import {
   require_format,
   require_jsonlines,
   setupDomain
-} from "./chunks/chunk-JAY74MG2.js";
+} from "./chunks/chunk-OSXJ6G4O.js";
 import {
   getGlobalPathConfig,
   persistAuthConfig,
   readLocalConfig,
   sleep,
   writeToConfigFile
-} from "./chunks/chunk-SAEAR237.js";
+} from "./chunks/chunk-S7HMSWGQ.js";
 import "./chunks/chunk-V5P25P7F.js";
 import {
   CHECKBOX_INSTRUCTIONS,
@@ -128,7 +137,7 @@ import {
 import {
   formatEnvironment,
   validateLsArgs
-} from "./chunks/chunk-2E3ZC3JA.js";
+} from "./chunks/chunk-JGXABANG.js";
 import {
   validateJsonOutput
 } from "./chunks/chunk-XPKWKPWA.js";
@@ -140,6 +149,7 @@ import {
   CREDIT_TYPE_LABELS,
   FLAG_CONDITION_LIST_COMPARATORS,
   FLAG_CONDITION_RHS_OPTIONAL_COMPARATORS,
+  FLAG_EVALUATIONS_GRANULARITIES,
   SUPPORTED_ADDON_ALIASES,
   SUPPORTED_CREDIT_TYPES,
   abortSubcommand,
@@ -225,6 +235,7 @@ import {
   enableSubcommand,
   enableSubcommand2,
   enableSubcommand3 as enableSubcommand4,
+  evaluationsSubcommand,
   fetchSubcommand,
   firewallCommand,
   flagsCommand,
@@ -260,6 +271,7 @@ import {
   ipBlocksListSubcommand,
   ipBlocksSubcommand,
   ipBlocksUnblockSubcommand,
+  isFlagEvaluationsGranularity,
   issueSubcommand,
   itemsSubcommand,
   listStoresSubcommand,
@@ -415,7 +427,7 @@ import {
   webAnalyticsSubcommand,
   webhooksCommand,
   whoamiCommand
-} from "./chunks/chunk-7ZECC3BE.js";
+} from "./chunks/chunk-2KNVJ7ET.js";
 import {
   addSubcommand as addSubcommand12,
   inspectSubcommand as inspectSubcommand8,
@@ -476,9 +488,9 @@ import "./chunks/chunk-OGG6UBXK.js";
 import "./chunks/chunk-LHFNIZ2P.js";
 import {
   main
-} from "./chunks/chunk-NMAHBCNK.js";
+} from "./chunks/chunk-K6YMSJMZ.js";
 import "./chunks/chunk-IB5L4LKZ.js";
-import "./chunks/chunk-AHSE4X6V.js";
+import "./chunks/chunk-JIK3GTU3.js";
 import {
   require_execa
 } from "./chunks/chunk-R6IGDGX3.js";
@@ -493,10 +505,10 @@ import {
 } from "./chunks/chunk-VXYGCOKL.js";
 import {
   ensureLink
-} from "./chunks/chunk-74TJ5D35.js";
-import "./chunks/chunk-UOB64NBX.js";
-import "./chunks/chunk-XOED7Y6Z.js";
-import "./chunks/chunk-M5LOXLMK.js";
+} from "./chunks/chunk-4QRRJEYO.js";
+import "./chunks/chunk-ENIJVO7C.js";
+import "./chunks/chunk-UA3D44SL.js";
+import "./chunks/chunk-EJNFC5AV.js";
 import {
   help
 } from "./chunks/chunk-DMSLNAVH.js";
@@ -561,7 +573,7 @@ import {
   selectOrg,
   toHost,
   ua_default
-} from "./chunks/chunk-RGOP4OYL.js";
+} from "./chunks/chunk-QX4337BT.js";
 import {
   AGENT_ACTION,
   AGENT_REASON,
@@ -2396,7 +2408,7 @@ async function activity(client) {
         return 0;
       }
       telemetry2.trackCliSubcommandLs(subcommandOriginal);
-      const listFn = (await import("./chunks/list-44G7AUFR.js")).default;
+      const listFn = (await import("./chunks/list-FJT44SB6.js")).default;
       return listFn(client, telemetry2);
     }
   }
@@ -3891,10 +3903,11 @@ async function resolveAgents(args) {
     checked: detected[i]
   }));
   const picked = await client.input.checkbox({
-    message: `Which coding agents should use the AI Gateway? ${import_chalk11.default.dim(
-      "Detected agents are pre-selected"
-    )}`,
-    instructions: CHECKBOX_INSTRUCTIONS,
+    message: `Which coding agents should use the AI Gateway?
+${import_chalk11.default.dim(
+      "  Detected agents are pre-selected \xB7"
+    )}${CHECKBOX_INSTRUCTIONS}`,
+    instructions: false,
     choices
   });
   const selected = picked.map((id) => getAgentById(id)).filter((a) => Boolean(a));
@@ -3935,9 +3948,7 @@ function defaultKeyName() {
 async function promptKeyName(client) {
   const fallback = defaultKeyName();
   const answer = await client.input.text({
-    message: `Key name? ${import_chalk12.default.dim(
-      "A new AI Gateway API key will be created for your coding agents"
-    )}`,
+    message: "Key name?",
     default: fallback
   });
   return answer.trim() || fallback;
@@ -4002,7 +4013,11 @@ async function ensureTeam2(client, opts) {
   if (canPrompt2 && !yes && !hasExplicitScopeFlag(client.argv)) {
     const org = await selectOrg(
       client,
-      `Which team? ${import_chalk12.default.dim("The API key is created under this team")}`
+      "Which team?",
+      void 0,
+      true,
+      void 0,
+      "The new AI Gateway API key will be created under this team:"
     );
     client.config.currentTeam = org.type === "team" ? org.id : void 0;
     return void 0;
@@ -4083,6 +4098,18 @@ function keychainLookup(opts = {}) {
   const cmd2 = `${SECURITY_BIN} find-generic-password -s '${KEYCHAIN_SERVICE}' -a '${KEYCHAIN_ACCOUNT}' -w 2>/dev/null`;
   return opts.fish ? `(${cmd2})` : `$(${cmd2})`;
 }
+var PBCOPY_BIN = "/usr/bin/pbcopy";
+function copyToClipboard(text2) {
+  try {
+    execFileSync(PBCOPY_BIN, {
+      input: text2,
+      stdio: ["pipe", "ignore", "ignore"]
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // src/util/ai-gateway/coding-agents/apply.ts
 function detectShellRc(home, override2) {
@@ -4327,7 +4354,10 @@ function mask(text2, secrets) {
   return redactSecretFields(maskKnownSecrets(text2, secrets));
 }
 function renderDiff(before, after, options = {}) {
-  const { secrets = [], context = 2, indent: indent2 = "  " } = options;
+  const { secrets = [], context = 2, indent: indent2 = "  ", color = true } = options;
+  const dim = color ? import_chalk13.default.dim : (s) => s;
+  const green = color ? import_chalk13.default.green : (s) => s;
+  const red2 = color ? import_chalk13.default.red : (s) => s;
   const lines = diffLines(before, after);
   if (!lines.some((l) => l.type !== " ")) {
     return "";
@@ -4345,7 +4375,7 @@ function renderDiff(before, after, options = {}) {
   lines.forEach((line2, idx) => {
     if (!keep[idx]) {
       if (!collapsed) {
-        rendered.push(import_chalk13.default.dim(`${indent2}  \u22EF`));
+        rendered.push(dim(`${indent2}  \u22EF`));
         collapsed = true;
       }
       return;
@@ -4353,11 +4383,11 @@ function renderDiff(before, after, options = {}) {
     collapsed = false;
     const text2 = mask(line2.text, secrets);
     if (line2.type === "+") {
-      rendered.push(import_chalk13.default.green(`${indent2}+ ${text2}`));
+      rendered.push(green(`${indent2}+ ${text2}`));
     } else if (line2.type === "-") {
-      rendered.push(import_chalk13.default.red(`${indent2}- ${text2}`));
+      rendered.push(red2(`${indent2}- ${text2}`));
     } else {
-      rendered.push(import_chalk13.default.dim(`${indent2}  ${text2}`));
+      rendered.push(dim(`${indent2}  ${text2}`));
     }
   });
   return rendered.join("\n");
@@ -4461,7 +4491,7 @@ function printReceiptPath(label, path3) {
 }
 function printKeyRow(key, opts = {}) {
   printAlignedLabel(
-    "API Key",
+    opts.created ? "New API Key" : "API Key",
     `${maskSecret(key)} \xB7 ${opts.keychain ? "macOS Keychain" : "Config files"}`
   );
 }
@@ -4480,6 +4510,31 @@ function printKey(key, opts = {}) {
   output_manager_default.print("\n");
   printKeyRow(key, opts);
 }
+function buildAgentPrompt(plan, apiKey) {
+  const sections = [
+    "Set up the Vercel AI Gateway for my coding agents by applying the file changes below.",
+    "For each file, create it if missing or edit it to match the diff (lines starting with `+` are added, `-` are removed; `\u22EF` marks skipped unchanged lines).",
+    `Any masked value (e.g. ${maskSecret(apiKey)}) is my AI Gateway API key, stored in my macOS Keychain; the config and shell already reference it with \`${"security find-generic-password"}\`, so leave those lookups as-is and do not ask me to paste the key.`,
+    ""
+  ];
+  for (const change2 of plan.changes) {
+    if (change2.status !== "create" && change2.status !== "update") {
+      continue;
+    }
+    const diff2 = renderDiff(change2.current ?? "", change2.next ?? "", {
+      secrets: [apiKey],
+      indent: "",
+      color: false
+    });
+    sections.push(`# ${change2.label} \u2014 ${change2.path}`);
+    if (diff2) {
+      sections.push(diff2);
+    }
+    sections.push("");
+  }
+  return `${sections.join("\n").trimEnd()}
+`;
+}
 
 // src/util/ai-gateway/coding-agents/consent.ts
 var import_chalk15 = __toESM(require_source(), 1);
@@ -4653,6 +4708,45 @@ async function runMachine(args) {
     overrides: args.overrides,
     shellRcOverride: args.shellRcOverride
   });
+  if (args.promptMode) {
+    if (!useKeychain) {
+      client.stdout.write(
+        `${JSON.stringify(
+          {
+            status: AGENT_STATUS.ERROR,
+            reason: "keychain_error",
+            message: "The `--apply prompt` mode needs the key in the macOS Keychain, but storing it failed, so no prompt was produced.",
+            skipped,
+            warnings: args.warnings
+          },
+          null,
+          2
+        )}
+`
+      );
+      return 1;
+    }
+    client.stdout.write(
+      `${JSON.stringify(
+        {
+          status: AGENT_STATUS.OK,
+          reason: "agent_prompt",
+          message: "Created the AI Gateway key and generated an agent prompt. No files were written.",
+          prompt: buildAgentPrompt(finalPlan, key),
+          configured: [],
+          skipped,
+          warnings: args.warnings,
+          notes: finalPlan.notes.flatMap(
+            (n) => n.notes.map((line2) => `${n.displayName}: ${line2}`)
+          )
+        },
+        null,
+        2
+      )}
+`
+    );
+    return 0;
+  }
   const results = await applyPlan(finalPlan, { backup });
   client.stdout.write(
     `${JSON.stringify(
@@ -4761,6 +4855,11 @@ var AiGatewayCodingAgentsSetupTelemetryClient = class extends TelemetryClient {
       this.trackCliOption({ option: "shell-rc", value: this.redactedValue });
     }
   }
+  trackCliOptionApply(apply) {
+    if (apply) {
+      this.trackCliOption({ option: "apply", value: apply });
+    }
+  }
   trackCliFlagYes(yes) {
     if (yes) {
       this.trackCliFlag("yes");
@@ -4796,6 +4895,7 @@ async function codingAgentsSetup(client, argv) {
   const noKeychain = opts["--no-keychain"];
   const agentConfig = opts["--agent-config"];
   const shellRcOverride = opts["--shell-rc"];
+  const applyMode = opts["--apply"];
   const yes = opts["--yes"];
   telemetry2.trackCliOptionAgent(agentFlags);
   telemetry2.trackCliFlagAll(all);
@@ -4811,6 +4911,7 @@ async function codingAgentsSetup(client, argv) {
   telemetry2.trackCliFlagNoKeychain(noKeychain);
   telemetry2.trackCliOptionAgentConfig(agentConfig);
   telemetry2.trackCliOptionShellRc(shellRcOverride);
+  telemetry2.trackCliOptionApply(applyMode);
   telemetry2.trackCliFlagYes(yes);
   const machine = shouldEmitNonInteractiveCommandError(client);
   const canPrompt2 = Boolean(client.stdin.isTTY) && !machine;
@@ -4840,6 +4941,22 @@ async function codingAgentsSetup(client, argv) {
       `Invalid expiration "${expiration}". Must be one of: ${VALID_EXPIRY_VALUES.join(", ")}.`
     );
   }
+  if (applyMode !== void 0 && applyMode !== "edit" && applyMode !== "prompt") {
+    return failValidation(
+      client,
+      machine,
+      AGENT_REASON.INVALID_ARGUMENTS,
+      `Invalid --apply "${applyMode}". Must be "edit" or "prompt".`
+    );
+  }
+  if (applyMode === "prompt" && !wantKeychain) {
+    return failValidation(
+      client,
+      machine,
+      AGENT_REASON.INVALID_ARGUMENTS,
+      "The `--apply prompt` mode needs the macOS Keychain so the prompt never contains your plaintext key. Run on macOS without --no-keychain, or use `--apply edit`."
+    );
+  }
   const flagExpiresAt = expiration && expiration !== "none" ? presetToExpiresAt(expiration) : void 0;
   const overrides = {};
   for (const pair of agentConfig ?? []) {
@@ -5049,7 +5166,8 @@ async function codingAgentsSetup(client, argv) {
       home,
       alreadyConfigured,
       // With nothing consented there is nothing to rotate or reconfigure.
-      reconfigure: Boolean(reconfigure) && agents.length > 0
+      reconfigure: Boolean(reconfigure) && agents.length > 0,
+      promptMode: applyMode === "prompt"
     });
   }
   if (alreadyConfigured) {
@@ -5113,11 +5231,32 @@ async function codingAgentsSetup(client, argv) {
     );
     return 1;
   }
-  if (changed.length > 0 && canPrompt2 && !yes) {
-    const confirmed = await client.input.confirm("Apply these changes?", true);
-    if (!confirmed) {
-      printStatus("Aborted. No files were changed.");
-      return 0;
+  let applyAction = applyMode === "prompt" ? "copy" : "apply";
+  if (applyMode === void 0 && changed.length > 0 && canPrompt2 && !yes) {
+    if (useKeychain) {
+      const choice = await client.input.select({
+        message: "Apply these changes?",
+        choices: [
+          { name: "Yes, write the files now", value: "apply" },
+          { name: "Copy a prompt for my agent", value: "copy" },
+          { name: "Cancel", value: "cancel" }
+        ],
+        default: "apply"
+      });
+      if (choice === "cancel") {
+        printStatus("Aborted. No files were changed.");
+        return 0;
+      }
+      applyAction = choice;
+    } else {
+      const confirmed = await client.input.confirm(
+        "Apply these changes?",
+        true
+      );
+      if (!confirmed) {
+        printStatus("Aborted. No files were changed.");
+        return 0;
+      }
     }
   }
   let keySource;
@@ -5141,6 +5280,12 @@ async function codingAgentsSetup(client, argv) {
     throw err;
   }
   if (useKeychain && !storeKeyInKeychain(keySource.key)) {
+    if (applyAction === "copy") {
+      output_manager_default.error(
+        "Failed to store the key in the macOS Keychain, so a prompt would expose your plaintext key. Re-run and choose Apply, or pass --no-keychain to write the key to the config files."
+      );
+      return 1;
+    }
     printWarning(
       "Failed to store the key in the macOS Keychain; writing it to the config files instead."
     );
@@ -5153,11 +5298,36 @@ async function codingAgentsSetup(client, argv) {
     overrides,
     shellRcOverride
   });
+  if (applyAction === "copy") {
+    const promptText = buildAgentPrompt(applyPlanResult, keySource.key);
+    if (applyMode === "prompt") {
+      const copied = copyToClipboard(promptText);
+      printStatus(
+        copied ? "Created the key and generated an agent prompt (copied to clipboard; also written to stdout)." : "Created the key and generated an agent prompt (written to stdout)."
+      );
+      client.stdout.write(`${promptText}
+`);
+    } else if (copyToClipboard(promptText)) {
+      printStatus(
+        "Prompt copied to clipboard. Paste it into your coding agent to apply the changes."
+      );
+    } else {
+      output_manager_default.debug("pbcopy failed or unavailable");
+      printStatus("Could not access the clipboard \u2014 prompt printed below:");
+      client.stdout.write(`${promptText}
+`);
+    }
+    printKey(keySource.key, { keychain: true, created: keySource.created });
+    return 0;
+  }
   const results = await applyPlan(applyPlanResult, { backup: !noBackup });
   if (results.length === 0 && keySource.created) {
     output_manager_default.print("\n");
-    printAlignedLabel("Rotated", "AI Gateway API key", { gutter: "\u2713" });
-    printKeyRow(keySource.key, { keychain: useKeychain });
+    printAlignedLabel("Rotated", "AI Gateway API key");
+    printKeyRow(keySource.key, {
+      keychain: useKeychain,
+      created: keySource.created
+    });
     output_manager_default.print(import_chalk16.default.dim("  No config files changed.\n"));
   }
   if (results.length > 0) {
@@ -5171,7 +5341,10 @@ async function codingAgentsSetup(client, argv) {
         result.path
       );
     }
-    printKeyRow(keySource.key, { keychain: useKeychain });
+    printKeyRow(keySource.key, {
+      keychain: useKeychain,
+      created: keySource.created
+    });
     if (results.some((r) => r.backupPath)) {
       output_manager_default.print(import_chalk16.default.dim("  Previous files saved alongside as .bak\n"));
     }
@@ -5888,12 +6061,12 @@ async function alerts(client) {
   switch (subcommand) {
     case "inspect": {
       telemetry2.trackCliSubcommandInspect(subcommandOriginal);
-      const inspectFn = (await import("./chunks/inspect-BX26XAK2.js")).default;
+      const inspectFn = (await import("./chunks/inspect-Q5BKZNVI.js")).default;
       return inspectFn(client, args);
     }
     case "rules": {
       telemetry2.trackCliSubcommandRules(args[0] ?? "ls");
-      const rulesFn = (await import("./chunks/rules-OEOYTZ6U.js")).default;
+      const rulesFn = (await import("./chunks/rules-SQFCUKWS.js")).default;
       const rulesArgs = [...args];
       const project = parsedArgs.flags["--project"];
       const format4 = parsedArgs.flags["--format"];
@@ -5907,7 +6080,7 @@ async function alerts(client) {
     }
     default: {
       telemetry2.trackCliSubcommandLs(subcommandOriginal);
-      const listFn = (await import("./chunks/list-VLFAOPR5.js")).default;
+      const listFn = (await import("./chunks/list-N7OA4FBI.js")).default;
       return listFn(client, telemetry2);
     }
   }
@@ -30014,6 +30187,12 @@ var FlagsTelemetryClient = class extends TelemetryClient {
       value: actual
     });
   }
+  trackCliSubcommandEvaluations(actual) {
+    this.trackCliSubcommand({
+      subcommand: "evaluations",
+      value: actual
+    });
+  }
   trackCliSubcommandOpen(actual) {
     this.trackCliSubcommand({
       subcommand: "open",
@@ -30271,10 +30450,11 @@ function quoteArg(value) {
 function getProjectNameFromFlags(flags) {
   return flags["--project"];
 }
-function getLinkedFlagsProject(client, projectName) {
+function getLinkedFlagsProject(client, projectName, options) {
   return resolveProjectContext({
     client,
-    projectNameOrId: projectName
+    projectNameOrId: projectName,
+    projectNotFoundHandling: options?.projectNotFoundHandling
   });
 }
 
@@ -30528,6 +30708,13 @@ function formatVariantForDisplay(variant) {
   }
   return parts.join(" ");
 }
+function formatVariantListSummary(variant) {
+  const value = formatVariantValue(variant.value);
+  if (!variant.label) {
+    return value;
+  }
+  return `${value}: ${import_chalk117.default.gray(variant.label)}`;
+}
 function formatAvailableVariants(variants) {
   return variants.map((v) => `  - ${formatAvailableVariant(v)}`).join("\n");
 }
@@ -30861,13 +31048,6 @@ function getSortedEnvironmentEntries(flag, environments) {
 function hasCustomConfigurationEnabled(envConfig) {
   return Boolean(envConfig.targets && Object.keys(envConfig.targets).length > 0) || envConfig.rules.length > 0 || envConfig.fallthrough.type === "split" || envConfig.fallthrough.type === "rollout";
 }
-function formatVariantListSummary(variant) {
-  const value = formatVariantValue(variant.value);
-  if (!variant.label) {
-    return value;
-  }
-  return `${value}: ${import_chalk119.default.gray(variant.label)}`;
-}
 
 // src/commands/flags/inspect.ts
 async function inspect4(client, argv) {
@@ -32074,6 +32254,341 @@ function buildNextPageCommand2(flagArg, flags, nextCursor) {
   return `flags versions ${quoteArg(flagArg)}${baseFlags}${environmentFlag} --cursor ${quoteArg(nextCursor)}`;
 }
 
+// src/util/telemetry/commands/flags/evaluations.ts
+var FlagsEvaluationsTelemetryClient = class extends TelemetryClient {
+  trackCliArgumentFlag(flag) {
+    if (flag) {
+      this.trackCliArgument({
+        arg: "flag",
+        value: this.redactedValue
+      });
+    }
+  }
+  trackCliOptionSince(since) {
+    if (since) {
+      this.trackCliOption({
+        option: "since",
+        value: this.redactedValue
+      });
+    }
+  }
+  trackCliOptionUntil(until) {
+    if (until) {
+      this.trackCliOption({
+        option: "until",
+        value: this.redactedValue
+      });
+    }
+  }
+  trackCliOptionGranularity(granularity) {
+    if (granularity) {
+      this.trackCliOption({
+        option: "granularity",
+        value: isFlagEvaluationsGranularity(granularity) ? granularity : this.redactedValue
+      });
+    }
+  }
+  trackCliFlagJson(json) {
+    if (json) {
+      this.trackCliFlag("json");
+    }
+  }
+};
+
+// src/commands/flags/evaluations.ts
+var FLAG_EVALUATIONS_API_URL = "https://vercel.com/api/observability/metrics";
+var FLAG_EVALUATIONS_METRIC = "vercel.flag_evaluation.flag_evaluations";
+var FLAG_EVALUATIONS_AGGREGATION = "sum";
+var FLAG_EVALUATIONS_ROLLUP = getRollupColumnName(
+  FLAG_EVALUATIONS_METRIC,
+  FLAG_EVALUATIONS_AGGREGATION
+);
+var DISPLAY_GROUP_BY = "Variants";
+var QUERY_ENGINE_GROUP_BY = "flagVariant";
+var MAX_VARIANTS = 100;
+function getFlagEvaluationsApiUrl(ownerId) {
+  const url = new URL(
+    process.env.VERCEL_FLAG_EVALUATIONS_API_URL || FLAG_EVALUATIONS_API_URL
+  );
+  url.searchParams.set("ownerId", ownerId);
+  return url.href;
+}
+function escapeODataString(value) {
+  return value.replace(/'/g, "''");
+}
+function alignTimeRange(startTime, endTime, granularity) {
+  const granularityMs = toGranularityMsFromDuration(granularity);
+  return {
+    startTime: new Date(
+      Math.floor(startTime.getTime() / granularityMs) * granularityMs
+    ),
+    endTime: new Date(
+      Math.ceil(endTime.getTime() / granularityMs) * granularityMs
+    )
+  };
+}
+function getVariantDisplayName(flag, variantId2) {
+  if (!variantId2 || variantId2 === "(not set)") {
+    return "Default in Code";
+  }
+  const variant = flag.variants.find((item) => item.id === variantId2);
+  return variant ? formatVariantListSummary(variant) : variantId2;
+}
+function handleCommandError(client, error, jsonOutput) {
+  if (!jsonOutput) {
+    printError(error);
+    return 1;
+  }
+  if (isAPIError(error)) {
+    return outputError(
+      client,
+      true,
+      error.code || "API_ERROR",
+      error.serverMessage || `API error (${error.status}).`
+    );
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  return outputError(client, true, "UNEXPECTED_ERROR", message);
+}
+function handleMetricsQueryError(client, error, jsonOutput) {
+  return isAPIError(error) ? handleApiError(error, jsonOutput, client) : handleCommandError(client, error, jsonOutput);
+}
+function limitEvaluationVariants(response) {
+  if (response.summary.length <= MAX_VARIANTS) {
+    return { response, truncated: false };
+  }
+  const summary = response.summary.slice(0, MAX_VARIANTS);
+  const visibleVariants = new Set(
+    summary.map((row) => row[QUERY_ENGINE_GROUP_BY])
+  );
+  return {
+    response: {
+      ...response,
+      summary,
+      data: response.data?.filter(
+        (row) => visibleVariants.has(row[QUERY_ENGINE_GROUP_BY])
+      )
+    },
+    truncated: true
+  };
+}
+function formatEvaluationsJson(flag, response, startTime, endTime, granularity, truncated) {
+  return `${JSON.stringify(
+    {
+      flag: flag.slug,
+      variants: Object.fromEntries(
+        flag.variants.map(({ id, value }) => [id, value])
+      ),
+      startTime: startTime.toISOString(),
+      endTime: endTime.toISOString(),
+      granularity,
+      truncated,
+      buckets: (response.data ?? []).map((row) => ({
+        timestamp: row.timestamp,
+        variant: row[QUERY_ENGINE_GROUP_BY] ?? null,
+        evaluations: row[FLAG_EVALUATIONS_ROLLUP] ?? null
+      }))
+    },
+    null,
+    2
+  )}
+`;
+}
+async function evaluations(client, argv) {
+  const telemetry2 = new FlagsEvaluationsTelemetryClient({
+    opts: { store: client.telemetryEventStore }
+  });
+  let parsedArgs;
+  const flagsSpecification = getFlagsSpecification(
+    evaluationsSubcommand.options
+  );
+  try {
+    parsedArgs = parseArguments(argv, flagsSpecification);
+  } catch (error) {
+    printError(error);
+    return 1;
+  }
+  const { args, flags } = parsedArgs;
+  const [flagArgument] = args;
+  const projectName = getProjectNameFromFlags(flags);
+  const since = flags["--since"];
+  const until = flags["--until"];
+  const granularity = flags["--granularity"];
+  telemetry2.trackCliArgumentFlag(flagArgument);
+  telemetry2.trackCliOptionProject(projectName);
+  telemetry2.trackCliOptionSince(since);
+  telemetry2.trackCliOptionUntil(until);
+  telemetry2.trackCliOptionGranularity(granularity);
+  telemetry2.trackCliFlagJson(flags["--json"]);
+  const jsonOutput = flags["--json"] ?? false;
+  if (!flagArgument) {
+    return outputError(
+      client,
+      jsonOutput,
+      "MISSING_FLAG",
+      `Missing required argument: flag. Usage: ${getCommandName("flags evaluations <flag>")}`
+    );
+  }
+  if (granularity && !isFlagEvaluationsGranularity(granularity)) {
+    return outputError(
+      client,
+      jsonOutput,
+      "INVALID_GRANULARITY",
+      `Invalid granularity "${granularity}". Use one of: ${FLAG_EVALUATIONS_GRANULARITIES.join(", ")}.`
+    );
+  }
+  let startTime;
+  let endTime;
+  let resolvedGranularity;
+  try {
+    ({ startTime, endTime } = resolveTimeRange(since, until));
+    if (startTime.getTime() >= endTime.getTime()) {
+      throw new Error("The start time must be before the end time.");
+    }
+    resolvedGranularity = computeGranularity(
+      endTime.getTime() - startTime.getTime(),
+      granularity
+    );
+    ({ startTime, endTime } = alignTimeRange(
+      startTime,
+      endTime,
+      resolvedGranularity.duration
+    ));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return outputError(client, jsonOutput, "INVALID_TIME", message);
+  }
+  if (!jsonOutput && resolvedGranularity.adjusted && resolvedGranularity.notice) {
+    output_manager_default.log(`Notice: ${resolvedGranularity.notice}`);
+  }
+  let link;
+  try {
+    link = await getLinkedFlagsProject(client, projectName, {
+      projectNotFoundHandling: jsonOutput ? "return" : "report"
+    });
+  } catch (error) {
+    return handleCommandError(client, error, jsonOutput);
+  }
+  if (link.status === "error") {
+    return jsonOutput ? outputError(
+      client,
+      true,
+      "PROJECT_RESOLUTION_FAILED",
+      "Unable to resolve the requested Vercel project."
+    ) : link.exitCode;
+  }
+  if (link.status === "not_linked") {
+    const code2 = projectName ? "PROJECT_NOT_FOUND" : "NOT_LINKED";
+    const message = projectName ? `Project "${projectName}" was not found in the current scope.` : `Your codebase isn't linked to a project on Vercel. Pass --project <name>, or run ${getCommandName("link")} to link it.`;
+    return outputError(client, jsonOutput, code2, message);
+  }
+  client.config.currentTeam = link.org.type === "team" ? link.org.id : void 0;
+  const { project, org } = link;
+  let flag;
+  try {
+    flag = await getFlag(client, project.id, flagArgument);
+  } catch (error) {
+    return handleCommandError(client, error, jsonOutput);
+  }
+  if (!jsonOutput) {
+    output_manager_default.spinner("Querying flag evaluations...");
+  }
+  const scope = {
+    type: "project",
+    ownerId: org.id,
+    projectIds: [project.id]
+  };
+  let response;
+  try {
+    const body = {
+      scope,
+      reason: "flag_evaluation_chart",
+      event: "flagEvaluation",
+      rollups: {
+        [FLAG_EVALUATIONS_ROLLUP]: {
+          measure: "flagEvaluations",
+          aggregation: "sum"
+        }
+      },
+      orderBy: FLAG_EVALUATIONS_ROLLUP,
+      orderDirection: "desc",
+      groupBy: [QUERY_ENGINE_GROUP_BY],
+      // Fetch one extra variant so output can disclose truncation reliably.
+      limit: MAX_VARIANTS + 1,
+      limitRanking: "single_pass",
+      tailRollup: "truncate",
+      summaryOnly: false,
+      filter: `flagKey eq '${escapeODataString(flag.slug)}'`,
+      granularity: resolvedGranularity.duration,
+      startTime: startTime.toISOString(),
+      endTime: endTime.toISOString()
+    };
+    response = await client.fetch(
+      getFlagEvaluationsApiUrl(org.id),
+      {
+        method: "POST",
+        body: JSON.stringify(body),
+        headers: { "Content-Type": "application/json" },
+        useCurrentTeam: false,
+        bailOn429: true
+      }
+    );
+  } catch (error) {
+    return handleMetricsQueryError(client, error, jsonOutput);
+  } finally {
+    if (!jsonOutput) {
+      output_manager_default.stopSpinner();
+    }
+  }
+  const limited = limitEvaluationVariants(response);
+  if (jsonOutput) {
+    client.stdout.write(
+      formatEvaluationsJson(
+        flag,
+        limited.response,
+        startTime,
+        endTime,
+        resolvedGranularity.duration,
+        limited.truncated
+      )
+    );
+  } else {
+    if (limited.truncated) {
+      output_manager_default.warn(
+        `Results are limited to the ${MAX_VARIANTS} most evaluated variants.`
+      );
+    }
+    client.stdout.write(
+      formatText(
+        {
+          ...limited.response,
+          data: limited.response.data?.map((row) => ({
+            ...row,
+            [DISPLAY_GROUP_BY]: row[QUERY_ENGINE_GROUP_BY] ?? null
+          }))
+        },
+        {
+          metric: FLAG_EVALUATIONS_METRIC,
+          metricUnit: "count",
+          aggregation: FLAG_EVALUATIONS_AGGREGATION,
+          groupBy: [DISPLAY_GROUP_BY],
+          scope,
+          projectName: project.name,
+          teamName: org.slug,
+          periodStart: startTime.toISOString(),
+          periodEnd: endTime.toISOString(),
+          granularity: resolvedGranularity.duration,
+          presentation: {
+            compact: true,
+            formatGroupValue: (_field, value) => getVariantDisplayName(flag, value)
+          }
+        }
+      )
+    );
+  }
+  return 0;
+}
+
 // src/commands/flags/add.ts
 var import_chalk122 = __toESM(require_source(), 1);
 import { randomBytes as randomBytes2 } from "crypto";
@@ -38579,6 +39094,7 @@ var COMMAND_CONFIG30 = {
   ls: getCommandAliases(listSubcommand11),
   inspect: getCommandAliases(inspectSubcommand4),
   versions: getCommandAliases(versionsSubcommand),
+  evaluations: getCommandAliases(evaluationsSubcommand),
   create: getCommandAliases(createSubcommand4),
   open: getCommandAliases(openSubcommand2),
   update: getCommandAliases(updateSubcommand3),
@@ -38647,6 +39163,14 @@ async function main17(client) {
     case "versions":
       telemetry2.trackCliSubcommandVersions(subcommandOriginal);
       return versions(client, needHelp ? [...args, "--help"] : args);
+    case "evaluations":
+      if (needHelp) {
+        telemetry2.trackCliFlagHelp("flags", subcommandOriginal);
+        printHelp(evaluationsSubcommand);
+        return 2;
+      }
+      telemetry2.trackCliSubcommandEvaluations(subcommandOriginal);
+      return evaluations(client, args);
     case "open":
       if (needHelp) {
         telemetry2.trackCliFlagHelp("flags", subcommandOriginal);
@@ -48278,7 +48802,7 @@ async function metrics(client) {
         return 0;
       }
       telemetry2.trackCliSubcommandSchema(subcommandOriginal);
-      const schemaFn = (await import("./chunks/schema-OEWP27BI.js")).default;
+      const schemaFn = (await import("./chunks/schema-PWSCMD24.js")).default;
       return schemaFn(client, telemetry2);
     }
     default: {
@@ -48291,7 +48815,7 @@ async function metrics(client) {
         output_manager_default.print(help(metricsCommand, { columns: client.stderr.columns }));
         return 2;
       }
-      const queryFn = (await import("./chunks/query-XC3Y3EBD.js")).default;
+      const queryFn = (await import("./chunks/query-QDOKUCHX.js")).default;
       return queryFn(client, telemetry2);
     }
   }
@@ -58871,7 +59395,7 @@ async function main26(client) {
         return 2;
       }
       telemetry2.trackCliSubcommandEdit(subcommandOriginal);
-      return (await import("./chunks/edit-ML2P3MKK.js")).default(client, args);
+      return (await import("./chunks/edit-KO5KX4WU.js")).default(client, args);
     case "delete":
       if (needHelp) {
         telemetry2.trackCliFlagHelp("routes", subcommandOriginal);
@@ -58879,7 +59403,7 @@ async function main26(client) {
         return 2;
       }
       telemetry2.trackCliSubcommandDelete(subcommandOriginal);
-      return (await import("./chunks/delete-BO3RQ3F6.js")).default(client, args);
+      return (await import("./chunks/delete-AUDPLCMU.js")).default(client, args);
     case "enable":
       if (needHelp) {
         telemetry2.trackCliFlagHelp("routes", subcommandOriginal);
@@ -58887,7 +59411,7 @@ async function main26(client) {
         return 2;
       }
       telemetry2.trackCliSubcommandEnable(subcommandOriginal);
-      return (await import("./chunks/enable-E5YCEICZ.js")).default(client, args);
+      return (await import("./chunks/enable-I5HE32DI.js")).default(client, args);
     case "disable":
       if (needHelp) {
         telemetry2.trackCliFlagHelp("routes", subcommandOriginal);
@@ -58895,7 +59419,7 @@ async function main26(client) {
         return 2;
       }
       telemetry2.trackCliSubcommandDisable(subcommandOriginal);
-      return (await import("./chunks/disable-WRXXRGYR.js")).default(client, args);
+      return (await import("./chunks/disable-WFPXR7GZ.js")).default(client, args);
     case "reorder":
       if (needHelp) {
         telemetry2.trackCliFlagHelp("routes", subcommandOriginal);
@@ -58903,7 +59427,7 @@ async function main26(client) {
         return 2;
       }
       telemetry2.trackCliSubcommandReorder(subcommandOriginal);
-      return (await import("./chunks/reorder-L56M5KP3.js")).default(client, args);
+      return (await import("./chunks/reorder-L2M3YGJ4.js")).default(client, args);
     case "export":
       if (needHelp) {
         telemetry2.trackCliFlagHelp("routes", subcommandOriginal);
@@ -58911,7 +59435,7 @@ async function main26(client) {
         return 2;
       }
       telemetry2.trackCliSubcommandExport(subcommandOriginal);
-      return (await import("./chunks/export-EUFPKG5T.js")).default(client, args);
+      return (await import("./chunks/export-4Y5L2TOT.js")).default(client, args);
     case "publish":
       if (needHelp) {
         telemetry2.trackCliFlagHelp("routes", subcommandOriginal);
@@ -58919,7 +59443,7 @@ async function main26(client) {
         return 2;
       }
       telemetry2.trackCliSubcommandPublish(subcommandOriginal);
-      return (await import("./chunks/publish-C3QAGQJ7.js")).default(client, args);
+      return (await import("./chunks/publish-DUTEBRX3.js")).default(client, args);
     case "restore":
       if (needHelp) {
         telemetry2.trackCliFlagHelp("routes", subcommandOriginal);
@@ -58927,7 +59451,7 @@ async function main26(client) {
         return 2;
       }
       telemetry2.trackCliSubcommandRestore(subcommandOriginal);
-      return (await import("./chunks/restore-E5LGXKS3.js")).default(client, args);
+      return (await import("./chunks/restore-BVDNAJVC.js")).default(client, args);
     case "discard-staging":
       if (needHelp) {
         telemetry2.trackCliFlagHelp("routes", subcommandOriginal);
@@ -58935,7 +59459,7 @@ async function main26(client) {
         return 2;
       }
       telemetry2.trackCliSubcommandDiscardStaging(subcommandOriginal);
-      return (await import("./chunks/discard-5XOTKSVP.js")).default(client, args);
+      return (await import("./chunks/discard-RVFKIZZG.js")).default(client, args);
     default:
       output_manager_default.error(getInvalidSubcommand(COMMAND_CONFIG41));
       output_manager_default.print(help(routesCommand, { columns: client.stderr.columns }));
@@ -63546,25 +64070,25 @@ async function vcr(client) {
   switch (subcommand) {
     case "ls":
       telemetry2.trackCliSubcommandLs(subcommandOriginal);
-      return (await import("./chunks/ls-42JFBIDV.js")).default(client, args, telemetry2);
+      return (await import("./chunks/ls-H52WO65Y.js")).default(client, args, telemetry2);
     case "inspect":
       telemetry2.trackCliSubcommandInspect(subcommandOriginal);
-      return (await import("./chunks/inspect-W4SOI7QI.js")).default(client, args, telemetry2);
+      return (await import("./chunks/inspect-PJDCPARM.js")).default(client, args, telemetry2);
     case "add":
       telemetry2.trackCliSubcommandAdd(subcommandOriginal);
-      return (await import("./chunks/add-ANWCBEDB.js")).default(client, args, telemetry2);
+      return (await import("./chunks/add-2HLAH42D.js")).default(client, args, telemetry2);
     case "rm":
       telemetry2.trackCliSubcommandRm(subcommandOriginal);
-      return (await import("./chunks/rm-AG3FDPTQ.js")).default(client, args, telemetry2);
+      return (await import("./chunks/rm-VHWBHG3A.js")).default(client, args, telemetry2);
     case "login":
       telemetry2.trackCliSubcommandLogin(subcommandOriginal);
-      return (await import("./chunks/login-CL57KXDR.js")).default(client, args, telemetry2);
+      return (await import("./chunks/login-BPE774JW.js")).default(client, args, telemetry2);
     case "tag":
       telemetry2.trackCliSubcommandTag(subcommandOriginal);
-      return (await import("./chunks/tags-RUHWH6XO.js")).default(client, args, telemetry2);
+      return (await import("./chunks/tags-BT7ZGJP2.js")).default(client, args, telemetry2);
     case "image":
       telemetry2.trackCliSubcommandImage(subcommandOriginal);
-      return (await import("./chunks/image-5WOBJQFO.js")).default(client, args, telemetry2);
+      return (await import("./chunks/image-QC5MVWKN.js")).default(client, args, telemetry2);
     default:
       output_manager_default.error(getInvalidSubcommand(COMMAND_CONFIG47));
       output_manager_default.print(help(vcrCommand, { columns: client.stderr.columns }));