@koda-sl/baker-cli 0.497.0 → 0.498.0

package/dist/add-accounts-KQUUBIIG.js

@@ -0,0 +1,91 @@
+import {
+  PLATFORM_NAMES,
+  reportError,
+  splitList
+} from "./chunk-3Q32TXSP.js";
+import {
+  apiPost
+} from "./chunk-AS46I4WH.js";
+import "./chunk-6UW4J6IU.js";
+import "./chunk-XOHXG5TG.js";
+import {
+  BRAND_ACCOUNTS_MAX,
+  registerSchema,
+  writeJson
+} from "./chunk-AL6AEGWH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/add-accounts.ts
+import { defineCommand } from "citty";
+var ADD_TIMEOUT_MS = 12e4;
+var named = (accounts) => accounts.map((a) => `${a.name} (${PLATFORM_NAMES[a.platform]})`).join(", ");
+function addAccountsHints(data) {
+  const hints = [];
+  if (data.added.length > 0) {
+    hints.push(
+      `Now tracking ${named(data.added)} \u2014 its ads arrive over the next minutes; check \`baker winning-ads following\`.`
+    );
+  }
+  if (data.already_tracked.length > 0) {
+    hints.push(`Already tracked under this brand: ${named(data.already_tracked)}.`);
+  }
+  for (const failure of data.failed) {
+    hints.push(`Not added: "${failure.input}" \u2014 ${failure.error}`);
+  }
+  return hints;
+}
+registerSchema({
+  command: "winning-ads.add-accounts",
+  description: "Track more accounts under a brand you already follow \u2014 another country's or language's Facebook page, a second LinkedIn company, another Google Ads entity. Pass the brand's advertiser id and one or more links (comma-separated): profile or ad-library links, Google advertiser ids (AR\u2026), or a website. `follow` returns ready-made calls for the look-alike accounts it found.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id of a followed brand (from `following`)", required: true },
+    inputs: {
+      type: "string",
+      description: `Comma-separated links, advertiser ids or websites \u2014 up to ${BRAND_ACCOUNTS_MAX}`,
+      required: true
+    }
+  }
+});
+var addAccountsCommand = defineCommand({
+  meta: {
+    name: "add-accounts",
+    description: `Add more of a followed brand's accounts (another market's Facebook page, a second LinkedIn company). Example: baker winning-ads add-accounts adv_123 "https://www.facebook.com/barkibu.it,AR01614014350098432001"`
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id of a followed brand", required: true },
+    inputs: {
+      type: "positional",
+      description: "Comma-separated links, advertiser ids or websites",
+      required: true
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const inputs = [...new Set(splitList(String(args.inputs ?? "")))];
+      if (inputs.length === 0 || inputs.length > BRAND_ACCOUNTS_MAX) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `Pass between 1 and ${BRAND_ACCOUNTS_MAX} comma-separated links.`
+          }
+        });
+        process.exit(1);
+      }
+      const data = await apiPost(
+        "/api/ad-library/accounts/add",
+        { advertiser_id: String(args.advertiser), inputs },
+        { timeoutMs: ADD_TIMEOUT_MS }
+      );
+      const hints = addAccountsHints(data);
+      writeJson({ ok: true, data, hints: hints.length > 0 ? hints : void 0 });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addAccountsCommand,
+  addAccountsHints
+};
+//# sourceMappingURL=add-accounts-KQUUBIIG.js.map

package/dist/ads-3RBMFZMU.js

