@koda-sl/baker-cli 0.455.0 → 0.456.0

package/dist/{query-IEZRY6HV.js → chunk-XPOIIQCI.js}

@@ -1,6 +1,6 @@
 import {
   getFieldDescriptions
-} from "./chunk-CYEO5ZIO.js";
+} from "./chunk-JPK34QPS.js";
 import {
   LIST_FIELDS,
   duringLiteralExplanation,
@@ -8,8 +8,7 @@ import {
   isDuringLiteral,
   listFieldGuidance,
   parseApiError
-} from "./chunk-GX6VAHY7.js";
-import "./chunk-XCM6XWOB.js";
+} from "./chunk-5FWMRTNB.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -22,17 +21,14 @@ import {
 } from "./chunk-VFIOJD5M.js";
 import {
   GOOGLE_ADS_QUERY_MAX_PAGE_SIZE
-} from "./chunk-NE4F3FHN.js";
+} from "./chunk-ML7DLFFY.js";
 import {
   ApiError,
   apiPost
 } from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
 import {
   registerSchema
 } from "./chunk-NU7JSWVA.js";
-import "./chunk-YQSBHWOI.js";
 
 // src/commands/ads/google/query.ts
 import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
@@ -67,11 +63,11 @@ var SERVING_CHAINS = {
   campaign_asset: ["campaign.status", "campaign_asset.status"],
   ad_group_asset: ["campaign.status", "ad_group.status", "ad_group_asset.status"]
 };
