@koda-sl/baker-cli 0.458.0 → 0.459.0

package/dist/rerun-V4AMTVWG.js

@@ -0,0 +1,84 @@
+import {
+  executeCanvasRun
+} from "./chunk-T7Q4SWW4.js";
+import "./chunk-SXIPXBL2.js";
+import "./chunk-MWOIESOS.js";
+import "./chunk-WN4KX7GE.js";
+import "./chunk-EHXZDWAE.js";
+import "./chunk-E5EJRF7J.js";
+import "./chunk-IVIJJXXT.js";
+import "./chunk-44RWJ33Z.js";
+import "./chunk-KKJ4KJCW.js";
+import "./chunk-Q6ULQMWG.js";
+import "./chunk-3ACMDRSE.js";
+import "./chunk-HSAPEQBP.js";
+import "./chunk-I2HHXYRN.js";
+import "./chunk-FH23H72G.js";
+import "./chunk-TU7DPHNP.js";
+import "./chunk-TUYWBLHR.js";
+import "./chunk-LLEF2Q66.js";
+import "./chunk-FZT2UQF2.js";
+import "./chunk-WAGMHPWG.js";
+import "./chunk-LXBRJNIB.js";
+import "./chunk-NFSLRRIE.js";
+import "./chunk-SKAB7IBX.js";
+import "./chunk-OB6QMAE3.js";
+import "./chunk-S4EYRHCD.js";
+import "./chunk-IRUUPYCH.js";
+import "./chunk-4RARCMPM.js";
+import "./chunk-WSUZBTE6.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-CUJ2F472.js";
+import "./chunk-B7GQ4YUK.js";
+import "./chunk-CHSNHVYF.js";
+import "./chunk-ITWB62LG.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-3L4P5X7N.js";
+import "./chunk-JBDX74X5.js";
+import "./chunk-ULPPKJQH.js";
+import "./chunk-IK56IWZC.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import "./chunk-USFTTDIO.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-V4AMTVWG.js.map

package/dist/rerun-V4AMTVWG.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-C6SQN5IV.js

@@ -0,0 +1,261 @@
+import {
+  chatIdFromEnv,
+  failAvatarApi,
+  failValidation
+} from "./chunk-AINDZHQQ.js";
+import {
+  writeAvatars
+} from "./chunk-EHXZDWAE.js";
+import {
+  AVATAR_HANDLE_PATTERN
+} from "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-USFTTDIO.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-C6SQN5IV.js.map

package/dist/research-C6SQN5IV.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-XRE3LGFO.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-YSFEOI53.js").then((m) => m.webCommand),
+    fetch: () => import("./fetch-ELCHOTCH.js").then((m) => m.fetchCommand),
+    "google-ads": () => import("./google-ads-CJHPQ6ZB.js").then((m) => m.googleAdsCommand),
+    reddit: () => import("./reddit-6U3NJUBN.js").then((m) => m.redditCommand),
+    customers: () => import("./customers-54DNP36T.js").then((m) => m.customersCommand),
+    advertisers: () => import("./advertisers-S4YJJF36.js").then((m) => m.advertisersCommand),
+    autocomplete: () => import("./autocomplete-CJMIVLXG.js").then((m) => m.autocompleteCommand),
+    countries: () => import("./countries-HKTPBBLQ.js").then((m) => m.countriesCommand),
+    intent: () => import("./intent-4X76HZ4S.js").then((m) => m.intentCommand),
+    "keyword-metrics": () => import("./keyword-metrics-OWHQGCOD.js").then((m) => m.keywordMetricsCommand),
+    "keywords-for-site": () => import("./keywords-for-site-JPZUG65E.js").then((m) => m.keywordsForSiteCommand),
+    "keyword-gap": () => import("./keyword-gap-JZQSQBCJ.js").then((m) => m.keywordGapCommand),
+    languages: () => import("./languages-OG5UB5HX.js").then((m) => m.languagesCommand),
+    lighthouse: () => import("./lighthouse-PZVDR4V4.js").then((m) => m.lighthouseCommand),
+    "relevant-pages": () => import("./relevant-pages-E5IWT4JX.js").then((m) => m.relevantPagesCommand)
+  }
+});
+export {
+  researchCommand
+};
+//# sourceMappingURL=research-XRE3LGFO.js.map

package/dist/reset-G67E32S3.js

@@ -0,0 +1,53 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-WNP25LQF.js";
+import {
+  testimonialSourcesResetRequestSchema
+} from "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-USFTTDIO.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-G67E32S3.js.map

package/dist/reset-G67E32S3.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/reset-GKF3PG5D.js

@@ -0,0 +1,53 @@
+import {
+  reportError
+} from "./chunk-WLRQPH3F.js";
+import {
+  mediaSourcesResetRequestSchema
+} from "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-USFTTDIO.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-GKF3PG5D.js.map

package/dist/reset-GKF3PG5D.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":[]}