@koda-sl/baker-cli 0.498.0 → 0.500.0

package/dist/chunk-EHS3QWHJ.js

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

package/dist/chunk-EHS3QWHJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/research/hints.ts"],"sourcesContent":["/**\n * The `research` family shipped with no `hints[]` on any command. Everything\n * here is one nudge for one dead end that an audited run actually hit — not a\n * running commentary on healthy results.\n */\n\nimport { RESEARCH_GOOGLE_ADS_MAX_COPY, type ResearchRedditSource } from \"@baker/api\";\nimport type { QueryContext } from \"../../geo-context.ts\";\nimport type { ResearchFix } from \"./output.ts\";\n\ntype Depth = \"medium\" | \"high\" | \"xhigh\";\n\n/**\n * `advertisers` is named after advertisers and returns none of their advertising.\n * A run read the name as \"SERP ad creative\", got domain economics, and wrote \"no\n * live paid ad copy captured\" into the client's vault without ever trying the\n * command that does return copy. So this fires on every call, not just empty ones.\n */\nexport const AD_COPY_ROUTE =\n  \"This returns competing domains and their SERP economics — no ad copy, no headlines, no creative. \" +\n  \"For a competitor's Google ads and their copy: `baker research google-ads <competitor.com> --copy` \" +\n  \"(Google's Ads Transparency Center: every ad, how long it has run, and the text ads' headline and description). \" +\n  'For Meta and LinkedIn: `baker winning-ads advertisers \"<brand>\"` → ' +\n  '`baker winning-ads search \"<brief>\" --advertiser-id <id>` → `baker winning-ads content <adId>` ' +\n  \"(`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). \" +\n  \"Do not keep querying this command for copy.\";\n\n/**\n * Empty SERP data has two causes and only one is worth a second call: the wrong\n * market. Once the market was explicit, a re-query is waste — say so, because\n * \"no rows\" otherwise reads as \"reword the keyword\".\n */\nexport function noSerpRowsHints(rowCount: number, queryContext: QueryContext): string[] {\n  if (rowCount > 0) {\n    return [];\n  }\n  const defaulted = queryContext.location_is_default || queryContext.language_is_default;\n  if (defaulted) {\n    return [\n      `No rows for ${queryContext.location} / ${queryContext.language} — the market you did not set. ` +\n        \"Set --location and --language for the client's actual market and re-run once \" +\n        \"(`baker research countries` / `baker research languages` for the accepted codes) \" +\n        \"before you touch the keyword.\",\n    ];\n  }\n  return [\n    `No rows for ${queryContext.location} / ${queryContext.language}, which you set explicitly. ` +\n      \"This term has no third-party SERP coverage in that market — move on rather than re-querying it. \" +\n      \"For demand signal try `baker research autocomplete`; for a competitor's actual terms, \" +\n      \"`baker research keywords-for-site <domain>`.\",\n  ];\n}\n\nexport function advertisersHints(rowCount: number, queryContext: QueryContext): string[] {\n  return [...noSerpRowsHints(rowCount, queryContext), AD_COPY_ROUTE];\n}\n\n/**\n * \"This competitor buys no paid search\" is a real competitive answer, but it\n * arrives as an empty array that looks like a broken call — so say which it is\n * before the agent re-runs the same query with a different sort.\n */\nexport function keywordsForSiteHints(\n  rowCount: number,\n  queryContext: QueryContext,\n  typeFilter: string | undefined,\n): string[] {\n  if (rowCount > 0) {\n    return [];\n  }\n  if (typeFilter === \"paid\" || typeFilter === \"organic\") {\n    return [\n      `No rows with --type ${typeFilter} in ${queryContext.location} / ${queryContext.language}. ` +\n        `A domain with zero ${typeFilter} keywords in a market is itself the finding — record it and move on. ` +\n        \"Confirm once with --type all (nothing at all there means the domain has no SERP coverage, \" +\n        \"not that it has no ads) instead of re-running with a different --sort or --limit.\",\n    ];\n  }\n  return noSerpRowsHints(rowCount, queryContext);\n}\n\nconst THIN_ANSWER_CHARS = 600;\nconst THIN_SOURCE_COUNT = 2;\n\n// Only `medium` and `high` have somewhere to escalate to; `xhigh` is the ceiling,\n// so a thin answer there is a fact about the web, not a flag the agent forgot.\nconst ESCALATION: Partial<Record<Depth, string>> = {\n  medium:\n    \"`medium` is a quick lookup, not a search. Re-ask the SAME question once with `--depth high` before \" +\n    \"concluding the web has nothing on it.\",\n  high:\n    \"`high` already thought hard about this. `--depth xhigh` is the only step left and it can run 15 minutes — \" +\n    \"take it only if this answer blocks a deliverable; otherwise record the gap and move on.\",\n};\n\n/**\n * The one thing worth saying about a page that came back fine is that you are\n * not looking at all of it — which the content itself cannot tell you.\n */\nexport function fetchHints({\n  truncated,\n  contentChars,\n  shownChars,\n}: {\n  truncated: boolean;\n  contentChars: number;\n  shownChars: number;\n}): string[] {\n  const hints: string[] = [];\n\n  if (shownChars < contentChars) {\n    hints.push(\n      `Showing the first ${shownChars.toLocaleString(\"en-US\")} of ${contentChars.toLocaleString(\"en-US\")} characters. ` +\n        \"Re-run the same command with `--full` for the whole page — the read is cached for 24h, so it costs no extra time and no extra credit.\",\n    );\n  }\n\n  if (truncated) {\n    hints.push(\n      \"This page is longer than one read returns, so the end of it is missing. \" +\n        \"Don't present this as the complete page; if the part you need is further down, fetch the deeper URL directly.\",\n    );\n  }\n\n  return hints;\n}\n\nexport function webDepthHints({\n  answer,\n  sourceCount,\n  depth,\n}: {\n  answer: string;\n  sourceCount: number;\n  depth: Depth;\n}): string[] {\n  const thin = answer.length < THIN_ANSWER_CHARS || sourceCount <= THIN_SOURCE_COUNT;\n  const escalation = ESCALATION[depth];\n  if (!thin || !escalation) {\n    return [];\n  }\n  return [`Thin answer (${answer.length} chars, ${sourceCount} source(s)). ${escalation}`];\n}\n\n/**\n * The volume DataForSEO returns is Google's own Keyword Planner figure resold,\n * so putting the two side by side validates nothing — a run did exactly that,\n * found all seven rows agreeing to the digit, and reported the agreement as\n * corroboration. This fires on every call rather than on a suspicious one,\n * because by the time the numbers are in a table the provenance is already gone.\n */\nexport function keywordMetricsHints({\n  rows,\n  asked,\n  clickstream,\n  queryContext,\n}: {\n  rows: Array<{ keyword: string; search_volume: number | null }>;\n  asked: string[];\n  clickstream: boolean;\n  queryContext: QueryContext;\n}): string[] {\n  if (rows.length === 0) {\n    return noSerpRowsHints(0, queryContext);\n  }\n\n  const provenance =\n    \"DataForSEO resells Google's Keyword Planner volume — planner_search_volume here is the SAME number \" +\n    \"`baker ads google keywords metrics` returns, not an independent reading of it. Quoting the two as agreeing \" +\n    \"sources is not corroboration.\" +\n    (clickstream\n      ? \" clickstream_search_volume IS independent (DataForSEO's own panels); when the two disagree, say which one you are quoting.\"\n      : \" For a genuinely independent estimate of demand, re-run with --clickstream (costs 2x), or use first-party data: \" +\n        \"`baker gsc query` for what already reaches the site, or the account's own search terms.\");\n\n  const hints = [provenance];\n\n  const empty = rows.filter((row) => row.search_volume === null).map((row) => row.keyword);\n  if (empty.length > 0) {\n    hints.push(\n      `${empty.length} of ${asked.length} keywords came back with no data in ${queryContext.location} / ${queryContext.language}: ` +\n        `${empty.join(\", \")}. That is missing coverage, NOT zero demand — do not report them as unsearched, and do not ` +\n        \"re-query them reworded. `baker research autocomplete` on the head term is the way to find the phrasing that market uses.\",\n    );\n  }\n\n  return hints;\n}\n\n/**\n * The archive keeps a post's words the moment it is written and its points\n * only once it has settled, so a number on something young is not the number\n * Reddit shows. Said once, when it applies, so a count is never quoted as live.\n */\nconst ARCHIVE_NOTE =\n  \"Read from the Reddit archive: the words are as posted, but points and comment counts on anything under ~36h old are as first captured — don't quote those numbers as current.\";\n\n/**\n * An empty Reddit search is almost always a phrasing miss, not a silent\n * audience: Reddit matches words, and people write in their own. A run that\n * came back empty on a posts search also never looked at the replies, which is\n * where most of the verbatim voice is.\n */\nexport function redditSearchHints({\n  resultCount,\n  kind,\n  source,\n}: {\n  resultCount: number;\n  kind: \"posts\" | \"comments\";\n  source: ResearchRedditSource;\n}): string[] {\n  const hints: string[] = [];\n  if (resultCount === 0) {\n    hints.push(\n      \"Nothing matched. Reddit search matches words, not meaning: try the audience's own phrasing (one distinctive word, \" +\n        \"or a seed from `baker research autocomplete`), a longer --since window, or other subreddits — \" +\n        '`baker research reddit subreddits \"<topic>\"` finds where the audience actually talks' +\n        (kind === \"posts\" ? \", and try --kind comments — most of the voice is in the replies.\" : \".\"),\n    );\n  } else if (kind === \"posts\") {\n    hints.push(\n      \"Titles rarely carry the voice. Read the promising threads with `baker research reddit thread <permalink>` \" +\n        \"for the replies, or search the replies directly with --kind comments.\",\n    );\n  }\n  if (source === \"archive\" && resultCount > 0) hints.push(ARCHIVE_NOTE);\n  return hints;\n}\n\n/** A thread whose replies no source would serve is still the post — but it must not read as a thread nobody answered. */\nexport function redditThreadHints({\n  commentsShown,\n  commentsAsked,\n  commentCount,\n  source,\n}: {\n  commentsShown: number;\n  commentsAsked: number;\n  commentCount: number | null;\n  source: ResearchRedditSource;\n}): string[] {\n  const hints: string[] = [];\n  if (commentsAsked > 0 && commentsShown === 0 && (commentCount ?? 0) > 0) {\n    hints.push(\n      `This thread has ${commentCount} comments but none could be read just now. Quote the post only, and don't describe the replies.`,\n    );\n  }\n  if (source === \"archive\") hints.push(ARCHIVE_NOTE);\n  return hints;\n}\n\nconst REDDIT_HOST = /(^|\\.)reddit\\.com$|^redd\\.it$/i;\n\n/**\n * A subreddit's member count is its size, not its pulse. The run that prompted\n * this command mined r/CouriersUK — a real subreddit, with one post in its whole\n * history — and found nothing. One dated search tells a living subreddit from a\n * dead one before it is relied on.\n */\nexport function redditSubredditsHints({ resultCount }: { resultCount: number }): string[] {\n  if (resultCount === 0) {\n    return [\n      '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>`.',\n    ];\n  }\n  return [\n    '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.',\n  ];\n}\n\n/** A Reddit link that does not lead to the words attributed to it. Shared by `reddit thread` and `fetch`. */\nexport const REDDIT_LINK_REJECTED: ResearchFix = {\n  action: \"reject\",\n  explanation:\n    \"Do not quote anything attributed to this link — 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.\",\n};\n\n/**\n * `research fetch` hands a Reddit URL to the Reddit reader, but its generic\n * remediation was written for ordinary pages: FORBIDDEN reads \"this will not\n * open, carry on without it\" and NOT_FOUND \"carry on\". For Reddit both are the\n * wrong advice. A page the reader will not turn into a thread is one `reddit`\n * command away, and a link that leads nowhere real must not be quoted at all.\n */\nexport function redditPageFix(url: string, code: string): ResearchFix | null {\n  let host: string;\n  try {\n    host = new URL(url).hostname;\n  } catch {\n    return null;\n  }\n  if (!REDDIT_HOST.test(host)) return null;\n  if (code === \"NOT_FOUND\") return REDDIT_LINK_REJECTED;\n  if (code !== \"FORBIDDEN\") return null;\n  return {\n    action: \"retry_with_changes\",\n    explanation:\n      '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.',\n  };\n}\n\n/**\n * `google-ads` replaces a browser trip through Google's Ads Transparency\n * Center, so its hints keep the agent out of one: no ads is an answer, and an\n * ad whose copy Google does not give is shown by its link, never opened.\n */\nexport function googleAdsHints({\n  target,\n  adCount,\n  located,\n  textWithoutCopy,\n  copyAsked,\n  copyUnread,\n  visual,\n}: {\n  target: string;\n  adCount: number;\n  located: boolean;\n  textWithoutCopy: number;\n  copyAsked: boolean;\n  copyUnread: number;\n  visual: number;\n}): string[] {\n  if (adCount === 0) {\n    return [\n      `No Google ads point to ${target}${located ? \" in that region\" : \"\"} — that is the answer, not a failed call: ` +\n        \"this competitor is not advertising on Google there, or its ads point to another domain. \" +\n        (located ? \"Re-run once without --location to see every region; then move on. \" : \"Move on. \") +\n        `Its paid search terms, if any: \\`baker research keywords-for-site ${target} --type paid\\`.`,\n    ];\n  }\n  const hints: string[] = [];\n  if (!copyAsked && textWithoutCopy > 0) {\n    hints.push(\n      `${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).`,\n    );\n  }\n  const pastCap = copyAsked ? textWithoutCopy - copyUnread : 0;\n  if (pastCap > 0) {\n    hints.push(\n      `${pastCap} text ads past the first ${RESEARCH_GOOGLE_ADS_MAX_COPY} were not read — one request reads at most ${RESEARCH_GOOGLE_ADS_MAX_COPY}. ` +\n        \"Narrow with --since, --location or --platform google_search and re-run for their words.\",\n    );\n  }\n  if (visual > 0 || copyUnread > 0) {\n    const without = [\n      visual > 0 ? `${visual} image or video ads (Google gives no text for those)` : \"\",\n      copyUnread > 0 ? `${copyUnread} text ads whose image could not be read` : \"\",\n    ].filter(Boolean);\n    hints.push(\n      `No copy for ${without.join(\" and \")}: show those by their \\`transparency_url\\`. ` +\n        \"Do not open the Transparency Center in agent-browser to read them — it is the browser load this command exists to avoid.\",\n    );\n  }\n  return hints;\n}\n"],"mappings":";;;;;AAkBO,IAAM,gBACX;AAaK,SAAS,gBAAgB,UAAkB,cAAsC;AACtF,MAAI,WAAW,GAAG;AAChB,WAAO,CAAC;AAAA,EACV;AACA,QAAM,YAAY,aAAa,uBAAuB,aAAa;AACnE,MAAI,WAAW;AACb,WAAO;AAAA,MACL,eAAe,aAAa,QAAQ,MAAM,aAAa,QAAQ;AAAA,IAIjE;AAAA,EACF;AACA,SAAO;AAAA,IACL,eAAe,aAAa,QAAQ,MAAM,aAAa,QAAQ;AAAA,EAIjE;AACF;AAEO,SAAS,iBAAiB,UAAkB,cAAsC;AACvF,SAAO,CAAC,GAAG,gBAAgB,UAAU,YAAY,GAAG,aAAa;AACnE;AAOO,SAAS,qBACd,UACA,cACA,YACU;AACV,MAAI,WAAW,GAAG;AAChB,WAAO,CAAC;AAAA,EACV;AACA,MAAI,eAAe,UAAU,eAAe,WAAW;AACrD,WAAO;AAAA,MACL,uBAAuB,UAAU,OAAO,aAAa,QAAQ,MAAM,aAAa,QAAQ,wBAChE,UAAU;AAAA,IAGpC;AAAA,EACF;AACA,SAAO,gBAAgB,UAAU,YAAY;AAC/C;AAEA,IAAM,oBAAoB;AAC1B,IAAM,oBAAoB;AAI1B,IAAM,aAA6C;AAAA,EACjD,QACE;AAAA,EAEF,MACE;AAEJ;AAMO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AACF,GAIa;AACX,QAAM,QAAkB,CAAC;AAEzB,MAAI,aAAa,cAAc;AAC7B,UAAM;AAAA,MACJ,qBAAqB,WAAW,eAAe,OAAO,CAAC,OAAO,aAAa,eAAe,OAAO,CAAC;AAAA,IAEpG;AAAA,EACF;AAEA,MAAI,WAAW;AACb,UAAM;AAAA,MACJ;AAAA,IAEF;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AACF,GAIa;AACX,QAAM,OAAO,OAAO,SAAS,qBAAqB,eAAe;AACjE,QAAM,aAAa,WAAW,KAAK;AACnC,MAAI,CAAC,QAAQ,CAAC,YAAY;AACxB,WAAO,CAAC;AAAA,EACV;AACA,SAAO,CAAC,gBAAgB,OAAO,MAAM,WAAW,WAAW,gBAAgB,UAAU,EAAE;AACzF;AASO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKa;AACX,MAAI,KAAK,WAAW,GAAG;AACrB,WAAO,gBAAgB,GAAG,YAAY;AAAA,EACxC;AAEA,QAAM,aACJ,sPAGC,cACG,+HACA;AAGN,QAAM,QAAQ,CAAC,UAAU;AAEzB,QAAM,QAAQ,KAAK,OAAO,CAAC,QAAQ,IAAI,kBAAkB,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,OAAO;AACvF,MAAI,MAAM,SAAS,GAAG;AACpB,UAAM;AAAA,MACJ,GAAG,MAAM,MAAM,OAAO,MAAM,MAAM,uCAAuC,aAAa,QAAQ,MAAM,aAAa,QAAQ,KACpH,MAAM,KAAK,IAAI,CAAC;AAAA,IAEvB;AAAA,EACF;AAEA,SAAO;AACT;AAOA,IAAM,eACJ;AAQK,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AACF,GAIa;AACX,QAAM,QAAkB,CAAC;AACzB,MAAI,gBAAgB,GAAG;AACrB,UAAM;AAAA,MACJ,gTAGG,SAAS,UAAU,0EAAqE;AAAA,IAC7F;AAAA,EACF,WAAW,SAAS,SAAS;AAC3B,UAAM;AAAA,MACJ;AAAA,IAEF;AAAA,EACF;AACA,MAAI,WAAW,aAAa,cAAc,EAAG,OAAM,KAAK,YAAY;AACpE,SAAO;AACT;AAGO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKa;AACX,QAAM,QAAkB,CAAC;AACzB,MAAI,gBAAgB,KAAK,kBAAkB,MAAM,gBAAgB,KAAK,GAAG;AACvE,UAAM;AAAA,MACJ,mBAAmB,YAAY;AAAA,IACjC;AAAA,EACF;AACA,MAAI,WAAW,UAAW,OAAM,KAAK,YAAY;AACjD,SAAO;AACT;AAEA,IAAM,cAAc;AAQb,SAAS,sBAAsB,EAAE,YAAY,GAAsC;AACxF,MAAI,gBAAgB,GAAG;AACrB,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,EACF;AACF;AAGO,IAAM,uBAAoC;AAAA,EAC/C,QAAQ;AAAA,EACR,aACE;AACJ;AASO,SAAS,cAAc,KAAa,MAAkC;AAC3E,MAAI;AACJ,MAAI;AACF,WAAO,IAAI,IAAI,GAAG,EAAE;AAAA,EACtB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,CAAC,YAAY,KAAK,IAAI,EAAG,QAAO;AACpC,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,SAAS,YAAa,QAAO;AACjC,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,aACE;AAAA,EACJ;AACF;AAOO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAQa;AACX,MAAI,YAAY,GAAG;AACjB,WAAO;AAAA,MACL,0BAA0B,MAAM,GAAG,UAAU,oBAAoB,EAAE,6IAEhE,UAAU,uEAAuE,eAClF,qEAAqE,MAAM;AAAA,IAC/E;AAAA,EACF;AACA,QAAM,QAAkB,CAAC;AACzB,MAAI,CAAC,aAAa,kBAAkB,GAAG;AACrC,UAAM;AAAA,MACJ,GAAG,eAAe,6GAA6G,4BAA4B;AAAA,IAC7J;AAAA,EACF;AACA,QAAM,UAAU,YAAY,kBAAkB,aAAa;AAC3D,MAAI,UAAU,GAAG;AACf,UAAM;AAAA,MACJ,GAAG,OAAO,4BAA4B,4BAA4B,mDAA8C,4BAA4B;AAAA,IAE9I;AAAA,EACF;AACA,MAAI,SAAS,KAAK,aAAa,GAAG;AAChC,UAAM,UAAU;AAAA,MACd,SAAS,IAAI,GAAG,MAAM,yDAAyD;AAAA,MAC/E,aAAa,IAAI,GAAG,UAAU,4CAA4C;AAAA,IAC5E,EAAE,OAAO,OAAO;AAChB,UAAM;AAAA,MACJ,eAAe,QAAQ,KAAK,OAAO,CAAC;AAAA,IAEtC;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/chunk-ERMKQMMJ.js

