@koda-sl/baker-cli 0.132.1 → 0.133.0

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  AD_FORMAT_PLATFORMS,
   BackendClient,
   BackendClient2,
   DEFAULT_VIDEO_GENERATE_MODEL,
@@ -23,6 +24,7 @@ import {
   imageProfileFor,
   isPersistedAssetRef,
   parseRefExpr,
+  platformFormats,
   requireCredentialsFromEnv,
   resolveConcurrency,
   sha256Hex,
@@ -31,7 +33,7 @@ import {
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-MWR25ZMU.js";
+} from "./chunk-UBFU3E7L.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -19418,6 +19420,9 @@ var SHEET_SUBJECT_TYPE2 = {
 };
 var ACTOR_SHEET_MODEL2 = "google/gemini-3-pro-image-preview";
 var ACTOR_SHEET_IMAGE_SIZE = "4K";
+var ADAPT_MODEL = "google/gemini-3-pro-image-preview";
+var ADAPT_IMAGE_SIZE = "2K";
+var ADAPT_GUIDANCE = "Keep the headline, logo, CTA, and hero subject fully visible in every ratio. Reproduce every text string verbatim \u2014 no dropped, added, or altered characters \u2014 and preserve the exact brand-color treatment (e.g. a black\u2192red word pivot), never flattening it.";
 var Blueprint = z15.object({
   meta: z15.object({ estimated_aspect_ratio: z15.string().optional() }).loose().optional(),
   text_content: z15.array(z15.object({ text: z15.string().optional() }).loose()).optional()
@@ -19498,6 +19503,16 @@ function aspectRatio(blueprint, opts) {
   const requested = opts.aspectRatio ?? blueprint.meta?.estimated_aspect_ratio;
   return requested && GEN_ASPECT_RATIOS.has(requested) ? requested : DEFAULT_ASPECT_RATIO;
 }
+function baseAspectRatio(blueprint, opts) {
+  const requested = aspectRatio(blueprint, opts);
+  if (!opts.placements) return requested;
+  const formats = platformFormats(opts.placements);
+  return formats.includes(requested) ? requested : formats[0] ?? requested;
+}
+function outputFormats(blueprint, opts) {
+  if (!opts.placements) return [baseAspectRatio(blueprint, opts)];
+  return [...platformFormats(opts.placements)];
+}
 function blueprintTextStrings(blueprint) {
   return (blueprint.text_content ?? []).map((t) => typeof t.text === "string" ? t.text.trim() : "").filter((t) => t.length > 0);
 }
@@ -19615,11 +19630,25 @@ function scaffoldStaticAd(input, elementsInput, opts) {
     inputs: { reference, target_blueprint: "$ref:prompt.asset" },
     params: {
       model: opts.genModel,
-      aspect_ratio: aspectRatio(blueprint, opts),
+      aspect_ratio: baseAspectRatio(blueprint, opts),
       image_size: "2K",
       prompt
     }
   });
+  const fanOut = opts.placements !== void 0;
+  if (fanOut) {
+    nodes.push({
+      id: "adapt",
+      type: "image_aspect_adapt",
+      inputs: { source: "$ref:gen.images#0" },
+      params: {
+        model: ADAPT_MODEL,
+        platform: opts.placements,
+        guidance: ADAPT_GUIDANCE,
+        image_size: ADAPT_IMAGE_SIZE
+      }
+    });
+  }
   return {
     schema: "baker-canvas/1",
     metadata: {
@@ -19627,7 +19656,7 @@ function scaffoldStaticAd(input, elementsInput, opts) {
       description: "Scaffolded by `baker canvas scaffold-static-ad`. Edit `prompt.json` (the blueprint generated from the source image) into the ad you want, drop a real asset at each [TODO] ingest path (logo/product/subject/badge + brand font), then `baker canvas run`. The original is wired for composition only."
     },
     nodes,
-    output: { node: "gen", output: "images" }
+    output: fanOut ? { node: "adapt", output: "images" } : { node: "gen", output: "images" }
   };
 }
 function staticAdReport(input, elementsInput, opts) {
@@ -19644,7 +19673,9 @@ function staticAdReport(input, elementsInput, opts) {
     })),
     includes_font: opts.includeFont !== false,
     actor_sheets: includeActorSheets ? assignElementLabels2(elements).filter(({ el }) => SHEET_SUBJECT_TYPE2[el.type.toLowerCase()]).map(({ label }) => label) : [],
-    aspect_ratio: aspectRatio(blueprint, opts)
+    aspect_ratio: baseAspectRatio(blueprint, opts),
+    placements: opts.placements ?? null,
+    output_formats: outputFormats(blueprint, opts)
   };
 }
 
@@ -19664,6 +19695,12 @@ function resolveFormats(aspect) {
   const value = aspect?.trim();
   return value && FORMAT_VALUES.includes(value) ? [value] : ["4:5"];
 }
