@koda-sl/baker-cli 0.384.0-dev.4699b7308 → 0.384.0-dev.557795bef

package/dist/chunk-OIL6PU5W.js

@@ -0,0 +1,35 @@
+import {
+  ApiError
+} from "./chunk-CUL3VB4L.js";
+import {
+  writeJson
+} from "./chunk-MYTDK3AL.js";
+
+// src/commands/winning-ads/shared.ts
+function splitList(value) {
+  if (!value) {
+    return [];
+  }
+  return value.split(",").map((v) => v.trim()).filter(Boolean);
+}
+function reportError(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var PLATFORM_NAMES = {
+  meta: "Meta",
+  linkedin: "LinkedIn",
+  tiktok: "TikTok",
+  google: "Google Ads"
+};
+
+export {
+  splitList,
+  reportError,
+  PLATFORM_NAMES
+};
+//# sourceMappingURL=chunk-OIL6PU5W.js.map

package/dist/chunk-OIL6PU5W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/shared.ts"],"sourcesContent":["import type { AdLibraryPlatform } from \"@baker/api/ad-library\";\nimport { ApiError } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\n\n/** Split a comma list into trimmed, non-empty tokens. */\nexport function splitList(value: string | undefined): string[] {\n  if (!value) {\n    return [];\n  }\n  return value\n    .split(\",\")\n    .map((v) => v.trim())\n    .filter(Boolean);\n}\n\n/** Emit the `{ ok: false, error }` envelope and exit non-zero. */\nexport function reportError(err: unknown): never {\n  if (err instanceof ApiError) {\n    writeJson({ ok: false, error: { code: err.code, message: err.message } });\n    process.exit(1);\n  }\n  writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\n/** Each platform as people name it, for hints. */\nexport const PLATFORM_NAMES: Record<AdLibraryPlatform, string> = {\n  meta: \"Meta\",\n  linkedin: \"LinkedIn\",\n  tiktok: \"TikTok\",\n  google: \"Google Ads\",\n};\n"],"mappings":";;;;;;;;AAKO,SAAS,UAAU,OAAqC;AAC7D,MAAI,CAAC,OAAO;AACV,WAAO,CAAC;AAAA,EACV;AACA,SAAO,MACJ,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACnB;AAGO,SAAS,YAAY,KAAqB;AAC/C,MAAI,eAAe,UAAU;AAC3B,cAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,YAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,UAAQ,KAAK,CAAC;AAChB;AAGO,IAAM,iBAAoD;AAAA,EAC/D,MAAM;AAAA,EACN,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ;AACV;","names":[]}

package/dist/chunk-P4NSJS54.js

@@ -0,0 +1,20 @@
+// src/connected-resources.ts
+function listed(resources) {
+  return resources.map((resource) => resource.label ? `${resource.id} (${resource.label})` : resource.id).join("; ");
+}
+function connectedResourceHints({ plural, singular, flag, resources }) {
+  if (resources.length === 0) {
+    return [];
+  }
+  if (resources.length === 1) {
+    return [`This company connected one ${singular}: ${listed(resources)}. Commands use it unless you pass ${flag}.`];
+  }
+  return [
+    `This company connected ${resources.length} ${plural}: ${listed(resources)}. Each command works on one, so pass ${flag} \u2014 nothing is picked for you. A question about the whole business covers all ${resources.length}: answering from one and reporting it as the total is wrong.`
+  ];
+}
+
+export {
+  connectedResourceHints
+};
+//# sourceMappingURL=chunk-P4NSJS54.js.map

package/dist/chunk-P4NSJS54.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connected-resources.ts"],"sourcesContent":["/**\n * What an agent must be told about what a company actually connected.\n *\n * Every connection picker is multi-select — GA4 properties, Search Console\n * sites, ad accounts, Tag Manager containers — so \"the property\" is an\n * assumption, not a fact. Two failures follow from that assumption, and this\n * hint heads off both: a command that names no resource is refused (each one\n * works on a single resource, and nothing is picked for the agent), and an\n * answer built from whichever came back first gets reported as the whole\n * business. The list rides along with the hint so the agent can act on it\n * without a second call.\n */\n\nexport interface ConnectedResource {\n  /** What the flag takes: property id, customer id, site url, container id. */\n  id: string;\n  /** How the user knows it. */\n  label?: string;\n}\n\nexport interface ConnectedResourceHintSpec {\n  /** Plural noun in the user's words: \"GA4 properties\", \"Google Ads accounts\". */\n  plural: string;\n  /** Singular of the same noun. */\n  singular: string;\n  /** The flag that names one: \"--property-id\", \"--customer-id\". */\n  flag: string;\n  resources: ConnectedResource[];\n}\n\nfunction listed(resources: ConnectedResource[]): string {\n  return resources.map((resource) => (resource.label ? `${resource.id} (${resource.label})` : resource.id)).join(\"; \");\n}\n\nexport function connectedResourceHints({ plural, singular, flag, resources }: ConnectedResourceHintSpec): string[] {\n  if (resources.length === 0) {\n    return [];\n  }\n  if (resources.length === 1) {\n    return [`This company connected one ${singular}: ${listed(resources)}. Commands use it unless you pass ${flag}.`];\n  }\n  return [\n    `This company connected ${resources.length} ${plural}: ${listed(resources)}. Each command works on one, so pass ` +\n      `${flag} — nothing is picked for you. A question about the whole business covers all ${resources.length}: ` +\n      \"answering from one and reporting it as the total is wrong.\",\n  ];\n}\n"],"mappings":";AA8BA,SAAS,OAAO,WAAwC;AACtD,SAAO,UAAU,IAAI,CAAC,aAAc,SAAS,QAAQ,GAAG,SAAS,EAAE,KAAK,SAAS,KAAK,MAAM,SAAS,EAAG,EAAE,KAAK,IAAI;AACrH;AAEO,SAAS,uBAAuB,EAAE,QAAQ,UAAU,MAAM,UAAU,GAAwC;AACjH,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO,CAAC;AAAA,EACV;AACA,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO,CAAC,8BAA8B,QAAQ,KAAK,OAAO,SAAS,CAAC,qCAAqC,IAAI,GAAG;AAAA,EAClH;AACA,SAAO;AAAA,IACL,0BAA0B,UAAU,MAAM,IAAI,MAAM,KAAK,OAAO,SAAS,CAAC,wCACrE,IAAI,qFAAgF,UAAU,MAAM;AAAA,EAE3G;AACF;","names":[]}

