@koda-sl/baker-cli 0.447.0-dev.f5788a631 → 0.447.0

package/dist/chunk-ZPU3WDVK.js

@@ -0,0 +1,92 @@
+import {
+  claimNewCreativeInWorkspace,
+  creativeLimitRefusal
+} from "./chunk-MLU6STIN.js";
+import {
+  leadVersion,
+  writeSeriesMemberCanvas
+} from "./chunk-KBP7WJQB.js";
+import {
+  definitionFieldsOf,
+  setDefinitionFields,
+  setSpecMessage
+} from "./chunk-AWMFUGVX.js";
+import {
+  IDEAS_DIR
+} from "./chunk-U6SYRIOB.js";
+
+// src/commands/creatives/make-series.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { parseDocument } from "yaml";
+var LEAD_ONLY = ["idea", "message", "evidence", "angle", "persona", "awareness", "hypothesis", "series", "title"];
+function withoutFields(raw, keys) {
+  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+  if (!match) return raw;
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return raw;
+  for (const key of keys) doc.delete(key);
+  return `---
+${doc.toString()}---${raw.slice(match[0].length)}`;
+}
+async function makeSeriesAd(root, idea, slug, lead, evidence, deps) {
+  if (slug === lead) {
+    return {
+      code: "series_of_itself",
+      message: `"${slug}" is the lead itself.`,
+      fix: "Give the new ad its own --slug."
+    };
+  }
+  const version = await leadVersion(root, lead);
+  if ("refused" in version) return version.refused;
+  const dir = path.join(root, "src", "creatives", slug);
+  const definitionPath = path.join(dir, "_definition.md");
+  const claim = await claimNewCreativeInWorkspace(path.join(root, "canvas"), slug, deps.chatId, definitionPath);
+  if (!claim.allowed) return creativeLimitRefusal(slug).error;
+  await mkdir(dir, { recursive: true });
+  await writeFile(path.join(dir, "prompt.json"), setSpecMessage(JSON.stringify(version.spec), idea.message), "utf8");
+  const leadDefinition = await readFile(path.join(root, "src", "creatives", lead, "_definition.md"), "utf8").catch(
+    () => "---\nkind: static\n---\n"
+  );
+  const definition = setDefinitionFields(withoutFields(leadDefinition, LEAD_ONLY), {
+    title: idea.message.slice(0, 120),
+    series: lead,
+    status: "draft",
+    ...definitionFieldsOf(idea, evidence)
+  });
+  await writeFile(definitionPath, definition, "utf8");
+  const made = await writeSeriesMemberCanvas(root, slug, { leadWords: true });
+  if (made === null || "refused" in made) {
+    return made?.refused ?? { code: "series_not_made", message: `"${slug}" could not be made in the series of "${lead}".` };
+  }
+  if (idea.status === "idea") {
+    const ideaPath = path.join(root, IDEAS_DIR, `${idea.id}.md`);
+    const raw = await readFile(ideaPath, "utf8").catch(() => null);
+    if (raw !== null) await writeFile(ideaPath, setDefinitionFields(raw, { status: "built" }), "utf8");
+  }
+  await deps.sync(dir);
+  return { slug, lead, leadRunId: version.lead.runId, canvasPath: made.canvasPath };
+}
+function seriesMadeEnvelope(made, idea) {
+  return {
+    ok: true,
+    data: {
+      creative: made.slug,
+      idea: idea.id,
+      message: idea.message,
+      series: made.lead,
+      canvas_path: made.canvasPath
+    },
+    hints: [
+      `Write this ad's words in src/creatives/${made.slug}/prompt.json \`copy\`: one line for each of the lead's, in the same roles and about as long, saying this idea's message. Change nothing else: the picture, layout and colours are the lead's (${made.lead}), and every word you write replaces the lead's line in its place.`,
+      `When every ad of the series has its words: baker canvas run --series ${made.lead} (renders them all at once, each reviewed and corrected on its own).`
+    ]
+  };
+}
+
+export {
+  withoutFields,
+  makeSeriesAd,
+  seriesMadeEnvelope
+};
+//# sourceMappingURL=chunk-ZPU3WDVK.js.map

