@koda-sl/baker-cli 0.446.0-dev.c97e2d09a → 0.447.0-dev.f5788a631

package/dist/{chunk-QJE6ZYGI.js → chunk-IKYNOT57.js}

@@ -2,7 +2,7 @@ import {
   IDEA_VIDEO_FORMATS,
   figuresIn,
   unsourcedClaims
-} from "./chunk-27NMXSC3.js";
+} from "./chunk-5EEDEVOR.js";
 import {
   AD_SPEC_SCHEMA
 } from "./chunk-CLMM6P6B.js";
@@ -128,4 +128,4 @@ export {
   unsourcedCopyLines,
   ideaSpec
 };
-//# sourceMappingURL=chunk-QJE6ZYGI.js.map
+//# sourceMappingURL=chunk-IKYNOT57.js.map

package/dist/{chunk-B3AKIYBA.js → chunk-J5IU4OX2.js}

@@ -13,7 +13,7 @@ import {
 } from "./chunk-ERSX3MKH.js";
 import {
   RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS
-} from "./chunk-ASVKZQUU.js";
+} from "./chunk-6HJAHLLA.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -294,4 +294,4 @@ export {
   subredditsFromArgs,
   redditCommand
 };
-//# sourceMappingURL=chunk-B3AKIYBA.js.map
+//# sourceMappingURL=chunk-J5IU4OX2.js.map

package/dist/{chunk-EIP4PYCL.js → chunk-KMEMA7AZ.js}

@@ -5,7 +5,7 @@ import {
   adCopyHints,
   booleanWordPositionalError,
   capabilityFix
-} from "./chunk-GIJT3A5U.js";
+} from "./chunk-T4DD5YMP.js";
 import {
   hintLines,
   withHints
@@ -493,4 +493,4 @@ export {
   draftAction,
   draftListAction
 };
-//# sourceMappingURL=chunk-EIP4PYCL.js.map
+//# sourceMappingURL=chunk-KMEMA7AZ.js.map

package/dist/{chunk-ENUZU5LQ.js → chunk-KV5BCSUR.js}

@@ -1,12 +1,12 @@
 import {
   holdUnbilledSpend
-} from "./chunk-K3PN7TN5.js";
+} from "./chunk-WTOYCUKH.js";
 import {
   askAboutText
 } from "./chunk-RX6F3GEA.js";
 import {
   brandTokensSchema
-} from "./chunk-ASVKZQUU.js";
+} from "./chunk-6HJAHLLA.js";
 
 // src/engine/landing/lib/brand-tokens.ts
 import { readFile as readFile2 } from "fs/promises";
@@ -334,4 +334,4 @@ export {
   brandCommitsAiHue,
   brandCommitsCream
 };
-//# sourceMappingURL=chunk-ENUZU5LQ.js.map
+//# sourceMappingURL=chunk-KV5BCSUR.js.map

package/dist/{chunk-FXED3VZK.js → chunk-L27H2R2N.js}

@@ -9,7 +9,7 @@ import {
   adCopyHints,
   booleanWordPositionalError,
   capabilityFix
-} from "./chunk-GIJT3A5U.js";
+} from "./chunk-T4DD5YMP.js";
 import {
   withHints
 } from "./chunk-D5FY4FAK.js";
@@ -171,4 +171,4 @@ export {
   stageOp,
   stageStatusChange
 };
-//# sourceMappingURL=chunk-FXED3VZK.js.map
+//# sourceMappingURL=chunk-L27H2R2N.js.map

package/dist/{chunk-OWK5WYFZ.js → chunk-NK2UFFVH.js}

@@ -1,9 +1,9 @@
 import {
   latestVersion
-} from "./chunk-ZN63N3EP.js";
+} from "./chunk-6TCDQSM7.js";
 import {
   canvasOutputsRoot
-} from "./chunk-HIPDMQZ6.js";
+} from "./chunk-DZSIUEGH.js";
 
 // src/commands/creatives/version-of.ts
 import path from "path";
@@ -16,4 +16,4 @@ async function versionOf(slug, run) {
 export {
   versionOf
 };
-//# sourceMappingURL=chunk-OWK5WYFZ.js.map
+//# sourceMappingURL=chunk-NK2UFFVH.js.map

package/dist/{chunk-EZUG6WE2.js → chunk-NSA6HRG6.js}

@@ -1,6 +1,6 @@
 import {
   REF_PREFIX
-} from "./chunk-RRUJQVWA.js";
+} from "./chunk-RCQJHKK5.js";
 
 // src/commands/canvas/node-preview.ts
 var MAX_PARAMS_PREVIEW_LENGTH = 4e3;
