@koda-sl/baker-cli 0.461.0 → 0.462.0

package/dist/campaign-writes-6ICSZ6W5.js

@@ -0,0 +1,170 @@
+import {
+  clearableArg,
+  clearableCsvArg,
+  compact,
+  csvArg,
+  lowerArg,
+  lowerCsvArg,
+  microsFromArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-PIMITM2V.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-OATXWQPB.js";
+import "./chunk-V44SLD5J.js";
+import "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/campaign-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.campaigns;
+var SHARED_ARGS = {
+  name: { type: "string", description: "Campaign name (3+ characters)" },
+  description: { type: "string", description: "Internal description" },
+  "daily-budget": { type: "string", description: "Daily budget in account currency, e.g. 20 \u2014 or --lifetime-budget" },
+  "lifetime-budget": { type: "string", description: "Budget for the whole run in account currency" },
+  start: { type: "string", description: "Start, ISO 8601 (default: at publish)" },
+  end: { type: "string", description: "End, ISO 8601 (default: runs until paused)" },
+  countries: {
+    type: "string",
+    description: "Two-letter country codes, comma-separated, e.g. ES,MX. Changing any place or audience keeps the others as they are live"
+  },
+  "location-ids": {
+    type: "string",
+    description: "Region, market or postcode ids from `baker ads chatgpt locations`, comma-separated"
+  },
+  "excluded-countries": { type: "string", description: "Countries it never serves in, comma-separated \u2014 none clears" },
+  "excluded-location-ids": {
+    type: "string",
+    description: "Regions, markets or postcodes it never serves in, comma-separated \u2014 none clears"
+  },
+  "audience-ids": { type: "string", description: "Custom audiences it serves only to, comma-separated \u2014 none clears" },
+  "excluded-audience-ids": {
+    type: "string",
+    description: "Custom audiences it never serves, comma-separated \u2014 none clears"
+  },
+  "tracking-template": {
+    type: "string",
+    description: "Query string added to every landing page, e.g. utm_source=chatgpt&utm_campaign={campaign_id}&campaign_id={campaign_id}&ad_group_id={ad_group_id}&ad_id={ad_id} \u2014 keep the ids under those names, which Baker analytics splits by; the oppref click id is added by ChatGPT Ads itself. none clears"
+  },
+  platforms: {
+    type: "string",
+    description: "ios_app, android_app, web, desktop_web, ios_web, android_web \u2014 comma-separated (default: all)"
+  },
+  status: { type: "string", description: "paused (default) | active \u2014 active can spend the moment the chat publishes" },
+  "conversion-event-ids": {
+    type: "string",
+    description: "Conversions it measures, comma-separated (each id from `baker ads chatgpt conversions`, or a staged chatgpt_temp_ ref). On update it replaces the whole list. A conversions campaign takes exactly one standard conversion, fixed at creation"
+  }
+};
+var CREATE_ARGS = {
+  ...SHARED_ARGS,
+  "catalog-id": {
+    type: "string",
+    description: "Make it a catalog campaign: its ads come from this product catalog (fd_\u2026 from `catalogs`). Countries only; fixed once created"
+  },
+  name: { type: "string", description: "Campaign name (3+ characters)", required: true },
+  objective: { type: "string", description: "impressions | clicks | conversions \u2014 fixed once created", required: true }
+};
+var UPDATE_ARGS = {
+  id: { type: "positional", description: "Campaign id (cmpn_\u2026) or a staged chatgpt_temp_ ref", required: true },
+  ...SHARED_ARGS
+};
+function sharedPayload(args) {
+  return {
+    name: args.name,
+    description: args.description,
+    dailyBudgetMicros: microsFromArg(args["daily-budget"], "--daily-budget"),
+    lifetimeBudgetMicros: microsFromArg(args["lifetime-budget"], "--lifetime-budget"),
+    startTime: args.start,
+    endTime: args.end,
+    countries: clearableCsvArg(args.countries),
+    locationIds: clearableCsvArg(args["location-ids"]),
+    excludedCountries: clearableCsvArg(args["excluded-countries"]),
+    excludedLocationIds: clearableCsvArg(args["excluded-location-ids"]),
+    audienceIds: clearableCsvArg(args["audience-ids"]),
+    excludedAudienceIds: clearableCsvArg(args["excluded-audience-ids"]),
+    trackingTemplate: clearableArg(args["tracking-template"]),
+    platforms: lowerCsvArg(args.platforms),
+    status: lowerArg(args.status),
+    conversionEventSettingIds: csvArg(args["conversion-event-ids"])
+  };
+}
+function campaignUpdateOp(args) {
+  return { kind: "campaign.update", target: requireTarget(args, "id"), payload: compact(sharedPayload(args)) };
+}
+function campaignCreateOp(args) {
+  return {
+    kind: "campaign.create",
+    payload: compact({
+      ...sharedPayload(args),
+      objective: lowerArg(args.objective),
+      productFeedId: args["catalog-id"]
+    })
+  };
+}
+registerSchema({
+  command: "ads.chatgpt.campaigns.create",
+  description: "Stage a new ChatGPT Ads campaign on this chat's draft. Staged paused by default \u2014 nothing reaches ChatGPT Ads until the chat is published. Needs exactly one of --daily-budget or --lifetime-budget. The objective (and a conversions campaign's event) cannot change once it exists.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var campaignsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new campaign (applies when the chat is published). Needs exactly one of --daily-budget or --lifetime-budget.
+
+Examples:
+  baker ads chatgpt campaigns create --name "Spring push" --objective clicks --daily-budget 20 --countries ES
+  baker ads chatgpt campaigns create --name "Leads" --objective conversions --daily-budget 30 --conversion-event-ids 6ab69300554481a1`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(campaignCreateOp(args), REFERENCE, (staged) => [
+      `Next, give it an ad group: baker ads chatgpt ad-groups create --campaign-id ${staged.ref} --name "\u2026" --context-hints "\u2026" --max-bid 2.50`,
+      "Check this summary against everything the user asked for \u2014 countries, places to leave out, budget, dates \u2014 and stage what is missing before saying it is ready."
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.chatgpt.campaigns.update",
+  description: "Stage a change to a campaign \u2014 name, budget, schedule, places, audiences, platforms, tracking template or status. Changing any place or audience keeps the others as they are live; `none` clears a list. Staging the same campaign twice amends the staged change. A daily budget cannot become a lifetime one.",
+  args: schemaArgs(UPDATE_ARGS)
+});
+var campaignsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to a campaign.
+
+Examples:
+  baker ads chatgpt campaigns update cmpn_123 --daily-budget 35
+  baker ads chatgpt campaigns update cmpn_123 --countries ES,PT
+  baker ads chatgpt campaigns update cmpn_123 --excluded-location-ids 2000393
+  baker ads chatgpt campaigns update cmpn_123 --tracking-template "utm_source=chatgpt&utm_campaign={campaign_id}"
+  baker ads chatgpt campaigns update cmpn_123 --conversion-event-ids 6ab69300554481a1,6ab69300554481a2`
+  },
+  args: UPDATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(campaignUpdateOp(args), REFERENCE);
+  }
+});
+var campaignsPauseCommand = statusCommand("campaign", "pause", REFERENCE);
+var campaignsResumeCommand = statusCommand("campaign", "resume", REFERENCE);
+var campaignsArchiveCommand = statusCommand("campaign", "archive", REFERENCE);
+export {
+  campaignCreateOp,
+  campaignUpdateOp,
+  campaignsArchiveCommand,
+  campaignsCreateCommand,
+  campaignsPauseCommand,
+  campaignsResumeCommand,
+  campaignsUpdateCommand
+};
+//# sourceMappingURL=campaign-writes-6ICSZ6W5.js.map

