@koda-sl/baker-cli 0.465.0 → 0.467.0

package/dist/chunk-WHA3DDV6.js

@@ -1,96 +0,0 @@
-import {
-  ApiError,
-  apiGet,
-  apiPost
-} from "./chunk-T2MH5SCT.js";
-
-// src/commands/images/api.ts
-import { readFile } from "fs/promises";
-import { basename, extname } from "path";
-var imageProcessingTimeoutMs = 18e4;
-var imageReadyPollIntervalMs = 2e3;
-var mimeMap = {
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".webp": "image/webp",
-  ".svg": "image/svg+xml",
-  ".avif": "image/avif"
-};
-var defaultImageApiDeps = {
-  readFile,
-  post: apiPost,
-  get: apiGet,
-  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
-};
-function detectImageContentType(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 uploadLocalImage(args, deps = defaultImageApiDeps) {
-  return uploadImageBytes(
-    {
-      bytes: await deps.readFile(args.file),
-      contentType: args.contentType,
-      // Only the bytes used to be sent, so "iso27001-badge.png" arrived as an
-      // anonymous blob. The describe pass treats this as a hint, not gospel.
-      originalFilename: basename(args.file),
-      source: args.source,
-      descriptionContext: args.descriptionContext
-    },
-    deps
-  );
-}
-function uploadImageBytes(args, deps = defaultImageApiDeps) {
-  const body = {
-    base64: args.bytes.toString("base64"),
-    contentType: args.contentType,
-    originalFilename: args.originalFilename
-  };
-  if (args.source) body.source = args.source;
-  if (args.descriptionContext) body.descriptionContext = args.descriptionContext;
-  return deps.post("/api/images/upload", body, { timeoutMs: imageProcessingTimeoutMs });
-}
-function getImage(deps, imageId) {
-  return deps.get("/api/images/get", { id: imageId });
-}
-function publishImageAsCreative(deps, args) {
-  return deps.post("/api/creatives/publish", args);
-}
-async function waitForReadyImage(deps, imageId, opts = {}) {
-  const timeoutMs = opts.timeoutMs ?? imageProcessingTimeoutMs;
-  const pollIntervalMs = opts.pollIntervalMs ?? imageReadyPollIntervalMs;
-  const deadline = Date.now() + timeoutMs;
-  let lastStatus = "unknown";
-  while (Date.now() <= deadline) {
-    const image = await getImage(deps, imageId);
-    lastStatus = image.status;
-    if (image.status === "ready") {
-      return image;
-    }
-    if (image.status === "error") {
-      throw new ApiError("IMAGE_PROCESSING_ERROR", "Image processing failed");
-    }
-    await deps.sleep(pollIntervalMs);
-  }
-  throw new ApiError("TIMEOUT", `Image was not ready before timeout; last status: ${lastStatus}`);
-}
-
-export {
-  imageProcessingTimeoutMs,
-  defaultImageApiDeps,
-  detectImageContentType,
-  uploadLocalImage,
-  uploadImageBytes,
-  publishImageAsCreative,
-  waitForReadyImage
-};
-//# sourceMappingURL=chunk-WHA3DDV6.js.map

package/dist/chunk-WY6PPZO4.js

@@ -1,172 +0,0 @@
-import {
-  ACTION_TEMP_ID_PREFIX
-} from "./chunk-ZJVHZHYP.js";
-import {
-  ApiError
-} from "./chunk-T2MH5SCT.js";
-import {
-  writeJson
-} from "./chunk-SHVQFDNY.js";
-
-// src/commands/actions/tagError.ts
-var UNKNOWN_TAG_RE = /Unknown action tag\(s\): ([^.]+)\. Valid tags: ([^.]+)\./;
-function splitSlugs(list) {
-  return list.split(",").map((slug) => slug.trim()).filter((slug) => slug.length > 0);
-}
-function actionTagFix(message) {
-  const match = UNKNOWN_TAG_RE.exec(message);
-  if (!match) {
-    return null;
-  }
-  const [, unknownList, validList] = match;
-  const unknownTags = splitSlugs(unknownList ?? "");
-  const validTags = splitSlugs(validList ?? "");
-  const first = unknownTags[0];
-  if (first === void 0 || validTags.length === 0) {
-    return null;
-  }
-  return {
-    action: "retry_with_a_valid_tag",
-    explanation: `The tag(s) ${unknownTags.join(", ")} are not in this company's taxonomy. \`validTags\` below is the complete accepted set \u2014 pick from it and re-run the same command. Only mint a new tag when none of them names this work; a near-duplicate of an existing tag splits the backlog's filter instead of extending it.`,
-    unknownTags,
-    validTags,
-    mintCommand: `baker actions tags create --slug ${first} --description "<what ${first} groups>"`,
-    listCommand: "baker actions tags list"
-  };
-}
-
-// src/commands/actions/shared.ts
-function writeOk(data) {
-  writeJson({ ok: true, data: data ?? null });
-}
-function failValidation(message) {
-  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
-}
-function failApi(err) {
-  if (err instanceof ApiError) {
-    const fix = actionTagFix(err.message);
-    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
-    process.exit(1);
-  }
-  if (err instanceof Error) {
-    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-function generateTempId() {
-  return `${ACTION_TEMP_ID_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-}
-function isTempId(id) {
-  return id.startsWith(ACTION_TEMP_ID_PREFIX);
-}
-function parseTagList(value) {
-  if (typeof value !== "string") {
-    return void 0;
-  }
-  const tags = value.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
-  return [...new Set(tags)];
-}
-var ACTION_PRIORITIES = ["urgent", "high", "medium", "low"];
-function parsePriority(value, { allowClear }) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (typeof value !== "string") {
-    failValidation(
-      `--priority must be one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
-    );
-  }
-  const trimmed = value.trim().toLowerCase();
-  if (trimmed === "") {
-    if (allowClear) {
-      return null;
-    }
-    return void 0;
-  }
-  if (allowClear && (trimmed === "none" || trimmed === "clear")) {
-    return null;
-  }
-  if (ACTION_PRIORITIES.includes(trimmed)) {
-    return trimmed;
-  }
-  failValidation(
-    `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
-  );
-}
-var FAN_OUT_NUDGE_THRESHOLD = 2;
-var FAN_OUT_THRESHOLD = 3;
-function buildCreateHints({
-  advisory,
-  description,
-  tempId,
-  tags,
-  prioritySet,
-  draftCreateCount
-}) {
-  const hints = [];
-  if (advisory) {
-    hints.push(
-      `${advisory.hint} If nothing actually blocks it: baker actions draft remove ${tempId}, then do the work.`
-    );
-  }
-  if (draftCreateCount >= FAN_OUT_THRESHOLD) {
-    hints.push(
-      `${draftCreateCount} Tasks are staged in this chat. Re-read them with \`baker actions draft\`: can any be done now with a surface you already have, and do any two touch the same system (same container, same campaign, same page)? Those belong in ONE Task \u2014 fold them together with \`baker actions update\` and drop the extras with \`baker actions draft remove <tempId>\`.`
-    );
-  } else if (draftCreateCount === FAN_OUT_NUDGE_THRESHOLD) {
-    hints.push(
-      `Second Task staged in this chat. If these two land on the same system (same container, same campaign, same page) they are ONE Task \u2014 fold them with \`baker actions update\` and drop the extra with \`baker actions draft remove ${tempId}\`.`
-    );
-  }
-  hints.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);
-  if (!description) {
-    hints.push("Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)");
-  }
-  if (!tags || tags.length === 0) {
-    hints.push(
-      "MISSING --tags. This action is invisible to the backlog's tag filter. Re-run with --tags <slug,...> (`baker actions tags list` for the taxonomy, `baker actions tags create --slug <slug>` to mint) \u2014 or `baker actions update <tempId> --tags <slug,...>`."
-    );
-  }
-  if (!prioritySet) {
-    hints.push(
-      `MISSING --priority. Without it this action ranks as 'normal' (medium) in the do-first ordering, so urgent/high client work won't surface first. Re-run with --priority ${ACTION_PRIORITIES.join("|")} \u2014 or \`baker actions update <tempId> --priority <level>\`.`
-    );
-  }
-  return hints;
-}
-var ACTIONS_LIST_DEFAULT_LIMIT = 500;
-function buildListHints({ returned, limit }) {
-  if (returned < limit) {
-    return [];
-  }
-  return [
-    `This list is capped at ${limit} Tasks and came back full, so older Tasks exist that are NOT shown. Do not treat it as the whole backlog \u2014 re-run with --limit ${limit * 2} (or narrow with --status / --search).`
-  ];
-}
-function buildGetHints(detail) {
-  if (detail?.action.status !== "pending" || detail.activeChat !== null) {
-    return [];
-  }
-  return [
-    `If you are working on this Task in this chat, claim it first so the Tasks page shows it in progress: baker actions claim ${detail.action._id}`
-  ];
-}
-
-export {
-  writeOk,
-  failValidation,
-  failApi,
-  generateTempId,
-  isTempId,
-  parseTagList,
-  ACTION_PRIORITIES,
-  parsePriority,
-  buildCreateHints,
-  ACTIONS_LIST_DEFAULT_LIMIT,
-  buildListHints,
-  buildGetHints
-};
-//# sourceMappingURL=chunk-WY6PPZO4.js.map

