@koda-sl/baker-cli 0.524.0 → 0.525.0

package/dist/chunk-IRDKHNKO.js

@@ -1,142 +0,0 @@
-import {
-  avatarsOf
-} from "./chunk-OVBZ26PE.js";
-import {
-  readAvatars
-} from "./chunk-UTFSUMLU.js";
-import {
-  readCreativeContext,
-  workspaceOfCreative
-} from "./chunk-ICHXD4IB.js";
-import {
-  frontmatterOf,
-  ruleTells
-} from "./chunk-AYAVYXSL.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-M7MLFR2S.js";
-import {
-  isAdSpec,
-  nativeCopy,
-  readAdSpec
-} from "./chunk-X3BOXZVP.js";
-import {
-  marketFromCompanyDoc
-} from "./chunk-2WZI36D3.js";
-
-// src/engine/creative-context/ad-words.ts
-import { readdir, readFile } from "fs/promises";
-import path from "path";
-var json = (file) => readFile(file, "utf8").then((raw) => JSON.parse(raw)).catch(() => null);
-var text = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
-function waivedOf(spec) {
-  const waive = spec?.waive;
-  return Array.isArray(waive) ? waive.flatMap((w) => text(w?.rule) ?? []) : [];
-}
-function sceneWords(scene) {
-  const s = scene ?? {};
-  const spoken = Array.isArray(s.dialogue) ? s.dialogue.flatMap((d) => text(d?.line) ?? []) : [];
-  const shown = Array.isArray(s.overlays) ? s.overlays.flatMap((o) => text(o?.text) ?? []) : [];
-  return [...spoken, ...shown];
-}
-async function sceneFiles(creativeDir) {
-  const dir = path.join(creativeDir, "scenes");
-  const files = (await readdir(dir).catch(() => [])).filter((f) => f.endsWith(".json")).sort();
-  return await Promise.all(files.map((f) => json(path.join(dir, f))));
-}
-async function videoLanguage(creativeDir) {
-  const definition = frontmatterOf(await readFile(path.join(creativeDir, "_definition.md"), "utf8").catch(() => ""));
-  const beats = await json(path.join(creativeDir, "ad.spec.json"));
-  return text(definition?.language) ?? text(beats?.voice?.language);
-}
-async function videoWords(raw, creativeDir) {
-  const global = raw.global ?? {};
-  const transcript = text(global.transcript);
-  const scenes = [...Array.isArray(raw.scenes) ? raw.scenes : [], ...await sceneFiles(creativeDir)];
-  const lines = [.../* @__PURE__ */ new Set([...transcript ? [transcript] : [], ...scenes.flatMap(sceneWords)])];
-  const language = await videoLanguage(creativeDir);
-  return { kind: "video", lines, ...language ? { language } : {} };
-}
-function staticWords(raw) {
-  try {
-    const spec = readAdSpec(raw);
-    const lines = spec.native ? nativeCopy(spec.native) : spec.copy.map((l) => l.text);
-    const language = spec.viewer?.market?.language;
-    return { kind: "static", lines, ...language ? { language } : {} };
-  } catch {
-    return null;
-  }
-}
-async function readAdWords(creativeDir) {
-  const raw = await json(path.join(creativeDir, "prompt.json"));
-  if (!raw || typeof raw !== "object") return null;
-  const video = !isAdSpec(raw) && ("global" in raw || "scenes" in raw);
-  const words = video ? await videoWords(raw, creativeDir) : staticWords(raw);
-  if (!words) return null;
-  const product = text(raw.product);
-  const definition = frontmatterOf(await readFile(path.join(creativeDir, "_definition.md"), "utf8").catch(() => ""));
-  const platform = text(definition?.platform);
-  const listed = definition?.platforms;
-  const platforms = Array.isArray(listed) ? listed.map(text).filter((p) => p !== void 0) : [];
-  return {
-    ...words,
-    ...product ? { product } : {},
-    ...platform ? { platform } : {},
-    ...platforms.length > 0 ? { platforms } : {},
-    waived: waivedOf(raw)
-  };
-}
-
-// src/commands/canvas/rule-gate.ts
-import { readFile as readFile2 } from "fs/promises";
-import path2 from "path";
-function tellLine(tell) {
-  const where = tell.kind === "forbidden" ? `"${tell.line ?? ""}" says "${tell.phrase}"` : `No line says "${tell.phrase}"`;
-  const words = tell.quote ? ` Their words: ${tell.quote}` : "";
-  return `${where}: ${tell.rule} (${tell.strength}) \u2014 ${tell.text}${words}`;
-}
-function ruleRefusal(tells) {
-  if (tells.length === 0) return null;
-  return {
-    problems: [...new Set(tells.map(tellLine))],
-    fix: 'Rewrite each line named above within its rule (a static: its `copy` in prompt.json; a video: its scene files and ad.spec.json), then re-run. Only when the person explicitly asked for these words in this ad, keep them and add to prompt.json `"waive": [{"rule": "<id>", "why": "<their ask>"}]`.'
-  };
-}
-var liveRoster = () => readAvatars("/api/avatars", { status: "ready" }).then(avatarsOf, () => null);
-async function heldRules(creativeDir, ad) {
-  const words = ad === void 0 ? await readAdWords(creativeDir) : ad;
-  const root = findWorkspaceRoot(creativeDir) ?? workspaceOfCreative(creativeDir);
-  const context = await readCreativeContext(
-    root,
-    {
-      ...words ? { kind: words.kind } : {},
-      ...words?.product ? { product: words.product } : {},
-      ...words?.platform ? { platform: words.platform } : {},
-      ...words?.platforms ? { platforms: words.platforms } : {}
-    },
-    { waived: words?.waived ?? [] }
-  );
-  const language = words?.language ?? marketFromCompanyDoc(await readFile2(path2.join(root, "COMPANY.md"), "utf8").catch(() => null))?.language;
-  return { rules: context.rules, ...language ? { language } : {} };
-}
-async function ruleGate(creativeDir, roster = liveRoster) {
-  const ad = await readAdWords(creativeDir);
-  if (!ad) return { broken: null, realOnly: null };
-  const { rules, language } = await heldRules(creativeDir, ad);
-  const people = rules.find((r) => r.check?.people === "real" && r.strength !== "prefer");
-  return {
-    broken: ruleRefusal(ruleTells(ad.lines, rules, language)),
-    realOnly: people ? {
-      rule: { id: people.id, text: people.text, ...people.source.quote ? { quote: people.source.quote } : {} },
-      avatars: await roster().catch(() => null)
-    } : null
-  };
-}
-
-export {
-  readAdWords,
-  ruleRefusal,
-  heldRules,
-  ruleGate
-};
-//# sourceMappingURL=chunk-IRDKHNKO.js.map

