@koda-sl/baker-cli 0.457.0 → 0.458.0

package/dist/ads-5SGFPSQL.js

@@ -0,0 +1,113 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-Q3PB5ZUT.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-K63BDJYR.js";
+import "./chunk-G4PE563Y.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-KIGGMKAE.js";
+import {
+  apiGet
+} from "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/ads.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "adset-id": { type: "string", description: "Filter to one adset" },
+  "campaign-id": { type: "string", description: "Filter to one campaign" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  ...META_LIST_SHAPE_ARGS
+};
+registerMetaListSchema(
+  "ads",
+  "List ads in a Meta ad account, as a table by default: id, name, adset_id, campaign_id, effective_status, creative_id, issues (why an ad is WITH_ISSUES), created_time. Start here: baker ads meta ads --adset-id 6123. --fields takes dotted paths (e.g. id,tracking_specs); --full returns every field Meta sent; --output json returns the rows in the envelope.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List ads in a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta ads --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["adset-id"]) params["adset-id"] = args["adset-id"];
+      if (args["campaign-id"]) params["campaign-id"] = args["campaign-id"];
+      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/ads", params);
+      const shaped = shapeMetaListRows("ads", data, args);
+      writeMetaListRows("ads", shaped, csvOrJson(args), statusFilterHints(data, effectiveStatus, "ads"));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var adsListCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: `List ads in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/retag).
+Defaults to ACTIVE only \u2014 pass --all-statuses to widen. Write subcommands stage ops on this chat's draft.
+
+The dashboard shows effective_status (e.g. WITH_ISSUES, PENDING_REVIEW, DISAPPROVED, ADSET_PAUSED), not status.
+
+Listings print a table by default: id, name, adset_id, campaign_id, effective_status, creative_id, issues
+(why an ad is WITH_ISSUES), created_time. --fields takes dotted paths (e.g. tracking_specs,
+preview_shareable_link); --full returns every field; --output json returns the rows as JSON.
+
+Examples:
+  baker ads meta ads --account-id act_123
+  baker ads meta ads --adset-id 6123
+  baker ads meta ads --account-id act_123 --all-statuses --name-contains octubre --fields id,name,adset_id,creative_id   \u2014 find one ad by name
+  baker ads meta ads --adset-id 6123 --fields id,name,preview_shareable_link
+  baker ads meta ads create --name "Ad 1" --adset meta_temp_as01 --creative meta_temp_cr01
+  baker ads meta ads pause 6123 --account-id act_123
+  baker ads meta ads retag 6123 --set "utm_medium=paid-social"      \u2014 fix tracking on a LIVE ad, keeping everything else`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-HZI5YF52.js").then((m) => m.adsCreateCommand),
+    update: () => import("./write-commands-HZI5YF52.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./write-commands-HZI5YF52.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./write-commands-HZI5YF52.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./write-commands-HZI5YF52.js").then((m) => m.adsArchiveCommand),
+    delete: () => import("./write-commands-HZI5YF52.js").then((m) => m.adsDeleteCommand),
+    duplicate: () => import("./write-commands-HZI5YF52.js").then((m) => m.adsDuplicateCommand),
+    retag: () => import("./write-commands-HZI5YF52.js").then((m) => m.adsRetagCommand)
+  },
+  // `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 {
+  adsListCommand
+};
+//# sourceMappingURL=ads-5SGFPSQL.js.map

package/dist/ads-CP4VTPKO.js

