@koda-sl/baker-cli 0.522.0 → 0.524.0-dev.3eb5500a1

package/dist/triggers-E3XWB4EZ.js

@@ -0,0 +1,144 @@
+import {
+  failApi
+} from "./chunk-AIG53YWM.js";
+import "./chunk-OW27W5X4.js";
+import {
+  triggerCatalogSchema
+} from "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-4U7HXXSA.js";
+import "./chunk-V6AAOAMM.js";
+import "./chunk-GGUQP6KI.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-L55PHMSR.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/triggers.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  trigger: {
+    type: "string",
+    description: "One trigger in full \u2014 what makes it run, what it narrows by, its payload fields. A kind (experiment.decided) or a family prefix (experiment).",
+    required: false
+  },
+  group: {
+    type: "string",
+    description: "Every trigger in one group, in full, e.g. experiments, tasks, forms. The listing names each group.",
+    required: false
+  },
+  full: {
+    type: "boolean",
+    description: "Every trigger in full (about 25 KB). Prefer --trigger or --group.",
+    required: false
+  }
+};
+registerSchema({
+  command: "scheduled-agents.triggers",
+  description: "Everything that can start a scheduled agent. Bare, a compact listing of every trigger kind by group; --trigger <kind|family> or --group <id> for what each narrows by and the payload fields it hands over. Read this before proposing automation, so the trigger you name is one that exists \u2014 a time of day is only the most obvious of them, and most of what a marketer actually wants is a reaction to something.",
+  args: ARGS
+});
+function matchesTrigger(kind, query) {
+  const family = query.replace(/\.?\*?$/, "");
+  return kind === query || kind.startsWith(`${family}.`);
+}
+function shapeTriggerCatalog(response, filter) {
+  const { trigger, group } = filter;
+  const unfiltered = trigger === void 0 && group === void 0;
+  if (unfiltered && filter.full) return { ok: true, data: response };
+  const parsed = triggerCatalogSchema.safeParse(response);
+  if (!parsed.success) {
+    return {
+      ok: false,
+      error: {
+        code: "INTERNAL_ERROR",
+        message: "The trigger list came back in a shape this version of the CLI cannot read.",
+        fix: {
+          action: "run `baker scheduled-agents triggers --full`",
+          explanation: "--full prints the whole list as the server sent it, without reading it."
+        }
+      }
+    };
+  }
+  const catalog = parsed.data;
+  if (unfiltered) {
+    return {
+      ok: true,
+      data: {
+        groups: catalog.groups.map((entry) => ({
+          group: entry.group,
+          triggers: Object.fromEntries(entry.triggers.map((t) => [t.kind, t.label]))
+        }))
+      },
+      hints: [
+        "Next: `baker scheduled-agents triggers --trigger <kind>` (or a family, e.g. --trigger experiment) for what it narrows by and the payload fields to use in --when and {{payload.<field>}}."
+      ]
+    };
+  }
+  const groups = catalog.groups.filter((entry) => group === void 0 || entry.group === group).map((entry) => ({
+    ...entry,
+    triggers: entry.triggers.filter(
+      (t) => trigger === void 0 || matchesTrigger(t.kind, trigger)
+    )
+  })).filter((entry) => entry.triggers.length > 0);
+  if (groups.length === 0) {
+    const asked = [
+      trigger === void 0 ? null : `--trigger "${trigger}"`,
+      group === void 0 ? null : `--group "${group}"`
+    ].filter(Boolean);
+    return {
+      ok: false,
+      error: {
+        code: "NOT_FOUND",
+        message: `No trigger matches ${asked.join(" ")}.`,
+        fix: {
+          action: "run `baker scheduled-agents triggers`",
+          explanation: `Groups: ${catalog.groups.map((entry) => entry.group).join(", ")}. The bare command lists every trigger kind.`
+        }
+      }
+    };
+  }
+  return { ok: true, data: { groups, reacting: catalog.reacting } };
+}
+var triggersCommand = defineCommand({
+  meta: {
+    name: "triggers",
+    description: `Everything that can start a scheduled agent.
+
+A scheduled agent is a trigger and a prompt. The trigger is the whole of the "when": a time, a cadence, a call-in from another tool, an event arriving (a HubSpot deal reaching a stage is one), a Form being submitted, an A/B test reaching an answer, a Task closing, a tool needing reconnecting, a publish leaving changes behind, a new review, a competitor launching ads.
+
+Start here: the bare command lists every trigger kind by group, compactly. Then ask for the one you picked: it says what narrows it (\`pointAt\`) and the payload fields it hands over, for --when rules ("amount > 10000") and the prompt ({{payload.amount}}).
+
+Examples:
+  baker scheduled-agents triggers
+  baker scheduled-agents triggers --trigger experiment.decided
+  baker scheduled-agents triggers --trigger experiment
+  baker scheduled-agents triggers --group tasks
+Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    try {
+      const response = await apiPost("/api/scheduled-agents/triggers", {});
+      const shaped = shapeTriggerCatalog(response.data, { trigger: args.trigger, group: args.group, full: args.full });
+      writeJson(shaped);
+      if (!shaped.ok) process.exit(1);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  shapeTriggerCatalog,
+  triggersCommand
+};
+//# sourceMappingURL=triggers-E3XWB4EZ.js.map

package/dist/unlink-OIMMKPRN.js

@@ -0,0 +1,70 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-XKRCO3JC.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-4U7HXXSA.js";
+import "./chunk-V6AAOAMM.js";
+import {
+  requireChatId
+} from "./chunk-GGUQP6KI.js";
+import {
+  registerSchema
+} from "./chunk-L55PHMSR.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/unlink.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.unlink",
+  description: "Stage removal of a 'blocker -> blocked' dependency. The blocked action must be claimed by current chat.",
+  args: {
+    blocker: { type: "string", description: "Blocker action ID", required: true },
+    blocked: { type: "string", description: "Blocked action ID (must be claimed by current chat)", required: true }
+  }
+});
+var unlinkCommand = defineCommand({
+  meta: {
+    name: "unlink",
+    description: "Stage removal of a dependency. Example: baker actions unlink --blocker <id> --blocked <id>"
+  },
+  args: {
+    blocker: { type: "string", description: "Blocker action ID", required: false },
+    blocked: { type: "string", description: "Blocked action ID", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const blocker = args.blocker;
+      const blocked = args.blocked;
+      if (!blocker || !blocked) {
+        failValidation("--blocker and --blocked are required.");
+      }
+      validateConvexId(blocker);
+      validateConvexId(blocked);
+      const chatId = requireChatId();
+      await apiPost("/api/actions/unlink", {
+        chatId,
+        blockerId: blocker,
+        blockedId: blocked
+      });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  unlinkCommand
+};
+//# sourceMappingURL=unlink-OIMMKPRN.js.map

package/dist/unstage-SP32LXDY.js

@@ -0,0 +1,88 @@
+import {
+  failApi,
+  failValidation,
+  validateScheduledAgentRef
+} from "./chunk-AIG53YWM.js";
+import "./chunk-OW27W5X4.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-4U7HXXSA.js";
+import "./chunk-V6AAOAMM.js";
+import {
+  requireChatId
+} from "./chunk-GGUQP6KI.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-L55PHMSR.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/unstage.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "scheduled-agents.unstage",
+  description: "Take back what this chat staged on one scheduled agent, before Publish \u2014 the same as discarding its row in the change list. With --index, only that one change (its `index` in `baker scheduled-agents list` \u2192 draft.ops). Taking back a create also takes back the edits staged on it. Never touches a published item: to change or remove one, stage update/delete instead.",
+  args: {
+    id: { type: "string", description: "Published scheduled agent ID or temp_agent_* draft ID", required: true },
+    index: {
+      type: "string",
+      description: "Only this staged change, by its index in `list` \u2192 draft.ops. Indexes shift after each unstage \u2014 list again before the next one.",
+      required: false
+    }
+  }
+});
+function unstageBody(args, chatId) {
+  validateScheduledAgentRef(args.ref);
+  if (args.index === void 0) {
+    return { chatId, ref: args.ref };
+  }
+  const index = Number(args.index);
+  if (args.index.trim() === "" || !Number.isInteger(index) || index < 0) {
+    failValidation(
+      "--index must be a whole number from `baker scheduled-agents list` \u2192 draft.ops[].index. Leave it off to take back everything staged on the item."
+    );
+  }
+  return { chatId, ref: args.ref, index };
+}
+var unstageCommand = defineCommand({
+  meta: {
+    name: "unstage",
+    description: "Take back what this chat staged on a scheduled agent, before Publish. Examples: baker scheduled-agents unstage temp_agent_abc123 | baker scheduled-agents unstage <id> --index 2"
+  },
+  args: {
+    id: { type: "positional", description: "Scheduled agent ID or temp_agent_* draft ID", required: false },
+    "scheduled-agent-id": {
+      type: "string",
+      description: "Scheduled agent ID (alternative to positional)",
+      required: false
+    },
+    index: { type: "string", description: "Only this staged change, from list \u2192 draft.ops[].index", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const ref = args.id || args["scheduled-agent-id"];
+      if (!ref) {
+        failValidation("Scheduled agent ID is required.");
+      }
+      const index = typeof args.index === "string" ? args.index : void 0;
+      const body = unstageBody({ ref, ...index !== void 0 ? { index } : {} }, requireChatId());
+      const response = await apiPost("/api/scheduled-agents/draft-op/remove", body);
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  unstageBody,
+  unstageCommand
+};
+//# sourceMappingURL=unstage-SP32LXDY.js.map

package/dist/unstage-XN3VC7LZ.js

@@ -0,0 +1,96 @@
+import {
+  analyticsErrorEnvelope
+} from "./chunk-2FL7NBPT.js";
+import {
+  ANALYTICS_UNSTAGE_KINDS
+} from "./chunk-PILLZPNC.js";
+import "./chunk-NKQWDEB7.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-X7DMNLDD.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiPost
+} from "./chunk-4U7HXXSA.js";
+import "./chunk-V6AAOAMM.js";
+import {
+  requireChatId
+} from "./chunk-GGUQP6KI.js";
+import {
+  registerSchema
+} from "./chunk-L55PHMSR.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/analytics/unstage.ts
+import { defineCommand } from "citty";
+var KIND_LIST = ANALYTICS_UNSTAGE_KINDS.join("|");
+registerSchema({
+  command: "analytics.unstage",
+  description: `Take back a Measure change this chat staged, before Publish \u2014 the same as discarding its row in the change review. Name one with --kind and --ref (mapping: <platform>/<name> as \`analytics map\` prints it; conversion: the event key; send: the send id; source: the source id or src_temp_*), or pass --all to take back everything staged (all kinds, or one with --kind). Never touches anything already live.`,
+  args: {
+    kind: {
+      type: "string",
+      description: `What was staged: ${KIND_LIST}`,
+      required: false,
+      enum: [...ANALYTICS_UNSTAGE_KINDS]
+    },
+    ref: { type: "string", description: "Which staged change of that kind (see the description)", required: false },
+    all: { type: "boolean", description: "Take back everything staged (of --kind, or of every kind)", required: false }
+  }
+});
+function refuse(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function isUnstageKind(value) {
+  return ANALYTICS_UNSTAGE_KINDS.includes(value);
+}
+function unstageBody(args, chatId) {
+  if (args.kind !== void 0 && !isUnstageKind(args.kind)) {
+    refuse(`--kind must be one of ${KIND_LIST}.`);
+  }
+  const kind = args.kind;
+  if (args.all === true) {
+    if (args.ref !== void 0) {
+      refuse("Pass --ref to take back one staged change, or --all for everything \u2014 not both.");
+    }
+    return { chatId, all: true, ...kind !== void 0 ? { kind } : {} };
+  }
+  if (kind === void 0 || args.ref === void 0 || args.ref.trim() === "") {
+    refuse(`Pass --kind (${KIND_LIST}) with --ref to take back one staged change, or --all for everything staged.`);
+  }
+  return { chatId, kind, ref: args.ref };
+}
+var unstageCommand = defineCommand({
+  meta: {
+    name: "unstage",
+    description: "Take back a Measure change this chat staged, before Publish. Examples: baker analytics unstage --kind conversion --ref 'page:Deal won' | baker analytics unstage --kind mapping --ref google/kw | baker analytics unstage --all"
+  },
+  args: {
+    kind: { type: "string", description: `What was staged: ${KIND_LIST}`, required: false },
+    ref: { type: "string", description: "Which staged change of that kind", required: false },
+    all: { type: "boolean", description: "Take back everything staged", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = unstageBody(
+        {
+          ...typeof args.kind === "string" ? { kind: args.kind } : {},
+          ...typeof args.ref === "string" ? { ref: args.ref } : {},
+          ...args.all === true ? { all: true } : {}
+        },
+        requireChatId()
+      );
+      const response = await apiPost("/api/analytics/draft-op/remove", body);
+      writeJsonEnvelope(response);
+    } catch (err) {
+      writeJsonEnvelope({ ok: false, error: analyticsErrorEnvelope(err) });
+      process.exit(1);
+    }
+  }
+});
+export {
+  unstageBody,
+  unstageCommand
+};
+//# sourceMappingURL=unstage-XN3VC7LZ.js.map

package/dist/update-2GAPIRWU.js

@@ -0,0 +1,192 @@
+import {
+  buildProfilePatch,
+  hasProfileEdit,
+  mergeProfile
+} from "./chunk-IJMWEO4P.js";
+import {
+  failAvatarApi,
+  failValidation,
+  updateHints
+} from "./chunk-NDFLI64C.js";
+import {
+  readAvatars,
+  writeAvatars
+} from "./chunk-UTFSUMLU.js";
+import {
+  AVATAR_HANDLE_PATTERN,
+  AVATAR_RELATIONS
+} from "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-4U7HXXSA.js";
+import "./chunk-V6AAOAMM.js";
+import "./chunk-GGUQP6KI.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-L55PHMSR.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/update.ts
+import { defineCommand } from "citty";
+
+// src/commands/avatars/relation.ts
+function relationPatch(args) {
+  const relation = typeof args.relation === "string" ? args.relation.trim().toLowerCase() : "";
+  const testimonial = typeof args.testimonial === "string" ? args.testimonial : "";
+  const ids = testimonial.split(",").map((id) => id.trim()).filter(Boolean);
+  const known = AVATAR_RELATIONS.find((r) => r === relation);
+  if (relation && !known) {
+    return { ok: false, message: `--relation "${relation}" is not one of ${AVATAR_RELATIONS.join(", ")}.` };
+  }
+  return {
+    ok: true,
+    patch: { ...known ? { relation: known } : {}, ...ids.length > 0 ? { testimonialIds: ids } : {} }
+  };
+}
+
+// src/commands/avatars/update.ts
+function readUpdateArgs(args) {
+  const handle = (args.handle || args["avatar-handle"])?.trim();
+  if (!handle) {
+    failValidation('An avatar handle is required, e.g. `baker avatars update marta --persona "\u2026"`.');
+  }
+  const name = args.name?.trim();
+  const newHandle = args["new-handle"]?.trim().toLowerCase();
+  const regenerateSheet = Boolean(args["regenerate-sheet"]);
+  const patch = buildProfilePatch(args);
+  const who = relationPatch(args);
+  if (!who.ok) failValidation(who.message);
+  if (patch.subjectDescription === "") {
+    failValidation(
+      "--subject cannot be emptied: it is what the identity sheet was built from. Replace it with a new description of the same length or better, and pass --regenerate-sheet."
+    );
+  }
+  if (newHandle && !AVATAR_HANDLE_PATTERN.test(newHandle)) {
+    failValidation(
+      `--new-handle "${newHandle}" is not usable. Use lowercase letters, numbers and dashes, starting with a letter.`
+    );
+  }
+  if (!name && !newHandle && !hasProfileEdit(patch) && !regenerateSheet && Object.keys(who.patch).length === 0) {
+    failValidation(
+      "Nothing to change. Pass at least one of --name, --new-handle, --subject, --persona, --speech, --motion, --wardrobe, --setting, --accent, --guardrails, --relation, --testimonial, --regenerate-sheet."
+    );
+  }
+  return { handle, name, newHandle, regenerateSheet, patch, who: who.patch };
+}
+registerSchema({
+  command: "avatars.update",
+  description: 'Edit an avatar: rename it, change its handle, rewrite any part of its written profile, set the accent it speaks with, or rebuild its identity sheet. Profile flags are merged over what is stored, so `--persona "\u2026"` alone leaves the subject description intact. When you change --subject, pass --regenerate-sheet in the same call \u2014 otherwise the sheet still shows the person you described before, the words and the face stop matching, and every render drifts. Rebuilding is a ~30s billed render and puts the avatar back to `generating`.',
+  args: {
+    handle: { type: "positional", description: "Handle of the avatar to edit", required: false },
+    "avatar-handle": { type: "string", description: "Handle (alternative to positional)", required: false },
+    name: { type: "string", description: "New display name", required: false },
+    "new-handle": { type: "string", description: "New mention handle (lowercase, dashes)", required: false },
+    subject: {
+      type: "string",
+      description: "Rewrite the identity description. Pass --regenerate-sheet with it, always.",
+      required: false
+    },
+    persona: { type: "string", description: "Who they are on camera", required: false },
+    speech: { type: "string", description: "How they speak", required: false },
+    motion: { type: "string", description: "Body language in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit", required: false },
+    setting: { type: "string", description: "Default surroundings", required: false },
+    guardrails: {
+      type: "string",
+      description: "Comma-separated things they must never do (replaces the stored list; empty string clears it)",
+      required: false
+    },
+    accent: {
+      type: "string",
+      description: "Where their voice is FROM, as a place: 'Spanish from Spain, Madrid accent', 'Mexican Spanish'. THE lever for how they sound \u2014 an avatar has no pinned voice (ADR 0005), so the region directed in the prompt is the only thing steering pronunciation. An adjective like 'clear Spanish accent' is read as NO accent and the clip comes out sounding like nowhere.",
+      required: false
+    },
+    relation: {
+      type: "string",
+      description: "Who this person is to the company: team | founder | customer | partner | creator | role. A customer, partner or creator face appears only in an ad quoting their own published words; only team, founder and role faces are cast freely.",
+      required: false
+    },
+    testimonial: {
+      type: "string",
+      description: "Comma-separated testimonial ids this person gave (their quotes may carry their face in an ad)",
+      required: false
+    },
+    "regenerate-sheet": {
+      type: "boolean",
+      description: "Rebuild the identity sheet (~30s, billed). Required whenever --subject changed.",
+      required: false,
+      default: false
+    }
+  }
+});
+var updateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: 'Edit an avatar; profile flags merge over what is stored. Example: baker avatars update marta --subject "woman in her early 50s, silver bob" --regenerate-sheet'
+  },
+  args: {
+    handle: { type: "positional", description: "Handle of the avatar to edit", required: false },
+    "avatar-handle": { type: "string", description: "Handle (alternative to positional)", required: false },
+    name: { type: "string", description: "New display name", required: false },
+    "new-handle": { type: "string", description: "New mention handle", required: false },
+    subject: { type: "string", description: "Rewrite the identity description", required: false },
+    persona: { type: "string", description: "Who they are on camera", required: false },
+    speech: { type: "string", description: "How they speak", required: false },
+    motion: { type: "string", description: "Body language in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit", required: false },
+    setting: { type: "string", description: "Default surroundings", required: false },
+    guardrails: { type: "string", description: "Comma-separated rules (empty string clears)", required: false },
+    accent: { type: "string", description: "Where their voice is FROM, as a place", required: false },
+    relation: { type: "string", description: "team | founder | customer | partner | creator | role", required: false },
+    testimonial: { type: "string", description: "Comma-separated testimonial ids this person gave", required: false },
+    "regenerate-sheet": {
+      type: "boolean",
+      description: "Rebuild the identity sheet (~30s, billed)",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    const { handle, name, newHandle, regenerateSheet, patch, who } = readUpdateArgs(args);
+    try {
+      let profile;
+      let subjectChanged = false;
+      if (hasProfileEdit(patch)) {
+        const current = await readAvatars("/api/avatars/get", { handle, full: "1" });
+        profile = mergeProfile(current.profile, patch);
+        subjectChanged = profile.subjectDescription !== current.profile.subjectDescription;
+      }
+      const body = {
+        handle,
+        ...name ? { name } : {},
+        ...newHandle ? { newHandle } : {},
+        ...profile ? { profile } : {},
+        ...regenerateSheet ? { regenerateSheet: true } : {},
+        ...who
+      };
+      const data = await writeAvatars("/api/avatars/update", body);
+      writeJson({
+        ok: true,
+        data,
+        hints: updateHints({
+          avatar: data.avatar,
+          subjectChanged,
+          regeneratedSheet: regenerateSheet,
+          previousHandle: handle
+        })
+      });
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+export {
+  updateCommand
+};
+//# sourceMappingURL=update-2GAPIRWU.js.map