@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/chunk-5HH4RGC4.js

@@ -1,136 +0,0 @@
-import {
-  canvasOutputsRoot
-} from "./chunk-NMMKTPGI.js";
-import {
-  MODEL_REGISTRY,
-  isRegisteredModel
-} from "./chunk-KY4MPR6R.js";
-import {
-  optionalChatId
-} from "./chunk-SXRSLUW7.js";
-
-// src/commands/canvas/creative-limit.ts
-import { existsSync } from "fs";
-import { mkdir, readdir, writeFile } from "fs/promises";
-import path from "path";
-var NEW_CREATIVES_PER_CHAT = 10;
-function claimNewCreative(made, slug) {
-  if (made.includes(slug)) return { allowed: true, count: made.length };
-  if (made.length >= NEW_CREATIVES_PER_CHAT) return { allowed: false, count: made.length };
-  return { allowed: true, count: made.length + 1 };
-}
-function chatDir(canvasRoot, chatId) {
-  return path.join(canvasRoot, ".creative-limit", (chatId ?? "no-chat").replace(/[^A-Za-z0-9_-]/g, "_"));
-}
-async function madeInChat(dir) {
-  return readdir(dir).catch(() => []);
-}
-async function claimNewCreativeInWorkspace(canvasRoot, slug, chatId, definitionPath, exists = existsSync) {
-  const dir = chatDir(canvasRoot, chatId);
-  const made = await madeInChat(dir);
-  if (!made.includes(slug) && exists(definitionPath)) return { allowed: true, count: made.length };
-  const claim = claimNewCreative(made, slug);
-  if (claim.allowed && !made.includes(slug)) {
-    try {
-      await mkdir(dir, { recursive: true });
-      await writeFile(path.join(dir, slug), "", { flag: "wx" });
-    } catch {
-    }
-  }
-  return claim;
-}
-function creativeLimitRefusal(slug) {
-  return {
-    ok: false,
-    error: {
-      code: "CREATIVE_LIMIT",
-      message: `${slug} would be new creative number ${NEW_CREATIVES_PER_CHAT + 1} in this chat. A chat makes at most ${NEW_CREATIVES_PER_CHAT} new creatives.`,
-      fix: `Build nothing more. Finish and show the ${NEW_CREATIVES_PER_CHAT} you have, and tell the person in one line that a chat makes up to ${NEW_CREATIVES_PER_CHAT} new creatives, so the rest go in a new chat. Editing or resizing the ones already made still works here. Working as a subagent: return now and say the limit was reached.`
-    }
-  };
-}
-async function enforceNewCreativeLimit(slug, canvasPath) {
-  const claim = await claimNewCreativeInWorkspace(
-    canvasOutputsRoot(canvasPath),
-    slug,
-    optionalChatId() ?? null,
-    path.join(path.dirname(path.resolve(canvasPath)), "_definition.md")
-  );
-  if (claim.allowed) return;
-  process.stderr.write(`${JSON.stringify(creativeLimitRefusal(slug), null, 2)}
-`);
-  process.exit(2);
-}
-
-// src/commands/canvas/scaffold-common.ts
-import { access, readFile } from "fs/promises";
-
-// src/commands/canvas/composition-path.ts
-import { existsSync as existsSync2 } from "fs";
-import path2 from "path";
-function resolveShippedCanvasDir(name, startDir, exists = existsSync2, maxDepth = 8) {
-  const rel = path2.join("canvas", name);
-  let dir = startDir;
-  for (let i = 0; i < maxDepth; i++) {
-    const candidate = path2.join(dir, rel);
-    if (exists(path2.join(candidate, "meta.json"))) return candidate;
-    const parent = path2.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return path2.resolve(startDir, "../../../", rel);
-}
-
-// src/commands/canvas/scaffold-common.ts
-var SHIPPED_OVERLAY_COMPOSITION_DIR = resolveShippedCanvasDir(
-  "video-overlay-composition",
-  import.meta.dirname
-);
-var SHIPPED_CAPTIONS_DIR = resolveShippedCanvasDir("tiktok-captions-composition", import.meta.dirname);
-function resolveModel(kind, requested, fallback) {
-  const model = requested ? String(requested) : fallback;
-  if (isRegisteredModel(kind, model)) return model;
-  const known = Object.keys(MODEL_REGISTRY[kind]).join(", ");
-  throw new Error(`"${model}" is not a ${kind} model. Use one of: ${known}`);
-}
-async function loadAssetText(ref, label) {
-  const r = ref;
-  if (typeof r?.path === "string") return readFile(r.path, "utf8");
-  if (typeof r?.url === "string") {
-    const res = await fetch(r.url);
-    if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);
-    return res.text();
-  }
-  throw new Error(`${label}: output had no readable path or url`);
-}
-function parseElements(raw) {
-  const parsed = JSON.parse(raw);
-  if (Array.isArray(parsed)) return parsed;
-  if (parsed && typeof parsed === "object" && Array.isArray(parsed.elements)) {
-    return parsed.elements;
-  }
-  return [];
-}
-function fail(code, message) {
-  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}
-`);
-  process.exit(2);
-}
-function fileExists(target) {
-  return access(target).then(
-    () => true,
-    () => false
-  );
-}
-
-export {
-  enforceNewCreativeLimit,
-  SHIPPED_OVERLAY_COMPOSITION_DIR,
-  SHIPPED_CAPTIONS_DIR,
-  resolveModel,
-  loadAssetText,
-  parseElements,
-  fail,
-  fileExists
-};
-//# sourceMappingURL=chunk-5HH4RGC4.js.map

package/dist/chunk-5HH4RGC4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/canvas/creative-limit.ts","../src/commands/canvas/scaffold-common.ts","../src/commands/canvas/composition-path.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { mkdir, readdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { optionalChatId } from \"../../env.ts\";\nimport { canvasOutputsRoot } from \"./normalize-paths.ts\";\n\n// How many new creatives one chat may scaffold.\n//\n// A spend brake, not a marketing rule: the batches people actually ask for stay well under\n// it (production, Sept 2026: the largest was 10, and it took 137 minutes at ~200 credits a\n// creative). Past it, the ask is far more likely a slip (\"100\" for \"10\", a looping agent)\n// than a plan, and each one bills the platform. Scaffolding is where a creative is born, so\n// the brake sits there, before any billed pass. Editing, resizing or re-scaffolding a\n// creative that already existed is not new work and never counts.\n//\n// One marker file per creative under `canvas/.creative-limit/<chat>/`, created with `wx`,\n// like the render budget's file per slug: producers scaffold in parallel, and a shared\n// read-change-write file loses claims (or reads back empty mid-write and restarts at zero).\n// Counting then creating can overshoot by the claims in flight at once (one wave), never\n// reset. Keyed by chat so a workspace reused by another chat starts over.\n\nexport const NEW_CREATIVES_PER_CHAT = 10;\n\n/** Whether `slug` may be born in a chat that has already made `made`. Pure. */\nexport function claimNewCreative(made: readonly string[], slug: string): { allowed: boolean; count: number } {\n  if (made.includes(slug)) return { allowed: true, count: made.length };\n  if (made.length >= NEW_CREATIVES_PER_CHAT) return { allowed: false, count: made.length };\n  return { allowed: true, count: made.length + 1 };\n}\n\nfunction chatDir(canvasRoot: string, chatId: string | null): string {\n  return path.join(canvasRoot, \".creative-limit\", (chatId ?? \"no-chat\").replace(/[^A-Za-z0-9_-]/g, \"_\"));\n}\n\nasync function madeInChat(dir: string): Promise<string[]> {\n  return readdir(dir).catch(() => []);\n}\n\n/**\n * Count `slug` as a creative born in this chat, or refuse it. A creative whose folder already\n * held a `_definition.md` existed before and is let through uncounted. An unwritable marker\n * never blocks: the limit is a brake on slips, not a lock.\n */\nexport async function claimNewCreativeInWorkspace(\n  canvasRoot: string,\n  slug: string,\n  chatId: string | null,\n  definitionPath: string,\n  exists: (p: string) => boolean = existsSync,\n): Promise<{ allowed: boolean; count: number }> {\n  const dir = chatDir(canvasRoot, chatId);\n  const made = await madeInChat(dir);\n  if (!made.includes(slug) && exists(definitionPath)) return { allowed: true, count: made.length };\n  const claim = claimNewCreative(made, slug);\n  if (claim.allowed && !made.includes(slug)) {\n    try {\n      await mkdir(dir, { recursive: true });\n      await writeFile(path.join(dir, slug), \"\", { flag: \"wx\" });\n    } catch {\n      // Already claimed by a parallel scaffold of the same slug, or unwritable: best-effort.\n    }\n  }\n  return claim;\n}\n\n/** What a scaffold answers past the limit: what to tell the person, not \"try again\". */\nexport function creativeLimitRefusal(slug: string): { ok: false; error: { code: string; message: string; fix: string } } {\n  return {\n    ok: false,\n    error: {\n      code: \"CREATIVE_LIMIT\",\n      message: `${slug} would be new creative number ${NEW_CREATIVES_PER_CHAT + 1} in this chat. A chat makes at most ${NEW_CREATIVES_PER_CHAT} new creatives.`,\n      fix: `Build nothing more. Finish and show the ${NEW_CREATIVES_PER_CHAT} you have, and tell the person in one line that a chat makes up to ${NEW_CREATIVES_PER_CHAT} new creatives, so the rest go in a new chat. Editing or resizing the ones already made still works here. Working as a subagent: return now and say the limit was reached.`,\n    },\n  };\n}\n\n/**\n * The scaffold commands' gate: refuse `slug` before any billed pass when it would be one new\n * creative too many for this chat. Exits the process with the refusal; returns when allowed.\n */\nexport async function enforceNewCreativeLimit(slug: string, canvasPath: string): Promise<void> {\n  const claim = await claimNewCreativeInWorkspace(\n    canvasOutputsRoot(canvasPath),\n    slug,\n    optionalChatId() ?? null,\n    path.join(path.dirname(path.resolve(canvasPath)), \"_definition.md\"),\n  );\n  if (claim.allowed) return;\n  process.stderr.write(`${JSON.stringify(creativeLimitRefusal(slug), null, 2)}\\n`);\n  process.exit(2);\n}\n","// What the three scaffold commands (`scaffold-video`, `scaffold-static-ad`,\n// `scaffold-ad`) share: the compositions they ship, how a model flag resolves, and\n// how an analysis pass's output is read back.\n\nimport { access, readFile } from \"node:fs/promises\";\nimport { isRegisteredModel, MODEL_REGISTRY, type NodeKind } from \"@baker/canvas-contract\";\nimport { resolveShippedCanvasDir } from \"./composition-path.ts\";\n\n// The composition templates that ship with the CLI, resolved by walking up to the\n// package's `canvas/` dir so they work in both the dev (tsx) and bundled dist layout.\n/** The ad's text and brand overlay. */\nexport const SHIPPED_OVERLAY_COMPOSITION_DIR = resolveShippedCanvasDir(\n  \"video-overlay-composition\",\n  import.meta.dirname,\n);\n/** The TikTok-style word-by-word caption track (sound-off feeds). */\nexport const SHIPPED_CAPTIONS_DIR = resolveShippedCanvasDir(\"tiktok-captions-composition\", import.meta.dirname);\n\n/**\n * The model a scaffold node runs on: the one the caller named, else the role default.\n *\n * Either must be registered for `kind`, and an unknown one is an error naming what\n * the registry does have. This used to fall back to the registry's first id, so a\n * typo in a model flag rendered every node on a model nobody chose.\n */\nexport function resolveModel(kind: NodeKind, requested: unknown, fallback: string): string {\n  const model = requested ? String(requested) : fallback;\n  if (isRegisteredModel(kind, model)) return model;\n  const known = Object.keys(MODEL_REGISTRY[kind]).join(\", \");\n  throw new Error(`\"${model}\" is not a ${kind} model. Use one of: ${known}`);\n}\n\ntype LoadableRef = { path?: unknown; url?: unknown };\n\n/** Read an asset's content as text: the locally-ingested file first, else its URL. */\nexport async function loadAssetText(ref: unknown, label: string): Promise<string> {\n  const r = ref as LoadableRef;\n  if (typeof r?.path === \"string\") return readFile(r.path, \"utf8\");\n  if (typeof r?.url === \"string\") {\n    const res = await fetch(r.url);\n    if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);\n    return res.text();\n  }\n  throw new Error(`${label}: output had no readable path or url`);\n}\n\n/** Parse the selection pass output into the elements array ({elements:[...]} or a bare array). */\nexport function parseElements(raw: string): unknown[] {\n  const parsed = JSON.parse(raw) as unknown;\n  if (Array.isArray(parsed)) return parsed;\n  if (parsed && typeof parsed === \"object\" && Array.isArray((parsed as { elements?: unknown }).elements)) {\n    return (parsed as { elements: unknown[] }).elements;\n  }\n  return [];\n}\n\n/** Print the `{ ok: false, error }` envelope and exit 2. */\nexport function fail(code: string, message: string): never {\n  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}\\n`);\n  process.exit(2);\n}\n\nexport function fileExists(target: string): Promise<boolean> {\n  return access(target).then(\n    () => true,\n    () => false,\n  );\n}\n","import { existsSync } from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Resolve a shipped `canvas/<name>` asset dir, robust to BOTH module layouts:\n *  - dev (tsx): this code lives at `src/commands/canvas/`, so the asset is at\n *    `<package root>/canvas/<name>` — three levels up.\n *  - published (tsup): `src/**` is flattened into a single `dist/cli.js`, so the\n *    same code now lives at `<package root>/dist/`, and the asset is `../canvas/<name>`.\n *\n * A single hardcoded relative path cannot satisfy both layouts (the previous\n * `../../../canvas` worked from src but overshot the package entirely from the\n * bundled dist, throwing ENOENT after the billed deconstruct already ran). So\n * instead of guessing the nesting, walk UP from the module dir until we find a\n * `canvas/<name>` that actually exists on disk. `canvas` must stay in\n * package.json `files` for the published build to ship the asset at all.\n */\nexport function resolveShippedCanvasDir(\n  name: string,\n  startDir: string,\n  exists: (p: string) => boolean = existsSync,\n  maxDepth = 8,\n): string {\n  const rel = path.join(\"canvas\", name);\n  let dir = startDir;\n  for (let i = 0; i < maxDepth; i++) {\n    const candidate = path.join(dir, rel);\n    // `meta.json` is the composition's manifest — its presence proves we found\n    // the real asset dir, not an empty `canvas/` that happens to exist higher up.\n    if (exists(path.join(candidate, \"meta.json\"))) return candidate;\n    const parent = path.dirname(dir);\n    if (parent === dir) break; // reached filesystem root\n    dir = parent;\n  }\n  // Fall back to the dev src-relative location so a missing asset still produces\n  // a clear \"no such file\" at copy time rather than a silently-wrong path.\n  return path.resolve(startDir, \"../../../\", rel);\n}\n"],"mappings":"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","names":["existsSync","path"]}

