@koda-sl/baker-cli 0.564.0 → 0.565.0

package/dist/{meta-5KQ6CQBT.js.map → meta-5TRG7RTQ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/ads/meta/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\n/**\n * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.\n *\n * Every backend read route has a command except `/currency`: `account` already\n * returns the currency and time zone, so a second command for two of its\n * fields would only be a second place to look.\n *\n * Default behaviors that matter:\n *   - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.\n *   - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.\n *   - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).\n *   - Heavy insights queries auto-fall to async (poll loop hidden).\n *   - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.\n */\nexport const metaCommand = defineCommand({\n  meta: {\n    name: \"meta\",\n    description: `Meta Marketing API — AI-first command surface (Facebook + Instagram ads).\n\nDiscovery:\n  baker ads meta accounts                                — accounts in this company's connected scope\n  baker ads meta businesses                              — Business Manager IDs\n  baker ads meta pages                                   — Facebook Pages the selected ad accounts can promote (an ad's identity)\n  baker ads meta lead-forms --page-id 100635183117758    — instant (lead) forms on a Page, with lead counts\n  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json — stage a new form\n  baker ads meta leads --form-id 987654321               — the leads one form collected (contact details masked)\n\nSnapshot a running account (default = ACTIVE only):\n  baker ads meta campaigns --account-id act_123\n  baker ads meta adsets --campaign-id 6123\n  baker ads meta ads --adset-id 6123\n  baker ads meta campaigns --account-id act_123 --all-statuses        — include paused, archived\n\nBuild targeting (Meta takes ids, never names — look them up first):\n  baker ads meta targeting search --account-id act_123 --q \"solar energy\"  — interest/behavior/employer… ids\n  baker ads meta targeting geo --account-id act_123 --q Madrid             — location keys\n  baker ads meta targeting validate --account-id act_123 --targeting-file t.json\n  baker ads meta targeting estimate --account-id act_123 --targeting-file t.json --optimization-goal LEAD_GENERATION\n  baker ads meta targeting describe --account-id act_123 --adset-id 6123   — the audience in Meta's words\n\nIdentities and libraries:\n  baker ads meta instagram-accounts --account-id act_123              — the --instagram-user an ad can run as\n  baker ads meta apps --account-id act_123                            — apps it can promote\n  baker ads meta dsa-recommendations --account-id act_123             — EU DSA beneficiary/payor names\n  baker ads meta images --account-id act_123                          — image hashes already on Meta\n  baker ads meta labels --account-id act_123\n  baker ads meta catalogs --business-id 601050769212882               — product catalogs; --catalog-id for product sets; products/sets/feeds/diagnostics\n  baker ads meta page-photos upload --page-id … --image-id …           — a photo on a Page, not posted (Instant Experiences)\n  baker ads meta instant-experiences --page-id 904238019441800        — full-screen pages an ad can open (collection ads)\n  baker ads meta studies --account-id act_123                         — A/B tests; --study-id for results\n  baker ads meta high-demand-periods --campaign-id 6123               — budget boosts\n  baker ads meta page-posts --page-id 904238019441800                 — posts an ad can boost; instagram-media for Instagram\n  baker ads meta block-lists --account-id act_123                     — sites and apps ads stay off (brand safety)\n  baker ads meta reach-frequency --account-id act_123                 — reach & frequency quotes; predict | reserve | cancel\n  baker ads meta account-settings --account-id act_123 --spending-limit 5000 — account name / spending limit (staged)\n  baker ads meta comments --ad-id 120211234567890                     — comments on an ad's post\n  baker ads meta account-details --account-id act_123 --show users    — people, Meta's suggestions, Advantage+ controls, playables, page sets\n\nDrill in:\n  baker ads meta account --account-id act_123                         — currency, balance, business, whether it can deliver\n  baker ads meta creatives --creative-id 9988,9989                    — creatives' copy, link and assets, several at once\n  baker ads meta audiences --name-contains buyers                     — one audience and its lookalikes\n  baker ads meta custom-conversions --account-id act_123              — the marketer's own conversions (\"my conversions\")\n  baker ads meta pixels --account-id act_123                          — pixel list\n  baker ads meta pixels --pixel-id 9988 --stats --days 7              — firing health\n\nPerformance (the workhorse):\n  baker ads meta insights --object act_123                                                    — defaults: level=account, intent=baseline, last_7d\n  baker ads meta insights --object act_123 --intent revenue --date-preset last_28d\n  baker ads meta insights --object act_123 --level ad --intent ranking                        — flag creatives to refresh\n  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age  — placement × age\n  baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31   — auto-async\n  baker ads meta insights --list-intents\n\nAutomated rules (run on Meta, unattended, once published):\n  baker ads meta rules --account-id act_123                           — every rule and what it does\n  baker ads meta rules history --rule-id 1132635173044914             — what a rule did and when\n  baker ads meta rules create --name \"Stop expensive ads\" --apply-to ad --when \"cost_per_result>20\" --action pause\n\nA/B tests (Meta splits the audience between versions and calls the winner):\n  baker ads meta adsets duplicate 6123 --name \"… – lookalike\"         — then change ONE thing on the copy\n  baker ads meta studies create --name \"Broad vs lookalike\" --adsets 6123,meta_temp_ab12 --start 2026-10-20T08:00Z --days 14\n\nAudit & review:\n  baker ads meta activities --account-id act_123 --days 14\n  baker ads meta preview --ad-id 9988 --ad-format MOBILE_FEED_STANDARD             — SEE the ad: displayed text + a picture\nFull guide: __tooling__/docs/tools/baker/ads-meta.md`,\n  },\n  subCommands: {\n    accounts: () => import(\"./accounts.ts\").then((m) => m.accountsCommand),\n    account: () => import(\"./account.ts\").then((m) => m.accountCommand),\n    businesses: () => import(\"./businesses.ts\").then((m) => m.businessesCommand),\n    pages: () => import(\"./pages.ts\").then((m) => m.pagesCommand),\n    \"lead-forms\": () => import(\"./leads.ts\").then((m) => m.leadFormsCommand),\n    \"instant-experiences\": () => import(\"./instant-experiences.ts\").then((m) => m.instantExperiencesCommand),\n    leads: () => import(\"./leads.ts\").then((m) => m.leadsCommand),\n    campaigns: () => import(\"./campaigns.ts\").then((m) => m.campaignsCommand),\n    adsets: () => import(\"./adsets.ts\").then((m) => m.adsetsCommand),\n    ads: () => import(\"./ads.ts\").then((m) => m.adsListCommand),\n    creatives: () => import(\"./creatives.ts\").then((m) => m.creativesCommand),\n    audiences: () => import(\"./audiences.ts\").then((m) => m.audiencesCommand),\n    \"custom-conversions\": () => import(\"./custom-conversions.ts\").then((m) => m.customConversionsCommand),\n    pixels: () => import(\"./pixels.ts\").then((m) => m.pixelsCommand),\n    activities: () => import(\"./activities.ts\").then((m) => m.activitiesCommand),\n    insights: () => import(\"./insights.ts\").then((m) => m.insightsCommand),\n    preview: () => import(\"./preview.ts\").then((m) => m.previewCommand),\n    targeting: () => import(\"./targeting.ts\").then((m) => m.targetingCommand),\n    \"instagram-accounts\": () => import(\"./account-assets.ts\").then((m) => m.instagramAccountsCommand),\n    apps: () => import(\"./account-assets.ts\").then((m) => m.appsCommand),\n    \"dsa-recommendations\": () => import(\"./account-assets.ts\").then((m) => m.dsaRecommendationsCommand),\n    images: () => import(\"./account-assets.ts\").then((m) => m.imagesCommand),\n    labels: () => import(\"./account-assets.ts\").then((m) => m.labelsCommand),\n    studies: () => import(\"./studies.ts\").then((m) => m.studiesCommand),\n    catalogs: () => import(\"./catalogs.ts\").then((m) => m.catalogsCommand),\n    \"page-photos\": () => import(\"./page-photos.ts\").then((m) => m.pagePhotosCommand),\n    \"page-posts\": () => import(\"./account-level.ts\").then((m) => m.pagePostsCommand),\n    \"instagram-media\": () => import(\"./account-level.ts\").then((m) => m.instagramMediaCommand),\n    comments: () => import(\"./account-level.ts\").then((m) => m.commentsCommand),\n    \"account-settings\": () => import(\"./account-level.ts\").then((m) => m.accountSettingsCommand),\n    \"account-details\": () => import(\"./account-level.ts\").then((m) => m.accountDetailsCommand),\n    \"block-lists\": () => import(\"./account-level.ts\").then((m) => m.blockListsCommand),\n    \"reach-frequency\": () => import(\"./account-level.ts\").then((m) => m.reachFrequencyCommand),\n    \"high-demand-periods\": () => import(\"./account-assets.ts\").then((m) => m.highDemandPeriodsCommand),\n    rules: () => import(\"./rules.ts\").then((m) => m.rulesCommand),\n    media: () => import(\"./media.ts\").then((m) => m.metaMediaCommand),\n    draft: () => import(\"./draft.ts\").then((m) => m.metaDraftCommand),\n  },\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/commands/ads/meta/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\n/**\n * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.\n *\n * Every backend read route has a command except `/currency`: `account` already\n * returns the currency and time zone, so a second command for two of its\n * fields would only be a second place to look.\n *\n * Default behaviors that matter:\n *   - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.\n *   - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.\n *   - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).\n *   - Heavy insights queries auto-fall to async (poll loop hidden).\n *   - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.\n */\nexport const metaCommand = defineCommand({\n  meta: {\n    name: \"meta\",\n    description: `Meta Marketing API — AI-first command surface (Facebook + Instagram ads).\n\nDiscovery:\n  baker ads meta accounts                                — accounts in this company's connected scope\n  baker ads meta businesses                              — Business Manager IDs\n  baker ads meta pages                                   — Facebook Pages the selected ad accounts can promote (an ad's identity)\n  baker ads meta lead-forms --page-id 100635183117758    — instant (lead) forms on a Page, with lead counts\n  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json — stage a new form\n  baker ads meta leads --form-id 987654321               — the leads one form collected (contact details masked)\n\nSnapshot a running account (default = ACTIVE only):\n  baker ads meta campaigns --account-id act_123\n  baker ads meta adsets --campaign-id 6123\n  baker ads meta ads --adset-id 6123\n  baker ads meta campaigns --account-id act_123 --all-statuses        — include paused, archived\n\nBuild targeting (Meta takes ids, never names — look them up first):\n  baker ads meta targeting search --account-id act_123 --q \"solar energy\"  — interest/behavior/employer… ids\n  baker ads meta targeting geo --account-id act_123 --q Madrid             — location keys\n  baker ads meta targeting validate --account-id act_123 --targeting-file t.json\n  baker ads meta targeting estimate --account-id act_123 --targeting-file t.json --optimization-goal LEAD_GENERATION\n  baker ads meta targeting describe --account-id act_123 --adset-id 6123   — the audience in Meta's words\n\nIdentities and libraries:\n  baker ads meta instagram-accounts --account-id act_123              — the --instagram-user an ad can run as\n  baker ads meta apps --account-id act_123                            — apps it can promote\n  baker ads meta dsa-recommendations --account-id act_123             — EU DSA beneficiary/payor names\n  baker ads meta images --account-id act_123                          — image hashes already on Meta\n  baker ads meta labels --account-id act_123\n  baker ads meta catalogs --business-id 601050769212882               — product catalogs; --catalog-id for product sets; products/sets/feeds/diagnostics\n  baker ads meta page-photos upload --page-id … --image-id …           — a photo on a Page, not posted (Instant Experiences)\n  baker ads meta instant-experiences --page-id 904238019441800        — full-screen pages an ad can open (collection ads)\n  baker ads meta studies --account-id act_123                         — A/B tests; --study-id for results\n  baker ads meta high-demand-periods --campaign-id 6123               — budget boosts\n  baker ads meta page-posts --page-id 904238019441800                 — posts an ad can boost; instagram-media for Instagram\n  baker ads meta block-lists --account-id act_123                     — sites and apps ads stay off (brand safety)\n  baker ads meta reach-frequency --account-id act_123                 — reach & frequency quotes; predict | reserve | cancel\n  baker ads meta account-settings --account-id act_123 --spending-limit 5000 — account name / spending limit (staged)\n  baker ads meta comments --ad-id 120211234567890                     — comments on an ad's post\n  baker ads meta account-details --account-id act_123 --show users    — people, Meta's suggestions, Advantage+ controls, playables, page sets\n\nDrill in:\n  baker ads meta account --account-id act_123                         — currency, balance, business, whether it can deliver\n  baker ads meta creatives --creative-id 9988,9989                    — creatives' copy, link and assets, several at once\n  baker ads meta audiences --name-contains buyers                     — one audience and its lookalikes\n  baker ads meta custom-conversions --account-id act_123              — the marketer's own conversions (\"my conversions\")\n  baker ads meta pixels --account-id act_123                          — pixel list\n  baker ads meta pixels --pixel-id 9988 --stats --days 7              — firing health\n\nPerformance (the workhorse):\n  baker ads meta insights --object act_123                                                    — defaults: level=account, intent=baseline, last_7d\n  baker ads meta insights --object act_123 --intent revenue --date-preset last_28d\n  baker ads meta insights --object act_123 --level ad --intent ranking                        — flag creatives to refresh\n  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age  — placement × age\n  baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31   — auto-async\n  baker ads meta insights --list-intents\n\nAutomated rules (run on Meta, unattended, once published):\n  baker ads meta rules --account-id act_123                           — every rule and what it does\n  baker ads meta rules history --rule-id 1132635173044914             — what a rule did and when\n  baker ads meta rules create --name \"Stop expensive ads\" --apply-to ad --when \"cost_per_result>20\" --action pause\n\nA/B tests (Meta splits the audience between versions and calls the winner):\n  baker ads meta adsets duplicate 6123 --name \"… – lookalike\"         — then change ONE thing on the copy\n  baker ads meta studies create --name \"Broad vs lookalike\" --adsets 6123,meta_temp_ab12 --start 2026-10-20T08:00Z --days 14\n\nAudit & review:\n  baker ads meta activities --account-id act_123 --days 14\n  baker ads meta preview --ad-id 9988 --ad-format MOBILE_FEED_STANDARD             — SEE the ad: displayed text + a picture\n  baker ads meta videos --ad-id 9988,9989                                         — download the ads' video files (MP4) to watch or cut\nFull guide: __tooling__/docs/tools/baker/ads-meta.md`,\n  },\n  subCommands: {\n    accounts: () => import(\"./accounts.ts\").then((m) => m.accountsCommand),\n    account: () => import(\"./account.ts\").then((m) => m.accountCommand),\n    businesses: () => import(\"./businesses.ts\").then((m) => m.businessesCommand),\n    pages: () => import(\"./pages.ts\").then((m) => m.pagesCommand),\n    \"lead-forms\": () => import(\"./leads.ts\").then((m) => m.leadFormsCommand),\n    \"instant-experiences\": () => import(\"./instant-experiences.ts\").then((m) => m.instantExperiencesCommand),\n    leads: () => import(\"./leads.ts\").then((m) => m.leadsCommand),\n    campaigns: () => import(\"./campaigns.ts\").then((m) => m.campaignsCommand),\n    adsets: () => import(\"./adsets.ts\").then((m) => m.adsetsCommand),\n    ads: () => import(\"./ads.ts\").then((m) => m.adsListCommand),\n    creatives: () => import(\"./creatives.ts\").then((m) => m.creativesCommand),\n    audiences: () => import(\"./audiences.ts\").then((m) => m.audiencesCommand),\n    \"custom-conversions\": () => import(\"./custom-conversions.ts\").then((m) => m.customConversionsCommand),\n    pixels: () => import(\"./pixels.ts\").then((m) => m.pixelsCommand),\n    activities: () => import(\"./activities.ts\").then((m) => m.activitiesCommand),\n    insights: () => import(\"./insights.ts\").then((m) => m.insightsCommand),\n    preview: () => import(\"./preview.ts\").then((m) => m.previewCommand),\n    videos: () => import(\"./videos.ts\").then((m) => m.videosCommand),\n    targeting: () => import(\"./targeting.ts\").then((m) => m.targetingCommand),\n    \"instagram-accounts\": () => import(\"./account-assets.ts\").then((m) => m.instagramAccountsCommand),\n    apps: () => import(\"./account-assets.ts\").then((m) => m.appsCommand),\n    \"dsa-recommendations\": () => import(\"./account-assets.ts\").then((m) => m.dsaRecommendationsCommand),\n    images: () => import(\"./account-assets.ts\").then((m) => m.imagesCommand),\n    labels: () => import(\"./account-assets.ts\").then((m) => m.labelsCommand),\n    studies: () => import(\"./studies.ts\").then((m) => m.studiesCommand),\n    catalogs: () => import(\"./catalogs.ts\").then((m) => m.catalogsCommand),\n    \"page-photos\": () => import(\"./page-photos.ts\").then((m) => m.pagePhotosCommand),\n    \"page-posts\": () => import(\"./account-level.ts\").then((m) => m.pagePostsCommand),\n    \"instagram-media\": () => import(\"./account-level.ts\").then((m) => m.instagramMediaCommand),\n    comments: () => import(\"./account-level.ts\").then((m) => m.commentsCommand),\n    \"account-settings\": () => import(\"./account-level.ts\").then((m) => m.accountSettingsCommand),\n    \"account-details\": () => import(\"./account-level.ts\").then((m) => m.accountDetailsCommand),\n    \"block-lists\": () => import(\"./account-level.ts\").then((m) => m.blockListsCommand),\n    \"reach-frequency\": () => import(\"./account-level.ts\").then((m) => m.reachFrequencyCommand),\n    \"high-demand-periods\": () => import(\"./account-assets.ts\").then((m) => m.highDemandPeriodsCommand),\n    rules: () => import(\"./rules.ts\").then((m) => m.rulesCommand),\n    media: () => import(\"./media.ts\").then((m) => m.metaMediaCommand),\n    draft: () => import(\"./draft.ts\").then((m) => m.metaDraftCommand),\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/{posts-TRQCRLYZ.js → posts-F327IP23.js}

@@ -33,4 +33,4 @@ Full guide: __tooling__/docs/tools/baker/posts.md`
 export {
   postsCommand
 };
-//# sourceMappingURL=posts-TRQCRLYZ.js.map
+//# sourceMappingURL=posts-F327IP23.js.map

package/dist/{rerun-QGCY5TRB.js → rerun-4SVR7QGC.js}

@@ -1,21 +1,21 @@
 import {
   executeCanvasRun
-} from "./chunk-7YOCZ27T.js";
-import "./chunk-XZAVBONI.js";
+} from "./chunk-LVDYB7RO.js";
 import "./chunk-J35R2D6B.js";
+import "./chunk-XZAVBONI.js";
 import "./chunk-WN4KX7GE.js";
-import "./chunk-F62BW6DJ.js";
+import "./chunk-IWNLW7ZC.js";
 import "./chunk-IVIJJXXT.js";
-import "./chunk-Q6ULQMWG.js";
 import "./chunk-KKJ4KJCW.js";
+import "./chunk-Q6ULQMWG.js";
 import "./chunk-KNA3OWJC.js";
 import "./chunk-3ACMDRSE.js";
 import "./chunk-I7OJZ7QE.js";
-import "./chunk-7KLTVL4J.js";
+import "./chunk-LWYTFXJG.js";
+import "./chunk-7DKJF3Y5.js";
 import "./chunk-ERQZNOKZ.js";
 import "./chunk-EJBLF2LI.js";
 import "./chunk-TJHEMCST.js";
-import "./chunk-7DKJF3Y5.js";
 import "./chunk-T6RZ7ZOM.js";
 import "./chunk-KPXURSDF.js";
 import "./chunk-CP6RFWLW.js";
@@ -94,4 +94,4 @@ var rerunCommand = defineCommand({
 export {
   rerunCommand
 };
-//# sourceMappingURL=rerun-QGCY5TRB.js.map
+//# sourceMappingURL=rerun-4SVR7QGC.js.map

package/dist/{research-5AO6DRY5.js → research-VPONEQYW.js}

@@ -72,4 +72,4 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 export {
   researchCommand
 };
-//# sourceMappingURL=research-5AO6DRY5.js.map
+//# sourceMappingURL=research-VPONEQYW.js.map

package/dist/{run-5PRW3VXO.js → run-5XN3VZTK.js}

@@ -3,22 +3,22 @@ import {
   executeCanvasRun,
   runCommand,
   stopBeforeKinds
-} from "./chunk-7YOCZ27T.js";
-import "./chunk-XZAVBONI.js";
+} from "./chunk-LVDYB7RO.js";
 import "./chunk-J35R2D6B.js";
+import "./chunk-XZAVBONI.js";
 import "./chunk-WN4KX7GE.js";
-import "./chunk-F62BW6DJ.js";
+import "./chunk-IWNLW7ZC.js";
 import "./chunk-IVIJJXXT.js";
-import "./chunk-Q6ULQMWG.js";
 import "./chunk-KKJ4KJCW.js";
+import "./chunk-Q6ULQMWG.js";
 import "./chunk-KNA3OWJC.js";
 import "./chunk-3ACMDRSE.js";
 import "./chunk-I7OJZ7QE.js";
-import "./chunk-7KLTVL4J.js";
+import "./chunk-LWYTFXJG.js";
+import "./chunk-7DKJF3Y5.js";
 import "./chunk-ERQZNOKZ.js";
 import "./chunk-EJBLF2LI.js";
 import "./chunk-TJHEMCST.js";
-import "./chunk-7DKJF3Y5.js";
 import "./chunk-T6RZ7ZOM.js";
 import "./chunk-KPXURSDF.js";
 import "./chunk-CP6RFWLW.js";
@@ -69,4 +69,4 @@ export {
   runCommand,
   stopBeforeKinds
 };
-//# sourceMappingURL=run-5PRW3VXO.js.map
+//# sourceMappingURL=run-5XN3VZTK.js.map

package/dist/{scaffold-static-ad-DULWCCZW.js → scaffold-static-ad-5AWGI5QC.js}

@@ -19,14 +19,14 @@ import {
 } from "./chunk-7JBDVH7L.js";
 import {
   buildBackendClient
-} from "./chunk-7YOCZ27T.js";
-import "./chunk-XZAVBONI.js";
+} from "./chunk-LVDYB7RO.js";
 import "./chunk-J35R2D6B.js";
+import "./chunk-XZAVBONI.js";
 import "./chunk-WN4KX7GE.js";
-import "./chunk-F62BW6DJ.js";
+import "./chunk-IWNLW7ZC.js";
 import "./chunk-IVIJJXXT.js";
-import "./chunk-Q6ULQMWG.js";
 import "./chunk-KKJ4KJCW.js";
+import "./chunk-Q6ULQMWG.js";
 import "./chunk-KNA3OWJC.js";
 import "./chunk-3ACMDRSE.js";
 import "./chunk-I7OJZ7QE.js";
@@ -36,20 +36,8 @@ import {
   namesDelivery,
   scaffoldDelivery
 } from "./chunk-S456S5VM.js";
-import {
-  LIBRARY_PLATFORMS,
-  NO_FIT_HINT,
-  conceptFromFit,
-  fetchLibraryReference,
-  fitHints,
-  libraryReferenceBlock,
-  mergeReferenceIntoBlueprint,
-  notADesignReference,
-  readCachedFit,
-  referenceDescribeContext,
-  resolveSourcePlatform
-} from "./chunk-2NWVSWGS.js";
-import "./chunk-7KLTVL4J.js";
+import "./chunk-LWYTFXJG.js";
+import "./chunk-7DKJF3Y5.js";
 import "./chunk-ERQZNOKZ.js";
 import "./chunk-EJBLF2LI.js";
 import {
@@ -78,7 +66,6 @@ import {
   titleFromSlug,
   webFontUrl
 } from "./chunk-TJHEMCST.js";
-import "./chunk-7DKJF3Y5.js";
 import {
   describeViewer,
   liveViewerLookups,
@@ -88,6 +75,19 @@ import "./chunk-KPXURSDF.js";
 import "./chunk-CP6RFWLW.js";
 import "./chunk-EKX37C3T.js";
 import "./chunk-Q5DFEVLE.js";
+import {
+  LIBRARY_PLATFORMS,
+  NO_FIT_HINT,
+  conceptFromFit,
+  fetchLibraryReference,
+  fitHints,
+  libraryReferenceBlock,
+  mergeReferenceIntoBlueprint,
+  notADesignReference,
+  readCachedFit,
+  referenceDescribeContext,
+  resolveSourcePlatform
+} from "./chunk-2NWVSWGS.js";
 import "./chunk-KGAYDZM2.js";
 import "./chunk-OFMFBRSL.js";
 import "./chunk-RNS5MVHS.js";
@@ -1009,4 +1009,4 @@ export {
   uploadSourceAsReference,
   validateScaffoldedStaticAd
 };
-//# sourceMappingURL=scaffold-static-ad-DULWCCZW.js.map
+//# sourceMappingURL=scaffold-static-ad-5AWGI5QC.js.map

package/dist/{sources-QSKRDIT5.js → sources-FZZRJTQV.js}

@@ -27,4 +27,4 @@ Examples:
 export {
   sourcesCommand
 };
-//# sourceMappingURL=sources-QSKRDIT5.js.map
+//# sourceMappingURL=sources-FZZRJTQV.js.map

package/dist/{stock-WBNGQUZT.js → stock-WEY6RYKP.js}

@@ -1,14 +1,14 @@
 import {
   parseRequestFlags
 } from "./chunk-4N3Y5QWW.js";
-import {
-  activeFilterFlags,
-  emptyResultHints
-} from "./chunk-Q6ULQMWG.js";
 import {
   AUTO_INGEST_MAX,
   parseAutoIngest
 } from "./chunk-KKJ4KJCW.js";
+import {
+  activeFilterFlags,
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
 import {
   OUTPUT_ARGS,
   writeProviderHits
@@ -209,4 +209,4 @@ export {
   partialLibraryHints,
   stockCommand
 };
-//# sourceMappingURL=stock-WBNGQUZT.js.map
+//# sourceMappingURL=stock-WEY6RYKP.js.map

package/dist/{studio-ZRAZ2C25.js → studio-D2OMFCZZ.js}

@@ -46,4 +46,4 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 export {
   studioCommand
 };
-//# sourceMappingURL=studio-ZRAZ2C25.js.map
+//# sourceMappingURL=studio-D2OMFCZZ.js.map

package/dist/{testimonials-UOVGKW23.js → testimonials-M4GVNUI7.js}

@@ -23,10 +23,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
     list: () => import("./list-LLLEF6YM.js").then((m) => m.listCommand),
     delete: () => import("./delete-ZHGITRWJ.js").then((m) => m.deleteCommand),
     tags: () => import("./tags-HN67SXIG.js").then((m) => m.tagsCommand),
-    sources: () => import("./sources-QSKRDIT5.js").then((m) => m.sourcesCommand)
+    sources: () => import("./sources-FZZRJTQV.js").then((m) => m.sourcesCommand)
   }
 });
 export {
   testimonialsCommand
 };
-//# sourceMappingURL=testimonials-UOVGKW23.js.map
+//# sourceMappingURL=testimonials-M4GVNUI7.js.map

package/dist/{translate-IXHJUXWD.js → translate-ETC6UFI6.js}

@@ -1,15 +1,16 @@
 import {
   withoutFields
-} from "./chunk-Q4VZZYMR.js";
+} from "./chunk-XOC5F52C.js";
 import {
   leadVersion,
   runBaker,
   seriesLeadsAbove,
   writeSeriesMemberCanvas
-} from "./chunk-7KLTVL4J.js";
+} from "./chunk-LWYTFXJG.js";
 import {
   setDefinitionFields
 } from "./chunk-X3YYZLBH.js";
+import "./chunk-7DKJF3Y5.js";
 import "./chunk-ERQZNOKZ.js";
 import "./chunk-EJBLF2LI.js";
 import {
@@ -23,7 +24,6 @@ import {
   sameTag,
   tagSlug
 } from "./chunk-TJHEMCST.js";
-import "./chunk-7DKJF3Y5.js";
 import "./chunk-T6RZ7ZOM.js";
 import "./chunk-KPXURSDF.js";
 import "./chunk-CP6RFWLW.js";
@@ -600,4 +600,4 @@ var translateCommand = defineCommand({
 export {
   translateCommand
 };
-//# sourceMappingURL=translate-IXHJUXWD.js.map
+//# sourceMappingURL=translate-ETC6UFI6.js.map

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

@@ -38,4 +38,4 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 export {
   videosCommand
 };
-//# sourceMappingURL=videos-HROOMEHA.js.map
+//# sourceMappingURL=videos-HBQGC3G6.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/{winning-ads-ZEVLZPOA.js → winning-ads-RIZANJER.js}

@@ -83,4 +83,4 @@ Full guide: __tooling__/docs/tools/baker/winning-ads.md`
 export {
   winningAdsCommand
 };
-//# sourceMappingURL=winning-ads-ZEVLZPOA.js.map
+//# sourceMappingURL=winning-ads-RIZANJER.js.map

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

@@ -44,4 +44,4 @@ Full guide: __tooling__/docs/tools/baker/ads-x.md`
 export {
   xCommand
 };
-//# sourceMappingURL=x-5OJJOFRB.js.map
+//# sourceMappingURL=x-WNZNCXG3.js.map

package/package.json

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