@koda-sl/baker-cli 0.467.0 → 0.468.0

package/dist/chunk-UCZ5YYFP.js

@@ -0,0 +1,304 @@
+import {
+  languageTag
+} from "./chunk-YJO4IMUK.js";
+import {
+  parseRefExpr
+} from "./chunk-U4RDH7SC.js";
+import {
+  AWARENESS_VALUES
+} from "./chunk-5HYSKH77.js";
+import {
+  collectAssetRefLikes,
+  isPersistedAssetRef
+} from "./chunk-DJPCTTUN.js";
+
+// src/commands/canvas/creative-definition.ts
+import { parseDocument } from "yaml";
+var PLATFORM_VALUES = ["meta", "google", "linkedin", "tiktok", "youtube", "x", "other"];
+var FORMAT_VALUES = ["1:1", "4:5", "9:16", "16:9", "1.91:1"];
+var EVIDENCE_VALUES = ["observed", "interpreted", "hypothesized", "generated"];
+function titleFromSlug(slug) {
+  const title = slug.split("-").filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  return title || slug;
+}
+function resolvePlatform(platform) {
+  const value = platform?.trim();
+  return value && PLATFORM_VALUES.includes(value) ? value : "meta";
+}
+function resolveFormats(aspect) {
+  const value = aspect?.trim();
+  return value && FORMAT_VALUES.includes(value) ? [value] : ["4:5"];
+}
+function resolveFormatList(formats) {
+  const valid = [...new Set(formats.map((f) => f.trim()))].filter(
+    (f) => FORMAT_VALUES.includes(f)
+  );
+  return valid.length > 0 ? valid : ["4:5"];
+}
+function describeBlueprintIntent(blueprint) {
+  const intent = blueprint?.ad_intent;
+  if (typeof intent === "string" && intent.trim()) return intent.trim();
+  if (intent && typeof intent === "object") {
+    const summary = intent.summary ?? intent.feeling;
+    if (typeof summary === "string" && summary.trim()) return summary.trim();
+  }
+  return void 0;
+}
+function yamlScalar(value) {
+  return JSON.stringify(value);
+}
+function buildCreativeDefinition(input) {
+  const lines = ["---", `title: ${yamlScalar(input.title)}`, `kind: ${input.kind}`, `platform: ${input.platform}`];
+  lines.push(`formats: [${input.formats.map(yamlScalar).join(", ")}]`);
+  lines.push(`status: ${input.status ?? "draft"}`);
+  if (input.sourceReferenceUrl) lines.push(`sourceReferenceUrl: ${yamlScalar(input.sourceReferenceUrl)}`);
+  if (input.sourceAdvertiser) lines.push(`sourceAdvertiser: ${yamlScalar(input.sourceAdvertiser)}`);
+  if (input.sourceAdvertiserId) lines.push(`sourceAdvertiserId: ${yamlScalar(input.sourceAdvertiserId)}`);
+  if (input.sourceAdId) lines.push(`sourceAdId: ${yamlScalar(input.sourceAdId)}`);
+  if (input.sourcePlatform) lines.push(`sourcePlatform: ${input.sourcePlatform}`);
+  if (input.sourceKind) lines.push(`sourceKind: ${input.sourceKind}`);
+  if (input.sourcePath) lines.push(`sourcePath: ${yamlScalar(input.sourcePath)}`);
+  if (input.targetAdSet) lines.push(`targetAdSet: ${yamlScalar(input.targetAdSet)}`);
+  if (input.viewer) lines.push(`viewer: ${JSON.stringify(input.viewer)}`);
+  lines.push("---", "");
+  lines.push(input.description?.trim() || `${input.title} \u2014 canvas-built ${input.kind} ad for ${input.platform}.`);
+  lines.push("");
+  return lines.join("\n");
+}
+var SOURCE_FIELD_KEYS = ["sourceAdId", "sourcePlatform", "sourceAdvertiserId"];
+function parseDefinitionSourceFields(raw) {
+  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+  if (!match) return {};
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return {};
+  const fields = {};
+  for (const key of SOURCE_FIELD_KEYS) {
+    const value = doc.get(key);
+    if (typeof value === "string" && value.trim()) fields[key] = value.trim();
+  }
+  return fields;
+}
+function oneOf(values, value) {
+  return values.find((allowed) => allowed === value);
+}
+function parseDefinitionStrategyFields(raw) {
+  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+  if (!match) return {};
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return {};
+  const text = (key) => {
+    const value = doc.get(key);
+    return typeof value === "string" && value.trim() ? value.trim() : void 0;
+  };
+  const ideaSlug = text("idea");
+  const message = text("message");
+  const evidence = oneOf(EVIDENCE_VALUES, text("evidence"));
+  const angle = text("angle");
+  const persona = text("persona");
+  const awareness = oneOf(AWARENESS_VALUES, text("awareness"));
+  const hypothesis = text("hypothesis");
+  const seriesLead = text("series");
+  const language = languageTag(text("language") ?? "");
+  return {
+    ...seriesLead ? { seriesLead } : {},
+    ...language ? { language } : {},
+    ...ideaSlug ? { ideaSlug } : {},
+    ...message ? { message } : {},
+    ...evidence ? { evidence } : {},
+    ...angle ? { angle } : {},
+    ...persona ? { persona } : {},
+    ...awareness ? { awareness } : {},
+    ...hypothesis ? { hypothesis } : {}
+  };
+}
+function parseDefinitionSeriesPlace(raw) {
+  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+  if (!match || parseDocument(match[1] ?? "").errors.length > 0) return null;
+  const { seriesLead, language } = parseDefinitionStrategyFields(raw);
+  return { seriesLead: seriesLead ?? null, language: language ?? null };
+}
+function parseDefinitionViewerFields(raw) {
+  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+  if (!match) return {};
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return {};
+  const data = doc.toJS();
+  const adSet = data?.targetAdSet;
+  const targetAdSet = typeof adSet === "string" || typeof adSet === "number" ? String(adSet).trim() : "";
+  return {
+    ...targetAdSet ? { targetAdSet } : {},
+    ...data?.viewer !== void 0 ? { viewer: data.viewer } : {}
+  };
+}
+function setDefinitionViewer(raw, fields) {
+  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+  if (!match) return raw;
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return raw;
+  if (fields.targetAdSet) doc.set("targetAdSet", fields.targetAdSet);
+  if (fields.viewer) doc.set("viewer", doc.createNode(fields.viewer, { flow: true }));
+  return `---
+${doc.toString()}---${raw.slice(match[0].length)}`;
+}
+
+// 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_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 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 } : {}
+    };
+  });
+  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 {
+  titleFromSlug,
+  resolvePlatform,
+  resolveFormats,
+  resolveFormatList,
+  describeBlueprintIntent,
+  buildCreativeDefinition,
+  parseDefinitionSourceFields,
+  parseDefinitionStrategyFields,
+  parseDefinitionSeriesPlace,
+  parseDefinitionViewerFields,
+  setDefinitionViewer,
+  creativeSlugFromCanvasPath,
+  finalOutputLabelsFromCanvas,
+  nodeOutputsToRecord,
+  finalFiles,
+  buildRunRecord,
+  buildInitialRunRecord,
+  buildFailedRunRecord
+};
+//# sourceMappingURL=chunk-UCZ5YYFP.js.map