package/dist/chunk-P5T7OZKV.js

@@ -0,0 +1,26 @@
+import {
+  DEFAULT_VIDEO_GENERATE_MODEL,
+  clipAudioMode,
+  spokenWordsIn
+} from "./chunk-CAMX6OHF.js";
+
+// src/commands/studio/avatarModel.ts
+function pinnedModelHint(input) {
+  if (!input.avatar || !input.model) return null;
+  if (input.model === DEFAULT_VIDEO_GENERATE_MODEL) return null;
+  const speaks = input.generateAudio ?? true;
+  if (!speaks) return null;
+  return `You pinned --model ${input.model} on a speaking avatar. Without it this clip routes to ${DEFAULT_VIDEO_GENERATE_MODEL}, which was chosen for exactly this case: the better picture, both orientations, and audio always on. Drop --model unless the user asked for a specific one \u2014 and note ${input.model} may not take the length or the reference you are counting on.`;
+}
+function silentModelHint(model, prompt) {
+  if (!model || !prompt) return null;
+  if (clipAudioMode(model) !== "never") return null;
+  if (spokenWordsIn(prompt) === 0) return null;
+  return `${model} renders no audio \u2014 the line in this prompt will be mouthed and never heard. For a shot where someone speaks use ${DEFAULT_VIDEO_GENERATE_MODEL} (audio always on), or alibaba/wan-3.0 past 10 seconds. Keep this model for shots with no voice in them.`;
+}
+
+export {
+  pinnedModelHint,
+  silentModelHint
+};
+//# sourceMappingURL=chunk-P5T7OZKV.js.map

package/dist/chunk-P5T7OZKV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/studio/avatarModel.ts"],"sourcesContent":["import { clipAudioMode, DEFAULT_VIDEO_GENERATE_MODEL, spokenWordsIn } from \"@baker/canvas-contract\";\n\n/**\n * Pinning a model on a speaking avatar, which the routing had already decided better.\n *\n * A cast avatar with sound routes to Gemini Omni on purpose: it is the better picture, it\n * renders both orientations, and its audio is always on — which is what a talking clip\n * needs. Pin something else and that decision is discarded silently.\n *\n * Observed: the agent pinned `google/veo-3.1` unasked. Veo takes a first frame but no\n * reference, and renders 4, 6 or 8 seconds only — so its first attempt, at 15 seconds,\n * was refused outright. Nothing in the docs pointed there; it simply assumed.\n */\nexport function pinnedModelHint(input: { avatar?: string; model?: string; generateAudio?: boolean }): string | null {\n  if (!input.avatar || !input.model) return null;\n  if (input.model === DEFAULT_VIDEO_GENERATE_MODEL) return null;\n  const speaks = input.generateAudio ?? true;\n  if (!speaks) return null;\n  return `You pinned --model ${input.model} on a speaking avatar. Without it this clip routes to ${DEFAULT_VIDEO_GENERATE_MODEL}, which was chosen for exactly this case: the better picture, both orientations, and audio always on. Drop --model unless the user asked for a specific one — and note ${input.model} may not take the length or the reference you are counting on.`;\n}\n\n/**\n * A spoken line handed to a model that renders picture only.\n *\n * Runway and both Groks carry no audio at all. The line still gets mouthed — the take\n * looks almost right, and the silence is discovered by watching it, after paying. The\n * Studio now prints \"No sound\" for these; this is the same fact where the agent works.\n */\nexport function silentModelHint(model: string | undefined, prompt: string | undefined): string | null {\n  if (!model || !prompt) return null;\n  if (clipAudioMode(model) !== \"never\") return null;\n  if (spokenWordsIn(prompt) === 0) return null;\n  return `${model} renders no audio — the line in this prompt will be mouthed and never heard. For a shot where someone speaks use ${DEFAULT_VIDEO_GENERATE_MODEL} (audio always on), or alibaba/wan-3.0 past 10 seconds. Keep this model for shots with no voice in them.`;\n}\n"],"mappings":";;;;;;;AAaO,SAAS,gBAAgB,OAAoF;AAClH,MAAI,CAAC,MAAM,UAAU,CAAC,MAAM,MAAO,QAAO;AAC1C,MAAI,MAAM,UAAU,6BAA8B,QAAO;AACzD,QAAM,SAAS,MAAM,iBAAiB;AACtC,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,sBAAsB,MAAM,KAAK,yDAAyD,4BAA4B,+KAA0K,MAAM,KAAK;AACpT;AASO,SAAS,gBAAgB,OAA2B,QAA2C;AACpG,MAAI,CAAC,SAAS,CAAC,OAAQ,QAAO;AAC9B,MAAI,cAAc,KAAK,MAAM,QAAS,QAAO;AAC7C,MAAI,cAAc,MAAM,MAAM,EAAG,QAAO;AACxC,SAAO,GAAG,KAAK,yHAAoH,4BAA4B;AACjK;","names":[]}

