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

package/dist/x-TPEKLUTG.js

@@ -0,0 +1,47 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/index.ts
+import { defineCommand } from "citty";
+var xCommand = defineCommand({
+  meta: {
+    name: "x",
+    description: `X (Twitter) Ads commands. Read campaigns, line items, promoted tweets, creatives, audiences, and analytics.
+
+Start here:
+  baker ads x accounts                              \u2014 list accessible X Ads accounts
+  baker ads x stats sync --list-presets             \u2014 see available stats presets
+  baker ads x targeting-constants --constant locations --q "Madrid"
+
+Examples:
+  baker ads x campaigns --account-id 18ce53xyz
+  baker ads x line-items --account-id 18ce53xyz --campaign-ids abc
+  baker ads x promoted-tweets --account-id 18ce53xyz
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+  baker ads x stats job-create --entity CAMPAIGN --entity-ids abc \\
+    --start-time 2026-04-01T00:00:00Z --end-time 2026-05-01T00:00:00Z \\
+    --metric-groups ENGAGEMENT,BILLING --segmentation-type LOCATIONS
+
+The CLI auto-detects --account-id when exactly one X Ads account is connected, or via BAKER_X_ADS_ACCOUNT_ID.
+Full guide: __tooling__/docs/tools/baker/ads-x.md`
+  },
+  subCommands: {
+    accounts: () => import("./accounts-ARO5HAHH.js").then((m) => m.accountsCommand),
+    funding: () => import("./funding-UZUGMCI4.js").then((m) => m.fundingCommand),
+    campaigns: () => import("./campaigns-5L7R2HO6.js").then((m) => m.campaignsCommand),
+    "line-items": () => import("./line-items-EJUWLXKX.js").then((m) => m.lineItemsCommand),
+    "promoted-tweets": () => import("./promoted-tweets-6LCVTNA4.js").then((m) => m.promotedTweetsCommand),
+    tweets: () => import("./tweets-HESNCAOU.js").then((m) => m.tweetsCommand),
+    cards: () => import("./cards-45GJXE6B.js").then((m) => m.cardsCommand),
+    draft: () => import("./draft-A2W2GB6J.js").then((m) => m.draftCommand),
+    media: () => import("./media-KFQ56V4R.js").then((m) => m.mediaCommand),
+    audiences: () => import("./audiences-MDJ34WFZ.js").then((m) => m.audiencesCommand),
+    "targeting-criteria": () => import("./targeting-criteria-CRRYYBHP.js").then((m) => m.targetingCriteriaCommand),
+    "targeting-constants": () => import("./targeting-constants-6RAE4UMA.js").then((m) => m.targetingConstantsCommand),
+    "active-entities": () => import("./active-entities-5RIKIFLQ.js").then((m) => m.activeEntitiesCommand),
+    stats: () => import("./stats-ROWGFLUZ.js").then((m) => m.statsCommand)
+  }
+});
+export {
+  xCommand
+};
+//# sourceMappingURL=x-TPEKLUTG.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koda-sl/baker-cli",
-  "version": "0.545.0-dev.2a6beac48",
+  "version": "0.546.0",
   "description": "AI-agent-first CLI for interacting with Baker, including the Baker creative canvas.",
   "type": "module",
   "bin": {

package/dist/account-D236Y3BP.js

@@ -1,82 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError,
-  resolveAccountIdArg
-} from "./chunk-DD6IMD7G.js";
-import {
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-MGWAZXY6.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-FPTEBOB5.js";
-import "./chunk-S47XHWFU.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-BNO3EFGR.js";
-import {
-  apiGet
-} from "./chunk-B2OHCWYB.js";
-import "./chunk-SVUFNCOE.js";
-import "./chunk-E54435XT.js";
-import "./chunk-WCIS4FZH.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/account.ts
-import { defineCommand } from "citty";
-var accountDetailCommand = defineCommand({
-  meta: {
-    name: "detail",
-    description: `Single LinkedIn ad account detail (currency, status, type).
-
-Examples:
-  baker ads linkedin account --account-id 503001492
-  baker ads linkedin account --account-urn urn:li:sponsoredAccount:503001492 --output md`
-  },
-  args: {
-    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
-    "account-urn": { type: "string", description: "Alias for --account-id" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    const accountId = resolveAccountIdArg(args);
-    try {
-      const params = { "account-id": accountId };
-      if (args["no-cache"]) params["skip-cache"] = "true";
-      const data = await apiGet("/api/ads/linkedin/account", params);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput([data], fmt);
-        return;
-      }
-      writeAdsJson({ ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-var accountCommand = defineCommand({
-  meta: {
-    name: "account",
-    description: `LinkedIn ad account: its detail, and the settings that apply across every ad set in it.
-
-Examples:
-  baker ads linkedin account --account-id 503001492                          \u2014 currency, status, type
-  baker ads linkedin account url-params --param utm_source=linkedin          \u2014 UTMs for every ad in the account`
-  },
-  subCommands: {
-    detail: accountDetailCommand,
-    "url-params": () => import("./write-commands-ECCJLDLG.js").then((m) => m.accountUrlParamsCommand)
-  },
-  args: accountDetailCommand.args,
-  default: "detail"
-});
-export {
-  accountCommand
-};
-//# sourceMappingURL=account-D236Y3BP.js.map

package/dist/account-IG3U6UXZ.js

@@ -1,82 +0,0 @@
-import {
-  CHATGPT_ADS_REFERENCE,
-  runChatgptRead
-} from "./chunk-L7AJMZ6Z.js";
-import "./chunk-MGWAZXY6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import {
-  apiGet
-} from "./chunk-B2OHCWYB.js";
-import "./chunk-SVUFNCOE.js";
-import "./chunk-E54435XT.js";
-import {
-  registerSchema
-} from "./chunk-WCIS4FZH.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/chatgpt/account.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "ads.chatgpt.account",
-  description: "The connected ChatGPT Ads account: name, currency, timezone, status, and the brand and account reviews that decide whether anything in it can serve.",
-  args: {
-    full: { type: "boolean", description: "Return ChatGPT Ads' own account object", required: false }
-  }
-});
-function accountHints(account) {
-  const hints = [];
-  if (account.brandReview.status !== "approved") {
-    const reason = account.brandReview.reason ? ` (${account.brandReview.reason})` : "";
-    hints.push(
-      `Brand review is ${account.brandReview.status}${reason}: nothing in this account serves until it is approved. Fix it in ChatGPT Ads Manager before changing campaigns.`
-    );
-  }
-  if (account.accountReview && account.accountReview.status !== "approved") {
-    hints.push(`A separate account review is ${account.accountReview.status}; delivery can wait on it too.`);
-  }
-  if (account.status === "paused") {
-    hints.push("The whole account is paused, so no campaign in it serves whatever its own status says.");
-  }
-  return hints;
-}
-var SHOW_ARGS = {
-  full: { type: "boolean", description: "Return ChatGPT Ads' own account object", required: false }
-};
-var accountShowCommand = defineCommand({
-  meta: {
-    name: "show",
-    description: "The connected ChatGPT Ads account. Example: baker ads chatgpt account"
-  },
-  args: SHOW_ARGS,
-  run: async ({ args }) => {
-    await runChatgptRead(
-      CHATGPT_ADS_REFERENCE.account,
-      () => apiGet("/api/ads/chatgpt/account", args.full ? { full: "true" } : void 0),
-      (account) => args.full ? [] : accountHints(account)
-    );
-  }
-});
-var accountCommand = defineCommand({
-  meta: {
-    name: "account",
-    description: `The connected ChatGPT Ads account. Start here: currency and timezone for every figure, and whether reviews let anything serve.
-
-Examples:
-  baker ads chatgpt account
-  baker ads chatgpt account --full
-  baker ads chatgpt account update --favicon-url https://example.com/icon.png   \u2014 staged; applies on publish`
-  },
-  subCommands: {
-    show: accountShowCommand,
-    update: () => import("./account-writes-BSSKSTZ2.js").then((m) => m.accountUpdateCommand)
-  },
-  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
-  args: SHOW_ARGS,
-  default: "show"
-});
-export {
-  accountCommand,
-  accountHints
-};
-//# sourceMappingURL=account-IG3U6UXZ.js.map

package/dist/account-reads-L2GYNCD3.js

@@ -1,219 +0,0 @@
-import {
-  exitWithServiceReadError
-} from "./chunk-Q7BVIPQF.js";
-import {
-  failWriteValidation,
-  listFlag,
-  requireCustomerId
-} from "./chunk-B74ZFQKS.js";
-import "./chunk-ERSX3MKH.js";
-import "./chunk-3W4IORXH.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-NGQ5J4FV.js";
-import "./chunk-QALAJNBG.js";
-import "./chunk-GCFC2MNR.js";
-import {
-  getManagerIdForCustomer,
-  writeJsonEnvelope
-} from "./chunk-MGWAZXY6.js";
-import "./chunk-VWOKPC3T.js";
-import "./chunk-BGT5ZA4L.js";
-import "./chunk-JF2XP76K.js";
-import "./chunk-SYLPRIFM.js";
-import "./chunk-XBR7TSZN.js";
-import "./chunk-DGUN7FUH.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-BNO3EFGR.js";
-import {
-  apiPost
-} from "./chunk-B2OHCWYB.js";
-import "./chunk-SVUFNCOE.js";
-import "./chunk-E54435XT.js";
-import {
-  registerSchema
-} from "./chunk-WCIS4FZH.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/google/account-reads.ts
-import { defineCommand } from "citty";
-function register(command, description, args) {
-  registerSchema({
-    command,
-    description,
-    args: Object.fromEntries(
-      Object.entries(args).map(([name, arg]) => [
-        name,
-        { type: arg.type, description: arg.description, required: false }
-      ])
-    )
-  });
-}
-async function serviceRead(path, customerId, body) {
-  const managerId = getManagerIdForCustomer(customerId);
-  const { data } = await apiPost(path, {
-    customerId,
-    ...managerId ? { managerId } : {},
-    ...body
-  });
-  return data;
-}
-var CUSTOMER_ARG = {
-  "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)" }
-};
-var INVOICE_ARGS = {
-  ...CUSTOMER_ARG,
-  month: { type: "string", description: "Issue month, YYYY-MM (default: last month)" }
-};
-register(
-  "ads.google.invoices",
-  "List the invoices Google issued in one month (accounts on monthly invoicing only): id, dates, service period, subtotal/tax/total in micros, PDF link. Start here: `baker ads google invoices --customer-id 1234567890 --month 2026-09`. An account that pays automatically has no invoices \u2014 the error's fix says where its receipts are; carry on.",
-  INVOICE_ARGS
-);
-var invoicesCommand = defineCommand({
-  meta: {
-    name: "invoices",
-    description: `List one month's invoices (monthly-invoicing accounts only). Read-only.
-
-Example:
-  baker ads google invoices --customer-id 1234567890 --month 2026-09`
-  },
-  args: INVOICE_ARGS,
-  run: async ({ args }) => {
-    const customerId = requireCustomerId(args);
-    try {
-      const data = await serviceRead("/api/ads/google/invoices", customerId, {
-        ...args.month ? { month: args.month } : {}
-      });
-      const hints = data.invoices.length === 0 ? [`No invoice was issued in ${data.month}. Try the month before with --month.`] : [
-        "Amounts are micros in each invoice's currency_code (divide by 1,000,000). pdf_url needs the user's Google sign-in."
-      ];
-      writeJsonEnvelope({ ok: true, data, hints });
-    } catch (err) {
-      exitWithServiceReadError(err);
-    }
-  }
-});
-register(
-  "ads.google.identity-verification",
-  "Advertiser identity verification status: each program's status (PENDING_USER_ACTION, PENDING_REVIEW, SUCCESS, FAILURE), deadlines and the link where the user completes it. Start here: `baker ads google identity-verification --customer-id 1234567890`. Google only answers for accounts on monthly invoicing \u2014 otherwise the error's fix says where the user reads it; carry on.",
-  CUSTOMER_ARG
-);
-var identityVerificationCommand = defineCommand({
-  meta: {
-    name: "identity-verification",
-    description: `Advertiser identity verification status and deadlines. Read-only.
-
-Example:
-  baker ads google identity-verification --customer-id 1234567890`
-  },
-  args: CUSTOMER_ARG,
-  run: async ({ args }) => {
-    const customerId = requireCustomerId(args);
-    try {
-      const data = await serviceRead(
-        "/api/ads/google/identity-verification",
-        customerId,
-        {}
-      );
-      const pending = data.programs.filter((program) => program.status === "PENDING_USER_ACTION");
-      const hints = pending.length > 0 ? [
-        `Verification is waiting on the advertiser${pending[0]?.completion_deadline ? ` (deadline ${pending[0].completion_deadline})` : ""}: give the user the action_url \u2014 ads stop serving if it lapses.`
-      ] : [];
-      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
-    } catch (err) {
-      exitWithServiceReadError(err);
-    }
-  }
-});
-var PREVIEW_ARGS = {
-  ...CUSTOMER_ARG,
-  ads: {
-    type: "string",
-    description: "Comma-separated video ads of Video campaigns as {adGroupId}~{adId} (from `ads list`) \u2014 previewed live on YouTube"
-  },
-  "asset-groups": {
-    type: "string",
-    description: "Comma-separated Performance Max asset group ids (from `asset-groups list`) \u2014 previewed on Google's preview page"
-  }
-};
-register(
-  "ads.google.previews",
-  "Shareable preview links for Performance Max asset groups (Google's preview page) and video ads (live on YouTube) that already exist in the account \u2014 a link the user can open or forward. Start here: `baker ads google previews --customer-id 1234567890 --asset-groups 6743268912`. Returns { previews: [{ target, url, youtube_tv_url, expires_at }] }. Only video ads of Video campaigns can be previewed by ad (search, display and Demand Gen ads have no shareable preview); staged (unpublished) changes cannot be previewed.",
-  PREVIEW_ARGS
-);
-var previewsCommand = defineCommand({
-  meta: {
-    name: "previews",
-    description: `Shareable preview links for existing Performance Max asset groups and video ads. Read-only.
-
-Examples:
-  baker ads google previews --customer-id 1234567890 --asset-groups 6743268912
-  baker ads google previews --customer-id 1234567890 --ads 195752489650~826812181091   # a video ad, live on YouTube`
-  },
-  args: PREVIEW_ARGS,
-  run: async ({ args }) => {
-    const customerId = requireCustomerId(args);
-    const ads = listFlag(args.ads);
-    const assetGroups = listFlag(args["asset-groups"]);
-    if (!ads?.length && !assetGroups?.length) failWriteValidation("pass --ads and/or --asset-groups");
-    try {
-      const data = await serviceRead("/api/ads/google/previews", customerId, {
-        ...ads ? { ads } : {},
-        ...assetGroups ? { assetGroups } : {}
-      });
-      writeJsonEnvelope({
-        ok: true,
-        data,
-        hints: [
-          "Each link expires (expires_at). It shows what is live in the account now, not anything staged in this chat."
-        ]
-      });
-    } catch (err) {
-      exitWithServiceReadError(err);
-    }
-  }
-});
-var BRAND_ARGS = {
-  ...CUSTOMER_ARG,
-  prefix: { type: "string", description: "The start of the brand's name (at least 2 letters)" }
-};
-register(
-  "ads.google.brands",
-  "Find a brand's Google entity id \u2014 what a BRANDS list member names (`keyword-lists add --brand /g/\u2026`). Start here: `baker ads google brands --customer-id 1234567890 --prefix nike`. Several brands can share a name: pick by the URL. Read-only.",
-  BRAND_ARGS
-);
-var brandsCommand = defineCommand({
-  meta: {
-    name: "brands",
-    description: `Find brand entity ids for a brand list (BRANDS). Read-only.
-
-Example:
-  baker ads google brands --customer-id 1234567890 --prefix nike`
-  },
-  args: BRAND_ARGS,
-  run: async ({ args }) => {
-    const customerId = requireCustomerId(args);
-    if (typeof args.prefix !== "string" || args.prefix.trim().length < 2) {
-      failWriteValidation("--prefix needs at least the first 2 letters of the brand");
-    }
-    try {
-      const data = await serviceRead("/api/ads/google/brands", customerId, {
-        prefix: args.prefix
-      });
-      const hints = data.brands.length > 0 ? [
-        "Several brands can share a name \u2014 pick the one whose URL is the brand you mean, then `keyword-lists add --list-ref <BRANDS list> --brand <entity_id>`."
-      ] : ["No brand starts with that \u2014 try a shorter or different prefix."];
-      writeJsonEnvelope({ ok: true, data, hints });
-    } catch (err) {
-      exitWithServiceReadError(err);
-    }
-  }
-});
-export {
-  brandsCommand,
-  identityVerificationCommand,
-  invoicesCommand,
-  previewsCommand
-};
-//# sourceMappingURL=account-reads-L2GYNCD3.js.map

package/dist/account-users-A5H7FC7T.js

@@ -1,64 +0,0 @@
-import {
-  bareAccountId
-} from "./chunk-OM45JY2R.js";
-import {
-  handleLinkedinError
-} from "./chunk-DD6IMD7G.js";
-import "./chunk-3W4IORXH.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-NGQ5J4FV.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-MGWAZXY6.js";
-import "./chunk-VWOKPC3T.js";
-import "./chunk-BGT5ZA4L.js";
-import "./chunk-JF2XP76K.js";
-import "./chunk-SYLPRIFM.js";
-import "./chunk-XBR7TSZN.js";
-import "./chunk-DGUN7FUH.js";
-import "./chunk-S47XHWFU.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-BNO3EFGR.js";
-import {
-  apiGet
-} from "./chunk-B2OHCWYB.js";
-import "./chunk-SVUFNCOE.js";
-import "./chunk-E54435XT.js";
-import "./chunk-WCIS4FZH.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/account-users.ts
-import { defineCommand } from "citty";
-var accountUsersCommand = defineCommand({
-  meta: {
-    name: "account-users",
-    description: `Who works on the ad account and their Campaign Manager role (Billing admin, Account manager, Campaign manager, Creative manager, Viewer); \`connectedLinkedin: true\` marks the person whose connection Baker publishes with.
-Start here when: a conversation or message ad needs a sender (\`creatives create --format conversation --sender <person>\` \u2014 the default is the connected person), or a publish was refused for want of a role (a Viewer or Creative manager can't change campaigns).
-LinkedIn only gives this app each person's id, not their name.
-Example: baker ads linkedin account-users --account-id 513852526`
-  },
-  args: {
-    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
-    "account-urn": { type: "string", description: "Alias for --account-id" }
-  },
-  run: async ({ args }) => {
-    try {
-      const data = await apiGet("/api/ads/linkedin/account-users", {
-        "account-id": bareAccountId(args)
-      });
-      writeJsonEnvelope({ ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-export {
-  accountUsersCommand
-};
-//# sourceMappingURL=account-users-A5H7FC7T.js.map

package/dist/account-writes-BSSKSTZ2.js

@@ -1,68 +0,0 @@
-import {
-  compact,
-  schemaArgs,
-  stageChatgptOp
-} from "./chunk-64ALJ6TJ.js";
-import {
-  CHATGPT_ADS_REFERENCE,
-  chatgptFailure
-} from "./chunk-L7AJMZ6Z.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-MGWAZXY6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import {
-  apiGet
-} from "./chunk-B2OHCWYB.js";
-import "./chunk-SVUFNCOE.js";
-import "./chunk-E54435XT.js";
-import {
-  registerSchema
-} from "./chunk-WCIS4FZH.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/chatgpt/account-writes.ts
-import { defineCommand } from "citty";
-var REFERENCE = CHATGPT_ADS_REFERENCE.account;
-var UPDATE_ARGS = {
-  name: { type: "string", description: "The advertiser name shown on every card" },
-  "favicon-url": { type: "string", description: "https:// square icon, at least 128 \xD7 128 px" }
-};
-registerSchema({
-  command: "ads.chatgpt.account.update",
-  description: "Stage a change to the advertiser's brand name or icon. It applies when the chat is published and starts a new brand review; nothing in the account serves until it is approved.",
-  args: schemaArgs(UPDATE_ARGS)
-});
-var accountUpdateCommand = defineCommand({
-  meta: {
-    name: "update",
-    description: `Stage a change to the brand name or icon (applies when the chat is published).
-
-Examples:
-  baker ads chatgpt account update --favicon-url https://example.com/icon.png
-  baker ads chatgpt account update --name "GreenLeaf Energy"`
-  },
-  args: UPDATE_ARGS,
-  run: async ({ args }) => {
-    let account;
-    try {
-      account = await apiGet("/api/ads/chatgpt/account");
-    } catch (err) {
-      writeJsonEnvelope({ ...chatgptFailure(err, REFERENCE) });
-      process.exit(1);
-    }
-    await stageChatgptOp(
-      {
-        kind: "account.update",
-        target: account.id,
-        payload: compact({ name: args.name, faviconUrl: args["favicon-url"] })
-      },
-      REFERENCE
-    );
-  }
-});
-export {
-  accountUpdateCommand
-};
-//# sourceMappingURL=account-writes-BSSKSTZ2.js.map