@koda-sl/baker-cli 0.573.0 → 0.574.0

package/dist/media-6VI4PN4N.js

@@ -0,0 +1,18 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/media.ts
+import { defineCommand } from "citty";
+var metaMediaCommand = defineCommand({
+  meta: {
+    name: "media",
+    description: "Stage Baker library media uploads to Meta so creatives can reference them (upload), or take an image out of the account's image library (delete --image-hash). Upload publishes an ad-image hash or video id a creative binds via --image-ref/--video-ref."
+  },
+  subCommands: {
+    upload: () => import("./write-commands-XFYXMTXO.js").then((m) => m.mediaUploadCommand),
+    delete: () => import("./asset-writes-2CYNDRPU.js").then((m) => m.mediaDeleteCommand)
+  }
+});
+export {
+  metaMediaCommand
+};
+//# sourceMappingURL=media-6VI4PN4N.js.map

package/dist/media-WIFXVGKU.js

@@ -0,0 +1,89 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-RM5JT6XF.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-VJUVTMHY.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/media.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.media",
+  description: "List media assets in the X Ads media library (images, GIFs, videos). Filter by media-type (IMAGE, GIF, VIDEO).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "media-type": { type: "string", description: "IMAGE | GIF | VIDEO", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  }
+});
+var mediaCommand = defineCommand({
+  meta: {
+    name: "media",
+    description: `List media assets in the X Ads media library.
+
+Examples:
+  baker ads x media --account-id 18ce53xyz
+  baker ads x media --account-id 18ce53xyz --media-type VIDEO`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "media-type": { type: "string", description: "IMAGE | GIF | VIDEO", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `media:${accountId}:${args["media-type"] ?? "ALL"}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (args["media-type"]) params["media-type"] = args["media-type"];
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/media-library", params);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 6 * 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  mediaCommand
+};
+//# sourceMappingURL=media-WIFXVGKU.js.map

package/dist/media-sources-Z4JJELU7.js

@@ -0,0 +1,35 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/index.ts
+import { defineCommand } from "citty";
+var mediaSourcesCommand = defineCommand({
+  meta: {
+    name: "media-sources",
+    description: `Follow social accounts \u2014 the company's pages and its key people (CEO, CTO, head of sales\u2026) \u2014 on Instagram, TikTok, YouTube (videos), LinkedIn (pages and /in/ profiles) and Facebook. Their posts fill Posts (\`baker posts\`), their images and videos the libraries. A Google Drive folder is picked by the user in the chat (request_connection, platform google-drive, choose media-folder), never added here; once connected, list, sync, schedule and remove manage it like any source. Subcommands: add, update, list, sync, schedule, reset, remove.
+
+Examples:
+  baker media-sources add https://www.tiktok.com/@acme
+  baker media-sources add @acme --platform instagram --every daily
+  baker media-sources add https://www.linkedin.com/in/jane-doe --role ceo
+  baker media-sources update linkedin:in/jane-doe --role ceo --title "CEO & co-founder"
+  baker media-sources list
+  baker media-sources sync youtube:acme
+  baker media-sources schedule linkedin:acme --every monthly
+  baker media-sources reset instagram:acme        # unstick an import that never finished
+  baker media-sources remove facebook:acme
+Full guide: __tooling__/docs/tools/baker/media-sources.md`
+  },
+  subCommands: {
+    add: () => import("./add-IALA4VRA.js").then((m) => m.addCommand),
+    update: () => import("./update-TNOOVX3P.js").then((m) => m.updateCommand),
+    list: () => import("./list-UD43QCLC.js").then((m) => m.listCommand),
+    sync: () => import("./sync-STPHWKTE.js").then((m) => m.syncCommand),
+    schedule: () => import("./schedule-L5NVM4DN.js").then((m) => m.scheduleCommand),
+    reset: () => import("./reset-PDQTEM2J.js").then((m) => m.resetCommand),
+    remove: () => import("./remove-VGEKRK34.js").then((m) => m.removeCommand)
+  }
+});
+export {
+  mediaSourcesCommand
+};
+//# sourceMappingURL=media-sources-Z4JJELU7.js.map

package/dist/members-2BNKMQ2I.js

@@ -0,0 +1,47 @@
+import {
+  failApi
+} from "./chunk-MUU27AJF.js";
+import "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/members.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.members",
+  description: "The teammates a Task can be assigned to \u2014 everyone with access to this company that the person behind this chat can see, as { userId, name, email, role }. Pass a userId or email from here to `baker actions assign --to`. Read-only.",
+  args: {}
+});
+var membersCommand = defineCommand({
+  meta: {
+    name: "members",
+    description: "Teammates a Task can be assigned to. Example: baker actions members"
+  },
+  run: async () => {
+    try {
+      const response = await apiPost("/api/actions/members", {});
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  membersCommand
+};
+//# sourceMappingURL=members-2BNKMQ2I.js.map

package/dist/meme-I43AVLGS.js

@@ -0,0 +1,108 @@
+import {
+  librarySaveHint
+} from "./chunk-I7OJZ7QE.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/meme.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "Start here: the real, well-known meme template for a reaction (e.g. 'smug then horrified', 'two buttons', 'reject then approve'). Returns the blank template pictures best first, each with its caption boxes (panels). The words are yours: set them with the ad's text step, never Imgflip's caption service. Use the template whenever the brand's voice fits a meme; there is no question to ask the person. For two panels (a top and a bottom reaction), run once per reaction. Example: baker images meme 'reject then approve' --limit 5 --auto-ingest 1. Compact by default; --full adds sizes and match.";
+registerSchema({
+  command: "images.meme",
+  description: DESCRIPTION,
+  args: {
+    query: { type: "string", description: "The reaction in plain words", required: true },
+    limit: { type: "number", description: "Max templates (default 8, max 20)", required: false, default: 8 },
+    "auto-ingest": {
+      type: "number",
+      description: "Keep the top N in the library, tagged meme-template (default 0, max 4)",
+      required: false,
+      default: 0
+    },
+    panels: { type: "number", description: "Prefer templates with this many caption boxes", required: false },
+    full: { type: "boolean", description: "Add sizes and whether the name matched", required: false, default: false }
+  }
+});
+function memeRequestBody(args) {
+  const query = typeof args.query === "string" ? args.query.trim() : "";
+  if (!query) return null;
+  const body = { query };
+  if (args.limit) body.limit = Number(args.limit);
+  if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
+  if (args.panels) body.panels = Number(args.panels);
+  return body;
+}
+function compactMemes(response, full) {
+  return response.hits.map((hit) => ({
+    templateId: hit.templateId,
+    name: hit.name,
+    url: hit.url,
+    panels: hit.boxCount,
+    ...hit.ingestedImageId ? { imageId: hit.ingestedImageId } : {},
+    ...full ? { width: hit.width, height: hit.height, matched: hit.matched } : {}
+  }));
+}
+function memeHints(response) {
+  const hints = [];
+  if (response.hits.length > 0 && response.hits.every((h) => !h.matched)) {
+    hints.push(
+      "No template answers this reaction by name: these are only the most used. Try other words for the feeling (e.g. 'choice', 'regret', 'smug'), or build the ad without a meme."
+    );
+  }
+  hints.push(
+    "For two panels, run once per reaction (a top and a bottom reaction). Set the words with the ad's text step; never use the meme site's own caption service."
+  );
+  const saved = librarySaveHint(
+    "image library",
+    response.hits.flatMap((hit) => hit.ingestedImageId && hit.deduped !== true ? [hit.ingestedImageId] : [])
+  );
+  if (saved) hints.push(saved);
+  return hints;
+}
+var memeCommand = defineCommand({
+  meta: { name: "meme", description: DESCRIPTION },
+  args: {
+    query: { type: "positional", description: "The reaction in plain words", required: true },
+    limit: { type: "string", description: "Max templates", required: false },
+    "auto-ingest": { type: "string", description: "Keep the top N in the library", required: false },
+    panels: { type: "string", description: "Prefer templates with this many caption boxes", required: false },
+    full: { type: "boolean", description: "Add sizes and match", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = memeRequestBody(args);
+      if (!body) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "Say the reaction: baker images meme '<reaction>'" }
+        });
+        process.exit(1);
+      }
+      const data = await apiPost("/api/images/meme", body);
+      writeJson({ ok: true, data: { templates: compactMemes(data, args.full === true) }, hints: memeHints(data) });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  compactMemes,
+  memeCommand,
+  memeHints,
+  memeRequestBody
+};
+//# sourceMappingURL=meme-I43AVLGS.js.map

package/dist/meta-IVCO7HHX.js

@@ -0,0 +1,152 @@
+import {
+  applyAccountRule
+} from "./chunk-USFXKWTX.js";
+import {
+  normalizeMetaAccountId
+} from "./chunk-FCD5BPC5.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-VJUVTMHY.js";
+import {
+  apiGet
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/index.ts
+import { defineCommand } from "citty";
+var metaCommand = defineCommand({
+  meta: {
+    name: "meta",
+    description: `Meta Marketing API \u2014 AI-first command surface (Facebook + Instagram ads).
+
+Discovery:
+  baker ads meta accounts                                \u2014 accounts in this company's connected scope
+  baker ads meta businesses                              \u2014 Business Manager IDs
+  baker ads meta pages                                   \u2014 Facebook Pages the selected ad accounts can promote (an ad's identity)
+  baker ads meta lead-forms --page-id 100635183117758    \u2014 instant (lead) forms on a Page, with lead counts
+  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json \u2014 stage a new form
+  baker ads meta leads --form-id 987654321               \u2014 the leads one form collected (contact details masked)
+
+Snapshot a running account (default = ACTIVE only):
+  baker ads meta campaigns --account-id act_123
+  baker ads meta adsets --campaign-id 6123
+  baker ads meta ads --adset-id 6123
+  baker ads meta campaigns --account-id act_123 --all-statuses        \u2014 include paused, archived
+
+Build targeting (Meta takes ids, never names \u2014 look them up first):
+  baker ads meta targeting search --account-id act_123 --q "solar energy"  \u2014 interest/behavior/employer\u2026 ids
+  baker ads meta targeting geo --account-id act_123 --q Madrid             \u2014 location keys
+  baker ads meta targeting validate --account-id act_123 --targeting-file t.json
+  baker ads meta targeting estimate --account-id act_123 --targeting-file t.json --optimization-goal LEAD_GENERATION
+  baker ads meta targeting describe --account-id act_123 --adset-id 6123   \u2014 the audience in Meta's words
+
+Identities and libraries:
+  baker ads meta instagram-accounts --account-id act_123              \u2014 the --instagram-user an ad can run as
+  baker ads meta apps --account-id act_123                            \u2014 apps it can promote
+  baker ads meta dsa-recommendations --account-id act_123             \u2014 EU DSA beneficiary/payor names
+  baker ads meta images --account-id act_123                          \u2014 image hashes already on Meta
+  baker ads meta labels --account-id act_123
+  baker ads meta catalogs --business-id 601050769212882               \u2014 product catalogs; --catalog-id for product sets; products/sets/feeds/diagnostics
+  baker ads meta page-photos upload --page-id \u2026 --image-id \u2026           \u2014 a photo on a Page, not posted (Instant Experiences)
+  baker ads meta instant-experiences --page-id 904238019441800        \u2014 full-screen pages an ad can open (collection ads)
+  baker ads meta studies --account-id act_123                         \u2014 A/B tests; --study-id for results
+  baker ads meta high-demand-periods --campaign-id 6123               \u2014 budget boosts
+  baker ads meta page-posts --page-id 904238019441800                 \u2014 posts an ad can boost; instagram-media for Instagram
+  baker ads meta block-lists --account-id act_123                     \u2014 sites and apps ads stay off (brand safety)
+  baker ads meta reach-frequency --account-id act_123                 \u2014 reach & frequency quotes; predict | reserve | cancel
+  baker ads meta account-settings --account-id act_123 --spending-limit 5000 \u2014 account name / spending limit (staged)
+  baker ads meta comments --ad-id 120211234567890                     \u2014 comments on an ad's post
+  baker ads meta account-details --account-id act_123 --show users    \u2014 people, Meta's suggestions, Advantage+ controls, playables, page sets
+
+Drill in:
+  baker ads meta account --account-id act_123                         \u2014 currency, balance, business, whether it can deliver
+  baker ads meta creatives --creative-id 9988,9989                    \u2014 creatives' copy, link and assets, several at once
+  baker ads meta audiences --name-contains buyers                     \u2014 one audience and its lookalikes
+  baker ads meta custom-conversions --account-id act_123              \u2014 the marketer's own conversions ("my conversions")
+  baker ads meta pixels --account-id act_123                          \u2014 pixel list
+  baker ads meta pixels --pixel-id 9988 --stats --days 7              \u2014 firing health
+
+Performance (the workhorse):
+  baker ads meta insights --object act_123                                                    \u2014 defaults: level=account, intent=baseline, last_7d
+  baker ads meta insights --object act_123 --intent revenue --date-preset last_28d
+  baker ads meta insights --object act_123 --level ad --intent ranking                        \u2014 flag creatives to refresh
+  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age  \u2014 placement \xD7 age
+  baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31   \u2014 auto-async
+  baker ads meta insights --list-intents
+
+Automated rules (run on Meta, unattended, once published):
+  baker ads meta rules --account-id act_123                           \u2014 every rule and what it does
+  baker ads meta rules history --rule-id 1132635173044914             \u2014 what a rule did and when
+  baker ads meta rules create --name "Stop expensive ads" --apply-to ad --when "cost_per_result>20" --action pause
+
+A/B tests (Meta splits the audience between versions and calls the winner):
+  baker ads meta adsets duplicate 6123 --name "\u2026 \u2013 lookalike"         \u2014 then change ONE thing on the copy
+  baker ads meta studies create --name "Broad vs lookalike" --adsets 6123,meta_temp_ab12 --start 2026-10-20T08:00Z --days 14
+
+Audit & review:
+  baker ads meta activities --account-id act_123 --days 14
+  baker ads meta preview --ad-id 9988 --ad-format MOBILE_FEED_STANDARD             \u2014 SEE the ad: displayed text + a picture
+  baker ads meta videos --ad-id 9988,9989                                         \u2014 download the ads' video files (MP4) to watch or cut
+Full guide: __tooling__/docs/tools/baker/ads-meta.md`
+  },
+  setup: ({ rawArgs }) => applyAccountRule({
+    platform: "Meta",
+    rawArgs,
+    flags: ["--account-id"],
+    envVar: "BAKER_META_AD_ACCOUNT_ID",
+    skip: /* @__PURE__ */ new Set(["accounts", "businesses", "draft"]),
+    list: async () => (await apiGet("/api/ads/meta/accounts")).flatMap(
+      (account) => {
+        const id = account.externalId ?? account.id;
+        return id ? [{ id, ...account.name ? { label: account.name } : {} }] : [];
+      }
+    ),
+    normalize: normalizeMetaAccountId
+  }),
+  subCommands: {
+    accounts: () => import("./accounts-LTGUK6OV.js").then((m) => m.accountsCommand),
+    account: () => import("./account-YYB2KWLU.js").then((m) => m.accountCommand),
+    businesses: () => import("./businesses-HOAQVYRH.js").then((m) => m.businessesCommand),
+    pages: () => import("./pages-RMTL3RCK.js").then((m) => m.pagesCommand),
+    "lead-forms": () => import("./leads-VEHYM23G.js").then((m) => m.leadFormsCommand),
+    "instant-experiences": () => import("./instant-experiences-YZYOLGBA.js").then((m) => m.instantExperiencesCommand),
+    leads: () => import("./leads-VEHYM23G.js").then((m) => m.leadsCommand),
+    campaigns: () => import("./campaigns-EEH3VDK6.js").then((m) => m.campaignsCommand),
+    adsets: () => import("./adsets-HNFBX4LB.js").then((m) => m.adsetsCommand),
+    ads: () => import("./ads-A34INCCM.js").then((m) => m.adsListCommand),
+    creatives: () => import("./creatives-ZGXH7UA7.js").then((m) => m.creativesCommand),
+    audiences: () => import("./audiences-S6TXNKQ2.js").then((m) => m.audiencesCommand),
+    "custom-conversions": () => import("./custom-conversions-RTSR3KKJ.js").then((m) => m.customConversionsCommand),
+    pixels: () => import("./pixels-YQJKJWAC.js").then((m) => m.pixelsCommand),
+    activities: () => import("./activities-ZRP22SC2.js").then((m) => m.activitiesCommand),
+    insights: () => import("./insights-2NWY4XJR.js").then((m) => m.insightsCommand),
+    preview: () => import("./preview-HWM6KHV5.js").then((m) => m.previewCommand),
+    videos: () => import("./videos-QIDOIJ24.js").then((m) => m.videosCommand),
+    targeting: () => import("./targeting-AVHPKERN.js").then((m) => m.targetingCommand),
+    "instagram-accounts": () => import("./account-assets-BFMQWV33.js").then((m) => m.instagramAccountsCommand),
+    apps: () => import("./account-assets-BFMQWV33.js").then((m) => m.appsCommand),
+    "dsa-recommendations": () => import("./account-assets-BFMQWV33.js").then((m) => m.dsaRecommendationsCommand),
+    images: () => import("./account-assets-BFMQWV33.js").then((m) => m.imagesCommand),
+    labels: () => import("./account-assets-BFMQWV33.js").then((m) => m.labelsCommand),
+    studies: () => import("./studies-4JOP2GQJ.js").then((m) => m.studiesCommand),
+    catalogs: () => import("./catalogs-WBXWK7NT.js").then((m) => m.catalogsCommand),
+    "page-photos": () => import("./page-photos-52S2XRIW.js").then((m) => m.pagePhotosCommand),
+    "page-posts": () => import("./account-level-47IS2CZB.js").then((m) => m.pagePostsCommand),
+    "instagram-media": () => import("./account-level-47IS2CZB.js").then((m) => m.instagramMediaCommand),
+    comments: () => import("./account-level-47IS2CZB.js").then((m) => m.commentsCommand),
+    "account-settings": () => import("./account-level-47IS2CZB.js").then((m) => m.accountSettingsCommand),
+    "account-details": () => import("./account-level-47IS2CZB.js").then((m) => m.accountDetailsCommand),
+    "block-lists": () => import("./account-level-47IS2CZB.js").then((m) => m.blockListsCommand),
+    "reach-frequency": () => import("./account-level-47IS2CZB.js").then((m) => m.reachFrequencyCommand),
+    "high-demand-periods": () => import("./account-assets-BFMQWV33.js").then((m) => m.highDemandPeriodsCommand),
+    rules: () => import("./rules-BBALKNBK.js").then((m) => m.rulesCommand),
+    media: () => import("./media-6VI4PN4N.js").then((m) => m.metaMediaCommand),
+    draft: () => import("./draft-3MYPEBSF.js").then((m) => m.metaDraftCommand)
+  }
+});
+export {
+  metaCommand
+};
+//# sourceMappingURL=meta-IVCO7HHX.js.map

package/dist/meta-IVCO7HHX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { applyAccountRule } from \"../sole-account.ts\";\nimport { normalizeMetaAccountId } from \"./shared.ts\";\n\n/**\n * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.\n *\n * Every backend read route has a command except `/currency`: `account` already\n * returns the currency and time zone, so a second command for two of its\n * fields would only be a second place to look.\n *\n * Default behaviors that matter:\n *   - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.\n *   - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.\n *   - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).\n *   - Heavy insights queries auto-fall to async (poll loop hidden).\n *   - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.\n */\nexport const metaCommand = defineCommand({\n  meta: {\n    name: \"meta\",\n    description: `Meta Marketing API — AI-first command surface (Facebook + Instagram ads).\n\nDiscovery:\n  baker ads meta accounts                                — accounts in this company's connected scope\n  baker ads meta businesses                              — Business Manager IDs\n  baker ads meta pages                                   — Facebook Pages the selected ad accounts can promote (an ad's identity)\n  baker ads meta lead-forms --page-id 100635183117758    — instant (lead) forms on a Page, with lead counts\n  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json — stage a new form\n  baker ads meta leads --form-id 987654321               — the leads one form collected (contact details masked)\n\nSnapshot a running account (default = ACTIVE only):\n  baker ads meta campaigns --account-id act_123\n  baker ads meta adsets --campaign-id 6123\n  baker ads meta ads --adset-id 6123\n  baker ads meta campaigns --account-id act_123 --all-statuses        — include paused, archived\n\nBuild targeting (Meta takes ids, never names — look them up first):\n  baker ads meta targeting search --account-id act_123 --q \"solar energy\"  — interest/behavior/employer… ids\n  baker ads meta targeting geo --account-id act_123 --q Madrid             — location keys\n  baker ads meta targeting validate --account-id act_123 --targeting-file t.json\n  baker ads meta targeting estimate --account-id act_123 --targeting-file t.json --optimization-goal LEAD_GENERATION\n  baker ads meta targeting describe --account-id act_123 --adset-id 6123   — the audience in Meta's words\n\nIdentities and libraries:\n  baker ads meta instagram-accounts --account-id act_123              — the --instagram-user an ad can run as\n  baker ads meta apps --account-id act_123                            — apps it can promote\n  baker ads meta dsa-recommendations --account-id act_123             — EU DSA beneficiary/payor names\n  baker ads meta images --account-id act_123                          — image hashes already on Meta\n  baker ads meta labels --account-id act_123\n  baker ads meta catalogs --business-id 601050769212882               — product catalogs; --catalog-id for product sets; products/sets/feeds/diagnostics\n  baker ads meta page-photos upload --page-id … --image-id …           — a photo on a Page, not posted (Instant Experiences)\n  baker ads meta instant-experiences --page-id 904238019441800        — full-screen pages an ad can open (collection ads)\n  baker ads meta studies --account-id act_123                         — A/B tests; --study-id for results\n  baker ads meta high-demand-periods --campaign-id 6123               — budget boosts\n  baker ads meta page-posts --page-id 904238019441800                 — posts an ad can boost; instagram-media for Instagram\n  baker ads meta block-lists --account-id act_123                     — sites and apps ads stay off (brand safety)\n  baker ads meta reach-frequency --account-id act_123                 — reach & frequency quotes; predict | reserve | cancel\n  baker ads meta account-settings --account-id act_123 --spending-limit 5000 — account name / spending limit (staged)\n  baker ads meta comments --ad-id 120211234567890                     — comments on an ad's post\n  baker ads meta account-details --account-id act_123 --show users    — people, Meta's suggestions, Advantage+ controls, playables, page sets\n\nDrill in:\n  baker ads meta account --account-id act_123                         — currency, balance, business, whether it can deliver\n  baker ads meta creatives --creative-id 9988,9989                    — creatives' copy, link and assets, several at once\n  baker ads meta audiences --name-contains buyers                     — one audience and its lookalikes\n  baker ads meta custom-conversions --account-id act_123              — the marketer's own conversions (\"my conversions\")\n  baker ads meta pixels --account-id act_123                          — pixel list\n  baker ads meta pixels --pixel-id 9988 --stats --days 7              — firing health\n\nPerformance (the workhorse):\n  baker ads meta insights --object act_123                                                    — defaults: level=account, intent=baseline, last_7d\n  baker ads meta insights --object act_123 --intent revenue --date-preset last_28d\n  baker ads meta insights --object act_123 --level ad --intent ranking                        — flag creatives to refresh\n  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age  — placement × age\n  baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31   — auto-async\n  baker ads meta insights --list-intents\n\nAutomated rules (run on Meta, unattended, once published):\n  baker ads meta rules --account-id act_123                           — every rule and what it does\n  baker ads meta rules history --rule-id 1132635173044914             — what a rule did and when\n  baker ads meta rules create --name \"Stop expensive ads\" --apply-to ad --when \"cost_per_result>20\" --action pause\n\nA/B tests (Meta splits the audience between versions and calls the winner):\n  baker ads meta adsets duplicate 6123 --name \"… – lookalike\"         — then change ONE thing on the copy\n  baker ads meta studies create --name \"Broad vs lookalike\" --adsets 6123,meta_temp_ab12 --start 2026-10-20T08:00Z --days 14\n\nAudit & review:\n  baker ads meta activities --account-id act_123 --days 14\n  baker ads meta preview --ad-id 9988 --ad-format MOBILE_FEED_STANDARD             — SEE the ad: displayed text + a picture\n  baker ads meta videos --ad-id 9988,9989                                         — download the ads' video files (MP4) to watch or cut\nFull guide: __tooling__/docs/tools/baker/ads-meta.md`,\n  },\n  setup: ({ rawArgs }) =>\n    applyAccountRule({\n      platform: \"Meta\",\n      rawArgs,\n      flags: [\"--account-id\"],\n      envVar: \"BAKER_META_AD_ACCOUNT_ID\",\n      skip: new Set([\"accounts\", \"businesses\", \"draft\"]),\n      list: async () =>\n        (await apiGet<Array<{ externalId?: string; id?: string; name?: string }>>(\"/api/ads/meta/accounts\")).flatMap(\n          (account) => {\n            const id = account.externalId ?? account.id;\n            return id ? [{ id, ...(account.name ? { label: account.name } : {}) }] : [];\n          },\n        ),\n      normalize: normalizeMetaAccountId,\n    }),\n  subCommands: {\n    accounts: () => import(\"./accounts.ts\").then((m) => m.accountsCommand),\n    account: () => import(\"./account.ts\").then((m) => m.accountCommand),\n    businesses: () => import(\"./businesses.ts\").then((m) => m.businessesCommand),\n    pages: () => import(\"./pages.ts\").then((m) => m.pagesCommand),\n    \"lead-forms\": () => import(\"./leads.ts\").then((m) => m.leadFormsCommand),\n    \"instant-experiences\": () => import(\"./instant-experiences.ts\").then((m) => m.instantExperiencesCommand),\n    leads: () => import(\"./leads.ts\").then((m) => m.leadsCommand),\n    campaigns: () => import(\"./campaigns.ts\").then((m) => m.campaignsCommand),\n    adsets: () => import(\"./adsets.ts\").then((m) => m.adsetsCommand),\n    ads: () => import(\"./ads.ts\").then((m) => m.adsListCommand),\n    creatives: () => import(\"./creatives.ts\").then((m) => m.creativesCommand),\n    audiences: () => import(\"./audiences.ts\").then((m) => m.audiencesCommand),\n    \"custom-conversions\": () => import(\"./custom-conversions.ts\").then((m) => m.customConversionsCommand),\n    pixels: () => import(\"./pixels.ts\").then((m) => m.pixelsCommand),\n    activities: () => import(\"./activities.ts\").then((m) => m.activitiesCommand),\n    insights: () => import(\"./insights.ts\").then((m) => m.insightsCommand),\n    preview: () => import(\"./preview.ts\").then((m) => m.previewCommand),\n    videos: () => import(\"./videos.ts\").then((m) => m.videosCommand),\n    targeting: () => import(\"./targeting.ts\").then((m) => m.targetingCommand),\n    \"instagram-accounts\": () => import(\"./account-assets.ts\").then((m) => m.instagramAccountsCommand),\n    apps: () => import(\"./account-assets.ts\").then((m) => m.appsCommand),\n    \"dsa-recommendations\": () => import(\"./account-assets.ts\").then((m) => m.dsaRecommendationsCommand),\n    images: () => import(\"./account-assets.ts\").then((m) => m.imagesCommand),\n    labels: () => import(\"./account-assets.ts\").then((m) => m.labelsCommand),\n    studies: () => import(\"./studies.ts\").then((m) => m.studiesCommand),\n    catalogs: () => import(\"./catalogs.ts\").then((m) => m.catalogsCommand),\n    \"page-photos\": () => import(\"./page-photos.ts\").then((m) => m.pagePhotosCommand),\n    \"page-posts\": () => import(\"./account-level.ts\").then((m) => m.pagePostsCommand),\n    \"instagram-media\": () => import(\"./account-level.ts\").then((m) => m.instagramMediaCommand),\n    comments: () => import(\"./account-level.ts\").then((m) => m.commentsCommand),\n    \"account-settings\": () => import(\"./account-level.ts\").then((m) => m.accountSettingsCommand),\n    \"account-details\": () => import(\"./account-level.ts\").then((m) => m.accountDetailsCommand),\n    \"block-lists\": () => import(\"./account-level.ts\").then((m) => m.blockListsCommand),\n    \"reach-frequency\": () => import(\"./account-level.ts\").then((m) => m.reachFrequencyCommand),\n    \"high-demand-periods\": () => import(\"./account-assets.ts\").then((m) => m.highDemandPeriodsCommand),\n    rules: () => import(\"./rules.ts\").then((m) => m.rulesCommand),\n    media: () => import(\"./media.ts\").then((m) => m.metaMediaCommand),\n    draft: () => import(\"./draft.ts\").then((m) => m.metaDraftCommand),\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/metrics-KXTFXSWK.js

@@ -0,0 +1,152 @@
+import {
+  PLANNER_FIELD_DESCRIPTIONS,
+  PLANNER_SOURCE,
+  stampPlannerRows
+} from "./chunk-2Y5V23PU.js";
+import {
+  buildAdsQueryContext,
+  warnDefaults
+} from "./chunk-IGCS3X4F.js";
+import "./chunk-BMMXYR7A.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  handleConnectionError,
+  isNotConnectedError,
+  resolveCustomerId,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-VJUVTMHY.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/metrics.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.metrics",
+  description: 'Get historical market metrics for specific keywords. Returns { source: "keyword_planner_estimate", historical_metrics: [...] }. These are Keyword Planner estimates of total market search volume, not this account\'s data: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. If --location and --language are omitted, they default to United States (2840) and English (1000); `query_context` shows which were used.',
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits; dashes are fine). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    keywords: { type: "string", description: "Comma-separated keywords to analyze (max 200)", required: true },
+    location: {
+      type: "string",
+      description: "Geo target ID. Defaults to 2840 (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language ID. Defaults to 1000 (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function stampMetricsResponse(data) {
+  return { ...data, source: PLANNER_SOURCE, historical_metrics: stampPlannerRows(data.historical_metrics ?? []) };
+}
+function handleMetricsError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("google_ads", err.message);
+    }
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: { action: "reject", explanation: err.message },
+        retryable: err.code === "RATE_LIMITED"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var metricsCommand = defineCommand({
+  meta: {
+    name: "metrics",
+    description: `Get historical search metrics for specific keywords.
+
+Returns Keyword Planner ESTIMATES of market search volume, not this account's numbers. Every row carries source=keyword_planner_estimate and planner_-prefixed metrics; keep those names when you quote a figure, and never present one as an impression or click count.
+
+Examples:
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "running shoes,nike shoes,adidas shoes"
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "seo tools" --location 2826`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+    keywords: { type: "string", description: "Comma-separated keywords", required: true },
+    location: { type: "string", description: "Geo target ID (default 2840)", required: false },
+    language: { type: "string", description: "Language ID (default 1000)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const queryContext = buildAdsQueryContext(args.location, args.language);
+    const keywords = args.keywords.split(",").map((k) => k.trim()).filter(Boolean);
+    if (keywords.length === 0) {
+      writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "At least one keyword is required" } });
+      process.exit(1);
+    }
+    if (keywords.length > 200) {
+      writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Maximum 200 keywords per request" } });
+      process.exit(1);
+    }
+    const body = { customerId, keywords };
+    const managerId = getManagerIdForCustomer(customerId);
+    if (managerId) body.managerId = managerId;
+    if (args.location) body.locationIds = [args.location];
+    if (args.language) body.languageId = args.language;
+    const useCache = !args["no-cache"];
+    if (!useCache) body.skipCache = true;
+    const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("keywords", cacheKey);
+      if (cached) {
+        warnDefaults(queryContext);
+        writeAdsJson({ ok: true, data: stampMetricsResponse(cached.data), cached: true, query_context: queryContext });
+        return;
+      }
+    }
+    try {
+      const data = await apiPost("/api/ads/google/keywords/metrics", body);
+      if (useCache) {
+        cacheSet("keywords", cacheKey, data, 24 * 60 * 60 * 1e3);
+      }
+      warnDefaults(queryContext);
+      const stamped = stampMetricsResponse(data);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(stamped.historical_metrics, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data: stamped, fields: PLANNER_FIELD_DESCRIPTIONS, query_context: queryContext });
+    } catch (err) {
+      handleMetricsError(err);
+    }
+  }
+});
+export {
+  metricsCommand,
+  stampMetricsResponse
+};
+//# sourceMappingURL=metrics-KXTFXSWK.js.map