@koda-sl/baker-cli 0.449.0 → 0.450.0-dev.b454c3dd2

package/dist/sends-BQZM5PLS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/analytics/sends.ts"],"sourcesContent":["/**\n * `baker analytics sends` — where this company's system events are sent, and\n * changing it.\n *\n * A send hangs off an event one of the client's own systems raises, by its\n * key: `page:deal_won` from HubSpot → Meta Purchase. Every such event is\n * uploaded to the platform with who the person is, the click that brought\n * them and the amount forwarded automatically. Nothing is mapped. What happens\n * on a page or in a Form is not sendable here: the page's own pixels and the\n * Form's own side effects already send those.\n *\n * A write STAGES: it lands when the chat is published, and from then on it\n * spends ad budget on every event under the key. The dashboard's Sources page\n * applies at once because the person clicking is the review; an agent's\n * proposal gets its review at Publish.\n */\n\nimport {\n  isSendPlatform,\n  SEND_PLATFORMS,\n  type SendsRequest,\n  type SendsResponse,\n  sendEventProblem,\n  sendsRequestSchema,\n} from \"@baker/api/analytics\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\nimport { ConversionArgsError, onlyOnce } from \"./conversionArgs.ts\";\n\nexport interface SendsArgs {\n  set?: {\n    id: string;\n    eventKey: string;\n    platform: string;\n    tagId: string;\n    event: string;\n    account?: string;\n    parameters?: Record<string, string>;\n  };\n  remove?: string;\n  days?: number;\n  /** One send's uploads, by id, and whether only the refused ones. */\n  uploads?: string;\n  failedOnly?: boolean;\n  /** With `uploads`: only the events it skipped, for want of anything to match. */\n  skippedOnly?: boolean;\n  full: boolean;\n}\n\nconst SET_FLAGS = [\"--source-event\", \"--platform\", \"--tag\", \"--event\"] as const;\n\n/**\n * The flags, checked for the shapes that would otherwise stage the wrong\n * send in silence. Pure, so the refusals are tier-1 tested.\n */\nexport function parseSendsArgs(raw: Record<string, unknown>, argv: readonly string[], now = Date.now()): SendsArgs {\n  const set = parseSetFlags(raw, argv, now);\n  const remove = onlyOnce(raw.remove, \"--remove\", argv);\n\n  const days = raw.days === undefined ? undefined : Number(raw.days);\n  if (days !== undefined && (!Number.isInteger(days) || days <= 0 || days > 400)) {\n    throw new ConversionArgsError(\"--days must be a whole number of days, from 1 to 400.\");\n  }\n\n  const uploads = onlyOnce(raw.uploads, \"--uploads\", argv);\n  if (raw.failed === true && uploads === undefined) {\n    throw new ConversionArgsError(\"--failed narrows --uploads <sendId> to the refused ones; name the send.\");\n  }\n  if (raw.skipped === true && uploads === undefined) {\n    throw new ConversionArgsError(\n      \"--skipped narrows --uploads <sendId> to the events it never uploaded; name the send.\",\n    );\n  }\n\n  return {\n    ...(set === undefined ? {} : { set }),\n    ...(remove === undefined ? {} : { remove }),\n    ...(days === undefined ? {} : { days }),\n    ...(uploads === undefined ? {} : { uploads }),\n    ...(raw.failed === true ? { failedOnly: true } : {}),\n    ...(raw.skipped === true ? { skippedOnly: true } : {}),\n    full: raw.full === true,\n  };\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/**\n * Every `--parameter name=template` on the command line, in order. Read off\n * argv rather than the parsed args because citty keeps only the last value\n * of a repeated flag — the defect that once staged one of three UTMs.\n */\nexport function parseParameterArgs(argv: readonly string[]): Record<string, string> | undefined {\n  const parameters: Record<string, string> = {};\n  for (let index = 0; index < argv.length; index += 1) {\n    const pair = flagValueAt(argv, \"--parameter\", index);\n    if (pair === undefined) continue;\n    const eq = pair.indexOf(\"=\");\n    const name = (eq === -1 ? pair : pair.slice(0, eq)).trim();\n    const template = eq === -1 ? \"\" : pair.slice(eq + 1).trim();\n    if (name === \"\" || template === \"\") {\n      throw new ConversionArgsError(\n        `--parameter needs <name>=<template>, like --parameter content_name={{properties.plan}}; got \"${pair}\".`,\n      );\n    }\n    parameters[name] = template;\n  }\n  return Object.keys(parameters).length === 0 ? undefined : parameters;\n}\n\n/**\n * The send `--set` describes, or nothing on a read.\n *\n * The four flags are only meaningful together and only under `--set`: a send\n * described without it would answer ok and stage nothing, and a `--set` with\n * a piece missing would be refused by the server with the field named but not\n * the flag.\n */\nfunction parseSetFlags(raw: Record<string, unknown>, argv: readonly string[], now: number): SendsArgs[\"set\"] {\n  if (raw.conversion !== undefined) {\n    throw new ConversionArgsError(\n      \"--conversion is gone: a send is on a system's EVENT, not a conversion. Pass --source-event <key> — one of events[].eventKey from a plain `baker analytics sends` (page:<name>).\",\n    );\n  }\n  const values = {\n    \"--source-event\": onlyOnce(raw[\"source-event\"] ?? raw.sourceEvent, \"--source-event\", argv),\n    \"--platform\": onlyOnce(raw.platform, \"--platform\", argv),\n    \"--tag\": onlyOnce(raw.tag, \"--tag\", argv),\n    \"--event\": onlyOnce(raw.event, \"--event\", argv),\n  };\n  const given = SET_FLAGS.filter((flag) => values[flag] !== undefined);\n  const set = raw.set === true;\n\n  if (!set) {\n    if (given.length > 0) {\n      throw new ConversionArgsError(\n        `${given.join(\", \")} describe a send, so add --set to stage it. Without --set the command only reads.`,\n      );\n    }\n    return undefined;\n  }\n\n  const missing = SET_FLAGS.filter((flag) => values[flag] === undefined);\n  if (missing.length > 0) {\n    throw new ConversionArgsError(\n      `--set needs ${SET_FLAGS.join(\", \")}; missing ${missing.join(\", \")}. Copy --tag from platforms[].tags of a plain \\`baker analytics sends\\`, never from memory.`,\n    );\n  }\n  const platform = values[\"--platform\"] ?? \"\";\n  if (!isSendPlatform(platform)) {\n    throw new ConversionArgsError(\n      `\"${platform}\" is not somewhere a conversion can be sent — --platform is one of ${SEND_PLATFORMS.join(\", \")}.`,\n    );\n  }\n\n  const event = values[\"--event\"] ?? \"\";\n  const templated = sendEventProblem(platform, event);\n  if (templated !== null) {\n    throw new ConversionArgsError(`--event ${event} cannot be sent to ${platform}. ${templated}`);\n  }\n\n  const account = onlyOnce(raw.account, \"--account\", argv);\n  const parameters = parseParameterArgs(argv);\n  return {\n    id: onlyOnce(raw.id, \"--id\", argv) ?? sendIdFor(now),\n    eventKey: values[\"--source-event\"] ?? \"\",\n    ...originFlag(raw, argv),\n    platform,\n    tagId: values[\"--tag\"] ?? \"\",\n    event,\n    ...(account === undefined ? {} : { account }),\n    ...(parameters === undefined ? {} : { parameters }),\n  };\n}\n\n/**\n * Which door's events `--set` uploads, as the send spells it: every door the\n * event arrives by (`origin: \"any\"`, the default — one event, one set of\n * destinations, uploaded once when the pixel and the API both report it under\n * one event id), or only the pixel's (`website`) or only the API's and the\n * integrations' (no field at all).\n */\nfunction originFlag(raw: Record<string, unknown>, argv: readonly string[]): { origin?: \"website\" | \"any\" } {\n  const from = onlyOnce(raw.from, \"--from\", argv) ?? \"any\";\n  if (from === \"any\") return { origin: \"any\" };\n  if (from === \"api\") return {};\n  if (from === \"pixel\") return { origin: \"website\" };\n  throw new ConversionArgsError(\n    `--from is any, pixel or api; got \"${from}\". any — the default — uploads the event whichever door it arrives by, once when the pixel and the API both report it with the same event id; pixel only what Baker's pixel sent from the client's website; api only what the API or an integration sent.`,\n  );\n}\n\n/** A short id a person can type, when the caller did not choose one. */\nfunction sendIdFor(now: number): string {\n  return `s${now.toString(36).slice(-5)}`;\n}\n\n/**\n * The request body, validated against the shared schema here rather than only\n * on the server, so a malformed send is named before a round trip.\n */\nexport function sendsWrite(args: SendsArgs): SendsRequest {\n  const body = {\n    ...(args.set === undefined ? {} : { set: [args.set] }),\n    ...(args.remove === undefined ? {} : { remove: [args.remove] }),\n    ...(args.days === undefined ? {} : { days: args.days }),\n    ...(args.uploads === undefined ? {} : { uploads: args.uploads }),\n    ...(args.failedOnly === undefined ? {} : { failedOnly: args.failedOnly }),\n    ...(args.skippedOnly === undefined ? {} : { skippedOnly: args.skippedOnly }),\n  };\n  const parsed = sendsRequestSchema.safeParse(body);\n  if (!parsed.success) {\n    const issue = parsed.error.issues[0];\n    throw new ConversionArgsError(\n      `That send cannot be staged — ${issue?.path.join(\".\") || \"set\"}: ${issue?.message ?? \"invalid\"}. Run \\`baker schema analytics.sends\\` for the exact shape.`,\n    );\n  }\n  return parsed.data;\n}\n\n/**\n * What to print. Compact by default: the sends with their outcomes, the\n * platforms with the tags that can send (where a `tagId` is copied from), and\n * the system events that can be sent. `carries` — every field a send forwards\n * — is the same list every time, so it is behind `--full`.\n */\nexport function sendsView(response: SendsResponse, full: boolean): Record<string, unknown> {\n  const { carries, templateFields, ...rest } = response.data;\n  return {\n    ok: true,\n    data: { ...rest, ...(full ? { carries, templateFields } : {}) },\n    ...(response.hints && response.hints.length > 0 ? { hints: response.hints } : {}),\n  };\n}\n\nconst args = {\n  set: {\n    type: \"boolean\",\n    description:\n      \"Stage a send, described by --source-event, --platform, --tag and --event. It applies when this chat is published, and from then on every event arriving under that key is uploaded to the platform and spends ad budget — say so to the client, never that it is a preview\",\n    required: false,\n  },\n  \"source-event\": {\n    type: \"string\",\n    description:\n      \"The event to send, by key — one of `events[].eventKey` from a plain `baker analytics sends`: a Source's own event (page:<source name>), or a named event the client's server posts. A Form's or a page's event is refused: the page's own pixels and the Form's side effects already send those\",\n    required: false,\n  },\n  from: {\n    type: \"string\",\n    description:\n      \"Which door's events the send uploads: `any` (default) — the event whichever door it arrives by, uploaded once when the pixel and the API both report it with the same event id; `pixel` — only what Baker's pixel sent from the client's own website (an `events[]` row with origin `website`); `api` — only what the client's server posted or an integration like HubSpot sent\",\n    required: false,\n  },\n  platform: {\n    type: \"string\",\n    description: `Where it goes: one of ${SEND_PLATFORMS.join(\", \")}`,\n    required: false,\n  },\n  tag: {\n    type: \"string\",\n    description:\n      \"The tag on Tracking that sends it. COPY the id from `platforms[].tags[].tagId` in the response — it is only listed there when the tag holds its server credential, and one typed from memory is refused\",\n    required: false,\n  },\n  event: {\n    type: \"string\",\n    description:\n      'What the platform calls it — `platforms[].eventMeans` says what each one takes: a Meta or Google Analytics event name (Purchase, Lead, generate_lead), a Google Ads conversion action id copied from `platforms[].conversionActions`, or the conversion label the person gives you (staged as its id; never type an id: one the account does not hold is refused), a LinkedIn conversion rule id, an X event tag id. On Meta and Google Analytics it may be WRITTEN FROM THE EVENT with the same {{path}} mentions --parameter takes: --event {{properties.plan}} sends each event under the plan it carries, --event \"Purchase {{properties.tier}}\" mixes text and a field. An event carrying nothing there is not uploaded. Google Ads, LinkedIn and X take an id THEY issued, so a template is refused there — pass what varies as a --parameter instead. For a GOOGLE ADS id, list the account\\'s conversion actions first and pick by name — `baker ads google query \"SELECT conversion_action.id, conversion_action.name, conversion_action.primary_for_goal FROM conversion_action WHERE conversion_action.status = \\'ENABLED\\'\"` — never guess: Google accepts an upload against an id the account does not hold and files it against nothing',\n    required: false,\n  },\n  account: {\n    type: \"string\",\n    description: \"LinkedIn only: the ad account the conversion rule belongs to\",\n    required: false,\n  },\n  parameter: {\n    type: \"string\",\n    description:\n      \"<name>=<template>, repeatable, with --set: an EXTRA parameter the platform receives with every upload, beyond who, the click and the amount — Meta's custom_data (content_name, content_category, or your own), a GA4 event parameter, a Google Ads custom variable (must exist in the account), X's contents (content_name, num_items…); LinkedIn takes none. The template is text with {{path}} mentions over the event: its own properties as {{properties.<key>}} (a HubSpot event's --field properties.<key> rows, a server event's `properties`), and the fields `templateFields` lists (--full): value, value_currency, event_name, page_path, city, country, gclid… Example: --parameter content_name={{properties.plan}} --parameter content_category=hubspot. `parameters[]` in the response says what each platform takes\",\n    required: false,\n  },\n  uploads: {\n    type: \"string\",\n    description:\n      \"The id of a send (`sends[].id`) whose uploads to list, newest first over --days: which event went, when, `outcome` (success | failed | pending | skipped) and in `error` the platform's refusal in its own words or what a skipped event was missing — the rows behind `sends[].outcome`. With --failed, only the refused ones; with --skipped, only the skipped ones\",\n    required: false,\n  },\n  failed: {\n    type: \"boolean\",\n    description: \"With --uploads: only the uploads the platform refused\",\n    required: false,\n  },\n  skipped: {\n    type: \"boolean\",\n    description:\n      \"With --uploads: only the events the send never uploaded because they carried nothing the platform matches a person by — each `error` names what was missing (a Meta click id or cookie, an email, a gclid…)\",\n    required: false,\n  },\n  id: {\n    type: \"string\",\n    description:\n      \"The send's id, when changing one that exists (`sends[].id` for a live one, `staged.set[].id` for one staged in this chat, like s1). Left out, a new id is minted and a NEW send is staged — so re-running a --set you already ran is refused, naming the send it would duplicate\",\n    required: false,\n  },\n  remove: {\n    type: \"string\",\n    description: \"The id of a send to stop, from `sends[].id`. Staged like a set: it stops when the chat is published\",\n    required: false,\n  },\n  days: {\n    type: \"string\",\n    description: \"How many days the outcome beside each send covers (default 30, up to 400)\",\n    required: false,\n  },\n  full: {\n    type: \"boolean\",\n    description: \"Also return `carries`: every field a send forwards, the same for every send\",\n    required: false,\n  },\n} as const;\n\nregisterSchema({\n  command: \"analytics.sends\",\n  description: \"Read where this company's system events are sent, or stage a change\",\n  args,\n});\n\nexport const sendsCommand = defineCommand({\n  meta: {\n    name: \"sends\",\n    description: `Where this company's SYSTEM EVENTS are sent — Meta, Google Ads, LinkedIn, X, Google Analytics — and what happened to each upload. A send belongs to an event one of the client's own systems raises, by key: page:deal_won from HubSpot → Meta Purchase means every \"deal_won\" HubSpot reports is uploaded to Meta with who the person is, the click that brought them and the amount forwarded automatically. There is nothing to map. What happens on a page or in a Form is never sent from here — the page's pixels and the Form's own side effects do that — and a send is never set on a funnel step: the step reads the sends of the events behind its ways in.\n\nStart here:\n  baker analytics sends                                   — the sends in effect, each with its outcome; the platforms and the tags that can send; the system events (events[]) that can be sent\n  baker analytics sends --set --source-event page:deal_won --platform meta --tag <tagId> --event Purchase\n  baker analytics sends --set --source-event page:deal_won --platform googleAds --tag <tagId> --event 987654321\n  baker analytics sends --set --source-event page:deal_won --platform meta --tag <tagId> --event Purchase --parameter content_name={{properties.plan}}\n  baker analytics sends --set --source-event page:lead_completed_step_2 --platform meta --tag <tagId> --event Lead   — an event the pixel and/or the API send; uploaded once per event id\n  baker analytics sends --set --source-event page:deal_won --platform meta --tag <tagId> --event {{properties.plan}}   — a Meta event named after what each one carries\n  baker analytics sends --remove s1                       — stop one\n  baker analytics sends --days 7                          — outcomes over the last week\n  baker analytics sends --uploads s1 --failed             — the uploads Meta refused, each with the event and Meta's own words\n  baker analytics sends --uploads s1 --skipped            — the events never uploaded, each with what the platform needed and they lacked\n\nThree things to hold on to:\n  it is STAGED   — a set or a remove lands when this chat is published, and from then on it SPENDS AD BUDGET on every \"<event>\" that arrives. Tell the client that plainly; never call a published send a preview.\n  the tagId is COPIED — from \\`platforms[].tags\\` in the response, which lists only the tags on Tracking that hold their server credential. One typed from memory is refused; a platform with no tag listed says what to add on Tracking (\\`platforms[].setupHint\\`).\n  the outcome is what happened — \\`sends[].outcome\\` counts what was sent, what failed and why (\\`lastError\\`, in the platform's words), and what was SKIPPED: an event carrying nothing the platform matches a person by is never uploaded (Meta: a Meta click id or cookie, an email or your own customer id; Google Ads: gclid, wbraid, gbraid, an email or a phone; LinkedIn: li_fat_id or an email; X: twclid or an email; Google Analytics: nothing), counted in \\`skipped\\` with \\`lastSkipReason\\`.\n  check the MATCH before staging — \\`events[].match\\` says, for the last 30 days of each event, how many arrived and how many each platform could match. A send to a platform matching 0 of 14 skips all 14: say so to the client, and ask for the click id or the email to be sent with the event instead. \"Nothing sent yet\" means no event under that name has fired since the send was set. \\`--uploads <id>\\` lists the rows behind the count, \\`--failed\\` only the refused ones — read it before telling a client a send \"failed\".\n  a Meta or GA4 event name can be WRITTEN FROM THE EVENT — \\`--event {{properties.plan}}\\` sends each event under its own plan, so one Source covers every value instead of one Source, one send and one conversion action per value. Only where the platform takes a name of your own: Google Ads, LinkedIn and X take an id they issued and refuse a template.\n  extra parameters are optional — \\`--parameter <name>=<template>\\` adds what the platform receives beyond who, the click and the amount: \\`{{properties.<key>}}\\` reads a property the event carries (a HubSpot event's \\`--field properties.<key>\\` rows), \\`{{value}}\\`, \\`{{page_path}}\\`, \\`{{city}}\\`… read the event's fields. \\`parameters[]\\` in the response says what each platform takes and the names it knows; LinkedIn takes none.\n\nAn empty \\`events[]\\` means none of the client's systems sends an event yet and there is nothing to send: make a Source with \\`baker analytics sources\\` (a HubSpot event, or the server's address), then send its event.`,\n  },\n  args,\n  run: async ({ args: raw }) => {\n    try {\n      const parsed = parseSendsArgs(raw as Record<string, unknown>, process.argv);\n      const response = await apiPost<SendsResponse>(\"/api/analytics/sends\", sendsWrite(parsed));\n      writeJsonEnvelope(sendsView(response, parsed.full));\n    } catch (err) {\n      handleError(err);\n    }\n  },\n});\n\nfunction handleError(err: unknown): never {\n  if (err instanceof ConversionArgsError) {\n    writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message: err.message } });\n    process.exit(1);\n  }\n  if (err instanceof ApiError) {\n    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });\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"],"mappings":"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","names":["args"]}

