@koda-sl/baker-cli 0.573.0 → 0.574.0

package/dist/people-5A6NEDEU.js

@@ -0,0 +1,164 @@
+import {
+  peopleHints
+} from "./chunk-P3CYWSTO.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-7PKEBTVP.js";
+import "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/people.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.people",
+  description: "Who likely holds a role at one company \u2014 start here to name the people behind an ABM account (the CTO, the VP of Engineering) when the client's CRM doesn't have them. Searches Google's public LinkedIn results once, then a decision model checks every profile: works at the company now (`atCompany`) and holds the role (`roleMatch`), 0-1 each; profiles failing either are dropped. Leads to confirm, never contacts: nothing is stored. Example: `baker research people acme.com --title \"Chief Technology Officer,CTO\"`.",
+  args: {
+    company: { type: "string", description: "The company's website domain or name (positional)", required: true },
+    name: {
+      type: "string",
+      description: "The company's name as people write it on LinkedIn, when the domain doesn't say it (acme.io \u2192 'Acme Robotics')",
+      required: false
+    },
+    title: {
+      type: "string",
+      description: "Comma-separated job titles, any of them: 'Chief Technology Officer,CTO'",
+      required: false
+    },
+    seniority: {
+      type: "string",
+      description: "A LinkedIn seniority instead of titles: CXO, VP, Director, Owner, Partner, Manager, Senior",
+      required: false
+    },
+    function: {
+      type: "string",
+      description: "A LinkedIn job function: Engineering, Marketing, Finance\u2026",
+      required: false
+    },
+    limit: { type: "string", description: "Most people to return, 1-20 (default 10)", required: false },
+    "no-cache": { type: "boolean", description: "Search again instead of the week-old answer", required: false }
+  }
+});
+var FIELDS = {
+  company: "The company name searched for",
+  query: "The Google search that found them",
+  name: "Their name, as the result shows it",
+  headline: "The line under their name: usually their title and company",
+  profile_url: "Their LinkedIn profile",
+  at_company: "How likely they work at this company now (0-1)",
+  role_match: "How likely they hold the role asked for (0-1)",
+  dropped: "Profiles found that the check dropped: elsewhere now, or another role",
+  verified: "false when the check could not run: every profile found is returned unchecked"
+};
+function peopleFix(code) {
+  if (code === "FORBIDDEN") {
+    return {
+      action: "ask_admin",
+      explanation: "Outside data is switched off for this company. Don't abort: name the roles to brief sales on without names, carry on with what Baker already knows (`baker accounts people <domain>`), and tell the user an admin can switch on Outside data in Settings \u2192 General."
+    };
+  }
+  if (code === "VALIDATION_ERROR" || code === "BAD_REQUEST") {
+    return {
+      action: "retry_with_changes",
+      explanation: "Pass the company (domain or name) and a role: --title, --seniority or --function."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "The search failed. Don't loop on it \u2014 name the roles to brief sales on without names, and say who couldn't be found."
+  };
+}
+function list(raw) {
+  if (typeof raw !== "string") return void 0;
+  const items = raw.split(",").map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+var text = (raw) => typeof raw === "string" && raw.trim() !== "" ? raw.trim() : void 0;
+var peopleCommand = defineCommand({
+  meta: {
+    name: "people",
+    description: `Who likely holds a role at one company, from public LinkedIn results checked by a decision model.
+
+Use it to name who at a warming ABM account most likely saw the ads, after the client's CRM (\`baker hubspot companies contacts <domain> --roles \u2026\`) came up short. Every profile is checked: at the company now, and in the role; the rest are dropped.
+
+Leads to confirm, never contacts: brief sales with them. Nothing is stored; never save them to Knowledge.
+
+Examples:
+  baker research people acme.com --title "Chief Technology Officer,CTO"
+  baker research people acme.io --name "Acme Robotics" --seniority VP --function Engineering`
+  },
+  args: {
+    company: { type: "positional", description: "The company's website domain or name", required: false },
+    name: { type: "string", description: "The company's name as written on LinkedIn", required: false },
+    title: { type: "string", description: "Comma-separated job titles", required: false },
+    seniority: { type: "string", description: "CXO, VP, Director, Owner, Partner, Manager, Senior", required: false },
+    function: { type: "string", description: "Engineering, Marketing, Finance\u2026", required: false },
+    limit: { type: "string", description: "Most people to return, 1-20 (default 10)", required: false },
+    "no-cache": { type: "boolean", description: "Search again", required: false }
+  },
+  run: async ({ args }) => {
+    const body = {
+      company: text(args.company) ?? "",
+      name: text(args.name),
+      titles: list(args.title),
+      seniority: text(args.seniority),
+      function: text(args.function),
+      limit: text(args.limit) === void 0 ? void 0 : Number(args.limit),
+      skipCache: args["no-cache"] === true ? true : void 0
+    };
+    if (!body.company) {
+      writeResearchJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Name the company: a domain or a name",
+          fix: peopleFix("VALIDATION_ERROR")
+        }
+      });
+      process.exit(1);
+    }
+    try {
+      const data = await apiPost("/api/research/people", body);
+      writeResearchJson({
+        ok: true,
+        data: {
+          company: data.company,
+          query: data.query,
+          people: data.people.map((person) => ({
+            name: person.name,
+            headline: person.headline,
+            profile_url: person.profileUrl,
+            at_company: person.atCompany,
+            role_match: person.roleMatch
+          })),
+          dropped: data.dropped,
+          verified: data.verified
+        },
+        fields: FIELDS,
+        hints: peopleHints({ found: data.people.length, dropped: data.dropped, verified: data.verified })
+      });
+    } catch (err) {
+      handleResearchError(err, peopleFix);
+    }
+  }
+});
+export {
+  peopleCommand,
+  peopleFix
+};
+//# sourceMappingURL=people-5A6NEDEU.js.map

