@koda-sl/baker-cli 0.478.0 → 0.480.0

package/dist/chunk-AQ5WISEG.js

@@ -0,0 +1,98 @@
+import {
+  isRemoteUrl
+} from "./chunk-MI3JB5KB.js";
+import {
+  detectImageContentType,
+  uploadLocalImage
+} from "./chunk-DMVDVZJK.js";
+import {
+  IMAGE_GENERATE_MODELS,
+  MODEL_REGISTRY,
+  VIDEO_GENERATE_MODELS
+} from "./chunk-T6ATGN7Y.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+
+// src/commands/studio/modelOptions.ts
+function unionOfStringEnum(node, models, param) {
+  const values = /* @__PURE__ */ new Set();
+  for (const model of models) {
+    const schema = MODEL_REGISTRY[node][model]?.params[param];
+    if (schema?.kind === "string") for (const value of schema.enum ?? []) values.add(value);
+  }
+  return [...values];
+}
+function unionOfNumberEnum(node, models, param) {
+  const values = /* @__PURE__ */ new Set();
+  for (const model of models) {
+    const schema = MODEL_REGISTRY[node][model]?.params[param];
+    if (schema?.kind === "number") for (const value of schema.enum ?? []) values.add(value);
+  }
+  return [...values].sort((a, b) => a - b);
+}
+var IMAGE_MODEL_IDS = [...IMAGE_GENERATE_MODELS];
+var VIDEO_MODEL_IDS = [...VIDEO_GENERATE_MODELS];
+var IMAGE_SIZES = unionOfStringEnum("image_generate", IMAGE_GENERATE_MODELS, "image_size");
+var IMAGE_QUALITIES = unionOfStringEnum("image_generate", IMAGE_GENERATE_MODELS, "quality");
+var CLIP_RESOLUTIONS = unionOfStringEnum("video_generate", VIDEO_GENERATE_MODELS, "resolution");
+var CLIP_DURATIONS = unionOfNumberEnum("video_generate", VIDEO_GENERATE_MODELS, "duration");
+var CLIP_PERSON_GENERATION = unionOfStringEnum("video_generate", VIDEO_GENERATE_MODELS, "person_generation");
+
+// src/commands/studio/references.ts
+var LIBRARY_ID_RE = /^[a-z0-9]{16,}$/i;
+var FILE_EXTENSION_RE = /\.[a-z0-9]{2,5}$/i;
+var PATH_HINT_RE = /[/\\]/;
+function classify(entry) {
+  if (isRemoteUrl(entry)) return { kind: "url", value: entry };
+  if (PATH_HINT_RE.test(entry) || FILE_EXTENSION_RE.test(entry)) return { kind: "path", value: entry };
+  if (LIBRARY_ID_RE.test(entry)) return { kind: "id", value: entry };
+  throw new ApiError(
+    "VALIDATION_ERROR",
+    `"${entry}" is not a library image id, a file path, or an image URL. Pass a comma-separated mix of those.`
+  );
+}
+function parseImageRefs(spec) {
+  return spec.split(",").map((entry) => entry.trim()).filter(Boolean).map(classify);
+}
+var defaultDeps = {
+  ingest: (url) => apiPost("/api/images/ingest", { url, source: "uploaded" }),
+  upload: (path) => uploadLocalImage({ file: path, contentType: detectImageContentType(path), source: "uploaded" })
+};
+async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
+  const refs = parseImageRefs(spec);
+  if (limit && refs.length > limit.max) {
+    throw new ApiError("VALIDATION_ERROR", limit.refuse(refs.length));
+  }
+  const imageIds = [];
+  const added = [];
+  for (const ref of refs) {
+    if (ref.kind === "id") {
+      imageIds.push(ref.value);
+      continue;
+    }
+    const { imageId } = ref.kind === "url" ? await deps.ingest(ref.value) : await deps.upload(ref.value).catch(uploadFailure(ref.value));
+    imageIds.push(imageId);
+    added.push(imageId);
+  }
+  return { imageIds, added };
+}
+function uploadFailure(path) {
+  return (error) => {
+    if (error instanceof ApiError) throw error;
+    throw new ApiError("VALIDATION_ERROR", `Could not read "${path}" as an image.`);
+  };
+}
+
+export {
+  IMAGE_MODEL_IDS,
+  VIDEO_MODEL_IDS,
+  IMAGE_SIZES,
+  IMAGE_QUALITIES,
+  CLIP_RESOLUTIONS,
+  CLIP_DURATIONS,
+  CLIP_PERSON_GENERATION,
+  resolveLibraryImageIds
+};
+//# sourceMappingURL=chunk-AQ5WISEG.js.map