package/dist/set-prompt-2HASHGWC.js

@@ -0,0 +1,187 @@
+import {
+  CanvasPrepareError,
+  adaptNodes,
+  compiledPromptNodeIds,
+  prepareCanvas,
+  sceneOwnedPrompts
+} from "./chunk-ASI4P6X2.js";
+import "./chunk-4QEY2L6U.js";
+import "./chunk-VL43TNIP.js";
+import "./chunk-ZDMTXQ2Q.js";
+import "./chunk-F2S5BLPE.js";
+import "./chunk-WTOYCUKH.js";
+import "./chunk-DZSIUEGH.js";
+import {
+  defaultRegistry,
+  validateCanvasDeep
+} from "./chunk-LYQJ4PZW.js";
+import "./chunk-FPOGPFAG.js";
+import "./chunk-NCWCZY5P.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-W3B4BHQU.js";
+import {
+  COPY_DIRECTIVE_HEADER
+} from "./chunk-PZXCWSKV.js";
+import "./chunk-CAMX6OHF.js";
+import "./chunk-RX6F3GEA.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-VAJBWA2U.js";
+import "./chunk-HRYOZUSK.js";
+import "./chunk-VVZBBKRC.js";
+import "./chunk-YBMVHGY3.js";
+import "./chunk-7EPXVICM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-HR6IWNKE.js";
+import "./chunk-NE4F3FHN.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/set-prompt.ts
+import { readFile, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+function setNodePrompt(canvas, nodeId, text) {
+  const nodes = canvas?.nodes;
+  if (!Array.isArray(nodes)) throw new Error("canvas has no nodes array");
+  const idx = nodes.findIndex((n) => n?.id === nodeId);
+  if (idx < 0) {
+    const ids = nodes.map((n) => n?.id).filter((id) => typeof id === "string");
+    throw new Error(`node "${nodeId}" not found. Known nodes: ${ids.join(", ")}`);
+  }
+  const node = nodes[idx];
+  const newNode = { ...node, params: { ...node.params ?? {}, prompt: text } };
+  const newNodes = [...nodes];
+  newNodes[idx] = newNode;
+  return { ...canvas, nodes: newNodes };
+}
+var SetPromptError = class extends Error {
+  code;
+  fix;
+  details;
+  constructor(code, message, opts = {}) {
+    super(message);
+    this.name = "SetPromptError";
+    this.code = code;
+    this.fix = opts.fix;
+    this.details = opts.details;
+  }
+};
+async function setPromptInCanvasFile(canvasPath, nodeId, text) {
+  const filePath = path.resolve(canvasPath);
+  const original = await readFile(filePath, "utf8");
+  let canvas;
+  try {
+    canvas = JSON.parse(original);
+  } catch (e) {
+    throw new SetPromptError("parse", `${filePath}: JSON parse error: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  const sceneFile = (await sceneOwnedPrompts(filePath)).get(nodeId);
+  if (sceneFile) {
+    throw new SetPromptError(
+      "projected_prompt",
+      `The prompt of "${nodeId}" is rebuilt from ${sceneFile} on every validate and run, so setting it in the canvas would be overwritten.`,
+      {
+        fix: `Edit the scene's description in ${sceneFile} (its frame and motion fields, e.g. start_frame_prompt, end_frame_prompt, frame_prompt, motion_prompt), then run \`baker canvas validate\` to see the rebuilt prompt.`
+      }
+    );
+  }
+  if (compiledPromptNodeIds(canvas).has(nodeId) || adaptNodes(canvas).some((a) => a.node.id === nodeId)) {
+    throw new SetPromptError(
+      "projected_prompt",
+      `The prompt of "${nodeId}" is compiled from prompt.json on every validate and run, so setting it in the canvas would be overwritten.`,
+      {
+        fix: `Edit the ad in ${path.join(path.dirname(filePath), "prompt.json")} (its scene, copy, references or direction), then run \`baker canvas validate\` to see the compiled prompt on the node.`
+      }
+    );
+  }
+  let updated;
+  try {
+    updated = setNodePrompt(canvas, nodeId, withCopyBlock(canvas, nodeId, text));
+  } catch (e) {
+    throw new SetPromptError("node_not_found", e instanceof Error ? e.message : String(e));
+  }
+  await writeFile(filePath, `${JSON.stringify(updated, null, 2)}
+`, "utf8");
+  const restore = () => writeFile(filePath, original, "utf8");
+  try {
+    const prepared = await prepareCanvas(filePath);
+    const validation = await validateCanvasDeep(prepared.canvas, defaultRegistry());
+    if (!validation.ok) {
+      await restore();
+      throw new SetPromptError("validation", "The edited canvas does not validate; nothing was changed.", {
+        details: { issues: validation.issues }
+      });
+    }
+  } catch (e) {
+    if (e instanceof SetPromptError) throw e;
+    await restore();
+    if (e instanceof CanvasPrepareError) {
+      throw new SetPromptError(e.code, e.message, { ...e.fix ? { fix: e.fix } : {}, ...e.details ? { details: e.details } : {} });
+    }
+    throw e;
+  }
+}
+function withCopyBlock(canvas, nodeId, text) {
+  const nodes = canvas?.nodes;
+  const current = Array.isArray(nodes) ? nodes.find((n) => n?.id === nodeId)?.params?.prompt : void 0;
+  if (typeof current !== "string" || !current.includes(COPY_DIRECTIVE_HEADER) || text.includes(COPY_DIRECTIVE_HEADER)) {
+    return text;
+  }
+  return `${text.trimEnd()}
+
+${COPY_DIRECTIVE_HEADER}`;
+}
+var setPromptCommand = defineCommand({
+  meta: {
+    name: "set-prompt",
+    description: "Safely set a node's params.prompt (a frame description, motion prompt, etc.) without hand-editing the JSON. Prefer --text-file for multi-line/accented copy \u2014 it preserves UTF-8 exactly, unlike shell-quoted jq. A prompt rebuilt from a scene file (scenes/sNN.json), or compiled from a static ad's prompt.json, is refused with the file to edit instead."
+  },
+  args: {
+    file: { type: "positional", required: true, description: "Path to canvas JSON" },
+    node: { type: "positional", required: true, description: "Node id to edit (e.g. s0_start)" },
+    text: { type: "string", description: "New prompt text (inline)" },
+    "text-file": { type: "string", description: "Read the new prompt from a UTF-8 file (preserves accents/newlines)" }
+  },
+  async run({ args }) {
+    let text;
+    if (args["text-file"]) text = await readFile(path.resolve(String(args["text-file"])), "utf8");
+    else if (args.text !== void 0) text = String(args.text);
+    else {
+      process.stderr.write(
+        `${JSON.stringify({ ok: false, error: { code: "no_text", message: "pass --text or --text-file" } }, null, 2)}
+`
+      );
+      process.exit(2);
+      return;
+    }
+    try {
+      await setPromptInCanvasFile(String(args.file), String(args.node), text);
+    } catch (e) {
+      if (!(e instanceof SetPromptError)) throw e;
+      process.stderr.write(
+        `${JSON.stringify(
+          { ok: false, error: { code: e.code, message: e.message, ...e.fix ? { fix: e.fix } : {}, ...e.details ?? {} } },
+          null,
+          2
+        )}
+`
+      );
+      process.exit(2);
+      return;
+    }
+    process.stdout.write(`${JSON.stringify({ ok: true, node: String(args.node), bytes: text.length }, null, 2)}
+`);
+  }
+});
+export {
+  SetPromptError,
+  setNodePrompt,
+  setPromptCommand,
+  setPromptInCanvasFile
+};
+//# sourceMappingURL=set-prompt-2HASHGWC.js.map

