@koda-sl/baker-cli 0.495.0 → 0.497.0

package/dist/research-L25D4WHQ.js

@@ -0,0 +1,263 @@
+import {
+  chatIdFromEnv,
+  failAvatarApi,
+  failValidation
+} from "./chunk-BAXDNVT2.js";
+import {
+  writeAvatars
+} from "./chunk-QG4MW2V4.js";
+import {
+  AVATAR_HANDLE_PATTERN
+} from "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.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-L25D4WHQ.js.map

package/dist/research-L25D4WHQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/avatars/research.ts","../src/commands/avatars/researchHints.ts"],"sourcesContent":["import { AVATAR_HANDLE_PATTERN, type AvatarsResearchRequest, type AvatarsResearchResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { chatIdFromEnv } from \"./casting.ts\";\nimport { failAvatarApi, failValidation } from \"./failures.ts\";\nimport { type ResearchCall, researchHints } from \"./researchHints.ts\";\nimport { writeAvatars } from \"./transport.ts\";\n\n/** Searches, profile reads, a vision check and the photo ingests — well past the default minute on a slow day. */\nconst RESEARCH_TIMEOUT_MS = 180_000;\n\nregisterSchema({\n  command: \"avatars.research\",\n  description:\n    'Find a REAL, named person from a description and gather their public photos — 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 — or, with no company, the role and the context — 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 — no confirmation question. A person who already has an avatar comes back with it (`reused: true`) — nothing searched, nothing billed — so run it every time copy names someone.',\n  args: {\n    who: {\n      type: \"string\",\n      description: 'How the copy names them, e.g. \"Lautaro Suarez, CTO at Vibiz\" or \"the CEO of Vibiz\"',\n      required: true,\n    },\n    name: {\n      type: \"string\",\n      description: \"Their full name, when the description leaves it out or reads it wrong\",\n      required: false,\n    },\n    role: { type: \"string\", description: 'Their role, e.g. \"CTO\", \"Founder\"', required: false },\n    company: { type: \"string\", description: \"The company they are at\", required: false },\n    context: {\n      type: \"string\",\n      description:\n        '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',\n      required: false,\n    },\n    site: {\n      type: \"string\",\n      description:\n        \"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\",\n      required: false,\n    },\n    profile: {\n      type: \"string\",\n      description:\n        \"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\",\n      required: false,\n    },\n    linkedin: { type: \"string\", description: \"Same as --profile\", required: false },\n    create: {\n      type: \"boolean\",\n      description: \"Build their avatar from the photos right away (likeness `licensed`, no face picker)\",\n      required: false,\n    },\n    handle: {\n      type: \"string\",\n      description: \"Mention handle for the avatar --create builds (derived from the name when omitted)\",\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Include their about text, location and every search that was run\",\n      required: false,\n    },\n  },\n});\n\n/**\n * Compact by default: what an agent needs to decide — who, how sure, which photos,\n * which avatar. The about text is paragraphs long and only matters to a reader.\n */\nfunction compact(data: AvatarsResearchResponse, full: boolean): Record<string, unknown> {\n  if (full) return data;\n  const { searched, person, ...rest } = data;\n  const { about: _about, location: _location, ...who } = person ?? { socials: {} };\n  return {\n    ...rest,\n    ...(person ? { person: who } : {}),\n    // A `not_found` is only useful with what was tried.\n    ...(data.status === \"not_found\" ? { searched } : {}),\n  };\n}\n\nexport const researchCommand = defineCommand({\n  meta: {\n    name: \"research\",\n    description:\n      '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',\n  },\n  args: {\n    who: {\n      type: \"positional\",\n      description: 'Who: \"<name>, <role> at <company>\" or \"the CEO of <company>\"',\n      required: false,\n    },\n    name: { type: \"string\", description: \"Their full name (overrides the description)\", required: false },\n    role: { type: \"string\", description: \"Their role (overrides the description)\", required: false },\n    company: { type: \"string\", description: \"Their company (overrides the description)\", required: false },\n    context: {\n      type: \"string\",\n      description: 'What else you know of them: \"Spanish, banking\" (where they are from or based, their field)',\n      required: false,\n    },\n    site: { type: \"string\", description: 'The company\\'s own website, e.g. \"santander.com\"', required: false },\n    profile: {\n      type: \"string\",\n      description:\n        \"The profile to take: a candidate's link from a `possible` answer, or a LinkedIn you checked is them\",\n      required: false,\n    },\n    linkedin: { type: \"string\", description: \"Same as --profile\", required: false },\n    create: { type: \"boolean\", description: \"Build their avatar from the photos\", required: false, default: false },\n    handle: { type: \"string\", description: \"Mention handle for the new avatar\", required: false },\n    full: {\n      type: \"boolean\",\n      description: \"Include about, location and the searches run\",\n      required: false,\n      default: false,\n    },\n  },\n  run: async ({ args }) => {\n    const text = (key: string) => {\n      const value = (args as Record<string, unknown>)[key];\n      return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n    };\n    const call = callOf(text, Boolean(args.create));\n    const { who, name, company, handle } = call;\n    if (!who && !name && !company) {\n      failValidation(\n        'Say who to research, e.g. `baker avatars research \"Lautaro Suarez, CTO at Vibiz\"` or `baker avatars research \"the CEO of Vibiz\"`.',\n      );\n    }\n    if (handle && !AVATAR_HANDLE_PATTERN.test(handle)) {\n      failValidation(\n        `--handle \"${handle}\" is not usable. Use lowercase letters, numbers and dashes, starting with a letter — \"lautaro-suarez\". Leave it off to have one derived from the name.`,\n      );\n    }\n\n    const chatId = chatIdFromEnv();\n    const { profile: profileUrl, ...asked } = call;\n    const body: AvatarsResearchRequest = {\n      ...asked,\n      ...(profileUrl ? { profileUrl } : {}),\n      // A backend from before --profile reads a picked LinkedIn only here.\n      ...(profileUrl && /linkedin\\.com\\//i.test(profileUrl) ? { linkedinUrl: profileUrl } : {}),\n      ...(chatId ? { chatId } : {}),\n    };\n\n    try {\n      const data = await writeAvatars<AvatarsResearchResponse>(\"/api/avatars/research\", body, {\n        timeoutMs: RESEARCH_TIMEOUT_MS,\n      });\n      writeJson({ ok: true, data: compact(data, Boolean(args.full)), hints: researchHints(data, call) });\n    } catch (err) {\n      failAvatarApi(err, handle);\n    }\n  },\n});\n\n/** The call as it was made: the description and the flags given, each only when set. */\nfunction callOf(text: (key: string) => string | undefined, create: boolean): ResearchCall {\n  const who = text(\"who\");\n  const name = text(\"name\");\n  const role = text(\"role\");\n  const company = text(\"company\");\n  const context = text(\"context\");\n  const site = text(\"site\");\n  const handle = text(\"handle\")?.toLowerCase();\n  const profile = text(\"profile\") ?? text(\"linkedin\");\n  return {\n    ...(who ? { who } : {}),\n    ...(name ? { name } : {}),\n    ...(role ? { role } : {}),\n    ...(company ? { company } : {}),\n    ...(context ? { context } : {}),\n    ...(site ? { site } : {}),\n    ...(handle ? { handle } : {}),\n    ...(profile ? { profile } : {}),\n    create,\n  };\n}\n","import type { AvatarsResearchResponse } from \"@baker/api\";\n\n/** How the command was called, so a hint can hand back the exact next command. */\nexport interface ResearchCall {\n  who?: string;\n  name?: string;\n  role?: string;\n  company?: string;\n  context?: string;\n  site?: string;\n  handle?: string;\n  /** The profile picked by its link (`--profile`, or `--linkedin` as it was called before). */\n  profile?: string;\n  create: boolean;\n}\n\n/** The person as the call described them. */\nfunction described(call: ResearchCall): string {\n  return call.who ?? [call.name, call.role, call.company].filter(Boolean).join(\", \");\n}\n\n/** The call again, exactly as it was made (without `--create`, which each hint adds when it applies). */\nfunction rerunOf(call: ResearchCall): string {\n  return [\n    \"baker avatars research\",\n    call.who ? quoted(call.who) : undefined,\n    call.name ? `--name ${quoted(call.name)}` : undefined,\n    call.role ? `--role ${quoted(call.role)}` : undefined,\n    call.company ? `--company ${quoted(call.company)}` : undefined,\n    call.context ? `--context ${quoted(call.context)}` : undefined,\n    call.site ? `--site ${call.site}` : undefined,\n    call.handle ? `--handle ${call.handle}` : undefined,\n    call.profile ? `--profile ${call.profile}` : undefined,\n  ]\n    .filter(Boolean)\n    .join(\" \");\n}\n\nfunction quoted(text: string): string {\n  return `\"${text.replaceAll('\"', '\\\\\"')}\"`;\n}\n\nfunction possibleHints(data: AvatarsResearchResponse, rerun: string, create: string): string[] {\n  const lines = (data.candidates ?? []).map((candidate) =>\n    [candidate.name, candidate.headline, candidate.profile].filter(Boolean).join(\" — \"),\n  );\n  const example = data.candidates?.[0]?.profile ?? \"<profile url>\";\n  return [\n    `Not sure it is them: these profiles matched only in part, so no photo was taken.\\n${lines.map((line) => `  - ${line}`).join(\"\\n\")}`,\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 — never put a face in an ad on a guess.`,\n  ];\n}\n\nfunction notFoundHints(data: AvatarsResearchResponse, rerun: string, create: string): string[] {\n  const searched = data.searched.map((query) => `\"${query}\"`).join(\", \");\n  const company = data.query.company;\n  const sites = (data.possibleSites ?? []).map(\n    (site) =>\n      `${site} may be ${company ?? \"the company\"}'s own website (its domain spells part of the name). If it is — you know it, or a quick look confirms it — run again on it: \\`${rerun} --site ${site}${create}\\`. Never name a site that is not theirs.`,\n  );\n  return [\n    `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 — never a photo of somebody else, and never stall the job over it.`,\n    ...sites,\n    '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>`).',\n  ];\n}\n\nfunction avatarHints(avatar: NonNullable<AvatarsResearchResponse[\"avatar\"]>, name: string): string[] {\n  const where = avatar.reused\n    ? `@${avatar.handle} is already ${name}'s avatar — reused, not built again.`\n    : `@${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\\`.`;\n  return [\n    where,\n    `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.`,\n  ];\n}\n\nfunction foundHints(data: AvatarsResearchResponse, call: ResearchCall, rerun: string): string[] {\n  const name = data.person?.name ?? described(call);\n  if (data.avatar) return avatarHints(data.avatar, name);\n\n  const photoIds = (data.photos ?? []).map((photo) => photo.imageId).join(\",\");\n  if (!photoIds) {\n    return [\n      `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.`,\n    ];\n  }\n  if (call.create) {\n    return [\n      `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\\`.`,\n    ];\n  }\n  return [\n    `Found ${name}; their photos are in the image library (${photoIds}). Build their avatar from them: \\`${rerun} --create\\`.`,\n  ];\n}\n\n/** What the agent should do next with a research answer, keyed off its status. */\nexport function researchHints(data: AvatarsResearchResponse, call: ResearchCall): string[] {\n  const rerun = rerunOf(call);\n  if (data.status === \"possible\") {\n    return possibleHints(data, rerunOf({ ...call, profile: undefined }), call.create ? \" --create\" : \"\");\n  }\n  if (data.status === \"not_found\") return notFoundHints(data, rerun, call.create ? \" --create\" : \"\");\n  return foundHints(data, call, rerun);\n}\n"],"mappings":"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","names":[]}

