@koda-sl/baker-cli 0.502.0 → 0.504.0

package/dist/learn-2QPP7NHC.js

@@ -0,0 +1,205 @@
+import {
+  setDefinitionFields
+} from "./chunk-YNYAT2TZ.js";
+import {
+  IDEAS_DIR,
+  readIdeas
+} from "./chunk-SWN6OHXG.js";
+import "./chunk-A3IQAONL.js";
+import {
+  parseDays,
+  withDefinitions
+} from "./chunk-FM6RRYJB.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-E44NXCTL.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-EJGAJHLB.js";
+import "./chunk-LRV6M2WB.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import {
+  failApi
+} from "./chunk-36MUCC42.js";
+import "./chunk-EXELLNQS.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/creatives/learn.ts
+import { readFileSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+
+// src/commands/creatives/learn-model.ts
+var MIN_IMPRESSIONS = 1e3;
+var SEEN_ENOUGH = 5e3;
+var WINNER_RATIO = 0.8;
+var WINNER_MIN_RESULTS = 3;
+var FAILED_RATIO = 1.5;
+var SILENT_SPEND = 2;
+var SETTLED = /* @__PURE__ */ new Set(["winner", "failed", "inconclusive"]);
+var round = (n) => Math.round(n * 100) / 100;
+function totals(creatives) {
+  const spend = creatives.reduce((sum, c) => sum + c.spend, 0);
+  const impressions = creatives.reduce((sum, c) => sum + c.impressions, 0);
+  const results = creatives.reduce((sum, c) => sum + (c.results ?? 0), 0);
+  const clicks = creatives.reduce((sum, c) => sum + (c.ctr ?? 0) * c.impressions, 0);
+  return { spend, impressions, results, ctr: impressions > 0 ? round(clicks / impressions) : null };
+}
+function verdict(result, usual) {
+  if (result.impressions < MIN_IMPRESSIONS) return "testing";
+  if (usual !== null) {
+    if (result.results === 0 && result.spend >= SILENT_SPEND * usual) return "failed";
+    const ratio = result.vsAccount;
+    if (ratio !== null && result.results >= WINNER_MIN_RESULTS && ratio <= WINNER_RATIO) return "winner";
+    if (ratio !== null && ratio >= FAILED_RATIO) return "failed";
+  }
+  return result.impressions >= SEEN_ENOUGH ? "inconclusive" : "testing";
+}
+function ideaResult(own, usual, asOf) {
+  const mine = totals(own);
+  const costPerResult = mine.results > 0 ? round(mine.spend / mine.results) : null;
+  return {
+    asOf,
+    creatives: own.length,
+    ...own[0]?.currency ? { currency: own[0].currency } : {},
+    spend: round(mine.spend),
+    impressions: mine.impressions,
+    results: mine.results,
+    costPerResult,
+    ctr: mine.ctr,
+    vsAccount: usual !== null && costPerResult !== null ? round(costPerResult / usual) : null
+  };
+}
+function learnFromResults(ideas, creatives, asOf) {
+  const ideaOf = (c) => c.definition?.idea ?? null;
+  return ideas.flatMap((idea) => {
+    if (idea.status === "idea" || idea.status === "retired") return [];
+    const own = creatives.filter((c) => ideaOf(c) === idea.id);
+    if (own.length === 0) return [];
+    const rest = totals(creatives.filter((c) => ideaOf(c) !== idea.id));
+    const usual = rest.results > 0 ? rest.spend / rest.results : null;
+    const result = ideaResult(own, usual, asOf);
+    const to = verdict(result, usual);
+    if (to === "testing" && SETTLED.has(idea.status)) return [];
+    return [{ idea: idea.id, from: idea.status, to, result }];
+  });
+}
+
+// src/commands/creatives/learn.ts
+var DESCRIPTION = `Write back what each built idea's ads did in the live Meta account: every creative of the idea pooled, judged against the rest of the account's cost per result, and the verdict (winner, failed, inconclusive, testing) and frozen numbers written onto src/creatives/_ideas/<idea>.md. Run it before writing new ideas, and weekly.
+
+Start here:
+  baker creatives learn               # last 30 days, written onto the ideas
+  baker creatives learn --days 60
+  baker creatives learn --dry-run     # show the verdicts, write nothing
+
+A winner gets results at 0.8x the usual cost or less (3+ results); failed is 1.5x or more, or spend worth two usual results with none; under 1,000 impressions it is still testing.`;
+var ARGS = {
+  days: { type: "string", required: false, description: "Reporting window in days (default 30)" },
+  "dry-run": { type: "boolean", required: false, default: false, description: "Show the verdicts; write nothing" }
+};
+registerSchema({ command: "creatives.learn", description: DESCRIPTION, args: ARGS });
+function learnEnvelope(learnings, written, unreadable = []) {
+  const winners = learnings.filter((l) => l.to === "winner").map((l) => l.idea);
+  const failed = learnings.filter((l) => l.to === "failed").map((l) => l.idea);
+  const hints = [];
+  if (unreadable.length > 0) {
+    hints.push(
+      `Could not read ${unreadable.join(", ")}, so their results were not written: fix what \`baker creatives ideas\` names, then run this again.`
+    );
+  }
+  if (learnings.length === 0) {
+    hints.push(
+      "No built idea has ads delivering yet: nothing to learn. Ideas count once a published ad shows their creative."
+    );
+  }
+  if (winners.length > 0) {
+    hints.push(
+      `Build on ${winners.join(", ")}: keep the message and make it in a new format or for a new persona before any new idea.`
+    );
+  }
+  if (failed.length > 0) {
+    hints.push(
+      `${failed.join(", ")} lost: never repeat their message; \`baker creatives ideas\` flags an idea that does.`
+    );
+  }
+  return {
+    ok: true,
+    data: {
+      written,
+      ideas: learnings.map((l) => ({
+        idea: l.idea,
+        status: l.from === l.to ? l.to : `${l.from} \u2192 ${l.to}`,
+        ...l.result
+      }))
+    },
+    hints
+  };
+}
+async function writeBack(root, learnings) {
+  for (const learning of learnings) {
+    const file = path.join(root, IDEAS_DIR, `${learning.idea}.md`);
+    const raw = await readFile(file, "utf8");
+    await writeFile(file, setDefinitionFields(raw, { status: learning.to, result: learning.result }), "utf8");
+  }
+}
+function readDefinition(root, slug) {
+  try {
+    return readFileSync(path.join(root, "src", "creatives", slug, "_definition.md"), "utf8");
+  } catch {
+    return null;
+  }
+}
+function today() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+var learnCommand = defineCommand({
+  meta: { name: "learn", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    try {
+      const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+      const days = parseDays(args.days);
+      const performance = withDefinitions(
+        await apiPost("/api/creatives/performance", days ? { days } : {}),
+        (slug) => readDefinition(root, slug)
+      );
+      const { ideas, unreadable } = await readIdeas(root);
+      const learnings = learnFromResults(ideas, performance.data.creatives, today());
+      const dryRun = args["dry-run"] === true;
+      if (!dryRun) await writeBack(root, learnings);
+      writeJson(
+        learnEnvelope(
+          learnings,
+          !dryRun && learnings.length > 0,
+          unreadable.map((u) => u.id)
+        )
+      );
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  learnCommand,
+  learnEnvelope
+};
+//# sourceMappingURL=learn-2QPP7NHC.js.map

package/dist/line-item-writes-2XGDEEV3.js

@@ -0,0 +1,209 @@
+import {
+  compact,
+  csvArg,
+  microsFromArg,
+  requireTarget,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-DTUGU4EI.js";
+import "./chunk-FIN4ZXGJ.js";
+import "./chunk-7NF73SCB.js";
+import "./chunk-ZRP7Y2DM.js";
+import {
+  OBJECTIVES,
+  PLACEMENTS,
+  PRODUCT_TYPES
+} from "./chunk-EXELLNQS.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/line-item-writes.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.lineItems.create",
+  description: `Stage a new X ad group under a campaign. Objective, product type and campaign are fixed at create \u2014 X refuses to change any of them afterwards, so get them right here.
+Objectives: ${OBJECTIVES.join(", ")}.`,
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "campaign-id": {
+      type: "string",
+      description: "Parent campaign id, or an x_temp_* ref staged in this draft",
+      required: true
+    },
+    name: { type: "string", description: "Ad group name", required: true },
+    objective: { type: "string", description: OBJECTIVES.join(" | "), required: true },
+    "product-type": { type: "string", description: PRODUCT_TYPES.join(" | "), required: false },
+    placements: { type: "string", description: `CSV of ${PLACEMENTS.join(", ")}`, required: false },
+    status: { type: "string", description: "ACTIVE | PAUSED | DRAFT (default PAUSED)", required: false },
+    "bid-strategy": { type: "string", description: "AUTO | MAX | TARGET", required: false },
+    bid: {
+      type: "string",
+      description: "Bid in account currency \u2014 required for MAX/TARGET, refused for AUTO",
+      required: false
+    },
+    "daily-budget": { type: "string", description: "Daily budget in account currency", required: false },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency", required: false },
+    "start-time": { type: "string", description: "ISO 8601 start", required: false },
+    "end-time": { type: "string", description: "ISO 8601 end", required: false }
+  }
+});
+var lineItemsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new ad group (applies when the chat is published).
+
+Examples:
+  baker ads x line-items create --campaign-id oilf0 --name "Spain" --objective WEBSITE_CLICKS
+  baker ads x line-items create --campaign-id x_temp_abc --name "Spain" --objective REACH --bid-strategy MAX --bid 1.20`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "campaign-id": { type: "string", description: "Parent campaign id or x_temp_* ref", required: true },
+    name: { type: "string", description: "Ad group name", required: true },
+    objective: { type: "string", description: OBJECTIVES.join(" | "), required: true },
+    "product-type": { type: "string", description: PRODUCT_TYPES.join(" | ") },
+    placements: { type: "string", description: `CSV of ${PLACEMENTS.join(", ")}` },
+    status: { type: "string", description: "ACTIVE | PAUSED | DRAFT (default PAUSED)" },
+    "bid-strategy": { type: "string", description: "AUTO | MAX | TARGET" },
+    bid: { type: "string", description: "Bid in account currency" },
+    "daily-budget": { type: "string", description: "Daily budget in account currency" },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency" },
+    "start-time": { type: "string", description: "ISO 8601 start" },
+    "end-time": { type: "string", description: "ISO 8601 end" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "lineItem.create",
+      accountId,
+      payload: compact({
+        campaignId: args["campaign-id"],
+        name: args.name,
+        objective: args.objective,
+        productType: args["product-type"],
+        placements: csvArg(args.placements),
+        entityStatus: args.status,
+        bidStrategy: args["bid-strategy"],
+        bidAmountLocalMicro: microsFromArg(args.bid, "--bid"),
+        dailyBudgetAmountLocalMicro: microsFromArg(args["daily-budget"], "--daily-budget"),
+        totalBudgetAmountLocalMicro: microsFromArg(args["total-budget"], "--total-budget"),
+        startTime: args["start-time"],
+        endTime: args["end-time"]
+      })
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.lineItems.update",
+  description: "Stage a change to an existing X ad group. Objective, product type and campaign are absent on purpose \u2014 X treats all three as immutable after create.",
+  args: {
+    id: { type: "string", description: "Ad group id", required: true },
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    name: { type: "string", description: "New name", required: false },
+    status: { type: "string", description: "ACTIVE | PAUSED", required: false },
+    placements: { type: "string", description: "CSV of placements", required: false },
+    "bid-strategy": { type: "string", description: "AUTO | MAX | TARGET", required: false },
+    bid: { type: "string", description: "Bid in account currency", required: false },
+    "daily-budget": { type: "string", description: "Daily budget in account currency", required: false },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency", required: false },
+    "start-time": { type: "string", description: "ISO 8601 start", required: false },
+    "end-time": { type: "string", description: "ISO 8601 end", required: false }
+  }
+});
+var lineItemsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to an ad group.
+
+Examples:
+  baker ads x line-items update wiee9 --bid 1.50
+  baker ads x line-items update wiee9 --end-time 2026-12-31T00:00:00Z`
+  },
+  args: {
+    id: { type: "positional", description: "Ad group id", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" },
+    name: { type: "string", description: "New name" },
+    status: { type: "string", description: "ACTIVE | PAUSED" },
+    placements: { type: "string", description: "CSV of placements" },
+    "bid-strategy": { type: "string", description: "AUTO | MAX | TARGET" },
+    bid: { type: "string", description: "Bid in account currency" },
+    "daily-budget": { type: "string", description: "Daily budget in account currency" },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency" },
+    "start-time": { type: "string", description: "ISO 8601 start" },
+    "end-time": { type: "string", description: "ISO 8601 end" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "lineItem.update",
+      accountId,
+      target: requireTarget(args, "id"),
+      payload: compact({
+        name: args.name,
+        entityStatus: args.status,
+        placements: csvArg(args.placements),
+        bidStrategy: args["bid-strategy"],
+        bidAmountLocalMicro: microsFromArg(args.bid, "--bid"),
+        dailyBudgetAmountLocalMicro: microsFromArg(args["daily-budget"], "--daily-budget"),
+        totalBudgetAmountLocalMicro: microsFromArg(args["total-budget"], "--total-budget"),
+        startTime: args["start-time"],
+        endTime: args["end-time"]
+      })
+    });
+  }
+});
+function statusCommand(name, status) {
+  registerSchema({
+    command: `ads.x.lineItems.${name}`,
+    description: `Stage ${name === "pause" ? "a pause" : "a resume"} for one or more X ad groups. Pass every id in one call.`,
+    args: {
+      ids: { type: "string", description: "Ad group ids, comma-separated", required: true },
+      "account-id": { type: "string", description: "X Ads account ID", required: false }
+    }
+  });
+  return defineCommand({
+    meta: {
+      name,
+      description: `Stage ${name === "pause" ? "pausing" : "resuming"} ad groups.
+
+Example:
+  baker ads x line-items ${name} wiee9,wo2sr`
+    },
+    args: {
+      ids: { type: "positional", description: "Ad group ids, comma-separated", required: true },
+      "account-id": { type: "string", description: "X Ads account ID" }
+    },
+    run: async ({ args }) => {
+      const accountId = await stageAccountId(args);
+      await stageXOps(
+        requireTargets(args, "ids").map((id) => ({
+          kind: "lineItem.update",
+          accountId,
+          target: id,
+          payload: { entityStatus: status }
+        }))
+      );
+    }
+  });
+}
+var lineItemsPauseCommand = statusCommand("pause", "PAUSED");
+var lineItemsResumeCommand = statusCommand("resume", "ACTIVE");
+export {
+  lineItemsCreateCommand,
+  lineItemsPauseCommand,
+  lineItemsResumeCommand,
+  lineItemsUpdateCommand
+};
+//# sourceMappingURL=line-item-writes-2XGDEEV3.js.map