package/dist/set-prompt-2HASHGWC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/set-prompt.ts"],"sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { defaultRegistry, validateCanvasDeep } from \"../../engine/index.ts\";\nimport { COPY_DIRECTIVE_HEADER } from \"../../engine/scaffold/static-copy.ts\";\nimport { adaptNodes } from \"../../engine/scaffold/static-adapt-briefs.ts\";\nimport { compiledPromptNodeIds } from \"../../engine/scaffold/static-render-briefs.ts\";\nimport { CanvasPrepareError, prepareCanvas } from \"./prepare-canvas.ts\";\nimport { sceneOwnedPrompts } from \"./scene-projection.ts\";\n\n/**\n * Set one node's `params.prompt` in a parsed canvas, returning a NEW canvas. The\n * structured alternative to hand-editing a 133 KB machine JSON with jq/sed — which\n * is where `\"prompt\": null` pollution (a global `gsub` writing prompt onto every\n * node) and the French-accent corruption (shell `''` eating apostrophes) came from.\n * Throws when the node id is unknown. Pure — unit-tested without the filesystem.\n */\nexport function setNodePrompt(canvas: unknown, nodeId: string, text: string): unknown {\n  const nodes = (canvas as { nodes?: unknown })?.nodes;\n  if (!Array.isArray(nodes)) throw new Error(\"canvas has no nodes array\");\n  const idx = nodes.findIndex((n) => (n as { id?: unknown })?.id === nodeId);\n  if (idx < 0) {\n    const ids = nodes.map((n) => (n as { id?: unknown })?.id).filter((id): id is string => typeof id === \"string\");\n    throw new Error(`node \"${nodeId}\" not found. Known nodes: ${ids.join(\", \")}`);\n  }\n  const node = nodes[idx] as { params?: Record<string, unknown> };\n  const newNode = { ...node, params: { ...(node.params ?? {}), prompt: text } };\n  const newNodes = [...nodes];\n  newNodes[idx] = newNode;\n  return { ...(canvas as object), nodes: newNodes };\n}\n\n/** Why `set-prompt` did not write: the node's prompt is owned elsewhere, or the edit does not validate. */\nexport class SetPromptError extends Error {\n  readonly code: string;\n  readonly fix: string | undefined;\n  readonly details: Record<string, unknown> | undefined;\n  constructor(code: string, message: string, opts: { fix?: string; details?: Record<string, unknown> } = {}) {\n    super(message);\n    this.name = \"SetPromptError\";\n    this.code = code;\n    this.fix = opts.fix;\n    this.details = opts.details;\n  }\n}\n\n/**\n * Set a node's prompt in the canvas FILE, where it will survive.\n *\n * The canvas is a projection of its blueprint, and `prepareCanvas` rewrites the projected\n * parts on every validate and run. So:\n * - a frame or clip prompt a scene file rebuilds is refused, naming the scene file to edit\n *   (writing it here would be silently overwritten by the next preflight);\n * - a static ad's scaffolded render prompt (a take, a re-lay, the judge) is refused, naming\n *   prompt.json: it is compiled from the ad spec there on every run;\n * - a hand-written static render prompt keeps its copy block: the text replaces the scene\n *   description, and the \"render these exact strings\" block after it is re-read from\n *   prompt.json, as always;\n * - anything else is the canvas's own, and is written.\n * The result is validated; an edit that does not validate is undone.\n */\nexport async function setPromptInCanvasFile(canvasPath: string, nodeId: string, text: string): Promise<void> {\n  const filePath = path.resolve(canvasPath);\n  const original = await readFile(filePath, \"utf8\");\n  let canvas: unknown;\n  try {\n    canvas = JSON.parse(original);\n  } catch (e) {\n    throw new SetPromptError(\"parse\", `${filePath}: JSON parse error: ${e instanceof Error ? e.message : String(e)}`);\n  }\n\n  const sceneFile = (await sceneOwnedPrompts(filePath)).get(nodeId);\n  if (sceneFile) {\n    throw new SetPromptError(\n      \"projected_prompt\",\n      `The prompt of \"${nodeId}\" is rebuilt from ${sceneFile} on every validate and run, so setting it in the canvas would be overwritten.`,\n      {\n        fix: `Edit the scene's description in ${sceneFile} (its frame and motion fields, e.g. start_frame_prompt, end_frame_prompt, frame_prompt, motion_prompt), then run \\`baker canvas validate\\` to see the rebuilt prompt.`,\n      },\n    );\n  }\n\n  if (compiledPromptNodeIds(canvas).has(nodeId) || adaptNodes(canvas).some((a) => a.node.id === nodeId)) {\n    throw new SetPromptError(\n      \"projected_prompt\",\n      `The prompt of \"${nodeId}\" is compiled from prompt.json on every validate and run, so setting it in the canvas would be overwritten.`,\n      {\n        fix: `Edit the ad in ${path.join(path.dirname(filePath), \"prompt.json\")} (its scene, copy, references or direction), then run \\`baker canvas validate\\` to see the compiled prompt on the node.`,\n      },\n    );\n  }\n\n  let updated: unknown;\n  try {\n    updated = setNodePrompt(canvas, nodeId, withCopyBlock(canvas, nodeId, text));\n  } catch (e) {\n    throw new SetPromptError(\"node_not_found\", e instanceof Error ? e.message : String(e));\n  }\n\n  await writeFile(filePath, `${JSON.stringify(updated, null, 2)}\\n`, \"utf8\");\n  const restore = () => writeFile(filePath, original, \"utf8\");\n  try {\n    const prepared = await prepareCanvas(filePath);\n    const validation = await validateCanvasDeep(prepared.canvas, defaultRegistry());\n    if (!validation.ok) {\n      await restore();\n      throw new SetPromptError(\"validation\", \"The edited canvas does not validate; nothing was changed.\", {\n        details: { issues: validation.issues },\n      });\n    }\n  } catch (e) {\n    if (e instanceof SetPromptError) throw e;\n    await restore();\n    if (e instanceof CanvasPrepareError) {\n      throw new SetPromptError(e.code, e.message, { ...(e.fix ? { fix: e.fix } : {}), ...(e.details ? { details: e.details } : {}) });\n    }\n    throw e;\n  }\n}\n\n/**\n * A static ad's render prompt ends with the copy block the preflight fills from prompt.json.\n * New text that leaves it out keeps it, so replacing the scene description never drops the\n * words the ad must show.\n */\nfunction withCopyBlock(canvas: unknown, nodeId: string, text: string): string {\n  const nodes = (canvas as { nodes?: unknown })?.nodes;\n  const current = Array.isArray(nodes)\n    ? (nodes as Array<{ id?: unknown; params?: { prompt?: unknown } }>).find((n) => n?.id === nodeId)?.params?.prompt\n    : undefined;\n  if (typeof current !== \"string\" || !current.includes(COPY_DIRECTIVE_HEADER) || text.includes(COPY_DIRECTIVE_HEADER)) {\n    return text;\n  }\n  return `${text.trimEnd()}\\n\\n${COPY_DIRECTIVE_HEADER}`;\n}\n\nexport const setPromptCommand = defineCommand({\n  meta: {\n    name: \"set-prompt\",\n    description:\n      \"Safely set a node's params.prompt (a frame description, motion prompt, etc.) without hand-editing the JSON. Prefer --text-file for multi-line/accented copy — it preserves UTF-8 exactly, unlike shell-quoted jq. A prompt rebuilt from a scene file (scenes/sNN.json), or compiled from a static ad's prompt.json, is refused with the file to edit instead.\",\n  },\n  args: {\n    file: { type: \"positional\", required: true, description: \"Path to canvas JSON\" },\n    node: { type: \"positional\", required: true, description: \"Node id to edit (e.g. s0_start)\" },\n    text: { type: \"string\", description: \"New prompt text (inline)\" },\n    \"text-file\": { type: \"string\", description: \"Read the new prompt from a UTF-8 file (preserves accents/newlines)\" },\n  },\n  async run({ args }) {\n    let text: string;\n    if (args[\"text-file\"]) text = await readFile(path.resolve(String(args[\"text-file\"])), \"utf8\");\n    else if (args.text !== undefined) text = String(args.text);\n    else {\n      process.stderr.write(\n        `${JSON.stringify({ ok: false, error: { code: \"no_text\", message: \"pass --text or --text-file\" } }, null, 2)}\\n`,\n      );\n      process.exit(2);\n      return;\n    }\n\n    try {\n      await setPromptInCanvasFile(String(args.file), String(args.node), text);\n    } catch (e) {\n      if (!(e instanceof SetPromptError)) throw e;\n      process.stderr.write(\n        `${JSON.stringify(\n          { ok: false, error: { code: e.code, message: e.message, ...(e.fix ? { fix: e.fix } : {}), ...(e.details ?? {}) } },\n          null,\n          2,\n        )}\\n`,\n      );\n      process.exit(2);\n      return;\n    }\n    process.stdout.write(`${JSON.stringify({ ok: true, node: String(args.node), bytes: text.length }, null, 2)}\\n`);\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/setup-links-GYSE56GX.js