package/dist/research-YCMMQVK6.js

@@ -0,0 +1,62 @@
+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
+  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 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-6JMWERTT.js").then((m) => m.webCommand),
+    fetch: () => import("./fetch-HMUGSRE4.js").then((m) => m.fetchCommand),
+    "google-ads": () => import("./google-ads-6X4BHGUR.js").then((m) => m.googleAdsCommand),
+    reddit: () => import("./reddit-6C3PT5CT.js").then((m) => m.redditCommand),
+    customers: () => import("./customers-LMSX33FO.js").then((m) => m.customersCommand),
+    advertisers: () => import("./advertisers-STYAIX72.js").then((m) => m.advertisersCommand),
+    autocomplete: () => import("./autocomplete-SDDSJTAF.js").then((m) => m.autocompleteCommand),
+    countries: () => import("./countries-F5ISQB3M.js").then((m) => m.countriesCommand),
+    intent: () => import("./intent-FUGWRUSW.js").then((m) => m.intentCommand),
+    "keyword-metrics": () => import("./keyword-metrics-KNTIN4ZK.js").then((m) => m.keywordMetricsCommand),
+    "keywords-for-site": () => import("./keywords-for-site-S4MXGXWR.js").then((m) => m.keywordsForSiteCommand),
+    "keyword-gap": () => import("./keyword-gap-DXTKZLV2.js").then((m) => m.keywordGapCommand),
+    languages: () => import("./languages-73GOUAHX.js").then((m) => m.languagesCommand),
+    lighthouse: () => import("./lighthouse-ZZUYZALE.js").then((m) => m.lighthouseCommand),
+    "relevant-pages": () => import("./relevant-pages-CTG72PBR.js").then((m) => m.relevantPagesCommand)
+  }
+});
+export {
+  researchCommand
+};
+//# sourceMappingURL=research-YCMMQVK6.js.map

