@koda-sl/baker-cli 0.495.0-dev.6b9c22aff → 0.495.0

package/dist/set-prompt-O4YAE4CE.js

@@ -0,0 +1,193 @@
+import {
+  CanvasPrepareError,
+  adaptNodes,
+  compiledPromptNodeIds,
+  prepareCanvas,
+  sceneOwnedPrompts
+} from "./chunk-GXGYTFZA.js";
+import "./chunk-I7J7YQXZ.js";
+import "./chunk-PHCIFBP3.js";
+import "./chunk-QG4MW2V4.js";
+import "./chunk-MOFMOYUA.js";
+import "./chunk-NKIBXOHT.js";
+import "./chunk-Y46FE75E.js";
+import "./chunk-Q5WBTVA7.js";
+import "./chunk-NEU5QD2C.js";
+import "./chunk-3S274625.js";
+import "./chunk-6UNOK7WV.js";
+import "./chunk-UFKO626N.js";
+import "./chunk-XRIM7NYV.js";
+import {
+  defaultRegistry,
+  validateCanvasDeep
+} from "./chunk-B7GF34FU.js";
+import "./chunk-OL7JS4NG.js";
+import "./chunk-7KHTJQGV.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-QMOYQJIN.js";
+import {
+  COPY_DIRECTIVE_HEADER
+} from "./chunk-FKYPAGKK.js";
+import "./chunk-S4VLLGTW.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-A6WKCV3V.js";
+import "./chunk-U7YR5CZL.js";
+import "./chunk-VI5YQQ63.js";
+import "./chunk-JX7BX2NB.js";
+import "./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 "./chunk-QANGHND7.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-O4YAE4CE.js.map

package/dist/setup-links-2GJYCV2A.js

@@ -0,0 +1,141 @@
+import {
+  repeatedFlagValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  failApi,
+  failValidation
+} from "./chunk-ZDAVSTEE.js";
+import "./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/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-2GJYCV2A.js.map

package/dist/site-47B6V2UX.js

@@ -0,0 +1,177 @@
+import {
+  SiteArgsError,
+  failSite,
+  parseSetArgs
+} from "./chunk-2TVXJPGR.js";
+import "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import {
+  optionalChatId,
+  requireChatId
+} from "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.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-M7AEGAYI.js").then((m) => m.domainCommand)
+  }
+});
+export {
+  siteCommand
+};
+//# sourceMappingURL=site-47B6V2UX.js.map