+function resolveFormatList(formats) {
+  const valid = [...new Set(formats.map((f) => f.trim()))].filter(
+    (f) => FORMAT_VALUES.includes(f)
+  );
+  return valid.length > 0 ? valid : ["4:5"];
+}
 function describeBlueprintIntent(blueprint) {
   const intent = blueprint?.ad_intent;
   if (typeof intent === "string" && intent.trim()) return intent.trim();
@@ -19964,6 +20001,25 @@ function resolveModels(args) {
     genModel: pick("gen-model", "image_generate", "openai/gpt-5.4-image-2")
   };
 }
+var PLATFORM_PLACEMENTS = {
+  meta: "meta_feed_stories",
+  google: "google_demandgen",
+  linkedin: "linkedin",
+  tiktok: "tiktok",
+  youtube: "youtube",
+  x: void 0,
+  other: void 0
+};
+function resolvePlacements(placementsFlag, definitionPlatform) {
+  const flag = placementsFlag?.trim();
+  if (flag === void 0 || flag === "") return { ok: true, placements: PLATFORM_PLACEMENTS[definitionPlatform] };
+  if (flag === "none") return { ok: true, placements: void 0 };
+  if (AD_FORMAT_PLATFORMS.includes(flag)) return { ok: true, placements: flag };
+  return {
+    ok: false,
+    message: `--placements "${flag}" is not a valid placement set. Use one of: ${AD_FORMAT_PLATFORMS.join(", ")}, or "none" for a single base ad.`
+  };
+}
 function regionCount(layout) {
   const regions = layout?.regions;
   return Array.isArray(regions) ? regions.length : 0;
@@ -20037,7 +20093,7 @@ async function runVisionPasses(canvas) {
 var scaffoldStaticAdCommand = defineCommand91({
   meta: {
     name: "scaffold-static-ad",
-    description: "Turn a source/inspiration image into a runnable static-ad canvas. Runs billed passes \u2014 image_describe (the blueprint, baked to prompt.json as the editable 'prompt'), an AI selection of the image's MAIN identity elements, and a structured global-layout pass (the column/row grid with per-region bounds and text sizes) \u2014 then scaffolds a canvas that wires one [TODO] ingest slot per element (logo/product/subject/badge + brand font) into image_generate. Edit prompt.json and drop the real assets, then `baker canvas run` it."
+    description: "Turn a source/inspiration image into a runnable static-ad canvas. Runs billed passes \u2014 image_describe (the blueprint, baked to prompt.json as the editable 'prompt'), an AI selection of the image's MAIN identity elements, and a structured global-layout pass (the column/row grid with per-region bounds and text sizes) \u2014 then scaffolds a canvas that wires one [TODO] ingest slot per element (logo/product/subject/badge + brand font) into image_generate. By default it also fans the hero out to the platform's placement ratios (via image_aspect_adapt \u2014 the hero ratio is free, the rest are billed AI recompositions); pass --placements none for a single base ad, or a preset to pick the set. Edit prompt.json and drop the real assets, then `baker canvas run` it."
   },
   args: {
     file: { type: "positional", required: true, description: "Path or http(s) URL to the source/inspiration image" },
@@ -20050,14 +20106,18 @@ var scaffoldStaticAdCommand = defineCommand91({
     title: { type: "string", description: "Creative title for _definition.md (default: title-cased slug)" },
     platform: {
       type: "string",
-      description: "Ad platform for _definition.md (meta|google|linkedin|tiktok|youtube|x|other; default meta)"
+      description: "Ad platform (meta|google|linkedin|tiktok|youtube|x|other; default meta). Sets _definition.md AND, unless --placements is given, the default placement set the hero auto-fans-out to (meta \u2192 4:5+9:16, google \u2192 1:1+4:5+16:9, linkedin \u2192 1:1, tiktok \u2192 9:16, youtube \u2192 16:9; x/other \u2192 none)."
     },
     advertiser: { type: "string", description: "Source advertiser recorded in _definition.md" },
     "describe-model": { type: "string", description: "Override the image_describe model id" },
     "select-model": { type: "string", description: "Override the text_generate model id for element selection" },
     "layout-model": { type: "string", description: "Override the text_generate model id for the layout pass" },
     "gen-model": { type: "string", description: "Override the image_generate model id" },
-    aspect: { type: "string", description: "Force the output aspect ratio (else inferred from the image)" },
+    aspect: { type: "string", description: "Force the hero's aspect ratio (else inferred from the image)" },
+    placements: {
+      type: "string",
+      description: "Placement set the hero auto-fans-out to (image_aspect_adapt). One of meta_feed | meta_feed_stories | meta_all | linkedin | google_demandgen | tiktok | youtube, or `none` for a single base ad. Default: derived from --platform (meta \u2192 feed + stories). Each extra ratio is a billed render; the hero ratio passes through free."
+    },
     "skip-font": { type: "boolean", description: "Skip the brand-font \u2192 type-specimen slot" },
     "skip-actor-sheets": {
       type: "boolean",
@@ -20117,6 +20177,13 @@ var scaffoldStaticAdCommand = defineCommand91({
         canvasImageIsUrl = true;
       }
     }
+    const definitionPlatform = resolvePlatform(args.platform ? String(args.platform) : void 0);
+    const placementsResult = resolvePlacements(
+      args.placements ? String(args.placements) : void 0,
+      definitionPlatform
+    );
+    if (!placementsResult.ok) return fail2("invalid_placements", placementsResult.message);
+    const placements = placementsResult.placements;
     const opts = {
       genModel,
       imagePath: canvasImagePath,
@@ -20124,7 +20191,8 @@ var scaffoldStaticAdCommand = defineCommand91({
       blueprintPath: canvasBlueprintPath,
       aspectRatio: args.aspect ? String(args.aspect) : void 0,
       includeFont: !args["skip-font"],
-      includeActorSheets: !args["skip-actor-sheets"]
+      includeActorSheets: !args["skip-actor-sheets"],
+      placements
     };
     let canvas;
     let report;
@@ -20150,8 +20218,8 @@ var scaffoldStaticAdCommand = defineCommand91({
         buildCreativeDefinition({
           title: args.title ? String(args.title) : titleFromSlug(slug ?? ""),
           kind: "static",
-          platform: resolvePlatform(args.platform ? String(args.platform) : void 0),
-          formats: resolveFormats(args.aspect ? String(args.aspect) : report.aspect_ratio),
+          platform: definitionPlatform,
+          formats: resolveFormatList(report.output_formats),
           sourceReferenceUrl: durableSourceUrl ?? (imageIsUrl ? imageSource : void 0),
           sourceAdvertiser: args.advertiser ? String(args.advertiser) : args.context ? String(args.context) : void 0,
           sourceKind: "image",
@@ -20164,8 +20232,8 @@ var scaffoldStaticAdCommand = defineCommand91({
       await syncCreativeDefinitionBestEffort({
         slug,
         title: args.title ? String(args.title) : titleFromSlug(slug),
-        platform: resolvePlatform(args.platform ? String(args.platform) : void 0),
-        formats: resolveFormats(args.aspect ? String(args.aspect) : report.aspect_ratio),
+        platform: definitionPlatform,
+        formats: resolveFormatList(report.output_formats),
         sourceReferenceUrl: durableSourceUrl ?? (imageIsUrl ? imageSource : void 0),
         canvas,
         sourceSha: await computeSourceSha(outPath)
@@ -20182,6 +20250,8 @@ var scaffoldStaticAdCommand = defineCommand91({
           output: canvas.output,
           models: { describe: describeModel, select: selectModel, layout: layoutModel, gen: opts.genModel },
           aspect_ratio: report.aspect_ratio,
+          placements: report.placements,
+          output_formats: report.output_formats,
           layout_regions: regionCount(layout),
           stats: {
             total_nodes: canvas.nodes.length,
@@ -20193,6 +20263,7 @@ var scaffoldStaticAdCommand = defineCommand91({
             assets_to_supply: report.elements,
             font_slot: report.includes_font ? "Drop a brand font at the [TODO] brandfont path (the describe pass recorded the ad's typefaces under `fonts` in prompt.json \u2014 match those). The font is wired into the render as a TYPE SPECIMEN reference so generated text takes the brand letterforms. Delete the brandfont + type_ref nodes to skip it." : "skipped (--skip-font)",
             actor_sheets: report.actor_sheets.length > 0 ? `Each living hero (${report.actor_sheets.join(", ")}) is fused into a generated multi-view reference sheet (image_reference_sheet) that the render grounds on \u2014 so drop ONE clean photo at that hero's ingest and the sheet builds the consistent turnaround. Pass --skip-actor-sheets to ground on the lone photo instead.` : "none (no person/animal heroes detected, or --skip-actor-sheets)",
+            placements: report.placements === null ? `Single format (${report.aspect_ratio}). Pass --placements meta_feed_stories|meta_all|linkedin|\u2026 to auto-fan-out to a platform's set.` : `Auto-fans the approved hero out to ${report.placements} \u2192 ${report.output_formats.join(", ")}. The hero ratio (${report.aspect_ratio}) passes through free; each other ratio is a billed render, AI-recomposed (not cropped). Re-read the copy and confirm the brand-color treatment on EVERY ratio before publishing \u2014 adaptation re-generates and can silently mangle text or flatten a color device. Pass --placements none for a single base ad.`,
             note: "Populate as you go: for each [TODO] ingest slot, source its real asset and wire it into the slot right away \u2014 one at a time, not all sourced first then reconciled at the end. When every slot is filled, `baker canvas validate` then `baker canvas run`. Running generates a billed image \u2014 it is not free."
           }
         },