@koda-sl/baker-cli 0.567.0 → 0.569.0-dev.1b455b3fe

package/dist/relevant-pages-4YGN3I2U.js

@@ -0,0 +1,99 @@
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-D3YAFC6K.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-D32EWSMB.js";
+import "./chunk-WZXMZFVB.js";
+import "./chunk-IMS53EQU.js";
+import {
+  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/relevant-pages.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.relevant-pages",
+  description: "Get the top pages of a competitor domain with organic traffic and ranking data. Shows which pages drive the most traffic. If --location and --language are omitted, defaults to United States (us) and English (en).",
+  args: {
+    target: { type: "string", description: "Domain to analyze (positional, e.g. competitor.com)", required: true },
+    location: {
+      type: "string",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language code or name. Defaults to en (English) if omitted",
+      required: false
+    },
+    limit: { type: "string", description: "Max results (default: 20, max: 1000)", required: false },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  page: "Page URL",
+  etv: "Estimated monthly organic traffic",
+  keywords: "Total organic keywords the page ranks for",
+  top_10: "Keywords in positions 1-10"
+};
+var relevantPagesCommand = defineCommand({
+  meta: {
+    name: "relevant-pages",
+    description: `Get the top pages of a competitor domain with traffic data.
+
+Examples:
+  baker research relevant-pages "competitor.com"
+  baker research relevant-pages "competitor.com" --location es --limit 10`
+  },
+  args: {
+    target: { type: "positional", description: "Domain to analyze", required: true },
+    location: { type: "string", description: "Country code or location code (default: us)", required: false },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    limit: { type: "string", description: "Max results (default: 20, max: 1000)", 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 target = args.target;
+    const location = args.location || void 0;
+    const language = args.language || void 0;
+    const limit = args.limit ? Number(args.limit) : void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(location, language);
+    try {
+      const data = await apiPost("/api/research/relevant-pages", {
+        target,
+        location,
+        language,
+        limit,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        writeResearchHints([RESEARCH_DATA_NOTE], format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS, note: RESEARCH_DATA_NOTE, query_context: queryContext });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  relevantPagesCommand
+};
+//# sourceMappingURL=relevant-pages-4YGN3I2U.js.map

package/dist/remove-QD4PITBL.js

@@ -0,0 +1,53 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-EFTYCX5C.js";
+import {
+  testimonialSourcesRemoveRequestSchema
+} from "./chunk-YOHGEF2N.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-IMS53EQU.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/remove.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.sources.remove",
+  description: "Remove a review source AND every testimonial it imported (and their pictures). Applies immediately and cannot be undone \u2014 only when the user asked for it.",
+  args: { id: { type: "string", description: "Source id from `testimonials sources list`", required: true } }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Remove a review source and all its testimonials (cannot be undone).\n\nExample: baker testimonials sources remove <source-id>"
+  },
+  args: { id: { type: "positional", description: "Source id from `testimonials sources list`", required: true } },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesRemoveRequestSchema.safeParse({ id: String(args.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/remove", parsed.data);
+      writeJson({ ok: true, data });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  removeCommand
+};
+//# sourceMappingURL=remove-QD4PITBL.js.map

package/dist/reopen-JSC6AVJC.js

@@ -0,0 +1,66 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-LNYM4PQS.js";
+import "./chunk-YOHGEF2N.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-IMS53EQU.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/reopen.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.reopen",
+  description: "Stage reopening a completed Task: when the chat is published it goes back to the backlog as pending and its completion note is cleared. Only completed Tasks can be reopened (a discarded one cannot). Drop it with `baker actions draft remove <id> --op reopen`.",
+  args: {
+    id: { type: "string", description: "ID of a completed Task", required: true }
+  }
+});
+var reopenCommand = defineCommand({
+  meta: {
+    name: "reopen",
+    description: "Stage reopening a completed Task (applies on publish). Example: baker actions reopen <id>"
+  },
+  args: {
+    id: { type: "positional", description: "ID of a completed Task", required: false },
+    "action-id": { type: "string", description: "ID of a completed Task", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      await apiPost("/api/actions/reopen", { chatId: requireChatId(), actionId: id });
+      writeJson({
+        ok: true,
+        data: null,
+        hints: ["Staged: the Task goes back to the backlog when the chat is published."]
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  reopenCommand
+};
+//# sourceMappingURL=reopen-JSC6AVJC.js.map

package/dist/rerun-QIAUVJX6.js

@@ -0,0 +1,98 @@
+import {
+  executeCanvasRun
+} from "./chunk-L43B2YGZ.js";
+import "./chunk-TAGJYHVI.js";
+import "./chunk-WXSRSMY3.js";
+import "./chunk-WN4KX7GE.js";
+import "./chunk-IWNLW7ZC.js";
+import "./chunk-IVIJJXXT.js";
+import "./chunk-KKJ4KJCW.js";
+import "./chunk-Q6ULQMWG.js";
+import "./chunk-KNA3OWJC.js";
+import "./chunk-3ACMDRSE.js";
+import "./chunk-I7OJZ7QE.js";
+import "./chunk-77LXZAX2.js";
+import "./chunk-OSZOUSK5.js";
+import "./chunk-O7WRA3JU.js";
+import "./chunk-SOM4OTR5.js";
+import "./chunk-ROHICQPK.js";
+import "./chunk-CKHF7UXS.js";
+import "./chunk-HDMD6LXS.js";
+import "./chunk-CP6RFWLW.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-SZZ7BBED.js";
+import "./chunk-QMQSI4WA.js";
+import "./chunk-OFMFBRSL.js";
+import "./chunk-IKADYUXK.js";
+import "./chunk-46DHUWMV.js";
+import "./chunk-MWJ6BCZJ.js";
+import "./chunk-SYDPUGF5.js";
+import "./chunk-ESSA3AWR.js";
+import "./chunk-TQJLEVLA.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-4H6XLX7E.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-IAYJKH4R.js";
+import "./chunk-7URHRPC7.js";
+import "./chunk-TW57RTKN.js";
+import "./chunk-AQNTVM6S.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-Y2TOB4N5.js";
+import "./chunk-KJ3J2DYM.js";
+import "./chunk-MTFAG6E3.js";
+import "./chunk-F3CZFUXZ.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-YOHGEF2N.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-IMS53EQU.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/rerun.ts
+import { defineCommand } from "citty";
+var rerunCommand = defineCommand({
+  meta: {
+    name: "rerun",
+    hidden: true,
+    description: "Deprecated: use `baker canvas run --slug <slug>`, which does the same."
+  },
+  args: {
+    slug: { type: "positional", required: true, description: "Creative slug (src/creatives/<slug>)" },
+    "force-remote": {
+      type: "boolean",
+      default: false,
+      description: "Overwrite local files whose content differs from the recorded snapshot"
+    },
+    fresh: { type: "boolean", default: false, description: "Start a new run id instead of resuming an interrupted one" },
+    regenerate: { type: "string", description: "Comma-separated node ids to force fresh this run" },
+    concurrency: { type: "string", description: "Max nodes running at once" }
+  },
+  async run({ args }) {
+    process.stderr.write("[deprecated] `baker canvas rerun <slug>` is now `baker canvas run --slug <slug>`.\n");
+    await executeCanvasRun({
+      slug: String(args.slug),
+      forceRemote: args["force-remote"] === true,
+      fresh: args.fresh === true,
+      regenerate: args.regenerate !== void 0 ? String(args.regenerate) : void 0,
+      concurrency: args.concurrency !== void 0 ? String(args.concurrency) : void 0
+    });
+  }
+});
+export {
+  rerunCommand
+};
+//# sourceMappingURL=rerun-QIAUVJX6.js.map

package/dist/rerun-QIAUVJX6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/rerun.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { executeCanvasRun } from \"./run.ts\";\n\n/**\n * Deprecated spelling of `baker canvas run --slug <slug>`, kept for one release so client\n * agents and docs that still say `rerun` keep working. Hidden from help; delete once the\n * scaffold docs and hooks have shipped the new spelling everywhere.\n */\nexport const rerunCommand = defineCommand({\n  meta: {\n    name: \"rerun\",\n    hidden: true,\n    description: \"Deprecated: use `baker canvas run --slug <slug>`, which does the same.\",\n  },\n  args: {\n    slug: { type: \"positional\", required: true, description: \"Creative slug (src/creatives/<slug>)\" },\n    \"force-remote\": {\n      type: \"boolean\",\n      default: false,\n      description: \"Overwrite local files whose content differs from the recorded snapshot\",\n    },\n    fresh: { type: \"boolean\", default: false, description: \"Start a new run id instead of resuming an interrupted one\" },\n    regenerate: { type: \"string\", description: \"Comma-separated node ids to force fresh this run\" },\n    concurrency: { type: \"string\", description: \"Max nodes running at once\" },\n  },\n  async run({ args }) {\n    process.stderr.write(\"[deprecated] `baker canvas rerun <slug>` is now `baker canvas run --slug <slug>`.\\n\");\n    await executeCanvasRun({\n      slug: String(args.slug),\n      forceRemote: args[\"force-remote\"] === true,\n      fresh: args.fresh === true,\n      regenerate: args.regenerate !== undefined ? String(args.regenerate) : undefined,\n      concurrency: args.concurrency !== undefined ? String(args.concurrency) : undefined,\n    });\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAQvB,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,aAAa;AAAA,EACf;AAAA,EACA,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,cAAc,UAAU,MAAM,aAAa,uCAAuC;AAAA,IAChG,gBAAgB;AAAA,MACd,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,IACf;AAAA,IACA,OAAO,EAAE,MAAM,WAAW,SAAS,OAAO,aAAa,4DAA4D;AAAA,IACnH,YAAY,EAAE,MAAM,UAAU,aAAa,mDAAmD;AAAA,IAC9F,aAAa,EAAE,MAAM,UAAU,aAAa,4BAA4B;AAAA,EAC1E;AAAA,EACA,MAAM,IAAI,EAAE,KAAK,GAAG;AAClB,YAAQ,OAAO,MAAM,qFAAqF;AAC1G,UAAM,iBAAiB;AAAA,MACrB,MAAM,OAAO,KAAK,IAAI;AAAA,MACtB,aAAa,KAAK,cAAc,MAAM;AAAA,MACtC,OAAO,KAAK,UAAU;AAAA,MACtB,YAAY,KAAK,eAAe,SAAY,OAAO,KAAK,UAAU,IAAI;AAAA,MACtE,aAAa,KAAK,gBAAgB,SAAY,OAAO,KAAK,WAAW,IAAI;AAAA,IAC3E,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}

package/dist/research-MMFUFZGS.js

@@ -0,0 +1,265 @@
+import {
+  chatIdFromEnv,
+  failAvatarApi,
+  failValidation
+} from "./chunk-MYIOR35H.js";
+import {
+  writeAvatars
+} from "./chunk-OFMFBRSL.js";
+import {
+  AVATAR_HANDLE_PATTERN
+} from "./chunk-YOHGEF2N.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-IMS53EQU.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/research.ts
+import { defineCommand } from "citty";
+
+// src/commands/avatars/researchHints.ts
+function described(call) {
+  return call.who ?? [call.name, call.role, call.company].filter(Boolean).join(", ");
+}
+function rerunOf(call) {
+  return [
+    "baker avatars research",
+    call.who ? quoted(call.who) : void 0,
+    call.name ? `--name ${quoted(call.name)}` : void 0,
+    call.role ? `--role ${quoted(call.role)}` : void 0,
+    call.company ? `--company ${quoted(call.company)}` : void 0,
+    call.context ? `--context ${quoted(call.context)}` : void 0,
+    call.site ? `--site ${call.site}` : void 0,
+    call.handle ? `--handle ${call.handle}` : void 0,
+    call.profile ? `--profile ${call.profile}` : void 0
+  ].filter(Boolean).join(" ");
+}
+function quoted(text) {
+  return `"${text.replaceAll('"', '\\"')}"`;
+}
+function possibleHints(data, rerun, create) {
+  const lines = (data.candidates ?? []).map(
+    (candidate) => [candidate.name, candidate.headline, candidate.profile].filter(Boolean).join(" \u2014 ")
+  );
+  const example = data.candidates?.[0]?.profile ?? "<profile url>";
+  return [
+    `Not sure it is them: these profiles matched only in part, so no photo was taken.
+${lines.map((line) => `  - ${line}`).join("\n")}`,
+    `If the copy makes clear which one is the person (same company, same role, what else you know of them), take it: \`${rerun} --profile ${example}${create}\`. If none of them clearly is, treat this as not found \u2014 never put a face in an ad on a guess.`
+  ];
+}
+function notFoundHints(data, rerun, create) {
+  const searched = data.searched.map((query) => `"${query}"`).join(", ");
+  const company = data.query.company;
+  const sites = (data.possibleSites ?? []).map(
+    (site) => `${site} may be ${company ?? "the company"}'s own website (its domain spells part of the name). If it is \u2014 you know it, or a quick look confirms it \u2014 run again on it: \`${rerun} --site ${site}${create}\`. Never name a site that is not theirs.`
+  );
+  return [
+    `No public profile could be tied to this person${searched ? ` (searched ${searched})` : ""}, so no photo was taken. Carry on with an invented one-off person drawn from the description, exactly as for anyone unnamed \u2014 never a photo of somebody else, and never stall the job over it.`,
+    ...sites,
+    'If you know more than was searched, run it again with it: their exact name or company (`--name`, `--company`), the company\'s own website (`--site <domain>`), what else is known of them (`--context "Spanish, banking"`: where they are from or based, their field), or their LinkedIn profile once you have checked it is them (`--profile <url>`).'
+  ];
+}
+function avatarHints(avatar, name) {
+  const where = avatar.reused ? `@${avatar.handle} is already ${name}'s avatar \u2014 reused, not built again.` : `@${avatar.handle} is ${name}'s avatar, built from their real photos. Its sheet settles in about 30s: if the next thing you do needs it, \`baker avatars get ${avatar.handle} --wait\`.`;
+  return [
+    where,
+    `Use it everywhere ${name} appears: \`--avatar ${avatar.handle}\` on static ads, video and Studio renders; on a landing, their photo is the avatar's \`coverUrl\` from \`baker avatars get ${avatar.handle}\` (upscale it when it is shown large). Never invent another face for them.`
+  ];
+}
+function foundHints(data, call, rerun) {
+  const name = data.person?.name ?? described(call);
+  if (data.avatar) return avatarHints(data.avatar, name);
+  const photoIds = (data.photos ?? []).map((photo) => photo.imageId).join(",");
+  if (!photoIds) {
+    return [
+      `Found ${name}, but no usable photo of them was public${call.create ? ", so no avatar was built" : ""}. Carry on with an invented one-off person drawn from the description.`
+    ];
+  }
+  if (call.create) {
+    return [
+      `Found ${name}, but their avatar could not be built automatically. Build it from the photos yourself: \`baker avatars create --name ${quoted(name)} --subject "<one person, plainly: age, build, hair, skin, face>" --source-image ${photoIds} --likeness-confirmed\`.`
+    ];
+  }
+  return [
+    `Found ${name}; their photos are in the image library (${photoIds}). Build their avatar from them: \`${rerun} --create\`.`
+  ];
+}
+function researchHints(data, call) {
+  const rerun = rerunOf(call);
+  if (data.status === "possible") {
+    return possibleHints(data, rerunOf({ ...call, profile: void 0 }), call.create ? " --create" : "");
+  }
+  if (data.status === "not_found") return notFoundHints(data, rerun, call.create ? " --create" : "");
+  return foundHints(data, call, rerun);
+}
+
+// src/commands/avatars/research.ts
+var RESEARCH_TIMEOUT_MS = 18e4;
+registerSchema({
+  command: "avatars.research",
+  description: 'Find a REAL, named person from a description and gather their public photos \u2014 and, with --create, build their avatar from them. Start here: `baker avatars research "Lautaro Suarez, CTO at Vibiz" --create`. Use it whenever copy shows a real person by name: a testimonial author with their role and company, the company\'s founder or CEO, a named team member. Describe them: "<name>, <role> at <company>", or "the CEO of <company>" when the copy names a role, and add what else you know: --site <the company\'s own website> when its domain is not its name spelled out (santander.com for Banco Santander), --context "<where they are from or based, their field>" for someone with no company. Identity is checked in code (the name AND the company \u2014 or, with no company, the role and the context \u2014 must match a public profile): `found` returns their photos (now in the image library) and a subject description; `possible` returns the half-matches to pick from with --profile <their link> (or a LinkedIn you found and checked yourself); `not_found` lists any site that may be the company\'s (possibleSites) and means fall back to an invented one-off person. The company naming them in its copy is the go-ahead to use their likeness \u2014 no confirmation question. A person who already has an avatar comes back with it (`reused: true`) \u2014 nothing searched, nothing billed \u2014 so run it every time copy names someone.',
+  args: {
+    who: {
+      type: "string",
+      description: 'How the copy names them, e.g. "Lautaro Suarez, CTO at Vibiz" or "the CEO of Vibiz"',
+      required: true
+    },
+    name: {
+      type: "string",
+      description: "Their full name, when the description leaves it out or reads it wrong",
+      required: false
+    },
+    role: { type: "string", description: 'Their role, e.g. "CTO", "Founder"', required: false },
+    company: { type: "string", description: "The company they are at", required: false },
+    context: {
+      type: "string",
+      description: 'What else you know of them, in a few words: where they are from or based, their field, e.g. "Spanish, banking". Narrows the search; with no company, name + role + context on one profile is enough to find them',
+      required: false
+    },
+    site: {
+      type: "string",
+      description: "The company's own website, e.g. \"santander.com\" for Banco Santander: its pages are searched for them however the domain spells the name. Use it when the domain is not the company's name spelled out, or when a `not_found` lists it in possibleSites and it is theirs",
+      required: false
+    },
+    profile: {
+      type: "string",
+      description: "The profile to take, by its link: one of the candidates a `possible` answer listed (a LinkedIn, or a public record), or a LinkedIn you found and checked is them (same person, role and company). The name on it must match",
+      required: false
+    },
+    linkedin: { type: "string", description: "Same as --profile", required: false },
+    create: {
+      type: "boolean",
+      description: "Build their avatar from the photos right away (likeness `licensed`, no face picker)",
+      required: false
+    },
+    handle: {
+      type: "string",
+      description: "Mention handle for the avatar --create builds (derived from the name when omitted)",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Include their about text, location and every search that was run",
+      required: false
+    }
+  }
+});
+function compact(data, full) {
+  if (full) return data;
+  const { searched, person, ...rest } = data;
+  const { about: _about, location: _location, ...who } = person ?? { socials: {} };
+  return {
+    ...rest,
+    ...person ? { person: who } : {},
+    // A `not_found` is only useful with what was tried.
+    ...data.status === "not_found" ? { searched } : {}
+  };
+}
+var researchCommand = defineCommand({
+  meta: {
+    name: "research",
+    description: 'Find a real, named person from a description and build their avatar from their public photos. Example: baker avatars research "Lautaro Suarez, CTO at Vibiz" --create'
+  },
+  args: {
+    who: {
+      type: "positional",
+      description: 'Who: "<name>, <role> at <company>" or "the CEO of <company>"',
+      required: false
+    },
+    name: { type: "string", description: "Their full name (overrides the description)", required: false },
+    role: { type: "string", description: "Their role (overrides the description)", required: false },
+    company: { type: "string", description: "Their company (overrides the description)", required: false },
+    context: {
+      type: "string",
+      description: 'What else you know of them: "Spanish, banking" (where they are from or based, their field)',
+      required: false
+    },
+    site: { type: "string", description: `The company's own website, e.g. "santander.com"`, required: false },
+    profile: {
+      type: "string",
+      description: "The profile to take: a candidate's link from a `possible` answer, or a LinkedIn you checked is them",
+      required: false
+    },
+    linkedin: { type: "string", description: "Same as --profile", required: false },
+    create: { type: "boolean", description: "Build their avatar from the photos", required: false, default: false },
+    handle: { type: "string", description: "Mention handle for the new avatar", required: false },
+    full: {
+      type: "boolean",
+      description: "Include about, location and the searches run",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    const text = (key) => {
+      const value = args[key];
+      return typeof value === "string" && value.trim() ? value.trim() : void 0;
+    };
+    const call = callOf(text, Boolean(args.create));
+    const { who, name, company, handle } = call;
+    if (!who && !name && !company) {
+      failValidation(
+        'Say who to research, e.g. `baker avatars research "Lautaro Suarez, CTO at Vibiz"` or `baker avatars research "the CEO of Vibiz"`.'
+      );
+    }
+    if (handle && !AVATAR_HANDLE_PATTERN.test(handle)) {
+      failValidation(
+        `--handle "${handle}" is not usable. Use lowercase letters, numbers and dashes, starting with a letter \u2014 "lautaro-suarez". Leave it off to have one derived from the name.`
+      );
+    }
+    const chatId = chatIdFromEnv();
+    const { profile: profileUrl, ...asked } = call;
+    const body = {
+      ...asked,
+      ...profileUrl ? { profileUrl } : {},
+      // A backend from before --profile reads a picked LinkedIn only here.
+      ...profileUrl && /linkedin\.com\//i.test(profileUrl) ? { linkedinUrl: profileUrl } : {},
+      ...chatId ? { chatId } : {}
+    };
+    try {
+      const data = await writeAvatars("/api/avatars/research", body, {
+        timeoutMs: RESEARCH_TIMEOUT_MS
+      });
+      writeJson({ ok: true, data: compact(data, Boolean(args.full)), hints: researchHints(data, call) });
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+function callOf(text, create) {
+  const who = text("who");
+  const name = text("name");
+  const role = text("role");
+  const company = text("company");
+  const context = text("context");
+  const site = text("site");
+  const handle = text("handle")?.toLowerCase();
+  const profile = text("profile") ?? text("linkedin");
+  return {
+    ...who ? { who } : {},
+    ...name ? { name } : {},
+    ...role ? { role } : {},
+    ...company ? { company } : {},
+    ...context ? { context } : {},
+    ...site ? { site } : {},
+    ...handle ? { handle } : {},
+    ...profile ? { profile } : {},
+    create
+  };
+}
+export {
+  researchCommand
+};
+//# sourceMappingURL=research-MMFUFZGS.js.map

package/dist/research-SRISCVBM.js

@@ -0,0 +1,75 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/index.ts
+import { defineCommand } from "citty";
+var researchCommand = defineCommand({
+  meta: {
+    name: "research",
+    description: `Competitive intelligence and AI-powered research commands.
+
+Commands:
+  web                \u2014 Search the web with AI (ask any question)
+  fetch              \u2014 Read a page an ordinary web fetch could not
+  cite               \u2014 Prove a quote word for word against its page, and record the evidence
+  linkedin-person    \u2014 One person's public LinkedIn, read once for 1:1 messaging
+  transcript         \u2014 The words of a keynote, earnings call or podcast
+  company            \u2014 A company's size, industry, HQ, tech and hiring; --search to size a market
+  reddit             \u2014 Read Reddit verbatim: search posts/comments, read a thread
+  customers          \u2014 Gather real customer words into Knowledge (src/content/insights), verbatim only
+  google-ads         \u2014 A competitor's Google ads and their copy (Ads Transparency Center)
+  advertisers        \u2014 Who's bidding on a keyword?
+  autocomplete       \u2014 Google Autocomplete suggestions
+  intent             \u2014 Google Search intent classification
+  keyword-metrics    \u2014 Volume/CPC/competition for keywords you name (no domain)
+  keywords-for-site  \u2014 Keywords a domain bids on
+  keyword-gap        \u2014 Keywords they have that we don't
+  relevant-pages     \u2014 Top pages of a competitor domain
+  lighthouse         \u2014 Landing page performance audit
+  countries          \u2014 List supported country codes
+  languages          \u2014 List supported language codes
+
+Examples:
+  baker research web "Who are the main competitors of HubSpot?"
+  baker research web "What is the ICP for CRM buyers?" --depth high
+  baker research fetch "https://competitor.com/pricing"
+  baker research cite "https://competitor.com/pricing" "Plans start at $10 per month"
+  baker research linkedin-person https://www.linkedin.com/in/jane-doe
+  baker research transcript "https://www.youtube.com/watch?v=<id>" --out keynote.txt
+  baker research company acme.es
+  baker research company --search --industry computer-software --size 50-200 --country es
+  baker research reddit search "agency never paid" --subreddit AmazonFlexUK --kind comments
+  baker research customers --focus "payroll app for restaurants"
+  baker research google-ads competitor.com --location es --copy
+  baker research advertisers "running shoes"
+  baker research intent "buy running shoes,best running shoes 2026"
+  baker research keyword-metrics "chatbot whatsapp,crm whatsapp" --location mx --language es
+  baker research keywords-for-site "competitor.com"
+  baker research keyword-gap "them.com" "us.com"
+Full guide: __tooling__/docs/tools/baker/research.md`
+  },
+  subCommands: {
+    web: () => import("./web-7EODEH25.js").then((m) => m.webCommand),
+    fetch: () => import("./fetch-72ZILZHO.js").then((m) => m.fetchCommand),
+    cite: () => import("./cite-AJ5ZQWD2.js").then((m) => m.citeCommand),
+    "linkedin-person": () => import("./linkedin-person-FEIY7FYQ.js").then((m) => m.linkedinPersonCommand),
+    transcript: () => import("./transcript-FTHDWMGU.js").then((m) => m.transcriptCommand),
+    company: () => import("./company-YANP3G62.js").then((m) => m.companyCommand),
+    "google-ads": () => import("./google-ads-YBOJ3XXK.js").then((m) => m.googleAdsCommand),
+    reddit: () => import("./reddit-JFFMZLJS.js").then((m) => m.redditCommand),
+    customers: () => import("./customers-LP6I7POL.js").then((m) => m.customersCommand),
+    advertisers: () => import("./advertisers-HSTND4HE.js").then((m) => m.advertisersCommand),
+    autocomplete: () => import("./autocomplete-5BKEMOQ3.js").then((m) => m.autocompleteCommand),
+    countries: () => import("./countries-GZSBGSVT.js").then((m) => m.countriesCommand),
+    intent: () => import("./intent-URHTU4AK.js").then((m) => m.intentCommand),
+    "keyword-metrics": () => import("./keyword-metrics-57MUTYMH.js").then((m) => m.keywordMetricsCommand),
+    "keywords-for-site": () => import("./keywords-for-site-ABZS7O5B.js").then((m) => m.keywordsForSiteCommand),
+    "keyword-gap": () => import("./keyword-gap-WXM6SN6A.js").then((m) => m.keywordGapCommand),
+    languages: () => import("./languages-GCRI2PI3.js").then((m) => m.languagesCommand),
+    lighthouse: () => import("./lighthouse-W3KAVW2G.js").then((m) => m.lighthouseCommand),
+    "relevant-pages": () => import("./relevant-pages-4YGN3I2U.js").then((m) => m.relevantPagesCommand)
+  }
+});
+export {
+  researchCommand
+};
+//# sourceMappingURL=research-SRISCVBM.js.map