@koda-sl/baker-cli 0.538.0-dev.fc2958a1d → 0.539.0

package/dist/sources-S63224S7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/analytics/sources.ts"],"sourcesContent":["import { REJECTION_MESSAGES, validateEventName } from \"@baker/api/event-ingest\";\nimport {\n  HUBSPOT_DEAL_CONTACTS,\n  HUBSPOT_OBJECTS,\n  type HubspotDealContacts,\n  type HubspotObject,\n  hubspotDefaultMapping,\n  hubspotTriggerInputSchema,\n  mappingRowProblem,\n  readsAssociatedContact,\n  SOURCE_FIELD_NAMES,\n  type SourcesRequestInput,\n  type SourcesResponse,\n  templateMentions,\n} from \"@baker/api/event-sources\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\nimport { hubspotRefusal } from \"../hubspot/refusal.ts\";\nimport { ConversionArgsError, onlyOnce } from \"./conversionArgs.ts\";\n\n/**\n * `baker analytics sources` — an address for each of the client's own tools to\n * send events to, and what each one's payloads are read as.\n *\n * ## Why a URL and not a key\n *\n * `POST /v1/events` needs the sender to write code to our contract. A CRM's\n * webhook, an automation platform, a billing system cannot be told what to\n * send — they post what they post, to a URL, and set nothing else. A source\n * is that URL: the token in it is the whole credential, the first send\n * teaches Baker the shape, and a person confirms once which path is the\n * email, which the amount. From then on every arrival is an ordinary event.\n *\n * ## `--field` and `--value` repeat, and citty keeps only the last\n *\n * citty hands the LAST value of a repeated flag over as a plain string, so\n * `--field email=a --field value=b` would map `value` and silently drop\n * `email`, and `--value lead --value customer` would watch `customer` alone.\n * Both are read off `process.argv` instead, the way `conversions` reads its\n * repeats.\n */\n\nconst args = {\n  server: {\n    type: \"boolean\",\n    description:\n      \"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\",\n    required: false,\n  },\n  create: {\n    type: \"boolean\",\n    description:\n      \"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\",\n    required: false,\n  },\n  \"create-hubspot\": {\n    type: \"boolean\",\n    description:\n      \"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\",\n    required: false,\n  },\n  \"create-activecampaign\": {\n    type: \"boolean\",\n    description:\n      \"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 — 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\",\n    required: false,\n  },\n  events: {\n    type: \"string\",\n    description:\n      \"With --create-activecampaign: ActiveCampaign's events, comma-separated — 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\",\n    required: false,\n  },\n  account: {\n    type: \"string\",\n    description:\n      \"With --create-activecampaign: which ActiveCampaign connection, by id, when the company has more than one (the refusal lists them)\",\n    required: false,\n  },\n  \"set-trigger\": {\n    type: \"boolean\",\n    description:\n      \"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\",\n    required: false,\n  },\n  preview: {\n    type: \"boolean\",\n    description:\n      \"Ask HubSpot what --property --operator --value would count today, and read one real contact — the one most recently there, or --contact — with the properties the --field rows mention (the defaults when none), to check every row against real data BEFORE --create-hubspot. Makes nothing\",\n    required: false,\n  },\n  object: {\n    type: \"string\",\n    description:\n      \"With --create-hubspot or --preview: what the trigger is on — `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 — HubSpot records both as a lead stage, and nothing on the contact or the deal says a lead was disqualified\",\n    required: false,\n  },\n  contacts: {\n    type: \"string\",\n    description:\n      \"With --object deal or --object lead (on --create-hubspot or --set-trigger): whose event it is — `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)\",\n    required: false,\n  },\n  property: {\n    type: \"string\",\n    description:\n      \"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) — any property, whatever its kind\",\n    required: false,\n  },\n  operator: {\n    type: \"string\",\n    description:\n      \"With --property: how the property has to read. By the property's kind — select: is, isNot, isEmpty, isNotEmpty · text: is, isNot, contains, doesNotContain, startsWith, endsWith, isEmpty, isNotEmpty · number: equal, notEqual, lessThan, lessThanOrEqual, greaterThan, greaterThanOrEqual, isEmpty, isNotEmpty · date: is, isBefore, isAfter, isOnOrBefore, isOnOrAfter, isBetween, isEmpty, isNotEmpty · yes/no: is, isNot. `is` when unsaid\",\n    required: false,\n  },\n  value: {\n    type: \"string\",\n    description:\n      \"With --property: the value, as HubSpot spells it — a dropdown's internal value (customer, QUALIFIED…), 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\",\n    required: false,\n  },\n  conditions: {\n    type: \"string\",\n    description:\n      '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 — `{\"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',\n    required: false,\n  },\n  contact: {\n    type: \"string\",\n    description:\n      \"With --preview: the record to draw the sample from — 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\",\n    required: false,\n  },\n  \"amount-property\": {\n    type: \"string\",\n    description:\n      \"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\",\n    required: false,\n  },\n  currency: {\n    type: \"string\",\n    description: \"With --amount-property: the three-letter currency the property is in, like EUR or USD\",\n    required: false,\n  },\n  \"set-amount\": {\n    type: \"boolean\",\n    description:\n      \"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\",\n    required: false,\n  },\n  backfill: {\n    type: \"boolean\",\n    description:\n      \"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 — 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\",\n    required: false,\n  },\n  since: {\n    type: \"string\",\n    description:\n      \"With --backfill: the date to count this event's history from, `2026-09-19` or an ISO instant. At most 400 days back — the store keeps no more\",\n    required: false,\n  },\n  before: {\n    type: \"string\",\n    description:\n      \"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 — 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\",\n    required: false,\n  },\n  write: {\n    type: \"boolean\",\n    description:\n      \"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\",\n    required: false,\n  },\n  name: {\n    type: \"string\",\n    description:\n      \"The tool the source is for — 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`\",\n    required: false,\n  },\n  map: {\n    type: \"boolean\",\n    description:\n      \"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\",\n    required: false,\n  },\n  source: { type: \"string\", description: \"The source id, from the list\", required: false },\n  field: {\n    type: \"string\",\n    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 — a plan, a stage, anything Measure → Events should break it down by and a send may pass on to a platform — 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`,\n    required: false,\n  },\n  pause: {\n    type: \"boolean\",\n    description: \"Stop counting a source's arrivals; they are answered and dropped. Needs --source\",\n    required: false,\n  },\n  resume: { type: \"boolean\", description: \"Count a paused source's arrivals again. Needs --source\", required: false },\n  remove: {\n    type: \"boolean\",\n    description: \"Delete a source; its address stops working at once. Needs --source\",\n    required: false,\n  },\n  full: {\n    type: \"boolean\",\n    description:\n      \"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\",\n    required: false,\n  },\n} as const;\n\nregisterSchema({\n  command: \"analytics.sources\",\n  description:\n    \"Where events reach Baker from a server: the client's own server door, HubSpot events Baker reads, and ActiveCampaign events its webhook sends — what each one watches and reads, and how it is doing\",\n  args,\n});\n\n/** The value a repeated flag carries at this position, in either spelling, or nothing. */\nfunction flagValueAt(argv: readonly string[], flag: string, index: number): string | undefined {\n  const arg = argv[index] ?? \"\";\n  if (arg === flag) return argv[index + 1];\n  return arg.startsWith(`${flag}=`) ? arg.slice(flag.length + 1) : undefined;\n}\n\n/** Every value of a repeated flag on the command line, in order. */\nexport function parseRepeated(argv: readonly string[], flag: string): string[] {\n  const values: string[] = [];\n  for (let index = 0; index < argv.length; index += 1) {\n    const value = flagValueAt(argv, flag, index);\n    if (value !== undefined) values.push(value);\n  }\n  return values;\n}\n\n/** Every `--field k=v` on the command line, in order, refusing a malformed one. */\nexport function parseFieldArgs(argv: readonly string[]): Record<string, string> {\n  const mapping: Record<string, string> = {};\n  for (const pair of parseRepeated(argv, \"--field\")) {\n    const eq = pair.indexOf(\"=\");\n    const field = eq === -1 ? pair : pair.slice(0, eq);\n    const path = eq === -1 ? \"\" : pair.slice(eq + 1).trim();\n    const problem = mappingRowProblem(field);\n    if (problem !== null) throw new ConversionArgsError(problem);\n    if (path === \"\") throw new ConversionArgsError(`--field ${field} needs a path: --field ${field}=<dotted.path>.`);\n    mapping[field] = path;\n  }\n  return mapping;\n}\n\n/** The amount pair, which travels together or not at all. */\nfunction amountArgs(raw: Record<string, unknown>, argv: readonly string[]) {\n  const amountProperty = onlyOnce(raw[\"amount-property\"], \"--amount-property\", argv);\n  const currency = onlyOnce(raw.currency, \"--currency\", argv);\n  if ((amountProperty === undefined) !== (currency === undefined)) {\n    throw new ConversionArgsError(\"--amount-property and --currency go together: name both or neither.\");\n  }\n  return {\n    ...(amountProperty === undefined ? {} : { amountProperty }),\n    ...(currency === undefined ? {} : { currency }),\n  };\n}\n\nconst NO_VALUE_OPERATORS = new Set([\"isEmpty\", \"isNotEmpty\"]);\n\n/**\n * The trigger every HubSpot verb needs: the property, how it has to read,\n * and the values — repeated on the command line, read off argv. Refused with\n * where the names come from; what the property's kind allows is checked\n * against the account by the backend.\n */\nfunction triggerArgs(raw: Record<string, unknown>, argv: readonly string[], verb: string): TriggerInput {\n  const conditions = onlyOnce(raw.conditions, \"--conditions\", argv);\n  if (conditions !== undefined) return conditionsArg(conditions, raw, verb);\n  const property = onlyOnce(raw.property, \"--property\", argv);\n  const operator = onlyOnce(raw.operator, \"--operator\", argv) ?? \"is\";\n  // The last --value is what citty kept; every one is what was typed.\n  const values = argv.length === 0 && typeof raw.value === \"string\" ? [raw.value] : parseRepeated(argv, \"--value\");\n  if (property === undefined) {\n    throw new ConversionArgsError(\n      `--${verb} needs --property <name> [--operator <op>] --value <value>…, from \\`baker hubspot contacts properties\\`.`,\n    );\n  }\n  if (values.length === 0 && !NO_VALUE_OPERATORS.has(operator)) {\n    throw new ConversionArgsError(\n      `--${verb} needs --value <value> (repeat it for a list); only --operator isEmpty / isNotEmpty take none.`,\n    );\n  }\n  return { property, operator, values };\n}\n\ntype TriggerInput = NonNullable<SourcesRequestInput[\"createHubspot\"]>[\"trigger\"];\n\n/** `--conditions <json>`: a combination, checked for shape here so a typo is refused before the call. */\nfunction conditionsArg(text: string, raw: Record<string, unknown>, verb: string): TriggerInput {\n  if (raw.property !== undefined || raw.value !== undefined || raw.operator !== undefined) {\n    throw new ConversionArgsError(`--${verb} takes --conditions or --property/--operator/--value, not both.`);\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text);\n  } catch {\n    throw new ConversionArgsError(\n      '--conditions is JSON: {\"logic\":\"And\",\"conditions\":[{\"property\":\"lifecyclestage\",\"values\":[\"customer\"]}]}.',\n    );\n  }\n  const checked = hubspotTriggerInputSchema.safeParse(parsed);\n  if (!checked.success) {\n    throw new ConversionArgsError(`--conditions: ${checked.error.issues.map((issue) => issue.message).join(\"; \")}`);\n  }\n  return parsed as TriggerInput;\n}\n\n/** `--object contact|deal`, spelled the two ways the wire takes and nothing else. */\nfunction objectArg(raw: Record<string, unknown>, argv: readonly string[]): HubspotObject {\n  const object = onlyOnce(raw.object, \"--object\", argv) ?? \"contact\";\n  if (!(HUBSPOT_OBJECTS as readonly string[]).includes(object)) {\n    throw new ConversionArgsError(`--object is one of ${HUBSPOT_OBJECTS.join(\", \")}, not \"${object}\".`);\n  }\n  return object as HubspotObject;\n}\n\n/** `--contacts first|every`, which only means something on a deal or a lead. */\nfunction contactsArg(raw: Record<string, unknown>, argv: readonly string[]): HubspotDealContacts | undefined {\n  const contacts = onlyOnce(raw.contacts, \"--contacts\", argv);\n  if (contacts === undefined) return undefined;\n  if (!(HUBSPOT_DEAL_CONTACTS as readonly string[]).includes(contacts)) {\n    throw new ConversionArgsError(`--contacts is one of ${HUBSPOT_DEAL_CONTACTS.join(\", \")}, not \"${contacts}\".`);\n  }\n  return contacts as HubspotDealContacts;\n}\n\nfunction createHubspotArgs(\n  raw: Record<string, unknown>,\n  argv: readonly string[],\n  name: string | undefined,\n): NonNullable<SourcesRequestInput[\"createHubspot\"]> {\n  const mapping = parseFieldArgs(argv);\n  const object = objectArg(raw, argv);\n  const contacts = contactsArg(raw, argv);\n  if (contacts !== undefined && !readsAssociatedContact(object)) {\n    throw new ConversionArgsError(\n      \"--contacts says whose event a deal's or a lead's is; it needs --object deal or --object lead.\",\n    );\n  }\n  return {\n    // A contact is the wire's default, so it is left unsaid — the way the schema reads it back.\n    ...(object === \"contact\" ? {} : { object }),\n    trigger: triggerArgs(raw, argv, \"create-hubspot\"),\n    ...(contacts === undefined ? {} : { contacts }),\n    ...(name === undefined ? {} : { name }),\n    ...(Object.keys(mapping).length === 0 ? {} : { mapping }),\n    ...amountArgs(raw, argv),\n  };\n}\n\n/** What to read off the sample contact: whatever the rows mention, or the default rows' properties. */\nfunction previewArgs(\n  raw: Record<string, unknown>,\n  argv: readonly string[],\n): NonNullable<SourcesRequestInput[\"preview\"]> {\n  const rows = parseFieldArgs(argv);\n  const object = objectArg(raw, argv);\n  const templates = Object.values(Object.keys(rows).length === 0 ? hubspotDefaultMapping(\"\", object) : rows);\n  const properties = [...new Set(templates.flatMap((template) => templateMentions(template ?? \"\")))];\n  const contact = onlyOnce(raw.contact, \"--contact\", argv);\n  return {\n    ...(object === \"contact\" ? {} : { object }),\n    trigger: triggerArgs(raw, argv, \"preview\"),\n    properties,\n    ...(contact === undefined ? {} : { contact }),\n  };\n}\n\nconst VERBS = [\n  \"server\",\n  \"create\",\n  \"create-hubspot\",\n  \"create-activecampaign\",\n  \"set-trigger\",\n  \"preview\",\n  \"backfill\",\n  \"set-amount\",\n  \"map\",\n  \"pause\",\n  \"resume\",\n  \"remove\",\n] as const;\n\n/**\n * The name, refused here when the ingest door could never accept it.\n *\n * A source's name is the `event_name` of every event it raises, so this is\n * not a label being tidied: a name outside the rule makes a source that\n * counts **nothing**, for ever, while `baker analytics sources` goes on\n * listing it as counting and the only trace is one red line per event on the\n * feed. The contract refuses it too (`sourceNameSchema`), but that comes back\n * as a wire-validation error; the agent is better served by the sentence.\n */\nfunction checkedName(raw: Record<string, unknown>, argv: readonly string[]): string | undefined {\n  const name = onlyOnce(raw.name, \"--name\", argv);\n  if (name === undefined || validateEventName(name) === null) return name;\n  throw new ConversionArgsError(\n    `\"${name}\" cannot be an event name, and the name is what every event this source raises will carry. ${REJECTION_MESSAGES.invalid_name}`,\n  );\n}\n\n/** What a backfill reads back to, and whether it counts what it finds. */\nfunction backfillArgs(\n  raw: Record<string, unknown>,\n  argv: readonly string[],\n  sourceId: string,\n): NonNullable<SourcesRequestInput[\"backfill\"]> {\n  const since = onlyOnce(raw.since, \"--since\", argv);\n  if (since === undefined) {\n    throw new ConversionArgsError(\n      \"--backfill needs --since <date>, e.g. --since 2026-09-19. Nothing before it is read.\",\n    );\n  }\n  const before = onlyOnce(raw.before, \"--before\", argv);\n  return {\n    sourceId,\n    since,\n    ...(before === undefined ? {} : { before }),\n    ...(raw.write === true ? { write: true } : {}),\n  };\n}\n\nfunction createActiveCampaignArgs(\n  raw: Record<string, unknown>,\n  argv: readonly string[],\n  name: string | undefined,\n): NonNullable<SourcesRequestInput[\"createActiveCampaign\"]> {\n  const events = onlyOnce(raw.events, \"--events\", argv);\n  const account = onlyOnce(raw.account, \"--account\", argv);\n  return {\n    ...(name === undefined ? {} : { name }),\n    ...(events === undefined\n      ? {}\n      : {\n          events: events\n            .split(\",\")\n            .map((item) => item.trim())\n            .filter((item) => item !== \"\"),\n        }),\n    ...(account === undefined ? {} : { account }),\n  };\n}\n\n/** The three ways to make a source: an address for a tool, a HubSpot event, ActiveCampaign events. */\nfunction createRequest(\n  verb: (typeof VERBS)[number],\n  raw: Record<string, unknown>,\n  argv: readonly string[],\n  name: string | undefined,\n): SourcesRequestInput | null {\n  if (verb === \"create\") {\n    if (name === undefined) throw new ConversionArgsError(\"--create needs --name <tool>.\");\n    return { create: { name } };\n  }\n  if (verb === \"create-hubspot\") return { createHubspot: createHubspotArgs(raw, argv, name) };\n  if (verb === \"create-activecampaign\") return { createActiveCampaign: createActiveCampaignArgs(raw, argv, name) };\n  return null;\n}\n\nexport function sourcesRequest(raw: Record<string, unknown>, argv: readonly string[]): SourcesRequestInput {\n  const name = checkedName(raw, argv);\n  const source = onlyOnce(raw.source, \"--source\", argv);\n  const verbs = VERBS.filter((verb) => raw[verb] === true);\n  if (verbs.length > 1) throw new ConversionArgsError(`One of --${verbs.join(\", --\")} per call.`);\n  const verb = verbs[0];\n  if (verb === undefined) return {};\n  if (verb === \"server\") return { server: {} };\n  const made = createRequest(verb, raw, argv, name);\n  if (made !== null) return made;\n  if (verb === \"preview\") return { preview: previewArgs(raw, argv) };\n  if (source === undefined) throw new ConversionArgsError(`--${verb} needs --source <id>, from the list.`);\n  if (verb === \"backfill\") return { backfill: backfillArgs(raw, argv, source) };\n  if (verb === \"set-trigger\") {\n    const contacts = contactsArg(raw, argv);\n    return {\n      setTrigger: {\n        sourceId: source,\n        trigger: triggerArgs(raw, argv, verb),\n        ...(contacts === undefined ? {} : { contacts }),\n      },\n    };\n  }\n  if (verb === \"set-amount\") return { setAmount: { sourceId: source, ...amountArgs(raw, argv) } };\n  if (verb === \"map\") return { map: { sourceId: source, mapping: parseFieldArgs(argv) } };\n  return { [verb]: { sourceId: source } };\n}\n\nfunction handleError(err: unknown): never {\n  if (err instanceof ApiError) {\n    // A HubSpot event needs HubSpot connected, and allowed to read what it watches.\n    const refusal = hubspotRefusal(err.code, err.message);\n    writeJsonEnvelope({\n      ok: false,\n      error:\n        refusal === null\n          ? { code: err.code, message: err.message }\n          : { code: refusal.code, message: err.message, fix: refusal.fix },\n    });\n    process.exit(1);\n  }\n  writeJsonEnvelope({\n    ok: false,\n    error: { code: \"NETWORK_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" },\n  });\n  process.exit(1);\n}\n\nexport const sourcesCommand = defineCommand({\n  meta: {\n    name: \"sources\",\n    description:\n      '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 — 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 — 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 — on every plan, nothing to set up in HubSpot. The trigger is *when a contact\\'s* property satisfies a condition — 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 — `--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 … [--operator …] --value … [--field …] [--contact <id or email>]` says how many contacts satisfy it today (NOT counted — 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 … --value … --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 … --operator … --value …` changes what an event watches later (rows kept, counting from now on). Every row is a template — text with {{property}} mentions, one thing per mention; `--map --source <id> --field …` 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 …] [--account <id>]` stages a source that the ActiveCampaign webhook sends to once the chat is published; each arrival is an event called `activecampaign.<event>` — whatever the source is called — 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.',\n  },\n  args,\n  run: async ({ args: raw }) => {\n    try {\n      const request = sourcesRequest(raw as Record<string, unknown>, process.argv);\n      const response = await apiPost<SourcesResponse>(\"/api/analytics/sources\", request);\n      const full = raw.full === true;\n      const sources = response.data.sources.map((source) => {\n        const { sample, ...rest } = source;\n        return full || sample === undefined ? source : { ...rest, sample: { receivedAt: sample.receivedAt } };\n      });\n      writeJsonEnvelope({\n        ok: true,\n        data: {\n          sources,\n          ...(response.data.preview === undefined ? {} : { preview: response.data.preview }),\n          ...(response.data.staged === undefined ? {} : { staged: response.data.staged }),\n        },\n        ...(response.hints && response.hints.length > 0 ? { hints: response.hints } : {}),\n      });\n    } catch (err) {\n      if (err instanceof ConversionArgsError) {\n        handleError(new ApiError(\"VALIDATION_ERROR\", err.message));\n      }\n      handleError(err);\n    }\n  },\n});\n"],"mappings":"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","names":["verb"]}

package/dist/stale-6BEHWQZ7.js

@@ -0,0 +1,90 @@
+import {
+  staleCreatives
+} from "./chunk-TNQJDM2P.js";
+import "./chunk-TQDZQT6U.js";
+import "./chunk-NJIRVF2B.js";
+import "./chunk-BBGKZJXP.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-GTIQUOYC.js";
+import "./chunk-R2VP7FK4.js";
+import "./chunk-GY6N42PE.js";
+import "./chunk-6EMVPPSQ.js";
+import "./chunk-LXV2U4MI.js";
+import "./chunk-A5PQYKVO.js";
+import "./chunk-YFIWCMVC.js";
+import "./chunk-WTYKTPZP.js";
+import "./chunk-CB7GZQVN.js";
+import "./chunk-2AJ5UNOF.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-NRMJWNX3.js";
+import "./chunk-W3PJ7V4W.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-CM2LECNX.js";
+import "./chunk-AMHVCMBW.js";
+import "./chunk-NQ5O2NCJ.js";
+import "./chunk-RW32BYY3.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-FSLSISPI.js";
+import "./chunk-GT76FWES.js";
+import "./chunk-4PWC4KAK.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-ZPF253G5.js";
+import "./chunk-AXSSATJW.js";
+import "./chunk-DNRXEP4A.js";
+import "./chunk-OYYAR5TD.js";
+import "./chunk-3LH5ANM4.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-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import {
+  optionalTurnId
+} from "./chunk-LBIF6FJY.js";
+import {
+  registerSchema
+} from "./chunk-TRXGJZDL.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-6BEHWQZ7.js.map

