@koda-sl/baker-cli 0.476.0 → 0.481.0-dev.2d33e194f

package/dist/chunk-DRPSJE62.js

@@ -1,216 +0,0 @@
-import {
-  nodeParamsPreview
-} from "./chunk-IMH2ZKKC.js";
-import {
-  creativeSlugFromCanvasPath,
-  parseDefinitionSeriesPlace,
-  parseDefinitionSourceFields,
-  parseDefinitionStrategyFields
-} from "./chunk-MSKB6I5E.js";
-import {
-  prepareCanvas
-} from "./chunk-WOLE67OJ.js";
-import {
-  BackendClient
-} from "./chunk-NDITGFPZ.js";
-import {
-  nodeDependencies
-} from "./chunk-WJOQ6IEK.js";
-import {
-  requireCredentialsFromEnv
-} from "./chunk-VPBCR6DT.js";
-
-// src/commands/canvas/sync-definition.ts
-import { readdir, readFile, stat } from "fs/promises";
-import path from "path";
-import { parseDocument } from "yaml";
-import { defineCommand } from "citty";
-
-// src/commands/canvas/definition-graph.ts
-var MAX_NODES = 300;
-var PREVIEWABLE_INGEST_EXPECTS = /* @__PURE__ */ new Set(["image"]);
-function nodeInputPreviewUrl(type, params) {
-  if (type !== "ingest" || !params || typeof params !== "object") return void 0;
-  const p = params;
-  if (p.source !== "url" || typeof p.url !== "string") return void 0;
-  if (!/^https?:\/\//i.test(p.url)) return void 0;
-  if (typeof p.expect === "string" && !PREVIEWABLE_INGEST_EXPECTS.has(p.expect)) return void 0;
-  return p.url;
-}
-function canvasToDefinitionGraph(canvas) {
-  const rawNodes = canvas?.nodes;
-  if (!Array.isArray(rawNodes)) return null;
-  const parsed = [];
-  for (const raw of rawNodes) {
-    const id = raw?.id;
-    const type = raw?.type;
-    if (typeof id !== "string" || typeof type !== "string") continue;
-    parsed.push({ id, type, inputs: raw.inputs, params: raw.params });
-    if (parsed.length >= MAX_NODES) break;
-  }
-  if (parsed.length === 0) return null;
-  const ids = new Set(parsed.map((n) => n.id));
-  const nodes = parsed.map(({ id, type, inputs, params }) => {
-    const deps = nodeDependencies({ id, inputs, params }, ids);
-    deps.delete(id);
-    const depList = [...deps];
-    const paramsPreview = nodeParamsPreview(params, depList);
-    const base = { id, type };
-    if (depList.length > 0) base.deps = depList;
-    if (paramsPreview) base.paramsPreview = paramsPreview;
-    const inputPreviewUrl = nodeInputPreviewUrl(type, params);
-    if (inputPreviewUrl) base.inputPreviewUrl = inputPreviewUrl;
-    return base;
-  });
-  const rawOutput = canvas?.output;
-  const outNode = rawOutput?.node;
-  const outSlot = rawOutput?.output;
-  const output = typeof outNode === "string" && typeof outSlot === "string" ? { node: outNode, output: outSlot } : void 0;
-  return { nodes, output };
-}
-
-// src/commands/canvas/sync-definition.ts
-function buildDefinitionSyncPayload(input, graph, chatId) {
-  const { canvas: _canvas, ...fields } = input;
-  return Object.fromEntries([
-    ...Object.entries(fields).filter(([, v]) => v !== void 0),
-    ["graph", graph],
-    ["chatId", chatId]
-  ]);
-}
-async function readDefinitionSourceFields(canvasPath) {
-  try {
-    return parseDefinitionSourceFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
-  } catch {
-    return {};
-  }
-}
-async function readDefinitionBody(canvasPath) {
-  try {
-    return { definition: await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8") };
-  } catch {
-    return {};
-  }
-}
-async function readDefinitionTitle(canvasPath) {
-  try {
-    const raw = await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8");
-    const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
-    const doc = match ? parseDocument(match[1] ?? "") : null;
-    const title = doc && doc.errors.length === 0 ? doc.get("title") : void 0;
-    return typeof title === "string" && title.trim() ? title.trim() : void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function readDefinitionStrategyFields(canvasPath) {
-  try {
-    return parseDefinitionStrategyFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
-  } catch {
-    return {};
-  }
-}
-async function readDefinitionSeriesPlace(canvasPath) {
-  try {
-    return parseDefinitionSeriesPlace(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8")) ?? {};
-  } catch {
-    return {};
-  }
-}
-async function syncCreativeDefinitionBestEffort(input) {
-  const chatId = process.env.BAKER_CHAT_ID;
-  if (!chatId) return;
-  const graph = canvasToDefinitionGraph(input.canvas);
-  if (!graph || graph.nodes.length === 0) return;
-  try {
-    const creds = requireCredentialsFromEnv();
-    const client = new BackendClient({ baseUrl: creds.url, apiKey: creds.apiKey });
-    await client.syncCreativeDefinition(buildDefinitionSyncPayload(input, graph, chatId));
-    process.stdout.write(`[definition] synced workflow graph (${graph.nodes.length} nodes) \u2014 view it in the dashboard
-`);
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e);
-    process.stderr.write(`[warn] workflow graph not synced (${msg})
-`);
-  }
-}
-async function resolveCanvasPath(inputPath) {
-  const resolved = path.resolve(inputPath);
-  let dir = resolved;
-  try {
-    if ((await stat(resolved)).isFile()) {
-      if (resolved.endsWith(".canvas.json")) return resolved;
-      dir = path.dirname(resolved);
-    }
-  } catch {
-    dir = resolved.endsWith(".canvas.json") ? path.dirname(resolved) : resolved;
-  }
-  let entries;
-  try {
-    entries = await readdir(dir);
-  } catch {
-    return null;
-  }
-  const canvases = entries.filter((name) => name.endsWith(".canvas.json"));
-  const slug = creativeSlugFromCanvasPath(`${dir}/x/`);
-  const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : void 0) ?? canvases[0];
-  return chosen ? path.join(dir, chosen) : null;
-}
-var syncDefinitionCommand = defineCommand({
-  meta: {
-    name: "sync-definition",
-    description: "Push a creative's current node-graph + input thumbnails to the dashboard without rendering. The graph has the creative's blueprint applied (prompt.json and scenes/*.json edits), exactly as `run` would render it, without changing any file. Runs automatically when you edit a creative's canvas.json or prompt.json."
-  },
-  args: {
-    file: {
-      type: "positional",
-      required: true,
-      description: "A path under src/creatives/<slug>/ (the .canvas.json, its prompt.json, or the folder)"
-    },
-    title: {
-      type: "boolean",
-      description: "Also record the title its _definition.md gives. Only for a creative just made from another (a series ad, a translation), never on an edit re-sync."
-    }
-  },
-  async run({ args }) {
-    const canvasPath = await resolveCanvasPath(String(args.file));
-    if (!canvasPath) {
-      return;
-    }
-    const slug = creativeSlugFromCanvasPath(canvasPath);
-    if (!slug) return;
-    let canvas;
-    let sourceSha;
-    try {
-      const prepared = await prepareCanvas(canvasPath, { write: false });
-      canvas = prepared.fileGraph;
-      sourceSha = prepared.sourceSha;
-    } catch {
-      return;
-    }
-    const title = args.title ? await readDefinitionTitle(canvasPath) : void 0;
-    await syncCreativeDefinitionBestEffort({
-      slug,
-      canvas,
-      sourceSha,
-      ...title ? { title } : {},
-      ...await readDefinitionSourceFields(canvasPath),
-      ...await readDefinitionStrategyFields(canvasPath),
-      ...await readDefinitionSeriesPlace(canvasPath),
-      ...await readDefinitionBody(canvasPath)
-    });
-  }
-});
-
-export {
-  buildDefinitionSyncPayload,
-  readDefinitionSourceFields,
-  readDefinitionBody,
-  readDefinitionTitle,
-  readDefinitionStrategyFields,
-  readDefinitionSeriesPlace,
-  syncCreativeDefinitionBestEffort,
-  resolveCanvasPath,
-  syncDefinitionCommand
-};
-//# sourceMappingURL=chunk-DRPSJE62.js.map

package/dist/chunk-DRPSJE62.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/canvas/sync-definition.ts","../src/commands/canvas/definition-graph.ts"],"sourcesContent":["import { readdir, readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { parseDocument } from \"yaml\";\nimport { defineCommand } from \"citty\";\nimport { BackendClient } from \"../../engine/index.ts\";\nimport { requireCredentialsFromEnv } from \"../../engine/client/env.ts\";\nimport {\n  type DefinitionSeriesPlace,\n  type DefinitionSourceFields,\n  type DefinitionStrategyFields,\n  parseDefinitionSeriesPlace,\n  parseDefinitionSourceFields,\n  parseDefinitionStrategyFields,\n} from \"./creative-definition.ts\";\nimport { canvasToDefinitionGraph } from \"./definition-graph.ts\";\nimport { prepareCanvas } from \"./prepare-canvas.ts\";\nimport { creativeSlugFromCanvasPath } from \"./run-record.ts\";\n\n/** Why the creative exists (`_definition.md` idea / message / evidence / angle / persona / awareness / hypothesis). */\ntype DefinitionSyncInput = Omit<DefinitionStrategyFields, \"seriesLead\" | \"language\"> & {\n  slug: string;\n  /** The series lead and language: omitted when not read (the backend keeps them), null when the definition names none (cleared). */\n  seriesLead?: string | null;\n  language?: string | null;\n  /** Omitted on an edit re-sync so the backend keeps the creative's existing title. */\n  title?: string;\n  platform?: string;\n  formats?: string[];\n  sourceReferenceUrl?: string;\n  /** The library ad it adapted (`_definition.md` sourceAdId / sourcePlatform / sourceAdvertiserId). */\n  sourceAdId?: string;\n  sourcePlatform?: string;\n  sourceAdvertiserId?: string;\n  canvas: unknown;\n  /** The creative's source fingerprint (`computeSourceSha`): powers the \"edited since last render\" staleness signal. */\n  sourceSha?: string;\n  /** The `_definition.md` as written, so the dashboard shows the thinking behind the ad; omitted when not read (kept). */\n  definition?: string;\n};\n\n/**\n * The body `POST /api/creatives/definition` receives. Absent fields are left out rather than\n * sent as undefined so the backend's `?? existing` keeps what an earlier sync recorded.\n */\nexport function buildDefinitionSyncPayload(\n  input: DefinitionSyncInput,\n  graph: unknown,\n  chatId: string,\n): Record<string, unknown> {\n  const { canvas: _canvas, ...fields } = input;\n  return Object.fromEntries([\n    ...Object.entries(fields).filter(([, v]) => v !== undefined),\n    [\"graph\", graph],\n    [\"chatId\", chatId],\n  ]);\n}\n\n/** The library ids the creative's `_definition.md` names, read from beside its canvas; empty when there is none. */\nexport async function readDefinitionSourceFields(canvasPath: string): Promise<DefinitionSourceFields> {\n  try {\n    return parseDefinitionSourceFields(await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\"));\n  } catch {\n    return {};\n  }\n}\n\n/** The `_definition.md` beside the canvas, whole; empty when there is none, so the last one synced is kept. */\nexport async function readDefinitionBody(canvasPath: string): Promise<{ definition?: string }> {\n  try {\n    return { definition: await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\") };\n  } catch {\n    return {};\n  }\n}\n\n/** The creative's title, read from the `_definition.md` beside its canvas; undefined when it names none. */\nexport async function readDefinitionTitle(canvasPath: string): Promise<string | undefined> {\n  try {\n    const raw = await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\");\n    const match = raw.match(/^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/);\n    const doc = match ? parseDocument(match[1] ?? \"\") : null;\n    const title = doc && doc.errors.length === 0 ? doc.get(\"title\") : undefined;\n    return typeof title === \"string\" && title.trim() ? title.trim() : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** The creative's strategy, read from the `_definition.md` beside its canvas; empty when there is none. */\nexport async function readDefinitionStrategyFields(canvasPath: string): Promise<DefinitionStrategyFields> {\n  try {\n    return parseDefinitionStrategyFields(await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\"));\n  } catch {\n    return {};\n  }\n}\n\n/** The series place the `_definition.md` beside the canvas names; empty when it cannot be read, so nothing is cleared. */\nexport async function readDefinitionSeriesPlace(canvasPath: string): Promise<DefinitionSeriesPlace | Record<never, never>> {\n  try {\n    return (\n      parseDefinitionSeriesPlace(await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\")) ?? {}\n    );\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Push a creative's parsed node-graph to the backend so the dashboard can draw\n * its workflow (and its wired input thumbnails) BEFORE — and BETWEEN — billed\n * runs. Best-effort: a missing chat id, missing creds, an unparseable canvas, or\n * a failed POST warns and returns — it must never fail the caller (a scaffold\n * that just did the real work, or a watcher reacting to an edit).\n */\nexport async function syncCreativeDefinitionBestEffort(input: DefinitionSyncInput): Promise<void> {\n  const chatId = process.env.BAKER_CHAT_ID;\n  if (!chatId) return; // Not chat-attached — nothing to preview against.\n  const graph = canvasToDefinitionGraph(input.canvas);\n  if (!graph || graph.nodes.length === 0) return;\n  try {\n    const creds = requireCredentialsFromEnv();\n    const client = new BackendClient({ baseUrl: creds.url, apiKey: creds.apiKey });\n    await client.syncCreativeDefinition(buildDefinitionSyncPayload(input, graph, chatId));\n    process.stdout.write(`[definition] synced workflow graph (${graph.nodes.length} nodes) — view it in the dashboard\\n`);\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    process.stderr.write(`[warn] workflow graph not synced (${msg})\\n`);\n  }\n}\n\n/**\n * Resolve the canvas file backing a creative from ANY path under its dir — the\n * `{slug}.canvas.json` itself, its sibling `prompt.json`, or the creative\n * directory. Lets a file watcher hand us whichever file changed and still find\n * the one canvas to project. Prefers `{slug}.canvas.json`, else the sole\n * `*.canvas.json` in the directory; null when there is no single canvas.\n */\nexport async function resolveCanvasPath(inputPath: string): Promise<string | null> {\n  const resolved = path.resolve(inputPath);\n  let dir = resolved;\n  try {\n    if ((await stat(resolved)).isFile()) {\n      if (resolved.endsWith(\".canvas.json\")) return resolved;\n      dir = path.dirname(resolved);\n    }\n  } catch {\n    // A deleted/renamed file: fall back to treating the path as its directory.\n    dir = resolved.endsWith(\".canvas.json\") ? path.dirname(resolved) : resolved;\n  }\n  let entries: string[];\n  try {\n    entries = await readdir(dir);\n  } catch {\n    return null;\n  }\n  const canvases = entries.filter((name) => name.endsWith(\".canvas.json\"));\n  const slug = creativeSlugFromCanvasPath(`${dir}/x/`);\n  const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : undefined) ?? canvases[0];\n  return chosen ? path.join(dir, chosen) : null;\n}\n\nexport const syncDefinitionCommand = defineCommand({\n  meta: {\n    name: \"sync-definition\",\n    description:\n      \"Push a creative's current node-graph + input thumbnails to the dashboard without rendering. The graph has the creative's blueprint applied (prompt.json and scenes/*.json edits), exactly as `run` would render it, without changing any file. Runs automatically when you edit a creative's canvas.json or prompt.json.\",\n  },\n  args: {\n    file: {\n      type: \"positional\",\n      required: true,\n      description: \"A path under src/creatives/<slug>/ (the .canvas.json, its prompt.json, or the folder)\",\n    },\n    title: {\n      type: \"boolean\",\n      description:\n        \"Also record the title its _definition.md gives. Only for a creative just made from another (a series ad, a translation), never on an edit re-sync.\",\n    },\n  },\n  async run({ args }) {\n    const canvasPath = await resolveCanvasPath(String(args.file));\n    if (!canvasPath) {\n      // Nothing to sync (not a creative path, or no canvas yet) — a no-op, not an error.\n      return;\n    }\n    const slug = creativeSlugFromCanvasPath(canvasPath);\n    if (!slug) return;\n    // The same preflight `run` uses, so the dashboard draws the graph that will render\n    // (the scene and copy projections included), in the file's canvas-relative spelling,\n    // never this machine's absolute paths. Read-only: the watcher runs this over every\n    // creative on every edit, and must never rewrite a creative nobody touched. The\n    // fingerprint is taken over the projected graph, as `run` and `baker canvas stale` take it.\n    let canvas: unknown;\n    let sourceSha: string | undefined;\n    try {\n      const prepared = await prepareCanvas(canvasPath, { write: false });\n      canvas = prepared.fileGraph;\n      sourceSha = prepared.sourceSha;\n    } catch {\n      // Mid-edit invalid JSON (canvas, prompt.json or a scene): skip this tick; the next\n      // save re-fires the watcher.\n      return;\n    }\n    // No title/platform/formats: an edit re-sync must never rename or re-classify\n    // the creative — the backend preserves what the scaffold already set. The library\n    // ids are re-read from `_definition.md`, so an agent that adds or fixes them after\n    // the scaffold still gets them recorded without waiting for Publish — and so is the\n    // creative's strategy, the moment the agent writes it.\n    const title = args.title ? await readDefinitionTitle(canvasPath) : undefined;\n    await syncCreativeDefinitionBestEffort({\n      slug,\n      canvas,\n      sourceSha,\n      ...(title ? { title } : {}),\n      ...(await readDefinitionSourceFields(canvasPath)),\n      ...(await readDefinitionStrategyFields(canvasPath)),\n      ...(await readDefinitionSeriesPlace(canvasPath)),\n      ...(await readDefinitionBody(canvasPath)),\n    });\n  },\n});\n","import { nodeDependencies } from \"../../engine/engine/graph.ts\";\nimport { nodeParamsPreview } from \"./node-preview.ts\";\n\nexport type DefinitionGraphNode = {\n  id: string;\n  type: string;\n  deps?: string[];\n  paramsPreview?: string;\n  /**\n   * A directly-viewable input image/video for the node BEFORE any run — today\n   * an `ingest` node's `source:\"url\"` src. Lets the dashboard show a real\n   * thumbnail (a swapped logo/hero) the moment the canvas changes, with no\n   * render. Path-source ingests carry no preview (their bytes aren't uploaded\n   * outside a run); the graph still shows the `path:` line via paramsPreview.\n   */\n  inputPreviewUrl?: string;\n};\nexport type CanvasDefinitionGraph = {\n  nodes: DefinitionGraphNode[];\n  output?: { node: string; output: string };\n};\n\n// Keep the synced blueprint bounded — matches the backend's cap.\nconst MAX_NODES = 300;\n\n// Only image ingests become a pre-run thumbnail: absent `expect` defaults to an\n// image, and a still renders unambiguously in the graph card. Video/font/json\n// ingests carry no preview (a video would need its own player wiring) — their\n// `url:`/`path:` line still shows via paramsPreview.\nconst PREVIEWABLE_INGEST_EXPECTS = new Set([\"image\"]);\n\n/**\n * A directly-viewable input URL for a node's pre-run thumbnail: an `ingest`\n * node pulling an image from a `source:\"url\"` src. Everything else (path-source\n * ingests, generators, non-image expects) returns undefined — only image bytes\n * the dashboard can already fetch become a thumbnail without a run.\n */\nfunction nodeInputPreviewUrl(type: string, params: unknown): string | undefined {\n  if (type !== \"ingest\" || !params || typeof params !== \"object\") return undefined;\n  const p = params as { source?: unknown; url?: unknown; expect?: unknown };\n  if (p.source !== \"url\" || typeof p.url !== \"string\") return undefined;\n  if (!/^https?:\\/\\//i.test(p.url)) return undefined;\n  if (typeof p.expect === \"string\" && !PREVIEWABLE_INGEST_EXPECTS.has(p.expect)) return undefined;\n  return p.url;\n}\n\n/**\n * Parse a canvas JSON into the compact node-graph the dashboard draws before any\n * run — shares the engine's `nodeDependencies` ($ref edges from inputs AND params) so\n * the pre-run blueprint matches the eventual run graph. Best-effort and defensive:\n * a not-yet-valid canvas (mid-edit) returns whatever nodes it can read, or null\n * if there are none, so a caller can skip the sync without failing the command.\n */\nexport function canvasToDefinitionGraph(canvas: unknown): CanvasDefinitionGraph | null {\n  const rawNodes = (canvas as { nodes?: unknown })?.nodes;\n  if (!Array.isArray(rawNodes)) return null;\n\n  const parsed: Array<{ id: string; type: string; inputs: unknown; params: unknown }> = [];\n  for (const raw of rawNodes) {\n    const id = (raw as { id?: unknown })?.id;\n    const type = (raw as { type?: unknown })?.type;\n    if (typeof id !== \"string\" || typeof type !== \"string\") continue;\n    parsed.push({ id, type, inputs: (raw as { inputs?: unknown }).inputs, params: (raw as { params?: unknown }).params });\n    if (parsed.length >= MAX_NODES) break;\n  }\n  if (parsed.length === 0) return null;\n\n  const ids = new Set(parsed.map((n) => n.id));\n  const nodes: DefinitionGraphNode[] = parsed.map(({ id, type, inputs, params }) => {\n    const deps = nodeDependencies({ id, inputs, params }, ids);\n    deps.delete(id);\n    const depList = [...deps];\n    // The pre-run graph carries each node's spec (model / aspect / size / expect …) +\n    // its wired props so a freshly-scaffolded creative shows full node detail in the\n    // inspector BEFORE the first billed run, matching what a run later records.\n    const paramsPreview = nodeParamsPreview(params, depList);\n    const base: DefinitionGraphNode = { id, type };\n    if (depList.length > 0) base.deps = depList;\n    if (paramsPreview) base.paramsPreview = paramsPreview;\n    const inputPreviewUrl = nodeInputPreviewUrl(type, params);\n    if (inputPreviewUrl) base.inputPreviewUrl = inputPreviewUrl;\n    return base;\n  });\n\n  const rawOutput = (canvas as { output?: unknown })?.output;\n  const outNode = (rawOutput as { node?: unknown })?.node;\n  const outSlot = (rawOutput as { output?: unknown })?.output;\n  const output =\n    typeof outNode === \"string\" && typeof outSlot === \"string\" ? { node: outNode, output: outSlot } : undefined;\n\n  return { nodes, output };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-EMDUW6QN.js

@@ -1,206 +0,0 @@
-import {
-  RESEARCH_GOOGLE_ADS_MAX_COPY
-} from "./chunk-PHY3AERY.js";
-
-// src/commands/research/hints.ts
-var AD_COPY_ROUTE = 'This returns competing domains and their SERP economics \u2014 no ad copy, no headlines, no creative. For a competitor\'s Google ads and their copy: `baker research google-ads <competitor.com> --copy` (Google\'s Ads Transparency Center: every ad, how long it has run, and the text ads\' headline and description). For Meta and LinkedIn: `baker winning-ads advertisers "<brand>"` \u2192 `baker winning-ads search "<brief>" --advertiser-id <id>` \u2192 `baker winning-ads content <adId>` (`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). Do not keep querying this command for copy.';
-function noSerpRowsHints(rowCount, queryContext) {
-  if (rowCount > 0) {
-    return [];
-  }
-  const defaulted = queryContext.location_is_default || queryContext.language_is_default;
-  if (defaulted) {
-    return [
-      `No rows for ${queryContext.location} / ${queryContext.language} \u2014 the market you did not set. Set --location and --language for the client's actual market and re-run once (\`baker research countries\` / \`baker research languages\` for the accepted codes) before you touch the keyword.`
-    ];
-  }
-  return [
-    `No rows for ${queryContext.location} / ${queryContext.language}, which you set explicitly. This term has no third-party SERP coverage in that market \u2014 move on rather than re-querying it. For demand signal try \`baker research autocomplete\`; for a competitor's actual terms, \`baker research keywords-for-site <domain>\`.`
-  ];
-}
-function advertisersHints(rowCount, queryContext) {
-  return [...noSerpRowsHints(rowCount, queryContext), AD_COPY_ROUTE];
-}
-function keywordsForSiteHints(rowCount, queryContext, typeFilter) {
-  if (rowCount > 0) {
-    return [];
-  }
-  if (typeFilter === "paid" || typeFilter === "organic") {
-    return [
-      `No rows with --type ${typeFilter} in ${queryContext.location} / ${queryContext.language}. A domain with zero ${typeFilter} keywords in a market is itself the finding \u2014 record it and move on. Confirm once with --type all (nothing at all there means the domain has no SERP coverage, not that it has no ads) instead of re-running with a different --sort or --limit.`
-    ];
-  }
-  return noSerpRowsHints(rowCount, queryContext);
-}
-var THIN_ANSWER_CHARS = 600;
-var THIN_SOURCE_COUNT = 2;
-var ESCALATION = {
-  medium: "`medium` is a quick lookup, not a search. Re-ask the SAME question once with `--depth high` before concluding the web has nothing on it.",
-  high: "`high` already thought hard about this. `--depth xhigh` is the only step left and it can run 15 minutes \u2014 take it only if this answer blocks a deliverable; otherwise record the gap and move on."
-};
-function fetchHints({
-  truncated,
-  contentChars,
-  shownChars
-}) {
-  const hints = [];
-  if (shownChars < contentChars) {
-    hints.push(
-      `Showing the first ${shownChars.toLocaleString("en-US")} of ${contentChars.toLocaleString("en-US")} characters. Re-run the same command with \`--full\` for the whole page \u2014 the read is cached for 24h, so it costs no extra time and no extra credit.`
-    );
-  }
-  if (truncated) {
-    hints.push(
-      "This page is longer than one read returns, so the end of it is missing. Don't present this as the complete page; if the part you need is further down, fetch the deeper URL directly."
-    );
-  }
-  return hints;
-}
-function webDepthHints({
-  answer,
-  sourceCount,
-  depth
-}) {
-  const thin = answer.length < THIN_ANSWER_CHARS || sourceCount <= THIN_SOURCE_COUNT;
-  const escalation = ESCALATION[depth];
-  if (!thin || !escalation) {
-    return [];
-  }
-  return [`Thin answer (${answer.length} chars, ${sourceCount} source(s)). ${escalation}`];
-}
-function keywordMetricsHints({
-  rows,
-  asked,
-  clickstream,
-  queryContext
-}) {
-  if (rows.length === 0) {
-    return noSerpRowsHints(0, queryContext);
-  }
-  const provenance = "DataForSEO resells Google's Keyword Planner volume \u2014 planner_search_volume here is the SAME number `baker ads google keywords metrics` returns, not an independent reading of it. Quoting the two as agreeing sources is not corroboration." + (clickstream ? " clickstream_search_volume IS independent (DataForSEO's own panels); when the two disagree, say which one you are quoting." : " For a genuinely independent estimate of demand, re-run with --clickstream (costs 2x), or use first-party data: `baker gsc query` for what already reaches the site, or the account's own search terms.");
-  const hints = [provenance];
-  const empty = rows.filter((row) => row.search_volume === null).map((row) => row.keyword);
-  if (empty.length > 0) {
-    hints.push(
-      `${empty.length} of ${asked.length} keywords came back with no data in ${queryContext.location} / ${queryContext.language}: ${empty.join(", ")}. That is missing coverage, NOT zero demand \u2014 do not report them as unsearched, and do not re-query them reworded. \`baker research autocomplete\` on the head term is the way to find the phrasing that market uses.`
-    );
-  }
-  return hints;
-}
-var ARCHIVE_NOTE = "Read from the Reddit archive: the words are as posted, but points and comment counts on anything under ~36h old are as first captured \u2014 don't quote those numbers as current.";
-function redditSearchHints({
-  resultCount,
-  kind,
-  source
-}) {
-  const hints = [];
-  if (resultCount === 0) {
-    hints.push(
-      'Nothing matched. Reddit search matches words, not meaning: try the audience\'s own phrasing (one distinctive word, or a seed from `baker research autocomplete`), a longer --since window, or other subreddits \u2014 `baker research reddit subreddits "<topic>"` finds where the audience actually talks' + (kind === "posts" ? ", and try --kind comments \u2014 most of the voice is in the replies." : ".")
-    );
-  } else if (kind === "posts") {
-    hints.push(
-      "Titles rarely carry the voice. Read the promising threads with `baker research reddit thread <permalink>` for the replies, or search the replies directly with --kind comments."
-    );
-  }
-  if (source === "archive" && resultCount > 0) hints.push(ARCHIVE_NOTE);
-  return hints;
-}
-function redditThreadHints({
-  commentsShown,
-  commentsAsked,
-  commentCount,
-  source
-}) {
-  const hints = [];
-  if (commentsAsked > 0 && commentsShown === 0 && (commentCount ?? 0) > 0) {
-    hints.push(
-      `This thread has ${commentCount} comments but none could be read just now. Quote the post only, and don't describe the replies.`
-    );
-  }
-  if (source === "archive") hints.push(ARCHIVE_NOTE);
-  return hints;
-}
-var REDDIT_HOST = /(^|\.)reddit\.com$|^redd\.it$/i;
-function redditSubredditsHints({ resultCount }) {
-  if (resultCount === 0) {
-    return [
-      'No subreddits matched. Try the audience\'s role or the platform they work on ("amazon flex", "deliveroo", "nurses"), one word at a time, or a web search for `site:reddit.com <topic>`.'
-    ];
-  }
-  return [
-    'Members say how big a subreddit is, not how active it is. Before mining one, run `baker research reddit search "<word>" --subreddit <name> --since <a recent date>`: nothing back means it is quiet, so pick another. `restricted` can still be read; `private` cannot.'
-  ];
-}
-var REDDIT_LINK_REJECTED = {
-  action: "reject",
-  explanation: "Do not quote anything attributed to this link \u2014 it does not lead to those words. Find the real thread with `baker research reddit search`, and if you already wrote a quote from it, remove it."
-};
-function redditPageFix(url, code) {
-  let host;
-  try {
-    host = new URL(url).hostname;
-  } catch {
-    return null;
-  }
-  if (!REDDIT_HOST.test(host)) return null;
-  if (code === "NOT_FOUND") return REDDIT_LINK_REJECTED;
-  if (code !== "FORBIDDEN") return null;
-  return {
-    action: "retry_with_changes",
-    explanation: 'Read Reddit with its own commands: `baker research reddit search "<words>" --subreddit <name>` to find what people said, `baker research reddit thread <url>` for one thread.'
-  };
-}
-function googleAdsHints({
-  target,
-  adCount,
-  located,
-  textWithoutCopy,
-  copyAsked,
-  copyUnread,
-  visual
-}) {
-  if (adCount === 0) {
-    return [
-      `No Google ads point to ${target}${located ? " in that region" : ""} \u2014 that is the answer, not a failed call: this competitor is not advertising on Google there, or its ads point to another domain. ` + (located ? "Re-run once without --location to see every region; then move on. " : "Move on. ") + `Its paid search terms, if any: \`baker research keywords-for-site ${target} --type paid\`.`
-    ];
-  }
-  const hints = [];
-  if (!copyAsked && textWithoutCopy > 0) {
-    hints.push(
-      `${textWithoutCopy} text ads came back without their words. Re-run with --copy to read the headline and description of up to ${RESEARCH_GOOGLE_ADS_MAX_COPY} (cached, so only the reading is new).`
-    );
-  }
-  const pastCap = copyAsked ? textWithoutCopy - copyUnread : 0;
-  if (pastCap > 0) {
-    hints.push(
-      `${pastCap} text ads past the first ${RESEARCH_GOOGLE_ADS_MAX_COPY} were not read \u2014 one request reads at most ${RESEARCH_GOOGLE_ADS_MAX_COPY}. Narrow with --since, --location or --platform google_search and re-run for their words.`
-    );
-  }
-  if (visual > 0 || copyUnread > 0) {
-    const without = [
-      visual > 0 ? `${visual} image or video ads (Google gives no text for those)` : "",
-      copyUnread > 0 ? `${copyUnread} text ads whose image could not be read` : ""
-    ].filter(Boolean);
-    hints.push(
-      `No copy for ${without.join(" and ")}: show those by their \`transparency_url\`. Do not open the Transparency Center in agent-browser to read them \u2014 it is the browser load this command exists to avoid.`
-    );
-  }
-  return hints;
-}
-
-export {
-  noSerpRowsHints,
-  advertisersHints,
-  keywordsForSiteHints,
-  fetchHints,
-  webDepthHints,
-  keywordMetricsHints,
-  redditSearchHints,
-  redditThreadHints,
-  redditSubredditsHints,
-  REDDIT_LINK_REJECTED,
-  redditPageFix,
-  googleAdsHints
-};
-//# sourceMappingURL=chunk-EMDUW6QN.js.map

package/dist/chunk-ENY76SPM.js

@@ -1,74 +0,0 @@
-import {
-  writeOutput
-} from "./chunk-IWLWY2UD.js";
-
-// src/commands/images/providerHits.ts
-function asRecord(value) {
-  return value && typeof value === "object" ? value : {};
-}
-function str(value) {
-  return typeof value === "string" && value.length > 0 ? value : void 0;
-}
-function num(value) {
-  return typeof value === "number" ? value : void 0;
-}
-function compactHit(hit) {
-  return {
-    source: str(hit.source) ?? "",
-    url: str(hit.url) ?? "",
-    imageId: str(hit.imageId),
-    imageUrl: str(hit.imageUrl),
-    name: str(hit.name),
-    width: num(hit.width),
-    height: num(hit.height)
-  };
-}
-function providerHitNormalizer(record, full) {
-  const compact = compactHit(record);
-  if (!full) {
-    return compact;
-  }
-  const group = asRecord(record.group);
-  return {
-    ...compact,
-    externalUrl: str(record.externalUrl),
-    externalId: str(record.externalId),
-    description: str(record.description),
-    tags: Array.isArray(record.tags) ? record.tags : [],
-    aspectRatio: num(record.aspectRatio),
-    dominantColor: str(record.dominantColor),
-    score: num(record.score),
-    deduped: typeof record.deduped === "boolean" ? record.deduped : void 0,
-    alsoInLibrary: str(record.alsoInLibrary),
-    groupKey: str(group.key)
-  };
-}
-function readOutputFlags(args) {
-  const format = typeof args.output === "string" && args.output.length > 0 ? args.output : "json";
-  const rawFields = typeof args.fields === "string" && args.fields.length > 0 ? args.fields : void 0;
-  return {
-    format,
-    fields: rawFields ? rawFields.split(",").filter(Boolean) : void 0,
-    full: args.full === true
-  };
-}
-function writeProviderHits(data, hits, args, hints) {
-  const { format, fields, full } = readOutputFlags(args);
-  const envelope = {
-    ok: true,
-    data: format === "json" ? data : hits,
-    ...hints.length > 0 ? { hints } : {}
-  };
-  writeOutput(envelope, format, fields, full, providerHitNormalizer);
-}
-var OUTPUT_ARGS = {
-  output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
-  fields: { type: "string", description: "Comma-separated field names to include", required: false },
-  full: { type: "boolean", description: "Include full metadata", required: false, default: false }
-};
-
-export {
-  writeProviderHits,
-  OUTPUT_ARGS
-};
-//# sourceMappingURL=chunk-ENY76SPM.js.map