@koda-sl/baker-cli 0.491.0 → 0.492.0

package/dist/add-44SGKTS4.js

@@ -0,0 +1,97 @@
+import {
+  reportError
+} from "./chunk-Y4OYFJP7.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/add.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "landing.inspiration.add",
+  description: "Add someone else's landing page to the reference library and save it to this company. Returns immediately \u2014 studying a page takes a few minutes, so never wait on it. Use it when the client names a site they admire, or when you find a competitor page worth learning from. Never point it at a page we built: it is refused, because the source is already in the project and reading a screenshot of it tells you less than opening the file.",
+  args: {
+    url: { type: "string", description: "Landing page address", required: true },
+    note: { type: "string", description: "Why this page is worth keeping", required: false },
+    refresh: {
+      type: "boolean",
+      description: "Study the page again even if it is already in the library. Use when the user says the page has changed or the saved sections look outdated",
+      required: false
+    }
+  }
+});
+function addHints(data, { refresh }) {
+  if (data.refreshDeclined === "studying") {
+    return [
+      "This page is already being studied \u2014 no second study was started. Search for it later in the turn or in a later one."
+    ];
+  }
+  if (data.refreshDeclined === "too_soon") {
+    return [
+      "This page was just studied a few minutes ago, so it was not studied again \u2014 its sections are already current.",
+      `Search it with: baker landing inspiration search --domain ${new URL(data.canonicalUrl).hostname}`
+    ];
+  }
+  if (data.alreadyKnown) {
+    return [
+      "This page was already in the library, so nothing was re-studied \u2014 its sections are searchable now.",
+      `Search it with: baker landing inspiration search --domain ${new URL(data.canonicalUrl).hostname}`,
+      "If the user says the live page looks different from what the library shows, run this again with --refresh."
+    ];
+  }
+  return [
+    refresh ? "Studying it again from the live site \u2014 this takes a few minutes. Until it lands, search results still show the old version, so don't build from them yet." : "Studying this page takes a few minutes. Don't wait on it \u2014 carry on, and search for it later in the turn or in a later one.",
+    "Meanwhile, search what is already in the library: baker landing inspiration search '<what you want to see>' --scope all",
+    "This is saved and being studied now, so it is listed as already applied \u2014 tell the user it is kept whatever they do with this chat.",
+    // The save is not a promise that the study succeeded. An agent that
+    // assumes it did will later search its own favorites, find nothing,
+    // and have no idea why.
+    "The save sticks even if the page turns out to be unreadable \u2014 `baker landing inspiration favorites` reports those separately as unreadable, so check there rather than assuming this page is searchable."
+  ];
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Add someone else's landing page to the reference library. Example: baker landing inspiration add https://linear.app --note 'the client likes this density'. Add --refresh to study a saved page again after the site changed"
+  },
+  args: {
+    url: { type: "positional", description: "Landing page address", required: true },
+    note: { type: "string", description: "Why this page is worth keeping", required: false },
+    refresh: {
+      type: "boolean",
+      description: "Study it again even if it is already in the library",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiPost("/api/landing-inspiration/add", {
+        url: args.url,
+        note: args.note,
+        favorite: true,
+        refresh: args.refresh || void 0
+      });
+      const hints = addHints(data, { refresh: args.refresh });
+      writeJson({
+        ok: true,
+        data: { id: data.sourceId, url: data.canonicalUrl, status: data.status, already_known: data.alreadyKnown },
+        hints
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+export {
+  addCommand,
+  addHints
+};
+//# sourceMappingURL=add-44SGKTS4.js.map

package/dist/add-6DDU34GR.js

@@ -0,0 +1,81 @@
+import {
+  PLATFORM_NAMES,
+  reportError
+} from "./chunk-LK6W5FDV.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  brandAccountInput,
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/add.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.add",
+  description: "Add a brand to Baker's ads library WITHOUT following it: every account its website links, on every platform (Meta, LinkedIn, TikTok, Google Ads) and in every country, collected into the library so `profile`, `ads` and `landings` can read it. Nobody follows it and it never shows in anyone's feed. For a brand you study rather than track \u2014 above all a client being set up, from an organization's workspace. Start here: baker winning-ads advertisers \"<domain>\"; when the brand is not there, baker winning-ads add \"<domain>\". A company's own competitor is `follow`, not this.",
+  args: {
+    input: {
+      type: "string",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    }
+  }
+});
+function readNext(advertiserId) {
+  return `baker winning-ads profile ${advertiserId} (the platforms it runs on, how many ads, its estimated spend, its landing pages), then baker winning-ads ads ${advertiserId} --running running for the creatives and baker winning-ads landings ${advertiserId} --analyse for what each landing sells and how`;
+}
+function addHints(data) {
+  const names = data.suggestions.map((s) => `${s.name} (${PLATFORM_NAMES[s.platform]})`).join(", ");
+  if (data.status === "unconfirmed") {
+    const [first] = data.suggestions;
+    return [
+      `Nothing added: we found no account we're sure is this brand's, only accounts named like it: ${names}. Check each one's ad library, then add the brand's own by its link, e.g. baker winning-ads add "${first ? brandAccountInput(first) : ""}". Or retry with the brand's website.`
+    ];
+  }
+  if (data.status === "ambiguous" || data.advertiser_id === null) {
+    return [
+      "These accounts belong to more than one brand already in the library. Read the one in `candidates` that is this brand (its name and website), with baker winning-ads profile <advertiser_id>."
+    ];
+  }
+  const hints = data.collecting > 0 ? [
+    `Its ads are being collected from ${data.collecting} account${data.collecting === 1 ? "" : "s"}: a few minutes, longer for a big advertiser. Read the other sources meanwhile, then ${readNext(data.advertiser_id)}. An empty profile means they are still arriving.`
+  ] : [`Already in the library. Read ${readNext(data.advertiser_id)}.`];
+  if (data.suggestions.length > 0) {
+    hints.push(
+      `Also found accounts only named like this brand, not added: ${names}. Add one that is its own (another country's page) with baker winning-ads add "<its link>".`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: `Add a brand's ads to Baker's library without following it, so profile, ads and landings can read them. Example: baker winning-ads add "barkibu.com"`
+  },
+  args: {
+    input: {
+      type: "positional",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiPost("/api/ad-library/add", { input: String(args.input) });
+      writeJson({ ok: true, data, hints: addHints(data) });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addHints
+};
+//# sourceMappingURL=add-6DDU34GR.js.map

package/dist/add-6DDU34GR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/add.ts"],"sourcesContent":["import { brandAccountInput, type LibraryAddResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { PLATFORM_NAMES, reportError } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"winning-ads.add\",\n  description:\n    \"Add a brand to Baker's ads library WITHOUT following it: every account its website links, on every platform (Meta, LinkedIn, TikTok, Google Ads) and in every country, collected into the library so `profile`, `ads` and `landings` can read it. Nobody follows it and it never shows in anyone's feed. For a brand you study rather than track — above all a client being set up, from an organization's workspace. Start here: baker winning-ads advertisers \\\"<domain>\\\"; when the brand is not there, baker winning-ads add \\\"<domain>\\\". A company's own competitor is `follow`, not this.\",\n  args: {\n    input: {\n      type: \"string\",\n      description: \"Website (best), brand name, or any profile/ad-library link\",\n      required: true,\n    },\n  },\n});\n\n/** What to read once the brand's ads are in the library. */\nfunction readNext(advertiserId: string): string {\n  return `baker winning-ads profile ${advertiserId} (the platforms it runs on, how many ads, its estimated spend, its landing pages), then baker winning-ads ads ${advertiserId} --running running for the creatives and baker winning-ads landings ${advertiserId} --analyse for what each landing sells and how`;\n}\n\n/** What the agent reads after an add: whether the ads are there yet, and what to read once they are. */\nexport function addHints(data: LibraryAddResponse): string[] {\n  const names = data.suggestions.map((s) => `${s.name} (${PLATFORM_NAMES[s.platform]})`).join(\", \");\n  if (data.status === \"unconfirmed\") {\n    const [first] = data.suggestions;\n    return [\n      `Nothing added: we found no account we're sure is this brand's, only accounts named like it: ${names}. Check each one's ad library, then add the brand's own by its link, e.g. baker winning-ads add \"${first ? brandAccountInput(first) : \"\"}\". Or retry with the brand's website.`,\n    ];\n  }\n  if (data.status === \"ambiguous\" || data.advertiser_id === null) {\n    return [\n      \"These accounts belong to more than one brand already in the library. Read the one in `candidates` that is this brand (its name and website), with baker winning-ads profile <advertiser_id>.\",\n    ];\n  }\n  const hints =\n    data.collecting > 0\n      ? [\n          `Its ads are being collected from ${data.collecting} account${data.collecting === 1 ? \"\" : \"s\"}: a few minutes, longer for a big advertiser. Read the other sources meanwhile, then ${readNext(data.advertiser_id)}. An empty profile means they are still arriving.`,\n        ]\n      : [`Already in the library. Read ${readNext(data.advertiser_id)}.`];\n  if (data.suggestions.length > 0) {\n    hints.push(\n      `Also found accounts only named like this brand, not added: ${names}. Add one that is its own (another country's page) with baker winning-ads add \"<its link>\".`,\n    );\n  }\n  return hints;\n}\n\nexport const addCommand = defineCommand({\n  meta: {\n    name: \"add\",\n    description:\n      \"Add a brand's ads to Baker's library without following it, so profile, ads and landings can read them. Example: baker winning-ads add \\\"barkibu.com\\\"\",\n  },\n  args: {\n    input: {\n      type: \"positional\",\n      description: \"Website (best), brand name, or any profile/ad-library link\",\n      required: true,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const data = await apiPost<LibraryAddResponse>(\"/api/ad-library/add\", { input: String(args.input) });\n      writeJson({ ok: true, data, hints: addHints(data) });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAGD,SAAS,SAAS,cAA8B;AAC9C,SAAO,6BAA6B,YAAY,iHAAiH,YAAY,uEAAuE,YAAY;AAClQ;AAGO,SAAS,SAAS,MAAoC;AAC3D,QAAM,QAAQ,KAAK,YAAY,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,KAAK,eAAe,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,IAAI;AAChG,MAAI,KAAK,WAAW,eAAe;AACjC,UAAM,CAAC,KAAK,IAAI,KAAK;AACrB,WAAO;AAAA,MACL,+FAA+F,KAAK,oGAAoG,QAAQ,kBAAkB,KAAK,IAAI,EAAE;AAAA,IAC/O;AAAA,EACF;AACA,MAAI,KAAK,WAAW,eAAe,KAAK,kBAAkB,MAAM;AAC9D,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AACA,QAAM,QACJ,KAAK,aAAa,IACd;AAAA,IACE,oCAAoC,KAAK,UAAU,WAAW,KAAK,eAAe,IAAI,KAAK,GAAG,wFAAwF,SAAS,KAAK,aAAa,CAAC;AAAA,EACpN,IACA,CAAC,gCAAgC,SAAS,KAAK,aAAa,CAAC,GAAG;AACtE,MAAI,KAAK,YAAY,SAAS,GAAG;AAC/B,UAAM;AAAA,MACJ,8DAA8D,KAAK;AAAA,IACrE;AAAA,EACF;AACA,SAAO;AACT;AAEO,IAAM,aAAa,cAAc;AAAA,EACtC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAO,MAAM,QAA4B,uBAAuB,EAAE,OAAO,OAAO,KAAK,KAAK,EAAE,CAAC;AACnG,gBAAU,EAAE,IAAI,MAAM,MAAM,OAAO,SAAS,IAAI,EAAE,CAAC;AAAA,IACrD,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/add-6K6LO7CM.js

@@ -0,0 +1,104 @@
+import {
+  compactSource,
+  reportError,
+  reportInvalid
+} from "./chunk-RVTXDQYC.js";
+import {
+  testimonialSourceRefreshIntervalSchema,
+  testimonialSourceTypeSchema,
+  testimonialSourcesAddRequestSchema
+} from "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/add.ts
+import { defineCommand } from "citty";
+var SITES = testimonialSourceTypeSchema.options.join("|");
+registerSchema({
+  command: "testimonials.sources.add",
+  description: "Add a review page as a testimonial source \u2014 Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store or Google Play. Pass the page's link (it names its own site), or a business name for Google Maps. Its reviews (up to 700) are imported, tagged and made searchable in the background over the next minutes. Each imported review costs a little, so add only the client's own listings the user asked for. Applies immediately and shows on the chat as an already-applied change. Adding a listing that is already a source is a no-op that starts a fresh import.",
+  args: {
+    input: {
+      type: "string",
+      description: "The review page's link, or a business name (Google Maps only)",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: `Only to force a site: ${SITES}. A bare domain with trustpilot is that company's Trustpilot page.`,
+      required: false
+    },
+    every: {
+      type: "string",
+      description: `Auto-sync cadence: ${testimonialSourceRefreshIntervalSchema.options.join("|")} (default never)`,
+      required: false
+    }
+  }
+});
+function addSourceHints(input, { created, source }) {
+  const hints = [
+    created ? `Added ${source.label} on ${source.platformLabel}. Its reviews are importing in the background \u2014 they become searchable with \`baker testimonials search\` as each one is analysed, usually within a few minutes. Don't wait on them in this turn; check with \`baker testimonials sources list\`.` : `${source.label} on ${source.platformLabel} was already a source; a fresh import was started if one wasn't running.`
+  ];
+  if (created && source.platform === "google" && !/^https?:\/\/|\.[a-z]{2,}\//i.test(input.trim())) {
+    hints.push(
+      `Matched the name to ${source.label} on Google Maps (${source.pageUrl ?? "no link"}). If that is not the client's business, run \`baker testimonials sources remove ${source.id}\` at once and add the listing's Google Maps link instead.`
+    );
+  }
+  if (source.refreshInterval === "never") {
+    hints.push(
+      `Auto-sync is off. If the user wants new reviews to keep arriving: \`baker testimonials sources schedule ${source.id} --every monthly\`.`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: `Add a review page as a testimonial source. Start here with the page's link; for Google Maps a business name also works.
+
+Examples:
+  baker testimonials sources add https://www.yelp.com/biz/acme-bakery-madrid
+  baker testimonials sources add https://www.g2.com/products/acme --every monthly
+  baker testimonials sources add "Acme Bakery Madrid"          # Google Maps, found by name
+  baker testimonials sources add acme.com --platform trustpilot`
+  },
+  args: {
+    input: { type: "positional", description: "Review page link, or a business name for Google Maps", required: true },
+    platform: { type: "string", description: `Force a site: ${SITES}`, required: false },
+    every: { type: "string", description: "Auto-sync: never|daily|weekly|monthly", required: false }
+  },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesAddRequestSchema.safeParse({
+      input: String(args.input ?? ""),
+      platform: args.platform ? String(args.platform).toLowerCase().replace(/[\s-]/g, "_") : void 0,
+      every: args.every ? String(args.every).toLowerCase() : void 0
+    });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/add", parsed.data, {
+        timeoutMs: 12e4
+      });
+      const hints = addSourceHints(parsed.data.input, data);
+      writeJson({ ok: true, data: { created: data.created, source: compactSource(data.source) }, hints });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addSourceHints
+};
+//# sourceMappingURL=add-6K6LO7CM.js.map

package/dist/add-LYDJZDGO.js

@@ -0,0 +1,302 @@
+import {
+  flowDataPath,
+  isUsableStepNameKey,
+  readFlowTree,
+  requestFlowInputCall,
+  stepNameKey,
+  walkNodes,
+  writeFlowTree
+} from "./chunk-Q3LXLWZY.js";
+import {
+  flowCatalogEntry,
+  flowCatalogTypes,
+  flowNodeTriggers
+} from "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/flows/add.ts
+import { randomUUID } from "crypto";
+import { defineCommand } from "citty";
+function unknownType(kind, type) {
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: `No ${kind} type "${type}".`,
+      fix: `Known types: ${flowCatalogTypes(kind).join(", ")}. See: baker flows schema ${kind}`
+    }
+  });
+  process.exit(1);
+}
+function concrete(skeleton, replacements) {
+  return { ...structuredClone(skeleton), ...replacements };
+}
+function stepNameRefusal(nodes, name) {
+  const key = stepNameKey(name);
+  if (!isUsableStepNameKey(key)) {
+    return {
+      message: `"${name}" cannot be a step name: it becomes the constant \`${key || "(empty)"}\`, which is not a valid identifier.`,
+      fix: 'A step name becomes `export const <NAME> = \u2026` in the form\'s generated code, so it must start with a letter and hold only letters, digits, spaces and dashes. Try "Your Details" rather than "1. Your details".'
+    };
+  }
+  const clash = nodes.find((node) => typeof node.name === "string" && stepNameKey(node.name) === key);
+  if (!clash) return null;
+  return {
+    message: `This form already has a step named "${clash.name}", which collides with "${name}".`,
+    fix: `Both become the constant \`${key}\`, and the form's generated code cannot hold it twice. Pick a name that differs by more than case, spacing or punctuation.`
+  };
+}
+registerSchema({
+  command: "flows.add-node",
+  description: "Add a step to a form with a valid skeleton \u2014 fresh UUID, explicit condition, correct nodeData discriminator, and form.external:null for a widget. Author its copy and conditions afterwards by editing _data.json.",
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    type: { type: "string", description: "Node type (see: baker flows schema node)", required: true },
+    name: { type: "string", description: "Step name \u2014 unique, Title Case", required: true },
+    parent: { type: "string", description: "Parent node id. Omit to append to the root's children.", required: false }
+  }
+});
+var addNodeCommand = defineCommand({
+  meta: {
+    name: "add-node",
+    description: 'Add a step to a form, with the skeleton its type requires. Example: baker flows add-node contact --type customForm --name "Contact Info"'
+  },
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    type: { type: "string", description: "Node type", required: true },
+    name: { type: "string", description: "Step name \u2014 unique, Title Case", required: true },
+    parent: { type: "string", description: "Parent node id (default: the root)" }
+  },
+  run: ({ args }) => {
+    const slug = String(args.slug);
+    const type = String(args.type);
+    const name = String(args.name).trim();
+    const entry = flowCatalogEntry("node", type) ?? unknownType("node", type);
+    const tree = readFlowTree(slug);
+    const nodes = walkNodes(tree);
+    const refusal = stepNameRefusal(nodes, name);
+    if (refusal) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: refusal.message.replace("This form", `"${slug}"`),
+          fix: refusal.fix
+        }
+      });
+      process.exit(1);
+    }
+    const parent = args.parent ? nodes.find((node2) => node2.id === String(args.parent)) : tree;
+    if (!parent) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "NOT_FOUND",
+          message: `No node with id "${args.parent}" in "${slug}".`,
+          fix: `Nodes in this form: ${nodes.map((node2) => `${node2.id} (${node2.name})`).join(", ")}`
+        }
+      });
+      process.exit(1);
+    }
+    const node = concrete(entry.skeleton, { id: randomUUID(), name });
+    if (!Array.isArray(parent.children)) parent.children = [];
+    parent.children.push(node);
+    writeFlowTree(slug, tree);
+    writeJson({
+      ok: true,
+      data: { slug, nodeId: node.id, type, parentId: parent.id ?? null, path: flowDataPath(slug) },
+      hints: [
+        `Now fill in this step's \`ai\` field and its copy by editing ${flowDataPath(slug)}.`,
+        // Said on every step added, because the moment a Form's shape changes
+        // is the moment its outcome can move — and a Form nobody named an
+        // outcome for reports zero conversions rather than an error.
+        `Say what this Form counts before you finish: \`baker analytics conversions --flow ${slug}\` lists every ending already spelled as an event key, including this step's. Nothing in _data.json decides it.`,
+        ...entry.owners?.["nodeData.form.external"] === "request_flow_input" ? [
+          `Pick this ${type} step's resource: ${requestFlowInputCall(slug, pendingItem("node", String(node.id), type))}.`
+        ] : [],
+        ...entry.gotcha ? [entry.gotcha] : []
+      ]
+    });
+  }
+});
+function resolveTrigger(node, requested) {
+  const triggers = flowNodeTriggers(node.nodeData);
+  const where = `Step "${String(node.name ?? node.id)}"${triggers.type ? ` (a ${triggers.type} step)` : ""}`;
+  const raises = triggers.available.length > 0 ? `It raises: ${triggers.available.join(", ")}.` : triggers.why ?? "";
+  const no = (message, fix) => ({ ok: false, message, fix });
+  if (!triggers.known) {
+    return requested ? { ok: true, triggerId: requested } : no(`${where} is not a node type this command knows, so --trigger is required.`, triggers.why ?? "");
+  }
+  if (requested) {
+    return triggers.available.includes(requested) ? { ok: true, triggerId: requested } : no(
+      `${where} never raises \`${requested}\`, so a side effect carrying it would be written, pass every check, and never run.`,
+      raises
+    );
+  }
+  return triggers.completion ? { ok: true, triggerId: triggers.completion } : no(`${where} has no trigger a side effect can answer.`, raises);
+}
+function freeSideEffectId(type, taken) {
+  for (let n = 1; ; n++) {
+    const candidate = `se-${type}-${n}`;
+    if (!taken.has(candidate)) return candidate;
+  }
+}
+function sameTrackingSideEffect(node, type, triggerId) {
+  if (flowCatalogEntry("side-effect", type)?.owners?.tagIds !== "tags") return null;
+  const effects = Array.isArray(node.sideEffects) ? node.sideEffects : [];
+  for (const raw of effects) {
+    const effect = raw;
+    if (effect?.type === type && effect.triggerId === triggerId) return effect;
+  }
+  return null;
+}
+function secondPixelHint(node, type, triggerId) {
+  const already = sameTrackingSideEffect(node, type, triggerId);
+  if (!already) return null;
+  const event = typeof already.eventName === "string" ? ` with event "${already.eventName}"` : "";
+  return `"${String(node.name ?? node.id)}" already reports \`${triggerId}\` to ${type} as "${String(already.id)}"${event}. Give this one a different event; to change that conversion, edit "${String(already.id)}" and delete this one \u2014 the same event to the same tag counts every conversion twice.`;
+}
+function pendingItem(target, nodeId, kind, sideEffectId) {
+  return {
+    target,
+    nodeId,
+    kind,
+    status: `${kind} \u2014 not configured`,
+    needsInput: true,
+    ...sideEffectId ? { sideEffectId } : {}
+  };
+}
+function configureHints(slug, nodeId, id, type, needsCard) {
+  if (!needsCard) return [];
+  return [
+    `Configure it: ${requestFlowInputCall(slug, pendingItem("sideEffect", nodeId, type, id))}. Read the destination off that call's result.`
+  ];
+}
+registerSchema({
+  command: "flows.add-side-effect",
+  description: "Add a side effect to a step with a valid skeleton \u2014 encryptedConfig:null for a CRM, a tagIds slot for a pixel, and no oauthProviderId key. Then set where it sends with `baker flows connect` (an email: --email/--subject, written by you); only a typed secret goes to request_flow_input.",
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    node: { type: "string", description: "Id of the step that fires it", required: true },
+    type: { type: "string", description: "Side-effect type (see: baker flows schema side-effect)", required: true },
+    id: { type: "string", description: "Side-effect id. Defaults to se-{type}-{n}.", required: false },
+    trigger: {
+      type: "string",
+      description: "triggerId. Defaults to the moment the step named by --node completes, which is a different id per node type. Pass this only for a non-completion moment (a HubSpot form's onFormReady, a Calendly page view, one of several iframe events); an id the step never raises is refused.",
+      required: false
+    }
+  }
+});
+var addSideEffectCommand = defineCommand({
+  meta: {
+    name: "add-side-effect",
+    description: "Add a side effect to a step, with the skeleton its type requires. Example: baker flows add-side-effect contact --node <id> --type googleSpreadsheet"
+  },
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    node: { type: "string", description: "Id of the step that fires it", required: true },
+    type: { type: "string", description: "Side-effect type", required: true },
+    id: { type: "string", description: "Side-effect id (default se-{type}-{n})" },
+    trigger: {
+      type: "string",
+      description: "triggerId, for a non-completion moment. Default: whatever the step named by --node raises"
+    }
+  },
+  run: ({ args }) => {
+    const slug = String(args.slug);
+    const type = String(args.type);
+    const entry = flowCatalogEntry("side-effect", type) ?? unknownType("side-effect", type);
+    const tree = readFlowTree(slug);
+    const nodes = walkNodes(tree);
+    const node = nodes.find((candidate) => candidate.id === String(args.node));
+    if (!node) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "NOT_FOUND",
+          message: `No node with id "${args.node}" in "${slug}".`,
+          fix: `Nodes in this form: ${nodes.map((candidate) => `${candidate.id} (${candidate.name})`).join(", ")}`
+        }
+      });
+      process.exit(1);
+    }
+    if (!Array.isArray(node.sideEffects)) node.sideEffects = [];
+    const existing = node.sideEffects;
+    const takenIds = new Set(
+      nodes.flatMap((n) => (n.sideEffects ?? []).map((se) => String(se?.id ?? "")))
+    );
+    const id = args.id ? String(args.id) : freeSideEffectId(type, takenIds);
+    if (takenIds.has(id)) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: `"${slug}" already has a side effect with id "${id}".`,
+          fix: `Drop --id to be given a free one (${freeSideEffectId(type, takenIds)}), or pick another.`
+        }
+      });
+      process.exit(1);
+    }
+    const trigger = resolveTrigger(node, args.trigger ? String(args.trigger) : void 0);
+    if (!trigger.ok) {
+      writeJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: trigger.message, ...trigger.fix ? { fix: trigger.fix } : {} }
+      });
+      process.exit(1);
+    }
+    const triggerId = trigger.triggerId;
+    const secondPixel = secondPixelHint(node, type, triggerId);
+    const sideEffect = concrete(entry.skeleton, { id, triggerId });
+    existing.push(sideEffect);
+    writeFlowTree(slug, tree);
+    const needsUser = Object.entries(entry.owners ?? {}).filter(([, owner]) => owner !== "agent");
+    writeJson({
+      ok: true,
+      data: { slug, nodeId: node.id, sideEffectId: id, type, triggerId, path: flowDataPath(slug) },
+      hints: [
+        `Fires on \`${triggerId}\` \u2014 the moment "${String(node.name ?? node.id)}" raises. A side effect only runs when its triggerId is the one its own step raises, so this is set from the step, never from the side-effect type.`,
+        // A pixel side effect is the thing most often mistaken for "setting the
+        // conversion". It tells the ad platform; it tells Baker nothing, and a
+        // Form can fire every pixel it has while every Baker report says it
+        // converted nobody.
+        ...needsUser.some(([, owner]) => owner === "tags") ? [
+          `This reports the conversion to ${type}. It does NOT make Baker count anything: what Baker counts is a named event, set with \`baker analytics conversions --flow ${slug}\`. Do both \u2014 they are two different systems asked the same question.`
+        ] : [],
+        ...secondPixel ? [secondPixel] : [],
+        ...configureHints(
+          slug,
+          String(node.id),
+          id,
+          type,
+          needsUser.some(([, owner]) => owner === "request_flow_input" || owner === "connect")
+        ),
+        ...needsUser.some(([, owner]) => owner === "tags") ? [
+          "Fill `tagIds` with a real ref from `baker tags list`, or stage the tag first with the `tags` skill. Never invent one."
+        ] : [],
+        ...entry.gotcha ? [entry.gotcha] : []
+      ]
+    });
+  }
+});
+export {
+  addNodeCommand,
+  addSideEffectCommand,
+  freeSideEffectId,
+  resolveTrigger,
+  sameTrackingSideEffect,
+  secondPixelHint,
+  stepNameRefusal
+};
+//# sourceMappingURL=add-LYDJZDGO.js.map