package/dist/chunk-IXPYC4D2.js

@@ -1,170 +0,0 @@
-import {
-  storeProductReads
-} from "./chunk-XOHLV5MO.js";
-import {
-  coverageOf,
-  readCreativeRecords,
-  readIdeas,
-  readInsights,
-  readKnowledgeCorpus,
-  readPersonaIds,
-  sameMessageRead,
-  workspaceIdeasJudge
-} from "./chunk-ABK536AV.js";
-import {
-  readAllRules
-} from "./chunk-ICHXD4IB.js";
-import {
-  IDEA_ANGLES,
-  IDEA_FORMATS,
-  checkIdeas
-} from "./chunk-AYAVYXSL.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-M7MLFR2S.js";
-import {
-  selectRules
-} from "./chunk-MF3BTAT6.js";
-import {
-  marketFromCompanyDoc
-} from "./chunk-2WZI36D3.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-L55PHMSR.js";
-
-// src/commands/creatives/ideas.ts
-import { readFile } from "fs/promises";
-import path from "path";
-import { defineCommand } from "citty";
-var BUILD_NEXT = 3;
-var DESCRIPTION = `Check and rank the ad ideas in src/creatives/_ideas/: is each backed by something a customer said (src/content/insights/), does it claim only what the Knowledge holds, is it a different ad from the others, does it fill a gap the live ads leave. Free and local.
-
-Start here, after writing 4-8 idea files (one per file: who, message, evidence, awareness, angle, shows, job, why; format only for a video or a container the person asked for; plus product: <handle> when the ad sells a store product, so the store's prices count as sourced):
-  baker creatives ideas            # ranked, with problems; build_next names the ones to make
-  baker creatives make <idea>      # then build each one in build_next
-An idea with a problem is not built until it is fixed. An idea with no evidence is an explore bet: it may be built, and says so.`;
-var ARGS = {
-  full: {
-    type: "boolean",
-    description: "Every idea with its warnings and gaps, and the allowed angle and format values",
-    required: false,
-    default: false
-  }
-};
-registerSchema({ command: "creatives.ideas", description: DESCRIPTION, args: ARGS });
-function ideasHints(report) {
-  const hints = [];
-  const toBuild = report.ideas.filter((i) => i.status === "idea");
-  if (toBuild.length === 0 && report.unreadable.length === 0) {
-    hints.push(
-      "No ideas yet. Write 4-8 files in src/creatives/_ideas/<idea>.md (who, message, evidence, awareness, angle, shows, job, why), then run this again."
-    );
-  }
-  if (report.unreadable.length > 0) {
-    hints.push(`Fix ${report.unreadable.map((u) => u.id).join(", ")}: each names what is missing or unknown.`);
-  }
-  const blocked = toBuild.filter((i) => i.problems.length > 0);
-  if (blocked.length > 0) hints.push(`Fix before building: ${blocked.map((i) => i.id).join(", ")}.`);
-  if (report.observedCount < 3) {
-    hints.push(
-      "Few customer quotes on file: run `baker research customers` so ideas stand on what customers said; until then they are explore bets."
-    );
-  } else if (toBuild.length > 0 && toBuild.every((i) => i.evidence === "explore")) {
-    hints.push("No idea cites an insight: put the insight ids that back each one in its `evidence`.");
-  }
-  const next = buildNext(report.ideas);
-  if (next.length === 1) hints.push(`Build: \`baker creatives make ${next[0]}\`.`);
-  if (next.length > 1)
-    hints.push(
-      `Build ${next.join(", ")} at once: one \`creative-producer\` per idea, all spawned in one message in the background, each given its idea id, and handle each as it returns. Never build them one after another: each render takes minutes. Edited an idea after this check? Run \`baker creatives ideas\` again first: a producer cannot build an idea with a problem.`
-    );
-  return hints;
-}
-function buildNext(ideas, count = BUILD_NEXT) {
-  const ready = ideas.filter((i) => i.status === "idea" && i.problems.length === 0);
-  const firstBet = ready.find((i) => i.evidence === "explore");
-  return ready.filter((i) => i.evidence !== "explore" || i === firstBet).slice(0, count).map((i) => i.id);
-}
-function compactIdea(check) {
-  return {
-    idea: check.id,
-    status: check.status,
-    evidence: check.evidence,
-    ...check.quote ? { quote: check.quote.length > 120 ? `${check.quote.slice(0, 117)}...` : check.quote } : {},
-    awareness: check.awareness,
-    angle: check.angle,
-    ...check.shows ? { shows: check.shows } : {},
-    ...check.format ? { format: check.format } : {},
-    platforms: check.platforms ?? "unset",
-    ...check.problems.length > 0 ? { problems: check.problems } : {},
-    ...check.warnings.length > 0 ? { warnings: check.warnings } : {}
-  };
-}
-async function ideasReport(root, opts = {}) {
-  const judge = opts.ask ? { ask: opts.ask, done: () => Promise.resolve() } : workspaceIdeasJudge(root);
-  const [{ ideas, unreadable }, insights, knowledge, personas, creatives, rules, companyDoc] = await Promise.all([
-    readIdeas(root),
-    readInsights(root, { ask: judge.ask }),
-    readKnowledgeCorpus(root),
-    readPersonaIds(root),
-    readCreativeRecords(root),
-    readAllRules(root).then((all) => selectRules(all, {})),
-    readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => null)
-  ]);
-  const language = marketFromCompanyDoc(companyDoc)?.language;
-  const [sameMessage, products] = await Promise.all([
-    sameMessageRead(ideas, judge.ask),
-    storeProductReads(
-      ideas.map((i) => i.product),
-      opts.readProduct
-    )
-  ]);
-  await judge.done();
-  const checked = checkIdeas({
-    ideas,
-    insights,
-    knowledge,
-    personas,
-    sameMessage,
-    products,
-    rules,
-    ...language ? { language } : {},
-    ...coverageOf(ideas, creatives)
-  });
-  return {
-    ideas: checked,
-    unreadable,
-    insightCount: insights.length,
-    observedCount: insights.filter((i) => i.status === "observed").length
-  };
-}
-var ideasCommand = defineCommand({
-  meta: { name: "ideas", description: DESCRIPTION },
-  args: ARGS,
-  async run({ args }) {
-    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
-    const report = await ideasReport(root);
-    const full = args.full === true;
-    writeJson({
-      ok: true,
-      data: {
-        build_next: buildNext(report.ideas),
-        ideas: full ? report.ideas : report.ideas.map(compactIdea),
-        ...report.unreadable.length > 0 ? { unreadable: report.unreadable } : {},
-        customer_quotes: { total: report.insightCount, observed: report.observedCount },
-        ...full ? { allowed: { angle: IDEA_ANGLES, format: IDEA_FORMATS } } : {}
-      },
-      hints: ideasHints(report)
-    });
-  }
-});
-
-export {
-  ideasHints,
-  buildNext,
-  compactIdea,
-  ideasReport,
-  ideasCommand
-};
-//# sourceMappingURL=chunk-IXPYC4D2.js.map

