@koda-sl/baker-cli 0.455.0 → 0.456.0

package/dist/{chunk-LLOOWRBB.js → chunk-4KCKNAVW.js}

@@ -5,21 +5,25 @@ import {
   adCopyHints,
   booleanWordPositionalError,
   capabilityFix
-} from "./chunk-T4DD5YMP.js";
+} from "./chunk-XY7BZSDQ.js";
 import {
   hintLines,
   withHints
 } from "./chunk-D5FY4FAK.js";
 import {
+  cacheGet,
+  cacheSet,
   handleConnectionError,
   isNotConnectedError,
   writeJsonEnvelope
 } from "./chunk-VFIOJD5M.js";
 import {
   GOOGLE_DRAFT_BATCH_MAX,
+  OP_TOO_LARGE_FIX,
+  OP_TOO_LARGE_MESSAGE_START,
   googleDraftOpInputSchema,
   toMicros
-} from "./chunk-NE4F3FHN.js";
+} from "./chunk-ML7DLFFY.js";
 import {
   ApiError,
   apiPost
@@ -31,6 +35,7 @@ import {
 
 // src/commands/ads/google/write-shared.ts
 import { readFileSync } from "fs";
+import { defineCommand } from "citty";
 
 // src/commands/ads/google/copy-list-usage.ts
 var AD_COPY_LIST_USAGE = `repeat the flag once per item, or pass one comma-separated list and wrap an item that contains a comma in double quotes: '"Fast, free quotes",Book today'. A flag given once is read as a list, so a lone item with a comma needs its double quotes too: '"Fast, free quotes"'`;
@@ -209,6 +214,41 @@ function renderDraftStatus(data) {
   return lines.join("\n");
 }
 
+// src/commands/ads/google/stage-streak.ts
+var STREAK_WINDOW_MS = 5 * 6e4;
+var STREAK_THRESHOLD = 5;
+function nextStageStreak(previous, kind, now) {
+  const continues = previous && previous.kind === kind && now - previous.lastAt <= STREAK_WINDOW_MS;
+  return { kind, count: continues ? previous.count + 1 : 1, lastAt: now };
+}
+var BATCH_FORMS = {
+  "google.keyword.add": "`keywords add --file keywords.txt` (one term[:MATCH_TYPE] per line)",
+  "google.keyword.update": "`keywords pause|resume <resource name> <resource name>\u2026` (or --file, one per line) for status",
+  "google.keyword.remove": "`draft stage --file` with one google.keyword.remove per target",
+  "google.negativeKeyword.add": "`negative-keywords add --file terms.txt`",
+  "google.sharedSetMember.add": "`keyword-lists add --file terms.txt`",
+  "google.sharedSetMember.remove": '`keyword-lists remove --list-ref <id> --text "a,b,c"`'
+};
+function stageStreakHints(streak) {
+  if (streak.count < STREAK_THRESHOLD) {
+    return [];
+  }
+  const form = BATCH_FORMS[streak.kind];
+  return [
+    `LOOP: that is ${streak.count} ${streak.kind} ops staged one command at a time. Stop looping \u2014 put every remaining change in one file and stage them in ONE call: \`baker ads google draft stage --file ops.json --customer-id <id>\` (a JSON array of {"kind","target"?,"payload"?}, up to 500, any mix of kinds)${form ? `, or ${form}` : ""}. Fix staged ops together with \`draft amend --file\`.`
+  ];
+}
+var STREAK_CACHE = "stage-streak";
+function recordSingleStage(chatId, kind) {
+  try {
+    const streak = nextStageStreak(cacheGet(STREAK_CACHE, chatId)?.data, kind, Date.now());
+    cacheSet(STREAK_CACHE, chatId, streak, STREAK_WINDOW_MS);
+    return stageStreakHints(streak);
+  } catch {
+    return [];
+  }
+}
+
 // src/commands/ads/google/write-shared.ts
 function failWriteValidation(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
@@ -233,6 +273,22 @@ function requireTarget(args, entity) {
   }
   return target;
 }
+function targetEntries(args, entity) {
+  const booleanWord = booleanWordPositionalError(args, entity);
+  if (booleanWord) {
+    failWriteValidation(booleanWord);
+  }
+  const positionals = Array.isArray(args._) ? args._.filter((v) => typeof v === "string") : [];
+  const raw = [...positionals.flatMap((v) => v.split(",")), ...rawFileEntries(args.file)].map((v) => v.trim()).filter(Boolean);
+  const targets = [...new Set(raw)];
+  if (targets.length === 0) {
+    failWriteValidation(`pass the ${entity} resource name(s) as positional arguments and/or --file (one per line)`);
+  }
+  if (targets.length > GOOGLE_DRAFT_BATCH_MAX) {
+    failWriteValidation(`${targets.length} targets exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} \u2014 split them`);
+  }
+  return targets;
+}
 function requireStringFlag(value, flag) {
   if (typeof value !== "string" || value.length === 0) {
     failWriteValidation(`${flag} is required`);
@@ -275,9 +331,9 @@ function rawTextEntries(value, rawArgs) {
   return repeatedValues(rawArgs, "text", value).flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
 }
 function rawFileEntries(path) {
-  if (typeof path !== "string" || path.length === 0) {
-    return [];
-  }
+  return typeof path === "string" && path.length > 0 ? fileLines(path) : [];
+}
+function fileLines(path) {
   return readFileSync(path, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
 }
 function keywordEntries(args, rawArgs) {
@@ -301,25 +357,55 @@ function keywordEntries(args, rawArgs) {
   }
   return entries;
 }
-function loadJsonFileArg(path) {
+function loadJsonPayloads(path) {
   if (typeof path !== "string" || path.length === 0) {
-    return {};
+    return [];
   }
-  const inline = path.trimStart().startsWith("{");
+  const inline = /^\s*[[{]/.test(path);
   const source = inline ? "inline JSON" : path;
-  try {
-    const parsed = JSON.parse(inline ? path : readFileSync(path, "utf8"));
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation(`${source} must contain a JSON object`);
+  const text = inline ? path : readFileSync(path, "utf8");
+  return parsedPayloads(text, source).map((item, index, all) => {
+    if (item === null || typeof item !== "object" || Array.isArray(item)) {
+      failWriteValidation(
+        all.length === 1 ? `${source} must contain a JSON object` : `${source}: item ${index} must be a JSON object`
+      );
     }
-    return parsed;
+    return item;
+  });
+}
+function parsedPayloads(text, source) {
+  try {
+    const parsed = JSON.parse(text);
+    return Array.isArray(parsed) ? parsed : [parsed];
   } catch (err) {
-    if (err instanceof SyntaxError) {
-      failWriteValidation(`${source} is not valid JSON: ${err.message}`);
+    if (!(err instanceof SyntaxError)) {
+      throw err;
     }
-    throw err;
+    const lines = text.split(/\r?\n/).filter((line) => line.trim().length > 0);
+    if (lines.length > 1) {
+      return lines.map((line, index) => parseJsonLine(line, index, source));
+    }
+    failWriteValidation(`${source} is not valid JSON: ${err.message}`);
   }
 }
+function parseJsonLine(line, index, source) {
+  try {
+    return JSON.parse(line);
+  } catch (err) {
+    return failWriteValidation(
+      `${source} line ${index + 1} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+function loadJsonFileArg(path) {
+  const payloads = loadJsonPayloads(path);
+  if (payloads.length > 1) {
+    failWriteValidation(
+      `this command changes one entity, and --file holds ${payloads.length} payloads \u2014 stage many changes from one file with \`baker ads google draft stage --file\` (one op per item: {"kind","customerId","target"?,"payload"?})`
+    );
+  }
+  return payloads[0] ?? {};
+}
 function mergePayload(file, flags) {
   const merged = { ...file };
   for (const [key, value] of Object.entries(flags)) {
@@ -356,6 +442,18 @@ function handleGoogleError(err) {
     if (isNotConnectedError(err.code, err.message)) {
       handleConnectionError("google_ads", err.message);
     }
+    if (err.message.includes(OP_TOO_LARGE_MESSAGE_START)) {
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "OP_TOO_LARGE",
+          message: err.message,
+          retryable: false,
+          fix: { action: "split_the_change", explanation: OP_TOO_LARGE_FIX }
+        }
+      });
+      process.exit(1);
+    }
     writeJsonEnvelope({ ok: false, error: { code: err.code ?? "API_ERROR", message: err.message } });
     process.exit(1);
   }
@@ -395,7 +493,12 @@ async function stageGoogleOp(raw, hints) {
   try {
     const chatId = requireChatId();
     const response = await apiPost("/api/ads/google/draft/stage", { chatId, op: preflight.data });
-    const allHints = [...noopHints(response.data), ...hints ?? [], ...await adCopyHints(preflight.data)];
+    const allHints = [
+      ...noopHints(response.data),
+      ...recordSingleStage(chatId, preflight.data.kind),
+      ...hints ?? [],
+      ...await adCopyHints(preflight.data)
+    ];
     writeJsonEnvelope(withHints(response, allHints));
   } catch (err) {
     handleGoogleError(err);
@@ -404,6 +507,7 @@ async function stageGoogleOp(raw, hints) {
 async function stageCreate(kind, customerId, payload, hints) {
   await stageGoogleOp({ kind, customerId, payload }, hints);
 }
+var STAGE_BATCH_TIMEOUT_MS = 5 * 6e4;
 async function stageGoogleOps(rawOps, hints) {
   if (rawOps.length === 1 && rawOps[0]) {
     await stageGoogleOp(rawOps[0], hints);
@@ -432,7 +536,11 @@ async function stageGoogleOps(rawOps, hints) {
   }
   try {
     const chatId = requireChatId();
-    const response = await apiPost("/api/ads/google/draft/stage-batch", { chatId, ops });
+    const response = await apiPost(
+      "/api/ads/google/draft/stage-batch",
+      { chatId, ops },
+      { timeoutMs: STAGE_BATCH_TIMEOUT_MS }
+    );
     const allHints = [
       ...skippedHints(response.data.skipped ?? [], ops.length),
       ...hints ?? [],
@@ -472,25 +580,86 @@ async function draftListAction(json, chat) {
     handleGoogleError(err);
   }
 }
+var customerIdArg = {
+  "customer-id": { type: "string", description: "10-digit Google Ads customer id" }
+};
+var fileArg = {
+  file: {
+    type: "string",
+    description: "The op payload: a JSON file path, or the JSON object inline (flags override it)"
+  }
+};
+var fileBatchArg = {
+  file: {
+    type: "string",
+    description: "The op payload: a JSON file path or inline JSON \u2014 one object, or a JSON array / JSON Lines of objects to stage many in one call (up to 500)"
+  }
+};
+function fileCreateCommand(name, kind, description, hints) {
+  return defineCommand({
+    meta: { name, description },
+    args: { ...customerIdArg, ...fileBatchArg },
+    run: async ({ args }) => {
+      const customerId = requireCustomerId(args);
+      const payloads = loadJsonPayloads(args.file);
+      if (payloads.length === 0 || payloads.some((payload) => Object.keys(payload).length === 0)) {
+        failWriteValidation(`${kind} needs --file with the op payload (one object, or a JSON array to stage many)`);
+      }
+      if (payloads.length > GOOGLE_DRAFT_BATCH_MAX) {
+        failWriteValidation(
+          `${payloads.length} payloads exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} \u2014 split the file`
+        );
+      }
+      const payloadHints = [
+        ...new Set(payloads.flatMap((payload) => typeof hints === "function" ? hints(payload) : hints ?? []))
+      ];
+      await stageGoogleOps(
+        payloads.map((payload) => ({ kind, customerId, payload })),
+        payloadHints
+      );
+    }
+  });
+}
+function bidModifierFlag(value) {
+  if (value === void 0 || value === null || value === "") {
+    failWriteValidation(
+      "--bid-modifier is required: 1 for no adjustment, 1.25 to bid 25% more, 0.9 to bid 10% less, 0 to stop serving on a device"
+    );
+  }
+  const num = Number(value);
+  if (Number.isNaN(num) || num < 0 || num > 10 || num > 0 && num < 0.1) {
+    failWriteValidation("--bid-modifier must be 0 (stop serving on it) or between 0.1 and 10.0");
+  }
+  return num;
+}
 
 export {
   AD_COPY_LIST_USAGE,
   failWriteValidation,
   requireCustomerId,
   requireTarget,
+  targetEntries,
   requireStringFlag,
   microsFlag,
   listFlag,
+  fileLines,
   keywordEntries,
+  loadJsonPayloads,
   loadJsonFileArg,
   mergePayload,
   loadPatchArg,
+  handleGoogleError,
   stageGoogleOp,
   stageCreate,
   stageGoogleOps,
   stageUpdate,
   stageTarget,
   draftAction,
-  draftListAction
+  draftListAction,
+  customerIdArg,
+  fileArg,
+  fileBatchArg,
+  fileCreateCommand,
+  bidModifierFlag
 };
-//# sourceMappingURL=chunk-LLOOWRBB.js.map
+//# sourceMappingURL=chunk-4KCKNAVW.js.map

package/dist/chunk-4KCKNAVW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/write-shared.ts","../src/commands/ads/google/copy-list-usage.ts","../src/commands/ads/google/draft-status.ts","../src/commands/ads/google/stage-streak.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport {\n  GOOGLE_DRAFT_BATCH_MAX,\n  type GoogleDraftListResponse,\n  type GoogleDraftStageBatchResponse,\n  type GoogleDraftStageResponse,\n  googleDraftOpInputSchema,\n  OP_TOO_LARGE_FIX,\n  OP_TOO_LARGE_MESSAGE_START,\n  toMicros,\n} from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { requireChatId, resolveChatId } from \"../../../env.ts\";\nimport { handleConnectionError, isNotConnectedError } from \"../../../error-handler.ts\";\nimport { repeatedValues } from \"../../../lib/repeatedFlags.ts\";\nimport { capabilityFix } from \"../../capabilities/fix.ts\";\nimport { booleanWordPositionalError } from \"../boolean-word-positional.ts\";\nimport { adCopyHints } from \"../copy-hints.ts\";\nimport { hintLines, withHints } from \"../hints.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { copyListCountFix } from \"./copy-list-usage.ts\";\nimport { renderDraftStatus } from \"./draft-status.ts\";\nimport { recordSingleStage } from \"./stage-streak.ts\";\n\n/**\n * Shared plumbing for the staged Google Ads write commands. Writes NEVER hit\n * the Google Ads API directly: every command stages an op against this chat's\n * draft (`/api/ads/google/draft/stage`), the dashboard shows it as a pending\n * Google Ads change, and the draft applies as one `GoogleAdsService.Mutate`\n * request per advertiser account when the chat is published. `--customer-id` is\n * required on every write — a draft may span several accounts, so nothing is\n * picked for you.\n */\n\nexport function failWriteValidation(message: string): never {\n  writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\nexport function requireCustomerId(args: Record<string, unknown>): string {\n  const raw = (args[\"customer-id\"] ?? args.customerId) as string | undefined;\n  if (!raw || !/^\\d{10}$/.test(raw)) {\n    failWriteValidation(\"pass --customer-id as the 10-digit Google Ads customer id (no dashes)\");\n  }\n  return raw;\n}\n\nexport function requireTarget(args: Record<string, unknown>, entity: string): string {\n  // `--flag false` is refused, not documented: citty parses it as the flag set to TRUE plus a stray\n  // positional nobody consumes, so on `conversions update --primary` it silently PROMOTES an action\n  // into what every Maximize Conversions campaign bids toward. Caught here because this is the only\n  // place on this surface that reads positionals, and every target-taking command goes through it.\n  const booleanWord = booleanWordPositionalError(args, entity);\n  if (booleanWord) {\n    failWriteValidation(booleanWord);\n  }\n  const positional = Array.isArray(args._) ? args._[0] : undefined;\n  const target = args.id ?? args.target ?? args.ref ?? positional;\n  if (typeof target !== \"string\" || target.length === 0) {\n    failWriteValidation(`pass the ${entity} resource name or id as the positional argument`);\n  }\n  return target;\n}\n\n/**\n * The targets a bulk status command was given: every positional (comma-separated ones split), plus\n * `--file` with one target per line (blank lines and `#` comments skipped), deduped in order. One\n * call then stages them all as one batch instead of one command per row.\n */\nexport function targetEntries(args: Record<string, unknown>, entity: string): string[] {\n  const booleanWord = booleanWordPositionalError(args, entity);\n  if (booleanWord) {\n    failWriteValidation(booleanWord);\n  }\n  const positionals = Array.isArray(args._) ? args._.filter((v): v is string => typeof v === \"string\") : [];\n  const raw = [...positionals.flatMap((v) => v.split(\",\")), ...rawFileEntries(args.file)]\n    .map((v) => v.trim())\n    .filter(Boolean);\n  const targets = [...new Set(raw)];\n  if (targets.length === 0) {\n    failWriteValidation(`pass the ${entity} resource name(s) as positional arguments and/or --file (one per line)`);\n  }\n  if (targets.length > GOOGLE_DRAFT_BATCH_MAX) {\n    failWriteValidation(`${targets.length} targets exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} — split them`);\n  }\n  return targets;\n}\n\nexport function requireStringFlag(value: unknown, flag: string): string {\n  if (typeof value !== \"string\" || value.length === 0) {\n    failWriteValidation(`${flag} is required`);\n  }\n  return value;\n}\n\n/** Money flag in major currency units → micros. */\nexport function microsFlag(value: unknown, flag: string): number | undefined {\n  if (value === undefined || value === null || value === \"\") {\n    return undefined;\n  }\n  const num = Number(value);\n  if (Number.isNaN(num) || num <= 0) {\n    failWriteValidation(`${flag} must be a positive amount (major currency units, e.g. 50 or 50.00)`);\n  }\n  return toMicros(num);\n}\n\n/** Split a comma-separated flag into trimmed non-empty values. */\nexport function listFlag(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.length === 0) {\n    return undefined;\n  }\n  const items = value\n    .split(\",\")\n    .map((v) => v.trim())\n    .filter(Boolean);\n  return items.length > 0 ? items : undefined;\n}\n\nexport interface KeywordEntry {\n  text: string;\n  matchType: string;\n}\n\nconst MATCH_TYPES = new Set([\"EXACT\", \"PHRASE\", \"BROAD\"]);\n\n/**\n * One raw keyword entry → { text, matchType }. A trailing `:EXACT|:PHRASE|:BROAD`\n * suffix overrides the default match type; colons and commas aren't legal in Google\n * keyword text, so the syntax is unambiguous.\n */\nfunction parseKeywordEntry(raw: string, defaultMatch: string | undefined): KeywordEntry {\n  const colon = raw.lastIndexOf(\":\");\n  if (colon > 0) {\n    const suffix = raw\n      .slice(colon + 1)\n      .trim()\n      .toUpperCase();\n    if (MATCH_TYPES.has(suffix)) {\n      return { text: raw.slice(0, colon).trim(), matchType: suffix };\n    }\n    failWriteValidation(`\"${raw}\": \":${raw.slice(colon + 1)}\" is not a match type (EXACT | PHRASE | BROAD)`);\n  }\n  if (!defaultMatch) {\n    failWriteValidation(`\"${raw}\" has no match type — add a :EXACT/:PHRASE/:BROAD suffix or pass --match-type`);\n  }\n  return { text: raw, matchType: defaultMatch };\n}\n\n/**\n * Raw --text value(s) → individual entries: repeated flags and comma-separated\n * both work. The repeats have to come off `rawArgs`, because citty parses a\n * repeated flag down to its last value alone.\n */\nfunction rawTextEntries(value: unknown, rawArgs: readonly string[] | undefined): string[] {\n  return repeatedValues(rawArgs, \"text\", value)\n    .flatMap((v) => v.split(\",\"))\n    .map((v) => v.trim())\n    .filter(Boolean);\n}\n\n/** Newline-separated keyword file: one `text[:MATCH_TYPE]` per line; blank lines and `#` comments skipped. */\nfunction rawFileEntries(path: unknown): string[] {\n  return typeof path === \"string\" && path.length > 0 ? fileLines(path) : [];\n}\n\n/** A text file's entries: one per line, trimmed; blank lines and `#` comments skipped. */\nexport function fileLines(path: string): string[] {\n  return readFileSync(path, \"utf8\")\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0 && !line.startsWith(\"#\"));\n}\n\n/**\n * The keyword batch a command was invoked with: comma-separated `--text` entries\n * (optional `:MATCH_TYPE` suffix each) plus `--file` lines, deduped, each falling\n * back to `--match-type`. One entry stages exactly like before; many stage as one batch.\n */\nexport function keywordEntries(args: Record<string, unknown>, rawArgs?: readonly string[]): KeywordEntry[] {\n  const defaultMatch = typeof args[\"match-type\"] === \"string\" ? args[\"match-type\"].toUpperCase() : undefined;\n  const raw = [...rawTextEntries(args.text, rawArgs), ...rawFileEntries(args.file)];\n  if (raw.length === 0) {\n    failWriteValidation(\"pass keywords via --text (comma-separated) and/or --file (one per line)\");\n  }\n  if (raw.length > GOOGLE_DRAFT_BATCH_MAX) {\n    failWriteValidation(`${raw.length} keywords exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX}`);\n  }\n  const entries: KeywordEntry[] = [];\n  const seen = new Set<string>();\n  for (const item of raw) {\n    const entry = parseKeywordEntry(item, defaultMatch);\n    const key = JSON.stringify([entry.text, entry.matchType]);\n    if (!seen.has(key)) {\n      seen.add(key);\n      entries.push(entry);\n    }\n  }\n  return entries;\n}\n\n/**\n * The payloads behind `--file`: a path to a JSON file, or the JSON written inline. The file holds one\n * payload object, a JSON array of them, or JSON Lines (one object per line) — many payloads stage as\n * one batch, which is how a bulk change lands in one call instead of hundreds.\n *\n * Inline is here because every doc example already writes it that way — `packages/cli/README.md`\n * and the scaffold's `ads-google.md` both show `--file '{\"type\":\"image\",…}'` — while the arg only\n * ever read a path, so following the documentation answered with a raw ENOENT stack trace. Reading\n * a leading `{` or `[` as the payload makes those examples true rather than making the agent re-learn\n * the one shape that works.\n */\nexport function loadJsonPayloads(path: unknown): Array<Record<string, unknown>> {\n  if (typeof path !== \"string\" || path.length === 0) {\n    return [];\n  }\n  const inline = /^\\s*[[{]/.test(path);\n  const source = inline ? \"inline JSON\" : path;\n  const text = inline ? path : readFileSync(path, \"utf8\");\n  return parsedPayloads(text, source).map((item, index, all) => {\n    if (item === null || typeof item !== \"object\" || Array.isArray(item)) {\n      failWriteValidation(\n        all.length === 1 ? `${source} must contain a JSON object` : `${source}: item ${index} must be a JSON object`,\n      );\n    }\n    return item as Record<string, unknown>;\n  });\n}\n\n/** One JSON value (an array spreads into its items), else JSON Lines; the JSON error when neither parses. */\nfunction parsedPayloads(text: string, source: string): unknown[] {\n  try {\n    const parsed = JSON.parse(text) as unknown;\n    return Array.isArray(parsed) ? parsed : [parsed];\n  } catch (err) {\n    if (!(err instanceof SyntaxError)) {\n      throw err;\n    }\n    const lines = text.split(/\\r?\\n/).filter((line) => line.trim().length > 0);\n    if (lines.length > 1) {\n      return lines.map((line, index) => parseJsonLine(line, index, source));\n    }\n    failWriteValidation(`${source} is not valid JSON: ${err.message}`);\n  }\n}\n\n/** One JSON Lines entry, or the line's own error naming where it is. */\nfunction parseJsonLine(line: string, index: number, source: string): unknown {\n  try {\n    return JSON.parse(line) as unknown;\n  } catch (err) {\n    return failWriteValidation(\n      `${source} line ${index + 1} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\n/** The ONE op payload behind `--file`, for commands that change a single entity. */\nexport function loadJsonFileArg(path: unknown): Record<string, unknown> {\n  const payloads = loadJsonPayloads(path);\n  if (payloads.length > 1) {\n    failWriteValidation(\n      `this command changes one entity, and --file holds ${payloads.length} payloads — stage many changes from one file with \\`baker ads google draft stage --file\\` (one op per item: {\"kind\",\"customerId\",\"target\"?,\"payload\"?})`,\n    );\n  }\n  return payloads[0] ?? {};\n}\n\n/** Flags override file keys — the file is the base, flags are the overrides. */\nexport function mergePayload(file: Record<string, unknown>, flags: Record<string, unknown>): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...file };\n  for (const [key, value] of Object.entries(flags)) {\n    if (value !== undefined) {\n      merged[key] = value;\n    }\n  }\n  return merged;\n}\n\n/**\n * The `draft amend` patch: exactly one of `--file <path>` (JSON file) or `--patch '<json>'`\n * (inline string), and it must parse to a JSON object — RFC-7386 merge-patch needs an object to\n * merge, and a stray array/scalar would silently no-op or replace the whole payload.\n */\nexport function loadPatchArg(args: Record<string, unknown>): Record<string, unknown> {\n  const file = typeof args.file === \"string\" && args.file.length > 0 ? args.file : undefined;\n  const inline = typeof args.patch === \"string\" && args.patch.length > 0 ? args.patch : undefined;\n  if (Boolean(file) === Boolean(inline)) {\n    failWriteValidation(\"pass exactly one of --file <patch.json> or --patch '<json>'\");\n  }\n  if (file) {\n    return loadJsonFileArg(file);\n  }\n  try {\n    const parsed = JSON.parse(inline as string) as unknown;\n    if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      failWriteValidation(\"--patch must be a JSON object\");\n    }\n    return parsed as Record<string, unknown>;\n  } catch (err) {\n    if (err instanceof SyntaxError) {\n      failWriteValidation(`--patch is not valid JSON: ${err.message}`);\n    }\n    throw err;\n  }\n}\n\nexport function handleGoogleError(err: unknown): never {\n  if (err instanceof ApiError) {\n    // Covers both \"no connection\" and staging's 403 for an account this company\n    // never connected — same remedy either way: connect, and pick the account.\n    if (isNotConnectedError(err.code, err.message)) {\n      handleConnectionError(\"google_ads\", err.message);\n    }\n    if (err.message.includes(OP_TOO_LARGE_MESSAGE_START)) {\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"OP_TOO_LARGE\",\n          message: err.message,\n          retryable: false,\n          fix: { action: \"split_the_change\", explanation: OP_TOO_LARGE_FIX },\n        },\n      });\n      process.exit(1);\n    }\n    writeJsonEnvelope({ ok: false, error: { code: err.code ?? \"API_ERROR\", message: err.message } });\n    process.exit(1);\n  }\n  writeJsonEnvelope({\n    ok: false,\n    error: { code: \"UNKNOWN\", message: err instanceof Error ? err.message : String(err) },\n  });\n  process.exit(1);\n}\n\ninterface StageEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: GoogleDraftStageResponse;\n}\n\n/**\n * A no-op response isn't a failure — the change was already in place, so nothing was\n * staged. Say so explicitly, otherwise the agent re-stages it or reports work it\n * didn't do.\n */\nfunction noopHints(data: GoogleDraftStageResponse): string[] {\n  return data.staged\n    ? []\n    : [`NOT STAGED — ${data.reason}. Nothing to publish for this change; say so rather than reporting it as done.`];\n}\n\n/**\n * What to tell the agent about the ops a batch didn't stage.\n *\n * Two different things land in `skipped`: a change already in place, and a change Google refuses\n * outright (editing an experiment campaign's status, dates or budget). This hint used to assert the\n * first — \"already in the requested state\" — which read as \"done\" for a refusal the user never heard\n * about. So it leads with each op's own reason and asks for the refusals to be passed on.\n */\nexport function skippedHints(skipped: Array<{ summary: string; reason: string }>, total: number): string[] {\n  if (skipped.length === 0) {\n    return [];\n  }\n  const detail = skipped.map((s) => `${s.summary} — ${s.reason}`).join(\"; \");\n  return [\n    `${skipped.length} of ${total} op(s) NOT STAGED: ${detail}. Don't re-stage them; tell the user which changes couldn't be made and why, then carry on with the rest.`,\n  ];\n}\n\n/**\n * Preflight-validates the op against the shared `@baker/api/ads-google`\n * contract (the same schema the backend enforces), then stages it. Prints the\n * staged envelope — ref, mode (always `live`: publishing reaches the real\n * account), summary, warnings.\n */\nexport async function stageGoogleOp(raw: Record<string, unknown>, hints?: string[]): Promise<void> {\n  const preflight = googleDraftOpInputSchema.safeParse(raw);\n  if (!preflight.success) {\n    const fields = preflight.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message }));\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"VALIDATION_ERROR\",\n        message: fields.map((f) => (f.path ? `${f.path}: ${f.message}` : f.message)).join(\"; \"),\n        fields,\n        fix: copyListCountFix(raw, preflight.error.issues) ?? capabilityFix(\"google-ads\"),\n      },\n    });\n    process.exit(1);\n  }\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageEnvelope>(\"/api/ads/google/draft/stage\", { chatId, op: preflight.data });\n    const allHints = [\n      ...noopHints(response.data),\n      ...recordSingleStage(chatId, preflight.data.kind),\n      ...(hints ?? []),\n      ...(await adCopyHints(preflight.data)),\n    ];\n    writeJsonEnvelope(withHints(response, allHints));\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\n/** Stage a create op: `{ kind, customerId, payload }`. */\nexport async function stageCreate(\n  kind: string,\n  customerId: string,\n  payload: Record<string, unknown>,\n  hints?: string[],\n): Promise<void> {\n  await stageGoogleOp({ kind, customerId, payload }, hints);\n}\n\ninterface StageBatchEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: GoogleDraftStageBatchResponse;\n}\n\n/**\n * A batch reads every target's before-state and checks each op against the account, which for a few\n * hundred removals outlasts the default 60 s. Timing out early reported a batch as failed that went on\n * to stage, so a retry then collided with the ops it had already staged.\n */\nconst STAGE_BATCH_TIMEOUT_MS = 5 * 60_000;\n\n/**\n * Stage several ops as ONE request (`/stage-batch`) — all-or-nothing on the backend,\n * one rate-limit hit instead of one per keyword. A single op falls through to the\n * plain stage path so its envelope (and amend behavior) stays exactly as before.\n */\nexport async function stageGoogleOps(rawOps: Array<Record<string, unknown>>, hints?: string[]): Promise<void> {\n  if (rawOps.length === 1 && rawOps[0]) {\n    await stageGoogleOp(rawOps[0], hints);\n    return;\n  }\n  const ops: unknown[] = [];\n  for (const [index, raw] of rawOps.entries()) {\n    const preflight = googleDraftOpInputSchema.safeParse(raw);\n    if (!preflight.success) {\n      const fields = preflight.error.issues.map((issue) => ({\n        path: `ops[${index}].${issue.path.join(\".\")}`,\n        message: issue.message,\n      }));\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: fields.map((f) => `${f.path}: ${f.message}`).join(\"; \"),\n          fields,\n          fix: copyListCountFix(raw, preflight.error.issues) ?? capabilityFix(\"google-ads\"),\n        },\n      });\n      process.exit(1);\n    }\n    ops.push(preflight.data);\n  }\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageBatchEnvelope>(\n      \"/api/ads/google/draft/stage-batch\",\n      { chatId, ops },\n      { timeoutMs: STAGE_BATCH_TIMEOUT_MS },\n    );\n    const allHints = [\n      ...skippedHints(response.data.skipped ?? [], ops.length),\n      ...(hints ?? []),\n      ...(await adCopyHints(ops)),\n    ];\n    writeJsonEnvelope(withHints(response, allHints));\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\n/** Stage an update op: `{ kind, customerId, target, payload }`. */\nexport async function stageUpdate(\n  kind: string,\n  customerId: string,\n  target: string,\n  payload: Record<string, unknown>,\n  hints?: string[],\n): Promise<void> {\n  await stageGoogleOp({ kind, customerId, target, payload }, hints);\n}\n\n/** Stage a target-only op (pause/resume/remove/detach): `{ kind, customerId, target }`. */\nexport async function stageTarget(kind: string, customerId: string, target: string, hints?: string[]): Promise<void> {\n  await stageGoogleOp({ kind, customerId, target }, hints);\n}\n\nexport async function draftAction(path: string, body: Record<string, unknown>, chat?: unknown): Promise<void> {\n  try {\n    const chatId = resolveChatId(chat);\n    const response = await apiPost<Record<string, unknown>>(path, { chatId, ...body });\n    writeJsonEnvelope(response);\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\ninterface DraftListEnvelope extends Record<string, unknown> {\n  ok: boolean;\n  data?: GoogleDraftListResponse;\n}\n\n/**\n * List the staged draft. By default renders a readable campaign ▸ ad group ▸ ad status tree so the\n * agent can review everything it has staged at a glance; `--json` returns the raw envelope for tools.\n */\nexport async function draftListAction(json: boolean, chat?: unknown): Promise<void> {\n  try {\n    const chatId = resolveChatId(chat);\n    const response = await apiPost<DraftListEnvelope>(\"/api/ads/google/draft\", { chatId });\n    if (json || !response.ok || !response.data) {\n      writeJsonEnvelope(response);\n      return;\n    }\n    process.stdout.write(`${renderDraftStatus(response.data)}${hintLines(response)}\\n`);\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\nexport const customerIdArg = {\n  \"customer-id\": { type: \"string\" as const, description: \"10-digit Google Ads customer id\" },\n};\nexport const fileArg = {\n  file: {\n    type: \"string\" as const,\n    description: \"The op payload: a JSON file path, or the JSON object inline (flags override it)\",\n  },\n};\nexport const fileBatchArg = {\n  file: {\n    type: \"string\" as const,\n    description:\n      \"The op payload: a JSON file path or inline JSON — one object, or a JSON array / JSON Lines of objects to stage many in one call (up to 500)\",\n  },\n};\n\n/** A create command whose payload is a JSON file or inline JSON — one object or an array staged as one batch. */\nexport function fileCreateCommand(\n  name: string,\n  kind: string,\n  description: string,\n  hints?: string[] | ((payload: Record<string, unknown>) => string[]),\n) {\n  return defineCommand({\n    meta: { name, description },\n    args: { ...customerIdArg, ...fileBatchArg },\n    run: async ({ args }) => {\n      const customerId = requireCustomerId(args);\n      const payloads = loadJsonPayloads(args.file);\n      if (payloads.length === 0 || payloads.some((payload) => Object.keys(payload).length === 0)) {\n        failWriteValidation(`${kind} needs --file with the op payload (one object, or a JSON array to stage many)`);\n      }\n      if (payloads.length > GOOGLE_DRAFT_BATCH_MAX) {\n        failWriteValidation(\n          `${payloads.length} payloads exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} — split the file`,\n        );\n      }\n      const payloadHints = [\n        ...new Set(payloads.flatMap((payload) => (typeof hints === \"function\" ? hints(payload) : (hints ?? [])))),\n      ];\n      await stageGoogleOps(\n        payloads.map((payload) => ({ kind, customerId, payload })),\n        payloadHints,\n      );\n    },\n  });\n}\n\n/**\n * `--bid-modifier` as a number, validated against the range Google actually accepts.\n *\n * Rejecting the (0, 0.1) gap here rather than at the backend is the point: 0 and 0.1 are a hundredth\n * apart in value and mean \"never serve\" versus \"bid a tenth\", so a typo between them is a real spend\n * decision, and the error should arrive before anything is staged.\n */\nexport function bidModifierFlag(value: unknown): number {\n  if (value === undefined || value === null || value === \"\") {\n    failWriteValidation(\n      \"--bid-modifier is required: 1 for no adjustment, 1.25 to bid 25% more, 0.9 to bid 10% less, 0 to stop serving on a device\",\n    );\n  }\n  const num = Number(value);\n  if (Number.isNaN(num) || num < 0 || num > 10 || (num > 0 && num < 0.1)) {\n    failWriteValidation(\"--bid-modifier must be 0 (stop serving on it) or between 0.1 and 10.0\");\n  }\n  return num;\n}\n","import type { z } from \"zod\";\n\n/** Appended to each copy flag's help, so `--help` and `baker schema` say how to pass a comma. */\nexport const AD_COPY_LIST_USAGE =\n  \"repeat the flag once per item, or pass one comma-separated list and wrap an item that contains a comma in double quotes: '\\\"Fast, free quotes\\\",Book today'. A flag given once is read as a list, so a lone item with a comma needs its double quotes too: '\\\"Fast, free quotes\\\"'\";\n\n/** The op's copy-list fields, by the flag an agent passes them with. */\nconst COPY_LIST_FLAG: Readonly<Record<string, string>> = {\n  headlines: \"--headlines\",\n  descriptions: \"--descriptions\",\n  longHeadlines: \"--long-headlines\",\n};\n\ninterface CountRefusal {\n  flag: string;\n  count: number | undefined;\n  bound: string;\n  tooMany: boolean;\n}\n\nfunction valueAt(root: unknown, path: readonly PropertyKey[]): unknown {\n  let node = root;\n  for (const key of path) {\n    if (node === null || typeof node !== \"object\") return undefined;\n    node = (node as Record<PropertyKey, unknown>)[key];\n  }\n  return node;\n}\n\nfunction countRefusal(op: unknown, issue: z.core.$ZodIssue): CountRefusal | undefined {\n  if ((issue.code !== \"too_big\" && issue.code !== \"too_small\") || issue.origin !== \"array\") return undefined;\n  const flag = COPY_LIST_FLAG[String(issue.path.at(-1))];\n  if (!flag) return undefined;\n  const value = valueAt(op, issue.path);\n  const count = Array.isArray(value) ? value.length : undefined;\n  return issue.code === \"too_big\"\n    ? { flag, count, bound: `at most ${issue.maximum}`, tooMany: true }\n    : { flag, count, bound: `at least ${issue.minimum}`, tooMany: false };\n}\n\n/**\n * The fix for a stage refused only for how many headlines, descriptions or long headlines it has.\n *\n * That is a limit on a field the agent named correctly, so the generic \"read `baker capabilities`,\n * do not guess another field name\" sent it through draft list, schema and --help before it saw the\n * cause. Too many items is usually copy cut at its commas — a flag given once is a comma-separated\n * list, so \"Rated 4,5/5\" becomes two items — which is why that case names the forms that keep a\n * comma. Undefined when anything else was refused too, so the capabilities pointer still covers it.\n */\nexport function copyListCountFix(\n  op: unknown,\n  issues: readonly z.core.$ZodIssue[],\n): { action: string; explanation: string } | undefined {\n  const refusals = issues.map((issue) => countRefusal(op, issue));\n  if (refusals.length === 0 || refusals.some((refusal) => refusal === undefined)) return undefined;\n  const counted = refusals.filter((refusal): refusal is CountRefusal => refusal !== undefined);\n  const limits = counted\n    .map(({ flag, count, bound }) => `${flag} has ${count ?? \"the wrong number of\"} items; this ad takes ${bound}.`)\n    .join(\" \");\n  const commaCause = counted.some((refusal) => refusal.tooMany)\n    ? ' If you meant fewer items, the copy was cut at its commas: a flag given once is read as a comma-separated list, so an item with a comma in it (\"Fast, free quotes\", a decimal like \"4,5/5\") becomes two. To keep a comma, ' +\n      `${AD_COPY_LIST_USAGE} — or put the content in --file as JSON.`\n    : \"\";\n  return {\n    action: \"fix_copy_list_count\",\n    explanation: `${limits}${commaCause} ${commaCause ? \"Otherwise add\" : \"Add\"} or drop items to fit the limit, then stage again; the field names are right.`,\n  };\n}\n","import type {\n  GoogleDraftListResponse,\n  GoogleDraftStatusCollection,\n  GoogleDraftStatusNode,\n} from \"@baker/api/ads-google\";\n\n/**\n * Render the staged Google Ads draft as a readable campaign ▸ ad group ▸ ad tree — the CLI\n * counterpart to the dashboard's Google Ads tab, so an agent can review everything it has staged\n * with one command instead of reading raw JSON. Pure: takes the draft-list response, returns text.\n */\n\nconst OPERATION_LABELS: Record<string, string> = {\n  create: \"Creating\",\n  update: \"Updating\",\n  pause: \"Pausing\",\n  resume: \"Resuming\",\n  remove: \"Removing\",\n};\n\nfunction badge(node: GoogleDraftStatusNode): string {\n  const label = node.operation ? OPERATION_LABELS[node.operation] : undefined;\n  if (label) {\n    return label;\n  }\n  return node.existing ? \"on Google Ads\" : \"staged\";\n}\n\nfunction collectionLine(collection: GoogleDraftStatusCollection): string | undefined {\n  const parts: string[] = [];\n  if (collection.added > 0) {\n    parts.push(`+${collection.added}`);\n  }\n  if (collection.existing > 0) {\n    parts.push(`${collection.existing} existing`);\n  }\n  if (collection.removed > 0) {\n    parts.push(`-${collection.removed}`);\n  }\n  // Neither an add nor a remove — a member that stays in the set with a changed value (a device's\n  // bid adjustment). Left out, a draft whose only criterion change is one printed no line at all.\n  if ((collection.updated ?? 0) > 0) {\n    parts.push(`~${collection.updated}`);\n  }\n  return parts.length > 0 ? `${collection.label}: ${parts.join(\", \")}` : undefined;\n}\n\n/**\n * Every advertiser account the tree touches. A draft may legitimately span\n * several, and a criterion id is derived from the keyword's text and match type\n * — so the same keyword carries the same id in every account. The account is\n * printed on each node once there is more than one, and left off when there is not.\n */\nfunction accountsInTree(nodes: readonly GoogleDraftStatusNode[]): Set<string> {\n  const accounts = new Set<string>();\n  const walk = (node: GoogleDraftStatusNode): void => {\n    accounts.add(node.customerId);\n    for (const child of node.children) {\n      walk(child);\n    }\n  };\n  for (const node of nodes) {\n    walk(node);\n  }\n  return accounts;\n}\n\nfunction renderNode(node: GoogleDraftStatusNode, depth: number, lines: string[], showAccount: boolean): void {\n  const indent = \"  \".repeat(depth);\n  const account = showAccount ? ` · account ${node.customerId}` : \"\";\n  lines.push(`${indent}• ${node.name} · ${badge(node)}${account}`);\n  for (const warning of node.warnings ?? []) {\n    lines.push(`${indent}    ⚠ ${warning}`);\n  }\n  for (const collection of node.collections) {\n    const line = collectionLine(collection);\n    if (line) {\n      lines.push(`${indent}    ${line}`);\n    }\n  }\n  for (const child of node.children) {\n    renderNode(child, depth + 1, lines, showAccount);\n  }\n}\n\nconst RESOURCE_ENTITIES = new Set([\n  \"sharedSet\",\n  \"biddingStrategy\",\n  \"audience\",\n  \"conversionAction\",\n  \"label\",\n  \"budget\",\n  \"asset\",\n]);\n\nfunction renderSection(title: string, nodes: GoogleDraftStatusNode[], lines: string[], showAccount: boolean): void {\n  if (nodes.length === 0) {\n    return;\n  }\n  lines.push(\"\");\n  lines.push(title);\n  for (const node of nodes) {\n    renderNode(node, 1, lines, showAccount);\n  }\n}\n\nfunction renderAdvisories(data: GoogleDraftListResponse, lines: string[]): void {\n  const advisories = data.advisories ?? [];\n  // Every advisory is phrased as something to settle BEFORE publishing. On a published draft there\n  // is nothing left to settle here, and printing them reads as work still outstanding on this chat.\n  if (advisories.length === 0 || data.status === \"applied\") {\n    return;\n  }\n  lines.push(\"\");\n  // Two kinds of finding share this block: build-out nudges (\"this ad group has one ad\") and\n  // whole-draft coherence findings (\"this campaign will report zero conversions\", \"two of your\n  // campaigns bid on the same keyword\"). The coherence ones come first and cost money, so the\n  // heading no longer frames the block as optional polish.\n  lines.push(\"Advisories (non-blocking, checked across the whole draft — settle these before you publish)\");\n  for (const advisory of advisories) {\n    lines.push(`  • ${advisory.message}`);\n  }\n}\n\n/**\n * What the publish did, once there is a publish to report.\n *\n * A published Google Ads draft rendered exactly like a staged one — same count, every op still\n * reading \"Creating\" — so the surface `.claude/rules/cli-env.md` sends an agent to for the outcome\n * could not answer, and a failed op was invisible in the human output while sitting in the JSON\n * envelope the whole time. Found by publishing a BUSINESS_LOGO link that Google refused with\n * \"Customer is not verified\": the draft still read \"4 staged changes\". LinkedIn fixed the same\n * shape first; this is its counterpart.\n */\nfunction renderOutcome(data: GoogleDraftListResponse, lines: string[]): void {\n  const counts = new Map<string, number>();\n  for (const op of data.ops) {\n    const status = op.result?.status ?? \"pending\";\n    counts.set(status, (counts.get(status) ?? 0) + 1);\n  }\n  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(\", \");\n  lines.push(`Google Ads — published · ${summary || `${data.count} op(s)`} · ${data.mode}`);\n  // A failure is the reason to read this at all, so it is named with its error rather than left as\n  // a number to go and look up.\n  for (const op of data.ops) {\n    const status = op.result?.status;\n    if (status !== \"failed\" && status !== \"skipped\") {\n      continue;\n    }\n    const reason = op.result?.error ?? op.result?.skippedBecause ?? \"no reason recorded\";\n    lines.push(`  ✗ ${op.summary} — ${status}: ${reason}`);\n  }\n}\n\nexport function renderDraftStatus(data: GoogleDraftListResponse): string {\n  if (data.status === \"none\" || data.count === 0) {\n    return \"No staged Google Ads changes on this chat.\";\n  }\n  const modeNote =\n    data.mode === \"live\"\n      ? \"Live — publishing writes directly to Google Ads.\"\n      : \"Simulated — publishing completes the whole draft without calling Google Ads.\";\n  const lines: string[] = [];\n  if (data.status === \"applied\") {\n    renderOutcome(data, lines);\n  } else if (data.status === \"publishing\") {\n    lines.push(`Google Ads — publishing ${data.count} change${data.count === 1 ? \"\" : \"s\"} · ${data.mode}`);\n  } else {\n    lines.push(`Google Ads — ${data.count} staged change${data.count === 1 ? \"\" : \"s\"} · ${data.mode}`);\n  }\n  lines.push(modeNote);\n\n  const tree = data.tree ?? [];\n  const showAccount = accountsInTree(tree).size > 1;\n  renderSection(\n    \"Shared resources\",\n    tree.filter((node) => RESOURCE_ENTITIES.has(node.entity)),\n    lines,\n    showAccount,\n  );\n  renderSection(\n    \"Campaigns\",\n    tree.filter((node) => node.entity === \"campaign\"),\n    lines,\n    showAccount,\n  );\n  const rest = tree.filter((node) => !RESOURCE_ENTITIES.has(node.entity) && node.entity !== \"campaign\");\n  renderSection(\"Other\", rest, lines, showAccount);\n  renderAdvisories(data, lines);\n\n  return lines.join(\"\\n\");\n}\n","import { cacheGet, cacheSet } from \"../cache.ts\";\n\n/**\n * Bulk work done as a loop of single commands — one `keywords update` per keyword, one\n * `negative-keywords remove` per term — is one request, one rate-limit hit and one tool call per row;\n * production saw 1,284 of them. The CLI cannot see the loop from inside one call, so it remembers the\n * last few single stages per chat and, once the same kind repeats, says how to do the rest in one call.\n */\n\nexport interface StageStreak {\n  kind: string;\n  count: number;\n  lastAt: number;\n}\n\n/** Singles further apart than this are separate decisions, not a loop. */\nconst STREAK_WINDOW_MS = 5 * 60_000;\n/** The streak length that reads as a loop. */\nconst STREAK_THRESHOLD = 5;\n\nexport function nextStageStreak(previous: StageStreak | undefined, kind: string, now: number): StageStreak {\n  const continues = previous && previous.kind === kind && now - previous.lastAt <= STREAK_WINDOW_MS;\n  return { kind, count: continues ? previous.count + 1 : 1, lastAt: now };\n}\n\n/** The one-call form of a kind, where a command has one beside `draft stage --file`. */\nconst BATCH_FORMS: Record<string, string> = {\n  \"google.keyword.add\": \"`keywords add --file keywords.txt` (one term[:MATCH_TYPE] per line)\",\n  \"google.keyword.update\":\n    \"`keywords pause|resume <resource name> <resource name>…` (or --file, one per line) for status\",\n  \"google.keyword.remove\": \"`draft stage --file` with one google.keyword.remove per target\",\n  \"google.negativeKeyword.add\": \"`negative-keywords add --file terms.txt`\",\n  \"google.sharedSetMember.add\": \"`keyword-lists add --file terms.txt`\",\n  \"google.sharedSetMember.remove\": '`keyword-lists remove --list-ref <id> --text \"a,b,c\"`',\n};\n\nexport function stageStreakHints(streak: StageStreak): string[] {\n  if (streak.count < STREAK_THRESHOLD) {\n    return [];\n  }\n  const form = BATCH_FORMS[streak.kind];\n  return [\n    `LOOP: that is ${streak.count} ${streak.kind} ops staged one command at a time. Stop looping — put every remaining change in one file and stage them in ONE call: \\`baker ads google draft stage --file ops.json --customer-id <id>\\` (a JSON array of {\"kind\",\"target\"?,\"payload\"?}, up to 500, any mix of kinds)${form ? `, or ${form}` : \"\"}. Fix staged ops together with \\`draft amend --file\\`.`,\n  ];\n}\n\nconst STREAK_CACHE = \"stage-streak\";\n\n/** Record one single stage on this chat and return the nudge it earns, if any. Never throws. */\nexport function recordSingleStage(chatId: string, kind: string): string[] {\n  try {\n    const streak = nextStageStreak(cacheGet<StageStreak>(STREAK_CACHE, chatId)?.data, kind, Date.now());\n    cacheSet(STREAK_CACHE, chatId, streak, STREAK_WINDOW_MS);\n    return stageStreakHints(streak);\n  } catch {\n    return [];\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-GX6VAHY7.js → chunk-5FWMRTNB.js}

@@ -3,7 +3,7 @@ import {
   CHANGE_SCOPE_MAX_DAYS,
   DEFAULT_CHANGE_DAYS,
   isChangeLookbackWithinReach
-} from "./chunk-XCM6XWOB.js";
+} from "./chunk-7VHPAGPK.js";
 import {
   connectionFixExplanation,
   isNotConnectedError
@@ -236,6 +236,10 @@ var LIST_FIELDS = /* @__PURE__ */ new Set([
   "experiment_arm.campaigns",
   "experiment_arm.in_design_campaigns",
   "keyword_plan_campaign.language_constants",
+  "lift_measurement_config.campaigns",
+  "lift_measurement_config.conversion_actions",
+  "lift_measurement_config.single_measurement_question_set.competitor_choices",
+  "lift_measurement_config.single_measurement_question_set.question_measurements",
   "local_services_employee.category_ids",
   "local_services_employee.languages_spoken",
   "metrics.interaction_event_types",
@@ -437,18 +441,6 @@ var CORRECTION_RULES = [
       };
     }
   },
-  // 9. Missing LIMIT
-  {
-    matchQuery: /^(?!.*\bLIMIT\b)/is,
-    fix: (ctx) => {
-      const corrected = `${ctx.originalQuery.trimEnd()} LIMIT 200`;
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Added LIMIT 200 to prevent excessive data transfer"
-      };
-    }
-  },
   // 10a. Customer not found (wrong customer ID)
   {
     matchApiError: /CUSTOMER_NOT_FOUND|not.*found.*customer/i,
@@ -703,6 +695,30 @@ var CORRECTION_RULES = [
       };
     }
   },
+  // 22b. A field this API version does not have (removed, renamed, or misspelled). The rules above
+  // rewrite the known renames; anything left is named back so the agent drops or replaces it —
+  // without this, "invalid argument … field" fell through to the bare-resource rule below.
+  {
+    matchApiError: /UNRECOGNIZED_FIELD|Unrecognized field in the query/i,
+    fix: (ctx) => {
+      const field = ctx.apiErrorMessage?.match(/Unrecognized field in the query:\s*\\?'([\w.]+)/i)?.[1];
+      return {
+        action: "retry_with_modified_query",
+        explanation: field ? `${field} does not exist in this Google Ads API version (removed, renamed or misspelled). Drop it, or find its replacement in Google's field reference for that resource.` : "A field in this query does not exist in this Google Ads API version. Drop it, or find its replacement in Google's field reference."
+      };
+    }
+  },
+  // 22c. A field that exists but cannot be SELECTed (only filtered on, or read through another resource).
+  {
+    matchApiError: /PROHIBITED_FIELD_IN_SELECT_CLAUSE|may not be used in SELECT clause/i,
+    fix: (ctx) => {
+      const field = ctx.apiErrorMessage?.match(/may not be used in SELECT clause:\s*\\?'([\w.]+)/i)?.[1];
+      return {
+        action: "retry_with_modified_query",
+        explanation: `${field ?? "A field in this query"} cannot be selected \u2014 Google allows it only in WHERE, or not at all on this resource. Drop it from SELECT.`
+      };
+    }
+  },
   // 23. Bare resource in SELECT
   {
     matchApiError: /cannot.*select.*bare.*resource|invalid.*field/i,
@@ -822,9 +838,9 @@ export {
   isDuringLiteral,
   equivalentBetween,
   duringLiteralExplanation,
-  resolveChangesWindow,
   LIST_FIELDS,
   listFieldGuidance,
+  resolveChangesWindow,
   parseApiError
 };
-//# sourceMappingURL=chunk-GX6VAHY7.js.map
+//# sourceMappingURL=chunk-5FWMRTNB.js.map