@@ -0,0 +1,115 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-WN6WHZRC.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-W3H7CX5E.js";
+import "./chunk-Y2JZX6JB.js";
+import "./chunk-KBSWQKOT.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-Q6GYSW47.js";
+import "./chunk-65Y3RCWP.js";
+import {
+  apiGet
+} from "./chunk-AS46I4WH.js";
+import "./chunk-6UW4J6IU.js";
+import "./chunk-XOHXG5TG.js";
+import "./chunk-AL6AEGWH.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/copy/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-3RLSYXOH.js").then((m) => m.adsCreateCommand),
+    update: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adsArchiveCommand),
+    delete: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adsDeleteCommand),
+    duplicate: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adsDuplicateCommand),
+    copy: () => import("./copy-writes-SIQPN7L4.js").then((m) => m.adsCopyCommand),
+    retag: () => import("./write-commands-3RLSYXOH.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-3RBMFZMU.js.map

package/dist/ads-3RBMFZMU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/ads.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { META_LIST_SHAPE_ARGS, registerMetaListSchema, shapeMetaListRows, writeMetaListRows } from \"./list-rows.ts\";\nimport {\n  csvOrJson,\n  handleMetaError,\n  NAME_CONTAINS_ARG,\n  resolveAccountIdArg,\n  resolveEffectiveStatus,\n  statusFilterHints,\n} from \"./shared.ts\";\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n  \"adset-id\": { type: \"string\", description: \"Filter to one adset\" },\n  \"campaign-id\": { type: \"string\", description: \"Filter to one campaign\" },\n  \"effective-status\": { type: \"string\", description: \"Comma-separated effective_status filter (overrides default)\" },\n  \"all-statuses\": { type: \"boolean\", description: \"Drop the default ACTIVE filter\" },\n  \"name-contains\": NAME_CONTAINS_ARG,\n  limit: { type: \"string\", description: \"Max rows (default 1000)\" },\n  \"no-cache\": NO_CACHE_ARG,\n  ...META_LIST_SHAPE_ARGS,\n} as const;\n\nregisterMetaListSchema(\n  \"ads\",\n  \"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.\",\n  listArgs,\n);\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List ads in a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta ads --account-id act_123\",\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    const effectiveStatus = resolveEffectiveStatus(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"adset-id\"]) params[\"adset-id\"] = args[\"adset-id\"] as string;\n      if (args[\"campaign-id\"]) params[\"campaign-id\"] = args[\"campaign-id\"] as string;\n      if (effectiveStatus) params[\"effective-status\"] = effectiveStatus;\n      if (args[\"name-contains\"]) params[\"name-contains\"] = args[\"name-contains\"] as string;\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/ads\", params);\n      const shaped = shapeMetaListRows(\"ads\", data, args);\n      writeMetaListRows(\"ads\", shaped, csvOrJson(args), statusFilterHints(data, effectiveStatus, \"ads\"));\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nexport const adsListCommand = defineCommand({\n  meta: {\n    name: \"ads\",\n    description: `List ads in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/copy/retag).\nDefaults to ACTIVE only — pass --all-statuses to widen. Write subcommands stage ops on this chat's draft.\n\nThe dashboard shows effective_status (e.g. WITH_ISSUES, PENDING_REVIEW, DISAPPROVED, ADSET_PAUSED), not status.\n\nListings print a table by default: id, name, adset_id, campaign_id, effective_status, creative_id, issues\n(why an ad is WITH_ISSUES), created_time. --fields takes dotted paths (e.g. tracking_specs,\npreview_shareable_link); --full returns every field; --output json returns the rows as JSON.\n\nExamples:\n  baker ads meta ads --account-id act_123\n  baker ads meta ads --adset-id 6123\n  baker ads meta ads --account-id act_123 --all-statuses --name-contains octubre --fields id,name,adset_id,creative_id   — find one ad by name\n  baker ads meta ads --adset-id 6123 --fields id,name,preview_shareable_link\n  baker ads meta ads create --name \"Ad 1\" --adset meta_temp_as01 --creative meta_temp_cr01\n  baker ads meta ads pause 6123 --account-id act_123\n  baker ads meta ads retag 6123 --set \"utm_medium=paid-social\"      — fix tracking on a LIVE ad, keeping everything else`,\n  },\n  subCommands: {\n    list: listCommand,\n    create: () => import(\"./write-commands.ts\").then((m) => m.adsCreateCommand),\n    update: () => import(\"./write-commands.ts\").then((m) => m.adsUpdateCommand),\n    pause: () => import(\"./write-commands.ts\").then((m) => m.adsPauseCommand),\n    resume: () => import(\"./write-commands.ts\").then((m) => m.adsResumeCommand),\n    archive: () => import(\"./write-commands.ts\").then((m) => m.adsArchiveCommand),\n    delete: () => import(\"./write-commands.ts\").then((m) => m.adsDeleteCommand),\n    duplicate: () => import(\"./write-commands.ts\").then((m) => m.adsDuplicateCommand),\n    copy: () => import(\"./copy-writes.ts\").then((m) => m.adsCopyCommand),\n    retag: () => import(\"./write-commands.ts\").then((m) => m.adsRetagCommand),\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;AAa9B,IAAM,WAAW;AAAA,EACf,cAAc,EAAE,MAAM,UAAU,aAAa,qBAAqB;AAAA,EAClE,YAAY,EAAE,MAAM,UAAU,aAAa,sBAAsB;AAAA,EACjE,eAAe,EAAE,MAAM,UAAU,aAAa,yBAAyB;AAAA,EACvE,oBAAoB,EAAE,MAAM,UAAU,aAAa,8DAA8D;AAAA,EACjH,gBAAgB,EAAE,MAAM,WAAW,aAAa,iCAAiC;AAAA,EACjF,iBAAiB;AAAA,EACjB,OAAO,EAAE,MAAM,UAAU,aAAa,0BAA0B;AAAA,EAChE,YAAY;AAAA,EACZ,GAAG;AACL;AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;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,UAAM,kBAAkB,uBAAuB,IAAI;AACnD,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,UAAI,KAAK,UAAU,EAAG,QAAO,UAAU,IAAI,KAAK,UAAU;AAC1D,UAAI,KAAK,aAAa,EAAG,QAAO,aAAa,IAAI,KAAK,aAAa;AACnE,UAAI,gBAAiB,QAAO,kBAAkB,IAAI;AAClD,UAAI,KAAK,eAAe,EAAG,QAAO,eAAe,IAAI,KAAK,eAAe;AACzE,UAAI,KAAK,MAAO,QAAO,QAAQ,KAAK;AACpC,UAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,YAAM,OAAO,MAAM,OAAuC,qBAAqB,MAAM;AACrF,YAAM,SAAS,kBAAkB,OAAO,MAAM,IAAI;AAClD,wBAAkB,OAAO,QAAQ,UAAU,IAAI,GAAG,kBAAkB,MAAM,iBAAiB,KAAK,CAAC;AAAA,IACnG,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAEM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBf;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IAC1E,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IAC1E,OAAO,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACxE,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IAC1E,SAAS,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,iBAAiB;AAAA,IAC5E,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IAC1E,WAAW,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,mBAAmB;AAAA,IAChF,MAAM,MAAM,OAAO,2BAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IACnE,OAAO,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,EAC1E;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM;AAAA,EACN,SAAS;AACX,CAAC;","names":[]}