package/dist/people-5A6NEDEU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/people.ts"],"sourcesContent":["import type { ResearchPeopleRequest, ResearchPeopleResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { peopleHints } from \"./hints.ts\";\nimport { handleResearchError, type ResearchFix, writeResearchJson } from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.people\",\n  description:\n    \"Who likely holds a role at one company — start here to name the people behind an ABM account (the CTO, the VP of Engineering) when the client's CRM doesn't have them. Searches Google's public LinkedIn results once, then a decision model checks every profile: works at the company now (`atCompany`) and holds the role (`roleMatch`), 0-1 each; profiles failing either are dropped. Leads to confirm, never contacts: nothing is stored. Example: `baker research people acme.com --title \\\"Chief Technology Officer,CTO\\\"`.\",\n  args: {\n    company: { type: \"string\", description: \"The company's website domain or name (positional)\", required: true },\n    name: {\n      type: \"string\",\n      description:\n        \"The company's name as people write it on LinkedIn, when the domain doesn't say it (acme.io → 'Acme Robotics')\",\n      required: false,\n    },\n    title: {\n      type: \"string\",\n      description: \"Comma-separated job titles, any of them: 'Chief Technology Officer,CTO'\",\n      required: false,\n    },\n    seniority: {\n      type: \"string\",\n      description: \"A LinkedIn seniority instead of titles: CXO, VP, Director, Owner, Partner, Manager, Senior\",\n      required: false,\n    },\n    function: {\n      type: \"string\",\n      description: \"A LinkedIn job function: Engineering, Marketing, Finance…\",\n      required: false,\n    },\n    limit: { type: \"string\", description: \"Most people to return, 1-20 (default 10)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Search again instead of the week-old answer\", required: false },\n  },\n});\n\nconst FIELDS: Record<string, string> = {\n  company: \"The company name searched for\",\n  query: \"The Google search that found them\",\n  name: \"Their name, as the result shows it\",\n  headline: \"The line under their name: usually their title and company\",\n  profile_url: \"Their LinkedIn profile\",\n  at_company: \"How likely they work at this company now (0-1)\",\n  role_match: \"How likely they hold the role asked for (0-1)\",\n  dropped: \"Profiles found that the check dropped: elsewhere now, or another role\",\n  verified: \"false when the check could not run: every profile found is returned unchecked\",\n};\n\n/** What the agent does after a refused `baker research people`. Pure. */\nexport function peopleFix(code: string): ResearchFix {\n  if (code === \"FORBIDDEN\") {\n    return {\n      action: \"ask_admin\",\n      explanation:\n        \"Outside data is switched off for this company. Don't abort: name the roles to brief sales on without names, carry on with what Baker already knows (`baker accounts people <domain>`), and tell the user an admin can switch on Outside data in Settings → General.\",\n    };\n  }\n  if (code === \"VALIDATION_ERROR\" || code === \"BAD_REQUEST\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation: \"Pass the company (domain or name) and a role: --title, --seniority or --function.\",\n    };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"The search failed. Don't loop on it — name the roles to brief sales on without names, and say who couldn't be found.\",\n  };\n}\n\nfunction list(raw: unknown): string[] | undefined {\n  if (typeof raw !== \"string\") return undefined;\n  const items = raw\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n  return items.length > 0 ? items : undefined;\n}\n\nconst text = (raw: unknown) => (typeof raw === \"string\" && raw.trim() !== \"\" ? raw.trim() : undefined);\n\nexport const peopleCommand = defineCommand({\n  meta: {\n    name: \"people\",\n    description: `Who likely holds a role at one company, from public LinkedIn results checked by a decision model.\n\nUse it to name who at a warming ABM account most likely saw the ads, after the client's CRM (\\`baker hubspot companies contacts <domain> --roles …\\`) came up short. Every profile is checked: at the company now, and in the role; the rest are dropped.\n\nLeads to confirm, never contacts: brief sales with them. Nothing is stored; never save them to Knowledge.\n\nExamples:\n  baker research people acme.com --title \"Chief Technology Officer,CTO\"\n  baker research people acme.io --name \"Acme Robotics\" --seniority VP --function Engineering`,\n  },\n  args: {\n    company: { type: \"positional\", description: \"The company's website domain or name\", required: false },\n    name: { type: \"string\", description: \"The company's name as written on LinkedIn\", required: false },\n    title: { type: \"string\", description: \"Comma-separated job titles\", required: false },\n    seniority: { type: \"string\", description: \"CXO, VP, Director, Owner, Partner, Manager, Senior\", required: false },\n    function: { type: \"string\", description: \"Engineering, Marketing, Finance…\", required: false },\n    limit: { type: \"string\", description: \"Most people to return, 1-20 (default 10)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Search again\", required: false },\n  },\n  run: async ({ args }) => {\n    const body: ResearchPeopleRequest = {\n      company: text(args.company) ?? \"\",\n      name: text(args.name),\n      titles: list(args.title),\n      seniority: text(args.seniority),\n      function: text(args.function),\n      limit: text(args.limit) === undefined ? undefined : Number(args.limit),\n      skipCache: args[\"no-cache\"] === true ? true : undefined,\n    };\n    if (!body.company) {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"Name the company: a domain or a name\",\n          fix: peopleFix(\"VALIDATION_ERROR\"),\n        },\n      });\n      process.exit(1);\n    }\n\n    try {\n      const data = await apiPost<ResearchPeopleResponse>(\"/api/research/people\", body);\n      writeResearchJson({\n        ok: true,\n        data: {\n          company: data.company,\n          query: data.query,\n          people: data.people.map((person) => ({\n            name: person.name,\n            headline: person.headline,\n            profile_url: person.profileUrl,\n            at_company: person.atCompany,\n            role_match: person.roleMatch,\n          })),\n          dropped: data.dropped,\n          verified: data.verified,\n        },\n        fields: FIELDS,\n        hints: peopleHints({ found: data.people.length, dropped: data.dropped, verified: data.verified }),\n      });\n    } catch (err) {\n      handleResearchError(err, peopleFix);\n    }\n  },\n});\n"],"mappings":"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","names":[]}