@koda-sl/baker-cli 0.572.0 → 0.574.0

package/dist/chunk-QENSBNRJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/query.ts","../src/commands/ads/google/preflight.ts","../src/commands/ads/google/conversion-mix.ts","../src/commands/ads/google/keyword-serving.ts","../src/commands/ads/google/money-units.ts"],"sourcesContent":["import { appendFileSync, existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { GOOGLE_ADS_QUERY_MAX_PAGE_SIZE } from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { buildQueryCacheKey, cacheGet, cacheSet, getManagerIdForCustomer, getQueryTtl } from \"../cache.ts\";\nimport { getFieldDescriptions } from \"../field-descriptions.ts\";\nimport { resolveCustomerId, toCsvRow, writeAdsJson } from \"../output.ts\";\nimport { googlePresetSyncedHint } from \"../synced-first.ts\";\nimport type { AdsErrorEnvelope, AdsFileSummary, AdsSuccessEnvelope, AdsWarning } from \"../types.ts\";\nimport { parseCampaignIds } from \"./campaign-ids.ts\";\nimport { conversionMixWarnings, countRowsWithConversions } from \"./conversion-mix.ts\";\nimport { parseApiError } from \"./error-parser.ts\";\nimport {\n  collectKeywordLimits,\n  type KeywordLimits,\n  type KeywordServingOptions,\n  keywordServingWarnings,\n  renderKeywordLimits,\n} from \"./keyword-serving.ts\";\nimport { moneyUnitWarnings } from \"./money-units.ts\";\nimport { isSingleRowRead, validatePreflight } from \"./preflight.ts\";\nimport { expandPreset, getPreset, isInventoryPreset, PRESETS, SERVING_CHAINS } from \"./presets.ts\";\n\nregisterSchema({\n  command: \"ads.google.query\",\n  description:\n    \"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` — 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.\",\n  args: {\n    query: { type: \"positional\", description: \"GAQL SELECT statement (or pass it with --gaql)\", required: false },\n    gaql: {\n      type: \"string\",\n      description:\n        'GAQL SELECT statement as a flag — same as the positional, for when quoting a positional is awkward: --gaql \"SELECT campaign.name FROM campaign\"',\n      required: false,\n    },\n    \"customer-id\": {\n      type: \"string\",\n      description:\n        \"Google Ads customer ID (10 digits; dashes are fine). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.\",\n      required: false,\n    },\n    preset: {\n      type: \"string\",\n      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 — pass --include-paused to include paused ones.`,\n      required: false,\n    },\n    \"date-range\": {\n      type: \"string\",\n      description:\n        \"Date range for presets: a Google date literal (TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH …) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'. Google has no LAST_90_DAYS — use BETWEEN for any other window.\",\n      required: false,\n    },\n    \"include-paused\": {\n      type: \"boolean\",\n      description:\n        \"Include paused entities in preset results. Off by default: presets return only actually-serving entities. Google Ads has no single serving flag — an entity serves only when its whole chain (campaign, ad group, ad) is ENABLED, so recommendations should target serving entities unless the user asks about paused ones.\",\n      required: false,\n    },\n    limit: {\n      type: \"number\",\n      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.`,\n      required: false,\n    },\n    \"list-presets\": { type: \"boolean\", description: \"List all available query presets\", required: false },\n    cursor: {\n      type: \"string\",\n      description: \"Resume after a previous page: pass its pagination.cursor with the same query and --limit\",\n      required: false,\n    },\n    all: {\n      type: \"boolean\",\n      description:\n        \"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.\",\n      required: false,\n    },\n    out: {\n      type: \"string\",\n      description: \"Write data to file (format from extension: .csv, .jsonl, .json)\",\n      required: false,\n    },\n    append: { type: \"boolean\", description: \"Append to existing file (skip CSV headers)\", required: false },\n    output: {\n      type: \"string\",\n      description: \"Output format: json|csv|jsonl|md\",\n      required: false,\n      default: \"json\",\n      enum: [\"json\", \"csv\", \"jsonl\", \"md\"],\n    },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache, hit API directly\", required: false },\n    full: {\n      type: \"boolean\",\n      description:\n        \"Include the field description glossary in the JSON envelope. Off by default — rows already carry the data; only ask for this when you need a field's meaning explained.\",\n      required: false,\n    },\n  },\n});\n\ninterface QueryApiResponse {\n  rows: Array<Record<string, unknown>>;\n  pageToken?: string;\n}\n\nfunction extractFields(rows: Array<Record<string, unknown>>): string[] {\n  const keys = new Set<string>();\n  foldObservedFields(rows, keys);\n  return [...keys];\n}\n\n// The columns a table-shaped read renders: every SELECTed field, in SELECT order, whether or not any\n// row carried it. Deriving them from the rows is what dropped `campaign_conversion_goal.biddable` from\n// an md table: Google omits a false boolean, the first row was a non-biddable goal, and the column\n// that answered the question vanished with no warning. A submessage selected whole expands to the\n// leaves that came back, and a key nobody selected is kept at the end rather than lost.\nexport function resultColumns(gaql: string, rows: Array<Record<string, unknown>>): string[] {\n  const observed = extractFields(rows);\n  const columns: string[] = [];\n  for (const field of parseSelectedFields(gaql)) {\n    const leaves = observed.filter((key) => key.startsWith(`${field}.`));\n    columns.push(...(leaves.length > 0 ? leaves : [field]));\n  }\n  for (const key of observed) columns.push(key);\n  return [...new Set(columns)];\n}\n\nfunction isCsvPath(filePath: string): boolean {\n  return filePath.split(\".\").pop()?.toLowerCase() === \"csv\";\n}\n\nfunction writeRowsToFile(\n  filePath: string,\n  rows: Array<Record<string, unknown>>,\n  fields: string[],\n  append: boolean,\n): void {\n  if (isCsvPath(filePath)) {\n    if (!append || !existsSync(filePath)) {\n      writeFileSync(filePath, `${toCsvRow(fields)}\\n`, \"utf-8\");\n    }\n    const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? \"\"))));\n    appendFileSync(filePath, `${csvRows.join(\"\\n\")}\\n`, \"utf-8\");\n  } else if (filePath.split(\".\").pop()?.toLowerCase() === \"jsonl\") {\n    const lines = rows.map((row) => JSON.stringify(row));\n    if (append && existsSync(filePath)) {\n      appendFileSync(filePath, `${lines.join(\"\\n\")}\\n`, \"utf-8\");\n    } else {\n      writeFileSync(filePath, `${lines.join(\"\\n\")}\\n`, \"utf-8\");\n    }\n  } else if (append && existsSync(filePath)) {\n    const existing = JSON.parse(readFileSync(filePath, \"utf-8\")) as unknown[];\n    writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), \"utf-8\");\n  } else {\n    writeFileSync(filePath, JSON.stringify(rows, null, 2), \"utf-8\");\n  }\n}\n\n// The row cap in force for the whole read, or undefined when nothing caps it. --limit is only the\n// size of a page — the read hands back a cursor when the account holds more — so the one cap left is\n// a LIMIT the statement itself carries. Needed to tell \"this is all there is\" from \"this is as much\n// as the statement asked for\".\n//\n// A statement that returns one row by construction has no cap in force: its LIMIT 1 is the shape of\n// the answer, not a page size, and one row filling it is the whole data set.\nexport function effectiveRowLimit(finalQuery: string): number | undefined {\n  if (isSingleRowRead(finalQuery)) return undefined;\n  const match = finalQuery.match(/\\bLIMIT\\s+(\\d+)/i);\n  return match?.[1] ? Number(match[1]) : undefined;\n}\n\n// One notice per warning, shaped so it survives the format it travels in. The channel never names\n// a warning code: whatever the preflight or a row decoder produces flows through unchanged.\nexport function warningLines(warnings: AdsWarning[], format: string): string[] {\n  return warnings.map((w) => {\n    const message = w.message.replace(/\\s*\\n\\s*/g, \" \");\n    if (format === \"jsonl\") return JSON.stringify({ _baker_warning: { code: w.code, message } });\n    if (format === \"md\") return `> **${w.code}** — ${message}`;\n    // csv and anything else: a leading # keeps a CSV parser from reading it as a header.\n    return `# baker ${w.code}: ${message}`;\n  });\n}\n\nexport interface ReadCompleteness {\n  rowCount: number;\n  /** The statement's own LIMIT — see `effectiveRowLimit`. Undefined when nothing caps the read. */\n  effectiveLimit: number | undefined;\n  /** The account handed back a next-page cursor that this run did not follow. */\n  hasMore: boolean;\n}\n\n// A truncated read that looks complete is the whole failure this guard exists for: rows that stop\n// at a cap are indistinguishable from a data set that happens to be that size, and the agent reads\n// them as the universe. Two things can stop a read short — an unfollowed cursor, or the statement's\n// own LIMIT — and each has its own way on. A read that ran out of rows says nothing.\nexport function completenessWarnings(read: ReadCompleteness): AdsWarning[] {\n  const cap = read.effectiveLimit;\n  const filledTheCap = cap !== undefined && cap > 0 && read.rowCount >= cap;\n  if (!read.hasMore && !filledTheCap) return [];\n  const [cause, fix] = read.hasMore\n    ? [\n        \"More rows are waiting: the account returned a next-page cursor this run did not follow.\",\n        \"Re-run with --all --out <file> to read every page, or pass --cursor <pagination.cursor> (same query, same --limit) for the next page.\",\n      ]\n    : [\n        `The ${read.rowCount} rows returned exactly fill the LIMIT in the statement (${cap}).`,\n        `Raise the LIMIT in the statement above ${cap}, or drop it — without a LIMIT, --all pages through every row.`,\n      ];\n  return [\n    {\n      code: \"TRUNCATED_RESULTS\",\n      message: `INCOMPLETE READ — ${cause} These rows are a page, not the data set. Don't count, total or describe them as the whole picture. ${fix}`,\n    },\n  ];\n}\n\ninterface EnvelopeOptions {\n  full: boolean;\n  cached: boolean;\n  nextCursor?: string;\n}\n\n// The field-description dictionary is a static glossary the agent almost never reads, so it is\n// opt-in via --full rather than a per-call token tax on every JSON envelope.\nexport function buildQueryEnvelope(\n  rows: Array<Record<string, unknown>>,\n  fieldDescs: Record<string, string>,\n  warnings: AdsWarning[],\n  options: EnvelopeOptions,\n): AdsSuccessEnvelope<Array<Record<string, unknown>>> {\n  // Key order is load-bearing: a pretty-printed envelope of 500 rows read through `head` shows only\n  // its first keys, so warnings and pagination go BEFORE data, and a one-line notice closes it for\n  // whoever reads the tail.\n  const notice = summariseWarnings(warnings);\n  return {\n    ok: true,\n    ...(options.cached ? { cached: true as const } : {}),\n    ...(warnings.length > 0 ? { warnings } : {}),\n    ...(options.nextCursor ? { pagination: { hasMore: true, cursor: options.nextCursor } } : {}),\n    data: rows,\n    ...(options.full && Object.keys(fieldDescs).length > 0 ? { fields: fieldDescs } : {}),\n    ...(notice ? { notice } : {}),\n  };\n}\n\n// One line naming every warning code, so a reader who only sees the end of the output still knows\n// something was flagged. Code-agnostic: any warning the pipeline produces lands here.\nexport function summariseWarnings(warnings: AdsWarning[]): string | undefined {\n  if (warnings.length === 0) return undefined;\n  const codes = [...new Set(warnings.map((w) => w.code))].join(\", \");\n  return `Read the \"warnings\" above before using these rows: ${codes}.`;\n}\n\nexport interface FileSummaryInput {\n  file: string;\n  rows: number;\n  warnings: AdsWarning[];\n  complete: boolean;\n}\n\n// The --out branch throws the rows away, so this envelope is the only thing the agent reads about\n// the pull. It carries every warning the read raised, not just the ones a row decoder produced.\nexport function buildFileSummary(input: FileSummaryInput): AdsFileSummary {\n  const notice = summariseWarnings(input.warnings);\n  return {\n    ok: true,\n    fields: {},\n    file: input.file,\n    rows: input.rows,\n    complete: input.complete,\n    ...(input.warnings.length > 0 ? { warnings: input.warnings } : {}),\n    ...(notice ? { notice } : {}),\n  };\n}\n\n// Repeating the notice at the tail costs two lines and buys the case that actually bit us: a long\n// CSV read whose output the agent inspects with `tail`. Short reads are visible whole, so once is enough.\nconst REPEAT_NOTICE_ABOVE_ROWS = 20;\n\nexport interface ReadContext {\n  /** The statement that ran — its SELECT list, not the rows, decides a table's columns. */\n  gaql: string;\n  effectiveLimit: number | undefined;\n  nextCursor?: string;\n}\n\nfunction writeLine(line: string): void {\n  process.stdout.write(`${line}\\n`);\n}\n\ntype RowWriter = (rows: Array<Record<string, unknown>>, fields: string[], notices: string[]) => void;\n\n// The header stays the first line so a CSV reader still parses; the notice sits right under it,\n// where a `head` lands, and repeats at the tail, where a `tail` lands.\nconst writeCsvRows: RowWriter = (rows, fields, notices) => {\n  writeLine(toCsvRow(fields));\n  for (const line of notices) writeLine(line);\n  for (const row of rows) writeLine(toCsvRow(fields.map((f) => String(row[f] ?? \"\"))));\n};\n\nconst writeJsonlRows: RowWriter = (rows, _fields, notices) => {\n  for (const line of notices) writeLine(line);\n  for (const row of rows) writeLine(JSON.stringify(row));\n};\n\nconst OMITTED = \"(omitted)\";\nconst OMITTED_FALSE = `false ${OMITTED}`;\nconst OMITTED_LEGEND = `> ${OMITTED} = Google left this field off the row, which is how it sends false, 0 and \"not set\": the field WAS read. A field with no column here was not read.`;\n\n// A blank cell reads as \"no data\", which is the one thing an omitted field is not. Google omits a\n// false boolean, so in a column that carries a boolean anywhere the omission is spelled out as false.\nfunction mdCell(row: Record<string, unknown>, field: string, booleanColumns: ReadonlySet<string>): string {\n  if (!(field in row)) return booleanColumns.has(field) ? OMITTED_FALSE : OMITTED;\n  return String(row[field] ?? \"\").replace(/\\|/g, \"\\\\|\");\n}\n\n// A blockquote inside a markdown table would break it, so the notice brackets the table.\nconst writeMdRows: RowWriter = (rows, fields, notices) => {\n  const booleanColumns = new Set(fields.filter((f) => rows.some((row) => typeof row[f] === \"boolean\")));\n  for (const line of notices) writeLine(line);\n  writeLine(`| ${fields.join(\" | \")} |`);\n  writeLine(`| ${fields.map(() => \"---\").join(\" | \")} |`);\n  for (const row of rows) writeLine(`| ${fields.map((f) => mdCell(row, f, booleanColumns)).join(\" | \")} |`);\n  if (rows.some((row) => fields.some((f) => !(f in row)))) writeLine(OMITTED_LEGEND);\n};\n\nconst ROW_WRITERS: Record<string, RowWriter> = { csv: writeCsvRows, jsonl: writeJsonlRows, md: writeMdRows };\n\n// Each writer decides where a notice can sit without wrecking the format it travels in; the tail\n// repeat is common to all of them, because `| tail` is how a long read gets inspected.\nfunction writeRows(format: string, rows: Array<Record<string, unknown>>, columns: string[], notices: string[]): void {\n  const write = ROW_WRITERS[format] ?? writeMdRows;\n  write(rows, columns, notices);\n  if (rows.length > REPEAT_NOTICE_ABOVE_ROWS) {\n    for (const line of notices) writeLine(line);\n  }\n}\n\nexport function outputResults(\n  rows: Array<Record<string, unknown>>,\n  fieldDescs: Record<string, string>,\n  warnings: AdsWarning[],\n  args: Record<string, unknown>,\n  cached: boolean,\n  read: ReadContext,\n): void {\n  const format = (args.output as string) || \"json\";\n  const allWarnings = [\n    ...warnings,\n    ...completenessWarnings({\n      rowCount: rows.length,\n      effectiveLimit: read.effectiveLimit,\n      hasMore: Boolean(read.nextCursor),\n    }),\n  ];\n  // Every format carries its warnings in-band, so stdout is their one channel: a stderr copy reached\n  // the agent twice through `2>&1`, and in front of the JSON it made the capture unparseable.\n  if (format === \"json\") {\n    writeAdsJson(\n      buildQueryEnvelope(rows, fieldDescs, allWarnings, {\n        full: Boolean(args.full),\n        cached,\n        nextCursor: read.nextCursor,\n      }),\n    );\n    return;\n  }\n  writeRows(format, rows, resultColumns(read.gaql, rows), warningLines(allWarnings, format));\n}\n\n/** The statement typed as the positional or as --gaql — never two different ones. */\nexport function resolveGaqlInput(\n  args: Record<string, unknown>,\n): { ok: true; gaql: string } | { ok: false; message: string } {\n  const positional = typeof args.query === \"string\" ? args.query.trim() : \"\";\n  const flag = typeof args.gaql === \"string\" ? args.gaql.trim() : \"\";\n  if (positional && flag && positional !== flag) {\n    return { ok: false, message: \"Pass the GAQL statement once — as the positional or as --gaql, not both.\" };\n  }\n  return { ok: true, gaql: positional || flag };\n}\n\nfunction resolveGaql(args: Record<string, unknown>): string | null {\n  if (args.preset) {\n    const preset = getPreset(args.preset as string);\n    if (!preset) {\n      const available = PRESETS.map((p) => p.name).join(\", \");\n      writeAdsJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: `Unknown preset: \"${args.preset}\". Available: ${available}` },\n      });\n      return null;\n    }\n    const campaigns = parseCampaignIds(args[\"campaign-id\"]);\n    if (!campaigns.ok) {\n      writeAdsJson({ ok: false, error: campaigns.error });\n      return null;\n    }\n    const expanded = expandPreset(preset, {\n      dateRange: args[\"date-range\"] as string | undefined,\n      includePaused: Boolean(args[\"include-paused\"]),\n      campaignIds: campaigns.ids,\n    });\n    if (expanded.dateRangeError) {\n      writeAdsJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: expanded.dateRangeError },\n      });\n      return null;\n    }\n    return expanded.query;\n  }\n  const input = resolveGaqlInput(args);\n  if (!input.ok || !input.gaql) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"VALIDATION_ERROR\",\n        message: input.ok\n          ? \"Provide a GAQL query (positional or --gaql) or use --preset. Run --list-presets to see options.\"\n          : input.message,\n      },\n    });\n    return null;\n  }\n  return input.gaql;\n}\n\n// Resources whose rows only actually serve when their whole status chain is ENABLED, MINUS the\n// multi-rung ones preflight's SERVING_CHAINS already judges rung by rung. What is left is the\n// single-rung resources: they carry no ancestor to forget, so preflight exempts them by design and\n// this is the only place that says an unfiltered read of them returns paused rows. Two warnings for\n// one defect is how an agent learns to skim past both, so the populations must not overlap.\nconst SERVING_HIERARCHY_RESOURCES = [\n  \"campaign\",\n  \"ad_group\",\n  \"ad_group_ad\",\n  \"ad_group_criterion\",\n  \"keyword_view\",\n  \"search_term_view\",\n  \"shopping_performance_view\",\n  \"asset_group_asset\",\n].filter((resource) => !(resource in SERVING_CHAINS));\n\n// Extract the WHERE clause's predicates from an uppercased GAQL string — everything between\n// WHERE and the first trailing clause (ORDER BY / LIMIT / PARAMETERS). Returns \"\" when there is\n// no WHERE. Used to detect a real status *filter* rather than a status column in the SELECT list.\n// Keywords are found by word boundary, not by spaces, so a query written over several lines reads\n// the same as one written on a single line.\nfunction whereClause(upperQuery: string): string {\n  const where = /\\bWHERE\\b/.exec(upperQuery);\n  if (!where) return \"\";\n  const rest = upperQuery.slice(where.index + where[0].length);\n  const trailing = /\\b(?:ORDER\\s+BY|GROUP\\s+BY|LIMIT|PARAMETERS)\\b/.exec(rest);\n  return trailing ? rest.slice(0, trailing.index) : rest;\n}\n\n// Nudge the agent toward serving-only analysis. Presets already default to the serving chain,\n// so this only fires for raw custom GAQL that targets a serving-hierarchy resource without any\n// status predicate — Google Ads has no single serving flag, so an unfiltered query returns\n// paused-parent entities that look live.\nexport function servingScopeWarnings(args: Record<string, unknown>, finalQuery: string): AdsWarning[] {\n  // --include-paused only has an effect on presets (expandPreset consumes it). A preset without\n  // the flag is serving-only by construction, so it needs no warning; with the flag we say so.\n  if (args.preset) {\n    // An inventory (`<thing> list`) lists paused entities on purpose: it is where ids to edit come from.\n    // A preset with no serving chain has nothing for --include-paused to widen.\n    const name = String(args.preset);\n    if (!args[\"include-paused\"] || isInventoryPreset(name) || !getPreset(name)?.statusFields?.length) return [];\n    return [\n      {\n        code: \"SERVING_SCOPE\",\n        message:\n          \"Paused entities are included (--include-paused). Only recommend changes for actually-serving entities (enabled campaign, ad group, and ad) unless the user asked about paused ones.\",\n      },\n    ];\n  }\n\n  // Raw GAQL: --include-paused is a no-op here, so don't claim paused rows were included. Warn\n  // only when the query targets a serving-hierarchy resource with no status filter in its WHERE\n  // (a status column in the SELECT list displays status but doesn't filter on it).\n  const upper = finalQuery.toUpperCase();\n  const fromMatch = upper.match(/\\bFROM\\s+([A-Z_]+)/);\n  const resource = fromMatch?.[1]?.toLowerCase();\n  const hierarchical = resource ? SERVING_HIERARCHY_RESOURCES.includes(resource) : false;\n  const where = whereClause(upper);\n  const filtersStatus = where.includes(\".STATUS\");\n  // Entities named by id are the ones asked for, paused or not.\n  const pinnedById = resource ? new RegExp(`\\\\b${resource.toUpperCase()}\\\\.ID\\\\s*(=|IN\\\\b)`).test(where) : false;\n  if (hierarchical && !filtersStatus && !pinnedById) {\n    return [\n      {\n        code: \"SERVING_SCOPE\",\n        message:\n          \"This query has no status filter, so it may return paused entities that aren't actually serving. Google Ads has no single serving flag — an entity serves only when its whole chain is ENABLED. Add campaign.status = 'ENABLED' AND ad_group.status = 'ENABLED' AND ad_group_ad.status = 'ENABLED' (as applicable), or use a --preset, unless you intend to include paused entities.\",\n      },\n    ];\n  }\n  return [];\n}\n\n// A performance preset Baker's synced copy also answers: say so, since that read has no rate limit.\nfunction syncedCopyWarnings(args: Record<string, unknown>): AdsWarning[] {\n  const hint = googlePresetSyncedHint(typeof args.preset === \"string\" ? args.preset : undefined);\n  return hint ? [{ code: \"SYNCED_COPY\", message: hint }] : [];\n}\n\n// Parse the SELECT list out of a GAQL statement. Case-insensitive, newline- and\n// whitespace-tolerant. Returns [] when the statement has no parseable SELECT ... FROM.\nexport function parseSelectedFields(gaql: string): string[] {\n  const match = gaql.match(/\\bSELECT\\b([\\s\\S]*?)\\bFROM\\b/i);\n  const list = match?.[1];\n  if (!list) return [];\n  return list\n    .split(\",\")\n    .map((field) => field.trim())\n    .filter((field) => /^[A-Za-z_][A-Za-z0-9_]*(\\.[A-Za-z0-9_]+)*$/.test(field));\n}\n\n// Which SELECTed fields appeared on NO returned row. Google Ads omits a field entirely from a\n// row when it has no value, so a key's absence is \"not observed\", never \"empty\" — and the union\n// across ALL rows is the only honest denominator (one arbitrary row proves nothing).\nfunction foldObservedFields(rows: Array<Record<string, unknown>>, observed: Set<string>): void {\n  for (const row of rows) {\n    for (const key of Object.keys(row)) observed.add(key);\n  }\n}\n\nexport function unobservedSelectedFields(gaql: string, rows: Array<Record<string, unknown>>): string[] {\n  const observed = new Set<string>();\n  foldObservedFields(rows, observed);\n  return unobservedFields(gaql, observed);\n}\n\n// Same verdict from a folded key set instead of the rows, so a read that streamed to disk can\n// still answer it.\nexport function unobservedFields(gaql: string, observed: Set<string>): string[] {\n  return parseSelectedFields(gaql).filter((field) => {\n    // The backend strips resource_name from every row, so it is never observable.\n    if (field.endsWith(\".resource_name\")) return false;\n    if (observed.has(field)) return false;\n    // A submessage selected as a whole is observed when any of its flattened leaves came back.\n    return ![...observed].some((key) => key.startsWith(`${field}.`));\n  });\n}\n\n// An absent field must never read as an empty one. Zero rows is a different, already-obvious\n// signal, so this only fires when the read actually returned data.\nexport function missingFieldWarnings(gaql: string, rows: Array<Record<string, unknown>>): AdsWarning[] {\n  const observed = new Set<string>();\n  foldObservedFields(rows, observed);\n  return missingFieldWarningsFor(gaql, observed, rows.length);\n}\n\nexport function missingFieldWarningsFor(gaql: string, observed: Set<string>, rowCount: number): AdsWarning[] {\n  if (rowCount === 0) return [];\n  const missing = unobservedFields(gaql, observed);\n  if (missing.length === 0) return [];\n  return [\n    {\n      code: \"MISSING_FIELDS\",\n      message: `These SELECTed fields came back on no row: ${missing.join(\", \")}. Google Ads omits a field entirely when it has no value, so this does NOT mean the setting is empty — it means this read didn't observe it. Check the level that owns the setting before concluding it is unset.`,\n    },\n  ];\n}\n\n// A CSV header is fixed on the first page and cannot grow a column later, so a submessage selected\n// whole whose leaves first appear on a later page has nowhere to land in the file. Those values are\n// lost, and MISSING_FIELDS cannot see it (the leaves WERE observed), so the loss is named here.\nexport function unwrittenColumnWarnings(header: string[], observed: Set<string>): AdsWarning[] {\n  const written = new Set(header);\n  const unwritten = [...observed].filter((key) => !written.has(key));\n  if (unwritten.length === 0) return [];\n  return [\n    {\n      code: \"UNWRITTEN_COLUMNS\",\n      message: `The file has no column for ${unwritten.join(\", \")}: the header was fixed on the first page, which carried none of them, so their values from later pages are NOT in the file. Do not read those columns as empty. SELECT these fields by name instead of their parent, or write to a .jsonl file, then re-run.`,\n    },\n  ];\n}\n\n// Google omits primary_status_reasons when a keyword has none, so the decoder can only tell\n// \"nothing to report\" from \"we never asked\" by looking at what the statement selected.\nexport function keywordServingOptions(gaql: string): KeywordServingOptions {\n  return { statusReasonsSelected: parseSelectedFields(gaql).includes(\"ad_group_criterion.primary_status_reasons\") };\n}\n\nasync function fetchAllPages(\n  gaql: string,\n  body: Record<string, unknown>,\n  args: Record<string, unknown>,\n  servingOptions: KeywordServingOptions,\n): Promise<{\n  allRows: Array<Record<string, unknown>>;\n  lastPageToken?: string;\n  totalRowsWritten: number;\n  rowsWithConversions: number;\n  keywordLimits: KeywordLimits;\n  observedFields: Set<string>;\n  fileColumns: string[];\n}> {\n  let allRows: Array<Record<string, unknown>> = [];\n  let pageToken: string | undefined = args.cursor as string | undefined;\n  let totalRowsWritten = 0;\n  // Folded page by page, since the --out path keeps no rows to count afterwards.\n  let rowsWithConversions = 0;\n  let keywordLimits: KeywordLimits | undefined;\n  const observedFields = new Set<string>();\n  // One header for the whole file: fixed on the first page, since a CSV cannot grow a column later.\n  let fileColumns: string[] | undefined;\n\n  do {\n    const requestBody: Record<string, unknown> = { ...body };\n    if (pageToken) requestBody.pageToken = pageToken;\n\n    const response = await apiPost<QueryApiResponse>(\"/api/ads/google/query\", requestBody);\n    const rows = response.rows ?? [];\n    pageToken = response.pageToken;\n    rowsWithConversions += countRowsWithConversions(rows);\n\n    if (args.out) {\n      const shouldAppend = (args.append as boolean) || totalRowsWritten > 0;\n      fileColumns ??= resultColumns(gaql, rows);\n      writeRowsToFile(resolve(args.out as string), rows, fileColumns, shouldAppend);\n      totalRowsWritten += rows.length;\n      // The rows are gone after this — fold their verdicts now or the file summary has nothing\n      // to say about the very pull this preset is sized for.\n      keywordLimits = collectKeywordLimits(rows, servingOptions, keywordLimits);\n      foldObservedFields(rows, observedFields);\n    } else {\n      allRows = allRows.concat(rows);\n    }\n\n    if (!args.all) break;\n  } while (pageToken);\n\n  return {\n    allRows,\n    lastPageToken: pageToken,\n    totalRowsWritten,\n    rowsWithConversions,\n    keywordLimits: keywordLimits ?? collectKeywordLimits([], servingOptions),\n    observedFields,\n    fileColumns: fileColumns ?? [],\n  };\n}\n\n/** One cached page: its rows and the cursor to the page after it, so a cache hit still says \"there is more\". */\ninterface CachedPage {\n  rows: Array<Record<string, unknown>>;\n  cursor?: string;\n}\n\n// A page is cached under the statement, its size and the cursor it starts at — any one of the three\n// changes which rows it holds. An --all read is many pages and never comes from (or goes to) this cache.\nexport function pageCacheKey(customerId: string, query: string, pageSize: number, cursor: string | undefined): string {\n  return buildQueryCacheKey(customerId, `${query}\\u0000page=${pageSize}\\u0000cursor=${cursor ?? \"\"}`);\n}\n\nasync function executeQuery(\n  finalQuery: string,\n  args: Record<string, unknown>,\n  customerId: string,\n  limit: number,\n  warnings: AdsWarning[],\n  useCache: boolean,\n  cacheKey: string,\n): Promise<void> {\n  const body: Record<string, unknown> = { customerId, query: finalQuery, pageSize: limit };\n  const managerId = getManagerIdForCustomer(customerId);\n  if (managerId) body.managerId = managerId;\n  if (!useCache) body.skipCache = true;\n\n  const servingOptions = keywordServingOptions(finalQuery);\n  const { allRows, lastPageToken, totalRowsWritten, rowsWithConversions, keywordLimits, observedFields, fileColumns } =\n    await fetchAllPages(finalQuery, body, args, servingOptions);\n  // A read that started after a cursor, or left a page unread, cannot speak for the rows it skipped.\n  const readWhole = !args.cursor && !lastPageToken;\n\n  if (args.out) {\n    const truncation = completenessWarnings({\n      rowCount: totalRowsWritten,\n      effectiveLimit: effectiveRowLimit(finalQuery),\n      hasMore: Boolean(lastPageToken),\n    });\n    const fileWarnings = [\n      ...warnings,\n      ...renderKeywordLimits(keywordLimits),\n      ...missingFieldWarningsFor(finalQuery, observedFields, totalRowsWritten),\n      // Only a CSV has a header to fall out of; json and jsonl files carry every row whole.\n      ...(isCsvPath(args.out as string) ? unwrittenColumnWarnings(fileColumns, observedFields) : []),\n      ...conversionMixWarnings(finalQuery, readWhole ? rowsWithConversions : undefined),\n      ...moneyUnitWarnings(parseSelectedFields(finalQuery)),\n      ...truncation,\n    ];\n    writeAdsJson(\n      buildFileSummary({\n        file: resolve(args.out as string),\n        rows: totalRowsWritten,\n        warnings: fileWarnings,\n        complete: truncation.length === 0,\n      }),\n    );\n    return;\n  }\n\n  if (useCache && !args.all && allRows.length > 0) {\n    const page: CachedPage = { rows: allRows, ...(lastPageToken ? { cursor: lastPageToken } : {}) };\n    cacheSet(\"queries\", cacheKey, page, getQueryTtl(finalQuery), getFieldDescriptions(extractFields(allRows)));\n  }\n  const fields = extractFields(allRows);\n  outputResults(\n    allRows,\n    getFieldDescriptions(fields),\n    [\n      ...warnings,\n      ...missingFieldWarnings(finalQuery, allRows),\n      ...keywordServingWarnings(allRows, servingOptions),\n      ...conversionMixWarnings(finalQuery, readWhole ? rowsWithConversions : undefined),\n      ...moneyUnitWarnings(resultColumns(finalQuery, allRows)),\n    ],\n    args,\n    false,\n    {\n      gaql: finalQuery,\n      effectiveLimit: effectiveRowLimit(finalQuery),\n      nextCursor: lastPageToken,\n    },\n  );\n}\n\n// A --out read must always produce the file. The --out branch never populates the cache, so a hit\n// there can only come from an earlier stdout read of the same statement — serving it would print\n// rows and leave the file stale or absent, which the next command reads as this pull.\nexport function shouldReadCache(args: Record<string, unknown>): boolean {\n  return !args[\"no-cache\"] && !args.out && !args.all;\n}\n\ninterface ValidatedArgs {\n  customerId: string;\n  limit: number;\n  finalQuery: string;\n  warnings: AdsWarning[];\n  useCache: boolean;\n  cacheKey: string;\n}\n\nconst DEFAULT_QUERY_LIMIT = 200;\n\n/**\n * `--limit` is the page size, and the server refuses a page above its cap. Checked here, before any\n * request, so an out-of-range value comes back as the input error it is — sent on, the server's\n * refusal reached the agent as an API_ERROR, indistinguishable from a Google failure.\n */\nexport function parseQueryLimit(\n  raw: unknown,\n  fallback = DEFAULT_QUERY_LIMIT,\n): { ok: true; limit: number } | { ok: false; error: AdsErrorEnvelope } {\n  if (raw === undefined || raw === null || raw === \"\") return { ok: true, limit: fallback };\n  const limit = Number(raw);\n  if (Number.isInteger(limit) && limit >= 1 && limit <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return { ok: true, limit };\n  return {\n    ok: false,\n    error: {\n      ok: false,\n      error: {\n        code: \"VALIDATION_ERROR\",\n        message: `--limit must be a whole number from 1 to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}, got '${String(raw)}'.`,\n        fix: {\n          action: \"retry_with_flag\",\n          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.`,\n        },\n        retryable: false,\n      },\n    },\n  };\n}\n\n/** The page size: --limit when given, else the preset's own page size, else 200. */\nexport function queryPageSize(args: Record<string, unknown>): ReturnType<typeof parseQueryLimit> {\n  const preset = typeof args.preset === \"string\" ? getPreset(args.preset) : undefined;\n  return parseQueryLimit(args.limit, preset?.defaultLimit ?? DEFAULT_QUERY_LIMIT);\n}\n\nasync function validateArgs(args: Record<string, unknown>): Promise<ValidatedArgs | null> {\n  const parsedLimit = queryPageSize(args);\n  if (!parsedLimit.ok) {\n    writeAdsJson(parsedLimit.error);\n    process.exit(1);\n  }\n  const { limit } = parsedLimit;\n  const customerId = await resolveCustomerId(args);\n\n  const gaql = resolveGaql(args);\n  if (!gaql) {\n    process.exit(1);\n  }\n\n  const preflight = validatePreflight(gaql, customerId);\n  if (!preflight.valid && preflight.error) {\n    writeAdsJson(preflight.error);\n    process.exit(1);\n  }\n\n  const finalQuery = preflight.correctedQuery ?? gaql;\n  return {\n    customerId,\n    limit,\n    finalQuery,\n    warnings: [...preflight.warnings, ...servingScopeWarnings(args, finalQuery), ...syncedCopyWarnings(args)],\n    useCache: !args[\"no-cache\"],\n    cacheKey: pageCacheKey(customerId, finalQuery, limit, args.cursor as string | undefined),\n  };\n}\n\nfunction handleQueryError(err: unknown, finalQuery: string, customerId: string): never {\n  if (err instanceof ApiError) {\n    const envelope = parseApiError(err.message, finalQuery, customerId, err.code);\n    envelope.error.gaqlExecuted = finalQuery;\n    writeAdsJson(envelope);\n    process.exit(1);\n  }\n  writeAdsJson({\n    ok: false,\n    error: {\n      code: \"NETWORK_ERROR\",\n      message: err instanceof Error ? err.message : \"Unexpected error\",\n      fix: { action: \"wait_and_retry\", explanation: \"Network error — check connectivity and retry\" },\n      retryable: true,\n      gaqlExecuted: finalQuery,\n    },\n  } satisfies AdsErrorEnvelope);\n  process.exit(1);\n}\n\n/**\n * One read, start to finish: validate, serve a cached page or fetch, then write the envelope. The\n * `query` command and every `<thing> list` command (which hand it a preset) run through here.\n */\nexport async function runQuery(args: Record<string, unknown>): Promise<void> {\n  const validated = await validateArgs(args);\n  if (!validated) return;\n  const { customerId, limit, finalQuery, warnings, useCache, cacheKey } = validated;\n\n  if (shouldReadCache(args)) {\n    const cached = cacheGet<CachedPage>(\"queries\", cacheKey);\n    if (cached && Array.isArray(cached.data.rows)) {\n      const rows = cached.data.rows;\n      outputResults(\n        rows,\n        cached.fields ?? getFieldDescriptions(extractFields(rows)),\n        [\n          ...warnings,\n          ...missingFieldWarnings(finalQuery, rows),\n          ...keywordServingWarnings(rows, keywordServingOptions(finalQuery)),\n          // A cached page is whole only when it starts at the first row and has no page after it.\n          ...conversionMixWarnings(\n            finalQuery,\n            args.cursor || cached.data.cursor ? undefined : countRowsWithConversions(rows),\n          ),\n          ...moneyUnitWarnings(resultColumns(finalQuery, rows)),\n        ],\n        args,\n        true,\n        { gaql: finalQuery, effectiveLimit: effectiveRowLimit(finalQuery), nextCursor: cached.data.cursor },\n      );\n      return;\n    }\n  }\n\n  try {\n    await executeQuery(finalQuery, args, customerId, limit, warnings, useCache, cacheKey);\n  } catch (err) {\n    handleQueryError(err, finalQuery, customerId);\n  }\n}\n\nexport const queryCommand = defineCommand({\n  meta: {\n    name: \"query\",\n    description: `Run GAQL against Google Ads, one page at a time. Supports raw GAQL, presets, paging, file export, and caching.\n\nStart here:\n  baker ads google query --list-presets\n  baker ads google query --preset campaign-performance --customer-id 1234567890\n\nEach read returns one page (--limit rows; the preset's page size by default, else 200). When the\naccount holds more, the envelope carries pagination.cursor: pass it with --cursor for the next page,\nor read everything with --all --out <file>. A LIMIT written in the GAQL caps the whole read.\n\nExamples:\n  baker ads google query \"SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS\" --customer-id 1234567890\n  baker ads google query --gaql \"SELECT ad_group.name FROM ad_group WHERE ad_group.status = 'ENABLED'\" --customer-id 1234567890\n  baker ads google query --preset search-terms --customer-id 1234567890 --date-range LAST_7_DAYS --all --out terms.csv\n  baker ads google query --preset keyword-serving --customer-id 1234567890 --cursor <pagination.cursor>`,\n  },\n  args: {\n    query: { type: \"positional\", description: \"GAQL SELECT statement\", required: false },\n    gaql: {\n      type: \"string\",\n      description: \"GAQL SELECT statement as a flag (instead of the positional)\",\n      required: false,\n    },\n    \"customer-id\": {\n      type: \"string\",\n      description: \"Google Ads customer ID (10 digits; dashes are fine)\",\n      required: false,\n    },\n    preset: { type: \"string\", description: \"Named query preset\", required: false },\n    \"date-range\": { type: \"string\", description: \"Date range override for presets\", required: false },\n    \"include-paused\": {\n      type: \"boolean\",\n      description: \"Include paused entities in preset results (default: serving entities only)\",\n      required: false,\n    },\n    limit: {\n      type: \"string\",\n      description: \"Rows per page (default: the preset's page size, else 200)\",\n      required: false,\n    },\n    \"list-presets\": { type: \"boolean\", description: \"List available presets\", required: false },\n    cursor: { type: \"string\", description: \"pagination.cursor from the previous page\", required: false },\n    all: { type: \"boolean\", description: \"Follow every page (use with --out for large reads)\", required: false },\n    out: { type: \"string\", description: \"File path for output\", required: false },\n    append: { type: \"boolean\", description: \"Append to file\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|jsonl|md\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n    full: { type: \"boolean\", description: \"Include the field description glossary\", required: false },\n  },\n  run: async ({ args }) => {\n    if (args[\"list-presets\"]) {\n      writeAdsJson({\n        ok: true,\n        data: PRESETS.map((p) => ({\n          name: p.name,\n          description: p.description,\n          defaultDateRange: p.defaultDateRange,\n          pageSize: p.defaultLimit,\n          servingOnly: (p.statusFields?.length ?? 0) > 0,\n          gaql: expandPreset(p, {}).query,\n        })),\n      });\n      return;\n    }\n\n    await runQuery(args);\n  },\n});\n","import type { AdsErrorEnvelope, AdsWarning, PreflightResult } from \"../types.ts\";\nimport { NO_OR_EXPLANATION } from \"./correction-table.ts\";\nimport { duringLiteralExplanation, equivalentBetween, isDuringLiteral } from \"./during-literals.ts\";\nimport { LIST_FIELDS, listFieldGuidance } from \"./list-fields.ts\";\nimport { SERVING_CHAINS } from \"./presets.ts\";\n\nfunction buildCommand(query: string, customerId: string): string {\n  return `baker ads google query \"${query}\" --customer-id ${customerId}`;\n}\n\n// A rung is also settled when the query pins that level to one named entity: the caller looked at\n// that level and chose it, which is a different act from sweeping it silently.\nconst RUNG_PIN_FIELDS: Record<string, string[]> = {\n  \"campaign.status\": [\"campaign.id\", \"campaign.resource_name\"],\n  \"ad_group.status\": [\"ad_group.id\", \"ad_group.resource_name\"],\n  \"ad_group_criterion.status\": [\"ad_group_criterion.criterion_id\", \"ad_group_criterion.resource_name\"],\n  \"ad_group_ad.status\": [\"ad_group_ad.ad.id\", \"ad_group_ad.resource_name\"],\n  \"asset_group.status\": [\"asset_group.id\", \"asset_group.resource_name\"],\n  \"asset_group_asset.status\": [\"asset_group_asset.resource_name\"],\n  \"campaign_asset.status\": [\"campaign_asset.resource_name\"],\n  \"ad_group_asset.status\": [\"ad_group_asset.resource_name\"],\n};\n\n// WHERE clause only — a status column in the SELECT list displays status, it does not scope the rows.\nfunction whereClause(query: string): string {\n  const match = query.match(/\\bWHERE\\b([\\s\\S]*)$/i);\n  if (!match?.[1]) return \"\";\n  let rest = match[1];\n  for (const trailing of [/\\bORDER\\s+BY\\b/i, /\\bLIMIT\\b/i, /\\bPARAMETERS\\b/i]) {\n    const idx = rest.search(trailing);\n    if (idx !== -1) rest = rest.slice(0, idx);\n  }\n  return rest;\n}\n\nfunction selectClause(query: string): string {\n  return query.split(/\\bFROM\\b/i)[0] ?? \"\";\n}\n\nfunction mentions(clause: string, field: string): boolean {\n  return new RegExp(`(?<![\\\\w.])${field.replace(/\\./g, \"\\\\.\")}\\\\b`, \"i\").test(clause);\n}\n\ninterface ChainAnalysis {\n  chain: string[];\n  /** Rungs the WHERE clause says nothing about — neither a status predicate nor an entity pin. */\n  unscoped: string[];\n  /** Rungs the WHERE clause pins to `= 'ENABLED'`, i.e. where the query claims \"this is live\". */\n  assertsServing: boolean;\n}\n\nfunction analyzeServingChain(query: string): ChainAnalysis | null {\n  const resource = fromResource(query);\n  const chain = resource ? SERVING_CHAINS[resource] : undefined;\n  if (!chain) return null;\n\n  const where = whereClause(query);\n\n  // A negative keyword never serves, so the serving chain is not a question anyone is asking of it.\n  if (/ad_group_criterion\\.negative\\s*=\\s*TRUE/i.test(where)) return null;\n\n  const unscoped = chain.filter((rung) => {\n    if (mentions(where, rung)) return false;\n    return !(RUNG_PIN_FIELDS[rung] ?? []).some((pin) => mentions(where, pin));\n  });\n  const assertsServing = chain.some((rung) =>\n    new RegExp(`${rung.replace(/\\./g, \"\\\\.\")}\\\\s*=\\\\s*'ENABLED'`, \"i\").test(where),\n  );\n\n  return { chain, unscoped, assertsServing };\n}\n\n/**\n * REJECT a half-asserted chain. A query that pins one rung to ENABLED and leaves another silent\n * returns rows that read as \"these are live\" and are not — the shape that reported 486 serving\n * keywords when the account had 53. There is no reading of \"enabled criteria in ad groups I did\n * not look at\" that anyone means, so this is refused rather than warned: a warning on this path is\n * dropped by `--output csv` and swallowed by `2>/dev/null`, and no data at all is the only signal\n * that survives.\n */\nfunction rejectPartialChain(query: string, customerId: string, analysis: ChainAnalysis): AdsErrorEnvelope | null {\n  if (!analysis.assertsServing || analysis.unscoped.length === 0) return null;\n\n  const added = analysis.unscoped.map((rung) => `${rung} = 'ENABLED'`).join(\" AND \");\n  // The rungs go into SELECT as well where the resource segments on them — on campaign_asset and\n  // ad_group_asset a filtered-but-unselected ancestor is refused outright, so a corrected command\n  // that only touched the WHERE clause was one the agent could not run either.\n  const fixed = addRequiredAncestorFields(query.replace(/\\bWHERE\\b/i, `WHERE ${added} AND`)).query;\n  return {\n    ok: false,\n    error: {\n      code: \"INCOMPLETE_STATUS_CHAIN\",\n      message: `This query filters on serving status but leaves ${analysis.unscoped.join(\", \")} unscoped. Google Ads has no single serving flag — a row is live only when its whole chain (${analysis.chain.join(\" → \")}) is ENABLED, so rows under a paused parent will come back looking live.`,\n      fix: {\n        action: \"retry_with_modified_query\",\n        correctedCommand: buildCommand(fixed, customerId),\n        explanation: `Add the missing rungs: ${added}. To look at paused entities on purpose, scope every rung explicitly instead (e.g. ${analysis.unscoped.map((rung) => `${rung} != 'REMOVED'`).join(\" AND \")}), or use --preset ... --include-paused.`,\n      },\n      retryable: false,\n    },\n  };\n}\n\n/**\n * ANNOTATE an unasserted chain. A sweep that claims nothing about serving is a legitimate read —\n * \"show me everything, paused included\" — so the rows are not changed. Every unscoped rung's status\n * column is added to SELECT instead, so the status travels with the data through a CSV, a `--out`\n * file and a `python3` pass. A banner does not survive that trip; a column name does.\n */\nfunction annotateUnscopedChain(query: string, analysis: ChainAnalysis): { query: string; warnings: AdsWarning[] } {\n  if (analysis.assertsServing || analysis.unscoped.length === 0) return { query, warnings: [] };\n\n  const select = selectClause(query);\n  const missing = analysis.unscoped.filter((rung) => !mentions(select, rung));\n  if (missing.length === 0) return { query, warnings: [] };\n\n  return {\n    query: query.replace(/SELECT\\s+/i, `SELECT ${missing.join(\", \")}, `),\n    warnings: [\n      {\n        code: \"SERVING_STATUS_ADDED\",\n        message: `Added ${missing.join(\", \")} to SELECT — this query does not scope ${analysis.unscoped.join(\", \")}, so it returns paused-parent rows that are not serving. Read those columns before calling any row live; filter every rung = 'ENABLED' to get serving rows only.`,\n      },\n    ],\n  };\n}\n\n// Resources that return exactly one row per account, so no LIMIT can truncate them and no row can be\n// set against another. SELECTing a segment (segments.date, segments.device …) fans one back out into\n// many rows; filtering on a date range in WHERE does not — Google sums the range into the one row,\n// which is exactly what the account-summary preset reads.\nconst SINGLE_ROW_RESOURCES = [\"customer\"];\n\n// The resource named in the FROM clause, lowercased. Newline- and case-tolerant; null when the\n// statement has no FROM.\nexport function fromResource(query: string): string | null {\n  const match = query.match(/\\bFROM\\s+([A-Za-z_][A-Za-z0-9_]*)/i);\n  return match?.[1]?.toLowerCase() ?? null;\n}\n\n// A statement that returns one row by construction — decided from the statement, never from the rows.\nexport function isSingleRowRead(query: string): boolean {\n  const resource = fromResource(query);\n  if (!resource || !SINGLE_ROW_RESOURCES.includes(resource)) return false;\n  return !/\\bsegments\\./i.test(selectClause(query));\n}\n\n// Resources whose ancestors SEGMENT them: one budget backs many campaigns, one asset is linked from\n// many campaigns/ad groups, so an ancestor field used in WHERE must appear in SELECT too or Google\n// refuses the whole statement with EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE. Verified live on v23:\n// FROM campaign/ad_group/ad_group_ad/ad_group_criterion/asset_group_asset filter their ancestors\n// freely; these three do not.\nconst SEGMENTING_ANCESTORS: Record<string, string[]> = {\n  campaign_budget: [\"campaign\"],\n  campaign_asset: [\"campaign\"],\n  ad_group_asset: [\"campaign\", \"ad_group\"],\n};\n\n/** The ancestor fields a query filters on but does not select — empty unless the resource segments. */\nfunction missingRequiredSelectFields(query: string): string[] {\n  const ancestors = SEGMENTING_ANCESTORS[fromResource(query) ?? \"\"];\n  if (!ancestors) return [];\n\n  const select = selectClause(query);\n  // Everything after WHERE, ORDER BY included — an ancestor field is just as referenced there.\n  const where = query.split(/\\bWHERE\\b/i)[1] ?? \"\";\n  const filtered = ancestors.flatMap(\n    (ancestor) => where.match(new RegExp(`(?<![\\\\w.])${ancestor}\\\\.[\\\\w.]+`, \"g\")) ?? [],\n  );\n  return [...new Set(filtered)].filter((field) => !mentions(select, field));\n}\n\nfunction addRequiredAncestorFields(query: string): { query: string; warnings: AdsWarning[] } {\n  const missing = missingRequiredSelectFields(query);\n  if (missing.length === 0) return { query, warnings: [] };\n\n  return {\n    query: query.replace(/SELECT\\s+/i, `SELECT ${missing.join(\", \")}, `),\n    warnings: [\n      {\n        code: \"REQUIRED_FIELD_ADDED\",\n        message: `Added ${missing.join(\", \")} to SELECT — ${fromResource(query)} queries must select the ancestor fields used in WHERE`,\n      },\n    ],\n  };\n}\n\nfunction applyAutoFixes(query: string): { query: string; warnings: AdsWarning[] } {\n  let corrected = query;\n  const warnings: AdsWarning[] = [];\n\n  // bare keyword.text → ad_group_criterion.keyword.text\n  // Lookbehind skips fields already scoped to a resource (shared_criterion.keyword.text,\n  // campaign_criterion.keyword.text, ad_group_criterion.keyword.text) so they pass through untouched.\n  if (/(?<![\\w.])keyword\\.text\\b/.test(corrected)) {\n    corrected = corrected.replace(/(?<![\\w.])keyword\\.text\\b/g, \"ad_group_criterion.keyword.text\");\n    warnings.push({ code: \"FIELD_RENAMED\", message: \"keyword.text → ad_group_criterion.keyword.text\" });\n  }\n\n  // bare keyword.match_type → ad_group_criterion.keyword.match_type\n  if (/(?<![\\w.])keyword\\.match_type\\b/.test(corrected)) {\n    corrected = corrected.replace(/(?<![\\w.])keyword\\.match_type\\b/g, \"ad_group_criterion.keyword.match_type\");\n    warnings.push({ code: \"FIELD_RENAMED\", message: \"keyword.match_type → ad_group_criterion.keyword.match_type\" });\n  }\n\n  // shopping_performance_view.product_* → segments.product_*\n  if (/shopping_performance_view\\.product_\\w+/.test(corrected)) {\n    corrected = corrected.replace(/shopping_performance_view\\.product_(\\w+)/g, \"segments.product_$1\");\n    warnings.push({ code: \"FIELD_RENAMED\", message: \"shopping_performance_view.product_* → segments.product_*\" });\n  }\n\n  // asset.<type>_asset.final_urls → asset.final_urls (final URLs live on the asset itself;\n  // the typed sub-message only carries type-specific fields like link_text/descriptions)\n  if (/asset\\.\\w+_asset\\.final_(mobile_)?urls\\b/.test(corrected)) {\n    corrected = corrected.replace(/asset\\.\\w+_asset\\.final_(mobile_)?urls\\b/g, \"asset.final_$1urls\");\n    warnings.push({ code: \"FIELD_RENAMED\", message: \"asset.<type>_asset.final_urls → asset.final_urls\" });\n  }\n\n  const ancestorFix = addRequiredAncestorFields(corrected);\n  corrected = ancestorFix.query;\n  warnings.push(...ancestorFix.warnings);\n\n  // campaign.status = 'ACTIVE' → 'ENABLED'\n  if (/campaign\\.status\\s*=\\s*'ACTIVE'/i.test(corrected)) {\n    corrected = corrected.replace(/campaign\\.status\\s*=\\s*'ACTIVE'/gi, \"campaign.status = 'ENABLED'\");\n    warnings.push({ code: \"ENUM_CORRECTED\", message: \"campaign.status ACTIVE → ENABLED\" });\n  }\n\n  // ad_group.status = 'ACTIVE' → 'ENABLED'\n  if (/ad_group\\.status\\s*=\\s*'ACTIVE'/i.test(corrected)) {\n    corrected = corrected.replace(/ad_group\\.status\\s*=\\s*'ACTIVE'/gi, \"ad_group.status = 'ENABLED'\");\n    warnings.push({ code: \"ENUM_CORRECTED\", message: \"ad_group.status ACTIVE → ENABLED\" });\n  }\n\n  return { query: corrected, warnings };\n}\n\nconst DURING_CLAUSE = /(?<=[a-z_]\\.[a-z_.]+\\s+)DURING\\s+([A-Za-z0-9_]+)/gi;\n\n/**\n * REJECT a DURING literal outside Google's set (LAST_90_DAYS, LAST_12_MONTHS …). Google refuses the\n * whole statement, so it is refused here with the same window spelled as a BETWEEN range.\n */\nfunction rejectUnsupportedDuring(query: string, customerId: string): AdsErrorEnvelope | null {\n  const unsupported = [...query.matchAll(DURING_CLAUSE)]\n    .map((match) => match[1] ?? \"\")\n    .filter((literal) => !isDuringLiteral(literal));\n  const literal = unsupported[0];\n  if (literal === undefined) return null;\n  const now = new Date();\n  const between = equivalentBetween(literal, now);\n  // Every unsupported clause is rewritten, so the corrected command runs as-is; one with no fixed\n  // window leaves nothing runnable to offer.\n  const fixed = unsupported.every((l) => equivalentBetween(l, now) !== null)\n    ? query.replace(DURING_CLAUSE, (clause, l: string) =>\n        isDuringLiteral(l) ? clause : (equivalentBetween(l, now) ?? clause),\n      )\n    : undefined;\n  return {\n    ok: false,\n    error: {\n      code: \"INVALID_DATE_RANGE\",\n      message: `DURING ${literal} is not a Google Ads date range, so Google would refuse this query.`,\n      fix: {\n        action: \"narrow_date_range\",\n        ...(fixed ? { correctedCommand: buildCommand(fixed, customerId) } : {}),\n        explanation: duringLiteralExplanation(literal, between),\n      },\n      retryable: false,\n    },\n  };\n}\n\nconst WHERE_OPERATOR =\n  /(?<![\\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;\n\nfunction escapeRegExp(text: string): string {\n  return text.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\n/** The statement without one null test on `field`, with `field` kept in SELECT so the rows still carry it. */\nfunction withoutNullTest(query: string, field: string): string {\n  const test = `${escapeRegExp(field)}\\\\s+IS\\\\s+(?:NOT\\\\s+)?NULL\\\\b`;\n  const dropped = query\n    .replace(new RegExp(`\\\\bWHERE\\\\s+${test}\\\\s+AND\\\\s+`, \"i\"), \"WHERE \")\n    .replace(new RegExp(`\\\\s+AND\\\\s+${test}`, \"i\"), \"\")\n    .replace(new RegExp(`\\\\s*\\\\bWHERE\\\\s+${test}`, \"i\"), \"\");\n  return mentions(selectClause(dropped), field) ? dropped : dropped.replace(/SELECT\\s+/i, `SELECT ${field}, `);\n}\n\n/** `field = 'x'` / `IN (…)` as CONTAINS ANY, `!=` / `NOT IN` as CONTAINS NONE — null when there is no list equivalent. */\nfunction asListCondition(query: string, field: string): string | null {\n  const condition = new RegExp(\n    `(?<![\\\\w.])${escapeRegExp(field)}\\\\s*(NOT\\\\s+IN\\\\b|IN\\\\b|!=|=)\\\\s*('[^']*'|\\\\([^)]*\\\\))`,\n    \"i\",\n  );\n  const match = query.match(condition);\n  if (!match) return null;\n  const [, operator = \"\", value = \"\"] = match;\n  const contains = /^(=|IN)$/i.test(operator.trim()) ? \"CONTAINS ANY\" : \"CONTAINS NONE\";\n  const values = value.startsWith(\"(\") ? value : `(${value})`;\n  return query.replace(condition, `${field} ${contains} ${values}`);\n}\n\n/**\n * REJECT an operator a list field does not take. Google filters a list field only with CONTAINS\n * ALL/ANY/NONE and refuses the whole statement otherwise. The corrected read rewrites =/IN/!=/NOT IN\n * to CONTAINS, and drops a null test — which has no list equivalent — keeping the field in SELECT for\n * the caller to filter. LIKE and the rest have no rewrite, so they get the explanation alone.\n */\nfunction rejectListFieldOperator(query: string, customerId: string): AdsErrorEnvelope | null {\n  const where = whereClause(query).replace(/'(?:\\\\.|[^'\\\\])*'|\"(?:\\\\.|[^\"\\\\])*\"/g, \"''\");\n  const refusals = [...where.matchAll(WHERE_OPERATOR)]\n    .map(([, field = \"\", operator = \"\"]) => ({\n      field: field.toLowerCase(),\n      operator: operator.toUpperCase().replace(/\\s+/g, \" \"),\n    }))\n    .filter(({ field, operator }) => LIST_FIELDS.has(field) && !operator.startsWith(\"CONTAINS\"));\n  const first = refusals[0];\n  if (!first) return null;\n  const fixed = refusals.reduce<string | null>(\n    (corrected, { field, operator }) =>\n      corrected === null\n        ? null\n        : operator.startsWith(\"IS \")\n          ? withoutNullTest(corrected, field)\n          : asListCondition(corrected, field),\n    query,\n  );\n  return {\n    ok: false,\n    error: {\n      code: \"INVALID_OPERATOR\",\n      message: `${first.operator} cannot be used on ${first.field}: it is a list field, so Google would refuse this query.`,\n      fix: {\n        action: \"change_operator\",\n        ...(fixed ? { correctedCommand: buildCommand(fixed, customerId) } : {}),\n        explanation: listFieldGuidance(first.field),\n      },\n      retryable: false,\n    },\n  };\n}\n\n/** REJECT the function form CONTAINS(field, 'x'), which GAQL does not have — LIKE is the substring match. */\nfunction rejectContainsCall(query: string, customerId: string): AdsErrorEnvelope | null {\n  const containsMatch = query.match(/CONTAINS\\s*\\(\\s*([^,]+),\\s*'([^']+)'\\s*\\)/i);\n  if (!containsMatch) return null;\n  const field = containsMatch[1]?.trim();\n  const value = containsMatch[2] ?? \"\";\n  const fixed = query.replace(/CONTAINS\\s*\\(\\s*[^,]+,\\s*'[^']+'\\s*\\)/i, `${field} LIKE '%${value}%'`);\n  return {\n    ok: false,\n    error: {\n      code: \"INVALID_OPERATOR\",\n      message: \"GAQL does not support CONTAINS. Use LIKE with % wildcards.\",\n      fix: {\n        action: \"change_operator\",\n        correctedCommand: buildCommand(fixed, customerId),\n        explanation: \"GAQL uses LIKE '%value%' for substring matching, not CONTAINS()\",\n      },\n      retryable: false,\n    },\n  };\n}\n\n/**\n * REJECT an OR, or a parenthesised group of conditions, in WHERE. GAQL joins conditions with AND\n * only and Google refuses either shape, naming the token it choked on but not why. Quoted values\n * (single or double quotes, escapes included) are blanked first, and a parenthesis after IN / CONTAINS ANY|ALL|NONE is a value list, not a group.\n */\nfunction rejectOrCondition(query: string): AdsErrorEnvelope | null {\n  const where = whereClause(query).replace(/'(?:\\\\.|[^'\\\\])*'|\"(?:\\\\.|[^\"\\\\])*\"/g, \"''\");\n  const hasOr = /(?<![\\w.])OR(?![\\w.])/i.test(where);\n  const hasGroup = /(?:^|\\bAND|\\bNOT)\\s*\\(/i.test(where);\n  if (!hasOr && !hasGroup) return null;\n  return {\n    ok: false,\n    error: {\n      code: \"INVALID_SYNTAX\",\n      message: `${hasOr ? \"OR\" : \"A parenthesised condition\"} in WHERE: Google would refuse this query.`,\n      fix: { action: \"retry_with_modified_query\", explanation: NO_OR_EXPLANATION },\n      retryable: false,\n    },\n  };\n}\n\nexport function validatePreflight(query: string, customerId: string): PreflightResult {\n  const warnings: AdsWarning[] = [];\n  const corrected = query;\n\n  // REJECT: Non-SELECT queries\n  const firstWord = corrected.trim().split(/\\s+/)[0]?.toUpperCase();\n  if (firstWord && firstWord !== \"SELECT\") {\n    return {\n      valid: false,\n      warnings: [],\n      error: {\n        ok: false,\n        error: {\n          code: \"READ_ONLY\",\n          message: `Only SELECT queries are allowed. Got: ${firstWord}`,\n          fix: {\n            action: \"reject\",\n            explanation: \"This CLI only supports GAQL SELECT queries for reading data\",\n          },\n          retryable: false,\n        },\n      },\n    };\n  }\n\n  // REJECT: Open-ended date range\n  const openDateMatch = corrected.match(/segments\\.date\\s*>=\\s*'(\\d{4}-\\d{2}-\\d{2})'/i);\n  if (openDateMatch && !/BETWEEN/i.test(corrected)) {\n    const startDate = openDateMatch[1] ?? \"\";\n    const today = new Date().toISOString().slice(0, 10);\n    const fixed = corrected.replace(\n      /segments\\.date\\s*>=\\s*'(\\d{4}-\\d{2}-\\d{2})'/i,\n      `segments.date BETWEEN '${startDate}' AND '${today}'`,\n    );\n    return {\n      valid: false,\n      warnings: [],\n      error: {\n        ok: false,\n        error: {\n          code: \"OPEN_ENDED_DATE\",\n          message: \"Open-ended date ranges are not supported. Use BETWEEN or DURING.\",\n          fix: {\n            action: \"narrow_date_range\",\n            correctedCommand: buildCommand(fixed, customerId),\n            explanation: \"Use BETWEEN with explicit start and end dates\",\n          },\n          retryable: false,\n        },\n      },\n    };\n  }\n\n  for (const reject of [rejectContainsCall, rejectOrCondition, rejectListFieldOperator, rejectUnsupportedDuring]) {\n    const rejection = reject(corrected, customerId);\n    if (rejection) return { valid: false, warnings: [], error: rejection };\n  }\n\n  // REJECT: conversion action segments are incompatible with cost metrics in GAQL.\n  // Split conversion-action breakdowns from spend/cost queries and join by campaign in report code.\n  if (/\\bsegments\\.conversion_action_name\\b/i.test(corrected) && /\\bmetrics\\.cost_micros\\b/i.test(corrected)) {\n    return {\n      valid: false,\n      warnings: [],\n      error: {\n        ok: false,\n        error: {\n          code: \"INCOMPATIBLE_FIELDS\",\n          message: \"segments.conversion_action_name cannot be selected with metrics.cost_micros in one GAQL query.\",\n          fix: {\n            action: \"split_query\",\n            explanation:\n              \"Run one campaign spend query with metrics.cost_micros and a separate conversion-action query without cost metrics, then join the results by campaign.\",\n          },\n          retryable: false,\n        },\n      },\n    };\n  }\n\n  // WARN: ad_group_criterion without negative field — positives and negatives will be mixed\n  if (/FROM\\s+ad_group_criterion\\b/i.test(corrected) && !/ad_group_criterion\\.negative/i.test(corrected)) {\n    warnings.push({\n      code: \"NEGATIVE_FIELD_MISSING\",\n      message:\n        \"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.\",\n    });\n  }\n\n  const { query: autoFixed, warnings: autoFixWarnings } = applyAutoFixes(corrected);\n  warnings.push(...autoFixWarnings);\n\n  // Runs last, on the auto-fixed query, so ACTIVE → ENABLED is already normalised into the chain.\n  const analysis = analyzeServingChain(autoFixed);\n  if (!analysis) return { valid: true, correctedQuery: autoFixed, warnings };\n\n  const rejection = rejectPartialChain(autoFixed, customerId, analysis);\n  if (rejection) return { valid: false, warnings: [], error: rejection };\n\n  const annotated = annotateUnscopedChain(autoFixed, analysis);\n  warnings.push(...annotated.warnings);\n\n  return { valid: true, correctedQuery: annotated.query, warnings };\n}\n","/**\n * Refusing to let one `metrics.conversions` column stand for several different events.\n *\n * `metrics.conversions` is not a metric, it is a sum: each campaign contributes whatever conversion\n * actions the account has marked primary for it, and in a real account those differ campaign by\n * campaign — a webinar registration here, a form fill there, a CRM-stage SQL somewhere else. So a\n * total across campaigns adds events that are not the same event, and a conversion rate from one\n * campaign is not comparable with another's.\n *\n * This was learned on a report that put \"our landings 4,6 % CVR vs theirs 3,2 %\" in front of the\n * client. The two sides were different campaign types counting different actions; the client caught\n * it, and the comparison had to be withdrawn. The read that produced it looked completely ordinary:\n * one `landing_page_view` pull with `metrics.conversions` and no campaign filter.\n *\n * The statement decides whether a read can blend actions at all. The rows can only clear it, and only\n * a read that started at the first page and reached the last: fewer than two converting rows leave\n * nothing to total. A read that skipped rows, or left some unread, is judged on the statement alone.\n */\n\nimport type { AdsWarning } from \"../types.ts\";\nimport { isSingleRowRead } from \"./preflight.ts\";\n\n/** Metrics whose value is a sum, or a rate, over whichever conversion actions each campaign counts. */\nconst CONVERSION_METRICS = [\n  \"METRICS.CONVERSIONS\",\n  \"METRICS.ALL_CONVERSIONS\",\n  \"METRICS.CONVERSIONS_VALUE\",\n  \"METRICS.ALL_CONVERSIONS_VALUE\",\n  \"METRICS.COST_PER_CONVERSION\",\n  \"METRICS.COST_PER_ALL_CONVERSIONS\",\n  \"METRICS.CONVERSIONS_FROM_INTERACTIONS_RATE\",\n  \"METRICS.ALL_CONVERSIONS_FROM_INTERACTIONS_RATE\",\n  \"METRICS.VALUE_PER_CONVERSION\",\n  \"METRICS.VALUE_PER_ALL_CONVERSIONS\",\n];\n\n/** Segments that split the metric back into one row per action, which is what makes it readable. */\nconst CONVERSION_SEGMENTS = [\"SEGMENTS.CONVERSION_ACTION_NAME\", \"SEGMENTS.CONVERSION_ACTION=\"];\n\n/** A campaign identity pinned by an equality predicate — the one shape that confines a read. */\nconst CAMPAIGN_EQUALITY = /\\bCAMPAIGN\\.(ID|NAME|RESOURCE_NAME)\\s*=/;\n\n// Everything between WHERE and the first trailing clause. A campaign column in the SELECT list\n// names a dimension the rows are broken down by; only a predicate confines the read to one.\nfunction whereClause(upperQuery: string): string {\n  const whereIdx = upperQuery.indexOf(\" WHERE \");\n  if (whereIdx === -1) return \"\";\n  let rest = upperQuery.slice(whereIdx + 7);\n  for (const trailing of [\" ORDER BY \", \" GROUP BY \", \" LIMIT \", \" PARAMETERS \"]) {\n    const idx = rest.indexOf(trailing);\n    if (idx !== -1) rest = rest.slice(0, idx);\n  }\n  return rest;\n}\n\n// The same prefix the statement check matches by, so `metrics.conversions_by_conversion_date` and\n// `metrics.conversions_value_per_cost` count on a row exactly as they do in the SELECT.\nfunction isConversionMetric(field: string): boolean {\n  const upper = field.toUpperCase();\n  return CONVERSION_METRICS.some((metric) => upper.startsWith(metric));\n}\n\n// Google omits a zero metric, so an absent key counts as no conversions.\nexport function countRowsWithConversions(rows: Array<Record<string, unknown>>): number {\n  return rows.filter((row) =>\n    Object.entries(row).some(\n      ([field, value]) => isConversionMetric(field) && value !== undefined && value !== null && Number(value) !== 0,\n    ),\n  ).length;\n}\n\n/**\n * `rowsWithConversions`, only for a read that started at the first page and reached the last: fewer\n * than two leave nothing to total or set side by side. Any other read is judged on the statement.\n */\nexport function conversionMixWarnings(finalQuery: string, rowsWithConversions?: number): AdsWarning[] {\n  const upper = ` ${finalQuery.toUpperCase().replace(/\\s+/g, \" \")} `;\n  const readsConversions = CONVERSION_METRICS.some((metric) => upper.includes(metric));\n  if (!readsConversions) return [];\n  if (CONVERSION_SEGMENTS.some((segment) => upper.includes(segment))) return [];\n  if (CAMPAIGN_EQUALITY.test(whereClause(upper))) return [];\n  // One account-wide row carries no campaign to total across or set beside another.\n  if (isSingleRowRead(finalQuery)) return [];\n  if (rowsWithConversions !== undefined && rowsWithConversions < 2) return [];\n\n  return [\n    {\n      code: \"CONVERSION_MIX\",\n      message:\n        \"MIXED CONVERSION ACTIONS — this read covers more than one campaign, and a campaign's conversion figures count whatever conversion actions are primary for it. Those differ campaign by campaign (a webinar registration, an info request, a CRM-stage SQL), so a total across these rows adds different events and a conversion rate from one campaign is not comparable with another's. Before totalling or comparing, re-run segmented by segments.conversion_action_name and check the campaigns you are putting side by side count the same action. If they do not, compare only within one action — and carry that caveat into anything you write for the user, not just the analysis.\",\n    },\n  ];\n}\n","import type { AdsWarning } from \"../types.ts\";\n\n// Google Ads' UI renders \"Eligible (Limited) — Below first page bid (€3.63)\" from three separate\n// API fields: ad_group_criterion.primary_status_reasons, position_estimates.first_page_cpc_micros\n// and effective_cpc_bid_micros. Read raw, that is an enum name and two micro-integers — this\n// module turns them back into the sentence the column was showing, plus what fixes it.\n\nconst BELOW_FIRST_PAGE_BID = \"AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID\";\n\n// Reasons the keyword itself can act on. The parent-chain ones (CAMPAIGN_PAUSED, AD_GROUP_PAUSED,\n// AD_GROUP_CRITERION_PAUSED/REMOVED, …) restate a status the row already carries, so they are left\n// out rather than reported as a finding.\nconst ACTIONABLE_REASONS: Record<string, { label: string; advice: string }> = {\n  [BELOW_FIRST_PAGE_BID]: {\n    label: \"Below first page bid\",\n    advice:\n      \"raise the max CPC (keywords update --cpc-bid) to at least the first-page estimate, or move the ad group onto a smart bidding strategy that sets the bid itself\",\n  },\n  AD_GROUP_CRITERION_LOW_QUALITY: {\n    label: \"Low quality score\",\n    advice:\n      \"a bid raise does not lift quality — tighten ad relevance to the keyword and the landing page it points at (ad_group_criterion.quality_info.* breaks the score into its three parts)\",\n  },\n  AD_GROUP_CRITERION_RARELY_SERVED: {\n    label: \"Rarely served\",\n    advice: \"too few people search this term — broaden the match type or drop it, don't bid it up\",\n  },\n  AD_GROUP_CRITERION_DISAPPROVED: {\n    label: \"Disapproved\",\n    advice: \"select ad_group_criterion.disapproval_reasons to see which policy blocked it\",\n  },\n  AD_GROUP_CRITERION_RESTRICTED: {\n    label: \"Restricted\",\n    advice: \"policy limits where and to whom this keyword may show\",\n  },\n  AD_GROUP_CRITERION_UNDER_REVIEW: {\n    label: \"Under review\",\n    advice: \"waiting on Google's review — nothing to change yet\",\n  },\n  AD_GROUP_CRITERION_PENDING_REVIEW: {\n    label: \"Pending review\",\n    advice: \"waiting on Google's review — nothing to change yet\",\n  },\n  AD_GROUP_CRITERION_PAUSED_DUE_TO_LOW_ACTIVITY: {\n    label: \"Auto-paused for low activity\",\n    advice: \"Google paused it after prolonged low serving — resume it only alongside a change that gives it traffic\",\n  },\n};\n\nconst REASON_ORDER = Object.keys(ACTIONABLE_REASONS);\nconst MAX_NAMED_KEYWORDS = 5;\n\n// Google's REST transport serialises int64 as a JSON string, so a micros field arrives as\n// \"3630000\" from the API and as 3630000 from a hand-built fixture. Both have to read the same.\nfunction toMicros(value: unknown): number | null {\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"string\" && value.trim() !== \"\" && Number.isFinite(Number(value))) return Number(value);\n  return null;\n}\n\nfunction formatMoney(micros: number): string {\n  return (micros / 1_000_000).toFixed(2);\n}\n\n// A keyword's criterion id is derived from its text + match type, so the same id and the same text\n// repeat in every ad group holding that keyword. Naming a copy without its ad group makes the\n// copies indistinguishable — and identical enough to be silently deduped out of the count.\nfunction keywordLabel(row: Record<string, unknown>): string {\n  const text = row[\"ad_group_criterion.keyword.text\"];\n  const id = row[\"ad_group_criterion.criterion_id\"];\n  const name = typeof text === \"string\" && text !== \"\" ? text : id == null ? \"(unnamed keyword)\" : `criterion ${id}`;\n  const adGroup = row[\"ad_group.name\"];\n  return typeof adGroup === \"string\" && adGroup !== \"\" ? `${name} (ad group ${adGroup})` : name;\n}\n\n// What makes two rows the same keyword for counting. The ad group is half the identity, so it is\n// part of the key whenever the read selected it.\nfunction keywordKey(row: Record<string, unknown>): string {\n  const adGroup = row[\"ad_group.id\"] ?? row[\"ad_group.name\"] ?? \"\";\n  const criterion = row[\"ad_group_criterion.criterion_id\"] ?? row[\"ad_group_criterion.keyword.text\"] ?? \"\";\n  return `${String(adGroup)}~${String(criterion)}` === \"~\" ? keywordLabel(row) : `${adGroup}~${criterion}`;\n}\n\nfunction reasonsOn(row: Record<string, unknown>): string[] | null {\n  const raw = row[\"ad_group_criterion.primary_status_reasons\"];\n  if (!Array.isArray(raw)) return null;\n  return raw.filter((r): r is string => typeof r === \"string\");\n}\n\n// The bid gap the API states outright, for reads that selected the estimates without the status.\nfunction bidShortfall(row: Record<string, unknown>): string | null {\n  const bid = toMicros(row[\"ad_group_criterion.effective_cpc_bid_micros\"] ?? row[\"ad_group_criterion.cpc_bid_micros\"]);\n  const firstPage = toMicros(row[\"ad_group_criterion.position_estimates.first_page_cpc_micros\"]);\n  if (bid == null || firstPage == null || bid >= firstPage) return null;\n  return `bids ${formatMoney(bid)} against a ${formatMoney(firstPage)} first-page estimate`;\n}\n\n// The limits one row reports, each already phrased with the keyword it belongs to.\n//\n// Google omits primary_status_reasons entirely when a keyword has none, so an absent key means\n// two different things: \"nothing to report\" if the read selected the field, \"we never asked\" if it\n// didn't. Only the query knows which, hence statusReasonsSelected — without it, every healthy\n// keyword bidding under a stale estimate gets reported as starved.\nfunction limitsOn(\n  row: Record<string, unknown>,\n  options: KeywordServingOptions,\n): Array<{ reason: string; detail: string }> {\n  const reasons = reasonsOn(row);\n  const shortfall = bidShortfall(row);\n  const label = keywordLabel(row);\n\n  const applicable = reasons\n    ? reasons.filter((reason) => reason in ACTIONABLE_REASONS)\n    : options.statusReasonsSelected || shortfall === null\n      ? []\n      : [BELOW_FIRST_PAGE_BID];\n\n  return applicable.map((reason) => ({\n    reason,\n    detail: reason === BELOW_FIRST_PAGE_BID && shortfall ? `\"${label}\" ${shortfall}` : `\"${label}\"`,\n  }));\n}\n\nfunction describeLimit(reason: string, details: string[]): string {\n  const named = details.slice(0, MAX_NAMED_KEYWORDS).join(\"; \");\n  const rest = details.length > MAX_NAMED_KEYWORDS ? ` (+${details.length - MAX_NAMED_KEYWORDS} more)` : \"\";\n  const { label, advice } = ACTIONABLE_REASONS[reason] as { label: string; advice: string };\n  return `${label} — ${details.length}: ${named}${rest}. Fix: ${advice}.`;\n}\n\nexport interface KeywordServingOptions {\n  /** Whether the executed query selected ad_group_criterion.primary_status_reasons. */\n  statusReasonsSelected: boolean;\n}\n\n/** Limits found so far: the details to quote per reason, and which keywords they belong to. */\nexport interface KeywordLimits {\n  detailsByReason: Map<string, string[]>;\n  keywords: Set<string>;\n}\n\n/**\n * Fold one page of rows into the running limits. `--out` streams each page to disk and keeps no\n * rows, so the tally has to survive between pages rather than be recomputed at the end.\n */\nexport function collectKeywordLimits(\n  rows: Array<Record<string, unknown>>,\n  options: KeywordServingOptions,\n  acc: KeywordLimits = { detailsByReason: new Map(), keywords: new Set() },\n): KeywordLimits {\n  for (const row of rows) {\n    const limits = limitsOn(row, options);\n    if (limits.length === 0) continue;\n    // Counted once per keyword, however many reasons it carries — Google reports below-first-page-\n    // bid and low-quality together on the same keyword all the time.\n    acc.keywords.add(keywordKey(row));\n    for (const { reason, detail } of limits) {\n      const bucket = acc.detailsByReason.get(reason);\n      if (bucket) bucket.push(detail);\n      else acc.detailsByReason.set(reason, [detail]);\n    }\n  }\n  return acc;\n}\n\n/** Render accumulated limits as the single warning the agent reads. Empty when nothing is limited. */\nexport function renderKeywordLimits(limits: KeywordLimits): AdsWarning[] {\n  if (limits.detailsByReason.size === 0) return [];\n\n  const sentences = REASON_ORDER.filter((reason) => limits.detailsByReason.has(reason)).map((reason) =>\n    describeLimit(reason, limits.detailsByReason.get(reason) ?? []),\n  );\n  const count = limits.keywords.size;\n\n  return [\n    {\n      code: \"KEYWORD_SERVING_LIMITED\",\n      message: `${count} ${count === 1 ? \"keyword is\" : \"keywords are\"} limited and not getting the traffic they could. ${sentences.join(\" \")} Amounts are in the account currency (baker ads google currency).`,\n    },\n  ];\n}\n\n/**\n * Turn the serving signals on a keyword read into one warning naming what is limited and what\n * fixes it. Silent when the rows carry no serving signal, or when every limit is just a paused\n * parent — a row that already says PAUSED needs no second telling.\n */\nexport function keywordServingWarnings(\n  rows: Array<Record<string, unknown>>,\n  options: KeywordServingOptions,\n): AdsWarning[] {\n  return renderKeywordLimits(collectKeywordLimits(rows, options));\n}\n","/**\n * Google Ads reads keep money in micros (millionths of the account currency),\n * exactly as GAQL returns it, while every money flag (`--amount`, `--cpc-bid`,\n * `--target-cpa`, …) takes whole currency. An amount copied from one into the\n * other is a millionfold raise, so a read that carries a budget, bid or target\n * says so once, next to the rows.\n *\n * Only the settings a flag is set from count: cost metrics are read, not copied\n * into a write, and saying it on every performance read would teach the agent to\n * skip warnings. `*_fraction_micros` is a share, not money.\n */\n\nimport type { AdsWarning } from \"../types.ts\";\n\nfunction isSettingMicros(field: string): boolean {\n  return field.endsWith(\"_micros\") && !field.startsWith(\"metrics.\") && !field.endsWith(\"_fraction_micros\");\n}\n\nexport function moneyUnitWarnings(fields: readonly string[]): AdsWarning[] {\n  const example = fields.find(isSettingMicros);\n  if (!example) return [];\n  return [\n    {\n      code: \"MONEY_IN_MICROS\",\n      message:\n        `Budgets and bids in these rows are in micros, millionths of the account currency: ${example} 20000000 is 20. ` +\n        \"Write flags (--amount, --cpc-bid, --max-cpc, --target-cpa, --target-cpc) take whole currency: --amount 20, never the micros.\",\n    },\n  ];\n}\n"],"mappings":"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","names":["literal","rejection","whereClause","whereClause"]}