@@ -0,0 +1,77 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-Y4V55WFQ.js";
+import "./chunk-G4PE563Y.js";
+import "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import {
+  registerSchema
+} from "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/ads.ts
+import { defineCommand } from "citty";
+var args = {
+  "ad-group-id": { type: "string", description: "Only this ad group's ads (adgrp_\u2026)", required: false },
+  full: { type: "boolean", description: "Return ChatGPT Ads' own ad objects", required: false }
+};
+registerSchema({
+  command: "ads.chatgpt.ads",
+  description: "Ads in the connected ChatGPT Ads account, or in one ad group: the card's title, body, image and destination, its review outcome and reason, and serving issues.",
+  args
+});
+function adHints(ads) {
+  const rejected = ads.filter((ad) => ad.review === "rejected");
+  return rejected.length > 0 ? [
+    `${rejected.length} ad(s) were rejected in review; reviewReason says why. Editing the creative sends it back to review.`
+  ] : [];
+}
+var adsListCommand = defineCommand({
+  meta: { name: "list", description: "ChatGPT Ads chat cards. Example: baker ads chatgpt ads --ad-group-id adgrp_123" },
+  args,
+  run: async ({ args: input }) => {
+    const params = {};
+    if (input["ad-group-id"]) {
+      params["ad-group-id"] = input["ad-group-id"];
+    }
+    if (input.full) {
+      params.full = "true";
+    }
+    await runChatgptListRead(
+      CHATGPT_ADS_REFERENCE.ads,
+      "/api/ads/chatgpt/ads",
+      params,
+      (ads) => input.full ? [] : adHints(ads)
+    );
+  }
+});
+var adsCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: `ChatGPT Ads ads (chat cards): copy, image, destination and review status \u2014 or stage a change that applies when the chat is published.
+
+Examples:
+  baker ads chatgpt ads --ad-group-id adgrp_123
+  baker ads chatgpt ads create --ad-group-id adgrp_123 --name "Card A" --title "\u2026" --body "\u2026" --target-url https://\u2026 --image-url https://\u2026
+  baker ads chatgpt ads update ad_123 --title "Solar with no upfront cost"
+  baker ads chatgpt ads pause ad_123`
+  },
+  subCommands: {
+    list: adsListCommand,
+    create: () => import("./ad-writes-YDMS7NPG.js").then((m) => m.adsCreateCommand),
+    update: () => import("./ad-writes-YDMS7NPG.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./ad-writes-YDMS7NPG.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./ad-writes-YDMS7NPG.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./ad-writes-YDMS7NPG.js").then((m) => m.adsArchiveCommand),
+    "create-product": () => import("./ad-writes-YDMS7NPG.js").then((m) => m.adsCreateProductCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args,
+  default: "list"
+});
+export {
+  adsCommand
+};
+//# sourceMappingURL=ads-CP4VTPKO.js.map

package/dist/ads-FYSAF7HG.js