package/dist/reset-HKKCWKZ7.js

@@ -0,0 +1,55 @@
+import {
+  reportError
+} from "./chunk-SZNGQ2GF.js";
+import {
+  mediaSourcesResetRequestSchema
+} from "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/reset.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "media-sources.reset",
+  description: "Unstick a connected source whose import failed, or has not moved for an hour, so it can import again. Keeps what it already imported. Refused while an import is still moving.",
+  args: {
+    key: { type: "string", description: "Source key from `media-sources list`, e.g. tiktok:acme", required: true }
+  }
+});
+var resetCommand = defineCommand({
+  meta: {
+    name: "reset",
+    description: "Unstick a source whose import failed or has not moved for an hour, so it can import again. Keeps what it already imported; refused while an import is still moving.\n\nExample: baker media-sources reset tiktok:acme"
+  },
+  args: { key: { type: "positional", description: "Source key, e.g. tiktok:acme", required: true } },
+  run: async ({ args }) => {
+    const parsed = mediaSourcesResetRequestSchema.safeParse({ key: String(args.key ?? "") });
+    if (!parsed.success) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message ?? "" } });
+      process.exit(1);
+    }
+    try {
+      const data = await apiPost("/api/media-sources/reset", parsed.data);
+      writeJson({ ok: true, data, hints: [`Run \`baker media-sources sync ${data.key}\` to import its new posts.`] });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  resetCommand
+};
+//# sourceMappingURL=reset-HKKCWKZ7.js.map