@@ -57,4 +57,4 @@ ${body}` : header || body || compactJson(record);
 export {
   nodeParamsPreview
 };
-//# sourceMappingURL=chunk-EZUG6WE2.js.map
+//# sourceMappingURL=chunk-NSA6HRG6.js.map

package/dist/{chunk-DQPTUBCB.js → chunk-NTPXZU3V.js}

@@ -1,6 +1,6 @@
 import {
   ACTION_TEMP_ID_PREFIX
-} from "./chunk-ASVKZQUU.js";
+} from "./chunk-6HJAHLLA.js";
 import {
   ApiError
 } from "./chunk-XBOK23HI.js";
@@ -160,4 +160,4 @@ export {
   ACTIONS_LIST_DEFAULT_LIMIT,
   buildListHints
 };
-//# sourceMappingURL=chunk-DQPTUBCB.js.map
+//# sourceMappingURL=chunk-NTPXZU3V.js.map

package/dist/{chunk-P3WRQED4.js → chunk-OAQPHP6V.js}

@@ -1,13 +1,13 @@
 import {
   findSubreddits,
   searchReddit
-} from "./chunk-B3AKIYBA.js";
+} from "./chunk-J5IU4OX2.js";
 import {
   holdUnbilledSpend
-} from "./chunk-K3PN7TN5.js";
+} from "./chunk-WTOYCUKH.js";
 import {
   findWorkspaceRoot
-} from "./chunk-HIPDMQZ6.js";
+} from "./chunk-DZSIUEGH.js";
 import {
   CUSTOMER_INSIGHTS_MODEL
 } from "./chunk-OBDAYP2P.js";
@@ -589,4 +589,4 @@ export {
   researchCustomers,
   customersCommand
 };
-//# sourceMappingURL=chunk-P3WRQED4.js.map
+//# sourceMappingURL=chunk-OAQPHP6V.js.map

package/dist/{chunk-633BRRZO.js → chunk-RB5DB3WN.js}

@@ -6,7 +6,7 @@ import {
   calendarDaySchema,
   todayUtc,
   windowTooLong
-} from "./chunk-ASVKZQUU.js";
+} from "./chunk-6HJAHLLA.js";
 
 // ../api/src/accounts/crm.ts
 import { z } from "zod";
@@ -1076,4 +1076,4 @@ export {
   accountsCampaignsRequestSchema,
   ACCOUNTS_NO_SETTINGS_MESSAGE
 };
-//# sourceMappingURL=chunk-633BRRZO.js.map
+//# sourceMappingURL=chunk-RB5DB3WN.js.map

package/dist/{chunk-RRUJQVWA.js → chunk-RCQJHKK5.js}

@@ -43,7 +43,7 @@ import {
   isBlocking,
   looksLikeHttpUrl,
   resolveOutputKinds
-} from "./chunk-OTFHEHIU.js";
+} from "./chunk-HRYOZUSK.js";
 
 // src/engine/scaffold/static-brief.ts
 var wordCount = (s) => s.split(/\s+/).filter(Boolean).length;
@@ -4349,9 +4349,11 @@ export {
   BackendClient,
   REF_PREFIX,
   parseRefExpr,
+  NodeDecl,
   renderTemplate,
   priceNode,
   estimateNodeCredits,
+  sumCredits,
   nodeDependencies,
   buildDependencyGraph,
   elementMentionKeywords,
@@ -4369,4 +4371,4 @@ export {
   canSpellNumbers,
   spellNumber
 };
-//# sourceMappingURL=chunk-RRUJQVWA.js.map
+//# sourceMappingURL=chunk-RCQJHKK5.js.map

package/dist/{chunk-ZXTW3TXY.js → chunk-SKT3SAHG.js}

@@ -10,10 +10,10 @@ import {
   readPersonaIds,
   sameMessageRead,
   workspaceIdeasJudge
-} from "./chunk-27NMXSC3.js";
+} from "./chunk-5EEDEVOR.js";
 import {
   findWorkspaceRoot
-} from "./chunk-HIPDMQZ6.js";
+} from "./chunk-DZSIUEGH.js";
 import {
   registerSchema,
   writeJson
@@ -130,4 +130,4 @@ export {
   ideasReport,
   ideasCommand
 };
-//# sourceMappingURL=chunk-ZXTW3TXY.js.map
+//# sourceMappingURL=chunk-SKT3SAHG.js.map

package/dist/{chunk-GIJT3A5U.js → chunk-T4DD5YMP.js}

@@ -11,10 +11,10 @@ import {
 } from "./chunk-F2S5BLPE.js";
 import {
   holdUnbilledSpend
-} from "./chunk-K3PN7TN5.js";
+} from "./chunk-WTOYCUKH.js";
 import {
   findWorkspaceRoot
-} from "./chunk-HIPDMQZ6.js";
+} from "./chunk-DZSIUEGH.js";
 import {
   CAPABILITY_SURFACE_SPECS
 } from "./chunk-ZJWUBJYQ.js";
@@ -163,4 +163,4 @@ export {
   capabilityFix,
   adCopyHints
 };
-//# sourceMappingURL=chunk-GIJT3A5U.js.map
+//# sourceMappingURL=chunk-T4DD5YMP.js.map

package/dist/{chunk-OC5IJSIW.js → chunk-V2X3KK52.js}

@@ -1,9 +1,9 @@
 import {
   holdUnbilledSpend
-} from "./chunk-K3PN7TN5.js";
+} from "./chunk-WTOYCUKH.js";
 import {
   findWorkspaceRoot
-} from "./chunk-HIPDMQZ6.js";
+} from "./chunk-DZSIUEGH.js";
 import {
   bytesOf
 } from "./chunk-4SJDDGPV.js";
@@ -417,4 +417,4 @@ export {
   fitReference,
   fitCommand
 };
-//# sourceMappingURL=chunk-OC5IJSIW.js.map
+//# sourceMappingURL=chunk-V2X3KK52.js.map

package/dist/{chunk-YY6CIVRY.js → chunk-V5WSJP5A.js}

@@ -1,10 +1,10 @@
 import {
   failApi
-} from "./chunk-DQPTUBCB.js";
+} from "./chunk-NTPXZU3V.js";
 import {
   HUBSPOT_MISSING_GRANT_MARKER,
   HUBSPOT_NOT_CONNECTED_MESSAGE
-} from "./chunk-ASVKZQUU.js";
+} from "./chunk-6HJAHLLA.js";
 import {
   ApiError
 } from "./chunk-XBOK23HI.js";
@@ -48,4 +48,4 @@ export {
   hubspotRefusal,
   failNotConnected
 };
-//# sourceMappingURL=chunk-YY6CIVRY.js.map
+//# sourceMappingURL=chunk-V5WSJP5A.js.map

package/dist/{chunk-7H2VLDYU.js → chunk-VJZHVOA4.js}

@@ -1,10 +1,10 @@
 import {
   finalOutputLabelsFromCanvas,
   parseDefinitionStrategyFields
-} from "./chunk-XZPREXCE.js";
+} from "./chunk-ACFWVULZ.js";
 import {
   readRenderState
-} from "./chunk-ZN63N3EP.js";
+} from "./chunk-6TCDQSM7.js";
 import {
   STATIC_AD_ROLE,
   formatOfAdaptId,
@@ -12,14 +12,15 @@ import {
   isSignatureLine,
   sameTag,
   seriesMemberAd
-} from "./chunk-NEZLPWD4.js";
+} from "./chunk-IH4UQ2OK.js";
 import {
   fetchRunRecord
-} from "./chunk-GZVZ7CQI.js";
+} from "./chunk-WRIC2RPQ.js";
 import {
   localPathParam
-} from "./chunk-HIPDMQZ6.js";
+} from "./chunk-DZSIUEGH.js";
 import {
+  NodeDecl,
   STATIC_ADAPT_FORMAT_ROLE,
   STATIC_FIX_ROLE,
   STATIC_MASTER_ROLE,
@@ -30,11 +31,15 @@ import {
   nodesWithRole,
   relaidPictureRole,
   rolesById
-} from "./chunk-RRUJQVWA.js";
+} from "./chunk-RCQJHKK5.js";
 import {
   isAdSpec,
   readAdSpec
 } from "./chunk-CLMM6P6B.js";
+import {
+  sha256Hex,
+  toModelSafeImage
+} from "./chunk-HRYOZUSK.js";
 
 // src/commands/baker-child.ts
 import { execFile } from "child_process";
@@ -81,6 +86,7 @@ function isStaticAdCanvas(parsed) {
 // src/commands/canvas/static-fix.ts
 import { readFile } from "fs/promises";
 import path from "path";
+import { z } from "zod";
 async function previousAdImage(canvasRoot, runId, fetchRecord = fetchRunRecord, roles = {}) {
   try {
     const manifest = JSON.parse(await readFile(path.join(canvasRoot, runId, "manifest.json"), "utf8"));
@@ -140,7 +146,9 @@ function chosenUrl(byNode) {
   return null;
 }
 function correctedUrl(byNode) {
-  for (const [id, out] of Object.entries(byNode)) {
+  const editNumber = (id) => Number(id.match(/^edit_(\d+)$/)?.[1] ?? 0);
+  const entries = Object.entries(byNode).sort(([a], [b]) => editNumber(b) - editNumber(a));
+  for (const [id, out] of entries) {
     if (id === "fix" || id === "chosen" || out.role === STATIC_FIX_ROLE) {
       const url = urlOf(out);
       if (url) return url;
@@ -148,6 +156,59 @@ function correctedUrl(byNode) {
   }
   return null;
 }
+async function fetchGraph(url) {
+  const res = await fetch(url);
+  return res.ok ? res.json() : null;
+}
+var HISTORY = { record: fetchRunRecord, graph: fetchGraph };
+var VersionGraph = z.object({ nodes: z.array(NodeDecl) });
+var VersionManifest = z.object({
+  canvas: VersionGraph,
+  outputs_by_node: z.record(z.string(), z.record(z.string(), z.unknown()))
+});
+async function versionRun(canvasRoot, runId, sources = HISTORY) {
+  try {
+    const manifest = VersionManifest.safeParse(JSON.parse(await readFile(path.join(canvasRoot, runId, "manifest.json"), "utf8")));
+    if (manifest.success) return { canvas: manifest.data.canvas, outputs: manifest.data.outputs_by_node };
+  } catch {
+  }
+  const record = await sources.record(runId).catch(() => null);
+  const graph = record?.graphUrl ? await sources.graph(record.graphUrl).catch(() => null) : null;
+  const canvas = VersionGraph.safeParse(graph);
+  return record && canvas.success ? { canvas: canvas.data, outputs: outputsByNode(record.nodes) } : null;
+}
+async function ingestedNow(files, canvasDir) {
+  const entries = await Promise.all(
+    files.map(async (file) => {
+      const bytes = await readFile(path.resolve(canvasDir, file.path)).catch(() => null);
+      if (!bytes) return [file.id, []];
+      const own = sha256Hex(bytes);
+      if (file.expect !== "image") return [file.id, [own]];
+      const raster = await toModelSafeImage(bytes).catch(() => null);
+      return [file.id, raster ? [.../* @__PURE__ */ new Set([own, sha256Hex(raster.bytes)])] : [own]];
+    })
+  );
+  return Object.fromEntries(entries);
+}
+function outputsByNode(nodes) {
+  const byNode = {};
+  for (const node of nodes) {
+    const outputs = {};
+    for (const out of node.outputs) {
+      const [slot = "", index] = String(out.slot ?? "").split("#");
+      const { slot: _slot, label: _label, durationMs, ...ref } = out;
+      const asset = { ...ref, ...typeof durationMs === "number" ? { duration_ms: durationMs } : {} };
+      if (index === void 0) outputs[slot] = asset;
+      else {
+        const list = Array.isArray(outputs[slot]) ? outputs[slot] : [];
+        list[Number(index)] = asset;
+        outputs[slot] = list;
+      }
+    }
+    if (Object.keys(outputs).length > 0) byNode[node.nodeId] = outputs;
+  }
+  return byNode;
+}
 async function correctedPicture(canvasRoot, runId, fetchRecord = fetchRunRecord) {
   try {
     const manifest = JSON.parse(await readFile(path.join(canvasRoot, runId, "manifest.json"), "utf8"));
@@ -432,6 +493,8 @@ export {
   isStaticAdCanvas,
   previousAdImage,
   previousDelivered,
+  versionRun,
+  ingestedNow,
   correctedPicture,
   pictureRecord,
   keepsChosen,
@@ -443,4 +506,4 @@ export {
   writeSeriesMemberCanvas,
   seriesRunHints
 };
-//# sourceMappingURL=chunk-7H2VLDYU.js.map
+//# sourceMappingURL=chunk-VJZHVOA4.js.map

package/dist/chunk-VJZHVOA4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/baker-child.ts","../src/commands/canvas/static-ad-canvas.ts","../src/commands/canvas/static-fix.ts","../src/commands/canvas/series-member.ts"],"sourcesContent":["/**\n * Another `baker` command run from this one, as a child process of the same CLI, read back by its\n * JSON answer: `creatives make` scaffolds through it, and `canvas run --series` renders each ad of\n * a series through it, all at once.\n */\nimport { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\n\nconst run = promisify(execFile);\n\n/** The last JSON object a command printed, after any progress lines. Pure. */\nexport function lastJsonObject(stdout: string): Record<string, unknown> | null {\n  for (let at = stdout.lastIndexOf(\"{\"); at >= 0; at = stdout.lastIndexOf(\"{\", at - 1)) {\n    if (at > 0 && stdout[at - 1] !== \"\\n\") continue;\n    try {\n      const parsed: unknown = JSON.parse(stdout.slice(at));\n      if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) return parsed as Record<string, unknown>;\n    } catch {\n      // Not the start of the final object: keep looking further back.\n    }\n    if (at === 0) break;\n  }\n  return null;\n}\n\n/** Run another `baker` command in this same CLI and read its JSON answer. */\nexport async function runBaker(args: string[], signal?: AbortSignal): Promise<Record<string, unknown>> {\n  const entry = process.argv[1];\n  const [file, argv] = entry ? [process.execPath, [...process.execArgv, entry, ...args]] : [\"baker\", args];\n  try {\n    const { stdout } = await run(file, argv, { maxBuffer: 32 * 1024 * 1024, ...(signal ? { signal } : {}) });\n    return lastJsonObject(stdout) ?? { ok: false, error: { code: \"INTERNAL_ERROR\", message: \"no answer\" } };\n  } catch (err) {\n    // A scaffold reports its failure on stderr, other commands on stdout.\n    const { stdout = \"\", stderr = \"\" } = err as { stdout?: string; stderr?: string };\n    return (\n      lastJsonObject(stdout) ??\n      lastJsonObject(stderr) ?? {\n        ok: false,\n        error: { code: \"INTERNAL_ERROR\", message: err instanceof Error ? err.message.slice(0, 300) : String(err) },\n      }\n    );\n  }\n}\n","import { STATIC_AD_ROLE } from \"../../engine/scaffold/static-render-briefs.ts\";\nimport { STATIC_VARIANTS_ROLE } from \"../../engine/scaffold/static-topology.ts\";\n\n/**\n * A static ad canvas, by role: an ingest tagged as the static ad's blueprint, or a node that\n * renders a static ad's variants. A canvas scaffolded by the overlay engine (a `compose_spec`\n * ingest) still counts, so a creative already in a client workspace reads as one until it is\n * re-scaffolded.\n */\nexport function isStaticAdCanvas(parsed: unknown): boolean {\n  const nodes = (parsed as { nodes?: unknown } | null)?.nodes;\n  if (!Array.isArray(nodes)) return false;\n  return nodes.some((n) => {\n    const role = (n as { tags?: { role?: unknown } } | null)?.tags?.role;\n    if (role === STATIC_VARIANTS_ROLE) return true;\n    return n?.type === \"ingest\" && (role === STATIC_AD_ROLE || n?.id === \"compose_spec\");\n  });\n}\n","import { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport { toModelSafeImage } from \"../../engine/nodes/ingest.ts\";\nimport type { VariantFile, VersionRun } from \"../../engine/scaffold/static-history.ts\";\nimport { NodeDecl } from \"../../engine/schema/canvas.ts\";\nimport { sha256Hex } from \"../../engine/storage/sha256.ts\";\nimport { fetchRunRecord } from \"./run-history.ts\";\n\nimport {\n  rolesById,\n  STATIC_ADAPT_FORMAT_ROLE,\n  STATIC_FIX_ROLE,\n  STATIC_MASTER_ROLE,\n  STATIC_PICK_ROLE,\n  STATIC_SAFE_FIT_ROLE,\n  STATIC_SIZE_ROLE,\n  STATIC_VARIANTS_ROLE,\n} from \"../../engine/scaffold/static-topology.ts\";\n\ntype Output = { url?: unknown; slot?: unknown; sha256?: unknown; path?: unknown };\n/** One node's outputs as a run keeps them: a list (`images`) or a single image, and its role when known. */\n/** A node's outputs by slot: a generation's `images`, a tool's `image`, an ingest's `asset`. */\ntype NodeOutputs = { images?: Output[]; image?: Output; asset?: Output; role?: string };\n\n/**\n * The finished ad a run chose, as the durable URL its record holds: its master (the chosen\n * picture before any logo is placed on it), or, on a run of the older graph, the judge's pick\n * or the lone take. Read from the local run folder first (`manifest.json`, outputs by node id,\n * given roles by `roles` — the canvas's), then from the company's run history (whose nodes\n * carry their roles), so a version rendered in another chat can be corrected too. Null when\n * the run is unknown or made no ad.\n */\nexport async function previousAdImage(\n  canvasRoot: string,\n  runId: string,\n  fetchRecord: (\n    runId: string,\n  ) => Promise<{ nodes: Array<{ nodeId: string; role?: string; outputs: Output[] }> } | null> = fetchRunRecord,\n  roles: Readonly<Record<string, string>> = {},\n): Promise<string | null> {\n  try {\n    const manifest = JSON.parse(await readFile(path.join(canvasRoot, runId, \"manifest.json\"), \"utf8\")) as {\n      outputs_by_node?: Record<string, NodeOutputs>;\n    };\n    const byNode = Object.fromEntries(\n      Object.entries(manifest.outputs_by_node ?? {}).map(([id, out]) => [id, { ...out, ...(roles[id] ? { role: roles[id] } : {}) }]),\n    );\n    const local = chosenUrl(byNode);\n    if (local) return local;\n  } catch {\n    // Not rendered here: ask the run history.\n  }\n  const record = await fetchRecord(runId).catch(() => null);\n  if (!record) return null;\n  return chosenUrl(\n    Object.fromEntries(\n      record.nodes.map((n) => {\n        const role = n.role ?? roles[n.nodeId];\n        return [n.nodeId, { images: n.outputs, ...(role ? { role } : {}) }];\n      }),\n    ),\n  );\n}\n\n/**\n * The sizes a run delivered (its `output` collect, `finalNode`), each with the format `labels`\n * gives it, from the local run folder: its local file, or its durable URL first (`prefer: \"url\"`).\n * Empty when the run was not rendered here.\n */\nexport async function previousDelivered(\n  canvasRoot: string,\n  runId: string,\n  finalNode: string,\n  labels: readonly (string | undefined)[],\n  opts: { prefer?: \"url\" } = {},\n): Promise<Array<{ format: string; path: string }>> {\n  try {\n    const manifest = JSON.parse(await readFile(path.join(canvasRoot, runId, \"manifest.json\"), \"utf8\")) as {\n      outputs_by_node?: Record<string, NodeOutputs>;\n    };\n    const images = manifest.outputs_by_node?.[finalNode]?.images ?? [];\n    return images.flatMap((image, i) => {\n      const local = typeof image.path === \"string\" ? image.path : null;\n      const durable = typeof image.url === \"string\" ? image.url : null;\n      const source = opts.prefer === \"url\" ? (durable ?? local) : (local ?? durable);\n      const format = labels[i];\n      return source && format ? [{ format, path: source }] : [];\n    });\n  } catch {\n    return [];\n  }\n}\n\n/** Which node holds the chosen ad, best first: by role on the one-picture graph, by id on an older one. */\nconst CHOSEN: ReadonlyArray<(id: string, out: NodeOutputs) => boolean> = [\n  (_, out) => out.role === STATIC_MASTER_ROLE,\n  (_, out) => out.role === STATIC_PICK_ROLE,\n  (_, out) => out.role === STATIC_FIX_ROLE,\n  (id, out) => id === \"pick\" && out.role === undefined,\n  (id, out) => id === \"ad\" && out.role === undefined,\n];\n\nfunction urlOf(out: NodeOutputs): string | null {\n  const url = out.images?.find((o) => typeof o?.url === \"string\")?.url ?? out.image?.url ?? out.asset?.url;\n  return typeof url === \"string\" ? url : null;\n}\n\n/** The chosen ad among a run's node outputs (see `previousAdImage`). Never a variant the judge did not keep. Pure. */\nexport function chosenUrl(byNode: Record<string, NodeOutputs>): string | null {\n  const entries = Object.entries(byNode).filter(([, out]) => out.role !== STATIC_VARIANTS_ROLE);\n  for (const matches of CHOSEN) {\n    for (const [id, out] of entries) {\n      if (!matches(id, out)) continue;\n      const url = urlOf(out);\n      if (url) return url;\n    }\n  }\n  return null;\n}\n\n/**\n * The picture a correction (`--fix`) or a person's choice (`--use-variant`) put in place of the\n * variants, the input its master was made from. Null for a plain render: the scaffolded graph\n * already reaches that picture through its own cache. Ids are the ones `fixStaticAd` and\n * `rederiveFromVariant` give those nodes; a run record also carries the correction's role. Pure.\n */\nexport function correctedUrl(byNode: Record<string, NodeOutputs>): string | null {\n  // A version grown on top of others (`static-history.ts`) keeps every correction: it shows its last.\n  // `fix` and `chosen` never share a graph with an `edit_<n>`: a chosen variant drops the edits before it.\n  const editNumber = (id: string) => Number(id.match(/^edit_(\\d+)$/)?.[1] ?? 0);\n  const entries = Object.entries(byNode).sort(([a], [b]) => editNumber(b) - editNumber(a));\n  for (const [id, out] of entries) {\n    if (id === \"fix\" || id === \"chosen\" || out.role === STATIC_FIX_ROLE) {\n      const url = urlOf(out);\n      if (url) return url;\n    }\n  }\n  return null;\n}\n\n/** A run as the run history keeps it: each node's recorded outputs, and where the graph it ran is kept. */\ntype RecordedRun = {\n  graphUrl?: string;\n  nodes: ReadonlyArray<{ nodeId: string; outputs: ReadonlyArray<Record<string, unknown>> }>;\n};\n\ntype VersionSources = {\n  record: (runId: string) => Promise<RecordedRun | null>;\n  graph: (url: string) => Promise<unknown>;\n};\n\nasync function fetchGraph(url: string): Promise<unknown> {\n  const res = await fetch(url);\n  return res.ok ? res.json() : null;\n}\n\nconst HISTORY: VersionSources = { record: fetchRunRecord, graph: fetchGraph };\n\n/** The graph a version ran, as its manifest or the run history keeps it. */\nconst VersionGraph = z.object({ nodes: z.array(NodeDecl) });\n/** The part of a run's manifest a version grows from: the graph it ran and every node's outputs. */\nconst VersionManifest = z.object({\n  canvas: VersionGraph,\n  outputs_by_node: z.record(z.string(), z.record(z.string(), z.unknown())),\n});\n\n/**\n * The graph run `runId` ran and every node's outputs, so the next version can be grown on top of\n * it (`growFromVersion`): from its run folder here, else, for a version rendered in another\n * workspace (\"Edit creative …\" from a new chat), from the run history and the graph it kept. Null\n * when neither has it (a run recorded before graphs were kept): the caller corrects by URL.\n */\nexport async function versionRun(\n  canvasRoot: string,\n  runId: string,\n  sources: VersionSources = HISTORY,\n): Promise<VersionRun | null> {\n  try {\n    const manifest = VersionManifest.safeParse(JSON.parse(await readFile(path.join(canvasRoot, runId, \"manifest.json\"), \"utf8\")));\n    if (manifest.success) return { canvas: manifest.data.canvas, outputs: manifest.data.outputs_by_node };\n  } catch {\n    // Not rendered here: ask the run history.\n  }\n  const record = await sources.record(runId).catch(() => null);\n  const graph = record?.graphUrl ? await sources.graph(record.graphUrl).catch(() => null) : null;\n  const canvas = VersionGraph.safeParse(graph);\n  return record && canvas.success ? { canvas: canvas.data, outputs: outputsByNode(record.nodes) } : null;\n}\n\n/**\n * What each workspace file the variants read is ingested as now, by node id (`makesSameVariants`):\n * the sha256 of its bytes, and for a picture also of the raster the ingest makes it into (an SVG\n * logo is ingested as a PNG). A file that cannot be read matches nothing.\n */\nexport async function ingestedNow(files: readonly VariantFile[], canvasDir: string): Promise<Record<string, string[]>> {\n  const entries = await Promise.all(\n    files.map(async (file): Promise<[string, string[]]> => {\n      const bytes = await readFile(path.resolve(canvasDir, file.path)).catch(() => null);\n      if (!bytes) return [file.id, []];\n      const own = sha256Hex(bytes);\n      if (file.expect !== \"image\") return [file.id, [own]];\n      const raster = await toModelSafeImage(bytes).catch(() => null);\n      return [file.id, raster ? [...new Set([own, sha256Hex(raster.bytes)])] : [own]];\n    }),\n  );\n  return Object.fromEntries(entries);\n}\n\n/**\n * Each node's outputs as the engine hands them on, from the run record's flat list: `images#1`\n * back into `images[1]`, `image` as it is, each an asset ref. A node that recorded none is left out.\n * Pure.\n */\nfunction outputsByNode(nodes: RecordedRun[\"nodes\"]): Record<string, Record<string, unknown>> {\n  const byNode: Record<string, Record<string, unknown>> = {};\n  for (const node of nodes) {\n    const outputs: Record<string, unknown> = {};\n    for (const out of node.outputs) {\n      const [slot = \"\", index] = String(out.slot ?? \"\").split(\"#\");\n      const { slot: _slot, label: _label, durationMs, ...ref } = out;\n      const asset = { ...ref, ...(typeof durationMs === \"number\" ? { duration_ms: durationMs } : {}) };\n      if (index === undefined) outputs[slot] = asset;\n      else {\n        const list = (Array.isArray(outputs[slot]) ? outputs[slot] : []) as unknown[];\n        list[Number(index)] = asset;\n        outputs[slot] = list;\n      }\n    }\n    if (Object.keys(outputs).length > 0) byNode[node.nodeId] = outputs;\n  }\n  return byNode;\n}\n\n/**\n * `correctedUrl` of a run: the local run folder first, then the company's run history, so a\n * version corrected in another chat is found too. Null for a plain render or an unknown run.\n */\nexport async function correctedPicture(\n  canvasRoot: string,\n  runId: string,\n  fetchRecord: (\n    runId: string,\n  ) => Promise<{ nodes: Array<{ nodeId: string; role?: string; outputs: Output[] }> } | null> = fetchRunRecord,\n): Promise<string | null> {\n  try {\n    const manifest = JSON.parse(await readFile(path.join(canvasRoot, runId, \"manifest.json\"), \"utf8\")) as {\n      outputs_by_node?: Record<string, NodeOutputs>;\n    };\n    if (manifest.outputs_by_node) return correctedUrl(manifest.outputs_by_node);\n  } catch {\n    // Not rendered here: ask the run history.\n  }\n  const record = await fetchRecord(runId).catch(() => null);\n  if (!record) return null;\n  return correctedUrl(\n    Object.fromEntries(record.nodes.map((n) => [n.nodeId, { images: n.outputs, ...(n.role ? { role: n.role } : {}) }])),\n  );\n}\n\n/**\n * How a version's picture came to be, where its canvas alone would not say: `chosen`, the person\n * picked it (`--use-variant`), so it is only ever corrected, never replaced, through every fix and\n * re-layout of it; `redrawn`, a new picture told what the last one got wrong (an autofix round),\n * which the scaffolded graph would not draw again.\n */\nexport type PictureRecord = { runId: string; chosen?: true; redrawn?: true };\n\n/**\n * The record of run `runId`'s picture: `chose`, the person picked it now; `keeps`, the run kept the\n * picture of version `from` (a fix, an edit, a re-layout), whose record `of` is. Pure.\n */\nexport function pictureRecord(\n  runId: string,\n  opts: { chose?: boolean; of?: PictureRecord | undefined; from?: string | undefined; keeps?: boolean; redrawn?: boolean },\n): PictureRecord {\n  const chosen = opts.chose === true || (opts.keeps === true && keepsChosen(opts.of, opts.from));\n  return { runId, ...(chosen ? { chosen: true as const } : {}), ...(opts.redrawn ? { redrawn: true as const } : {}) };\n}\n\n/** Whether version `from` shows a picture the person chose. Pure. */\nexport function keepsChosen(picture: PictureRecord | undefined, from: string | undefined): boolean {\n  return picture?.chosen === true && from !== undefined && picture.runId === from;\n}\n\n/**\n * Whether `--regenerate` forces only re-laid-out sizes (their fills and safe fits): work that must start\n * from the picture the version already shows, never from new variants. Pure.\n */\nexport function relaysSizesOnly(canvas: unknown, ids: readonly string[]): boolean {\n  const roles = rolesById(canvas);\n  const sizing = new Set([STATIC_ADAPT_FORMAT_ROLE, STATIC_SIZE_ROLE, STATIC_SAFE_FIT_ROLE]);\n  return ids.length > 0 && ids.every((id) => sizing.has(roles[id] ?? \"\"));\n}\n\n/** A sha256 or a unique prefix of one (at least 8 hex characters). */\nconst SHA_PREFIX = /^[0-9a-f]{8,64}$/;\n\n/** The URL of the variant whose sha256 starts with `sha` among one node's outputs; null when none or several match. */\nfunction matchVariant(outputs: readonly Output[], sha: string): string | null {\n  const hits = outputs.filter((o) => typeof o?.sha256 === \"string\" && o.sha256.startsWith(sha) && typeof o.url === \"string\");\n  const urls = [...new Set(hits.map((o) => o.url as string))];\n  return urls.length === 1 ? (urls[0] as string) : null;\n}\n\n/**\n * The durable URL of the variant to make every size from instead of the judge's pick (`--use-variant`),\n * found by its sha256 among the run's variants, never by position: the local run folder first\n * (its outputs keyed by node id, given roles by `roles`), then the run history. Null when the\n * run or the variant is unknown.\n */\nexport async function variantImage(\n  canvasRoot: string,\n  runId: string,\n  sha256: string,\n  fetchRecord: (\n    runId: string,\n  ) => Promise<{ nodes: Array<{ nodeId: string; role?: string; outputs: Output[] }> } | null> = fetchRunRecord,\n  roles: Readonly<Record<string, string>> = {},\n): Promise<string | null> {\n  const sha = sha256.trim().toLowerCase();\n  if (!SHA_PREFIX.test(sha)) return null;\n  try {\n    const manifest = JSON.parse(await readFile(path.join(canvasRoot, runId, \"manifest.json\"), \"utf8\")) as {\n      outputs_by_node?: Record<string, NodeOutputs>;\n    };\n    for (const [id, out] of Object.entries(manifest.outputs_by_node ?? {})) {\n      if (roles[id] !== STATIC_VARIANTS_ROLE) continue;\n      const url = matchVariant(out.images ?? [], sha);\n      if (url) return url;\n    }\n  } catch {\n    // Not rendered here: ask the run history.\n  }\n  const record = await fetchRecord(runId).catch(() => null);\n  const variants = record?.nodes.find((n) => n.role === STATIC_VARIANTS_ROLE);\n  return variants ? matchVariant(variants.outputs, sha) : null;\n}\n","/**\n * An ad of a series, on disk: `src/creatives/<slug>/` holds its own words (`prompt.json`) and a\n * `_definition.md` naming its lead (`series: <lead>`); its canvas is written from the lead's,\n * every run, as an edit of the lead's ready version (`seriesMemberAd`). The ad never designs a\n * picture of its own, so ten messages in one style come out as one ad ten times.\n */\nimport { existsSync } from \"node:fs\";\nimport { readdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { CreativesRunData } from \"@baker/api\";\nimport { isAdSpec, readAdSpec } from \"../../engine/scaffold/static-ad-spec.ts\";\nimport { isCustomersWords, isSignatureLine } from \"../../engine/scaffold/static-proof.ts\";\nimport { sameTag } from \"../../language.ts\";\nimport { formatOfAdaptId } from \"../../engine/scaffold/static-adapt-briefs.ts\";\nimport {\n  nodesWithRole,\n  relaidPictureRole,\n  rolesById,\n  STATIC_ADAPT_FORMAT_ROLE,\n} from \"../../engine/scaffold/static-topology.ts\";\nimport { type SeriesLead, seriesMemberAd } from \"../../engine/scaffold/staticAd.ts\";\nimport { parseDefinitionStrategyFields } from \"./creative-definition.ts\";\nimport { localPathParam } from \"./resolve-paths.ts\";\nimport { readRenderState } from \"./render-state.ts\";\nimport { fetchRunRecord } from \"./run-history.ts\";\nimport { finalOutputLabelsFromCanvas } from \"./run-record.ts\";\nimport { isStaticAdCanvas } from \"./static-ad-canvas.ts\";\nimport { previousAdImage, previousDelivered } from \"./static-fix.ts\";\n\n/** Why a series ad cannot be made yet: what to tell the agent, and what to do. */\nexport type SeriesRefusal = { refused: { code: string; message: string; fix: string } };\n\ntype Fetch = (runId: string) => Promise<CreativesRunData | null>;\n\nconst creativeDir = (root: string, slug: string) => path.join(root, \"src\", \"creatives\", slug);\nconst canvasFile = (root: string, slug: string) => path.join(creativeDir(root, slug), `${slug}.canvas.json`);\n\n/** What a creative's `_definition.md` says of its series: its lead (`series:`) and the language its words are in. */\nasync function seriesFieldsOf(root: string, slug: string): Promise<{ seriesLead?: string; language?: string }> {\n  const raw = await readFile(path.join(creativeDir(root, slug), \"_definition.md\"), \"utf8\").catch(() => null);\n  return raw === null ? {} : parseDefinitionStrategyFields(raw);\n}\n\n/** The lead a creative's `_definition.md` names (`series:`); null when it is no ad of a series. */\nexport async function seriesLeadOf(root: string, slug: string): Promise<string | null> {\n  return (await seriesFieldsOf(root, slug)).seriesLead ?? null;\n}\n\n/** The language a translation's words are in: its own, when it is not its lead's. Undefined on any other ad. */\nasync function translatedInto(root: string, slug: string, lead: string): Promise<string | undefined> {\n  const own = (await seriesFieldsOf(root, slug)).language;\n  const leads = (await seriesFieldsOf(root, lead)).language;\n  return own && !(leads && sameTag(own, leads)) ? own : undefined;\n}\n\n/** How many leads up a series may chain: a design, its angle ads, their translations. */\nexport const SERIES_DEPTH = 3;\n\n/**\n * The leads above `slug`, nearest first, up to the ad whose design the whole series has (an angle\n * ad, then the design it was made from). Bounded and cycle-safe; empty for an ad in no series.\n */\nexport async function seriesLeadsAbove(root: string, slug: string): Promise<string[]> {\n  const leads: string[] = [];\n  let at = await seriesLeadOf(root, slug);\n  while (at && at !== slug && !leads.includes(at) && leads.length < SERIES_DEPTH) {\n    leads.push(at);\n    at = await seriesLeadOf(root, at);\n  }\n  return leads;\n}\n\n/** Every ad of the series led by `lead`, by slug, in folder order. */\nexport async function seriesMembers(root: string, lead: string): Promise<string[]> {\n  const slugs = await readdir(path.join(root, \"src\", \"creatives\")).catch(() => [] as string[]);\n  const members: string[] = [];\n  for (const slug of slugs.sort()) {\n    if (slug !== lead && (await seriesLeadOf(root, slug)) === lead) members.push(slug);\n  }\n  return members;\n}\n\nfunction refusal(code: string, message: string, fix: string): SeriesRefusal {\n  return { refused: { code, message, fix } };\n}\n\n/**\n * The lead's ready version: the one this workspace shows (its render state), its words as that\n * render drew them, its chosen picture and every size it delivered. A lead never rendered, or\n * whose version still needs fixes, is refused: every ad of the series copies it.\n */\nexport async function leadVersion(\n  root: string,\n  lead: string,\n  fetchRecord: Fetch = fetchRunRecord,\n): Promise<{ lead: SeriesLead; canvas: unknown; spec: unknown } | SeriesRefusal> {\n  const file = canvasFile(root, lead);\n  const canvas: unknown = existsSync(file) ? JSON.parse(await readFile(file, \"utf8\")) : null;\n  if (!canvas || !isStaticAdCanvas(canvas)) {\n    return refusal(\n      \"series_lead_not_found\",\n      `The lead ad \"${lead}\" is not a static ad in this workspace.`,\n      \"Name a static ad of this workspace as the lead: make it with `baker creatives make <idea>` and render it first.\",\n    );\n  }\n  const canvasRoot = path.join(root, \"canvas\");\n  const state = await readRenderState(canvasRoot, lead);\n  const runId = state.rendered?.runId;\n  if (!runId) {\n    return refusal(\n      \"series_lead_not_rendered\",\n      `The lead ad \"${lead}\" has no finished version yet: every ad of its series is made from it.`,\n      `Render the lead first and get it ready: baker canvas run --slug ${lead}. Then make the series.`,\n    );\n  }\n  if ((state.blocking ?? []).length > 0) {\n    return refusal(\n      \"series_lead_not_ready\",\n      `The lead ad \"${lead}\" still needs fixes (${(state.blocking ?? []).join(\" | \")}): the series would copy them.`,\n      `Correct the lead until its verdict is ready (baker canvas run --slug ${lead}, or --fix \"<what to change>\"), then run the series again.`,\n    );\n  }\n  const record = (): Promise<CreativesRunData | null> => fetchRecord(runId).catch(() => null);\n  const picture = await previousAdImage(canvasRoot, runId, record, { ...rolesById(canvas), ...relaidPictureRole(canvas) });\n  const sizes = await deliveredSizes(canvasRoot, runId, canvas, record);\n  if (!picture) {\n    return refusal(\n      \"series_lead_not_rendered\",\n      `The finished picture of the lead's version (${runId}) is not available.`,\n      `Render the lead again (baker canvas run --slug ${lead}), then run the series.`,\n    );\n  }\n  const drawn = state.prompt ?? JSON.parse(await readFile(path.join(creativeDir(root, lead), \"prompt.json\"), \"utf8\"));\n  const copy = readAdSpec(drawn).copy.map((l) => ({ text: l.text, ...(l.role ? { role: l.role } : {}) }));\n  return { lead: { slug: lead, runId, copy, picture, sizes }, canvas, spec: drawn };\n}\n\n/** Each re-laid-out size the lead's version delivered, by format: its local run folder first, else its record. */\nasync function deliveredSizes(\n  canvasRoot: string,\n  runId: string,\n  canvas: unknown,\n  record: () => Promise<CreativesRunData | null>,\n): Promise<Record<string, string>> {\n  const wanted = new Set(nodesWithRole(canvas, STATIC_ADAPT_FORMAT_ROLE).flatMap((n) => formatOfAdaptId(n.id) ?? []));\n  const labels = finalOutputLabelsFromCanvas(canvas);\n  const local = await previousDelivered(canvasRoot, runId, labels?.nodeId ?? \"final\", labels?.labels ?? [], {\n    prefer: \"url\",\n  });\n  const found = local.length > 0 ? local : ((await record())?.finalOutputs ?? []).flatMap((o) =>\n    o.label && o.url ? [{ format: o.label, path: o.url }] : [],\n  );\n  return Object.fromEntries(found.filter((d) => wanted.has(d.format)).map((d) => [d.format, d.path]));\n}\n\n/**\n * The lead's canvas with its local paths read from the member's folder: the brand's font and\n * logo are the same files, the member's own `prompt.json` stays its own. Pure.\n */\nexport function rebaseLeadPaths<T>(canvas: T, leadDir: string, memberDir: string): T {\n  const out = structuredClone(canvas) as { nodes?: Array<{ id?: unknown; type?: unknown; params?: Record<string, unknown> }> };\n  for (const node of out.nodes ?? []) {\n    const key = localPathParam(node);\n    const value = key ? node.params?.[key] : undefined;\n    if (!key || !node.params || typeof value !== \"string\" || node.id === \"prompt\" || path.isAbsolute(value)) continue;\n    const rel = path.relative(memberDir, path.resolve(leadDir, value)).split(path.sep).join(\"/\");\n    node.params[key] = rel.startsWith(\".\") ? rel : `./${rel}`;\n  }\n  return out as T;\n}\n\n/** What every ad of a series shares with its lead: everything in prompt.json but its words and who it speaks to. */\nconst DESIGN_FIELDS = [\n  \"scene\",\n  \"brand\",\n  \"colors\",\n  \"references\",\n  \"logo\",\n  \"logo_position\",\n  \"third_party_brands\",\n  \"formats\",\n  \"direction\",\n] as const;\n\n/** The design a spec draws, as one comparable string; null when it does not read as an ad spec. Pure. */\nexport function seriesDesignOf(spec: unknown): string | null {\n  try {\n    const read = readAdSpec(spec) as Record<string, unknown>;\n    return JSON.stringify(DESIGN_FIELDS.map((key) => read[key] ?? null));\n  } catch {\n    return null;\n  }\n}\n\n/** `memberSpec` with the lead's design and its own words, viewer and message. Pure. */\nfunction withLeadDesign(memberSpec: unknown, leadSpec: unknown): Record<string, unknown> {\n  // An older blueprint names its design in its own shape: each is taken as the ad spec it reads as.\n  const asSpec = (spec: unknown): Record<string, unknown> =>\n    isAdSpec(spec) ? (spec as Record<string, unknown>) : readAdSpec(spec);\n  const lead = asSpec(leadSpec);\n  const out = { ...asSpec(memberSpec) };\n  for (const key of DESIGN_FIELDS) {\n    if (key in lead) out[key] = lead[key];\n    else delete out[key];\n  }\n  return out;\n}\n\n/** A series ad whose words are still the lead's renders the lead again: refused before anything bills. Pure. */\nexport function unchangedCopyRefusal(lead: SeriesLead, memberSpec: unknown): SeriesRefusal | null {\n  const words = (copy: ReadonlyArray<{ text: string }>) => copy.map((l) => l.text.trim()).join(\"\\n\");\n  let copy: ReadonlyArray<{ text: string }>;\n  try {\n    copy = readAdSpec(memberSpec).copy;\n  } catch {\n    return null;\n  }\n  if (words(copy) !== words(lead.copy)) return null;\n  return refusal(\n    \"series_copy_unchanged\",\n    `This ad's words are still the lead's (\"${lead.copy[0]?.text ?? \"\"}\"): it would render the lead again.`,\n    \"Write this ad's own words in its prompt.json `copy`, one line for each of the lead's (same roles), saying this ad's message. Keep everything else: the design is the lead's.\",\n  );\n}\n\n/**\n * A translation whose lines the lead holds as a customer's words (a quote, signed by its shape or\n * its role, or by a signature on the line below) are not those words as the lead has them: the\n * translation puts words the customer never said under their name. Null when every one is kept. Pure.\n */\nexport function changedCustomerWordsRefusal(lead: SeriesLead, memberSpec: unknown): SeriesRefusal | null {\n  let copy: ReadonlyArray<{ text: string }>;\n  try {\n    copy = readAdSpec(memberSpec).copy;\n  } catch {\n    return null;\n  }\n  const said = new Set(copy.map((l) => l.text.trim()));\n  const changed = lead.copy.filter((line, i) => {\n    const below = lead.copy[i + 1];\n    const theirs = isCustomersWords(line) || (below !== undefined && isSignatureLine(below));\n    return theirs && !said.has(line.text.trim());\n  });\n  if (changed.length === 0) return null;\n  return refusal(\n    \"series_customer_words_changed\",\n    `This translation changed a customer's own words: ${changed.map((l) => `\"${l.text}\"`).join(\", \")} is how they said it, and translated it would be words they never said under their name.`,\n    `Put ${changed.length === 1 ? \"that line\" : \"those lines\"} back in this ad's prompt.json exactly as the lead has ${changed.length === 1 ? \"it\" : \"them\"}: ${changed.map((l) => `\"${l.text}\"`).join(\", \")}. Translate only the advertiser's own lines.`,\n  );\n}\n\n/**\n * A design edited on an ad of a series: it is made once, on the ad whose design the whole series\n * has (the last of `leads`), then carried down each series run, the farthest first. Pure.\n */\nexport function designChangedRefusal(lead: string, leads: readonly string[]): SeriesRefusal {\n  const chain = leads.length > 0 ? leads : [lead];\n  const design = chain[chain.length - 1] ?? lead;\n  const runs = [...chain].reverse().map((l) => `baker canvas run --series ${l}`);\n  return refusal(\n    \"series_design_changed\",\n    `This ad's design (its scene, colours, pictures or logo in prompt.json) was changed on the ad itself, but every ad of the series has the design of \"${design}\".`,\n    `Make the change once, on ${design}: edit src/creatives/${design}/prompt.json (or baker canvas run --slug ${design} --fix \"<the change>\"), then ${runs.join(\", then \")}: every ad takes the new design, its own words kept. Only this ad's copy belongs in its own prompt.json.`,\n  );\n}\n\n/**\n * Write the canvas of series ad `slug` from its lead's ready version. Null when `slug` is no ad\n * of a series; a refusal when its lead is not ready or its words are still the lead's (allowed\n * only when the ad is first made, before its words are written: `leadWords`).\n */\nexport async function writeSeriesMemberCanvas(\n  root: string,\n  slug: string,\n  opts: { fetchRecord?: Fetch; leadWords?: boolean; takeLeadDesign?: boolean } = {},\n): Promise<\n  | {\n      lead: string;\n      leadRunId: string;\n      canvasPath: string;\n      written: boolean;\n      designFromLead: boolean;\n      /** The ad was last made from an older version of its lead: this run is a new version of the ad. */\n      newLeadVersion: boolean;\n    }\n  | SeriesRefusal\n  | null\n> {\n  const lead = await seriesLeadOf(root, slug);\n  if (!lead) return null;\n  const version = await leadVersion(root, lead, opts.fetchRecord);\n  if (\"refused\" in version) return version;\n  const dir = creativeDir(root, slug);\n  const promptPath = path.join(dir, \"prompt.json\");\n  let memberSpec = JSON.parse(await readFile(promptPath, \"utf8\").catch(() => \"null\"));\n  const unchanged = opts.leadWords ? null : unchangedCopyRefusal(version.lead, memberSpec);\n  if (unchanged) return unchanged;\n  const language = await translatedInto(root, slug, lead);\n  const rewritten = language ? changedCustomerWordsRefusal(version.lead, memberSpec) : null;\n  if (rewritten) return rewritten;\n  const file = canvasFile(root, slug);\n  const before = await readFile(file, \"utf8\").catch(() => null);\n  // The design is the lead's. A new version of the lead carries it to an ad untouched since; a\n  // design edited on the ad itself is refused, unless the series run is asked to take the lead's back.\n  const leadDesign = seriesDesignOf(version.spec);\n  const ownDesign = seriesDesignOf(memberSpec);\n  const previous = before\n    ? (JSON.parse(before) as { metadata?: { series?: { design?: string; run_id?: string } } }).metadata?.series\n    : undefined;\n  const synced = previous?.design;\n  let designFromLead = false;\n  if (leadDesign !== null && ownDesign !== null && ownDesign !== leadDesign) {\n    if (!opts.takeLeadDesign && ownDesign !== synced) {\n      return designChangedRefusal(lead, await seriesLeadsAbove(root, slug));\n    }\n    memberSpec = withLeadDesign(memberSpec, version.spec);\n    await writeFile(promptPath, `${JSON.stringify(memberSpec, null, 2)}\\n`, \"utf8\");\n    designFromLead = true;\n  }\n  const canvas = seriesMemberAd(\n    rebaseLeadPaths(version.canvas, creativeDir(root, lead), dir),\n    { ...version.lead, ...(leadDesign !== null ? { design: leadDesign } : {}) },\n    language ? { language } : {},\n  );\n  const text = `${JSON.stringify(canvas, null, 2)}\\n`;\n  if (before !== text) await writeFile(file, text, \"utf8\");\n  const madeFrom = (await readRenderState(path.join(root, \"canvas\"), slug)).seriesLeadRun;\n  const newLeadVersion = madeFrom !== undefined && madeFrom !== version.lead.runId;\n  return { lead, leadRunId: version.lead.runId, canvasPath: file, written: before !== text, designFromLead, newLeadVersion };\n}\n\n/**\n * What a run of an ad of a series, or of its lead, says to do next: a new version of the lead\n * reaches the series only through a series run, and a change to the design every ad shares is\n * made once, on the lead. Empty for an ad in no series. Pure.\n */\nexport function seriesRunHints(\n  slug: string,\n  series: { lead?: string | null; leads?: readonly string[]; members: readonly string[] },\n): string[] {\n  // Nearest lead first: a translation of an angle ad takes its design from the ad at the top.\n  const leads = series.leads?.length ? series.leads : series.lead ? [series.lead] : [];\n  const root = leads[leads.length - 1];\n  if (root) {\n    const runs = [...leads].reverse().map((lead) => `baker canvas run --series ${lead}`);\n    return [\n      `This ad is one of the series led by ${leads[0]}: its picture is ${root}'s with its own words. A change to what every ad shares (the picture, colours, layout, logo) is made once, on ${root} (src/creatives/${root}/prompt.json, or baker canvas run --slug ${root} --fix \"<the change>\"), then ${runs.join(\", then \")}. Correct only this ad's own words or its own defect here.`,\n    ];\n  }\n  if (series.members.length === 0) return [];\n  return [\n    `This ad leads a series of ${series.members.length + 1}: baker canvas run --series ${slug} makes ${series.members.join(\", \")} again from this version, each with its own words. Until then they show the lead's earlier version; an ad of the series run by itself (baker canvas run --slug ${series.members[0]}) is made from this version too, its design included.`,\n  ];\n}\n"],"mappings":"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","names":["readFile","path","path","readFile","copy"]}

