@koda-sl/baker-cli 0.478.0 → 0.480.0

package/dist/chunk-65PUXMWE.js

@@ -0,0 +1,167 @@
+import {
+  parseRefExpr
+} from "./chunk-D4I3KULJ.js";
+import {
+  collectAssetRefLikes,
+  isPersistedAssetRef
+} from "./chunk-2FSEESJU.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-65PUXMWE.js.map

package/dist/chunk-65PUXMWE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/run-record.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { CanvasRunVerdict } from \"@baker/api\";\nimport type { NodeRunRecord, RunResult } from \"../../engine/engine/executor.ts\";\nimport { parseRefExpr } from \"../../engine/schema/canvas.ts\";\nimport { collectAssetRefLikes, isPersistedAssetRef } from \"../../engine/storage/remote-cache-store.ts\";\n\n// Mirrors of the backend intake caps (canvas/runRecords.ts) so an in-bounds\n// payload is sent even for pathological runs; the server re-caps defensively.\nconst MAX_RUN_NODES = 200;\nconst MAX_OUTPUTS_PER_NODE = 10;\nconst MAX_FINAL_OUTPUTS = 10;\n/** The longest `facts` JSON a node record carries (the backend's cap); a longer one is dropped, never cut. */\nconst MAX_NODE_FACTS_CHARS = 4096;\n\nexport type RunRecordOutput = {\n  slot: string;\n  /** Variant identity from the collect terminal (branch/scene name) — slot stays the stable key. */\n  label?: string;\n  kind: \"image\" | \"video\" | \"audio\" | \"json\" | \"text\" | \"font\";\n  sha256: string;\n  url: string;\n  mime: string;\n  width?: number;\n  height?: number;\n  durationMs?: number;\n};\n\n/** Labels for a collect-terminated canvas: the collector's node id + one label per collected image. */\nexport type FinalOutputLabels = { nodeId: string; labels: (string | undefined)[] };\n\nexport type RunNodeStatus = \"pending\" | \"running\" | \"completed\" | \"failed\";\n\nexport type RunRecordNode = {\n  nodeId: string;\n  nodeType: string;\n  cached: boolean;\n  credits: number;\n  durationMs: number;\n  outputs: RunRecordOutput[];\n  /** Upstream node ids ($ref edges) — lets the dashboard render the workflow graph. */\n  deps?: string[];\n  status?: RunNodeStatus;\n  /** Compact params excerpt (prompt text preferred) for graph-node legibility. */\n  paramsPreview?: string;\n  /** Why this node failed — the real upstream status/provider — set only on `status: \"failed\"`. */\n  error?: RunNodeError;\n  /** The node's job, from its `tags.role` (e.g. `static_variants`), so readers never parse node ids. */\n  role?: string;\n  /** What the node did, as small JSON (its `facts` output: a size's crop, words move, steps). */\n  facts?: string;\n};\n\n/** Display-ready per-node failure detail. Mirrors the engine's `NodeFailureDetail`. */\nexport type RunNodeError = {\n  message: string;\n  code?: string;\n  provider?: string;\n  retryable?: boolean;\n};\n\n/** Run attribution stamped on every record post (progress, terminal, initial). */\nexport type RunRecordMeta = {\n  creativeSlug?: string;\n  canvasPath?: string;\n  canvasSha?: string;\n  /** Content sha of the rendered source (canvas.json + prompt.json) — powers the dashboard staleness signal. */\n  sourceSha?: string;\n  chatId?: string;\n  /** R2 manifest of the executed canvas + its local file refs — first-write-wins server-side. */\n  canvasSnapshotUrl?: string;\n  /** R2 copy of the graph this run executes (every node's declaration): what a correction elsewhere grows on. */\n  graphUrl?: string;\n  /** What the render review found, so it outlives the terminal it was printed to. */\n  review?: { severity: \"blocking\" | \"warning\"; what: string; scene?: string }[];\n  /**\n   * What the review's own model calls cost, as the gateway reported them.\n   *\n   * The review calls OpenRouter from the Runtime — that is where the finished video is,\n   * and shipping 60MB through Convex to reach the same gateway would buy nothing — so\n   * this record is what carries the spend back to where it is billed. `costUsd` is\n   * OpenRouter's own `usage.cost`, relayed rather than computed: the sandbox never\n   * prices anything, which is what makes it safe for the model id to float.\n   */\n  reviewUsage?: { model: string; inputTokens: number; outputTokens: number; costUsd: number }[];\n  /** What the render review said (`@baker/api` CANVAS_RUN_VERDICTS), and whether the run may be shown as a version. */\n  verdict?: CanvasRunVerdict;\n  presentable?: boolean;\n  /** An ad of a series made again from a new version of its lead: a new version of the ad, not a retry. */\n  newAsk?: boolean;\n  /** The company's creative rules this run was made and checked against (`rulesDigest`, and their ids). */\n  rules?: { digest: string; ids: string[] };\n};\n\nexport type RunRecordPayload = {\n  runId: string;\n  /** `awaiting_approval`: stopped on purpose at a `--until` checkpoint, resumable with the same run id. */\n  status: \"running\" | \"completed\" | \"failed\" | \"awaiting_approval\";\n  errorMessage?: string;\n  stats: { totalNodes: number; cachedNodes: number; totalCredits: number; durationMs: number };\n  nodes: RunRecordNode[];\n  finalOutputs?: RunRecordOutput[];\n  /**\n   * What the render review found, sent with the run that produced it.\n   *\n   * Without this the findings existed only in the CLI's stdout — visible to the agent\n   * for one turn and to nobody afterwards. A check whose result leaves no trace cannot\n   * be read back, compared between runs, or shown to the person the ad is for, and is\n   * indistinguishable from a check that never ran.\n   */\n  review?: { severity: \"blocking\" | \"warning\"; what: string; scene?: string }[];\n  /** Graceful-abort flush (SIGINT/SIGTERM): terminal but resumable — the backend keeps the row adoptable. */\n  interrupted?: boolean;\n} & RunRecordMeta;\n\n/** Per-node plan facts (edges + params preview) captured from the engine's plan event. */\nexport type RunPlanInfo = Map<string, { deps: string[]; paramsPreview?: string; role?: string }>;\n\n// Mirrors the backend's CREATIVE_SLUG_MAX_LENGTH — an over-long slug would\n// 400 the whole run record, so attribution is dropped instead.\nconst MAX_CREATIVE_SLUG_LENGTH = 100;\n\n/**\n * A canvas under the repo convention `src/creatives/{slug}/` belongs to that\n * creative; its runs become the creative's generation history. Returns null\n * for canvases anywhere else (and for slugs the backend would reject).\n */\nexport function creativeSlugFromCanvasPath(filePath: string): string | null {\n  const normalized = filePath.split(path.sep).join(\"/\");\n  const match = normalized.match(/(?:^|\\/)src\\/creatives\\/([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)\\//);\n  const slug = match?.[1] ?? null;\n  return slug && slug.length <= MAX_CREATIVE_SLUG_LENGTH ? slug : null;\n}\n\n/**\n * Best-effort variant labels from a not-yet-validated canvas: when the declared\n * output is a `collect` node, each final inherits the node's explicit\n * `params.labels[i]`, else the producer node id parsed from the raw `$ref` it\n * collects (`$ref:gen_billboard_03.images#0` → `gen_billboard_03`). Null for\n * every other canvas shape — single-output runs stay unlabeled.\n */\nexport function finalOutputLabelsFromCanvas(parsed: unknown): FinalOutputLabels | null {\n  const canvas = parsed as { nodes?: unknown; output?: { node?: unknown } } | null;\n  const outputNodeId = canvas?.output?.node;\n  if (typeof outputNodeId !== \"string\" || !Array.isArray(canvas?.nodes)) return null;\n  const node = canvas.nodes.find((n) => (n as { id?: unknown })?.id === outputNodeId) as\n    | { type?: unknown; inputs?: { images?: unknown }; params?: { labels?: unknown } }\n    | undefined;\n  if (node?.type !== \"collect\") return null;\n  const explicit = node.params?.labels;\n  if (Array.isArray(explicit) && explicit.every((l) => typeof l === \"string\")) {\n    return { nodeId: outputNodeId, labels: explicit };\n  }\n  const images = node.inputs?.images;\n  if (!Array.isArray(images)) return null;\n  const labels = images.map((entry) => {\n    if (typeof entry !== \"string\") return undefined;\n    return parseRefExpr(entry)?.nodeId;\n  });\n  return { nodeId: outputNodeId, labels };\n}\n\nconst OUTPUT_KINDS = new Set([\"image\", \"video\", \"audio\", \"json\", \"text\", \"font\"]);\n\nfunction toRecordOutput(slot: string, value: unknown, label?: string): RunRecordOutput | null {\n  const refs = collectAssetRefLikes(value);\n  const ref = refs.length === 1 ? refs[0] : null;\n  if (!ref || !isPersistedAssetRef(ref)) return null;\n  const kind = typeof ref.kind === \"string\" && OUTPUT_KINDS.has(ref.kind) ? ref.kind : null;\n  if (!kind) return null;\n  return {\n    slot,\n    label,\n    kind: kind as RunRecordOutput[\"kind\"],\n    sha256: ref.sha256,\n    url: ref.url,\n    mime: ref.mime,\n    width: typeof ref.width === \"number\" ? ref.width : undefined,\n    height: typeof ref.height === \"number\" ? ref.height : undefined,\n    durationMs: typeof ref.duration_ms === \"number\" ? ref.duration_ms : undefined,\n  };\n}\n\n/**\n * Flatten one node's outputs into record entries. Single refs keep their slot\n * name; arrays become `slot#i`. Values without a persisted ref (plain JSON\n * manifests, refs whose upload failed) are dropped — every stored output must\n * be renderable from R2.\n */\nexport function nodeOutputsToRecord(\n  nodeOutputs: Record<string, unknown>,\n  labels?: (string | undefined)[],\n): RunRecordOutput[] {\n  const out: RunRecordOutput[] = [];\n  for (const [slot, value] of Object.entries(nodeOutputs)) {\n    if (Array.isArray(value)) {\n      value.forEach((item, i) => {\n        const rec = toRecordOutput(`${slot}#${i}`, item, labels?.[i]);\n        if (rec) out.push(rec);\n      });\n    } else {\n      const rec = toRecordOutput(slot, value);\n      if (rec) out.push(rec);\n    }\n  }\n  return out.slice(0, MAX_OUTPUTS_PER_NODE);\n}\n\nfunction finalOutputsToRecord(output: unknown, labels?: (string | undefined)[]): RunRecordOutput[] {\n  if (Array.isArray(output)) {\n    return output\n      .map((item, i) => toRecordOutput(`final#${i}`, item, labels?.[i]))\n      .filter((rec): rec is RunRecordOutput => rec !== null)\n      .slice(0, MAX_FINAL_OUTPUTS);\n  }\n  const rec = toRecordOutput(\"final\", output);\n  return rec ? [rec] : [];\n}\n\n/** Each delivered size's local file, keyed by its label (or `final#i`), so the agent opens it with Read. */\nexport function finalFiles(output: unknown, labels?: (string | undefined)[]): Record<string, string> {\n  const items = Array.isArray(output) ? output : [output];\n  const files: Record<string, string> = {};\n  items.forEach((item, i) => {\n    const ref = collectAssetRefLikes(item)[0];\n    if (ref && typeof ref.path === \"string\") files[labels?.[i] ?? `final#${i}`] = ref.path;\n  });\n  return files;\n}\n\n/**\n * `{ facts }`: a node's `facts` output as the JSON its record carries; nothing when it has none or\n * its JSON is longer than `MAX_NODE_FACTS_CHARS` (dropped whole: a cut JSON parses as nothing).\n */\nexport function withFacts(nodeOutputs: Record<string, unknown>): { facts?: string } {\n  const facts = nodeOutputs.facts;\n  if (facts === undefined || facts === null) return {};\n  const json = JSON.stringify(facts);\n  return json.length <= MAX_NODE_FACTS_CHARS ? { facts: json } : {};\n}\n\nexport function buildRunRecord(\n  result: Pick<RunResult, \"run_id\" | \"output\" | \"outputs_by_node\" | \"stats\"> & { node_runs: NodeRunRecord[] },\n  meta: RunRecordMeta,\n  plan?: RunPlanInfo,\n  finalLabels?: FinalOutputLabels,\n): RunRecordPayload {\n  const nodes = result.node_runs.slice(0, MAX_RUN_NODES).map((run): RunRecordNode => {\n    const planned = plan?.get(run.node_id);\n    return {\n      nodeId: run.node_id,\n      nodeType: run.node_type,\n      cached: run.cached,\n      credits: run.credits,\n      durationMs: run.duration_ms,\n      outputs: nodeOutputsToRecord(\n        result.outputs_by_node[run.node_id] ?? {},\n        run.node_id === finalLabels?.nodeId ? finalLabels.labels : undefined,\n      ),\n      deps: planned?.deps,\n      status: plan ? \"completed\" : undefined,\n      paramsPreview: planned?.paramsPreview,\n      ...(planned?.role !== undefined ? { role: planned.role } : {}),\n      ...withFacts(result.outputs_by_node[run.node_id] ?? {}),\n    };\n  });\n  const finalOutputs = finalOutputsToRecord(result.output, finalLabels?.labels);\n  return {\n    runId: result.run_id,\n    ...meta,\n    status: \"completed\",\n    stats: {\n      totalNodes: result.stats.total_nodes,\n      cachedNodes: result.stats.cached_nodes,\n      totalCredits: result.stats.total_credits,\n      durationMs: result.stats.duration_ms,\n    },\n    nodes,\n    finalOutputs: finalOutputs.length > 0 ? finalOutputs : undefined,\n    // Sent whenever the review RAN, empty list included. Sending it only when there\n    // were findings makes a clean render and an unreviewed one look identical in the\n    // record — which is the exact ambiguity this field was added to remove: proving a\n    // review had happened once meant re-running a cached canvas and reading raw JSON.\n    // Only the fields the backend keeps: a static review's typed fields (`kind`) stay in the CLI.\n    ...(meta.review\n      ? { review: meta.review.slice(0, 40).map(({ severity, what, scene }) => ({ severity, what, ...(scene ? { scene } : {}) })) }\n      : {}),\n  };\n}\n\n/**\n * The empty `running` record posted BEFORE layer 1 executes. This row is the\n * Convex-side in-flight marker: the reconciliation sweep and cross-sandbox\n * resume both key off it, so unlike the fire-and-forget progress stream it is\n * posted synchronously (with retries) at run start.\n */\nexport function buildInitialRunRecord(runId: string, meta: RunRecordMeta): RunRecordPayload {\n  return {\n    runId,\n    ...meta,\n    status: \"running\",\n    stats: { totalNodes: 0, cachedNodes: 0, totalCredits: 0, durationMs: 0 },\n    nodes: [],\n  };\n}\n\nexport function buildFailedRunRecord(runId: string, errorMessage: string, meta: RunRecordMeta): RunRecordPayload {\n  return {\n    runId,\n    ...meta,\n    status: \"failed\",\n    errorMessage: errorMessage.slice(0, 2000),\n    stats: { totalNodes: 0, cachedNodes: 0, totalCredits: 0, durationMs: 0 },\n    nodes: [],\n  };\n}\n"],"mappings":"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","names":["rec"]}