package/dist/chunk-5NQIFCNX.js

@@ -1,141 +0,0 @@
-import {
-  hintLines,
-  splitHints
-} from "./chunk-D5FY4FAK.js";
-import {
-  isNotConnectedError,
-  writeJsonEnvelope
-} from "./chunk-6YWRJMGR.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-EPK2GYLV.js";
-import {
-  requireChatId,
-  resolveChatId
-} from "./chunk-SXRSLUW7.js";
-
-// src/commands/tag-manager/shared.ts
-import { readFileSync } from "fs";
-function failValidation(message) {
-  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
-}
-function requireTarget(args, entity) {
-  const positional = Array.isArray(args._) ? args._[0] : void 0;
-  const target = args.id ?? args.target ?? positional;
-  if (typeof target !== "string" || target.length === 0) {
-    failValidation(`pass the ${entity} id or path as the positional argument`);
-  }
-  return target;
-}
-function loadJsonArg(args, flag = "json") {
-  const inline = args[flag];
-  const file = args.file;
-  const raw = typeof file === "string" && file.length > 0 ? readFileSync(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
-  if (raw === void 0) {
-    failValidation(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
-  }
-  try {
-    const parsed = JSON.parse(raw);
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failValidation(`--${flag} must be a JSON object`);
-    }
-    return parsed;
-  } catch {
-    return failValidation(`--${flag} is not valid JSON`);
-  }
-}
-var RETRYABLE_CODES = /* @__PURE__ */ new Set(["RATE_LIMITED", "UNAVAILABLE", "INTERNAL_ERROR", "NETWORK_ERROR", "TIMEOUT"]);
-function handleError(err) {
-  if (err instanceof ApiError) {
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        ...err.code === "UNAUTHORIZED" || err.code === "FORBIDDEN" && isNotConnectedError(err.code, err.message) ? {
-          fix: {
-            action: "request_connection",
-            explanation: 'Tag Manager is not connected for this company yet, or no container has been picked. Don\'t send the user to Settings \u2014 call the `request_connection` tool with { platform: "google-tag-manager", reason } and they connect and pick their containers (they can pick more than one) from inside the chat. `request_tag_input` is not the route: that form manages the container snippet on the site, not what runs inside the container, and it cannot pick a container. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 Google Tag Manager, where they also pick the container. Then carry on with the rest of the task.'
-          }
-        } : {},
-        retryable: RETRYABLE_CODES.has(err.code)
-      }
-    });
-    process.exit(1);
-  }
-  writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error", retryable: true } });
-  process.exit(1);
-}
-var STAGE_HINTS = [
-  "Staged only \u2014 nothing has changed in Tag Manager yet. These apply when the chat completes, in dependency order, and close as a Tag Manager version that is then published, so they do go live on the user's site. Say the changes are ready and go live when they publish \u2014 not that they are live already."
-];
-async function stageOp(op) {
-  const chatId = requireChatId();
-  try {
-    const { data, hints } = splitHints(
-      await apiPost("/api/tag-manager/draft/stage", { chatId, op })
-    );
-    writeJsonEnvelope({ ok: true, data, hints: [...hints, ...STAGE_HINTS] });
-  } catch (err) {
-    handleError(err);
-  }
-}
-async function draftAction(path, body, chat) {
-  const chatId = resolveChatId(chat);
-  try {
-    const { data, hints } = splitHints(await apiPost(path, { chatId, ...body }));
-    writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
-    return data;
-  } catch (err) {
-    handleError(err);
-  }
-}
-function renderDraft(response) {
-  if (response.count === 0) {
-    return "No Tag Manager changes staged on this chat.";
-  }
-  const lines = [
-    `${response.count} staged Tag Manager change(s)`,
-    ...response.ops.map((op) => {
-      const status = op.result ? ` [${op.result.status}]` : "";
-      return `  ${op.ref}  ${op.summary}${status}`;
-    })
-  ];
-  if (response.versionId) {
-    lines.push(
-      "",
-      response.published ? `Applied and published as Tag Manager version ${response.versionId}. These changes are live on the site.` : `Applied into Tag Manager version ${response.versionId}. It is NOT published \u2014 publish it in Tag Manager to go live.`
-    );
-  }
-  if (response.compilerError) {
-    lines.push("", `Tag Manager reported a problem building the version: ${response.compilerError}`);
-  }
-  return lines.join("\n");
-}
-async function draftList(json, chat) {
-  const chatId = resolveChatId(chat);
-  try {
-    const response = await apiPost("/api/tag-manager/draft", { chatId });
-    const { data, hints } = splitHints(response);
-    if (json) {
-      writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
-      return;
-    }
-    process.stdout.write(`${renderDraft(data)}${hintLines(response)}
-`);
-  } catch (err) {
-    handleError(err);
-  }
-}
-
-export {
-  requireTarget,
-  loadJsonArg,
-  handleError,
-  stageOp,
-  draftAction,
-  draftList
-};
-//# sourceMappingURL=chunk-5NQIFCNX.js.map

