@koda-sl/baker-cli 0.556.0 → 0.558.0

package/dist/chunk-NPGPRZW2.js

@@ -0,0 +1,1313 @@
+import {
+  CHANGES_MAX_LIMIT,
+  CHANGE_RESOURCE_TYPES,
+  CHANGE_SCOPES,
+  CHANGE_SCOPE_MAX_DAYS,
+  DEFAULT_CHANGE_DAYS,
+  isChangeLookbackWithinReach
+} from "./chunk-Q2JDS6WL.js";
+import {
+  connectionFixExplanation,
+  isNotConnectedError
+} from "./chunk-QYH2UZAK.js";
+
+// src/commands/ads/google/during-literals.ts
+var GAQL_DURING_LITERALS = [
+  "TODAY",
+  "YESTERDAY",
+  "LAST_7_DAYS",
+  "LAST_14_DAYS",
+  "LAST_30_DAYS",
+  "LAST_BUSINESS_WEEK",
+  "THIS_MONTH",
+  "LAST_MONTH",
+  "THIS_WEEK_SUN_TODAY",
+  "THIS_WEEK_MON_TODAY",
+  "LAST_WEEK_SUN_SAT",
+  "LAST_WEEK_MON_SUN"
+];
+function isDuringLiteral(value) {
+  return GAQL_DURING_LITERALS.includes(value.toUpperCase());
+}
+function isoDay(date) {
+  return date.toISOString().slice(0, 10);
+}
+function utcDate(year, month, day) {
+  return new Date(Date.UTC(year, month, day));
+}
+function monthsBefore(date, months) {
+  const lastDayOfTarget = utcDate(date.getUTCFullYear(), date.getUTCMonth() - months + 1, 0).getUTCDate();
+  return utcDate(date.getUTCFullYear(), date.getUTCMonth() - months, Math.min(date.getUTCDate(), lastDayOfTarget));
+}
+function equivalentBetween(literal, now) {
+  const upper = literal.toUpperCase();
+  const today = utcDate(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+  const yesterday = utcDate(today.getUTCFullYear(), today.getUTCMonth(), today.getUTCDate() - 1);
+  const range = (from, to) => `BETWEEN '${isoDay(from)}' AND '${isoDay(to)}'`;
+  const year = today.getUTCFullYear();
+  const quarterStart = Math.floor(today.getUTCMonth() / 3) * 3;
+  const rolling = upper.match(/^LAST_(\d+)_(DAYS|WEEKS|MONTHS|YEARS)$/);
+  if (rolling) {
+    const n = Number(rolling[1]);
+    const unit = rolling[2];
+    if (n < 1) return null;
+    if (unit === "DAYS" || unit === "WEEKS") {
+      const days = unit === "DAYS" ? n : n * 7;
+      return range(utcDate(year, today.getUTCMonth(), today.getUTCDate() - days), yesterday);
+    }
+    const months = unit === "MONTHS" ? n : n * 12;
+    return range(monthsBefore(today, months), yesterday);
+  }
+  switch (upper) {
+    case "THIS_YEAR":
+      return range(utcDate(year, 0, 1), today);
+    case "LAST_YEAR":
+      return range(utcDate(year - 1, 0, 1), utcDate(year - 1, 11, 31));
+    case "THIS_QUARTER":
+      return range(utcDate(year, quarterStart, 1), today);
+    case "LAST_QUARTER":
+      return range(utcDate(year, quarterStart - 3, 1), utcDate(year, quarterStart, 0));
+    default:
+      return null;
+  }
+}
+function duringLiteralExplanation(literal, between) {
+  const accepted = GAQL_DURING_LITERALS.join(", ");
+  const lead = between ? `Google does not accept ${literal} after DURING. The same window as explicit dates is ${between}.` : `Google does not accept ${literal} after DURING, and it names no fixed window \u2014 use BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD', or drop the date filter.`;
+  return `${lead} DURING accepts only: ${accepted}. Any other window needs BETWEEN.`;
+}
+
+// src/commands/ads/google/changes-window.ts
+function monthlySpendTrendQuery(now = /* @__PURE__ */ new Date()) {
+  return `SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date ${equivalentBetween("LAST_12_MONTHS", now)}`;
+}
+function isChangeScope(value) {
+  return CHANGE_SCOPES.includes(value);
+}
+function resolveChangesWindow(input) {
+  const refusal = changesFilterRefusal(input);
+  if (refusal) return { ok: false, error: refusal };
+  const scope = input.scope ?? "detail";
+  if (!isChangeScope(scope)) {
+    return {
+      ok: false,
+      error: {
+        code: "INVALID_SCOPE",
+        message: `Unknown scope '${scope}'. Use 'detail' (field-level changes, 30 days) or 'summary' (which resources changed, 90 days).`,
+        fix: {
+          action: "retry_with_flag",
+          explanation: "Pass --scope detail or --scope summary."
+        }
+      }
+    };
+  }
+  const days = input.days ?? DEFAULT_CHANGE_DAYS;
+  if (!Number.isInteger(days) || days < 1) {
+    return {
+      ok: false,
+      error: {
+        code: "INVALID_LOOKBACK",
+        message: `--days must be a whole number of days, got '${days}'.`,
+        fix: {
+          action: "retry_with_flag",
+          explanation: `Pass --days as a positive integer, e.g. --days ${DEFAULT_CHANGE_DAYS}.`
+        }
+      }
+    };
+  }
+  if (!isChangeLookbackWithinReach(days, scope)) {
+    return { ok: false, error: lookbackTooLong(scope, days, CHANGE_SCOPE_MAX_DAYS[scope]) };
+  }
+  return { ok: true, scope, days, hints: hintsFor(scope, days) };
+}
+function changesFilterRefusal(input) {
+  const { limit, resourceType } = input;
+  if (limit !== void 0 && (!Number.isInteger(limit) || limit < 1 || limit > CHANGES_MAX_LIMIT)) {
+    return {
+      code: "INVALID_LIMIT",
+      message: `--limit must be a whole number from 1 to ${CHANGES_MAX_LIMIT}, got '${limit}'.`,
+      fix: {
+        action: "retry_with_flag",
+        explanation: `Pass --limit ${CHANGES_MAX_LIMIT} at most. To see further back than one full read reaches, narrow with --resource-type or shorten --days and read again.`
+      }
+    };
+  }
+  if (resourceType && !CHANGE_RESOURCE_TYPES.includes(resourceType)) {
+    return {
+      code: "INVALID_RESOURCE_TYPE",
+      message: `--resource-type '${resourceType}' is not one the change history can be filtered by.`,
+      fix: {
+        action: "retry_with_flag",
+        explanation: `Use one of ${CHANGE_RESOURCE_TYPES.join(", ")}, or drop --resource-type and filter the rows by their resource type.`
+      }
+    };
+  }
+  return null;
+}
+function lookbackTooLong(scope, days, max) {
+  if (scope === "detail" && days <= CHANGE_SCOPE_MAX_DAYS.summary) {
+    return {
+      code: "LOOKBACK_TOO_LONG",
+      message: `Google keeps field-level change detail for ${max} days only; ${days} days is outside that window.`,
+      fix: {
+        action: "narrow_date_range",
+        explanation: `Re-run with --scope summary --days ${days} to reach back ${CHANGE_SCOPE_MAX_DAYS.summary} days. Summary tells you which campaigns, ad groups, ads and criteria changed and when, but not the old and new values \u2014 read the resource itself for current values.`
+      }
+    };
+  }
+  return {
+    code: "LOOKBACK_TOO_LONG",
+    message: `Google's account history API reaches back ${CHANGE_SCOPE_MAX_DAYS.summary} days at most; ${days} days is outside that window.`,
+    fix: {
+      action: "use_different_resource",
+      explanation: `Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (${monthlySpendTrendQuery()}) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters.`
+    }
+  };
+}
+function hintsFor(scope, days) {
+  const hints = [];
+  if (scope === "detail") {
+    hints.push(
+      `Detailed history covers the last ${CHANGE_SCOPE_MAX_DAYS.detail} days. For anything older use --scope summary (reaches ${CHANGE_SCOPE_MAX_DAYS.summary} days, reports which resources changed but not their values).`
+    );
+  } else {
+    hints.push(
+      "Summary history reports which resources changed and when, not old and new values. To see what a changed resource looks like now, query it by resource_name."
+    );
+    if (days > CHANGE_SCOPE_MAX_DAYS.detail) {
+      hints.push(
+        `Changes inside the last ${CHANGE_SCOPE_MAX_DAYS.detail} days also have field-level detail \u2014 re-run with --scope detail for those.`
+      );
+    }
+  }
+  return hints;
+}
+var CHANGE_TIME_FIELDS = ["change_event.change_date_time", "change_status.last_change_date_time"];
+function cappedChangesHint(rows, limit, days) {
+  if (rows.length < limit) return null;
+  const oldest = rows[rows.length - 1];
+  const at = CHANGE_TIME_FIELDS.map((field) => oldest?.[field]).find((value) => typeof value === "string");
+  const reached = typeof at === "string" ? `reaching back only to ${at}` : "not the whole window";
+  const more = limit < CHANGES_MAX_LIMIT ? `re-run with --limit ${Math.min(limit * 2, CHANGES_MAX_LIMIT)}, or narrow with --resource-type` : "narrow with --resource-type";
+  return `This read came back full at --limit ${limit}, ${reached}, not the ${days} days asked for: older changes almost certainly exist and are NOT shown. Do not conclude nothing changed before then \u2014 ${more}.`;
+}
+
+// src/commands/ads/google/presets.ts
+var BETWEEN_RE = /^BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'$/i;
+function isValidDateRange(value) {
+  const trimmed = value.trim();
+  return isDuringLiteral(trimmed) || BETWEEN_RE.test(trimmed);
+}
+function dateRangeError(dateRange, now) {
+  if (/^[A-Za-z0-9_]+$/.test(dateRange.trim())) {
+    return `Invalid date range: "${dateRange}". ${duringLiteralExplanation(dateRange, equivalentBetween(dateRange, now))} Pass it as --date-range "BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'".`;
+  }
+  return `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`;
+}
+var SERVING_CHAINS = {
+  keyword_view: ["campaign.status", "ad_group.status", "ad_group_criterion.status"],
+  ad_group_criterion: ["campaign.status", "ad_group.status", "ad_group_criterion.status"],
+  ad_group_ad: ["campaign.status", "ad_group.status", "ad_group_ad.status"],
+  search_term_view: ["campaign.status", "ad_group.status"],
+  ad_group: ["campaign.status", "ad_group.status"],
+  asset_group: ["campaign.status", "asset_group.status"],
+  // An asset link carries its own status, and it is not the campaign's, the ad group's or the asset
+  // group's. Google returns a REMOVED link like any other row, so a read scoped only to its owners
+  // lists extensions that are no longer attached to anything — which is what 74 detaches were planned
+  // from on a live account, every one of them refused at publish as `RESOURCE_NOT_FOUND`.
+  // `customer_asset` is deliberately absent: one rung, no ancestor to forget.
+  asset_group_asset: ["campaign.status", "asset_group.status", "asset_group_asset.status"],
+  campaign_asset: ["campaign.status", "campaign_asset.status"],
+  ad_group_asset: ["campaign.status", "ad_group.status", "ad_group_asset.status"]
+};
+var CORE_PRESETS = [
+  {
+    name: "campaign-performance",
+    description: "Campaign-level metrics overview",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign.advertising_channel_type, campaign.bidding_strategy_type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.all_conversions, metrics.conversions_value, metrics.ctr, metrics.average_cpc FROM campaign WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
+  {
+    name: "budget-limited",
+    description: "Campaigns Google reports as limited by budget, with each one's bid target next to its actual cost per conversion \u2014 the state where a target above actual now drives delivery up to the target instead of holding recent cost",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign.advertising_channel_type, campaign.bidding_strategy_type, campaign.primary_status, campaign.primary_status_reasons, campaign.target_cpa.target_cpa_micros, campaign.maximize_conversions.target_cpa_micros, campaign.target_roas.target_roas, campaign.maximize_conversion_value.target_roas, campaign.target_cpc.target_cpc_micros, campaign_budget.amount_micros, metrics.cost_micros, metrics.conversions, metrics.conversions_value, metrics.cost_per_conversion, metrics.search_budget_lost_impression_share FROM campaign WHERE campaign.primary_status_reasons CONTAINS ANY (BUDGET_CONSTRAINED) AND segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
+  {
+    name: "conversions-by-action",
+    description: "Which conversion action each campaign's conversions actually are \u2014 the read that says whether two campaigns' conversion rates are measuring the same event",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, segments.conversion_action_name, segments.conversion_action_category, metrics.conversions, metrics.all_conversions FROM campaign WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.conversions DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
+  {
+    name: "keyword-analysis",
+    description: "Keyword performance with match type, quality and the first-page, top-of-page and first-position CPC estimates",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ad_group_criterion.criterion_id, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type, ad_group_criterion.status, ad_group_criterion.quality_info.quality_score, ad_group_criterion.position_estimates.first_page_cpc_micros, ad_group_criterion.position_estimates.top_of_page_cpc_micros, ad_group_criterion.position_estimates.first_position_cpc_micros, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.all_conversions, metrics.ctr FROM keyword_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.impressions DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status", "ad_group.status", "ad_group_criterion.status"]
+  },
+  {
+    name: "keyword-serving",
+    description: "Why a keyword is limited \u2014 Google Ads' 'Eligible (Limited) / Below first page bid' column, with the first-page bid estimate, the current max CPC and quality score",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, ad_group.id, ad_group.name, ad_group_criterion.criterion_id, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type, ad_group_criterion.status, ad_group_criterion.primary_status, ad_group_criterion.primary_status_reasons, ad_group_criterion.system_serving_status, ad_group_criterion.approval_status, ad_group_criterion.effective_cpc_bid_micros, ad_group_criterion.effective_cpc_bid_source, ad_group_criterion.position_estimates.first_page_cpc_micros, ad_group_criterion.position_estimates.top_of_page_cpc_micros, ad_group_criterion.quality_info.quality_score, ad_group_criterion.quality_info.creative_quality_score, ad_group_criterion.quality_info.post_click_quality_score, ad_group_criterion.quality_info.search_predicted_ctr FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.negative = FALSE{statusScope} ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500,
+    statusFields: ["campaign.status", "ad_group.status", "ad_group_criterion.status"]
+  },
+  {
+    name: "positive-keywords",
+    description: "Positive (targeting) keywords only \u2014 excludes negatives",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ad_group_criterion.criterion_id, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type, ad_group_criterion.status, ad_group_criterion.negative FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.negative = FALSE{statusScope} ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500,
+    statusFields: ["campaign.status", "ad_group.status", "ad_group_criterion.status"]
+  },
+  {
+    name: "negative-keywords",
+    description: "Negative keywords only \u2014 campaign and ad group level",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, ad_group.name, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type, ad_group_criterion.negative FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.negative = TRUE AND campaign.status != 'REMOVED' ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  },
+  {
+    name: "negative-keyword-lists",
+    description: "Shared negative keyword lists and the terms inside them (SharedSet members), with each member's resource name \u2014 what `negative-keywords remove` / a list-member removal takes",
+    gaqlTemplate: `SELECT shared_set.id, shared_set.name, shared_criterion.resource_name, shared_criterion.criterion_id, shared_criterion.keyword.text, shared_criterion.keyword.match_type FROM shared_criterion WHERE shared_set.type = 'NEGATIVE_KEYWORDS' AND shared_set.status = 'ENABLED' ORDER BY shared_set.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  },
+  {
+    name: "negative-list-attachments",
+    description: "Which campaigns each shared negative keyword list is attached to",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, shared_set.id, shared_set.name FROM campaign_shared_set WHERE shared_set.type = 'NEGATIVE_KEYWORDS' AND campaign_shared_set.status = 'ENABLED' ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  },
+  {
+    name: "search-terms",
+    description: "Actual user search queries triggering ads, with the match type that matched them",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.name, ad_group.status, search_term_view.search_term, segments.search_term_match_type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.impressions DESC`,
+    defaultDateRange: "LAST_7_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status", "ad_group.status"]
+  },
+  {
+    name: "ad-copy-performance",
+    description: "Every ad's metrics, with its headlines and descriptions when it is a responsive search ad",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ad_group_ad.ad.id, ad_group_ad.ad.type, ad_group_ad.status, ad_group_ad.ad.responsive_search_ad.headlines, ad_group_ad.ad.responsive_search_ad.descriptions, ad_group_ad.ad.final_urls, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.all_conversions, metrics.ctr FROM ad_group_ad WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.impressions DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status", "ad_group.status", "ad_group_ad.status"]
+  },
+  {
+    name: "asset-performance",
+    // `asset_group_asset.performance_label` is gone (v25 answers UNRECOGNIZED_FIELD): Google retired
+    // the BEST/GOOD/LOW label, so the read is each asset's serving status and its own metrics.
+    description: "Performance Max assets: serving status and metrics per asset",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, asset_group.name, asset_group.status, asset_group_asset.status, asset_group_asset.field_type, asset_group_asset.primary_status, asset_group_asset.primary_status_reasons, asset.type, asset.text_asset.text, asset.image_asset.full_size.url, metrics.impressions, metrics.clicks, metrics.conversions, metrics.cost_micros FROM asset_group_asset WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX' AND segments.date DURING {dateRange}{statusScope}`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status", "asset_group.status", "asset_group_asset.status"]
+  },
+  {
+    name: "shopping-products",
+    description: "Product-level shopping performance metrics",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, segments.product_title, segments.product_item_id, segments.product_brand, segments.product_type_l1, metrics.clicks, metrics.impressions, metrics.cost_micros, metrics.conversions FROM shopping_performance_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
+  {
+    name: "account-summary",
+    description: "Account-level totals for a date range",
+    gaqlTemplate: `SELECT customer.id, customer.descriptive_name, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.all_conversions, metrics.conversions_value FROM customer WHERE segments.date DURING {dateRange} LIMIT 1`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 1
+  }
+];
+var REPORT_PRESETS = [
+  {
+    name: "pmax-channels",
+    description: "Performance Max spend and results split by channel (Search, YouTube, Display, Discover, Gmail, Maps\u2026) \u2014 segments.ad_network_type per campaign",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, segments.ad_network_type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.conversions_value FROM campaign WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX' AND segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
+  {
+    name: "pmax-placements",
+    description: "Where Performance Max ads showed on Display / YouTube / apps (Google reports impressions only for these)",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, performance_max_placement_view.display_name, performance_max_placement_view.placement, performance_max_placement_view.placement_type, performance_max_placement_view.target_url, metrics.impressions FROM performance_max_placement_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.impressions DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
+  {
+    name: "placements",
+    description: "Where Display, Video and Demand Gen ads showed \u2014 each website, app or YouTube video, with cost and conversions (exclusion candidates)",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, detail_placement_view.display_name, detail_placement_view.placement, detail_placement_view.placement_type, detail_placement_view.target_url, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM detail_placement_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status", "ad_group.status"]
+  },
+  {
+    name: "rsa-assets",
+    description: "Each responsive search ad headline and description: its text, pin, whether it is enabled, its approval and its own impressions/clicks/conversions",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ad_group_ad.ad.id, ad_group_ad.status, ad_group_ad_asset_view.field_type, ad_group_ad_asset_view.pinned_field, ad_group_ad_asset_view.enabled, ad_group_ad_asset_view.policy_summary, asset.id, asset.text_asset.text, metrics.impressions, metrics.clicks, metrics.conversions FROM ad_group_ad_asset_view WHERE ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' AND segments.date DURING {dateRange}{statusScope} ORDER BY metrics.impressions DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 500,
+    statusFields: ["campaign.status", "ad_group.status", "ad_group_ad.status"]
+  },
+  {
+    name: "landing-pages",
+    description: "Final URLs as written on the ads, with clicks, cost, conversions, mobile-friendly click share and speed score",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, landing_page_view.unexpanded_final_url, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.mobile_friendly_clicks_percentage, metrics.speed_score FROM landing_page_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.clicks DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
+  {
+    name: "geo-performance",
+    description: "Results by country and location type (people IN vs INTERESTED IN the place) per campaign \u2014 the read behind a Presence vs Presence-or-interest decision",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, geographic_view.country_criterion_id, geographic_view.location_type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM geographic_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
+  {
+    name: "age-performance",
+    description: "Results by age range per ad group",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ad_group_criterion.age_range.type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM age_range_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status", "ad_group.status"]
+  },
+  {
+    name: "gender-performance",
+    description: "Results by gender per ad group",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ad_group_criterion.gender.type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM gender_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status", "ad_group.status"]
+  },
+  {
+    name: "ai-max-search-terms",
+    description: "AI Max for Search: each search term with the headline and landing page Google generated or chose for it, with results",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ai_max_search_term_ad_combination_view.search_term, ai_max_search_term_ad_combination_view.headline, ai_max_search_term_ad_combination_view.landing_page, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM ai_max_search_term_ad_combination_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.impressions DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["campaign.status", "ad_group.status"]
+  },
+  {
+    name: "bidding-strategy-performance",
+    description: "Each portfolio bidding strategy's type, status, targets and metrics",
+    gaqlTemplate: `SELECT bidding_strategy.id, bidding_strategy.name, bidding_strategy.type, bidding_strategy.status, bidding_strategy.campaign_count, bidding_strategy.target_cpa.target_cpa_micros, bidding_strategy.target_roas.target_roas, bidding_strategy.maximize_conversions.target_cpa_micros, bidding_strategy.maximize_conversion_value.target_roas, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.all_conversions, metrics.conversions_value FROM bidding_strategy WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC`,
+    defaultDateRange: "LAST_30_DAYS",
+    defaultLimit: 200,
+    statusFields: ["bidding_strategy.status"]
+  },
+  {
+    name: "conversion-tags",
+    description: "The tracking code of each website and call conversion action: the Google tag and the event snippet to put on the site",
+    gaqlTemplate: `SELECT conversion_action.id, conversion_action.name, conversion_action.type, conversion_action.status, conversion_action.tag_snippets FROM conversion_action WHERE conversion_action.type IN ('WEBPAGE', 'WEBPAGE_CODELESS', 'WEBSITE_CALL') AND conversion_action.status != 'REMOVED' ORDER BY conversion_action.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 50
+  },
+  {
+    name: "account-budget",
+    description: "The account budget (invoiced billing): approved spending limit, served amount, dates and any pending change \u2014 read-only",
+    gaqlTemplate: `SELECT account_budget.id, account_budget.name, account_budget.status, account_budget.billing_setup, account_budget.approved_spending_limit_micros, account_budget.approved_spending_limit_type, account_budget.amount_served_micros, account_budget.total_adjustments_micros, account_budget.approved_start_date_time, account_budget.approved_end_date_time, account_budget.pending_proposal.proposal_type, account_budget.pending_proposal.spending_limit_micros FROM account_budget ORDER BY account_budget.approved_start_date_time DESC`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 50
+  },
+  {
+    name: "recommendations",
+    description: "Google's open recommendations (not dismissed): type, the campaign/ad group it targets, and its estimated impact",
+    gaqlTemplate: `SELECT recommendation.resource_name, recommendation.type, recommendation.campaign, recommendation.ad_group, recommendation.impact FROM recommendation WHERE recommendation.dismissed = FALSE`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  },
+  {
+    name: "campaign-simulations",
+    description: "Google's what-if curves per campaign \u2014 budget, target CPA / ROAS, CPC bid or target impression share against the clicks, cost and conversions Google predicts",
+    gaqlTemplate: `SELECT campaign_simulation.campaign_id, campaign_simulation.type, campaign_simulation.modification_method, campaign_simulation.start_date, campaign_simulation.end_date, campaign_simulation.budget_point_list.points, campaign_simulation.target_cpa_point_list.points, campaign_simulation.target_roas_point_list.points, campaign_simulation.cpc_bid_point_list.points, campaign_simulation.target_impression_share_point_list.points FROM campaign_simulation`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  },
+  {
+    name: "keyword-bid-simulations",
+    description: "Google's what-if curve per keyword: CPC bid against predicted clicks, cost and impressions",
+    gaqlTemplate: `SELECT ad_group_criterion_simulation.ad_group_id, ad_group_criterion_simulation.criterion_id, ad_group_criterion_simulation.type, ad_group_criterion_simulation.start_date, ad_group_criterion_simulation.end_date, ad_group_criterion_simulation.cpc_bid_point_list.points FROM ad_group_criterion_simulation`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  }
+];
+var INVENTORY_PRESETS = [
+  {
+    name: "campaigns",
+    description: "Every campaign: id, name, status, channel, bidding, budget and dates",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign.primary_status, campaign.advertising_channel_type, campaign.advertising_channel_sub_type, campaign.bidding_strategy_type, campaign.bidding_strategy, campaign.campaign_budget, campaign_budget.amount_micros, campaign.start_date_time, campaign.end_date_time FROM campaign{statusWhere} ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200,
+    statusFields: ["campaign.status"]
+  },
+  {
+    name: "budgets",
+    description: "Every campaign budget: id, name, daily amount, delivery, whether it is shared and how many campaigns use it",
+    gaqlTemplate: `SELECT campaign_budget.id, campaign_budget.name, campaign_budget.status, campaign_budget.amount_micros, campaign_budget.delivery_method, campaign_budget.explicitly_shared, campaign_budget.reference_count FROM campaign_budget WHERE campaign_budget.status != 'REMOVED' ORDER BY campaign_budget.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  },
+  {
+    name: "ad-groups",
+    description: "Every ad group: id, name, status, type and default CPC bid, under its campaign",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ad_group.type, ad_group.cpc_bid_micros FROM ad_group{statusWhere} ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500,
+    statusFields: ["campaign.status", "ad_group.status"]
+  },
+  {
+    name: "keywords",
+    description: "Every positive keyword: resource name, text, match type, status, bid and final URL \u2014 `keywords update|remove` take the resource name",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ad_group_criterion.resource_name, ad_group_criterion.criterion_id, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type, ad_group_criterion.status, ad_group_criterion.negative, ad_group_criterion.cpc_bid_micros, ad_group_criterion.final_urls FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.negative = FALSE{statusScope} ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500,
+    statusFields: ["campaign.status", "ad_group.status", "ad_group_criterion.status"]
+  },
+  {
+    name: "campaign-negative-keywords",
+    description: "Campaign-level negative keywords with the resource name `negative-keywords remove` takes",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign_criterion.resource_name, campaign_criterion.keyword.text, campaign_criterion.keyword.match_type FROM campaign_criterion WHERE campaign_criterion.type = 'KEYWORD' AND campaign_criterion.negative = TRUE AND campaign_criterion.status != 'REMOVED' AND campaign.status != 'REMOVED' ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  },
+  {
+    name: "ad-group-negative-keywords",
+    description: "Ad-group-level negative keywords with the resource name `negative-keywords remove` takes",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, ad_group.id, ad_group.name, ad_group_criterion.resource_name, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type, ad_group_criterion.negative FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.negative = TRUE AND ad_group_criterion.status != 'REMOVED' AND ad_group.status != 'REMOVED' AND campaign.status != 'REMOVED' ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  },
+  {
+    name: "shared-sets",
+    description: "Every shared list (negative keyword / placement lists): id, name, type, member count and how many campaigns use it",
+    gaqlTemplate: `SELECT shared_set.id, shared_set.name, shared_set.type, shared_set.status, shared_set.member_count, shared_set.reference_count FROM shared_set WHERE shared_set.status != 'REMOVED' ORDER BY shared_set.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  },
+  {
+    name: "ads",
+    description: "Every ad: id, type, name, status, approval and final URLs, under its ad group",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.id, ad_group.name, ad_group.status, ad_group_ad.resource_name, ad_group_ad.ad.id, ad_group_ad.ad.type, ad_group_ad.ad.name, ad_group_ad.status, ad_group_ad.policy_summary.approval_status, ad_group_ad.ad.final_urls FROM ad_group_ad{statusWhere} ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500,
+    statusFields: ["campaign.status", "ad_group.status", "ad_group_ad.status"]
+  },
+  {
+    name: "assets",
+    description: "Every asset in the account library: id, name, type, text and final URLs",
+    gaqlTemplate: `SELECT asset.id, asset.name, asset.type, asset.text_asset.text, asset.sitelink_asset.link_text, asset.callout_asset.callout_text, asset.image_asset.full_size.url, asset.youtube_video_asset.youtube_video_id, asset.final_urls FROM asset ORDER BY asset.type`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  },
+  {
+    name: "asset-groups",
+    description: "Every Performance Max asset group: id, name, status, final URLs and strength, under its campaign",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, asset_group.resource_name, asset_group.id, asset_group.name, asset_group.status, asset_group.final_urls, asset_group.ad_strength FROM asset_group{statusWhere} ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200,
+    statusFields: ["campaign.status", "asset_group.status"]
+  },
+  {
+    name: "audiences",
+    description: "Every audience (user list): id, name, type, membership status, size on search and display, membership duration",
+    gaqlTemplate: `SELECT user_list.id, user_list.name, user_list.type, user_list.membership_status, user_list.size_for_search, user_list.size_for_display, user_list.membership_life_span, user_list.eligible_for_search, user_list.eligible_for_display FROM user_list ORDER BY user_list.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  },
+  {
+    name: "conversion-actions",
+    description: "Every conversion action: id, name, type, category, origin, status, primary or secondary, counting",
+    gaqlTemplate: `SELECT conversion_action.id, conversion_action.name, conversion_action.type, conversion_action.category, conversion_action.origin, conversion_action.status, conversion_action.primary_for_goal, conversion_action.counting_type FROM conversion_action WHERE conversion_action.status != 'REMOVED' ORDER BY conversion_action.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  },
+  {
+    name: "bidding-strategies",
+    description: "Every portfolio bidding strategy: id, name, type, status and how many campaigns use it",
+    gaqlTemplate: `SELECT bidding_strategy.id, bidding_strategy.name, bidding_strategy.type, bidding_strategy.status, bidding_strategy.campaign_count FROM bidding_strategy WHERE bidding_strategy.status != 'REMOVED' ORDER BY bidding_strategy.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  },
+  {
+    name: "labels",
+    description: "Every label: id, name, colour and description",
+    gaqlTemplate: `SELECT label.id, label.name, label.status, label.text_label.background_color, label.text_label.description FROM label WHERE label.status != 'REMOVED' ORDER BY label.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  },
+  {
+    name: "merchant-center",
+    description: "Merchant Center accounts linked to this Google Ads account \u2014 the merchantId a Shopping or retail Performance Max campaign names",
+    gaqlTemplate: `SELECT product_link.resource_name, product_link.product_link_id, product_link.type, product_link.merchant_center.merchant_center_id FROM product_link WHERE product_link.type = 'MERCHANT_CENTER'`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 200
+  },
+  {
+    name: "campaign-criteria",
+    description: "Every campaign targeting criterion and exclusion \u2014 locations, languages, devices, ad schedules, radius, carriers, operating systems, placements, topics, demographics, content types, IP addresses, web pages, brand lists, audiences \u2014 with the resource name `campaign-criteria update|remove` takes",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign.advertising_channel_type, campaign_criterion.resource_name, campaign_criterion.type, campaign_criterion.negative, campaign_criterion.bid_modifier, campaign_criterion.location.geo_target_constant, campaign_criterion.language.language_constant, campaign_criterion.device.type, campaign_criterion.ad_schedule.day_of_week, campaign_criterion.ad_schedule.start_hour, campaign_criterion.ad_schedule.end_hour, campaign_criterion.proximity.radius, campaign_criterion.placement.url, campaign_criterion.mobile_application.app_id, campaign_criterion.youtube_channel.channel_id, campaign_criterion.youtube_video.video_id, campaign_criterion.topic.topic_constant, campaign_criterion.age_range.type, campaign_criterion.gender.type, campaign_criterion.income_range.type, campaign_criterion.parental_status.type, campaign_criterion.content_label.type, campaign_criterion.ip_block.ip_address, campaign_criterion.webpage.criterion_name, campaign_criterion.brand_list.shared_set, campaign_criterion.carrier.carrier_constant, campaign_criterion.operating_system_version.operating_system_version_constant, campaign_criterion.user_list.user_list, campaign_criterion.user_interest.user_interest_category FROM campaign_criterion WHERE campaign_criterion.type != 'KEYWORD' AND campaign_criterion.status != 'REMOVED' AND campaign.status != 'REMOVED' ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  },
+  {
+    name: "ad-group-criteria",
+    description: "Every ad group targeting criterion and exclusion other than keywords \u2014 placements, apps, YouTube, topics, demographics, web pages, Demand Gen locations, languages and audience, audiences \u2014 with its bid adjustment, max CPC, status and the resource name `ad-group-criteria update|remove` takes",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign.advertising_channel_type, ad_group.id, ad_group.name, ad_group.status, ad_group_criterion.resource_name, ad_group_criterion.type, ad_group_criterion.negative, ad_group_criterion.status, ad_group_criterion.bid_modifier, ad_group_criterion.cpc_bid_micros, ad_group_criterion.placement.url, ad_group_criterion.mobile_application.app_id, ad_group_criterion.youtube_channel.channel_id, ad_group_criterion.youtube_video.video_id, ad_group_criterion.topic.topic_constant, ad_group_criterion.age_range.type, ad_group_criterion.gender.type, ad_group_criterion.parental_status.type, ad_group_criterion.income_range.type, ad_group_criterion.webpage.criterion_name, ad_group_criterion.location.geo_target_constant, ad_group_criterion.language.language_constant, ad_group_criterion.audience.audience, ad_group_criterion.brand_list.shared_set, ad_group_criterion.user_list.user_list, ad_group_criterion.user_interest.user_interest_category FROM ad_group_criterion WHERE ad_group_criterion.type NOT IN ('KEYWORD', 'LISTING_GROUP'){statusScope} ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500,
+    statusFields: ["campaign.status", "ad_group.status", "ad_group_criterion.status"]
+  },
+  {
+    name: "account-exclusions",
+    description: "Every account-wide exclusion \u2014 sites, apps, app categories, YouTube, content types, IP addresses, account negative keyword lists \u2014 with the resource name `account-exclusions remove` takes",
+    gaqlTemplate: `SELECT customer_negative_criterion.resource_name, customer_negative_criterion.type, customer_negative_criterion.placement.url, customer_negative_criterion.mobile_application.app_id, customer_negative_criterion.mobile_app_category.mobile_app_category_constant, customer_negative_criterion.youtube_channel.channel_id, customer_negative_criterion.youtube_video.video_id, customer_negative_criterion.content_label.type, customer_negative_criterion.ip_block.ip_address, customer_negative_criterion.negative_keyword_list.shared_set FROM customer_negative_criterion`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  },
+  {
+    name: "asset-group-signals",
+    description: "Every Performance Max asset group's signals \u2014 search themes and the combined audience \u2014 under its campaign and group, with the resource name `asset-group-signals remove` takes",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, asset_group.id, asset_group.name, asset_group_signal.resource_name, asset_group_signal.search_theme.text, asset_group_signal.audience.audience, asset_group_signal.approval_status FROM asset_group_signal WHERE campaign.status != 'REMOVED' AND asset_group.status != 'REMOVED' ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  },
+  {
+    name: "ad-group-bid-modifiers",
+    description: "Every ad group's own device bid adjustment, with the resource name `ad-group-bid-modifiers update|remove` takes",
+    gaqlTemplate: `SELECT campaign.id, campaign.name, ad_group.id, ad_group.name, ad_group_bid_modifier.resource_name, ad_group_bid_modifier.device.type, ad_group_bid_modifier.bid_modifier FROM ad_group_bid_modifier WHERE campaign.status != 'REMOVED' AND ad_group.status != 'REMOVED' ORDER BY campaign.name`,
+    defaultDateRange: "ALL_TIME",
+    defaultLimit: 500
+  }
+];
+var PRESETS = [...CORE_PRESETS, ...REPORT_PRESETS, ...INVENTORY_PRESETS];
+function isInventoryPreset(name) {
+  return INVENTORY_PRESETS.some((preset) => preset.name === name);
+}
+function getPreset(name) {
+  return PRESETS.find((p) => p.name === name);
+}
+function buildStatusScope(statusFields, includePaused) {
+  if (!statusFields || statusFields.length === 0) return "";
+  const predicate = includePaused ? "!= 'REMOVED'" : "= 'ENABLED'";
+  return statusFields.map((field) => ` AND ${field} ${predicate}`).join("");
+}
+function expandPreset(preset, params, now = /* @__PURE__ */ new Date()) {
+  const dateRange = params.dateRange ?? preset.defaultDateRange;
+  if (preset.gaqlTemplate.includes("{dateRange}") && !isValidDateRange(dateRange)) {
+    return { query: "", dateRangeError: dateRangeError(dateRange, now) };
+  }
+  const statusScope = buildStatusScope(preset.statusFields, params.includePaused ?? false);
+  const range = dateRange.trim();
+  const query = preset.gaqlTemplate.replace(/DURING\s+\{dateRange\}/g, BETWEEN_RE.test(range) ? range : `DURING ${range}`).replace(/\{dateRange\}/g, range).replace(/\{statusScope\}/g, statusScope).replace(/\{statusWhere\}/g, statusScope ? ` WHERE${statusScope.replace(/^ AND/, "")}` : "");
+  return { query };
+}
+
+// src/commands/ads/google/list-fields.ts
+var LIST_FIELDS = /* @__PURE__ */ new Set([
+  "ad.final_mobile_urls",
+  "ad.final_urls",
+  "ad_group.excluded_parent_asset_field_types",
+  "ad_group.excluded_parent_asset_set_types",
+  "ad_group.labels",
+  "ad_group.primary_status_reasons",
+  "ad_group_ad.ad.final_mobile_urls",
+  "ad_group_ad.ad.final_urls",
+  "ad_group_ad.labels",
+  "ad_group_ad.primary_status_reasons",
+  "ad_group_asset.primary_status_reasons",
+  "ad_group_criterion.disapproval_reasons",
+  "ad_group_criterion.final_mobile_urls",
+  "ad_group_criterion.final_urls",
+  "ad_group_criterion.labels",
+  "ad_group_criterion.primary_status_reasons",
+  "ad_group_criterion.topic.path",
+  "ad_group_criterion.webpage.sample.sample_urls",
+  "asset.dynamic_custom_asset.contextual_keywords",
+  "asset.dynamic_custom_asset.similar_ids",
+  "asset.dynamic_education_asset.contextual_keywords",
+  "asset.dynamic_education_asset.similar_program_ids",
+  "asset.dynamic_flights_asset.similar_destination_ids",
+  "asset.dynamic_hotels_and_rentals_asset.contextual_keywords",
+  "asset.dynamic_hotels_and_rentals_asset.similar_property_ids",
+  "asset.dynamic_jobs_asset.contextual_keywords",
+  "asset.dynamic_jobs_asset.similar_job_ids",
+  "asset.dynamic_local_asset.contextual_keywords",
+  "asset.dynamic_local_asset.similar_deal_ids",
+  "asset.dynamic_real_estate_asset.contextual_keywords",
+  "asset.dynamic_real_estate_asset.similar_listing_ids",
+  "asset.dynamic_travel_asset.contextual_keywords",
+  "asset.dynamic_travel_asset.similar_destination_ids",
+  "asset.final_mobile_urls",
+  "asset.final_urls",
+  "asset.page_feed_asset.labels",
+  "asset.structured_snippet_asset.values",
+  "asset_group.final_mobile_urls",
+  "asset_group.final_urls",
+  "asset_group.primary_status_reasons",
+  "asset_group_asset.primary_status_reasons",
+  "asset_group_signal.disapproval_reasons",
+  "asset_set.business_profile_location_group.dynamic_business_profile_location_group_filter.label_filters",
+  "asset_set.business_profile_location_group.dynamic_business_profile_location_group_filter.listing_id_filters",
+  "asset_set.location_set.business_profile_location_set.label_filters",
+  "asset_set.location_set.business_profile_location_set.listing_id_filters",
+  "bidding_data_exclusion.advertising_channel_types",
+  "bidding_data_exclusion.campaigns",
+  "bidding_data_exclusion.devices",
+  "bidding_seasonality_adjustment.advertising_channel_types",
+  "bidding_seasonality_adjustment.campaigns",
+  "bidding_seasonality_adjustment.devices",
+  "campaign.excluded_parent_asset_field_types",
+  "campaign.excluded_parent_asset_set_types",
+  "campaign.feed_types",
+  "campaign.labels",
+  "campaign.optimization_goal_setting.optimization_goal_types",
+  "campaign.primary_status_reasons",
+  "campaign.selective_optimization.conversion_actions",
+  "campaign.shopping_setting.advertising_partner_ids",
+  "campaign.text_guidelines.term_exclusions",
+  "campaign_asset.primary_status_reasons",
+  "campaign_criterion.location_group.geo_target_constants",
+  "campaign_criterion.topic.path",
+  "campaign_criterion.webpage.sample.sample_urls",
+  "conversion_value_rule.audience_condition.user_interests",
+  "conversion_value_rule.audience_condition.user_lists",
+  "conversion_value_rule.device_condition.device_types",
+  "conversion_value_rule.geo_location_condition.excluded_geo_target_constants",
+  "conversion_value_rule.geo_location_condition.geo_target_constants",
+  "conversion_value_rule_set.conversion_value_rules",
+  "conversion_value_rule_set.dimensions",
+  "custom_conversion_goal.conversion_actions",
+  "customer.pay_per_conversion_eligibility_failure_reasons",
+  "customer_asset.primary_status_reasons",
+  "customer_client.applied_labels",
+  "experiment_arm.campaigns",
+  "experiment_arm.in_design_campaigns",
+  "keyword_plan_campaign.language_constants",
+  "lift_measurement_config.campaigns",
+  "lift_measurement_config.conversion_actions",
+  "lift_measurement_config.single_measurement_question_set.competitor_choices",
+  "lift_measurement_config.single_measurement_question_set.question_measurements",
+  "local_services_employee.category_ids",
+  "local_services_employee.languages_spoken",
+  "metrics.interaction_event_types",
+  "recommendation.campaigns",
+  "shared_criterion.webpage.sample.sample_urls",
+  "shopping_product.target_countries",
+  "topic_constant.path",
+  "user_list.lookalike_user_list.country_codes",
+  "user_list.lookalike_user_list.seed_user_list_ids"
+]);
+var LIST_FIELD_OPERATORS = "CONTAINS ALL, CONTAINS ANY, CONTAINS NONE";
+function listFieldGuidance(field) {
+  return `${field} is a list field: it takes only ${LIST_FIELD_OPERATORS} \u2014 no comparison (=, !=, IN), pattern match or null test. To find rows that have it, drop that condition, keep ${field} in SELECT and filter the rows (rows without it omit the key); to match values, use ${field} CONTAINS ANY ('value')`;
+}
+
+// src/commands/ads/google/correction-table.ts
+function buildCommand(query, ctx) {
+  return `baker ads google query "${query}" --customer-id ${ctx.customerId}`;
+}
+var NO_OR_EXPLANATION = "GAQL has no OR: WHERE conditions combine only with AND, and cannot be grouped in parentheses. For several values of one field use IN: field IN ('a', 'b'). For several patterns on one text field use REGEXP_MATCH: field REGEXP_MATCH '(?i).*(a|b).*'. For alternatives on different fields, run one query per condition and merge the rows.";
+var KNOWN_FIELDS = /* @__PURE__ */ new Set([
+  ...PRESETS.flatMap((preset) => preset.gaqlTemplate.match(/\b[a-z_]+(?:\.[a-z0-9_]+)+/g) ?? []),
+  ...LIST_FIELDS
+]);
+function sharedPrefixLength(a, b) {
+  let i = 0;
+  while (i < a.length && i < b.length && a[i] === b[i]) i++;
+  return i;
+}
+function similarKnownFields(field) {
+  const [resource = "", attribute = ""] = field.split(/\.(.*)/s);
+  const firstWord = attribute.split(/[_.]/)[0];
+  if (!firstWord) return [];
+  const stem = `${resource}.${firstWord}`;
+  return [...KNOWN_FIELDS].filter((known) => known !== field && known.startsWith(stem)).sort((a, b) => sharedPrefixLength(b, field) - sharedPrefixLength(a, field) || a.localeCompare(b)).slice(0, 3);
+}
+var MOVED_FIELDS = {
+  "campaign.conversion_goal_config.goal_config_level": "conversion_goal_campaign_config.goal_config_level"
+};
+function unknownFieldFix(field, ctx) {
+  const similar = similarKnownFields(field);
+  const gone = `${field} does not exist in this Google Ads API version (removed, renamed or misspelled).`;
+  const moved = MOVED_FIELDS[field];
+  if (moved) {
+    const resource = moved.split(".")[0];
+    return {
+      action: "retry_with_modified_query",
+      explanation: `${gone} It moved to ${moved}: select it FROM ${resource} (campaign fields such as campaign.name can be selected alongside).`
+    };
+  }
+  if (similar.length === 0) {
+    return {
+      action: "retry_with_modified_query",
+      explanation: `${gone} Drop it, or find its replacement in Google's field reference for that resource.`
+    };
+  }
+  const renamed = similar.filter((known) => known.startsWith(`${field}_`));
+  const [replacement] = renamed;
+  if (renamed.length === 1 && replacement) {
+    const corrected = ctx.originalQuery.replace(
+      new RegExp(`(?<![\\w.])${field.replace(/\./g, "\\.")}(?![\\w.])`, "g"),
+      replacement
+    );
+    return {
+      action: "retry_with_modified_query",
+      correctedCommand: buildCommand(corrected, ctx),
+      explanation: `${gone} Its current name is ${replacement} \u2014 swapped in.`
+    };
+  }
+  return {
+    action: "retry_with_modified_query",
+    explanation: `${gone} Fields with a similar name on this resource: ${similar.join(", ")}. Use the one you meant, or drop it.`
+  };
+}
+var CORRECTION_RULES = [
+  // 0. EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE — some resources (e.g. campaign_budget)
+  // require fields filtered in WHERE to also be selected. The error names the exact field,
+  // so add it to SELECT and retry. Kept first: field-specific rules below must not shadow
+  // this with an unrelated rewrite when the named field happens to match their pattern.
+  {
+    matchApiError: /must be present in SELECT clause:\s*'([\w.]+)'/i,
+    fix: (ctx) => {
+      const field = ctx.apiErrorMessage?.match(/must be present in SELECT clause:\s*'([\w.]+)'/i)?.[1];
+      if (!field) {
+        return {
+          action: "add_required_field",
+          explanation: "Add the field named in the error to the SELECT clause and retry"
+        };
+      }
+      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, `SELECT ${field}, `);
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: `${field} is used in WHERE but this resource requires it in SELECT too \u2014 added it`
+      };
+    }
+  },
+  // 0b. OPERATOR_FIELD_MISMATCH — the field refuses this operator, and Google names the
+  // ones it takes. Kept ahead of the field-specific rules for the same reason as rule 0.
+  // A repeated field (final_urls, labels, …) takes only CONTAINS ALL/ANY/NONE, so it has
+  // no null test at all: read it unfiltered and filter the rows instead.
+  {
+    matchApiError: /OPERATOR_FIELD_MISMATCH|is not a valid operator to use with/i,
+    fix: (ctx) => {
+      const message = ctx.apiErrorMessage ?? "";
+      const field = message.match(/valid operator to use with '([\w.]+)'/i)?.[1] ?? "this field";
+      const operator = message.match(/([A-Z=!<>][A-Z_ =!<>]*?) is not a valid operator/)?.[1]?.trim();
+      const valid = message.match(/Valid operators: (.+?)\.?(?:"|$)/i)?.[1]?.trim();
+      const refused = operator ? `${operator} cannot be used on ${field}` : `${field} does not take that operator`;
+      const allowed = valid ? `; its valid operators are ${valid}` : "";
+      const repeated = valid?.split(",").every((op) => /^CONTAINS (ALL|ANY|NONE)$/i.test(op.trim())) ?? false;
+      const guidance = repeated ? `. ${listFieldGuidance(field)}` : ". Rewrite that condition with one of them, or drop it and filter the rows";
+      return {
+        action: "change_operator",
+        explanation: `${refused}${allowed}${guidance}`
+      };
+    }
+  },
+  // 0c. An OR, or a parenthesised group, in WHERE. Google names the token it choked on
+  // ("unexpected input OR", "invalid field name '('"), never the reason, so without this the
+  // "invalid … field" wording fell through to the bare-resource rule below.
+  {
+    matchApiError: /unexpected input (?:OR|\()|invalid field name \\?'\(/i,
+    fix: () => ({ action: "retry_with_modified_query", explanation: NO_OR_EXPLANATION })
+  },
+  // 0d. An enum value this field does not have in this API version.
+  {
+    matchApiError: /BAD_ENUM_CONSTANT|Invalid enum value/i,
+    fix: (ctx) => {
+      const value = ctx.apiErrorMessage?.match(/Invalid enum value[^']*\\?'([\w]+)/i)?.[1];
+      return {
+        action: "retry_with_modified_query",
+        explanation: `${value ? `'${value}' is` : "A value in this query is"} not one of the values Google accepts for the field it filters, in this API version. Use one the field's reference lists, or drop that condition and filter the rows.`
+      };
+    }
+  },
+  // 1. bare keyword.text → ad_group_criterion.keyword.text (leaves <resource>.keyword.text untouched)
+  {
+    matchApiError: /keyword\.text/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/(?<![\w.])keyword\.text\b/g, "ad_group_criterion.keyword.text");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Use ad_group_criterion.keyword.text \u2014 keywords are accessed through the criterion resource"
+      };
+    }
+  },
+  // 2. bare keyword.match_type → ad_group_criterion.keyword.match_type (leaves <resource>.keyword.match_type untouched)
+  {
+    matchApiError: /keyword\.match_type/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(
+        /(?<![\w.])keyword\.match_type\b/g,
+        "ad_group_criterion.keyword.match_type"
+      );
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Use ad_group_criterion.keyword.match_type for keyword match type"
+      };
+    }
+  },
+  // 3. campaign_budget.* queried FROM campaign
+  {
+    matchApiError: /campaign_budget.*not.*valid.*campaign|cannot.*select.*campaign_budget/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/FROM\s+campaign\b/i, "FROM campaign_budget");
+      return {
+        action: "use_different_resource",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "campaign_budget fields must be queried FROM campaign_budget, not FROM campaign"
+      };
+    }
+  },
+  // 6. Missing campaign.id in ad_group queries
+  {
+    matchApiError: /campaign\.id.*required|must.*include.*campaign\.id/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT campaign.id, ");
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Ad group queries require campaign.id in SELECT for parent context"
+      };
+    }
+  },
+  // 6. Missing campaign.id in keyword_view queries
+  {
+    matchApiError: /campaign\.id.*required.*keyword/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT campaign.id, ");
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Keyword view queries require campaign.id in SELECT"
+      };
+    }
+  },
+  // 7. shopping_performance_view.product_* → segments.product_*
+  {
+    matchApiError: /shopping_performance_view\.product/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/shopping_performance_view\.product_(\w+)/g, "segments.product_$1");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Product fields are segments (segments.product_*), not fields on shopping_performance_view"
+      };
+    }
+  },
+  // 8. Open-ended date range
+  {
+    matchApiError: /date.*range.*must.*finite|open.*ended/i,
+    fix: (ctx) => {
+      const match = ctx.originalQuery.match(/segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i);
+      const startDate = match?.[1] ?? "2024-01-01";
+      const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+      const corrected = ctx.originalQuery.replace(
+        /segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i,
+        `segments.date BETWEEN '${startDate}' AND '${today}'`
+      );
+      return {
+        action: "narrow_date_range",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Use BETWEEN with explicit end date \u2014 open-ended ranges are not supported"
+      };
+    }
+  },
+  // 10a. Customer not found (wrong customer ID)
+  {
+    matchApiError: /CUSTOMER_NOT_FOUND|not.*found.*customer/i,
+    fix: () => ({
+      action: "reject",
+      explanation: "Customer ID not found. Run 'baker ads google accounts' to list valid customer IDs, then retry with a valid --customer-id."
+    })
+  },
+  // 10b. Not accessible / login-customer-id required
+  {
+    matchApiError: /not.*accessible|login.customer.id/i,
+    fix: (ctx) => ({
+      action: "reject",
+      correctedCommand: buildCommand(ctx.originalQuery, ctx),
+      explanation: "Account not accessible \u2014 may need a manager (MCC) login-customer-id. Run 'baker ads google accounts' to refresh the accounts cache, then retry."
+    })
+  },
+  // 12. Incompatible fields
+  {
+    matchApiError: /incompatible|mutually.*exclusive|cannot.*select.*together/i,
+    fix: () => ({
+      action: "split_query",
+      explanation: "These fields cannot be in the same query \u2014 split into separate queries and join client-side"
+    })
+  },
+  // 15. ad.final_urls → ad_group_ad.ad.final_urls
+  {
+    matchApiError: /ad\.final_urls/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/\bad\.final_urls\b/g, "ad_group_ad.ad.final_urls");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Use the full path: ad_group_ad.ad.final_urls"
+      };
+    }
+  },
+  // 15b. asset.<type>_asset.final_urls → asset.final_urls (final URLs live on the asset
+  // itself; the typed sub-message only carries type-specific fields like link_text)
+  {
+    matchApiError: /asset\.\w+_asset\.final_(mobile_)?urls/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/asset\.\w+_asset\.final_(mobile_)?urls\b/g, "asset.final_$1urls");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Final URLs are on the asset itself \u2014 use asset.final_urls, not asset.<type>_asset.final_urls"
+      };
+    }
+  },
+  // 16. Rate limit / quota
+  {
+    matchApiError: /RESOURCE_EXHAUSTED|quota.*exceeded|rate.*limit/i,
+    fix: () => ({
+      action: "wait_and_retry",
+      explanation: "API quota exceeded \u2014 wait 30 seconds before retrying"
+    })
+  },
+  // 17. WHERE on metrics
+  {
+    matchApiError: /cannot.*filter.*metric|WHERE.*metrics|prohibited.*where/i,
+    fix: () => ({
+      action: "reject",
+      explanation: "Cannot filter on metrics in WHERE clause \u2014 remove the metrics filter and filter results client-side"
+    })
+  },
+  // 18. ORDER BY field not in SELECT
+  {
+    matchApiError: /order.*by.*field.*not.*selected|must.*select.*field.*order/i,
+    fix: (ctx) => {
+      const orderMatch = ctx.originalQuery.match(/ORDER\s+BY\s+([\w.]+)/i);
+      const field = orderMatch?.[1] ?? "field";
+      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, `SELECT ${field}, `);
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: `Add ${field} to SELECT \u2014 ORDER BY fields must be selected`
+      };
+    }
+  },
+  // The change-history rules must stay ahead of rule 19: its `status.*filter`
+  // pattern also matches Google's change_status errors ("the change_status request
+  // is missing filters on ..."), and the first matching rule wins.
+  // 18a. change_event past its 30-day reach → change_status, which reaches 90 days.
+  // These three rules match on the error code only, never on the resource in the query:
+  // keyed on the query, they would answer every unrelated failure on a history query with
+  // "switch resources", which is never the real fix. The backend forwards the
+  // code as JSON (`"changeEventError":"START_DATE_TOO_OLD"`), so match that shape as well
+  // as the dotted enum spelling.
+  {
+    matchApiError: /changeEventError\W{0,4}START_DATE_TOO_OLD/i,
+    fix: (ctx) => {
+      const limit = ctx.originalQuery.match(/LIMIT\s+(\d+)/i)?.[1] ?? "50";
+      const requested = ctx.originalQuery.match(/change_date_time\s*>=\s*'([^']+)'/i)?.[1]?.slice(0, 10);
+      const oldestStart = new Date(Date.now() - 89 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
+      const start = requested && requested > oldestStart ? requested : oldestStart;
+      const corrected = `SELECT change_status.last_change_date_time, change_status.resource_type, change_status.resource_status, change_status.resource_name, change_status.campaign, change_status.ad_group FROM change_status WHERE change_status.last_change_date_time >= '${start}' ORDER BY change_status.last_change_date_time DESC LIMIT ${limit}`;
+      return {
+        action: "use_different_resource",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: `change_event only reaches back 30 days. change_status reaches 90 (from ${start}) but reports only which resources changed and whether they were added, changed or removed \u2014 no old/new values and no user email. Read a changed resource by its resource_name to see its current values.`
+      };
+    }
+  },
+  // 18b. Past 90 days no history resource reaches — infer the change from spend instead.
+  {
+    matchApiError: /changeStatusError\W{0,4}START_DATE_TOO_OLD/i,
+    fix: () => ({
+      action: "use_different_resource",
+      explanation: `Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: ${monthlySpendTrendQuery()} shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API.`
+    })
+  },
+  // 18c. change_status rejects a date range it cannot bound. Google raises this both for
+  // a half-open range and for no date filter at all, so supply whichever end is missing.
+  {
+    matchApiError: /CHANGE_DATE_RANGE_INFINITE/i,
+    fix: (ctx) => {
+      const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+      const oldestStart = new Date(Date.now() - 89 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
+      const hasLowerBound = /last_change_date_time\s*>=?/i.test(ctx.originalQuery);
+      const hasUpperBound = /last_change_date_time\s*<=?/i.test(ctx.originalQuery);
+      const bounds = [
+        ...hasLowerBound ? [] : [`change_status.last_change_date_time >= '${oldestStart}'`],
+        ...hasUpperBound ? [] : [`change_status.last_change_date_time <= '${today}'`]
+      ];
+      const hasWhere = /\bWHERE\b/i.test(ctx.originalQuery);
+      const clause = hasWhere ? ` AND ${bounds.join(" AND ")}` : ` WHERE ${bounds.join(" AND ")}`;
+      const corrected = /\s+(ORDER\s+BY|LIMIT)\b/i.test(ctx.originalQuery) ? ctx.originalQuery.replace(/(\s+)(ORDER\s+BY|LIMIT)\b/i, `${clause}$1$2`) : ctx.originalQuery.trimEnd() + clause;
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "change_status needs a date range bounded at both ends \u2014 added the missing bound(s) on last_change_date_time."
+      };
+    }
+  },
+  // 19. Results include REMOVED entities
+  {
+    matchApiError: /REMOVED.*entities|status.*filter/i,
+    fix: (ctx) => {
+      const resourceMatch = ctx.originalQuery.match(/FROM\s+(\w+)/i);
+      const resource = resourceMatch?.[1] ?? "campaign";
+      const hasWhere = /WHERE/i.test(ctx.originalQuery);
+      const suffix = hasWhere ? ` AND ${resource}.status != 'REMOVED'` : ` WHERE ${resource}.status != 'REMOVED'`;
+      const limitMatch = ctx.originalQuery.match(/(\s+LIMIT\s+\d+)/i);
+      let corrected;
+      if (limitMatch) {
+        corrected = ctx.originalQuery.replace(/(\s+LIMIT\s+\d+)/i, `${suffix}$1`);
+      } else {
+        corrected = ctx.originalQuery.trimEnd() + suffix;
+      }
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: `Add status filter to exclude REMOVED ${resource}s`
+      };
+    }
+  },
+  // 20. change_event without date constraint
+  {
+    matchApiError: /change_event.*date|date.*required.*change/i,
+    fix: (ctx) => {
+      const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
+      const hasWhere = /WHERE/i.test(ctx.originalQuery);
+      const suffix = hasWhere ? ` AND change_event.change_date_time >= '${sevenDaysAgo}'` : ` WHERE change_event.change_date_time >= '${sevenDaysAgo}'`;
+      const corrected = ctx.originalQuery.trimEnd() + suffix;
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "change_event queries require a date constraint on change_date_time"
+      };
+    }
+  },
+  // 22. segments.click_type incompatibility
+  {
+    matchApiError: /click_type.*incompatible|cannot.*click_type/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/,?\s*segments\.click_type/g, "");
+      return {
+        action: "split_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "segments.click_type is incompatible with other segments \u2014 remove it or query separately"
+      };
+    }
+  },
+  // 22b. A field this API version does not have (removed, renamed, or misspelled). The rules above
+  // rewrite the known renames; anything left is named back so the agent drops or replaces it —
+  // without this, "invalid argument … field" fell through to the bare-resource rule below.
+  {
+    matchApiError: /UNRECOGNIZED_FIELD|Unrecognized field in the query/i,
+    fix: (ctx) => {
+      const field = ctx.apiErrorMessage?.match(/Unrecognized field in the query:\s*\\?'([\w.]+)/i)?.[1];
+      return field ? unknownFieldFix(field, ctx) : {
+        action: "retry_with_modified_query",
+        explanation: "A field in this query does not exist in this Google Ads API version. Drop it, or find its replacement in Google's field reference."
+      };
+    }
+  },
+  // 22c. A field that exists but cannot be SELECTed (only filtered on, or read through another resource).
+  {
+    matchApiError: /PROHIBITED_FIELD_IN_SELECT_CLAUSE|may not be used in SELECT clause/i,
+    fix: (ctx) => {
+      const field = ctx.apiErrorMessage?.match(/may not be used in SELECT clause:\s*\\?'([\w.]+)/i)?.[1];
+      return {
+        action: "retry_with_modified_query",
+        explanation: `${field ?? "A field in this query"} cannot be selected \u2014 Google allows it only in WHERE, or not at all on this resource. Drop it from SELECT.`
+      };
+    }
+  },
+  // 23. Bare resource in SELECT
+  {
+    matchApiError: /cannot.*select.*bare.*resource|invalid.*field/i,
+    fix: () => ({
+      action: "retry_with_modified_query",
+      explanation: "Cannot SELECT a bare resource name \u2014 use resource.id, resource.name, or resource.resource_name"
+    })
+  },
+  // 24. Authentication error
+  {
+    matchApiError: /unauthenticated|authentication.*required|invalid.*credentials/i,
+    fix: () => ({
+      action: "authenticate",
+      explanation: "Google Ads authentication failed \u2014 reconnect Google Ads in dashboard settings"
+    })
+  },
+  // 25. Timeout / deadline exceeded
+  {
+    matchApiError: /timeout|deadline.*exceeded|DEADLINE_EXCEEDED/i,
+    fix: (ctx) => ({
+      action: "retry_with_modified_query",
+      correctedCommand: buildCommand(ctx.originalQuery, ctx),
+      explanation: "Query timed out \u2014 narrow the date range, add more WHERE filters, or reduce LIMIT"
+    })
+  }
+];
+
+// src/commands/ads/google/error-parser.ts
+function mapErrorCode(message) {
+  if (/must be present in SELECT clause/i.test(message)) return "MISSING_SELECT_FIELD";
+  if (/unexpected input (?:OR|\()|invalid field name \\?'\(/i.test(message)) return "INVALID_SYNTAX";
+  if (/BAD_ENUM_CONSTANT|Invalid enum value/i.test(message)) return "INVALID_ENUM_VALUE";
+  if (/field.*not.*found|unrecognized.*field|not.*valid.*field/i.test(message)) return "FIELD_NOT_FOUND";
+  if (/not.*valid.*resource|cannot.*select.*from/i.test(message)) return "WRONG_RESOURCE";
+  if (/operator|CONTAINS|LIKE/i.test(message)) return "INVALID_OPERATOR";
+  if (/CUSTOMER_NOT_FOUND/i.test(message)) return "CUSTOMER_NOT_FOUND";
+  if (/login.customer.id|not.*accessible/i.test(message)) return "MISSING_MANAGER_ID";
+  if (/incompatible|mutually.*exclusive|PROHIBITED_SEGMENT_WITH_METRIC/i.test(message)) return "INCOMPATIBLE_FIELDS";
+  if (/unauthenticated|authentication/i.test(message)) return "AUTH_ERROR";
+  if (/permission/i.test(message)) return "PERMISSION_DENIED";
+  if (/RESOURCE_EXHAUSTED|quota|rate.*limit/i.test(message)) return "QUOTA_EXCEEDED";
+  if (/timeout|DEADLINE_EXCEEDED/i.test(message)) return "TIMEOUT";
+  return "API_ERROR";
+}
+function isRetryable(code) {
+  return code === "QUOTA_EXCEEDED" || code === "TIMEOUT";
+}
+function getRetryDelay(code) {
+  if (code === "QUOTA_EXCEEDED") return 3e4;
+  if (code === "TIMEOUT") return 5e3;
+  return void 0;
+}
+var QUERY_NARROWING = " If it fails again, ask for less in one call \u2014 a shorter date range, or a lower --limit instead of --all.";
+function serverFailure(apiCode, message, narrowing = "") {
+  if (apiCode !== "INTERNAL_ERROR" && apiCode !== "UNAVAILABLE") return null;
+  return {
+    ok: false,
+    error: {
+      code: apiCode,
+      message,
+      fix: {
+        action: "wait_and_retry",
+        explanation: `Google Ads or Baker failed on its own side; nothing in the request was refused. Retry it once as it is.${narrowing}`
+      },
+      retryable: true,
+      retryAfterMs: 5e3
+    }
+  };
+}
+function rateLimited(message) {
+  return {
+    ok: false,
+    error: {
+      code: "RATE_LIMITED",
+      message,
+      fix: {
+        action: "wait_and_retry",
+        explanation: "Google Ads is limiting how often Baker can ask for this account; nothing in the request was refused. Wait as the message says, then retry it as it is."
+      },
+      retryable: true,
+      retryAfterMs: 6e4
+    }
+  };
+}
+function parseApiError(errorMessage, originalQuery, customerId, apiCode) {
+  const ctx = {
+    originalQuery,
+    customerId,
+    apiErrorMessage: errorMessage
+  };
+  if (apiCode && isNotConnectedError(apiCode, errorMessage)) {
+    return {
+      ok: false,
+      error: {
+        code: "NO_GOOGLE_ADS_CONNECTION",
+        message: errorMessage,
+        fix: { action: "request_connection", explanation: connectionFixExplanation("google_ads") },
+        retryable: false
+      }
+    };
+  }
+  const failure = serverFailure(apiCode, errorMessage, originalQuery ? QUERY_NARROWING : "");
+  if (failure) return failure;
+  if (apiCode === "RATE_LIMITED") return rateLimited(errorMessage);
+  if (apiCode === "CONFLICT") {
+    return {
+      ok: false,
+      error: {
+        code: "CONFLICT",
+        message: errorMessage,
+        fix: {
+          action: "retry_with_modified_query",
+          explanation: "The rows moved between two pages. Read again from the first page (no --cursor), with a unique field last in the ORDER BY (e.g. ORDER BY metrics.cost_micros DESC, campaign.id) so pages stay stable."
+        },
+        retryable: true
+      }
+    };
+  }
+  for (const rule of CORRECTION_RULES) {
+    if (rule.matchApiError.test(errorMessage)) {
+      const fix = rule.fix(ctx);
+      const code2 = mapErrorCode(errorMessage);
+      return {
+        ok: false,
+        error: {
+          code: code2,
+          message: errorMessage,
+          fix,
+          retryable: isRetryable(code2),
+          retryAfterMs: getRetryDelay(code2)
+        }
+      };
+    }
+  }
+  const mapped = mapErrorCode(errorMessage);
+  const code = mapped === "API_ERROR" && apiCode ? apiCode : mapped;
+  return {
+    ok: false,
+    error: {
+      code,
+      message: errorMessage,
+      fix: {
+        action: "reject",
+        explanation: "Baker has no specific fix for this error. The message says what was refused: change that, and do not retry the same request unchanged."
+      },
+      retryable: isRetryable(code),
+      retryAfterMs: getRetryDelay(code)
+    }
+  };
+}
+
+export {
+  isDuringLiteral,
+  equivalentBetween,
+  duringLiteralExplanation,
+  resolveChangesWindow,
+  cappedChangesHint,
+  LIST_FIELDS,
+  listFieldGuidance,
+  SERVING_CHAINS,
+  PRESETS,
+  isInventoryPreset,
+  getPreset,
+  expandPreset,
+  NO_OR_EXPLANATION,
+  serverFailure,
+  parseApiError
+};
+//# sourceMappingURL=chunk-NPGPRZW2.js.map