package/dist/chunk-UGI33KTO.js

@@ -0,0 +1,55 @@
+import {
+  ApiError
+} from "./chunk-MMOTJIV6.js";
+import {
+  writeJson
+} from "./chunk-D3RTGIT4.js";
+
+// src/commands/media-sources/shared.ts
+function driveRefusalFix(input, code) {
+  if (!/drive\.google\.com/i.test(input) || code !== "BAD_REQUEST") return void 0;
+  return `A Google Drive folder is never added by link \u2014 don't retry. Call request_connection with platform "google-drive" and choose "media-folder": the card lets the user pick the folder in the chat (only the Baker team can for now; anyone else is told the team will set it up). A connected result carries the new source's mediaSourceKey; if it is declined, carry on with the rest of the task.`;
+}
+function reportError(err, input) {
+  if (err instanceof ApiError) {
+    const fix = input ? driveRefusalFix(input, err.code) : void 0;
+    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function halfState(half) {
+  if (!half) return null;
+  return {
+    status: half.syncStatus === "fetching" || half.syncStatus === "processing" ? "importing" : half.syncStatus,
+    stored: half.storedCount ?? 0,
+    ...half.pendingItems ? { pending: half.pendingItems } : {},
+    ...half.failedItems ? { failed: half.failedItems } : {},
+    ...half.lastSyncedAt ? { lastSyncedAt: new Date(half.lastSyncedAt).toISOString() } : {},
+    ...half.errorMessage ? { error: half.errorMessage } : {}
+  };
+}
+function compactSource(source) {
+  return {
+    key: source.key,
+    platform: source.platform,
+    label: source.label,
+    url: source.profileUrl,
+    autoSync: source.refreshInterval,
+    images: halfState(source.images),
+    videos: halfState(source.videos)
+  };
+}
+function isImporting(source) {
+  return [source.images, source.videos].some(
+    (half) => half?.syncStatus === "fetching" || half?.syncStatus === "processing"
+  );
+}
+
+export {
+  reportError,
+  compactSource,
+  isImporting
+};
+//# sourceMappingURL=chunk-UGI33KTO.js.map

package/dist/chunk-UX7HIGS7.js

@@ -0,0 +1,67 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-6SL6463H.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-MMOTJIV6.js";
+
+// src/commands/ads/x/run-list.ts
+function buildCleanParams(opts) {
+  const out = {};
+  for (const [k, v] of Object.entries(opts.params)) {
+    if (v !== void 0 && v !== "") {
+      out[k] = v;
+    }
+  }
+  if (!opts.useCache) {
+    out["skip-cache"] = "true";
+  }
+  return out;
+}
+function emitFromCache(opts) {
+  if (!opts.useCache || opts.cacheTtlMs === void 0) return false;
+  const cached = cacheGet(opts.cacheCategory, opts.cacheKey);
+  if (!cached) return false;
+  writeAdsJson({ ok: true, data: cached.data, cached: true });
+  return true;
+}
+function emitData(opts, data) {
+  if (opts.format !== "json") {
+    writeAdsOutput(data, opts.format);
+    return;
+  }
+  writeAdsJson({ ok: true, data });
+}
+function emitError(opts, err) {
+  if (err instanceof ApiError) {
+    writeAdsJson(parseXApiError(err.message, opts.accountId ?? "\u2014"));
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+async function runListCommand(opts) {
+  if (emitFromCache(opts)) return;
+  const params = buildCleanParams(opts);
+  try {
+    const data = await apiGet(opts.path, params);
+    if (opts.useCache && opts.cacheTtlMs !== void 0) {
+      cacheSet(opts.cacheCategory, opts.cacheKey, data, opts.cacheTtlMs);
+    }
+    emitData(opts, data);
+  } catch (err) {
+    emitError(opts, err);
+  }
+}
+
+export {
+  runListCommand
+};
+//# sourceMappingURL=chunk-UX7HIGS7.js.map