@koda-sl/baker-cli 0.525.0 → 0.526.0

package/dist/companies-4TOBU44J.js

@@ -0,0 +1,198 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-364TCROV.js";
+import {
+  TABLE_OUTPUT_FORMATS,
+  outputFormatRefusal,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-HPDGVK6R.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X3HPRECW.js";
+import {
+  linkedinCompaniesRequestSchema
+} from "./chunk-HVJJEQDQ.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-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import {
+  getEnv
+} from "./chunk-52IYZCRS.js";
+import "./chunk-FSGJSREN.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-4TOBU44J.js.map

package/dist/company-RK34S3IA.js

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

package/dist/complete-7BNBQ5AI.js

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

package/dist/config-GDLHHBJZ.js

@@ -0,0 +1,88 @@
+import {
+  handleError
+} from "./chunk-KRQ2AXFW.js";
+import "./chunk-D5FY4FAK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-HPDGVK6R.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ga4/config.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ga4.config",
+  description: "Read how a Google Analytics property is configured to measure: key events (conversions), custom dimensions and metrics, custom events, audiences, linked Google Ads accounts, data streams and the data retention window. Start here before staging any change \u2014 every id an update or removal targets comes from this, and `canWrite` says whether this connection may change anything at all. Compact by default; pass --full for the raw Analytics objects AND each website stream's enhanced measurement settings (the automatic events), which are the only way to see what is on before changing a toggle.",
+  args: {
+    "property-id": { type: "string", description: "GA4 property id (optional when one is connected)", required: false },
+    full: {
+      type: "boolean",
+      description: "Include the raw Analytics object for each entity, plus each website stream's enhanced measurement settings",
+      required: false
+    }
+  }
+});
+function configHints(config) {
+  const hints = [];
+  if (!config.canWrite) {
+    hints.push(
+      "This connection can READ this property but not change it. Do not promise to configure anything \u2014 ask the user to reconnect Google Analytics in the dashboard first, and carry on with the reporting side of the job."
+    );
+  }
+  if (config.keyEvents.length === 0) {
+    hints.push(
+      "This property has no key events, so nothing is being counted as a conversion and Google Ads has nothing to import. Ask what counts as a lead or sale before proposing anything else."
+    );
+  }
+  if (config.dataRetention.eventDataRetention === "TWO_MONTHS") {
+    hints.push(
+      "Event data is only kept for 2 months, which makes any long-window analysis impossible. `baker ga4 data-retention set --event-data 14` stages the fix."
+    );
+  }
+  if (config.dataStreams.filter((stream) => stream.type === "WEB_DATA_STREAM").length > 1) {
+    hints.push("This property has more than one website data stream \u2014 pass --data-stream when staging a custom event.");
+  }
+  return hints;
+}
+var configCommand = defineCommand({
+  meta: {
+    name: "config",
+    description: `Read how the property is configured to measure \u2014 key events, custom definitions, custom events, retention
+
+Examples:
+  baker ga4 config
+  baker ga4 config --property-id 123456789
+  baker ga4 config --full          # + the automatic events each website stream collects today`
+  },
+  args: {
+    "property-id": { type: "string", description: "GA4 property id", required: false },
+    full: {
+      type: "boolean",
+      description: "Include raw Analytics objects and enhanced measurement settings",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiPost("/api/ga4/config", {
+        ...typeof args["property-id"] === "string" ? { propertyId: args["property-id"] } : {},
+        ...args.full === true ? { full: true } : {}
+      });
+      writeJsonEnvelope({ ok: true, data, hints: configHints(data) });
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+export {
+  configCommand,
+  configHints
+};
+//# sourceMappingURL=config-GDLHHBJZ.js.map