package/dist/chunk-AS5VL32C.js

@@ -0,0 +1,131 @@
+import {
+  holdUnbilledSpend
+} from "./chunk-5WMTPYKT.js";
+import {
+  askAboutText
+} from "./chunk-ZBV5IV5T.js";
+
+// src/engine/brand/brand-doc.ts
+import { createHash } from "crypto";
+import { mkdir, readdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { z } from "zod";
+var BRAND_DOC_MODEL = "google/gemini-3.5-flash-lite";
+var REQUEST = {
+  provider: { order: ["google-vertex"], allow_fallbacks: false },
+  seed: 0,
+  response_format: { type: "json_object" }
+};
+var PROMPT_VERSION = 3;
+var TIMEOUT_MS = 3e4;
+var BRAND_MD_CHARS = 32e3;
+var NOTE_CHARS = 600;
+var COMPANY_MD_CHARS = 4e3;
+var Font = z.object({
+  family: z.string().trim().min(1).max(60),
+  role: z.enum(["heading", "body", "any"]).catch("any"),
+  use: z.boolean()
+});
+var Color = z.object({
+  hex: z.string().trim().regex(/^#?[0-9a-fA-F]{6}$/).transform((h) => `#${h.replace(/^#/, "").toLowerCase()}`),
+  use: z.boolean()
+});
+var note = z.string().trim().min(1).max(NOTE_CHARS).nullable().optional().catch(null);
+var Reading = z.object({
+  name: z.string().trim().min(1).max(80).nullable().catch(null),
+  wordmark: z.array(z.string().trim().min(1).max(40)).catch([]),
+  logoNames: z.array(z.string().trim().min(1).max(40)).catch([]),
+  fonts: z.array(z.unknown()).catch([]),
+  colors: z.array(z.unknown()).catch([]),
+  voice: note,
+  imagery: note,
+  logoUsage: note
+});
+function brandDocPrompt(docs) {
+  return [
+    "You read a company's brand guidelines (BRAND.md), the start of its company profile (COMPANY.md) and the file names of its logos. They may be written in any language, or several. Extract only what they state; never invent a value.",
+    "",
+    "Return JSON only, in this shape:",
+    '{"name": string | null, "wordmark": string[], "logoNames": string[], "fonts": [{"family": string, "role": "heading" | "body" | "any", "use": boolean}], "colors": [{"hex": "#rrggbb", "use": boolean}], "voice": string | null, "imagery": string | null, "logoUsage": string | null}',
+    "",
+    `- name: the brand's name exactly as written ("# Zernio Brand Guidelines" names Zernio). null when neither document states one, as in an unfilled template ("# Brand Guidelines", "# Company", TODO).`,
+    `- wordmark: every word the documents say the logo prints, as they quote it ("Wordmark: \\"permut\\"" gives "permut"; 'symbol plus "Cubbo" wordmark' gives "Cubbo"), even when it is also the name. [] when they quote none.`,
+    '- logoNames: a product or brand name a logo file name carries ("logo-engage-blue.png" gives "Engage"). Colours, variants, sizes and formats (dark, white, icon, isotype, png) are not names. [] when none.',
+    `- fonts: every typeface the guidelines name, by its family name exactly, the banned ones included. role is heading, body, or any when they do not say. use is false when the guidelines ban it, forbid it or say to avoid it or never use it, in any wording or language; true when the brand uses it. Only a named typeface counts: a generic family (sans-serif, serif, monospace, system-ui) or the operating system's own fonts ("system stack", "system fonts") is not one, so leave it out.`,
+    "- colors: every hex colour the guidelines give. use is false when they ban it or say to avoid it, true when it is a brand colour.",
+    "- voice: how the brand speaks, as the guidelines put it, at most two sentences in their language. null when they do not say.",
+    "- imagery: what the brand's pictures look like and never look like (photography, illustration, people; a ```generation-style block says it too), at most two sentences in their language. null when they do not say.",
+    "- logoUsage: which logo file an ad uses and how it must appear (which file for which product, line or background, what never to do to it), at most two sentences in their language. null when they do not say.",
+    "",
+    "<brand_md>",
+    (docs.brandMd ?? "").slice(0, BRAND_MD_CHARS),
+    "</brand_md>",
+    "<company_md>",
+    (docs.companyMd ?? "").slice(0, COMPANY_MD_CHARS),
+    "</company_md>",
+    "<logo_files>",
+    (docs.logoFiles ?? []).join("\n"),
+    "</logo_files>"
+  ].join("\n");
+}
+function parseBrandDoc(answer) {
+  const parsed = Reading.safeParse(answer);
+  if (!parsed.success) return null;
+  const fonts = parsed.data.fonts.flatMap((f) => {
+    const font = Font.safeParse(f);
+    return font.success ? [font.data] : [];
+  });
+  const colors = parsed.data.colors.flatMap((c) => {
+    const color = Color.safeParse(c);
+    return color.success ? [color.data] : [];
+  });
+  const { voice, imagery, logoUsage } = parsed.data;
+  return {
+    ...parsed.data.name ? { name: parsed.data.name } : {},
+    wordmark: [.../* @__PURE__ */ new Set([...parsed.data.wordmark, ...parsed.data.logoNames])],
+    fonts,
+    colors,
+    ...voice ? { voice } : {},
+    ...imagery ? { imagery } : {},
+    ...logoUsage ? { logoUsage } : {}
+  };
+}
+function brandDocReader(cacheDir, onSpend) {
+  return async (docs) => {
+    const prompt = brandDocPrompt(docs);
+    const key = createHash("sha256").update(JSON.stringify([PROMPT_VERSION, BRAND_DOC_MODEL, prompt])).digest("hex");
+    const file = path.join(cacheDir, "brand-doc", `${key}.json`);
+    const cached = parseBrandDoc(await readFile(file, "utf8").then(JSON.parse, () => null));
+    if (cached) return cached;
+    const spent = [];
+    const answer = await askAboutText(BRAND_DOC_MODEL, prompt, (u) => onSpend ? onSpend(u) : spent.push(u), {
+      timeoutMs: TIMEOUT_MS,
+      request: REQUEST
+    }).catch(() => null);
+    await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+    const reading = parseBrandDoc(answer);
+    if (reading) {
+      await mkdir(path.dirname(file), { recursive: true }).catch(() => void 0);
+      await writeFile(file, JSON.stringify(reading), "utf8").catch(() => void 0);
+    }
+    return reading;
+  };
+}
+var LOGO_FILE = /logo|lockup|wordmark|isotype|isologo/i;
+async function workspaceBrandDocs(root) {
+  const read = (rel) => readFile(path.join(root, rel), "utf8").catch(() => null);
+  const logoFiles = (await readdir(path.join(root, "src", "brand", "logos")).catch(() => [])).filter((f) => /\.(png|jpe?g|webp|svg)$/i.test(f) && LOGO_FILE.test(f)).sort();
+  return { brandMd: await read("src/brand/BRAND.md"), companyMd: await read("COMPANY.md"), logoFiles };
+}
+async function readWorkspaceBrandDoc(root, opts = {}) {
+  const docs = await workspaceBrandDocs(root);
+  if (!docs.brandMd?.trim() && !docs.companyMd?.trim()) return null;
+  const read = opts.read ?? brandDocReader(path.join(root, "canvas", ".cache"), opts.onSpend);
+  return await read(docs).catch(() => null);
+}
+
+export {
+  LOGO_FILE,
+  readWorkspaceBrandDoc
+};
+//# sourceMappingURL=chunk-AS5VL32C.js.map

package/dist/chunk-AS5VL32C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/brand/brand-doc.ts"],"sourcesContent":["/**\n * What the brand's own documents state about it, read by a text model in whatever language they\n * are written: its name, the words its logo prints, the typefaces and colours it uses and the ones\n * it bans, how it speaks, what its pictures look like and how its logo is used. Its rules for ads\n * are read apart (`brand-rules.ts`). BRAND.md is prose, and every reader that scraped it with English words got it wrong\n * the moment it was written otherwise: \"nunca uses Inter\" read as a face to use.\n *\n * `src/brand/tokens.json` stays the canonical machine source; this is what the documents add or\n * what a workspace that predates tokens.json has. The model only extracts, pinned to one provider\n * and a seed, and each reading is kept by the documents' content, so the same documents\n * read the same on every run and cost one call per edit. Measured on scripts/brand-doc-evals.\n */\nimport { createHash } from \"node:crypto\";\nimport { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport { holdUnbilledSpend } from \"../../commands/canvas/unbilled-spend.ts\";\nimport { askAboutText, type ReviewUsage } from \"../nodes/local/lib/render-review.ts\";\n\n/**\n * Measured 2026-10-11 with scripts/brand-doc-evals: 21/21 on each of nine runs, p50 about 0.65 s\n * (2.5 Flash-Lite, which it replaces: 21/21, 0.5 s). Vertex takes no temperature for this model\n * and AI Studio, which does, fails the key's zero-data-retention guardrail, so the seed pins the draw.\n */\nexport const BRAND_DOC_MODEL = \"google/gemini-3.5-flash-lite\";\nconst REQUEST = {\n  provider: { order: [\"google-vertex\"], allow_fallbacks: false },\n  seed: 0,\n  response_format: { type: \"json_object\" },\n};\nconst PROMPT_VERSION = 3;\nconst TIMEOUT_MS = 30_000;\n/** About 8k tokens of guidelines: a brand document is shorter, and a runaway one is cut. */\nconst BRAND_MD_CHARS = 32_000;\nconst NOTE_CHARS = 600;\n/** A company profile states its name at the top. */\nconst COMPANY_MD_CHARS = 4_000;\n\nconst Font = z.object({\n  family: z.string().trim().min(1).max(60),\n  role: z.enum([\"heading\", \"body\", \"any\"]).catch(\"any\"),\n  use: z.boolean(),\n});\nconst Color = z.object({\n  hex: z\n    .string()\n    .trim()\n    .regex(/^#?[0-9a-fA-F]{6}$/)\n    .transform((h) => `#${h.replace(/^#/, \"\").toLowerCase()}`),\n  use: z.boolean(),\n});\nconst note = z.string().trim().min(1).max(NOTE_CHARS).nullable().optional().catch(null);\nconst Reading = z.object({\n  name: z.string().trim().min(1).max(80).nullable().catch(null),\n  wordmark: z.array(z.string().trim().min(1).max(40)).catch([]),\n  logoNames: z.array(z.string().trim().min(1).max(40)).catch([]),\n  fonts: z.array(z.unknown()).catch([]),\n  colors: z.array(z.unknown()).catch([]),\n  voice: note,\n  imagery: note,\n  logoUsage: note,\n});\n\nexport type BrandDocReading = {\n  name?: string;\n  /** The words the brand's logo prints, as the documents quote them or a logo file names a product. */\n  wordmark: string[];\n  fonts: Array<z.infer<typeof Font>>;\n  colors: Array<z.infer<typeof Color>>;\n  /** How the brand speaks, in the documents' words. */\n  voice?: string;\n  /** What its pictures look like and never look like. */\n  imagery?: string;\n  /** Which logo an ad uses and how it must appear. */\n  logoUsage?: string;\n};\n\nexport type BrandDocs = { brandMd?: string | null; companyMd?: string | null; logoFiles?: readonly string[] };\n\nfunction brandDocPrompt(docs: BrandDocs): string {\n  return [\n    \"You read a company's brand guidelines (BRAND.md), the start of its company profile (COMPANY.md) and the file names of its logos. They may be written in any language, or several. Extract only what they state; never invent a value.\",\n    \"\",\n    \"Return JSON only, in this shape:\",\n    '{\"name\": string | null, \"wordmark\": string[], \"logoNames\": string[], \"fonts\": [{\"family\": string, \"role\": \"heading\" | \"body\" | \"any\", \"use\": boolean}], \"colors\": [{\"hex\": \"#rrggbb\", \"use\": boolean}], \"voice\": string | null, \"imagery\": string | null, \"logoUsage\": string | null}',\n    \"\",\n    '- name: the brand\\'s name exactly as written (\"# Zernio Brand Guidelines\" names Zernio). null when neither document states one, as in an unfilled template (\"# Brand Guidelines\", \"# Company\", TODO).',\n    '- wordmark: every word the documents say the logo prints, as they quote it (\"Wordmark: \\\\\"permut\\\\\"\" gives \"permut\"; \\'symbol plus \"Cubbo\" wordmark\\' gives \"Cubbo\"), even when it is also the name. [] when they quote none.',\n    '- logoNames: a product or brand name a logo file name carries (\"logo-engage-blue.png\" gives \"Engage\"). Colours, variants, sizes and formats (dark, white, icon, isotype, png) are not names. [] when none.',\n    '- fonts: every typeface the guidelines name, by its family name exactly, the banned ones included. role is heading, body, or any when they do not say. use is false when the guidelines ban it, forbid it or say to avoid it or never use it, in any wording or language; true when the brand uses it. Only a named typeface counts: a generic family (sans-serif, serif, monospace, system-ui) or the operating system\\'s own fonts (\"system stack\", \"system fonts\") is not one, so leave it out.',\n    \"- colors: every hex colour the guidelines give. use is false when they ban it or say to avoid it, true when it is a brand colour.\",\n    \"- voice: how the brand speaks, as the guidelines put it, at most two sentences in their language. null when they do not say.\",\n    \"- imagery: what the brand's pictures look like and never look like (photography, illustration, people; a ```generation-style block says it too), at most two sentences in their language. null when they do not say.\",\n    \"- logoUsage: which logo file an ad uses and how it must appear (which file for which product, line or background, what never to do to it), at most two sentences in their language. null when they do not say.\",\n    \"\",\n    \"<brand_md>\",\n    (docs.brandMd ?? \"\").slice(0, BRAND_MD_CHARS),\n    \"</brand_md>\",\n    \"<company_md>\",\n    (docs.companyMd ?? \"\").slice(0, COMPANY_MD_CHARS),\n    \"</company_md>\",\n    \"<logo_files>\",\n    (docs.logoFiles ?? []).join(\"\\n\"),\n    \"</logo_files>\",\n  ].join(\"\\n\");\n}\n\n/** The model's answer as a reading, every entry it got wrong dropped; null when it is not one. Pure. */\nexport function parseBrandDoc(answer: unknown): BrandDocReading | null {\n  const parsed = Reading.safeParse(answer);\n  if (!parsed.success) return null;\n  const fonts = parsed.data.fonts.flatMap((f) => {\n    const font = Font.safeParse(f);\n    return font.success ? [font.data] : [];\n  });\n  const colors = parsed.data.colors.flatMap((c) => {\n    const color = Color.safeParse(c);\n    return color.success ? [color.data] : [];\n  });\n  const { voice, imagery, logoUsage } = parsed.data;\n  return {\n    ...(parsed.data.name ? { name: parsed.data.name } : {}),\n    wordmark: [...new Set([...parsed.data.wordmark, ...parsed.data.logoNames])],\n    fonts,\n    colors,\n    ...(voice ? { voice } : {}),\n    ...(imagery ? { imagery } : {}),\n    ...(logoUsage ? { logoUsage } : {}),\n  };\n}\n\n/** Reads the documents with the model, or null when it could not answer. */\nexport type ReadBrandDocs = (docs: BrandDocs) => Promise<BrandDocReading | null>;\n\n/**\n * The real reader: each reading kept in `cacheDir` by the documents, the model and the prompt.\n * Spend goes to `onSpend`, or, without one, waits in `cacheDir` for the workspace's next run\n * record to bill it.\n */\nexport function brandDocReader(cacheDir: string, onSpend?: (usage: ReviewUsage) => void): ReadBrandDocs {\n  return async (docs) => {\n    const prompt = brandDocPrompt(docs);\n    const key = createHash(\"sha256\")\n      .update(JSON.stringify([PROMPT_VERSION, BRAND_DOC_MODEL, prompt]))\n      .digest(\"hex\");\n    const file = path.join(cacheDir, \"brand-doc\", `${key}.json`);\n    const cached = parseBrandDoc(await readFile(file, \"utf8\").then(JSON.parse, () => null));\n    if (cached) return cached;\n    const spent: ReviewUsage[] = [];\n    const answer = await askAboutText(BRAND_DOC_MODEL, prompt, (u) => (onSpend ? onSpend(u) : spent.push(u)), {\n      timeoutMs: TIMEOUT_MS,\n      request: REQUEST,\n    }).catch(() => null);\n    await holdUnbilledSpend(cacheDir, spent).catch(() => undefined);\n    const reading = parseBrandDoc(answer);\n    if (reading) {\n      await mkdir(path.dirname(file), { recursive: true }).catch(() => undefined);\n      await writeFile(file, JSON.stringify(reading), \"utf8\").catch(() => undefined);\n    }\n    return reading;\n  };\n}\n\n/** A file named as the brand's own logo; a partner's or a tool's icon (`python-icon.png`) is not. */\nexport const LOGO_FILE = /logo|lockup|wordmark|isotype|isologo/i;\n\n/** BRAND.md, COMPANY.md and the brand's own logo file names in a workspace. Never throws. */\nasync function workspaceBrandDocs(root: string): Promise<BrandDocs> {\n  const read = (rel: string) => readFile(path.join(root, rel), \"utf8\").catch(() => null);\n  const logoFiles = ((await readdir(path.join(root, \"src\", \"brand\", \"logos\")).catch(() => [])) as string[])\n    .filter((f) => /\\.(png|jpe?g|webp|svg)$/i.test(f) && LOGO_FILE.test(f))\n    .sort();\n  return { brandMd: await read(\"src/brand/BRAND.md\"), companyMd: await read(\"COMPANY.md\"), logoFiles };\n}\n\n/**\n * What the workspace's brand documents state, read once per edit. Null when there is nothing to\n * read, or no model could read it: every caller then uses what code can read without one.\n */\nexport async function readWorkspaceBrandDoc(\n  root: string,\n  opts: { read?: ReadBrandDocs; onSpend?: (usage: ReviewUsage) => void } = {},\n): Promise<BrandDocReading | null> {\n  const docs = await workspaceBrandDocs(root);\n  if (!docs.brandMd?.trim() && !docs.companyMd?.trim()) return null;\n  const read = opts.read ?? brandDocReader(path.join(root, \"canvas\", \".cache\"), opts.onSpend);\n  return await read(docs).catch(() => null);\n}\n"],"mappings":";;;;;;;;AAYA,SAAS,kBAAkB;AAC3B,SAAS,OAAO,SAAS,UAAU,iBAAiB;AACpD,OAAO,UAAU;AACjB,SAAS,SAAS;AASX,IAAM,kBAAkB;AAC/B,IAAM,UAAU;AAAA,EACd,UAAU,EAAE,OAAO,CAAC,eAAe,GAAG,iBAAiB,MAAM;AAAA,EAC7D,MAAM;AAAA,EACN,iBAAiB,EAAE,MAAM,cAAc;AACzC;AACA,IAAM,iBAAiB;AACvB,IAAM,aAAa;AAEnB,IAAM,iBAAiB;AACvB,IAAM,aAAa;AAEnB,IAAM,mBAAmB;AAEzB,IAAM,OAAO,EAAE,OAAO;AAAA,EACpB,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EACvC,MAAM,EAAE,KAAK,CAAC,WAAW,QAAQ,KAAK,CAAC,EAAE,MAAM,KAAK;AAAA,EACpD,KAAK,EAAE,QAAQ;AACjB,CAAC;AACD,IAAM,QAAQ,EAAE,OAAO;AAAA,EACrB,KAAK,EACF,OAAO,EACP,KAAK,EACL,MAAM,oBAAoB,EAC1B,UAAU,CAAC,MAAM,IAAI,EAAE,QAAQ,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE;AAAA,EAC3D,KAAK,EAAE,QAAQ;AACjB,CAAC;AACD,IAAM,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,IAAI;AACtF,IAAM,UAAU,EAAE,OAAO;AAAA,EACvB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,IAAI;AAAA,EAC5D,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,EAC5D,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,EAC7D,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,EACpC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,EACrC,OAAO;AAAA,EACP,SAAS;AAAA,EACT,WAAW;AACb,CAAC;AAkBD,SAAS,eAAe,MAAyB;AAC/C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,KACC,KAAK,WAAW,IAAI,MAAM,GAAG,cAAc;AAAA,IAC5C;AAAA,IACA;AAAA,KACC,KAAK,aAAa,IAAI,MAAM,GAAG,gBAAgB;AAAA,IAChD;AAAA,IACA;AAAA,KACC,KAAK,aAAa,CAAC,GAAG,KAAK,IAAI;AAAA,IAChC;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAGO,SAAS,cAAc,QAAyC;AACrE,QAAM,SAAS,QAAQ,UAAU,MAAM;AACvC,MAAI,CAAC,OAAO,QAAS,QAAO;AAC5B,QAAM,QAAQ,OAAO,KAAK,MAAM,QAAQ,CAAC,MAAM;AAC7C,UAAM,OAAO,KAAK,UAAU,CAAC;AAC7B,WAAO,KAAK,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC;AAAA,EACvC,CAAC;AACD,QAAM,SAAS,OAAO,KAAK,OAAO,QAAQ,CAAC,MAAM;AAC/C,UAAM,QAAQ,MAAM,UAAU,CAAC;AAC/B,WAAO,MAAM,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC;AAAA,EACzC,CAAC;AACD,QAAM,EAAE,OAAO,SAAS,UAAU,IAAI,OAAO;AAC7C,SAAO;AAAA,IACL,GAAI,OAAO,KAAK,OAAO,EAAE,MAAM,OAAO,KAAK,KAAK,IAAI,CAAC;AAAA,IACrD,UAAU,CAAC,GAAG,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAK,UAAU,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC;AAAA,IAC1E;AAAA,IACA;AAAA,IACA,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,IACzB,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7B,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;AAAA,EACnC;AACF;AAUO,SAAS,eAAe,UAAkB,SAAuD;AACtG,SAAO,OAAO,SAAS;AACrB,UAAM,SAAS,eAAe,IAAI;AAClC,UAAM,MAAM,WAAW,QAAQ,EAC5B,OAAO,KAAK,UAAU,CAAC,gBAAgB,iBAAiB,MAAM,CAAC,CAAC,EAChE,OAAO,KAAK;AACf,UAAM,OAAO,KAAK,KAAK,UAAU,aAAa,GAAG,GAAG,OAAO;AAC3D,UAAM,SAAS,cAAc,MAAM,SAAS,MAAM,MAAM,EAAE,KAAK,KAAK,OAAO,MAAM,IAAI,CAAC;AACtF,QAAI,OAAQ,QAAO;AACnB,UAAM,QAAuB,CAAC;AAC9B,UAAM,SAAS,MAAM,aAAa,iBAAiB,QAAQ,CAAC,MAAO,UAAU,QAAQ,CAAC,IAAI,MAAM,KAAK,CAAC,GAAI;AAAA,MACxG,WAAW;AAAA,MACX,SAAS;AAAA,IACX,CAAC,EAAE,MAAM,MAAM,IAAI;AACnB,UAAM,kBAAkB,UAAU,KAAK,EAAE,MAAM,MAAM,MAAS;AAC9D,UAAM,UAAU,cAAc,MAAM;AACpC,QAAI,SAAS;AACX,YAAM,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC,EAAE,MAAM,MAAM,MAAS;AAC1E,YAAM,UAAU,MAAM,KAAK,UAAU,OAAO,GAAG,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,IAC9E;AACA,WAAO;AAAA,EACT;AACF;AAGO,IAAM,YAAY;AAGzB,eAAe,mBAAmB,MAAkC;AAClE,QAAM,OAAO,CAAC,QAAgB,SAAS,KAAK,KAAK,MAAM,GAAG,GAAG,MAAM,EAAE,MAAM,MAAM,IAAI;AACrF,QAAM,aAAc,MAAM,QAAQ,KAAK,KAAK,MAAM,OAAO,SAAS,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,CAAC,GACvF,OAAO,CAAC,MAAM,2BAA2B,KAAK,CAAC,KAAK,UAAU,KAAK,CAAC,CAAC,EACrE,KAAK;AACR,SAAO,EAAE,SAAS,MAAM,KAAK,oBAAoB,GAAG,WAAW,MAAM,KAAK,YAAY,GAAG,UAAU;AACrG;AAMA,eAAsB,sBACpB,MACA,OAAyE,CAAC,GACzC;AACjC,QAAM,OAAO,MAAM,mBAAmB,IAAI;AAC1C,MAAI,CAAC,KAAK,SAAS,KAAK,KAAK,CAAC,KAAK,WAAW,KAAK,EAAG,QAAO;AAC7D,QAAM,OAAO,KAAK,QAAQ,eAAe,KAAK,KAAK,MAAM,UAAU,QAAQ,GAAG,KAAK,OAAO;AAC1F,SAAO,MAAM,KAAK,IAAI,EAAE,MAAM,MAAM,IAAI;AAC1C;","names":[]}

