@koda-sl/baker-cli 0.542.0 → 0.544.0

package/dist/sources-VUKEO4WE.js

@@ -0,0 +1,457 @@
+import {
+  hubspotDefaultMapping,
+  hubspotTriggerInputSchema
+} from "./chunk-7IU4WGGY.js";
+import {
+  hubspotRefusal
+} from "./chunk-5RX473E3.js";
+import "./chunk-PFO26LK5.js";
+import "./chunk-GRQ2AXDX.js";
+import {
+  ConversionArgsError,
+  onlyOnce
+} from "./chunk-IHZUSAUX.js";
+import "./chunk-PILLZPNC.js";
+import {
+  SOURCE_FIELD_NAMES,
+  mappingRowProblem,
+  templateMentions
+} from "./chunk-NKQWDEB7.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MGWAZXY6.js";
+import "./chunk-CMXG4X3S.js";
+import {
+  HUBSPOT_DEAL_CONTACTS,
+  HUBSPOT_OBJECTS,
+  REJECTION_MESSAGES,
+  readsAssociatedContact,
+  validateEventName
+} from "./chunk-NFXW6C6I.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-TI4UL56R.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/analytics/sources.ts
+import { defineCommand } from "citty";
+var args = {
+  server: {
+    type: "boolean",
+    description: "The client's own server door: one address for their developers, made once and the same for ever after, counting at once in Baker's own format (`baker analytics sending-events` has the contract). Prints it; nothing else to set",
+    required: false
+  },
+  create: {
+    type: "boolean",
+    description: "Make an address for a tool that cannot be told what to send (a CRM webhook, an automation step). Needs --name. Its first send is kept as a sample and counted as nothing until --map",
+    required: false
+  },
+  "create-hubspot": {
+    type: "boolean",
+    description: "Make a HubSpot event: HubSpot keeps each change to --property for Baker (Baker's app subscribes the account to that property with the condition as HubSpot's own filter, and nothing else), and every contact whose new value satisfies --operator --value is an event, counted within a minute. Needs --property (names, kinds and operators from `baker hubspot contacts properties`); --operator defaults to `is`; --value repeats for a list (`is` on a dropdown) or a between; --name is optional and defaults to the trigger's words; --field rows (names from `baker hubspot contacts fields`) replace the default rows they name. Counts from now on, never earlier contacts",
+    required: false
+  },
+  "create-activecampaign": {
+    type: "boolean",
+    description: "Make an ActiveCampaign event source: when this chat is published, ActiveCampaign's own webhook is set up on the account to send --events here, and each one counts as `activecampaign.<event>` (a contact subscribing is `activecampaign.subscribe`) from then on \u2014 a scheduled agent can run on any of them (`baker scheduled-agents create --trigger event.received --event activecampaign.deal_update`). --events defaults to subscribe,contact_tag_added,deal_add,deal_update; --name to ActiveCampaign; --account picks the connection when there are several. Removing the source takes the webhook off the account",
+    required: false
+  },
+  events: {
+    type: "string",
+    description: "With --create-activecampaign: ActiveCampaign's events, comma-separated \u2014 subscribe, unsubscribe, update, contact_tag_added, contact_tag_removed, subscriber_note, contact_task_add, sent, open, click, reply, forward, share, bounce, list_add, deal_add, deal_update, deal_note_add, deal_task_add, deal_task_complete, deal_pipeline_add, deal_stage_add, deal_tasktype_add, account_add, account_update, account_contact_add, account_contact_update",
+    required: false
+  },
+  account: {
+    type: "string",
+    description: "With --create-activecampaign: which ActiveCampaign connection, by id, when the company has more than one (the refusal lists them)",
+    required: false
+  },
+  "set-trigger": {
+    type: "boolean",
+    description: "Change what a HubSpot event watches. Needs --source and the same --property --operator --value as --create-hubspot. The rows stay; it counts from now on under the new trigger",
+    required: false
+  },
+  preview: {
+    type: "boolean",
+    description: "Ask HubSpot what --property --operator --value would count today, and read one real contact \u2014 the one most recently there, or --contact \u2014 with the properties the --field rows mention (the defaults when none), to check every row against real data BEFORE --create-hubspot. Makes nothing",
+    required: false
+  },
+  object: {
+    type: "string",
+    description: "With --create-hubspot or --preview: what the trigger is on \u2014 `contact` (the default), `deal` or `lead`. A deal's and a lead's event is about the contact the record is associated with: its rows read the record's own properties bare ({{amount}}, {{dealstage}}, {{hs_pipeline_stage}}) and the contact's as {{contact.<name>}} (`baker hubspot deals fields` / `baker hubspot leads fields`). A deal's amount defaults to its own amount in its currency; a lead has none, so it counts the step rather than money. Use `lead` for qualification and disqualification \u2014 HubSpot records both as a lead stage, and nothing on the contact or the deal says a lead was disqualified",
+    required: false
+  },
+  contacts: {
+    type: "string",
+    description: "With --object deal or --object lead (on --create-hubspot or --set-trigger): whose event it is \u2014 `every` (the default: every contact on the record, each its own event; on a deal each worth the deal's amount) or `first` (the record's first contact only)",
+    required: false
+  },
+  property: {
+    type: "string",
+    description: "With --create-hubspot, --set-trigger or --preview: the property to watch, by HubSpot's internal name (lifecyclestage, hs_lead_status, a custom one on a contact; dealstage, amount, closedate on a deal; hs_pipeline_stage, hs_lead_label on a lead) \u2014 any property, whatever its kind",
+    required: false
+  },
+  operator: {
+    type: "string",
+    description: "With --property: how the property has to read. By the property's kind \u2014 select: is, isNot, isEmpty, isNotEmpty \xB7 text: is, isNot, contains, doesNotContain, startsWith, endsWith, isEmpty, isNotEmpty \xB7 number: equal, notEqual, lessThan, lessThanOrEqual, greaterThan, greaterThanOrEqual, isEmpty, isNotEmpty \xB7 date: is, isBefore, isAfter, isOnOrBefore, isOnOrAfter, isBetween, isEmpty, isNotEmpty \xB7 yes/no: is, isNot. `is` when unsaid",
+    required: false
+  },
+  value: {
+    type: "string",
+    description: "With --property: the value, as HubSpot spells it \u2014 a dropdown's internal value (customer, QUALIFIED\u2026), a number, a YYYY-MM-DD, true/false. Repeat it for a list (--value lead --value customer) or the two ends of isBetween; none for isEmpty / isNotEmpty",
+    required: false
+  },
+  conditions: {
+    type: "string",
+    description: 'With --create-hubspot, --set-trigger or --preview, instead of --property/--operator/--value: several conditions combined the way a Form\'s filter combines them, as JSON \u2014 `{"logic":"And","conditions":[{"property":"lifecyclestage","values":["customer"]},{"logic":"Or","conditions":[{"property":"country","values":["Spain"]},{"property":"amount","operator":"greaterThan","values":["1000"]}]}]}`. `logic` is And (every row) or Or (any row); a row is a condition or a group with its own logic, one level deep; at most 10 conditions. The event fires when a change to any named property makes the whole combination hold',
+    required: false
+  },
+  contact: {
+    type: "string",
+    description: "With --preview: the record to draw the sample from \u2014 a HubSpot id, or text to search (an email or a name for a contact, a deal's or a lead's name). The one most recently satisfying the trigger when unsaid",
+    required: false
+  },
+  "amount-property": {
+    type: "string",
+    description: "With --create-hubspot or --set-amount: a NUMBER property of the watched object to read as the event's amount (a deal value synced onto the contact; a deal's own `amount` is read by default on a deal). Needs --currency beside it",
+    required: false
+  },
+  currency: {
+    type: "string",
+    description: "With --amount-property: the three-letter currency the property is in, like EUR or USD",
+    required: false
+  },
+  "set-amount": {
+    type: "boolean",
+    description: "Change where a HubSpot-read source takes its amount from. Needs --source; with --amount-property and --currency it reads them, with neither it stops reading an amount",
+    required: false
+  },
+  backfill: {
+    type: "boolean",
+    description: "Count a HubSpot event's history: every moment its trigger came to hold since --since, at the instant HubSpot says it did. Needs --source and --since. Nothing is invented \u2014 a record that merely satisfies the trigger today is not an event today, and only moments HubSpot has a timestamp for are counted. Dry without --write. Reach for it when an event was made after the deals it should have counted, or after fixing one that was refusing everything it received",
+    required: false
+  },
+  since: {
+    type: "string",
+    description: "With --backfill: the date to count this event's history from, `2026-09-19` or an ISO instant. At most 400 days back \u2014 the store keeps no more",
+    required: false
+  },
+  before: {
+    type: "string",
+    description: "With --backfill: carry on from where a capped run stopped, by passing back the `reachedBack` it returned. One run reads at most 500 records, most recently changed first, so a capped run has covered the newest and the rest are the ones nearest --since \u2014 narrowing --since cannot reach them, this can. Repeat until `capped` is false; nothing is counted twice. It bounds which records are read, never which of their moments count: those are still the whole of --since to now",
+    required: false
+  },
+  write: {
+    type: "boolean",
+    description: "With --backfill: actually count what it found. Without it nothing is counted and the answer says what would be. Events inside the last 72 hours are uploaded to this event's ad platforms within minutes of counting, which spends real budget",
+    required: false
+  },
+  name: {
+    type: "string",
+    description: "The tool the source is for \u2014 HubSpot, Zapier, Stripe. It is the event's name when the payload does not say one, and every event it sends carries it as `baker_source`",
+    required: false
+  },
+  map: {
+    type: "boolean",
+    description: "Set what each field is read from. For an address this starts counting; needs --source, and one --field per row. With no --field the guess is used, which is right for a tool already sending Baker's own format. For a HubSpot-read source it replaces the whole mapping (the row list is on the source as `mapping`; empty means HubSpot's standard properties), so repeat every row you want kept",
+    required: false
+  },
+  source: { type: "string", description: "The source id, from the list", required: false },
+  field: {
+    type: "string",
+    description: `<field>=<template>, repeatable. A template is text with {{path}} mentions, one thing per mention: --field email={{contact.email}} --field currency=EUR --field first_name="{{who.first}} {{who.last}}". A bare path (--field email=contact.email) is read as its mention when the sample has that path, so the short spelling still works. Fields: ${SOURCE_FIELD_NAMES.join(", ")}. An EXTRA PROPERTY of the event \u2014 a plan, a stage, anything Measure \u2192 Events should break it down by and a send may pass on to a platform \u2014 is --field properties.<name>=<template>, e.g. --field properties.plan={{plan_tier}}. Paths come from \`paths\` on the source's sample; for a HubSpot event they are contact property names (\`baker hubspot contacts fields\`) plus \`id\` for the contact id`,
+    required: false
+  },
+  pause: {
+    type: "boolean",
+    description: "Stop counting a source's arrivals; they are answered and dropped. Needs --source",
+    required: false
+  },
+  resume: { type: "boolean", description: "Count a paused source's arrivals again. Needs --source", required: false },
+  remove: {
+    type: "boolean",
+    description: "Delete a source; its address stops working at once. Needs --source",
+    required: false
+  },
+  full: {
+    type: "boolean",
+    description: "Also return each source's masked sample body. The paths and the guess are always returned; the body is only for reading what a path held",
+    required: false
+  }
+};
+registerSchema({
+  command: "analytics.sources",
+  description: "Where events reach Baker from a server: the client's own server door, HubSpot events Baker reads, and ActiveCampaign events its webhook sends \u2014 what each one watches and reads, and how it is doing",
+  args
+});
+function flagValueAt(argv, flag, index) {
+  const arg = argv[index] ?? "";
+  if (arg === flag) return argv[index + 1];
+  return arg.startsWith(`${flag}=`) ? arg.slice(flag.length + 1) : void 0;
+}
+function parseRepeated(argv, flag) {
+  const values = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = flagValueAt(argv, flag, index);
+    if (value !== void 0) values.push(value);
+  }
+  return values;
+}
+function parseFieldArgs(argv) {
+  const mapping = {};
+  for (const pair of parseRepeated(argv, "--field")) {
+    const eq = pair.indexOf("=");
+    const field = eq === -1 ? pair : pair.slice(0, eq);
+    const path = eq === -1 ? "" : pair.slice(eq + 1).trim();
+    const problem = mappingRowProblem(field);
+    if (problem !== null) throw new ConversionArgsError(problem);
+    if (path === "") throw new ConversionArgsError(`--field ${field} needs a path: --field ${field}=<dotted.path>.`);
+    mapping[field] = path;
+  }
+  return mapping;
+}
+function amountArgs(raw, argv) {
+  const amountProperty = onlyOnce(raw["amount-property"], "--amount-property", argv);
+  const currency = onlyOnce(raw.currency, "--currency", argv);
+  if (amountProperty === void 0 !== (currency === void 0)) {
+    throw new ConversionArgsError("--amount-property and --currency go together: name both or neither.");
+  }
+  return {
+    ...amountProperty === void 0 ? {} : { amountProperty },
+    ...currency === void 0 ? {} : { currency }
+  };
+}
+var NO_VALUE_OPERATORS = /* @__PURE__ */ new Set(["isEmpty", "isNotEmpty"]);
+function triggerArgs(raw, argv, verb) {
+  const conditions = onlyOnce(raw.conditions, "--conditions", argv);
+  if (conditions !== void 0) return conditionsArg(conditions, raw, verb);
+  const property = onlyOnce(raw.property, "--property", argv);
+  const operator = onlyOnce(raw.operator, "--operator", argv) ?? "is";
+  const values = argv.length === 0 && typeof raw.value === "string" ? [raw.value] : parseRepeated(argv, "--value");
+  if (property === void 0) {
+    throw new ConversionArgsError(
+      `--${verb} needs --property <name> [--operator <op>] --value <value>\u2026, from \`baker hubspot contacts properties\`.`
+    );
+  }
+  if (values.length === 0 && !NO_VALUE_OPERATORS.has(operator)) {
+    throw new ConversionArgsError(
+      `--${verb} needs --value <value> (repeat it for a list); only --operator isEmpty / isNotEmpty take none.`
+    );
+  }
+  return { property, operator, values };
+}
+function conditionsArg(text, raw, verb) {
+  if (raw.property !== void 0 || raw.value !== void 0 || raw.operator !== void 0) {
+    throw new ConversionArgsError(`--${verb} takes --conditions or --property/--operator/--value, not both.`);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    throw new ConversionArgsError(
+      '--conditions is JSON: {"logic":"And","conditions":[{"property":"lifecyclestage","values":["customer"]}]}.'
+    );
+  }
+  const checked = hubspotTriggerInputSchema.safeParse(parsed);
+  if (!checked.success) {
+    throw new ConversionArgsError(`--conditions: ${checked.error.issues.map((issue) => issue.message).join("; ")}`);
+  }
+  return parsed;
+}
+function objectArg(raw, argv) {
+  const object = onlyOnce(raw.object, "--object", argv) ?? "contact";
+  if (!HUBSPOT_OBJECTS.includes(object)) {
+    throw new ConversionArgsError(`--object is one of ${HUBSPOT_OBJECTS.join(", ")}, not "${object}".`);
+  }
+  return object;
+}
+function contactsArg(raw, argv) {
+  const contacts = onlyOnce(raw.contacts, "--contacts", argv);
+  if (contacts === void 0) return void 0;
+  if (!HUBSPOT_DEAL_CONTACTS.includes(contacts)) {
+    throw new ConversionArgsError(`--contacts is one of ${HUBSPOT_DEAL_CONTACTS.join(", ")}, not "${contacts}".`);
+  }
+  return contacts;
+}
+function createHubspotArgs(raw, argv, name) {
+  const mapping = parseFieldArgs(argv);
+  const object = objectArg(raw, argv);
+  const contacts = contactsArg(raw, argv);
+  if (contacts !== void 0 && !readsAssociatedContact(object)) {
+    throw new ConversionArgsError(
+      "--contacts says whose event a deal's or a lead's is; it needs --object deal or --object lead."
+    );
+  }
+  return {
+    // A contact is the wire's default, so it is left unsaid — the way the schema reads it back.
+    ...object === "contact" ? {} : { object },
+    trigger: triggerArgs(raw, argv, "create-hubspot"),
+    ...contacts === void 0 ? {} : { contacts },
+    ...name === void 0 ? {} : { name },
+    ...Object.keys(mapping).length === 0 ? {} : { mapping },
+    ...amountArgs(raw, argv)
+  };
+}
+function previewArgs(raw, argv) {
+  const rows = parseFieldArgs(argv);
+  const object = objectArg(raw, argv);
+  const templates = Object.values(Object.keys(rows).length === 0 ? hubspotDefaultMapping("", object) : rows);
+  const properties = [...new Set(templates.flatMap((template) => templateMentions(template ?? "")))];
+  const contact = onlyOnce(raw.contact, "--contact", argv);
+  return {
+    ...object === "contact" ? {} : { object },
+    trigger: triggerArgs(raw, argv, "preview"),
+    properties,
+    ...contact === void 0 ? {} : { contact }
+  };
+}
+var VERBS = [
+  "server",
+  "create",
+  "create-hubspot",
+  "create-activecampaign",
+  "set-trigger",
+  "preview",
+  "backfill",
+  "set-amount",
+  "map",
+  "pause",
+  "resume",
+  "remove"
+];
+function checkedName(raw, argv) {
+  const name = onlyOnce(raw.name, "--name", argv);
+  if (name === void 0 || validateEventName(name) === null) return name;
+  throw new ConversionArgsError(
+    `"${name}" cannot be an event name, and the name is what every event this source raises will carry. ${REJECTION_MESSAGES.invalid_name}`
+  );
+}
+function backfillArgs(raw, argv, sourceId) {
+  const since = onlyOnce(raw.since, "--since", argv);
+  if (since === void 0) {
+    throw new ConversionArgsError(
+      "--backfill needs --since <date>, e.g. --since 2026-09-19. Nothing before it is read."
+    );
+  }
+  const before = onlyOnce(raw.before, "--before", argv);
+  return {
+    sourceId,
+    since,
+    ...before === void 0 ? {} : { before },
+    ...raw.write === true ? { write: true } : {}
+  };
+}
+function createActiveCampaignArgs(raw, argv, name) {
+  const events = onlyOnce(raw.events, "--events", argv);
+  const account = onlyOnce(raw.account, "--account", argv);
+  return {
+    ...name === void 0 ? {} : { name },
+    ...events === void 0 ? {} : {
+      events: events.split(",").map((item) => item.trim()).filter((item) => item !== "")
+    },
+    ...account === void 0 ? {} : { account }
+  };
+}
+function createRequest(verb, raw, argv, name) {
+  if (verb === "create") {
+    if (name === void 0) throw new ConversionArgsError("--create needs --name <tool>.");
+    return { create: { name } };
+  }
+  if (verb === "create-hubspot") return { createHubspot: createHubspotArgs(raw, argv, name) };
+  if (verb === "create-activecampaign") return { createActiveCampaign: createActiveCampaignArgs(raw, argv, name) };
+  return null;
+}
+function sourcesRequest(raw, argv) {
+  const name = checkedName(raw, argv);
+  const source = onlyOnce(raw.source, "--source", argv);
+  const verbs = VERBS.filter((verb2) => raw[verb2] === true);
+  if (verbs.length > 1) throw new ConversionArgsError(`One of --${verbs.join(", --")} per call.`);
+  const verb = verbs[0];
+  if (verb === void 0) return {};
+  if (verb === "server") return { server: {} };
+  const made = createRequest(verb, raw, argv, name);
+  if (made !== null) return made;
+  if (verb === "preview") return { preview: previewArgs(raw, argv) };
+  if (source === void 0) throw new ConversionArgsError(`--${verb} needs --source <id>, from the list.`);
+  if (verb === "backfill") return { backfill: backfillArgs(raw, argv, source) };
+  if (verb === "set-trigger") {
+    const contacts = contactsArg(raw, argv);
+    return {
+      setTrigger: {
+        sourceId: source,
+        trigger: triggerArgs(raw, argv, verb),
+        ...contacts === void 0 ? {} : { contacts }
+      }
+    };
+  }
+  if (verb === "set-amount") return { setAmount: { sourceId: source, ...amountArgs(raw, argv) } };
+  if (verb === "map") return { map: { sourceId: source, mapping: parseFieldArgs(argv) } };
+  return { [verb]: { sourceId: source } };
+}
+function handleError(err) {
+  if (err instanceof ApiError) {
+    const refusal = hubspotRefusal(err.code, err.message);
+    writeJsonEnvelope({
+      ok: false,
+      error: refusal === null ? { code: err.code, message: err.message } : { code: refusal.code, message: err.message, fix: refusal.fix }
+    });
+    process.exit(1);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+var sourcesCommand = defineCommand({
+  meta: {
+    name: "sources",
+    description: 'Where events reach Baker from a server, and what each one reads. Two doors. **The client\'s own server**: `--server` prints one address for their developers \u2014 made once, the same for ever, counting at once, Baker\'s own `POST /v1/events` format (`baker analytics sending-events` has the contract, `X-Baker-Mode: test` rehearses). **HubSpot events**: HubSpot keeps each change to a watched property in a journal Baker reads every half minute \u2014 Baker\'s app subscribes the account to that one property with the condition as HubSpot\'s own filter, so an account with a million contacts costs nothing to watch \u2014 on every plan, nothing to set up in HubSpot. The trigger is *when a contact\'s* property satisfies a condition \u2014 the same conditions a Form\'s filters take: `--property lifecyclestage --value customer` (a dropdown; `--value lead --value customer` for either), `--property deal_value --operator greaterThan --value 1000`, `--property email --operator endsWith --value @acme.com`, `--property closed_at --operator isAfter --value 2026-01-01`, `--property phone --operator isEmpty`. Several conditions combine the way a Form\'s filter does \u2014 `--conditions \'{"logic":"And","conditions":[{"property":"lifecyclestage","values":["customer"]},{"property":"country","values":["Spain"]}]}\'` (AND / OR, groups one level deep, 10 conditions at most) in place of --property/--operator/--value, on --create-hubspot, --set-trigger and --preview; the event fires when a change to any named property makes the whole combination hold. `baker hubspot contacts properties` lists every property with its kind, the operators that kind takes and a dropdown\'s values; `baker hubspot contacts fields` every property a row can read. `--preview --property \u2026 [--operator \u2026] --value \u2026 [--field \u2026] [--contact <id or email>]` says how many contacts satisfy it today (NOT counted \u2014 only contacts that come to satisfy it from now on are) and reads one real contact so every row can be checked against real data; then `--create-hubspot --property \u2026 --value \u2026 --name "Deal won" --field email={{work_email}} --field value={{deal_value}} --field currency=EUR` makes the event, rows over the defaults (email, phone, the contact id, name, address, hs_google_click_id, hs_facebook_click_id). `--set-trigger --source <id> --property \u2026 --operator \u2026 --value \u2026` changes what an event watches later (rows kept, counting from now on). Every row is a template \u2014 text with {{property}} mentions, one thing per mention; `--map --source <id> --field \u2026` replaces the whole row set later, `--amount-property <number property> --currency EUR` is the short spelling for the amount rows. Each event is an ordinary event named after the source, carrying `baker_source`, listed by `feed --source <name>`, counted with `conversions` under `page:<name>`, and sent to the ad platforms with `sends`. **ActiveCampaign events**: `--create-activecampaign [--events subscribe,deal_update] [--name \u2026] [--account <id>]` stages a source that the ActiveCampaign webhook sends to once the chat is published; each arrival is an event called `activecampaign.<event>` \u2014 whatever the source is called \u2014 carrying the contact and the rest of the ActiveCampaign payload as `properties.*` (the stage of a deal, the tag, the campaign), which is what a scheduled agent on `event.received --event activecampaign.<event>` runs on. `--pause`, `--resume`, `--remove` by --source; removing an ActiveCampaign source deletes its webhook. `--create --name <tool>` still makes an address for a tool that cannot be told what to send; its first send is a masked sample counted as nothing until `--map` confirms the rows.'
+  },
+  args,
+  run: async ({ args: raw }) => {
+    try {
+      const request = sourcesRequest(raw, process.argv);
+      const response = await apiPost("/api/analytics/sources", request);
+      const full = raw.full === true;
+      const sources = response.data.sources.map((source) => {
+        const { sample, ...rest } = source;
+        return full || sample === void 0 ? source : { ...rest, sample: { receivedAt: sample.receivedAt } };
+      });
+      writeJsonEnvelope({
+        ok: true,
+        data: {
+          sources,
+          ...response.data.preview === void 0 ? {} : { preview: response.data.preview },
+          ...response.data.staged === void 0 ? {} : { staged: response.data.staged }
+        },
+        ...response.hints && response.hints.length > 0 ? { hints: response.hints } : {}
+      });
+    } catch (err) {
+      if (err instanceof ConversionArgsError) {
+        handleError(new ApiError("VALIDATION_ERROR", err.message));
+      }
+      handleError(err);
+    }
+  }
+});
+export {
+  parseFieldArgs,
+  parseRepeated,
+  sourcesCommand,
+  sourcesRequest
+};
+//# sourceMappingURL=sources-VUKEO4WE.js.map

package/dist/stale-PSJNR6EY.js

@@ -0,0 +1,90 @@
+import {
+  staleCreatives
+} from "./chunk-GFBEO33K.js";
+import "./chunk-TNZUMU55.js";
+import "./chunk-LUIV5R2Z.js";
+import "./chunk-6REXNFPV.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-GN7K3NPI.js";
+import "./chunk-PKZA7XCB.js";
+import "./chunk-RJS47NTI.js";
+import "./chunk-7RXR34EN.js";
+import "./chunk-C4EE6LIF.js";
+import "./chunk-Z7BNOHTY.js";
+import "./chunk-RHEWQB5O.js";
+import "./chunk-4GLSV5AI.js";
+import "./chunk-3BI2PHW4.js";
+import "./chunk-NBWZVBDG.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-NGQ5J4FV.js";
+import "./chunk-VWOKPC3T.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-BGT5ZA4L.js";
+import "./chunk-JY3OJBKZ.js";
+import "./chunk-XYNQMRNX.js";
+import "./chunk-TARINRA4.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-RP36XHWT.js";
+import "./chunk-KIXVHP2C.js";
+import "./chunk-4D73PLXU.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-JF2XP76K.js";
+import "./chunk-SYLPRIFM.js";
+import "./chunk-XBR7TSZN.js";
+import "./chunk-DGUN7FUH.js";
+import "./chunk-NFXW6C6I.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-TI4UL56R.js";
+import "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import {
+  optionalTurnId
+} from "./chunk-E54435XT.js";
+import {
+  registerSchema
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/stale.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "List the creatives edited since their last render in this workspace: what the models would be sent (the projected canvas, prompt.json without its `reference`/`source_context`/`notes` bookkeeping, scenes/*.json, the compositions it renders, the formats in _definition.md) no longer matches what the last completed `baker canvas run` drew, so the preview shows an older creative. Reformatting a file is not an edit. Read-only, offline and free. During a turn, re-render each one listed that the person should see with `baker canvas run <canvasPath>`. During a publish, never: Publish ships the last version the person was shown. Creatives never rendered here and half-built ones (unfilled [TODO] asset slots) are not listed. An entry with `refusedThisTurn` cannot be rendered again in this chat turn (it is ready, or had its renders or its time): do not run it; show the version it has and let the person's next message say what changes.";
+registerSchema({ command: "canvas.stale", description: DESCRIPTION, args: {} });
+var staleCommand = defineCommand({
+  meta: {
+    name: "stale",
+    description: DESCRIPTION
+  },
+  args: {},
+  async run() {
+    const cwd = process.cwd();
+    const stale = await staleCreatives(findWorkspaceRoot(cwd) ?? cwd, optionalTurnId());
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          ok: true,
+          data: { stale },
+          ...stale.length > 0 ? {
+            hints: stale.map(
+              (c) => c.refusedThisTurn ? `No render of ${c.slug} in this turn: ${c.refusedThisTurn}` : `Re-render ${c.slug} before showing it (never during a publish): baker canvas run ${c.canvasPath}`
+            )
+          } : {}
+        },
+        null,
+        2
+      )}
+`
+    );
+  }
+});
+export {
+  staleCommand
+};
+//# sourceMappingURL=stale-PSJNR6EY.js.map

package/dist/stats-ROWGFLUZ.js

@@ -0,0 +1,34 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/stats/index.ts
+import { defineCommand } from "citty";
+var statsCommand = defineCommand({
+  meta: {
+    name: "stats",
+    description: `X Ads analytics. Sync (\u22647 days, no segmentation) or async jobs (\u226490 days, segmentable).
+
+Subcommands:
+  sync         \u2014 synchronous stats (max 7 days). Cheapest, fastest.
+  job          \u2014 async stats job, end-to-end (creates + polls + downloads). Must run in the background.
+                 Use for ranges >7 days, segmented stats, or when sync limits are hit.
+  job-create   \u2014 low-level: create an async stats job and return the ID immediately
+  job-status   \u2014 low-level: poll job status / get the download URL
+
+Examples:
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+  baker ads x stats job --account-id 18ce53xyz --entity CAMPAIGN \\
+    --entity-ids abc,def --start-time 2026-04-01T00:00:00Z \\
+    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT,BILLING
+  baker ads x stats job-status --account-id 18ce53xyz --job-id abc`
+  },
+  subCommands: {
+    sync: () => import("./sync-QY2O4ISM.js").then((m) => m.statsSyncCommand),
+    job: () => import("./job-RB7LJI4W.js").then((m) => m.statsJobCommand),
+    "job-create": () => import("./job-create-OYJCLKZ5.js").then((m) => m.statsJobCreateCommand),
+    "job-status": () => import("./job-status-NTQWCQBZ.js").then((m) => m.statsJobStatusCommand)
+  }
+});
+export {
+  statsCommand
+};
+//# sourceMappingURL=stats-ROWGFLUZ.js.map

package/dist/status-SJKGPDXC.js

@@ -0,0 +1,65 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-CMXG4X3S.js";
+import "./chunk-NFXW6C6I.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-TI4UL56R.js";
+import {
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import {
+  getEnv
+} from "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/status.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.status",
+  description: "Resolve one or more Work Action refs by real action ID or temp_* ref in a single batch call. When BAKER_CHAT_ID is set, a temp_* ref still staged in THIS chat resolves to status 'draft' (not 'not_found') \u2014 staged ops only become published actions on chat publish.",
+  args: {
+    ref: {
+      type: "positional",
+      description: "One or more action refs: real action IDs or temp_* refs (space-separated)",
+      required: true
+    }
+  }
+});
+var statusCommand = defineCommand({
+  meta: {
+    name: "status",
+    description: "Resolve Work Action refs by real ID or temp_* ref. Example: baker actions status temp_hero jx123"
+  },
+  args: {
+    ref: { type: "positional", description: "Action ID or temp_* ref; accepts multiple refs", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const refs = [args.ref, ...Array.isArray(args._) ? args._ : []].filter((ref) => typeof ref === "string").map((ref) => ref.trim()).filter(Boolean);
+      if (refs.length === 0) {
+        failValidation("At least one action ref is required.");
+      }
+      const { BAKER_CHAT_ID } = getEnv();
+      const body = BAKER_CHAT_ID ? { refs, chatId: BAKER_CHAT_ID } : { refs };
+      const response = await apiPost("/api/actions/status", body);
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  statusCommand
+};
+//# sourceMappingURL=status-SJKGPDXC.js.map