package/dist/chunk-6CCDQO2F.js

@@ -1,225 +0,0 @@
-import {
-  ApiError
-} from "./chunk-EPK2GYLV.js";
-import {
-  optionalChatId
-} from "./chunk-SXRSLUW7.js";
-import {
-  writeJson
-} from "./chunk-O4AXPEOE.js";
-
-// src/commands/avatars/casting.ts
-var CAST_FLAG_RULE = "Cast with `--avatar <handle>` on `baker studio generate`, `baker studio animate`, `baker canvas scaffold-ad`, `baker canvas scaffold-static-ad` and `baker canvas scaffold-video`. Don't hand-roll it by pasting `subjectDescription` into the prompt or by passing the sheet through `--reference` \u2014 both render something that merely resembles them. `--avatar` is also the only thing that carries their accent and delivery into a clip. An avatar has no pinned voice by design (ADR 0005): the video model renders the voice, and the region on their profile is the only thing steering it \u2014 without the flag the clip is performed flat, in whatever accent the model picks on its own. `baker canvas scaffold-video` casts only their face: a reproduced video keeps the source ad's accent direction, so never tell the user it speaks in theirs.";
-var VERBATIM_RULE = "When you do write the description yourself \u2014 a hand-built canvas node, a landing image, anywhere `--avatar` does not exist \u2014 copy `subjectDescription` verbatim, word for word. Re-phrasing it per generation is the other reason a face drifts across a set.";
-var VIDEO_ROUTING = "In video, a photoreal presenter renders on `google/veo-3.1` (or `google/veo-3.1-fast`), never `bytedance/seedance-2.0` \u2014 it refuses photoreal human faces, AI-generated ones included. Reproducing a video the user gave you: `baker canvas scaffold-video \u2026 --avatar <handle> --real-face`.";
-function castingHints(avatar) {
-  if (avatar.status === "generating" && avatar.needsFace) {
-    return [
-      `The user is picking @${avatar.handle}'s face right now \u2014 portraits are on their screen and nothing renders until they answer. There is NOTHING to wait for and nothing to check: do not poll, do not block on it, do not ask about the face in a question of your own, and do not delete or recreate this avatar. Whatever you do next simply runs after they have chosen.`
-    ];
-  }
-  if (avatar.status === "generating") {
-    return [
-      `Still building \u2014 a ~30s render that settles on its own, and this avatar is castable only once it reads \`ready\`. If the next thing you do needs it (a clip, a still, anything with --avatar), block on it: \`baker avatars get ${avatar.handle} --wait\` returns the moment it is ready. Otherwise do other work first and read it back with \`baker avatars get ${avatar.handle}\`. Never write your own sleep or poll loop, and never end the turn waiting \u2014 the user would have to come back and tell you it is ready.`
-    ];
-  }
-  if (avatar.status === "error") {
-    return [
-      `The identity sheet could not be built${avatar.errorMessage ? `: ${avatar.errorMessage}` : ""}. This avatar cannot be cast. Sharpen the subject description (one person, plain description, no scene) and rebuild: \`baker avatars update ${avatar.handle} --subject "\u2026" --regenerate-sheet\`.`
-    ];
-  }
-  if (avatar.status === "archived") {
-    return [
-      `Retired. Work that already used it still resolves, but do not cast it into anything new \u2014 \`baker avatars list\` shows the roster you can cast from.`
-    ];
-  }
-  if (!avatar.sheetUrl) {
-    return [
-      `No identity sheet on this avatar yet, so there is nothing to ground a render on. Re-read it with \`baker avatars get ${avatar.handle}\`; if it stays this way, rebuild the sheet with \`baker avatars update ${avatar.handle} --regenerate-sheet\`.`
-    ];
-  }
-  return [
-    `Ready to cast: \`baker studio generate "<your scene>" --avatar ${avatar.handle}\` for a still, \`baker studio animate "<the motion, and the line they say>" --avatar ${avatar.handle}\` for a clip.`,
-    CAST_FLAG_RULE,
-    VERBATIM_RULE,
-    VIDEO_ROUTING
-  ];
-}
-function rosterRow(avatar) {
-  return {
-    handle: avatar.handle,
-    name: avatar.name,
-    status: avatar.status,
-    likeness: avatar.likeness,
-    sheetUrl: avatar.sheetUrl ?? null,
-    avatarId: avatar.avatarId,
-    ...avatar.errorMessage ? { errorMessage: avatar.errorMessage } : {}
-  };
-}
-function chatIdFromEnv() {
-  return optionalChatId();
-}
-function rosterHints(roster, statusFilter) {
-  if (roster.length === 0) {
-    return [
-      statusFilter ? `No avatars with status "${statusFilter}". Drop \`--status\` to see the whole roster.` : `No avatars yet \u2014 and retired ones are hidden unless you pass \`--status archived\`. Cast a new presenter with \`baker avatars create --name "\u2026" --subject "\u2026"\`.`
-    ];
-  }
-  const mine = roster.filter((avatar) => avatar.fromThisChat).map((avatar) => avatar.handle);
-  const hints = mine.length ? [
-    `@${mine[0]} was made in this conversation${mine.length > 1 ? ` (with ${mine.slice(1).map((h) => `@${h}`).join(", ")})` : ""} \u2014 that is the avatar this chat is about, and the user chose its face. Use it. The others belong to earlier conversations: only reach for one if the user names it, and never ask which to use when the answer is the one you just cast.`
-  ] : [];
-  hints.push(
-    "Casting one of these? Cast them with `--avatar <handle>` on `baker studio generate` / `baker studio animate` \u2014 that flag carries their face AND their accent. `baker avatars get <handle>` returns the written profile behind it; the roster leaves the description out on purpose, because it must never be read half-way."
-  );
-  const building = roster.filter((avatar) => avatar.status === "generating").map((avatar) => avatar.handle);
-  if (building.length > 0) {
-    hints.push(
-      `Still building, not castable yet: ${building.join(", ")}. Check with \`baker avatars get ${building[0]}\` after your next piece of work.`
-    );
-  }
-  const failed = roster.filter((avatar) => avatar.status === "error").map((avatar) => avatar.handle);
-  if (failed.length > 0) {
-    hints.push(
-      `Could not be built: ${failed.join(", ")}. Read why with \`baker avatars get ${failed[0]}\`, then rebuild with \`baker avatars update ${failed[0]} --subject "\u2026" --regenerate-sheet\`.`
-    );
-  }
-  return hints;
-}
-function thinProfileHint(profile, handle) {
-  const missing = ["motion", "persona", "speech", "accent", "wardrobe", "setting"].filter(
-    (field) => !profile?.[field]?.trim()
-  );
-  if (missing.length === 0) return null;
-  return `MISSING ${missing.map((field) => `--${field}`).join(" ")}. A bare subject description holds the face still and nothing else, so clips of @${handle} come out stiff and generic \u2014 measured, filling these in nearly doubled the movement in the same brief. --accent is the one nobody guesses and the only one that fails silently: it decides the LANGUAGE and accent the avatar speaks in, in every clip. Name the region whose language the USER is writing to you in ("Spanish from Spain, Madrid accent") \u2014 "Spanish" on its own renders as no accent at all, and a region taken from how the person LOOKS ("European", "Nordic") renders as that region's language: an ad for a Spanish client shipped with --accent "German" and came back spoken in German. The user almost certainly told you how this person talks and carries themselves; put it in: \`baker avatars update ${handle} ${missing.map((field) => `--${field} "\u2026"`).join(" ")}\`.`;
-}
-function parseFaceChoice(raw) {
-  if (raw === void 0) return "ask";
-  const value = raw.trim().toLowerCase();
-  if (value === "ask" || value === "auto") return value;
-  return null;
-}
-function creationHints(created, profile) {
-  const thin = thinProfileHint(profile, created.handle);
-  const casting = created.likeness === "synthetic" && created.faceChoice === "auto" ? [
-    `No one was asked about this face \u2014 \`--face auto\` cast it and it is kept. Do not tell the user they chose it, and do not offer them a pick you are not going to run. If this should have been theirs, say so and create it again with \`--face ask\`.`
-  ] : created.likeness === "synthetic" ? [
-    `The user is being shown real portraits of @${created.handle} right now, and the turn waits for them to pick \u2014 this happens on its own, triggered by the command you just ran. The picker is already showing, so don't call request_avatar_casting, don't ask about the face in a question of your own, and don't wait or poll: whatever you do next simply runs after they have chosen \u2014 or, if they have not picked within 30 seconds of the faces appearing, after the first face is kept for them (then never say they chose it). Say what you created and get on with the work.`
-  ] : [];
-  const hints = [
-    ...casting,
-    ...thin ? [thin] : [],
-    ...castingHints({ handle: created.handle, status: created.status }),
-    `Once it is ready, cast it with \`--avatar ${created.handle}\` on \`baker studio generate\` / \`baker studio animate\` \u2014 that flag is what grounds the render on its identity sheet and, for a clip, what carries their accent and delivery into the read.`
-  ];
-  if (created.likeness === "licensed") {
-    hints.push(
-      "This avatar carries a real person's likeness, used on the company's confirmation that it may appear in their advertising. Keep it out of any creative that would misrepresent them, and out of claims they did not make."
-    );
-  }
-  return hints;
-}
-function updateHints(update) {
-  const hints = [];
-  if (update.previousHandle !== update.avatar.handle) {
-    hints.push(
-      `Renamed to @${update.avatar.handle}. @${update.previousHandle} no longer resolves \u2014 update anything that mentioned it.`
-    );
-  }
-  if (update.regeneratedSheet) {
-    hints.push(
-      `Rebuilding the identity sheet (~30s). The avatar is back to building and cannot be cast until \`baker avatars get ${update.avatar.handle}\` shows \`ready\` \u2014 and the sheet URL changes, so drop any \`--reference\` you were reusing and read the new one.`
-    );
-    return hints;
-  }
-  if (update.subjectChanged) {
-    hints.push(
-      `MISSING --regenerate-sheet. You changed the subject description but the identity sheet still shows the person you described before, so the words and the face no longer match and every new render will drift. Re-run: \`baker avatars update ${update.avatar.handle} --regenerate-sheet\` (a ~30s rebuild, billed).`
-    );
-    return hints;
-  }
-  hints.push(...castingHints(update.avatar));
-  return hints;
-}
-function removalHints(removal) {
-  if (removal.archived) {
-    return [
-      `Retired @${removal.handle}. Work that already used it still resolves and its images stay as they are; it no longer shows in \`baker avatars list\` and must not be cast into anything new.`
-    ];
-  }
-  return [
-    `Deleted @${removal.handle} for good. The mention no longer resolves anywhere \u2014 creatives that already rendered keep their images, but nothing new can be grounded on this identity. \`--archive\` is the reversible option next time.`
-  ];
-}
-function avatarRowNormalizer(record) {
-  const flat = {};
-  for (const [key, value] of Object.entries(record)) {
-    if (Array.isArray(value)) {
-      flat[key] = value.join("; ");
-      continue;
-    }
-    if (value !== null && typeof value === "object") {
-      for (const [nested, nestedValue] of Object.entries(value)) {
-        flat[nested] = Array.isArray(nestedValue) ? nestedValue.join("; ") : nestedValue;
-      }
-      continue;
-    }
-    flat[key] = value;
-  }
-  return flat;
-}
-
-// src/commands/avatars/failures.ts
-function failValidation(message, fix) {
-  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message, ...fix ? { fix } : {} } });
-  process.exit(1);
-}
-function avatarFailureFix(err, handle, context = {}) {
-  if (err.code === "NOT_FOUND") {
-    return {
-      action: "list_avatars",
-      explanation: `Run \`baker avatars list\` to see which avatars this company has${handle ? ` \u2014 "${handle}" is not one of them` : ""}. Handles are lowercase letters, numbers and dashes ("maria-founder", not "Maria Founder"). If the roster is empty, create the avatar first with \`baker avatars create\`. Do not abandon the wider job over this \u2014 carry on without the avatar and say so.`
-    };
-  }
-  if (err.code === "CONFLICT" && context.operation === "remove") {
-    return {
-      action: "wait_for_the_user",
-      explanation: `Do not remove or recreate${handle ? ` @${handle}` : " this avatar"} \u2014 wait. The portraits are on the user's screen and the turn continues once they answer. If you think the faces are wrong, say so in your reply and let them turn all four down; that recasts the same avatar from what they tell you was missing, and keeps everything already pointing at it.`
-    };
-  }
-  if (err.code === "CONFLICT" && handle) {
-    return {
-      action: "use_the_existing_avatar",
-      explanation: `@${handle} already exists in this company \u2014 avatars belong to the company, not to a chat, so one made in an earlier conversation is still here and still castable. If it is the person you want, use it as it is: \`--avatar ${handle}\`. Read it first with \`baker avatars get ${handle} --full\` and say who they already are. Do not create the same person under a second name: the user would be told about one avatar and handed another, and the company ends up with duplicates nobody chose a face for. If you genuinely need a different person, ask the user what to call them.`
-    };
-  }
-  return void 0;
-}
-function failAvatarApi(err, handle, context = {}) {
-  if (err instanceof ApiError) {
-    const fix = avatarFailureFix(err, handle, context);
-    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
-    process.exit(1);
-  }
-  if (err instanceof Error) {
-    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-
-export {
-  castingHints,
-  rosterRow,
-  chatIdFromEnv,
-  rosterHints,
-  parseFaceChoice,
-  creationHints,
-  updateHints,
-  removalHints,
-  avatarRowNormalizer,
-  failValidation,
-  failAvatarApi
-};
-//# sourceMappingURL=chunk-6CCDQO2F.js.map

package/dist/chunk-6CCDQO2F.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/avatars/casting.ts","../src/commands/avatars/failures.ts"],"sourcesContent":["import type { AvatarLikeness, AvatarStatus, AvatarSummary } from \"@baker/api\";\nimport { optionalChatId } from \"../../env.ts\";\n\n/** What an avatar has to look like before it can be put on screen. */\nexport interface CastingSubject {\n  handle: string;\n  status: AvatarStatus;\n  sheetUrl?: string;\n  errorMessage?: string;\n  /** Parked on a face the user has not picked. `generating` with nothing rendering. */\n  needsFace?: boolean;\n}\n\n// Observed failure, end to end: the agent cast an avatar, gave it a voice, then\n// rendered two clips by PASTING the subject description into the prompt and\n// leaving `--avatar` off. Every hint here used to teach exactly that shape, so\n// the rule now leads with the flag and only then explains the words.\nconst CAST_FLAG_RULE =\n  \"Cast with `--avatar <handle>` on `baker studio generate`, `baker studio animate`, `baker canvas scaffold-ad`, `baker canvas scaffold-static-ad` and `baker canvas scaffold-video`. Don't hand-roll it by pasting `subjectDescription` into the prompt or by passing the sheet through `--reference` — both render something that merely resembles them. `--avatar` is also the only thing that carries their accent and delivery into a clip. An avatar has no pinned voice by design (ADR 0005): the video model renders the voice, and the region on their profile is the only thing steering it — without the flag the clip is performed flat, in whatever accent the model picks on its own. `baker canvas scaffold-video` casts only their face: a reproduced video keeps the source ad's accent direction, so never tell the user it speaks in theirs.\";\n\nconst VERBATIM_RULE =\n  \"When you do write the description yourself — a hand-built canvas node, a landing image, anywhere `--avatar` does not exist — copy `subjectDescription` verbatim, word for word. Re-phrasing it per generation is the other reason a face drifts across a set.\";\n\n// ByteDance's filter refuses photoreal human faces, AI-generated ones included,\n// so a presenter clip routed to Seedance is a paid refusal every time.\nconst VIDEO_ROUTING =\n  \"In video, a photoreal presenter renders on `google/veo-3.1` (or `google/veo-3.1-fast`), never `bytedance/seedance-2.0` — it refuses photoreal human faces, AI-generated ones included. Reproducing a video the user gave you: `baker canvas scaffold-video … --avatar <handle> --real-face`.\";\n\n/**\n * What the agent should do next with this avatar, keyed off its status.\n *\n * The two lines that matter on a ready avatar are the same two things that make\n * a face hold still across a set: ground on the identity sheet, and reuse the\n * subject description word for word.\n */\nexport function castingHints(avatar: CastingSubject): string[] {\n  // Before the building hint, and deliberately loud. `generating` normally means a\n  // render is running, so every piece of advice below reads as \"come back in a moment\"\n  // — and an agent that acts on it here waits out a deadline on work that has not\n  // started. Observed end to end: two 90s `--wait` calls against this exact state, then\n  // a delete and a recreate with `--face auto`, which took the choice off the user\n  // while the four portraits were still on their screen.\n  if (avatar.status === \"generating\" && avatar.needsFace) {\n    return [\n      `The user is picking @${avatar.handle}'s face right now — portraits are on their screen and nothing renders until they answer. There is NOTHING to wait for and nothing to check: do not poll, do not block on it, do not ask about the face in a question of your own, and do not delete or recreate this avatar. Whatever you do next simply runs after they have chosen.`,\n    ];\n  }\n\n  if (avatar.status === \"generating\") {\n    return [\n      `Still building — a ~30s render that settles on its own, and this avatar is castable only once it reads \\`ready\\`. If the next thing you do needs it (a clip, a still, anything with --avatar), block on it: \\`baker avatars get ${avatar.handle} --wait\\` returns the moment it is ready. Otherwise do other work first and read it back with \\`baker avatars get ${avatar.handle}\\`. Never write your own sleep or poll loop, and never end the turn waiting — the user would have to come back and tell you it is ready.`,\n    ];\n  }\n\n  if (avatar.status === \"error\") {\n    return [\n      `The identity sheet could not be built${avatar.errorMessage ? `: ${avatar.errorMessage}` : \"\"}. This avatar cannot be cast. Sharpen the subject description (one person, plain description, no scene) and rebuild: \\`baker avatars update ${avatar.handle} --subject \"…\" --regenerate-sheet\\`.`,\n    ];\n  }\n\n  if (avatar.status === \"archived\") {\n    return [\n      `Retired. Work that already used it still resolves, but do not cast it into anything new — \\`baker avatars list\\` shows the roster you can cast from.`,\n    ];\n  }\n\n  if (!avatar.sheetUrl) {\n    return [\n      `No identity sheet on this avatar yet, so there is nothing to ground a render on. Re-read it with \\`baker avatars get ${avatar.handle}\\`; if it stays this way, rebuild the sheet with \\`baker avatars update ${avatar.handle} --regenerate-sheet\\`.`,\n    ];\n  }\n\n  return [\n    `Ready to cast: \\`baker studio generate \"<your scene>\" --avatar ${avatar.handle}\\` for a still, \\`baker studio animate \"<the motion, and the line they say>\" --avatar ${avatar.handle}\\` for a clip.`,\n    CAST_FLAG_RULE,\n    VERBATIM_RULE,\n    VIDEO_ROUTING,\n  ];\n}\n\n/**\n * One line of the roster.\n *\n * `subjectDescription` is deliberately absent: it has to reach a prompt word for\n * word, and a list is exactly where a long description gets skimmed, wrapped, or\n * half-copied. `baker avatars get <handle>` is the one place it is read.\n */\nexport function rosterRow(avatar: AvatarSummary): Record<string, unknown> {\n  return {\n    handle: avatar.handle,\n    name: avatar.name,\n    status: avatar.status,\n    likeness: avatar.likeness,\n    sheetUrl: avatar.sheetUrl ?? null,\n    avatarId: avatar.avatarId,\n    ...(avatar.errorMessage ? { errorMessage: avatar.errorMessage } : {}),\n  };\n}\n\n/** Next steps after reading the roster. */\n/**\n * The chat this command is running inside, when it is running inside one.\n *\n * Attribution is best-effort: a direct caller outside a chat still works, it just isn't\n * tied to a Session. Shared with the roster, which uses it to say which avatar the\n * current conversation is about.\n */\nexport function chatIdFromEnv(): string | undefined {\n  return optionalChatId();\n}\n\nexport function rosterHints(\n  roster: ReadonlyArray<{ handle: string; status: AvatarStatus; fromThisChat?: boolean }>,\n  statusFilter: string | undefined,\n): string[] {\n  if (roster.length === 0) {\n    return [\n      statusFilter\n        ? `No avatars with status \"${statusFilter}\". Drop \\`--status\\` to see the whole roster.`\n        : `No avatars yet — and retired ones are hidden unless you pass \\`--status archived\\`. Cast a new presenter with \\`baker avatars create --name \"…\" --subject \"…\"\\`.`,\n    ];\n  }\n\n  // Leads the list, because the roster is the moment the agent picks who to use and the\n  // rest of it is noise at that moment. Observed: the user had just chosen a face for an\n  // avatar in this conversation, and the agent came back offering two from earlier chats\n  // and asking which one to use — a question they had already answered by picking.\n  const mine = roster.filter((avatar) => avatar.fromThisChat).map((avatar) => avatar.handle);\n  const hints = mine.length\n    ? [\n        `@${mine[0]} was made in this conversation${\n          mine.length > 1\n            ? ` (with ${mine\n                .slice(1)\n                .map((h) => `@${h}`)\n                .join(\", \")})`\n            : \"\"\n        } — that is the avatar this chat is about, and the user chose its face. Use it. The others belong to earlier conversations: only reach for one if the user names it, and never ask which to use when the answer is the one you just cast.`,\n      ]\n    : [];\n  // Says what `CAST_FLAG_RULE` says, because this is the hint read at the moment the\n  // agent picks who to use. It used to hand back \"the identity sheet URL for\n  // `--reference`\" — the exact hand-rolled shape that rule bans — and an agent that\n  // lists the roster and then casts never reads the rule itself.\n  hints.push(\n    \"Casting one of these? Cast them with `--avatar <handle>` on `baker studio generate` / `baker studio animate` — that flag carries their face AND their accent. `baker avatars get <handle>` returns the written profile behind it; the roster leaves the description out on purpose, because it must never be read half-way.\",\n  );\n  const building = roster.filter((avatar) => avatar.status === \"generating\").map((avatar) => avatar.handle);\n  if (building.length > 0) {\n    hints.push(\n      `Still building, not castable yet: ${building.join(\", \")}. Check with \\`baker avatars get ${building[0]}\\` after your next piece of work.`,\n    );\n  }\n  const failed = roster.filter((avatar) => avatar.status === \"error\").map((avatar) => avatar.handle);\n  if (failed.length > 0) {\n    hints.push(\n      `Could not be built: ${failed.join(\", \")}. Read why with \\`baker avatars get ${failed[0]}\\`, then rebuild with \\`baker avatars update ${failed[0]} --subject \"…\" --regenerate-sheet\\`.`,\n    );\n  }\n  return hints;\n}\n\n/** The parts of a profile that describe a PERFORMANCE rather than a photograph. */\nexport interface AvatarPerformanceProfile {\n  persona?: string;\n  speech?: string;\n  accent?: string;\n  motion?: string;\n  wardrobe?: string;\n  setting?: string;\n}\n\n/**\n * Warn when an avatar was cast on a bare description.\n *\n * A subject description alone is enough to keep a FACE consistent and nothing\n * else, so every clip built on it comes back stiff and generic — the fields that\n * tell a video model how this person moves, dresses and stands are simply absent\n * from the render.\n *\n * Measured on one avatar, same sheet, same 5s brief, inter-frame motion averaged\n * over the clip: a bare profile with a flat prompt scored 1.28; adding a real\n * motion brief took it to 3.28; filling `motion`/`persona`/`speech`/`wardrobe`/\n * `setting` as well reached 4.91 — 3.8x the movement, for text that costs\n * nothing. The prompt is the bigger lever of the two, but the profile is the one\n * that keeps paying out on every future clip instead of just this one.\n */\nexport function thinProfileHint(profile: AvatarPerformanceProfile | undefined, handle: string): string | null {\n  const missing = ([\"motion\", \"persona\", \"speech\", \"accent\", \"wardrobe\", \"setting\"] as const).filter(\n    (field) => !profile?.[field]?.trim(),\n  );\n  if (missing.length === 0) return null;\n  return `MISSING ${missing.map((field) => `--${field}`).join(\" \")}. A bare subject description holds the face still and nothing else, so clips of @${handle} come out stiff and generic — measured, filling these in nearly doubled the movement in the same brief. --accent is the one nobody guesses and the only one that fails silently: it decides the LANGUAGE and accent the avatar speaks in, in every clip. Name the region whose language the USER is writing to you in (\"Spanish from Spain, Madrid accent\") — \"Spanish\" on its own renders as no accent at all, and a region taken from how the person LOOKS (\"European\", \"Nordic\") renders as that region's language: an ad for a Spanish client shipped with --accent \"German\" and came back spoken in German. The user almost certainly told you how this person talks and carries themselves; put it in: \\`baker avatars update ${handle} ${missing.map((field) => `--${field} \"…\"`).join(\" \")}\\`.`;\n}\n\n/**\n * Who picks the avatar's face.\n *\n * `ask` blocks on the user; `auto` lets the build cast one and keep it. Both are real\n * modes, not a default and a fallback: a scheduled agent rendering overnight has nobody to ask,\n * and blocking there would park the run until it times out.\n */\nexport type FaceChoice = \"ask\" | \"auto\";\n\n/**\n * Read `--face`. Null for a value this does not know.\n *\n * Defaulting to `ask` rather than `auto` is the deliberate half: an unasked face is\n * silent — the avatar comes back ready and looks finished, and nothing about it says the\n * user was skipped. A blocked turn is loud, and a person who is there can answer it.\n */\nexport function parseFaceChoice(raw: string | undefined): FaceChoice | null {\n  if (raw === undefined) return \"ask\";\n  const value = raw.trim().toLowerCase();\n  if (value === \"ask\" || value === \"auto\") return value;\n  return null;\n}\n\n/** Next steps straight after casting a new avatar — it is never ready yet. */\nexport function creationHints(\n  created: { handle: string; status: AvatarStatus; likeness: AvatarLikeness; faceChoice?: FaceChoice },\n  profile?: AvatarPerformanceProfile,\n): string[] {\n  const thin = thinProfileHint(profile, created.handle);\n  // First, ahead of everything — including \"still building, come back later\", which is\n  // true and is also the hint an agent acts on. Left to that one it goes off and does\n  // other work, and when it does want the user to choose a face it invents a question of\n  // its own: four text options, no portraits, a choice nobody can actually make. The\n  // sheet this avatar is building right now is fused from a face nobody has seen.\n  const casting =\n    created.likeness === \"synthetic\" && created.faceChoice === \"auto\"\n      ? [\n          `No one was asked about this face — \\`--face auto\\` cast it and it is kept. Do not tell the user they chose it, and do not offer them a pick you are not going to run. If this should have been theirs, say so and create it again with \\`--face ask\\`.`,\n        ]\n      : created.likeness === \"synthetic\"\n        ? [\n            `The user is being shown real portraits of @${created.handle} right now, and the turn waits for them to pick — this happens on its own, triggered by the command you just ran. The picker is already showing, so don't call request_avatar_casting, don't ask about the face in a question of your own, and don't wait or poll: whatever you do next simply runs after they have chosen — or, if they have not picked within 30 seconds of the faces appearing, after the first face is kept for them (then never say they chose it). Say what you created and get on with the work.`,\n          ]\n        : [];\n  const hints = [\n    ...casting,\n    ...(thin ? [thin] : []),\n    ...castingHints({ handle: created.handle, status: created.status }),\n    `Once it is ready, cast it with \\`--avatar ${created.handle}\\` on \\`baker studio generate\\` / \\`baker studio animate\\` — that flag is what grounds the render on its identity sheet and, for a clip, what carries their accent and delivery into the read.`,\n  ];\n  if (created.likeness === \"licensed\") {\n    hints.push(\n      \"This avatar carries a real person's likeness, used on the company's confirmation that it may appear in their advertising. Keep it out of any creative that would misrepresent them, and out of claims they did not make.\",\n    );\n  }\n  return hints;\n}\n\n/** Next steps after an edit — mostly about keeping sheet and description in sync. */\nexport function updateHints(update: {\n  avatar: CastingSubject;\n  subjectChanged: boolean;\n  regeneratedSheet: boolean;\n  previousHandle: string;\n}): string[] {\n  const hints: string[] = [];\n  if (update.previousHandle !== update.avatar.handle) {\n    hints.push(\n      `Renamed to @${update.avatar.handle}. @${update.previousHandle} no longer resolves — update anything that mentioned it.`,\n    );\n  }\n\n  if (update.regeneratedSheet) {\n    hints.push(\n      `Rebuilding the identity sheet (~30s). The avatar is back to building and cannot be cast until \\`baker avatars get ${update.avatar.handle}\\` shows \\`ready\\` — and the sheet URL changes, so drop any \\`--reference\\` you were reusing and read the new one.`,\n    );\n    return hints;\n  }\n\n  if (update.subjectChanged) {\n    hints.push(\n      `MISSING --regenerate-sheet. You changed the subject description but the identity sheet still shows the person you described before, so the words and the face no longer match and every new render will drift. Re-run: \\`baker avatars update ${update.avatar.handle} --regenerate-sheet\\` (a ~30s rebuild, billed).`,\n    );\n    return hints;\n  }\n\n  hints.push(...castingHints(update.avatar));\n  return hints;\n}\n\n/** Next steps after retiring or deleting an avatar. */\nexport function removalHints(removal: { handle: string; archived: boolean }): string[] {\n  if (removal.archived) {\n    return [\n      `Retired @${removal.handle}. Work that already used it still resolves and its images stay as they are; it no longer shows in \\`baker avatars list\\` and must not be cast into anything new.`,\n    ];\n  }\n  return [\n    `Deleted @${removal.handle} for good. The mention no longer resolves anywhere — creatives that already rendered keep their images, but nothing new can be grounded on this identity. \\`--archive\\` is the reversible option next time.`,\n  ];\n}\n\n/**\n * Flatten one avatar for `--output md|files`, which can only print scalars.\n * JSON output is untouched — it already carries the shape the API returned.\n */\nexport function avatarRowNormalizer(record: Record<string, unknown>): Record<string, unknown> {\n  const flat: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(record)) {\n    if (Array.isArray(value)) {\n      flat[key] = value.join(\"; \");\n      continue;\n    }\n    if (value !== null && typeof value === \"object\") {\n      for (const [nested, nestedValue] of Object.entries(value as Record<string, unknown>)) {\n        flat[nested] = Array.isArray(nestedValue) ? nestedValue.join(\"; \") : nestedValue;\n      }\n      continue;\n    }\n    flat[key] = value;\n  }\n  return flat;\n}\n","import { ApiError } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\n\ntype Remediation = { action: string; explanation: string } & Record<string, unknown>;\n\nexport function failValidation(message: string, fix?: Remediation): never {\n  writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message, ...(fix ? { fix } : {}) } });\n  process.exit(1);\n}\n\n/**\n * The remedy for a failed avatar call, when there is one.\n *\n * An unknown handle and a taken one are the two failures the agent can act on, and each\n * has exactly one right move — which is the point: left with a bare message it invents a\n * third. A taken handle became a silent rename (\"Elena\" already existed from an earlier\n * chat, so it created \"Marta\"), which left the user reading about one avatar and looking\n * at another.\n */\n/** Which call failed. A CONFLICT means two different things on create and on remove. */\nexport interface AvatarFailureContext {\n  operation?: \"remove\";\n}\n\nexport function avatarFailureFix(\n  err: ApiError,\n  handle?: string,\n  context: AvatarFailureContext = {},\n): Remediation | undefined {\n  if (err.code === \"NOT_FOUND\") {\n    return {\n      action: \"list_avatars\",\n      explanation: `Run \\`baker avatars list\\` to see which avatars this company has${handle ? ` — \"${handle}\" is not one of them` : \"\"}. Handles are lowercase letters, numbers and dashes (\"maria-founder\", not \"Maria Founder\"). If the roster is empty, create the avatar first with \\`baker avatars create\\`. Do not abandon the wider job over this — carry on without the avatar and say so.`,\n    };\n  }\n  // A removal is refused for one reason only: the user is choosing this avatar's face.\n  // Falling through to the handle-collision remedy below answered that with \"use the\n  // existing avatar\", which is both wrong and an invitation to go find another one.\n  if (err.code === \"CONFLICT\" && context.operation === \"remove\") {\n    return {\n      action: \"wait_for_the_user\",\n      explanation: `Do not remove or recreate${handle ? ` @${handle}` : \" this avatar\"} — wait. The portraits are on the user's screen and the turn continues once they answer. If you think the faces are wrong, say so in your reply and let them turn all four down; that recasts the same avatar from what they tell you was missing, and keeps everything already pointing at it.`,\n    };\n  }\n  if (err.code === \"CONFLICT\" && handle) {\n    return {\n      action: \"use_the_existing_avatar\",\n      explanation: `@${handle} already exists in this company — avatars belong to the company, not to a chat, so one made in an earlier conversation is still here and still castable. If it is the person you want, use it as it is: \\`--avatar ${handle}\\`. Read it first with \\`baker avatars get ${handle} --full\\` and say who they already are. Do not create the same person under a second name: the user would be told about one avatar and handed another, and the company ends up with duplicates nobody chose a face for. If you genuinely need a different person, ask the user what to call them.`,\n    };\n  }\n  return undefined;\n}\n\n/**\n * Report a failed avatar call.\n */\nexport function failAvatarApi(err: unknown, handle?: string, context: AvatarFailureContext = {}): never {\n  if (err instanceof ApiError) {\n    const fix = avatarFailureFix(err, handle, context);\n    writeJson({ ok: false, error: { code: err.code, message: err.message, ...(fix ? { fix } : {}) } });\n    process.exit(1);\n  }\n  if (err instanceof Error) {\n    writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: err.message } });\n    process.exit(1);\n  }\n  writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n"],"mappings":"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","names":[]}