@koda-sl/baker-cli 0.562.0 → 0.563.0-dev.25ca3cbc8

package/dist/validate-7KONBGGV.js

@@ -0,0 +1,125 @@
+import {
+  outputRatioWarningsFor,
+  shownBaseline
+} from "./chunk-BG25VWP6.js";
+import "./chunk-UL5LPRAC.js";
+import {
+  creativeSlugFromCanvasPath
+} from "./chunk-2H26UU5Y.js";
+import {
+  exitOnPrepareError,
+  prepareCanvas
+} from "./chunk-A3MZX27M.js";
+import "./chunk-ZXPFGNSJ.js";
+import "./chunk-LTUJKEAG.js";
+import "./chunk-CP6RFWLW.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-IM4HHVY6.js";
+import "./chunk-KFCN6DEX.js";
+import "./chunk-OFMFBRSL.js";
+import "./chunk-TFF2G2WU.js";
+import "./chunk-2FMORF3B.js";
+import "./chunk-LQN7REMU.js";
+import "./chunk-S5NSCPWH.js";
+import "./chunk-DWA42GNM.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-4H6XLX7E.js";
+import "./chunk-Y5PNLB24.js";
+import {
+  canvasOutputsRoot
+} from "./chunk-N3PASNUA.js";
+import {
+  defaultRegistry,
+  validateCanvasDeep
+} from "./chunk-3U4DQRFG.js";
+import "./chunk-4JZ3NS43.js";
+import "./chunk-J7IYLOPV.js";
+import "./chunk-J4LQ6GK5.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-KHVZZTWD.js";
+import "./chunk-FZJB77OK.js";
+import "./chunk-IZMSISEN.js";
+import "./chunk-UQA3ASVK.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-OVNVYNVH.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-7XFVKPE5.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  optionalTurnId
+} from "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/validate.ts
+import path from "path";
+import { defineCommand } from "citty";
+var validateCommand = defineCommand({
+  meta: {
+    name: "validate",
+    description: "Validate a canvas JSON file (no execution). Brings the canvas up to date with its prompt.json first (prompt.json and, for a video, scenes/*.json edits are written into the canvas, exactly as `run` does), then checks it: a per-node cost preview, each node's deep validators (composition meta checks for hyperframe_render/_snapshot), and each generator prompt measured with its {{slots}} filled against the model's character cap (PROMPT_OVER_MODEL_LIMIT)."
+  },
+  args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
+  async run({ args }) {
+    const filePath = path.resolve(String(args.file));
+    const slug = creativeSlugFromCanvasPath(filePath) ?? void 0;
+    const baseline = slug ? (await shownBaseline({
+      canvasRoot: canvasOutputsRoot(filePath),
+      slug,
+      creativeDir: path.dirname(filePath),
+      turnId: optionalTurnId(),
+      record: false
+    })).baseline : void 0;
+    let prepared;
+    try {
+      prepared = await prepareCanvas(filePath, {
+        gate: true,
+        log: (line) => process.stderr.write(`${line}
+`),
+        ...baseline ? { baseline } : {}
+      });
+    } catch (e) {
+      exitOnPrepareError(e);
+    }
+    const result = await validateCanvasDeep(prepared.canvas, defaultRegistry());
+    if (!result.ok) {
+      process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "validation", issues: result.issues } }, null, 2)}
+`);
+      process.exit(2);
+      return;
+    }
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          ok: true,
+          total_nodes: result.canvas.nodes.length,
+          estimated_credits: result.estimatedCredits,
+          cost_preview: result.perNodeCredits ?? [],
+          style_projection: prepared.projections.style,
+          scene_projection: prepared.projections.scenes,
+          canvas_updated: prepared.written,
+          normalized_paths: prepared.rewrites,
+          warnings: [...result.warnings ?? [], ...await outputRatioWarningsFor(prepared.canvas, filePath)]
+        },
+        null,
+        2
+      )}
+`
+    );
+  }
+});
+export {
+  validateCommand
+};
+//# sourceMappingURL=validate-7KONBGGV.js.map