package/dist/chunk-PFBQERWX.js

@@ -0,0 +1,10 @@
+// src/commands/chat-arg.ts
+var CHAT_READ_ARG = {
+  type: "string",
+  description: "Read another chat's staged changes instead of this one's. Start here when asked to redo, reapply or explain what an earlier chat did \u2014 its changes are kept verbatim, including what happened to each one on publish. Never retype an earlier chat's work from a summary."
+};
+
+export {
+  CHAT_READ_ARG
+};
+//# sourceMappingURL=chunk-PFBQERWX.js.map

package/dist/chunk-PFBQERWX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/chat-arg.ts"],"sourcesContent":["/**\n * The `--chat` flag every draft-read command shares.\n *\n * A staged change is kept exactly as it was written, and it outlives the chat that wrote it — so\n * \"redo what that chat did\" is a read, not a reconstruction. One definition rather than seven so\n * the flag means the same thing on Google, Meta, LinkedIn, Tag Manager, Tasks, tags and schedules.\n *\n * Read commands only. Anything that stages, amends or discards keeps using `requireChatId`.\n */\nexport const CHAT_READ_ARG = {\n  type: \"string\",\n  description:\n    \"Read another chat's staged changes instead of this one's. Start here when asked to redo, reapply or explain what an earlier chat did — its changes are kept verbatim, including what happened to each one on publish. Never retype an earlier chat's work from a summary.\",\n} as const;\n"],"mappings":";AASO,IAAM,gBAAgB;AAAA,EAC3B,MAAM;AAAA,EACN,aACE;AACJ;","names":[]}

package/dist/chunk-PSWVSLJU.js

@@ -0,0 +1,56 @@
+import {
+  ApiError,
+  apiGet
+} from "./chunk-CUL3VB4L.js";
+import {
+  compactImage,
+  compactVideo,
+  writeJson
+} from "./chunk-MYTDK3AL.js";
+
+// src/commands/mediaGroup.ts
+async function runMediaGroupLookup(input) {
+  if (!input.id && !input.groupKey) {
+    writeJson({
+      ok: false,
+      error: { code: "VALIDATION_ERROR", message: `Pass ${input.idLabel} or --group-key` }
+    });
+    process.exit(1);
+  }
+  try {
+    const query = new URLSearchParams();
+    if (input.id) query.set("id", input.id);
+    if (input.groupKey) query.set("groupKey", input.groupKey);
+    const data = await apiGet(`${input.path}?${query.toString()}`);
+    const images = data.images.map((image) => compactImage(image));
+    const videos = (data.videos ?? []).map((video) => compactVideo(video));
+    const count = images.length + videos.length;
+    writeJson({
+      ok: true,
+      data: {
+        groupKey: data.groupKey,
+        groupKind: data.groupKind ?? null,
+        // The caption or page title the whole set shares — often the only
+        // place the campaign is named.
+        groupTitle: data.groupTitle ?? null,
+        groupUrl: data.groupUrl ?? null,
+        count,
+        images,
+        videos
+      },
+      hints: count > 1 ? ["These arrived together and are ordered. Read them in sequence before using any one of them alone."] : void 0
+    });
+  } catch (err) {
+    if (err instanceof ApiError) {
+      writeJson({ ok: false, error: { code: err.code, message: err.message } });
+      process.exit(1);
+    }
+    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+    process.exit(1);
+  }
+}
+
+export {
+  runMediaGroupLookup
+};
+//# sourceMappingURL=chunk-PSWVSLJU.js.map