package/dist/chunk-X7ZODEXJ.js

@@ -1,36 +0,0 @@
-// src/cache-flag.ts
-var NO_CACHE_ARG = {
-  type: "boolean",
-  description: "Skip cached results and read live from the platform (slower)",
-  required: false
-};
-var LEGACY = "--skip-cache";
-var CANONICAL = "--no-cache";
-var PARSEABLE = "--noCache";
-function respell(token, from, to) {
-  if (token === from) {
-    return [to];
-  }
-  if (!token.startsWith(`${from}=`)) {
-    return [token];
-  }
-  return token.slice(from.length + 1) === "false" ? [] : [to];
-}
-function normalizeCacheFlag(argv) {
-  return rewriteBeforeDoubleDash(argv, (token) => respell(token, LEGACY, CANONICAL));
-}
-function cacheFlagForParser(argv) {
-  return rewriteBeforeDoubleDash(argv, (token) => respell(token, CANONICAL, PARSEABLE));
-}
-function rewriteBeforeDoubleDash(argv, rewrite) {
-  const end = argv.indexOf("--");
-  const limit = end === -1 ? argv.length : end;
-  return argv.flatMap((token, index) => index >= limit ? [token] : rewrite(token));
-}
-
-export {
-  NO_CACHE_ARG,
-  normalizeCacheFlag,
-  cacheFlagForParser
-};
-//# sourceMappingURL=chunk-X7ZODEXJ.js.map

