@koda-sl/baker-cli 0.568.0 → 0.570.0

package/dist/media-34I7UB7Z.js

@@ -0,0 +1,89 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-3GXHML4V.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-MPTNN35I.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.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-34I7UB7Z.js.map

package/dist/media-KKI3KWLR.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-AIWLEGO2.js").then((m) => m.mediaUploadCommand),
+    delete: () => import("./asset-writes-NDSHY5OT.js").then((m) => m.mediaDeleteCommand)
+  }
+});
+export {
+  metaMediaCommand
+};
+//# sourceMappingURL=media-KKI3KWLR.js.map

package/dist/media-sources-VSPVHLYN.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-D44VCDRU.js").then((m) => m.addCommand),
+    update: () => import("./update-SD5YQIJC.js").then((m) => m.updateCommand),
+    list: () => import("./list-Q52FPW3H.js").then((m) => m.listCommand),
+    sync: () => import("./sync-OHIXI4I6.js").then((m) => m.syncCommand),
+    schedule: () => import("./schedule-D7EDEM45.js").then((m) => m.scheduleCommand),
+    reset: () => import("./reset-J2NLNITD.js").then((m) => m.resetCommand),
+    remove: () => import("./remove-NHE4UT7G.js").then((m) => m.removeCommand)
+  }
+});
+export {
+  mediaSourcesCommand
+};
+//# sourceMappingURL=media-sources-VSPVHLYN.js.map

package/dist/members-L6SXP6GC.js

@@ -0,0 +1,47 @@
+import {
+  failApi
+} from "./chunk-TEJOILEY.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.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-L6SXP6GC.js.map

package/dist/meme-6NFYFQ7T.js

@@ -0,0 +1,108 @@
+import {
+  librarySaveHint
+} from "./chunk-I7OJZ7QE.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.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-6NFYFQ7T.js.map

package/dist/meta-2UK7KIE4.js

@@ -0,0 +1,124 @@
+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`
+  },
+  subCommands: {
+    accounts: () => import("./accounts-A47QUTTB.js").then((m) => m.accountsCommand),
+    account: () => import("./account-NSBALYYS.js").then((m) => m.accountCommand),
+    businesses: () => import("./businesses-TRFYMZ4I.js").then((m) => m.businessesCommand),
+    pages: () => import("./pages-7HW5YOZV.js").then((m) => m.pagesCommand),
+    "lead-forms": () => import("./leads-4TLOH47R.js").then((m) => m.leadFormsCommand),
+    "instant-experiences": () => import("./instant-experiences-2LKF7XVK.js").then((m) => m.instantExperiencesCommand),
+    leads: () => import("./leads-4TLOH47R.js").then((m) => m.leadsCommand),
+    campaigns: () => import("./campaigns-2MTON2IE.js").then((m) => m.campaignsCommand),
+    adsets: () => import("./adsets-PSVCPCE3.js").then((m) => m.adsetsCommand),
+    ads: () => import("./ads-DGL5SGP3.js").then((m) => m.adsListCommand),
+    creatives: () => import("./creatives-4EPM3RHG.js").then((m) => m.creativesCommand),
+    audiences: () => import("./audiences-UHLVATR6.js").then((m) => m.audiencesCommand),
+    "custom-conversions": () => import("./custom-conversions-GQTU5E6X.js").then((m) => m.customConversionsCommand),
+    pixels: () => import("./pixels-D5HF24FI.js").then((m) => m.pixelsCommand),
+    activities: () => import("./activities-ZDWREYR7.js").then((m) => m.activitiesCommand),
+    insights: () => import("./insights-BR3456EI.js").then((m) => m.insightsCommand),
+    preview: () => import("./preview-55TRUF4Q.js").then((m) => m.previewCommand),
+    videos: () => import("./videos-GHFCOTT7.js").then((m) => m.videosCommand),
+    targeting: () => import("./targeting-BM72UTI6.js").then((m) => m.targetingCommand),
+    "instagram-accounts": () => import("./account-assets-EPEYTJFD.js").then((m) => m.instagramAccountsCommand),
+    apps: () => import("./account-assets-EPEYTJFD.js").then((m) => m.appsCommand),
+    "dsa-recommendations": () => import("./account-assets-EPEYTJFD.js").then((m) => m.dsaRecommendationsCommand),
+    images: () => import("./account-assets-EPEYTJFD.js").then((m) => m.imagesCommand),
+    labels: () => import("./account-assets-EPEYTJFD.js").then((m) => m.labelsCommand),
+    studies: () => import("./studies-YGYAH3JI.js").then((m) => m.studiesCommand),
+    catalogs: () => import("./catalogs-4DNLG4AM.js").then((m) => m.catalogsCommand),
+    "page-photos": () => import("./page-photos-KNBLMFLN.js").then((m) => m.pagePhotosCommand),
+    "page-posts": () => import("./account-level-VD4NLB2D.js").then((m) => m.pagePostsCommand),
+    "instagram-media": () => import("./account-level-VD4NLB2D.js").then((m) => m.instagramMediaCommand),
+    comments: () => import("./account-level-VD4NLB2D.js").then((m) => m.commentsCommand),
+    "account-settings": () => import("./account-level-VD4NLB2D.js").then((m) => m.accountSettingsCommand),
+    "account-details": () => import("./account-level-VD4NLB2D.js").then((m) => m.accountDetailsCommand),
+    "block-lists": () => import("./account-level-VD4NLB2D.js").then((m) => m.blockListsCommand),
+    "reach-frequency": () => import("./account-level-VD4NLB2D.js").then((m) => m.reachFrequencyCommand),
+    "high-demand-periods": () => import("./account-assets-EPEYTJFD.js").then((m) => m.highDemandPeriodsCommand),
+    rules: () => import("./rules-FYVD2QBB.js").then((m) => m.rulesCommand),
+    media: () => import("./media-KKI3KWLR.js").then((m) => m.metaMediaCommand),
+    draft: () => import("./draft-MWYKIZC4.js").then((m) => m.metaDraftCommand)
+  }
+});
+export {
+  metaCommand
+};
+//# sourceMappingURL=meta-2UK7KIE4.js.map

package/dist/metrics-4AFEEDVP.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-MPTNN35I.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.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, no dashes). 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-4AFEEDVP.js.map