package/dist/chunk-PSWVSLJU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/mediaGroup.ts"],"sourcesContent":["import type { ImagesGroupResponse } from \"@baker/api\";\nimport { ApiError, apiGet } from \"../client.ts\";\nimport { compactImage, compactVideo, writeJson } from \"../output.ts\";\n\n/**\n * The set an asset arrived in, fetched the same way whichever half you hold.\n *\n * A group spans both tables — an Instagram carousel routinely mixes stills and\n * clips — so `baker images group` and `baker videos group` are two doors onto\n * one answer. The noun the agent happens to have should not decide whether it\n * can ask; that asymmetry is what left a clip with no way back to its post.\n */\nexport async function runMediaGroupLookup(input: {\n  id: string | undefined;\n  groupKey: string | undefined;\n  /** The route to call. Both serve the same handler; the path only follows the\n   * command the agent reached for. */\n  path: \"/api/images/group\" | \"/api/videos/group\";\n  /** What to call the id in the error, in the agent's own vocabulary. */\n  idLabel: string;\n}): Promise<void> {\n  if (!input.id && !input.groupKey) {\n    writeJson({\n      ok: false,\n      error: { code: \"VALIDATION_ERROR\", message: `Pass ${input.idLabel} or --group-key` },\n    });\n    process.exit(1);\n  }\n\n  try {\n    const query = new URLSearchParams();\n    if (input.id) query.set(\"id\", input.id);\n    if (input.groupKey) query.set(\"groupKey\", input.groupKey);\n\n    const data = await apiGet<ImagesGroupResponse>(`${input.path}?${query.toString()}`);\n    const images = data.images.map((image) => compactImage(image as Record<string, unknown>));\n    // A carousel can mix stills and clips — report both or the agent will\n    // think it has the whole set when it is missing the video slides.\n    const videos = (data.videos ?? []).map((video) => compactVideo(video as Record<string, unknown>));\n    const count = images.length + videos.length;\n\n    writeJson({\n      ok: true,\n      data: {\n        groupKey: data.groupKey,\n        groupKind: data.groupKind ?? null,\n        // The caption or page title the whole set shares — often the only\n        // place the campaign is named.\n        groupTitle: data.groupTitle ?? null,\n        groupUrl: data.groupUrl ?? null,\n        count,\n        images,\n        videos,\n      },\n      hints:\n        count > 1\n          ? [\"These arrived together and are ordered. Read them in sequence before using any one of them alone.\"]\n          : undefined,\n    });\n  } catch (err) {\n    if (err instanceof ApiError) {\n      writeJson({ ok: false, error: { code: err.code, message: err.message } });\n      process.exit(1);\n    }\n    writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n    process.exit(1);\n  }\n}\n"],"mappings":";;;;;;;;;;;AAYA,eAAsB,oBAAoB,OAQxB;AAChB,MAAI,CAAC,MAAM,MAAM,CAAC,MAAM,UAAU;AAChC,cAAU;AAAA,MACR,IAAI;AAAA,MACJ,OAAO,EAAE,MAAM,oBAAoB,SAAS,QAAQ,MAAM,OAAO,kBAAkB;AAAA,IACrF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI;AACF,UAAM,QAAQ,IAAI,gBAAgB;AAClC,QAAI,MAAM,GAAI,OAAM,IAAI,MAAM,MAAM,EAAE;AACtC,QAAI,MAAM,SAAU,OAAM,IAAI,YAAY,MAAM,QAAQ;AAExD,UAAM,OAAO,MAAM,OAA4B,GAAG,MAAM,IAAI,IAAI,MAAM,SAAS,CAAC,EAAE;AAClF,UAAM,SAAS,KAAK,OAAO,IAAI,CAAC,UAAU,aAAa,KAAgC,CAAC;AAGxF,UAAM,UAAU,KAAK,UAAU,CAAC,GAAG,IAAI,CAAC,UAAU,aAAa,KAAgC,CAAC;AAChG,UAAM,QAAQ,OAAO,SAAS,OAAO;AAErC,cAAU;AAAA,MACR,IAAI;AAAA,MACJ,MAAM;AAAA,QACJ,UAAU,KAAK;AAAA,QACf,WAAW,KAAK,aAAa;AAAA;AAAA;AAAA,QAG7B,YAAY,KAAK,cAAc;AAAA,QAC/B,UAAU,KAAK,YAAY;AAAA,QAC3B;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACA,OACE,QAAQ,IACJ,CAAC,mGAAmG,IACpG;AAAA,IACR,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,QAAI,eAAe,UAAU;AAC3B,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,cAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/dist/chunk-PY2NJ6XZ.js