package/dist/videos-3RLDBPN4.js

@@ -0,0 +1,41 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/index.ts
+import { defineCommand } from "citty";
+var videosCommand = defineCommand({
+  meta: {
+    name: "videos",
+    description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, fetch, download, describe, delete, retry, tags.
+
+Examples:
+  baker videos search "product demo" --limit 5
+  baker videos search "tutorial" --tags explainer
+  baker videos get <video-id>
+  baker videos upload ./demo.mp4
+  baker videos ingest https://www.youtube.com/watch?v=abc123
+  baker videos fetch https://www.youtube.com/watch?v=abc123 --out ./clips
+  baker videos download <video-id> --out /tmp/clips   # a library video as a local .mp4 to edit
+  baker videos describe <video-id> --description "Customer testimonial, 30s"
+  baker videos delete <video-id> --dry-run
+  baker videos retry <video-id>                    # process a failed video again
+  baker videos tags                                # list; tags create|update|delete for custom tags
+Full guide: __tooling__/docs/tools/baker/videos.md`
+  },
+  subCommands: {
+    get: () => import("./get-BQBLPGFE.js").then((m) => m.getCommand),
+    group: () => import("./group-THZPJALS.js").then((m) => m.groupCommand),
+    search: () => import("./search-QQDR74KQ.js").then((m) => m.searchCommand),
+    upload: () => import("./upload-GLNKFQYB.js").then((m) => m.uploadCommand),
+    ingest: () => import("./ingest-F4MXHO2R.js").then((m) => m.ingestCommand),
+    fetch: () => import("./fetch-KB64NPDF.js").then((m) => m.fetchCommand),
+    download: () => import("./download-2NSCKINN.js").then((m) => m.downloadCommand),
+    describe: () => import("./describe-EAPKNUUU.js").then((m) => m.describeCommand),
+    delete: () => import("./delete-46B7DSQV.js").then((m) => m.deleteCommand),
+    retry: () => import("./retry-UVVOQ3ZP.js").then((m) => m.retryCommand),
+    tags: () => import("./tags-4OJPFYHD.js").then((m) => m.tagsCommand)
+  }
+});
+export {
+  videosCommand
+};
+//# sourceMappingURL=videos-3RLDBPN4.js.map

package/dist/videos-NITQKILV.js

@@ -0,0 +1,146 @@
+import {
+  handleMetaError
+} from "./chunk-5H6N36LS.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-RBCO3C3Q.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/videos.ts
+import { createWriteStream, mkdirSync } from "fs";
+import { join } from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+
+// ../api/src/ads-meta/adVideos.ts
+import { z } from "zod";
+var metaAdVideoSchema = z.object({
+  videoId: z.string(),
+  /** Short-lived MP4 address; null when Meta does not hand the file to this connection. */
+  source: z.string().url().nullable(),
+  seconds: z.number().nullable(),
+  title: z.string().nullable(),
+  thumbnail: z.string().url().nullable()
+});
+var metaAdVideosResponseSchema = z.object({
+  adId: z.string().nullable(),
+  creativeId: z.string(),
+  videos: z.array(metaAdVideoSchema)
+});
+
+// src/commands/ads/meta/videos.ts
+import { defineCommand } from "citty";
+var DEFAULT_OUT_DIR = "/tmp/meta-ad-videos";
+function downloadHints(results) {
+  const all = results.flatMap((result) => result.videos);
+  const hints = [];
+  if (all.length === 0)
+    hints.push("No video in these ads: they are image or carousel ads (`creatives --creative-id` shows their assets).");
+  if (all.some((video) => video.file === null && video.url === void 0)) {
+    hints.push(
+      "A video with no file is a copy Meta does not hand to this connection (usually the Page's copy of the same upload); the other video of that ad is the same film."
+    );
+  }
+  if (all.some((video) => video.file !== null)) {
+    hints.push(
+      "Watch before judging: a frame strip (`ffmpeg -i <file> -vf fps=2,scale=240:-1,tile=8x2 strip.jpg`) and the 3-second hold rate from `insights --level ad --intent video`."
+    );
+  }
+  return hints;
+}
+async function download(url, file) {
+  const response = await fetch(url);
+  if (!response.ok || !response.body) throw new Error(`Meta's video address answered ${response.status}`);
+  await pipeline(Readable.fromWeb(response.body), createWriteStream(file));
+  return Number(response.headers.get("content-length") ?? 0);
+}
+async function fetchAndSave(params, outDir, save) {
+  const data = metaAdVideosResponseSchema.parse(await apiGet("/api/ads/meta/videos", params));
+  const owner = data.adId ?? data.creativeId;
+  const videos = [];
+  for (const video of data.videos) {
+    if (!video.source || !save) {
+      videos.push({
+        videoId: video.videoId,
+        file: null,
+        ...video.source ? { url: video.source } : {},
+        seconds: video.seconds,
+        megabytes: null
+      });
+      continue;
+    }
+    const file = join(outDir, `${owner}-${video.videoId}.mp4`);
+    const bytes = await download(video.source, file);
+    videos.push({
+      videoId: video.videoId,
+      file,
+      seconds: video.seconds,
+      megabytes: bytes ? Math.round(bytes / 1e5) / 10 : null
+    });
+  }
+  return { adId: data.adId, creativeId: data.creativeId, videos };
+}
+var splitIds = (value) => typeof value === "string" ? value.split(",").map((id) => id.trim()).filter(Boolean) : [];
+registerSchema({
+  command: "ads.meta.videos",
+  description: "Download the video files of running Meta ads (or creatives) to disk, to watch, cut or analyse them. One call for several ads.",
+  args: {
+    "ad-id": { type: "string", description: "Ad id, or several comma-separated", required: false },
+    "creative-id": { type: "string", description: "Creative id, or several comma-separated", required: false },
+    "out-dir": { type: "string", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})`, required: false },
+    "url-only": {
+      type: "boolean",
+      description: "Return Meta's short-lived addresses instead of files",
+      required: false
+    }
+  }
+});
+var videosCommand = defineCommand({
+  meta: {
+    name: "videos",
+    description: `Download the video files behind Meta ads, to watch, cut or analyse the company's own ads.
+  baker ads meta videos --ad-id 120211234567890,120211234567891     \u2014 MP4s in ${DEFAULT_OUT_DIR}
+  baker ads meta videos --creative-id 9988 --out-dir /tmp/ads        \u2014 by creative
+Start here when judging video ads: \`insights --level ad --intent video\` names the ads, this gets their files.`
+  },
+  args: {
+    "ad-id": { type: "string", description: "Ad id, or several comma-separated" },
+    "creative-id": { type: "string", description: "Creative id, or several comma-separated" },
+    "out-dir": { type: "string", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})` },
+    // Not `--no-download`: citty reads any `--no-x` as `x: false`, so that flag would never be set.
+    "url-only": { type: "boolean", description: "Return Meta's short-lived addresses instead of files" }
+  },
+  run: async ({ args }) => {
+    const adIds = splitIds(args["ad-id"]);
+    const creativeIds = splitIds(args["creative-id"]);
+    if (adIds.length + creativeIds.length === 0) {
+      writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message: "Name --ad-id or --creative-id" } });
+      process.exit(1);
+    }
+    const outDir = typeof args["out-dir"] === "string" ? args["out-dir"] : DEFAULT_OUT_DIR;
+    const save = !args["url-only"];
+    if (save) mkdirSync(outDir, { recursive: true });
+    try {
+      const results = [];
+      for (const id of adIds) results.push(await fetchAndSave({ "ad-id": id }, outDir, save));
+      for (const id of creativeIds) results.push(await fetchAndSave({ "creative-id": id }, outDir, save));
+      writeJsonEnvelope({ ok: true, data: results, hints: downloadHints(results) });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  downloadHints,
+  videosCommand
+};
+//# sourceMappingURL=videos-NITQKILV.js.map

package/dist/videos-NITQKILV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/videos.ts","../../api/src/ads-meta/adVideos.ts"],"sourcesContent":["import { createWriteStream, mkdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport type { ReadableStream as WebReadableStream } from \"node:stream/web\";\nimport { type MetaAdVideosResponse, metaAdVideosResponseSchema } from \"@baker/api/ads-meta/adVideos\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleMetaError } from \"./shared.ts\";\n\n/**\n * The video files behind running ads, downloaded to disk so the agent can\n * watch, cut and judge the company's own ads. Before this it pulled them out of\n * a preview's HTML in about ten steps per ad.\n */\n\nconst DEFAULT_OUT_DIR = \"/tmp/meta-ad-videos\";\n\nexport interface DownloadedVideo {\n  videoId: string;\n  file: string | null;\n  /** Only with --url-only: Meta's short-lived address, instead of a file. */\n  url?: string;\n  seconds: number | null;\n  megabytes: number | null;\n}\n\n/** One line per video: where it is on disk, or why it is not. */\nexport function downloadHints(results: ReadonlyArray<{ videos: readonly DownloadedVideo[] }>): string[] {\n  const all = results.flatMap((result) => result.videos);\n  const hints: string[] = [];\n  if (all.length === 0)\n    hints.push(\"No video in these ads: they are image or carousel ads (`creatives --creative-id` shows their assets).\");\n  if (all.some((video) => video.file === null && video.url === undefined)) {\n    hints.push(\n      \"A video with no file is a copy Meta does not hand to this connection (usually the Page's copy of the same upload); the other video of that ad is the same film.\",\n    );\n  }\n  if (all.some((video) => video.file !== null)) {\n    hints.push(\n      \"Watch before judging: a frame strip (`ffmpeg -i <file> -vf fps=2,scale=240:-1,tile=8x2 strip.jpg`) and the 3-second hold rate from `insights --level ad --intent video`.\",\n    );\n  }\n  return hints;\n}\n\nasync function download(url: string, file: string): Promise<number> {\n  const response = await fetch(url);\n  if (!response.ok || !response.body) throw new Error(`Meta's video address answered ${response.status}`);\n  await pipeline(Readable.fromWeb(response.body as WebReadableStream<Uint8Array>), createWriteStream(file));\n  return Number(response.headers.get(\"content-length\") ?? 0);\n}\n\nasync function fetchAndSave(\n  params: Record<string, string>,\n  outDir: string,\n  save: boolean,\n): Promise<{ adId: string | null; creativeId: string; videos: DownloadedVideo[] }> {\n  const data: MetaAdVideosResponse = metaAdVideosResponseSchema.parse(await apiGet(\"/api/ads/meta/videos\", params));\n  const owner = data.adId ?? data.creativeId;\n  const videos: DownloadedVideo[] = [];\n  for (const video of data.videos) {\n    if (!video.source || !save) {\n      videos.push({\n        videoId: video.videoId,\n        file: null,\n        ...(video.source ? { url: video.source } : {}),\n        seconds: video.seconds,\n        megabytes: null,\n      });\n      continue;\n    }\n    const file = join(outDir, `${owner}-${video.videoId}.mp4`);\n    const bytes = await download(video.source, file);\n    videos.push({\n      videoId: video.videoId,\n      file,\n      seconds: video.seconds,\n      megabytes: bytes ? Math.round(bytes / 1e5) / 10 : null,\n    });\n  }\n  return { adId: data.adId, creativeId: data.creativeId, videos };\n}\n\nconst splitIds = (value: unknown): string[] =>\n  typeof value === \"string\"\n    ? value\n        .split(\",\")\n        .map((id) => id.trim())\n        .filter(Boolean)\n    : [];\n\nregisterSchema({\n  command: \"ads.meta.videos\",\n  description:\n    \"Download the video files of running Meta ads (or creatives) to disk, to watch, cut or analyse them. One call for several ads.\",\n  args: {\n    \"ad-id\": { type: \"string\", description: \"Ad id, or several comma-separated\", required: false },\n    \"creative-id\": { type: \"string\", description: \"Creative id, or several comma-separated\", required: false },\n    \"out-dir\": { type: \"string\", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})`, required: false },\n    \"url-only\": {\n      type: \"boolean\",\n      description: \"Return Meta's short-lived addresses instead of files\",\n      required: false,\n    },\n  },\n});\n\nexport const videosCommand = defineCommand({\n  meta: {\n    name: \"videos\",\n    description: `Download the video files behind Meta ads, to watch, cut or analyse the company's own ads.\n  baker ads meta videos --ad-id 120211234567890,120211234567891     — MP4s in ${DEFAULT_OUT_DIR}\n  baker ads meta videos --creative-id 9988 --out-dir /tmp/ads        — by creative\nStart here when judging video ads: \\`insights --level ad --intent video\\` names the ads, this gets their files.`,\n  },\n  args: {\n    \"ad-id\": { type: \"string\", description: \"Ad id, or several comma-separated\" },\n    \"creative-id\": { type: \"string\", description: \"Creative id, or several comma-separated\" },\n    \"out-dir\": { type: \"string\", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})` },\n    // Not `--no-download`: citty reads any `--no-x` as `x: false`, so that flag would never be set.\n    \"url-only\": { type: \"boolean\", description: \"Return Meta's short-lived addresses instead of files\" },\n  },\n  run: async ({ args }) => {\n    const adIds = splitIds(args[\"ad-id\"]);\n    const creativeIds = splitIds(args[\"creative-id\"]);\n    if (adIds.length + creativeIds.length === 0) {\n      writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Name --ad-id or --creative-id\" } });\n      process.exit(1);\n    }\n    const outDir = typeof args[\"out-dir\"] === \"string\" ? args[\"out-dir\"] : DEFAULT_OUT_DIR;\n    const save = !args[\"url-only\"];\n    if (save) mkdirSync(outDir, { recursive: true });\n    try {\n      const results = [];\n      for (const id of adIds) results.push(await fetchAndSave({ \"ad-id\": id }, outDir, save));\n      for (const id of creativeIds) results.push(await fetchAndSave({ \"creative-id\": id }, outDir, save));\n      writeJsonEnvelope({ ok: true, data: results, hints: downloadHints(results) });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n","/**\n * The video files behind a running ad, so an agent can watch and cut the\n * company's own ads instead of scraping them out of a preview.\n *\n * A creative names its videos in three places, and which one depends on how\n * it was built: `video_id` on the creative itself, `object_story_spec.video_data`\n * for a single-video ad, and `asset_feed_spec.videos` for a dynamic creative\n * (Baker builds these itself). `GET /{video_id}?fields=source` then hands back\n * a short-lived MP4 address.\n */\nimport { z } from \"zod\";\n\n/** The parts of a Meta creative that can name a video. */\nexport interface CreativeVideoFields {\n  video_id?: string;\n  object_story_spec?: { video_data?: { video_id?: string } };\n  asset_feed_spec?: { videos?: Array<{ video_id?: string }> };\n}\n\n/** Every video a creative uses, each once, in the order Meta lists them. */\nexport function videoIdsOfCreative(creative: CreativeVideoFields): string[] {\n  const ids = [\n    creative.video_id,\n    creative.object_story_spec?.video_data?.video_id,\n    ...(creative.asset_feed_spec?.videos ?? []).map((video) => video.video_id),\n  ];\n  return [...new Set(ids.filter((id): id is string => typeof id === \"string\" && id.length > 0))];\n}\n\nexport const metaAdVideoSchema = z.object({\n  videoId: z.string(),\n  /** Short-lived MP4 address; null when Meta does not hand the file to this connection. */\n  source: z.string().url().nullable(),\n  seconds: z.number().nullable(),\n  title: z.string().nullable(),\n  thumbnail: z.string().url().nullable(),\n});\nexport type MetaAdVideo = z.infer<typeof metaAdVideoSchema>;\n\nexport const metaAdVideosResponseSchema = z.object({\n  adId: z.string().nullable(),\n  creativeId: z.string(),\n  videos: z.array(metaAdVideoSchema),\n});\nexport type MetaAdVideosResponse = z.infer<typeof metaAdVideosResponseSchema>;\n"],"mappings":"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","names":[]}

package/dist/viewer-check-4I7DP7LF.js

@@ -0,0 +1,83 @@
+import {
+  OFFER_READ,
+  VIEWER_CLARITY,
+  VIEWER_QUESTIONS,
+  VIEWER_REQUIRED_CLARITY,
+  ViewerAnswerSchema,
+  buildViewerPrompt,
+  checkViewer,
+  describeViewer,
+  gatewayViewerModel,
+  jevReadJudge,
+  judgeViewerAnswer,
+  liveViewerLookups,
+  misreadings,
+  personaSegments,
+  readCreativeForViewerCheck,
+  readPersonas,
+  resolveViewer,
+  sureEnough,
+  viewerCheckBeforeRender,
+  viewerCheckCacheKey,
+  viewerCheckCommand,
+  viewerCheckFailure,
+  viewerCheckSkip
+} from "./chunk-ZXPFGNSJ.js";
+import "./chunk-LTUJKEAG.js";
+import "./chunk-KFCN6DEX.js";
+import "./chunk-OFMFBRSL.js";
+import "./chunk-TFF2G2WU.js";
+import "./chunk-2FMORF3B.js";
+import "./chunk-DWA42GNM.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-4H6XLX7E.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-FZJB77OK.js";
+import "./chunk-IZMSISEN.js";
+import "./chunk-UQA3ASVK.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-OVNVYNVH.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-7XFVKPE5.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  OFFER_READ,
+  VIEWER_CLARITY,
+  VIEWER_QUESTIONS,
+  VIEWER_REQUIRED_CLARITY,
+  ViewerAnswerSchema,
+  buildViewerPrompt,
+  checkViewer,
+  describeViewer,
+  gatewayViewerModel,
+  jevReadJudge,
+  judgeViewerAnswer,
+  liveViewerLookups,
+  misreadings,
+  personaSegments,
+  readCreativeForViewerCheck,
+  readPersonas,
+  resolveViewer,
+  sureEnough,
+  viewerCheckBeforeRender,
+  viewerCheckCacheKey,
+  viewerCheckCommand,
+  viewerCheckFailure,
+  viewerCheckSkip
+};
+//# sourceMappingURL=viewer-check-4I7DP7LF.js.map

