@koda-sl/baker-cli 0.545.0 → 0.546.0-dev.a72c87f73

package/dist/schedule-7OKUUJHO.js

@@ -0,0 +1,64 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-F4QA4J2S.js";
+import {
+  testimonialSourceRefreshIntervalSchema,
+  testimonialSourcesScheduleRequestSchema
+} from "./chunk-UKIS6BLM.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-H4CLWLYF.js";
+import {
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/schedule.ts
+import { defineCommand } from "citty";
+var INTERVALS = testimonialSourceRefreshIntervalSchema.options.join("|");
+registerSchema({
+  command: "testimonials.sources.schedule",
+  description: "Set how often a review source imports its new reviews on its own.",
+  args: {
+    id: { type: "string", description: "Source id from `testimonials sources list`", required: true },
+    every: { type: "string", description: `Auto-sync cadence: ${INTERVALS}`, required: true }
+  }
+});
+var scheduleCommand = defineCommand({
+  meta: {
+    name: "schedule",
+    description: "Set a review source's auto-sync cadence.\n\nExample: baker testimonials sources schedule <source-id> --every monthly"
+  },
+  args: {
+    id: { type: "positional", description: "Source id from `testimonials sources list`", required: true },
+    every: { type: "string", description: INTERVALS, required: true }
+  },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesScheduleRequestSchema.safeParse({
+      id: String(args.id ?? ""),
+      every: String(args.every ?? "").toLowerCase()
+    });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/schedule", parsed.data);
+      writeJson({ ok: true, data: { id: data.id, autoSync: parsed.data.every } });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  scheduleCommand
+};
+//# sourceMappingURL=schedule-7OKUUJHO.js.map

package/dist/scheduled-agents-N6FDAL7K.js

@@ -0,0 +1,55 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/index.ts
+import { defineCommand } from "citty";
+var scheduledAgentsCommand = defineCommand({
+  meta: {
+    name: "scheduled-agents",
+    description: `Manage Scheduled agents. Subcommands: list, get, history, triggers, targets, create, update, delete, unstage, run.
+
+A scheduled agent is a **trigger** and a **prompt**, and nothing else. The trigger is the whole of the "when" \u2014 a time, a cadence, a call-in from another tool, an event arriving, a Form being submitted, an A/B test finishing, a Task closing. The prompt is the whole of the "what": when the trigger fires, a Session opens with that prompt and does the job. There is no Task in between.
+
+Keep the prompt short: the outcome, the exact \`baker\` commands (or tools) to run with their flags, and what to report. A few lines, not an essay \u2014 the run already knows how to work.
+
+Start with \`triggers\`: a time of day is only the most obvious way to start one, and most of what a marketer actually wants is a reaction to something. Then \`targets\` to point it at one thing \u2014 this Task, that agent's publish, one competitor \u2014 rather than every one.
+
+Drafts: create/update/delete stage changes on BAKER_CHAT_ID and apply when the chat is published; \`unstage\` takes one back before then. \`run\` fires a published item immediately. \`get\` on a published item says who its runs act as and which tools they load (runsAs). \`history\` lists every time it was triggered \u2014 the runs, and the firings that did not run and why.
+
+For a condition no field rule can express ("only leads from real companies"), add \`--ai-check "<condition in plain words>"\`: AI judges what arrived against it, after the --when rules.
+
+Publishing every run's work unreviewed is the user's switch, on the item \u2014 not a flag. Ask them to turn it on after this chat is published.
+
+Examples:
+  baker scheduled-agents triggers
+  baker scheduled-agents targets --trigger task.claimed --field taskId
+  baker scheduled-agents list
+  baker scheduled-agents get <id-or-temp_agent_id>
+  baker scheduled-agents history <id> --only skipped --full
+  baker scheduled-agents create --name "Weekly search check" --description "..." --prompt "Run \`baker gsc query --preset top-queries --days 28\`. Report the five queries that lost the most clicks and the page each ranks with." --cron "0 9 * * MON"
+  baker scheduled-agents create --name "Chase a new lead" --description "..." --prompt "..." --trigger form.submitted --form quote
+  baker scheduled-agents create --name "Chase company leads" --description "..." --prompt "..." --trigger form.submitted --form demo --ai-check "the person writes on behalf of a company, not as a student or for personal use"
+  baker scheduled-agents create --name "Welcome the first signup" --description "..." --prompt "..." --trigger event.received --event signup --occurrences 1
+  baker scheduled-agents create --name "Check the SEO agent's work" --description "..." --prompt "..." --trigger session.published --agent <id>
+  baker scheduled-agents update <id-or-temp_agent_id> --enabled false
+  baker scheduled-agents delete <id-or-temp_agent_id>
+  baker scheduled-agents unstage <id-or-temp_agent_id> [--index <n>]
+  baker scheduled-agents run <id>
+Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
+  },
+  subCommands: {
+    list: () => import("./list-ALQGX6JI.js").then((m) => m.listCommand),
+    get: () => import("./get-ZPJFKFHL.js").then((m) => m.getCommand),
+    history: () => import("./history-NEKVFRGQ.js").then((m) => m.historyCommand),
+    triggers: () => import("./triggers-543HDVJK.js").then((m) => m.triggersCommand),
+    targets: () => import("./targets-YCVILKKZ.js").then((m) => m.targetsCommand),
+    create: () => import("./create-6I7SRQHV.js").then((m) => m.createCommand),
+    update: () => import("./update-DGIBKKIB.js").then((m) => m.updateCommand),
+    delete: () => import("./delete-ZWUCKXI5.js").then((m) => m.deleteCommand),
+    unstage: () => import("./unstage-7UQU4MQT.js").then((m) => m.unstageCommand),
+    run: () => import("./run-QP7JP2H4.js").then((m) => m.runCommand)
+  }
+});
+export {
+  scheduledAgentsCommand
+};
+//# sourceMappingURL=scheduled-agents-N6FDAL7K.js.map

package/dist/schema-6O6CJTT5.js

@@ -0,0 +1,135 @@
+import {
+  describeSlots
+} from "./chunk-G47B4DOH.js";
+import "./chunk-IDFTXHRQ.js";
+import {
+  FLOW_CATALOG,
+  FLOW_FORM_FIELD_TYPES,
+  flowCatalogEntry,
+  flowCatalogTypes,
+  flowNodeTriggers
+} from "./chunk-UKIS6BLM.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-H4CLWLYF.js";
+import "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/flows/schema.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "flows.schema",
+  description: "The shape of one node or side-effect type: a pasteable skeleton, who fills each part, and the reference file with the craft. Start here before authoring anything in a form's _data.json.",
+  args: {
+    kind: { type: "positional", description: "node | side-effect. Omit to list both vocabularies.", required: false },
+    type: { type: "positional", description: "The type, e.g. customForm or googleSpreadsheet", required: false }
+  }
+});
+var KINDS = ["node", "side-effect"];
+function triggerReport(triggers) {
+  return {
+    fires: triggers.completion,
+    available: triggers.available,
+    ...triggers.why ? { why: triggers.why } : {}
+  };
+}
+function triggerHints(triggers) {
+  if (!triggers) return [];
+  if (!triggers.completion) return [`No side effect can be added to this step as it stands: ${triggers.why}`];
+  const others = triggers.available.filter((id) => id !== triggers.completion);
+  return [
+    `A side effect on this step carries \`triggerId: "${triggers.completion}"\`, and \`baker flows add-side-effect\` writes it for you. The trigger belongs to the STEP, not to the side-effect type: one that does not match is valid, ships, and never runs.` + (others.length > 0 ? ` Other moments this step raises: ${others.join(", ")}.` : "")
+  ];
+}
+var schemaCommand = defineCommand({
+  meta: {
+    name: "schema",
+    description: "Show a node or side-effect type's shape. Start here: baker flows schema node customForm \xB7 baker flows schema side-effect googleSpreadsheet \xB7 baker flows schema (lists both)"
+  },
+  args: {
+    kind: { type: "positional", description: "node | side-effect", required: false },
+    type: { type: "positional", description: "The type name", required: false }
+  },
+  run: ({ args }) => {
+    const kind = args.kind ? String(args.kind) : void 0;
+    const type = args.type ? String(args.type) : void 0;
+    if (!kind) {
+      writeJson({
+        ok: true,
+        data: {
+          node: flowCatalogTypes("node"),
+          "side-effect": flowCatalogTypes("side-effect"),
+          formFieldTypes: FLOW_FORM_FIELD_TYPES
+        },
+        hints: [
+          "baker flows schema node <type> \xB7 baker flows schema side-effect <type>",
+          "`hubspot` is in both lists and they are different things: the node embeds a form on the page, the side effect fires a behavioural event.",
+          "formFieldTypes are the `fieldtype` values INSIDE a customForm \u2014 a third vocabulary, not node types."
+        ]
+      });
+      return;
+    }
+    if (!KINDS.includes(kind)) {
+      writeJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: `Unknown kind "${kind}".`, fix: `Expected: ${KINDS.join(" | ")}` }
+      });
+      process.exit(1);
+    }
+    if (!type) {
+      writeJson({
+        ok: true,
+        data: { kind, types: flowCatalogTypes(kind) },
+        hints: [`baker flows schema ${kind} <type>`]
+      });
+      return;
+    }
+    const entry = flowCatalogEntry(kind, type);
+    if (!entry) {
+      const alternate = FLOW_CATALOG.find((candidate) => candidate.type === type);
+      writeJson({
+        ok: false,
+        error: {
+          code: "NOT_FOUND",
+          message: `No ${kind} type "${type}".`,
+          fix: alternate ? `"${type}" is a ${alternate.kind} type, not a ${kind} type. Try: baker flows schema ${alternate.kind} ${type}` : `Known ${kind} types: ${flowCatalogTypes(kind).join(", ")}`
+        }
+      });
+      process.exit(1);
+    }
+    const mappable = kind === "side-effect" ? describeSlots(type) : [];
+    const triggers = kind === "node" ? flowNodeTriggers(entry.skeleton.nodeData) : null;
+    writeJson({
+      ok: true,
+      data: {
+        ...entry,
+        ...mappable.length > 0 ? { mappable } : {},
+        ...triggers ? { triggers: triggerReport(triggers) } : {}
+      },
+      hints: [
+        `Full schema, gotchas and a worked example: ${entry.reference}`,
+        ...triggerHints(triggers),
+        ...mappable.length > 0 ? [
+          `Mappable with \`baker flows map\`: ${mappable.map((slot) => slot.slot).join(", ")}. Run \`baker flows map <slug> --side-effect <id>\` with no --map to see the legal keys for one you already have.`
+        ] : [],
+        ...entry.owners ? [
+          `You author everything except: ${Object.entries(entry.owners).filter(([, owner]) => owner !== "agent").map(([key, owner]) => `${key} (${owner})`).join(", ")}`
+        ] : []
+      ].filter(Boolean)
+    });
+  }
+});
+export {
+  schemaCommand
+};
+//# sourceMappingURL=schema-6O6CJTT5.js.map