@koda-sl/baker-cli 0.432.0 → 0.433.0

package/README.md

@@ -1121,6 +1121,7 @@ baker ads linkedin top-companies --campaign-id 1234 --last-days 30
 # most engaged first ({org, name, impressions, clicks, engagements, costLocal}).
 # Defaults: last 12 calendar months, the only selected ad account, top 100 (--full for all).
 baker ads linkedin companies --account-id 1234
+baker ads linkedin companies --page 2                              # companies 101-200, most engaged first
 baker ads linkedin companies --by month --min-impressions 50       # months[] per company
 baker ads linkedin companies --campaign-id 1,2 --by campaign       # campaigns[] per company
 baker ads linkedin companies --with-domains --stats --output csv   # + domain/domainSource; read-quality stats
@@ -4018,13 +4019,14 @@ No write surface against HubSpot itself — a form's fields, redirect, or consen
 
 ### `baker accounts influenced | engagement | warm | company | campaigns | crm`
 
-Account insights: which companies the LinkedIn ads are warming, and which CRM deals they influenced. Reads Baker's nightly copy of LinkedIn and the CRM, so it is fast and covers up to 24 months; nothing is changed anywhere. Only for companies with Account insights switched on — otherwise every command exits 1 with `ACCOUNTS_NOT_ENABLED` and an `error.fix` pointing at the live read (`baker ads linkedin companies`, plus `baker hubspot companies search`). `--start`/`--end` must be real calendar days within 24 calendar months; a bad flag or an unsupported `--output` exits 1 with `INVALID_ARGS`.
+Account insights: which companies the LinkedIn ads are warming, and which CRM deals they influenced. Reads Baker's nightly copy of LinkedIn and the CRM, so it is fast and covers up to 24 months; nothing is changed anywhere. Every company has it once a LinkedIn ad account is chosen; before the first nightly read the reports are empty — read live with `baker ads linkedin companies`. `--start`/`--end` must be real calendar days within 24 calendar months; a bad flag or an unsupported `--output` exits 1 with `INVALID_ARGS`.
 
 ```bash
 baker accounts influenced                              # influenced pipeline, last 12 calendar months
 baker accounts influenced --basis revenue --start 2026-01-01 --end 2026-06-30
 baker accounts influenced --full                       # every deal in the period, influenced or not
 baker accounts engagement --last-months 3 --limit 50   # companies reached, New/Rising, CRM match and deals
+baker accounts engagement --last-months 3 --limit 50 --page 2   # the next 50 (pageInfo.total counts them all)
 baker accounts engagement --campaign-id 123456 --output csv
 baker accounts warm --output csv > warm.csv            # companyName,domain,organizationUrn
 baker accounts company acme.com                        # or a LinkedIn company id / urn:li:organization:N

package/dist/cli.js

@@ -22414,7 +22414,12 @@ var crmSheetLinkSchema = z2.object({
 var accountsCrmStatusResponseSchema = z2.object({
   ok: z2.literal(true),
   data: z2.object({
-    enabled: z2.boolean(),
+    /**
+     * Always true, for CLIs from when Account insights was a per-company
+     * switch: they read its absence as "switched off". Drop it once no
+     * Runtime runs one of them.
+     */
+    enabled: z2.literal(true).optional(),
     /** `hubspot` (Baker reads it), `api` (the client sends it), or null before anyone chose. */
     source: z2.enum(["hubspot", "api"]).nullable(),
     /** Where a client's system sends. */
@@ -22702,7 +22707,10 @@ var accountsEngagementRequestSchema = z3.object({
   ...windowFields,
   /** One campaign's companies; every campaign together when absent. */
   campaignId: z3.string().regex(/^\d+$/, "use the numeric campaign id").optional(),
-  limit: z3.number().int().min(1).max(ACCOUNTS_ENGAGEMENT_MAX_LIMIT).default(ACCOUNTS_ENGAGEMENT_DEFAULT_LIMIT)
+  /** Companies per page. */
+  limit: z3.number().int().min(1).max(ACCOUNTS_ENGAGEMENT_MAX_LIMIT).default(ACCOUNTS_ENGAGEMENT_DEFAULT_LIMIT),
+  /** Which page, 1-based, most engaged first. */
+  page: z3.number().int().min(1).default(1)
 }).superRefine(windowRules);
 var accountsEngagementResponseSchema = z3.object({
   ok: z3.literal(true),
@@ -22710,8 +22718,10 @@ var accountsEngagementResponseSchema = z3.object({
     window: accountsWindowSchema,
     previousWindow: accountsWindowSchema,
     companies: z3.array(accountEngagementRowSchema),
-    /** True when more companies were reached than `limit`. */
+    /** True when more companies were reached than this page and the ones before it hold. */
     truncated: z3.boolean(),
+    /** Which page this is, and how many companies there are in all. Absent from older servers. */
+    pageInfo: z3.object({ page: z3.number(), pageSize: z3.number(), total: z3.number(), hasMore: z3.boolean() }).optional(),
     /** The company's influence rule (the default one before setup): the minimum `baker accounts warm` applies. */
     rule: influenceParamsSchema.optional()
   })
@@ -22860,7 +22870,6 @@ var accountsCampaignsResponseSchema = z3.object({
     campaigns: z3.array(accountCampaignRowSchema)
   })
 });
-var ACCOUNTS_NOT_ENABLED_MESSAGE = "Account insights are not switched on for this company yet. The Baker team turns them on on request.";
 var ACCOUNTS_NO_SETTINGS_MESSAGE = "Account insights are not set up yet: in Measure \u2192 Accounts, say where your deals are (HubSpot or another CRM) and what won and lost mean.";
 
 // src/commands/accounts/index.ts
@@ -23718,6 +23727,8 @@ var linkedinCompaniesRequestSchema = z6.object({
   withDomains: z6.boolean().default(false),
   minImpressions: z6.number().int().min(0).default(0),
   full: z6.boolean().default(false),
+  /** Which page of 100 companies, most engaged first; ignored with `full`. */
+  page: z6.number().int().min(1).default(1),
   stats: z6.boolean().default(false),
   skipCache: z6.boolean().optional()
 }).superRefine((req, ctx) => {
@@ -23772,8 +23783,10 @@ var linkedinCompaniesStatsSchema = z6.object({
 var linkedinCompaniesWarningSchema = z6.object({ code: z6.string(), message: z6.string() });
 var linkedinCompaniesResponseSchema = z6.object({
   rows: z6.array(linkedinCompanyRowSchema),
-  /** Companies above minImpressions before the compact cap. */
+  /** Companies above minImpressions, every page together. */
   totalCompanies: z6.number(),
+  /** Which page of 100 `rows` is (1 with `full`). Absent from older servers. */
+  page: z6.number().optional(),
   stats: linkedinCompaniesStatsSchema.optional(),
   warnings: z6.array(linkedinCompaniesWarningSchema),
   query: z6.object({
@@ -32953,7 +32966,6 @@ function refusedHints(lastLive) {
   ];
 }
 function statusHints(data) {
-  if (!data.enabled) return ["Account insights is not switched on for this company; the Baker team switches it on."];
   if (data.source === null) {
     return [
       "Nobody has said where the deals are yet. The user chooses in Measure \u2192 Accounts: HubSpot, or Another CRM (they send the deals)."
@@ -33039,15 +33051,6 @@ var crmCommand = defineCommand({
 
 // src/commands/accounts/report.ts
 function accountsRefusal(code, message) {
-  if (code === "CONFLICT" && message.includes(ACCOUNTS_NOT_ENABLED_MESSAGE)) {
-    return {
-      code: "ACCOUNTS_NOT_ENABLED",
-      fix: {
-        action: "continue_without",
-        explanation: "Account insights is not switched on for this company, so none of `baker accounts` can answer \u2014 do not retry it. Read the same thing live instead: `baker ads linkedin companies --with-domains` lists the companies the LinkedIn ads reached (--by month shows who is warming up); if HubSpot is connected, `baker hubspot companies search --domains <domain,\u2026> --with-deals` shows which are already customers or open deals. Say the numbers come from that live read, not from Account insights, and finish the rest of the task."
-      }
-    };
-  }
   if (code === "CONFLICT" && message.includes(ACCOUNTS_NO_SETTINGS_MESSAGE)) {
     return {
       code: "ACCOUNTS_NOT_SET_UP",
@@ -33111,6 +33114,14 @@ function engagementHints(data, request) {
       `No company the LinkedIn ads reached shows up for ${data.window.start} to ${data.window.end}. The nightly sync may not have run since the campaigns started delivering, or LinkedIn left the companies out (fewer than 3 events in a month). Try a longer period (--last-months 12), or read the ad account live with \`baker ads linkedin companies\`.`
     ];
   }
