@koda-sl/baker-cli 0.453.0 → 0.454.0-dev.67ad219ab

package/dist/campaign-writes-PIOQVLAI.js

@@ -0,0 +1,170 @@
+import {
+  clearableArg,
+  clearableCsvArg,
+  compact,
+  csvArg,
+  lowerArg,
+  lowerCsvArg,
+  microsFromArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-4BIU2YVF.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-JGCYENVG.js";
+import "./chunk-CWW5ITFK.js";
+import "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema
+} from "./chunk-5WW456MW.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-PIOQVLAI.js.map

package/dist/campaign-writes-UGUL5EDR.js

@@ -0,0 +1,165 @@
+import {
+  compact,
+  microsFromArg,
+  requireTarget,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-W5FCTANB.js";
+import "./chunk-M6UNISGO.js";
+import "./chunk-E25X7QES.js";
+import "./chunk-CWW5ITFK.js";
+import "./chunk-IDYAVGCS.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema
+} from "./chunk-5WW456MW.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-UGUL5EDR.js.map

package/dist/campaigns-6ARLQJU2.js

@@ -0,0 +1,109 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-DMA7XZLS.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-CWW5ITFK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-UK4DUS6I.js";
+import "./chunk-IDYAVGCS.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiGet
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import "./chunk-5WW456MW.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-PKB23ZBZ.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-PKB23ZBZ.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-PKB23ZBZ.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-PKB23ZBZ.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-PKB23ZBZ.js").then((m) => m.campaignsArchiveCommand),
+    duplicate: () => import("./write-commands-PKB23ZBZ.js").then((m) => m.campaignsDuplicateCommand),
+    "url-params": () => import("./write-commands-PKB23ZBZ.js").then((m) => m.campaignsUrlParamsCommand),
+    "exclude-companies": () => import("./write-commands-PKB23ZBZ.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-6ARLQJU2.js.map

package/dist/campaigns-IZZ4FCHQ.js

@@ -0,0 +1,110 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-NPW3LEAE.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-7P2Y7OQF.js";
+import "./chunk-CWW5ITFK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-UK4DUS6I.js";
+import "./chunk-KIGGMKAE.js";
+import {
+  apiGet
+} from "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import "./chunk-5WW456MW.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/campaigns.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter and return everything" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  ...META_LIST_SHAPE_ARGS
+};
+registerMetaListSchema(
+  "campaigns",
+  "List campaigns in a Meta ad account, as a table by default: id, name, effective_status, daily_budget, lifetime_budget, created_date. ACTIVE only unless --all-statuses. Start here: baker ads meta campaigns --account-id act_123 --all-statuses. --fields takes dotted paths for anything else (e.g. id,name,objective,bid_strategy,special_ad_categories); --full returns every field Meta sent; --output json returns the rows in the envelope.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List campaigns for a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta campaigns --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args["name-contains"]) params["name-contains"] = args["name-contains"];
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/campaigns", params);
+      const shaped = shapeMetaListRows("campaigns", data, args);
+      writeMetaListRows("campaigns", shaped, csvOrJson(args), statusFilterHints(data, effectiveStatus, "campaigns"));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `List campaigns for a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate).
+Defaults to ACTIVE only \u2014 pass --all-statuses to widen. Write subcommands stage ops on this chat's draft and
+apply only when the chat is published.
+
+In Meta's API "campaign" is the top-of-tree object (what marketers usually call a campaign group).
+The dashboard shows effective_status: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, etc.
+
+Listings print a table by default: id, name, effective_status, daily/lifetime budget, created_date.
+--fields takes dotted paths for anything else (objective, bid_strategy, special_ad_categories, created_time);
+--full returns every field; --output json returns the same rows in the { ok, data } envelope.
+
+Examples:
+  baker ads meta campaigns --account-id act_123                                   # ACTIVE only
+  baker ads meta campaigns --account-id act_123 --all-statuses                    # everything
+  baker ads meta campaigns --account-id act_123 --all-statuses --name-contains Q3               # find one by name
+  baker ads meta campaigns --account-id act_123 --fields id,name,objective,bid_strategy,special_ad_categories
+  baker ads meta campaigns --account-id act_123 --output json                     # rows as JSON
+  baker ads meta campaigns create --account-id act_123 --name "Q3" --objective OUTCOME_LEADS --daily-budget 50
+  baker ads meta campaigns pause 6123 --account-id act_123`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-WYET5424.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-WYET5424.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-WYET5424.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-WYET5424.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-WYET5424.js").then((m) => m.campaignsArchiveCommand),
+    delete: () => import("./write-commands-WYET5424.js").then((m) => m.campaignsDeleteCommand),
+    duplicate: () => import("./write-commands-WYET5424.js").then((m) => m.campaignsDuplicateCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-IZZ4FCHQ.js.map

package/dist/campaigns-PFNTJHMX.js

@@ -0,0 +1,107 @@
+import {
+  runListCommand
+} from "./chunk-6K47VIWF.js";
+import "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-E25X7QES.js";
+import "./chunk-CWW5ITFK.js";
+import "./chunk-5BQCBI2G.js";
+import "./chunk-A7F3C6AJ.js";
+import "./chunk-YZIZEPAQ.js";
+import {
+  registerSchema
+} from "./chunk-5WW456MW.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-UGUL5EDR.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./campaign-writes-UGUL5EDR.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./campaign-writes-UGUL5EDR.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./campaign-writes-UGUL5EDR.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-PFNTJHMX.js.map