package/dist/chunk-QY6GNZFH.js

@@ -0,0 +1,224 @@
+import {
+  nodeParamsPreview
+} from "./chunk-Z3KRNKEA.js";
+import {
+  creativeSlugFromCanvasPath
+} from "./chunk-M7BSXJNL.js";
+import {
+  parseDefinitionDelivery,
+  parseDefinitionSeriesPlace,
+  parseDefinitionSourceFields,
+  parseDefinitionStrategyFields,
+  prepareCanvas
+} from "./chunk-MVDMMSXS.js";
+import {
+  BackendClient
+} from "./chunk-BYV4VS5E.js";
+import {
+  nodeDependencies
+} from "./chunk-LRIP2J5S.js";
+import {
+  requireCredentialsFromEnv
+} from "./chunk-EFZVDV7F.js";
+
+// src/commands/canvas/sync-definition.ts
+import { readdir, readFile, stat } from "fs/promises";
+import path from "path";
+import { parseDocument } from "yaml";
+import { defineCommand } from "citty";
+
+// src/commands/canvas/definition-graph.ts
+var MAX_NODES = 300;
+var PREVIEWABLE_INGEST_EXPECTS = /* @__PURE__ */ new Set(["image"]);
+function nodeInputPreviewUrl(type, params) {
+  if (type !== "ingest" || !params || typeof params !== "object") return void 0;
+  const p = params;
+  if (p.source !== "url" || typeof p.url !== "string") return void 0;
+  if (!/^https?:\/\//i.test(p.url)) return void 0;
+  if (typeof p.expect === "string" && !PREVIEWABLE_INGEST_EXPECTS.has(p.expect)) return void 0;
+  return p.url;
+}
+function canvasToDefinitionGraph(canvas) {
+  const rawNodes = canvas?.nodes;
+  if (!Array.isArray(rawNodes)) return null;
+  const parsed = [];
+  for (const raw of rawNodes) {
+    const id = raw?.id;
+    const type = raw?.type;
+    if (typeof id !== "string" || typeof type !== "string") continue;
+    parsed.push({ id, type, inputs: raw.inputs, params: raw.params });
+    if (parsed.length >= MAX_NODES) break;
+  }
+  if (parsed.length === 0) return null;
+  const ids = new Set(parsed.map((n) => n.id));
+  const nodes = parsed.map(({ id, type, inputs, params }) => {
+    const deps = nodeDependencies({ id, inputs, params }, ids);
+    deps.delete(id);
+    const depList = [...deps];
+    const paramsPreview = nodeParamsPreview(params, depList);
+    const base = { id, type };
+    if (depList.length > 0) base.deps = depList;
+    if (paramsPreview) base.paramsPreview = paramsPreview;
+    const inputPreviewUrl = nodeInputPreviewUrl(type, params);
+    if (inputPreviewUrl) base.inputPreviewUrl = inputPreviewUrl;
+    return base;
+  });
+  const rawOutput = canvas?.output;
+  const outNode = rawOutput?.node;
+  const outSlot = rawOutput?.output;
+  const output = typeof outNode === "string" && typeof outSlot === "string" ? { node: outNode, output: outSlot } : void 0;
+  return { nodes, output };
+}
+
+// src/commands/canvas/sync-definition.ts
+function buildDefinitionSyncPayload(input, graph, chatId) {
+  const { canvas: _canvas, ...fields } = input;
+  return Object.fromEntries([
+    ...Object.entries(fields).filter(([, v]) => v !== void 0),
+    ["graph", graph],
+    ["chatId", chatId]
+  ]);
+}
+async function readDefinitionSourceFields(canvasPath) {
+  try {
+    return parseDefinitionSourceFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
+  } catch {
+    return {};
+  }
+}
+async function readDefinitionPlatforms(canvasPath) {
+  const raw = await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8").catch(() => null);
+  const delivery = raw === null ? null : parseDefinitionDelivery(raw);
+  return delivery ? { platforms: delivery.platforms ?? null } : {};
+}
+async function readDefinitionBody(canvasPath) {
+  try {
+    return { definition: await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8") };
+  } catch {
+    return {};
+  }
+}
+async function readDefinitionTitle(canvasPath) {
+  try {
+    const raw = await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8");
+    const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+    const doc = match ? parseDocument(match[1] ?? "") : null;
+    const title = doc && doc.errors.length === 0 ? doc.get("title") : void 0;
+    return typeof title === "string" && title.trim() ? title.trim() : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function readDefinitionStrategyFields(canvasPath) {
+  try {
+    return parseDefinitionStrategyFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
+  } catch {
+    return {};
+  }
+}
+async function readDefinitionSeriesPlace(canvasPath) {
+  try {
+    return parseDefinitionSeriesPlace(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8")) ?? {};
+  } catch {
+    return {};
+  }
+}
+async function syncCreativeDefinitionBestEffort(input) {
+  const chatId = process.env.BAKER_CHAT_ID;
+  if (!chatId) return;
+  const graph = canvasToDefinitionGraph(input.canvas);
+  if (!graph || graph.nodes.length === 0) return;
+  try {
+    const creds = requireCredentialsFromEnv();
+    const client = new BackendClient({ baseUrl: creds.url, apiKey: creds.apiKey });
+    await client.syncCreativeDefinition(buildDefinitionSyncPayload(input, graph, chatId));
+    process.stdout.write(`[definition] synced workflow graph (${graph.nodes.length} nodes) \u2014 view it in the dashboard
+`);
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    process.stderr.write(`[warn] workflow graph not synced (${msg})
+`);
+  }
+}
+async function resolveCanvasPath(inputPath) {
+  const resolved = path.resolve(inputPath);
+  let dir = resolved;
+  try {
+    if ((await stat(resolved)).isFile()) {
+      if (resolved.endsWith(".canvas.json")) return resolved;
+      dir = path.dirname(resolved);
+    }
+  } catch {
+    dir = resolved.endsWith(".canvas.json") ? path.dirname(resolved) : resolved;
+  }
+  let entries;
+  try {
+    entries = await readdir(dir);
+  } catch {
+    return null;
+  }
+  const canvases = entries.filter((name) => name.endsWith(".canvas.json"));
+  const slug = creativeSlugFromCanvasPath(`${dir}/x/`);
+  const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : void 0) ?? canvases[0];
+  return chosen ? path.join(dir, chosen) : null;
+}
+var syncDefinitionCommand = defineCommand({
+  meta: {
+    name: "sync-definition",
+    description: "Push a creative's current node-graph + input thumbnails to the dashboard without rendering. The graph has the creative's blueprint applied (prompt.json and scenes/*.json edits), exactly as `run` would render it, without changing any file. Runs automatically when you edit a creative's canvas.json or prompt.json."
+  },
+  args: {
+    file: {
+      type: "positional",
+      required: true,
+      description: "A path under src/creatives/<slug>/ (the .canvas.json, its prompt.json, or the folder)"
+    },
+    title: {
+      type: "boolean",
+      description: "Also record the title its _definition.md gives. Only for a creative just made from another (a series ad, a translation), never on an edit re-sync."
+    }
+  },
+  async run({ args }) {
+    const canvasPath = await resolveCanvasPath(String(args.file));
+    if (!canvasPath) {
+      return;
+    }
+    const slug = creativeSlugFromCanvasPath(canvasPath);
+    if (!slug) return;
+    let canvas;
+    let sourceSha;
+    try {
+      const prepared = await prepareCanvas(canvasPath, { write: false });
+      canvas = prepared.fileGraph;
+      sourceSha = prepared.sourceSha;
+    } catch {
+      return;
+    }
+    const title = args.title ? await readDefinitionTitle(canvasPath) : void 0;
+    await syncCreativeDefinitionBestEffort({
+      slug,
+      canvas,
+      sourceSha,
+      ...title ? { title } : {},
+      ...await readDefinitionSourceFields(canvasPath),
+      ...await readDefinitionStrategyFields(canvasPath),
+      ...await readDefinitionSeriesPlace(canvasPath),
+      ...await readDefinitionPlatforms(canvasPath),
+      ...await readDefinitionBody(canvasPath)
+    });
+  }
+});
+
+export {
+  buildDefinitionSyncPayload,
+  readDefinitionSourceFields,
+  readDefinitionPlatforms,
+  readDefinitionBody,
+  readDefinitionTitle,
+  readDefinitionStrategyFields,
+  readDefinitionSeriesPlace,
+  syncCreativeDefinitionBestEffort,
+  resolveCanvasPath,
+  syncDefinitionCommand
+};
+//# sourceMappingURL=chunk-QY6GNZFH.js.map

package/dist/chunk-RM5JT6XF.js

@@ -0,0 +1,106 @@
+import {
+  cacheGet,
+  cacheSet,
+  handleConnectionError,
+  needsConnectionFix,
+  writeAdsJson
+} from "./chunk-VJUVTMHY.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-JCFZ7ECN.js";
+import {
+  getEnv
+} from "./chunk-OMLZ35HJ.js";
+
+// src/commands/ads/x/output.ts
+var ACCOUNTS_CACHE_TTL_MS = 60 * 60 * 1e3;
+var NO_X_ACCOUNTS_EXPLANATION = "The X Ads connection is live, but X lists no ads accounts for it. That is usually an account X has not activated for advertising yet \u2014 most often one with no billing set up. It does not mean the connection failed, and reconnecting will not change it. An account X omits here still works everywhere else: take its id from the ads.x.com URL (ads.x.com/manager/<id>/\u2026) and pass --account-id <id>, or set BAKER_X_ADS_ACCOUNT_ID.";
+async function fetchXAccounts(useCache) {
+  if (useCache) {
+    const cached = cacheGet("x-accounts", "list");
+    if (cached) return cached.data;
+  }
+  const params = !useCache ? { "skip-cache": "true" } : void 0;
+  const data = await apiGet("/api/ads/x/accounts", params);
+  if (useCache) {
+    cacheSet("x-accounts", "list", data, ACCOUNTS_CACHE_TTL_MS);
+  }
+  return data;
+}
+async function resolveXAccountId(args) {
+  const fromArgs = args["account-id"];
+  const accountId = fromArgs || getEnv().BAKER_X_ADS_ACCOUNT_ID;
+  if (accountId) {
+    if (!/^[a-z0-9]+$/.test(accountId)) {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "INVALID_ACCOUNT_ID",
+          message: "X Ads account ID must be a base36 string (lowercase letters and digits). Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID."
+        }
+      });
+      process.exit(1);
+    }
+    return accountId;
+  }
+  const useCache = !args["no-cache"];
+  try {
+    const accounts = await fetchXAccounts(useCache);
+    const [single] = accounts;
+    if (accounts.length === 1 && single) {
+      process.stderr.write(`Using account "${single.name}" (${single.id})
+`);
+      return single.id;
+    }
+    if (accounts.length === 0) {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "INVALID_ACCOUNT_ID",
+          message: NO_X_ACCOUNTS_EXPLANATION,
+          fix: { action: "reject", explanation: NO_X_ACCOUNTS_EXPLANATION },
+          retryable: false
+        }
+      });
+      process.exit(1);
+    }
+    const list = accounts.map((a) => `  ${a.id}  ${a.name}`).join("\n");
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MULTIPLE_ACCOUNTS",
+        message: `Multiple X Ads accounts found. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID:
+${list}`
+      }
+    });
+    process.exit(1);
+  } catch (err) {
+    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("x_ads", err.message);
+    }
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_ACCOUNT_ID",
+        message: "Could not auto-detect account. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID."
+      }
+    });
+    process.exit(1);
+  }
+}
+async function resolveXAccountTimezone(accountId, args) {
+  try {
+    const accounts = await fetchXAccounts(!args["no-cache"]);
+    return accounts.find((a) => a.id === accountId)?.timezone || "UTC";
+  } catch {
+    return "UTC";
+  }
+}
+
+export {
+  NO_X_ACCOUNTS_EXPLANATION,
+  resolveXAccountId,
+  resolveXAccountTimezone
+};
+//# sourceMappingURL=chunk-RM5JT6XF.js.map