@@ -0,0 +1,130 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-OIS3WG2U.js";
+import {
+  reportError
+} from "./chunk-3FOE4P6A.js";
+import {
+  advertiserAdsRequestSchema
+} from "./chunk-VAOMHPEX.js";
+import {
+  apiGet
+} from "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import {
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/ads.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.ads",
+  description: "Every ad one advertiser has run (one row per distinct ad, strongest first), on every platform or one, running, stopped or both, of every format or the ones in --format (`--platform google --format text`: its Google search ads). The brand page's All ads; `winners` is its top winners. Pages with --offset; `next_offset` is null on the last page. Rows are compact; --fields ad_id,summary,days_active,active keeps a long listing small.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id (from `advertisers` or `following`)", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    running: { type: "string", description: "all|running|stopped (default all)", required: false, default: "all" },
+    format: {
+      type: "string",
+      description: "Comma list: video,static,carousel,text (text = Google search ads); every format when omitted",
+      required: false
+    },
+    limit: { type: "number", description: "Ads per page 1-100 (default 24)", required: false, default: 24 },
+    offset: { type: "number", description: "Skip this many ads (from `next_offset`)", required: false, default: 0 },
+    full: { type: "boolean", description: "Include DNA detail + longevity", required: false, default: false }
+  }
+});
+function nextOffset(page, offset) {
+  const reached = offset + page.returned;
+  if (page.returned === 0) return null;
+  if (page.total === null) return page.returned === page.limit ? reached : null;
+  return reached < page.total ? reached : null;
+}
+function adsHints(request, returned, next) {
+  if (next !== null) return [`More ads: run again with --offset ${next}.`];
+  if (returned === 0 && request.offset === 0 && request.running === "running") {
+    return [
+      `No ad counts as running unless the brand was checked in the last 35 days: read last_checked_at in \`baker winning-ads profile ${request.id}\` before saying it runs nothing.`
+    ];
+  }
+  return [];
+}
+var adsCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: "Every ad an advertiser has run, per platform and format or all together. Example: baker winning-ads ads adv_123 --platform google --format text --running running --output md"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    running: { type: "string", description: "all|running|stopped (default all)", required: false },
+    format: { type: "string", description: "Comma list: video,static,carousel,text", required: false },
+    limit: { type: "string", description: "Ads per page 1-100 (default 24)", required: false },
+    offset: { type: "string", description: "Skip this many ads (from next_offset)", required: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include DNA detail + longevity", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const parsed = advertiserAdsRequestSchema.safeParse({
+        id: String(args.advertiser),
+        platform: args.platform || void 0,
+        running: args.running || void 0,
+        format: args.format || void 0,
+        limit: args.limit || void 0,
+        offset: args.offset || void 0
+      });
+      if (!parsed.success) {
+        const issue = parsed.error.issues[0];
+        writeJson({
+          ok: false,
+          error: { code: "BAD_REQUEST", message: `--${issue?.path.join(".") ?? "args"}: ${issue?.message}` }
+        });
+        process.exit(1);
+      }
+      const request = parsed.data;
+      const params = {
+        id: request.id,
+        running: request.running,
+        limit: String(request.limit),
+        offset: String(request.offset)
+      };
+      if (request.platform) params.platform = request.platform;
+      if (request.format) params.format = request.format.join(",");
+      const data = await apiGet("/api/ad-library/advertiser-ads", params);
+      const plan = adFieldPlan(args.fields, args.full);
+      const next = nextOffset({ returned: data.ads.length, total: data.total, limit: request.limit }, request.offset);
+      const hints = adsHints(request, data.ads.length, next);
+      const output = args.output || "json";
+      if (output === "json") {
+        writeJson({
+          ok: true,
+          data: {
+            advertiser_id: data.advertiser_id,
+            total: data.total,
+            next_offset: next,
+            ads: adRows(data.ads, plan)
+          },
+          ...hints.length > 0 ? { hints } : {}
+        });
+        return;
+      }
+      writeOutput({ ok: true, data: data.ads }, output, plan.fields, plan.full, winningAdNormalizer);
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  adsCommand,
+  adsHints,
+  nextOffset
+};
+//# sourceMappingURL=ads-FYSAF7HG.js.map

