@koda-sl/baker-cli 0.564.0 → 0.566.0

package/dist/{triggers-3GJOP4QN.js → triggers-NQMVL755.js}

@@ -1,10 +1,10 @@
 import {
   failApi
-} from "./chunk-RM6ZIQHH.js";
+} from "./chunk-CXRFK47Z.js";
 import "./chunk-WR5Y64OE.js";
 import {
   triggerCatalogSchema
-} from "./chunk-7BV5QN2P.js";
+} from "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -141,4 +141,4 @@ export {
   shapeTriggerCatalog,
   triggersCommand
 };
-//# sourceMappingURL=triggers-3GJOP4QN.js.map
+//# sourceMappingURL=triggers-NQMVL755.js.map

package/dist/{unlink-636FAP6D.js → unlink-2RGEODVO.js}

@@ -2,8 +2,8 @@ import {
   failApi,
   failValidation,
   writeOk
-} from "./chunk-TSFHW2W4.js";
-import "./chunk-7BV5QN2P.js";
+} from "./chunk-OZTNA2O7.js";
+import "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -67,4 +67,4 @@ var unlinkCommand = defineCommand({
 export {
   unlinkCommand
 };
-//# sourceMappingURL=unlink-636FAP6D.js.map
+//# sourceMappingURL=unlink-2RGEODVO.js.map

package/dist/{unstage-445BCA7J.js → unstage-KLYI3EMB.js}

@@ -2,9 +2,9 @@ import {
   failApi,
   failValidation,
   validateScheduledAgentRef
-} from "./chunk-RM6ZIQHH.js";
+} from "./chunk-CXRFK47Z.js";
 import "./chunk-WR5Y64OE.js";
-import "./chunk-7BV5QN2P.js";
+import "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -85,4 +85,4 @@ export {
   unstageBody,
   unstageCommand
 };
-//# sourceMappingURL=unstage-445BCA7J.js.map
+//# sourceMappingURL=unstage-KLYI3EMB.js.map

package/dist/{update-V5WN6HAR.js → update-CVUA6TTH.js}

@@ -15,7 +15,7 @@ import {
 import {
   AVATAR_HANDLE_PATTERN,
   AVATAR_RELATIONS
-} from "./chunk-7BV5QN2P.js";
+} from "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -189,4 +189,4 @@ var updateCommand = defineCommand({
 export {
   updateCommand
 };
-//# sourceMappingURL=update-V5WN6HAR.js.map
+//# sourceMappingURL=update-CVUA6TTH.js.map

package/dist/{update-J357GPUA.js → update-HDI54TX2.js}

@@ -16,9 +16,9 @@ import {
   slackBody,
   validateScheduledAgentRef,
   writeOk
-} from "./chunk-RM6ZIQHH.js";
+} from "./chunk-CXRFK47Z.js";
 import "./chunk-WR5Y64OE.js";
-import "./chunk-7BV5QN2P.js";
+import "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -152,4 +152,4 @@ var updateCommand = defineCommand({
 export {
   updateCommand
 };
-//# sourceMappingURL=update-J357GPUA.js.map
+//# sourceMappingURL=update-HDI54TX2.js.map

package/dist/{update-U4UVU7LC.js → update-YUMXVVIV.js}

@@ -6,8 +6,8 @@ import {
   parsePriority,
   parseTagList,
   writeOk
-} from "./chunk-TSFHW2W4.js";
-import "./chunk-7BV5QN2P.js";
+} from "./chunk-OZTNA2O7.js";
+import "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -98,4 +98,4 @@ var updateCommand = defineCommand({
 export {
   updateCommand
 };
-//# sourceMappingURL=update-U4UVU7LC.js.map
+//# sourceMappingURL=update-YUMXVVIV.js.map

package/dist/{update-64M3KSXE.js → update-ZUB7IM4K.js}

