@koda-sl/baker-cli 0.449.0 → 0.451.0-dev.b2a4eba2b

package/dist/google-M7KEXVK5.js

@@ -1,1872 +0,0 @@
-import {
-  AD_COPY_LIST_USAGE,
-  failWriteValidation,
-  keywordEntries,
-  listFlag,
-  loadJsonFileArg,
-  mergePayload,
-  microsFlag,
-  requireCustomerId,
-  requireStringFlag,
-  requireTarget,
-  stageCreate,
-  stageGoogleOp,
-  stageGoogleOps,
-  stageTarget,
-  stageUpdate
-} from "./chunk-LLOOWRBB.js";
-import {
-  repeatedFlagValues,
-  repeatedValues
-} from "./chunk-ERSX3MKH.js";
-import {
-  booleanWordPositionalError
-} from "./chunk-T4DD5YMP.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-F2S5BLPE.js";
-import {
-  ACCOUNT_URL_OPTIONS_LOCATION,
-  ACCOUNT_URL_OPTIONS_NOT_STAGEABLE
-} from "./chunk-XCM6XWOB.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import "./chunk-WTOYCUKH.js";
-import "./chunk-DZSIUEGH.js";
-import "./chunk-VAJBWA2U.js";
-import "./chunk-HRYOZUSK.js";
-import "./chunk-VVZBBKRC.js";
-import "./chunk-YBMVHGY3.js";
-import "./chunk-ZJWUBJYQ.js";
-import {
-  ASSET_GROUP_ASSET_FIELD_TYPES,
-  CONVERSION_ACTION_CATEGORIES,
-  CONVERSION_ORIGINS,
-  NEGATIVE_GEO_TARGET_TYPES,
-  POSITIVE_GEO_TARGET_TYPES
-} from "./chunk-NE4F3FHN.js";
-import "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import "./chunk-NU7JSWVA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/google/index.ts
-import { defineCommand as defineCommand3 } from "citty";
-
-// src/commands/ads/google/keywords/index.ts
-import { defineCommand } from "citty";
-var keywordsCommand = defineCommand({
-  meta: {
-    name: "keywords",
-    description: `Keyword research tools. Subcommands: discover, metrics, locations, languages.
-
-Examples:
-  baker ads google keywords discover --customer-id 1234567890 --seeds "running shoes"
-  baker ads google keywords metrics --customer-id 1234567890 --keywords "running shoes,nike shoes"
-  baker ads google keywords locations
-  baker ads google keywords languages`
-  },
-  subCommands: {
-    discover: () => import("./discover-BJPZNXUQ.js").then((m) => m.discoverCommand),
-    metrics: () => import("./metrics-SQDJ5NQO.js").then((m) => m.metricsCommand),
-    locations: () => import("./locations-J4G5RNPH.js").then((m) => m.locationsCommand),
-    languages: () => import("./languages-HORKPDNH.js").then((m) => m.languagesCommand)
-  }
-});
-
-// src/commands/ads/google/write-commands.ts
-import { defineCommand as defineCommand2 } from "citty";
-
-// src/commands/ads/google/ad-copy-flags.ts
-var AD_COPY_LIST_FLAGS = ["headlines", "descriptions", "long-headlines"];
-function skipBlanks(value, at) {
-  let i = at;
-  while (value[i] === " " || value[i] === "	") i++;
-  return i;
-}
-function readQuotedField(value, open, flag) {
-  let text = "";
-  let j = open + 1;
-  while (!(value[j] === '"' && value[j + 1] !== '"')) {
-    if (j >= value.length) {
-      failWriteValidation(`--${flag} has a quote with no closing quote: ${value} \u2014 ${AD_COPY_LIST_USAGE}`);
-    }
-    text += value[j];
-    j += value[j] === '"' ? 2 : 1;
-  }
-  const after = skipBlanks(value, j + 1);
-  if (after < value.length && value[after] !== ",") {
-    failWriteValidation(
-      `--${flag}: text follows the closing quote of "${text}" \u2014 a quoted item must end at a comma. To put a quote inside an item, double it ("") or ${AD_COPY_LIST_USAGE}`
-    );
-  }
-  return { text, next: after + 1 };
-}
-function splitQuotedList(value, flag) {
-  const fields = [];
-  let i = 0;
-  while (i <= value.length) {
-    const start = skipBlanks(value, i);
-    if (value[start] === '"') {
-      const { text, next } = readQuotedField(value, start, flag);
-      fields.push({ text, quoted: true });
-      i = next;
-    } else {
-      const comma = value.indexOf(",", start);
-      const end = comma === -1 ? value.length : comma;
-      fields.push({ text: value.slice(start, end), quoted: false });
-      i = end + 1;
-    }
-  }
-  const several = fields.length > 1;
-  return fields.map((field) => ({ text: field.text.trim(), splitAtComma: several && !field.quoted }));
-}
-function jsonStringArray(value) {
-  if (!value.startsWith("[")) return void 0;
-  try {
-    const parsed = JSON.parse(value);
-    return Array.isArray(parsed) && parsed.every((v) => typeof v === "string") ? parsed : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function parseCopyList(value, flag) {
-  let items;
-  if (Array.isArray(value)) {
-    items = value.filter((v) => typeof v === "string").map((v) => ({ text: v.trim(), splitAtComma: false }));
-  } else if (typeof value === "string") {
-    const trimmed = value.trim();
-    const json = jsonStringArray(trimmed);
-    items = json ? json.map((v) => ({ text: v.trim(), splitAtComma: false })) : splitQuotedList(trimmed, flag);
-  } else {
-    return void 0;
-  }
-  const kept = items.filter((item) => item.text.length > 0);
-  return kept.length > 0 ? kept : void 0;
-}
-function copyListFlag(value, flag) {
-  return parseCopyList(value, flag)?.map((item) => item.text);
-}
-function refuseDashLedValue(rawArgs, flag) {
-  for (let i = 0; i < rawArgs.length - 1; i++) {
-    if (rawArgs[i] === "--") return;
-    const value = rawArgs[i + 1];
-    if (rawArgs[i] === `--${flag}` && value?.startsWith("-")) {
-      failWriteValidation(
-        `--${flag} is followed by "${value}", which starts with a dash and is read as another flag, not as copy. Join copy that starts with a dash to its flag with =: --${flag}="${value}"`
-      );
-    }
-  }
-}
-function withRepeatedCopyFlags(args, rawArgs) {
-  const out = { ...args };
-  for (const flag of AD_COPY_LIST_FLAGS) {
-    refuseDashLedValue(rawArgs ?? [], flag);
-    const values = repeatedFlagValues(rawArgs ?? [], flag);
-    if (values.length > 1) {
-      out[flag] = values;
-    }
-  }
-  return out;
-}
-function copyListSplitHints(args) {
-  const hints = [];
-  for (const flag of AD_COPY_LIST_FLAGS) {
-    const items = parseCopyList(args[flag], flag) ?? [];
-    const fragments = items.filter((item, index) => index > 0 && item.splitAtComma && new RegExp("^\\p{Ll}", "u").test(item.text));
-    if (fragments.length > 0) {
-      hints.push(
-        `--${flag}: ${fragments.map((f) => `"${f.text}"`).join(", ")} starts in lowercase \u2014 it looks like the end of one item cut at a comma. Check the staged copy; if it was one item, fix this op in place with \`draft amend <ref>\` (the ref this response returned) rather than staging it again, which would leave the cut copy staged too \u2014 ${AD_COPY_LIST_USAGE}.`
-      );
-    }
-  }
-  return hints;
-}
-
-// src/commands/ads/google/write-commands.ts
-var customerIdArg = { "customer-id": { type: "string", description: "10-digit Google Ads customer id" } };
-var fileArg = {
-  file: {
-    type: "string",
-    description: "The op payload: a JSON file path, or the JSON object inline (flags override it)"
-  }
-};
-var STAGED_WRITE = "Stages only \u2014 applies to the live account when the chat is published. Field contract: `baker capabilities google-ads`.";
-var BUDGET_DEMAND_HINTS = [
-  "Check this daily budget against the search volume you measured for these keywords, not against the plan you had before you measured it. A budget many times larger than the traffic the target pool can absorb never spends, and reads to the client as a number nobody costed.",
-  "No volume measured yet? Pull it first \u2014 `baker ads google query --preset search-terms` for what the account already captures, `baker ads google keywords metrics` for the market estimate (those are planner figures, never account performance)."
-];
-var budgetsCommand = defineCommand2({
-  meta: { name: "budgets", description: "Stage campaign budget create/update" },
-  subCommands: {
-    // Fires where the budget is actually set, rather than on whatever the chat happened to stage
-    // first. A budget several times what the target pool can absorb never spends, and reads to the
-    // client as a plan nobody costed.
-    create: defineCommand2({
-      meta: {
-        name: "create",
-        description: `Stage a daily campaign budget; campaigns reference it by the g_temp_* ref it returns (--budget-ref). ${STAGED_WRITE}`
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        name: { type: "string", description: 'Budget name as shown in Google Ads (e.g. "Brand search \u2014 daily")' },
-        amount: { type: "string", description: "Daily amount in major currency units (e.g. 50)" },
-        delivery: { type: "string", description: "STANDARD | ACCELERATED" },
-        shared: { type: "boolean", description: "Explicitly shared budget" }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        const payload = mergePayload(loadJsonFileArg(args.file), {
-          name: args.name,
-          amountMicros: microsFlag(args.amount, "--amount"),
-          deliveryMethod: args.delivery,
-          explicitlyShared: args.shared || void 0
-        });
-        await stageCreate("google.budget.create", customerId, payload, BUDGET_DEMAND_HINTS);
-      }
-    }),
-    update: defineCommand2({
-      meta: {
-        name: "update",
-        description: `Stage a change to an existing budget's name, daily amount or delivery. ${STAGED_WRITE}`
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        name: { type: "string", description: "New budget name as shown in Google Ads" },
-        amount: { type: "string", description: "New daily amount in major currency units" },
-        delivery: { type: "string" }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        const target = requireTarget(args, "budget");
-        const payload = mergePayload(loadJsonFileArg(args.file), {
-          name: args.name,
-          amountMicros: microsFlag(args.amount, "--amount"),
-          deliveryMethod: args.delivery
-        });
-        await stageUpdate("google.budget.update", customerId, target, payload, BUDGET_DEMAND_HINTS);
-      }
-    })
-  }
-});
-var MAX_CPC_STRATEGIES = ["TARGET_IMPRESSION_SHARE", "TARGET_SPEND", "PERCENT_CPC"];
-function biddingFromFlags(args) {
-  const type = args["bidding-strategy"];
-  const maxCpcMicros = microsFlag(args["max-cpc"], "--max-cpc");
-  if (!type) {
-    if (maxCpcMicros !== void 0) {
-      failWriteValidation(
-        "--max-cpc needs --bidding-strategy too (the ceiling belongs to a strategy) \u2014 e.g. --bidding-strategy TARGET_IMPRESSION_SHARE --max-cpc 12"
-      );
-    }
-    if (args["target-cpc"] !== void 0) {
-      failWriteValidation(
-        "--target-cpc needs --bidding-strategy too (the target belongs to a strategy) \u2014 use --bidding-strategy TARGET_CPC --target-cpc 1.5"
-      );
-    }
-    return void 0;
-  }
-  if (maxCpcMicros !== void 0 && !MAX_CPC_STRATEGIES.includes(type.toUpperCase())) {
-    failWriteValidation(`${type} does not take --max-cpc \u2014 only ${MAX_CPC_STRATEGIES.join(", ")} carry a bid ceiling`);
-  }
-  const targetCpcMicros = microsFlag(args["target-cpc"], "--target-cpc");
-  if (targetCpcMicros !== void 0 && type.toUpperCase() !== "TARGET_CPC") {
-    failWriteValidation(
-      `${type} does not take --target-cpc \u2014 pair it with --bidding-strategy TARGET_CPC (Demand Gen campaigns only)`
-    );
-  }
-  return {
-    type,
-    targetCpaMicros: microsFlag(args["target-cpa"], "--target-cpa"),
-    targetRoas: args["target-roas"] !== void 0 ? Number(args["target-roas"]) : void 0,
-    targetCpcMicros,
-    cpcBidCeilingMicros: maxCpcMicros
-  };
-}
-var maxCpcArg = {
-  "max-cpc": {
-    type: "string",
-    description: "Max CPC bid ceiling (major units) for TARGET_IMPRESSION_SHARE, TARGET_SPEND or PERCENT_CPC"
-  }
-};
-var finalUrlSuffixArg = {
-  "final-url-suffix": {
-    type: "string",
-    description: 'Final URL suffix for this campaign \u2014 bare query params, no leading "?" (e.g. "utm_source=google&utm_agency=baker"). REPLACES the account-level suffix for this campaign; pass "" to clear it back to the account value. Account-wide tagging belongs at the account level: --level account tells you where.'
-  }
-};
-var urlOptionsArgs = {
-  "tracking-template": {
-    type: "string",
-    description: 'Campaign tracking template \u2014 the click-measurement URL every ad routes through. Must carry the landing page through {lpurl}, e.g. "https://tracker.example/?url={lpurl}". REPLACES the account-level template for this campaign; pass "" to clear it back to the account value.'
-  },
-  "custom-param": {
-    type: "string",
-    description: "Custom parameter as key=value, referenced in a template or final URL as {_key} (e.g. --custom-param season=summer). Repeat for several; Google allows 8. REPLACES the campaign's whole set."
-  },
-  "clear-custom-params": {
-    type: "boolean",
-    description: "Remove every custom parameter from this campaign (Google replaces the set wholesale)."
-  }
-};
-function urlCustomParametersFromFlags(args, rawArgs) {
-  const entries = repeatedValues(rawArgs, "custom-param", args["custom-param"]).filter((v) => v.length > 0);
-  if (entries.length === 0) {
-    return args["clear-custom-params"] === true ? [] : void 0;
-  }
-  if (args["clear-custom-params"] === true) {
-    failWriteValidation("--clear-custom-params removes every parameter \u2014 pass it OR --custom-param, not both");
-  }
-  return entries.map((entry) => {
-    const split = entry.indexOf("=");
-    if (split <= 0) {
-      failWriteValidation(`--custom-param "${entry}" must be key=value (e.g. --custom-param season=summer)`);
-    }
-    return { key: entry.slice(0, split), value: entry.slice(split + 1) };
-  });
-}
-var aiMaxArgs = {
-  "ai-max": {
-    type: "boolean",
-    description: "AI Max for Search: --ai-max turns it on (Google then matches searches beyond your keywords), --ai-max=false turns it off along with its text customization and URL expansion. Search campaigns only."
-  },
-  "ai-max-text": {
-    type: "boolean",
-    description: "AI Max text customization: --ai-max-text lets Google write ad text from your landing page and ads (needs AI Max on); --ai-max-text=false stops it. Required before text guidelines."
-  },
-  "ai-max-url-expansion": {
-    type: "boolean",
-    description: "AI Max final URL expansion: --ai-max-url-expansion lets Google send clicks to the most relevant page of your site (needs text customization on); --ai-max-url-expansion=false keeps every click on your final URLs."
-  }
-};
-function aiMaxFromFlags(args) {
-  const flag = (name) => typeof args[name] === "boolean" ? args[name] : void 0;
-  const aiMax = {
-    enabled: flag("ai-max"),
-    textCustomization: flag("ai-max-text"),
-    finalUrlExpansion: flag("ai-max-url-expansion")
-  };
-  const stated = Object.entries(aiMax).filter(([, v]) => v !== void 0);
-  return stated.length > 0 ? Object.fromEntries(stated) : void 0;
-}
-var textGuidelinesArgs = {
-  "term-exclusion": {
-    type: "string",
-    description: `Text guidelines (AI Max Search and Performance Max): a word or phrase Google's generated ad text must never use, up to 30 characters (e.g. --term-exclusion "cheap"). Repeat for several; Google allows 25. REPLACES the campaign's whole list.`
-  },
-  "messaging-restriction": {
-    type: "string",
-    description: `Text guidelines (AI Max Search and Performance Max): a plain-language rule for Google's generated ad text, up to 300 characters (e.g. --messaging-restriction "Never promise a delivery date"). Repeat for several; Google allows 40. REPLACES the campaign's whole list.`
-  },
-  "clear-term-exclusions": {
-    type: "boolean",
-    description: "Remove every term exclusion from this campaign's text guidelines."
-  },
-  "clear-messaging-restrictions": {
-    type: "boolean",
-    description: "Remove every messaging restriction from this campaign's text guidelines."
-  }
-};
-function guidelineListFromFlags(args, rawArgs, flag, clearFlag) {
-  const values = repeatedValues(rawArgs, flag, args[flag]).filter((v) => v.length > 0);
-  if (values.length === 0) {
-    return args[clearFlag] === true ? [] : void 0;
-  }
-  if (args[clearFlag] === true) {
-    failWriteValidation(`--${clearFlag} removes the whole list \u2014 pass it OR --${flag}, not both`);
-  }
-  return values;
-}
-function textGuidelinesFromFlags(args, rawArgs) {
-  const termExclusions = guidelineListFromFlags(args, rawArgs, "term-exclusion", "clear-term-exclusions");
-  const messagingRestrictions = guidelineListFromFlags(
-    args,
-    rawArgs,
-    "messaging-restriction",
-    "clear-messaging-restrictions"
-  );
-  if (termExclusions === void 0 && messagingRestrictions === void 0) {
-    return void 0;
-  }
-  return {
-    ...termExclusions !== void 0 ? { termExclusions } : {},
-    ...messagingRestrictions !== void 0 ? { messagingRestrictions } : {}
-  };
-}
-var geoTargetTypeArgs = {
-  "geo-target-type": {
-    type: "string",
-    description: 'Location option \u2014 PRESENCE (only people in your targeted locations) or PRESENCE_OR_INTEREST (also people interested in them). Google applies PRESENCE_OR_INTEREST when this is left out, so pass PRESENCE explicitly for local-service, delivery-radius or in-store campaigns. Sets the same "Location options" as the Google Ads UI.'
-  },
-  "negative-geo-target-type": {
-    type: "string",
-    description: "How EXCLUDED locations are matched \u2014 PRESENCE (default: excludes people in the location) or PRESENCE_OR_INTEREST (also excludes people interested in it)."
-  }
-};
-function enumFlag(value, flag, allowed) {
-  if (typeof value !== "string" || value.length === 0) {
-    return void 0;
-  }
-  const upper = value.toUpperCase();
-  if (!allowed.includes(upper)) {
-    failWriteValidation(`${flag} must be one of ${allowed.join(" | ")}`);
-  }
-  return upper;
-}
-function geoTargetTypeFromFlags(args) {
-  const positiveGeoTargetType = enumFlag(args["geo-target-type"], "--geo-target-type", POSITIVE_GEO_TARGET_TYPES);
-  const negativeGeoTargetType = enumFlag(
-    args["negative-geo-target-type"],
-    "--negative-geo-target-type",
-    NEGATIVE_GEO_TARGET_TYPES
-  );
-  if (positiveGeoTargetType === void 0 && negativeGeoTargetType === void 0) {
-    return void 0;
-  }
-  return Object.fromEntries(
-    Object.entries({ positiveGeoTargetType, negativeGeoTargetType }).filter(([, v]) => v !== void 0)
-  );
-}
-var NETWORK_SETTING_KEYS = [
-  "targetGoogleSearch",
-  "targetSearchNetwork",
-  "targetContentNetwork",
-  "targetPartnerSearchNetwork"
-];
-var NETWORK_FLAG_VALUES = {
-  search: "targetGoogleSearch",
-  "search-partners": "targetSearchNetwork",
-  partners: "targetSearchNetwork",
-  display: "targetContentNetwork",
-  "partner-search": "targetPartnerSearchNetwork"
-};
-var networksArg = {
-  networks: {
-    type: "string",
-    description: `Networks to serve on, comma-separated: search | search-partners | display | partner-search. Every network you do not list is turned OFF, so state the whole set. Start here: --networks search \u2014 a new Search campaign left unset publishes on Google Search only, because Google's own default adds Search partners and the Display network, which spends the same budget on surfaces the advertiser did not pick. Sets the same "Networks" as the Google Ads UI.`
-  }
-};
-function networkSettingsFromFlags(args) {
-  const raw = args.networks;
-  if (typeof raw !== "string") {
-    return void 0;
-  }
-  const names = raw.split(",").map((n) => n.trim().toLowerCase()).filter((n) => n.length > 0);
-  const allowed = Object.keys(NETWORK_FLAG_VALUES).join(" | ");
-  if (names.length === 0) {
-    failWriteValidation(`--networks needs at least one of ${allowed}`);
-  }
-  const settings = Object.fromEntries(NETWORK_SETTING_KEYS.map((k) => [k, false]));
-  for (const name of names) {
-    const key = NETWORK_FLAG_VALUES[name];
-    if (!key) {
-      failWriteValidation(`--networks must list only ${allowed}`);
-    }
-    settings[key] = true;
-  }
-  return settings;
-}
-function networksHints(payload) {
-  if (payload.networkSettings !== void 0) {
-    return [];
-  }
-  if (payload.channelType !== "SEARCH") {
-    return [];
-  }
-  return [
-    "No --networks set, so this campaign publishes on Google Search only \u2014 Search partners and the Display network are off. Re-stage with --networks search,search-partners (or add display) to widen it, and tell the user which networks this campaign serves on."
-  ];
-}
-function geoTargetTypeHints(payload) {
-  if (payload.geoTargetTypeSetting !== void 0) {
-    return [];
-  }
-  return [
-    `No --geo-target-type set, so this campaign will use Google's default location option "Presence or interest" \u2014 it reaches people interested in your locations, not only people in them. Re-stage with --geo-target-type PRESENCE if the offer is local (in-store, delivery radius, service area), and tell the user which of the two this campaign uses.`
-  ];
-}
-function accountLevelNotStageable(customerId, suffix) {
-  writeJsonEnvelope({
-    ok: false,
-    error: {
-      code: "ACCOUNT_LEVEL_NOT_STAGEABLE",
-      message: ACCOUNT_URL_OPTIONS_NOT_STAGEABLE,
-      retryable: false,
-      fix: {
-        action: "use_different_resource",
-        explanation: `Set it once by hand in ${ACCOUNT_URL_OPTIONS_LOCATION} for account ${customerId}, then tell the user that is the only place an account-wide suffix can be changed. Keep going with the rest of the task \u2014 this is not a reason to abort.`,
-        where: ACCOUNT_URL_OPTIONS_LOCATION,
-        ...suffix !== void 0 ? { value: suffix } : {},
-        correctedCommand: `baker ads google campaigns update <campaign-id> --customer-id ${customerId} --final-url-suffix "${suffix ?? "utm_agency=baker"}"`,
-        correctedCommandCaveat: "Per-campaign fallback only: a campaign suffix REPLACES the account one for that campaign and does not merge, and it covers only the campaigns you stage it on.",
-        verify: `baker ads google url-options --customer-id ${customerId}`
-      }
-    }
-  });
-  process.exit(1);
-}
-var campaignsCommand = defineCommand2({
-  meta: { name: "campaigns", description: "Stage campaign create/update/pause/resume/remove" },
-  subCommands: {
-    create: defineCommand2({
-      meta: {
-        name: "create",
-        description: `Stage a new campaign on a budget (--budget-ref); it is created paused unless --status ENABLED. ${STAGED_WRITE}`
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        name: { type: "string", description: 'Campaign name, unique in the account (e.g. "Search \u2014 Brand \u2014 ES")' },
-        "channel-type": {
-          type: "string",
-          description: "SEARCH | DISPLAY | SHOPPING | VIDEO | PERFORMANCE_MAX | DEMAND_GEN | \u2026"
-        },
-        "sub-type": { type: "string", description: "Advertising channel sub-type" },
-        "budget-ref": { type: "string", description: "Budget ref (g_temp_*, id, or resource name)" },
-        "bidding-strategy": {
-          type: "string",
-          description: "MANUAL_CPC | MAXIMIZE_CONVERSIONS | MAXIMIZE_CONVERSION_VALUE | TARGET_SPEND | \u2026"
-        },
-        "target-cpa": {
-          type: "string",
-          description: "Target CPA (major units). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSIONS \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_CPA."
-        },
-        "target-roas": {
-          type: "string",
-          description: "Target ROAS (e.g. 4.0). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSION_VALUE \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_ROAS."
-        },
-        "target-cpc": {
-          type: "string",
-          description: "Target CPC (major units) for Demand Gen \u2014 pair it with --bidding-strategy TARGET_CPC. Demand Gen only; other channels have no target CPC."
-        },
-        ...maxCpcArg,
-        ...finalUrlSuffixArg,
-        ...urlOptionsArgs,
-        ...geoTargetTypeArgs,
-        ...networksArg,
-        ...aiMaxArgs,
-        objective: { type: "string", description: "Advisory UI objective (SALES, LEADS, \u2026)" },
-        "start-date": { type: "string", description: "YYYY-MM-DD" },
-        "end-date": { type: "string", description: "YYYY-MM-DD" },
-        "eu-political-ads": {
-          type: "boolean",
-          description: "Pass when the campaign contains EU political advertising. Google requires the declaration on every new campaign; omitted stages the campaign as not containing EU political ads."
-        },
-        status: { type: "string", description: "ENABLED | PAUSED (default PAUSED)" }
-      },
-      run: async ({ args, rawArgs }) => {
-        const customerId = requireCustomerId(args);
-        const payload = mergePayload(loadJsonFileArg(args.file), {
-          name: args.name,
-          channelType: args["channel-type"],
-          channelSubType: args["sub-type"],
-          budget: args["budget-ref"],
-          bidding: biddingFromFlags(args),
-          geoTargetTypeSetting: geoTargetTypeFromFlags(args),
-          networkSettings: networkSettingsFromFlags(args),
-          finalUrlSuffix: args["final-url-suffix"],
-          trackingUrlTemplate: args["tracking-template"],
-          urlCustomParameters: urlCustomParametersFromFlags(args, rawArgs),
-          objective: args.objective,
-          startDate: args["start-date"],
-          endDate: args["end-date"],
-          euPoliticalAds: args["eu-political-ads"],
-          aiMax: aiMaxFromFlags(args),
-          status: args.status
-        });
-        await stageCreate("google.campaign.create", customerId, payload, [
-          ...geoTargetTypeHints(payload),
-          ...networksHints(payload)
-        ]);
-      }
-    }),
-    update: defineCommand2({
-      meta: {
-        name: "update",
-        description: `Stage a change to an existing campaign's name, budget, bidding, settings, AI Max switches or text guidelines (what AI Max and Performance Max ad text must avoid). ${STAGED_WRITE}`
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        name: { type: "string", description: "New campaign name, unique in the account" },
-        "budget-ref": { type: "string" },
-        "bidding-strategy": {
-          type: "string",
-          description: "MANUAL_CPC | MAXIMIZE_CONVERSIONS | MAXIMIZE_CONVERSION_VALUE | TARGET_SPEND | \u2026"
-        },
-        "target-cpa": {
-          type: "string",
-          description: "Target CPA (major units). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSIONS \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_CPA."
-        },
-        "target-roas": {
-          type: "string",
-          description: "Target ROAS (e.g. 4.0). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSION_VALUE \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_ROAS."
-        },
-        "target-cpc": {
-          type: "string",
-          description: "Target CPC (major units) for Demand Gen \u2014 pair it with --bidding-strategy TARGET_CPC. Demand Gen only; other channels have no target CPC."
-        },
-        ...maxCpcArg,
-        ...finalUrlSuffixArg,
-        ...urlOptionsArgs,
-        ...geoTargetTypeArgs,
-        ...networksArg,
-        ...textGuidelinesArgs,
-        ...aiMaxArgs,
-        "eu-political-ads": {
-          type: "boolean",
-          description: "Corrects the campaign's EU political advertising declaration: --eu-political-ads if it contains EU political ads, --eu-political-ads=false if it does not. Existing campaigns without a declaration block location-targeting changes until one is set."
-        },
-        level: {
-          type: "string",
-          description: "campaign (default) | account. `account` stages nothing \u2014 it reports where an account-wide final URL suffix has to be set instead."
-        },
-        status: { type: "string" }
-      },
-      run: async ({ args, rawArgs }) => {
-        const customerId = requireCustomerId(args);
-        const level = typeof args.level === "string" && args.level.length > 0 ? args.level : "campaign";
-        if (level === "account") {
-          accountLevelNotStageable(customerId, args["final-url-suffix"]);
-        }
-        if (level !== "campaign") {
-          failWriteValidation("--level must be campaign or account");
-        }
-        const target = requireTarget(args, "campaign");
-        const payload = mergePayload(loadJsonFileArg(args.file), {
-          name: args.name,
-          budget: args["budget-ref"],
-          bidding: biddingFromFlags(args),
-          geoTargetTypeSetting: geoTargetTypeFromFlags(args),
-          networkSettings: networkSettingsFromFlags(args),
-          finalUrlSuffix: args["final-url-suffix"],
-          trackingUrlTemplate: args["tracking-template"],
-          urlCustomParameters: urlCustomParametersFromFlags(args, rawArgs),
-          euPoliticalAds: args["eu-political-ads"],
-          textGuidelines: textGuidelinesFromFlags(args, rawArgs),
-          aiMax: aiMaxFromFlags(args),
-          status: args.status
-        });
-        await stageUpdate("google.campaign.update", customerId, target, payload);
-      }
-    }),
-    pause: statusCommand("google.campaign.pause", "campaign"),
-    resume: statusCommand("google.campaign.resume", "campaign"),
-    remove: statusCommand("google.campaign.remove", "campaign")
-  }
-});
-function statusCommand(kind, entity, hints) {
-  return defineCommand2({
-    meta: { name: kind.split(".")[2], description: `Stage a ${entity} ${kind.split(".")[2]}` },
-    args: {
-      ...customerIdArg,
-      id: { type: "positional", description: `${entity} resource name or id`, required: false }
-    },
-    run: async ({ args }) => {
-      const customerId = requireCustomerId(args);
-      await stageTarget(kind, customerId, requireTarget(args, entity), hints);
-    }
-  });
-}
-var adGroupsCommand = defineCommand2({
-  meta: { name: "ad-groups", description: "Stage ad group create/update/pause/resume/remove" },
-  subCommands: {
-    create: defineCommand2({
-      meta: {
-        name: "create",
-        description: `Stage a new ad group in a campaign (--campaign-ref); it is created paused unless --status ENABLED. ${STAGED_WRITE}`
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        name: {
-          type: "string",
-          description: 'Ad group name, unique within its campaign (e.g. "Solar panels \u2014 price")'
-        },
-        "campaign-ref": { type: "string", description: "Campaign ref (g_temp_*, id, or resource name)" },
-        type: {
-          type: "string",
-          description: "Ad group type \u2014 leave it out and Google derives it from the campaign's channel, which is required on a Demand Gen campaign (there is no Demand Gen ad group type). SEARCH_STANDARD | DISPLAY_STANDARD | SHOPPING_PRODUCT_ADS | VIDEO_*"
-        },
-        "cpc-bid": { type: "string", description: "Default CPC bid in major units" },
-        status: { type: "string" }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        const payload = mergePayload(loadJsonFileArg(args.file), {
-          name: args.name,
-          campaign: args["campaign-ref"],
-          type: args.type,
-          cpcBidMicros: microsFlag(args["cpc-bid"], "--cpc-bid"),
-          status: args.status
-        });
-        await stageCreate("google.adGroup.create", customerId, payload);
-      }
-    }),
-    update: defineCommand2({
-      meta: {
-        name: "update",
-        description: `Stage a change to an existing ad group's name, default CPC bid or status. ${STAGED_WRITE}`
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        name: { type: "string", description: "New ad group name, unique within its campaign" },
-        "cpc-bid": { type: "string" },
-        status: { type: "string" }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        const target = requireTarget(args, "ad group");
-        const payload = mergePayload(loadJsonFileArg(args.file), {
-          name: args.name,
-          cpcBidMicros: microsFlag(args["cpc-bid"], "--cpc-bid"),
-          status: args.status
-        });
-        await stageUpdate("google.adGroup.update", customerId, target, payload);
-      }
-    }),
-    pause: statusCommand("google.adGroup.pause", "ad group"),
-    resume: statusCommand("google.adGroup.resume", "ad group"),
-    remove: statusCommand("google.adGroup.remove", "ad group")
-  }
-});
-var KEYWORD_KILL_HINTS = [
-  "Keyword metrics are per ad group. Decide this from keyword_view rows carrying ad_group.id + ad_group_criterion.criterion_id (`--preset keyword-analysis` returns both) \u2014 never from campaign totals or metrics summed across ad groups.",
-  "The same keyword text in several ad groups shares ONE criterion id, so an aggregate blends the copy that holds the history with the copies that never served. Compare the copies row by row and keep the one with the impressions/conversions; if the keyword is duplicated and only one copy performs, pause the others, not it."
-];
-function keywordKillHints(status) {
-  const kills = typeof status === "string" && ["PAUSED", "REMOVED"].includes(status.toUpperCase());
-  return kills ? KEYWORD_KILL_HINTS : [];
-}
-function keywordFinalUrlHints(finalUrl, count) {
-  if (typeof finalUrl !== "string" || finalUrl.length === 0) {
-    return [];
-  }
-  return count > 1 ? [
-    `--final-url applied the same landing page to all ${count} keywords \u2014 the flag has no per-keyword form. A keyword-level URL only earns its place when that keyword must land somewhere the ad doesn't, so one URL shared by every keyword belongs on the ad instead: set the ad's final URL to this page and re-stage the keywords without --final-url. Keep it only if this page is genuinely each keyword's own destination and not the ad's.`
-  ] : [
-    "Keep --final-url only if this keyword's destination differs from the ad's final URL \u2014 otherwise drop it and let the keyword inherit the ad's landing page."
-  ];
-}
-function keywordUpdateFinalUrls(args) {
-  const finalUrl = args["final-url"];
-  const clear = args["clear-final-url"] === true;
-  if (typeof finalUrl !== "string" || finalUrl.length === 0) {
-    return clear ? [] : void 0;
-  }
-  if (clear) {
-    failWriteValidation(
-      "--clear-final-url sends the keyword back to the ad's landing page \u2014 pass it OR --final-url, not both"
-    );
-  }
-  return [finalUrl];
-}
-var keywordWriteSubcommands = {
-  add: defineCommand2({
-    meta: { name: "add", description: "Add keyword(s) to an ad group \u2014 one --text or a whole batch" },
-    args: {
-      ...customerIdArg,
-      "ad-group-ref": { type: "string", description: "Ad group ref (g_temp_*, id, or resource name)" },
-      text: {
-        type: "string",
-        description: 'Keyword text \u2014 comma-separate for a batch, optional ":EXACT|:PHRASE|:BROAD" suffix per entry'
-      },
-      file: { type: "string", description: "Text file with one keyword[:MATCH_TYPE] per line" },
-      "match-type": { type: "string", description: "Default match type: EXACT | PHRASE | BROAD" },
-      "cpc-bid": { type: "string", description: "Keyword CPC bid in major units (applies to all)" },
-      "final-url": {
-        type: "string",
-        description: "Rarely needed: send THIS keyword to a page the ad doesn't go to. Applies to every keyword in the call, so leave it unset unless the destination is keyword-specific \u2014 otherwise set the ad's final URL"
-      }
-    },
-    run: async ({ args, rawArgs }) => {
-      const customerId = requireCustomerId(args);
-      const adGroup = requireStringFlag(args["ad-group-ref"], "--ad-group-ref");
-      const cpcBidMicros = microsFlag(args["cpc-bid"], "--cpc-bid");
-      const finalUrls = args["final-url"] ? [args["final-url"]] : void 0;
-      const entries = keywordEntries(args, rawArgs);
-      await stageGoogleOps(
-        entries.map((entry) => ({
-          kind: "google.keyword.add",
-          customerId,
-          payload: { adGroup, text: entry.text, matchType: entry.matchType, cpcBidMicros, finalUrls }
-        })),
-        keywordFinalUrlHints(args["final-url"], entries.length)
-      );
-    }
-  }),
-  update: defineCommand2({
-    meta: { name: "update", description: "Update a keyword" },
-    args: {
-      ...customerIdArg,
-      "cpc-bid": { type: "string" },
-      status: { type: "string" },
-      "final-url": {
-        type: "string",
-        description: "Rarely needed: send THIS keyword to a page the ad doesn't go to. Leave unset unless the destination is keyword-specific \u2014 otherwise set the ad's final URL"
-      },
-      "clear-final-url": {
-        type: "boolean",
-        description: "Drop this keyword's own landing page so it inherits the ad's again"
-      }
-    },
-    run: async ({ args }) => {
-      const customerId = requireCustomerId(args);
-      const finalUrls = keywordUpdateFinalUrls(args);
-      await stageUpdate(
-        "google.keyword.update",
-        customerId,
-        requireTarget(args, "keyword"),
-        { cpcBidMicros: microsFlag(args["cpc-bid"], "--cpc-bid"), status: args.status, finalUrls },
-        [...keywordKillHints(args.status), ...keywordFinalUrlHints(args["final-url"], 1)]
-      );
-    }
-  }),
-  remove: statusCommand("google.keyword.remove", "keyword", KEYWORD_KILL_HINTS)
-};
-var NEGATIVE_COVERAGE_HINTS = [
-  "Before publishing, confirm each term isn't already blocked: run `baker ads google query --preset negative-keyword-lists` (shared-list terms) and `--preset negative-keywords` (campaign/ad-group negatives).",
-  "If a term is already in a negative list but still shows in search terms, the list likely isn't attached to this campaign (check `--preset negative-list-attachments`) or its match type is narrower than the query \u2014 explain that instead of staging a duplicate negative."
-];
-var negativeKeywordsCommand = defineCommand2({
-  meta: { name: "negative-keywords", description: "Stage negative keyword add/remove (ad-group or campaign level)" },
-  subCommands: {
-    add: defineCommand2({
-      meta: { name: "add", description: "Add negative keyword(s) \u2014 one --text or a whole batch" },
-      args: {
-        ...customerIdArg,
-        level: { type: "string", description: "adGroup | campaign" },
-        "parent-ref": { type: "string", description: "Ad group or campaign ref" },
-        text: {
-          type: "string",
-          description: 'Keyword text \u2014 comma-separate for a batch, optional ":MATCH_TYPE" suffix per entry'
-        },
-        file: { type: "string", description: "Text file with one keyword[:MATCH_TYPE] per line" },
-        "match-type": { type: "string", description: "Default match type: EXACT | PHRASE | BROAD" }
-      },
-      run: async ({ args, rawArgs }) => {
-        const customerId = requireCustomerId(args);
-        const level = requireStringFlag(args.level, "--level");
-        const parent = requireStringFlag(args["parent-ref"], "--parent-ref");
-        await stageGoogleOps(
-          keywordEntries(args, rawArgs).map((entry) => ({
-            kind: "google.negativeKeyword.add",
-            customerId,
-            payload: { level, parent, text: entry.text, matchType: entry.matchType }
-          })),
-          NEGATIVE_COVERAGE_HINTS
-        );
-      }
-    }),
-    remove: statusCommand("google.negativeKeyword.remove", "negative keyword")
-  }
-});
-var keywordListsCommand = defineCommand2({
-  meta: {
-    name: "keyword-lists",
-    description: "Stage shared negative keyword lists (create/add/attach/detach). Build at least one shared negative list (brand, competitor, junk-intent terms) and attach it to every campaign to protect spend."
-  },
-  subCommands: {
-    create: defineCommand2({
-      meta: { name: "create", description: "Create a shared negative keyword list" },
-      args: {
-        ...customerIdArg,
-        name: { type: "string" },
-        type: {
-          type: "string",
-          description: "NEGATIVE_KEYWORDS (default) | NEGATIVE_PLACEMENTS | ACCOUNT_LEVEL_NEGATIVE_KEYWORDS"
-        }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        await stageCreate("google.sharedSet.create", customerId, {
-          name: requireStringFlag(args.name, "--name"),
-          type: args.type
-        });
-      }
-    }),
-    add: defineCommand2({
-      meta: { name: "add", description: "Add keyword(s) to a shared list \u2014 one --text or a whole batch" },
-      args: {
-        ...customerIdArg,
-        "list-ref": { type: "string", description: "Shared set ref" },
-        text: {
-          type: "string",
-          description: 'Keyword text \u2014 comma-separate for a batch, optional ":MATCH_TYPE" suffix per entry'
-        },
-        file: { type: "string", description: "Text file with one keyword[:MATCH_TYPE] per line" },
-        "match-type": { type: "string", description: "Default match type: EXACT | PHRASE | BROAD" }
-      },
-      run: async ({ args, rawArgs }) => {
-        const customerId = requireCustomerId(args);
-        const sharedSet = requireStringFlag(args["list-ref"], "--list-ref");
-        await stageGoogleOps(
-          keywordEntries(args, rawArgs).map((entry) => ({
-            kind: "google.sharedSetMember.add",
-            customerId,
-            payload: { sharedSet, text: entry.text, matchType: entry.matchType }
-          }))
-        );
-      }
-    }),
-    attach: defineCommand2({
-      meta: { name: "attach", description: "Attach a keyword list to a campaign" },
-      args: { ...customerIdArg, "campaign-ref": { type: "string" }, "list-ref": { type: "string" } },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        await stageCreate("google.campaignSharedSet.attach", customerId, {
-          campaign: requireStringFlag(args["campaign-ref"], "--campaign-ref"),
-          sharedSet: requireStringFlag(args["list-ref"], "--list-ref")
-        });
-      }
-    }),
-    detach: statusCommand("google.campaignSharedSet.detach", "campaign shared set")
-  }
-});
-function rsaContentFromFlags(args) {
-  const headlines = copyListFlag(args.headlines, "headlines");
-  const descriptions = copyListFlag(args.descriptions, "descriptions");
-  if (!headlines || !descriptions) {
-    failWriteValidation("responsive search ads need --headlines and --descriptions, or use --file");
-  }
-  const finalUrls = listFlag(args["final-url"]);
-  if (!finalUrls) {
-    failWriteValidation("--final-url is required for a responsive search ad");
-  }
-  return {
-    format: "responsiveSearch",
-    headlines: headlines.map((text) => ({ text })),
-    descriptions: descriptions.map((text) => ({ text })),
-    path1: args.path1,
-    path2: args.path2,
-    finalUrls
-  };
-}
-function rdaContentFromFlags(args, base) {
-  const content = {
-    format: "responsiveDisplay",
-    ...base !== null && typeof base === "object" && !Array.isArray(base) ? base : {}
-  };
-  const headlines = copyListFlag(args.headlines, "headlines");
-  if (headlines) {
-    content.headlines = headlines.map((text) => ({ text }));
-  }
-  const descriptions = copyListFlag(args.descriptions, "descriptions");
-  if (descriptions) {
-    content.descriptions = descriptions.map((text) => ({ text }));
-  }
-  if (typeof args["long-headline"] === "string") {
-    content.longHeadline = { text: args["long-headline"] };
-  }
-  if (typeof args["business-name"] === "string") {
-    content.businessName = args["business-name"];
-  }
-  const finalUrls = listFlag(args["final-url"]);
-  if (finalUrls) {
-    content.finalUrls = finalUrls;
-  }
-  const marketing = listFlag(args["marketing-images"]);
-  if (marketing) {
-    content.marketingImageAssets = marketing;
-  }
-  const square = listFlag(args["square-marketing-images"]);
-  if (square) {
-    content.squareMarketingImageAssets = square;
-  }
-  const logos = listFlag(args["logo-images"]);
-  if (logos) {
-    content.logoImageAssets = logos;
-  }
-  return content;
-}
-function videoContentFromFlags(args, base) {
-  const content = {
-    format: "video",
-    ...base !== null && typeof base === "object" && !Array.isArray(base) ? base : {}
-  };
-  const videoAssets = listFlag(args["video-assets"]);
-  if (videoAssets) {
-    content.videoAssets = videoAssets;
-  }
-  const finalUrls = listFlag(args["final-url"]);
-  if (finalUrls) {
-    content.finalUrls = finalUrls;
-  }
-  return content;
-}
-function demandGenContentFromFlags(args, base) {
-  const content = {
-    format: "demandGen",
-    ...base !== null && typeof base === "object" && !Array.isArray(base) ? base : {}
-  };
-  if (typeof args["ad-name"] === "string") {
-    content.name = args["ad-name"];
-  }
-  const headlines = copyListFlag(args.headlines, "headlines");
-  if (headlines) {
-    content.headlines = headlines.map((text) => ({ text }));
-  }
-  const descriptions = copyListFlag(args.descriptions, "descriptions");
-  if (descriptions) {
-    content.descriptions = descriptions.map((text) => ({ text }));
-  }
-  if (typeof args["business-name"] === "string") {
-    content.businessName = args["business-name"];
-  }
-  const finalUrls = listFlag(args["final-url"]);
-  if (finalUrls) {
-    content.finalUrls = finalUrls;
-  }
-  const images = listFlag(args["image-assets"]);
-  if (images) {
-    content.imageAssets = images;
-  }
-  const squareImages = listFlag(args["square-image-assets"]);
-  if (squareImages) {
-    content.squareImageAssets = squareImages;
-  }
-  const logoImages = listFlag(args["logo-image-assets"]);
-  if (logoImages) {
-    content.logoImageAssets = logoImages;
-  }
-  return content;
-}
-function demandGenVideoContentFromFlags(args, base) {
-  const content = {
-    format: "demandGenVideo",
-    ...base !== null && typeof base === "object" && !Array.isArray(base) ? base : {}
-  };
-  if (typeof args["ad-name"] === "string") {
-    content.name = args["ad-name"];
-  }
-  const headlines = copyListFlag(args.headlines, "headlines");
-  if (headlines) {
-    content.headlines = headlines.map((text) => ({ text }));
-  }
-  const longHeadlines = copyListFlag(args["long-headlines"], "long-headlines");
-  if (longHeadlines) {
-    content.longHeadlines = longHeadlines.map((text) => ({ text }));
-  }
-  const descriptions = copyListFlag(args.descriptions, "descriptions");
-  if (descriptions) {
-    content.descriptions = descriptions.map((text) => ({ text }));
-  }
-  if (typeof args["business-name"] === "string") {
-    content.businessName = args["business-name"];
-  }
-  const finalUrls = listFlag(args["final-url"]);
-  if (finalUrls) {
-    content.finalUrls = finalUrls;
-  }
-  const videos = listFlag(args["video-assets"]);
-  if (videos) {
-    content.videoAssets = videos;
-  }
-  const logoImages = listFlag(args["logo-image-assets"]);
-  if (logoImages) {
-    content.logoImageAssets = logoImages;
-  }
-  const callToActions = listFlag(args["call-to-action-assets"]);
-  if (callToActions) {
-    content.callToActionAssets = callToActions;
-  }
-  return content;
-}
-function appContentFromFlags(args, base) {
-  const content = {
-    format: "app",
-    ...base !== null && typeof base === "object" && !Array.isArray(base) ? base : {}
-  };
-  const headlines = copyListFlag(args.headlines, "headlines");
-  if (headlines) {
-    content.headlines = headlines.map((text) => ({ text }));
-  }
-  const descriptions = copyListFlag(args.descriptions, "descriptions");
-  if (descriptions) {
-    content.descriptions = descriptions.map((text) => ({ text }));
-  }
-  const images = listFlag(args["image-assets"]);
-  if (images) {
-    content.images = images;
-  }
-  const videos = listFlag(args["video-assets"]);
-  if (videos) {
-    content.youtubeVideos = videos;
-  }
-  return content;
-}
-var FORMAT_CONTENT_FLAGS = {
-  responsiveSearch: ["headlines", "descriptions", "path1", "path2", "final-url"],
-  responsiveDisplay: [
-    "headlines",
-    "descriptions",
-    "long-headline",
-    "business-name",
-    "final-url",
-    "marketing-images",
-    "square-marketing-images",
-    "logo-images"
-  ],
-  video: ["video-assets", "final-url"],
-  demandGen: [
-    "ad-name",
-    "headlines",
-    "descriptions",
-    "business-name",
-    "final-url",
-    "image-assets",
-    "square-image-assets",
-    "logo-image-assets"
-  ],
-  demandGenVideo: [
-    "ad-name",
-    "headlines",
-    "long-headlines",
-    "descriptions",
-    "business-name",
-    "final-url",
-    "video-assets",
-    "logo-image-assets",
-    "call-to-action-assets"
-  ],
-  app: ["headlines", "descriptions", "image-assets", "video-assets"],
-  // A call ad builds its content from `--file` alone, so EVERY content flag on it is dropped — the
-  // same silent drop this gate exists for, on the one format that reads no flags at all.
-  call: []
-};
-function formatsReading(flag) {
-  return Object.entries(FORMAT_CONTENT_FLAGS).filter(([, flags]) => flags.includes(flag)).map(([format]) => format);
-}
-function assertFlagsFitFormat(args, format) {
-  const allowed = FORMAT_CONTENT_FLAGS[format];
-  if (!allowed) {
-    return;
-  }
-  const stray = Object.keys(adContentArgs).filter(
-    (flag) => flag !== "format" && args[flag] !== void 0 && !allowed.includes(flag)
-  );
-  if (stray.length === 0) {
-    return;
-  }
-  const detail = stray.map((flag) => {
-    const elsewhere = formatsReading(flag);
-    return elsewhere.length > 0 ? `--${flag} (${elsewhere.join(" / ")})` : `--${flag}`;
-  }).join(", ");
-  failWriteValidation(
-    `a ${format} ad has no ${stray.map((f) => `--${f}`).join(", ")} \u2014 passing it here would stage the change without it. Formats that take it: ${detail}. Check the format with \`baker ads google query "SELECT ad_group_ad.ad.type FROM ad_group_ad WHERE ad_group_ad.ad.id = <id>"\`.`
-  );
-}
-function adContentFromFlags(args, format, fileContent) {
-  assertFlagsFitFormat(args, format);
-  if (format === "responsiveSearch") {
-    return fileContent ?? rsaContentFromFlags(args);
-  }
-  if (format === "responsiveDisplay") {
-    return rdaContentFromFlags(args, fileContent);
-  }
-  if (format === "video") {
-    return videoContentFromFlags(args, fileContent);
-  }
-  if (format === "demandGen") {
-    return demandGenContentFromFlags(args, fileContent);
-  }
-  if (format === "demandGenVideo") {
-    return demandGenVideoContentFromFlags(args, fileContent);
-  }
-  if (format === "app") {
-    return appContentFromFlags(args, fileContent);
-  }
-  return fileContent ?? failWriteValidation(`--format ${format} needs --file with the ad content`);
-}
-var adContentArgs = {
-  format: {
-    type: "string",
-    description: "responsiveSearch (default) | responsiveDisplay | call | app | video | demandGen | demandGenVideo"
-  },
-  headlines: {
-    type: "string",
-    description: `Headlines (RSA/RDA/demandGen/demandGenVideo/app) \u2014 ${AD_COPY_LIST_USAGE}`
-  },
-  descriptions: {
-    type: "string",
-    description: `Descriptions (RSA/RDA/demandGen/demandGenVideo/app) \u2014 ${AD_COPY_LIST_USAGE}`
-  },
-  path1: { type: "string" },
-  path2: { type: "string" },
-  "long-headline": { type: "string", description: "Long headline (responsiveDisplay)" },
-  "ad-name": {
-    type: "string",
-    description: `The ad's own name, shown as "Ad name" in Google Ads. REQUIRED on a Demand Gen ad (demandGen/demandGenVideo) and on no other format`
-  },
-  "long-headlines": {
-    type: "string",
-    description: `Long headlines, up to 5 of 90 chars (demandGenVideo \u2014 no other format has them) \u2014 ${AD_COPY_LIST_USAGE}`
-  },
-  "business-name": { type: "string", description: "Business name (responsiveDisplay/demandGen/demandGenVideo)" },
-  "marketing-images": {
-    type: "string",
-    description: "Comma-separated marketing image asset refs (responsiveDisplay)"
-  },
-  "square-marketing-images": {
-    type: "string",
-    description: "Comma-separated square marketing image asset refs (responsiveDisplay)"
-  },
-  "logo-images": { type: "string", description: "Comma-separated logo image asset refs (responsiveDisplay)" },
-  "video-assets": {
-    type: "string",
-    description: `Comma-separated video asset refs (video/app/demandGenVideo formats) \u2014 stage the YouTube video as an asset first (assets create --file '{"type":"youtubeVideo",\u2026}')`
-  },
-  "image-assets": { type: "string", description: "Comma-separated image asset refs (demandGen/app)" },
-  "square-image-assets": { type: "string", description: "Comma-separated square image asset refs (demandGen)" },
-  "logo-image-assets": {
-    type: "string",
-    description: "Comma-separated logo image asset refs (demandGen/demandGenVideo)"
-  },
-  "call-to-action-assets": {
-    type: "string",
-    description: "Comma-separated callToAction asset refs for the ad's button (demandGenVideo)"
-  },
-  "final-url": { type: "string", description: "Comma-separated final URLs" }
-};
-function assertNoContentFlags(args) {
-  const passed = Object.keys(adContentArgs).filter((flag) => flag !== "format" && args[flag] !== void 0);
-  if (passed.length > 0) {
-    failWriteValidation(
-      `${passed.map((flag) => `--${flag}`).join(", ")} only build an ad's content alongside --format (responsiveSearch | responsiveDisplay | call | app | video | demandGen | demandGenVideo) \u2014 add it, or pass --file with the complete content`
-    );
-  }
-}
-var adsCommand = defineCommand2({
-  meta: { name: "ads", description: "Stage ad create/update/pause/resume/remove" },
-  subCommands: {
-    create: defineCommand2({
-      meta: {
-        name: "create",
-        description: "Stage an ad (responsive search via flags; other formats via --file). RSA needs 3\u201315 headlines and 2\u20134 descriptions \u2014 give Google 8\u201312 varied headlines to test, and stage 2\u20134 ads per ad group. Performance Max has no ad format of its own \u2014 stage its copy with `asset-groups create`."
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        "ad-group-ref": { type: "string", description: "Ad group ref" },
-        ...adContentArgs,
-        status: { type: "string" }
-      },
-      run: async ({ args: parsedArgs, rawArgs }) => {
-        const args = withRepeatedCopyFlags(parsedArgs, rawArgs);
-        const customerId = requireCustomerId(args);
-        const file = loadJsonFileArg(args.file);
-        const format = args.format ?? "responsiveSearch";
-        const content = adContentFromFlags(args, format, file.content);
-        await stageCreate(
-          "google.ad.create",
-          customerId,
-          {
-            adGroup: requireStringFlag(args["ad-group-ref"] ?? file.adGroup, "--ad-group-ref"),
-            status: args.status ?? file.status,
-            content
-          },
-          copyListSplitHints(args)
-        );
-      }
-    }),
-    update: defineCommand2({
-      meta: {
-        name: "update",
-        description: "Stage an ad update. Any content change needs --format plus EVERY required field of that format (or --file with the complete content) \u2014 a field you send replaces its current value wholesale, so a list you pass must already include the entries you want to keep. Optional asset lists you omit entirely are left untouched on the ad. Status-only changes need neither --format nor content flags."
-      },
-      args: { ...customerIdArg, ...fileArg, ...adContentArgs, status: { type: "string" } },
-      run: async ({ args: parsedArgs, rawArgs }) => {
-        const args = withRepeatedCopyFlags(parsedArgs, rawArgs);
-        const customerId = requireCustomerId(args);
-        const file = loadJsonFileArg(args.file);
-        const format = args.format;
-        if (!format) {
-          assertNoContentFlags(args);
-        }
-        const payload = mergePayload(file, {
-          status: args.status,
-          ...format ? { content: adContentFromFlags(args, format, file.content) } : {}
-        });
-        await stageUpdate("google.ad.update", customerId, requireTarget(args, "ad"), payload, [
-          ...payload.content !== void 0 ? [
-            "Each content field you sent replaces its current value wholesale at publish \u2014 re-check that every headline, description, final URL and asset you want to KEEP is in this payload, not just the ones you changed."
-          ] : [],
-          ...format ? copyListSplitHints(args) : []
-        ]);
-      }
-    }),
-    pause: statusCommand("google.ad.pause", "ad"),
-    resume: statusCommand("google.ad.resume", "ad"),
-    remove: statusCommand("google.ad.remove", "ad")
-  }
-});
-var assetGroupsCommand = defineCommand2({
-  meta: {
-    name: "asset-groups",
-    description: "Stage Performance Max asset group create/update \u2014 the PMax campaign's copy and images."
-  },
-  subCommands: {
-    create: defineCommand2({
-      meta: {
-        name: "create",
-        description: "Stage a Performance Max asset group: 3\u201315 headlines (\u226430ch), 1\u20135 long headlines (\u226490ch), 2\u20135 descriptions (\u226490ch), a business name, and image refs."
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        "campaign-ref": {
-          type: "string",
-          description: "Performance Max campaign ref (g_temp_*, id, or resource name)"
-        },
-        name: { type: "string", description: "Asset group name" },
-        "final-urls": { type: "string", description: "Comma-separated final URLs" },
-        headlines: { type: "string", description: `Headlines (3\u201315, \u226430 chars) \u2014 ${AD_COPY_LIST_USAGE}` },
-        "long-headlines": { type: "string", description: `Long headlines (1\u20135, \u226490 chars) \u2014 ${AD_COPY_LIST_USAGE}` },
-        descriptions: { type: "string", description: `Descriptions (2\u20135, \u226490 chars) \u2014 ${AD_COPY_LIST_USAGE}` },
-        "business-name": { type: "string" },
-        "image-assets": { type: "string", description: "Comma-separated marketing image asset refs (1.91:1)" },
-        "square-image-assets": {
-          type: "string",
-          description: "Comma-separated square marketing image asset refs (1:1)"
-        },
-        "portrait-image-assets": {
-          type: "string",
-          description: "Comma-separated portrait marketing image asset refs (4:5)"
-        },
-        "logo-assets": { type: "string", description: "Comma-separated logo image asset refs" },
-        status: { type: "string", description: "ENABLED | PAUSED (default PAUSED)" }
-      },
-      run: async ({ args: parsedArgs, rawArgs }) => {
-        const args = withRepeatedCopyFlags(parsedArgs, rawArgs);
-        const customerId = requireCustomerId(args);
-        const headlines = copyListFlag(args.headlines, "headlines");
-        const longHeadlines = copyListFlag(args["long-headlines"], "long-headlines");
-        const descriptions = copyListFlag(args.descriptions, "descriptions");
-        const payload = mergePayload(loadJsonFileArg(args.file), {
-          campaign: args["campaign-ref"],
-          name: args.name,
-          finalUrls: listFlag(args["final-urls"]),
-          headlines: headlines?.map((text) => ({ text })),
-          longHeadlines: longHeadlines?.map((text) => ({ text })),
-          descriptions: descriptions?.map((text) => ({ text })),
-          businessName: args["business-name"],
-          imageAssets: listFlag(args["image-assets"]),
-          squareImageAssets: listFlag(args["square-image-assets"]),
-          portraitImageAssets: listFlag(args["portrait-image-assets"]),
-          logoAssets: listFlag(args["logo-assets"]),
-          status: args.status
-        });
-        await stageCreate("google.assetGroup.create", customerId, payload, copyListSplitHints(args));
-      }
-    }),
-    update: defineCommand2({
-      meta: { name: "update", description: "Stage a Performance Max asset group update" },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        name: { type: "string" },
-        "final-urls": { type: "string", description: "Comma-separated final URLs" },
-        status: { type: "string", description: "ENABLED | PAUSED | REMOVED" }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        const target = requireTarget(args, "asset group");
-        const payload = mergePayload(loadJsonFileArg(args.file), {
-          name: args.name,
-          finalUrls: listFlag(args["final-urls"]),
-          status: args.status
-        });
-        await stageUpdate("google.assetGroup.update", customerId, target, payload);
-      }
-    }),
-    attach: defineCommand2({
-      meta: {
-        name: "attach",
-        description: "Add one existing asset to an existing asset group. Start here to refresh a live PMax group's creatives: attach the new image, then `detach` the old one \u2014 never detach first."
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        "asset-group-ref": { type: "string", description: "Asset group ref (g_temp_*, id, or resource name)" },
-        "asset-ref": { type: "string", description: "Asset ref (g_temp_*, id, or resource name)" },
-        "field-type": {
-          type: "string",
-          description: `Slot the asset fills: ${ASSET_GROUP_ASSET_FIELD_TYPES.join(" | ")}`
-        }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        const payload = mergePayload(loadJsonFileArg(args.file), {
-          assetGroup: args["asset-group-ref"],
-          asset: args["asset-ref"],
-          fieldType: args["field-type"]
-        });
-        await stageCreate("google.assetGroupAsset.attach", customerId, payload, [
-          "Swapping a creative? Stage the matching `asset-groups detach` for the image this one replaces \u2014 an attach alone grows the group instead of refreshing it.",
-          "The field type must match the image's real ratio (1.91:1 \u2192 MARKETING_IMAGE, 1:1 \u2192 SQUARE_MARKETING_IMAGE, 4:5 \u2192 PORTRAIT_MARKETING_IMAGE); Google rejects a mismatch at publish.",
-          "Slots have ceilings as well as minimums: BUSINESS_NAME and CALL_TO_ACTION_SELECTION hold 1, LOGO 5, LONG_HEADLINE and DESCRIPTION 5, HEADLINE 15, YOUTUBE_VIDEO 15, images 20. Adding to a full slot is rejected exactly like removing below an empty one, so count what the group already holds (`SELECT asset_group_asset.field_type FROM asset_group_asset WHERE asset_group.id = \u2026`) and stage the detach alongside when it is full."
-        ]);
-      }
-    }),
-    detach: statusCommand("google.assetGroupAsset.detach", "asset group asset", [
-      "Stage order is execution order \u2014 if you are replacing this image, its `asset-groups attach` must already be staged BEFORE this detach, or Google sees the group below its per-ratio minimum and rejects the removal.",
-      "Pass the full composite resource name (customers/{cid}/assetGroupAssets/{assetGroupId}~{assetId}~{FIELD_TYPE}) \u2014 read it from `asset_group_asset.resource_name` via `ads google query`, scoping `asset_group_asset.status != 'REMOVED'`: the link carries its own status and Google returns an already-detached one like any other row."
-    ])
-  }
-});
-function fileCreateCommand(name, kind, description, hints) {
-  return defineCommand2({
-    meta: { name, description },
-    args: { ...customerIdArg, ...fileArg },
-    run: async ({ args }) => {
-      const customerId = requireCustomerId(args);
-      const payload = loadJsonFileArg(args.file);
-      if (Object.keys(payload).length === 0) {
-        failWriteValidation(`${kind} needs --file with the op payload`);
-      }
-      await stageGoogleOp({ kind, customerId, payload }, typeof hints === "function" ? hints(payload) : hints);
-    }
-  });
-}
-function imageAssetHints(payload) {
-  if (payload.type !== "image") {
-    return [];
-  }
-  return [
-    "This image publishes into the advertiser's Google Ads asset library. Stage the `assets attach` too, with field type AD_IMAGE on the campaign (or ad group) it belongs on: Google opens Search image links per account, so Baker asks Google as you stage \u2014 where the account takes them the link is staged and applies at publish, and where it does not the link is skipped and names the campaign in the handover Task.",
-    "Until a link to it is staged, Baker keeps a Task for this image in this chat's changes \u2014 the user adding it to the campaign under Assets \u2014 and withdraws it when an accepted link names the image; do not stage a second one with `baker actions`. If that Task is still there after the attach, tell the user the images are already in their Google Ads account and only need adding to the campaign under Assets, and name them. Never tell them to upload images they already have. (A Performance Max asset group is different \u2014 images link there with `asset-groups attach`.)"
-  ];
-}
-var assetsUpdateCommand = defineCommand2({
-  meta: {
-    name: "update",
-    description: "Update a staged or live asset in place (flat partial \u2014 set only the fields that changed). Works across asset types: sitelink (--link-text/--description1/--description2/--final-urls), callout (--callout-text), structured snippet (--header/--values), call-to-action (--cta), text (--text), or --name."
-  },
-  args: {
-    ...customerIdArg,
-    ...fileArg,
-    name: { type: "string", description: "Asset display name" },
-    "link-text": { type: "string", description: "Sitelink link text" },
-    description1: { type: "string", description: "Sitelink description line 1" },
-    description2: { type: "string", description: "Sitelink description line 2" },
-    "final-urls": { type: "string", description: "Comma-separated sitelink final URLs" },
-    "callout-text": { type: "string", description: "Callout text" },
-    header: { type: "string", description: "Structured snippet header" },
-    values: { type: "string", description: "Comma-separated structured snippet values (3-10, max 25 characters each)" },
-    cta: { type: "string", description: "Call-to-action text" },
-    text: { type: "string", description: "Text asset content" }
-  },
-  run: async ({ args }) => {
-    const customerId = requireCustomerId(args);
-    const target = requireTarget(args, "asset");
-    const payload = mergePayload(loadJsonFileArg(args.file), {
-      name: args.name,
-      linkText: args["link-text"],
-      description1: args.description1,
-      description2: args.description2,
-      finalUrls: listFlag(args["final-urls"]),
-      calloutText: args["callout-text"],
-      header: args.header,
-      values: listFlag(args.values),
-      callToAction: args.cta,
-      text: args.text
-    });
-    await stageUpdate("google.asset.update", customerId, target, payload);
-  }
-});
-var assetsCommand = defineCommand2({
-  meta: {
-    name: "assets",
-    description: "Stage asset create/update + asset-link attach/detach (via --file). For a high-performance Search campaign add \u22654 sitelinks, \u22653 callouts and \u22651 structured snippet per campaign. Image extensions: `create` uploads the image into the advertiser's account, then `attach` links it with field type AD_IMAGE (campaign or ad group). Google opens image links per account, so Baker asks Google as you stage: an account that takes them stages the link like a sitelink; one that does not skips it and stages a handover Task instead \u2014 never tell them to upload anything. The advertiser's logo links as BUSINESS_LOGO, at campaign or customer level, on a verified account."
-  },
-  subCommands: {
-    create: fileCreateCommand(
-      "create",
-      "google.asset.create",
-      "Stage an asset (text/image/sitelink/callout/structuredSnippet/\u2026)",
-      imageAssetHints
-    ),
-    update: assetsUpdateCommand,
-    attach: fileCreateCommand("attach", "google.assetLink.attach", "Attach an asset to a campaign/adGroup/customer", [
-      'Search image extensions link as AD_IMAGE, at campaign or ad group level: `{"level":"campaign","parent":"<campaign id>","asset":"<image asset id or g_temp_ ref>","fieldType":"AD_IMAGE"}`. Google opens these per advertiser account, so Baker asks Google (a check that changes nothing) as you stage. The image must be 1.91:1 or 1:1 \u2014 any other shape is sent back to crop. Accepted \u2192 the link is staged and applies at publish. Refused or not confirmed \u2192 it is skipped rather than stored, the rest of a batch is unaffected, and Baker stages the handover Task naming those images and that campaign; then tell the user they are already in their Google Ads account and only need adding to the campaign under Assets, and do not stage a second Task with `baker actions`. MARKETING_IMAGE / SQUARE_MARKETING_IMAGE are Performance Max asset-group slots (`asset-groups attach`), never a Search link. The advertiser\'s logo links as `BUSINESS_LOGO` (campaign or customer level, on a verified account).'
-    ]),
-    detach: statusCommand("google.assetLink.detach", "asset link", [
-      "Pass the resource name Google gave you \u2014 `SELECT campaign_asset.resource_name \u2026 FROM campaign_asset WHERE campaign_asset.status != 'REMOVED'` (or `ad_group_asset` / `customer_asset`) \u2014 never one composed out of an owner id and an asset id. A link's own status is not its campaign's and not its ad group's, so an inventory read scoped only to those lists extensions that are already detached, and a link between an asset and an owner that never held it parses fine and exists nowhere. Either way the target is read back before it is staged, and a detach of a link that is not there is refused here rather than at publish."
-    ])
-  }
-});
-var audienceModeArg = {
-  mode: {
-    type: "string",
-    description: "observation = the audience only adjusts bids, reach is unchanged | targeting = the ads are shown only to people in the audiences attached to this campaign/ad group"
-  }
-};
-function requireAudienceMode(value) {
-  const mode = typeof value === "string" ? value.toLowerCase() : void 0;
-  if (mode !== "observation" && mode !== "targeting") {
-    failWriteValidation(
-      `pass --mode observation (the audience adjusts bids and reach is unchanged \u2014 the Google Ads interface's default) or --mode targeting (the ads are shown only to people in the audiences on this campaign/ad group). There is no safe default: the API's own default is targeting, which can cut a campaign's reach to the size of the list.`
-    );
-  }
-  return mode === "observation" ? "OBSERVATION" : "TARGETING";
-}
-function requireAudienceLevel(value) {
-  const level = requireStringFlag(value, "--level");
-  if (level !== "campaign" && level !== "adGroup") {
-    failWriteValidation("--level must be campaign or adGroup");
-  }
-  return level;
-}
-var AUDIENCE_ATTACH_HINTS = [
-  'Read back what the parent ended up with before you report: `baker ads google query "SELECT campaign.id, campaign.targeting_setting.target_restrictions FROM campaign"` (or the ad_group equivalent). A missing AUDIENCE row means TARGETING \u2014 Google does not serialize an empty setting, so absence is a value, not a gap.',
-  "Staging checks the list is big enough to serve on this campaign's network (1,000 users on search, 100 on display) and refuses a targeting attach that is not. It does NOT check delivery afterwards, and Google reports no error when an audience stops a campaign serving \u2014 after publishing, read the campaign's impressions for the hour that follows and say what you saw."
-];
-var audiencesAttachCommand = defineCommand2({
-  meta: {
-    name: "attach",
-    description: "Target or exclude an audience (user list) on a campaign or ad group. Start here: baker ads google audiences attach --customer-id 1234567890 --level campaign --parent 23837707642 --user-list 9398951971 --mode observation. `--mode` is required for a positive attach and decides whether the list only adjusts bids (observation) or narrows who sees the ads (targeting) \u2014 with --mode observation the audience setting is staged alongside the attach, because Google's API otherwise defaults to targeting."
-  },
-  args: {
-    ...customerIdArg,
-    ...fileArg,
-    ...audienceModeArg,
-    level: { type: "string", description: "campaign | adGroup" },
-    parent: { type: "string", description: "Campaign or ad group id (or a g_temp_* ref staged earlier)" },
-    "user-list": { type: "string", description: "User list id (or a g_temp_* ref from `audiences create`)" },
-    negative: { type: "boolean", description: "Exclude this audience instead of targeting it" }
-  },
-  run: async ({ args }) => {
-    const customerId = requireCustomerId(args);
-    const payload = mergePayload(loadJsonFileArg(args.file), {
-      level: args.level,
-      parent: args.parent,
-      userList: args["user-list"],
-      negative: args.negative
-    });
-    if (payload.negative === true) {
-      if (args.mode !== void 0) {
-        failWriteValidation(
-          "--mode does not apply to --negative: an excluded audience is excluded under both observation and targeting. Drop --mode, or drop --negative if you meant to target the list."
-        );
-      }
-      await stageGoogleOp({ kind: "google.audienceCriterion.attach", customerId, payload });
-      return;
-    }
-    const ops = audienceAttachOps(customerId, payload, requireAudienceMode(args.mode));
-    await stageGoogleOps(ops, AUDIENCE_ATTACH_HINTS);
-  }
-});
-function audienceAttachOps(customerId, payload, mode) {
-  const attachOp = { kind: "google.audienceCriterion.attach", customerId, payload };
-  if (mode === "TARGETING") {
-    return [attachOp];
-  }
-  return [
-    {
-      kind: "google.targetingSetting.set",
-      customerId,
-      payload: { level: payload.level, parent: payload.parent, audience: "OBSERVATION" }
-    },
-    attachOp
-  ];
-}
-var audiencesTargetingCommand = defineCommand2({
-  meta: {
-    name: "targeting",
-    description: "Switch the audiences already on a campaign or ad group between observation (they adjust bids only) and targeting (the ads are shown only to people in them) \u2014 the Observation/Targeting selector in the Google Ads interface. Start here: baker ads google audiences targeting 195883284706 --customer-id 1234567890 --level adGroup --mode observation."
-  },
-  args: {
-    ...customerIdArg,
-    ...audienceModeArg,
-    level: { type: "string", description: "campaign | adGroup" }
-  },
-  run: async ({ args }) => {
-    const customerId = requireCustomerId(args);
-    const parent = requireTarget(args, "campaign or ad group");
-    await stageGoogleOp({
-      kind: "google.targetingSetting.set",
-      customerId,
-      payload: { level: requireAudienceLevel(args.level), parent, audience: requireAudienceMode(args.mode) }
-    });
-  }
-});
-var audiencesCommand = defineCommand2({
-  meta: {
-    name: "audiences",
-    description: "Stage audience (user list) create, criterion attach/detach, and the observation/targeting setting the criteria are read under"
-  },
-  subCommands: {
-    create: fileCreateCommand("create", "google.audience.create", "Stage a user-list audience"),
-    attach: audiencesAttachCommand,
-    detach: statusCommand("google.audienceCriterion.detach", "audience criterion"),
-    targeting: audiencesTargetingCommand
-  }
-});
-var PRIMARY_FOR_GOAL_QUERY = 'baker ads google query "SELECT conversion_action.name, conversion_action.primary_for_goal, conversion_action.status FROM conversion_action"';
-var CONVERSION_CREATE_HINTS = [
-  `A new conversion action is staged as SECONDARY (reported, not bid toward) unless the payload says \`"primaryForGoal": true\` \u2014 Google otherwise decides for you, and an accidentally-primary action redirects the spend of every Maximize Conversions / Target CPA campaign. Ask the user which they want rather than guessing.`
-];
-var CONVERSION_ROLE_HINTS = [
-  `Primary actions are what Maximize Conversions / Target CPA campaigns bid toward. Before publishing, list what the account will be left with: ${PRIMARY_FOR_GOAL_QUERY} \u2014 and say so if this leaves no primary action, because bidding then has nothing to optimize toward.`
-];
-function conversionGoalFromFlags(args) {
-  const booleanWord = booleanWordPositionalError(args, "conversion goal");
-  if (booleanWord) {
-    failWriteValidation(booleanWord);
-  }
-  const category = requireStringFlag(args.category, "--category").toUpperCase();
-  const origin = requireStringFlag(args.origin, "--origin").toUpperCase();
-  if (typeof args.biddable !== "boolean") {
-    failWriteValidation(
-      "pass --biddable (this conversion category drives automated bidding) or --no-biddable (it is measured only). There is no safe default \u2014 this changes what the whole account bids toward."
-    );
-  }
-  if (!CONVERSION_ACTION_CATEGORIES.includes(category)) {
-    failWriteValidation(`--category must be one of ${CONVERSION_ACTION_CATEGORIES.join(" | ")}`);
-  }
-  if (!CONVERSION_ORIGINS.includes(origin)) {
-    failWriteValidation(`--origin must be one of ${CONVERSION_ORIGINS.join(" | ")}`);
-  }
-  return { category, origin, biddable: args.biddable };
-}
-var CONVERSION_GOAL_QUERY = 'baker ads google query "SELECT customer_conversion_goal.category, customer_conversion_goal.origin, customer_conversion_goal.biddable FROM customer_conversion_goal"';
-var CONVERSION_GOAL_HINTS = [
-  `A conversion drives automated bidding only when BOTH halves are on: the action is primary (\`conversions update --primary\`) AND its category's account-level goal is included (this command). Before publishing, read back what the account will bid toward: ${CONVERSION_GOAL_QUERY} \u2014 and say plainly which conversions this leaves driving spend.`
-];
-var conversionsCommand = defineCommand2({
-  meta: {
-    name: "conversions",
-    description: "Stage conversion action create/update (via --file), the account-level goal, and manual conversion uploads for a period where tracking was broken"
-  },
-  subCommands: {
-    upload: () => import("./conversion-upload-command-AUF3LNTH.js").then((m) => m.conversionsUploadCommand),
-    create: fileCreateCommand(
-      "create",
-      "google.conversionAction.create",
-      "Stage a conversion action (secondary unless the payload sets primaryForGoal)",
-      CONVERSION_CREATE_HINTS
-    ),
-    update: defineCommand2({
-      meta: {
-        name: "update",
-        description: "Stage a conversion action update. --primary makes it a primary action (automated bidding optimizes toward it); --no-primary demotes it to secondary (reported only)."
-      },
-      args: {
-        ...customerIdArg,
-        ...fileArg,
-        primary: {
-          type: "boolean",
-          // The spaced form is refused by `booleanWordPositionalError`, shared by every ad surface
-          // and the source of truth for this — the description only states the forms that work.
-          description: "Primary action \u2014 automated bidding optimizes toward it. Demote to secondary (reported only) with --no-primary or --primary=false."
-        }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        const payload = mergePayload(loadJsonFileArg(args.file), { primaryForGoal: args.primary });
-        await stageUpdate(
-          "google.conversionAction.update",
-          customerId,
-          requireTarget(args, "conversion action"),
-          payload,
-          payload.primaryForGoal === void 0 ? void 0 : CONVERSION_ROLE_HINTS
-        );
-      }
-    }),
-    goal: defineCommand2({
-      meta: {
-        name: "goal",
-        description: `Stage the ACCOUNT-LEVEL conversion goal for one (category, origin) pair \u2014 Google Ads' "Included in account-level goals" switch. Start here when a conversion action is already Primary but bidding still ignores it: both halves have to be on. One command per pair. --biddable includes the category in bidding; --no-biddable measures it only.`
-      },
-      args: {
-        ...customerIdArg,
-        category: {
-          type: "string",
-          description: `Conversion category, e.g. PURCHASE, SUBMIT_LEAD_FORM, SIGNUP (${CONVERSION_ACTION_CATEGORIES.join(" | ")})`
-        },
-        origin: {
-          type: "string",
-          description: `Where the conversion happens (${CONVERSION_ORIGINS.join(" | ")})`
-        },
-        biddable: {
-          type: "boolean",
-          // The spaced form is refused by `booleanWordPositionalError` — the description only states
-          // the forms that work.
-          description: "Include this category in the account's bidding goals. Exclude it (measured only, never bid toward) with --no-biddable or --biddable=false."
-        }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        await stageCreate("google.conversionAction.goal", customerId, conversionGoalFromFlags(args), [
-          ...CONVERSION_GOAL_HINTS
-        ]);
-      }
-    })
-  }
-});
-var biddingStrategiesCommand = defineCommand2({
-  meta: { name: "bidding-strategies", description: "Stage portfolio bidding strategy create/update (via --file)" },
-  subCommands: {
-    create: fileCreateCommand("create", "google.biddingStrategy.create", "Stage a portfolio bidding strategy"),
-    update: defineCommand2({
-      meta: { name: "update", description: "Stage a portfolio bidding strategy update" },
-      args: { ...customerIdArg, ...fileArg },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        await stageUpdate(
-          "google.biddingStrategy.update",
-          customerId,
-          requireTarget(args, "bidding strategy"),
-          loadJsonFileArg(args.file)
-        );
-      }
-    })
-  }
-});
-var labelsCommand = defineCommand2({
-  meta: { name: "labels", description: "Stage label create + attach (via --file)" },
-  subCommands: {
-    create: defineCommand2({
-      meta: { name: "create", description: "Create a label" },
-      args: {
-        ...customerIdArg,
-        name: { type: "string" },
-        "background-color": { type: "string" },
-        description: { type: "string" }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        await stageCreate("google.label.create", customerId, {
-          name: requireStringFlag(args.name, "--name"),
-          backgroundColor: args["background-color"],
-          description: args.description
-        });
-      }
-    }),
-    attach: fileCreateCommand("attach", "google.label.attach", "Attach a label to a campaign/adGroup/ad")
-  }
-});
-function bidModifierFlag(value) {
-  if (value === void 0 || value === null || value === "") {
-    failWriteValidation(
-      "--bid-modifier is required: 1 for no adjustment, 1.25 to bid 25% more, 0.9 to bid 10% less, 0 to stop serving on it"
-    );
-  }
-  const num = Number(value);
-  if (Number.isNaN(num) || num < 0 || num > 10 || num > 0 && num < 0.1) {
-    failWriteValidation("--bid-modifier must be 0 (stop serving on it) or between 0.1 and 10.0");
-  }
-  return num;
-}
-var campaignCriteriaCommand = defineCommand2({
-  meta: {
-    name: "campaign-criteria",
-    description: "Stage campaign criteria (location/language/adSchedule/device): add/remove a targeting criterion, or update a device bid adjustment"
-  },
-  subCommands: {
-    add: fileCreateCommand("add", "google.campaignCriterion.add", "Add a campaign criterion"),
-    update: defineCommand2({
-      meta: {
-        name: "update",
-        description: "Change a criterion's bid adjustment \u2014 the only way to change a device setting the campaign already has, since Google never lets one be removed. Start here: `campaign-criteria update customers/<cid>/campaignCriteria/<campaignId>~<criterionId> --bid-modifier 1` resets a boost to neutral; --bid-modifier 0 stops ads serving on that device. Use `campaign-criteria add` instead when the campaign has no criterion for that device yet. Read the current ones with: baker ads google query \"SELECT campaign_criterion.resource_name, campaign_criterion.device.type, campaign_criterion.bid_modifier FROM campaign_criterion WHERE campaign_criterion.type = 'DEVICE'\""
-      },
-      args: {
-        ...customerIdArg,
-        id: {
-          type: "positional",
-          description: "Criterion resource name (customers/\u2026/campaignCriteria/{campaignId}~{criterionId})",
-          required: false
-        },
-        "bid-modifier": {
-          type: "string",
-          description: "1 = no adjustment, 1.25 = bid 25% more, 0.9 = bid 10% less, 0 = don't serve on it"
-        }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        const target = requireTarget(args, "campaign criterion");
-        await stageUpdate("google.campaignCriterion.update", customerId, target, {
-          bidModifier: bidModifierFlag(args["bid-modifier"])
-        });
-      }
-    }),
-    remove: defineCommand2({
-      meta: {
-        name: "remove",
-        description: "Stage a campaign criterion remove. Works for what you added \u2014 locations, languages, ad schedules. A device setting CANNOT be removed once the campaign has one: use `campaign-criteria update --bid-modifier` to change or neutralise it instead."
-      },
-      args: {
-        ...customerIdArg,
-        id: { type: "positional", description: "Criterion resource name or id", required: false }
-      },
-      run: async ({ args }) => {
-        const customerId = requireCustomerId(args);
-        await stageTarget("google.campaignCriterion.remove", customerId, requireTarget(args, "campaign criterion"));
-      }
-    })
-  }
-});
-var googleWriteCommands = {
-  budgets: budgetsCommand,
-  campaigns: campaignsCommand,
-  "ad-groups": adGroupsCommand,
-  "negative-keywords": negativeKeywordsCommand,
-  "keyword-lists": keywordListsCommand,
-  ads: adsCommand,
-  assets: assetsCommand,
-  "asset-groups": assetGroupsCommand,
-  audiences: audiencesCommand,
-  conversions: conversionsCommand,
-  "bidding-strategies": biddingStrategiesCommand,
-  labels: labelsCommand,
-  "campaign-criteria": campaignCriteriaCommand
-};
-
-// src/commands/ads/google/index.ts
-var keywordsWithWrites = defineCommand3({
-  meta: keywordsCommand.meta,
-  subCommands: { ...keywordsCommand.subCommands, ...keywordWriteSubcommands }
-});
-var googleCommand = defineCommand3({
-  meta: {
-    name: "google",
-    description: `Google Ads commands. Query campaigns, keywords, search terms, and more via GAQL.
-
-Start here:
-  baker ads google accounts                    \u2014 list accessible accounts
-  baker ads google query --list-presets        \u2014 see available query templates
-
-Examples:
-  baker ads google query "SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS" --customer-id 1234567890
-  baker ads google query --preset campaign-performance --customer-id 1234567890
-  baker ads google currency --customer-id 1234567890
-  baker ads google url-options --customer-id 1234567890   \u2014 UTM / tracking parameters in force
-  baker ads google keywords discover --customer-id 1234567890 --seeds "running shoes"
-
-Staged writes (never touch Google until the chat is published):
-  baker ads google budgets create --customer-id 1234567890 --name "Search" --amount 50
-  baker ads google campaigns create --customer-id 1234567890 --name "Brand" --channel-type SEARCH --budget-ref g_temp_\u2026 --bidding-strategy MANUAL_CPC
-  baker ads google keyword-lists create --customer-id 1234567890 --name "Brand exclusions"
-  baker ads google draft list                  \u2014 review staged Google Ads changes
-Full guide: __tooling__/docs/tools/baker/ads-google.md`
-  },
-  subCommands: {
-    accounts: () => import("./accounts-KYJO3JC6.js").then((m) => m.accountsCommand),
-    currency: () => import("./currency-XCGKQ7FE.js").then((m) => m.currencyCommand),
-    "url-options": () => import("./url-options-GGXAL3J4.js").then((m) => m.urlOptionsCommand),
-    changes: () => import("./changes-TP7ZZHB3.js").then((m) => m.changesCommand),
-    query: () => import("./query-IEZRY6HV.js").then((m) => m.queryCommand),
-    keywords: keywordsWithWrites,
-    ...googleWriteCommands,
-    draft: () => import("./draft-5YAYCEYY.js").then((m) => m.draftCommand)
-  }
-});
-export {
-  googleCommand
-};
-//# sourceMappingURL=google-M7KEXVK5.js.map