package/dist/chunk-BFRIRZRZ.js

@@ -0,0 +1,98 @@
+import {
+  ApiError
+} from "./chunk-XDZVBX6L.js";
+
+// src/commands/research/output.ts
+var RESEARCH_DATA_NOTE = "Estimates based on third-party SERP data \u2014 not exact figures. Use for directional insights, not precise measurement.";
+function writeResearchJson(envelope) {
+  process.stdout.write(`${JSON.stringify(envelope, null, 2)}
+`);
+}
+function toCsvRow(values) {
+  return values.map((v) => {
+    if (v.includes(",") || v.includes('"') || v.includes("\n")) {
+      return `"${v.replace(/"/g, '""')}"`;
+    }
+    return v;
+  }).join(",");
+}
+function flattenRow(row) {
+  const flat = {};
+  for (const [key, val] of Object.entries(row)) {
+    flat[key] = typeof val === "object" && val !== null ? JSON.stringify(val) : String(val ?? "");
+  }
+  return flat;
+}
+function writeCsv(data, fields) {
+  if (data.length === 0) return;
+  const cols = fields ?? Object.keys(data[0] ?? {});
+  process.stdout.write(`${toCsvRow(cols)}
+`);
+  for (const row of data) {
+    const flat = flattenRow(row);
+    process.stdout.write(`${toCsvRow(cols.map((f) => flat[f] ?? ""))}
+`);
+  }
+}
+function writeJsonl(data) {
+  for (const row of data) {
+    process.stdout.write(`${JSON.stringify(row)}
+`);
+  }
+}
+function writeMd(data, fields) {
+  if (data.length === 0) return;
+  const cols = fields ?? Object.keys(data[0] ?? {});
+  process.stdout.write(`| ${cols.join(" | ")} |
+`);
+  process.stdout.write(`| ${cols.map(() => "---").join(" | ")} |
+`);
+  for (const row of data) {
+    const flat = flattenRow(row);
+    process.stdout.write(`| ${cols.map((f) => markdownCell(flat[f] ?? "")).join(" | ")} |
+`);
+  }
+}
+function markdownCell(value) {
+  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+function writeResearchOutput(data, format, fields) {
+  switch (format) {
+    case "csv":
+      writeCsv(data, fields);
+      break;
+    case "jsonl":
+      writeJsonl(data);
+      break;
+    case "md":
+      writeMd(data, fields);
+      break;
+    default:
+      writeResearchJson({ ok: true, data });
+  }
+}
+function writeResearchHints(hints, format) {
+  if (format === "json") {
+    return;
+  }
+  for (const hint of hints) {
+    process.stderr.write(`${hint}
+`);
+  }
+}
+function handleResearchError(err, fixFor) {
+  const code = err instanceof ApiError ? err.code : "NETWORK_ERROR";
+  const message = err instanceof ApiError ? err.message : err instanceof Error ? err.message : "Unexpected error";
+  const fix = fixFor?.(code);
+  writeResearchJson({ ok: false, error: { code, message, ...fix ? { fix } : {} } });
+  process.exit(1);
+}
+
+export {
+  RESEARCH_DATA_NOTE,
+  writeResearchJson,
+  writeResearchOutput,
+  writeResearchHints,
+  handleResearchError
+};
+//# sourceMappingURL=chunk-BFRIRZRZ.js.map

package/dist/chunk-BFZS3WHS.js

@@ -0,0 +1,84 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+
+// src/commands/videos/api.ts
+import { readFile } from "fs/promises";
+import { basename, extname } from "path";
+var videoProcessingTimeoutMs = 18e4;
+var videoReadyPollIntervalMs = 3e3;
+var mimeMap = {
+  ".mp4": "video/mp4",
+  ".mov": "video/quicktime",
+  ".webm": "video/webm",
+  ".avi": "video/x-msvideo",
+  ".mkv": "video/x-matroska"
+};
+var defaultVideoApiDeps = {
+  readFile,
+  post: apiPost,
+  get: apiGet,
+  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+  putFile: async (url, contentType, body) => {
+    const response = await fetch(url, { method: "PUT", headers: { "Content-Type": contentType }, body });
+    if (!response.ok) {
+      throw new ApiError("INTERNAL_ERROR", `Mux upload failed: HTTP ${response.status} ${response.statusText}`);
+    }
+  }
+};
+function isVideoFile(filePath) {
+  return mimeMap[extname(filePath).toLowerCase()] !== void 0;
+}
+function detectVideoContentType(filePath, opts = {}) {
+  const ext = extname(filePath).toLowerCase();
+  const contentType = mimeMap[ext];
+  if (!contentType || opts.allowedContentTypes && !opts.allowedContentTypes.includes(contentType)) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      opts.unsupportedMessage ?? `Cannot detect content type for extension "${ext}". Use --content-type.`
+    );
+  }
+  return contentType;
+}
+async function uploadLocalVideo(args, deps = defaultVideoApiDeps) {
+  const { uploadUrl, videoId } = await deps.post("/api/videos/upload", {
+    originalFilename: basename(args.file),
+    descriptionContext: args.descriptionContext
+  });
+  await deps.putFile(uploadUrl, args.contentType, await deps.readFile(args.file));
+  return { videoId };
+}
+var PLAYABLE_STATUSES = /* @__PURE__ */ new Set(["uploaded", "processing", "ready"]);
+async function waitForPlayableVideo(deps, videoId, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? videoProcessingTimeoutMs;
+  const pollIntervalMs = opts.pollIntervalMs ?? videoReadyPollIntervalMs;
+  const deadline = Date.now() + timeoutMs;
+  let lastStatus = "unknown";
+  while (Date.now() <= deadline) {
+    const video = await deps.get("/api/videos/get", { id: videoId });
+    lastStatus = video.status;
+    if (video.muxPlaybackId && PLAYABLE_STATUSES.has(video.status)) {
+      return video;
+    }
+    if (video.status === "error") {
+      throw new ApiError(
+        "INTERNAL_ERROR",
+        "The video library could not process this file. Export it again as an MP4 (H.264) and retry."
+      );
+    }
+    await deps.sleep(pollIntervalMs);
+  }
+  throw new ApiError("TIMEOUT", `Video was not playable before timeout; last status: ${lastStatus}`);
+}
+
+export {
+  videoProcessingTimeoutMs,
+  defaultVideoApiDeps,
+  isVideoFile,
+  detectVideoContentType,
+  uploadLocalVideo,
+  waitForPlayableVideo
+};
+//# sourceMappingURL=chunk-BFZS3WHS.js.map

package/dist/chunk-BITS62MF.js

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