@@ -2,8 +2,8 @@ import {
   failApi,
   failValidation,
   writeOk
-} from "./chunk-TSFHW2W4.js";
-import "./chunk-7BV5QN2P.js";
+} from "./chunk-OZTNA2O7.js";
+import "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -63,4 +63,4 @@ var tagsUpdateCommand = defineCommand({
 export {
   tagsUpdateCommand
 };
-//# sourceMappingURL=update-64M3KSXE.js.map
+//# sourceMappingURL=update-ZUB7IM4K.js.map

package/dist/{upload-PCXMVTGL.js → upload-RARJSXYY.js}

@@ -1,6 +1,6 @@
 import {
   runVideoIngest
-} from "./chunk-I4VURNFW.js";
+} from "./chunk-5O57QLEV.js";
 import "./chunk-FKOECEVC.js";
 import "./chunk-RJ2ETGAQ.js";
 import {
@@ -11,7 +11,7 @@ import {
   librarySaveHint
 } from "./chunk-I7OJZ7QE.js";
 import "./chunk-G6U45QD3.js";
-import "./chunk-7BV5QN2P.js";
+import "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -134,4 +134,4 @@ var uploadCommand = defineCommand({
 export {
   uploadCommand
 };
-//# sourceMappingURL=upload-PCXMVTGL.js.map
+//# sourceMappingURL=upload-RARJSXYY.js.map

package/dist/{url-params-NEVV6NED.js → url-params-YRMDSBOO.js}

@@ -1,13 +1,13 @@
 import {
   handleLinkedinError,
   resolveAccountIdArg
-} from "./chunk-QML3FCJC.js";
+} from "./chunk-JPICIFPM.js";
 import {
   writeAdsJson
 } from "./chunk-RBCO3C3Q.js";
 import {
   LINKEDIN_TRACKING_PARAMS_AD_SET_MAX
-} from "./chunk-7BV5QN2P.js";
+} from "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -98,4 +98,4 @@ export {
   hints,
   urlParamsCommand
 };
-//# sourceMappingURL=url-params-NEVV6NED.js.map
+//# sourceMappingURL=url-params-YRMDSBOO.js.map

package/dist/{validate-73GLPP7O.js → validate-NG3O63DD.js}

@@ -1,26 +1,26 @@
 import {
   outputRatioWarningsFor,
   shownBaseline
-} from "./chunk-J35R2D6B.js";
-import "./chunk-ERQZNOKZ.js";
+} from "./chunk-SSEJKI43.js";
+import "./chunk-FZ4OKE7N.js";
 import {
   creativeSlugFromCanvasPath
 } from "./chunk-EJBLF2LI.js";
 import {
   exitOnPrepareError,
   prepareCanvas
-} from "./chunk-TJHEMCST.js";
-import "./chunk-T6RZ7ZOM.js";
-import "./chunk-KPXURSDF.js";
+} from "./chunk-ZF5G7QTP.js";
+import "./chunk-6AK74BNG.js";
+import "./chunk-NQVUPVI5.js";
 import "./chunk-CP6RFWLW.js";
 import "./chunk-EKX37C3T.js";
 import "./chunk-Q5DFEVLE.js";
-import "./chunk-KGAYDZM2.js";
+import "./chunk-J47JWEHU.js";
 import "./chunk-OFMFBRSL.js";
-import "./chunk-RNS5MVHS.js";
+import "./chunk-2KT7DG5E.js";
 import "./chunk-UKZKLXTE.js";
-import "./chunk-UHWGXVYT.js";
-import "./chunk-MXGXVYF3.js";
+import "./chunk-SICI27M7.js";
+import "./chunk-PX2VBLV7.js";
 import "./chunk-KDAINT54.js";
 import "./chunk-G6XKD7QE.js";
 import "./chunk-4H6XLX7E.js";
@@ -46,7 +46,7 @@ import "./chunk-E56V3RFO.js";
 import "./chunk-EL3TDR5S.js";
 import "./chunk-G6U45QD3.js";
 import "./chunk-X6U3B6YK.js";
-import "./chunk-7BV5QN2P.js";
+import "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -122,4 +122,4 @@ var validateCommand = defineCommand({
 export {
   validateCommand
 };