package/dist/status-MCMOSDVX.js

@@ -0,0 +1,65 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-THV7SMY6.js";
+import "./chunk-3LH5ANM4.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-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import {
+  getEnv
+} from "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.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-MCMOSDVX.js.map

package/dist/studio-4QOFG7MQ.js

@@ -0,0 +1,49 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/index.ts
+import { defineCommand } from "citty";
+var studioCommand = defineCommand({
+  meta: {
+    name: "studio",
+    description: `Make new imagery and clips. Every batch is recorded and shows up in the dashboard Studio for the client to review, labelled with this conversation.
+
+Make something:
+  baker studio generate <prompt> [--reference ids,paths,urls] [--model \u2026] [--aspect-ratio \u2026] [--count N]
+                                        Render 1-8 takes of one still; each is ingested into the media library as it lands
+  baker studio animate <prompt> --image <id|path|url,\u2026>
+                                        Turn a still into a clip \u2014 the prompt describes MOVEMENT, not the look
+  baker studio skills                   Craft directions you can pass to --skill
+  baker studio improve <prompt>         Sharpen a rough brief (use it for the CLIENT's words, not your own)
+
+Know what you can ask for:
+  baker studio models [--kind video] [--model <id>]
+                                        Per model: shapes, resolutions, clip lengths, prompt cap, reference limit, every knob
+
+Review and pick:
+  baker studio get <generationId>       One batch: every take, its url, whether it is in the library, why one failed
+  baker studio list [--kind image|video] [--all]
+                                        Recent batches for this conversation (--all = the whole company)
+  baker studio keep <generationId> --slot N
+                                        Mark the keeper. Stars an image; INGESTS a clip into the video library
+
+Three rules worth remembering:
+  - --reference is the biggest quality lever there is. Ground a render in a real logo, product shot or mood image.
+  - A clip is not usable anywhere until it is kept. Unkept takes are never ingested.
+  - The models disagree about what they accept, and a setting the chosen model does not have is REFUSED rather than ignored. Run baker studio models to answer "can this one do that".
+Full guide: __tooling__/docs/tools/baker/studio.md`
+  },
+  subCommands: {
+    generate: () => import("./generate-QG7GX6WO.js").then((m) => m.generateCommand),
+    animate: () => import("./animate-CQON6SZE.js").then((m) => m.animateCommand),
+    get: () => import("./get-TXVHONYI.js").then((m) => m.getCommand),
+    list: () => import("./list-AAQISQHE.js").then((m) => m.listCommand),
+    keep: () => import("./keep-ACLZB7KL.js").then((m) => m.keepCommand),
+    models: () => import("./models-EU3NO4IY.js").then((m) => m.modelsCommand),
+    skills: () => import("./skills-KV4X22KQ.js").then((m) => m.skillsCommand),
+    improve: () => import("./improve-BKFZOBXI.js").then((m) => m.improveCommand)
+  }
+});
+export {
+  studioCommand
+};
+//# sourceMappingURL=studio-4QOFG7MQ.js.map