package/dist/ads-6GTQ2HS4.js

@@ -0,0 +1,43 @@
+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)
+  terms     \u2014 which platform terms an ad account has accepted (customer lists, lead forms, \u2026) and how to accept the rest
+
+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
+  baker ads terms --platform google --account-id 1234567890
+Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedin|x|chatgpt|terms)`
+  },
+  subCommands: {
+    google: () => import("./google-JQHC36XQ.js").then((m) => m.googleCommand),
+    meta: () => import("./meta-ACKABP2H.js").then((m) => m.metaCommand),
+    linkedin: () => import("./linkedin-F43WCEFC.js").then((m) => m.linkedinCommand),
+    x: () => import("./x-JGV5D7AV.js").then((m) => m.xCommand),
+    chatgpt: () => import("./chatgpt-J3ITRRCX.js").then((m) => m.chatgptCommand),
+    terms: () => import("./terms-YM6UNNYX.js").then((m) => m.termsCommand)
+  }
+});
+export {
+  adsCommand
+};
+//# sourceMappingURL=ads-6GTQ2HS4.js.map

package/dist/ads-6GTQ2HS4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\nexport const adsCommand = defineCommand({\n  meta: {\n    name: \"ads\",\n    description: `Ad platform commands. Each platform exposes its own native command surface — no forced parity.\n\nPlatforms:\n  google    — Google Ads (GAQL queries, keywords, accounts, ad library)\n  meta      — Meta Ads (campaigns, adsets, ads, insights, previews)\n  linkedin  — LinkedIn Ads (firmographic analytics — job-title × company × industry × seniority pivots)\n  x         — X (Twitter) Ads (campaigns, line items, promoted tweets, analytics)\n  chatgpt   — ChatGPT Ads (account, campaigns, ad groups, ads, insights — read-only)\n  terms     — which platform terms an ad account has accepted (customer lists, lead forms, …) and how to accept the rest\n\nExamples:\n  baker ads google accounts\n  baker ads google query --preset campaign-performance --customer-id 1234567890\n  baker ads meta accounts\n  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE\n  baker ads meta insights --object act_123 --level ad --date-preset last_7d --fields impressions,spend,ctr\n  baker ads linkedin accounts\n  baker ads x accounts\n  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def\n  baker ads chatgpt insights --days 30 --granularity daily\n  baker ads terms --platform google --account-id 1234567890\nFull guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedin|x|chatgpt|terms)`,\n  },\n  subCommands: {\n    google: () => import(\"./google/index.ts\").then((m) => m.googleCommand),\n    meta: () => import(\"./meta/index.ts\").then((m) => m.metaCommand),\n    linkedin: () => import(\"./linkedin/index.ts\").then((m) => m.linkedinCommand),\n    x: () => import(\"./x/index.ts\").then((m) => m.xCommand),\n    chatgpt: () => import(\"./chatgpt/index.ts\").then((m) => m.chatgptCommand),\n    terms: () => import(\"./terms.ts\").then((m) => m.termsCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAEvB,IAAM,aAAa,cAAc;AAAA,EACtC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBf;AAAA,EACA,aAAa;AAAA,IACX,QAAQ,MAAM,OAAO,sBAAmB,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,IACrE,MAAM,MAAM,OAAO,oBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW;AAAA,IAC/D,UAAU,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IAC3E,GAAG,MAAM,OAAO,iBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ;AAAA,IACtD,SAAS,MAAM,OAAO,uBAAoB,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IACxE,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;AAAA,EAC9D;AACF,CAAC;","names":[]}

package/dist/ads-C6LVVX4F.js

@@ -0,0 +1,128 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-QR44DQTC.js";
+import {
+  reportError
+} from "./chunk-3Q32TXSP.js";
+import {
+  apiGet
+} from "./chunk-AS46I4WH.js";
+import "./chunk-6UW4J6IU.js";
+import "./chunk-XOHXG5TG.js";
+import {
+  advertiserAdsRequestSchema,
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-AL6AEGWH.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-C6LVVX4F.js.map

package/dist/ads-TLJI5KCA.js

@@ -0,0 +1,77 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-ZFINQBE7.js";
+import "./chunk-KBSWQKOT.js";
+import "./chunk-AS46I4WH.js";
+import "./chunk-6UW4J6IU.js";
+import "./chunk-XOHXG5TG.js";
+import {
+  registerSchema
+} from "./chunk-AL6AEGWH.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-FNWVH7SP.js").then((m) => m.adsCreateCommand),
+    update: () => import("./ad-writes-FNWVH7SP.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./ad-writes-FNWVH7SP.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./ad-writes-FNWVH7SP.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./ad-writes-FNWVH7SP.js").then((m) => m.adsArchiveCommand),
+    "create-product": () => import("./ad-writes-FNWVH7SP.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-TLJI5KCA.js.map

package/dist/adsets-2536GR4Q.js

@@ -0,0 +1,178 @@
+import {
+  VIEWER_TABLE_COLUMNS,
+  adSetViewerRows,
+  audienceNamesOf,
+  flattenViewerRows,
+  readAudienceNames
+} from "./chunk-G6XKD7QE.js";
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-WN6WHZRC.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-W3H7CX5E.js";
+import {
+  rememberedJev
+} from "./chunk-XVMRO6W5.js";
+import "./chunk-Y2JZX6JB.js";
+import {
+  writeAdsOutput
+} from "./chunk-KBSWQKOT.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-MITWP546.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-52KXFESB.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-Q6GYSW47.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-BTGOVA2H.js";
+import "./chunk-UAKNLPIU.js";
+import "./chunk-BCFIMEZJ.js";
+import "./chunk-2Q324LIK.js";
+import {
+  apiGet
+} from "./chunk-AS46I4WH.js";
+import "./chunk-6UW4J6IU.js";
+import "./chunk-XOHXG5TG.js";
+import "./chunk-AL6AEGWH.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/copy).
+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-3RLSYXOH.js").then((m) => m.adSetsCreateCommand),
+    update: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adSetsUpdateCommand),
+    pause: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adSetsPauseCommand),
+    resume: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adSetsResumeCommand),
+    archive: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adSetsArchiveCommand),
+    delete: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adSetsDeleteCommand),
+    duplicate: () => import("./write-commands-3RLSYXOH.js").then((m) => m.adSetsDuplicateCommand),
+    copy: () => import("./copy-writes-SIQPN7L4.js").then((m) => m.adSetsCopyCommand)
+  },
+  // `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-2536GR4Q.js.map