@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/leads-TPB5OFSQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/leads.ts"],"sourcesContent":["import { isMetaLeadAdsRefusal } from \"@baker/api/ads-meta\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeAdsJson, writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport { csvOrJson, handleMetaError } from \"./shared.ts\";\nimport { bareAccountId, loadJsonFileArg, mergePayload, stageOp } from \"./write-shared.ts\";\n\n/** An instant form attached to a Facebook Page. */\nexport interface MetaLeadForm {\n  id: string;\n  name?: string;\n  status?: string;\n  locale?: string;\n  leads_count?: number;\n  created_time?: string;\n}\n\n/** One page of leads plus the cursor that continues it. */\nexport interface MetaLeadPage {\n  leads: MetaLead[];\n  /** Present only while Meta says another page exists. */\n  nextCursor?: string;\n  /** What the backend says about this page (every answer masked when it could not tell contact questions apart). */\n  hints?: string[];\n}\n\n/** One lead, already shaped by the backend (contact values masked unless --full). */\nexport interface MetaLead {\n  id: string;\n  created_time?: string;\n  ad_id?: string;\n  ad_name?: string;\n  adset_id?: string;\n  adset_name?: string;\n  campaign_id?: string;\n  campaign_name?: string;\n  form_id?: string;\n  is_organic?: boolean;\n  platform?: string;\n  answers: Record<string, string>;\n}\n\nregisterSchema({\n  command: \"ads.meta.lead-forms\",\n  description:\n    \"List the instant (lead) forms on a Facebook Page, with how many leads each has collected. Start here: a lead is fetched by form id. Use a Page from `baker ads meta pages` with hasPageAccessToken: true.\",\n  args: {\n    \"page-id\": {\n      type: \"string\",\n      description: \"Facebook Page ID — from `baker ads meta pages` with hasPageAccessToken: true\",\n      required: true,\n    },\n    full: { type: \"boolean\", description: \"Include each form's questions\", required: false },\n    output: { type: \"string\", description: \"json|csv\", required: false, default: \"json\" },\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.lead-forms.create\",\n  description:\n    \"Start here to stage a Page-owned Meta Instant Form. The form is created only when this Session publishes. Use the returned meta_temp_* ref as --lead-form on a creative in the same Session.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"Selected Meta ad account, act_<id>\", required: true },\n    \"page-id\": {\n      type: \"string\",\n      description:\n        \"Facebook Page that owns the form — choose one with this account in promotingAccountIds and hasPageAccessToken: true from `baker ads meta pages`\",\n      required: true,\n    },\n    name: { type: \"string\", description: \"Form name\", required: true },\n    questions: {\n      type: \"string\",\n      description: \"Comma-separated Meta fields, e.g. FULL_NAME,EMAIL,PHONE\",\n      required: true,\n    },\n    \"privacy-policy-url\": { type: \"string\", description: \"Public HTTPS privacy policy\", required: true },\n    \"follow-up-url\": { type: \"string\", description: \"Public HTTPS link after submission\", required: true },\n    \"optimized-for-quality\": {\n      type: \"boolean\",\n      description: \"Ask Meta to optimize form leads for quality\",\n      required: false,\n    },\n    file: {\n      type: \"string\",\n      description: \"JSON file with full form payload, including thankYou and custom questions\",\n      required: false,\n    },\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.leads\",\n  description:\n    \"Read the leads an instant form collected. Contact details (email, phone) come back masked; pass --full only when the raw values are genuinely needed, e.g. handing them to a CRM.\",\n  args: {\n    \"form-id\": { type: \"string\", description: \"Instant form ID — from `baker ads meta lead-forms`\", required: false },\n    \"ad-id\": { type: \"string\", description: \"Read the leads of one ad instead of a whole form\", required: false },\n    since: { type: \"string\", description: \"Earliest submission date, YYYY-MM-DD\", required: false },\n    until: { type: \"string\", description: \"Latest submission date, YYYY-MM-DD (inclusive)\", required: false },\n    limit: { type: \"string\", description: \"Leads per page (default 100, max 500)\", required: false },\n    after: {\n      type: \"string\",\n      description: \"Cursor from a previous call's nextCursor — fetches the following page\",\n      required: false,\n    },\n    full: { type: \"boolean\", description: \"Return raw contact details instead of masked ones\", required: false },\n    output: { type: \"string\", description: \"json|csv\", required: false, default: \"json\" },\n  },\n});\n\n/**\n * A form that exists but has never collected anything is the single most common\n * thing to misread here — it looks identical to a permissions problem in the\n * output, and the remedies are opposite. Say which it is.\n */\n/** The backend drains instant forms up to this many; see `META_LEAD_FORMS_MAX`. */\nconst LEAD_FORMS_CAP = 500;\n\nexport function leadFormHints(forms: MetaLeadForm[]): string[] {\n  if (forms.length === 0) {\n    return [\"This Page has NO instant forms. Nothing to read leads from — the form has to be created first.\"];\n  }\n  if (forms.length >= LEAD_FORMS_CAP) {\n    return [\n      `PARTIAL LIST — this Page has at least ${LEAD_FORMS_CAP} instant forms and only the first ${LEAD_FORMS_CAP} came back. Do not describe this as every form on the Page.`,\n    ];\n  }\n  const empty = forms.filter((form) => (form.leads_count ?? 0) === 0);\n  if (empty.length === forms.length) {\n    return [\n      \"Every form on this Page has collected 0 leads. That is a real, readable answer — the connection works. Do not retry and do not report it as a permissions problem.\",\n    ];\n  }\n  return [];\n}\n\n/**\n * A `FORBIDDEN` that Baker itself produced is already conclusive, so it must not\n * collect the generic ambiguous-403 remedy.\n *\n * `metaForbiddenFix` exists for Meta's own 403, which covers two causes with\n * opposite fixes and can only be told apart by testing the blast radius. Pasting\n * that after *\"this needs switching on by the Baker team\"* would hand the agent\n * a paragraph suggesting a reconnect right underneath a sentence saying a\n * reconnect cannot help — and the agent would pass it on, costing the client a\n * pointless round trip through their Meta login. Everything that is genuinely\n * Meta's still goes through the normal handler.\n */\nfunction handleLeadsError(err: unknown): never {\n  if (err instanceof ApiError && err.code === \"FORBIDDEN\" && isMetaLeadAdsRefusal(err.message)) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: { action: \"reject\", explanation: err.message },\n        retryable: false,\n      },\n    });\n    process.exit(1);\n  }\n  handleMetaError(err);\n}\n\n/**\n * What the agent has to know before it reports a number.\n *\n * Counting is what this command is mostly used for, so a page that is full is\n * the dangerous case: without a word, 100 rows read as \"100 leads\" and the\n * client is told something false. The cursor is the remedy, and it has to be\n * named in the same breath as the warning.\n */\nexport function leadPageHints(page: MetaLeadPage, full: boolean): string[] {\n  const hints: string[] = [];\n  if (page.nextCursor) {\n    hints.push(\n      `PARTIAL PAGE — more leads exist. This is ${page.leads.length} of an unknown larger number; do NOT report it as a total. Fetch the next page with \\`--after ${page.nextCursor}\\` (repeat until no nextCursor), or narrow the window with --since/--until.`,\n    );\n  }\n  if (!full) {\n    hints.push(\n      \"Answers that give contact details (email, phone, any question asking for one) are masked. Report on them as they are; pass --full only when the raw values have to leave Baker (a CRM hand-off), and never paste them into the chat otherwise.\",\n    );\n  }\n  hints.push(...(page.hints ?? []));\n  return hints;\n}\n\nconst leadFormsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a Meta Instant Form on a Facebook Page. The form appears in review and is created only when the Session publishes.\nChoose a Page with this account in promotingAccountIds and hasPageAccessToken: true from \\`baker ads meta pages\\`.\nExample: baker ads meta lead-forms create --account-id act_123 --page-id 456 --name \"Free audit\" --questions FULL_NAME,EMAIL,PHONE --privacy-policy-url https://example.com/privacy --follow-up-url https://example.com`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Selected Meta ad account\" },\n    \"page-id\": { type: \"string\", description: \"Facebook Page ID\" },\n    name: { type: \"string\", description: \"Form name\" },\n    questions: { type: \"string\", description: \"FULL_NAME,EMAIL,PHONE or other Meta fields\" },\n    \"privacy-policy-url\": { type: \"string\", description: \"HTTPS privacy policy\" },\n    \"follow-up-url\": { type: \"string\", description: \"HTTPS thank-you link\" },\n    \"optimized-for-quality\": { type: \"boolean\", description: \"Optimize form leads for quality\" },\n    file: { type: \"string\", description: \"JSON form payload; flags override file keys\" },\n  },\n  run: async ({ args }) => {\n    const accountId = bareAccountId(args as Record<string, unknown>);\n    const payload = mergePayload(loadJsonFileArg(args.file), {\n      page_id: args[\"page-id\"],\n      name: args.name,\n      questions:\n        typeof args.questions === \"string\"\n          ? args.questions.split(\",\").map((type) => ({ type: type.trim().toUpperCase() }))\n          : undefined,\n      privacyPolicyUrl: args[\"privacy-policy-url\"],\n      followUpActionUrl: args[\"follow-up-url\"],\n      optimizedForQuality: args[\"optimized-for-quality\"],\n    });\n    await stageOp({ kind: \"leadForm.create\", accountId, payload });\n  },\n});\n\nconst leadFormsListArgs = {\n  \"page-id\": { type: \"string\", description: \"Facebook Page ID\" },\n  full: { type: \"boolean\", description: \"Include each form's questions\" },\n  output: { type: \"string\", description: \"Output format\", default: \"json\" },\n} as const;\n\nconst leadFormsListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List the Instant Forms on a Facebook Page, with lead counts. Choose a Page with hasPageAccessToken: true from `baker ads meta pages`. Pass --full to include questions.\",\n  },\n  args: leadFormsListArgs,\n  run: async ({ args }) => {\n    try {\n      const pageId = args[\"page-id\"] as string | undefined;\n      if (!pageId) {\n        handleLeadsError(\n          new Error(\n            \"--page-id is required. Run `baker ads meta pages` and choose a Page with hasPageAccessToken: true.\",\n          ),\n        );\n      }\n      const params: Record<string, string> = { \"page-id\": pageId };\n      if (args.full) params.full = \"true\";\n      const data = await apiGet<MetaLeadForm[]>(\"/api/ads/meta/lead-forms\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      const hints = leadFormHints(data);\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      handleLeadsError(err);\n    }\n  },\n});\n\nexport const leadFormsCommand = defineCommand({\n  meta: {\n    name: \"lead-forms\",\n    description: `List Instant Forms on a Facebook Page or stage a new one.\nExamples:\n  baker ads meta lead-forms --page-id 100635183117758\n  baker ads meta lead-forms --page-id 100635183117758 --full\n  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json`,\n  },\n  args: leadFormsListArgs,\n  subCommands: { list: leadFormsListCommand, create: leadFormsCreateCommand },\n  default: \"list\",\n});\n\nexport const leadsCommand = defineCommand({\n  meta: {\n    name: \"leads\",\n    description: `Read the leads an instant form collected. Every question comes back; email and phone answers are MASKED unless you pass --full, so you can report on what a form is collecting without moving contact details around.\n\nExamples:\n  baker ads meta leads --form-id 987654321\n  baker ads meta leads --form-id 987654321 --since 2026-08-01 --until 2026-08-31\n  baker ads meta leads --ad-id 6123456789 --limit 50\n  baker ads meta leads --form-id 987654321 --after <nextCursor>   # the next page\n  baker ads meta leads --form-id 987654321 --full            # raw contact details — only when handing leads over\n\nResults are PAGED. A response carrying \\`nextCursor\\` is not the whole set — follow it before reporting any total.`,\n  },\n  args: {\n    \"form-id\": { type: \"string\", description: \"Instant form ID (from `baker ads meta lead-forms`)\" },\n    \"ad-id\": { type: \"string\", description: \"Read one ad's leads instead of a whole form\" },\n    since: { type: \"string\", description: \"Earliest submission date, YYYY-MM-DD\" },\n    until: { type: \"string\", description: \"Latest submission date, YYYY-MM-DD (inclusive)\" },\n    limit: { type: \"string\", description: \"Leads per page (default 100, max 500)\" },\n    after: { type: \"string\", description: \"Cursor from a previous call's nextCursor\" },\n    full: { type: \"boolean\", description: \"Return raw contact details instead of masked ones\" },\n    output: { type: \"string\", description: \"Output format\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    try {\n      const formId = args[\"form-id\"] as string | undefined;\n      const adId = args[\"ad-id\"] as string | undefined;\n      if (!formId && !adId) {\n        handleLeadsError(new Error(\"Pass --form-id (from `baker ads meta lead-forms`) or --ad-id.\"));\n      }\n      const params: Record<string, string> = {};\n      if (formId) params[\"form-id\"] = formId;\n      if (adId) params[\"ad-id\"] = adId;\n      if (args.since) params.since = args.since as string;\n      if (args.until) params.until = args.until as string;\n      if (args.limit) params.limit = String(args.limit);\n      if (args.after) params.after = String(args.after);\n      if (args.full) params.full = \"true\";\n      const page = await apiGet<MetaLeadPage>(\"/api/ads/meta/leads\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(page.leads as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      writeJsonEnvelope({\n        ok: true,\n        data: page.leads,\n        ...(page.nextCursor ? { nextCursor: page.nextCursor } : {}),\n        hints: leadPageHints(page, args.full === true),\n      });\n    } catch (err) {\n      handleLeadsError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/learn-NMFEA5H5.js

