@koda-sl/baker-cli 0.573.0 → 0.574.0

package/dist/chunk-SQZKWZ6F.js

@@ -0,0 +1,103 @@
+import {
+  SITE_COLLECTION_MODES,
+  SITE_CONSENT_MODES,
+  SITE_HOME_MODES
+} from "./chunk-AJ4OO3CV.js";
+import {
+  ApiError
+} from "./chunk-JCFZ7ECN.js";
+import {
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+
+// src/commands/site/setArgs.ts
+var SiteArgsError = class extends Error {
+};
+function oneOf(flag, value, allowed) {
+  if (!allowed.includes(value)) {
+    throw new SiteArgsError(`--${flag} must be one of: ${allowed.join(", ")}`);
+  }
+  return value;
+}
+function onOff(flag, value) {
+  if (value === "on" || value === "true") return true;
+  if (value === "off" || value === "false") return false;
+  throw new SiteArgsError(`--${flag} must be on or off`);
+}
+function parseProfile(raw, readFile) {
+  const text = raw.startsWith("@") ? readFile(raw.slice(1)) : raw;
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    throw new SiteArgsError("--export-profile must be JSON, or @path to a JSON file");
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new SiteArgsError("--export-profile must be a JSON object");
+  }
+  return parsed;
+}
+function parseSetArgs(args, readFile) {
+  const inputs = [];
+  if (args.consent !== void 0) {
+    inputs.push({ setting: "consent", mode: oneOf("consent", args.consent, SITE_CONSENT_MODES) });
+  }
+  if (args.collection !== void 0) {
+    const mode = oneOf("collection", args.collection, SITE_COLLECTION_MODES);
+    inputs.push({
+      setting: "analyticsCollection",
+      mode,
+      ...args.payloads === void 0 ? {} : { payloads: onOff("payloads", args.payloads) }
+    });
+  } else if (args.payloads !== void 0) {
+    throw new SiteArgsError("--payloads goes with --collection, e.g. --collection full --payloads off");
+  }
+  if (args.indexing !== void 0) {
+    inputs.push({ setting: "indexing", enabled: onOff("indexing", args.indexing) });
+  }
+  if (args.home !== void 0) {
+    const slug = args.home.trim().replace(/^\/+|\/+$/g, "");
+    inputs.push(
+      slug === "none" || slug === "" ? { setting: "homePage", override: null } : {
+        setting: "homePage",
+        override: { mode: oneOf("home-mode", args["home-mode"] ?? "rewrite", SITE_HOME_MODES), slug }
+      }
+    );
+  } else if (args["home-mode"] !== void 0) {
+    throw new SiteArgsError("--home-mode goes with --home <landing slug>");
+  }
+  if (args.timezone !== void 0) {
+    inputs.push({ setting: "timezone", timezone: args.timezone });
+  }
+  if (args["export-profile"] !== void 0) {
+    inputs.push({ setting: "exportProfile", profile: parseProfile(args["export-profile"], readFile) });
+  }
+  if (inputs.length === 0) {
+    throw new SiteArgsError(
+      "Nothing to stage. Pass at least one of --consent, --collection, --indexing, --home, --timezone, --export-profile."
+    );
+  }
+  return inputs;
+}
+
+// src/commands/site/shared.ts
+function failSite(err) {
+  if (err instanceof SiteArgsError) {
+    writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: err.message } });
+  } else if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+  } else {
+    writeJson({
+      ok: false,
+      error: { code: "INTERNAL_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+    });
+  }
+  process.exit(1);
+}
+
+export {
+  SiteArgsError,
+  parseSetArgs,
+  failSite
+};
+//# sourceMappingURL=chunk-SQZKWZ6F.js.map

package/dist/chunk-SSFQNMPS.js

@@ -0,0 +1,259 @@
+import {
+  targetsHints
+} from "./chunk-UYOUNHUQ.js";
+import {
+  readTargetsFile,
+  targetsOfTier
+} from "./chunk-VASOAJDL.js";
+import {
+  csvOrJson,
+  handleLinkedinError,
+  optionalAccountIdArg
+} from "./chunk-SLTZC32B.js";
+import {
+  TABLE_OUTPUT_FORMATS,
+  outputFormatRefusal,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-VJUVTMHY.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-HPF3USL2.js";
+import {
+  linkedinCompaniesRequestSchema
+} from "./chunk-AJ4OO3CV.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+
+// src/commands/ads/linkedin/companies.ts
+import { readdirSync, readFileSync } from "fs";
+import { defineCommand } from "citty";
+var COMPANIES_PAGE_SIZE = 100;
+var COMPANIES_TIMEOUT_MS = 18e4;
+var CSV_FIELDS = [
+  "org",
+  "name",
+  "domain",
+  "domainSource",
+  "impressions",
+  "clicks",
+  "engagements",
+  "costLocal",
+  "videoViews",
+  "industry",
+  "staffCount",
+  "target",
+  "months",
+  "campaigns"
+];
+function companiesHints(data, request) {
+  const hints = [];
+  if (data.rows.length === 0) {
+    hints.push(
+      `No company shows up for ${data.query.start} to ${data.query.end}${data.query.minImpressions > 0 ? ` at --min-impressions ${data.query.minImpressions}` : ""}. LinkedIn reports companies 12-24h late and leaves out any with fewer than 3 events in a month, so a small or new campaign can have none yet. Try a longer period (--last-months 24), drop --min-impressions, or check the campaigns delivered with \`baker ads linkedin analytics\`.`
+    );
+    return hints;
+  }
+  const withDomain = data.rows.filter((row) => row.domain !== void 0).length;
+  if (withDomain > 0) {
+    hints.push(
+      `${withDomain} companies came back with a website domain \u2014 if HubSpot is connected, \`baker hubspot companies search --domains <domain,domain,\u2026> --with-deals\` (up to 100 per call) shows which are already accounts and which have deals.`
+    );
+  } else if (!request.withDomains && data.rows.length > 0) {
+    hints.push(
+      "Add --with-domains to get each company's website domain, ready for matching against your customer list."
+    );
+  }
+  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 ";
+    hints.push(
+      `Showing companies ${first}-${last} of ${data.totalCompanies.toLocaleString("en")}, most engaged first${next}--full for all, or --min-impressions to trim the tail.`
+    );
+  }
+  if (!request.withFirmographics && data.rows.length > 0) {
+    hints.push(
+      "Add --with-firmographics for each company's industry and employee band, or --min-staff <n> to keep only companies that big \u2014 never judge fit from a name."
+    );
+  }
+  if (data.query.by === "none" && data.rows.length > 0) {
+    hints.push("--by month shows when each company warmed up; --by campaign shows which campaigns reached it.");
+  }
+  return hints;
+}
+function csvList(raw) {
+  if (typeof raw !== "string") return void 0;
+  const items = raw.split(",").map((s) => s.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+var FLAG_OF_FIELD = {
+  accountId: "--account-id",
+  campaignIds: "--campaign-id",
+  lastMonths: "--last-months",
+  start: "--start",
+  end: "--end",
+  by: "--by",
+  minImpressions: "--min-impressions",
+  page: "--page",
+  targets: "--targets",
+  minStaff: "--min-staff"
+};
+function flagOf(field) {
+  return FLAG_OF_FIELD[field.split(".")[0] ?? ""] ?? (field || "args");
+}
+function optionalNumber(raw) {
+  return typeof raw === "string" && raw.trim() !== "" ? Number(raw) : void 0;
+}
+var TARGET_ACCOUNTS_DIR = "src/content/target-accounts";
+function knowledgeTargetsHint(listEntries = () => readdirSync(TARGET_ACCOUNTS_DIR)) {
+  let entries;
+  try {
+    entries = listEntries().filter((file) => file.endsWith(".md"));
+  } catch {
+    return [];
+  }
+  if (entries.length === 0) return [];
+  return [
+    `The Knowledge lists ${entries.length} target account${entries.length === 1 ? "" : "s"}. To score them, write them with \`node __tooling__/scripts/target-accounts.mjs --out targets.csv\` and re-run with --targets targets.csv (--tier N for one tier): one call, with the ones never reached listed.`
+  ];
+}
+function targetsArg(path, tier, read = (file) => readFileSync(file, "utf8")) {
+  if (path === void 0 || path === "") {
+    if (tier !== void 0) throw new Error("--tier narrows a --targets list; pass --targets <file> too.");
+    return null;
+  }
+  const file = targetsOfTier(readTargetsFile(path, read(path)), tier);
+  if (file.targets.length === 0) throw new Error(`${path} names no company website.`);
+  return file;
+}
+var companiesCommand = defineCommand({
+  meta: {
+    name: "companies",
+    description: `Which companies your LinkedIn ads reached \u2014 one row per company over the whole period, most engaged first.
+
+Start here for "which companies are our ads warming", ABM reporting, or building a warm-account list.
+Scoring a target-account list? One call with --targets (build the file with
+\`node __tooling__/scripts/target-accounts.mjs --out targets.csv\`), never top-N reads joined by hand.
+Rows: {org, name, impressions, clicks, engagements, costLocal} (+ industry, staffCount with --with-firmographics; + target with --targets). Defaults: the last 12 calendar
+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
+  baker ads linkedin companies --targets targets.csv --tier 1           # only the tier-1 target accounts, + which were never reached
+  baker ads linkedin companies --with-firmographics --min-staff 500     # + industry and employee band; only companies of 500+
+  baker ads linkedin companies --last-months 3 --stats                  # + how complete LinkedIn's data is
+
+LinkedIn reports companies 12-24h late and leaves out any company with fewer than 3 events in a month,
+so small companies are undercounted. engagements = LinkedIn's totalEngagements.`
+  },
+  args: {
+    "account-id": {
+      type: "string",
+      description: "Ad account id (numeric or urn:li:sponsoredAccount:N). Default: the only selected account"
+    },
+    "campaign-id": { type: "string", description: "Comma-separated campaign ids \u2014 read only these campaigns" },
+    "last-months": { type: "string", description: "Calendar months back, including this one (1-24, default 12)" },
+    start: { type: "string", description: "Start date YYYY-MM-DD (instead of --last-months)" },
+    end: { type: "string", description: "End date YYYY-MM-DD (default today)" },
+    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" },
+    targets: {
+      type: "string",
+      description: "Only these target accounts: the file `node __tooling__/scripts/target-accounts.mjs --out targets.csv` writes from the Knowledge (or any .csv/.json `baker accounts --targets` takes). Matched on LinkedIn page, then website, then name; `targets` says how many were reached and engaged, per tier, and which never were"
+    },
+    tier: { type: "string", description: "With --targets: only this tier's accounts (the list's tier column)" },
+    "with-firmographics": {
+      type: "boolean",
+      description: "Add each company's industry and employee band (staffCount), read from its website \u2014 up to 100 companies a call, each new one billed like `baker research company`"
+    },
+    "min-staff": {
+      type: "string",
+      description: "Keep only companies with at least N employees (reads firmographics for the 100 most engaged)"
+    },
+    "min-impressions": { type: "string", description: "Leave out companies under N impressions over the period" },
+    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" }
+  },
+  run: async ({ args }) => {
+    let targets;
+    try {
+      targets = targetsArg(args.targets, args.tier);
+    } catch (err) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "INVALID_ARGS", message: `--targets: ${err instanceof Error ? err.message : String(err)}` }
+      });
+      process.exit(1);
+    }
+    const input = {
+      accountId: optionalAccountIdArg(args),
+      campaignIds: csvList(args["campaign-id"]),
+      lastMonths: optionalNumber(args["last-months"]),
+      start: args.start,
+      end: args.end,
+      by: args.by,
+      withDomains: Boolean(args["with-domains"]),
+      minImpressions: optionalNumber(args["min-impressions"]),
+      full: Boolean(args.full),
+      page: optionalNumber(args.page),
+      stats: Boolean(args.stats),
+      ...targets ? { targets: targets.targets } : {},
+      withFirmographics: Boolean(args["with-firmographics"]),
+      minStaff: optionalNumber(args["min-staff"]),
+      skipCache: Boolean(args["no-cache"])
+    };
+    const parsed = linkedinCompaniesRequestSchema.safeParse(input);
+    const formatRefusal = outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);
+    if (!parsed.success || formatRefusal !== null) {
+      const issues = parsed.success ? [] : parsed.error.issues;
+      const messages = issues.map((issue) => `${flagOf(issue.path.join("."))}: ${issue.message}`);
+      writeAdsJson({
+        ok: false,
+        error: { code: "INVALID_ARGS", message: [...messages, ...formatRefusal ? [formatRefusal] : []].join("; ") }
+      });
+      process.exit(1);
+    }
+    try {
+      const { data } = await apiPost(
+        "/api/ads/linkedin/companies",
+        input,
+        { timeoutMs: COMPANIES_TIMEOUT_MS }
+      );
+      const hints = [
+        ...targets ? targetsHints(data.targets, targets.unreadable) : knowledgeTargetsHint(),
+        ...companiesHints(data, parsed.data)
+      ];
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        const notes = [...data.warnings.map((w) => `${w.code}: ${w.message}`), ...hints];
+        writeAdsOutput(data.rows, fmt, CSV_FIELDS, notes);
+        return;
+      }
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+
+export {
+  companiesHints,
+  knowledgeTargetsHint,
+  targetsArg,
+  companiesCommand
+};
+//# sourceMappingURL=chunk-SSFQNMPS.js.map

package/dist/chunk-SSFQNMPS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/companies.ts"],"sourcesContent":["import { readdirSync, readFileSync } from \"node:fs\";\nimport {\n  type LINKEDIN_COMPANIES_BY,\n  type LinkedinCompaniesRequestInput,\n  type LinkedinCompaniesResponse,\n  linkedinCompaniesRequestSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { targetsHints } from \"../../accounts/report.ts\";\nimport { readTargetsFile, type TargetsFile, targetsOfTier } from \"../../accounts/targets.ts\";\nimport {\n  outputFormatRefusal,\n  TABLE_OUTPUT_FORMATS,\n  writeAdsJson,\n  writeAdsOutput,\n  writeJsonEnvelope,\n} from \"../output.ts\";\nimport { csvOrJson, handleLinkedinError, optionalAccountIdArg } from \"./shared.ts\";\n\n/** Companies per page without --full. */\nconst COMPANIES_PAGE_SIZE = 100;\n\n/** A by-campaign read makes one LinkedIn call per delivered campaign. */\nconst COMPANIES_TIMEOUT_MS = 180_000;\n\nconst CSV_FIELDS = [\n  \"org\",\n  \"name\",\n  \"domain\",\n  \"domainSource\",\n  \"impressions\",\n  \"clicks\",\n  \"engagements\",\n  \"costLocal\",\n  \"videoViews\",\n  \"industry\",\n  \"staffCount\",\n  \"target\",\n  \"months\",\n  \"campaigns\",\n];\n\n/** Next steps the agent can't see from the rows alone. */\nexport function companiesHints(\n  data: LinkedinCompaniesResponse,\n  request: { withDomains: boolean; withFirmographics: boolean },\n): string[] {\n  const hints: string[] = [];\n  if (data.rows.length === 0) {\n    hints.push(\n      `No company shows up for ${data.query.start} to ${data.query.end}${data.query.minImpressions > 0 ? ` at --min-impressions ${data.query.minImpressions}` : \"\"}. LinkedIn reports companies 12-24h late and leaves out any with fewer than 3 events in a month, so a small or new campaign can have none yet. Try a longer period (--last-months 24), drop --min-impressions, or check the campaigns delivered with \\`baker ads linkedin analytics\\`.`,\n    );\n    return hints;\n  }\n  const withDomain = data.rows.filter((row) => row.domain !== undefined).length;\n  if (withDomain > 0) {\n    hints.push(\n      `${withDomain} companies came back with a website domain — if HubSpot is connected, \\`baker hubspot companies search --domains <domain,domain,…> --with-deals\\` (up to 100 per call) shows which are already accounts and which have deals.`,\n    );\n  } else if (!request.withDomains && data.rows.length > 0) {\n    hints.push(\n      \"Add --with-domains to get each company's website domain, ready for matching against your customer list.\",\n    );\n  }\n  if (data.totalCompanies > data.rows.length) {\n    const page = data.page ?? 1;\n    const first = (page - 1) * COMPANIES_PAGE_SIZE + 1;\n    const last = first + data.rows.length - 1;\n    const next = last < data.totalCompanies ? ` — --page ${page + 1} for the next ${COMPANIES_PAGE_SIZE}, ` : \" — \";\n    hints.push(\n      `Showing companies ${first}-${last} of ${data.totalCompanies.toLocaleString(\"en\")}, most engaged first${next}--full for all, or --min-impressions to trim the tail.`,\n    );\n  }\n  if (!request.withFirmographics && data.rows.length > 0) {\n    hints.push(\n      \"Add --with-firmographics for each company's industry and employee band, or --min-staff <n> to keep only companies that big — never judge fit from a name.\",\n    );\n  }\n  if (data.query.by === \"none\" && data.rows.length > 0) {\n    hints.push(\"--by month shows when each company warmed up; --by campaign shows which campaigns reached it.\");\n  }\n  return hints;\n}\n\nfunction csvList(raw: unknown): string[] | undefined {\n  if (typeof raw !== \"string\") return undefined;\n  const items = raw\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n  return items.length > 0 ? items : undefined;\n}\n\n/** Request fields as the flags that set them, so a refusal names what the agent typed. */\nconst FLAG_OF_FIELD: Record<string, string> = {\n  accountId: \"--account-id\",\n  campaignIds: \"--campaign-id\",\n  lastMonths: \"--last-months\",\n  start: \"--start\",\n  end: \"--end\",\n  by: \"--by\",\n  minImpressions: \"--min-impressions\",\n  page: \"--page\",\n  targets: \"--targets\",\n  minStaff: \"--min-staff\",\n};\n\nfunction flagOf(field: string): string {\n  return FLAG_OF_FIELD[field.split(\".\")[0] ?? \"\"] ?? (field || \"args\");\n}\n\nfunction optionalNumber(raw: unknown): number | undefined {\n  return typeof raw === \"string\" && raw.trim() !== \"\" ? Number(raw) : undefined;\n}\n\n/** Where the Knowledge keeps the client's target accounts, one entry per company. */\nconst TARGET_ACCOUNTS_DIR = \"src/content/target-accounts\";\n\n/**\n * The nudge a read without `--targets` gets when the Knowledge lists target\n * accounts: scoring them is one call, never a top-N read joined by hand.\n */\nexport function knowledgeTargetsHint(listEntries: () => string[] = () => readdirSync(TARGET_ACCOUNTS_DIR)): string[] {\n  let entries: string[];\n  try {\n    entries = listEntries().filter((file) => file.endsWith(\".md\"));\n  } catch {\n    return [];\n  }\n  if (entries.length === 0) return [];\n  return [\n    `The Knowledge lists ${entries.length} target account${entries.length === 1 ? \"\" : \"s\"}. To score them, write them with \\`node __tooling__/scripts/target-accounts.mjs --out targets.csv\\` and re-run with --targets targets.csv (--tier N for one tier): one call, with the ones never reached listed.`,\n  ];\n}\n\n/** `--targets <file>` narrowed to `--tier`; null without one. Throws, in the agent's words, on a list it cannot use. */\nexport function targetsArg(\n  path: string | undefined,\n  tier: string | undefined,\n  read: (path: string) => string = (file) => readFileSync(file, \"utf8\"),\n): TargetsFile | null {\n  if (path === undefined || path === \"\") {\n    if (tier !== undefined) throw new Error(\"--tier narrows a --targets list; pass --targets <file> too.\");\n    return null;\n  }\n  const file = targetsOfTier(readTargetsFile(path, read(path)), tier);\n  if (file.targets.length === 0) throw new Error(`${path} names no company website.`);\n  return file;\n}\n\nexport const companiesCommand = defineCommand({\n  meta: {\n    name: \"companies\",\n    description: `Which companies your LinkedIn ads reached — one row per company over the whole period, most engaged first.\n\nStart here for \"which companies are our ads warming\", ABM reporting, or building a warm-account list.\nScoring a target-account list? One call with --targets (build the file with\n\\`node __tooling__/scripts/target-accounts.mjs --out targets.csv\\`), never top-N reads joined by hand.\nRows: {org, name, impressions, clicks, engagements, costLocal} (+ industry, staffCount with --with-firmographics; + target with --targets). Defaults: the last 12 calendar\nmonths, the only selected ad account, 100 companies a page (--page 2 for the next, --full for all).\n\nExamples:\n  baker ads linkedin companies                                          # last 12 months, whole account\n  baker ads linkedin companies --page 2                                 # the next 100 companies\n  baker ads linkedin companies --by month --min-impressions 50          # when each company warmed up\n  baker ads linkedin companies --campaign-id 333728193,810055513 --by campaign\n  baker ads linkedin companies --with-domains --output csv              # + website domain, for CRM matching\n  baker ads linkedin companies --targets targets.csv --tier 1           # only the tier-1 target accounts, + which were never reached\n  baker ads linkedin companies --with-firmographics --min-staff 500     # + industry and employee band; only companies of 500+\n  baker ads linkedin companies --last-months 3 --stats                  # + how complete LinkedIn's data is\n\nLinkedIn reports companies 12-24h late and leaves out any company with fewer than 3 events in a month,\nso small companies are undercounted. engagements = LinkedIn's totalEngagements.`,\n  },\n  args: {\n    \"account-id\": {\n      type: \"string\",\n      description: \"Ad account id (numeric or urn:li:sponsoredAccount:N). Default: the only selected account\",\n    },\n    \"campaign-id\": { type: \"string\", description: \"Comma-separated campaign ids — read only these campaigns\" },\n    \"last-months\": { type: \"string\", description: \"Calendar months back, including this one (1-24, default 12)\" },\n    start: { type: \"string\", description: \"Start date YYYY-MM-DD (instead of --last-months)\" },\n    end: { type: \"string\", description: \"End date YYYY-MM-DD (default today)\" },\n    by: { type: \"string\", description: \"none | month | campaign — break each company down (default none)\" },\n    \"with-domains\": { type: \"boolean\", description: \"Add each company's website domain and domainSource\" },\n    targets: {\n      type: \"string\",\n      description:\n        \"Only these target accounts: the file `node __tooling__/scripts/target-accounts.mjs --out targets.csv` writes from the Knowledge (or any .csv/.json `baker accounts --targets` takes). Matched on LinkedIn page, then website, then name; `targets` says how many were reached and engaged, per tier, and which never were\",\n    },\n    tier: { type: \"string\", description: \"With --targets: only this tier's accounts (the list's tier column)\" },\n    \"with-firmographics\": {\n      type: \"boolean\",\n      description:\n        \"Add each company's industry and employee band (staffCount), read from its website — up to 100 companies a call, each new one billed like `baker research company`\",\n    },\n    \"min-staff\": {\n      type: \"string\",\n      description: \"Keep only companies with at least N employees (reads firmographics for the 100 most engaged)\",\n    },\n    \"min-impressions\": { type: \"string\", description: \"Leave out companies under N impressions over the period\" },\n    full: { type: \"boolean\", description: \"Every company (not just a page of 100), plus videoViews\" },\n    page: {\n      type: \"string\",\n      description: \"Which page of 100 companies, most engaged first (default 1); totalCompanies counts them all\",\n    },\n    stats: { type: \"boolean\", description: \"Add read-quality stats: row counts, cost/reach/domain coverage\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    let targets: TargetsFile | null;\n    try {\n      targets = targetsArg(args.targets as string | undefined, args.tier as string | undefined);\n    } catch (err) {\n      writeAdsJson({\n        ok: false,\n        error: { code: \"INVALID_ARGS\", message: `--targets: ${err instanceof Error ? err.message : String(err)}` },\n      });\n      process.exit(1);\n    }\n    const input: LinkedinCompaniesRequestInput = {\n      accountId: optionalAccountIdArg(args),\n      campaignIds: csvList(args[\"campaign-id\"]),\n      lastMonths: optionalNumber(args[\"last-months\"]),\n      start: args.start as string | undefined,\n      end: args.end as string | undefined,\n      by: args.by as (typeof LINKEDIN_COMPANIES_BY)[number] | undefined,\n      withDomains: Boolean(args[\"with-domains\"]),\n      minImpressions: optionalNumber(args[\"min-impressions\"]),\n      full: Boolean(args.full),\n      page: optionalNumber(args.page),\n      stats: Boolean(args.stats),\n      ...(targets ? { targets: targets.targets } : {}),\n      withFirmographics: Boolean(args[\"with-firmographics\"]),\n      minStaff: optionalNumber(args[\"min-staff\"]),\n      skipCache: Boolean(args[\"no-cache\"]),\n    };\n    const parsed = linkedinCompaniesRequestSchema.safeParse(input);\n    const formatRefusal = outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);\n    if (!parsed.success || formatRefusal !== null) {\n      const issues = parsed.success ? [] : parsed.error.issues;\n      const messages = issues.map((issue) => `${flagOf(issue.path.join(\".\"))}: ${issue.message}`);\n      writeAdsJson({\n        ok: false,\n        error: { code: \"INVALID_ARGS\", message: [...messages, ...(formatRefusal ? [formatRefusal] : [])].join(\"; \") },\n      });\n      process.exit(1);\n    }\n\n    try {\n      const { data } = await apiPost<{ ok: true; data: LinkedinCompaniesResponse }>(\n        \"/api/ads/linkedin/companies\",\n        input,\n        { timeoutMs: COMPANIES_TIMEOUT_MS },\n      );\n      const hints = [\n        ...(targets ? targetsHints(data.targets, targets.unreadable) : knowledgeTargetsHint()),\n        ...companiesHints(data, parsed.data),\n      ];\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        const notes = [...data.warnings.map((w) => `${w.code}: ${w.message}`), ...hints];\n        writeAdsOutput(data.rows, fmt, CSV_FIELDS, notes);\n        return;\n      }\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-SULQZX5W.js

@@ -0,0 +1,42 @@
+import {
+  ApiError
+} from "./chunk-JCFZ7ECN.js";
+import {
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+
+// src/commands/studio/errors.ts
+var CREDIT_HINTS = ["credit", "top up", "billing", "quota"];
+function studioStartFix(message) {
+  const lower = message.toLowerCase();
+  if (CREDIT_HINTS.some((hint) => lower.includes(hint))) {
+    return {
+      action: "Stop generating and finish the task with assets that already exist",
+      explanation: "No generation will run until the plan is topped up, so retrying costs time and changes nothing. Source or reuse an image instead, complete the rest of the work, and tell the user the new artwork could not be produced."
+    };
+  }
+  return {
+    action: "Drop or correct the setting the message names, then run the command once more",
+    explanation: "The message says which model was chosen and what it accepts. If the setting is not essential to the brief, leave it out rather than switching model. Do not abort the wider job over one refused setting."
+  };
+}
+function failStudioCommand(error, opts = {}) {
+  if (error instanceof ApiError) {
+    writeJson({
+      ok: false,
+      error: {
+        code: error.code,
+        message: error.message,
+        ...opts.withFix ? { fix: studioStartFix(error.message) } : {}
+      }
+    });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+
+export {
+  failStudioCommand
+};
+//# sourceMappingURL=chunk-SULQZX5W.js.map