@koda-sl/baker-cli 0.466.0 → 0.467.0

package/dist/campaign-writes-2LMGW7FW.js

@@ -0,0 +1,165 @@
+import {
+  compact,
+  microsFromArg,
+  requireTarget,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-HWSUW5PX.js";
+import "./chunk-M6UNISGO.js";
+import "./chunk-H7JOVRHO.js";
+import "./chunk-LHNL6JM2.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema
+} from "./chunk-4DM6OAQ6.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-2LMGW7FW.js.map

package/dist/campaign-writes-2LMGW7FW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/campaign-writes.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport {\n  compact,\n  microsFromArg,\n  requireTarget,\n  requireTargets,\n  stageAccountId,\n  stageXOp,\n  stageXOps,\n} from \"./write-shared.ts\";\n\n/**\n * Staged campaign writes. Nothing here calls X: each command appends an op to\n * this chat's draft, which applies when the chat publishes.\n */\n\nconst BUDGET_ARGS = {\n  \"daily-budget\": { type: \"string\", description: \"Daily budget in account currency, e.g. 12.50\" },\n  \"total-budget\": { type: \"string\", description: \"Lifetime budget in account currency — must exceed the daily budget\" },\n} as const;\n\nregisterSchema({\n  command: \"ads.x.campaigns.create\",\n  description:\n    \"Stage a new X campaign on this chat's draft. Needs a funding instrument (`baker ads x funding`). Defaults to PAUSED — an ACTIVE campaign starts spending the moment the chat publishes.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    name: { type: \"string\", description: \"Campaign name\", required: true },\n    \"funding-instrument-id\": { type: \"string\", description: \"From `baker ads x funding`\", required: true },\n    status: { type: \"string\", description: \"ACTIVE | PAUSED | DRAFT (default PAUSED)\", required: false },\n    \"daily-budget\": { type: \"string\", description: \"Daily budget in account currency\", required: false },\n    \"total-budget\": { type: \"string\", description: \"Lifetime budget in account currency\", required: false },\n    \"budget-optimization\": { type: \"string\", description: \"CAMPAIGN | LINE_ITEM\", required: false },\n  },\n});\n\nexport const campaignsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a new campaign (applies when the chat is published).\n\nExamples:\n  baker ads x campaigns create --name \"zz-baker-harness\" --funding-instrument-id vtbot --daily-budget 5`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n    name: { type: \"string\", description: \"Campaign name\", required: true },\n    \"funding-instrument-id\": { type: \"string\", description: \"Funding instrument id\", required: true },\n    status: { type: \"string\", description: \"ACTIVE | PAUSED | DRAFT (default PAUSED)\" },\n    ...BUDGET_ARGS,\n    \"budget-optimization\": { type: \"string\", description: \"CAMPAIGN | LINE_ITEM\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOp({\n      kind: \"campaign.create\",\n      accountId,\n      payload: compact({\n        name: args.name,\n        fundingInstrumentId: args[\"funding-instrument-id\"],\n        entityStatus: args.status,\n        budgetOptimization: args[\"budget-optimization\"],\n        dailyBudgetAmountLocalMicro: microsFromArg(args[\"daily-budget\"], \"--daily-budget\"),\n        totalBudgetAmountLocalMicro: microsFromArg(args[\"total-budget\"], \"--total-budget\"),\n      }),\n    });\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.campaigns.update\",\n  description:\n    \"Stage a change to an existing X campaign. Staging the same campaign twice amends the staged change in place rather than queueing two writes.\",\n  args: {\n    id: { type: \"string\", description: \"Campaign id\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    name: { type: \"string\", description: \"New name\", required: false },\n    status: { type: \"string\", description: \"ACTIVE | PAUSED\", required: false },\n    \"daily-budget\": { type: \"string\", description: \"Daily budget in account currency\", required: false },\n    \"total-budget\": { type: \"string\", description: \"Lifetime budget in account currency\", required: false },\n    \"budget-optimization\": { type: \"string\", description: \"CAMPAIGN | LINE_ITEM\", required: false },\n  },\n});\n\nexport const campaignsUpdateCommand = defineCommand({\n  meta: {\n    name: \"update\",\n    description: `Stage a change to a campaign.\n\nExamples:\n  baker ads x campaigns update oilf0 --daily-budget 20\n  baker ads x campaigns update oilf0 --name \"Spring push\"`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Campaign id\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n    name: { type: \"string\", description: \"New name\" },\n    status: { type: \"string\", description: \"ACTIVE | PAUSED\" },\n    ...BUDGET_ARGS,\n    \"budget-optimization\": { type: \"string\", description: \"CAMPAIGN | LINE_ITEM\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOp({\n      kind: \"campaign.update\",\n      accountId,\n      target: requireTarget(args, \"id\"),\n      payload: compact({\n        name: args.name,\n        entityStatus: args.status,\n        budgetOptimization: args[\"budget-optimization\"],\n        dailyBudgetAmountLocalMicro: microsFromArg(args[\"daily-budget\"], \"--daily-budget\"),\n        totalBudgetAmountLocalMicro: microsFromArg(args[\"total-budget\"], \"--total-budget\"),\n      }),\n    });\n  },\n});\n\nfunction statusCommand(name: \"pause\" | \"resume\", status: \"PAUSED\" | \"ACTIVE\") {\n  registerSchema({\n    command: `ads.x.campaigns.${name}`,\n    description: `Stage ${name === \"pause\" ? \"a pause\" : \"a resume\"} for one or more X campaigns. Pass every id in one call.`,\n    args: {\n      ids: { type: \"string\", description: \"Campaign ids, comma-separated\", required: true },\n      \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    },\n  });\n  return defineCommand({\n    meta: {\n      name,\n      description: `Stage ${name === \"pause\" ? \"pausing\" : \"resuming\"} campaigns.\n\nExample:\n  baker ads x campaigns ${name} oilf0,omyq3`,\n    },\n    args: {\n      ids: { type: \"positional\", description: \"Campaign ids, comma-separated\", required: true },\n      \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n    },\n    run: async ({ args }) => {\n      const accountId = await stageAccountId(args);\n      await stageXOps(\n        requireTargets(args, \"ids\").map((id) => ({\n          kind: \"campaign.update\",\n          accountId,\n          target: id,\n          payload: { entityStatus: status },\n        })),\n      );\n    },\n  });\n}\n\nexport const campaignsPauseCommand = statusCommand(\"pause\", \"PAUSED\");\nexport const campaignsResumeCommand = statusCommand(\"resume\", \"ACTIVE\");\n"],"mappings":"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","names":[]}

