@koda-sl/baker-cli 0.462.0 → 0.463.0

package/dist/triggers-HBBM5ID3.js

@@ -0,0 +1,140 @@
+import {
+  failApi
+} from "./chunk-4JHBYYPU.js";
+import {
+  triggerCatalogSchema
+} from "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-TU6CHBNF.js";
+import "./chunk-E6VWLJVK.js";
+import "./chunk-7HD4SFUW.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-V2PX6XX5.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,
+          about: entry.about,
+          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-HBBM5ID3.js.map

package/dist/tweets-I46FLKDE.js

@@ -0,0 +1,123 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-W6WLVU4M.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-3ITK2SBF.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-TU6CHBNF.js";
+import "./chunk-E6VWLJVK.js";
+import "./chunk-7HD4SFUW.js";
+import {
+  registerSchema
+} from "./chunk-V2PX6XX5.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/tweets.ts
+import { defineCommand } from "citty";
+function cacheKeyFor(accountId, args) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  return `tweets:${accountId}:${today}:${args["tweet-type"] ?? ""}:${args["timeline-type"] ?? ""}:${args["user-id"] ?? ""}`;
+}
+function requestParams(accountId, args) {
+  const params = { "account-id": accountId };
+  for (const key of ["tweet-type", "timeline-type", "user-id"]) {
+    if (args[key]) {
+      params[key] = String(args[key]);
+    }
+  }
+  if (args["no-cache"]) {
+    params["skip-cache"] = "true";
+  }
+  return params;
+}
+function toPost(tweet) {
+  return {
+    id: tweet.id_str,
+    text: typeof tweet.full_text === "string" ? tweet.full_text : tweet.text,
+    created_at: tweet.created_at,
+    promoted_only: tweet.nullcast === true,
+    handle: tweet.user?.screen_name
+  };
+}
+function hintsFor(posts) {
+  return posts.length === 0 ? ["This account has published no posts, so there is nothing to promote yet."] : ["Promote one with: baker ads x promoted-tweets create --line-item-id <id> --tweet-ids <id>"];
+}
+var TWEET_TYPES = "PUBLISHED | DRAFT";
+var TIMELINE_TYPES = "ALL | ORGANIC | NULLCAST";
+registerSchema({
+  command: "ads.x.tweets",
+  description: `The account's own posts, so one can be promoted by id. Start here before \`baker ads x promoted-tweets create\` \u2014 that command takes a post id, and this is the only place to get one.
+A NULLCAST post ("promoted-only") never appears on the profile timeline and exists to be advertised; an ORGANIC one is a normal post that can also be promoted.`,
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "tweet-type": { type: "string", description: `${TWEET_TYPES} (default PUBLISHED)`, required: false },
+    "timeline-type": { type: "string", description: `${TIMELINE_TYPES}`, required: false },
+    "user-id": { type: "string", description: "Numeric id of the posting handle", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false }
+  }
+});
+var tweetsCommand = defineCommand({
+  meta: {
+    name: "tweets",
+    description: `The account's own posts, with the id needed to promote one.
+
+Examples:
+  baker ads x tweets
+  baker ads x tweets --timeline-type NULLCAST --output md`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "tweet-type": { type: "string", description: `${TWEET_TYPES} (default PUBLISHED)` },
+    "timeline-type": { type: "string", description: TIMELINE_TYPES },
+    "user-id": { type: "string", description: "Numeric id of the posting handle" },
+    "no-cache": { type: "boolean", description: "Skip cache" },
+    output: { type: "string", description: "Format: json|csv|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = cacheKeyFor(accountId, args);
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeJsonEnvelope({ ok: true, data: cached.data, cached: true, hints: hintsFor(cached.data) });
+        return;
+      }
+    }
+    try {
+      const data = await apiGet("/api/ads/x/tweets", requestParams(accountId, args));
+      const posts = data.map(toPost);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, posts, 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(posts, format);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data: posts, hints: hintsFor(posts) });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  tweetsCommand
+};
+//# sourceMappingURL=tweets-I46FLKDE.js.map

package/dist/unfollow-OO3E4BBV.js

@@ -0,0 +1,46 @@
+import {
+  reportError
+} from "./chunk-FNGSUPBI.js";
+import {
+  apiPost
+} from "./chunk-TU6CHBNF.js";
+import "./chunk-E6VWLJVK.js";
+import "./chunk-7HD4SFUW.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-V2PX6XX5.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/unfollow.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.unfollow",
+  description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
+  }
+});
+var unfollowCommand = defineCommand({
+  meta: {
+    name: "unfollow",
+    description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiPost("/api/ad-library/unfollow", {
+        advertiser_id: String(args.advertiser)
+      });
+      writeJson({ ok: true, data });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  unfollowCommand
+};
+//# sourceMappingURL=unfollow-OO3E4BBV.js.map

package/dist/unlink-K6NQEDYZ.js

@@ -0,0 +1,66 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-5FJB35TV.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-TU6CHBNF.js";
+import "./chunk-E6VWLJVK.js";
+import {
+  requireChatId
+} from "./chunk-7HD4SFUW.js";
+import {
+  registerSchema
+} from "./chunk-V2PX6XX5.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-K6NQEDYZ.js.map

package/dist/unstage-KEMZKHW3.js

@@ -0,0 +1,95 @@
+import {
+  analyticsErrorEnvelope
+} from "./chunk-QRXPQLVI.js";
+import {
+  ANALYTICS_UNSTAGE_KINDS
+} from "./chunk-SSJK7FEV.js";
+import "./chunk-EDLZGTGN.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-3ITK2SBF.js";
+import {
+  apiPost
+} from "./chunk-TU6CHBNF.js";
+import "./chunk-E6VWLJVK.js";
+import {
+  requireChatId
+} from "./chunk-7HD4SFUW.js";
+import {
+  registerSchema
+} from "./chunk-V2PX6XX5.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-KEMZKHW3.js.map

package/dist/unstage-XM5INZHX.js

@@ -0,0 +1,83 @@
+import {
+  failApi,
+  failValidation,
+  validateScheduledAgentRef
+} from "./chunk-4JHBYYPU.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-TU6CHBNF.js";
+import "./chunk-E6VWLJVK.js";
+import {
+  requireChatId
+} from "./chunk-7HD4SFUW.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-V2PX6XX5.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-XM5INZHX.js.map