@@ -0,0 +1,191 @@
+import {
+  hintLines,
+  splitHints
+} from "./chunk-D5FY4FAK.js";
+import {
+  isNotConnectedError,
+  writeJsonEnvelope
+} from "./chunk-EIGXX6KI.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-I4FTS5EE.js";
+
+// src/commands/ga4/shared.ts
+import { readFileSync } from "fs";
+function failValidation(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function requireTarget(args, entity) {
+  const positional = Array.isArray(args._) ? args._[0] : void 0;
+  const target = args.id ?? args.target ?? positional;
+  if (typeof target !== "string" || target.length === 0) {
+    failValidation(`pass the ${entity} id as the positional argument`);
+  }
+  return target;
+}
+function readJsonSource(args, flag) {
+  const inline = args[flag];
+  const file = args.file;
+  const raw = typeof file === "string" && file.length > 0 ? readFileSync(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
+  if (raw === void 0) {
+    failValidation(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return failValidation(`--${flag} is not valid JSON`);
+  }
+}
+function asObject(value, flag, index) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    failValidation(
+      index === void 0 ? `--${flag} must be a JSON object` : `--${flag}[${index}] must be a JSON object`
+    );
+  }
+  return value;
+}
+function loadJsonArg(args, flag = "json") {
+  return asObject(readJsonSource(args, flag), flag);
+}
+function loadJsonPayloads(args) {
+  const parsed = readJsonSource(args, "json");
+  if (!Array.isArray(parsed)) {
+    return [asObject(parsed, "json")];
+  }
+  if (parsed.length === 0) {
+    failValidation("--json is an empty list \u2014 pass at least one definition");
+  }
+  return parsed.map((entry, index) => asObject(entry, "json", index));
+}
+var RETRYABLE_CODES = /* @__PURE__ */ new Set(["RATE_LIMITED", "UNAVAILABLE", "INTERNAL_ERROR", "NETWORK_ERROR", "TIMEOUT"]);
+function handleError(err) {
+  if (err instanceof ApiError) {
+    const readOnly = err.code === "FORBIDDEN" && /read the property but not change it/i.test(err.message);
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        ...readOnly ? {
+          fix: {
+            action: "reconnect",
+            explanation: "The Google Analytics connection is read-only. Ask the user to reconnect Google Analytics \u2014 in the dashboard, Brain \u2192 Integrations \u2192 Platforms \u2192 Google Analytics \u2014 which grants the permission to change the property. Reporting (`baker ga4 query`, `baker ga4 audit`) keeps working meanwhile, so carry on with the rest of the job and tell them what you will set up once they have reconnected. Don't claim anything was configured."
+          }
+        } : err.code === "UNAUTHORIZED" || err.code === "FORBIDDEN" && isNotConnectedError(err.code, err.message) ? {
+          fix: {
+            action: "request_connection",
+            explanation: 'Google Analytics is not connected for this company yet, or no property has been picked. Don\'t send the user to Settings \u2014 call the `request_connection` tool with { platform: "google-analytics", reason } and they connect and pick their property from inside the chat. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 Google Analytics. Then carry on with the rest of the task.'
+          }
+        } : {},
+        retryable: RETRYABLE_CODES.has(err.code)
+      }
+    });
+    process.exit(1);
+  }
+  writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error", retryable: true } });
+  process.exit(1);
+}
+var STAGE_HINTS = [
+  "Staged only \u2014 nothing has changed in Google Analytics yet. These apply when the chat completes, and an applied change takes effect on the property immediately: there is no version to publish afterwards and no undo. Say the changes are ready and take effect when the user completes the chat \u2014 not that they are done already."
+];
+var WARNING_HINT = "Read the warnings above before telling the user this is ready.";
+async function stageOp(op) {
+  const chatId = requireChatId();
+  try {
+    const { data, hints } = splitHints(await apiPost("/api/ga4/draft/stage", { chatId, op }));
+    writeJsonEnvelope({
+      ok: true,
+      data,
+      hints: [...hints, ...STAGE_HINTS, ...data.warnings.length > 0 ? [WARNING_HINT] : []]
+    });
+  } catch (err) {
+    handleError(err);
+  }
+}
+async function stageOps(ops) {
+  const [only] = ops;
+  if (ops.length === 1 && only) {
+    await stageOp(only);
+    return;
+  }
+  const chatId = requireChatId();
+  try {
+    const { data, hints } = splitHints(
+      await apiPost("/api/ga4/draft/stage-batch", { chatId, ops })
+    );
+    writeJsonEnvelope({
+      ok: true,
+      data,
+      hints: [...hints, ...STAGE_HINTS, ...data.ops.some((op) => op.warnings.length > 0) ? [WARNING_HINT] : []]
+    });
+  } catch (err) {
+    handleError(err);
+  }
+}
+async function draftAction(path, body, chat) {
+  const chatId = resolveChatId(chat);
+  try {
+    const { data, hints } = splitHints(await apiPost(path, { chatId, ...body }));
+    writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
+    return data;
+  } catch (err) {
+    handleError(err);
+  }
+}
+function renderDraft(response) {
+  if (response.count === 0) {
+    return "No Google Analytics changes staged on this chat.";
+  }
+  const lines = [
+    `${response.count} staged Google Analytics change(s)`,
+    ...response.ops.map((op) => {
+      const status = op.result ? ` [${op.result.status}]` : "";
+      return `  ${op.ref}  ${op.summary}${status}`;
+    })
+  ];
+  if (response.status === "applied") {
+    const failed = response.ops.filter((op) => op.result?.status !== "applied");
+    lines.push(
+      "",
+      failed.length === 0 ? "All applied \u2014 these are in effect on the property now." : `${failed.length} of ${response.count} did not apply. The rest are in effect on the property.`
+    );
+  }
+  if (response.publishError) {
+    lines.push("", response.publishError);
+  }
+  return lines.join("\n");
+}
+async function draftList(json, chat) {
+  const chatId = resolveChatId(chat);
+  try {
+    const response = await apiPost("/api/ga4/draft", { chatId });
+    const { data, hints } = splitHints(response);
+    if (json) {
+      writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
+      return;
+    }
+    process.stdout.write(`${renderDraft(data)}${hintLines(response)}
+`);
+  } catch (err) {
+    handleError(err);
+  }
+}
+
+export {
+  failValidation,
+  requireTarget,
+  loadJsonArg,
+  loadJsonPayloads,
+  handleError,
+  stageOp,
+  stageOps,
+  draftAction,
+  draftList
+};
+//# sourceMappingURL=chunk-PY2NJ6XZ.js.map