package/dist/line-items-ZSQS2AWV.js

@@ -0,0 +1,107 @@
+import {
+  xMicrosHints
+} from "./chunk-MKAYMOZY.js";
+import {
+  runListCommand
+} from "./chunk-TLQOMWLQ.js";
+import "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-7NF73SCB.js";
+import "./chunk-ZRP7Y2DM.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/line-items.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.lineItems",
+  description: "List line items (ad groups) for an X Ads account. Returns bid, product_type, objective, placements, schedule. Filter by campaign-ids or line-item-ids (CSV).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+var lineItemsListCommand = defineCommand({
+  meta: {
+    name: "line-items",
+    description: `List X Ads line items (ad groups).
+
+Examples:
+  baker ads x line-items --account-id 18ce53xyz --campaign-ids abc
+  baker ads x line-items --account-id 18ce53xyz --with-deleted`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const cacheKey = `line-items:${accountId}:${today}:${args["campaign-ids"] ?? ""}:${args["line-item-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+    await runListCommand({
+      path: "/api/ads/x/line-items",
+      cacheCategory: "x-account-data",
+      cacheKey,
+      cacheTtlMs: 60 * 60 * 1e3,
+      params: {
+        "account-id": accountId,
+        "campaign-ids": args["campaign-ids"],
+        "line-item-ids": args["line-item-ids"],
+        "with-deleted": args["with-deleted"] ? "true" : void 0
+      },
+      format: args.output || "json",
+      accountId,
+      useCache,
+      hintsFor: xMicrosHints
+    });
+  }
+});
+var lineItemsCommand = defineCommand({
+  meta: {
+    name: "line-items",
+    description: `X Ads ad groups (X calls them line items) \u2014 read them, or stage a change that applies when the chat is published.
+
+Objective, product type and parent campaign are fixed at create: X refuses to
+change any of them afterwards.
+
+Examples:
+  baker ads x line-items
+  baker ads x line-items create --campaign-id oilf0 --name "Spain" --objective WEBSITE_CLICKS
+  baker ads x line-items update wiee9 --bid 1.50
+  baker ads x line-items pause wiee9`
+  },
+  subCommands: {
+    list: lineItemsListCommand,
+    create: () => import("./line-item-writes-2XGDEEV3.js").then((m) => m.lineItemsCreateCommand),
+    update: () => import("./line-item-writes-2XGDEEV3.js").then((m) => m.lineItemsUpdateCommand),
+    pause: () => import("./line-item-writes-2XGDEEV3.js").then((m) => m.lineItemsPauseCommand),
+    resume: () => import("./line-item-writes-2XGDEEV3.js").then((m) => m.lineItemsResumeCommand)
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs" },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs" },
+    "with-deleted": { type: "boolean", description: "Include deleted" },
+    "no-cache": { type: "boolean", description: "Skip cache" },
+    output: { type: "string", description: "Format: json|csv|md", default: "json" }
+  },
+  default: "list"
+});
+export {
+  lineItemsCommand
+};
+//# sourceMappingURL=line-items-ZSQS2AWV.js.map

package/dist/line-items-ZSQS2AWV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/line-items.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { xMicrosHints } from \"./money-units.ts\";\nimport { resolveXAccountId } from \"./output.ts\";\nimport { runListCommand } from \"./run-list.ts\";\n\nregisterSchema({\n  command: \"ads.x.lineItems\",\n  description:\n    \"List line items (ad groups) for an X Ads account. Returns bid, product_type, objective, placements, schedule. Filter by campaign-ids or line-item-ids (CSV).\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"campaign-ids\": { type: \"string\", description: \"CSV of campaign IDs\", required: false },\n    \"line-item-ids\": { type: \"string\", description: \"CSV of line item IDs\", required: false },\n    \"with-deleted\": { type: \"boolean\", description: \"Include deleted\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n  },\n});\n\nconst lineItemsListCommand = defineCommand({\n  meta: {\n    name: \"line-items\",\n    description: `List X Ads line items (ad groups).\n\nExamples:\n  baker ads x line-items --account-id 18ce53xyz --campaign-ids abc\n  baker ads x line-items --account-id 18ce53xyz --with-deleted`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"campaign-ids\": { type: \"string\", description: \"CSV of campaign IDs\", required: false },\n    \"line-item-ids\": { type: \"string\", description: \"CSV of line item IDs\", required: false },\n    \"with-deleted\": { type: \"boolean\", description: \"Include deleted\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md\", required: false, default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await resolveXAccountId(args);\n    const useCache = !args[\"no-cache\"];\n    const today = new Date().toISOString().slice(0, 10);\n    const cacheKey = `line-items:${accountId}:${today}:${args[\"campaign-ids\"] ?? \"\"}:${args[\"line-item-ids\"] ?? \"\"}:${args[\"with-deleted\"] ? \"1\" : \"0\"}`;\n    await runListCommand({\n      path: \"/api/ads/x/line-items\",\n      cacheCategory: \"x-account-data\",\n      cacheKey,\n      cacheTtlMs: 60 * 60 * 1000,\n      params: {\n        \"account-id\": accountId,\n        \"campaign-ids\": args[\"campaign-ids\"] as string | undefined,\n        \"line-item-ids\": args[\"line-item-ids\"] as string | undefined,\n        \"with-deleted\": args[\"with-deleted\"] ? \"true\" : undefined,\n      },\n      format: (args.output as string) || \"json\",\n      accountId,\n      useCache,\n      hintsFor: xMicrosHints,\n    });\n  },\n});\n\nexport const lineItemsCommand = defineCommand({\n  meta: {\n    name: \"line-items\",\n    description: `X Ads ad groups (X calls them line items) — read them, or stage a change that applies when the chat is published.\n\nObjective, product type and parent campaign are fixed at create: X refuses to\nchange any of them afterwards.\n\nExamples:\n  baker ads x line-items\n  baker ads x line-items create --campaign-id oilf0 --name \"Spain\" --objective WEBSITE_CLICKS\n  baker ads x line-items update wiee9 --bid 1.50\n  baker ads x line-items pause wiee9`,\n  },\n  subCommands: {\n    list: lineItemsListCommand,\n    create: () => import(\"./line-item-writes.ts\").then((m) => m.lineItemsCreateCommand),\n    update: () => import(\"./line-item-writes.ts\").then((m) => m.lineItemsUpdateCommand),\n    pause: () => import(\"./line-item-writes.ts\").then((m) => m.lineItemsPauseCommand),\n    resume: () => import(\"./line-item-writes.ts\").then((m) => m.lineItemsResumeCommand),\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n    \"campaign-ids\": { type: \"string\", description: \"CSV of campaign IDs\" },\n    \"line-item-ids\": { type: \"string\", description: \"CSV of line item IDs\" },\n    \"with-deleted\": { type: \"boolean\", description: \"Include deleted\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\" },\n    output: { type: \"string\", description: \"Format: json|csv|md\", default: \"json\" },\n  },\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}

package/dist/link-QL7Y2LML.js

@@ -0,0 +1,65 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-36MUCC42.js";
+import "./chunk-EXELLNQS.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/actions/link.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.link",
+  description: "Stage a 'blocker -> blocked' dependency. Refs can be either action IDs or tempIds from create ops in the same draft.",
+  args: {
+    blocker: { type: "string", description: "Blocker action ID or tempId", required: true },
+    blocked: { type: "string", description: "Blocked action ID or tempId", required: true }
+  }
+});
+var linkCommand = defineCommand({
+  meta: {
+    name: "link",
+    description: "Stage a dependency link. Example: baker actions link --blocker <id> --blocked <id>"
+  },
+  args: {
+    blocker: { type: "string", description: "Blocker ref", required: false },
+    blocked: { type: "string", description: "Blocked ref", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const blocker = args.blocker;
+      const blocked = args.blocked;
+      if (!blocker || !blocked) {
+        failValidation("--blocker and --blocked are required.");
+      }
+      const chatId = requireChatId();
+      await apiPost("/api/actions/link", {
+        chatId,
+        blockerRef: blocker,
+        blockedRef: blocked
+      });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  linkCommand
+};
+//# sourceMappingURL=link-QL7Y2LML.js.map