@koda-sl/baker-cli 0.461.0 → 0.462.0

package/dist/chunk-MQW4DEQD.js

@@ -1,382 +0,0 @@
-import {
-  AUTO_PUBLISH_REFUSAL,
-  TRIGGER_KINDS,
-  TRIGGER_KIND_IDS,
-  TRIGGER_TARGETS,
-  TRIGGER_TARGET_FIELDS,
-  TRIGGER_TARGET_FIELD_IDS,
-  firstTimes,
-  isTriggerKind,
-  parseConditionsExpression
-} from "./chunk-ZJVHZHYP.js";
-import {
-  ApiError,
-  validateConvexId
-} from "./chunk-NUHMHZTZ.js";
-import {
-  getEnv
-} from "./chunk-3XA4JVMY.js";
-import {
-  writeJson
-} from "./chunk-USFTTDIO.js";
-
-// src/commands/scheduled-agents/shared.ts
-var TEMP_SCHEDULED_AGENT_PREFIX = "temp_agent_";
-var TEMP_ID_PREFIX = "temp_";
-function writeOk(data, hints) {
-  writeJson({ ok: true, data: data ?? null, ...hints && hints.length > 0 ? { hints } : {} });
-}
-function failValidation(message) {
-  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
-}
-function failApi(err) {
-  if (err instanceof ApiError) {
-    writeJson({ ok: false, error: { code: err.code, message: err.message } });
-    process.exit(1);
-  }
-  if (err instanceof Error) {
-    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-var AUTO_PUBLISH_ARG = {
-  "auto-publish": {
-    type: "string",
-    description: "Not available to the agent: publishing every run unreviewed is switched on by the user, on the item, after this chat is published. Passing it is refused and tells you what to ask them.",
-    required: false
-  }
-};
-function refuseAutoPublish(args) {
-  if (args["auto-publish"] === void 0) {
-    return;
-  }
-  writeJson({
-    ok: false,
-    error: {
-      code: "FORBIDDEN",
-      message: AUTO_PUBLISH_REFUSAL,
-      fix: {
-        action: "ask_user",
-        explanation: 'Run the command again without --auto-publish. After this chat is published, ask the user to open the item in Scheduled agents and switch on "Publish its work on its own" under "When a run finishes" \u2014 until then each run waits for their review.'
-      }
-    }
-  });
-  process.exit(1);
-}
-function isTempScheduledAgentId(id) {
-  return id.startsWith(TEMP_SCHEDULED_AGENT_PREFIX);
-}
-function isOtherTempId(id) {
-  return id.startsWith(TEMP_ID_PREFIX) && !isTempScheduledAgentId(id);
-}
-function validateScheduledAgentRef(ref) {
-  if (isOtherTempId(ref)) {
-    failValidation(`Scheduled agent temp IDs must start with ${TEMP_SCHEDULED_AGENT_PREFIX}.`);
-  }
-  if (!isTempScheduledAgentId(ref)) {
-    validateConvexId(ref);
-  }
-}
-var TRIGGER_ARG_DESCRIPTION = `What makes this run. ${TRIGGER_KIND_IDS.map(
-  (id) => `${id}: ${TRIGGER_KINDS[id].description}`
-).join(" ")} For the two time ones, pass --cron or --run-at instead and the kind is implied.`;
-var TRIGGER_KIND_LIST = [...TRIGGER_KIND_IDS];
-var NARROWING_DESCRIPTIONS = {
-  eventName: "With --trigger event.received: only this event name (a source's name, or one your site sends). Omit it to run on any event.",
-  toolkit: "With --trigger app.event (required): the connected tool, by its slug \u2014 gmail, slack, googlesheets.",
-  account: "With --trigger app.event (required): which connected account of that tool, by id (a tool can be connected more than once).",
-  appEvent: "With --trigger app.event (required): what happens in the tool, by the tool's own id \u2014 GMAIL_NEW_GMAIL_MESSAGE. `targets --field appEvent --app <tool>` lists them with the settings each needs.",
-  provider: "With --trigger connection.created, connection.removed or connection.needs_reconnect: only this tool (google-ads, hubspot, meta, or a connected tool's slug such as slack). Omit it for any tool.",
-  flowId: "With --trigger form.submitted or flow.step.submitted: which Form, by slug. Omit it on form.submitted for any Form.",
-  stepId: "With --trigger flow.step.submitted: which step of that Form, by id \u2014 `targets --field stepId --form <slug>` lists them by name.",
-  page: "With --trigger landing.created or landing.published: only this page, by slug. Omit it for any page.",
-  tag: "With --trigger task.created, task.claimed, task.completed, landing.created or landing.published: only ones carrying this tag. Omit it for any.",
-  experimentId: 'With --trigger experiment.decided, experiment.ended or experiment.concluded: only this test. Omit it for any test. Not for experiment.started \u2014 narrow that with --when "page = <page>".',
-  taskId: "With --trigger task.claimed or task.completed: only this Task, by id (a temp_ id of a Task staged in this chat works too). Omit it for any Task.",
-  agentId: "With --trigger session.published, session.publish_failed or session.publish_incomplete: only the runs of this scheduled agent, by id (a temp_agent_ id staged in this chat works too). Omit it for any agent's work.",
-  platform: "With --trigger session.publish_incomplete: only when this platform's changes did not all land \u2014 google-ads, meta-ads, linkedin-ads, x-ads, tag-manager or ga4. Omit it for any.",
-  collection: "With --trigger knowledge.updated: only this Knowledge collection. Omit it for any of them.",
-  sourceId: "With --trigger review.received: only reviews from this review source, by id. Omit it for any source.",
-  advertiserId: "With --trigger advertiser.new_ads: only this followed advertiser, by id. Omit it for any of them."
-};
-var NARROWING_ARGS = {
-  ...Object.fromEntries(
-    TRIGGER_TARGET_FIELD_IDS.map((field) => [
-      TRIGGER_TARGET_FIELDS[field].flag,
-      {
-        type: "string",
-        description: `${NARROWING_DESCRIPTIONS[field]} \`baker scheduled-agents targets --trigger <kind> --field ${field}\` lists the values.`,
-        required: false
-      }
-    ])
-  ),
-  config: {
-    type: "string",
-    description: `With --trigger app.event: the event's own settings as a JSON object \u2014 they filter inside the tool, before anything is sent. A Gmail search ('{"query":"from:ana@acme.com"}'), a label, a Slack channel, a GitHub repository ('{"owner":"acme","repo":"site"}'). \`targets --field appEvent --app <tool> --event <id>\` lists each setting with its examples.`,
-    required: false
-  }
-};
-function validateRunAt(runAt) {
-  if (!runAt.endsWith("Z")) {
-    failValidation("--run-at must be an ISO UTC timestamp ending in Z.");
-  }
-  const parsed = Date.parse(runAt);
-  if (!Number.isFinite(parsed)) {
-    failValidation("--run-at must be a valid ISO timestamp.");
-  }
-  if (parsed <= Date.now()) {
-    failValidation(
-      `--run-at ${runAt} has already passed. A one-off item only runs at a time still to come \u2014 pass a later ISO UTC timestamp, and check which timezone you converted from if you worked it out from a local time.`
-    );
-  }
-}
-function buildTriggerBody(args, options) {
-  const cron = args.cron;
-  const runAt = args["run-at"];
-  const timezone = args.timezone;
-  const kind = args.trigger;
-  const given = [cron, runAt, kind].filter(Boolean).length;
-  if (given > 1) {
-    failValidation("--cron, --run-at and --trigger are mutually exclusive.");
-  }
-  refuseNarrowingWithoutKind(args, kind, given);
-  if (runAt) {
-    validateRunAt(runAt);
-    return { runAt, ...timezone ? { timezone } : {} };
-  }
-  if (cron) {
-    return { cron, ...timezone ? { timezone } : {} };
-  }
-  if (kind) {
-    return { trigger: triggerFromFlags(kind, args), ...timezone ? { timezone } : {} };
-  }
-  if (timezone && !options.required) {
-    return { timezone };
-  }
-  if (options.required) {
-    failValidation(
-      `A trigger is required. Pass --cron or --run-at for a time-based one, or --trigger with one of: ${TRIGGER_KIND_IDS.join(", ")}.`
-    );
-  }
-  return void 0;
-}
-function flagText(args, key) {
-  const value = args[key];
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
-}
-function refuseMisusedKinds(kind, args) {
-  if (kind === "time.once") {
-    failValidation("Use --run-at for a one-off, rather than --trigger time.once.");
-  }
-  if (kind === "time.cron") {
-    failValidation("Use --cron for a repeating schedule, rather than --trigger time.cron.");
-  }
-  if (kind === "experiment.started" && flagText(args, "experiment")) {
-    failValidation(
-      'A test that exists has already started, so --experiment never fires on experiment.started. Leave it off and add --when "page = <page>" to watch one page.'
-    );
-  }
-}
-function refuseStrayFlags(kind, args) {
-  const allowed = new Set(TRIGGER_TARGETS[kind].map((target) => TRIGGER_TARGET_FIELDS[target.field].flag));
-  const stray = TRIGGER_TARGET_FIELD_IDS.map((field) => TRIGGER_TARGET_FIELDS[field].flag).filter(
-    (flag) => !allowed.has(flag) && flagText(args, flag) !== void 0 && !(kind === "experiment.started" && flag === "experiment")
-  );
-  if (stray.length === 0) {
-    return;
-  }
-  failValidation(
-    `${stray.map((flag) => `--${flag}`).join(", ")} does not narrow ${kind}. ${allowed.size > 0 ? `It can be pointed with ${[...allowed].map((flag) => `--${flag}`).join(", ")}.` : "It runs every time it happens \u2014 narrow it with --when rules over its payload instead."}`
-  );
-}
-var NARROWING_FLAGS = [...TRIGGER_TARGET_FIELD_IDS.map((field) => TRIGGER_TARGET_FIELDS[field].flag), "config"];
-function refuseNarrowingWithoutKind(args, kind, given) {
-  if (kind) {
-    return;
-  }
-  const stray = NARROWING_FLAGS.filter((flag) => flagText(args, flag) !== void 0);
-  if (stray.length === 0) {
-    return;
-  }
-  const flags = stray.map((flag) => `--${flag}`).join(", ");
-  failValidation(
-    given > 0 ? `${flags} does not narrow --cron or --run-at: a time trigger runs every time it comes round. Use --trigger <kind> with ${flags} instead, or leave ${flags} off.` : `${flags} narrows a trigger, and no trigger was given. Pass --trigger <kind> too \u2014 the item's whole trigger, with ${flags} \u2014 or leave ${flags} off.`
-  );
-}
-function configFromFlag(kind, args) {
-  const config = flagText(args, "config");
-  if (!config) {
-    return {};
-  }
-  if (kind !== "app.event") {
-    failValidation("--config is only for --trigger app.event: the settings of what happens in the tool.");
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(config);
-  } catch {
-    parsed = null;
-  }
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    failValidation(`--config must be a JSON object, e.g. '{"labelIds":"INBOX"}'.`);
-  }
-  return { configJson: config };
-}
-function triggerFromFlags(kind, args) {
-  if (!isTriggerKind(kind)) {
-    failValidation(`--trigger must be one of: ${TRIGGER_KIND_IDS.join(", ")}.`);
-  }
-  refuseMisusedKinds(kind, args);
-  refuseStrayFlags(kind, args);
-  const narrowings = {};
-  for (const { field, required } of TRIGGER_TARGETS[kind]) {
-    const value = flagText(args, TRIGGER_TARGET_FIELDS[field].flag);
-    if (value) {
-      narrowings[field] = value;
-    } else if (required) {
-      failValidation(
-        `--trigger ${kind} needs --${TRIGGER_TARGET_FIELDS[field].flag}. \`baker scheduled-agents targets --trigger ${kind} --field ${field}\` lists what it can be.`
-      );
-    }
-  }
-  return { kind, ...narrowings, ...configFromFlag(kind, args) };
-}
-function parseOccurrences(raw) {
-  if (raw === void 0) {
-    return void 0;
-  }
-  if (typeof raw !== "string") {
-    failValidation("--occurrences must be a comma-separated list of whole numbers, e.g. 1 or 1,3.");
-  }
-  const parts = raw.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
-  const numbers = parts.map((part) => Number(part));
-  if (numbers.length === 0 || numbers.some((n) => !Number.isInteger(n) || n <= 0)) {
-    failValidation("--occurrences must be a comma-separated list of whole numbers above zero, e.g. 1 or 1,3.");
-  }
-  return numbers;
-}
-function parseBooleanFlag(raw, flagName) {
-  if (raw === void 0) {
-    return void 0;
-  }
-  if (raw === true || raw === "true") {
-    return true;
-  }
-  if (raw === false || raw === "false") {
-    return false;
-  }
-  failValidation(`${flagName} must be true or false.`);
-}
-var REACTION_ARGS = {
-  when: {
-    type: "string",
-    description: "Only run when what arrived passes these rules: `<field> <operator> <value>` joined by AND or by OR (either case). Fields are the trigger's payload fields (`baker scheduled-agents triggers --trigger <kind>` lists them; a webhook's are whatever was posted; an app.event's are what `targets --field appEvent --app <tool> --event <id>` says it sends). Operators: =, !=, contains, does not contain, starts with, ends with, >, <, >=, <=, in (comma list), exists, missing. Example: --when \"deal.stage = won AND amount > 10000\". A payload that fails is not counted and starts nothing. `none` clears the rules.",
-    required: false
-  },
-  times: {
-    type: "string",
-    description: "Only the first N times it fires (and its --when rules pass), then never again. `--times 1` is only the first time. Shorthand for --occurrences 1,2,\u2026,N.",
-    required: false
-  },
-  payload: {
-    type: "string",
-    description: "include (default) or omit. Whether the run's first message carries what arrived \u2014 the posted body, the event's properties, the Form's answers (emails and phones masked). Place single values in --prompt with {{payload.<field>}} instead; those are filled either way.",
-    required: false
-  },
-  cooldown: {
-    type: "string",
-    description: "At most one run per this many minutes, however often it fires. 0 removes it.",
-    required: false
-  }
-};
-var SLACK_ARG = {
-  slack: {
-    type: "string",
-    description: "Tell each run in Slack: `here` (the Slack conversation this chat came from), `me` (a direct message to the person in this chat), `#channel` (a channel linked to this company), or `off`. Each run opens its own thread there and Baker reports on it: what it found, what it needs, whether to publish.",
-    required: false
-  }
-};
-function slackBody(args) {
-  return typeof args.slack === "string" && args.slack.trim().length > 0 ? { slack: args.slack.trim() } : {};
-}
-function wholeNumber(raw, flag, { min }) {
-  if (raw === void 0) {
-    return void 0;
-  }
-  const value = Number(raw);
-  if (!Number.isInteger(value) || value < min) {
-    failValidation(`${flag} must be a whole number of at least ${min}.`);
-  }
-  return value;
-}
-function reactionBody(args) {
-  const occurrences = occurrencesFromFlags(args);
-  const when = whenFromFlag(args.when);
-  const includePayload = payloadFromFlag(args.payload);
-  const cooldownMinutes = wholeNumber(args.cooldown, "--cooldown", { min: 0 });
-  return {
-    ...occurrences !== void 0 ? { occurrences } : {},
-    ...when !== void 0 ? { when } : {},
-    ...includePayload !== void 0 ? { includePayload } : {},
-    ...cooldownMinutes !== void 0 ? { cooldownMinutes } : {}
-  };
-}
-function occurrencesFromFlags(args) {
-  const times = wholeNumber(args.times, "--times", { min: 1 });
-  const occurrences = parseOccurrences(args.occurrences);
-  if (times !== void 0 && occurrences !== void 0) {
-    failValidation("Pass --times or --occurrences, not both \u2014 --times 3 is --occurrences 1,2,3.");
-  }
-  return times !== void 0 ? firstTimes(times) : occurrences;
-}
-function whenFromFlag(raw) {
-  if (typeof raw !== "string") {
-    return void 0;
-  }
-  const text = raw.trim();
-  if (text.length === 0 || text.toLowerCase() === "none") {
-    return "none";
-  }
-  const parsed = parseConditionsExpression(text);
-  if (!parsed.ok) {
-    failValidation(parsed.error);
-  }
-  return text;
-}
-function payloadFromFlag(raw) {
-  if (raw === void 0) {
-    return void 0;
-  }
-  if (raw !== "include" && raw !== "omit") {
-    failValidation("--payload must be include or omit.");
-  }
-  return raw === "include";
-}
-function chatBody() {
-  const id = getEnv().BAKER_CHAT_ID;
-  return id ? { chatId: id } : {};
-}
-
-export {
-  writeOk,
-  failValidation,
-  failApi,
-  AUTO_PUBLISH_ARG,
-  refuseAutoPublish,
-  isTempScheduledAgentId,
-  validateScheduledAgentRef,
-  TRIGGER_ARG_DESCRIPTION,
-  TRIGGER_KIND_LIST,
-  NARROWING_ARGS,
-  buildTriggerBody,
-  parseBooleanFlag,
-  REACTION_ARGS,
-  SLACK_ARG,
-  slackBody,
-  reactionBody,
-  chatBody
-};
-//# sourceMappingURL=chunk-MQW4DEQD.js.map

package/dist/chunk-NDDJ343K.js

@@ -1,159 +0,0 @@
-import {
-  failApi
-} from "./chunk-GIG5DZZG.js";
-import {
-  CREATIVE_PERFORMANCE_DEFAULT_DAYS,
-  CREATIVE_PERFORMANCE_MAX_DAYS
-} from "./chunk-ZJVHZHYP.js";
-import {
-  apiPost
-} from "./chunk-NUHMHZTZ.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-USFTTDIO.js";
-
-// src/commands/creatives/performance.ts
-import { readFileSync } from "fs";
-import path from "path";
-import { defineCommand } from "citty";
-import { parse as parseYaml } from "yaml";
-var DESCRIPTION = `How each Baker creative is doing in the live Meta ads that show it: spend, impressions, CTR, CPC, results, cost per result, frequency and a fatigue verdict, next to the angle, hook, mechanism and dominant slot its definition set out to test. Video creatives add hookRate (percent of impressions that watched 3 seconds) and holdRate (percent of those that reached a ThruPlay). Use it before briefing new creatives, to learn which angle and mechanism to make next and which creatives to replace.
-
-Start here:
-  baker creatives performance                      # every creative in an ad, last 30 days
-  baker creatives performance --slug spring-offer  # one creative
-  baker creatives performance --days 14 --full     # ids, last-7-day figures, a video's watch funnel, one row per ad
-
-Fatigue follows the Meta playbook (07-creative-audit.md): fresh, fading, fatigued, dead, or too_early (under 14 days or 1,000 impressions) and no_delivery. A low hook rate means the first 3 seconds need new hooks; a working hook with a low hold rate means the body loses people. A creative counts once a Session's publish created an ad with it.`;
-var ARGS = {
-  slug: { type: "string", description: "Only this creative (src/creatives/<slug>/)", required: false },
-  days: {
-    type: "string",
-    description: `Reporting window in days, ending today (1-${CREATIVE_PERFORMANCE_MAX_DAYS}, default ${CREATIVE_PERFORMANCE_DEFAULT_DAYS})`,
-    required: false
-  },
-  full: {
-    type: "boolean",
-    description: "Add ids, last-7-day CTR and cost per result, and one row per ad",
-    required: false,
-    default: false
-  }
-};
-registerSchema({ command: "creatives.performance", description: DESCRIPTION, args: ARGS });
-var INSIGHT_KEYS = [
-  "idea",
-  "message",
-  "evidence",
-  "angle",
-  "hook",
-  "mechanism",
-  "dominantSlot",
-  "persona",
-  "awareness",
-  "hypothesis"
-];
-var FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---/;
-function insightValue(value) {
-  if (typeof value === "string") return value.trim() || null;
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
-  return null;
-}
-function definitionInsights(markdown) {
-  const block = FRONTMATTER.exec(markdown)?.[1];
-  if (!block) return null;
-  let parsed;
-  try {
-    parsed = parseYaml(block);
-  } catch {
-    return null;
-  }
-  if (parsed === null || typeof parsed !== "object") return null;
-  const insights = {};
-  for (const [key, raw] of Object.entries(parsed)) {
-    if (!(INSIGHT_KEYS.includes(key) || key.startsWith("source") || key.startsWith("reference"))) continue;
-    const value = insightValue(raw);
-    if (value !== null) insights[key] = value;
-  }
-  return Object.keys(insights).length > 0 ? insights : null;
-}
-function readLocalDefinition(slug) {
-  try {
-    return readFileSync(path.join(process.cwd(), "src", "creatives", slug, "_definition.md"), "utf8");
-  } catch {
-    return null;
-  }
-}
-var COMPARED_FIELDS = [
-  { key: "angle", label: "angle", advice: "Brief the next creative on the cheapest angle with a new hook." },
-  { key: "mechanism", label: "mechanism", advice: "Brief the next creative on the cheapest mechanism." },
-  { key: "dominantSlot", label: "dominant slot", advice: "Lead the next creative with the cheapest dominant slot." }
-];
-function cheapestHint(creatives, { key, label, advice }) {
-  const byValue = /* @__PURE__ */ new Map();
-  for (const creative of creatives) {
-    const value = creative.definition?.[key];
-    if (!value || creative.costPerResult === null) continue;
-    const best = byValue.get(value);
-    if (!best || (best.costPerResult ?? Number.POSITIVE_INFINITY) > creative.costPerResult)
-      byValue.set(value, creative);
-  }
-  if (byValue.size < 2) return null;
-  const ranked = [...byValue.entries()].sort(([, a], [, b]) => (a.costPerResult ?? 0) - (b.costPerResult ?? 0)).map(
-    ([value, creative]) => `"${value}" ${creative.costPerResult}${creative.currency ? ` ${creative.currency}` : ""} (${creative.slug ?? creative.title})`
-  );
-  return `Cost per result by ${label}: ${ranked.join(", ")}. ${advice}`;
-}
-function withDefinitions(response, readDefinition) {
-  const creatives = response.data.creatives.map((creative) => {
-    const markdown = creative.slug ? readDefinition(creative.slug) : null;
-    const definition = markdown ? definitionInsights(markdown) : null;
-    return definition ? { ...creative, definition } : creative;
-  });
-  const hints = [...response.hints ?? []];
-  for (const field of COMPARED_FIELDS) {
-    const hint = cheapestHint(creatives, field);
-    if (hint) hints.push(hint);
-  }
-  const unnamed = creatives.filter((creative) => !creative.definition?.angle).map((c) => c.slug ?? c.title);
-  if (unnamed.length > 0) {
-    hints.push(
-      `No angle recorded for: ${unnamed.join(", ")}. Add angle and hook to src/creatives/<slug>/_definition.md so results show which angle works.`
-    );
-  }
-  return { ...response, data: { ...response.data, creatives }, ...hints.length > 0 ? { hints } : {} };
-}
-function parseDays(raw) {
-  if (raw === void 0) return void 0;
-  const days = Number(raw);
-  if (!Number.isInteger(days) || days < 1 || days > CREATIVE_PERFORMANCE_MAX_DAYS) {
-    throw new Error(`--days must be a whole number from 1 to ${CREATIVE_PERFORMANCE_MAX_DAYS}`);
-  }
-  return days;
-}
-var performanceCommand = defineCommand({
-  meta: { name: "performance", description: DESCRIPTION },
-  args: ARGS,
-  run: async ({ args }) => {
-    try {
-      const body = {};
-      const slug = args.slug;
-      if (slug) body.slug = slug;
-      const days = parseDays(args.days);
-      if (days !== void 0) body.days = days;
-      if (args.full) body.full = true;
-      const response = await apiPost("/api/creatives/performance", body);
-      writeJson(withDefinitions(response, readLocalDefinition));
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-
-export {
-  definitionInsights,
-  withDefinitions,
-  parseDays,
-  performanceCommand
-};
-//# sourceMappingURL=chunk-NDDJ343K.js.map