@koda-sl/baker-cli 0.540.0 → 0.541.0-dev.b27330e67

package/dist/domain-A4IVVFI6.js

@@ -0,0 +1,101 @@
+import {
+  failSite
+} from "./chunk-OATKGUUI.js";
+import "./chunk-FSHIEGAY.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-BNO3EFGR.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import {
+  optionalChatId,
+  requireChatId
+} from "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/site/domain.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "site.domain.add",
+  description: "Stage connecting a custom domain (a subdomain such as shop.acme.com \u2014 not the bare acme.com) to the company's landings. Applies when the chat is published; then Baker starts verifying it. The client must add a CNAME record pointing the hostname at customers.withbaker.com \u2014 the response's hints give the exact record to ask for. Refused at once when another company already registered it or the company is at its domain limit.",
+  args: { hostname: { type: "string", description: "The subdomain to connect, e.g. shop.acme.com", required: true } }
+});
+registerSchema({
+  command: "site.domain.list",
+  description: "Every custom domain of the company and its status: pending_verification (waiting for the DNS record \u2014 `message` says what is missing), active (live), error, or staged (this chat adds it at publish). Read-only.",
+  args: {}
+});
+registerSchema({
+  command: "site.domain.verify",
+  description: "Re-check a domain that is waiting for verification now instead of waiting for the background check (every few minutes). Use after the client says they added the DNS record. Returns its state and, if it is not live yet, what is still missing. A staged domain cannot be checked until the chat is published.",
+  args: { hostname: { type: "string", description: "A domain from `baker site domain list`", required: true } }
+});
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Stage connecting a custom domain; applies at publish. The client adds a CNAME to customers.withbaker.com.\n\nExample: baker site domain add shop.acme.com"
+  },
+  args: { hostname: { type: "positional", description: "Subdomain, e.g. shop.acme.com", required: true } },
+  run: async ({ args }) => {
+    try {
+      const body = {
+        chatId: requireChatId(),
+        inputs: [{ setting: "customDomain", hostname: String(args.hostname) }]
+      };
+      writeJson(await apiPost("/api/site/stage", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List the company's custom domains and what each is waiting for.\n\nExample: baker site domain list"
+  },
+  run: async () => {
+    try {
+      const chatId = optionalChatId();
+      writeJson(await apiGet("/api/site/domains", chatId ? { chatId } : void 0));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var verifyCommand = defineCommand({
+  meta: {
+    name: "verify",
+    description: "Re-check a pending domain now, e.g. right after the client added the DNS record.\n\nExample: baker site domain verify shop.acme.com"
+  },
+  args: { hostname: { type: "positional", description: "A domain from `baker site domain list`", required: true } },
+  run: async ({ args }) => {
+    try {
+      const body = { hostname: String(args.hostname) };
+      writeJson(await apiPost("/api/site/domains/verify", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var domainCommand = defineCommand({
+  meta: {
+    name: "domain",
+    description: "Custom domains for the company's landings. Subcommands: add (staged until publish), list, verify.\n\nExamples:\n  baker site domain add shop.acme.com\n  baker site domain list\n  baker site domain verify shop.acme.com"
+  },
+  subCommands: { add: addCommand, list: listCommand, verify: verifyCommand }
+});
+export {
+  domainCommand
+};
+//# sourceMappingURL=domain-A4IVVFI6.js.map

package/dist/download-KIOTQW3Z.js

@@ -0,0 +1,172 @@
+import {
+  videosDownloadResponseSchema
+} from "./chunk-FSHIEGAY.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-BNO3EFGR.js";
+import {
+  ApiError,
+  apiPost,
+  validateConvexId
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/download.ts
+import { mkdir, open, rm, stat } from "fs/promises";
+import path from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+import { defineCommand } from "citty";
+var DEFAULT_TIMEOUT_SECONDS = 20 * 60;
+var POLL_INTERVAL_MS = 1e4;
+registerSchema({
+  command: "videos.download",
+  description: "Save a library video (one from `videos search`, or one the user attached in chat) as a local .mp4 to edit with ffmpeg or a canvas ingest node. Waits while the file is prepared.",
+  args: {
+    id: { type: "string", description: "Library video ID", required: true },
+    out: { type: "string", description: "Directory to write the file into (created if missing)", required: true },
+    "timeout-seconds": {
+      type: "string",
+      description: `How long to wait for the file to be prepared (default ${DEFAULT_TIMEOUT_SECONDS})`,
+      required: false
+    }
+  }
+});
+async function awaitDownloadUrl(ask, options) {
+  const deadline = options.now() + options.timeoutMs;
+  for (; ; ) {
+    const answer = await ask();
+    if (answer.status === "ready") return { ready: true, url: answer.url, filename: answer.filename };
+    if (options.now() + options.intervalMs > deadline) return { ready: false, lastStatus: answer.status };
+    await options.sleep(options.intervalMs);
+  }
+}
+async function saveVideoFile(url, outDir, filename) {
+  await mkdir(outDir, { recursive: true });
+  const { name: stem, ext } = path.parse(path.basename(filename));
+  for (let n = 1; ; n++) {
+    const file = path.join(outDir, `${stem}${n === 1 ? "" : `-${n}`}${ext || ".mp4"}`);
+    let handle;
+    try {
+      handle = await open(file, "wx");
+    } catch (err) {
+      if (err instanceof Error && "code" in err && err.code === "EEXIST") continue;
+      throw err;
+    }
+    try {
+      const response = await fetch(url);
+      if (!response.ok || !response.body)
+        throw new Error(`The video file could not be fetched (HTTP ${response.status})`);
+      await pipeline(Readable.fromWeb(response.body), handle.createWriteStream());
+    } catch (err) {
+      await handle.close().catch(() => void 0);
+      await rm(file, { force: true });
+      throw err;
+    }
+    return { file, bytes: (await stat(file)).size };
+  }
+}
+async function downloadLibraryVideo(args, deps) {
+  let wait;
+  try {
+    wait = await awaitDownloadUrl(deps.ask, { timeoutMs: args.timeoutMs, intervalMs: args.intervalMs, ...deps });
+  } catch (err) {
+    if (!(err instanceof ApiError)) throw err;
+    const fix = err.fix ?? (err.code === "CONFLICT" ? {
+      action: "continue_without",
+      explanation: "Tell the user why this video cannot be used and carry on without it."
+    } : void 0);
+    return { ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } };
+  }
+  if (!wait.ready) {
+    return {
+      ok: false,
+      error: {
+        code: "TIMEOUT",
+        message: wait.lastStatus === "processing" ? "The video is still being uploaded to the library." : "The library is still preparing a downloadable file of this video.",
+        fix: {
+          action: "wait_and_retry",
+          explanation: "Tell the user the video is still being prepared, carry on with the rest of the job, and run this command again in a few minutes. Do not abort the whole job."
+        }
+      }
+    };
+  }
+  try {
+    const saved = await saveVideoFile(wait.url, path.resolve(args.out), wait.filename);
+    return {
+      ok: true,
+      data: saved,
+      hints: [
+        `Edit ${saved.file} with ffprobe/ffmpeg, or feed it to a canvas ingest node as { source: "path", path, expect: "video" }. The library video is unchanged.`
+      ]
+    };
+  } catch (err) {
+    return {
+      ok: false,
+      error: { code: "DOWNLOAD_FAILED", message: err instanceof Error ? err.message : String(err) }
+    };
+  }
+}
+function positiveInt(value) {
+  const parsed = typeof value === "string" ? Number.parseInt(value, 10) : Number.NaN;
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : void 0;
+}
+var downloadCommand = defineCommand({
+  meta: {
+    name: "download",
+    description: "Save a library video as a local .mp4 so you can edit it (ffmpeg, canvas ingest node). Use it for a video the user attached in chat, or one found with `videos search`. Waits up to 20 minutes while the file is prepared.\n\nExample: baker videos download j571abc123def --out /tmp/clips"
+  },
+  args: {
+    id: { type: "positional", description: "Library video ID", required: true },
+    out: { type: "string", description: "Directory to write the file into", required: true },
+    "timeout-seconds": {
+      type: "string",
+      description: `How long to wait for the file (default ${DEFAULT_TIMEOUT_SECONDS})`,
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    const id = String(args.id ?? "");
+    try {
+      validateConvexId(id);
+    } catch (err) {
+      writeJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: err instanceof Error ? err.message : "Invalid video ID" }
+      });
+      process.exit(1);
+    }
+    const result = await downloadLibraryVideo(
+      {
+        id,
+        out: String(args.out ?? ""),
+        timeoutMs: (positiveInt(args["timeout-seconds"]) ?? DEFAULT_TIMEOUT_SECONDS) * 1e3,
+        intervalMs: POLL_INTERVAL_MS
+      },
+      {
+        ask: async () => videosDownloadResponseSchema.parse(await apiPost("/api/videos/download", { id })),
+        now: Date.now,
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+      }
+    );
+    writeJson(result);
+    if (!result.ok) process.exit(1);
+  }
+});
+export {
+  awaitDownloadUrl,
+  downloadCommand,
+  downloadLibraryVideo,
+  saveVideoFile
+};
+//# sourceMappingURL=download-KIOTQW3Z.js.map

package/dist/draft-4MKYX4VU.js

@@ -0,0 +1,396 @@
+import {
+  draftAction,
+  draftListAction,
+  failWriteValidation,
+  handleGoogleError,
+  loadJsonPayloads,
+  loadPatchArg,
+  requireTarget,
+  stageGoogleOps
+} from "./chunk-MHRFRSQ6.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-MM6CCIL7.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-NRMJWNX3.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-GCFC2MNR.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-EAHBTBVR.js";
+import "./chunk-W3PJ7V4W.js";
+import "./chunk-CM2LECNX.js";
+import "./chunk-ZPF253G5.js";
+import "./chunk-AXSSATJW.js";
+import "./chunk-DNRXEP4A.js";
+import "./chunk-OYYAR5TD.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-NSBNIPIW.js";
+import {
+  GOOGLE_DRAFT_BATCH_MAX
+} from "./chunk-BNO3EFGR.js";
+import {
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import {
+  requireChatId
+} from "./chunk-LBIF6FJY.js";
+import {
+  registerSchema
+} from "./chunk-TRXGJZDL.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."
+    );
+  }
+  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.ts
+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.
+
+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
+    }
+  }
+});
+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 open 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 still be open; its other work (Knowledge, Tasks) stays where it is. 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 open chat 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
+    }
+  }
+});
+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 open chat's staged changes here."
+  },
+  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 open chat 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: "Review everything staged as a campaign \u25B8 ad group \u25B8 ad tree (--json for the raw envelope)"
+      },
+      args: {
+        json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+        chat: CHAT_READ_ARG
+      },
+      run: async ({ args }) => {
+        await draftListAction(args.json === true, args.chat);
+      }
+    }),
+    remove: defineCommand({
+      meta: { name: "remove", description: "Remove one staged op (cascades to dependents)" },
+      args: { ref: { type: "positional", description: "Staged op ref (g_temp_* or target)", required: false } },
+      run: async ({ args }) => {
+        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: 'Update a staged op in place \u2014 merges a JSON patch into its payload (RFC-7386: objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create. Many at once: no ref, and --file holding [{"ref":"g_temp_\u2026","patch":{\u2026}}, \u2026] \u2014 all amended in one call, or none if any is refused.'
+      },
+      args: {
+        ref: {
+          type: "positional",
+          description: "Staged op ref (g_temp_*) or target id/resource name \u2014 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'
+        },
+        patch: { type: "string", description: "Inline JSON patch object" }
+      },
+      run: async ({ args }) => {
+        const positional = Array.isArray(args._) ? args._[0] : void 0;
+        if (!(args.ref ?? positional) && typeof args.file === "string" && args.file.length > 0) {
+          const amends = amendBatchEntries(loadJsonPayloads(args.file));
+          await draftAction("/api/ads/google/draft/amend-batch", { amends });
+          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" }
+      },
+      run: async ({ args }) => {
+        try {
+          const full = args.full === true;
+          const response = await apiPost(
+            "/api/ads/google/draft/validate",
+            { chatId: requireChatId(), full }
+          );
+          writeJsonEnvelope(response.ok && response.data ? validationEnvelope(response.data, full) : response);
+        } 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
+      },
+      run: async ({ args }) => {
+        await draftAction("/api/ads/google/draft/show", { ref: requireTarget(args, "op") }, args.chat);
+      }
+    })
+  }
+});
+export {
+  BULK_STAGE_HINTS,
+  draftCommand,
+  importHints
+};
+//# sourceMappingURL=draft-4MKYX4VU.js.map