@@ -0,0 +1,142 @@
+import {
+  repeatedFlagValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  failApi,
+  failValidation
+} from "./chunk-SJYEY5MV.js";
+import "./chunk-7EPXVICM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-HR6IWNKE.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/setup-links/index.ts
+import { defineCommand } from "citty";
+var DOC = "__tooling__/docs/tools/baker/setup-links.md";
+var CREATE_HINT = "Send this link to whoever owns the accounts; it works without a Baker login and expires in 30 days. Revoke it in Settings \u2192 Setup links.";
+var LIST_FLAGS = ["tags", "connect", "keys", "apps", "domains"];
+var FLAG_HELP = {
+  tags: "Tracking tags to add (repeatable or comma-separated): meta, googleAds, googleAnalytics, linkedinInsightTag, tiktok, \u2026",
+  connect: "Accounts to connect by signing in (repeatable or comma-separated): google-ads, meta, google-analytics, google-tag-manager, google-search-console, linkedin, x-ads, hubspot, \u2026",
+  keys: "Accounts connected by pasting a key (repeatable or comma-separated): chatgpt-ads",
+  apps: "Apps from the app catalog, by slug or exact name (repeatable or comma-separated): slack, notion, \u2026 Find one with `baker mcp catalog <search>`.",
+  mcp: "An MCP server to connect, as name=https://address (repeatable). The recipient types any key into the link, never you.",
+  domains: "The company's own domain whose DNS record the recipient sets, by hostname (repeatable or comma-separated). It must already be added to Baker."
+};
+registerSchema({
+  command: "setup-links.create",
+  description: "Start here: make a setup link for whoever holds the company's accounts (an agency, the client's IT) \u2014 they open it, no Baker login needed, and connect what it asks for. Example: baker setup-links create --connect google-ads --tags meta. Made at once and returned now with its url: send it back to the user in this reply. Unknown names are refused: tags, connections and keys with the list of valid ones, apps with a pointer to `baker mcp catalog`.",
+  args: {
+    tags: { type: "string", description: FLAG_HELP.tags, required: false },
+    connect: { type: "string", description: FLAG_HELP.connect, required: false },
+    keys: { type: "string", description: FLAG_HELP.keys, required: false },
+    apps: { type: "string", description: FLAG_HELP.apps, required: false },
+    mcp: { type: "string", description: FLAG_HELP.mcp, required: false },
+    domains: { type: "string", description: FLAG_HELP.domains, required: false }
+  }
+});
+registerSchema({
+  command: "setup-links.list",
+  description: "The company's setup links that still work: what each asks for (in the same words `create` takes), how much of it is done, its url and when it expires. Check it before making a link that already exists.",
+  args: {}
+});
+function listFlag(rawArgs, flag) {
+  return repeatedFlagValues(rawArgs, flag).flatMap((value) => value.split(",")).map((value) => value.trim()).filter((value) => value !== "");
+}
+function createBody(rawArgs) {
+  const body = {};
+  for (const flag of LIST_FLAGS) {
+    const values = listFlag(rawArgs, flag);
+    if (values.length > 0) body[flag] = values;
+  }
+  const mcp = [];
+  for (const raw of repeatedFlagValues(rawArgs, "mcp")) {
+    const separator = raw.indexOf("=");
+    const name = raw.slice(0, separator).trim();
+    const url = raw.slice(separator + 1).trim();
+    if (separator < 0 || name === "" || !/^https:\/\//.test(url)) {
+      return { ok: false, error: `--mcp takes name=https://address, got "${raw}".` };
+    }
+    mcp.push({ name, url });
+  }
+  if (mcp.length > 0) body.mcp = mcp;
+  if (Object.keys(body).length === 0) {
+    return {
+      ok: false,
+      error: "A setup link has to ask for something: pass --tags, --connect, --keys, --apps, --mcp or --domains."
+    };
+  }
+  return { ok: true, body };
+}
+var createCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Make a setup link for whoever holds the company's accounts; returns its url now.
+Start here: baker setup-links create --connect google-ads --tags meta`
+  },
+  args: {
+    tags: { type: "string", description: FLAG_HELP.tags, required: false },
+    connect: { type: "string", description: FLAG_HELP.connect, required: false },
+    keys: { type: "string", description: FLAG_HELP.keys, required: false },
+    apps: { type: "string", description: FLAG_HELP.apps, required: false },
+    mcp: { type: "string", description: FLAG_HELP.mcp, required: false },
+    domains: { type: "string", description: FLAG_HELP.domains, required: false }
+  },
+  run: async ({ rawArgs }) => {
+    const parsed = createBody(rawArgs);
+    if (!parsed.ok) {
+      failValidation(parsed.error);
+    }
+    try {
+      const response = await apiPost("/api/setup-links/create", parsed.body);
+      writeJson({ ok: true, data: response.data, hints: [CREATE_HINT] });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "The company's setup links that still work: what each asks for, progress, url and expiry."
+  },
+  args: {},
+  run: async () => {
+    try {
+      const response = await apiPost("/api/setup-links/list", {});
+      writeJson({
+        ok: true,
+        data: response.data,
+        meta: { count: response.data.links.length },
+        ...response.data.links.length === 0 ? { hints: ["No setup links are out. Make one with baker setup-links create."] } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var setupLinksCommand = defineCommand({
+  meta: {
+    name: "setup-links",
+    description: `Setup links: one link that lets whoever holds the company's accounts connect them, without a Baker login. Subcommands: create, list.
+Full guide: ${DOC}`
+  },
+  subCommands: { create: createCommand, list: listCommand }
+});
+export {
+  createBody,
+  setupLinksCommand
+};
+//# sourceMappingURL=setup-links-GYSE56GX.js.map

package/dist/setup-links-GYSE56GX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/setup-links/index.ts"],"sourcesContent":["import type { SetupLinksCreateRequest, SetupLinksCreateResponse, SetupLinksListResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { repeatedFlagValues } from \"../../lib/repeatedFlags.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi, failValidation } from \"../actions/shared.ts\";\n\nconst DOC = \"__tooling__/docs/tools/baker/setup-links.md\";\n\nconst CREATE_HINT =\n  \"Send this link to whoever owns the accounts; it works without a Baker login and expires in 30 days. Revoke it in Settings → Setup links.\";\n\nconst LIST_FLAGS = [\"tags\", \"connect\", \"keys\", \"apps\", \"domains\"] as const;\n\nconst FLAG_HELP = {\n  tags: \"Tracking tags to add (repeatable or comma-separated): meta, googleAds, googleAnalytics, linkedinInsightTag, tiktok, …\",\n  connect:\n    \"Accounts to connect by signing in (repeatable or comma-separated): google-ads, meta, google-analytics, google-tag-manager, google-search-console, linkedin, x-ads, hubspot, …\",\n  keys: \"Accounts connected by pasting a key (repeatable or comma-separated): chatgpt-ads\",\n  apps: \"Apps from the app catalog, by slug or exact name (repeatable or comma-separated): slack, notion, … Find one with `baker mcp catalog <search>`.\",\n  mcp: \"An MCP server to connect, as name=https://address (repeatable). The recipient types any key into the link, never you.\",\n  domains:\n    \"The company's own domain whose DNS record the recipient sets, by hostname (repeatable or comma-separated). It must already be added to Baker.\",\n} as const;\n\nregisterSchema({\n  command: \"setup-links.create\",\n  description:\n    \"Start here: make a setup link for whoever holds the company's accounts (an agency, the client's IT) — they open it, no Baker login needed, and connect what it asks for. Example: baker setup-links create --connect google-ads --tags meta. Made at once and returned now with its url: send it back to the user in this reply. Unknown names are refused: tags, connections and keys with the list of valid ones, apps with a pointer to `baker mcp catalog`.\",\n  args: {\n    tags: { type: \"string\", description: FLAG_HELP.tags, required: false },\n    connect: { type: \"string\", description: FLAG_HELP.connect, required: false },\n    keys: { type: \"string\", description: FLAG_HELP.keys, required: false },\n    apps: { type: \"string\", description: FLAG_HELP.apps, required: false },\n    mcp: { type: \"string\", description: FLAG_HELP.mcp, required: false },\n    domains: { type: \"string\", description: FLAG_HELP.domains, required: false },\n  },\n});\n\nregisterSchema({\n  command: \"setup-links.list\",\n  description:\n    \"The company's setup links that still work: what each asks for (in the same words `create` takes), how much of it is done, its url and when it expires. Check it before making a link that already exists.\",\n  args: {},\n});\n\n/** Every value of a repeatable, comma-separated flag. */\nfunction listFlag(rawArgs: readonly string[], flag: string): string[] {\n  return repeatedFlagValues(rawArgs, flag)\n    .flatMap((value) => value.split(\",\"))\n    .map((value) => value.trim())\n    .filter((value) => value !== \"\");\n}\n\n/** The request one `create` line asks for, or why it cannot be sent. */\nexport function createBody(\n  rawArgs: readonly string[],\n): { ok: true; body: SetupLinksCreateRequest } | { ok: false; error: string } {\n  const body: SetupLinksCreateRequest = {};\n  for (const flag of LIST_FLAGS) {\n    const values = listFlag(rawArgs, flag);\n    if (values.length > 0) body[flag] = values;\n  }\n  const mcp: NonNullable<SetupLinksCreateRequest[\"mcp\"]> = [];\n  for (const raw of repeatedFlagValues(rawArgs, \"mcp\")) {\n    const separator = raw.indexOf(\"=\");\n    const name = raw.slice(0, separator).trim();\n    const url = raw.slice(separator + 1).trim();\n    if (separator < 0 || name === \"\" || !/^https:\\/\\//.test(url)) {\n      return { ok: false, error: `--mcp takes name=https://address, got \"${raw}\".` };\n    }\n    mcp.push({ name, url });\n  }\n  if (mcp.length > 0) body.mcp = mcp;\n  if (Object.keys(body).length === 0) {\n    return {\n      ok: false,\n      error: \"A setup link has to ask for something: pass --tags, --connect, --keys, --apps, --mcp or --domains.\",\n    };\n  }\n  return { ok: true, body };\n}\n\nconst createCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Make a setup link for whoever holds the company's accounts; returns its url now.\nStart here: baker setup-links create --connect google-ads --tags meta`,\n  },\n  args: {\n    tags: { type: \"string\", description: FLAG_HELP.tags, required: false },\n    connect: { type: \"string\", description: FLAG_HELP.connect, required: false },\n    keys: { type: \"string\", description: FLAG_HELP.keys, required: false },\n    apps: { type: \"string\", description: FLAG_HELP.apps, required: false },\n    mcp: { type: \"string\", description: FLAG_HELP.mcp, required: false },\n    domains: { type: \"string\", description: FLAG_HELP.domains, required: false },\n  },\n  run: async ({ rawArgs }) => {\n    const parsed = createBody(rawArgs);\n    if (!parsed.ok) {\n      failValidation(parsed.error);\n    }\n    try {\n      const response = await apiPost<SetupLinksCreateResponse>(\"/api/setup-links/create\", parsed.body);\n      writeJson({ ok: true, data: response.data, hints: [CREATE_HINT] });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description: \"The company's setup links that still work: what each asks for, progress, url and expiry.\",\n  },\n  args: {},\n  run: async () => {\n    try {\n      const response = await apiPost<SetupLinksListResponse>(\"/api/setup-links/list\", {});\n      writeJson({\n        ok: true,\n        data: response.data,\n        meta: { count: response.data.links.length },\n        ...(response.data.links.length === 0\n          ? { hints: [\"No setup links are out. Make one with baker setup-links create.\"] }\n          : {}),\n      });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n\nexport const setupLinksCommand = defineCommand({\n  meta: {\n    name: \"setup-links\",\n    description: `Setup links: one link that lets whoever holds the company's accounts connect them, without a Baker login. Subcommands: create, list.\nFull guide: ${DOC}`,\n  },\n  subCommands: { create: createCommand, list: listCommand },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAO9B,IAAM,MAAM;AAEZ,IAAM,cACJ;AAEF,IAAM,aAAa,CAAC,QAAQ,WAAW,QAAQ,QAAQ,SAAS;AAEhE,IAAM,YAAY;AAAA,EAChB,MAAM;AAAA,EACN,SACE;AAAA,EACF,MAAM;AAAA,EACN,MAAM;AAAA,EACN,KAAK;AAAA,EACL,SACE;AACJ;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,UAAU,aAAa,UAAU,MAAM,UAAU,MAAM;AAAA,IACrE,SAAS,EAAE,MAAM,UAAU,aAAa,UAAU,SAAS,UAAU,MAAM;AAAA,IAC3E,MAAM,EAAE,MAAM,UAAU,aAAa,UAAU,MAAM,UAAU,MAAM;AAAA,IACrE,MAAM,EAAE,MAAM,UAAU,aAAa,UAAU,MAAM,UAAU,MAAM;AAAA,IACrE,KAAK,EAAE,MAAM,UAAU,aAAa,UAAU,KAAK,UAAU,MAAM;AAAA,IACnE,SAAS,EAAE,MAAM,UAAU,aAAa,UAAU,SAAS,UAAU,MAAM;AAAA,EAC7E;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,CAAC;AACT,CAAC;AAGD,SAAS,SAAS,SAA4B,MAAwB;AACpE,SAAO,mBAAmB,SAAS,IAAI,EACpC,QAAQ,CAAC,UAAU,MAAM,MAAM,GAAG,CAAC,EACnC,IAAI,CAAC,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,CAAC,UAAU,UAAU,EAAE;AACnC;AAGO,SAAS,WACd,SAC4E;AAC5E,QAAM,OAAgC,CAAC;AACvC,aAAW,QAAQ,YAAY;AAC7B,UAAM,SAAS,SAAS,SAAS,IAAI;AACrC,QAAI,OAAO,SAAS,EAAG,MAAK,IAAI,IAAI;AAAA,EACtC;AACA,QAAM,MAAmD,CAAC;AAC1D,aAAW,OAAO,mBAAmB,SAAS,KAAK,GAAG;AACpD,UAAM,YAAY,IAAI,QAAQ,GAAG;AACjC,UAAM,OAAO,IAAI,MAAM,GAAG,SAAS,EAAE,KAAK;AAC1C,UAAM,MAAM,IAAI,MAAM,YAAY,CAAC,EAAE,KAAK;AAC1C,QAAI,YAAY,KAAK,SAAS,MAAM,CAAC,cAAc,KAAK,GAAG,GAAG;AAC5D,aAAO,EAAE,IAAI,OAAO,OAAO,0CAA0C,GAAG,KAAK;AAAA,IAC/E;AACA,QAAI,KAAK,EAAE,MAAM,IAAI,CAAC;AAAA,EACxB;AACA,MAAI,IAAI,SAAS,EAAG,MAAK,MAAM;AAC/B,MAAI,OAAO,KAAK,IAAI,EAAE,WAAW,GAAG;AAClC,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,OAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO,EAAE,IAAI,MAAM,KAAK;AAC1B;AAEA,IAAM,gBAAgB,cAAc;AAAA,EAClC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA,EAEf;AAAA,EACA,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,UAAU,aAAa,UAAU,MAAM,UAAU,MAAM;AAAA,IACrE,SAAS,EAAE,MAAM,UAAU,aAAa,UAAU,SAAS,UAAU,MAAM;AAAA,IAC3E,MAAM,EAAE,MAAM,UAAU,aAAa,UAAU,MAAM,UAAU,MAAM;AAAA,IACrE,MAAM,EAAE,MAAM,UAAU,aAAa,UAAU,MAAM,UAAU,MAAM;AAAA,IACrE,KAAK,EAAE,MAAM,UAAU,aAAa,UAAU,KAAK,UAAU,MAAM;AAAA,IACnE,SAAS,EAAE,MAAM,UAAU,aAAa,UAAU,SAAS,UAAU,MAAM;AAAA,EAC7E;AAAA,EACA,KAAK,OAAO,EAAE,QAAQ,MAAM;AAC1B,UAAM,SAAS,WAAW,OAAO;AACjC,QAAI,CAAC,OAAO,IAAI;AACd,qBAAe,OAAO,KAAK;AAAA,IAC7B;AACA,QAAI;AACF,YAAM,WAAW,MAAM,QAAkC,2BAA2B,OAAO,IAAI;AAC/F,gBAAU,EAAE,IAAI,MAAM,MAAM,SAAS,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;AAAA,IACnE,SAAS,KAAK;AACZ,cAAQ,GAAG;AAAA,IACb;AAAA,EACF;AACF,CAAC;AAED,IAAM,cAAc,cAAc;AAAA,EAChC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,MAAM,CAAC;AAAA,EACP,KAAK,YAAY;AACf,QAAI;AACF,YAAM,WAAW,MAAM,QAAgC,yBAAyB,CAAC,CAAC;AAClF,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ,MAAM,SAAS;AAAA,QACf,MAAM,EAAE,OAAO,SAAS,KAAK,MAAM,OAAO;AAAA,QAC1C,GAAI,SAAS,KAAK,MAAM,WAAW,IAC/B,EAAE,OAAO,CAAC,iEAAiE,EAAE,IAC7E,CAAC;AAAA,MACP,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,cAAQ,GAAG;AAAA,IACb;AAAA,EACF;AACF,CAAC;AAEM,IAAM,oBAAoB,cAAc;AAAA,EAC7C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,cACH,GAAG;AAAA,EACf;AAAA,EACA,aAAa,EAAE,QAAQ,eAAe,MAAM,YAAY;AAC1D,CAAC;","names":[]}

