@koda-sl/baker-cli 0.567.0 → 0.569.0

package/dist/web-K2EMYVCD.js

@@ -0,0 +1,173 @@
+import {
+  webDepthHints,
+  webSourceHints
+} from "./chunk-LQACNCAV.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson
+} from "./chunk-D3YAFC6K.js";
+import "./chunk-2Q7K4F4H.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-XHWHBGKX.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-K2EMYVCD.js.map

package/dist/winning-ads-Q3RXH7EC.js

@@ -0,0 +1,86 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/index.ts
+import { defineCommand } from "citty";
+var winningAdsCommand = defineCommand({
+  meta: {
+    name: "winning-ads",
+    description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce, and manage the brands your library tracks. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
+
+Auth: BAKER_API_KEY (bk_, bkr_ or bkv_) + BAKER_API_URL (your Convex .convex.site URL).
+
+Rows are compact. Filter at the source (--platform, --format, --running, --advertiser-id) and keep only the columns you need with --fields ad_id,summary,days_active; --full only for the 2-3 ads you will use.
+
+Subcommands:
+  baker winning-ads search "<free text>"      \u2014 semantic search, followed brands first; lean shortlist (advertiser, summary, scores, proof, media_url)
+  baker winning-ads advertisers "<brand>"     \u2014 list corpus brands \u2192 advertiser ids (for --exclude-advertiser / --advertiser-id)
+  baker winning-ads follow "<website|brand|link>" \u2014 add a brand's ads to your library: every platform, every account it runs
+  baker winning-ads discover "<website|brand|link>" \u2014 see every account a brand runs ads from, without following
+  baker winning-ads add "<website|brand|link>" \u2014 put a brand's ads in Baker's library WITHOUT following it (a client you study, not track)
+  baker winning-ads add-accounts <advertiser> "<link,link>" \u2014 track more accounts of a followed brand (another market's page)
+  baker winning-ads follow-competitors "<domain,domain,...>"   \u2014 add MANY brands at once (every competitor by domain)
+  baker winning-ads following                 \u2014 list brands you follow (status + counts)
+  baker winning-ads feed                      \u2014 winners across EVERY brand you follow; trim with --advertiser
+  baker winning-ads winners <advertiser>      \u2014 top winners for one advertiser id (--platform: one platform's; --per-platform: each platform's own)
+  baker winning-ads ads <advertiser>          \u2014 every ad one advertiser has run; narrow with --platform, --format video,static,carousel,text, --running running|stopped
+  baker winning-ads profile <advertiser>      \u2014 what a brand is doing: spend estimate, launches + what still runs, tests + the version kept, mixes, landing pages, audiences, similar brands
+  baker winning-ads launches [--since 7]      \u2014 what followed brands launched in the last N days and which ads still run
+  baker winning-ads landings <advertiser>     \u2014 every landing page a brand's ads point to; --analyse reads how each sells (value props, offer, pricing, proof)
+  baker winning-ads search-copy <advertiser>  \u2014 what a brand says on Google Search: headlines + their hooks, descriptions, sitelinks, each running or dropped
+  baker winning-ads content <ad-id>           \u2014 read ONE ad's transcript + on-screen text + copy (understand a reference before reproducing it)
+  baker winning-ads fit <ad-id>               \u2014 does this winner fit OUR company? why it wins, what it needs, what we have, use|adapt|reject
+  baker winning-ads unfollow <advertiser>     \u2014 stop following a brand
+  baker winning-ads refresh <advertiser>      \u2014 re-scrape a followed brand for its newest ads (max once per 6h)
+  baker winning-ads hooks                     \u2014 top winner-weighted HOOK seeds for a segment (feed the seed to search --hook-archetype)
+  baker winning-ads mechanisms                \u2014 top winner-weighted PRODUCT mechanism seeds (how the product claims to work)
+  baker winning-ads formats                   \u2014 top winner-weighted static FORMAT patterns for a segment
+
+Examples:
+  baker winning-ads search "B2B SaaS before/after AI automation" --platform meta --format static --output md
+  baker winning-ads advertisers "Acme" --output md
+  baker winning-ads follow "deel.com"
+  baker winning-ads add-accounts adv_123 "https://www.facebook.com/barkibu.it"
+  baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"
+  baker winning-ads feed --output md
+  baker winning-ads feed --advertiser adv_123,adv_456 --platform meta --output md
+  baker winning-ads winners adv_123 --per-platform --top 5 --output md
+  baker winning-ads ads adv_123 --platform google --format text --running running --fields ad_id,summary,days_active --output md
+  baker winning-ads profile adv_123 --platform meta
+  baker winning-ads launches --since 7
+  baker winning-ads landings adv_123 --analyse
+  baker winning-ads search-copy adv_123 --running
+  baker winning-ads content adg_123 --full --output md
+  baker winning-ads hooks --platform meta --awareness problem_aware --industry saas --output md
+  baker winning-ads search "fintech onboarding" --hook-archetype callout --winner-category winner --output md
+  baker winning-ads search --format-pattern comparison_table --sort longest_running --output md
+Full guide: __tooling__/docs/tools/baker/winning-ads.md`
+  },
+  subCommands: {
+    search: () => import("./search-O3AOWEXC.js").then((m) => m.searchCommand),
+    advertisers: () => import("./advertisers-2GKICB23.js").then((m) => m.advertisersCommand),
+    follow: () => import("./follow-5VX5JWAQ.js").then((m) => m.followCommand),
+    discover: () => import("./discover-P7PBB3IV.js").then((m) => m.discoverCommand),
+    add: () => import("./add-PZEVRQ7Z.js").then((m) => m.addCommand),
+    "add-accounts": () => import("./add-accounts-D4V5K7SO.js").then((m) => m.addAccountsCommand),
+    "follow-competitors": () => import("./follow-competitors-D7I33T5C.js").then((m) => m.followCompetitorsCommand),
+    following: () => import("./following-6DI4IZ7P.js").then((m) => m.followingCommand),
+    feed: () => import("./feed-W3ECHUEX.js").then((m) => m.feedCommand),
+    winners: () => import("./winners-5PRDG7GT.js").then((m) => m.winnersCommand),
+    ads: () => import("./ads-RTRWWEP5.js").then((m) => m.adsCommand),
+    profile: () => import("./profile-MKKJT2UF.js").then((m) => m.profileCommand),
+    launches: () => import("./launches-CKPZFVMQ.js").then((m) => m.launchesCommand),
+    landings: () => import("./landings-AELJXEYN.js").then((m) => m.landingsCommand),
+    "search-copy": () => import("./search-copy-EB3TONDS.js").then((m) => m.searchCopyCommand),
+    content: () => import("./content-EQZKKIST.js").then((m) => m.contentCommand),
+    fit: () => import("./fit-BRJSLR7P.js").then((m) => m.fitCommand),
+    unfollow: () => import("./unfollow-OEMFPAFS.js").then((m) => m.unfollowCommand),
+    refresh: () => import("./refresh-V34YWN3W.js").then((m) => m.refreshCommand),
+    hooks: () => import("./seeds-RGIFHHYC.js").then((m) => m.hooksCommand),
+    mechanisms: () => import("./seeds-RGIFHHYC.js").then((m) => m.mechanismsCommand),
+    formats: () => import("./seeds-RGIFHHYC.js").then((m) => m.formatsCommand)
+  }
+});
+export {
+  winningAdsCommand
+};
+//# sourceMappingURL=winning-ads-Q3RXH7EC.js.map