package/dist/chunk-JHEWSMOS.js

@@ -1,175 +0,0 @@
-import {
-  termsRefusalFix
-} from "./chunk-QALAJNBG.js";
-import {
-  handleConnectionError,
-  isOrganizationReadRefusal,
-  needsConnectionFix,
-  writeAdsJson,
-  writeJsonEnvelope
-} from "./chunk-X7DMNLDD.js";
-import {
-  ApiError
-} from "./chunk-4U7HXXSA.js";
-import {
-  getEnv
-} from "./chunk-GGUQP6KI.js";
-
-// ../api/src/ads-meta/permissionGates.ts
-var META_PERMISSION_NOT_ENABLED_MESSAGE = {
-  catalog: "Catalog changes need the Catalog permission for Meta \u2014 ask a Baker admin to turn it on, then reconnect Meta. Everything else on Meta keeps working: tell the user, and carry on with the rest of the job.",
-  pagePosts: "Facebook Page posts need the Page posts permission for Meta \u2014 ask a Baker admin to turn it on, then reconnect Meta. Everything else on Meta keeps working: tell the user, and carry on with the rest of the job."
-};
-var META_PERMISSION_RECONNECT_MESSAGE = {
-  catalog: "Catalog changes need the Catalog permission for Meta. It is turned on for this company, but this Meta connection was made before, so it does not hold it \u2014 ask the user to reconnect Meta in the dashboard, then try again. Everything else on Meta keeps working meanwhile.",
-  pagePosts: "Facebook Page posts need the Page posts permission for Meta. It is turned on for this company, but this Meta connection was made before, so it does not hold it \u2014 ask the user to reconnect Meta in the dashboard, then try again. Everything else on Meta keeps working meanwhile."
-};
-var META_UNREQUESTED_PERMISSION_MESSAGE = {
-  comments: "Reading and moderating comments on ads needs Meta permissions Baker's Meta connection does not ask for yet (reading people's comments and managing them on the Page). Tell the user that comment moderation happens in Meta Business Suite for now, and carry on with the rest of the job.",
-  instagramMedia: "Listing an Instagram account's posts needs a Meta permission Baker's Meta connection does not ask for yet. Ask the user for the post's link or id instead, or boost it from Meta Business Suite, and carry on."
-};
-var META_PAGE_ADS_PERMISSION_REMEDY = "A Baker admin turns it on with the lead ads switch for this company; then the user reconnects Meta in the dashboard. Tell the user, and carry on with the rest of the job.";
-function isMetaPermissionGateRefusal(message) {
-  return [
-    ...Object.values(META_PERMISSION_NOT_ENABLED_MESSAGE),
-    ...Object.values(META_PERMISSION_RECONNECT_MESSAGE),
-    ...Object.values(META_UNREQUESTED_PERMISSION_MESSAGE),
-    META_PAGE_ADS_PERMISSION_REMEDY
-  ].some((refusal) => message.includes(refusal));
-}
-
-// src/commands/ads/meta/shared.ts
-var DAY_MS = 864e5;
-function metaForbiddenFix(message) {
-  if (isMetaPermissionGateRefusal(message)) {
-    return { action: "reject", explanation: message };
-  }
-  if (message.includes("has not accepted Meta's Lead Generation Terms")) {
-    return {
-      action: "reject",
-      explanation: `${message}
-
-Meta confirmed the Page's terms status using its Page access. Give the Page owner the terms link in the error and ask them to accept it before trying the form or lead ad set again. Do not suggest reconnecting Meta for this refusal; continue with other work that does not require the form or ad set.`
-    };
-  }
-  return {
-    action: "reject",
-    explanation: [
-      message,
-      "This is a permission refusal, not a dead connection, and Meta returns the same code for two causes with opposite remedies. Tell them apart by how much else works before you answer.",
-      "If other reads on this account are ALSO refused (campaigns, ad sets, insights), the connection is short a permission it was never granted. Only the user can widen it, by reconnecting Meta from the dashboard.",
-      "If those reads work and only this object is refused, the asset (pixel/dataset, Page, or catalog) belongs to a Business the connected user holds no role in. Ad-account access does not carry asset access and reconnecting cannot grant it \u2014 the client assigns that asset to the connected user or partner in Meta Business settings, under the asset's own section (Data sources \u2192 Datasets for a pixel).",
-      "Either way do not retry the same call, and do not abort the wider job. Continue with what you can read, and state in your answer that this specific check could not run and why \u2014 never present the task as verified when this step was skipped."
-    ].join("\n\n")
-  };
-}
-function handleMetaError(err) {
-  if (err instanceof ApiError) {
-    if (needsConnectionFix(err.code, err.message)) {
-      handleConnectionError("meta_ads", err.message);
-    }
-    const terms = termsRefusalFix(err.code, err.message);
-    if (terms) {
-      writeJsonEnvelope({
-        ok: false,
-        error: { code: terms.code, message: err.message, fix: terms.fix, retryable: false }
-      });
-      process.exit(1);
-    }
-    const envelope = {
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: err.code === "FORBIDDEN" && !isOrganizationReadRefusal(err.message) ? metaForbiddenFix(err.message) : { action: "reject", explanation: err.message },
-        retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE" || err.code === "INTERNAL_ERROR"
-      }
-    };
-    writeAdsJson(envelope);
-    process.exit(1);
-  }
-  const message = err instanceof Error ? err.message : "Unexpected error";
-  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message } });
-  process.exit(1);
-}
-var ACCOUNT_ID_RE = /^(act_)?[0-9]+$/;
-function resolveAccountIdArg(args) {
-  const fromArgs = args["account-id"];
-  const id = fromArgs || getEnv().BAKER_META_AD_ACCOUNT_ID;
-  if (!id) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "MISSING_ACCOUNT_ID",
-        message: "Pass --account-id or set BAKER_META_AD_ACCOUNT_ID. Run `baker ads meta accounts` to find IDs."
-      }
-    });
-    process.exit(1);
-  }
-  if (!ACCOUNT_ID_RE.test(id)) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "INVALID_ACCOUNT_ID",
-        message: `Invalid account ID "${id}". Expected numeric ID, optionally prefixed with "act_".`
-      }
-    });
-    process.exit(1);
-  }
-  return id.startsWith("act_") ? id : `act_${id}`;
-}
-function getDateRange(args) {
-  const datePreset = args["date-preset"];
-  const since = args.since;
-  const until = args.until;
-  if (since && until) return { since, until };
-  return { datePreset: datePreset ?? "last_7d" };
-}
-function todayIso() {
-  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-}
-function daysAgoIso(days) {
-  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);
-}
-function csvOrJson(args) {
-  return args.output ?? "json";
-}
-var NAME_CONTAINS_ARG = {
-  type: "string",
-  description: "Only rows whose name contains this text, matched by Meta before anything is returned. Start here to find one entity by name: --name-contains octubre --all-statuses"
-};
-function resolveEffectiveStatus(args) {
-  if (args["all-statuses"]) {
-    return void 0;
-  }
-  const explicit = args["effective-status"];
-  if (explicit) {
-    return explicit;
-  }
-  return "ACTIVE";
-}
-function statusFilterHints(rows, effectiveStatus, noun) {
-  if (rows.length > 0 || effectiveStatus === void 0) return [];
-  if (effectiveStatus === "ACTIVE") {
-    return [
-      `No ACTIVE ${noun}. The ACTIVE filter hides paused, archived and in-review ones (under a paused campaign or ad set that is all of them), so this does NOT mean none exist. Re-run with --all-statuses before concluding there are none.`
-    ];
-  }
-  return [
-    `No ${noun} with effective_status ${effectiveStatus}. Re-run with --all-statuses to see every status before concluding there are none.`
-  ];
-}
-
-export {
-  metaForbiddenFix,
-  handleMetaError,
-  resolveAccountIdArg,
-  getDateRange,
-  todayIso,
-  daysAgoIso,
-  csvOrJson,
-  NAME_CONTAINS_ARG,
-  resolveEffectiveStatus,
-  statusFilterHints
-};
-//# sourceMappingURL=chunk-JHEWSMOS.js.map