package/dist/sync-WJCJHNET.js

@@ -0,0 +1,57 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-UT4OM34H.js";
+import {
+  testimonialSourcesSyncRequestSchema
+} from "./chunk-3LH5ANM4.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-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/sync.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.sources.sync",
+  description: "Import a review source's new reviews now. Only reviews newer than the last import are read where the site allows it.",
+  args: { id: { type: "string", description: "Source id from `testimonials sources list`", required: true } }
+});
+var syncCommand = defineCommand({
+  meta: {
+    name: "sync",
+    description: "Import a review source's new reviews now.\n\nExample: baker testimonials sources sync <source-id>"
+  },
+  args: { id: { type: "positional", description: "Source id from `testimonials sources list`", required: true } },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesSyncRequestSchema.safeParse({ id: String(args.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/sync", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: data.started ? void 0 : ["An import was already running for this source; nothing new was started."]
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  syncCommand
+};
+//# sourceMappingURL=sync-WJCJHNET.js.map

package/dist/sync-definition-THVMBGJR.js

@@ -0,0 +1,70 @@
+import {
+  buildDefinitionSyncPayload,
+  readDefinitionBody,
+  readDefinitionPlatforms,
+  readDefinitionSeriesPlace,
+  readDefinitionSourceFields,
+  readDefinitionStrategyFields,
+  readDefinitionTitle,
+  resolveCanvasPath,
+  syncCreativeDefinitionBestEffort,
+  syncDefinitionCommand
+} from "./chunk-5Y3EEI52.js";
+import "./chunk-H27R5IVQ.js";
+import "./chunk-TQDZQT6U.js";
+import "./chunk-NJIRVF2B.js";
+import "./chunk-BBGKZJXP.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-GTIQUOYC.js";
+import "./chunk-GY6N42PE.js";
+import "./chunk-6EMVPPSQ.js";
+import "./chunk-LXV2U4MI.js";
+import "./chunk-A5PQYKVO.js";
+import "./chunk-YFIWCMVC.js";
+import "./chunk-WTYKTPZP.js";
+import "./chunk-CB7GZQVN.js";
+import "./chunk-2AJ5UNOF.js";
+import "./chunk-NRMJWNX3.js";
+import "./chunk-W3PJ7V4W.js";
+import "./chunk-CM2LECNX.js";
+import "./chunk-NGXZQESA.js";
+import "./chunk-AMHVCMBW.js";
+import "./chunk-NQ5O2NCJ.js";
+import "./chunk-RW32BYY3.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-FSLSISPI.js";
+import "./chunk-GT76FWES.js";
+import "./chunk-4PWC4KAK.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-ZPF253G5.js";
+import "./chunk-AXSSATJW.js";
+import "./chunk-DNRXEP4A.js";
+import "./chunk-OYYAR5TD.js";
+import "./chunk-3LH5ANM4.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-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildDefinitionSyncPayload,
+  readDefinitionBody,
+  readDefinitionPlatforms,
+  readDefinitionSeriesPlace,
+  readDefinitionSourceFields,
+  readDefinitionStrategyFields,
+  readDefinitionTitle,
+  resolveCanvasPath,
+  syncCreativeDefinitionBestEffort,
+  syncDefinitionCommand
+};
+//# sourceMappingURL=sync-definition-THVMBGJR.js.map

package/dist/tags-AGFUJ2BB.js

@@ -0,0 +1,227 @@
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import {
+  TAG_IDENTIFYING_FIELD
+} from "./chunk-3LH5ANM4.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-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/tags/index.ts
+import { defineCommand } from "citty";
+
+// src/commands/tags/shared.ts
+function failApi(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  if (err instanceof Error) {
+    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function failValidation(message) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function renderConfigValue(value) {
+  return value.includes("\n") ? value.replace(/\n/g, "\n      ") : value;
+}
+function renderEffectiveEntry(entry) {
+  const parts = [entry.ref, entry.type];
+  if (entry.identifier !== void 0) {
+    parts.push(entry.identifier);
+  }
+  if (entry.staged !== void 0) {
+    parts.push(`[staged: ${entry.staged}]`);
+  }
+  const secretBits = [
+    ...entry.secretsSet.map((field) => `${field} \u2713 set`),
+    ...entry.secretsPending.map((field) => `${field} \u23F3 pending`)
+  ];
+  if (secretBits.length > 0) {
+    parts.push(`[secrets: ${secretBits.join(", ")}]`);
+  }
+  const header = parts.join("  ");
+  const identifyingField = TAG_IDENTIFYING_FIELD[entry.type];
+  const configLines = Object.entries(entry.config).filter(([key]) => key !== identifyingField).map(([key, value]) => `    ${key}: ${renderConfigValue(value)}`);
+  return configLines.length > 0 ? `${header}
+${configLines.join("\n")}` : header;
+}
+function tagsListHints() {
+  return [
+    "To create, edit or delete a tag, call the `request_tag_input` approval form (tool `mcp__baker_ui__request_tag_input`, server `baker_ui`) \u2014 it is attached to every turn of this chat and collects any secret values itself.",
+    "Don't conclude the form is unavailable from your tool list: call it, and report what it returns. And never file a tag change as a Task \u2014 a Task hands the user work this chat can stage in one call."
+  ];
+}
+
+// src/commands/tags/index.ts
+registerSchema({
+  command: "tags.list",
+  description: "Effective marketing tags for this chat: production tags overlaid with the changes staged in this chat. Prints each tag's readable config in full (secrets are never included) \u2014 e.g. the Clarity projectId, GA4 measurementId, or the entire custom `code` snippet \u2014 so reuse a stored value to pre-fill a follow-up change instead of asking the user for something we already have. The printed refs (tag ids or tag_temp_*) are exactly what flow side-effect tagIds should reference. Read-only \u2014 every tag change (create, edit, delete) goes through the request_tag_input approval tool; `baker tags unstage` takes back one this chat staged.",
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list", required: false }
+  }
+});
+async function listTags(json) {
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/tags/list", { chatId });
+    const hints = tagsListHints();
+    if (json) {
+      writeJson({ ok: true, data: response, hints });
+      return;
+    }
+    if (response.tags.length === 0) {
+      process.stdout.write("No tags configured.\n");
+    } else {
+      process.stdout.write(`${response.tags.map(renderEffectiveEntry).join("\n")}
+`);
+    }
+    for (const hint of hints) {
+      process.stderr.write(`${hint}
+`);
+    }
+  } catch (err) {
+    failApi(err);
+  }
+}
+var listArgs = {
+  json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
+};
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Effective tags for this chat (production + staged), with each tag's full readable config (secrets excluded) \u2014 reuse a stored value to pre-fill a change rather than asking the user. Refs printed here are what flow side-effect tagIds should use. Example: baker tags list"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    await listTags(args.json === true);
+  }
+});
+async function listDraft(chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/tags/draft", { chatId });
+    writeJson({ ok: true, data: response, hints: tagsListHints() });
+  } catch (err) {
+    failApi(err);
+  }
+}
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "Review the tag changes staged in this chat (read-only). Staged changes were approved via request_tag_input and apply when the chat is published. To drop one, `baker tags unstage <ref>` with the ref printed here (or --all); to amend one, propose a follow-up change through the same tool. Takes --chat <id> to read an earlier chat's staged changes instead."
+  },
+  args: { chat: CHAT_READ_ARG },
+  run: async ({ args }) => {
+    await listDraft(args.chat);
+  }
+});
+registerSchema({
+  command: "tags.unstage",
+  description: "Take back a tag change this chat staged, before Publish \u2014 the same as discarding its row in the change review. Pass the ref `baker tags draft` prints (a tag id, or tag_temp_* for a staged create), or --all for every staged tag change. Taking back a staged create also drops the secrets the user entered for it. Never touches a live tag: to change or remove one, propose the change through request_tag_input.",
+  args: {
+    ref: { type: "string", description: "The staged change's ref, from `baker tags draft`", required: false },
+    all: { type: "boolean", description: "Take back every tag change staged in this chat", required: false }
+  }
+});
+function unstageBody(args, chatId) {
+  const ref = args.ref?.trim();
+  if (args.all === true && ref) {
+    failValidation("Pass one ref to take back that change, or --all for every staged tag change \u2014 not both.");
+  }
+  if (args.all === true) {
+    return { chatId, all: true };
+  }
+  if (!ref) {
+    failValidation("Pass the ref of the staged change (from `baker tags draft`), or --all.");
+  }
+  return { chatId, ref };
+}
+var unstageCommand = defineCommand({
+  meta: {
+    name: "unstage",
+    description: "Take back a tag change this chat staged, before Publish. Examples: baker tags unstage tag_temp_abc123 | baker tags unstage --all"
+  },
+  args: {
+    ref: { type: "positional", description: "The staged change's ref, from `baker tags draft`", required: false },
+    all: { type: "boolean", description: "Take back every tag change staged in this chat", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = unstageBody(
+        {
+          ...typeof args.ref === "string" ? { ref: args.ref } : {},
+          ...args.all === true ? { all: true } : {}
+        },
+        requireChatId()
+      );
+      const response = await apiPost("/api/tags/draft-op/remove", body);
+      writeJson({
+        ...response,
+        hints: ["Taken back: it does not apply when the chat is published. Live tags are unchanged."]
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var tagsCommand = defineCommand({
+  meta: {
+    name: "tags",
+    description: `Read the client's marketing/analytics tags (Meta pixel, GA4, Google Ads, GTM, Clarity, Hotjar, \u2026) \u2014 production tags plus the changes staged in this chat.
+
+Every tag change \u2014 create, edit, or delete \u2014 goes through the request_tag_input tool (baker_ui MCP server): propose one or more changes (each becomes a tab in one approval form), pre-fill the non-secret fields you know, and the user reviews, fills secrets, and approves or skips each. Secret values (accessToken, apiSecret, authorizationToken, apiKey, conversionToken, OAuth connections) never pass through the CLI or the chat.
+
+Refs: \`baker tags list\` prints each tag's ref \u2014 a real tag id, or tag_temp_* for creates staged in this chat. Use these refs as flow side-effect tagIds; they keep resolving after publish.
+
+\`baker tags list\` prints each tag's readable config in full (secrets excluded) \u2014 the Clarity projectId, GA4 measurementId, the whole custom \`code\` snippet, etc. Reuse a stored value to pre-fill a follow-up change instead of asking the user for something already installed.
+
+To take back a change this chat staged (before Publish), \`baker tags unstage <ref>\` \u2014 the ref \`baker tags draft\` prints \u2014 or \`--all\`. It never touches a live tag.
+
+Examples:
+  baker tags list       # production + staged, full readable config + secret status
+  baker tags draft      # review the staged changes awaiting publish
+  baker tags unstage tag_temp_abc123   # take back one staged change
+Full guide: __tooling__/docs/tools/baker/tags.md`
+  },
+  subCommands: {
+    list: listCommand,
+    draft: draftCommand,
+    unstage: unstageCommand
+  },
+  // Bare `baker tags` lists the effective tags. `args` stays so citty knows this
+  // command's flags when it scans rawArgs for a subcommand name, and `default` (not
+  // `run`) dispatches the bare invocation — citty falls through to `run` after a
+  // subcommand, so a `run` here would also list on every `baker tags draft`.
+  args: listArgs,
+  default: "list"
+});
+export {
+  tagsCommand,
+  unstageBody
+};
+//# sourceMappingURL=tags-AGFUJ2BB.js.map