package/dist/chunk-6JWEGFM5.js

@@ -0,0 +1,174 @@
+import {
+  metaDraftOpInputSchema
+} from "./chunk-GOJXKIFQ.js";
+import {
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-OP7DNHD2.js";
+import {
+  adCopyHints,
+  booleanWordPositionalError,
+  capabilityFix
+} from "./chunk-SFJW2KED.js";
+import {
+  withHints
+} from "./chunk-D5FY4FAK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-SWL4AAPP.js";
+import {
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import {
+  requireChatId
+} from "./chunk-EE72SSB2.js";
+
+// src/commands/ads/meta/write-shared.ts
+import { readFileSync } from "fs";
+function bareAccountId(args) {
+  return 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 {};
+  }
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failWriteValidation(`${path} must contain a JSON object`);
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      failWriteValidation(`${path} 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 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;
+}
+async function stageOp(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: capabilityFix("meta-ads")
+      }
+    });
+    process.exit(1);
+  }
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/meta/draft/stage", { chatId, op: preflight.data });
+    const copyHints = await adCopyHints(preflight.data);
+    writeJsonEnvelope(withHints(response, copyHints));
+  } catch (err) {
+    handleMetaError(err);
+  }
+}
+async function stageStatusChange(input) {
+  await stageOp({
+    kind: input.kind,
+    accountId: input.accountId,
+    target: input.target,
+    payload: { status: input.status }
+  });
+}
+
+export {
+  bareAccountId,
+  failWriteValidation,
+  refuseDeleteByUpdate,
+  loadJsonFileArg,
+  mergePayload,
+  parseMoneyFlag,
+  parseDateFlag,
+  listFlag,
+  upper,
+  numberFlag,
+  requireTarget,
+  stageOp,
+  stageStatusChange
+};
+//# sourceMappingURL=chunk-6JWEGFM5.js.map

package/dist/chunk-6KK26F2T.js

@@ -0,0 +1,46 @@
+import {
+  RENDER_REVIEW_MODEL,
+  askAboutImages,
+  buildRulesReviewPrompt,
+  classifyRuleFindings,
+  reviewedRules,
+  rulesSystem
+} from "./chunk-ZBV5IV5T.js";
+
+// src/engine/nodes/local/lib/confirm-blocking.ts
+var cutByFrame = (f) => f.kind?.defect === "cut";
+async function confirmBlocking(findings, stills, formats, ask) {
+  const claims = findings.filter((f) => f.severity === "blocking" && !cutByFrame(f));
+  if (claims.length === 0 || stills.length === 0) return [...findings];
+  const prompt = [
+    `These are the finished sizes of one ad, in order: ${formats.map((f, i) => `Image ${i + 1} is the ${f}`).join("; ")}.`,
+    "A reviewer reported each claim below. Look again at the size each one names (and, for a claim comparing sizes, at the others) and answer true only when the defect is plainly there for someone looking at it on a phone.",
+    "Answer false when the thing is not there, when it is an ordinary part of the scene (a second house, a neighbour's roof, a reflection), or when the sizes it compares show the same thing.",
+    ...claims.map((c, i) => `${i + 1}. ${c.what}`),
+    `Reply with only this JSON: {"answers":[true|false, ...]}, one answer per claim, in order.`
+  ].join("\n");
+  const answer = await ask([...stills], prompt).catch(() => null);
+  const answers = answer?.answers;
+  if (!Array.isArray(answers) || answers.length !== claims.length) return [...findings];
+  const unconfirmed = new Set(claims.filter((_, i) => answers[i] === false));
+  return findings.map((f) => unconfirmed.has(f) ? { ...f, severity: "warning" } : f);
+}
+
+// src/engine/nodes/local/lib/rules-review.ts
+var RULES_REVIEW_TIMEOUT_MS = 12e4;
+async function reviewAgainstRules(opts) {
+  const rules = reviewedRules(opts.rules);
+  if (rules.length === 0 || opts.stills.length === 0) return [];
+  const system = rulesSystem(rules);
+  const ask = (images, prompt) => askAboutImages(RENDER_REVIEW_MODEL, images, prompt, opts.onSpend, RULES_REVIEW_TIMEOUT_MS, void 0, system);
+  const answer = await ask([...opts.stills], buildRulesReviewPrompt({ formats: opts.formats, rules }));
+  if (answer === null) return null;
+  return await confirmBlocking(classifyRuleFindings(answer, rules), opts.stills, opts.formats, ask);
+}
+
+export {
+  cutByFrame,
+  confirmBlocking,
+  reviewAgainstRules
+};
+//# sourceMappingURL=chunk-6KK26F2T.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/nodes/local/lib/confirm-blocking.ts","../src/engine/nodes/local/lib/rules-review.ts"],"sourcesContent":["/**\n * The second look every review gives a blocking defect it judged by eye, before the defect costs a\n * correction round: the static review's and the rules review's alike.\n */\nimport type { RenderFinding } from \"./render-review.ts\";\n\n/** A finding about something the frame's edge cuts: the measured boxes corroborate it, not a second look. */\nexport const cutByFrame = (f: RenderFinding): boolean => f.kind?.defect === \"cut\";\n\n/** One model question about the delivered stills, as `askAboutStills` asks it. */\nexport type AskStills = (images: string[], prompt: string) => Promise<unknown>;\n\n/**\n * A second, direct look at each blocking defect the review judged by eye: one question, each claim\n * answered true only when plainly visible on the size it names. An unconfirmed one stays as a note.\n * The review's own judgement is the first look; a correction round is ~2 minutes, the look a few\n * seconds (Dev, Oct 2026: a neighbour's roof read as \"duplicated\", a card both sizes show read as\n * \"missing from the 9:16\"). No answer leaves the findings as they were.\n */\nexport async function confirmBlocking(\n  findings: readonly RenderFinding[],\n  stills: readonly string[],\n  formats: readonly string[],\n  ask: AskStills,\n): Promise<RenderFinding[]> {\n  // A cut or clipped element is corroborated by the measured boxes (`corroborateEdgeClaims`), and a\n  // second look answers its edges one by one: one wrong edge of three read a cut button as fine.\n  const claims = findings.filter((f) => f.severity === \"blocking\" && !cutByFrame(f));\n  if (claims.length === 0 || stills.length === 0) return [...findings];\n  const prompt = [\n    `These are the finished sizes of one ad, in order: ${formats.map((f, i) => `Image ${i + 1} is the ${f}`).join(\"; \")}.`,\n    \"A reviewer reported each claim below. Look again at the size each one names (and, for a claim comparing sizes, at the others) and answer true only when the defect is plainly there for someone looking at it on a phone.\",\n    \"Answer false when the thing is not there, when it is an ordinary part of the scene (a second house, a neighbour's roof, a reflection), or when the sizes it compares show the same thing.\",\n    ...claims.map((c, i) => `${i + 1}. ${c.what}`),\n    `Reply with only this JSON: {\"answers\":[true|false, ...]}, one answer per claim, in order.`,\n  ].join(\"\\n\");\n  const answer = await ask([...stills], prompt).catch(() => null);\n  const answers = (answer as { answers?: unknown } | null)?.answers;\n  if (!Array.isArray(answers) || answers.length !== claims.length) return [...findings];\n  const unconfirmed = new Set(claims.filter((_, i) => answers[i] === false));\n  return findings.map((f) => (unconfirmed.has(f) ? { ...f, severity: \"warning\" as const } : f));\n}\n","/**\n * The company's rules, checked on a finished ad's stills by a vision model (`reviewedRules`): one\n * owner for that look, which the static run review, a video's sampled frames, the admission test\n * of a new rule (`baker creatives rules add`) and the evals all ask the same way. A never or a must\n * broken blocks; a prefer is a note. Each blocking break gets a second look (`confirmBlocking`)\n * before it costs a correction round. The rules ride first, as a system message the same for every\n * review of the company's ads, so the provider can cache them.\n */\nimport type { CreativeRule } from \"../../../creative-rules/schema.ts\";\nimport { confirmBlocking } from \"./confirm-blocking.ts\";\nimport { askAboutImages, RENDER_REVIEW_MODEL, type RenderFinding, type ReviewUsage } from \"./render-review.ts\";\nimport { buildRulesReviewPrompt, classifyRuleFindings, reviewedRules, rulesSystem } from \"./rules-findings.ts\";\n\n/** How long the look may take: a few pictures and one list. */\nconst RULES_REVIEW_TIMEOUT_MS = 120_000;\n\n/**\n * The finished ad (its sizes as base64 JPEG, in `formats` order) against the rules a picture can\n * break. None when no such rule holds; null when no model answered.\n */\nexport async function reviewAgainstRules(opts: {\n  stills: readonly string[];\n  formats: readonly string[];\n  rules: readonly CreativeRule[];\n  onSpend?: (usage: ReviewUsage) => void;\n}): Promise<RenderFinding[] | null> {\n  const rules = reviewedRules(opts.rules);\n  if (rules.length === 0 || opts.stills.length === 0) return [];\n  const system = rulesSystem(rules);\n  const ask = (images: string[], prompt: string) =>\n    askAboutImages(RENDER_REVIEW_MODEL, images, prompt, opts.onSpend, RULES_REVIEW_TIMEOUT_MS, undefined, system);\n  const answer = await ask([...opts.stills], buildRulesReviewPrompt({ formats: opts.formats, rules }));\n  if (answer === null) return null;\n  return await confirmBlocking(classifyRuleFindings(answer, rules), opts.stills, opts.formats, ask);\n}\n"],"mappings":";;;;;;;;;;AAOO,IAAM,aAAa,CAAC,MAA8B,EAAE,MAAM,WAAW;AAY5E,eAAsB,gBACpB,UACA,QACA,SACA,KAC0B;AAG1B,QAAM,SAAS,SAAS,OAAO,CAAC,MAAM,EAAE,aAAa,cAAc,CAAC,WAAW,CAAC,CAAC;AACjF,MAAI,OAAO,WAAW,KAAK,OAAO,WAAW,EAAG,QAAO,CAAC,GAAG,QAAQ;AACnE,QAAM,SAAS;AAAA,IACb,qDAAqD,QAAQ,IAAI,CAAC,GAAG,MAAM,SAAS,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,IAAI,CAAC;AAAA,IACnH;AAAA,IACA;AAAA,IACA,GAAG,OAAO,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;AAAA,IAC7C;AAAA,EACF,EAAE,KAAK,IAAI;AACX,QAAM,SAAS,MAAM,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,MAAM,MAAM,IAAI;AAC9D,QAAM,UAAW,QAAyC;AAC1D,MAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW,OAAO,OAAQ,QAAO,CAAC,GAAG,QAAQ;AACpF,QAAM,cAAc,IAAI,IAAI,OAAO,OAAO,CAAC,GAAG,MAAM,QAAQ,CAAC,MAAM,KAAK,CAAC;AACzE,SAAO,SAAS,IAAI,CAAC,MAAO,YAAY,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,UAAU,UAAmB,IAAI,CAAE;AAC9F;;;AC3BA,IAAM,0BAA0B;AAMhC,eAAsB,mBAAmB,MAKL;AAClC,QAAM,QAAQ,cAAc,KAAK,KAAK;AACtC,MAAI,MAAM,WAAW,KAAK,KAAK,OAAO,WAAW,EAAG,QAAO,CAAC;AAC5D,QAAM,SAAS,YAAY,KAAK;AAChC,QAAM,MAAM,CAAC,QAAkB,WAC7B,eAAe,qBAAqB,QAAQ,QAAQ,KAAK,SAAS,yBAAyB,QAAW,MAAM;AAC9G,QAAM,SAAS,MAAM,IAAI,CAAC,GAAG,KAAK,MAAM,GAAG,uBAAuB,EAAE,SAAS,KAAK,SAAS,MAAM,CAAC,CAAC;AACnG,MAAI,WAAW,KAAM,QAAO;AAC5B,SAAO,MAAM,gBAAgB,qBAAqB,QAAQ,KAAK,GAAG,KAAK,QAAQ,KAAK,SAAS,GAAG;AAClG;","names":[]}