@koda-sl/baker-cli 0.554.0 → 0.556.0

package/dist/chunk-EENYLJUN.js

@@ -0,0 +1,225 @@
+import {
+  metaDraftOpInputSchema
+} from "./chunk-GC5P4KWY.js";
+import {
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-QY7EK6Q4.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  adCopyHints,
+  booleanWordPositionalError,
+  payloadFix
+} from "./chunk-CDTAKCJR.js";
+import {
+  withHints
+} from "./chunk-D5FY4FAK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-QYH2UZAK.js";
+import {
+  describeOpPayload
+} from "./chunk-R7XDGNZD.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import {
+  requireChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  payloadArg
+} from "./chunk-CCYZJMZ7.js";
+
+// src/commands/ads/meta/write-shared.ts
+import { readFileSync } from "fs";
+function fileArg(kind, description) {
+  return {
+    file: payloadArg(
+      {
+        type: "string",
+        description: `${description} \u2014 run \`baker schema\` on this command for every field the payload takes`
+      },
+      () => describeOpPayload(metaDraftOpInputSchema, kind)
+    )
+  };
+}
+async function bareAccountId(args) {
+  return (await resolveAccountIdArg(args)).replace(/^act_/, "");
+}
+function failWriteValidation(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function refuseDeleteByUpdate(payload, group) {
+  if (payload.status === "DELETED") {
+    failWriteValidation(
+      `update does not delete \u2014 deleting is permanent. Use \`baker ads meta ${group} delete <id>\` if the user asked to delete; otherwise pause or archive.`
+    );
+  }
+}
+function loadJsonFileArg(path) {
+  if (typeof path !== "string" || path.length === 0) {
+    return {};
+  }
+  const inline = /^\s*\{/.test(path);
+  const source = inline ? "inline JSON" : path;
+  try {
+    const parsed = JSON.parse(inline ? path : readFileSync(path, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failWriteValidation(`${source} must contain a JSON object`);
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      failWriteValidation(`${source} is not valid JSON: ${err.message}`);
+    }
+    throw err;
+  }
+}
+function mergePayload(file, flags) {
+  const merged = { ...file };
+  for (const [key, value] of Object.entries(flags)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
+  }
+  return merged;
+}
+function parseMoneyFlag(amount, currency, flag) {
+  if (amount === void 0 || amount === null || amount === "") {
+    return void 0;
+  }
+  if (currency === void 0 || currency === null || currency === "") {
+    return { amount: String(amount) };
+  }
+  if (typeof currency !== "string" || currency.length !== 3) {
+    failWriteValidation(`${flag} got an invalid --currency (expected a 3-letter code like USD)`);
+  }
+  return { amount: String(amount), currencyCode: currency.toUpperCase() };
+}
+function parseDateFlag(value, flag) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const raw = String(value);
+  if (/^\d{10,}$/.test(raw)) {
+    return Number(raw);
+  }
+  const parsed = Date.parse(raw);
+  if (Number.isNaN(parsed)) {
+    failWriteValidation(`${flag} must be an ISO date (2026-07-10) or epoch milliseconds`);
+  }
+  return parsed;
+}
+function listFlag(value) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    return void 0;
+  }
+  const items = value.split(",").map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+function repeatedListFlag(rawArgs, flag, parsed) {
+  const items = repeatedValues(rawArgs, flag, parsed).flatMap((value) => value.split(",")).map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+function upper(value) {
+  return typeof value === "string" && value.length > 0 ? value.toUpperCase() : void 0;
+}
+function numberFlag(value, flag) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const n = Number(value);
+  if (!Number.isFinite(n)) {
+    failWriteValidation(`${flag} must be a number`);
+  }
+  return n;
+}
+function requireTarget(args, entity) {
+  const inverted = booleanWordPositionalError(args, entity);
+  if (inverted !== void 0) {
+    failWriteValidation(inverted);
+  }
+  const positional = Array.isArray(args._) ? args._[0] : void 0;
+  const target = args.id ?? args.target ?? args.ref ?? positional;
+  if (typeof target !== "string" || target.length === 0) {
+    failWriteValidation(`pass the ${entity} id as the positional argument`);
+  }
+  return target;
+}
+function preflightOp(raw) {
+  const preflight = metaDraftOpInputSchema.safeParse(raw);
+  if (!preflight.success) {
+    const fields = preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message }));
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; "),
+        fields,
+        fix: payloadFix("meta-ads", metaDraftOpInputSchema, raw)
+      }
+    });
+    process.exit(1);
+  }
+  return preflight.data;
+}
+async function stageOp(raw, extraHints = []) {
+  const op = preflightOp(raw);
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/meta/draft/stage", { chatId, op });
+    const copyHints = await adCopyHints(op);
+    writeJsonEnvelope(withHints(response, [...copyHints, ...extraHints]));
+  } catch (err) {
+    handleMetaError(err);
+  }
+}
+async function stageOps(raws) {
+  const ops = raws.map(preflightOp);
+  const chatId = requireChatId();
+  const staged = [];
+  for (const op of ops) {
+    try {
+      const response = await apiPost("/api/ads/meta/draft/stage", { chatId, op });
+      staged.push(response.data);
+    } catch (err) {
+      if (staged.length > 0) {
+        process.stderr.write(`staged before the refusal: ${staged.map((entry) => entry.ref).join(", ")}
+`);
+      }
+      handleMetaError(err);
+    }
+  }
+  writeJsonEnvelope({ ok: true, data: staged });
+}
+async function stageStatusChange(input) {
+  await stageOp({
+    kind: input.kind,
+    accountId: input.accountId,
+    target: input.target,
+    payload: { status: input.status }
+  });
+}
+
+export {
+  fileArg,
+  bareAccountId,
+  failWriteValidation,
+  refuseDeleteByUpdate,
+  loadJsonFileArg,
+  mergePayload,
+  parseMoneyFlag,
+  parseDateFlag,
+  listFlag,
+  repeatedListFlag,
+  upper,
+  numberFlag,
+  requireTarget,
+  stageOp,
+  stageOps,
+  stageStatusChange
+};
+//# sourceMappingURL=chunk-EENYLJUN.js.map

