@koda-sl/baker-cli 0.572.0 → 0.574.0-dev.19539e5a8

package/dist/draft-WK4PEMB6.js

@@ -0,0 +1,614 @@
+import {
+  draftRefs,
+  removeDraftRefs
+} from "./chunk-V7EN5LFS.js";
+import {
+  draftAction,
+  draftListAction,
+  failWriteValidation,
+  handleGoogleError,
+  loadJsonPayloads,
+  loadPatchArg,
+  requireCustomerId,
+  requireTarget,
+  showAccountHint,
+  stageGoogleOps,
+  validateAccountHint
+} from "./chunk-FWYWLEDP.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-YRWCXYWW.js";
+import "./chunk-4NZ47VXO.js";
+import {
+  withHints
+} from "./chunk-D5FY4FAK.js";
+import "./chunk-BIBXZJZI.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-WZXMZFVB.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MPTNN35I.js";
+import "./chunk-Q3G4ZI2U.js";
+import "./chunk-DGHSXHZR.js";
+import "./chunk-Q736UFSD.js";
+import "./chunk-CBVUO7SK.js";
+import "./chunk-UK4XSLV2.js";
+import "./chunk-O5VSYBUA.js";
+import {
+  CHAT_READ_ARG,
+  DRAFT_FULL_ARG
+} from "./chunk-X32MFGWW.js";
+import "./chunk-R7XDGNZD.js";
+import {
+  GOOGLE_DRAFT_BATCH_MAX
+} from "./chunk-IMS53EQU.js";
+import {
+  apiPost
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-B64KJW5C.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/draft.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/google/draft-batch.ts
+function refuseOversized(count, what) {
+  if (count > GOOGLE_DRAFT_BATCH_MAX) {
+    failWriteValidation(
+      `${count} ${what} exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} \u2014 split the file and run the command once per part`
+    );
+  }
+}
+function stageFileOps(items, customerId) {
+  if (items.length === 0) {
+    failWriteValidation(
+      'pass --file with the ops to stage: a JSON array (or JSON Lines) of {"kind","customerId","target"?,"payload"?}'
+    );
+  }
+  refuseOversized(items.length, "ops");
+  return items.map((item, index) => {
+    if (typeof item.kind !== "string") {
+      failWriteValidation(
+        `item ${index} has no "kind" \u2014 every item is a whole op, e.g. {"kind":"google.keyword.add",\u2026}`
+      );
+    }
+    return item.customerId === void 0 && customerId ? { ...item, customerId } : item;
+  });
+}
+function amendBatchEntries(items) {
+  refuseOversized(items.length, "amends");
+  return items.map((item, index) => {
+    const { ref, patch } = item;
+    if (typeof ref !== "string" || ref.length === 0) {
+      failWriteValidation(`item ${index} has no "ref" \u2014 name the staged op (g_temp_* or its target) to amend`);
+    }
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+      failWriteValidation(`item ${index} has no "patch" object \u2014 {"ref":"\u2026","patch":{\u2026fields to change\u2026}}`);
+    }
+    return { ref, patch };
+  });
+}
+
+// src/commands/ads/google/draft-validate.ts
+var QUIET = /* @__PURE__ */ new Set(["accepted", "applied"]);
+function changes(n) {
+  return n === 1 ? "1 change" : `${n} changes`;
+}
+function validationHints(data) {
+  const { refused, blocked, unchecked } = data.counts;
+  const hints = [];
+  if (refused > 0) {
+    hints.push(
+      `${changes(refused)} would fail at publish. Fix each refused op in place with \`draft amend <ref>\` (or \`draft remove <ref>\` if it should not exist), then run \`draft validate\` again before asking the user to publish. Never tell the user a refused change will go live.`
+    );
+  }
+  if (blocked > 0) {
+    hints.push(
+      `${changes(blocked)} would not apply only because a refused change they depend on fails \u2014 fixing the refused one clears them.`
+    );
+  }
+  if (data.publishHeld) {
+    hints.push(
+      "Baker would hold this whole publish: a refused change stops a first publish from sending anything. Fix it first."
+    );
+  }
+  if (unchecked > 0) {
+    hints.push(
+      `${changes(unchecked)} can only be checked by Google at publish (the reason is on each one). Nothing here says they will fail.`
+    );
+  }
+  if (refused + blocked === 0 && !data.publishHeld && data.ops.length > 0) {
+    hints.push(
+      "Google accepted every change it was asked about. The draft is ready for the user to review and publish."
+    );
+  }
+  if (data.dailyLimit) {
+    hints.push(
+      `Not every change may go live the moment the user publishes: Baker sends what Google Ads takes then and the rest again on its own, all by about ${data.dailyLimit.fitsAt}, with nothing for the user to do. If you tell the user anything, say only that some changes will go live over the next hours and by when, in their time zone. Never mention a daily limit, quota, allowance or number of operations, and never ask them to cut down or split their work for it.`
+    );
+  }
+  return hints;
+}
+function validationEnvelope(data, full = false) {
+  const ops = full ? data.ops : data.ops.filter((op) => !QUIET.has(op.verdict));
+  return { ok: true, data: { ...data, ops }, hints: validationHints(data) };
+}
+
+// src/commands/ads/google/draft-where.ts
+function parseDraftWhere(value) {
+  const where = { kinds: [], under: [], fields: {} };
+  const pairs = value.split(",").map((pair) => pair.trim()).filter(Boolean);
+  if (pairs.length === 0) return { error: "--where names no condition" };
+  for (const pair of pairs) {
+    const eq = pair.indexOf("=");
+    const key = pair.slice(0, eq).trim();
+    const values = pair.slice(eq + 1).split("|").map((v) => v.trim()).filter(Boolean);
+    if (eq <= 0 || values.length === 0) return { error: `--where condition "${pair}" is not key=value` };
+    if (key === "kind") where.kinds.push(...values.map((k) => k.startsWith("google.") ? k : `google.${k}`));
+    else if (key === "under") where.under.push(...values);
+    else where.fields[key] = [...where.fields[key] ?? [], ...values];
+  }
+  return where;
+}
+function payloadOf(op) {
+  return typeof op.payload === "object" && op.payload !== null ? op.payload : {};
+}
+function parentsOf(op, byRef) {
+  const seen = /* @__PURE__ */ new Set();
+  const queue = [op];
+  for (let current = queue.shift(); current; current = queue.shift()) {
+    const named = Object.values(payloadOf(current)).filter((v) => typeof v === "string");
+    for (const parent of [...current.dependsOn, ...named]) {
+      if (seen.has(parent)) continue;
+      seen.add(parent);
+      const staged = byRef.get(parent);
+      if (staged) queue.push(staged);
+    }
+  }
+  return seen;
+}
+function selectDraftRefs(ops, where) {
+  const byRef = new Map(ops.map((op) => [op.ref, op]));
+  return ops.filter((op) => {
+    if (where.kinds.length > 0 && !where.kinds.includes(op.kind)) return false;
+    if (where.under.length > 0) {
+      const parents = parentsOf(op, byRef);
+      if (!where.under.some((ref) => parents.has(ref))) return false;
+    }
+    const payload = payloadOf(op);
+    return Object.entries(where.fields).every(([key, values]) => {
+      const actual = payload[key];
+      if (typeof actual !== "string" && typeof actual !== "number" && typeof actual !== "boolean") return false;
+      return values.some((v) => v.toLowerCase() === String(actual).toLowerCase());
+    });
+  }).map((op) => op.ref);
+}
+
+// src/commands/ads/google/draft.ts
+var DRAFT_ACCOUNT_ARG = {
+  type: "string",
+  description: "10-digit customer id. A draft is per chat and may span accounts: `list` narrows to this one; `validate` and `show` still answer for the whole draft",
+  required: false
+};
+var VALIDATE_DESCRIPTION = `Ask Google whether the whole staged draft would publish \u2014 without applying anything.
+
+Start here, after the last staged change and before telling the user the draft is ready:
+  baker ads google draft validate
+
+Every staged op is built, batched and sent exactly as publish sends it, with Google's validateOnly
+flag, so each verdict is the answer publish would get: accepted | refused | blocked (a change it
+depends on was refused) | unchecked (only publish can check it) | applied (an earlier publish did).
+Compact by default \u2014 counts, plus only the ops that need attention, each with Google's reason.
+Fix refused ops with \`draft amend <ref>\` and validate again.
+
+It also reads Baker's day of Google Ads changes, shared by every company. When the draft does
+not all fit in what is left, the answer carries dailyLimit: operations, room and fitsAt (ISO, when
+all of it should have gone). Publish still works: Baker sends what Google Ads takes and the rest
+again on its own. Never mention the limit, a quota or operation counts to the user, and never ask
+them to cut down or split their work for it; say only that some changes go live over the next
+hours, and by when.
+
+Examples:
+  baker ads google draft validate
+  baker ads google draft validate --full   # every op, with its built request and Google's raw answer`;
+registerSchema({
+  command: "ads.google.draft.validate",
+  description: VALIDATE_DESCRIPTION,
+  args: {
+    full: {
+      type: "boolean",
+      description: "List every op with its built request and Google's raw answer",
+      required: false
+    },
+    "customer-id": DRAFT_ACCOUNT_ARG
+  }
+});
+var STAGE_DESCRIPTION = `Stage many Google Ads changes from ONE file, in one call \u2014 any mix of kinds, up to 500 ops.
+
+Start here whenever a change touches more than a few rows (a keyword cleanup, bid changes, pausing
+ads, a list of negatives): write the ops to a file and stage them together instead of running one
+command per row.
+  baker ads google draft stage --file changes.json --customer-id 1234567890
+
+The file is a JSON array (or JSON Lines, one op per line). Each op is what the single commands
+build \u2014 kind, customerId (or --customer-id for all), target for a change to something that exists,
+payload. Read the shape for a kind with \`baker capabilities google-ads\`.
+  [
+    {"kind":"google.keyword.add","payload":{"adGroup":"customers/1234567890/adGroups/111","text":"solar panels","matchType":"PHRASE"}},
+    {"kind":"google.keyword.update","target":"customers/1234567890/adGroupCriteria/111~222","payload":{"status":"PAUSED"}},
+    {"kind":"google.negativeKeyword.add","payload":{"level":"campaign","parent":"222333","text":"free","matchType":"BROAD"}}
+  ]
+An op may name a g_temp_* ref an EARLIER call returned (a campaign or ad group staged before), but
+not another op in the same file \u2014 a ref exists only once its op is staged, so stage new parents first.
+All-or-nothing: one invalid op stages nothing. Ops already in effect come back as skipped.
+Then: baker ads google draft validate`;
+registerSchema({
+  command: "ads.google.draft.stage",
+  description: STAGE_DESCRIPTION,
+  args: {
+    file: {
+      type: "string",
+      description: "JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline",
+      required: true
+    },
+    "customer-id": {
+      type: "string",
+      description: "10-digit customer id for every op that does not name its own",
+      required: false
+    }
+  }
+});
+var IMPORT_DESCRIPTION = `Move another unpublished chat's staged Google Ads changes into this chat, in one call \u2014 and out of that chat, so the two can never publish the same change twice.
+
+Start here when the user wants another chat's changes brought into this one ("bring over", "merge",
+"include what the other chat prepared", "all of them except \u2026"):
+  baker ads google draft import --from-chat <chat-id>
+  baker ads google draft import --from-chat <chat-id> --exclude g_temp_a,customers/123/adGroupAds/4~5
+  baker ads google draft import --from-chat <chat-id> --refs g_temp_b
+
+Every op moves exactly as it was staged \u2014 same ref, same payload, nothing retyped \u2014 so never copy
+another chat's changes with \`draft show --chat\` and re-stage them. An op moves with the creates it
+depends on and the ops that depend on it (an asset and the link that attaches it go together).
+The other chat must be unpublished \u2014 still open, or its publish failed (a discarded chat's Google Ads
+changes are gone with it); its other work (Knowledge, Tasks) stays where it is. A published chat's changes its publish could not apply come
+with \`baker chats import --from-chat <chat-id> --failed\` instead. Find chat ids
+with \`baker chats list\`, and refs with \`baker ads google draft list --chat <chat-id> --json\`.
+Then: baker ads google draft validate`;
+registerSchema({
+  command: "ads.google.draft.import",
+  description: IMPORT_DESCRIPTION,
+  args: {
+    "from-chat": {
+      type: "string",
+      description: "The other unpublished chat (open, or its publish failed) whose staged changes move here",
+      required: true
+    },
+    refs: {
+      type: "string",
+      description: "Comma-separated refs to move (default: all); what they depend on comes too",
+      required: false
+    },
+    exclude: {
+      type: "string",
+      description: "Comma-separated refs to leave in the other chat, with the ops that depend on them",
+      required: false
+    }
+  }
+});
+var LIST_DESCRIPTION = "Review everything staged as a campaign \u25B8 ad group \u25B8 ad tree (--json for the raw envelope, --full for every op's payload too)";
+registerSchema({
+  command: "ads.google.draft.list",
+  description: LIST_DESCRIPTION,
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree", required: false },
+    full: { type: "boolean", description: DRAFT_FULL_ARG.description, required: false },
+    chat: { type: "string", description: CHAT_READ_ARG.description, required: false },
+    "customer-id": DRAFT_ACCOUNT_ARG
+  }
+});
+var WHERE_ARGS = {
+  where: {
+    type: "string",
+    description: "Select staged ops instead of naming refs: comma-separated key=value \u2014 kind (op kind), under (a campaign/ad group ref or resource name the op sits under), or any payload field (matchType, text, level, parent\u2026); `|` for alternatives",
+    required: false
+  },
+  "dry-run": { type: "boolean", description: "Print the refs that would change, and change nothing", required: false }
+};
+var REMOVE_DESCRIPTION = `Remove staged ops \u2014 one, many, or every op a selector matches, in one call. Each removal cascades to the ops that depend on it.
+
+  baker ads google draft remove g_temp_a
+  baker ads google draft remove g_temp_a g_temp_b g_temp_c     # or g_temp_a,g_temp_b,g_temp_c
+  baker ads google draft remove --where 'kind=google.negativeKeyword.add,text=twilio|baileys'
+  baker ads google draft remove --where kind=google.keyword.add,under=g_temp_c1 --dry-run
+
+Prints one summary: every op removed (cascades listed once), and any ref the draft did not hold.`;
+var REMOVE_ARGS = {
+  ref: {
+    type: "positional",
+    description: "Staged op ref(s) (g_temp_* or target) \u2014 several, space- or comma-separated",
+    required: false
+  },
+  ...WHERE_ARGS
+};
+registerSchema({ command: "ads.google.draft.remove", description: REMOVE_DESCRIPTION, args: REMOVE_ARGS });
+var AMEND_DESCRIPTION = `Update staged ops in place \u2014 merges a JSON patch into each payload (RFC-7386: objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create.
+
+  baker ads google draft amend g_temp_a --patch '{"cpcBidMicros":1500000}'
+  baker ads google draft amend g_temp_a g_temp_b --patch '{"status":"ENABLED"}'      # same patch, many refs
+  baker ads google draft amend --where kind=google.keyword.add,under=g_temp_c1,matchType=EXACT --patch '{"matchType":"BROAD"}'
+  baker ads google draft amend --file amends.json      # [{"ref":"g_temp_\u2026","patch":{\u2026}}, \u2026] \u2014 a patch per ref
+
+Many refs are amended in one call, all or none: one refused amend changes nothing.`;
+var AMEND_ARGS = {
+  ref: {
+    type: "positional",
+    description: "Staged op ref(s) (g_temp_*) or target id/resource name \u2014 several, space- or comma-separated, take the same patch; leave out to amend many from --file",
+    required: false
+  },
+  file: {
+    type: "string",
+    description: 'JSON file with the patch object \u2014 or, with no ref, a JSON array of {"ref","patch"} amends',
+    required: false
+  },
+  patch: { type: "string", description: "Inline JSON patch object", required: false },
+  ...WHERE_ARGS
+};
+registerSchema({ command: "ads.google.draft.amend", description: AMEND_DESCRIPTION, args: AMEND_ARGS });
+async function refsWhere(args) {
+  if (typeof args.where !== "string") return void 0;
+  const where = parseDraftWhere(args.where);
+  if ("error" in where) failWriteValidation(where.error);
+  if (draftRefs(args._).length > 0) failWriteValidation("pass refs or --where, not both");
+  let ops = [];
+  try {
+    const response = await apiPost("/api/ads/google/draft", {
+      chatId: requireChatId(),
+      full: true
+    });
+    ops = response.data?.ops ?? [];
+  } catch (err) {
+    handleGoogleError(err);
+  }
+  const refs = selectDraftRefs(ops, where);
+  if (refs.length === 0) {
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "NOT_FOUND",
+        message: `--where ${args.where} matches no staged op`,
+        fix: "Read the staged ops' kinds and payload fields with `baker ads google draft list --full`, then adjust the selector."
+      }
+    });
+    process.exit(1);
+  }
+  return refs;
+}
+function printDryRun(refs) {
+  writeJsonEnvelope({
+    ok: true,
+    data: { matched: refs.length, refs },
+    hints: ["Nothing changed. Run it again without --dry-run to apply it."]
+  });
+}
+function refList(value) {
+  if (typeof value !== "string") return void 0;
+  const refs = value.split(",").map((ref) => ref.trim()).filter((ref) => ref.length > 0);
+  return refs.length > 0 ? refs : null;
+}
+function importHints(fromChatId, data) {
+  const source = data.sourceRemaining > 0 ? `Chat ${fromChatId} still has ${data.sourceRemaining} Google Ads change(s) staged, which publish with that chat.` : `Chat ${fromChatId} has no Google Ads changes staged any more, so publishing it cannot apply these twice. Its other work stays there \u2014 never tell the user to discard it for this.`;
+  return [source, "Run `baker ads google draft validate` next."];
+}
+var BULK_STAGE_HINTS = [
+  "Run `baker ads google draft validate` next: it asks Google about every staged op at once and lists only the ones it would refuse.",
+  'To fix several staged ops, amend them together: `baker ads google draft amend --file amends.json` with [{"ref":"\u2026","patch":{\u2026}}, \u2026].'
+];
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "Stage many ops from one file, or list, validate, remove, clear, amend, or show staged Google Ads write ops for this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead; `import --from-chat <id>` moves another unpublished chat's staged changes here (open, or its publish failed)."
+  },
+  subCommands: {
+    stage: defineCommand({
+      meta: { name: "stage", description: STAGE_DESCRIPTION },
+      args: {
+        file: {
+          type: "string",
+          description: "JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline"
+        },
+        "customer-id": { type: "string", description: "10-digit customer id for every op that does not name its own" }
+      },
+      run: async ({ args }) => {
+        const customerId = typeof args["customer-id"] === "string" ? args["customer-id"] : void 0;
+        await stageGoogleOps(stageFileOps(loadJsonPayloads(args.file), customerId), BULK_STAGE_HINTS);
+      }
+    }),
+    import: defineCommand({
+      meta: { name: "import", description: IMPORT_DESCRIPTION },
+      args: {
+        "from-chat": {
+          type: "string",
+          description: "The other unpublished chat (open, or its publish failed) whose staged changes move here"
+        },
+        refs: { type: "string", description: "Comma-separated refs to move (default: all)" },
+        exclude: { type: "string", description: "Comma-separated refs to leave in the other chat" }
+      },
+      run: async ({ args }) => {
+        const fromChatId = typeof args["from-chat"] === "string" ? args["from-chat"].trim() : "";
+        if (!fromChatId) {
+          writeJsonEnvelope({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: "--from-chat is required",
+              fix: "Name the other chat: baker ads google draft import --from-chat <chat-id> (ids from `baker chats list`)."
+            }
+          });
+          process.exit(1);
+        }
+        const refs = refList(args.refs);
+        const exclude = refList(args.exclude);
+        const empty = refs === null ? "--refs" : exclude === null ? "--exclude" : void 0;
+        if (empty) {
+          writeJsonEnvelope({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: `${empty} names no change`,
+              fix: `Pass the refs, comma-separated (from \`baker ads google draft list --chat ${fromChatId} --json\`), or leave ${empty} off to move every change.`
+            }
+          });
+          process.exit(1);
+        }
+        try {
+          const response = await apiPost(
+            "/api/ads/google/draft/import",
+            { chatId: requireChatId(), fromChatId, refs: refs ?? void 0, exclude: exclude ?? void 0 }
+          );
+          writeJsonEnvelope(
+            response.ok && response.data ? { ...response, hints: importHints(fromChatId, response.data) } : response
+          );
+        } catch (err) {
+          handleGoogleError(err);
+        }
+      }
+    }),
+    list: defineCommand({
+      meta: {
+        name: "list",
+        description: LIST_DESCRIPTION
+      },
+      args: {
+        json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+        full: DRAFT_FULL_ARG,
+        chat: CHAT_READ_ARG,
+        "customer-id": DRAFT_ACCOUNT_ARG
+      },
+      run: async ({ args }) => {
+        const customerId = args["customer-id"] === void 0 ? void 0 : requireCustomerId(args);
+        await draftListAction(args.json === true, args.chat, args.full === true, customerId);
+      }
+    }),
+    remove: defineCommand({
+      meta: { name: "remove", description: REMOVE_DESCRIPTION },
+      args: REMOVE_ARGS,
+      run: async ({ args }) => {
+        const selected = await refsWhere(args);
+        const refs = selected ?? draftRefs(args._);
+        if (args["dry-run"] === true) {
+          printDryRun(refs);
+          return;
+        }
+        if (selected || refs.length > 1) {
+          await removeDraftRefs("/api/ads/google/draft/remove", refs);
+          return;
+        }
+        await draftAction("/api/ads/google/draft/remove", { ref: requireTarget(args, "op") });
+      }
+    }),
+    clear: defineCommand({
+      meta: { name: "clear", description: "Discard all staged ops on this chat" },
+      run: async () => {
+        await draftAction("/api/ads/google/draft/clear", {});
+      }
+    }),
+    amend: defineCommand({
+      meta: { name: "amend", description: AMEND_DESCRIPTION },
+      args: AMEND_ARGS,
+      run: async ({ args }) => {
+        const selected = await refsWhere(args);
+        const positional = Array.isArray(args._) ? args._[0] : void 0;
+        if (!selected && !(args.ref ?? positional) && typeof args.file === "string" && args.file.length > 0) {
+          const amends = amendBatchEntries(loadJsonPayloads(args.file));
+          if (args["dry-run"] === true) {
+            printDryRun(amends.map((amend) => amend.ref));
+            return;
+          }
+          await draftAction("/api/ads/google/draft/amend-batch", { amends });
+          return;
+        }
+        const refs = selected ?? draftRefs(args._);
+        if (args["dry-run"] === true) {
+          printDryRun(refs);
+          return;
+        }
+        if (selected || refs.length > 1) {
+          const patch2 = loadPatchArg(args);
+          await draftAction("/api/ads/google/draft/amend-batch", { amends: refs.map((ref2) => ({ ref: ref2, patch: patch2 })) });
+          return;
+        }
+        const ref = requireTarget(args, "op");
+        const patch = loadPatchArg(args);
+        await draftAction("/api/ads/google/draft/amend", { ref, patch });
+      }
+    }),
+    validate: defineCommand({
+      meta: { name: "validate", description: VALIDATE_DESCRIPTION },
+      args: {
+        full: { type: "boolean", description: "List every op with its built request and Google's raw answer" },
+        "customer-id": DRAFT_ACCOUNT_ARG
+      },
+      run: async ({ args }) => {
+        try {
+          const full = args.full === true;
+          const response = await apiPost(
+            "/api/ads/google/draft/validate",
+            { chatId: requireChatId(), full }
+          );
+          if (!response.ok || !response.data) {
+            writeJsonEnvelope(response);
+            return;
+          }
+          const envelope = validationEnvelope(response.data, full);
+          const customerId = args["customer-id"];
+          writeJsonEnvelope(
+            typeof customerId === "string" ? { ...envelope, hints: [...envelope.hints, validateAccountHint(customerId)] } : envelope
+          );
+        } catch (err) {
+          handleGoogleError(err);
+        }
+      }
+    }),
+    show: defineCommand({
+      meta: {
+        name: "show",
+        description: "Print the full staged payload for one op \u2014 the receipt to verify a change looks right before publish (never truncated)."
+      },
+      args: {
+        ref: {
+          type: "positional",
+          description: "Staged op ref (g_temp_*) or target id/resource name",
+          required: false
+        },
+        chat: CHAT_READ_ARG,
+        "customer-id": DRAFT_ACCOUNT_ARG
+      },
+      run: async ({ args }) => {
+        const ref = requireTarget(args, "op");
+        const customerId = args["customer-id"];
+        try {
+          const response = await apiPost(
+            "/api/ads/google/draft/show",
+            { chatId: resolveChatId(args.chat), ref }
+          );
+          const hint = typeof customerId === "string" && response.data ? showAccountHint(customerId, response.data.op.customerId) : void 0;
+          writeJsonEnvelope(hint ? withHints(response, [hint]) : response);
+        } catch (err) {
+          handleGoogleError(err);
+        }
+      }
+    })
+  }
+});
+export {
+  BULK_STAGE_HINTS,
+  draftCommand,
+  importHints
+};
+//# sourceMappingURL=draft-WK4PEMB6.js.map