-//# sourceMappingURL=validate-73GLPP7O.js.map
+//# sourceMappingURL=validate-NG3O63DD.js.map

package/dist/{videos-HROOMEHA.js → videos-IWTKAIJL.js}

@@ -25,17 +25,17 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
     get: () => import("./get-BQBLPGFE.js").then((m) => m.getCommand),
     group: () => import("./group-THZPJALS.js").then((m) => m.groupCommand),
     search: () => import("./search-QQDR74KQ.js").then((m) => m.searchCommand),
-    upload: () => import("./upload-PCXMVTGL.js").then((m) => m.uploadCommand),
-    ingest: () => import("./ingest-M47H5CT7.js").then((m) => m.ingestCommand),
+    upload: () => import("./upload-RARJSXYY.js").then((m) => m.uploadCommand),
+    ingest: () => import("./ingest-NGNELRYE.js").then((m) => m.ingestCommand),
     fetch: () => import("./fetch-KB64NPDF.js").then((m) => m.fetchCommand),
-    download: () => import("./download-CP3Y2K54.js").then((m) => m.downloadCommand),
+    download: () => import("./download-5NLYEXK3.js").then((m) => m.downloadCommand),
     describe: () => import("./describe-EAPKNUUU.js").then((m) => m.describeCommand),
     delete: () => import("./delete-46B7DSQV.js").then((m) => m.deleteCommand),
-    retry: () => import("./retry-ZZM63KIG.js").then((m) => m.retryCommand),
-    tags: () => import("./tags-T4QZEQIR.js").then((m) => m.tagsCommand)
+    retry: () => import("./retry-ZJYQRVXA.js").then((m) => m.retryCommand),
+    tags: () => import("./tags-R66INE52.js").then((m) => m.tagsCommand)
   }
 });
 export {
   videosCommand
 };
-//# sourceMappingURL=videos-HROOMEHA.js.map
+//# sourceMappingURL=videos-IWTKAIJL.js.map

package/dist/videos-NITQKILV.js