package/dist/{chunk-GZVZ7CQI.js → chunk-WRIC2RPQ.js}

@@ -1,6 +1,6 @@
 import {
   creativesRunResponseSchema
-} from "./chunk-ASVKZQUU.js";
+} from "./chunk-6HJAHLLA.js";
 import {
   ApiError,
   apiPost
@@ -20,4 +20,4 @@ async function fetchRunRecord(runId, post = apiPost) {
 export {
   fetchRunRecord
 };
-//# sourceMappingURL=chunk-GZVZ7CQI.js.map
+//# sourceMappingURL=chunk-WRIC2RPQ.js.map

package/dist/{chunk-K3PN7TN5.js → chunk-WTOYCUKH.js}

@@ -1,6 +1,6 @@
 import {
   findWorkspaceRoot
-} from "./chunk-HIPDMQZ6.js";
+} from "./chunk-DZSIUEGH.js";
 
 // src/commands/canvas/unbilled-spend.ts
 import { randomUUID } from "crypto";
@@ -81,4 +81,4 @@ export {
   sendBillingSpend,
   holdWhenSettled
 };
-//# sourceMappingURL=chunk-K3PN7TN5.js.map
+//# sourceMappingURL=chunk-WTOYCUKH.js.map

package/dist/{chunk-HMEFD2CG.js → chunk-XDNEG2H6.js}

@@ -16,10 +16,11 @@ import {
   renderedPromptOverLimit,
   spellNumber,
   subgraph,
+  sumCredits,
   topologicalLayers,
   validateCanvas,
   validateCanvasDeep
-} from "./chunk-RRUJQVWA.js";
+} from "./chunk-RCQJHKK5.js";
 import {
   remoteCacheEnabledFromEnv
 } from "./chunk-W3B4BHQU.js";