@@ -0,0 +1,203 @@
+import {
+  parseDays,
+  withDefinitions
+} from "./chunk-B52DCYL2.js";
+import {
+  setDefinitionFields
+} from "./chunk-S4LZ7KTG.js";
+import {
+  IDEAS_DIR,
+  readIdeas
+} from "./chunk-YULENNA7.js";
+import "./chunk-I3DIZWN5.js";
+import "./chunk-AUSKKFVH.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-HDHWIEJJ.js";
+import "./chunk-U6VRBDNQ.js";
+import "./chunk-CAMX6OHF.js";
+import "./chunk-MGKHFGLV.js";
+import "./chunk-U7BBXM67.js";
+import "./chunk-DX4GIDO7.js";
+import "./chunk-CZENWCBS.js";
+import {
+  failApi
+} from "./chunk-7THBBTJJ.js";
+import "./chunk-SMIENBNX.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-XX6ZMCY5.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/learn.ts
+import { readFileSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+
+// src/commands/creatives/learn-model.ts
+var MIN_IMPRESSIONS = 1e3;
+var SEEN_ENOUGH = 5e3;
+var WINNER_RATIO = 0.8;
+var WINNER_MIN_RESULTS = 3;
+var FAILED_RATIO = 1.5;
+var SILENT_SPEND = 2;
+var SETTLED = /* @__PURE__ */ new Set(["winner", "failed", "inconclusive"]);
+var round = (n) => Math.round(n * 100) / 100;
+function totals(creatives) {
+  const spend = creatives.reduce((sum, c) => sum + c.spend, 0);
+  const impressions = creatives.reduce((sum, c) => sum + c.impressions, 0);
+  const results = creatives.reduce((sum, c) => sum + (c.results ?? 0), 0);
+  const clicks = creatives.reduce((sum, c) => sum + (c.ctr ?? 0) * c.impressions, 0);
+  return { spend, impressions, results, ctr: impressions > 0 ? round(clicks / impressions) : null };
+}
+function verdict(result, usual) {
+  if (result.impressions < MIN_IMPRESSIONS) return "testing";
+  if (usual !== null) {
+    if (result.results === 0 && result.spend >= SILENT_SPEND * usual) return "failed";
+    const ratio = result.vsAccount;
+    if (ratio !== null && result.results >= WINNER_MIN_RESULTS && ratio <= WINNER_RATIO) return "winner";
+    if (ratio !== null && ratio >= FAILED_RATIO) return "failed";
+  }
+  return result.impressions >= SEEN_ENOUGH ? "inconclusive" : "testing";
+}
+function ideaResult(own, usual, asOf) {
+  const mine = totals(own);
+  const costPerResult = mine.results > 0 ? round(mine.spend / mine.results) : null;
+  return {
+    asOf,
+    creatives: own.length,
+    ...own[0]?.currency ? { currency: own[0].currency } : {},
+    spend: round(mine.spend),
+    impressions: mine.impressions,
+    results: mine.results,
+    costPerResult,
+    ctr: mine.ctr,
+    vsAccount: usual !== null && costPerResult !== null ? round(costPerResult / usual) : null
+  };
+}
+function learnFromResults(ideas, creatives, asOf) {
+  const ideaOf = (c) => c.definition?.idea ?? null;
+  return ideas.flatMap((idea) => {
+    if (idea.status === "idea" || idea.status === "retired") return [];
+    const own = creatives.filter((c) => ideaOf(c) === idea.id);
+    if (own.length === 0) return [];
+    const rest = totals(creatives.filter((c) => ideaOf(c) !== idea.id));
+    const usual = rest.results > 0 ? rest.spend / rest.results : null;
+    const result = ideaResult(own, usual, asOf);
+    const to = verdict(result, usual);
+    if (to === "testing" && SETTLED.has(idea.status)) return [];
+    return [{ idea: idea.id, from: idea.status, to, result }];
+  });
+}
+
+// src/commands/creatives/learn.ts
+var DESCRIPTION = `Write back what each built idea's ads did in the live Meta account: every creative of the idea pooled, judged against the rest of the account's cost per result, and the verdict (winner, failed, inconclusive, testing) and frozen numbers written onto src/creatives/_ideas/<idea>.md. Run it before writing new ideas, and weekly.
+
+Start here:
+  baker creatives learn               # last 30 days, written onto the ideas
+  baker creatives learn --days 60
+  baker creatives learn --dry-run     # show the verdicts, write nothing
+
+A winner gets results at 0.8x the usual cost or less (3+ results); failed is 1.5x or more, or spend worth two usual results with none; under 1,000 impressions it is still testing.`;
+var ARGS = {
+  days: { type: "string", required: false, description: "Reporting window in days (default 30)" },
+  "dry-run": { type: "boolean", required: false, default: false, description: "Show the verdicts; write nothing" }
+};
+registerSchema({ command: "creatives.learn", description: DESCRIPTION, args: ARGS });
+function learnEnvelope(learnings, written, unreadable = []) {
+  const winners = learnings.filter((l) => l.to === "winner").map((l) => l.idea);
+  const failed = learnings.filter((l) => l.to === "failed").map((l) => l.idea);
+  const hints = [];
+  if (unreadable.length > 0) {
+    hints.push(
+      `Could not read ${unreadable.join(", ")}, so their results were not written: fix what \`baker creatives ideas\` names, then run this again.`
+    );
+  }
+  if (learnings.length === 0) {
+    hints.push(
+      "No built idea has ads delivering yet: nothing to learn. Ideas count once a published ad shows their creative."
+    );
+  }
+  if (winners.length > 0) {
+    hints.push(
+      `Build on ${winners.join(", ")}: keep the message and make it in a new format or for a new persona before any new idea.`
+    );
+  }
+  if (failed.length > 0) {
+    hints.push(
+      `${failed.join(", ")} lost: never repeat their message; \`baker creatives ideas\` flags an idea that does.`
+    );
+  }
+  return {
+    ok: true,
+    data: {
+      written,
+      ideas: learnings.map((l) => ({
+        idea: l.idea,
+        status: l.from === l.to ? l.to : `${l.from} \u2192 ${l.to}`,
+        ...l.result
+      }))
+    },
+    hints
+  };
+}
+async function writeBack(root, learnings) {
+  for (const learning of learnings) {
+    const file = path.join(root, IDEAS_DIR, `${learning.idea}.md`);
+    const raw = await readFile(file, "utf8");
+    await writeFile(file, setDefinitionFields(raw, { status: learning.to, result: learning.result }), "utf8");
+  }
+}
+function readDefinition(root, slug) {
+  try {
+    return readFileSync(path.join(root, "src", "creatives", slug, "_definition.md"), "utf8");
+  } catch {
+    return null;
+  }
+}
+function today() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+var learnCommand = defineCommand({
+  meta: { name: "learn", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    try {
+      const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+      const days = parseDays(args.days);
+      const performance = withDefinitions(
+        await apiPost("/api/creatives/performance", days ? { days } : {}),
+        (slug) => readDefinition(root, slug)
+      );
+      const { ideas, unreadable } = await readIdeas(root);
+      const learnings = learnFromResults(ideas, performance.data.creatives, today());
+      const dryRun = args["dry-run"] === true;
+      if (!dryRun) await writeBack(root, learnings);
+      writeJson(
+        learnEnvelope(
+          learnings,
+          !dryRun && learnings.length > 0,
+          unreadable.map((u) => u.id)
+        )
+      );
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  learnCommand,
+  learnEnvelope
+};
+//# sourceMappingURL=learn-NMFEA5H5.js.map

package/dist/learn-NMFEA5H5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/learn.ts","../src/commands/creatives/learn-model.ts"],"sourcesContent":["/**\n * `baker creatives learn`: what the ads each idea became did in the live account, written back\n * onto the idea (its `status` and a frozen `result`), so the next chat builds on winners and\n * never repeats a message that lost.\n */\nimport { readFileSync } from \"node:fs\";\nimport { readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { CreativesPerformanceResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi } from \"../actions/shared.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { IDEAS_DIR, readIdeas } from \"./ideas-workspace.ts\";\nimport { type IdeaLearning, learnFromResults } from \"./learn-model.ts\";\nimport { setDefinitionFields } from \"./make-model.ts\";\nimport { parseDays, withDefinitions } from \"./performance.ts\";\n\nconst DESCRIPTION = `Write back what each built idea's ads did in the live Meta account: every creative of the idea pooled, judged against the rest of the account's cost per result, and the verdict (winner, failed, inconclusive, testing) and frozen numbers written onto src/creatives/_ideas/<idea>.md. Run it before writing new ideas, and weekly.\n\nStart here:\n  baker creatives learn               # last 30 days, written onto the ideas\n  baker creatives learn --days 60\n  baker creatives learn --dry-run     # show the verdicts, write nothing\n\nA winner gets results at 0.8x the usual cost or less (3+ results); failed is 1.5x or more, or spend worth two usual results with none; under 1,000 impressions it is still testing.`;\n\nconst ARGS = {\n  days: { type: \"string\", required: false, description: \"Reporting window in days (default 30)\" },\n  \"dry-run\": { type: \"boolean\", required: false, default: false, description: \"Show the verdicts; write nothing\" },\n} as const;\n\nregisterSchema({ command: \"creatives.learn\", description: DESCRIPTION, args: ARGS });\n\n/** What the agent reads, and what to do with winners and losers. Pure. */\nexport function learnEnvelope(\n  learnings: readonly IdeaLearning[],\n  written: boolean,\n  unreadable: readonly string[] = [],\n) {\n  const winners = learnings.filter((l) => l.to === \"winner\").map((l) => l.idea);\n  const failed = learnings.filter((l) => l.to === \"failed\").map((l) => l.idea);\n  const hints: string[] = [];\n  if (unreadable.length > 0) {\n    hints.push(\n      `Could not read ${unreadable.join(\", \")}, so their results were not written: fix what \\`baker creatives ideas\\` names, then run this again.`,\n    );\n  }\n  if (learnings.length === 0) {\n    hints.push(\n      \"No built idea has ads delivering yet: nothing to learn. Ideas count once a published ad shows their creative.\",\n    );\n  }\n  if (winners.length > 0) {\n    hints.push(\n      `Build on ${winners.join(\", \")}: keep the message and make it in a new format or for a new persona before any new idea.`,\n    );\n  }\n  if (failed.length > 0) {\n    hints.push(\n      `${failed.join(\", \")} lost: never repeat their message; \\`baker creatives ideas\\` flags an idea that does.`,\n    );\n  }\n  return {\n    ok: true as const,\n    data: {\n      written,\n      ideas: learnings.map((l) => ({\n        idea: l.idea,\n        status: l.from === l.to ? l.to : `${l.from} → ${l.to}`,\n        ...l.result,\n      })),\n    },\n    hints,\n  };\n}\n\nasync function writeBack(root: string, learnings: readonly IdeaLearning[]): Promise<void> {\n  for (const learning of learnings) {\n    const file = path.join(root, IDEAS_DIR, `${learning.idea}.md`);\n    const raw = await readFile(file, \"utf8\");\n    await writeFile(file, setDefinitionFields(raw, { status: learning.to, result: learning.result }), \"utf8\");\n  }\n}\n\nfunction readDefinition(root: string, slug: string): string | null {\n  try {\n    return readFileSync(path.join(root, \"src\", \"creatives\", slug, \"_definition.md\"), \"utf8\");\n  } catch {\n    return null;\n  }\n}\n\nfunction today(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nexport const learnCommand = defineCommand({\n  meta: { name: \"learn\", description: DESCRIPTION },\n  args: ARGS,\n  async run({ args }) {\n    try {\n      const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n      const days = parseDays(args.days as string | undefined);\n      const performance = withDefinitions(\n        await apiPost<CreativesPerformanceResponse>(\"/api/creatives/performance\", days ? { days } : {}),\n        (slug) => readDefinition(root, slug),\n      );\n      const { ideas, unreadable } = await readIdeas(root);\n      const learnings = learnFromResults(ideas, performance.data.creatives, today());\n      const dryRun = args[\"dry-run\"] === true;\n      if (!dryRun) await writeBack(root, learnings);\n      writeJson(\n        learnEnvelope(\n          learnings,\n          !dryRun && learnings.length > 0,\n          unreadable.map((u) => u.id),\n        ),\n      );\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n","/**\n * What the ads an idea became did, written back onto the idea: `baker creatives learn` turns\n * performance into a verdict per idea, so the next chat starts from what won and what lost\n * instead of from zero. Pure.\n */\nimport type { CreativePerformance } from \"@baker/api\";\nimport type { Idea, IdeaStatus } from \"./ideas-model.ts\";\n\n/** Below this many impressions an idea has not been seen enough to call. */\nconst MIN_IMPRESSIONS = 1000;\n/** Seen this much with no clear verdict, an idea is inconclusive rather than still testing. */\nconst SEEN_ENOUGH = 5000;\n/** At or under this share of the account's usual cost per result, with enough results: a winner. */\nconst WINNER_RATIO = 0.8;\nconst WINNER_MIN_RESULTS = 3;\n/** At or over this share of the usual cost per result: failed. */\nconst FAILED_RATIO = 1.5;\n/** Spending this many usual results' worth with none: failed. */\nconst SILENT_SPEND = 2;\n/** Verdicts a thin window never takes back: too little delivery says nothing new about them. */\nconst SETTLED: ReadonlySet<IdeaStatus> = new Set([\"winner\", \"failed\", \"inconclusive\"]);\n\nexport type IdeaResult = {\n  asOf: string;\n  creatives: number;\n  currency?: string;\n  spend: number;\n  impressions: number;\n  results: number;\n  costPerResult: number | null;\n  ctr: number | null;\n  /** Cost per result over the rest of the account's: 0.5 is half the usual cost. */\n  vsAccount: number | null;\n};\n\nexport type IdeaLearning = { idea: string; from: IdeaStatus; to: IdeaStatus; result: IdeaResult };\n\nconst round = (n: number) => Math.round(n * 100) / 100;\n\nfunction totals(creatives: readonly CreativePerformance[]) {\n  const spend = creatives.reduce((sum, c) => sum + c.spend, 0);\n  const impressions = creatives.reduce((sum, c) => sum + c.impressions, 0);\n  const results = creatives.reduce((sum, c) => sum + (c.results ?? 0), 0);\n  const clicks = creatives.reduce((sum, c) => sum + (c.ctr ?? 0) * c.impressions, 0);\n  return { spend, impressions, results, ctr: impressions > 0 ? round(clicks / impressions) : null };\n}\n\nfunction verdict(result: IdeaResult, usual: number | null): IdeaStatus {\n  if (result.impressions < MIN_IMPRESSIONS) return \"testing\";\n  if (usual !== null) {\n    if (result.results === 0 && result.spend >= SILENT_SPEND * usual) return \"failed\";\n    const ratio = result.vsAccount;\n    if (ratio !== null && result.results >= WINNER_MIN_RESULTS && ratio <= WINNER_RATIO) return \"winner\";\n    if (ratio !== null && ratio >= FAILED_RATIO) return \"failed\";\n  }\n  return result.impressions >= SEEN_ENOUGH ? \"inconclusive\" : \"testing\";\n}\n\n/** One idea's ads pooled into the numbers frozen on it, against the account's usual cost per result. */\nfunction ideaResult(own: readonly CreativePerformance[], usual: number | null, asOf: string): IdeaResult {\n  const mine = totals(own);\n  const costPerResult = mine.results > 0 ? round(mine.spend / mine.results) : null;\n  return {\n    asOf,\n    creatives: own.length,\n    ...(own[0]?.currency ? { currency: own[0].currency } : {}),\n    spend: round(mine.spend),\n    impressions: mine.impressions,\n    results: mine.results,\n    costPerResult,\n    ctr: mine.ctr,\n    vsAccount: usual !== null && costPerResult !== null ? round(costPerResult / usual) : null,\n  };\n}\n\n/**\n * Each built idea's ads, pooled and judged against the rest of the account: cheaper results than\n * usual win, far dearer ones (or spend with none) fail. Ideas still to build, retired, with no\n * ad delivering, or already judged and seen too little since, are left alone.\n */\nexport function learnFromResults(\n  ideas: readonly Idea[],\n  creatives: readonly CreativePerformance[],\n  asOf: string,\n): IdeaLearning[] {\n  const ideaOf = (c: CreativePerformance) => c.definition?.idea ?? null;\n  return ideas.flatMap((idea): IdeaLearning[] => {\n    if (idea.status === \"idea\" || idea.status === \"retired\") return [];\n    const own = creatives.filter((c) => ideaOf(c) === idea.id);\n    if (own.length === 0) return [];\n    const rest = totals(creatives.filter((c) => ideaOf(c) !== idea.id));\n    const usual = rest.results > 0 ? rest.spend / rest.results : null;\n    const result = ideaResult(own, usual, asOf);\n    const to = verdict(result, usual);\n    if (to === \"testing\" && SETTLED.has(idea.status)) return [];\n    return [{ idea: idea.id, from: idea.status, to, result }];\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/library-IP2UKNRU.js

@@ -0,0 +1,109 @@
+import {
+  activeFilterFlags,
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/library.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.library",
+  description: "Search the company image library. Returns only ready images.",
+  args: {
+    query: { type: "string", description: "Search query text", required: true },
+    limit: { type: "number", description: "Maximum results", required: false, default: 5 },
+    "min-score": { type: "number", description: "Minimum relevance score (0-1)", required: false },
+    "aspect-ratio": {
+      type: "string",
+      description: "Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)",
+      required: false
+    },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
+    source: {
+      type: "string",
+      description: "Filter by source (uploaded, pexels, pixabay, brandfetch, google_images, firecrawl, screenshotone, iconify, giphy, \u2026)",
+      required: false
+    },
+    "external-url-host": {
+      type: "string",
+      description: "Filter to library rows whose externalUrl host contains this substring",
+      required: false
+    }
+  }
+});
+var libraryCommand = defineCommand({
+  meta: {
+    name: "library",
+    description: "Search the company image library (hybrid BM25 + vector + Cohere rerank). Use this BEFORE any external provider.\n\nExample: baker images library 'hero banner' --aspect-ratio 16:9 --source magnific"
+  },
+  args: {
+    query: { type: "positional", description: "Search query text", required: false },
+    limit: { type: "string", description: "Max results (default 5)", required: false },
+    "min-score": { type: "string", description: "Minimum relevance score (0-1)", required: false },
+    "aspect-ratio": { type: "string", description: "Aspect ratio filter", required: false },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
+    source: { type: "string", description: "Filter by source", required: false },
+    "external-url-host": {
+      type: "string",
+      description: "Filter library by externalUrl host substring (e.g. competitor.com)",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.limit) body.limit = Number(args.limit);
+      if (args["aspect-ratio"]) body.aspectRatio = args["aspect-ratio"];
+      if (args.tags) body.tags = args.tags.split(",").filter(Boolean);
+      if (args.source) body.source = args.source;
+      if (args["external-url-host"]) body.externalUrlHost = args["external-url-host"];
+      let data = await apiPost("/api/images/search", body);
+      const minScore = args["min-score"] ? Number(args["min-score"]) : void 0;
+      if (minScore !== void 0) {
+        data = data.filter((r) => typeof r.score === "number" && r.score >= minScore);
+      }
+      const hints = emptyResultHints({
+        provider: "library",
+        hitCount: data.length,
+        activeFilters: activeFilterFlags(args, ["aspect-ratio", "tags", "source", "external-url-host", "min-score"]),
+        subject: query
+      });
+      writeOutput(
+        { ok: true, data, ...hints.length > 0 ? { hints } : {} },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        args.full
+      );
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  libraryCommand
+};
+//# sourceMappingURL=library-IP2UKNRU.js.map

package/dist/library-IP2UKNRU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/library.ts"],"sourcesContent":["import type { ImagesSearchResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { type OutputFormat, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { activeFilterFlags, emptyResultHints } from \"./searchHints.ts\";\n\nregisterSchema({\n  command: \"images.library\",\n  description: \"Search the company image library. Returns only ready images.\",\n  args: {\n    query: { type: \"string\", description: \"Search query text\", required: true },\n    limit: { type: \"number\", description: \"Maximum results\", required: false, default: 5 },\n    \"min-score\": { type: \"number\", description: \"Minimum relevance score (0-1)\", required: false },\n    \"aspect-ratio\": {\n      type: \"string\",\n      description: \"Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)\",\n      required: false,\n    },\n    tags: { type: \"string\", description: \"Comma-separated tags to filter by\", required: false },\n    source: {\n      type: \"string\",\n      description:\n        \"Filter by source (uploaded, pexels, pixabay, brandfetch, google_images, firecrawl, screenshotone, iconify, giphy, …)\",\n      required: false,\n    },\n    \"external-url-host\": {\n      type: \"string\",\n      description: \"Filter to library rows whose externalUrl host contains this substring\",\n      required: false,\n    },\n  },\n});\n\nexport const libraryCommand = defineCommand({\n  meta: {\n    name: \"library\",\n    description:\n      \"Search the company image library (hybrid BM25 + vector + Cohere rerank). Use this BEFORE any external provider.\\n\\nExample: baker images library 'hero banner' --aspect-ratio 16:9 --source magnific\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query text\", required: false },\n    limit: { type: \"string\", description: \"Max results (default 5)\", required: false },\n    \"min-score\": { type: \"string\", description: \"Minimum relevance score (0-1)\", required: false },\n    \"aspect-ratio\": { type: \"string\", description: \"Aspect ratio filter\", required: false },\n    tags: { type: \"string\", description: \"Comma-separated tags to filter by\", required: false },\n    source: { type: \"string\", description: \"Filter by source\", required: false },\n    \"external-url-host\": {\n      type: \"string\",\n      description: \"Filter library by externalUrl host substring (e.g. competitor.com)\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      if (!query) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Search query is required\" } });\n        process.exit(1);\n      }\n      const body: Record<string, unknown> = { query };\n      if (args.limit) body.limit = Number(args.limit);\n      if (args[\"aspect-ratio\"]) body.aspectRatio = args[\"aspect-ratio\"];\n      if (args.tags) body.tags = (args.tags as string).split(\",\").filter(Boolean);\n      if (args.source) body.source = args.source;\n      if (args[\"external-url-host\"]) body.externalUrlHost = args[\"external-url-host\"];\n\n      let data = await apiPost<ImagesSearchResponse>(\"/api/images/search\", body);\n      const minScore = args[\"min-score\"] ? Number(args[\"min-score\"]) : undefined;\n      if (minScore !== undefined) {\n        data = data.filter((r) => typeof r.score === \"number\" && r.score >= minScore);\n      }\n      // The library is step 1 of every sourcing recipe, so an empty result is\n      // the most common dead end there is — and it used to steer nowhere.\n      // `--min-score` counts as a filter here: it is applied client-side above,\n      // so it can empty a result the backend actually returned.\n      const hints = emptyResultHints({\n        provider: \"library\",\n        hitCount: data.length,\n        activeFilters: activeFilterFlags(args, [\"aspect-ratio\", \"tags\", \"source\", \"external-url-host\", \"min-score\"]),\n        subject: query,\n      });\n      writeOutput(\n        { ok: true, data, ...(hints.length > 0 ? { hints } : {}) },\n        (args.output as OutputFormat) || \"json\",\n        args.fields ? args.fields.split(\",\") : undefined,\n        args.full as boolean,\n      );\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/lighthouse-57XBJRCO.js

@@ -0,0 +1,75 @@
+import {
+  handleResearchError,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-Y362QH54.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/lighthouse.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.lighthouse",
+  description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
+  args: {
+    url: { type: "string", description: "Full URL to audit (with https://)", required: true },
+    mobile: { type: "boolean", description: "Test as mobile (default: true)", required: false },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  url: "URL that was audited",
+  performance_score: "Lighthouse performance score 0-100 (aim for 90+)",
+  fcp_ms: "First Contentful Paint in ms (good: < 1800)",
+  lcp_ms: "Largest Contentful Paint in ms (good: < 2500)",
+  cls: "Cumulative Layout Shift (good: < 0.1)",
+  speed_index_ms: "Speed Index in ms (good: < 3400)",
+  interactive_ms: "Time to Interactive in ms (good: < 3800)"
+};
+var lighthouseCommand = defineCommand({
+  meta: {
+    name: "lighthouse",
+    description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
+
+Examples:
+  baker research lighthouse "https://example.com/landing"
+  baker research lighthouse "https://example.com" --mobile false`
+  },
+  args: {
+    url: { type: "positional", description: "Full URL to audit (with https://)", required: true },
+    mobile: { type: "string", description: "Test as mobile: true|false (default: true)", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const url = args.url;
+    const mobile = args.mobile === "false" ? false : void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    try {
+      const data = await apiPost("/api/research/lighthouse", {
+        url,
+        mobile,
+        skipCache
+      });
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeResearchOutput([data], format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  lighthouseCommand
+};
+//# sourceMappingURL=lighthouse-57XBJRCO.js.map

package/dist/lighthouse-57XBJRCO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/lighthouse.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { handleResearchError, writeResearchJson, writeResearchOutput } from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.lighthouse\",\n  description: \"Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.\",\n  args: {\n    url: { type: \"string\", description: \"Full URL to audit (with https://)\", required: true },\n    mobile: { type: \"boolean\", description: \"Test as mobile (default: true)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\ninterface LighthouseResult {\n  url: string;\n  performance_score: number;\n  fcp_ms: number;\n  lcp_ms: number;\n  cls: number;\n  speed_index_ms: number;\n  interactive_ms: number;\n}\n\nconst FIELDS: Record<string, string> = {\n  url: \"URL that was audited\",\n  performance_score: \"Lighthouse performance score 0-100 (aim for 90+)\",\n  fcp_ms: \"First Contentful Paint in ms (good: < 1800)\",\n  lcp_ms: \"Largest Contentful Paint in ms (good: < 2500)\",\n  cls: \"Cumulative Layout Shift (good: < 0.1)\",\n  speed_index_ms: \"Speed Index in ms (good: < 3400)\",\n  interactive_ms: \"Time to Interactive in ms (good: < 3800)\",\n};\n\nexport const lighthouseCommand = defineCommand({\n  meta: {\n    name: \"lighthouse\",\n    description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.\n\nExamples:\n  baker research lighthouse \"https://example.com/landing\"\n  baker research lighthouse \"https://example.com\" --mobile false`,\n  },\n  args: {\n    url: { type: \"positional\", description: \"Full URL to audit (with https://)\", required: true },\n    mobile: { type: \"string\", description: \"Test as mobile: true|false (default: true)\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const url = args.url as string;\n    const mobile = args.mobile === \"false\" ? false : undefined;\n    const skipCache = args[\"no-cache\"] ? true : undefined;\n\n    try {\n      const data = await apiPost<LighthouseResult>(\"/api/research/lighthouse\", {\n        url,\n        mobile,\n        skipCache,\n      });\n\n      const format = (args.output as string) || \"json\";\n      if (format !== \"json\") {\n        writeResearchOutput([data as unknown as Record<string, unknown>], format);\n        return;\n      }\n      writeResearchJson({ ok: true, data, fields: FIELDS });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAK9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,KAAK,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,KAAK;AAAA,IACxF,QAAQ,EAAE,MAAM,WAAW,aAAa,kCAAkC,UAAU,MAAM;AAAA,IAC1F,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AACF,CAAC;AAYD,IAAM,SAAiC;AAAA,EACrC,KAAK;AAAA,EACL,mBAAmB;AAAA,EACnB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,gBAAgB;AAAA,EAChB,gBAAgB;AAClB;AAEO,IAAM,oBAAoB,cAAc;AAAA,EAC7C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,IACJ,KAAK,EAAE,MAAM,cAAc,aAAa,qCAAqC,UAAU,KAAK;AAAA,IAC5F,QAAQ,EAAE,MAAM,UAAU,aAAa,8CAA8C,UAAU,MAAM;AAAA,IACrG,QAAQ,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,OAAO;AAAA,IACrG,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,MAAM,KAAK;AACjB,UAAM,SAAS,KAAK,WAAW,UAAU,QAAQ;AACjD,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO;AAE5C,QAAI;AACF,YAAM,OAAO,MAAM,QAA0B,4BAA4B;AAAA,QACvE;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,YAAM,SAAU,KAAK,UAAqB;AAC1C,UAAI,WAAW,QAAQ;AACrB,4BAAoB,CAAC,IAA0C,GAAG,MAAM;AACxE;AAAA,MACF;AACA,wBAAkB,EAAE,IAAI,MAAM,MAAM,QAAQ,OAAO,CAAC;AAAA,IACtD,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}