package/dist/claim-V4F5GZJK.js

@@ -0,0 +1,197 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-E4MDJBLO.js";
+import "./chunk-NDXBU22S.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import {
+  requireChatId
+} from "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/claim.ts
+import { defineCommand } from "citty";
+
+// src/commands/actions/skillCatalog.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+var DESCRIPTION_MAX = 600;
+var SKILLS_SUBPATH = join(".claude", "skills");
+var EXCLUDED_SKILLS = /* @__PURE__ */ new Set(["actions"]);
+function stripQuotes(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+    return trimmed.slice(1, -1).replace(/\\"/g, '"').replace(/\\n/g, "\n");
+  }
+  if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return trimmed.slice(1, -1).replace(/''/g, "'");
+  }
+  return trimmed;
+}
+function extractFrontmatterLines(md) {
+  if (!md.startsWith("---")) return null;
+  const end = md.indexOf("\n---", 3);
+  if (end === -1) return null;
+  return md.slice(md.indexOf("\n", 3) + 1, end).split("\n");
+}
+var BLOCK_SCALAR = /^([|>])[+-]?$/;
+function collectBlockLines(lines, start) {
+  const collected = [];
+  for (let i = start; i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    if (line.trim() === "") {
+      collected.push("");
+    } else if (/^\s/.test(line)) {
+      collected.push(line.trim());
+    } else {
+      break;
+    }
+  }
+  while (collected.length > 0 && collected.at(-1) === "") collected.pop();
+  return collected;
+}
+function foldLines(collected) {
+  const paragraphs = [];
+  let buffer = [];
+  for (const line of collected) {
+    if (line === "") {
+      if (buffer.length > 0) paragraphs.push(buffer.join(" "));
+      buffer = [];
+    } else {
+      buffer.push(line);
+    }
+  }
+  if (buffer.length > 0) paragraphs.push(buffer.join(" "));
+  return paragraphs.join("\n");
+}
+function readBlockScalar(lines, start, style) {
+  const collected = collectBlockLines(lines, start);
+  return style === "|" ? collected.join("\n") : foldLines(collected);
+}
+function readField(lines, field) {
+  for (let i = 0; i < lines.length; i++) {
+    const match = (lines[i] ?? "").match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!match || match[1] !== field) continue;
+    const inline = (match[2] ?? "").trim();
+    const scalar = inline.match(BLOCK_SCALAR);
+    if (scalar) {
+      return readBlockScalar(lines, i + 1, scalar[1]);
+    }
+    return stripQuotes(inline);
+  }
+  return null;
+}
+function parseSkillFrontmatter(md) {
+  const lines = extractFrontmatterLines(md);
+  if (!lines) return null;
+  const name = readField(lines, "name");
+  const description = readField(lines, "description");
+  if (!name || !description) return null;
+  const trimmed = description.length > DESCRIPTION_MAX ? `${description.slice(0, DESCRIPTION_MAX)}\u2026` : description;
+  return { name, description: trimmed };
+}
+function findSkillsDir(startDir) {
+  let dir = startDir;
+  for (; ; ) {
+    const candidate = join(dir, SKILLS_SUBPATH);
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function readSkillCatalog(startDir) {
+  const skillsDir = findSkillsDir(startDir);
+  if (!skillsDir) return [];
+  const entries = [];
+  for (const dirent of readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!dirent.isDirectory() || EXCLUDED_SKILLS.has(dirent.name)) continue;
+    const skillFile = join(skillsDir, dirent.name, "SKILL.md");
+    if (!existsSync(skillFile)) continue;
+    try {
+      const parsed = parseSkillFrontmatter(readFileSync(skillFile, "utf8"));
+      if (parsed) entries.push(parsed);
+    } catch {
+    }
+  }
+  return entries.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// src/commands/actions/claim.ts
+registerSchema({
+  command: "actions.claim",
+  description: "Claim an action for the current chat (live \u2014 visible to other chats immediately). Claim only what you're actively working on now: it's required before `complete`, but NOT for `update` or `discard` (those stage without a claim). Returns action details plus a fast-model recommendation of which skills to load for the work (`recommendedSkills`) and a routing hint: load every skill that owns part of the work and the tool doc for each baker CLI family you'll use.",
+  args: {
+    id: { type: "string", description: "Action ID", required: true }
+  }
+});
+async function recommendSkills(actionId) {
+  const skills = readSkillCatalog(process.cwd());
+  if (skills.length === 0) return [];
+  const response = await apiPost("/api/actions/recommend-skills", {
+    actionId,
+    skills
+  });
+  return response.data.recommendations;
+}
+var ROUTING_HINT = "Actions often span several surfaces (a landing page plus a Google Ads change, a sheet pull plus an audience upload). Before starting, load EVERY skill that owns part of the work and read the tool doc (__tooling__/docs/tools/baker/<family>.md) for each baker CLI family you'll use. If the action references source material living in a connected tool (an email attachment, a call, a CRM record, a spreadsheet), reach for that tool too. If it describes recurring or future-dated work, it belongs on a schedule \u2014 see __tooling__/docs/tools/baker/scheduled-agents.md.";
+function buildHints(recommendations) {
+  if (recommendations.length === 0) {
+    return ["Review the action name, description, and tags above.", ROUTING_HINT];
+  }
+  return [
+    "Recommended skills for this action (load the ones you'll use):",
+    ...recommendations.map((r) => `  /${r.name} \u2014 ${r.reason}`),
+    "Suggestions come from the action's name/description/tags only \u2014 the work may need more.",
+    ROUTING_HINT
+  ];
+}
+var claimCommand = defineCommand({
+  meta: {
+    name: "claim",
+    description: "Claim an action so other chats see you're working on it. Required before `complete` (update and discard don't need a claim). Example: baker actions claim <action-id>"
+  },
+  args: {
+    id: { type: "positional", description: "Action ID", required: false },
+    "action-id": { type: "string", description: "Action ID", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      const chatId = requireChatId();
+      const response = await apiPost("/api/actions/claim", {
+        actionId: id,
+        chatId
+      });
+      let recommendedSkills = [];
+      try {
+        recommendedSkills = await recommendSkills(id);
+      } catch {
+      }
+      const data = response.data ? { ...response.data, recommendedSkills } : response.data;
+      writeJson({ ok: response.ok, data, hints: buildHints(recommendedSkills) });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  claimCommand
+};
+//# sourceMappingURL=claim-V4F5GZJK.js.map

package/dist/cli.js

@@ -106,38 +106,38 @@ Formats: --output json works on every command that prints the envelope. --output
 Introspection: Run 'baker schema <command>' to inspect argument schemas.`
   },
   subCommands: {
-    capabilities: () => import("./capabilities-GVHPHH2G.js").then((m) => m.capabilitiesCommand),
-    actions: () => import("./actions-HM4VVTGW.js").then((m) => m.actionsCommand),
-    "scheduled-agents": () => import("./scheduled-agents-K5WU7SVJ.js").then((m) => m.scheduledAgentsCommand),
-    ads: () => import("./ads-NUME2UXH.js").then((m) => m.adsCommand),
-    brand: () => import("./brand-OXYFSNA5.js").then((m) => m.brandCommand),
-    analytics: () => import("./analytics-QTR2ZITZ.js").then((m) => m.analyticsCommand),
+    capabilities: () => import("./capabilities-RDAERPYY.js").then((m) => m.capabilitiesCommand),
+    actions: () => import("./actions-5F4ZP6M4.js").then((m) => m.actionsCommand),
+    "scheduled-agents": () => import("./scheduled-agents-PCWCQAKP.js").then((m) => m.scheduledAgentsCommand),
+    ads: () => import("./ads-56OWZBXZ.js").then((m) => m.adsCommand),
+    brand: () => import("./brand-ASBS2HZM.js").then((m) => m.brandCommand),
+    analytics: () => import("./analytics-JVZKN735.js").then((m) => m.analyticsCommand),
     experiment: () => import("./experiment-LKK77YAN.js").then((m) => m.experimentCommand),
     ga4: () => import("./ga4-UDQ2HA2J.js").then((m) => m.ga4Command),
     gsc: () => import("./gsc-P3QYGDV2.js").then((m) => m.gscCommand),
-    research: () => import("./research-TISR736S.js").then((m) => m.researchCommand),
-    creatives: () => import("./creatives-5MUTX4DQ.js").then((m) => m.creativesCommand),
-    flows: () => import("./flows-OGGSWWGT.js").then((m) => m.flowsCommand),
-    funnel: () => import("./funnel-7U55LNJ4.js").then((m) => m.funnelCommand),
-    images: () => import("./images-LXFWEON7.js").then((m) => m.imagesCommand),
-    studio: () => import("./studio-HUEBE6DS.js").then((m) => m.studioCommand),
-    avatars: () => import("./avatars-OEK3FYKK.js").then((m) => m.avatarsCommand),
-    landing: () => import("./landing-D7QS42GK.js").then((m) => m.landingCommand),
-    videos: () => import("./videos-FVVID55J.js").then((m) => m.videosCommand),
-    testimonials: () => import("./testimonials-WJBRWLNW.js").then((m) => m.testimonialsCommand),
-    canvas: () => import("./canvas-B6DPRQGN.js").then((m) => m.canvasCommand),
-    tags: () => import("./tags-DIXLYB5P.js").then((m) => m.tagsCommand),
-    "tag-manager": () => import("./tag-manager-HREEYGVM.js").then((m) => m.tagManagerCommand),
-    chats: () => import("./chats-54CWM7DL.js").then((m) => m.chatsCommand),
-    history: () => import("./history-PSNJAUTW.js").then((m) => m.historyCommand),
-    credentials: () => import("./credentials-AETHKP5T.js").then((m) => m.credentialsCommand),
-    hubspot: () => import("./hubspot-2NHL47R2.js").then((m) => m.hubspotCommand),
-    accounts: () => import("./accounts-OSXDZZLY.js").then((m) => m.accountsCommand),
-    "winning-ads": () => import("./winning-ads-OSRFHVLV.js").then((m) => m.winningAdsCommand),
-    "media-sources": () => import("./media-sources-SJZUOMI2.js").then((m) => m.mediaSourcesCommand),
-    site: () => import("./site-MXPKMRQT.js").then((m) => m.siteCommand),
-    mcp: () => import("./mcp-JOXKA5HY.js").then((m) => m.mcpCommand),
-    "setup-links": () => import("./setup-links-KFROCISS.js").then((m) => m.setupLinksCommand),
+    research: () => import("./research-O7CJV5IS.js").then((m) => m.researchCommand),
+    creatives: () => import("./creatives-DWO5KEQC.js").then((m) => m.creativesCommand),
+    flows: () => import("./flows-CWXCXEUD.js").then((m) => m.flowsCommand),
+    funnel: () => import("./funnel-RLGQGYKO.js").then((m) => m.funnelCommand),
+    images: () => import("./images-SP5REF6E.js").then((m) => m.imagesCommand),
+    studio: () => import("./studio-C5K3YX3P.js").then((m) => m.studioCommand),
+    avatars: () => import("./avatars-N4SRNQI7.js").then((m) => m.avatarsCommand),
+    landing: () => import("./landing-R6DN7XLK.js").then((m) => m.landingCommand),
+    videos: () => import("./videos-BP3BKNTY.js").then((m) => m.videosCommand),
+    testimonials: () => import("./testimonials-6M5DXORT.js").then((m) => m.testimonialsCommand),
+    canvas: () => import("./canvas-K7IN7HLO.js").then((m) => m.canvasCommand),
+    tags: () => import("./tags-BHFQWNPL.js").then((m) => m.tagsCommand),
+    "tag-manager": () => import("./tag-manager-DYZUOIAS.js").then((m) => m.tagManagerCommand),
+    chats: () => import("./chats-YIAQGQ3X.js").then((m) => m.chatsCommand),
+    history: () => import("./history-4II5QA4B.js").then((m) => m.historyCommand),
+    credentials: () => import("./credentials-UULYCN2L.js").then((m) => m.credentialsCommand),
+    hubspot: () => import("./hubspot-TTITJFBO.js").then((m) => m.hubspotCommand),
+    accounts: () => import("./accounts-RHGN5WMU.js").then((m) => m.accountsCommand),
+    "winning-ads": () => import("./winning-ads-WUENRDVJ.js").then((m) => m.winningAdsCommand),
+    "media-sources": () => import("./media-sources-JWGO23BZ.js").then((m) => m.mediaSourcesCommand),
+    site: () => import("./site-WIQ7SSU3.js").then((m) => m.siteCommand),
+    mcp: () => import("./mcp-HVAVJGGS.js").then((m) => m.mcpCommand),
+    "setup-links": () => import("./setup-links-V3URI7DL.js").then((m) => m.setupLinksCommand),
     schema: () => import("./schema-6GR77VJG.js").then((m) => m.schemaCommand)
   }
 });

package/dist/companies-NJGJ7XNN.js

@@ -0,0 +1,195 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-6DB2B3GF.js";
+import {
+  TABLE_OUTPUT_FORMATS,
+  outputFormatRefusal,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-VFIOJD5M.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import {
+  linkedinCompaniesRequestSchema
+} from "./chunk-NDXBU22S.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import {
+  getEnv
+} from "./chunk-NAWWC5I3.js";
+import "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/companies.ts
+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",
+  "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 (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"
+};
+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;
+}
+function bareAccountId(raw) {
+  return raw?.startsWith("urn:") ? raw.split(":").pop() : raw;
+}
+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.
+Rows: {org, name, impressions, clicks, engagements, costLocal}. 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 --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" },
+    "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 }) => {
+    const input = {
+      accountId: bareAccountId(args["account-id"] || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID),
+      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),
+      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 = 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 {
+  companiesCommand,
+  companiesHints
+};
+//# sourceMappingURL=companies-NJGJ7XNN.js.map

package/dist/complete-MGNF5OAK.js

@@ -0,0 +1,81 @@
+import {
+  failApi,
+  failValidation,
+  isTempId,
+  writeOk
+} from "./chunk-E4MDJBLO.js";
+import {
+  ACTION_COMPLETE_NOTE_MIN
+} from "./chunk-NDXBU22S.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import {
+  requireChatId
+} from "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.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>"
+  },
+  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-MGNF5OAK.js.map

package/dist/connect-PJOTRTT4.js

@@ -0,0 +1,36 @@
+import {
+  attachDestination,
+  attachStep,
+  connectCommand,
+  copyDestination,
+  destinationRefusal,
+  targetsFor,
+  unpickedSteps,
+  unwiredHubspotForms,
+  unwiredSideEffects
+} from "./chunk-IM52NHGL.js";
+import "./chunk-HZ5DR5MX.js";
+import "./chunk-BSC33FLJ.js";
+import "./chunk-E4MDJBLO.js";
+import "./chunk-NDXBU22S.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  attachDestination,
+  attachStep,
+  connectCommand,
+  copyDestination,
+  destinationRefusal,
+  targetsFor,
+  unpickedSteps,
+  unwiredHubspotForms,
+  unwiredSideEffects
+};
+//# sourceMappingURL=connect-PJOTRTT4.js.map