@koda-sl/baker-cli 0.468.0 → 0.469.0

package/dist/triggers-SRQ3VFPQ.js

@@ -1,141 +0,0 @@
-import {
-  failApi
-} from "./chunk-542LVSYO.js";
-import {
-  triggerCatalogSchema
-} from "./chunk-WXC3I4CT.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-ML7DLFFY.js";
-import {
-  apiPost
-} from "./chunk-MMOTJIV6.js";
-import "./chunk-2ZZR2SOF.js";
-import "./chunk-YPCVPDU7.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-D3RTGIT4.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-SRQ3VFPQ.js.map

package/dist/tweets-XWE3VYQ4.js

@@ -1,123 +0,0 @@
-import {
-  parseXApiError
-} from "./chunk-M6UNISGO.js";
-import {
-  resolveXAccountId
-} from "./chunk-DMA77LLI.js";
-import {
-  cacheGet,
-  cacheSet,
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-6SL6463H.js";
-import {
-  ApiError,
-  apiGet
-} from "./chunk-MMOTJIV6.js";
-import "./chunk-2ZZR2SOF.js";
-import "./chunk-YPCVPDU7.js";
-import {
-  registerSchema
-} from "./chunk-D3RTGIT4.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-XWE3VYQ4.js.map

package/dist/unfollow-7U4UBAJX.js

@@ -1,46 +0,0 @@
-import {
-  reportError
-} from "./chunk-ICJFL7DU.js";
-import {
-  apiPost
-} from "./chunk-MMOTJIV6.js";
-import "./chunk-2ZZR2SOF.js";
-import "./chunk-YPCVPDU7.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-D3RTGIT4.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-7U4UBAJX.js.map

package/dist/unlink-N2ZZV6QD.js

@@ -1,67 +0,0 @@
-import {
-  failApi,
-  failValidation,
-  writeOk
-} from "./chunk-6KD4HB6Y.js";
-import "./chunk-WXC3I4CT.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-ML7DLFFY.js";
-import {
-  apiPost,
-  validateConvexId
-} from "./chunk-MMOTJIV6.js";
-import "./chunk-2ZZR2SOF.js";
-import {
-  requireChatId
-} from "./chunk-YPCVPDU7.js";
-import {
-  registerSchema
-} from "./chunk-D3RTGIT4.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-N2ZZV6QD.js.map

package/dist/unstage-B6K36IB4.js

@@ -1,84 +0,0 @@
-import {
-  failApi,
-  failValidation,
-  validateScheduledAgentRef
-} from "./chunk-542LVSYO.js";
-import "./chunk-WXC3I4CT.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-ML7DLFFY.js";
-import {
-  apiPost
-} from "./chunk-MMOTJIV6.js";
-import "./chunk-2ZZR2SOF.js";
-import {
-  requireChatId
-} from "./chunk-YPCVPDU7.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-D3RTGIT4.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-B6K36IB4.js.map

package/dist/unstage-RHIXLXOU.js

@@ -1,95 +0,0 @@
-import {
-  analyticsErrorEnvelope
-} from "./chunk-WJQZQBGR.js";
-import {
-  ANALYTICS_UNSTAGE_KINDS
-} from "./chunk-SSJK7FEV.js";
-import "./chunk-EDLZGTGN.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-6SL6463H.js";
-import {
-  apiPost
-} from "./chunk-MMOTJIV6.js";
-import "./chunk-2ZZR2SOF.js";
-import {
-  requireChatId
-} from "./chunk-YPCVPDU7.js";
-import {
-  registerSchema
-} from "./chunk-D3RTGIT4.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-RHIXLXOU.js.map

package/dist/update-AMKX7SWH.js

@@ -1,63 +0,0 @@
-import {
-  failApi,
-  failValidation,
-  writeOk
-} from "./chunk-6KD4HB6Y.js";
-import "./chunk-WXC3I4CT.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-ML7DLFFY.js";
-import {
-  apiPost
-} from "./chunk-MMOTJIV6.js";
-import "./chunk-2ZZR2SOF.js";
-import "./chunk-YPCVPDU7.js";
-import {
-  registerSchema
-} from "./chunk-D3RTGIT4.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-AMKX7SWH.js.map