package/dist/ads-FYSAF7HG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/ads.ts"],"sourcesContent":["import { type AdvertiserAdsResponse, advertiserAdsRequestSchema } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../client.ts\";\nimport { type OutputFormat, winningAdNormalizer, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { adFieldPlan, adRows } from \"./adRows.ts\";\nimport { reportError } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"winning-ads.ads\",\n  description:\n    \"Every ad one advertiser has run (one row per distinct ad, strongest first), on every platform or one, running, stopped or both, of every format or the ones in --format (`--platform google --format text`: its Google search ads). The brand page's All ads; `winners` is its top winners. Pages with --offset; `next_offset` is null on the last page. Rows are compact; --fields ad_id,summary,days_active,active keeps a long listing small.\",\n  args: {\n    advertiser: { type: \"string\", description: \"Advertiser id (from `advertisers` or `following`)\", required: true },\n    platform: { type: \"string\", description: \"Only this platform: meta|linkedin|tiktok|google\", required: false },\n    running: { type: \"string\", description: \"all|running|stopped (default all)\", required: false, default: \"all\" },\n    format: {\n      type: \"string\",\n      description: \"Comma list: video,static,carousel,text (text = Google search ads); every format when omitted\",\n      required: false,\n    },\n    limit: { type: \"number\", description: \"Ads per page 1-100 (default 24)\", required: false, default: 24 },\n    offset: { type: \"number\", description: \"Skip this many ads (from `next_offset`)\", required: false, default: 0 },\n    full: { type: \"boolean\", description: \"Include DNA detail + longevity\", required: false, default: false },\n  },\n});\n\n/** Where the next page starts, or null when this one reached the end. */\nexport function nextOffset(\n  page: { returned: number; total: number | null; limit?: number },\n  offset: number,\n): number | null {\n  const reached = offset + page.returned;\n  if (page.returned === 0) return null;\n  if (page.total === null) return page.returned === page.limit ? reached : null;\n  return reached < page.total ? reached : null;\n}\n\n/** The next page, or why \"running\" came back empty. */\nexport function adsHints(\n  request: { id: string; running: string; offset: number },\n  returned: number,\n  next: number | null,\n): string[] {\n  if (next !== null) return [`More ads: run again with --offset ${next}.`];\n  if (returned === 0 && request.offset === 0 && request.running === \"running\") {\n    return [\n      `No ad counts as running unless the brand was checked in the last 35 days: read last_checked_at in \\`baker winning-ads profile ${request.id}\\` before saying it runs nothing.`,\n    ];\n  }\n  return [];\n}\n\nexport const adsCommand = defineCommand({\n  meta: {\n    name: \"ads\",\n    description:\n      \"Every ad an advertiser has run, per platform and format or all together. Example: baker winning-ads ads adv_123 --platform google --format text --running running --output md\",\n  },\n  args: {\n    advertiser: { type: \"positional\", description: \"Advertiser id\", required: true },\n    platform: { type: \"string\", description: \"Only this platform: meta|linkedin|tiktok|google\", required: false },\n    running: { type: \"string\", description: \"all|running|stopped (default all)\", required: false },\n    format: { type: \"string\", description: \"Comma list: video,static,carousel,text\", required: false },\n    limit: { type: \"string\", description: \"Ads per page 1-100 (default 24)\", required: false },\n    offset: { type: \"string\", description: \"Skip this many ads (from next_offset)\", required: false },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include DNA detail + longevity\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const parsed = advertiserAdsRequestSchema.safeParse({\n        id: String(args.advertiser),\n        platform: args.platform || undefined,\n        running: args.running || undefined,\n        format: args.format || undefined,\n        limit: args.limit || undefined,\n        offset: args.offset || undefined,\n      });\n      if (!parsed.success) {\n        const issue = parsed.error.issues[0];\n        writeJson({\n          ok: false,\n          error: { code: \"BAD_REQUEST\", message: `--${issue?.path.join(\".\") ?? \"args\"}: ${issue?.message}` },\n        });\n        process.exit(1);\n      }\n      const request = parsed.data;\n      const params: Record<string, string> = {\n        id: request.id,\n        running: request.running,\n        limit: String(request.limit),\n        offset: String(request.offset),\n      };\n      if (request.platform) params.platform = request.platform;\n      if (request.format) params.format = request.format.join(\",\");\n\n      const data = await apiGet<AdvertiserAdsResponse>(\"/api/ad-library/advertiser-ads\", params);\n      const plan = adFieldPlan(args.fields, args.full);\n      const next = nextOffset({ returned: data.ads.length, total: data.total, limit: request.limit }, request.offset);\n      const hints = adsHints(request, data.ads.length, next);\n      const output = (args.output as OutputFormat) || \"json\";\n      if (output === \"json\") {\n        writeJson({\n          ok: true,\n          data: {\n            advertiser_id: data.advertiser_id,\n            total: data.total,\n            next_offset: next,\n            ads: adRows(data.ads, plan),\n          },\n          ...(hints.length > 0 ? { hints } : {}),\n        });\n        return;\n      }\n      writeOutput({ ok: true, data: data.ads }, output, plan.fields, plan.full, winningAdNormalizer);\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/ads-Q54IPFAS.js