@@ -94,7 +95,7 @@ import {
   persistOutputAssetUrls,
   sha256Hex,
   uploadAndIngest
-} from "./chunk-OTFHEHIU.js";
+} from "./chunk-HRYOZUSK.js";
 import {
   fetchExternalBytes
 } from "./chunk-YBMVHGY3.js";
@@ -106,6 +107,9 @@ import {
 // src/engine/index.ts
 import path15 from "path";
 
+// src/engine/engine/executor.ts
+import { existsSync } from "fs";
+
 // src/engine/lib/concurrency.ts
 var DEFAULT_CONCURRENCY = 8;
 function resolveConcurrency(...candidates) {
@@ -298,7 +302,8 @@ var Engine = class {
     const runId = opts.run_id ?? `r_${ulid()}`;
     const writer = new OutputWriter({ outputsDir: this.outputsDir, runId });
     await writer.ensure();
-    this.log(`[validate] ok (${canvas.nodes.length} nodes, est. ${validation.estimatedCredits} credits)`);
+    const estimate = opts.pinned ? sumCredits((validation.perNodeCredits ?? []).filter((n) => !opts.pinned?.[n.node_id])) : validation.estimatedCredits;
+    this.log(`[validate] ok (${canvas.nodes.length} nodes, est. ${estimate} credits)`);
     for (const w of validation.warnings ?? []) {
       this.log(`[warn    ] ${w.code}${w.node_id ? ` (${w.node_id})` : ""}: ${w.message}`);
     }
@@ -449,6 +454,8 @@ var Engine = class {
     if (!node) throw new Error(`executor: missing node ${nodeId}`);
     const def = this.registry.get(node.type);
     if (!def) throw new Error(`executor: missing registry entry for type ${node.type}`);
+    const pinned = opts.pinned?.[node.id];
+    if (pinned) return this.replayPinned(node, pinned, outputs, writer, downloadOutputs);
     const regenerateToken = resolveRegenerateToken(node, opts.regenerate, runId);
     const prepared = await prepareForExecution(node, outputs, def, canvas.cache_salt, regenerateToken, this.assets);
     const policy = opts.cache_policy ?? "read_write";
@@ -507,6 +514,25 @@ var Engine = class {
     this.logOutputWarnings(node.id, hit.outputs);
     return { cached: true, credits: 0, durationMs: Date.now() - cacheT0 };
   }
+  /**
+   * An earlier run's outputs replayed as this node's result: free, and never rendered again. A
+   * local file that is gone falls back to the durable URL, downloaded when a local node needs it.
+   */
+  async replayPinned(node, pinned, outputs, writer, downloadOutputs) {
+    const t0 = Date.now();
+    const replayed = await mapObjectsAsync(pinned, (v) => {
+      if (!isAssetRef(v) || typeof v.url !== "string") return void 0;
+      if (typeof v.path === "string" && existsSync(v.path)) return Promise.resolve(v);
+      const { path: _gone, ...urlOnly } = v;
+      if (!downloadOutputs) return Promise.resolve(urlOnly);
+      const url = v.url;
+      return this.assets.ingestRemote({ kind: v.kind, url, sha256: v.sha256, mime: v.mime, metadata: v.metadata }).then((local) => ({ ...urlOnly, path: local.path }));
+    });
+    outputs[node.id] = replayed;
+    await this.materializeNodeOutputs(node.id, replayed, writer);
+    this.log(`[exec    ] ${node.id.padEnd(20)} ${node.type.padEnd(20)} kept from the version before`);
+    return { cached: true, credits: 0, durationMs: Date.now() - t0 };
+  }
   /** Best-effort: a failed upload keeps the outputs local-only, never fails the node. */
   async persistOutputs(nodeId, outputs, ctx) {
     try {
@@ -5160,4 +5186,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-HMEFD2CG.js.map
+//# sourceMappingURL=chunk-XDNEG2H6.js.map