package/dist/site-4SKM7RKG.js

@@ -0,0 +1,178 @@
+import {
+  SiteArgsError,
+  failSite,
+  parseSetArgs
+} from "./chunk-FUHN4MFY.js";
+import "./chunk-7EPXVICM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-HR6IWNKE.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import {
+  optionalChatId,
+  requireChatId
+} from "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/site/index.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "site.show",
+  description: "Start here: the company's site settings as they will be after this chat publishes \u2014 cookie consent (consent), what Baker records (analyticsCollection), search engines (indexing), the home page (homePage, null = the first published landing), time zone, download format (exportProfile, null = default) and custom domains with their status \u2014 plus `staged`: what this chat changed, each with before/after. Hints name other open chats that already staged a site setting. Read-only.",
+  args: {
+    chat: {
+      type: "string",
+      description: "Read another chat's staged settings instead of this chat's (a chat id from `baker chats list`)",
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "site.set",
+  description: "Stage one or more site settings in one call; all apply when the chat is published, none mid-chat. Combine flags freely: `baker site set --consent recovery --indexing on`. Restaging a setting replaces what this chat staged before. Any member's chat may change these \u2014 the person who publishes is the review. --consent: bypass (no banner, maximum tracking), recovery (banner; declines still send anonymized pings \u2014 the usual EU choice), strict (banner; declines send nothing), external (the site's own consent tool). --collection: full, aggregate (counts only, nobody identifiable), off (Baker records nothing). --home takes a published landing slug (or one this chat is building); \"none\" restores the default. Always ask the user before hiding the site from search engines or reducing what Baker records.",
+  args: {
+    consent: { type: "string", description: "bypass | recovery | strict | external", required: false },
+    collection: { type: "string", description: "full | aggregate | off", required: false },
+    payloads: {
+      type: "string",
+      description: "on | off \u2014 keep a copy of each lead (only with --collection full)",
+      required: false
+    },
+    indexing: { type: "string", description: "on | off \u2014 show the site in search engines", required: false },
+    home: { type: "string", description: "Landing slug to serve at the site root, or none", required: false },
+    "home-mode": {
+      type: "string",
+      description: "rewrite (default; the root shows the landing) | redirect (the root sends visitors to /<slug>)",
+      required: false
+    },
+    timezone: { type: "string", description: "IANA time zone, e.g. Europe/Madrid", required: false },
+    "export-profile": {
+      type: "string",
+      description: 'Only the download-format fields to change, as JSON (e.g. {"htmlOutput":"fragment"}) or @path/to/profile.json. A second call adds to the first; Publish lays them over the format saved then',
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "site.unstage",
+  description: "Take back a site setting this chat staged, before publish \u2014 the same as discarding its row in the chat's Settings review. The key is the setting (consent, analyticsCollection, indexing, homePage, timezone, exportProfile) or customDomain:<hostname>; --all takes back every one. Never touches what is already live.",
+  args: {
+    key: { type: "string", description: "A `key` from `baker site show` \u2192 staged", required: false },
+    all: { type: "boolean", description: "Take back every staged site setting", required: false }
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show the site settings as they will be after this chat publishes, and what this chat staged.\n\nExample: baker site show"
+  },
+  args: {
+    chat: { type: "string", description: "Another chat's id, to read what it staged", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = typeof args.chat === "string" && args.chat.length > 0 ? args.chat : optionalChatId();
+      writeJson(await apiGet("/api/site", chatId ? { chatId } : void 0));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var setCommand = defineCommand({
+  meta: {
+    name: "set",
+    description: "Stage site settings; they apply when the chat is published.\n\nExamples:\n  baker site set --consent recovery\n  baker site set --collection aggregate\n  baker site set --indexing off\n  baker site set --home oferta --home-mode redirect\n  baker site set --home none\n  baker site set --timezone Europe/Madrid\n  baker site set --export-profile @profile.json"
+  },
+  args: {
+    consent: { type: "string", description: "bypass | recovery | strict | external", required: false },
+    collection: { type: "string", description: "full | aggregate | off", required: false },
+    payloads: { type: "string", description: "on | off (with --collection full)", required: false },
+    indexing: { type: "string", description: "on | off", required: false },
+    home: { type: "string", description: "Landing slug, or none", required: false },
+    "home-mode": { type: "string", description: "rewrite | redirect", required: false },
+    timezone: { type: "string", description: "IANA time zone", required: false },
+    "export-profile": {
+      type: "string",
+      description: "Fields to change, as JSON or @path; added to any staged earlier, laid over the saved format at Publish",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const inputs = parseSetArgs(
+        {
+          consent: args.consent,
+          collection: args.collection,
+          payloads: args.payloads,
+          indexing: args.indexing,
+          home: args.home,
+          "home-mode": args["home-mode"],
+          timezone: args.timezone,
+          "export-profile": args["export-profile"]
+        },
+        (path) => readFileSync(path, "utf8")
+      );
+      const body = { chatId: requireChatId(), inputs };
+      writeJson(await apiPost("/api/site/stage", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var unstageCommand = defineCommand({
+  meta: {
+    name: "unstage",
+    description: "Take back a staged site setting before publish.\n\nExamples:\n  baker site unstage consent\n  baker site unstage customDomain:shop.acme.com\n  baker site unstage --all"
+  },
+  args: {
+    key: { type: "positional", description: "The setting key from `baker site show` \u2192 staged", required: false },
+    all: { type: "boolean", description: "Take back every staged site setting", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const key = typeof args.key === "string" && args.key.length > 0 ? args.key : void 0;
+      if (key === void 0 === (args.all !== true)) {
+        throw new SiteArgsError("Pass one setting key (see `baker site show` \u2192 staged) or --all.");
+      }
+      const body = { chatId: requireChatId(), ...key ? { key } : { all: true } };
+      writeJson(await apiPost("/api/site/draft-op/remove", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var siteCommand = defineCommand({
+  meta: {
+    name: "site",
+    description: `The company's site settings: cookie consent, what Baker records, search engines, home page, time zone, landing download format, custom domains. Every change stages on this chat and applies when it is published. Subcommands: show, set, unstage, domain.
+
+Examples:
+  baker site show
+  baker site set --consent recovery --indexing on
+  baker site set --home oferta
+  baker site domain add shop.acme.com
+  baker site unstage homePage
+Full guide: __tooling__/docs/tools/baker/site.md`
+  },
+  subCommands: {
+    show: showCommand,
+    set: setCommand,
+    unstage: unstageCommand,
+    domain: () => import("./domain-RECGZXJB.js").then((m) => m.domainCommand)
+  }
+});
+export {
+  siteCommand
+};
+//# sourceMappingURL=site-4SKM7RKG.js.map