@@ -0,0 +1,40 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/index.ts
+import { defineCommand } from "citty";
+var adsCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: `Ad platform commands. Each platform exposes its own native command surface \u2014 no forced parity.
+
+Platforms:
+  google    \u2014 Google Ads (GAQL queries, keywords, accounts, ad library)
+  meta      \u2014 Meta Ads (campaigns, adsets, ads, insights, previews)
+  linkedin  \u2014 LinkedIn Ads (firmographic analytics \u2014 job-title \xD7 company \xD7 industry \xD7 seniority pivots)
+  x         \u2014 X (Twitter) Ads (campaigns, line items, promoted tweets, analytics)
+  chatgpt   \u2014 ChatGPT Ads (account, campaigns, ad groups, ads, insights \u2014 read-only)
+
+Examples:
+  baker ads google accounts
+  baker ads google query --preset campaign-performance --customer-id 1234567890
+  baker ads meta accounts
+  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE
+  baker ads meta insights --object act_123 --level ad --date-preset last_7d --fields impressions,spend,ctr
+  baker ads linkedin accounts
+  baker ads x accounts
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+  baker ads chatgpt insights --days 30 --granularity daily
+Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedin|x|chatgpt)`
+  },
+  subCommands: {
+    google: () => import("./google-KTDHD75U.js").then((m) => m.googleCommand),
+    meta: () => import("./meta-NGBLUNVU.js").then((m) => m.metaCommand),
+    linkedin: () => import("./linkedin-ES3KPPHF.js").then((m) => m.linkedinCommand),
+    x: () => import("./x-WA3Q46K6.js").then((m) => m.xCommand),
+    chatgpt: () => import("./chatgpt-RYL44ASK.js").then((m) => m.chatgptCommand)
+  }
+});
+export {
+  adsCommand
+};
+//# sourceMappingURL=ads-Q54IPFAS.js.map

package/dist/adsets-4RXF4YXR.js

