@koda-sl/baker-cli 0.534.0 → 0.535.0

package/dist/campaign-writes-JWHRXUZZ.js

@@ -0,0 +1,176 @@
+import {
+  clearableArg,
+  clearableCsvArg,
+  compact,
+  csvArg,
+  lowerArg,
+  lowerCsvArg,
+  microsFromArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-4ZPR265V.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-CHOCMV4I.js";
+import "./chunk-SBFNGJ4C.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-X6AHLUC7.js";
+import "./chunk-TM5UTSE4.js";
+import "./chunk-6THXOWAP.js";
+import {
+  registerSchema
+} from "./chunk-S6WPMD3V.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-JWHRXUZZ.js.map

package/dist/campaign-writes-MGRQBCFJ.js

@@ -0,0 +1,168 @@
+import {
+  compact,
+  microsFromArg,
+  requireTarget,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-A4T5JI75.js";
+import "./chunk-FIN4ZXGJ.js";
+import "./chunk-3FEOMQUT.js";
+import "./chunk-SBFNGJ4C.js";
+import "./chunk-HVJJEQDQ.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-46YLDIQG.js";
+import "./chunk-X6AHLUC7.js";
+import "./chunk-TM5UTSE4.js";
+import "./chunk-6THXOWAP.js";
+import {
+  registerSchema
+} from "./chunk-S6WPMD3V.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: "positional", 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: "positional", 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-MGRQBCFJ.js.map

package/dist/campaigns-4HC42PEZ.js

@@ -0,0 +1,113 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-ERYI4T2D.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-SBFNGJ4C.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-O57XNXSN.js";
+import "./chunk-HVJJEQDQ.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-46YLDIQG.js";
+import {
+  apiGet
+} from "./chunk-X6AHLUC7.js";
+import "./chunk-TM5UTSE4.js";
+import "./chunk-6THXOWAP.js";
+import "./chunk-S6WPMD3V.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-Q4FTWGRN.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-Q4FTWGRN.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-Q4FTWGRN.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-Q4FTWGRN.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-Q4FTWGRN.js").then((m) => m.campaignsArchiveCommand),
+    duplicate: () => import("./write-commands-Q4FTWGRN.js").then((m) => m.campaignsDuplicateCommand),
+    delete: () => import("./write-commands-Q4FTWGRN.js").then((m) => m.campaignsDeleteCommand),
+    "url-params": () => import("./write-commands-Q4FTWGRN.js").then((m) => m.campaignsUrlParamsCommand),
+    "exclude-companies": () => import("./write-commands-Q4FTWGRN.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-4HC42PEZ.js.map

package/dist/campaigns-5UI2LNQN.js

@@ -0,0 +1,130 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  budgetUnitHints,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-NT4KXGNJ.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-6ZX3Q4X7.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-SBFNGJ4C.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-O57XNXSN.js";
+import "./chunk-65Y3RCWP.js";
+import {
+  apiGet
+} from "./chunk-X6AHLUC7.js";
+import "./chunk-TM5UTSE4.js";
+import "./chunk-6THXOWAP.js";
+import "./chunk-S6WPMD3V.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/campaigns.ts
+import { defineCommand } from "citty";
+function advantagePlusHints(rows) {
+  const named = rows.flatMap((row) => {
+    const info = row.advantage_state_info;
+    const state = info?.advantage_state;
+    return typeof state === "string" && state.startsWith("ADVANTAGE_PLUS_") ? [`${String(row.id)} (${state.slice("ADVANTAGE_PLUS_".length).toLowerCase()})`] : [];
+  });
+  return named.length > 0 ? [
+    `Advantage+ campaigns: ${named.join(", ")}. Per-lever states (budget, audience, placements): --fields id,name,advantage_state_info.`
+  ] : [];
+}
+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,advantage_state_info); --full returns every field Meta sent; --output json returns the rows in the envelope. A hint names the campaigns Meta counts as Advantage+.",
+  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 = await 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"),
+        ...advantagePlusHints(data),
+        ...budgetUnitHints(data)
+      ]);
+    } 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/copy).
+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,
+advantage_state_info). A hint names the campaigns Meta counts as Advantage+ \u2014 a state Meta derives from a
+campaign budget, Advantage+ audience and automatic placements on every ad set, not a setting;
+--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-HMMBM5OC.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-HMMBM5OC.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-HMMBM5OC.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-HMMBM5OC.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-HMMBM5OC.js").then((m) => m.campaignsArchiveCommand),
+    delete: () => import("./write-commands-HMMBM5OC.js").then((m) => m.campaignsDeleteCommand),
+    duplicate: () => import("./write-commands-HMMBM5OC.js").then((m) => m.campaignsDuplicateCommand),
+    copy: () => import("./copy-writes-RF7MUAWA.js").then((m) => m.campaignsCopyCommand)
+  },
+  // `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 {
+  advantagePlusHints,
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-5UI2LNQN.js.map

package/dist/campaigns-KUN7KPBU.js

@@ -0,0 +1,78 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-CHOCMV4I.js";
+import "./chunk-SBFNGJ4C.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-X6AHLUC7.js";
+import "./chunk-TM5UTSE4.js";
+import "./chunk-6THXOWAP.js";
+import {
+  registerSchema
+} from "./chunk-S6WPMD3V.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-JWHRXUZZ.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./campaign-writes-JWHRXUZZ.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./campaign-writes-JWHRXUZZ.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./campaign-writes-JWHRXUZZ.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./campaign-writes-JWHRXUZZ.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-KUN7KPBU.js.map