@koda-sl/baker-cli 0.500.0 → 0.503.0

package/dist/triggers-H4NI72VX.js

@@ -0,0 +1,142 @@
+import {
+  failApi
+} from "./chunk-XMQ7IHRF.js";
+import "./chunk-ASRS37QE.js";
+import {
+  triggerCatalogSchema
+} from "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-H4NI72VX.js.map

package/dist/unlink-OECKXYGJ.js

@@ -0,0 +1,68 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-2VPNX7EZ.js";
+import "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.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-OECKXYGJ.js.map

package/dist/unstage-TMIAYNZP.js

@@ -0,0 +1,86 @@
+import {
+  failApi,
+  failValidation,
+  validateScheduledAgentRef
+} from "./chunk-XMQ7IHRF.js";
+import "./chunk-ASRS37QE.js";
+import "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-TMIAYNZP.js.map

package/dist/update-25YPQ7ZE.js

@@ -0,0 +1,153 @@
+import {
+  AUTO_PUBLISH_ARG,
+  NARROWING_ARGS,
+  REACTION_ARGS,
+  SLACK_ARG,
+  TRIGGER_ARG_DESCRIPTION,
+  TRIGGER_KIND_LIST,
+  buildTriggerBody,
+  companiesArg,
+  companiesBody,
+  failApi,
+  failValidation,
+  parseBooleanFlag,
+  reactionBody,
+  refuseAutoPublish,
+  slackBody,
+  validateScheduledAgentRef,
+  writeOk
+} from "./chunk-XMQ7IHRF.js";
+import "./chunk-ASRS37QE.js";
+import "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/update.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "scheduled-agents.update",
+  description: "Stage an update to a published scheduled agent, or to one this chat staged (temp_agent_*).",
+  args: {
+    id: { type: "string", description: "Published scheduled agent ID or temp_agent_* draft ID", required: true },
+    name: { type: "string", description: "New name", required: false },
+    description: { type: "string", description: "New one-line description", required: false },
+    prompt: { type: "string", description: "Replacement brief \u2014 the whole of what the run does", required: false },
+    cron: { type: "string", description: "5-field cron expression; implies --trigger time.cron", required: false },
+    "run-at": {
+      type: "string",
+      description: "New one-off run time, as an ISO UTC timestamp ending in Z. Must still be in the future \u2014 a time that has passed is refused.",
+      required: false
+    },
+    trigger: { type: "string", description: TRIGGER_ARG_DESCRIPTION, required: false, enum: TRIGGER_KIND_LIST },
+    ...NARROWING_ARGS,
+    occurrences: {
+      type: "string",
+      description: "Replacement list of firings to run on, 1-based and comma-separated",
+      required: false
+    },
+    ...REACTION_ARGS,
+    ...SLACK_ARG,
+    ...companiesArg(),
+    timezone: { type: "string", description: "IANA timezone override", required: false },
+    enabled: { type: "string", description: "Replacement enabled state", required: false, enum: ["true", "false"] }
+  }
+});
+var updateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: "Stage a scheduled agent update. Examples: baker scheduled-agents update <id> --enabled false | baker scheduled-agents update <id> --trigger form.submitted --form quote"
+  },
+  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
+    },
+    name: { type: "string", description: "New name", required: false },
+    description: { type: "string", description: "New description", required: false },
+    prompt: { type: "string", description: "Replacement brief", required: false },
+    cron: { type: "string", description: "5-field cron expression", required: false },
+    "run-at": { type: "string", description: "ISO UTC timestamp ending in Z, still in the future", required: false },
+    trigger: { type: "string", description: `One of: ${TRIGGER_KIND_LIST.join(", ")}`, required: false },
+    ...NARROWING_ARGS,
+    occurrences: { type: "string", description: "Only these firings, e.g. 1 or 1,3", required: false },
+    ...REACTION_ARGS,
+    ...SLACK_ARG,
+    ...companiesArg(),
+    timezone: { type: "string", description: "IANA timezone override", required: false },
+    enabled: { type: "string", description: "true|false", required: false },
+    ...AUTO_PUBLISH_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      refuseAutoPublish(args);
+      const id = args.id || args["scheduled-agent-id"];
+      if (!id) {
+        failValidation("Scheduled agent ID is required.");
+      }
+      validateScheduledAgentRef(id);
+      const body = { id };
+      let hasPatch = false;
+      for (const key of ["name", "description", "prompt"]) {
+        if (typeof args[key] === "string") {
+          body[key] = args[key];
+          hasPatch = true;
+        }
+      }
+      const trigger = buildTriggerBody(args, { required: false });
+      if (trigger) {
+        Object.assign(body, trigger);
+        hasPatch = true;
+      }
+      const reaction = reactionBody(args);
+      if (Object.keys(reaction).length > 0) {
+        Object.assign(body, reaction);
+        hasPatch = true;
+      }
+      const slack = slackBody(args);
+      if (slack.slack !== void 0) {
+        Object.assign(body, slack);
+        hasPatch = true;
+      }
+      const companies = companiesBody(args);
+      if (companies.companies !== void 0) {
+        Object.assign(body, companies);
+        hasPatch = true;
+      }
+      const enabled = parseBooleanFlag(args.enabled, "--enabled");
+      if (enabled !== void 0) {
+        body.enabled = enabled;
+        hasPatch = true;
+      }
+      if (!hasPatch) {
+        failValidation(
+          "Provide at least one of --name, --description, --prompt, --cron, --run-at, --trigger, --occurrences, --times, --when, --payload, --cooldown, --timezone, --enabled, --slack."
+        );
+      }
+      body.chatId = requireChatId();
+      const response = await apiPost("/api/scheduled-agents/update", body);
+      writeOk(null, response.hints);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  updateCommand
+};
+//# sourceMappingURL=update-25YPQ7ZE.js.map