package/dist/chunk-EGVWSAWY.js

@@ -0,0 +1,83 @@
+import {
+  launchBrowser
+} from "./chunk-VN3WDB4O.js";
+
+// src/commands/ads/ad-preview-images.ts
+import { mkdirSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+var AD_PREVIEW_DIR = join(tmpdir(), "baker-ad-previews");
+async function renderAdPreviews(inputs, target, draw = drawPreviewInChromium) {
+  mkdirSync(target.dir, { recursive: true });
+  const previews = [];
+  const taken = /* @__PURE__ */ new Map();
+  for (const input of inputs) {
+    const where = input.surface ? { placement: input.placement, surface: input.surface } : { placement: input.placement };
+    const base = [target.name, input.placement, input.surface?.toLowerCase()].filter(Boolean).join("-");
+    const seen = (taken.get(base) ?? 0) + 1;
+    taken.set(base, seen);
+    const file = join(target.dir, `${seen > 1 ? `${base}-${seen}` : base}.png`);
+    try {
+      const { text } = await draw(input.html, file);
+      previews.push({ ...where, shownText: shownLines(text), image: file });
+    } catch (err) {
+      previews.push({ ...where, error: err instanceof Error ? err.message : String(err) });
+    }
+  }
+  return { previews, hints: previewHints(previews) };
+}
+function shownLines(text) {
+  return text.split("\n").map((line) => line.replace(/\s+/g, " ").trim()).filter(Boolean);
+}
+function previewHints(previews) {
+  const hints = [];
+  if (previews.some((p) => "image" in p)) {
+    hints.push(
+      "shownText is what people see on the ad, in order \u2014 rendered by the platform itself, so it settles which text is displayed (headline under the image, button, cut-off intro). The API fields only say what is stored. Words drawn into the artwork are not in shownText: Read the image for those, and for cropping or how the ad looks."
+    );
+  }
+  if (previews.some((p) => "error" in p)) {
+    hints.push(
+      "Some previews could not be drawn. Do not describe how those look \u2014 say they could not be checked, and carry on with the rest."
+    );
+  }
+  return hints;
+}
+async function drawPreviewInChromium(html, file) {
+  const browser = await launchBrowser();
+  try {
+    const context = await browser.newContext({ viewport: { width: 900, height: 1200 }, deviceScaleFactor: 2 });
+    const page = await context.newPage();
+    await page.setContent(`<!doctype html><body style="margin:0;background:#fff">${html}</body>`, {
+      waitUntil: "load",
+      timeout: 3e4
+    });
+    await page.waitForLoadState("networkidle", { timeout: 15e3 }).catch(() => void 0);
+    const iframe = await page.$("iframe");
+    if (!iframe) throw new Error("the platform returned no preview frame");
+    const frame = await iframe.contentFrame();
+    if (frame) {
+      const height = await frame.evaluate(
+        () => Math.max(document.documentElement.scrollHeight, document.body?.scrollHeight ?? 0)
+      );
+      if (height > 0) {
+        await iframe.evaluate((node, h) => {
+          node.removeAttribute("height");
+          node.style.height = `${h}px`;
+        }, height);
+        await frame.waitForLoadState("networkidle", { timeout: 1e4 }).catch(() => void 0);
+      }
+    }
+    await iframe.screenshot({ path: file });
+    const text = frame ? await frame.evaluate(() => document.body?.innerText ?? "") : "";
+    return { text };
+  } finally {
+    await browser.close();
+  }
+}
+
+export {
+  AD_PREVIEW_DIR,
+  renderAdPreviews
+};
+//# sourceMappingURL=chunk-EGVWSAWY.js.map

package/dist/chunk-EGVWSAWY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/ad-preview-images.ts"],"sourcesContent":["import { mkdirSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { launchBrowser } from \"../../engine/landing-library/browser.ts\";\n\n/**\n * Opens a platform's preview iframe and returns what it displays: the text\n * people read (`shownText`) and a picture for questions text cannot answer.\n *\n * The API's fields say what is stored, not what shows. A Session paused seven\n * live ads because a stored headline read like an internal code, with no way to\n * check whether the feed showed it. The rendered text settles that; the picture\n * covers what is not text — words drawn into the artwork, cropping, layout.\n */\n\nexport interface AdPreviewInput {\n  placement: string;\n  /** Where the platform shows it (LinkedIn FEED, …) when one placement renders on several surfaces. */\n  surface?: string;\n  html: string;\n}\n\ntype AdPreviewWhere = { placement: string; surface?: string };\nexport type AdPreviewResult =\n  | (AdPreviewWhere & { shownText: string[]; image: string })\n  | (AdPreviewWhere & { error: string });\n\n/** Render `html` (a platform iframe): save a PNG at `file`, return the text it displays. */\nexport type DrawPreview = (html: string, file: string) => Promise<{ text: string }>;\n\nexport const AD_PREVIEW_DIR = join(tmpdir(), \"baker-ad-previews\");\n\nexport async function renderAdPreviews(\n  inputs: readonly AdPreviewInput[],\n  target: { dir: string; name: string },\n  draw: DrawPreview = drawPreviewInChromium,\n): Promise<{ previews: AdPreviewResult[]; hints: string[] }> {\n  mkdirSync(target.dir, { recursive: true });\n  const previews: AdPreviewResult[] = [];\n  const taken = new Map<string, number>();\n  for (const input of inputs) {\n    const where: AdPreviewWhere = input.surface\n      ? { placement: input.placement, surface: input.surface }\n      : { placement: input.placement };\n    // One file per rendering: a shared name would leave two results pointing at the last picture drawn.\n    const base = [target.name, input.placement, input.surface?.toLowerCase()].filter(Boolean).join(\"-\");\n    const seen = (taken.get(base) ?? 0) + 1;\n    taken.set(base, seen);\n    const file = join(target.dir, `${seen > 1 ? `${base}-${seen}` : base}.png`);\n    try {\n      const { text } = await draw(input.html, file);\n      previews.push({ ...where, shownText: shownLines(text), image: file });\n    } catch (err) {\n      previews.push({ ...where, error: err instanceof Error ? err.message : String(err) });\n    }\n  }\n  return { previews, hints: previewHints(previews) };\n}\n\nfunction shownLines(text: string): string[] {\n  return text\n    .split(\"\\n\")\n    .map((line) => line.replace(/\\s+/g, \" \").trim())\n    .filter(Boolean);\n}\n\nfunction previewHints(previews: readonly AdPreviewResult[]): string[] {\n  const hints: string[] = [];\n  if (previews.some((p) => \"image\" in p)) {\n    hints.push(\n      \"shownText is what people see on the ad, in order — rendered by the platform itself, so it settles which text is displayed (headline under the image, button, cut-off intro). The API fields only say what is stored. Words drawn into the artwork are not in shownText: Read the image for those, and for cropping or how the ad looks.\",\n    );\n  }\n  if (previews.some((p) => \"error\" in p)) {\n    hints.push(\n      \"Some previews could not be drawn. Do not describe how those look — say they could not be checked, and carry on with the rest.\",\n    );\n  }\n  return hints;\n}\n\n/**\n * The platforms' iframes have a fixed window (Meta's 335×450) and scroll the rest,\n * which cuts the headline and button off a picture. The frame is grown to its\n * content's height first, so the picture holds the whole ad.\n */\nexport async function drawPreviewInChromium(html: string, file: string): Promise<{ text: string }> {\n  const browser = await launchBrowser();\n  try {\n    const context = await browser.newContext({ viewport: { width: 900, height: 1200 }, deviceScaleFactor: 2 });\n    const page = await context.newPage();\n    await page.setContent(`<!doctype html><body style=\"margin:0;background:#fff\">${html}</body>`, {\n      waitUntil: \"load\",\n      timeout: 30_000,\n    });\n    await page.waitForLoadState(\"networkidle\", { timeout: 15_000 }).catch(() => undefined);\n    const iframe = await page.$(\"iframe\");\n    if (!iframe) throw new Error(\"the platform returned no preview frame\");\n    const frame = await iframe.contentFrame();\n    if (frame) {\n      const height = await frame.evaluate(() =>\n        Math.max(document.documentElement.scrollHeight, document.body?.scrollHeight ?? 0),\n      );\n      if (height > 0) {\n        await iframe.evaluate((node, h) => {\n          node.removeAttribute(\"height\");\n          (node as HTMLElement).style.height = `${h}px`;\n        }, height);\n        await frame.waitForLoadState(\"networkidle\", { timeout: 10_000 }).catch(() => undefined);\n      }\n    }\n    await iframe.screenshot({ path: file });\n    // innerText follows the layout: hidden elements drop out, line breaks stay.\n    const text = frame ? await frame.evaluate(() => document.body?.innerText ?? \"\") : \"\";\n    return { text };\n  } finally {\n    await browser.close();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-EJBLF2LI.js

@@ -0,0 +1,167 @@
+import {
+  parseRefExpr
+} from "./chunk-X3GWGFZP.js";
+import {
+  collectAssetRefLikes,
+  isPersistedAssetRef
+} from "./chunk-EL3TDR5S.js";
+
+// src/commands/canvas/run-record.ts
+import path from "path";
+var MAX_RUN_NODES = 200;
+var MAX_OUTPUTS_PER_NODE = 10;
+var MAX_FINAL_OUTPUTS = 10;
+var MAX_NODE_FACTS_CHARS = 4096;
+var MAX_CREATIVE_SLUG_LENGTH = 100;
+function creativeSlugFromCanvasPath(filePath) {
+  const normalized = filePath.split(path.sep).join("/");
+  const match = normalized.match(/(?:^|\/)src\/creatives\/([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)\//);
+  const slug = match?.[1] ?? null;
+  return slug && slug.length <= MAX_CREATIVE_SLUG_LENGTH ? slug : null;
+}
+function finalOutputLabelsFromCanvas(parsed) {
+  const canvas = parsed;
+  const outputNodeId = canvas?.output?.node;
+  if (typeof outputNodeId !== "string" || !Array.isArray(canvas?.nodes)) return null;
+  const node = canvas.nodes.find((n) => n?.id === outputNodeId);
+  if (node?.type !== "collect") return null;
+  const explicit = node.params?.labels;
+  if (Array.isArray(explicit) && explicit.every((l) => typeof l === "string")) {
+    return { nodeId: outputNodeId, labels: explicit };
+  }
+  const images = node.inputs?.images;
+  if (!Array.isArray(images)) return null;
+  const labels = images.map((entry) => {
+    if (typeof entry !== "string") return void 0;
+    return parseRefExpr(entry)?.nodeId;
+  });
+  return { nodeId: outputNodeId, labels };
+}
+var OUTPUT_KINDS = /* @__PURE__ */ new Set(["image", "video", "audio", "json", "text", "font"]);
+function toRecordOutput(slot, value, label) {
+  const refs = collectAssetRefLikes(value);
+  const ref = refs.length === 1 ? refs[0] : null;
+  if (!ref || !isPersistedAssetRef(ref)) return null;
+  const kind = typeof ref.kind === "string" && OUTPUT_KINDS.has(ref.kind) ? ref.kind : null;
+  if (!kind) return null;
+  return {
+    slot,
+    label,
+    kind,
+    sha256: ref.sha256,
+    url: ref.url,
+    mime: ref.mime,
+    width: typeof ref.width === "number" ? ref.width : void 0,
+    height: typeof ref.height === "number" ? ref.height : void 0,
+    durationMs: typeof ref.duration_ms === "number" ? ref.duration_ms : void 0
+  };
+}
+function nodeOutputsToRecord(nodeOutputs, labels) {
+  const out = [];
+  for (const [slot, value] of Object.entries(nodeOutputs)) {
+    if (Array.isArray(value)) {
+      value.forEach((item, i) => {
+        const rec = toRecordOutput(`${slot}#${i}`, item, labels?.[i]);
+        if (rec) out.push(rec);
+      });
+    } else {
+      const rec = toRecordOutput(slot, value);
+      if (rec) out.push(rec);
+    }
+  }
+  return out.slice(0, MAX_OUTPUTS_PER_NODE);
+}
+function finalOutputsToRecord(output, labels) {
+  if (Array.isArray(output)) {
+    return output.map((item, i) => toRecordOutput(`final#${i}`, item, labels?.[i])).filter((rec2) => rec2 !== null).slice(0, MAX_FINAL_OUTPUTS);
+  }
+  const rec = toRecordOutput("final", output);
+  return rec ? [rec] : [];
+}
+function finalFiles(output, labels) {
+  const items = Array.isArray(output) ? output : [output];
+  const files = {};
+  items.forEach((item, i) => {
+    const ref = collectAssetRefLikes(item)[0];
+    if (ref && typeof ref.path === "string") files[labels?.[i] ?? `final#${i}`] = ref.path;
+  });
+  return files;
+}
+function withFacts(nodeOutputs) {
+  const facts = nodeOutputs.facts;
+  if (facts === void 0 || facts === null) return {};
+  const json = JSON.stringify(facts);
+  return json.length <= MAX_NODE_FACTS_CHARS ? { facts: json } : {};
+}
+function buildRunRecord(result, meta, plan, finalLabels) {
+  const nodes = result.node_runs.slice(0, MAX_RUN_NODES).map((run) => {
+    const planned = plan?.get(run.node_id);
+    return {
+      nodeId: run.node_id,
+      nodeType: run.node_type,
+      cached: run.cached,
+      credits: run.credits,
+      durationMs: run.duration_ms,
+      outputs: nodeOutputsToRecord(
+        result.outputs_by_node[run.node_id] ?? {},
+        run.node_id === finalLabels?.nodeId ? finalLabels.labels : void 0
+      ),
+      deps: planned?.deps,
+      status: plan ? "completed" : void 0,
+      paramsPreview: planned?.paramsPreview,
+      ...planned?.role !== void 0 ? { role: planned.role } : {},
+      ...withFacts(result.outputs_by_node[run.node_id] ?? {})
+    };
+  });
+  const finalOutputs = finalOutputsToRecord(result.output, finalLabels?.labels);
+  return {
+    runId: result.run_id,
+    ...meta,
+    status: "completed",
+    stats: {
+      totalNodes: result.stats.total_nodes,
+      cachedNodes: result.stats.cached_nodes,
+      totalCredits: result.stats.total_credits,
+      durationMs: result.stats.duration_ms
+    },
+    nodes,
+    finalOutputs: finalOutputs.length > 0 ? finalOutputs : void 0,
+    // Sent whenever the review RAN, empty list included. Sending it only when there
+    // were findings makes a clean render and an unreviewed one look identical in the
+    // record — which is the exact ambiguity this field was added to remove: proving a
+    // review had happened once meant re-running a cached canvas and reading raw JSON.
+    // Only the fields the backend keeps: a static review's typed fields (`kind`) stay in the CLI.
+    ...meta.review ? { review: meta.review.slice(0, 40).map(({ severity, what, scene }) => ({ severity, what, ...scene ? { scene } : {} })) } : {}
+  };
+}
+function buildInitialRunRecord(runId, meta) {
+  return {
+    runId,
+    ...meta,
+    status: "running",
+    stats: { totalNodes: 0, cachedNodes: 0, totalCredits: 0, durationMs: 0 },
+    nodes: []
+  };
+}
+function buildFailedRunRecord(runId, errorMessage, meta) {
+  return {
+    runId,
+    ...meta,
+    status: "failed",
+    errorMessage: errorMessage.slice(0, 2e3),
+    stats: { totalNodes: 0, cachedNodes: 0, totalCredits: 0, durationMs: 0 },
+    nodes: []
+  };
+}
+
+export {
+  creativeSlugFromCanvasPath,
+  finalOutputLabelsFromCanvas,
+  nodeOutputsToRecord,
+  finalFiles,
+  withFacts,
+  buildRunRecord,
+  buildInitialRunRecord,
+  buildFailedRunRecord
+};
+//# sourceMappingURL=chunk-EJBLF2LI.js.map