-var PRESETS = [
+var CORE_PRESETS = [
   {
     name: "campaign-performance",
     description: "Campaign-level metrics overview",
-    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign.advertising_channel_type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.conversions_value, metrics.ctr, metrics.average_cpc FROM campaign WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.cost_micros DESC LIMIT {limit}`,
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign.advertising_channel_type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.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"]
@@ -79,7 +75,7 @@ var PRESETS = [
   {
     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 LIMIT {limit}`,
+    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"]
@@ -87,7 +83,7 @@ var PRESETS = [
   {
     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 LIMIT {limit}`,
+    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"]
@@ -95,7 +91,7 @@ var PRESETS = [
   {
     name: "keyword-analysis",
     description: "Keyword performance with match type and quality",
-    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, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.ctr FROM keyword_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.impressions DESC LIMIT {limit}`,
+    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, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.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"]
@@ -103,7 +99,7 @@ var PRESETS = [
   {
     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 LIMIT {limit}`,
+    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"]
@@ -111,7 +107,7 @@ var PRESETS = [
   {
     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 LIMIT {limit}`,
+    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"]
@@ -119,28 +115,28 @@ var PRESETS = [
   {
     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 LIMIT {limit}`,
+    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)",
-    gaqlTemplate: `SELECT shared_set.id, shared_set.name, 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 LIMIT {limit}`,
+    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 LIMIT {limit}`,
+    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",
-    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.name, ad_group.status, search_term_view.search_term, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.impressions DESC LIMIT {limit}`,
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.name, ad_group.status, search_term_view.search_term, 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"]
@@ -148,15 +144,17 @@ var PRESETS = [
   {
     name: "ad-copy-performance",
     description: "Ad headline and description effectiveness",
-    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.status, 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.conversions, metrics.ctr FROM ad_group_ad WHERE segments.date DURING {dateRange}{statusScope} ORDER BY metrics.impressions DESC LIMIT {limit}`,
+    gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, ad_group.status, 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.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",
-    description: "Performance Max asset performance labels",
-    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.performance_label, asset.type, asset.text_asset.text, asset.image_asset.full_size.url FROM asset_group_asset WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX' AND segments.date DURING {dateRange}{statusScope} LIMIT {limit}`,
+    // `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"]
@@ -164,7 +162,7 @@ var PRESETS = [
   {
     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 LIMIT {limit}`,
+    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"]
@@ -177,6 +175,253 @@ var PRESETS = [
     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: "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: "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);
 }
@@ -187,13 +432,12 @@ function buildStatusScope(statusFields, includePaused) {
 }
 function expandPreset(preset, params, now = /* @__PURE__ */ new Date()) {
   const dateRange = params.dateRange ?? preset.defaultDateRange;
-  const limit = params.limit ?? preset.defaultLimit;
   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(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
+  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 };
 }
 
@@ -313,7 +557,7 @@ function addRequiredAncestorFields(query) {
     ]
   };
 }
-function applyAutoFixes(query, limit) {
+function applyAutoFixes(query) {
   let corrected = query;
   const warnings = [];
   if (/(?<![\w.])keyword\.text\b/.test(corrected)) {
@@ -343,13 +587,6 @@ function applyAutoFixes(query, limit) {
     corrected = corrected.replace(/ad_group\.status\s*=\s*'ACTIVE'/gi, "ad_group.status = 'ENABLED'");
     warnings.push({ code: "ENUM_CORRECTED", message: "ad_group.status ACTIVE \u2192 ENABLED" });
   }
-  if (!/\bLIMIT\b/i.test(corrected)) {
-    const effectiveLimit = limit ?? 200;
-    corrected = `${corrected.trimEnd()} LIMIT ${effectiveLimit}`;
-    if (!isSingleRowRead(corrected)) {
-      warnings.push({ code: "AUTO_LIMIT", message: `Added LIMIT ${effectiveLimit}. Use --limit to override.` });
-    }
-  }
   return { query: corrected, warnings };
 }
 var DURING_CLAUSE = /(?<=[a-z_]\.[a-z_.]+\s+)DURING\s+([A-Za-z0-9_]+)/gi;
@@ -377,24 +614,6 @@ function rejectUnsupportedDuring(query, customerId) {
     }
   };
 }
-function rejectOversizedLimit(query, customerId) {
-  const match = query.match(/\bLIMIT\s+(\d+)\s*$/i);
-  if (!match || Number(match[1]) <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return null;
-  const fixed = query.replace(/\bLIMIT\s+\d+\s*$/i, `LIMIT ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}`);
-  return {
-    ok: false,
-    error: {
-      code: "VALIDATION_ERROR",
-      message: `LIMIT ${match[1]} is more rows than one read can return (${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}).`,
-      fix: {
-        action: "retry_with_flag",
-        correctedCommand: buildCommand(fixed, customerId),
-        explanation: `One query returns at most ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE} rows. For more, split the read into narrower queries \u2014 a shorter BETWEEN range each, or one campaign each \u2014 write each with --out, and combine the files.`
-      },
-      retryable: false
-    }
-  };
-}
 var WHERE_OPERATOR = /(?<![\w.])([a-z_]+(?:\.[a-z_]+)+)\s*(CONTAINS\s+(?:ALL|ANY|NONE)|IS\s+NOT\s+NULL|IS\s+NULL|NOT\s+LIKE|NOT\s+IN|NOT\s+REGEXP_MATCH|REGEXP_MATCH|LIKE|IN|BETWEEN|DURING|!=|<=|>=|=|<|>)/gi;
 function escapeRegExp(text) {
   return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -462,7 +681,7 @@ function rejectContainsCall(query, customerId) {
     }
   };
 }
-function validatePreflight(query, customerId, limit) {
+function validatePreflight(query, customerId) {
   const warnings = [];
   const corrected = query;
   const firstWord = corrected.trim().split(/\s+/)[0]?.toUpperCase();
@@ -510,7 +729,7 @@ function validatePreflight(query, customerId, limit) {
       }
     };
   }
-  for (const reject of [rejectContainsCall, rejectListFieldOperator, rejectUnsupportedDuring, rejectOversizedLimit]) {
+  for (const reject of [rejectContainsCall, rejectListFieldOperator, rejectUnsupportedDuring]) {
     const rejection2 = reject(corrected, customerId);
     if (rejection2) return { valid: false, warnings: [], error: rejection2 };
   }
@@ -538,7 +757,7 @@ function validatePreflight(query, customerId, limit) {
       message: "ad_group_criterion returns BOTH positive and negative keywords. Add ad_group_criterion.negative to SELECT or filter with WHERE ad_group_criterion.negative = FALSE (positives) / TRUE (negatives). Use --preset positive-keywords or negative-keywords instead."
     });
   }
-  const { query: autoFixed, warnings: autoFixWarnings } = applyAutoFixes(corrected, limit);
+  const { query: autoFixed, warnings: autoFixWarnings } = applyAutoFixes(corrected);
   warnings.push(...autoFixWarnings);
   const analysis = analyzeServingChain(autoFixed);
   if (!analysis) return { valid: true, correctedQuery: autoFixed, warnings };
@@ -707,9 +926,14 @@ function keywordServingWarnings(rows, options) {
 // src/commands/ads/google/query.ts
 registerSchema({
   command: "ads.google.query",
-  description: "Run a GAQL (Google Ads Query Language) query. The most powerful command \u2014 supports any valid SELECT statement. Use --preset for common queries without writing GAQL.",
+  description: "Run a GAQL (Google Ads Query Language) query, one page at a time. Start here: `baker ads google query --preset campaign-performance` (--list-presets for all). Each read returns one page of --limit rows and, when the account holds more, `pagination.cursor` \u2014 pass it back with --cursor for the next page, or use --all --out <file> to read every page. A LIMIT in your own GAQL caps the whole read.",
   args: {
-    query: { type: "string", description: "GAQL SELECT query string", required: false },
+    query: { type: "positional", description: "GAQL SELECT statement (or pass it with --gaql)", required: false },
+    gaql: {
+      type: "string",
+      description: 'GAQL SELECT statement as a flag \u2014 same as the positional, for when quoting a positional is awkward: --gaql "SELECT campaign.name FROM campaign"',
+      required: false
+    },
     "customer-id": {
       type: "string",
       description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
@@ -717,7 +941,7 @@ registerSchema({
     },
     preset: {
       type: "string",
-      description: "Named query preset. Reads (campaign-performance, conversions-by-action, keyword-analysis, keyword-serving, positive-keywords, negative-keywords, negative-keyword-lists, negative-list-attachments, search-terms, ad-copy-performance, asset-performance, shopping-products, account-summary). Presets return only actually-serving entities (enabled campaign AND ad group AND ad) by default \u2014 pass --include-paused to include paused ones.",
+      description: `Named query preset (--list-presets shows each one's GAQL and page size): ${PRESETS.map((p) => p.name).join(", ")}. Presets return only actually-serving entities (enabled campaign AND ad group AND ad) by default \u2014 pass --include-paused to include paused ones.`,
       required: false
     },
     "date-range": {
@@ -732,15 +956,18 @@ registerSchema({
     },
     limit: {
       type: "number",
-      description: "Max rows in ONE page (default 200), AND the LIMIT added to a query that has none \u2014 so it caps the whole read with --all too. Values up to 8192 are accepted \u2014 the most one read can return. Any read that fills this cap comes back flagged TRUNCATED_RESULTS \u2014 never count or total from one.",
-      required: false,
-      default: 200
+      description: `Rows per page (default: the preset's page size, else 200; at most ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}). A page size, not a cap: when more rows exist the read returns a cursor, and --all keeps paging.`,
+      required: false
     },
     "list-presets": { type: "boolean", description: "List all available query presets", required: false },
-    cursor: { type: "string", description: "Pagination cursor from previous response", required: false },
+    cursor: {
+      type: "string",
+      description: "Resume after a previous page: pass its pagination.cursor with the same query and --limit",
+      required: false
+    },
     all: {
       type: "boolean",
-      description: "Follow every page until the data set is exhausted (use with --out for large datasets). Needed for a read you may count or total, but not sufficient: it exhausts the pages, not the statement's LIMIT, so pair it with a LIMIT in the statement above the row count you expect (at most 8192 \u2014 split bigger reads into narrower queries) and check the read came back without TRUNCATED_RESULTS.",
+      description: "Follow every page until the account has no more rows (use with --out for large reads). Needed for any read you will count or total. Only a LIMIT written in the GAQL itself can stop it early.",
       required: false
     },
     out: {
@@ -807,12 +1034,10 @@ function writeRowsToFile(filePath, rows, fields, append) {
     writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
   }
 }
-function effectiveRowLimit(finalQuery, limit, all = false) {
+function effectiveRowLimit(finalQuery) {
   if (isSingleRowRead(finalQuery)) return void 0;
   const match = finalQuery.match(/\bLIMIT\s+(\d+)/i);
-  const statementLimit = match?.[1] ? Number(match[1]) : void 0;
-  if (all) return statementLimit;
-  return statementLimit === void 0 ? limit : Math.min(limit, statementLimit);
+  return match?.[1] ? Number(match[1]) : void 0;
 }
 function warningLines(warnings, format) {
   return warnings.map((w) => {
@@ -826,9 +1051,13 @@ function completenessWarnings(read) {
   const cap = read.effectiveLimit;
   const filledTheCap = cap !== void 0 && cap > 0 && read.rowCount >= cap;
   if (!read.hasMore && !filledTheCap) return [];
-  const cause = read.hasMore ? `More rows are waiting: the account returned a next-page cursor this run did not follow.` : `The ${read.rowCount} rows returned exactly fill the row cap in force (${cap}).`;
-  const atPageCap = cap !== void 0 && cap >= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE;
-  const fix = atPageCap ? `${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE} rows is the most one read can return \u2014 split it into narrower queries (a shorter BETWEEN range each, or one campaign each), write each with --out, and combine the files.` : read.all ? `Every page was followed, so the cap is the LIMIT in the statement itself \u2014 raise it above ${cap}, or drop it and pass a larger --limit (up to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}), then re-run.` : `Re-run with --all --out <file> to page through everything, or raise --limit above ${cap} (up to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}).`;
+  const [cause, fix] = read.hasMore ? [
+    "More rows are waiting: the account returned a next-page cursor this run did not follow.",
+    "Re-run with --all --out <file> to read every page, or pass --cursor <pagination.cursor> (same query, same --limit) for the next page."
+  ] : [
+    `The ${read.rowCount} rows returned exactly fill the LIMIT in the statement (${cap}).`,
+    `Raise the LIMIT in the statement above ${cap}, or drop it \u2014 without a LIMIT, --all pages through every row.`
+  ];
   return [
     {
       code: "TRUNCATED_RESULTS",
@@ -913,7 +1142,6 @@ function outputResults(rows, fieldDescs, warnings, args, cached, read) {
     ...completenessWarnings({
       rowCount: rows.length,
       effectiveLimit: read.effectiveLimit,
-      all: read.all,
       hasMore: Boolean(read.nextCursor)
     })
   ];
@@ -930,7 +1158,15 @@ function outputResults(rows, fieldDescs, warnings, args, cached, read) {
   }
   writeRows(format, rows, resultColumns(read.gaql, rows), warningLines(allWarnings, format));
 }
-function resolveGaql(args, limit) {
+function resolveGaqlInput(args) {
+  const positional = typeof args.query === "string" ? args.query.trim() : "";
+  const flag = typeof args.gaql === "string" ? args.gaql.trim() : "";
+  if (positional && flag && positional !== flag) {
+    return { ok: false, message: "Pass the GAQL statement once \u2014 as the positional or as --gaql, not both." };
+  }
+  return { ok: true, gaql: positional || flag };
+}
+function resolveGaql(args) {
   if (args.preset) {
     const preset = getPreset(args.preset);
     if (!preset) {
@@ -943,7 +1179,6 @@ function resolveGaql(args, limit) {
     }
     const expanded = expandPreset(preset, {
       dateRange: args["date-range"],
-      limit,
       includePaused: Boolean(args["include-paused"])
     });
     if (expanded.dateRangeError) {
@@ -955,18 +1190,18 @@ function resolveGaql(args, limit) {
     }
     return expanded.query;
   }
-  const gaql = args.query ?? "";
-  if (!gaql) {
+  const input = resolveGaqlInput(args);
+  if (!input.ok || !input.gaql) {
     writeAdsJson({
       ok: false,
       error: {
         code: "VALIDATION_ERROR",
-        message: "Provide a GAQL query or use --preset. Run --list-presets to see options."
+        message: input.ok ? "Provide a GAQL query (positional or --gaql) or use --preset. Run --list-presets to see options." : input.message
       }
     });
     return null;
   }
-  return gaql;
+  return input.gaql;
 }
 var SERVING_HIERARCHY_RESOURCES = [
   "campaign",
@@ -990,7 +1225,8 @@ function whereClause3(upperQuery) {
 }
 function servingScopeWarnings(args, finalQuery) {
   if (args.preset) {
-    if (!args["include-paused"]) return [];
+    const name = String(args.preset);
+    if (!args["include-paused"] || isInventoryPreset(name) || !getPreset(name)?.statusFields?.length) return [];
     return [
       {
         code: "SERVING_SCOPE",
@@ -1100,11 +1336,13 @@ async function fetchAllPages(gaql, body, args, servingOptions) {
     fileColumns: fileColumns ?? []
   };
 }
+function pageCacheKey(customerId, query, pageSize, cursor) {
+  return buildQueryCacheKey(customerId, `${query}\0page=${pageSize}\0cursor=${cursor ?? ""}`);
+}
 async function executeQuery(finalQuery, args, customerId, limit, warnings, useCache, cacheKey) {
   const body = { customerId, query: finalQuery, pageSize: limit };
   const managerId = getManagerIdForCustomer(customerId);
   if (managerId) body.managerId = managerId;
-  if (args.cursor) body.pageToken = args.cursor;
   if (!useCache) body.skipCache = true;
   const servingOptions = keywordServingOptions(finalQuery);
   const { allRows, lastPageToken, totalRowsWritten, keywordLimits, observedFields, fileColumns } = await fetchAllPages(
@@ -1116,8 +1354,7 @@ async function executeQuery(finalQuery, args, customerId, limit, warnings, useCa
   if (args.out) {
     const truncation = completenessWarnings({
       rowCount: totalRowsWritten,
-      effectiveLimit: effectiveRowLimit(finalQuery, limit, Boolean(args.all)),
-      all: Boolean(args.all),
+      effectiveLimit: effectiveRowLimit(finalQuery),
       hasMore: Boolean(lastPageToken)
     });
     const fileWarnings = [
@@ -1140,9 +1377,9 @@ async function executeQuery(finalQuery, args, customerId, limit, warnings, useCa
     );
     return;
   }
-  if (useCache && allRows.length > 0) {
-    const fields2 = extractFields(allRows);
-    cacheSet("queries", cacheKey, allRows, getQueryTtl(finalQuery), getFieldDescriptions(fields2));
+  if (useCache && !args.all && allRows.length > 0) {
+    const page = { rows: allRows, ...lastPageToken ? { cursor: lastPageToken } : {} };
+    cacheSet("queries", cacheKey, page, getQueryTtl(finalQuery), getFieldDescriptions(extractFields(allRows)));
   }
   const fields = extractFields(allRows);
   outputResults(
@@ -1158,18 +1395,17 @@ async function executeQuery(finalQuery, args, customerId, limit, warnings, useCa
     false,
     {
       gaql: finalQuery,
-      effectiveLimit: effectiveRowLimit(finalQuery, limit, Boolean(args.all)),
-      all: Boolean(args.all),
+      effectiveLimit: effectiveRowLimit(finalQuery),
       nextCursor: lastPageToken
     }
   );
 }
 function shouldReadCache(args) {
-  return !args["no-cache"] && !args.out;
+  return !args["no-cache"] && !args.out && !args.all;
 }
 var DEFAULT_QUERY_LIMIT = 200;
-function parseQueryLimit(raw) {
-  if (raw === void 0 || raw === null || raw === "") return { ok: true, limit: DEFAULT_QUERY_LIMIT };
+function parseQueryLimit(raw, fallback = DEFAULT_QUERY_LIMIT) {
+  if (raw === void 0 || raw === null || raw === "") return { ok: true, limit: fallback };
   const limit = Number(raw);
   if (Number.isInteger(limit) && limit >= 1 && limit <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return { ok: true, limit };
   return {
@@ -1181,26 +1417,30 @@ function parseQueryLimit(raw) {
         message: `--limit must be a whole number from 1 to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}, got '${String(raw)}'.`,
         fix: {
           action: "retry_with_flag",
-          explanation: `One read returns at most ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE} rows. For more, split the read into narrower queries (a shorter BETWEEN range each, or one campaign each), write each with --out, and combine the files.`
+          explanation: `--limit is the size of one page, at most ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE} rows. For more rows, keep the page size and add --all --out <file>: it reads every page.`
         },
         retryable: false
       }
     }
   };
 }
+function queryPageSize(args) {
+  const preset = typeof args.preset === "string" ? getPreset(args.preset) : void 0;
+  return parseQueryLimit(args.limit, preset?.defaultLimit ?? DEFAULT_QUERY_LIMIT);
+}
 async function validateArgs(args) {
-  const parsedLimit = parseQueryLimit(args.limit);
+  const parsedLimit = queryPageSize(args);
   if (!parsedLimit.ok) {
     writeAdsJson(parsedLimit.error);
     process.exit(1);
   }
   const { limit } = parsedLimit;
   const customerId = await resolveCustomerId(args);
-  const gaql = resolveGaql(args, limit);
+  const gaql = resolveGaql(args);
   if (!gaql) {
     process.exit(1);
   }
-  const preflight = validatePreflight(gaql, customerId, limit);
+  const preflight = validatePreflight(gaql, customerId);
   if (!preflight.valid && preflight.error) {
     writeAdsJson(preflight.error);
     process.exit(1);
@@ -1212,7 +1452,7 @@ async function validateArgs(args) {
     finalQuery,
     warnings: [...preflight.warnings, ...servingScopeWarnings(args, finalQuery)],
     useCache: !args["no-cache"],
-    cacheKey: buildQueryCacheKey(customerId, finalQuery)
+    cacheKey: pageCacheKey(customerId, finalQuery, limit, args.cursor)
   };
 }
 function handleQueryError(err, finalQuery, customerId) {
@@ -1234,19 +1474,62 @@ function handleQueryError(err, finalQuery, customerId) {
   });
   process.exit(1);
 }
+async function runQuery(args) {
+  const validated = await validateArgs(args);
+  if (!validated) return;
+  const { customerId, limit, finalQuery, warnings, useCache, cacheKey } = validated;
+  if (shouldReadCache(args)) {
+    const cached = cacheGet("queries", cacheKey);
+    if (cached && Array.isArray(cached.data.rows)) {
+      const rows = cached.data.rows;
+      outputResults(
+        rows,
+        cached.fields ?? getFieldDescriptions(extractFields(rows)),
+        [
+          ...warnings,
+          ...missingFieldWarnings(finalQuery, rows),
+          ...keywordServingWarnings(rows, keywordServingOptions(finalQuery)),
+          ...conversionMixWarnings(finalQuery)
+        ],
+        args,
+        true,
+        { gaql: finalQuery, effectiveLimit: effectiveRowLimit(finalQuery), nextCursor: cached.data.cursor }
+      );
+      return;
+    }
+  }
+  try {
+    await executeQuery(finalQuery, args, customerId, limit, warnings, useCache, cacheKey);
+  } catch (err) {
+    handleQueryError(err, finalQuery, customerId);
+  }
+}
 var queryCommand = defineCommand({
   meta: {
     name: "query",
-    description: `Run GAQL queries against Google Ads. Supports raw GAQL, presets, pagination, file export, and caching.
+    description: `Run GAQL against Google Ads, one page at a time. Supports raw GAQL, presets, paging, file export, and caching.
+
+Start here:
+  baker ads google query --list-presets
+  baker ads google query --preset campaign-performance --customer-id 1234567890
+
+Each read returns one page (--limit rows; the preset's page size by default, else 200). When the
+account holds more, the envelope carries pagination.cursor: pass it with --cursor for the next page,
+or read everything with --all --out <file>. A LIMIT written in the GAQL caps the whole read.
 
 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 query --preset search-terms --customer-id 1234567890 --date-range LAST_7_DAYS --out results.csv
-  baker ads google query --list-presets`
+  baker ads google query --gaql "SELECT ad_group.name FROM ad_group WHERE ad_group.status = 'ENABLED'" --customer-id 1234567890
+  baker ads google query --preset search-terms --customer-id 1234567890 --date-range LAST_7_DAYS --all --out terms.csv
+  baker ads google query --preset keyword-serving --customer-id 1234567890 --cursor <pagination.cursor>`
   },
   args: {
-    query: { type: "positional", description: "GAQL query string", required: false },
+    query: { type: "positional", description: "GAQL SELECT statement", required: false },
+    gaql: {
+      type: "string",
+      description: "GAQL SELECT statement as a flag (instead of the positional)",
+      required: false
+    },
     "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)", required: false },
     preset: { type: "string", description: "Named query preset", required: false },
     "date-range": { type: "string", description: "Date range override for presets", required: false },
@@ -1257,12 +1540,12 @@ Examples:
     },
     limit: {
       type: "string",
-      description: "Max rows in one page (default 200); without --all the read stops there",
+      description: "Rows per page (default: the preset's page size, else 200)",
       required: false
     },
     "list-presets": { type: "boolean", description: "List available presets", required: false },
-    cursor: { type: "string", description: "Pagination cursor", required: false },
-    all: { type: "boolean", description: "Follow every page (use with --out for large datasets)", required: false },
+    cursor: { type: "string", description: "pagination.cursor from the previous page", required: false },
+    all: { type: "boolean", description: "Follow every page (use with --out for large reads)", required: false },
     out: { type: "string", description: "File path for output", required: false },
     append: { type: "boolean", description: "Append to file", required: false },
     output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
@@ -1277,65 +1560,40 @@ Examples:
           name: p.name,
           description: p.description,
           defaultDateRange: p.defaultDateRange,
+          pageSize: p.defaultLimit,
           servingOnly: (p.statusFields?.length ?? 0) > 0,
           gaql: expandPreset(p, {}).query
         }))
       });
       return;
     }
-    const validated = await validateArgs(args);
-    if (!validated) return;
-    const { customerId, limit, finalQuery, warnings, useCache, cacheKey } = validated;
-    if (shouldReadCache(args)) {
-      const cached = cacheGet("queries", cacheKey);
-      if (cached) {
-        const fields = extractFields(cached.data);
-        outputResults(
-          cached.data,
-          cached.fields ?? getFieldDescriptions(fields),
-          [
-            ...warnings,
-            ...missingFieldWarnings(finalQuery, cached.data),
-            ...keywordServingWarnings(cached.data, keywordServingOptions(finalQuery)),
-            ...conversionMixWarnings(finalQuery)
-          ],
-          args,
-          true,
-          {
-            gaql: finalQuery,
-            effectiveLimit: effectiveRowLimit(finalQuery, limit, Boolean(args.all)),
-            all: Boolean(args.all)
-          }
-        );
-        return;
-      }
-    }
-    try {
-      await executeQuery(finalQuery, args, customerId, limit, warnings, useCache, cacheKey);
-    } catch (err) {
-      handleQueryError(err, finalQuery, customerId);
-    }
+    await runQuery(args);
   }
 });
+
 export {
-  buildFileSummary,
-  buildQueryEnvelope,
-  completenessWarnings,
+  resultColumns,
   effectiveRowLimit,
-  keywordServingOptions,
-  missingFieldWarnings,
-  missingFieldWarningsFor,
+  warningLines,
+  completenessWarnings,
+  buildQueryEnvelope,
+  summariseWarnings,
+  buildFileSummary,
   outputResults,
-  parseQueryLimit,
-  parseSelectedFields,
-  queryCommand,
-  resultColumns,
+  resolveGaqlInput,
   servingScopeWarnings,
-  shouldReadCache,
-  summariseWarnings,
-  unobservedFields,
+  parseSelectedFields,
   unobservedSelectedFields,
+  unobservedFields,
+  missingFieldWarnings,
+  missingFieldWarningsFor,
   unwrittenColumnWarnings,
-  warningLines
+  keywordServingOptions,
+  pageCacheKey,
+  shouldReadCache,
+  parseQueryLimit,
+  queryPageSize,
+  runQuery,
+  queryCommand
 };
-//# sourceMappingURL=query-IEZRY6HV.js.map
+//# sourceMappingURL=chunk-XPOIIQCI.js.map