package/dist/chunk-X7ZODEXJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cache-flag.ts"],"sourcesContent":["/**\n * One way to ask for a fresh read.\n *\n * Cached reads used to be bypassed by two different flags: `--no-cache` on the\n * Google, GA4, GSC, research and X families, `--skip-cache` on LinkedIn and\n * Meta. They named the two cache layers — `--no-cache` the CLI's own disk cache,\n * `--skip-cache` the server's — which is a distinction no caller has ever wanted\n * to make: a caller asking for fresh data wants fresh data, and the layer that\n * would have answered instead is an implementation detail of ours.\n *\n * The split was not survivable once an unrecognised flag started failing the\n * call instead of being dropped. The reports runtime appends `--no-cache` for\n * `?fresh=true` and cannot know which family a report reads, so every report row\n * backed by `ads linkedin analytics` or `ads meta insights` failed on refresh —\n * silently, as an empty row. So `--no-cache` is the name, on every command that\n * caches anything, and it bypasses both layers.\n */\n\n/**\n * The declaration LinkedIn and Meta share, so `baker schema` reads the same on\n * every command in the families this rename covers. The older families still\n * carry their own wording for the same flag.\n */\nexport const NO_CACHE_ARG = {\n  type: \"boolean\",\n  description: \"Skip cached results and read live from the platform (slower)\",\n  required: false,\n} as const;\n\nconst LEGACY = \"--skip-cache\";\nconst CANONICAL = \"--no-cache\";\n/**\n * The spelling handed to the parser, and the reason this module exists twice\n * over. citty resolves a bare `--no-cache` to `cache: false` rather than filling\n * the `no-cache` arg the command declared, so every `args[\"no-cache\"]` read in\n * the CLI sees `undefined` and the flag does nothing at all — the same trap\n * `wantsAsync` in `ads/meta/insights.ts` records for `--no-async`. citty\n * registers `camelCase(name)` as an alias of every declared arg, and mri leaves\n * `--noCache` alone, so this spelling lands in `args[\"no-cache\"]` as intended.\n */\nconst PARSEABLE = \"--noCache\";\n\n/**\n * One token, respelled — and collapsed to the bare flag when it carried a value.\n *\n * `--no-cache=true` is not the same option with a value: mri's `--no-` branch\n * never splits on `=`, so the whole `cache=true` becomes the key and the flag is\n * dropped without a word. The bare flag says the same thing and survives, and\n * the one value mri read as off drops the flag rather than mis-stating it.\n */\nfunction respell(token: string, from: string, to: string): string[] {\n  if (token === from) {\n    return [to];\n  }\n  if (!token.startsWith(`${from}=`)) {\n    return [token];\n  }\n  return token.slice(from.length + 1) === \"false\" ? [] : [to];\n}\n\n/**\n * The legacy spelling, translated before anything parses it.\n *\n * Sandboxes already running carry the old tool docs until their next sync, and\n * an agent that reads `--skip-cache` there would now have its call refused —\n * turning a rename into exactly the failure the rename exists to fix. Kept for\n * one release; the guard in `cache-flag-coverage.test.ts` is what stops the\n * second spelling coming back into the commands themselves.\n */\nexport function normalizeCacheFlag(argv: string[]): string[] {\n  return rewriteBeforeDoubleDash(argv, (token) => respell(token, LEGACY, CANONICAL));\n}\n\n/**\n * The canonical spelling in the form citty can actually parse.\n *\n * Deliberately applied after `refuseUnknownFlags`, not with the rewrite above:\n * that guard quotes the token back to the caller, and a command that does not\n * take this flag should be refused in the spelling the caller typed.\n */\nexport function cacheFlagForParser(argv: string[]): string[] {\n  return rewriteBeforeDoubleDash(argv, (token) => respell(token, CANONICAL, PARSEABLE));\n}\n\n/**\n * Everything after `--` is the caller's own payload, not ours to rewrite — the\n * same boundary `unknown-flags.ts` refuses to read past.\n */\nfunction rewriteBeforeDoubleDash(argv: string[], rewrite: (token: string) => string[]): string[] {\n  const end = argv.indexOf(\"--\");\n  const limit = end === -1 ? argv.length : end;\n  return argv.flatMap((token, index) => (index >= limit ? [token] : rewrite(token)));\n}\n"],"mappings":";AAuBO,IAAM,eAAe;AAAA,EAC1B,MAAM;AAAA,EACN,aAAa;AAAA,EACb,UAAU;AACZ;AAEA,IAAM,SAAS;AACf,IAAM,YAAY;AAUlB,IAAM,YAAY;AAUlB,SAAS,QAAQ,OAAe,MAAc,IAAsB;AAClE,MAAI,UAAU,MAAM;AAClB,WAAO,CAAC,EAAE;AAAA,EACZ;AACA,MAAI,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,GAAG;AACjC,WAAO,CAAC,KAAK;AAAA,EACf;AACA,SAAO,MAAM,MAAM,KAAK,SAAS,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE;AAC5D;AAWO,SAAS,mBAAmB,MAA0B;AAC3D,SAAO,wBAAwB,MAAM,CAAC,UAAU,QAAQ,OAAO,QAAQ,SAAS,CAAC;AACnF;AASO,SAAS,mBAAmB,MAA0B;AAC3D,SAAO,wBAAwB,MAAM,CAAC,UAAU,QAAQ,OAAO,WAAW,SAAS,CAAC;AACtF;AAMA,SAAS,wBAAwB,MAAgB,SAAgD;AAC/F,QAAM,MAAM,KAAK,QAAQ,IAAI;AAC7B,QAAM,QAAQ,QAAQ,KAAK,KAAK,SAAS;AACzC,SAAO,KAAK,QAAQ,CAAC,OAAO,UAAW,SAAS,QAAQ,CAAC,KAAK,IAAI,QAAQ,KAAK,CAAE;AACnF;","names":[]}