package/dist/reset-HKKCWKZ7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/media-sources/reset.ts"],"sourcesContent":["import { type MediaSourcesResetResponse, mediaSourcesResetRequestSchema } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"media-sources.reset\",\n  description:\n    \"Unstick a connected source whose import failed, or has not moved for an hour, so it can import again. Keeps what it already imported. Refused while an import is still moving.\",\n  args: {\n    key: { type: \"string\", description: \"Source key from `media-sources list`, e.g. tiktok:acme\", required: true },\n  },\n});\n\nexport const resetCommand = defineCommand({\n  meta: {\n    name: \"reset\",\n    description:\n      \"Unstick a source whose import failed or has not moved for an hour, so it can import again. Keeps what it already imported; refused while an import is still moving.\\n\\nExample: baker media-sources reset tiktok:acme\",\n  },\n  args: { key: { type: \"positional\", description: \"Source key, e.g. tiktok:acme\", required: true } },\n  run: async ({ args }) => {\n    const parsed = mediaSourcesResetRequestSchema.safeParse({ key: String(args.key ?? \"\") });\n    if (!parsed.success) {\n      writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: parsed.error.issues[0]?.message ?? \"\" } });\n      process.exit(1);\n    }\n    try {\n      const data = await apiPost<MediaSourcesResetResponse>(\"/api/media-sources/reset\", parsed.data);\n      writeJson({ ok: true, data, hints: [`Run \\`baker media-sources sync ${data.key}\\` to import its new posts.`] });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,KAAK,EAAE,MAAM,UAAU,aAAa,0DAA0D,UAAU,KAAK;AAAA,EAC/G;AACF,CAAC;AAEM,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM,EAAE,KAAK,EAAE,MAAM,cAAc,aAAa,gCAAgC,UAAU,KAAK,EAAE;AAAA,EACjG,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,+BAA+B,UAAU,EAAE,KAAK,OAAO,KAAK,OAAO,EAAE,EAAE,CAAC;AACvF,QAAI,CAAC,OAAO,SAAS;AACnB,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,SAAS,OAAO,MAAM,OAAO,CAAC,GAAG,WAAW,GAAG,EAAE,CAAC;AAC5G,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,QAAI;AACF,YAAM,OAAO,MAAM,QAAmC,4BAA4B,OAAO,IAAI;AAC7F,gBAAU,EAAE,IAAI,MAAM,MAAM,OAAO,CAAC,kCAAkC,KAAK,GAAG,6BAA6B,EAAE,CAAC;AAAA,IAChH,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/reset-SRL6I6GP.js

