@koda-sl/baker-cli 0.495.0 → 0.497.0

package/dist/web-6JMWERTT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/web.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet, apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { webDepthHints } from \"./hints.ts\";\nimport { handleResearchError, writeResearchHints, writeResearchJson } from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.web\",\n  description:\n    \"Search the web with AI to answer marketing questions — competitors, ICP, pricing, pain points, market trends. Three depth levels: medium (quick, default), high (thorough), xhigh (exhaustive deep research).\",\n  args: {\n    question: {\n      type: \"string\",\n      description: \"The research question to answer using live web data\",\n      required: true,\n    },\n    depth: {\n      type: \"string\",\n      description: \"Research depth: medium (quick), high (thorough), xhigh (exhaustive). Default: medium\",\n      required: false,\n      enum: [\"medium\", \"high\", \"xhigh\"],\n    },\n  },\n});\n\ntype Depth = \"medium\" | \"high\" | \"xhigh\";\n\nconst TIMEOUT_MS: Record<Depth, number> = {\n  medium: 180_000,\n  high: 360_000,\n  xhigh: 900_000,\n};\n\ninterface WebResult {\n  answer: string;\n  sources: Array<{ title: string; url: string }>;\n}\n\nconst FIELDS: Record<string, string> = {\n  answer: \"AI-generated research answer (markdown)\",\n  sources: \"Array of {title, url} sources used for grounding\",\n};\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nasync function runDeepResearch(question: string): Promise<WebResult> {\n  const { interactionId } = await apiPost<{ interactionId: string }>(\"/api/research/deep-research/start\", { question });\n\n  process.stderr.write(`Deep research started (${interactionId}). Polling...\\n`);\n\n  const deadline = Date.now() + TIMEOUT_MS.xhigh;\n  while (Date.now() < deadline) {\n    await sleep(10_000);\n    const poll = await apiGet<{ status: string; result?: WebResult }>(\"/api/research/deep-research/poll\", {\n      id: interactionId,\n    });\n\n    if (poll.status === \"completed\" && poll.result) {\n      return poll.result;\n    }\n    if (poll.status === \"failed\" || poll.status === \"cancelled\") {\n      throw new Error(`Deep research ${poll.status}`);\n    }\n    process.stderr.write(`  status: ${poll.status}\\n`);\n  }\n\n  throw new Error(\"Deep research timed out\");\n}\n\nexport const webCommand = defineCommand({\n  meta: {\n    name: \"web\",\n    description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.\n\nDepth levels:\n  medium  — Quick lookup using Gemini Flash with minimal thinking (default)\n  high    — Thorough answer using Gemini Flash with deep thinking\n  xhigh   — Exhaustive deep research using Gemini Deep Research (slow, use sparingly)\n\nExamples:\n  baker research web \"Who are the main competitors of HubSpot CRM?\"\n  baker research web \"What are the top pain points for SMB CRM buyers?\" --depth high\n  baker research web \"Full competitive analysis of project management SaaS\" --depth xhigh`,\n  },\n  args: {\n    question: { type: \"positional\", description: \"The research question\", required: true },\n    depth: { type: \"string\", description: \"Research depth: medium|high|xhigh (default: medium)\", required: false },\n    output: { type: \"string\", description: \"Format: json|md (default: json)\", required: false, default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const question = args.question as string;\n    if (question.length < 5) {\n      writeResearchJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Question must be at least 5 characters\" },\n      });\n      process.exit(1);\n    }\n\n    const depth = ((args.depth as string) || \"medium\") as Depth;\n    if (![\"medium\", \"high\", \"xhigh\"].includes(depth)) {\n      writeResearchJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Depth must be one of: medium, high, xhigh\" },\n      });\n      process.exit(1);\n    }\n\n    try {\n      const data =\n        depth === \"xhigh\"\n          ? await runDeepResearch(question)\n          : await apiPost<WebResult>(\"/api/research/explore\", { question, depth }, { timeoutMs: TIMEOUT_MS[depth] });\n\n      const format = (args.output as string) || \"json\";\n      const hints = webDepthHints({ answer: data.answer, sourceCount: data.sources.length, depth });\n      if (format === \"md\") {\n        process.stdout.write(`${data.answer}\\n`);\n        if (data.sources.length > 0) {\n          process.stdout.write(\"\\n## Sources\\n\");\n          for (const s of data.sources) {\n            process.stdout.write(`- [${s.title}](${s.url})\\n`);\n          }\n        }\n        writeResearchHints(hints, format);\n        return;\n      }\n      writeResearchJson({ ok: true, data, fields: FIELDS, hints });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/winning-ads-XCVUAIOU.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-IWNAZ52P.js").then((m) => m.searchCommand),
+    advertisers: () => import("./advertisers-OMB4FKK6.js").then((m) => m.advertisersCommand),
+    follow: () => import("./follow-LRGW6OHI.js").then((m) => m.followCommand),
+    discover: () => import("./discover-SII47P73.js").then((m) => m.discoverCommand),
+    add: () => import("./add-6DDU34GR.js").then((m) => m.addCommand),
+    "add-accounts": () => import("./add-accounts-QM4TQGDW.js").then((m) => m.addAccountsCommand),
+    "follow-competitors": () => import("./follow-competitors-UUN7EKFR.js").then((m) => m.followCompetitorsCommand),
+    following: () => import("./following-ISRRC2QL.js").then((m) => m.followingCommand),
+    feed: () => import("./feed-724KWSNI.js").then((m) => m.feedCommand),
+    winners: () => import("./winners-2FZXH22W.js").then((m) => m.winnersCommand),
+    ads: () => import("./ads-KDIRM745.js").then((m) => m.adsCommand),
+    profile: () => import("./profile-4QZXRUR6.js").then((m) => m.profileCommand),
+    launches: () => import("./launches-4VFF5MNM.js").then((m) => m.launchesCommand),
+    landings: () => import("./landings-W2ZW3WJK.js").then((m) => m.landingsCommand),
+    "search-copy": () => import("./search-copy-ZJHRQCVH.js").then((m) => m.searchCopyCommand),
+    content: () => import("./content-JDTHVSPS.js").then((m) => m.contentCommand),
+    fit: () => import("./fit-W7UNFZT5.js").then((m) => m.fitCommand),
+    unfollow: () => import("./unfollow-JSLPUZK5.js").then((m) => m.unfollowCommand),
+    refresh: () => import("./refresh-HCQXVFVR.js").then((m) => m.refreshCommand),
+    hooks: () => import("./seeds-5TAEFW6H.js").then((m) => m.hooksCommand),
+    mechanisms: () => import("./seeds-5TAEFW6H.js").then((m) => m.mechanismsCommand),
+    formats: () => import("./seeds-5TAEFW6H.js").then((m) => m.formatsCommand)
+  }
+});
+export {
+  winningAdsCommand
+};
+//# sourceMappingURL=winning-ads-XCVUAIOU.js.map