package/dist/chunk-XD7F3BSP.js

@@ -1,51 +0,0 @@
-import {
-  failApi
-} from "./chunk-WY6PPZO4.js";
-import {
-  HUBSPOT_MISSING_GRANT_MARKER,
-  HUBSPOT_NOT_CONNECTED_MESSAGE
-} from "./chunk-ZJVHZHYP.js";
-import {
-  ApiError
-} from "./chunk-T2MH5SCT.js";
-import {
-  writeJson
-} from "./chunk-SHVQFDNY.js";
-
-// src/commands/hubspot/refusal.ts
-var CONTINUE = "Keep going with the wider task: say which part you could not read, skip it, and finish everything else. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 HubSpot.";
-function hubspotRefusal(code, message, reason = "so I can count a contact becoming a customer") {
-  if (code === "NOT_FOUND" && message.includes(HUBSPOT_NOT_CONNECTED_MESSAGE)) {
-    return {
-      code: "NO_HUBSPOT_CONNECTION",
-      fix: {
-        action: "request_connection",
-        explanation: `AGENT INSTRUCTION: HubSpot is not connected, and only the user can connect it. Call the \`request_connection\` tool with { platform: "hubspot", reason } \u2014 reason in their words, e.g. "${reason}" \u2014 and they connect it inside the chat; then run this command again. ` + CONTINUE
-      }
-    };
-  }
-  if (code === "FORBIDDEN" && message.includes(HUBSPOT_MISSING_GRANT_MARKER)) {
-    return {
-      code: "HUBSPOT_RECONNECT_REQUIRED",
-      fix: {
-        action: "request_connection",
-        explanation: 'AGENT INSTRUCTION: HubSpot is connected \u2014 do not tell the user it is missing, and do not retry. Its access does not cover this read (it was connected before Baker asked for it, or the access was withdrawn), and only the user can widen it. Call the `request_connection` tool with { platform: "hubspot", reason } naming what you need to read; the card offers them a Reconnect button. Run this command again once they have. ' + CONTINUE
-      }
-    };
-  }
-  return null;
-}
-function failNotConnected(err, reason) {
-  const refusal = err instanceof ApiError ? hubspotRefusal(err.code, err.message, reason) : null;
-  if (err instanceof ApiError && refusal !== null) {
-    writeJson({ ok: false, error: { code: refusal.code, message: err.message, fix: refusal.fix } });
-    process.exit(1);
-  }
-  failApi(err);
-}
-
-export {
-  hubspotRefusal,
-  failNotConnected
-};
-//# sourceMappingURL=chunk-XD7F3BSP.js.map

package/dist/chunk-XPFQ3RSQ.js

@@ -1,84 +0,0 @@
-import {
-  ApiError,
-  apiGet,
-  apiPost
-} from "./chunk-T2MH5SCT.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-XPFQ3RSQ.js.map

package/dist/chunk-XX5DXKEI.js

@@ -1,206 +0,0 @@
-import {
-  RESEARCH_GOOGLE_ADS_MAX_COPY
-} from "./chunk-ZJVHZHYP.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-XX5DXKEI.js.map