@@ -0,0 +1,55 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-RVTXDQYC.js";
+import {
+  testimonialSourcesResetRequestSchema
+} from "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/reset.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.sources.reset",
+  description: "Unstick a review source whose import failed or has not moved for an hour, so it can be imported again. Refused while an import is still running. Keeps its reviews.",
+  args: { id: { type: "string", description: "Source id from `testimonials sources list`", required: true } }
+});
+var resetCommand = defineCommand({
+  meta: {
+    name: "reset",
+    description: "Unstick a review source whose import failed or has not moved for an hour, so it can be imported again. Refused while an import is still running. Keeps its reviews.\n\nExample: baker testimonials sources reset <source-id>"
+  },
+  args: { id: { type: "positional", description: "Source id from `testimonials sources list`", required: true } },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesResetRequestSchema.safeParse({ id: String(args.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/reset", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: [`Run \`baker testimonials sources sync ${data.id}\` to import its reviews again.`]
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  resetCommand
+};
+//# sourceMappingURL=reset-SRL6I6GP.js.map

package/dist/reset-SRL6I6GP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/testimonials/sources/reset.ts"],"sourcesContent":["import { type TestimonialSourcesResetResponse, testimonialSourcesResetRequestSchema } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeJson } from \"../../../output.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { reportError, reportInvalid } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"testimonials.sources.reset\",\n  description:\n    \"Unstick a review source whose import failed or has not moved for an hour, so it can be imported again. Refused while an import is still running. Keeps its reviews.\",\n  args: { id: { type: \"string\", description: \"Source id from `testimonials sources list`\", required: true } },\n});\n\nexport const resetCommand = defineCommand({\n  meta: {\n    name: \"reset\",\n    description:\n      \"Unstick a review source whose import failed or has not moved for an hour, so it can be imported again. Refused while an import is still running. Keeps its reviews.\\n\\nExample: baker testimonials sources reset <source-id>\",\n  },\n  args: { id: { type: \"positional\", description: \"Source id from `testimonials sources list`\", required: true } },\n  run: async ({ args }) => {\n    const parsed = testimonialSourcesResetRequestSchema.safeParse({ id: String(args.id ?? \"\") });\n    if (!parsed.success) reportInvalid(parsed.error.issues[0]);\n    try {\n      const data = await apiPost<TestimonialSourcesResetResponse>(\"/api/testimonials/sources/reset\", parsed.data);\n      writeJson({\n        ok: true,\n        data,\n        hints: [`Run \\`baker testimonials sources sync ${data.id}\\` to import its reviews again.`],\n      });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,aAAa,8CAA8C,UAAU,KAAK,EAAE;AAC5G,CAAC;AAEM,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,aAAa,8CAA8C,UAAU,KAAK,EAAE;AAAA,EAC9G,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,qCAAqC,UAAU,EAAE,IAAI,OAAO,KAAK,MAAM,EAAE,EAAE,CAAC;AAC3F,QAAI,CAAC,OAAO,QAAS,eAAc,OAAO,MAAM,OAAO,CAAC,CAAC;AACzD,QAAI;AACF,YAAM,OAAO,MAAM,QAAyC,mCAAmC,OAAO,IAAI;AAC1G,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ;AAAA,QACA,OAAO,CAAC,yCAAyC,KAAK,EAAE,iCAAiC;AAAA,MAC3F,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/resolve-POMTTAFR.js

@@ -0,0 +1,122 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-2YTBPRRG.js";
+import {
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-2VIZ4UUZ.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-U6RONIJC.js";
+import "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/resolve.ts
+import { defineCommand } from "citty";
+function domainHints(resolution) {
+  const hints = [];
+  if (resolution.errors.length > 0) {
+    hints.push(
+      `LinkedIn has no organization for ${resolution.errors.map((e) => e.id).join(", ")} \u2014 skip them or check the ids.`
+    );
+  }
+  if (resolution.orgs.some((o) => o.domainSource === "subdomain")) {
+    hints.push("domainSource=subdomain (e.g. news.microsoft.com \u2192 microsoft.com) is a weaker match \u2014 confirm it.");
+  }
+  if (resolution.orgs.some((o) => o.domainSource === "none")) {
+    hints.push("domainSource=none: no usable website (shortlink or missing) \u2014 match those by vanityName or name.");
+  }
+  return hints;
+}
+function toOrgUrn(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) {
+    return null;
+  }
+  if (trimmed.startsWith("urn:li:")) {
+    return trimmed;
+  }
+  return /^\d+$/.test(trimmed) ? `urn:li:organization:${trimmed}` : null;
+}
+var resolveCommand = defineCommand({
+  meta: {
+    name: "resolve",
+    description: `Resolve organization URNs to company names.
+
+Examples:
+  baker ads linkedin resolve --urns urn:li:organization:17719,urn:li:organization:19022
+  baker ads linkedin resolve --ids 17719,19022 --output csv
+  baker ads linkedin resolve --ids 1035,1337 --with-domains   # + website domain per org, for CRM matching
+
+Accepts --urns (full URNs) and/or --ids (bare numeric ids). Rows with no name
+couldn't be resolved \u2014 typically an org outside LinkedIn's targetable set.
+
+--with-domains returns {orgs, errors}: per org name, vanityName (LinkedIn page),
+website and domain (registrable, e.g. microsoft.com) with domainSource
+website | subdomain (weaker) | none (shortlink / no website). Ids LinkedIn
+doesn't know land in errors; the rest still resolve. Cached 7 days.`
+  },
+  args: {
+    urns: { type: "string", description: "Comma-separated org URNs (urn:li:organization:NNN)" },
+    ids: { type: "string", description: "Comma-separated bare org ids (17719,19022)" },
+    "with-domains": {
+      type: "boolean",
+      description: "Return vanityName, website, domain and domainSource per org (+ errors for unknown ids)"
+    },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const raw = [args.urns, args.ids].filter(Boolean).join(",").split(",");
+    const urns = [...new Set(raw.map(toOrgUrn).filter((u) => u !== null))];
+    if (urns.length === 0) {
+      handleLinkedinError(new Error("Provide --urns or --ids (org URNs or bare numeric ids)."));
+    }
+    try {
+      if (args["with-domains"]) {
+        const resolution = await apiPost("/api/ads/linkedin/resolve-orgs", {
+          urns,
+          withDomains: true,
+          skipCache: Boolean(args["no-cache"])
+        });
+        const hints = domainHints(resolution);
+        const fmt2 = csvOrJson(args);
+        if (fmt2 !== "json") {
+          writeAdsOutput(resolution.orgs, fmt2, void 0, hints);
+          return;
+        }
+        writeJsonEnvelope(hints.length > 0 ? { ok: true, data: resolution, hints } : { ok: true, data: resolution });
+        return;
+      }
+      const data = await apiPost("/api/ads/linkedin/resolve-orgs", {
+        urns,
+        skipCache: Boolean(args["no-cache"])
+      });
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  resolveCommand
+};
+//# sourceMappingURL=resolve-POMTTAFR.js.map

package/dist/resolve-POMTTAFR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/resolve.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport { csvOrJson, handleLinkedinError } from \"./shared.ts\";\n\ninterface ResolvedOrg {\n  urn: string;\n  id: string;\n  name?: string;\n}\n\ninterface ResolvedOrgDomain {\n  urn: string;\n  id: string;\n  name: string | null;\n  vanityName: string | null;\n  website: string | null;\n  domain: string | null;\n  domainSource: \"website\" | \"subdomain\" | \"none\";\n}\n\ninterface OrgDomainResolution {\n  orgs: ResolvedOrgDomain[];\n  errors: Array<{ urn: string; id: string; status: number | null }>;\n}\n\nfunction domainHints(resolution: OrgDomainResolution): string[] {\n  const hints: string[] = [];\n  if (resolution.errors.length > 0) {\n    hints.push(\n      `LinkedIn has no organization for ${resolution.errors.map((e) => e.id).join(\", \")} — skip them or check the ids.`,\n    );\n  }\n  if (resolution.orgs.some((o) => o.domainSource === \"subdomain\")) {\n    hints.push(\"domainSource=subdomain (e.g. news.microsoft.com → microsoft.com) is a weaker match — confirm it.\");\n  }\n  if (resolution.orgs.some((o) => o.domainSource === \"none\")) {\n    hints.push(\"domainSource=none: no usable website (shortlink or missing) — match those by vanityName or name.\");\n  }\n  return hints;\n}\n\n/** Accept bare ids (`17719`) or full URNs; emit canonical `urn:li:organization:NNN`. */\nfunction toOrgUrn(raw: string): string | null {\n  const trimmed = raw.trim();\n  if (trimmed.length === 0) {\n    return null;\n  }\n  if (trimmed.startsWith(\"urn:li:\")) {\n    return trimmed;\n  }\n  return /^\\d+$/.test(trimmed) ? `urn:li:organization:${trimmed}` : null;\n}\n\n/**\n * Resolve LinkedIn organization URNs to company names. The companion to\n * `top-companies` / `analytics --pivot company`, which surface bare org URNs:\n * paste the unresolved URNs here to confirm whether they're target accounts.\n *\n * Backed by the ads-scoped adTargetingEntities `urns` finder (1h-cached). Orgs\n * outside LinkedIn's targetable employer set come back with no name.\n */\nexport const resolveCommand = defineCommand({\n  meta: {\n    name: \"resolve\",\n    description: `Resolve organization URNs to company names.\n\nExamples:\n  baker ads linkedin resolve --urns urn:li:organization:17719,urn:li:organization:19022\n  baker ads linkedin resolve --ids 17719,19022 --output csv\n  baker ads linkedin resolve --ids 1035,1337 --with-domains   # + website domain per org, for CRM matching\n\nAccepts --urns (full URNs) and/or --ids (bare numeric ids). Rows with no name\ncouldn't be resolved — typically an org outside LinkedIn's targetable set.\n\n--with-domains returns {orgs, errors}: per org name, vanityName (LinkedIn page),\nwebsite and domain (registrable, e.g. microsoft.com) with domainSource\nwebsite | subdomain (weaker) | none (shortlink / no website). Ids LinkedIn\ndoesn't know land in errors; the rest still resolve. Cached 7 days.`,\n  },\n  args: {\n    urns: { type: \"string\", description: \"Comma-separated org URNs (urn:li:organization:NNN)\" },\n    ids: { type: \"string\", description: \"Comma-separated bare org ids (17719,19022)\" },\n    \"with-domains\": {\n      type: \"boolean\",\n      description: \"Return vanityName, website, domain and domainSource per org (+ errors for unknown ids)\",\n    },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const raw = [args.urns as string | undefined, args.ids as string | undefined].filter(Boolean).join(\",\").split(\",\");\n    const urns = [...new Set(raw.map(toOrgUrn).filter((u): u is string => u !== null))];\n    if (urns.length === 0) {\n      handleLinkedinError(new Error(\"Provide --urns or --ids (org URNs or bare numeric ids).\"));\n    }\n\n    try {\n      if (args[\"with-domains\"]) {\n        const resolution = await apiPost<OrgDomainResolution>(\"/api/ads/linkedin/resolve-orgs\", {\n          urns,\n          withDomains: true,\n          skipCache: Boolean(args[\"no-cache\"]),\n        });\n        const hints = domainHints(resolution);\n        const fmt = csvOrJson(args);\n        if (fmt !== \"json\") {\n          writeAdsOutput(resolution.orgs as unknown as Array<Record<string, unknown>>, fmt, undefined, hints);\n          return;\n        }\n        writeJsonEnvelope(hints.length > 0 ? { ok: true, data: resolution, hints } : { ok: true, data: resolution });\n        return;\n      }\n      const data = await apiPost<ResolvedOrg[]>(\"/api/ads/linkedin/resolve-orgs\", {\n        urns,\n        skipCache: Boolean(args[\"no-cache\"]),\n      });\n\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AA2B9B,SAAS,YAAY,YAA2C;AAC9D,QAAM,QAAkB,CAAC;AACzB,MAAI,WAAW,OAAO,SAAS,GAAG;AAChC,UAAM;AAAA,MACJ,oCAAoC,WAAW,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,IAAI,CAAC;AAAA,IACnF;AAAA,EACF;AACA,MAAI,WAAW,KAAK,KAAK,CAAC,MAAM,EAAE,iBAAiB,WAAW,GAAG;AAC/D,UAAM,KAAK,4GAAkG;AAAA,EAC/G;AACA,MAAI,WAAW,KAAK,KAAK,CAAC,MAAM,EAAE,iBAAiB,MAAM,GAAG;AAC1D,UAAM,KAAK,uGAAkG;AAAA,EAC/G;AACA,SAAO;AACT;AAGA,SAAS,SAAS,KAA4B;AAC5C,QAAM,UAAU,IAAI,KAAK;AACzB,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,WAAW,SAAS,GAAG;AACjC,WAAO;AAAA,EACT;AACA,SAAO,QAAQ,KAAK,OAAO,IAAI,uBAAuB,OAAO,KAAK;AACpE;AAUO,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcf;AAAA,EACA,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,UAAU,aAAa,qDAAqD;AAAA,IAC1F,KAAK,EAAE,MAAM,UAAU,aAAa,6CAA6C;AAAA,IACjF,gBAAgB;AAAA,MACd,MAAM;AAAA,MACN,aAAa;AAAA,IACf;AAAA,IACA,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,qBAAqB,SAAS,OAAO;AAAA,EAC9E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,MAAM,CAAC,KAAK,MAA4B,KAAK,GAAyB,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG;AACjH,UAAM,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,IAAI,QAAQ,EAAE,OAAO,CAAC,MAAmB,MAAM,IAAI,CAAC,CAAC;AAClF,QAAI,KAAK,WAAW,GAAG;AACrB,0BAAoB,IAAI,MAAM,yDAAyD,CAAC;AAAA,IAC1F;AAEA,QAAI;AACF,UAAI,KAAK,cAAc,GAAG;AACxB,cAAM,aAAa,MAAM,QAA6B,kCAAkC;AAAA,UACtF;AAAA,UACA,aAAa;AAAA,UACb,WAAW,QAAQ,KAAK,UAAU,CAAC;AAAA,QACrC,CAAC;AACD,cAAM,QAAQ,YAAY,UAAU;AACpC,cAAMA,OAAM,UAAU,IAAI;AAC1B,YAAIA,SAAQ,QAAQ;AAClB,yBAAe,WAAW,MAAmDA,MAAK,QAAW,KAAK;AAClG;AAAA,QACF;AACA,0BAAkB,MAAM,SAAS,IAAI,EAAE,IAAI,MAAM,MAAM,YAAY,MAAM,IAAI,EAAE,IAAI,MAAM,MAAM,WAAW,CAAC;AAC3G;AAAA,MACF;AACA,YAAM,OAAO,MAAM,QAAuB,kCAAkC;AAAA,QAC1E;AAAA,QACA,WAAW,QAAQ,KAAK,UAAU,CAAC;AAAA,MACrC,CAAC;AAED,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAClB,uBAAe,MAAmD,GAAG;AACrE;AAAA,MACF;AACA,mBAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACjC,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":["fmt"]}