@koda-sl/baker-cli 0.497.0 → 0.498.0

package/dist/draft-XK4QG5HQ.js

@@ -0,0 +1,100 @@
+import {
+  draftAction,
+  draftList,
+  loadJsonArg,
+  requireTarget
+} from "./chunk-SVNKWUBQ.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-KBSWQKOT.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-AS46I4WH.js";
+import "./chunk-6UW4J6IU.js";
+import "./chunk-XOHXG5TG.js";
+import {
+  registerSchema
+} from "./chunk-AL6AEGWH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ga4/draft.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ga4.draft",
+  description: "Review and undo the Google Analytics changes staged on this chat. Use `list` to see everything staged, `show` to inspect one change in full before the chat completes, `amend` to correct one in place, and `remove`/`clear` to drop them. `list` and `show` take --chat <id> to read an earlier chat's changes instead.",
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list", required: false },
+    chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
+  }
+});
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "List, show, amend, remove or clear the Google Analytics changes staged on this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
+  },
+  subCommands: {
+    list: defineCommand({
+      meta: { name: "list", description: "Review everything staged on this chat (--json for the raw envelope)" },
+      args: {
+        json: { type: "boolean", description: "Print the raw JSON envelope", required: false },
+        chat: CHAT_READ_ARG
+      },
+      run: async ({ args }) => {
+        await draftList(args.json === true, args.chat);
+      }
+    }),
+    show: defineCommand({
+      meta: {
+        name: "show",
+        description: "Print the full staged payload for one change, alongside how the property looks today \u2014 the receipt to verify it before the chat completes (never truncated)."
+      },
+      args: {
+        ref: { type: "positional", description: "Staged ref or target id", required: false },
+        chat: CHAT_READ_ARG
+      },
+      run: async ({ args }) => {
+        await draftAction(
+          "/api/ga4/draft/show",
+          { ref: requireTarget(args, "change") },
+          args.chat
+        );
+      }
+    }),
+    amend: defineCommand({
+      meta: {
+        name: "amend",
+        description: "Update a staged change in place \u2014 merges a JSON patch into its payload (objects deep-merge, null deletes a key, arrays/scalars replace) and re-runs every check. Use this instead of remove + re-create."
+      },
+      args: {
+        ref: { type: "positional", description: "Staged ref or target id", required: false },
+        patch: { type: "string", description: "Inline JSON patch object", required: false },
+        file: { type: "string", description: "JSON file with the patch object", required: false }
+      },
+      run: async ({ args }) => {
+        await draftAction("/api/ga4/draft/amend", {
+          ref: requireTarget(args, "change"),
+          patch: loadJsonArg(args, "patch")
+        });
+      }
+    }),
+    remove: defineCommand({
+      meta: { name: "remove", description: "Remove one staged change" },
+      args: { ref: { type: "positional", description: "Staged ref or target id", required: false } },
+      run: async ({ args }) => {
+        await draftAction("/api/ga4/draft/remove", {
+          ref: requireTarget(args, "change")
+        });
+      }
+    }),
+    clear: defineCommand({
+      meta: { name: "clear", description: "Discard all Google Analytics changes staged on this chat" },
+      run: async () => {
+        await draftAction("/api/ga4/draft/clear", {});
+      }
+    })
+  }
+});
+export {
+  draftCommand
+};
+//# sourceMappingURL=draft-XK4QG5HQ.js.map

package/dist/draft-YPSHMRPS.js

@@ -0,0 +1,308 @@
+import {
+  draftAction,
+  draftListAction,
+  failWriteValidation,
+  handleGoogleError,
+  loadJsonPayloads,
+  loadPatchArg,
+  requireTarget,
+  stageGoogleOps
+} from "./chunk-SQ23BTGW.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-W5IS6CMZ.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-XVMRO6W5.js";
+import "./chunk-Y2JZX6JB.js";
+import "./chunk-ANLLW3KZ.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-KBSWQKOT.js";
+import "./chunk-MITWP546.js";
+import "./chunk-52KXFESB.js";
+import "./chunk-BTGOVA2H.js";
+import "./chunk-UAKNLPIU.js";
+import "./chunk-BCFIMEZJ.js";
+import "./chunk-2Q324LIK.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-UI6BKYQD.js";
+import {
+  GOOGLE_DRAFT_BATCH_MAX
+} from "./chunk-ERSL4WZT.js";
+import {
+  apiPost
+} from "./chunk-AS46I4WH.js";
+import "./chunk-6UW4J6IU.js";
+import {
+  requireChatId
+} from "./chunk-XOHXG5TG.js";
+import {
+  registerSchema
+} from "./chunk-AL6AEGWH.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 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."
+  },
+  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);
+      }
+    }),
+    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
+};
+//# sourceMappingURL=draft-YPSHMRPS.js.map