package/dist/chunk-PY2NJ6XZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ga4/shared.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport type { Ga4DraftListResponse, Ga4DraftStageBatchResponse, Ga4DraftStageResponse } from \"@baker/api/ga4\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { requireChatId, resolveChatId } from \"../../env.ts\";\nimport { isNotConnectedError } from \"../../error-handler.ts\";\nimport { hintLines, splitHints } from \"../ads/hints.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\n\n/**\n * Shared plumbing for the staged Google Analytics write commands. These NEVER\n * change the property directly: each stages a change onto this chat's draft, the\n * user reviews the whole set in the Analytics tab, and it applies when the chat\n * completes.\n */\n\nexport function failValidation(message: string): never {\n  writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\nexport function requireTarget(args: Record<string, unknown>, entity: string): string {\n  const positional = Array.isArray(args._) ? args._[0] : undefined;\n  const target = args.id ?? args.target ?? positional;\n  if (typeof target !== \"string\" || target.length === 0) {\n    failValidation(`pass the ${entity} id as the positional argument`);\n  }\n  return target;\n}\n\nfunction readJsonSource(args: Record<string, unknown>, flag: \"patch\" | \"json\"): unknown {\n  const inline = args[flag];\n  const file = args.file;\n  const raw =\n    typeof file === \"string\" && file.length > 0\n      ? readFileSync(file, \"utf8\")\n      : typeof inline === \"string\" && inline.length > 0\n        ? inline\n        : undefined;\n  if (raw === undefined) {\n    failValidation(`pass --${flag} with inline JSON or --file with a path to a JSON file`);\n  }\n  try {\n    return JSON.parse(raw) as unknown;\n  } catch {\n    return failValidation(`--${flag} is not valid JSON`);\n  }\n}\n\nfunction asObject(value: unknown, flag: string, index?: number): Record<string, unknown> {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    failValidation(\n      index === undefined ? `--${flag} must be a JSON object` : `--${flag}[${index}] must be a JSON object`,\n    );\n  }\n  return value as Record<string, unknown>;\n}\n\n/** `--json '<inline>'` or `--file <path>` → a parsed object. */\nexport function loadJsonArg(args: Record<string, unknown>, flag: \"patch\" | \"json\" = \"json\"): Record<string, unknown> {\n  return asObject(readJsonSource(args, flag), flag);\n}\n\n/**\n * The same, but a JSON **array** is allowed and means \"stage all of these\n * together\".\n *\n * This is the only way to keep a bulk job cheap. Every stage call reads the\n * whole property first — the property, its data streams, its key events, its\n * custom definitions and its retention window — because that read is what the\n * duplicate and immutability refusals are derived from. One call per definition\n * therefore multiplies a routine \"make these eight parameters reportable\" into\n * roughly fifty Admin API reads against a quota Google counts per project.\n */\nexport function loadJsonPayloads(args: Record<string, unknown>): Record<string, unknown>[] {\n  const parsed = readJsonSource(args, \"json\");\n  if (!Array.isArray(parsed)) {\n    return [asObject(parsed, \"json\")];\n  }\n  if (parsed.length === 0) {\n    failValidation(\"--json is an empty list — pass at least one definition\");\n  }\n  return parsed.map((entry, index) => asObject(entry, \"json\", index));\n}\n\nconst RETRYABLE_CODES = new Set([\"RATE_LIMITED\", \"UNAVAILABLE\", \"INTERNAL_ERROR\", \"NETWORK_ERROR\", \"TIMEOUT\"]);\n\n/**\n * The one error shape for the whole family.\n *\n * Two different 403s reach here and they need opposite responses, which is why\n * the fix is keyed to the message and not just the status:\n *  - \"no Google Analytics connection / no property picked\" → the in-chat connect\n *    form, same as every other family.\n *  - \"this connection can read but not change the property\" → a RECONNECT, which\n *    is what every connection made before Baker could configure GA4 needs. The\n *    backend's message already says so, so it is passed through as the fix\n *    explanation rather than being replaced with the connect-form wording, which\n *    would send the user to set up a connection they already have.\n */\nexport function handleError(err: unknown): never {\n  if (err instanceof ApiError) {\n    const readOnly = err.code === \"FORBIDDEN\" && /read the property but not change it/i.test(err.message);\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        ...(readOnly\n          ? {\n              fix: {\n                action: \"reconnect\",\n                explanation:\n                  \"The Google Analytics connection is read-only. Ask the user to reconnect Google Analytics — in the \" +\n                  \"dashboard, Brain → Integrations → Platforms → Google Analytics — which grants the permission to change \" +\n                  \"the property. Reporting (`baker ga4 query`, `baker ga4 audit`) keeps working meanwhile, so carry \" +\n                  \"on with the rest of the job and tell them what you will set up once they have reconnected. Don't \" +\n                  \"claim anything was configured.\",\n              },\n            }\n          : err.code === \"UNAUTHORIZED\" || (err.code === \"FORBIDDEN\" && isNotConnectedError(err.code, err.message))\n            ? {\n                fix: {\n                  action: \"request_connection\",\n                  explanation:\n                    \"Google Analytics is not connected for this company yet, or no property has been picked. Don't \" +\n                    'send the user to Settings — call the `request_connection` tool with { platform: \"google-analytics\", ' +\n                    \"reason } and they connect and pick their property from inside the chat. If the \" +\n                    \"`request_connection` call fails, say so plainly and give the exact route: dashboard → Brain → \" +\n                    \"Integrations → Platforms → Google Analytics. Then carry on with the rest of the task.\",\n                },\n              }\n            : {}),\n        retryable: RETRYABLE_CODES.has(err.code),\n      },\n    });\n    process.exit(1);\n  }\n  writeJsonEnvelope({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\", retryable: true } });\n  process.exit(1);\n}\n\n/** Nudges returned after a stage so the agent's next step is obvious. */\nconst STAGE_HINTS = [\n  \"Staged only — nothing has changed in Google Analytics yet. These apply when the chat completes, and an applied \" +\n    \"change takes effect on the property immediately: there is no version to publish afterwards and no undo. Say \" +\n    \"the changes are ready and take effect when the user completes the chat — not that they are done already.\",\n];\n\nconst WARNING_HINT = \"Read the warnings above before telling the user this is ready.\";\n\nexport async function stageOp(op: Record<string, unknown>): Promise<void> {\n  const chatId = requireChatId();\n  try {\n    const { data, hints } = splitHints(await apiPost<Ga4DraftStageResponse>(\"/api/ga4/draft/stage\", { chatId, op }));\n    writeJsonEnvelope({\n      ok: true,\n      data,\n      hints: [...hints, ...STAGE_HINTS, ...(data.warnings.length > 0 ? [WARNING_HINT] : [])],\n    });\n  } catch (err) {\n    handleError(err);\n  }\n}\n\n/**\n * Stage several changes as ONE request against ONE read of the property.\n *\n * All-or-nothing: if any one of them is refused, none of them stage — which is\n * the honest outcome, since the refusals are things like \"two of these claim the\n * same parameter name\" that only mean anything about the set as a whole. A\n * single op falls through to the plain path so its envelope is unchanged.\n */\nexport async function stageOps(ops: Record<string, unknown>[]): Promise<void> {\n  const [only] = ops;\n  if (ops.length === 1 && only) {\n    await stageOp(only);\n    return;\n  }\n  const chatId = requireChatId();\n  try {\n    const { data, hints } = splitHints(\n      await apiPost<Ga4DraftStageBatchResponse>(\"/api/ga4/draft/stage-batch\", { chatId, ops }),\n    );\n    writeJsonEnvelope({\n      ok: true,\n      data,\n      hints: [...hints, ...STAGE_HINTS, ...(data.ops.some((op) => op.warnings.length > 0) ? [WARNING_HINT] : [])],\n    });\n  } catch (err) {\n    handleError(err);\n  }\n}\n\nexport async function draftAction(\n  path: string,\n  body: Record<string, unknown>,\n  chat?: unknown,\n): Promise<Record<string, unknown>> {\n  const chatId = resolveChatId(chat);\n  try {\n    const { data, hints } = splitHints(await apiPost<Record<string, unknown>>(path, { chatId, ...body }));\n    writeJsonEnvelope({ ok: true, data, ...(hints.length > 0 ? { hints } : {}) });\n    return data;\n  } catch (err) {\n    handleError(err);\n  }\n}\n\n/** A compact, readable view of everything staged on this chat. */\nexport function renderDraft(response: Ga4DraftListResponse): string {\n  if (response.count === 0) {\n    return \"No Google Analytics changes staged on this chat.\";\n  }\n  const lines = [\n    `${response.count} staged Google Analytics change(s)`,\n    ...response.ops.map((op) => {\n      const status = op.result ? ` [${op.result.status}]` : \"\";\n      return `  ${op.ref}  ${op.summary}${status}`;\n    }),\n  ];\n  if (response.status === \"applied\") {\n    const failed = response.ops.filter((op) => op.result?.status !== \"applied\");\n    lines.push(\n      \"\",\n      failed.length === 0\n        ? \"All applied — these are in effect on the property now.\"\n        : `${failed.length} of ${response.count} did not apply. The rest are in effect on the property.`,\n    );\n  }\n  if (response.publishError) {\n    lines.push(\"\", response.publishError);\n  }\n  return lines.join(\"\\n\");\n}\n\nexport async function draftList(json: boolean, chat?: unknown): Promise<void> {\n  const chatId = resolveChatId(chat);\n  try {\n    const response = await apiPost<Ga4DraftListResponse>(\"/api/ga4/draft\", { chatId });\n    const { data, hints } = splitHints(response);\n    if (json) {\n      writeJsonEnvelope({ ok: true, data, ...(hints.length > 0 ? { hints } : {}) });\n      return;\n    }\n    process.stdout.write(`${renderDraft(data)}${hintLines(response)}\\n`);\n  } catch (err) {\n    handleError(err);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-PZ4OM2LK.js

