@koda-sl/baker-cli 0.553.0 → 0.555.0

package/dist/company-6H2H73YP.js

@@ -0,0 +1,308 @@
+import {
+  companyHints,
+  companySearchHints,
+  unknownIndustriesFix
+} from "./chunk-UCJAPB5Y.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-CXYX6G3I.js";
+import {
+  RESEARCH_COMPANY_REVENUES,
+  RESEARCH_COMPANY_SEARCH_MAX_LIMIT,
+  RESEARCH_COMPANY_SIZES,
+  researchCompanySearchRequestSchema
+} from "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/company.ts
+import { defineCommand } from "citty";
+var COMPACT_TECHNOLOGIES = 15;
+registerSchema({
+  command: "research.company",
+  description: "What one company is \u2014 industry, size, HQ, revenue band, founded, LinkedIn, description, the technologies on its site \u2014 and whether it is hiring (open roles, top titles and functions), to fill, score and message a target-account list. With --search, the companies whose main industry, size, revenue and HQ country match. Start with --count: it sizes the market for free; pay for rows only when building the list. Filling a long list? Add --no-hiring \u2014 hiring costs ~20\xD7 the profile. Start here: `baker research company --search --industry computer-software --country es --size 50-200 --count`, then `baker research company acme.es`.",
+  args: {
+    domain: {
+      type: "string",
+      description: "The company's domain or any link on its site (positional). Not used with --search",
+      required: false
+    },
+    search: {
+      type: "boolean",
+      description: "List companies matching --industry / --size / --revenue / --country instead of reading one",
+      required: false,
+      default: false
+    },
+    count: {
+      type: "boolean",
+      description: "--search: only the number of matching companies, free. Start here to size a market",
+      required: false,
+      default: false
+    },
+    industry: {
+      type: "string",
+      description: "--search: main-industry slugs, comma-separated, any matching (computer-software,software-development). A word that is no slug is refused, free, with the closest slugs",
+      required: false
+    },
+    size: {
+      type: "string",
+      description: `--search: employee bands, comma-separated (${RESEARCH_COMPANY_SIZES.join(", ")})`,
+      required: false
+    },
+    revenue: {
+      type: "string",
+      description: `--search: revenue bands in USD, comma-separated (${RESEARCH_COMPANY_REVENUES.join(", ")})`,
+      required: false
+    },
+    country: {
+      type: "string",
+      description: "--search: HQ country codes, comma-separated (es, pt, fr)",
+      required: false
+    },
+    limit: {
+      type: "number",
+      description: `--search: companies per page, 1-${RESEARCH_COMPANY_SEARCH_MAX_LIMIT} (default 25). Each returned is billed`,
+      required: false
+    },
+    page: { type: "number", description: "--search: page to read (default 1)", required: false },
+    hiring: {
+      type: "boolean",
+      description: "Read hiring too (default). --no-hiring skips it \u2014 hiring costs ~20\xD7 the profile, so leave it out when filling a long list",
+      required: false,
+      default: true
+    },
+    full: {
+      type: "boolean",
+      description: "Every industry and technology, plus both providers' whole answers as `raw`",
+      required: false,
+      default: false
+    }
+  }
+});
+var FIELDS = {
+  name: "The company's name as the provider spells it; prefer the name on its LinkedIn page or site when they differ",
+  industry: "Main industry, as a slug",
+  employees: "Employee band (50-200); employees_exact when a headcount is known",
+  hq_country: "Headquarters country (hq_country_code is its two-letter code)",
+  hq_city: "Headquarters city",
+  revenue: "Revenue band (10m-50m)",
+  founded: "Year founded",
+  linkedin_url: "Its LinkedIn company page",
+  description: "What it says it does",
+  technologies: `Technologies seen on its site (first ${COMPACT_TECHNOLOGIES}; --full for all, technologies_total counts them)`,
+  hiring: "status ok: open_jobs live now, new_last_30_days, top_titles, top_functions. not_tracked: unknown. skipped: --no-hiring. unavailable: not read",
+  raw: "Both providers' whole answers (--full only)"
+};
+var SEARCH_FIELDS = {
+  total: "Every company matching, not just this page \u2014 the size of the market",
+  page: "This page; last_page is the last one",
+  companies: "name (provider's spelling), domain, industry (main), employees (band), revenue (band), country (HQ code)"
+};
+var COUNT_FIELDS = {
+  total: "Every company matching \u2014 the size of the market. Nothing was charged"
+};
+function companyFix(code) {
+  if (code === "VALIDATION_ERROR" || code === "BAD_REQUEST") {
+    return {
+      action: "retry_with_changes",
+      explanation: `The message names the value that was refused \u2014 fix that one and retry. A --search needs at least one of --industry (an industry slug), --size (one of ${RESEARCH_COMPANY_SIZES.join(", ")}), --revenue (one of ${RESEARCH_COMPANY_REVENUES.join(", ")}) or --country (two-letter ISO codes). A lookup needs the company's own domain (acme.es) or a link on its site.`
+    };
+  }
+  if (code === "CONFLICT") {
+    return {
+      action: "continue_without",
+      explanation: "Company data isn't switched on for this workspace yet. Don't retry \u2014 take size, industry and location from the company's LinkedIn page or its own site (`baker research fetch`), and tell the user company data is coming."
+    };
+  }
+  if (code === "NOT_FOUND") {
+    return {
+      action: "continue_without",
+      explanation: "There's no data for this domain. Check it is the company's main website once; otherwise read its site or LinkedIn page and say this account couldn't be enriched."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "Company data couldn't be read. Don't loop on it \u2014 finish the list from what you have and name the accounts left unenriched."
+  };
+}
+function listOf(value) {
+  return typeof value === "string" ? value.split(",").map((item) => item.trim()).filter((item) => item !== "") : [];
+}
+function failValidation(message) {
+  writeResearchJson({ ok: false, error: { code: "VALIDATION_ERROR", message, fix: companyFix("VALIDATION_ERROR") } });
+  process.exit(1);
+}
+async function runSearch(args) {
+  const parsed = researchCompanySearchRequestSchema.safeParse({
+    industries: listOf(args.industry),
+    sizes: listOf(args.size),
+    revenues: listOf(args.revenue),
+    countries: listOf(args.country),
+    count: Boolean(args.count),
+    ...args.limit !== void 0 ? { limit: Number(args.limit) } : {},
+    ...args.page !== void 0 ? { page: Number(args.page) } : {}
+  });
+  if (!parsed.success) failValidation(parsed.error.issues.map((issue) => issue.message).join("; "));
+  const result = await apiPost("/api/research/company/search", parsed.data);
+  if (result.status === "unknown_industries") {
+    const names = result.industries.map(({ input }) => `"${input}"`).join(", ");
+    writeResearchJson({
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: `No industry is called ${names}.`,
+        fix: unknownIndustriesFix(result.industries)
+      }
+    });
+    process.exit(1);
+  }
+  if (result.status === "counted") {
+    writeResearchJson({
+      ok: true,
+      data: { total: result.total },
+      fields: COUNT_FIELDS,
+      hints: companySearchHints({
+        total: result.total,
+        returned: 0,
+        page: 1,
+        lastPage: 1,
+        related: result.relatedIndustries
+      })
+    });
+    return;
+  }
+  writeResearchJson({
+    ok: true,
+    data: { total: result.total, page: result.page, last_page: result.lastPage, companies: result.companies },
+    fields: SEARCH_FIELDS,
+    hints: companySearchHints({
+      total: result.total,
+      returned: result.companies.length,
+      page: result.page,
+      lastPage: result.lastPage,
+      related: result.relatedIndustries
+    })
+  });
+}
+async function runLookup(domain, full, hiringToo) {
+  const body = { domain, full, hiring: hiringToo };
+  const { firmographics: firm, hiring, raw } = await apiPost("/api/research/company", body);
+  const technologies = firm?.technologies ?? [];
+  writeResearchJson({
+    ok: true,
+    data: {
+      domain: firm?.domain ?? domain,
+      ...firm ? {
+        name: firm.name,
+        industry: firm.industry,
+        ...full ? { industries: firm.industries } : {},
+        employees: firm.employees,
+        employees_exact: firm.employeesExact,
+        hq_country: firm.hqCountry,
+        hq_country_code: firm.hqCountryCode,
+        hq_city: firm.hqCity,
+        revenue: firm.revenue,
+        founded: firm.founded,
+        linkedin_url: firm.linkedinUrl,
+        description: firm.description,
+        technologies: full ? technologies : technologies.slice(0, COMPACT_TECHNOLOGIES),
+        technologies_total: technologies.length
+      } : { profile: null },
+      hiring: hiring.status === "ok" ? {
+        status: "ok",
+        open_jobs: hiring.openJobs,
+        new_last_30_days: hiring.newLast30Days,
+        top_titles: hiring.topTitles,
+        top_functions: hiring.topFunctions
+      } : hiring,
+      ...raw ? { raw } : {}
+    },
+    fields: FIELDS,
+    hints: companyHints({ domain: firm?.domain ?? domain, profile: firm, hiring })
+  });
+}
+var companyCommand = defineCommand({
+  meta: {
+    name: "company",
+    description: `What one company is and whether it is hiring \u2014 or, with --search, the companies matching an industry, size and country.
+
+Returns industry, employee band, HQ, revenue band, founded, LinkedIn page, description, the technologies on its site, and hiring signals (open roles, new in the last 30 days, top titles and functions). Use it to fill and score a target-account list and to pick displacement or integration messaging.
+
+--search lists companies whose main industry, size, revenue and HQ country match (name, domain, industry, size, revenue, country) and the total. Start with --count: it returns the total alone and is free, so size the market first and pay for rows (each one returned is billed) only when building the list. An --industry that is no slug is refused for free with the closest slugs; several slugs widen the search.
+
+Filling a long list? Add --no-hiring \u2014 hiring costs ~20\xD7 the profile. The name is the provider's spelling; prefer the one on the company's LinkedIn page or site.
+
+Examples:
+  baker research company --search --industry computer-software,software-development --country es --size 50-200 --count
+  baker research company --search --industry computer-software,software-development --country es --size 50-200 --revenue 1m-10m,10m-50m --limit 25
+  baker research company acme.es
+  baker research company acme.es --no-hiring
+  baker research company https://www.acme.es/about --full`
+  },
+  args: {
+    domain: { type: "positional", description: "The company's domain or a link on its site", required: false },
+    search: {
+      type: "boolean",
+      description: "List companies by --industry / --size / --revenue / --country",
+      required: false
+    },
+    count: { type: "boolean", description: "With --search: the number of matches alone, free", required: false },
+    industry: { type: "string", description: "Main-industry slugs, comma-separated, any matching", required: false },
+    size: {
+      type: "string",
+      description: `Employee bands, comma-separated (${RESEARCH_COMPANY_SIZES.join(", ")})`,
+      required: false
+    },
+    revenue: {
+      type: "string",
+      description: `Revenue bands, comma-separated (${RESEARCH_COMPANY_REVENUES.join(", ")})`,
+      required: false
+    },
+    country: { type: "string", description: "HQ country codes, comma-separated", required: false },
+    limit: {
+      type: "string",
+      description: `Companies per page, 1-${RESEARCH_COMPANY_SEARCH_MAX_LIMIT} (default 25)`,
+      required: false
+    },
+    page: { type: "string", description: "Page to read (default 1)", required: false },
+    hiring: {
+      type: "boolean",
+      description: "Read hiring too; --no-hiring skips it (~20\xD7 the profile's cost)",
+      required: false,
+      default: true
+    },
+    full: { type: "boolean", description: "Everything, plus the providers' whole answers", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      if (args.search) {
+        await runSearch(args);
+        return;
+      }
+      const domain = args.domain;
+      if (!domain) failValidation("A company domain is required, or --search with filters");
+      await runLookup(domain, Boolean(args.full), args.hiring !== false);
+    } catch (err) {
+      handleResearchError(err, companyFix);
+    }
+  }
+});
+export {
+  companyCommand
+};
+//# sourceMappingURL=company-6H2H73YP.js.map

