@koda-sl/baker-cli 0.265.2-dev.1f1c09c80 → 0.266.0-dev.1f1c09c80

package/README.md

@@ -3641,9 +3641,11 @@ because a video model garbles a wordmark every time:
   becomes a flat brand colour plate (rendered by ffmpeg, not generated), with the mark and
   the call to action over it. `end_card: false` keeps the footage; `end_card: { cta }` sets
   the words on the button, which otherwise default to the last line of the script.
-- **`cast`** — one description of the person the ad is about. The engine builds a reference
-  sheet from it and grounds every beat they appear in on that one identity. A beat sets
-  `cast: false` to opt out (a fitter on a roof, a product close-up).
+- **`cast.avatar`** — the handle of a cast Avatar (`baker avatars list`). The ad grounds
+  every beat they appear in on that avatar's identity sheet and copies its subject
+  description verbatim, so the ad shows the same face as the rest of the company's work.
+  This is the whole journey: `baker avatars create` → `cast.avatar` in the spec → render.
+- **`cast.description`** — a person described in words, when there is no avatar.
 
 Each of these also removes a generation: the closing beat costs no image and no clip.
 

package/dist/cli.js

@@ -27314,6 +27314,12 @@ var RecurringElement = z27.object({
   // pink shirt and believer in a white shirt). Each look gets its own reference
   // slot, but the face/identity must stay identical across them.
   same_as: z27.string().nullable().optional(),
+  /**
+   * A picture of this element that already exists — a cast Avatar's identity sheet,
+   * a product photo, a real location shot. Given, the slot ingests it; absent, the
+   * slot emits a TODO for somebody to drop one by hand.
+   */
+  source_image: z27.string().optional(),
   // Scenes the element appears in. Either a bare list of scene indices (both
   // edges) or per-{scene,edge} entries. Both forms are accepted and merged.
   scenes: z27.array(z27.number()).optional(),
@@ -29596,10 +29602,16 @@ function scaffoldVideoCanvas(input, elementsInput, opts) {
   const slots = buildElementSlots(elements);
   extendPresenceByPromptMentions(slots, blueprint);
   slots.forEach((slot, i) => {
+    const element = elements[i];
+    const supplied = typeof element?.source_image === "string" ? element.source_image.trim() : "";
     nodes.push({
       id: slot.id,
       type: "ingest",
-      params: { source: "path", path: todoPath(elements[i], slot.label), expect: "image" }
+      params: {
+        source: "path",
+        path: supplied || todoPath(element, slot.label),
+        expect: "image"
+      }
     });
   });
   buildElementSheets(slots, nodes);
@@ -32483,8 +32495,20 @@ var AdSpec = z30.object({
    * collage rather than a story.
    */
   cast: z30.object({
+    /**
+     * A cast Avatar's handle — `baker avatars list` shows who there is.
+     *
+     * The right way to put a person in an ad. The avatar already has a settled
+     * identity and a rendered identity sheet, so the ad grounds on the same face the
+     * rest of the company's work uses, and its subject description is copied verbatim
+     * rather than re-written per spec — re-phrasing it per render is the other reason
+     * a face drifts across a set.
+     */
+    avatar: z30.string().min(1).optional(),
     /** Who they are, plainly: age, build, hair, wardrobe, the register of the ad. */
-    description: z30.string().min(1)
+    description: z30.string().min(1).optional()
+  }).refine((c) => Boolean(c.avatar || c.description), {
+    message: "give `avatar` (a cast avatar's handle) or `description` \u2014 a cast with neither grounds on nothing"
   }).optional(),
   /**
    * A bed, described in words. Omitted leaves the ad dry — the engine only wires
@@ -32565,13 +32589,14 @@ function endCardCta(spec) {
   const declared = spec.end_card === false ? void 0 : spec.end_card?.cta;
   return declared?.trim() || (spec.beats[spec.beats.length - 1]?.say ?? "").trim() || null;
 }
-function adSpecCastElements(spec) {
-  const description = spec.cast?.description?.trim();
+function adSpecCastElements(spec, avatar) {
+  const description = (avatar?.subjectDescription ?? spec.cast?.description)?.trim();
   if (!description) return [];
   const lastIndex = spec.beats.length - 1;
   const scenes = spec.beats.map((beat, i) => ({ beat, i })).filter(({ beat, i }) => beat.cast !== false && !(endCardWanted(spec) && i === lastIndex)).map(({ i }) => i);
   if (scenes.length === 0) return [];
-  return [{ type: "person", label: "customer", description, scenes }];
+  const sheet = avatar?.sheetUrl?.trim();
+  return [{ type: "person", label: "customer", description, scenes, ...sheet ? { source_image: sheet } : {} }];
 }
 function adSpecToBlueprint(spec) {
   const total = spec.beats.length;
@@ -32824,6 +32849,26 @@ var scaffoldAdCommand = defineCommand104({
       process.exit(1);
       return;
     }
+    const handle = spec.data.cast?.avatar?.trim();
+    let avatar = null;
+    let avatarError = null;
+    if (handle) {
+      try {
+        avatar = await readAvatars(
+          "/api/avatars/get",
+          { handle }
+        );
+        if (avatar?.status && avatar.status !== "ready") {
+          avatarError = `Avatar \`${handle}\` is ${avatar.status}, not ready \u2014 only a ready avatar can be cast. Check \`baker avatars get ${handle}\`.`;
+          avatar = null;
+        } else if (!avatar?.sheetUrl) {
+          avatarError = `Avatar \`${handle}\` has no identity sheet yet, so the ad cannot ground on their face.`;
+          avatar = null;
+        }
+      } catch (e) {
+        avatarError = `Could not read avatar \`${handle}\`: ${e instanceof Error ? e.message : String(e)}. \`baker avatars list\` shows who there is.`;
+      }
+    }
     const blueprint = adSpecToBlueprint(spec.data);
     const slug = args.slug ?? path23.basename(specPath).replace(/\.[^.]+$/, "");
     const outPath = args.out ?? (args.slug ? path23.join("src/creatives", slug, `${slug}.canvas.json`) : path23.join(path23.dirname(specPath), `${slug}.canvas.json`));
@@ -32853,7 +32898,7 @@ var scaffoldAdCommand = defineCommand104({
       // 8 is the composition's own maximum and clears every beat measured here.
       captionWordsPerGroup: 8
     };
-    const canvas = scaffoldVideoCanvas(blueprint, adSpecCastElements(spec.data), opts);
+    const canvas = scaffoldVideoCanvas(blueprint, adSpecCastElements(spec.data, avatar), opts);
     const renderNode3 = canvas.nodes.find((n) => n.type === "hyperframe_render");
     const renderedDir = renderNode3 ? path23.join(outDir, String(renderNode3.params?.composition ?? "")) : null;
     let staged = null;
@@ -32890,6 +32935,13 @@ var scaffoldAdCommand = defineCommand104({
         ...logoPath && !staged ? [`Could not read the logo at \`${logoPath}\` \u2014 the ad has no mark on screen. Give the path as it appears in src/brand/BRAND.md, relative to the workspace root.`] : [],
         ...staged ? ["The brand mark is drawn by the composition \u2014 top-left throughout, and large on the closing card. It is never generated as a picture, so it cannot come back garbled."] : [],
         ...endCardWanted(spec.data) ? ["The last beat closes on a flat brand plate with the call to action over it, instead of one more photograph."] : [],
+        ...avatarError ? [avatarError] : [],
+        ...avatar ? [
+          `Every beat the customer appears in is grounded on \`${handle}\`'s identity sheet, and their subject description was copied into the frames verbatim \u2014 so it is the same face throughout and the same face as the rest of this company's work.`
+        ] : [],
+        ...spec.data.cast && !avatar ? [
+          "This cast has a description but no avatar, so the canvas asks you to drop a real source photo before it can run. `baker avatars list` \u2014 casting one and passing `cast.avatar` fills that slot for you and keeps the face consistent across every piece of work."
+        ] : [],
         "The caption cards are your `say` lines verbatim \u2014 read them back before running; that is the copy the viewer sees.",
         "Every clip renders with nobody speaking unless a beat set `on_camera`. If a beat needs a presenter talking, set it there rather than describing it in `show`.",
         ...spec.data.brand?.palette?.length && spec.data.brand?.logo ? [] : [