package/dist/chunk-JNW5S4ET.js

@@ -1,125 +0,0 @@
-import {
-  apiGet
-} from "./chunk-4U7HXXSA.js";
-
-// src/commands/studio/batch.ts
-function projectBatch(generation, full) {
-  const compact = {
-    generationId: generation.generationId,
-    kind: generation.kind,
-    status: generation.status,
-    prompt: generation.prompt,
-    model: generation.model,
-    aspectRatio: generation.aspectRatio,
-    variants: generation.variants.map((variant) => ({
-      slot: variant.slot,
-      status: variant.status,
-      ...variant.imageId ? { imageId: variant.imageId } : {},
-      ...variant.videoId ? { videoId: variant.videoId } : {},
-      ...variant.url ? { url: variant.url } : {},
-      inLibrary: variant.inLibrary,
-      ...variant.error ? { error: variant.error } : {}
-    }))
-  };
-  if (!full) return compact;
-  return {
-    ...compact,
-    ...generation.skillId ? { skillId: generation.skillId } : {},
-    ...generation.imageSettings ? { imageSettings: generation.imageSettings } : {},
-    ...generation.clipSettings ? { clipSettings: generation.clipSettings } : {},
-    ...generation.referenceImageIds ? { referenceImageIds: generation.referenceImageIds } : {},
-    ...generation.chatId ? { chatId: generation.chatId } : {},
-    createdAt: generation.createdAt
-  };
-}
-function slotArg(candidates) {
-  return candidates.length === 1 ? `--slot ${candidates[0]?.slot}` : "--slot <n>";
-}
-function chooseFirst(candidates) {
-  return candidates.length === 1 ? "" : " Look at the takes and pick one \u2014 do not default to the first.";
-}
-function batchHints(generation) {
-  const id = generation.generationId;
-  if (generation.status === "running") {
-    return [
-      `Still rendering. Run \`baker studio get ${id}\` when you need the result \u2014 do not start the same batch again.`
-    ];
-  }
-  const hints = [];
-  const ready = generation.variants.filter((variant) => variant.status === "ready");
-  const failed = generation.variants.filter((variant) => variant.status === "failed");
-  if (generation.kind === "image" && ready.length > 0) {
-    hints.push(
-      'Every rendered image is already in the media library and searchable \u2014 `baker images library "<what it shows>"` finds it, and you can use its image id straight away.'
-    );
-    hints.push(
-      `Mark the take you are using: \`baker studio keep ${id} ${slotArg(ready)}\` stars it so the client reviews the right one.${chooseFirst(ready)}`
-    );
-  }
-  const unkeptClips = ready.filter((variant) => !variant.inLibrary);
-  if (generation.kind === "video" && unkeptClips.length > 0) {
-    hints.push(
-      `A clip is not usable anywhere \u2014 canvas, landing, ad \u2014 until you keep it. \`baker studio keep ${id} ${slotArg(unkeptClips)}\` puts it in the video library; takes nobody keeps are never ingested.${chooseFirst(unkeptClips)}`
-    );
-  }
-  if (generation.status === "partial" && failed.length > 0) {
-    hints.push(
-      `${failed.length === 1 ? "This take" : "These takes"} did not render \u2014 ${failed.map((variant) => `take ${variant.slot}: ${variant.error ?? "no reason given"}`).join("; ")}. Use the ones that did and carry on; do not re-run the whole batch.`
-    );
-  }
-  if (generation.status === "failed") {
-    hints.push(
-      `No take rendered \u2014 ${failed[0]?.error ?? "no reason given"}. Continue the job with a sourced or existing asset rather than stopping.`
-    );
-  }
-  return hints;
-}
-function waitingHint(outcome, generationId, maxWaitMs) {
-  const collect = `Run \`baker studio get ${generationId}\` to pick it up \u2014 the batch is still going, so do not start it again.`;
-  if (outcome.kind === "unreachable") {
-    return `The batch started and is rendering, but reading it back failed (${outcome.reason}). ${collect}`;
-  }
-  return `Still rendering after ${Math.round(maxWaitMs / 1e3)}s. ${collect}`;
-}
-var FALSEY_FLAG_VALUES = /* @__PURE__ */ new Set(["false", "0", "no", "off"]);
-function resolveMaxWaitMs(wait, maxWait, defaultMs) {
-  if (typeof wait === "string" && FALSEY_FLAG_VALUES.has(wait.trim().toLowerCase())) return 0;
-  if (wait === false) return 0;
-  if (maxWait === void 0 || maxWait === "") return defaultMs;
-  const parsed = Number(maxWait);
-  return Number.isFinite(parsed) && parsed >= 0 ? parsed : defaultMs;
-}
-var POLL_INTERVAL_MS = 3e3;
-var defaultPollDeps = {
-  get: async (generationId) => {
-    const response = await apiGet(`/api/studio/generations/${generationId}`);
-    return response.generation;
-  },
-  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
-};
-async function pollBatch(generationId, maxWaitMs, deps = defaultPollDeps) {
-  const deadline = Date.now() + maxWaitMs;
-  while (Date.now() < deadline) {
-    const generation = await deps.get(generationId);
-    if (generation.status !== "running") return generation;
-    await deps.sleep(POLL_INTERVAL_MS);
-  }
-  return null;
-}
-async function awaitBatch(generationId, maxWaitMs, deps = defaultPollDeps) {
-  try {
-    const generation = await pollBatch(generationId, maxWaitMs, deps);
-    return generation ? { kind: "settled", generation } : { kind: "still-running" };
-  } catch (error) {
-    return { kind: "unreachable", reason: error instanceof Error ? error.message : "the read failed" };
-  }
-}
-
-export {
-  projectBatch,
-  batchHints,
-  waitingHint,
-  resolveMaxWaitMs,
-  awaitBatch
-};
-//# sourceMappingURL=chunk-JNW5S4ET.js.map