package/dist/web-GJEXXHSQ.js

@@ -0,0 +1,173 @@
+import {
+  webDepthHints,
+  webSourceHints
+} from "./chunk-AJFWK2DW.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson
+} from "./chunk-D3YAFC6K.js";
+import "./chunk-OVNVYNVH.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-7XFVKPE5.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/web.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.web",
+  description: "Search the web with AI to answer marketing questions \u2014 competitors, ICP, pricing, pain points, market trends. Each source is the page itself plus the part of the answer it backs. Depths: medium (a fast model, quick, default), high (the same model thinking longer \u2014 not a stronger model), xhigh (a deep-research agent, minutes).",
+  args: {
+    question: {
+      type: "string",
+      description: "The research question to answer using live web data",
+      required: true
+    },
+    depth: {
+      type: "string",
+      description: "Research depth: medium (quick), high (thorough), xhigh (exhaustive). Default: medium",
+      required: false,
+      enum: ["medium", "high", "xhigh"]
+    }
+  }
+});
+var TIMEOUT_MS = {
+  medium: 18e4,
+  high: 36e4,
+  xhigh: 9e5
+};
+var FIELDS = {
+  answer: "AI-generated research answer (markdown)",
+  sources: "Array of {title, url, resolved, cites}: url is the page Google read; cites are the parts of the answer that page backs (verbatim). resolved:false = an opaque Google link that could not be followed \u2014 do not cite it"
+};
+function webMarkdown(data) {
+  const lines = [data.answer];
+  if (data.sources.length > 0) {
+    lines.push("", "## Sources");
+    for (const s of data.sources) {
+      if (s.resolved === false) {
+        lines.push(`- ${s.title} \u2014 unresolved Google link, do not cite: ${s.url}`);
+        continue;
+      }
+      lines.push(`- [${s.title}](${s.url})`);
+      for (const cite of s.cites ?? []) lines.push(`  > "${cite}"`);
+    }
+  }
+  return `${lines.join("\n")}
+`;
+}
+var DEEP_RESEARCH_FINISHED = /* @__PURE__ */ new Set(["completed", "incomplete"]);
+var DEEP_RESEARCH_RUNNING = /* @__PURE__ */ new Set(["queued", "in_progress"]);
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function runDeepResearch(question) {
+  const { interactionId } = await apiPost("/api/research/deep-research/start", { question });
+  process.stderr.write(`Deep research started (${interactionId}). Polling...
+`);
+  const deadline = Date.now() + TIMEOUT_MS.xhigh;
+  while (Date.now() < deadline) {
+    await sleep(1e4);
+    const poll = await apiGet("/api/research/deep-research/poll", {
+      id: interactionId
+    });
+    if (DEEP_RESEARCH_FINISHED.has(poll.status) && poll.result) {
+      return { data: poll.result, incomplete: poll.status === "incomplete" };
+    }
+    if (!DEEP_RESEARCH_RUNNING.has(poll.status)) {
+      throw new Error(`Deep research ${poll.status}`);
+    }
+    process.stderr.write(`  status: ${poll.status}
+`);
+  }
+  throw new Error("Deep research timed out");
+}
+var webCommand = defineCommand({
+  meta: {
+    name: "web",
+    description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
+
+Depth levels:
+  medium  \u2014 Quick lookup: a fast model with minimal thinking (default)
+  high    \u2014 The SAME model and the same web search, thinking longer. Not a stronger model:
+            it reasons more over similar sources, so do not present a high answer as better-sourced.
+  xhigh   \u2014 A deep-research agent: plans, searches and reads many pages, writes a cited report
+            (minutes; use sparingly)
+
+Sources: every source is the page itself (Google's redirect links are followed for you), with
+"cites" \u2014 the parts of the answer that page is attached to, verbatim. Cite a URL only for the
+claim it backs. resolved:false means the link could not be followed: do not cite it or guess a path.
+An answer with no sources is synthesis, not a citable fact.
+
+Examples:
+  baker research web "Who are the main competitors of HubSpot CRM?"
+  baker research web "What are the top pain points for SMB CRM buyers?" --depth high
+  baker research web "Full competitive analysis of project management SaaS" --depth xhigh`
+  },
+  args: {
+    question: { type: "positional", description: "The research question", required: true },
+    depth: { type: "string", description: "Research depth: medium|high|xhigh (default: medium)", required: false },
+    output: { type: "string", description: "Format: json|md (default: json)", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const question = args.question;
+    if (question.length < 5) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Question must be at least 5 characters" }
+      });
+      process.exit(1);
+    }
+    const depth = args.depth || "medium";
+    if (!["medium", "high", "xhigh"].includes(depth)) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Depth must be one of: medium, high, xhigh" }
+      });
+      process.exit(1);
+    }
+    try {
+      const { data, incomplete } = depth === "xhigh" ? await runDeepResearch(question) : {
+        data: await apiPost(
+          "/api/research/explore",
+          { question, depth },
+          { timeoutMs: TIMEOUT_MS[depth] }
+        ),
+        incomplete: false
+      };
+      const format = args.output || "json";
+      const hints = [
+        ...webSourceHints(data.sources),
+        ...incomplete ? ["Deep research stopped at its budget, so the end of this report may be missing \u2014 say so if you use it."] : [],
+        ...webDepthHints({ answer: data.answer, sourceCount: data.sources.length, depth })
+      ];
+      if (format === "md") {
+        process.stdout.write(webMarkdown(data));
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS, hints });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  webCommand,
+  webMarkdown
+};
+//# sourceMappingURL=web-GJEXXHSQ.js.map