@@ -1,64 +0,0 @@
-import {
-  ApiError
-} from "./chunk-AS46I4WH.js";
-import {
-  writeJson
-} from "./chunk-AL6AEGWH.js";
-
-// src/commands/media-sources/shared.ts
-function driveRefusalFix(input, code) {
-  if (!/drive\.google\.com/i.test(input) || code !== "BAD_REQUEST") return void 0;
-  return `A Google Drive folder is never added by link \u2014 don't retry. Call request_connection with platform "google-drive" and choose "media-folder": the card lets the user pick the folder in the chat (only the Baker team can for now; anyone else is told the team will set it up). A connected result carries the new source's mediaSourceKey; if it is declined, carry on with the rest of the task.`;
-}
-function reportError(err, input) {
-  if (err instanceof ApiError) {
-    const fix = input ? driveRefusalFix(input, err.code) : void 0;
-    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-function halfState(half) {
-  if (!half) return null;
-  return {
-    status: half.syncStatus === "fetching" || half.syncStatus === "processing" ? "importing" : half.syncStatus,
-    stored: half.storedCount ?? 0,
-    ...half.pendingItems ? { pending: half.pendingItems } : {},
-    ...half.failedItems ? { failed: half.failedItems } : {},
-    ...half.lastSyncedAt ? { lastSyncedAt: new Date(half.lastSyncedAt).toISOString() } : {},
-    ...half.errorMessage ? { error: half.errorMessage } : {}
-  };
-}
-function whoLine(who) {
-  return [
-    who.kind === "person" ? "person" : "page",
-    who.role,
-    who.own ? "own" : "not own",
-    who.privateProfile ? "private profile \u2014 add posts by link" : void 0
-  ].filter(Boolean).join(" \xB7 ");
-}
-function compactSource(source) {
-  return {
-    key: source.key,
-    platform: source.platform,
-    label: source.label,
-    url: source.profileUrl,
-    ...source.who ? { who: whoLine(source.who) } : {},
-    autoSync: source.refreshInterval,
-    images: halfState(source.images),
-    videos: halfState(source.videos)
-  };
-}
-function isImporting(source) {
-  return [source.images, source.videos].some(
-    (half) => half?.syncStatus === "fetching" || half?.syncStatus === "processing"
-  );
-}
-
-export {
-  reportError,
-  compactSource,
-  isImporting
-};
-//# sourceMappingURL=chunk-ERMKQMMJ.js.map

package/dist/chunk-EZMF6W4M.js

@@ -1,64 +0,0 @@
-import {
-  REF_PREFIX
-} from "./chunk-VR6BCP3U.js";
-
-// src/commands/canvas/node-preview.ts
-var MAX_PARAMS_PREVIEW_LENGTH = 4e3;
-var SPEC_KEYS = [
-  "model",
-  "format",
-  "mode",
-  "aspect_ratio",
-  "image_size",
-  "resolution",
-  "duration",
-  "subject_type",
-  "font_size",
-  "expect",
-  "source",
-  "path",
-  "url"
-];
-var BODY_KEYS = ["prompt", "text", "subject_description"];
-function scalarField(params, key) {
-  const value = params[key];
-  if (typeof value === "number") return String(value);
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed && !trimmed.startsWith(REF_PREFIX) ? trimmed : void 0;
-}
-function compactJson(params) {
-  try {
-    const json = JSON.stringify(params);
-    return json && json !== "{}" ? json : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function cap(text) {
-  return text.length > MAX_PARAMS_PREVIEW_LENGTH ? `${text.slice(0, MAX_PARAMS_PREVIEW_LENGTH - 1)}\u2026` : text;
-}
-function nodeParamsPreview(params, deps) {
-  const refsLine = deps && deps.length > 0 ? `refs: ${deps.join(", ")}` : void 0;
-  if (!params || typeof params !== "object") return refsLine;
-  const own = params;
-  const nested = (key) => own[key] && typeof own[key] === "object" && !Array.isArray(own[key]) ? own[key] : {};
-  const record = { ...nested("paint"), ...nested("words"), ...own };
-  const spec = [];
-  for (const key of SPEC_KEYS) {
-    const value = scalarField(record, key);
-    if (value !== void 0) spec.push(`${key}: ${value}`);
-  }
-  if (refsLine) spec.push(refsLine);
-  const body = BODY_KEYS.map((key) => scalarField(record, key)).find(Boolean);
-  const header = spec.join("\n");
-  const composed = header && body ? `${header}
-
-${body}` : header || body || compactJson(record);
-  return composed ? cap(composed) : void 0;
-}
-
-export {
-  nodeParamsPreview
-};
-//# sourceMappingURL=chunk-EZMF6W4M.js.map