package/dist/draft-YPSHMRPS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/draft.ts","../src/commands/ads/google/draft-batch.ts","../src/commands/ads/google/draft-validate.ts"],"sourcesContent":["import type { GoogleDraftValidateResponse } from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { requireChatId } from \"../../../env.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHAT_READ_ARG } from \"../../chat-arg.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { amendBatchEntries, stageFileOps } from \"./draft-batch.ts\";\nimport { validationEnvelope } from \"./draft-validate.ts\";\nimport {\n  draftAction,\n  draftListAction,\n  handleGoogleError,\n  loadJsonPayloads,\n  loadPatchArg,\n  requireTarget,\n  stageGoogleOps,\n} from \"./write-shared.ts\";\n\nconst VALIDATE_DESCRIPTION = `Ask Google whether the whole staged draft would publish — without applying anything.\n\nStart here, after the last staged change and before telling the user the draft is ready:\n  baker ads google draft validate\n\nEvery staged op is built, batched and sent exactly as publish sends it, with Google's validateOnly\nflag, so each verdict is the answer publish would get: accepted | refused | blocked (a change it\ndepends on was refused) | unchecked (only publish can check it) | applied (an earlier publish did).\nCompact by default — counts, plus only the ops that need attention, each with Google's reason.\nFix refused ops with \\`draft amend <ref>\\` and validate again.\n\nExamples:\n  baker ads google draft validate\n  baker ads google draft validate --full   # every op, with its built request and Google's raw answer`;\n\nregisterSchema({\n  command: \"ads.google.draft.validate\",\n  description: VALIDATE_DESCRIPTION,\n  args: {\n    full: {\n      type: \"boolean\",\n      description: \"List every op with its built request and Google's raw answer\",\n      required: false,\n    },\n  },\n});\n\nconst STAGE_DESCRIPTION = `Stage many Google Ads changes from ONE file, in one call — any mix of kinds, up to 500 ops.\n\nStart here whenever a change touches more than a few rows (a keyword cleanup, bid changes, pausing\nads, a list of negatives): write the ops to a file and stage them together instead of running one\ncommand per row.\n  baker ads google draft stage --file changes.json --customer-id 1234567890\n\nThe file is a JSON array (or JSON Lines, one op per line). Each op is what the single commands\nbuild — kind, customerId (or --customer-id for all), target for a change to something that exists,\npayload. Read the shape for a kind with \\`baker capabilities google-ads\\`.\n  [\n    {\"kind\":\"google.keyword.add\",\"payload\":{\"adGroup\":\"customers/1234567890/adGroups/111\",\"text\":\"solar panels\",\"matchType\":\"PHRASE\"}},\n    {\"kind\":\"google.keyword.update\",\"target\":\"customers/1234567890/adGroupCriteria/111~222\",\"payload\":{\"status\":\"PAUSED\"}},\n    {\"kind\":\"google.negativeKeyword.add\",\"payload\":{\"level\":\"campaign\",\"parent\":\"222333\",\"text\":\"free\",\"matchType\":\"BROAD\"}}\n  ]\nAn op may name a g_temp_* ref an EARLIER call returned (a campaign or ad group staged before), but\nnot another op in the same file — a ref exists only once its op is staged, so stage new parents first.\nAll-or-nothing: one invalid op stages nothing. Ops already in effect come back as skipped.\nThen: baker ads google draft validate`;\n\nregisterSchema({\n  command: \"ads.google.draft.stage\",\n  description: STAGE_DESCRIPTION,\n  args: {\n    file: {\n      type: \"string\",\n      description: \"JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline\",\n      required: true,\n    },\n    \"customer-id\": {\n      type: \"string\",\n      description: \"10-digit customer id for every op that does not name its own\",\n      required: false,\n    },\n  },\n});\n\n/** After a bulk stage: what to do next, and the reminder that the file — not a loop — is the tool. */\nexport const BULK_STAGE_HINTS = [\n  \"Run `baker ads google draft validate` next: it asks Google about every staged op at once and lists only the ones it would refuse.\",\n  'To fix several staged ops, amend them together: `baker ads google draft amend --file amends.json` with [{\"ref\":\"…\",\"patch\":{…}}, …].',\n];\n\n/** Review and undo staged Google Ads ops on this chat's draft; `list`/`show` can also read another chat's. */\nexport const draftCommand = defineCommand({\n  meta: {\n    name: \"draft\",\n    description:\n      \"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.\",\n  },\n  subCommands: {\n    stage: defineCommand({\n      meta: { name: \"stage\", description: STAGE_DESCRIPTION },\n      args: {\n        file: {\n          type: \"string\",\n          description: \"JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline\",\n        },\n        \"customer-id\": { type: \"string\", description: \"10-digit customer id for every op that does not name its own\" },\n      },\n      run: async ({ args }) => {\n        const customerId = typeof args[\"customer-id\"] === \"string\" ? args[\"customer-id\"] : undefined;\n        await stageGoogleOps(stageFileOps(loadJsonPayloads(args.file), customerId), BULK_STAGE_HINTS);\n      },\n    }),\n    list: defineCommand({\n      meta: {\n        name: \"list\",\n        description: \"Review everything staged as a campaign ▸ ad group ▸ ad tree (--json for the raw envelope)\",\n      },\n      args: {\n        json: { type: \"boolean\", description: \"Print the raw JSON envelope instead of the readable tree\" },\n        chat: CHAT_READ_ARG,\n      },\n      run: async ({ args }) => {\n        await draftListAction(args.json === true, args.chat);\n      },\n    }),\n    remove: defineCommand({\n      meta: { name: \"remove\", description: \"Remove one staged op (cascades to dependents)\" },\n      args: { ref: { type: \"positional\", description: \"Staged op ref (g_temp_* or target)\", required: false } },\n      run: async ({ args }) => {\n        await draftAction(\"/api/ads/google/draft/remove\", { ref: requireTarget(args, \"op\") });\n      },\n    }),\n    clear: defineCommand({\n      meta: { name: \"clear\", description: \"Discard all staged ops on this chat\" },\n      run: async () => {\n        await draftAction(\"/api/ads/google/draft/clear\", {});\n      },\n    }),\n    amend: defineCommand({\n      meta: {\n        name: \"amend\",\n        description:\n          'Update a staged op in place — 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_…\",\"patch\":{…}}, …] — all amended in one call, or none if any is refused.',\n      },\n      args: {\n        ref: {\n          type: \"positional\",\n          description: \"Staged op ref (g_temp_*) or target id/resource name — leave out to amend many from --file\",\n          required: false,\n        },\n        file: {\n          type: \"string\",\n          description: 'JSON file with the patch object — or, with no ref, a JSON array of {\"ref\",\"patch\"} amends',\n        },\n        patch: { type: \"string\", description: \"Inline JSON patch object\" },\n      },\n      run: async ({ args }) => {\n        const positional = Array.isArray(args._) ? args._[0] : undefined;\n        if (!(args.ref ?? positional) && typeof args.file === \"string\" && args.file.length > 0) {\n          const amends = amendBatchEntries(loadJsonPayloads(args.file));\n          await draftAction(\"/api/ads/google/draft/amend-batch\", { amends });\n          return;\n        }\n        const ref = requireTarget(args, \"op\");\n        const patch = loadPatchArg(args);\n        await draftAction(\"/api/ads/google/draft/amend\", { ref, patch });\n      },\n    }),\n    validate: defineCommand({\n      meta: { name: \"validate\", description: VALIDATE_DESCRIPTION },\n      args: {\n        full: { type: \"boolean\", description: \"List every op with its built request and Google's raw answer\" },\n      },\n      run: async ({ args }) => {\n        try {\n          const full = args.full === true;\n          const response = await apiPost<{ ok: boolean; data?: GoogleDraftValidateResponse }>(\n            \"/api/ads/google/draft/validate\",\n            { chatId: requireChatId(), full },\n          );\n          writeJsonEnvelope(response.ok && response.data ? validationEnvelope(response.data, full) : response);\n        } catch (err) {\n          handleGoogleError(err);\n        }\n      },\n    }),\n    show: defineCommand({\n      meta: {\n        name: \"show\",\n        description:\n          \"Print the full staged payload for one op — the receipt to verify a change looks right before publish (never truncated).\",\n      },\n      args: {\n        ref: {\n          type: \"positional\",\n          description: \"Staged op ref (g_temp_*) or target id/resource name\",\n          required: false,\n        },\n        chat: CHAT_READ_ARG,\n      },\n      run: async ({ args }) => {\n        await draftAction(\"/api/ads/google/draft/show\", { ref: requireTarget(args, \"op\") }, args.chat);\n      },\n    }),\n  },\n});\n","import { GOOGLE_DRAFT_BATCH_MAX } from \"@baker/api/ads-google\";\nimport { failWriteValidation } from \"./write-shared.ts\";\n\n/**\n * The bulk halves of `draft`: one file of many changes, staged or amended in ONE request. A bulk\n * change done as a loop of single commands is one request, one rate-limit hit and one tool call per\n * row — production saw 1,284 such calls — while a file is one of each for up to 500 rows.\n */\n\nfunction refuseOversized(count: number, what: string): void {\n  if (count > GOOGLE_DRAFT_BATCH_MAX) {\n    failWriteValidation(\n      `${count} ${what} exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} — split the file and run the command once per part`,\n    );\n  }\n}\n\n/**\n * `draft stage --file` items → ops: each item is a whole op (`kind`, `customerId`, `target` for a\n * change to something that exists, `payload`); `--customer-id` fills the account on items that leave\n * it out, so a one-account file need not repeat it. The ops are preflighted by `stageGoogleOps`.\n */\nexport function stageFileOps(\n  items: ReadonlyArray<Record<string, unknown>>,\n  customerId: string | undefined,\n): Array<Record<string, unknown>> {\n  if (items.length === 0) {\n    failWriteValidation(\n      'pass --file with the ops to stage: a JSON array (or JSON Lines) of {\"kind\",\"customerId\",\"target\"?,\"payload\"?}',\n    );\n  }\n  refuseOversized(items.length, \"ops\");\n  return items.map((item, index) => {\n    if (typeof item.kind !== \"string\") {\n      failWriteValidation(\n        `item ${index} has no \"kind\" — every item is a whole op, e.g. {\"kind\":\"google.keyword.add\",…}`,\n      );\n    }\n    return item.customerId === undefined && customerId ? { ...item, customerId } : item;\n  });\n}\n\n/** `draft amend --file` items → the amend batch: each `{ ref, patch }` exactly as `draft amend <ref>` takes it. */\nexport function amendBatchEntries(\n  items: ReadonlyArray<Record<string, unknown>>,\n): Array<{ ref: string; patch: Record<string, unknown> }> {\n  refuseOversized(items.length, \"amends\");\n  return items.map((item, index) => {\n    const { ref, patch } = item;\n    if (typeof ref !== \"string\" || ref.length === 0) {\n      failWriteValidation(`item ${index} has no \"ref\" — name the staged op (g_temp_* or its target) to amend`);\n    }\n    if (patch === null || typeof patch !== \"object\" || Array.isArray(patch)) {\n      failWriteValidation(`item ${index} has no \"patch\" object — {\"ref\":\"…\",\"patch\":{…fields to change…}}`);\n    }\n    return { ref, patch: patch as Record<string, unknown> };\n  });\n}\n","import type { GoogleDraftOpVerdict, GoogleDraftValidateResponse } from \"@baker/api/ads-google\";\n\n/** Verdicts that need nothing from the agent — counted, never listed in the compact view. */\nconst QUIET: ReadonlySet<GoogleDraftOpVerdict[\"verdict\"]> = new Set([\"accepted\", \"applied\"]);\n\nfunction changes(n: number): string {\n  return n === 1 ? \"1 change\" : `${n} changes`;\n}\n\n/** What to do next, read off the counts — the agent decides from these without re-reading every op. */\nfunction validationHints(data: GoogleDraftValidateResponse): string[] {\n  const { refused, blocked, unchecked } = data.counts;\n  const hints: string[] = [];\n  if (refused > 0) {\n    hints.push(\n      `${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.`,\n    );\n  }\n  if (blocked > 0) {\n    hints.push(\n      `${changes(blocked)} would not apply only because a refused change they depend on fails — fixing the refused one clears them.`,\n    );\n  }\n  if (data.publishHeld) {\n    hints.push(\n      \"Baker would hold this whole publish: a refused change stops a first publish from sending anything. Fix it first.\",\n    );\n  }\n  if (unchecked > 0) {\n    hints.push(\n      `${changes(unchecked)} can only be checked by Google at publish (the reason is on each one). Nothing here says they will fail.`,\n    );\n  }\n  if (refused + blocked === 0 && !data.publishHeld && data.ops.length > 0) {\n    hints.push(\n      \"Google accepted every change it was asked about. The draft is ready for the user to review and publish.\",\n    );\n  }\n  return hints;\n}\n\n/**\n * The `draft validate` envelope. Compact by default: counts for everything, and only the ops that\n * need attention listed — a 300-keyword draft that Google accepts reads as one line, not 300.\n * `full` keeps every op with its built request and Google's raw answer.\n */\nexport function validationEnvelope(\n  data: GoogleDraftValidateResponse,\n  full = false,\n): { ok: true; data: GoogleDraftValidateResponse; hints: string[] } {\n  const ops = full ? data.ops : data.ops.filter((op) => !QUIET.has(op.verdict));\n  return { ok: true, data: { ...data, ops }, hints: validationHints(data) };\n}\n"],"mappings":"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","names":[]}