package/dist/campaign-writes-GZQUYXJW.js

@@ -0,0 +1,164 @@
+import {
+  compact,
+  microsFromArg,
+  requireTarget,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-IAEI2ATC.js";
+import "./chunk-M6UNISGO.js";
+import "./chunk-7EBQ2WTU.js";
+import "./chunk-V44SLD5J.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/campaign-writes.ts
+import { defineCommand } from "citty";
+var BUDGET_ARGS = {
+  "daily-budget": { type: "string", description: "Daily budget in account currency, e.g. 12.50" },
+  "total-budget": { type: "string", description: "Lifetime budget in account currency \u2014 must exceed the daily budget" }
+};
+registerSchema({
+  command: "ads.x.campaigns.create",
+  description: "Stage a new X campaign on this chat's draft. Needs a funding instrument (`baker ads x funding`). Defaults to PAUSED \u2014 an ACTIVE campaign starts spending the moment the chat publishes.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    name: { type: "string", description: "Campaign name", required: true },
+    "funding-instrument-id": { type: "string", description: "From `baker ads x funding`", required: true },
+    status: { type: "string", description: "ACTIVE | PAUSED | DRAFT (default PAUSED)", 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 },
+    "budget-optimization": { type: "string", description: "CAMPAIGN | LINE_ITEM", required: false }
+  }
+});
+var campaignsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new campaign (applies when the chat is published).
+
+Examples:
+  baker ads x campaigns create --name "zz-baker-harness" --funding-instrument-id vtbot --daily-budget 5`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    name: { type: "string", description: "Campaign name", required: true },
+    "funding-instrument-id": { type: "string", description: "Funding instrument id", required: true },
+    status: { type: "string", description: "ACTIVE | PAUSED | DRAFT (default PAUSED)" },
+    ...BUDGET_ARGS,
+    "budget-optimization": { type: "string", description: "CAMPAIGN | LINE_ITEM" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "campaign.create",
+      accountId,
+      payload: compact({
+        name: args.name,
+        fundingInstrumentId: args["funding-instrument-id"],
+        entityStatus: args.status,
+        budgetOptimization: args["budget-optimization"],
+        dailyBudgetAmountLocalMicro: microsFromArg(args["daily-budget"], "--daily-budget"),
+        totalBudgetAmountLocalMicro: microsFromArg(args["total-budget"], "--total-budget")
+      })
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.campaigns.update",
+  description: "Stage a change to an existing X campaign. Staging the same campaign twice amends the staged change in place rather than queueing two writes.",
+  args: {
+    id: { type: "string", description: "Campaign 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 },
+    "daily-budget": { type: "string", description: "Daily budget in account currency", required: false },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency", required: false },
+    "budget-optimization": { type: "string", description: "CAMPAIGN | LINE_ITEM", required: false }
+  }
+});
+var campaignsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to a campaign.
+
+Examples:
+  baker ads x campaigns update oilf0 --daily-budget 20
+  baker ads x campaigns update oilf0 --name "Spring push"`
+  },
+  args: {
+    id: { type: "positional", description: "Campaign id", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" },
+    name: { type: "string", description: "New name" },
+    status: { type: "string", description: "ACTIVE | PAUSED" },
+    ...BUDGET_ARGS,
+    "budget-optimization": { type: "string", description: "CAMPAIGN | LINE_ITEM" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "campaign.update",
+      accountId,
+      target: requireTarget(args, "id"),
+      payload: compact({
+        name: args.name,
+        entityStatus: args.status,
+        budgetOptimization: args["budget-optimization"],
+        dailyBudgetAmountLocalMicro: microsFromArg(args["daily-budget"], "--daily-budget"),
+        totalBudgetAmountLocalMicro: microsFromArg(args["total-budget"], "--total-budget")
+      })
+    });
+  }
+});
+function statusCommand(name, status) {
+  registerSchema({
+    command: `ads.x.campaigns.${name}`,
+    description: `Stage ${name === "pause" ? "a pause" : "a resume"} for one or more X campaigns. Pass every id in one call.`,
+    args: {
+      ids: { type: "string", description: "Campaign 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"} campaigns.
+
+Example:
+  baker ads x campaigns ${name} oilf0,omyq3`
+    },
+    args: {
+      ids: { type: "positional", description: "Campaign 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: "campaign.update",
+          accountId,
+          target: id,
+          payload: { entityStatus: status }
+        }))
+      );
+    }
+  });
+}
+var campaignsPauseCommand = statusCommand("pause", "PAUSED");
+var campaignsResumeCommand = statusCommand("resume", "ACTIVE");
+export {
+  campaignsCreateCommand,
+  campaignsPauseCommand,
+  campaignsResumeCommand,
+  campaignsUpdateCommand
+};
+//# sourceMappingURL=campaign-writes-GZQUYXJW.js.map

package/dist/campaigns-3QHB7IYM.js

@@ -0,0 +1,108 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-WSYGMU3A.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-V44SLD5J.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiGet
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/campaigns.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" },
+  "campaign-group-id": { type: "string", description: "Filter by campaign group" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  statuses: { type: "string", description: statusesArgDescription("campaigns") },
+  limit: { type: "string", description: "Max rows (default: 500)" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+};
+var campaignsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List LinkedIn campaigns. Runs by default when no subcommand is given."
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      const statuses = resolveStatusFilter(args, "campaigns");
+      if (statuses) params.statuses = statuses.join(",");
+      if (args["campaign-group-id"]) params["campaign-group-id"] = String(args["campaign-group-id"]);
+      if (args.limit) params.limit = String(args.limit);
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/campaigns", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `List LinkedIn campaigns, or stage writes (create/update/pause/resume/archive/duplicate).
+
+Default: ACTIVE only. The schema includes the audit-relevant settings:
+  audienceExpansionEnabled \u2014 playbook \xA702 silent budget drain (should be false)
+  offsiteDeliveryEnabled   \u2014 LinkedIn Audience Network gate
+  optimizationTargetType   \u2014 driver of the bidding strategy
+  costType                 \u2014 CPC | CPM | CPV | CPS
+
+Write subcommands stage ops on this chat's draft \u2014 they never hit the LinkedIn
+API directly and apply only when the chat is published.
+
+Examples:
+  baker ads linkedin campaigns --account-id 503001492
+  baker ads linkedin campaigns --account-id 503001492 --all-statuses --output csv
+  baker ads linkedin campaigns update 123456 --daily-budget 100 --currency EUR
+  baker ads linkedin campaigns pause 123456
+  baker ads linkedin campaigns url-params 123456 --param utm_source=linkedin   \u2014 UTMs for every ad in the ad set
+  baker ads linkedin campaigns exclude-companies 123456 --org 1035,1441        \u2014 stop reaching these companies`
+  },
+  subCommands: {
+    list: campaignsListCommand,
+    create: () => import("./write-commands-DRPTQRPQ.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-DRPTQRPQ.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-DRPTQRPQ.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-DRPTQRPQ.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-DRPTQRPQ.js").then((m) => m.campaignsArchiveCommand),
+    duplicate: () => import("./write-commands-DRPTQRPQ.js").then((m) => m.campaignsDuplicateCommand),
+    "url-params": () => import("./write-commands-DRPTQRPQ.js").then((m) => m.campaignsUrlParamsCommand),
+    "exclude-companies": () => import("./write-commands-DRPTQRPQ.js").then((m) => m.campaignsExcludeCompaniesCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it *after* running
+  // the matched subcommand, so every write would also trigger a full live list.
+  // `args` stays here so citty's subcommand scan knows which flags take a value.
+  args: listArgs,
+  default: "list"
+});
+export {
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-3QHB7IYM.js.map

package/dist/campaigns-CNXKJMVI.js

@@ -0,0 +1,107 @@
+import {
+  runListCommand
+} from "./chunk-ZSROMVZB.js";
+import "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-7EBQ2WTU.js";
+import "./chunk-V44SLD5J.js";
+import "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/campaigns.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.campaigns",
+  description: "List campaigns for an X Ads account. Optionally filter by funding-instrument-ids or campaign-ids (comma-separated). Includes deleted with --with-deleted. Falls back to BAKER_X_ADS_ACCOUNT_ID.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted campaigns", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  }
+});
+var listArgs = {
+  "account-id": { type: "string", description: "X Ads account ID" },
+  "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs" },
+  "campaign-ids": { type: "string", description: "CSV of campaign 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" }
+};
+var campaignsListCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `List X Ads campaigns. Returns budget, schedule, funding instrument, status.
+
+Examples:
+  baker ads x campaigns --account-id 18ce53xyz
+  baker ads x campaigns --account-id 18ce53xyz --campaign-ids abc,def
+  baker ads x campaigns --account-id 18ce53xyz --with-deleted`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign 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 = `campaigns:${accountId}:${today}:${args["funding-instrument-ids"] ?? ""}:${args["campaign-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+    await runListCommand({
+      path: "/api/ads/x/campaigns",
+      cacheCategory: "x-account-data",
+      cacheKey,
+      cacheTtlMs: 60 * 60 * 1e3,
+      params: {
+        "account-id": accountId,
+        "funding-instrument-ids": args["funding-instrument-ids"],
+        "campaign-ids": args["campaign-ids"],
+        "with-deleted": args["with-deleted"] ? "true" : void 0
+      },
+      format: args.output || "json",
+      accountId,
+      useCache
+    });
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `X Ads campaigns \u2014 read them, or stage a change that applies when the chat is published.
+
+Write subcommands stage ops on this chat's draft. They never call X directly.
+
+Examples:
+  baker ads x campaigns
+  baker ads x campaigns create --name "Spring" --funding-instrument-id vtbot --daily-budget 5
+  baker ads x campaigns update oilf0 --daily-budget 20
+  baker ads x campaigns pause oilf0,omyq3`
+  },
+  subCommands: {
+    list: campaignsListCommand,
+    create: () => import("./campaign-writes-GZQUYXJW.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./campaign-writes-GZQUYXJW.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./campaign-writes-GZQUYXJW.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./campaign-writes-GZQUYXJW.js").then((m) => m.campaignsResumeCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it AFTER the
+  // matched subcommand, so every write would also trigger a full live list.
+  args: listArgs,
+  default: "list"
+});
+export {
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-CNXKJMVI.js.map

package/dist/campaigns-ERG4SGAD.js

@@ -0,0 +1,76 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-OATXWQPB.js";
+import "./chunk-V44SLD5J.js";
+import "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/campaigns.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.chatgpt.campaigns",
+  description: "Every campaign in the connected ChatGPT Ads account: status, objective, daily or lifetime budget (currency units), schedule, locations, platforms, and the serving issues ChatGPT Ads reports for it.",
+  args: {
+    full: { type: "boolean", description: "Return ChatGPT Ads' own campaign objects", required: false }
+  }
+});
+var LIST_ARGS = {
+  full: { type: "boolean", description: "Return ChatGPT Ads' own campaign objects", required: false }
+};
+function campaignHints(campaigns) {
+  if (campaigns.length === 0) {
+    return ["This account has no campaigns yet."];
+  }
+  const blocked = campaigns.filter((campaign) => campaign.servingIssues.length > 0);
+  return blocked.length > 0 ? [
+    `${blocked.length} campaign(s) report serving issues. Read servingIssues before changing a bid or budget \u2014 a higher bid does not fix a paused parent, a spent budget or a rejected ad.`
+  ] : [];
+}
+var campaignsListCommand = defineCommand({
+  meta: { name: "list", description: "ChatGPT Ads campaigns, newest first. Example: baker ads chatgpt campaigns" },
+  args: LIST_ARGS,
+  run: async ({ args }) => {
+    await runChatgptListRead(
+      CHATGPT_ADS_REFERENCE.campaigns,
+      "/api/ads/chatgpt/campaigns",
+      args.full ? { full: "true" } : void 0,
+      (campaigns) => args.full ? [] : campaignHints(campaigns)
+    );
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `ChatGPT Ads campaigns \u2014 read them with why each one is or is not serving, or stage a change that applies when the chat is published.
+
+Write subcommands stage changes on this chat's draft. They never call ChatGPT Ads directly.
+
+Examples:
+  baker ads chatgpt campaigns
+  baker ads chatgpt campaigns create --name "Spring push" --objective clicks --daily-budget 20 --countries ES
+  baker ads chatgpt campaigns update cmpn_123 --daily-budget 35
+  baker ads chatgpt campaigns pause cmpn_123,cmpn_456`
+  },
+  subCommands: {
+    list: campaignsListCommand,
+    create: () => import("./campaign-writes-6ICSZ6W5.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./campaign-writes-6ICSZ6W5.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./campaign-writes-6ICSZ6W5.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./campaign-writes-6ICSZ6W5.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./campaign-writes-6ICSZ6W5.js").then((m) => m.campaignsArchiveCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the
+  // matched subcommand, so every write would also trigger a live list.
+  args: LIST_ARGS,
+  default: "list"
+});
+export {
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-ERG4SGAD.js.map