@@ -0,0 +1,146 @@
+import {
+  handleMetaError
+} from "./chunk-5H6N36LS.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-RBCO3C3Q.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/videos.ts
+import { createWriteStream, mkdirSync } from "fs";
+import { join } from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+
+// ../api/src/ads-meta/adVideos.ts
+import { z } from "zod";
+var metaAdVideoSchema = z.object({
+  videoId: z.string(),
+  /** Short-lived MP4 address; null when Meta does not hand the file to this connection. */
+  source: z.string().url().nullable(),
+  seconds: z.number().nullable(),
+  title: z.string().nullable(),
+  thumbnail: z.string().url().nullable()
+});
+var metaAdVideosResponseSchema = z.object({
+  adId: z.string().nullable(),
+  creativeId: z.string(),
+  videos: z.array(metaAdVideoSchema)
+});
+
+// src/commands/ads/meta/videos.ts
+import { defineCommand } from "citty";
+var DEFAULT_OUT_DIR = "/tmp/meta-ad-videos";
+function downloadHints(results) {
+  const all = results.flatMap((result) => result.videos);
+  const hints = [];
+  if (all.length === 0)
+    hints.push("No video in these ads: they are image or carousel ads (`creatives --creative-id` shows their assets).");
+  if (all.some((video) => video.file === null && video.url === void 0)) {
+    hints.push(
+      "A video with no file is a copy Meta does not hand to this connection (usually the Page's copy of the same upload); the other video of that ad is the same film."
+    );
+  }
+  if (all.some((video) => video.file !== null)) {
+    hints.push(
+      "Watch before judging: a frame strip (`ffmpeg -i <file> -vf fps=2,scale=240:-1,tile=8x2 strip.jpg`) and the 3-second hold rate from `insights --level ad --intent video`."
+    );
+  }
+  return hints;
+}
+async function download(url, file) {
+  const response = await fetch(url);
+  if (!response.ok || !response.body) throw new Error(`Meta's video address answered ${response.status}`);
+  await pipeline(Readable.fromWeb(response.body), createWriteStream(file));
+  return Number(response.headers.get("content-length") ?? 0);
+}
+async function fetchAndSave(params, outDir, save) {
+  const data = metaAdVideosResponseSchema.parse(await apiGet("/api/ads/meta/videos", params));
+  const owner = data.adId ?? data.creativeId;
+  const videos = [];
+  for (const video of data.videos) {
+    if (!video.source || !save) {
+      videos.push({
+        videoId: video.videoId,
+        file: null,
+        ...video.source ? { url: video.source } : {},
+        seconds: video.seconds,
+        megabytes: null
+      });
+      continue;
+    }
+    const file = join(outDir, `${owner}-${video.videoId}.mp4`);
+    const bytes = await download(video.source, file);
+    videos.push({
+      videoId: video.videoId,
+      file,
+      seconds: video.seconds,
+      megabytes: bytes ? Math.round(bytes / 1e5) / 10 : null
+    });
+  }
+  return { adId: data.adId, creativeId: data.creativeId, videos };
+}
+var splitIds = (value) => typeof value === "string" ? value.split(",").map((id) => id.trim()).filter(Boolean) : [];
+registerSchema({
+  command: "ads.meta.videos",
+  description: "Download the video files of running Meta ads (or creatives) to disk, to watch, cut or analyse them. One call for several ads.",
+  args: {
+    "ad-id": { type: "string", description: "Ad id, or several comma-separated", required: false },
+    "creative-id": { type: "string", description: "Creative id, or several comma-separated", required: false },
+    "out-dir": { type: "string", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})`, required: false },
+    "url-only": {
+      type: "boolean",
+      description: "Return Meta's short-lived addresses instead of files",
+      required: false
+    }
+  }
+});
+var videosCommand = defineCommand({
+  meta: {
+    name: "videos",
+    description: `Download the video files behind Meta ads, to watch, cut or analyse the company's own ads.
+  baker ads meta videos --ad-id 120211234567890,120211234567891     \u2014 MP4s in ${DEFAULT_OUT_DIR}
+  baker ads meta videos --creative-id 9988 --out-dir /tmp/ads        \u2014 by creative
+Start here when judging video ads: \`insights --level ad --intent video\` names the ads, this gets their files.`
+  },
+  args: {
+    "ad-id": { type: "string", description: "Ad id, or several comma-separated" },
+    "creative-id": { type: "string", description: "Creative id, or several comma-separated" },
+    "out-dir": { type: "string", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})` },
+    // Not `--no-download`: citty reads any `--no-x` as `x: false`, so that flag would never be set.
+    "url-only": { type: "boolean", description: "Return Meta's short-lived addresses instead of files" }
+  },
+  run: async ({ args }) => {
+    const adIds = splitIds(args["ad-id"]);
+    const creativeIds = splitIds(args["creative-id"]);
+    if (adIds.length + creativeIds.length === 0) {
+      writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message: "Name --ad-id or --creative-id" } });
+      process.exit(1);
+    }
+    const outDir = typeof args["out-dir"] === "string" ? args["out-dir"] : DEFAULT_OUT_DIR;
+    const save = !args["url-only"];
+    if (save) mkdirSync(outDir, { recursive: true });
+    try {
+      const results = [];
+      for (const id of adIds) results.push(await fetchAndSave({ "ad-id": id }, outDir, save));
+      for (const id of creativeIds) results.push(await fetchAndSave({ "creative-id": id }, outDir, save));
+      writeJsonEnvelope({ ok: true, data: results, hints: downloadHints(results) });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  downloadHints,
+  videosCommand
+};
+//# sourceMappingURL=videos-NITQKILV.js.map

package/dist/videos-NITQKILV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/videos.ts","../../api/src/ads-meta/adVideos.ts"],"sourcesContent":["import { createWriteStream, mkdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport type { ReadableStream as WebReadableStream } from \"node:stream/web\";\nimport { type MetaAdVideosResponse, metaAdVideosResponseSchema } from \"@baker/api/ads-meta/adVideos\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleMetaError } from \"./shared.ts\";\n\n/**\n * The video files behind running ads, downloaded to disk so the agent can\n * watch, cut and judge the company's own ads. Before this it pulled them out of\n * a preview's HTML in about ten steps per ad.\n */\n\nconst DEFAULT_OUT_DIR = \"/tmp/meta-ad-videos\";\n\nexport interface DownloadedVideo {\n  videoId: string;\n  file: string | null;\n  /** Only with --url-only: Meta's short-lived address, instead of a file. */\n  url?: string;\n  seconds: number | null;\n  megabytes: number | null;\n}\n\n/** One line per video: where it is on disk, or why it is not. */\nexport function downloadHints(results: ReadonlyArray<{ videos: readonly DownloadedVideo[] }>): string[] {\n  const all = results.flatMap((result) => result.videos);\n  const hints: string[] = [];\n  if (all.length === 0)\n    hints.push(\"No video in these ads: they are image or carousel ads (`creatives --creative-id` shows their assets).\");\n  if (all.some((video) => video.file === null && video.url === undefined)) {\n    hints.push(\n      \"A video with no file is a copy Meta does not hand to this connection (usually the Page's copy of the same upload); the other video of that ad is the same film.\",\n    );\n  }\n  if (all.some((video) => video.file !== null)) {\n    hints.push(\n      \"Watch before judging: a frame strip (`ffmpeg -i <file> -vf fps=2,scale=240:-1,tile=8x2 strip.jpg`) and the 3-second hold rate from `insights --level ad --intent video`.\",\n    );\n  }\n  return hints;\n}\n\nasync function download(url: string, file: string): Promise<number> {\n  const response = await fetch(url);\n  if (!response.ok || !response.body) throw new Error(`Meta's video address answered ${response.status}`);\n  await pipeline(Readable.fromWeb(response.body as WebReadableStream<Uint8Array>), createWriteStream(file));\n  return Number(response.headers.get(\"content-length\") ?? 0);\n}\n\nasync function fetchAndSave(\n  params: Record<string, string>,\n  outDir: string,\n  save: boolean,\n): Promise<{ adId: string | null; creativeId: string; videos: DownloadedVideo[] }> {\n  const data: MetaAdVideosResponse = metaAdVideosResponseSchema.parse(await apiGet(\"/api/ads/meta/videos\", params));\n  const owner = data.adId ?? data.creativeId;\n  const videos: DownloadedVideo[] = [];\n  for (const video of data.videos) {\n    if (!video.source || !save) {\n      videos.push({\n        videoId: video.videoId,\n        file: null,\n        ...(video.source ? { url: video.source } : {}),\n        seconds: video.seconds,\n        megabytes: null,\n      });\n      continue;\n    }\n    const file = join(outDir, `${owner}-${video.videoId}.mp4`);\n    const bytes = await download(video.source, file);\n    videos.push({\n      videoId: video.videoId,\n      file,\n      seconds: video.seconds,\n      megabytes: bytes ? Math.round(bytes / 1e5) / 10 : null,\n    });\n  }\n  return { adId: data.adId, creativeId: data.creativeId, videos };\n}\n\nconst splitIds = (value: unknown): string[] =>\n  typeof value === \"string\"\n    ? value\n        .split(\",\")\n        .map((id) => id.trim())\n        .filter(Boolean)\n    : [];\n\nregisterSchema({\n  command: \"ads.meta.videos\",\n  description:\n    \"Download the video files of running Meta ads (or creatives) to disk, to watch, cut or analyse them. One call for several ads.\",\n  args: {\n    \"ad-id\": { type: \"string\", description: \"Ad id, or several comma-separated\", required: false },\n    \"creative-id\": { type: \"string\", description: \"Creative id, or several comma-separated\", required: false },\n    \"out-dir\": { type: \"string\", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})`, required: false },\n    \"url-only\": {\n      type: \"boolean\",\n      description: \"Return Meta's short-lived addresses instead of files\",\n      required: false,\n    },\n  },\n});\n\nexport const videosCommand = defineCommand({\n  meta: {\n    name: \"videos\",\n    description: `Download the video files behind Meta ads, to watch, cut or analyse the company's own ads.\n  baker ads meta videos --ad-id 120211234567890,120211234567891     — MP4s in ${DEFAULT_OUT_DIR}\n  baker ads meta videos --creative-id 9988 --out-dir /tmp/ads        — by creative\nStart here when judging video ads: \\`insights --level ad --intent video\\` names the ads, this gets their files.`,\n  },\n  args: {\n    \"ad-id\": { type: \"string\", description: \"Ad id, or several comma-separated\" },\n    \"creative-id\": { type: \"string\", description: \"Creative id, or several comma-separated\" },\n    \"out-dir\": { type: \"string\", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})` },\n    // Not `--no-download`: citty reads any `--no-x` as `x: false`, so that flag would never be set.\n    \"url-only\": { type: \"boolean\", description: \"Return Meta's short-lived addresses instead of files\" },\n  },\n  run: async ({ args }) => {\n    const adIds = splitIds(args[\"ad-id\"]);\n    const creativeIds = splitIds(args[\"creative-id\"]);\n    if (adIds.length + creativeIds.length === 0) {\n      writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Name --ad-id or --creative-id\" } });\n      process.exit(1);\n    }\n    const outDir = typeof args[\"out-dir\"] === \"string\" ? args[\"out-dir\"] : DEFAULT_OUT_DIR;\n    const save = !args[\"url-only\"];\n    if (save) mkdirSync(outDir, { recursive: true });\n    try {\n      const results = [];\n      for (const id of adIds) results.push(await fetchAndSave({ \"ad-id\": id }, outDir, save));\n      for (const id of creativeIds) results.push(await fetchAndSave({ \"creative-id\": id }, outDir, save));\n      writeJsonEnvelope({ ok: true, data: results, hints: downloadHints(results) });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n","/**\n * The video files behind a running ad, so an agent can watch and cut the\n * company's own ads instead of scraping them out of a preview.\n *\n * A creative names its videos in three places, and which one depends on how\n * it was built: `video_id` on the creative itself, `object_story_spec.video_data`\n * for a single-video ad, and `asset_feed_spec.videos` for a dynamic creative\n * (Baker builds these itself). `GET /{video_id}?fields=source` then hands back\n * a short-lived MP4 address.\n */\nimport { z } from \"zod\";\n\n/** The parts of a Meta creative that can name a video. */\nexport interface CreativeVideoFields {\n  video_id?: string;\n  object_story_spec?: { video_data?: { video_id?: string } };\n  asset_feed_spec?: { videos?: Array<{ video_id?: string }> };\n}\n\n/** Every video a creative uses, each once, in the order Meta lists them. */\nexport function videoIdsOfCreative(creative: CreativeVideoFields): string[] {\n  const ids = [\n    creative.video_id,\n    creative.object_story_spec?.video_data?.video_id,\n    ...(creative.asset_feed_spec?.videos ?? []).map((video) => video.video_id),\n  ];\n  return [...new Set(ids.filter((id): id is string => typeof id === \"string\" && id.length > 0))];\n}\n\nexport const metaAdVideoSchema = z.object({\n  videoId: z.string(),\n  /** Short-lived MP4 address; null when Meta does not hand the file to this connection. */\n  source: z.string().url().nullable(),\n  seconds: z.number().nullable(),\n  title: z.string().nullable(),\n  thumbnail: z.string().url().nullable(),\n});\nexport type MetaAdVideo = z.infer<typeof metaAdVideoSchema>;\n\nexport const metaAdVideosResponseSchema = z.object({\n  adId: z.string().nullable(),\n  creativeId: z.string(),\n  videos: z.array(metaAdVideoSchema),\n});\nexport type MetaAdVideosResponse = z.infer<typeof metaAdVideosResponseSchema>;\n"],"mappings":"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","names":[]}