package/dist/engine/index.js

@@ -8,23 +8,23 @@ import {
   defaultRegistry,
   generateCatalog,
   validateCanvasDeep
-} from "../chunk-B7GF34FU.js";
-import "../chunk-OL7JS4NG.js";
-import "../chunk-7KHTJQGV.js";
+} from "../chunk-WAMT3TUD.js";
+import "../chunk-VR6BCP3U.js";
+import "../chunk-FO2JX473.js";
 import "../chunk-DGCUPJZD.js";
-import "../chunk-QMOYQJIN.js";
-import "../chunk-FKYPAGKK.js";
-import "../chunk-S4VLLGTW.js";
+import "../chunk-2YUVO3LP.js";
+import "../chunk-L6GYTD3A.js";
+import "../chunk-SJJHM57A.js";
 import "../chunk-MCJ5I5LR.js";
 import "../chunk-2WZI36D3.js";
 import "../chunk-65Y3RCWP.js";
-import "../chunk-A6WKCV3V.js";
-import "../chunk-U7YR5CZL.js";
-import "../chunk-VI5YQQ63.js";
-import "../chunk-JX7BX2NB.js";
-import "../chunk-D5NEIESR.js";
-import "../chunk-57KKVDDR.js";
-import "../chunk-QANGHND7.js";
+import "../chunk-BTGOVA2H.js";
+import "../chunk-UAKNLPIU.js";
+import "../chunk-BCFIMEZJ.js";
+import "../chunk-2Q324LIK.js";
+import "../chunk-6UW4J6IU.js";
+import "../chunk-XOHXG5TG.js";
+import "../chunk-AL6AEGWH.js";
 import "../chunk-YQSBHWOI.js";
 export {
   BackendClient,

package/dist/env-3ZELNMXQ.js

@@ -0,0 +1,51 @@
+import {
+  MissingChatIdError,
+  canvasAssetOriginsSetting,
+  captureBudgetMs,
+  captureProxyCredentials,
+  captureVimeoCookie,
+  childEnvWith,
+  clearTargetCompany,
+  debugLogSetting,
+  frameVisionKey,
+  getEnv,
+  hasFrameVisionKey,
+  hasOpenRouterKey,
+  openRouterKey,
+  optionalChatId,
+  optionalConnection,
+  optionalTargetCompany,
+  optionalTurnId,
+  optionalWorkspaceKind,
+  requireChatId,
+  requireConnection,
+  resolveChatId,
+  setTargetCompany
+} from "./chunk-XOHXG5TG.js";
+import "./chunk-AL6AEGWH.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  MissingChatIdError,
+  canvasAssetOriginsSetting,
+  captureBudgetMs,
+  captureProxyCredentials,
+  captureVimeoCookie,
+  childEnvWith,
+  clearTargetCompany,
+  debugLogSetting,
+  frameVisionKey,
+  getEnv,
+  hasFrameVisionKey,
+  hasOpenRouterKey,
+  openRouterKey,
+  optionalChatId,
+  optionalConnection,
+  optionalTargetCompany,
+  optionalTurnId,
+  optionalWorkspaceKind,
+  requireChatId,
+  requireConnection,
+  resolveChatId,
+  setTargetCompany
+};
+//# sourceMappingURL=env-3ZELNMXQ.js.map