@koda-sl/baker-cli 0.524.0-dev.3eb5500a1 → 0.524.0

package/dist/chunk-ZUXXUHZY.js

@@ -1,91 +0,0 @@
-import {
-  leadVersion,
-  writeSeriesMemberCanvas
-} from "./chunk-76TUVLAJ.js";
-import {
-  definitionFieldsOf,
-  setDefinitionFields,
-  setSpecMessage
-} from "./chunk-XXCMIS2V.js";
-import {
-  IDEAS_DIR
-} from "./chunk-ISDOF6KZ.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");
-  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) {
-  const lead = made.leadPlatforms ?? [];
-  const elsewhere = (idea.platforms ?? []).some((p) => !lead.includes(p));
-  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).`,
-      ...elsewhere && lead.length > 0 ? [
-        `A series ad runs where its lead runs (${lead.join(", ")}), in its sizes; the idea names ${idea.platforms?.join(", ")}. To run it there, make it on its own: baker creatives make ${idea.id} --platforms ${idea.platforms?.join(",")}.`
-      ] : []
-    ]
-  };
-}
-
-export {
-  withoutFields,
-  makeSeriesAd,
-  seriesMadeEnvelope
-};
-//# sourceMappingURL=chunk-ZUXXUHZY.js.map

package/dist/chunk-ZV7I2U4T.js

@@ -1,51 +0,0 @@
-import {
-  failApi
-} from "./chunk-XKRCO3JC.js";
-import {
-  HUBSPOT_MISSING_GRANT_MARKER,
-  HUBSPOT_NOT_CONNECTED_MESSAGE
-} from "./chunk-DYOUJERF.js";
-import {
-  ApiError
-} from "./chunk-4U7HXXSA.js";
-import {
-  writeJson
-} from "./chunk-L55PHMSR.js";
-
-// src/commands/hubspot/refusal.ts
-var CONTINUE = "Keep going with the wider task: say which part you could not read, skip it, and finish everything else. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 HubSpot.";
-function hubspotRefusal(code, message, reason = "so I can count a contact becoming a customer") {
-  if (code === "NOT_FOUND" && message.includes(HUBSPOT_NOT_CONNECTED_MESSAGE)) {
-    return {
-      code: "NO_HUBSPOT_CONNECTION",
-      fix: {
-        action: "request_connection",
-        explanation: `AGENT INSTRUCTION: HubSpot is not connected, and only the user can connect it. Call the \`request_connection\` tool with { platform: "hubspot", reason } \u2014 reason in their words, e.g. "${reason}" \u2014 and they connect it inside the chat; then run this command again. ` + CONTINUE
-      }
-    };
-  }
-  if (code === "FORBIDDEN" && message.includes(HUBSPOT_MISSING_GRANT_MARKER)) {
-    return {
-      code: "HUBSPOT_RECONNECT_REQUIRED",
-      fix: {
-        action: "request_connection",
-        explanation: 'AGENT INSTRUCTION: HubSpot is connected \u2014 do not tell the user it is missing, and do not retry. Its access does not cover this read (it was connected before Baker asked for it, or the access was withdrawn), and only the user can widen it. Call the `request_connection` tool with { platform: "hubspot", reason } naming what you need to read; the card offers them a Reconnect button. Run this command again once they have. ' + CONTINUE
-      }
-    };
-  }
-  return null;
-}
-function failNotConnected(err, reason) {
-  const refusal = err instanceof ApiError ? hubspotRefusal(err.code, err.message, reason) : null;
-  if (err instanceof ApiError && refusal !== null) {
-    writeJson({ ok: false, error: { code: refusal.code, message: err.message, fix: refusal.fix } });
-    process.exit(1);
-  }
-  failApi(err);
-}
-
-export {
-  hubspotRefusal,
-  failNotConnected
-};
-//# sourceMappingURL=chunk-ZV7I2U4T.js.map

package/dist/claim-HDRBJL5Q.js

@@ -1,200 +0,0 @@
-import {
-  failApi,
-  failValidation
-} from "./chunk-XKRCO3JC.js";
-import "./chunk-DYOUJERF.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-MUS2UTWU.js";
-import {
-  apiPost,
-  validateConvexId
-} from "./chunk-4U7HXXSA.js";
-import "./chunk-V6AAOAMM.js";
-import {
-  requireChatId
-} from "./chunk-GGUQP6KI.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-L55PHMSR.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-HDRBJL5Q.js.map

package/dist/companies-A7BFDYCP.js

@@ -1,198 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError
-} from "./chunk-JMQ3F5VX.js";
-import {
-  TABLE_OUTPUT_FORMATS,
-  outputFormatRefusal,
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-X7DMNLDD.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-7PMGAOHZ.js";
-import {
-  linkedinCompaniesRequestSchema
-} from "./chunk-DYOUJERF.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-MUS2UTWU.js";
-import {
-  apiPost
-} from "./chunk-4U7HXXSA.js";
-import "./chunk-V6AAOAMM.js";
-import {
-  getEnv
-} from "./chunk-GGUQP6KI.js";
-import "./chunk-L55PHMSR.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-A7BFDYCP.js.map