@koda-sl/baker-cli 0.386.0-dev.4e118c09a → 0.386.0-dev.d6e55699d

package/dist/chunk-MUVSWFLL.js

@@ -0,0 +1,111 @@
+import {
+  prepareCanvas,
+  unsuppliedPlaceholderAssets
+} from "./chunk-QKE7GXZ7.js";
+import {
+  isSourceStale
+} from "./chunk-KRIK2JR4.js";
+
+// src/commands/canvas/render-state.ts
+import { mkdir, readdir, readFile, rm, writeFile } from "fs/promises";
+import path from "path";
+var RENDER_STATE_DIR = ".rendered";
+function statePath(canvasRoot, slug) {
+  return path.join(canvasRoot, RENDER_STATE_DIR, `${slug}.json`);
+}
+async function readRenderState(canvasRoot, slug) {
+  try {
+    const parsed = JSON.parse(await readFile(statePath(canvasRoot, slug), "utf8"));
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+async function latestVersion(canvasRoot, slug) {
+  return (await readRenderState(canvasRoot, slug)).rendered?.runId ?? null;
+}
+async function updateRenderState(canvasRoot, slug, patch) {
+  try {
+    const next = { ...await readRenderState(canvasRoot, slug), ...patch };
+    await mkdir(path.join(canvasRoot, RENDER_STATE_DIR), { recursive: true });
+    await writeFile(statePath(canvasRoot, slug), `${JSON.stringify(next, null, 2)}
+`, "utf8");
+  } catch {
+  }
+}
+async function recordRenderAttempt(canvasRoot, slug, sourceSha) {
+  if (!sourceSha) return;
+  await updateRenderState(canvasRoot, slug, { attempted: { sourceSha, at: Date.now() } });
+}
+async function recordRendered(canvasRoot, slug, sourceSha, runId, drawn = {}) {
+  if (!sourceSha) return;
+  await updateRenderState(canvasRoot, slug, {
+    rendered: { sourceSha, runId, at: Date.now() },
+    ...drawn.prompt !== void 0 ? { prompt: drawn.prompt } : {},
+    lastFix: drawn.lastFix,
+    picture: drawn.picture,
+    ...drawn.seriesLeadRun ? { seriesLeadRun: drawn.seriesLeadRun } : {}
+  });
+}
+async function recordReviewOutcome(canvasRoot, slug, outcome) {
+  await updateRenderState(canvasRoot, slug, outcome);
+}
+async function recordSeriesLeadRun(canvasRoot, slug, leadRunId) {
+  await updateRenderState(canvasRoot, slug, { seriesLeadRun: leadRunId });
+}
+async function recordSnapshot(canvasRoot, slug, snapshot) {
+  await updateRenderState(canvasRoot, slug, { snapshot });
+}
+function isRenderStale(state, currentSourceSha) {
+  if (!state.rendered) return false;
+  if (!isSourceStale(currentSourceSha, state.rendered.sourceSha)) return false;
+  return state.attempted?.sourceSha !== currentSourceSha;
+}
+async function staleCreatives(workspaceRoot) {
+  const creativesDir = path.join(workspaceRoot, "src", "creatives");
+  const canvasRoot = path.join(workspaceRoot, "canvas");
+  let slugs;
+  try {
+    slugs = (await readdir(creativesDir, { withFileTypes: true })).filter((d) => d.isDirectory()).map((d) => d.name);
+  } catch {
+    return [];
+  }
+  const stale = [];
+  for (const slug of slugs.sort()) {
+    const state = await readRenderState(canvasRoot, slug);
+    if (!state.rendered) continue;
+    const canvasPath = path.join(creativesDir, slug, `${slug}.canvas.json`);
+    let prepared;
+    try {
+      prepared = await prepareCanvas(canvasPath, { write: false });
+    } catch {
+      continue;
+    }
+    if (unsuppliedPlaceholderAssets(prepared.fileGraph).length > 0) continue;
+    const current = prepared.sourceSha;
+    if (!current || !isRenderStale(state, current)) continue;
+    stale.push({
+      slug,
+      canvasPath: path.relative(workspaceRoot, canvasPath).split(path.sep).join("/"),
+      renderedRunId: state.rendered.runId,
+      sourceSha: current
+    });
+  }
+  return stale;
+}
+async function clearLegacyDirtyMarker(canvasRoot, slug) {
+  await rm(path.join(canvasRoot, ".dirty", `${slug}.json`), { force: true }).catch(() => void 0);
+}
+
+export {
+  readRenderState,
+  latestVersion,
+  recordRenderAttempt,
+  recordRendered,
+  recordReviewOutcome,
+  recordSeriesLeadRun,
+  recordSnapshot,
+  staleCreatives,
+  clearLegacyDirtyMarker
+};
+//# sourceMappingURL=chunk-MUVSWFLL.js.map

package/dist/chunk-MUVSWFLL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/render-state.ts"],"sourcesContent":["import { mkdir, readdir, readFile, rm, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { isSourceStale } from \"@baker/api\";\nimport type { LastFix } from \"./static-edit.ts\";\nimport type { PictureRecord } from \"./static-fix.ts\";\nimport { unsuppliedPlaceholderAssets } from \"./placeholders.ts\";\nimport { type PreparedCanvas, prepareCanvas } from \"./prepare-canvas.ts\";\n\n/**\n * What this workspace last rendered, per creative: `canvas/.rendered/<slug>.json`.\n *\n * \"Edited since its last render\" is the source fingerprint (`computeSourceSha`) now,\n * compared with the fingerprint the last completed render recorded here. It replaces the\n * `canvas/.dirty` marker a PostToolUse hook used to drop, which only saw the Write and\n * Edit tools touching `*.canvas.json` / `prompt.json`: an edit to a scene file, a\n * composition, or anything made through the shell slipped past it, and the Stop hook and\n * the `validate-creative-renders` gate let a stale preview ship.\n *\n * Two facts are kept apart:\n * - `rendered`: the source a COMPLETED render drew, and its run id;\n * - `attempted`: the source the last `baker canvas run` started on, whatever came of it.\n *   A render that fails on exactly this source is not asked for again until the source\n *   moves, so a canvas that cannot render never loops the agent.\n *\n * Lives under the gitignored `canvas/` outputs root of the workspace the canvas belongs\n * to (never `--outputs-dir`), so the CLI and the scaffold hooks always agree on the path.\n * A fresh workspace has no record, and a creative with none is not stale: there is no\n * preview of it in this workspace to be out of date.\n */\nexport const RENDER_STATE_DIR = \".rendered\";\n\nexport type RenderState = {\n  rendered?: { sourceSha: string; runId: string; at: number };\n  attempted?: { sourceSha: string; at: number };\n  /** The last portable run snapshot uploaded for this creative (see `run-snapshot.ts`). */\n  snapshot?: { identity: string; url: string };\n  /** A static ad's prompt.json as the completed render drew it: a later edit of only its words or colours renders as an edit of that version (`static-edit.ts`). */\n  prompt?: unknown;\n  /** The `--fix` (or edit) the completed render ran, and the blocking defects it left: the same fix is never run again. */\n  lastFix?: LastFix;\n  /** The blocking defects the review of the completed render named: what a fix of it is measured against. */\n  blocking?: string[];\n  /** How the completed render's picture came to be, where its canvas would not say (`static-fix.ts`). */\n  picture?: PictureRecord;\n  /**\n   * An ad of a series: the version of its lead its last registered run was made from, finished or not\n   * (`series-member.ts`). A run that fails after it is registered is not a new ask when retried.\n   */\n  seriesLeadRun?: string;\n};\n\nfunction statePath(canvasRoot: string, slug: string): string {\n  return path.join(canvasRoot, RENDER_STATE_DIR, `${slug}.json`);\n}\n\nexport async function readRenderState(canvasRoot: string, slug: string): Promise<RenderState> {\n  try {\n    const parsed = JSON.parse(await readFile(statePath(canvasRoot, slug), \"utf8\")) as RenderState;\n    return parsed && typeof parsed === \"object\" ? parsed : {};\n  } catch {\n    return {};\n  }\n}\n\n/** The version (run id) a creative shows in this workspace: its last completed render; null before one. */\nexport async function latestVersion(canvasRoot: string, slug: string): Promise<string | null> {\n  return (await readRenderState(canvasRoot, slug)).rendered?.runId ?? null;\n}\n\n/** Merge `patch` into the record. Best-effort: freshness is advisory, a render never fails over it. */\nasync function updateRenderState(canvasRoot: string, slug: string, patch: Partial<RenderState>): Promise<void> {\n  try {\n    const next = { ...(await readRenderState(canvasRoot, slug)), ...patch };\n    await mkdir(path.join(canvasRoot, RENDER_STATE_DIR), { recursive: true });\n    await writeFile(statePath(canvasRoot, slug), `${JSON.stringify(next, null, 2)}\\n`, \"utf8\");\n  } catch {\n    // Ignore: at worst the Stop hook asks for one render too many or too few.\n  }\n}\n\nexport async function recordRenderAttempt(canvasRoot: string, slug: string, sourceSha: string | undefined): Promise<void> {\n  if (!sourceSha) return;\n  await updateRenderState(canvasRoot, slug, { attempted: { sourceSha, at: Date.now() } });\n}\n\nexport async function recordRendered(\n  canvasRoot: string,\n  slug: string,\n  sourceSha: string | undefined,\n  runId: string,\n  drawn: { prompt?: unknown; lastFix?: LastFix; picture?: PictureRecord; seriesLeadRun?: string } = {},\n): Promise<void> {\n  if (!sourceSha) return;\n  await updateRenderState(canvasRoot, slug, {\n    rendered: { sourceSha, runId, at: Date.now() },\n    ...(drawn.prompt !== undefined ? { prompt: drawn.prompt } : {}),\n    lastFix: drawn.lastFix,\n    picture: drawn.picture,\n    ...(drawn.seriesLeadRun ? { seriesLeadRun: drawn.seriesLeadRun } : {}),\n  });\n}\n\n/** What the review of a completed render found blocking, and the fix the render ran, if one. */\nexport async function recordReviewOutcome(\n  canvasRoot: string,\n  slug: string,\n  outcome: { blocking: string[]; lastFix?: LastFix },\n): Promise<void> {\n  await updateRenderState(canvasRoot, slug, outcome);\n}\n\n/** The version of its lead a series ad's run was registered from: written before the run renders. */\nexport async function recordSeriesLeadRun(canvasRoot: string, slug: string, leadRunId: string): Promise<void> {\n  await updateRenderState(canvasRoot, slug, { seriesLeadRun: leadRunId });\n}\n\nexport async function recordSnapshot(canvasRoot: string, slug: string, snapshot: RenderState[\"snapshot\"]): Promise<void> {\n  await updateRenderState(canvasRoot, slug, { snapshot });\n}\n\n/**\n * Whether the preview in this workspace no longer shows the source: it was rendered, the\n * source has moved since (`isSourceStale`: a render fingerprinted by an older rule never\n * is), and no render of the source as it is now was attempted yet.\n */\nexport function isRenderStale(state: RenderState, currentSourceSha: string): boolean {\n  if (!state.rendered) return false;\n  if (!isSourceStale(currentSourceSha, state.rendered.sourceSha)) return false;\n  return state.attempted?.sourceSha !== currentSourceSha;\n}\n\n/** `sourceSha` is the source as it stands now: what a render of it would record. */\nexport type StaleCreative = { slug: string; canvasPath: string; renderedRunId: string; sourceSha: string };\n\n/**\n * Every renderable creative in the workspace whose preview is stale. A canvas that still\n * has an unfilled `[TODO]` asset slot is skipped: the agent is mid-build, and a half-built\n * creative must never be pushed to render. The source is fingerprinted the way a render\n * and the dashboard sync fingerprint it (`prepareCanvas`, read-only), so the three never\n * disagree about what is stale. `canvasPath` is workspace-relative.\n */\nexport async function staleCreatives(workspaceRoot: string): Promise<StaleCreative[]> {\n  const creativesDir = path.join(workspaceRoot, \"src\", \"creatives\");\n  const canvasRoot = path.join(workspaceRoot, \"canvas\");\n  let slugs: string[];\n  try {\n    slugs = (await readdir(creativesDir, { withFileTypes: true })).filter((d) => d.isDirectory()).map((d) => d.name);\n  } catch {\n    return [];\n  }\n  const stale: StaleCreative[] = [];\n  for (const slug of slugs.sort()) {\n    const state = await readRenderState(canvasRoot, slug);\n    if (!state.rendered) continue;\n    const canvasPath = path.join(creativesDir, slug, `${slug}.canvas.json`);\n    let prepared: PreparedCanvas;\n    try {\n      prepared = await prepareCanvas(canvasPath, { write: false });\n    } catch {\n      continue; // Gone, renamed, or mid-edit invalid JSON: the next check reads it again.\n    }\n    if (unsuppliedPlaceholderAssets(prepared.fileGraph).length > 0) continue;\n    const current = prepared.sourceSha;\n    if (!current || !isRenderStale(state, current)) continue;\n    stale.push({\n      slug,\n      canvasPath: path.relative(workspaceRoot, canvasPath).split(path.sep).join(\"/\"),\n      renderedRunId: state.rendered.runId,\n      sourceSha: current,\n    });\n  }\n  return stale;\n}\n\n/**\n * Remove the `canvas/.dirty/<slug>.json` marker an older scaffold's PostToolUse hook wrote.\n * Nothing in a current scaffold reads it, but a client repo can run this CLI before its\n * scaffold sync lands, and there the old Stop hook and verify gate still read the marker:\n * clearing it on a render attempt, as the CLI always did, keeps that gate from blocking\n * forever. Delete once every client runs a scaffold without `nudge-canvas-rerender`.\n */\nexport async function clearLegacyDirtyMarker(canvasRoot: string, slug: string): Promise<void> {\n  await rm(path.join(canvasRoot, \".dirty\", `${slug}.json`), { force: true }).catch(() => undefined);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-NFSLRRIE.js

@@ -0,0 +1,77 @@
+import {
+  classifyAudience
+} from "./chunk-5HYSKH77.js";
+
+// src/audience-names.ts
+var BUYERS_QUESTION = `\`name\` is the name an advertiser gave a custom audience in their Meta ad account, in any language. Is it made of people who have already bought from the brand: purchasers, paying customers, clients, a customer list? People who only visited, engaged, signed up, started a checkout or are leads or prospects have not bought. A lookalike of buyers is not buyers.`;
+var BUYERS_HELD = 0.42;
+var LOOKALIKE_QUESTION = `\`name\` is the name an advertiser gave a custom audience in their Meta ad account, in any language. Is it a lookalike audience: new people Meta finds because they resemble a seed audience (often named "Lookalike (GB, 1%)", "LAL 3%", "Similar to\u2026")?`;
+var LOOKALIKE_HELD = 0.4;
+async function readAudienceNames(names, ask) {
+  const distinct = [...new Set(names.map((n) => n.trim()).filter(Boolean))];
+  if (distinct.length === 0) return () => void 0;
+  const answers = await ask(
+    distinct.flatMap((name) => [
+      { instructions: { name, question: BUYERS_QUESTION } },
+      { instructions: { name, question: LOOKALIKE_QUESTION } }
+    ])
+  );
+  if (answers === null) return () => void 0;
+  const read = new Map(
+    distinct.map((name, i) => [
+      name,
+      { buyers: (answers[2 * i] ?? 0) >= BUYERS_HELD, lookalike: (answers[2 * i + 1] ?? 0) >= LOOKALIKE_HELD }
+    ])
+  );
+  return (name) => read.get(name.trim());
+}
+
+// src/commands/ads/meta/adset-viewers.ts
+function adSetViewerRows(adSets, audiences, campaigns, readName) {
+  const campaignById = new Map(campaigns.map((campaign) => [campaign.id, campaign]));
+  return adSets.map((adSet) => ({
+    id: adSet.id,
+    name: adSet.name,
+    campaign_id: adSet.campaign_id,
+    effective_status: adSet.effective_status,
+    viewer: classifyAudience(adSet, audiences, campaignById.get(adSet.campaign_id), readName)
+  }));
+}
+var VIEWER_TABLE_COLUMNS = [
+  "id",
+  "name",
+  "effective_status",
+  "temperature",
+  "knows",
+  "placements",
+  "why"
+];
+function flattenViewerRows(rows) {
+  return rows.map(({ viewer, ...row }) => ({
+    id: row.id,
+    name: row.name,
+    effective_status: row.effective_status,
+    temperature: viewer.temperature,
+    knows: viewer.knows.length > 0 ? viewer.knows.join(", ") : "nothing yet",
+    placements: viewer.placements.join(", "),
+    why: viewer.reasons.join(" ")
+  }));
+}
+function audienceNamesOf(adSets, audiences) {
+  const refs = adSets.flatMap((adSet) => {
+    const targeting = adSet.targeting ?? {};
+    return [targeting.custom_audiences, targeting.excluded_custom_audiences].flatMap(
+      (list) => Array.isArray(list) ? list.map((ref) => ref?.name) : []
+    );
+  });
+  return [...refs, ...audiences.map((a) => a.name)].filter((n) => typeof n === "string" && n.length > 0);
+}
+
+export {
+  readAudienceNames,
+  adSetViewerRows,
+  VIEWER_TABLE_COLUMNS,
+  flattenViewerRows,
+  audienceNamesOf
+};
+//# sourceMappingURL=chunk-NFSLRRIE.js.map

package/dist/chunk-NFSLRRIE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/audience-names.ts","../src/commands/ads/meta/adset-viewers.ts"],"sourcesContent":["/**\n * What a Meta custom audience's name says its members are, read by the decision model (Jev) in\n * the advertiser's own language: buyers (\"Compradores 180d\", \"Kunden-Liste\", \"購入者\"), or a\n * lookalike of a seed. It replaced a regex of the words for \"buyer\" in five languages, which read\n * \"Clientes potenciales\" (leads) as buyers and missed every other language. Thresholds were\n * measured on scripts/audience-names-evals (docs/decision-model.md).\n */\nimport type { AskNouls } from \"./engine/lib/remembered-nouls.ts\";\nimport type { AudienceNameReading } from \"./viewer-profile.ts\";\n\nexport const BUYERS_QUESTION = `\\`name\\` is the name an advertiser gave a custom audience in their Meta ad account, in any language. Is it made of people who have already bought from the brand: purchasers, paying customers, clients, a customer list? People who only visited, engaged, signed up, started a checkout or are leads or prospects have not bought. A lookalike of buyers is not buyers.`;\nconst BUYERS_HELD = 0.42;\n\nexport const LOOKALIKE_QUESTION = `\\`name\\` is the name an advertiser gave a custom audience in their Meta ad account, in any language. Is it a lookalike audience: new people Meta finds because they resemble a seed audience (often named \"Lookalike (GB, 1%)\", \"LAL 3%\", \"Similar to…\")?`;\nconst LOOKALIKE_HELD = 0.4;\n\n/** Each name's reading, in one request; undefined for every name when the model could not answer. */\nexport async function readAudienceNames(names: readonly string[], ask: AskNouls): Promise<AudienceNameReading> {\n  const distinct = [...new Set(names.map((n) => n.trim()).filter(Boolean))];\n  if (distinct.length === 0) return () => undefined;\n  const answers = await ask(\n    distinct.flatMap((name) => [\n      { instructions: { name, question: BUYERS_QUESTION } },\n      { instructions: { name, question: LOOKALIKE_QUESTION } },\n    ]),\n  );\n  if (answers === null) return () => undefined;\n  const read = new Map(\n    distinct.map((name, i) => [\n      name,\n      { buyers: (answers[2 * i] ?? 0) >= BUYERS_HELD, lookalike: (answers[2 * i + 1] ?? 0) >= LOOKALIKE_HELD },\n    ]),\n  );\n  return (name) => read.get(name.trim());\n}\n","import {\n  type AudienceNameReading,\n  type CustomAudienceInput,\n  classifyAudience,\n  type ViewerProfile,\n} from \"../../../viewer-profile.ts\";\n\ntype MetaRow = Record<string, unknown>;\n\nexport interface AdSetViewerRow {\n  id: unknown;\n  name: unknown;\n  campaign_id: unknown;\n  effective_status: unknown;\n  viewer: ViewerProfile;\n}\n\n/**\n * `baker ads meta adsets --audience`: who each ad set reaches, read off its own\n * targeting, the account's audience list (for each audience's subtype) and its\n * campaign's objective, and what each audience's name says its members are\n * (`readAudienceNames`; read by subtype alone without it). The row keeps only\n * what names the ad set, so the viewer is the one thing it adds.\n */\nexport function adSetViewerRows(\n  adSets: readonly MetaRow[],\n  audiences: readonly CustomAudienceInput[],\n  campaigns: readonly MetaRow[],\n  readName?: AudienceNameReading,\n): AdSetViewerRow[] {\n  const campaignById = new Map(campaigns.map((campaign) => [campaign.id, campaign]));\n  return adSets.map((adSet) => ({\n    id: adSet.id,\n    name: adSet.name,\n    campaign_id: adSet.campaign_id,\n    effective_status: adSet.effective_status,\n    viewer: classifyAudience(adSet, audiences, campaignById.get(adSet.campaign_id), readName),\n  }));\n}\n\nexport const VIEWER_TABLE_COLUMNS = [\n  \"id\",\n  \"name\",\n  \"effective_status\",\n  \"temperature\",\n  \"knows\",\n  \"placements\",\n  \"why\",\n] as const;\n\n/** The table and csv writers print one scalar per cell, so the viewer is spelled out column by column. */\nexport function flattenViewerRows(rows: readonly AdSetViewerRow[]): Array<Record<string, unknown>> {\n  return rows.map(({ viewer, ...row }) => ({\n    id: row.id,\n    name: row.name,\n    effective_status: row.effective_status,\n    temperature: viewer.temperature,\n    knows: viewer.knows.length > 0 ? viewer.knows.join(\", \") : \"nothing yet\",\n    placements: viewer.placements.join(\", \"),\n    why: viewer.reasons.join(\" \"),\n  }));\n}\n\n/** Every audience name an ad set includes or excludes, and every name in the account's list. Pure. */\nexport function audienceNamesOf(adSets: readonly MetaRow[], audiences: readonly CustomAudienceInput[]): string[] {\n  const refs = adSets.flatMap((adSet) => {\n    const targeting = (adSet.targeting ?? {}) as Record<string, unknown>;\n    return [targeting.custom_audiences, targeting.excluded_custom_audiences].flatMap((list) =>\n      Array.isArray(list) ? list.map((ref) => (ref as { name?: unknown })?.name) : [],\n    );\n  });\n  return [...refs, ...audiences.map((a) => a.name)].filter((n): n is string => typeof n === \"string\" && n.length > 0);\n}\n"],"mappings":";;;;;AAUO,IAAM,kBAAkB;AAC/B,IAAM,cAAc;AAEb,IAAM,qBAAqB;AAClC,IAAM,iBAAiB;AAGvB,eAAsB,kBAAkB,OAA0B,KAA6C;AAC7G,QAAM,WAAW,CAAC,GAAG,IAAI,IAAI,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC;AACxE,MAAI,SAAS,WAAW,EAAG,QAAO,MAAM;AACxC,QAAM,UAAU,MAAM;AAAA,IACpB,SAAS,QAAQ,CAAC,SAAS;AAAA,MACzB,EAAE,cAAc,EAAE,MAAM,UAAU,gBAAgB,EAAE;AAAA,MACpD,EAAE,cAAc,EAAE,MAAM,UAAU,mBAAmB,EAAE;AAAA,IACzD,CAAC;AAAA,EACH;AACA,MAAI,YAAY,KAAM,QAAO,MAAM;AACnC,QAAM,OAAO,IAAI;AAAA,IACf,SAAS,IAAI,CAAC,MAAM,MAAM;AAAA,MACxB;AAAA,MACA,EAAE,SAAS,QAAQ,IAAI,CAAC,KAAK,MAAM,aAAa,YAAY,QAAQ,IAAI,IAAI,CAAC,KAAK,MAAM,eAAe;AAAA,IACzG,CAAC;AAAA,EACH;AACA,SAAO,CAAC,SAAS,KAAK,IAAI,KAAK,KAAK,CAAC;AACvC;;;ACVO,SAAS,gBACd,QACA,WACA,WACA,UACkB;AAClB,QAAM,eAAe,IAAI,IAAI,UAAU,IAAI,CAAC,aAAa,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC;AACjF,SAAO,OAAO,IAAI,CAAC,WAAW;AAAA,IAC5B,IAAI,MAAM;AAAA,IACV,MAAM,MAAM;AAAA,IACZ,aAAa,MAAM;AAAA,IACnB,kBAAkB,MAAM;AAAA,IACxB,QAAQ,iBAAiB,OAAO,WAAW,aAAa,IAAI,MAAM,WAAW,GAAG,QAAQ;AAAA,EAC1F,EAAE;AACJ;AAEO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,kBAAkB,MAAiE;AACjG,SAAO,KAAK,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,OAAO;AAAA,IACvC,IAAI,IAAI;AAAA,IACR,MAAM,IAAI;AAAA,IACV,kBAAkB,IAAI;AAAA,IACtB,aAAa,OAAO;AAAA,IACpB,OAAO,OAAO,MAAM,SAAS,IAAI,OAAO,MAAM,KAAK,IAAI,IAAI;AAAA,IAC3D,YAAY,OAAO,WAAW,KAAK,IAAI;AAAA,IACvC,KAAK,OAAO,QAAQ,KAAK,GAAG;AAAA,EAC9B,EAAE;AACJ;AAGO,SAAS,gBAAgB,QAA4B,WAAqD;AAC/G,QAAM,OAAO,OAAO,QAAQ,CAAC,UAAU;AACrC,UAAM,YAAa,MAAM,aAAa,CAAC;AACvC,WAAO,CAAC,UAAU,kBAAkB,UAAU,yBAAyB,EAAE;AAAA,MAAQ,CAAC,SAChF,MAAM,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,QAAS,KAA4B,IAAI,IAAI,CAAC;AAAA,IAChF;AAAA,EACF,CAAC;AACD,SAAO,CAAC,GAAG,MAAM,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,MAAmB,OAAO,MAAM,YAAY,EAAE,SAAS,CAAC;AACpH;","names":[]}

package/dist/chunk-NHU33T2S.js

@@ -0,0 +1,60 @@
+import {
+  REF_PREFIX
+} from "./chunk-66USKCVY.js";
+
+// src/commands/canvas/node-preview.ts
+var MAX_PARAMS_PREVIEW_LENGTH = 4e3;
+var SPEC_KEYS = [
+  "model",
+  "aspect_ratio",
+  "image_size",
+  "resolution",
+  "duration",
+  "subject_type",
+  "font_size",
+  "expect",
+  "source",
+  "path",
+  "url"
+];
+var BODY_KEYS = ["prompt", "text", "subject_description"];
+function scalarField(params, key) {
+  const value = params[key];
+  if (typeof value === "number") return String(value);
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed && !trimmed.startsWith(REF_PREFIX) ? trimmed : void 0;
+}
+function compactJson(params) {
+  try {
+    const json = JSON.stringify(params);
+    return json && json !== "{}" ? json : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function cap(text) {
+  return text.length > MAX_PARAMS_PREVIEW_LENGTH ? `${text.slice(0, MAX_PARAMS_PREVIEW_LENGTH - 1)}\u2026` : text;
+}
+function nodeParamsPreview(params, deps) {
+  const refsLine = deps && deps.length > 0 ? `refs: ${deps.join(", ")}` : void 0;
+  if (!params || typeof params !== "object") return refsLine;
+  const record = params;
+  const spec = [];
+  for (const key of SPEC_KEYS) {
+    const value = scalarField(record, key);
+    if (value !== void 0) spec.push(`${key}: ${value}`);
+  }
+  if (refsLine) spec.push(refsLine);
+  const body = BODY_KEYS.map((key) => scalarField(record, key)).find(Boolean);
+  const header = spec.join("\n");
+  const composed = header && body ? `${header}
+
+${body}` : header || body || compactJson(record);
+  return composed ? cap(composed) : void 0;
+}
+
+export {
+  nodeParamsPreview
+};
+//# sourceMappingURL=chunk-NHU33T2S.js.map

package/dist/chunk-NHU33T2S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/node-preview.ts"],"sourcesContent":["import { REF_PREFIX } from \"../../engine/schema/canvas.ts\";\n\n// Mirrors the backend's runNodeSchema / definitionGraph paramsPreview cap — an\n// over-long preview would 400 the whole record.\nconst MAX_PARAMS_PREVIEW_LENGTH = 4000;\n\n// Scalar params worth showing as their own labeled line in a node's detail — the\n// \"what settings produced this\" a reviewer asks for: the model, the aspect ratio,\n// the image size, an ingest's expected format and where it pulls from. Ordered\n// most-identifying first so the graph card's 2-line clamp surfaces the model/format\n// and the inspector shows the full set.\nconst SPEC_KEYS = [\n  \"model\",\n  \"aspect_ratio\",\n  \"image_size\",\n  \"resolution\",\n  \"duration\",\n  \"subject_type\",\n  \"font_size\",\n  \"expect\",\n  \"source\",\n  \"path\",\n  \"url\",\n] as const;\n\n// The longer free-text a node is recognized by, shown as the body under the spec\n// lines (a generator's prompt, a specimen's copy, a sheet's subject brief).\nconst BODY_KEYS = [\"prompt\", \"text\", \"subject_description\"] as const;\n\n/** A trimmed string or a number as text — never a `$ref:` wiring string (the deps line carries those). */\nfunction scalarField(params: Record<string, unknown>, key: string): string | undefined {\n  const value = params[key];\n  if (typeof value === \"number\") return String(value);\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed && !trimmed.startsWith(REF_PREFIX) ? trimmed : undefined;\n}\n\nfunction compactJson(params: unknown): string | undefined {\n  try {\n    const json = JSON.stringify(params);\n    return json && json !== \"{}\" ? json : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction cap(text: string): string {\n  return text.length > MAX_PARAMS_PREVIEW_LENGTH ? `${text.slice(0, MAX_PARAMS_PREVIEW_LENGTH - 1)}…` : text;\n}\n\n/**\n * A structured, multi-line excerpt of a node's params for the graph card and its\n * inspector: labeled spec lines (model / aspect_ratio / image_size / expect / …),\n * a `refs:` line naming the upstream nodes it consumes (the \"props\" wired into a\n * generate, taken from the resolved `$ref` deps), then the free-text body (prompt,\n * specimen copy, subject brief). This is what surfaces \"the model, the aspect ratio,\n * the size, everything\" in the dashboard instead of just a bare prompt line. Falls\n * back to compact JSON for a node with no recognized field, or just the `refs:` line\n * when params are absent but deps exist.\n */\nexport function nodeParamsPreview(params: unknown, deps?: readonly string[]): string | undefined {\n  const refsLine = deps && deps.length > 0 ? `refs: ${deps.join(\", \")}` : undefined;\n  if (!params || typeof params !== \"object\") return refsLine;\n\n  const record = params as Record<string, unknown>;\n  const spec: string[] = [];\n  for (const key of SPEC_KEYS) {\n    const value = scalarField(record, key);\n    if (value !== undefined) spec.push(`${key}: ${value}`);\n  }\n  if (refsLine) spec.push(refsLine);\n\n  const body = BODY_KEYS.map((key) => scalarField(record, key)).find(Boolean);\n  const header = spec.join(\"\\n\");\n  const composed = header && body ? `${header}\\n\\n${body}` : header || body || compactJson(record);\n  return composed ? cap(composed) : undefined;\n}\n"],"mappings":";;;;;AAIA,IAAM,4BAA4B;AAOlC,IAAM,YAAY;AAAA,EAChB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIA,IAAM,YAAY,CAAC,UAAU,QAAQ,qBAAqB;AAG1D,SAAS,YAAY,QAAiC,KAAiC;AACrF,QAAM,QAAQ,OAAO,GAAG;AACxB,MAAI,OAAO,UAAU,SAAU,QAAO,OAAO,KAAK;AAClD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,WAAW,CAAC,QAAQ,WAAW,UAAU,IAAI,UAAU;AAChE;AAEA,SAAS,YAAY,QAAqC;AACxD,MAAI;AACF,UAAM,OAAO,KAAK,UAAU,MAAM;AAClC,WAAO,QAAQ,SAAS,OAAO,OAAO;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,IAAI,MAAsB;AACjC,SAAO,KAAK,SAAS,4BAA4B,GAAG,KAAK,MAAM,GAAG,4BAA4B,CAAC,CAAC,WAAM;AACxG;AAYO,SAAS,kBAAkB,QAAiB,MAA8C;AAC/F,QAAM,WAAW,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,KAAK,IAAI,CAAC,KAAK;AACxE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAElD,QAAM,SAAS;AACf,QAAM,OAAiB,CAAC;AACxB,aAAW,OAAO,WAAW;AAC3B,UAAM,QAAQ,YAAY,QAAQ,GAAG;AACrC,QAAI,UAAU,OAAW,MAAK,KAAK,GAAG,GAAG,KAAK,KAAK,EAAE;AAAA,EACvD;AACA,MAAI,SAAU,MAAK,KAAK,QAAQ;AAEhC,QAAM,OAAO,UAAU,IAAI,CAAC,QAAQ,YAAY,QAAQ,GAAG,CAAC,EAAE,KAAK,OAAO;AAC1E,QAAM,SAAS,KAAK,KAAK,IAAI;AAC7B,QAAM,WAAW,UAAU,OAAO,GAAG,MAAM;AAAA;AAAA,EAAO,IAAI,KAAK,UAAU,QAAQ,YAAY,MAAM;AAC/F,SAAO,WAAW,IAAI,QAAQ,IAAI;AACpC;","names":[]}