package/dist/update-BD5NJHNU.js

@@ -0,0 +1,99 @@
+import {
+  ACTION_PRIORITIES,
+  failApi,
+  failValidation,
+  isTempId,
+  parsePriority,
+  parseTagList,
+  writeOk
+} from "./chunk-2VPNX7EZ.js";
+import "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/update.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.update",
+  description: "Stage an update on an action (name, description, tags, and/or priority) \u2014 no claim needed; edit any action you're not working on. Accepts either a real action ID or a tempId from `baker actions create` in THIS chat (edits the still-staged task in place \u2014 use this to flesh out a task you just created instead of removing and recreating it). Applies on publish. Blocked only if another chat currently has a real action claimed. --tags REPLACES the tag set; pass --tags '' to clear. --priority accepts urgent|high|medium|low or 'none' to clear back to unset (== normal).",
+  args: {
+    id: { type: "string", description: "Action ID or tempId (temp_*) of a task staged in this chat", required: true },
+    name: { type: "string", description: "New name", required: false },
+    description: {
+      type: "string",
+      description: "New description, in markdown \u2014 `##` headings per section, `-` bullets, `**bold**` for the decisive figures. REPLACES the whole description, so carry over anything still true.",
+      required: false
+    },
+    tags: {
+      type: "string",
+      description: "Comma-separated tag slugs \u2014 REPLACES existing tags ('' clears)",
+      required: false
+    },
+    priority: {
+      type: "string",
+      description: `User priority: ${ACTION_PRIORITIES.join("|")}, or 'none' to clear.`,
+      required: false
+    }
+  }
+});
+var updateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: 'Stage an update on an action, or edit a task still staged in this chat by its tempId (no claim needed). Example: baker actions update <id-or-tempId> --description "\u2026"'
+  },
+  args: {
+    id: { type: "positional", description: "Action ID or tempId (temp_*)", required: false },
+    "action-id": { type: "string", description: "Action ID or tempId (temp_*)", required: false },
+    name: { type: "string", description: "New name", required: false },
+    description: { type: "string", description: "New description (markdown)", required: false },
+    tags: { type: "string", description: "Comma-separated tag slugs \u2014 REPLACES existing ('' clears)", required: false },
+    priority: { type: "string", description: `Priority: ${ACTION_PRIORITIES.join("|")}|none`, required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      if (!isTempId(id)) {
+        validateConvexId(id);
+      }
+      const tags = parseTagList(args.tags);
+      const priority = parsePriority(args.priority, { allowClear: true });
+      if (args.name === void 0 && args.description === void 0 && tags === void 0 && priority === void 0) {
+        failValidation("Provide at least one of --name, --description, --tags, --priority.");
+      }
+      const chatId = requireChatId();
+      await apiPost("/api/actions/update", {
+        chatId,
+        actionId: id,
+        name: args.name,
+        description: args.description,
+        ...tags !== void 0 ? { tags } : {},
+        ...priority !== void 0 ? { priority } : {}
+      });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  updateCommand
+};
+//# sourceMappingURL=update-BD5NJHNU.js.map

package/dist/update-J4IBPOO6.js

@@ -0,0 +1,64 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-2VPNX7EZ.js";
+import "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/tags/update.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.tags.update",
+  description: "Change what a company custom action tag means (its description). Applies at once, like `tags create`. The slug itself cannot be renamed \u2014 every Task carrying it stores it; to rename, create the new tag, retag the Tasks, then delete the old one. Built-in default tags cannot be changed.",
+  args: {
+    slug: { type: "string", description: "Custom tag slug to change", required: true },
+    description: { type: "string", description: "What this tag means", required: true }
+  }
+});
+var tagsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: 'Change what a custom action tag means. Example: baker actions tags update --slug pmax --description "Performance Max campaigns"'
+  },
+  args: {
+    slug: { type: "string", description: "Custom tag slug", required: false },
+    description: { type: "string", description: "What this tag means", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const slug = args.slug?.trim();
+      if (!slug) {
+        failValidation("--slug is required.");
+      }
+      const description = args.description;
+      if (description === void 0) {
+        failValidation("--description is required: what this tag means.");
+      }
+      const response = await apiPost("/api/actions/tags/update", {
+        name: slug,
+        description
+      });
+      writeOk(response.data);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  tagsUpdateCommand
+};
+//# sourceMappingURL=update-J4IBPOO6.js.map