package/dist/complete-2QBC3POO.js

@@ -0,0 +1,84 @@
+import {
+  failApi,
+  failValidation,
+  isTempId,
+  writeOk
+} from "./chunk-BS2MC62Y.js";
+import {
+  ACTION_COMPLETE_NOTE_MIN
+} from "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/complete.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.complete",
+  description: "Stage completion of an action (it was done). Accepts a real action ID (must be claimed) or a temp ID from the same draft. The action becomes completed when the chat is published. --note is required and must describe what you actually did to resolve it (what changed, where, and the outcome) \u2014 it is the client-facing record surfaced by `baker actions log`. Don't use this to drop an action you no longer want \u2014 to remove a staged op use `actions draft remove`, to close an unwanted published action use `actions discard`.",
+  args: {
+    id: { type: "string", description: "Action ID or temp ID", required: true },
+    note: {
+      type: "string",
+      description: "REQUIRED. Detailed description of what you did to resolve this: what changed, where, and the outcome. This is the durable, client-facing record shown by `baker actions log`.",
+      required: true
+    }
+  }
+});
+var completeCommand = defineCommand({
+  meta: {
+    name: "complete",
+    description: 'Stage completion of an action. Accepts real IDs (claimed) or temp IDs (same draft). Example: baker actions complete <id> --note "Rewrote the pricing hero on /pricing; the CTA now names the trial"'
+  },
+  args: {
+    id: { type: "positional", description: "Action ID or temp ID", required: false },
+    "action-id": { type: "string", description: "Action ID or temp ID", required: false },
+    note: {
+      type: "string",
+      description: "REQUIRED. What you did to resolve this: what changed, where, and the outcome.",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      if (!isTempId(id)) {
+        validateConvexId(id);
+      }
+      const note = args.note?.trim() ?? "";
+      if (note.length < ACTION_COMPLETE_NOTE_MIN) {
+        failValidation(
+          `--note is required and must describe what you did (\u2265${ACTION_COMPLETE_NOTE_MIN} chars): what changed, where, and the outcome. This becomes the client-facing record surfaced by \`baker actions log\`.`
+        );
+      }
+      const chatId = requireChatId();
+      await apiPost("/api/actions/complete", { chatId, actionRef: id, note });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  completeCommand
+};
+//# sourceMappingURL=complete-2QBC3POO.js.map

package/dist/connect-35YPFAUL.js

@@ -0,0 +1,45 @@
+import {
+  attachDestination,
+  attachSettings,
+  attachStep,
+  connectCommand,
+  copyDestination,
+  destinationRefusal,
+  restatableTargets,
+  sealRequestFor,
+  targetsFor,
+  unpickedSteps,
+  unwiredHubspotForms,
+  unwiredSideEffects
+} from "./chunk-IMFIRELA.js";
+import "./chunk-GVUBRSD3.js";
+import "./chunk-LETR3RQE.js";
+import "./chunk-BS2MC62Y.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  attachDestination,
+  attachSettings,
+  attachStep,
+  connectCommand,
+  copyDestination,
+  destinationRefusal,
+  restatableTargets,
+  sealRequestFor,
+  targetsFor,
+  unpickedSteps,
+  unwiredHubspotForms,
+  unwiredSideEffects
+};
+//# sourceMappingURL=connect-35YPFAUL.js.map

package/dist/conversation-YZFNEWDV.js

@@ -0,0 +1,96 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-OTFHIGEO.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-QYH2UZAK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/conversation.ts
+import { defineCommand } from "citty";
+var conversationCommand = defineCommand({
+  meta: {
+    name: "conversation",
+    description: `Per-button click rates inside Sponsored Messaging / Conversation Ads.
+
+Returns one row per CONVERSATION_NODE_BUTTON pivot, sorted by clicks desc.
+Use this to A/B test button copy and the cascade tree.
+
+Examples:
+  baker ads linkedin conversation --campaign-id 1234
+  baker ads linkedin conversation --campaign-id 1234 --last-days 30 --output csv`
+  },
+  args: {
+    "campaign-id": {
+      type: "string",
+      description: "Comma-separated campaign IDs (Conversation Ad campaigns)",
+      required: true
+    },
+    start: { type: "string", description: "Start date YYYY-MM-DD" },
+    end: { type: "string", description: "End date YYYY-MM-DD" },
+    "last-days": { type: "string", description: "Window relative to today (default: 30)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const campaignIdsRaw = args["campaign-id"];
+    if (!campaignIdsRaw) {
+      handleLinkedinError(new Error("--campaign-id is required"));
+    }
+    const ids = campaignIdsRaw.split(",").map((s) => s.trim()).filter(Boolean);
+    const start = args.start ?? daysAgoIso(args["last-days"] ? Number(args["last-days"]) : 30);
+    const end = args.end ?? todayIso();
+    try {
+      const data = await apiPost("/api/ads/linkedin/analytics", {
+        request: {
+          level: "campaign",
+          ids,
+          intent: "inmail",
+          pivot: "conversation-node-button",
+          start,
+          end,
+          granularity: "ALL",
+          limit: 500
+        },
+        skipCache: Boolean(args["no-cache"])
+      });
+      const sorted = [...data.rows].sort((a, b) => Number(b.clicks ?? 0) - Number(a.clicks ?? 0));
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(sorted, fmt, data.fields);
+        return;
+      }
+      writeAdsJson({
+        ok: true,
+        data: { query: { campaigns: ids, start, end }, rows: sorted, warnings: data.warnings }
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  conversationCommand
+};
+//# sourceMappingURL=conversation-YZFNEWDV.js.map