@@ -0,0 +1,45 @@
+import {
+  ANALYTICS_BUSY_FIX,
+  isAnalyticsBusy
+} from "./chunk-QMLGJ5OW.js";
+import {
+  ApiError
+} from "./chunk-CUL3VB4L.js";
+
+// src/commands/analytics/errorEnvelope.ts
+import { z } from "zod";
+function analyticsErrorEnvelope(err) {
+  if (err instanceof ApiError) {
+    return isAnalyticsBusy(err.message) ? { code: err.code, message: err.message, fix: ANALYTICS_BUSY_FIX } : { code: err.code, message: err.message };
+  }
+  return { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" };
+}
+function requestErrorEnvelope(err, correction, correctsLocalInput) {
+  if (err instanceof z.ZodError || err instanceof SyntaxError) {
+    const message = err instanceof z.ZodError ? z.prettifyError(err) : err.message;
+    return { code: "VALIDATION_ERROR", message, ...correctsLocalInput ? { fix: correction } : {} };
+  }
+  const envelope = analyticsErrorEnvelope(err);
+  return envelope.code === "VALIDATION_ERROR" ? { ...envelope, fix: correction } : envelope;
+}
+function questionnaireErrorEnvelope(err) {
+  return requestErrorEnvelope(
+    err,
+    "Check baker analytics plan --full for missing app events. Resolve the named contract issue or narrow the observation window; never infer abandonment from completion totals.",
+    false
+  );
+}
+function trackingPlanErrorEnvelope(err) {
+  return requestErrorEnvelope(
+    err,
+    "Read baker analytics plan --full and baker tag-manager draft list to see what is prepared. Correct the request and repeat; do not publish until every requested installation is staged.",
+    true
+  );
+}
+
+export {
+  analyticsErrorEnvelope,
+  questionnaireErrorEnvelope,
+  trackingPlanErrorEnvelope
+};
+//# sourceMappingURL=chunk-PZ4OM2LK.js.map

package/dist/chunk-PZ4OM2LK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/analytics/errorEnvelope.ts"],"sourcesContent":["import { ANALYTICS_BUSY_FIX, isAnalyticsBusy } from \"@baker/api/analytics\";\nimport { z } from \"zod\";\nimport { ApiError, type ErrorCode } from \"../../client.ts\";\n\n/**\n * A failed analytics read, as the agent reads it.\n *\n * Separate from `handleError` — which writes it and exits — so the one decision\n * in it can be checked without a process to kill.\n *\n * ## The one decision\n *\n * Whether the failure is worth stopping for. Almost all of them are: a bad\n * preset, an unmapped role, a window outside retention. One is not — the store\n * refusing a read because a burst spent its per-minute compute allowance. That\n * refusal clears in seconds, loses nothing, and is answered correctly by\n * waiting; an agent that treats it like the others abandons a multi-step report\n * over a hiccup, which is the expensive outcome and the reason this carries a\n * `fix` at all.\n */\nexport function analyticsErrorEnvelope(err: unknown): { code: ErrorCode; message: string; fix?: string } {\n  if (err instanceof ApiError) {\n    return isAnalyticsBusy(err.message)\n      ? { code: err.code, message: err.message, fix: ANALYTICS_BUSY_FIX }\n      : { code: err.code, message: err.message };\n  }\n  return { code: \"NETWORK_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" };\n}\n\ntype CommandErrorEnvelope = { code: ErrorCode; message: string; fix?: string };\n\n/**\n * A refused request, with `fix` only where it applies: a rejected request gets\n * the command's correction, and anything else (busy, unavailable, unreachable)\n * keeps its own code, so an agent waits rather than rewriting a valid request.\n */\nfunction requestErrorEnvelope(err: unknown, correction: string, correctsLocalInput: boolean): CommandErrorEnvelope {\n  if (err instanceof z.ZodError || err instanceof SyntaxError) {\n    const message = err instanceof z.ZodError ? z.prettifyError(err) : err.message;\n    return { code: \"VALIDATION_ERROR\", message, ...(correctsLocalInput ? { fix: correction } : {}) };\n  }\n  const envelope = analyticsErrorEnvelope(err);\n  return envelope.code === \"VALIDATION_ERROR\" ? { ...envelope, fix: correction } : envelope;\n}\n\n/** A failed question report: the contract remedy only when the events themselves were refused. */\nexport function questionnaireErrorEnvelope(err: unknown): CommandErrorEnvelope {\n  return requestErrorEnvelope(\n    err,\n    \"Check baker analytics plan --full for missing app events. Resolve the named contract issue or narrow the observation window; never infer abandonment from completion totals.\",\n    false,\n  );\n}\n\n/** A failed plan read or preparation. */\nexport function trackingPlanErrorEnvelope(err: unknown): CommandErrorEnvelope {\n  return requestErrorEnvelope(\n    err,\n    \"Read baker analytics plan --full and baker tag-manager draft list to see what is prepared. Correct the request and repeat; do not publish until every requested installation is staged.\",\n    true,\n  );\n}\n"],"mappings":";;;;;;;;;AACA,SAAS,SAAS;AAmBX,SAAS,uBAAuB,KAAkE;AACvG,MAAI,eAAe,UAAU;AAC3B,WAAO,gBAAgB,IAAI,OAAO,IAC9B,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,SAAS,KAAK,mBAAmB,IAChE,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ;AAAA,EAC7C;AACA,SAAO,EAAE,MAAM,iBAAiB,SAAS,eAAe,QAAQ,IAAI,UAAU,mBAAmB;AACnG;AASA,SAAS,qBAAqB,KAAc,YAAoB,oBAAmD;AACjH,MAAI,eAAe,EAAE,YAAY,eAAe,aAAa;AAC3D,UAAM,UAAU,eAAe,EAAE,WAAW,EAAE,cAAc,GAAG,IAAI,IAAI;AACvE,WAAO,EAAE,MAAM,oBAAoB,SAAS,GAAI,qBAAqB,EAAE,KAAK,WAAW,IAAI,CAAC,EAAG;AAAA,EACjG;AACA,QAAM,WAAW,uBAAuB,GAAG;AAC3C,SAAO,SAAS,SAAS,qBAAqB,EAAE,GAAG,UAAU,KAAK,WAAW,IAAI;AACnF;AAGO,SAAS,2BAA2B,KAAoC;AAC7E,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,0BAA0B,KAAoC;AAC5E,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}