+  const page = data.pageInfo;
+  if (page?.hasMore) {
+    const first = (page.page - 1) * page.pageSize + 1;
+    const last = first + data.companies.length - 1;
+    return [
+      `Companies ${first}-${last} of ${page.total.toLocaleString("en")} shown. Read the next ones with --page ${page.page + 1} --limit ${page.pageSize}.`
+    ];
+  }
   return data.truncated ? [`More companies were reached than --limit ${request.limit}; raise it to see the tail.`] : [];
 }
 var ENGAGEMENT_TABLE_FIELDS = [
@@ -33392,21 +33403,27 @@ var ENGAGEMENT_ARGS = {
   "campaign-id": { type: "string", description: "Only this campaign's companies (numeric id)", required: false },
   limit: {
     type: "string",
-    description: `Most companies, 1-${ACCOUNTS_ENGAGEMENT_MAX_LIMIT} (default 500)`,
+    description: `Companies per page, 1-${ACCOUNTS_ENGAGEMENT_MAX_LIMIT} (default 500)`,
+    required: false
+  },
+  page: {
+    type: "string",
+    description: "Which page to read, 1-based, most engaged first (default 1). pageInfo.hasMore says another page follows; pageInfo.total counts every company reached",
     required: false
   },
   output: OUTPUT_ARG
 };
 registerSchema({
   command: "accounts.engagement",
-  description: "Every company the LinkedIn ads reached, most engaged first, with the period before for comparison, New/Rising flags, and where it stands in the CRM (matched company; dealStatus won > open > lost > none, lost meaning every deal it had was lost; lastLostAt). Default the last 3 calendar months. From the nightly sync, so it is fast and covers up to 24 months; for a live read of one ad account use `baker ads linkedin companies`.",
+  description: "Every company the LinkedIn ads reached, most engaged first, with the period before for comparison, New/Rising flags, and where it stands in the CRM (matched company; dealStatus won > open > lost > none, lost meaning every deal it had was lost; lastLostAt). Default the last 3 calendar months. From the nightly sync, so it is fast and covers up to 24 months; for a live read of one ad account use `baker ads linkedin companies`. Paged: --limit companies per page, --page N; pageInfo {page, pageSize, total, hasMore}.",
   args: ENGAGEMENT_ARGS
 });
 function engagementInput(args8, limit) {
   return {
     ...windowInput(args8),
     campaignId: optionalString(args8["campaign-id"])?.replace(/^urn:li:sponsoredCampaign:/, ""),
-    limit: limit ?? optionalNumber(args8.limit)
+    limit: limit ?? optionalNumber(args8.limit),
+    page: limit === void 0 ? optionalNumber(args8.page) : void 0
   };
 }
 var engagementCommand = defineCommand2({
@@ -33430,7 +33447,7 @@ var engagementCommand = defineCommand2({
       writeJson({
         ...response,
         data: { ...response.data, companies },
-        meta: { count: companies.length },
+        meta: { count: companies.length, ...response.data.pageInfo ? { total: response.data.pageInfo.total } : {} },
         ...hints2.length > 0 ? { hints: hints2 } : {}
       });
     } catch (err) {
@@ -51098,7 +51115,7 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.companies",
-  description: "Which companies the LinkedIn ads reached \u2014 one row per company over the whole period ({org, name, impressions, clicks, engagements, costLocal}), most engaged first. Start here for warm accounts / ABM reporting. Defaults: last 12 calendar months, the only selected ad account, top 100 (--full for all). --by month|campaign adds a months[] or campaigns[] breakdown; --with-domains adds domain + domainSource for CRM matching; --stats adds row counts and cost/reach/domain coverage (no names). LinkedIn drops companies under 3 events a month.",
+  description: "Which companies the LinkedIn ads reached \u2014 one row per company over the whole period ({org, name, impressions, clicks, engagements, costLocal}), most engaged first. Start here for warm accounts / ABM reporting. Defaults: last 12 calendar months, the only selected ad account, 100 companies a page (--page N for the next, --full for all; totalCompanies counts them all). --by month|campaign adds a months[] or campaigns[] breakdown; --with-domains adds domain + domainSource for CRM matching; --stats adds row counts and cost/reach/domain coverage (no names). LinkedIn drops companies under 3 events a month.",
   args: {
     "account-id": {
       type: "string",
@@ -51117,6 +51134,11 @@ registerSchema({
     "with-domains": { type: "boolean", description: "Add website domain + domainSource per company", required: false },
     "min-impressions": { type: "string", description: "Leave out companies under N impressions", required: false },
     full: { type: "boolean", description: "Every company, plus videoViews", required: false },
+    page: {
+      type: "string",
+      description: "Which page of 100 companies, most engaged first (default 1)",
+      required: false
+    },
     stats: { type: "boolean", description: "Add read-quality stats (counts and rates only)", required: false },
     "no-cache": NO_CACHE_ARG,
     output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
@@ -53618,6 +53640,7 @@ Examples:
 
 // src/commands/ads/linkedin/companies.ts
 import { defineCommand as defineCommand68 } from "citty";
+var COMPANIES_PAGE_SIZE = 100;
 var COMPANIES_TIMEOUT_MS = 18e4;
 var CSV_FIELDS = [
   "org",
@@ -53651,8 +53674,12 @@ function companiesHints(data, request) {
     );
   }
   if (data.totalCompanies > data.rows.length) {
+    const page = data.page ?? 1;
+    const first = (page - 1) * COMPANIES_PAGE_SIZE + 1;
+    const last = first + data.rows.length - 1;
+    const next = last < data.totalCompanies ? ` \u2014 --page ${page + 1} for the next ${COMPANIES_PAGE_SIZE}, ` : " \u2014 ";
     hints2.push(
-      `Showing the ${data.rows.length} most engaged of ${data.totalCompanies} companies \u2014 pass --full for all, or --min-impressions to trim the tail.`
+      `Showing companies ${first}-${last} of ${data.totalCompanies.toLocaleString("en")}, most engaged first${next}--full for all, or --min-impressions to trim the tail.`
     );
   }
   if (data.query.by === "none" && data.rows.length > 0) {
@@ -53672,7 +53699,8 @@ var FLAG_OF_FIELD2 = {
   start: "--start",
   end: "--end",
   by: "--by",
-  minImpressions: "--min-impressions"
+  minImpressions: "--min-impressions",
+  page: "--page"
 };
 function flagOf(field) {
   return FLAG_OF_FIELD2[field.split(".")[0] ?? ""] ?? (field || "args");
@@ -53690,10 +53718,11 @@ var companiesCommand = defineCommand68({
 
 Start here for "which companies are our ads warming", ABM reporting, or building a warm-account list.
 Rows: {org, name, impressions, clicks, engagements, costLocal}. Defaults: the last 12 calendar
-months, the only selected ad account, top 100 companies (--full for all).
+months, the only selected ad account, 100 companies a page (--page 2 for the next, --full for all).
 
 Examples:
   baker ads linkedin companies                                          # last 12 months, whole account
+  baker ads linkedin companies --page 2                                 # the next 100 companies
   baker ads linkedin companies --by month --min-impressions 50          # when each company warmed up
   baker ads linkedin companies --campaign-id 333728193,810055513 --by campaign
   baker ads linkedin companies --with-domains --output csv              # + website domain, for CRM matching
@@ -53714,7 +53743,11 @@ so small companies are undercounted. engagements = LinkedIn's totalEngagements.`
     by: { type: "string", description: "none | month | campaign \u2014 break each company down (default none)" },
     "with-domains": { type: "boolean", description: "Add each company's website domain and domainSource" },
     "min-impressions": { type: "string", description: "Leave out companies under N impressions over the period" },
-    full: { type: "boolean", description: "Every company (not just the top 100), plus videoViews" },
+    full: { type: "boolean", description: "Every company (not just a page of 100), plus videoViews" },
+    page: {
+      type: "string",
+      description: "Which page of 100 companies, most engaged first (default 1); totalCompanies counts them all"
+    },
     stats: { type: "boolean", description: "Add read-quality stats: row counts, cost/reach/domain coverage" },
     "no-cache": NO_CACHE_ARG,
     output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
@@ -53730,6 +53763,7 @@ so small companies are undercounted. engagements = LinkedIn's totalEngagements.`
       withDomains: Boolean(args8["with-domains"]),
       minImpressions: optionalNumber2(args8["min-impressions"]),
       full: Boolean(args8.full),
+      page: optionalNumber2(args8.page),
       stats: Boolean(args8.stats),
       skipCache: Boolean(args8["no-cache"])
     };