@@ -0,0 +1,176 @@
+import {
+  VIEWER_TABLE_COLUMNS,
+  adSetViewerRows,
+  audienceNamesOf,
+  flattenViewerRows,
+  readAudienceNames
+} from "./chunk-NFSLRRIE.js";
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-Q3PB5ZUT.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-K63BDJYR.js";
+import {
+  rememberedJev
+} from "./chunk-GWFJAVWD.js";
+import {
+  writeAdsOutput
+} from "./chunk-G4PE563Y.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-RIXGQIMZ.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-73JXX4LJ.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-5URIFBIL.js";
+import "./chunk-3KN3VCS3.js";
+import "./chunk-LCMGWIEQ.js";
+import "./chunk-HMKVVPWY.js";
+import {
+  apiGet
+} from "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/adsets.ts
+import path from "path";
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "campaign-id": { type: "string", description: "Filter to one campaign" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  audience: {
+    type: "boolean",
+    description: "Who each ad set reaches, instead of the compact row: a viewer per ad set \u2014 temperature (cold|warm|hot), what they already know (brand/offer/product), placements, and the reasons, read from its targeting, the account's audiences and the campaign objective. Start here before writing an ad for an ad set: baker ads meta adsets --campaign-id 6123 --audience --output json"
+  },
+  ...META_LIST_SHAPE_ARGS
+};
+async function readOrEmpty(path2, params, label, hints) {
+  try {
+    return await apiGet(path2, params);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "unknown error";
+    hints.push(`Could not read the account's ${label} (${message}); the viewer was read without them.`);
+    return [];
+  }
+}
+async function writeAdSetViewers(adSets, accountParams, format, hints) {
+  const [audiences, campaigns] = await Promise.all([
+    readOrEmpty("/api/ads/meta/audiences", accountParams, "audiences", hints),
+    readOrEmpty("/api/ads/meta/campaigns", accountParams, "campaigns", hints)
+  ]);
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  const cacheDir = path.join(root, "canvas", ".cache");
+  const spent = [];
+  const readName = await readAudienceNames(
+    audienceNamesOf(adSets, audiences),
+    rememberedJev(path.join(cacheDir, "audience-names.json"), (u) => spent.push(u))
+  );
+  await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+  const rows = adSetViewerRows(adSets, audiences, campaigns, readName);
+  if (rows.length > 0) {
+    hints.push(
+      `Write each ad for the viewer of the ad set it will run in, then record it in the creative's _definition.md: targetAdSet: "<ad set id>" and viewer: { temperature, knows, placements, source }.`
+    );
+  }
+  if (format === "md" || format === "csv") {
+    writeAdsOutput(flattenViewerRows(rows), format, [...VIEWER_TABLE_COLUMNS], hints);
+    return;
+  }
+  writeAdsOutput(rows, format, void 0, hints);
+}
+registerMetaListSchema(
+  "adsets",
+  "List ad sets in a Meta ad account, as a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event, bid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting is not in the compact row \u2014 ask for it with --fields id,name,targeting (or --full). --audience replaces the row with who each ad set reaches (a viewer: temperature, what they already know, placements, reasons) \u2014 read it before writing an ad for an ad set. Start here: baker ads meta adsets --campaign-id 6123 --all-statuses. --output json returns the rows in the envelope.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List ad sets in a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta adsets --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["campaign-id"]) params["campaign-id"] = args["campaign-id"];
+      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/adsets", params);
+      if (args.audience) {
+        const hints = statusFilterHints(data, effectiveStatus, "ad sets");
+        const accountParams = { "account-id": accountId };
+        if (args["no-cache"]) accountParams["skip-cache"] = "true";
+        await writeAdSetViewers(data, accountParams, csvOrJson(args), hints);
+        return;
+      }
+      const shaped = shapeMetaListRows("adsets", data, args);
+      writeMetaListRows("adsets", shaped, csvOrJson(args), statusFilterHints(data, effectiveStatus, "ad sets"));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var adsetsCommand = defineCommand({
+  meta: {
+    name: "adsets",
+    description: `List ad sets in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate).
+Defaults to ACTIVE only. Write subcommands stage ops on this chat's draft.
+
+Listings print a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event,
+bid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting
+is not in the compact row \u2014 ask for it with --fields (dotted paths) or --full. --output json returns the rows as JSON.
+
+Examples:
+  baker ads meta adsets --account-id act_123
+  baker ads meta adsets --campaign-id 6123456789
+  baker ads meta adsets --account-id act_123 --all-statuses --name-contains retargeting   \u2014 find one ad set by name
+  baker ads meta adsets --campaign-id 6123456789 --fields id,name,targeting.geo_locations
+  baker ads meta adsets --campaign-id 6123456789 --audience --output json   \u2014 who each ad set reaches (viewer per ad set)
+  baker ads meta adsets create --campaign meta_temp_ab12 --name "US 25-54" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --daily-budget 50 --targeting-file t.json`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-HZI5YF52.js").then((m) => m.adSetsCreateCommand),
+    update: () => import("./write-commands-HZI5YF52.js").then((m) => m.adSetsUpdateCommand),
+    pause: () => import("./write-commands-HZI5YF52.js").then((m) => m.adSetsPauseCommand),
+    resume: () => import("./write-commands-HZI5YF52.js").then((m) => m.adSetsResumeCommand),
+    archive: () => import("./write-commands-HZI5YF52.js").then((m) => m.adSetsArchiveCommand),
+    delete: () => import("./write-commands-HZI5YF52.js").then((m) => m.adSetsDeleteCommand),
+    duplicate: () => import("./write-commands-HZI5YF52.js").then((m) => m.adSetsDuplicateCommand)
+  },
+  // `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 {
+  adsetsCommand
+};
+//# sourceMappingURL=adsets-4RXF4YXR.js.map