package/dist/{viewer-check-7YL3WXQK.js → viewer-check-JNFFC5IK.js}

@@ -22,11 +22,11 @@ import {
   viewerCheckCommand,
   viewerCheckFailure,
   viewerCheckSkip
-} from "./chunk-T6RZ7ZOM.js";
-import "./chunk-KPXURSDF.js";
-import "./chunk-KGAYDZM2.js";
+} from "./chunk-6AK74BNG.js";
+import "./chunk-NQVUPVI5.js";
+import "./chunk-J47JWEHU.js";
 import "./chunk-OFMFBRSL.js";
-import "./chunk-RNS5MVHS.js";
+import "./chunk-2KT7DG5E.js";
 import "./chunk-UKZKLXTE.js";
 import "./chunk-KDAINT54.js";
 import "./chunk-G6XKD7QE.js";
@@ -42,7 +42,7 @@ import "./chunk-E56V3RFO.js";
 import "./chunk-EL3TDR5S.js";
 import "./chunk-G6U45QD3.js";
 import "./chunk-X6U3B6YK.js";
-import "./chunk-7BV5QN2P.js";
+import "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -80,4 +80,4 @@ export {
   viewerCheckFailure,
   viewerCheckSkip
 };
-//# sourceMappingURL=viewer-check-7YL3WXQK.js.map
+//# sourceMappingURL=viewer-check-JNFFC5IK.js.map