package/dist/campaign-writes-4N3LQJL2.js

@@ -0,0 +1,170 @@
+import {
+  clearableArg,
+  clearableCsvArg,
+  compact,
+  csvArg,
+  lowerArg,
+  lowerCsvArg,
+  microsFromArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-JE5NMVRX.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-JSEPE5EP.js";
+import "./chunk-LHNL6JM2.js";
+import "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema
+} from "./chunk-4DM6OAQ6.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-4N3LQJL2.js.map

package/dist/campaigns-5FH5THMS.js

@@ -0,0 +1,76 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-JSEPE5EP.js";
+import "./chunk-LHNL6JM2.js";
+import "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema
+} from "./chunk-4DM6OAQ6.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-4N3LQJL2.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./campaign-writes-4N3LQJL2.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./campaign-writes-4N3LQJL2.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./campaign-writes-4N3LQJL2.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./campaign-writes-4N3LQJL2.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-5FH5THMS.js.map

package/dist/campaigns-66OOGMDW.js

@@ -0,0 +1,110 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-INJHF7AF.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-O3LHCQ7Q.js";
+import "./chunk-LHNL6JM2.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-DL2W4N7J.js";
+import "./chunk-KIGGMKAE.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.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-5TJ3LQ5F.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.campaignsArchiveCommand),
+    delete: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.campaignsDeleteCommand),
+    duplicate: () => import("./write-commands-5TJ3LQ5F.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-66OOGMDW.js.map

package/dist/campaigns-CYPLOBK3.js

@@ -0,0 +1,109 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-J57EXXFU.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-LHNL6JM2.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-DL2W4N7J.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.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-GLIDTGI3.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-GLIDTGI3.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-GLIDTGI3.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-GLIDTGI3.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-GLIDTGI3.js").then((m) => m.campaignsArchiveCommand),
+    duplicate: () => import("./write-commands-GLIDTGI3.js").then((m) => m.campaignsDuplicateCommand),
+    "url-params": () => import("./write-commands-GLIDTGI3.js").then((m) => m.campaignsUrlParamsCommand),
+    "exclude-companies": () => import("./write-commands-GLIDTGI3.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-CYPLOBK3.js.map