@koda-sl/baker-cli 0.489.0 → 0.490.0

package/dist/audience-writes-X52VG35Y.js

@@ -0,0 +1,324 @@
+import {
+  DATE_ORDERS,
+  customerListBatches,
+  customerListFromFile,
+  customerListUploadRefusal
+} from "./chunk-5GQCN2QZ.js";
+import {
+  bareAccountId,
+  failWriteValidation,
+  repeatedListFlag,
+  requireTarget,
+  stageOp
+} from "./chunk-5C35OW7L.js";
+import {
+  CUSTOMER_LIST_BATCH_ROWS,
+  CUSTOMER_LIST_MAX_BATCHES,
+  brandSafetyTargetingFields
+} from "./chunk-A4MVVPJ2.js";
+import "./chunk-HLVRHBKL.js";
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-QTOZ32SU.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-SFJW2KED.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-FNA277HP.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-SWL4AAPP.js";
+import "./chunk-5WMTPYKT.js";
+import "./chunk-23H4ZJRP.js";
+import "./chunk-DWX44QL6.js";
+import "./chunk-2FSEESJU.js";
+import "./chunk-CVBKW75S.js";
+import "./chunk-BLAHHMPF.js";
+import "./chunk-XQIOCIDO.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import {
+  requireChatId
+} from "./chunk-EE72SSB2.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/audience-writes.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
+var membersArgs = {
+  id: {
+    type: "positional",
+    description: "Customer-list audience id, or a meta_temp_* ref created in this chat",
+    required: true
+  },
+  "account-id": { type: "string", description: "Meta ad account ID (act_123)" },
+  file: {
+    type: "string",
+    description: "CSV (or ;/tab separated) in the workspace with a header row: email, phone, first name, last name, city, state, zip, country, birthday, gender, madid, external id"
+  },
+  country: {
+    type: "string",
+    description: "Two-letter country for phones written without their country code (when the row has no country column)"
+  },
+  "value-column": {
+    type: "string",
+    description: "Value-based list only: the column with each person's value (e.g. revenue)"
+  },
+  columns: {
+    type: "string",
+    description: "For a file without a header row: what each column is, in order (email,phone,country \u2014 comma-separated or repeated)"
+  },
+  "date-format": {
+    type: "string",
+    description: "How birthdays like 03/07/1990 are written: DMY (day first) or MDY (month first, US). Needed only when no date in the file shows it"
+  }
+};
+function schemaArgs(args) {
+  return Object.fromEntries(
+    Object.entries(args).map(([key, arg]) => [
+      key,
+      { type: arg.type, description: arg.description, required: arg.required === true }
+    ])
+  );
+}
+var ACTION_NOTES = {
+  add: "Adds the people in the file to the list; those already in it stay.",
+  remove: "Removes the people in the file from the list.",
+  replace: "Replaces the whole list with the file \u2014 everyone not in it leaves. Runs alone: not beside another change to the same list in this chat."
+};
+function dateFormatFlag(value) {
+  if (value === void 0) return void 0;
+  const upperValue = String(value).toUpperCase();
+  if (!DATE_ORDERS.includes(upperValue)) {
+    failWriteValidation(`--date-format takes ${DATE_ORDERS.join(" or ")}, not ${String(value)}`);
+  }
+  return upperValue;
+}
+function readList(args, rawArgs) {
+  const path = typeof args.file === "string" ? args.file : "";
+  if (!path) {
+    failWriteValidation("pass --file with the customer list (CSV in the workspace)");
+  }
+  let content;
+  try {
+    content = readFileSync(path, "utf8");
+  } catch (err) {
+    failWriteValidation(`could not read ${path}: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  try {
+    return customerListFromFile(content, {
+      defaultCountry: typeof args.country === "string" ? args.country : void 0,
+      valueColumn: typeof args["value-column"] === "string" ? args["value-column"] : void 0,
+      columns: repeatedListFlag(rawArgs, "columns", args.columns),
+      dateFormat: dateFormatFlag(args["date-format"])
+    });
+  } catch (err) {
+    failWriteValidation(err instanceof Error ? err.message : String(err));
+  }
+}
+function listHints(list) {
+  const hints = [`${list.rows.length.toLocaleString("en-US")} people read from the file, hashed before upload`];
+  const unreadable = Object.entries(list.unreadable).map(([key, count]) => `${count} ${key}`);
+  if (unreadable.length > 0) {
+    hints.push(`values that could not be read and were left out: ${unreadable.join(", ")}`);
+  }
+  if (list.skippedRows > 0) {
+    hints.push(
+      `${list.skippedRows} rows had nothing Meta can match on (no readable email, phone or id${list.schema.includes("LOOKALIKE_VALUE") ? ", or no readable value" : ""}) and were left out`
+    );
+  }
+  if (list.ignoredColumns.length > 0) {
+    hints.push(`columns not sent (Meta does not match on them): ${list.ignoredColumns.join(", ")}`);
+  }
+  if (list.rows.length < 100) {
+    hints.push("Meta needs about 100 matched people before a list can be used for ads or as a lookalike seed");
+  }
+  return hints;
+}
+async function stageMembers(action, args, rawArgs) {
+  const accountId = bareAccountId(args);
+  const audienceId = requireTarget(args, "audience");
+  const list = readList(args, rawArgs);
+  if (list.rows.length === 0) {
+    failWriteValidation("no one in this file can be matched \u2014 check the columns (email, phone, \u2026) and their values");
+  }
+  const batches = customerListBatches(list.rows);
+  if (batches.length > CUSTOMER_LIST_MAX_BATCHES) {
+    failWriteValidation(
+      `this file holds ${list.rows.length.toLocaleString("en-US")} people; one change carries at most ${(CUSTOMER_LIST_BATCH_ROWS * CUSTOMER_LIST_MAX_BATCHES).toLocaleString("en-US")} \u2014 split the file and stage one add per part`
+    );
+  }
+  const refusal = customerListUploadRefusal(audienceId, action, list);
+  if (refusal) {
+    failWriteValidation(refusal);
+  }
+  const stored = [];
+  try {
+    const chatId = requireChatId();
+    for (const rows of batches) {
+      const response = await apiPost(
+        "/api/ads/meta/draft/customer-list-batch",
+        { chatId, accountId, batch: { schema: list.schema, rows } },
+        { timeoutMs: 12e4 }
+      );
+      stored.push(response.data);
+    }
+  } catch (err) {
+    handleMetaError(err);
+  }
+  await stageOp(
+    {
+      kind: "customAudience.members",
+      accountId,
+      payload: { audience_id: audienceId, action, schema: list.schema, batches: stored }
+    },
+    listHints(list)
+  );
+}
+function membersCommand(action) {
+  registerSchema({
+    command: `ads.meta.audiences.members.${action}`,
+    description: `Stage ${action === "add" ? "adding people to" : action === "remove" ? "removing people from" : "replacing everyone in"} a Meta customer list from a CSV in the workspace. ${ACTION_NOTES[action]} Every value is normalized and SHA-256 hashed on this machine before upload, as Meta asks; only counts are printed. Applied at publish; Meta takes up to 24h to match.`,
+    args: schemaArgs(membersArgs)
+  });
+  return defineCommand({
+    meta: {
+      name: action,
+      description: `${ACTION_NOTES[action]} ${STAGED_NOTE}
+Example: baker ads meta audiences members ${action} 120249492603650208 --file customers.csv --country ES`
+    },
+    args: membersArgs,
+    run: async ({ args, rawArgs }) => {
+      await stageMembers(action, args, rawArgs);
+    }
+  });
+}
+var audiencesMembersCommand = defineCommand({
+  meta: {
+    name: "members",
+    description: `Change who is in a customer-list audience, from a CSV in the workspace. Hashed here before upload. ${STAGED_NOTE}
+  baker ads meta audiences members add <audienceId|meta_temp_\u2026> --file customers.csv [--country ES]
+  baker ads meta audiences members remove <audienceId> --file unsubscribed.csv
+  baker ads meta audiences members replace <audienceId> --file customers.csv
+  value-based list: add --value-column revenue`
+  },
+  subCommands: {
+    add: membersCommand("add"),
+    remove: membersCommand("remove"),
+    replace: membersCommand("replace")
+  }
+});
+registerSchema({
+  command: "ads.meta.audiences.delete",
+  description: "Stage deleting a Meta custom audience \u2014 permanent, applied at publish. Every ad that targets it stops and cannot be restarted; Meta refuses while a lookalike is built from it (delete the lookalike first).",
+  args: {
+    id: { type: "positional", description: "Audience id", required: true },
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false }
+  }
+});
+var audiencesDeleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: `Stage deleting an audience \u2014 permanent: ads that target it stop for good. Only when the user asked to delete it. ${STAGED_NOTE}`
+  },
+  args: {
+    id: { type: "positional", description: "Audience id", required: true },
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)" }
+  },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "customAudience.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "audience"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+registerSchema({
+  command: "ads.meta.audiences.saved",
+  description: "List the ad account's saved audiences (targeting saved in Ads Manager), or one with --saved-audience-id. Read-only \u2014 Meta's API cannot create or change one. Use one on a new ad set with `adsets create --saved-audience <id>`.",
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false },
+    "saved-audience-id": {
+      type: "string",
+      description: "One saved audience, with its full targeting",
+      required: false
+    },
+    full: { type: "boolean", description: "Include each audience's whole targeting spec", required: false },
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+var savedAudiencesCommand = defineCommand({
+  meta: {
+    name: "saved",
+    description: "Saved audiences on the account (read-only). Example: baker ads meta audiences saved --account-id act_123; use one with `adsets create --saved-audience <id>`"
+  },
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)" },
+    "saved-audience-id": { type: "string", description: "One saved audience, with its full targeting" },
+    full: { type: "boolean", description: "Include each audience's whole targeting spec" },
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["saved-audience-id"]) params["saved-audience-id"] = String(args["saved-audience-id"]);
+      const rows = await apiGet("/api/ads/meta/saved-audiences", params);
+      const shown = args.full || args["saved-audience-id"] ? rows : rows.map(({ targeting: _targeting, ...row }) => row);
+      const hints = rows.length === 0 ? [
+        "This account has no saved audiences \u2014 Meta's API cannot create one; build the targeting on the ad set instead."
+      ] : [
+        "Use one on a new ad set: `baker ads meta adsets create \u2026 --saved-audience <id>` (its targeting is copied)."
+      ];
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(shown, fmt, void 0, hints);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data: shown, hints });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+function targetingFromSavedAudience(saved, flagged) {
+  if (flagged === void 0) return { targeting: saved };
+  if (!Object.keys(flagged).every((key) => key in brandSafetyTargetingFields)) {
+    return { refusal: "--saved-audience brings the targeting \u2014 pass it or --targeting-file, not both" };
+  }
+  return { targeting: { ...saved, ...flagged } };
+}
+async function savedAudienceTargeting(accountId, savedAudienceId) {
+  try {
+    const rows = await apiGet("/api/ads/meta/saved-audiences", {
+      "account-id": accountId,
+      "saved-audience-id": savedAudienceId
+    });
+    const targeting = rows[0]?.targeting;
+    if (!targeting) {
+      failWriteValidation(`saved audience ${savedAudienceId} has no targeting to copy`);
+    }
+    return targeting;
+  } catch (err) {
+    handleMetaError(err);
+  }
+}
+export {
+  audiencesDeleteCommand,
+  audiencesMembersCommand,
+  savedAudienceTargeting,
+  savedAudiencesCommand,
+  targetingFromSavedAudience
+};
+//# sourceMappingURL=audience-writes-X52VG35Y.js.map

package/dist/audience-writes-X52VG35Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/audience-writes.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { brandSafetyTargetingFields } from \"@baker/api/ads-meta/brandSafety\";\nimport {\n  CUSTOMER_LIST_BATCH_ROWS,\n  CUSTOMER_LIST_MAX_BATCHES,\n  type CustomerListAction,\n  type CustomerListBatchResponse,\n} from \"@baker/api/ads-meta/customerList\";\nimport { defineCommand } from \"citty\";\nimport { apiGet, apiPost } from \"../../../client.ts\";\nimport { requireChatId } from \"../../../env.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport {\n  customerListBatches,\n  customerListFromFile,\n  customerListUploadRefusal,\n  DATE_ORDERS,\n  type DateOrder,\n  type HashedCustomerList,\n} from \"./customer-list.ts\";\nimport { csvOrJson, handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\nimport { bareAccountId, failWriteValidation, repeatedListFlag, requireTarget, stageOp } from \"./write-shared.ts\";\n\n/**\n * Staged writes on who is in a customer list, deleting an audience, and the\n * saved audiences an ad set can copy. The people are read from a file in the\n * workspace and hashed here; only their digests are held by Baker until the\n * chat publishes, and only counts are ever printed.\n */\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads meta draft`.\";\n\nconst membersArgs = {\n  id: {\n    type: \"positional\",\n    description: \"Customer-list audience id, or a meta_temp_* ref created in this chat\",\n    required: true,\n  },\n  \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\" },\n  file: {\n    type: \"string\",\n    description:\n      \"CSV (or ;/tab separated) in the workspace with a header row: email, phone, first name, last name, city, state, zip, country, birthday, gender, madid, external id\",\n  },\n  country: {\n    type: \"string\",\n    description:\n      \"Two-letter country for phones written without their country code (when the row has no country column)\",\n  },\n  \"value-column\": {\n    type: \"string\",\n    description: \"Value-based list only: the column with each person's value (e.g. revenue)\",\n  },\n  columns: {\n    type: \"string\",\n    description:\n      \"For a file without a header row: what each column is, in order (email,phone,country — comma-separated or repeated)\",\n  },\n  \"date-format\": {\n    type: \"string\",\n    description:\n      \"How birthdays like 03/07/1990 are written: DMY (day first) or MDY (month first, US). Needed only when no date in the file shows it\",\n  },\n} as const;\n\nfunction schemaArgs<T extends Record<string, { type: string; description: string; required?: boolean }>>(args: T) {\n  return Object.fromEntries(\n    Object.entries(args).map(([key, arg]) => [\n      key,\n      { type: arg.type, description: arg.description, required: arg.required === true },\n    ]),\n  );\n}\n\nconst ACTION_NOTES: Record<CustomerListAction, string> = {\n  add: \"Adds the people in the file to the list; those already in it stay.\",\n  remove: \"Removes the people in the file from the list.\",\n  replace:\n    \"Replaces the whole list with the file — everyone not in it leaves. Runs alone: not beside another change to the same list in this chat.\",\n};\n\nfunction dateFormatFlag(value: unknown): DateOrder | undefined {\n  if (value === undefined) return undefined;\n  const upperValue = String(value).toUpperCase();\n  if (!(DATE_ORDERS as readonly string[]).includes(upperValue)) {\n    failWriteValidation(`--date-format takes ${DATE_ORDERS.join(\" or \")}, not ${String(value)}`);\n  }\n  return upperValue as DateOrder;\n}\n\nfunction readList(args: Record<string, unknown>, rawArgs: readonly string[] | undefined): HashedCustomerList {\n  const path = typeof args.file === \"string\" ? args.file : \"\";\n  if (!path) {\n    failWriteValidation(\"pass --file with the customer list (CSV in the workspace)\");\n  }\n  let content: string;\n  try {\n    content = readFileSync(path, \"utf8\");\n  } catch (err) {\n    failWriteValidation(`could not read ${path}: ${err instanceof Error ? err.message : String(err)}`);\n  }\n  try {\n    return customerListFromFile(content, {\n      defaultCountry: typeof args.country === \"string\" ? args.country : undefined,\n      valueColumn: typeof args[\"value-column\"] === \"string\" ? args[\"value-column\"] : undefined,\n      columns: repeatedListFlag(rawArgs, \"columns\", args.columns),\n      dateFormat: dateFormatFlag(args[\"date-format\"]),\n    });\n  } catch (err) {\n    failWriteValidation(err instanceof Error ? err.message : String(err));\n  }\n}\n\n/** What the agent learns about the file: counts only. */\nfunction listHints(list: HashedCustomerList): string[] {\n  const hints = [`${list.rows.length.toLocaleString(\"en-US\")} people read from the file, hashed before upload`];\n  const unreadable = Object.entries(list.unreadable).map(([key, count]) => `${count} ${key}`);\n  if (unreadable.length > 0) {\n    hints.push(`values that could not be read and were left out: ${unreadable.join(\", \")}`);\n  }\n  if (list.skippedRows > 0) {\n    hints.push(\n      `${list.skippedRows} rows had nothing Meta can match on (no readable email, phone or id${list.schema.includes(\"LOOKALIKE_VALUE\") ? \", or no readable value\" : \"\"}) and were left out`,\n    );\n  }\n  if (list.ignoredColumns.length > 0) {\n    hints.push(`columns not sent (Meta does not match on them): ${list.ignoredColumns.join(\", \")}`);\n  }\n  if (list.rows.length < 100) {\n    hints.push(\"Meta needs about 100 matched people before a list can be used for ads or as a lookalike seed\");\n  }\n  return hints;\n}\n\nasync function stageMembers(\n  action: CustomerListAction,\n  args: Record<string, unknown>,\n  rawArgs: readonly string[] | undefined,\n): Promise<void> {\n  const accountId = bareAccountId(args);\n  const audienceId = requireTarget(args, \"audience\");\n  const list = readList(args, rawArgs);\n  if (list.rows.length === 0) {\n    failWriteValidation(\"no one in this file can be matched — check the columns (email, phone, …) and their values\");\n  }\n  const batches = customerListBatches(list.rows);\n  if (batches.length > CUSTOMER_LIST_MAX_BATCHES) {\n    failWriteValidation(\n      `this file holds ${list.rows.length.toLocaleString(\"en-US\")} people; one change carries at most ${(CUSTOMER_LIST_BATCH_ROWS * CUSTOMER_LIST_MAX_BATCHES).toLocaleString(\"en-US\")} — split the file and stage one add per part`,\n    );\n  }\n  const refusal = customerListUploadRefusal(audienceId, action, list);\n  if (refusal) {\n    failWriteValidation(refusal);\n  }\n  const stored: CustomerListBatchResponse[] = [];\n  try {\n    const chatId = requireChatId();\n    for (const rows of batches) {\n      const response = await apiPost<{ ok: true; data: CustomerListBatchResponse }>(\n        \"/api/ads/meta/draft/customer-list-batch\",\n        { chatId, accountId, batch: { schema: list.schema, rows } },\n        { timeoutMs: 120_000 },\n      );\n      stored.push(response.data);\n    }\n  } catch (err) {\n    handleMetaError(err);\n  }\n  await stageOp(\n    {\n      kind: \"customAudience.members\",\n      accountId,\n      payload: { audience_id: audienceId, action, schema: list.schema, batches: stored },\n    },\n    listHints(list),\n  );\n}\n\nfunction membersCommand(action: CustomerListAction) {\n  registerSchema({\n    command: `ads.meta.audiences.members.${action}`,\n    description: `Stage ${action === \"add\" ? \"adding people to\" : action === \"remove\" ? \"removing people from\" : \"replacing everyone in\"} a Meta customer list from a CSV in the workspace. ${ACTION_NOTES[action]} Every value is normalized and SHA-256 hashed on this machine before upload, as Meta asks; only counts are printed. Applied at publish; Meta takes up to 24h to match.`,\n    args: schemaArgs(membersArgs),\n  });\n  return defineCommand({\n    meta: {\n      name: action,\n      description: `${ACTION_NOTES[action]} ${STAGED_NOTE}\nExample: baker ads meta audiences members ${action} 120249492603650208 --file customers.csv --country ES`,\n    },\n    args: membersArgs,\n    run: async ({ args, rawArgs }) => {\n      await stageMembers(action, args as Record<string, unknown>, rawArgs);\n    },\n  });\n}\n\nexport const audiencesMembersCommand = defineCommand({\n  meta: {\n    name: \"members\",\n    description: `Change who is in a customer-list audience, from a CSV in the workspace. Hashed here before upload. ${STAGED_NOTE}\n  baker ads meta audiences members add <audienceId|meta_temp_…> --file customers.csv [--country ES]\n  baker ads meta audiences members remove <audienceId> --file unsubscribed.csv\n  baker ads meta audiences members replace <audienceId> --file customers.csv\n  value-based list: add --value-column revenue`,\n  },\n  subCommands: {\n    add: membersCommand(\"add\"),\n    remove: membersCommand(\"remove\"),\n    replace: membersCommand(\"replace\"),\n  },\n});\n\n// --- Delete ---\n\nregisterSchema({\n  command: \"ads.meta.audiences.delete\",\n  description:\n    \"Stage deleting a Meta custom audience — permanent, applied at publish. Every ad that targets it stops and cannot be restarted; Meta refuses while a lookalike is built from it (delete the lookalike first).\",\n  args: {\n    id: { type: \"positional\", description: \"Audience id\", required: true },\n    \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\", required: false },\n  },\n});\n\nexport const audiencesDeleteCommand = defineCommand({\n  meta: {\n    name: \"delete\",\n    description: `Stage deleting an audience — permanent: ads that target it stop for good. Only when the user asked to delete it. ${STAGED_NOTE}`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Audience id\", required: true },\n    \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\" },\n  },\n  run: async ({ args }) => {\n    await stageOp({\n      kind: \"customAudience.update\",\n      accountId: bareAccountId(args as Record<string, unknown>),\n      target: requireTarget(args as Record<string, unknown>, \"audience\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\n// --- Saved audiences ---\n\nregisterSchema({\n  command: \"ads.meta.audiences.saved\",\n  description:\n    \"List the ad account's saved audiences (targeting saved in Ads Manager), or one with --saved-audience-id. Read-only — Meta's API cannot create or change one. Use one on a new ad set with `adsets create --saved-audience <id>`.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\", required: false },\n    \"saved-audience-id\": {\n      type: \"string\",\n      description: \"One saved audience, with its full targeting\",\n      required: false,\n    },\n    full: { type: \"boolean\", description: \"Include each audience's whole targeting spec\", required: false },\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", required: false, default: \"json\" },\n  },\n});\n\nexport const savedAudiencesCommand = defineCommand({\n  meta: {\n    name: \"saved\",\n    description:\n      \"Saved audiences on the account (read-only). Example: baker ads meta audiences saved --account-id act_123; use one with `adsets create --saved-audience <id>`\",\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\" },\n    \"saved-audience-id\": { type: \"string\", description: \"One saved audience, with its full targeting\" },\n    full: { type: \"boolean\", description: \"Include each audience's whole targeting spec\" },\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"saved-audience-id\"]) params[\"saved-audience-id\"] = String(args[\"saved-audience-id\"]);\n      const rows = await apiGet<Array<Record<string, unknown>>>(\"/api/ads/meta/saved-audiences\", params);\n      const shown =\n        args.full || args[\"saved-audience-id\"] ? rows : rows.map(({ targeting: _targeting, ...row }) => row);\n      const hints =\n        rows.length === 0\n          ? [\n              \"This account has no saved audiences — Meta's API cannot create one; build the targeting on the ad set instead.\",\n            ]\n          : [\n              \"Use one on a new ad set: `baker ads meta adsets create … --saved-audience <id>` (its targeting is copied).\",\n            ];\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(shown, fmt, undefined, hints);\n        return;\n      }\n      writeJsonEnvelope({ ok: true, data: shown, hints });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\n/**\n * A saved audience's targeting with the command's own targeting laid over it:\n * the brand-safety flags (`--block-list`, …) join it, while a targeting file\n * would replace it whole, so the two are refused together.\n */\nexport function targetingFromSavedAudience(\n  saved: Record<string, unknown>,\n  flagged: Record<string, unknown> | undefined,\n): { targeting: Record<string, unknown> } | { refusal: string } {\n  if (flagged === undefined) return { targeting: saved };\n  if (!Object.keys(flagged).every((key) => key in brandSafetyTargetingFields)) {\n    return { refusal: \"--saved-audience brings the targeting — pass it or --targeting-file, not both\" };\n  }\n  return { targeting: { ...saved, ...flagged } };\n}\n\n/** A saved audience's targeting, to start an ad set from. */\nexport async function savedAudienceTargeting(\n  accountId: string,\n  savedAudienceId: string,\n): Promise<Record<string, unknown>> {\n  try {\n    const rows = await apiGet<Array<{ targeting?: Record<string, unknown> }>>(\"/api/ads/meta/saved-audiences\", {\n      \"account-id\": accountId,\n      \"saved-audience-id\": savedAudienceId,\n    });\n    const targeting = rows[0]?.targeting;\n    if (!targeting) {\n      failWriteValidation(`saved audience ${savedAudienceId} has no targeting to copy`);\n    }\n    return targeting;\n  } catch (err) {\n    handleMetaError(err);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{audiences-RPLVMO4H.js → audiences-AAZH56WD.js}

@@ -6,7 +6,7 @@ import {
   schemaArgs,
   stageChatgptOp,
   stageChatgptOps
-} from "./chunk-3UXMQ3K2.js";
+} from "./chunk-AQM4JH62.js";
 import {
   CHATGPT_ADS_REFERENCE,
   CHATGPT_AUDIENCE_USES,
@@ -265,4 +265,4 @@ export {
   audiencesCommand,
   membersFromArgs
 };
-//# sourceMappingURL=audiences-RPLVMO4H.js.map
+//# sourceMappingURL=audiences-AAZH56WD.js.map

package/dist/{audiences-XEZHACKH.js → audiences-X3RLGOVM.js}

@@ -2,7 +2,7 @@ import {
   csvOrJson,
   handleMetaError,
   resolveAccountIdArg
-} from "./chunk-OP7DNHD2.js";
+} from "./chunk-QTOZ32SU.js";
 import {
   writeAdsJson,
   writeAdsOutput
@@ -53,17 +53,23 @@ var listCommand = defineCommand({
 var audiencesCommand = defineCommand({
   meta: {
     name: "audiences",
-    description: `List custom audiences, or stage writes (create/update). Write subcommands stage ops on this chat's draft.
+    description: `List custom audiences, or stage writes (create/update/delete, members add|remove|replace). Write subcommands stage ops on this chat's draft.
 Includes lookalikes, website-pixel audiences, customer-file audiences. Meta hides exact size when count < 1000.
 
 Examples:
   baker ads meta audiences --account-id act_123
-  baker ads meta audiences create --name "Site 30d" --subtype WEBSITE --file rule.json`
+  baker ads meta audiences create --name "Site 30d" --subtype WEBSITE --file rule.json
+  baker ads meta audiences create --name "Customers" --subtype CUSTOM --customer-file-source USER_PROVIDED_ONLY
+  baker ads meta audiences members add meta_temp_ab12 --file customers.csv --country ES
+  baker ads meta audiences saved --account-id act_123            \u2014 saved audiences (read-only)`
   },
   subCommands: {
     list: listCommand,
-    create: () => import("./write-commands-HCQI4Y27.js").then((m) => m.audiencesCreateCommand),
-    update: () => import("./write-commands-HCQI4Y27.js").then((m) => m.audiencesUpdateCommand)
+    create: () => import("./write-commands-PEJBTME6.js").then((m) => m.audiencesCreateCommand),
+    update: () => import("./write-commands-PEJBTME6.js").then((m) => m.audiencesUpdateCommand),
+    delete: () => import("./audience-writes-X52VG35Y.js").then((m) => m.audiencesDeleteCommand),
+    members: () => import("./audience-writes-X52VG35Y.js").then((m) => m.audiencesMembersCommand),
+    saved: () => import("./audience-writes-X52VG35Y.js").then((m) => m.savedAudiencesCommand)
   },
   // `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`
@@ -75,4 +81,4 @@ Examples:
 export {
   audiencesCommand
 };
-//# sourceMappingURL=audiences-XEZHACKH.js.map
+//# sourceMappingURL=audiences-X3RLGOVM.js.map

package/dist/audiences-X3RLGOVM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/audiences.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport { csvOrJson, handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n  limit: { type: \"string\", description: \"Max rows\" },\n  \"no-cache\": NO_CACHE_ARG,\n  output: { type: \"string\", description: \"Output format\", default: \"json\" },\n} as const;\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List custom audiences. Runs by default when no subcommand is given. Example: baker ads meta audiences --account-id act_123\",\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args.limit) params.limit = args.limit as string;\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<Array<Record<string, unknown>>>(\"/api/ads/meta/audiences\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data, fmt);\n        return;\n      }\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nexport const audiencesCommand = defineCommand({\n  meta: {\n    name: \"audiences\",\n    description: `List custom audiences, or stage writes (create/update/delete, members add|remove|replace). Write subcommands stage ops on this chat's draft.\nIncludes lookalikes, website-pixel audiences, customer-file audiences. Meta hides exact size when count < 1000.\n\nExamples:\n  baker ads meta audiences --account-id act_123\n  baker ads meta audiences create --name \"Site 30d\" --subtype WEBSITE --file rule.json\n  baker ads meta audiences create --name \"Customers\" --subtype CUSTOM --customer-file-source USER_PROVIDED_ONLY\n  baker ads meta audiences members add meta_temp_ab12 --file customers.csv --country ES\n  baker ads meta audiences saved --account-id act_123            — saved audiences (read-only)`,\n  },\n  subCommands: {\n    list: listCommand,\n    create: () => import(\"./write-commands.ts\").then((m) => m.audiencesCreateCommand),\n    update: () => import(\"./write-commands.ts\").then((m) => m.audiencesUpdateCommand),\n    delete: () => import(\"./audience-writes.ts\").then((m) => m.audiencesDeleteCommand),\n    members: () => import(\"./audience-writes.ts\").then((m) => m.audiencesMembersCommand),\n    saved: () => import(\"./audience-writes.ts\").then((m) => m.savedAudiencesCommand),\n  },\n  // `args` stays even though the parent has no `run`: citty scans rawArgs for the\n  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`\n  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare\n  // invocation — citty falls through to `run` after a subcommand, double-executing it.\n  args: listArgs,\n  default: \"list\",\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAM9B,IAAM,WAAW;AAAA,EACf,cAAc,EAAE,MAAM,UAAU,aAAa,qBAAqB;AAAA,EAClE,OAAO,EAAE,MAAM,UAAU,aAAa,WAAW;AAAA,EACjD,YAAY;AAAA,EACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,iBAAiB,SAAS,OAAO;AAC1E;AAEA,IAAM,cAAc,cAAc;AAAA,EAChC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,UAAI,KAAK,MAAO,QAAO,QAAQ,KAAK;AACpC,UAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,YAAM,OAAO,MAAM,OAAuC,2BAA2B,MAAM;AAC3F,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAClB,uBAAe,MAAM,GAAG;AACxB;AAAA,MACF;AACA,mBAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACjC,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAEM,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASf;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IAChF,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IAChF,QAAQ,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IACjF,SAAS,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,uBAAuB;AAAA,IACnF,OAAO,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,qBAAqB;AAAA,EACjF;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM;AAAA,EACN,SAAS;AACX,CAAC;","names":[]}

package/dist/{avatars-MXTI74VC.js → avatars-YSFFRHDK.js}

@@ -35,4 +35,4 @@ Full guide: __tooling__/docs/tools/baker/avatars.md`
 export {
   avatarsCommand
 };
-//# sourceMappingURL=avatars-MXTI74VC.js.map
+//# sourceMappingURL=avatars-YSFFRHDK.js.map

package/dist/{brief-BN4UGUXF.js → brief-7S6XCJIA.js}

@@ -5,26 +5,23 @@ import {
   waiverCounts
 } from "./chunk-QVQKCVP7.js";
 import {
-  buildNext,
-  ideasReport
-} from "./chunk-TZEVD4Q6.js";
+  liveViewerLookups
+} from "./chunk-GSZZLW5Q.js";
+import "./chunk-LXQB4ZGE.js";
+import "./chunk-PTGYM4J6.js";
+import "./chunk-LCW3U4EA.js";
 import {
   buildSearchBody
 } from "./chunk-MXWOYFI2.js";
 import "./chunk-D7KR6KXR.js";
 import "./chunk-I5VZVQBZ.js";
 import {
-  withDefinitions
-} from "./chunk-NXZCCGES.js";
+  buildNext,
+  ideasReport
+} from "./chunk-P5FRWPG7.js";
 import {
   readInsights
 } from "./chunk-EOY6BK4C.js";
-import {
-  liveViewerLookups
-} from "./chunk-QE3JEJXF.js";
-import "./chunk-2XRMPSEV.js";
-import "./chunk-PTGYM4J6.js";
-import "./chunk-LCW3U4EA.js";
 import {
   readAllRules,
   readCompanyReading
@@ -34,6 +31,9 @@ import {
   IDEA_ANGLES,
   IDEA_FORMATS
 } from "./chunk-G2LGMWNG.js";
+import {
+  withDefinitions
+} from "./chunk-NXZCCGES.js";
 import {
   researchCustomers
 } from "./chunk-MVB32GPI.js";
@@ -41,7 +41,7 @@ import "./chunk-D5CUAOQX.js";
 import "./chunk-NEIUVSDK.js";
 import "./chunk-BFRIRZRZ.js";
 import "./chunk-JYALBYN7.js";
-import "./chunk-BITS62MF.js";
+import "./chunk-G6XKD7QE.js";
 import "./chunk-ERSX3MKH.js";
 import "./chunk-FNA277HP.js";
 import "./chunk-5WMTPYKT.js";
@@ -55,8 +55,8 @@ import {
 import "./chunk-MCJ5I5LR.js";
 import {
   viewerFromKnowledge
-} from "./chunk-KPYDTIAI.js";
-import "./chunk-KIGGMKAE.js";
+} from "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
 import "./chunk-DWX44QL6.js";
 import "./chunk-2FSEESJU.js";
 import "./chunk-CVBKW75S.js";
@@ -535,4 +535,4 @@ export {
   tastePart,
   whatWorks
 };
-//# sourceMappingURL=brief-BN4UGUXF.js.map
+//# sourceMappingURL=brief-7S6XCJIA.js.map

package/dist/{businesses-PRRYPR7H.js → businesses-H3HIDQX6.js}

@@ -1,7 +1,7 @@
 import {
   csvOrJson,
   handleMetaError
-} from "./chunk-OP7DNHD2.js";
+} from "./chunk-QTOZ32SU.js";
 import {
   writeAdsJson,
   writeAdsOutput
@@ -50,4 +50,4 @@ Examples:
 export {
   businessesCommand
 };
-//# sourceMappingURL=businesses-PRRYPR7H.js.map
+//# sourceMappingURL=businesses-H3HIDQX6.js.map

package/dist/{campaign-writes-BAFB5E7A.js → campaign-writes-7ZF57KLH.js}

@@ -78,7 +78,7 @@ 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 },
+    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 },
@@ -125,7 +125,7 @@ function statusCommand(name, status) {
     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 },
+      ids: { type: "positional", description: "Campaign ids, comma-separated", required: true },
       "account-id": { type: "string", description: "X Ads account ID", required: false }
     }
   });
@@ -162,4 +162,4 @@ export {
   campaignsResumeCommand,
   campaignsUpdateCommand
 };
-//# sourceMappingURL=campaign-writes-BAFB5E7A.js.map
+//# sourceMappingURL=campaign-writes-7ZF57KLH.js.map

package/dist/campaign-writes-7ZF57KLH.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: \"positional\", 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: \"positional\", 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-U5LTDTYK.js → campaign-writes-U5PUVSMT.js}

@@ -10,7 +10,7 @@ import {
   schemaArgs,
   stageChatgptOp,
   statusCommand
-} from "./chunk-3UXMQ3K2.js";
+} from "./chunk-AQM4JH62.js";
 import {
   CHATGPT_ADS_REFERENCE
 } from "./chunk-IG627WWY.js";
@@ -167,4 +167,4 @@ export {
   campaignsResumeCommand,
   campaignsUpdateCommand
 };
-//# sourceMappingURL=campaign-writes-U5LTDTYK.js.map
+//# sourceMappingURL=campaign-writes-U5PUVSMT.js.map