package/dist/{web-JUSF75RR.js → web-VR6XXNL6.js}

@@ -1,13 +1,13 @@
 import {
   webDepthHints,
   webSourceHints
-} from "./chunk-Y4B7RLIE.js";
+} from "./chunk-JAZZ3HFR.js";
 import {
   handleResearchError,
   writeResearchHints,
   writeResearchJson
 } from "./chunk-D3YAFC6K.js";
-import "./chunk-7BV5QN2P.js";
+import "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -170,4 +170,4 @@ export {
   webCommand,
   webMarkdown
 };
-//# sourceMappingURL=web-JUSF75RR.js.map
+//# sourceMappingURL=web-VR6XXNL6.js.map

package/dist/{winning-ads-ZEVLZPOA.js → winning-ads-M6UG74BB.js}

@@ -72,9 +72,9 @@ Full guide: __tooling__/docs/tools/baker/winning-ads.md`
     landings: () => import("./landings-AELJXEYN.js").then((m) => m.landingsCommand),
     "search-copy": () => import("./search-copy-EB3TONDS.js").then((m) => m.searchCopyCommand),
     content: () => import("./content-EQZKKIST.js").then((m) => m.contentCommand),
-    fit: () => import("./fit-DEY4SJ3Z.js").then((m) => m.fitCommand),
+    fit: () => import("./fit-JQ7MR5FU.js").then((m) => m.fitCommand),
     unfollow: () => import("./unfollow-OEMFPAFS.js").then((m) => m.unfollowCommand),
-    refresh: () => import("./refresh-BDEAUQEB.js").then((m) => m.refreshCommand),
+    refresh: () => import("./refresh-GZSPTRQO.js").then((m) => m.refreshCommand),
     hooks: () => import("./seeds-RGIFHHYC.js").then((m) => m.hooksCommand),
     mechanisms: () => import("./seeds-RGIFHHYC.js").then((m) => m.mechanismsCommand),
     formats: () => import("./seeds-RGIFHHYC.js").then((m) => m.formatsCommand)
@@ -83,4 +83,4 @@ Full guide: __tooling__/docs/tools/baker/winning-ads.md`
 export {
   winningAdsCommand
 };
-//# sourceMappingURL=winning-ads-ZEVLZPOA.js.map
+//# sourceMappingURL=winning-ads-M6UG74BB.js.map

package/dist/{write-commands-2TODH3QX.js → write-commands-6OHNL3UR.js}

@@ -16,10 +16,10 @@ import {
   stageLinkedinOps,
   stageOp,
   stageStatusChange
-} from "./chunk-SKW7CDXE.js";
+} from "./chunk-2A24YMHV.js";
 import {
   handleLinkedinError
-} from "./chunk-QML3FCJC.js";
+} from "./chunk-JPICIFPM.js";
 import {
   repeatedValues
 } from "./chunk-ERSX3MKH.js";
@@ -43,7 +43,7 @@ import {
   TRACKING_PARAM_DYNAMIC_VALUES,
   campaignExcludeCompaniesSchema,
   sponsoredPostUrn
-} from "./chunk-7BV5QN2P.js";
+} from "./chunk-2J5OCFOW.js";
 import "./chunk-QV6AST5T.js";
 import "./chunk-WCU362Z6.js";
 import "./chunk-GIWHHCD6.js";
@@ -1521,4 +1521,4 @@ export {
   sponsoredPostArgs,
   trackingParamsPayload
 };
-//# sourceMappingURL=write-commands-2TODH3QX.js.map
+//# sourceMappingURL=write-commands-6OHNL3UR.js.map

package/dist/{x-5OJJOFRB.js → x-TSLM5O2T.js}

@@ -27,15 +27,15 @@ Full guide: __tooling__/docs/tools/baker/ads-x.md`
   subCommands: {
     accounts: () => import("./accounts-AK4QIG24.js").then((m) => m.accountsCommand),
     funding: () => import("./funding-BSAHWU35.js").then((m) => m.fundingCommand),
-    campaigns: () => import("./campaigns-KMHUJNZX.js").then((m) => m.campaignsCommand),
-    "line-items": () => import("./line-items-PUWPYZOV.js").then((m) => m.lineItemsCommand),
-    "promoted-tweets": () => import("./promoted-tweets-ATKIVR2F.js").then((m) => m.promotedTweetsCommand),
+    campaigns: () => import("./campaigns-KJ6TFKHO.js").then((m) => m.campaignsCommand),
+    "line-items": () => import("./line-items-44QSYZTE.js").then((m) => m.lineItemsCommand),
+    "promoted-tweets": () => import("./promoted-tweets-N7XPG3XB.js").then((m) => m.promotedTweetsCommand),
     tweets: () => import("./tweets-MLDLLLDB.js").then((m) => m.tweetsCommand),
     cards: () => import("./cards-CAOGPPG4.js").then((m) => m.cardsCommand),
-    draft: () => import("./draft-3HRGCNWA.js").then((m) => m.draftCommand),
+    draft: () => import("./draft-33DTE674.js").then((m) => m.draftCommand),
     media: () => import("./media-DGV2AMZI.js").then((m) => m.mediaCommand),
     audiences: () => import("./audiences-7OS2ZJYO.js").then((m) => m.audiencesCommand),
-    "targeting-criteria": () => import("./targeting-criteria-JTY4OUQV.js").then((m) => m.targetingCriteriaCommand),
+    "targeting-criteria": () => import("./targeting-criteria-CR5VHR35.js").then((m) => m.targetingCriteriaCommand),
     "targeting-constants": () => import("./targeting-constants-RJS2STR5.js").then((m) => m.targetingConstantsCommand),
     "active-entities": () => import("./active-entities-HR7NJJLU.js").then((m) => m.activeEntitiesCommand),
     stats: () => import("./stats-XNKAJD2Z.js").then((m) => m.statsCommand)
@@ -44,4 +44,4 @@ Full guide: __tooling__/docs/tools/baker/ads-x.md`
 export {
   xCommand
 };
-//# sourceMappingURL=x-5OJJOFRB.js.map
+//# sourceMappingURL=x-TSLM5O2T.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koda-sl/baker-cli",
-  "version": "0.564.0",
+  "version": "0.566.0",
   "description": "AI-agent-first CLI for interacting with Baker, including the Baker creative canvas.",
   "type": "module",
   "bin": {