@koda-sl/baker-cli 0.497.0 → 0.498.0

package/dist/insights-BPKB6VSU.js

@@ -1,424 +0,0 @@
-import {
-  placementFormatNote,
-  previewFormatForPosition
-} from "./chunk-A4MVVPJ2.js";
-import "./chunk-HLVRHBKL.js";
-import {
-  csvOrJson,
-  getDateRange,
-  handleMetaError
-} from "./chunk-RUHZ7BRN.js";
-import {
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-2VIZ4UUZ.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-U6RONIJC.js";
-import {
-  apiGet,
-  apiPost
-} from "./chunk-6YLNY6CK.js";
-import "./chunk-D5NEIESR.js";
-import "./chunk-57KKVDDR.js";
-import "./chunk-QANGHND7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/insights.ts
-import { defineCommand } from "citty";
-
-// src/commands/ads/meta/placement-delivery.ts
-var MIN_IMPRESSIONS = 20;
-var SILENT_FRACTION_OF_REFERENCE = 0.1;
-var PLAYING_REFERENCE_RATE = 0.5;
-function toNumber(value) {
-  const n = Number(value);
-  return Number.isFinite(n) ? n : 0;
-}
-function sumActionValues(value) {
-  if (!Array.isArray(value)) return 0;
-  return value.reduce((total, entry) => {
-    const item = entry;
-    return total + toNumber(item?.value);
-  }, 0);
-}
-function aggregate(rows) {
-  const byPlacement = /* @__PURE__ */ new Map();
-  let totalImpressions = 0;
-  for (const row of rows) {
-    const position = row.platform_position;
-    if (typeof position !== "string" || position.length === 0) continue;
-    const platform = typeof row.publisher_platform === "string" ? row.publisher_platform : "";
-    const impressions = toNumber(row.impressions);
-    totalImpressions += impressions;
-    const key = `${platform}/${position}`;
-    const current = byPlacement.get(key) ?? { platform, position, impressions: 0, plays: 0, playRate: 0, share: 0 };
-    current.impressions += impressions;
-    current.plays += sumActionValues(row.video_play_actions);
-    byPlacement.set(key, current);
-  }
-  return [...byPlacement.values()].map((placement) => ({
-    ...placement,
-    playRate: placement.impressions > 0 ? placement.plays / placement.impressions : 0,
-    share: totalImpressions > 0 ? placement.impressions / totalImpressions : 0
-  }));
-}
-function previewCommand(placement) {
-  const format = previewFormatForPosition(placement.position, placement.platform);
-  return format ? `\`baker ads meta preview --creative-id <id> --placement ${placement.position} --platform ${placement.platform}\`` : `no preview format is known for ${placement.position}, so Meta's renderer cannot confirm it \u2014 say the placement is unverified rather than filling the gap`;
-}
-function isSingleAdQuery(rows) {
-  const adIds = /* @__PURE__ */ new Set();
-  for (const row of rows) {
-    if (typeof row.ad_id !== "string" || row.ad_id.length === 0) return false;
-    adIds.add(row.ad_id);
-  }
-  return adIds.size === 1;
-}
-function placementDeliveryHints(rows) {
-  const carriesVideoMetrics = rows.some((row) => Array.isArray(row.video_play_actions));
-  if (!carriesVideoMetrics || !isSingleAdQuery(rows)) return [];
-  const placements = aggregate(rows);
-  const judgeable = placements.filter((p) => p.impressions >= MIN_IMPRESSIONS);
-  const impressions = judgeable.reduce((total, p) => total + p.impressions, 0);
-  const reference = impressions > 0 ? judgeable.reduce((total, p) => total + p.plays, 0) / impressions : 0;
-  if (reference < PLAYING_REFERENCE_RATE) return [];
-  const silent = judgeable.filter((p) => p.playRate < reference * SILENT_FRACTION_OF_REFERENCE).sort((a, b) => b.impressions - a.impressions);
-  if (silent.length === 0) {
-    const worst = [...judgeable].sort((a, b) => a.playRate - b.playRate)[0];
-    return [
-      `Checked every placement above ${MIN_IMPRESSIONS} impressions against this ad's own play rate (${(reference * 100).toFixed(0)}%): no placement is failing to play the video${worst ? `, the lowest being ${worst.platform}/${worst.position} at ${(worst.playRate * 100).toFixed(0)}%` : ""}. So placements do not explain a "it shows as a still image" report \u2014 rule out autoplay off or data saver in the viewer's own app, which renders every video as its cover frame account-wide.`
-    ];
-  }
-  const hints = silent.map((placement) => {
-    const note = placementFormatNote(placement.position);
-    const documented = note ? ` Meta documents this placement: ${note.note}` : "";
-    return `${placement.platform}/${placement.position} delivered ${placement.impressions.toLocaleString("en-US")} impressions (${(placement.share * 100).toFixed(1)}% of the total) and ${placement.plays.toLocaleString("en-US")} video plays \u2014 it may not be rendering the video. This is account evidence, not a rule: confirm what Meta renders there with ${previewCommand(placement)} before you say anything about it.${documented}`;
-  });
-  const combinedShare = silent.reduce((total, placement) => total + placement.share, 0) * 100;
-  hints.push(
-    `Those placements are ${combinedShare.toFixed(1)}% of delivery in this query. State that share before proposing to remove them \u2014 and note that removing placements from a live ad set is a targeting change, which Meta counts as a significant edit that re-enters the learning phase.`
-  );
-  return hints;
-}
-
-// src/commands/ads/meta/presets.ts
-var INSIGHTS_INTENTS = {
-  baseline: {
-    name: "baseline",
-    description: "Spend, impressions, clicks, CTR, CPC, CPM. The default question: 'how is delivery?'",
-    fields: ["impressions", "reach", "frequency", "spend", "clicks", "ctr", "cpc", "cpm"]
-  },
-  revenue: {
-    name: "revenue",
-    description: "Spend, conversions, action_values, purchase_roas. 'How much money are we making?'",
-    fields: ["spend", "actions", "action_values", "conversions", "conversion_values", "purchase_roas"],
-    actionBreakdowns: ["action_type"]
-  },
-  funnel: {
-    name: "funnel",
-    description: "Impression \u2192 click \u2192 landing page \u2192 action. 'Where do users drop off?'",
-    fields: ["impressions", "clicks", "inline_link_clicks", "outbound_clicks", "actions", "spend"],
-    actionBreakdowns: ["action_type"]
-  },
-  ranking: {
-    name: "ranking",
-    description: "Quality, engagement, conversion-rate rankings. 'Which creatives need a refresh?'",
-    fields: ["impressions", "spend", "ctr", "quality_ranking", "engagement_rate_ranking", "conversion_rate_ranking"]
-  },
-  video: {
-    name: "video",
-    description: "Watch funnel, thruplay cost. 'How are video creatives holding attention?'",
-    fields: [
-      "impressions",
-      "spend",
-      "video_play_actions",
-      "video_p25_watched_actions",
-      "video_p50_watched_actions",
-      "video_p75_watched_actions",
-      "video_p100_watched_actions",
-      "video_thruplay_watched_actions",
-      "cost_per_thruplay"
-    ]
-  },
-  identity: {
-    name: "identity",
-    description: "Just the names + spend \u2014 for cheap roll-up summaries.",
-    fields: ["spend", "impressions"]
-  }
-};
-var IDENTITY_FIELDS_BY_LEVEL = {
-  account: ["account_id", "account_name", "account_currency"],
-  campaign: ["campaign_id", "campaign_name", "objective"],
-  adset: ["adset_id", "adset_name", "campaign_id", "campaign_name"],
-  ad: ["ad_id", "ad_name", "adset_id", "adset_name", "campaign_id", "campaign_name"]
-};
-function composeFields(intent, level) {
-  const intentFields = INSIGHTS_INTENTS[intent].fields;
-  const identity = IDENTITY_FIELDS_BY_LEVEL[level];
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const f of [...identity, ...intentFields]) {
-    if (!seen.has(f)) {
-      seen.add(f);
-      out.push(f);
-    }
-  }
-  return out;
-}
-function getIntent(name) {
-  return INSIGHTS_INTENTS[name];
-}
-function listIntents() {
-  return Object.values(INSIGHTS_INTENTS);
-}
-
-// src/commands/ads/meta/insights.ts
-var POLL_INTERVAL_MS = 5e3;
-var POLL_MAX_MS = 10 * 6e4;
-var DEFAULT_ATTRIBUTION_WINDOWS = ["7d_click", "1d_view"];
-var DEFAULT_FILTERING = [{ field: "impressions", operator: "GREATER_THAN", value: 0 }];
-function commaSplit(input) {
-  if (!input) return void 0;
-  return input.split(",").map((s) => s.trim()).filter(Boolean);
-}
-function parseFiltering(raw) {
-  if (!raw) return void 0;
-  try {
-    return JSON.parse(raw);
-  } catch {
-    handleMetaError(new Error("Invalid --filtering JSON"));
-  }
-}
-function pickIntent(name) {
-  if (!name) return "baseline";
-  const found = getIntent(name);
-  if (!found) {
-    handleMetaError(new Error(`Unknown --intent: ${name}. Use --list-intents to see options.`));
-  }
-  return found.name;
-}
-function pickLevel(args) {
-  const raw = args.level;
-  if (!raw) return "account";
-  if (raw !== "account" && raw !== "campaign" && raw !== "adset" && raw !== "ad") {
-    handleMetaError(new Error("--level must be one of: account|campaign|adset|ad"));
-  }
-  return raw;
-}
-function shouldAutoAsync(body) {
-  const breakdownCount = (body.breakdowns ?? []).length;
-  if (body.level === "ad" && breakdownCount > 0 && body.object.startsWith("act_")) {
-    return true;
-  }
-  if (breakdownCount > 2) {
-    return true;
-  }
-  if (body.since && body.until) {
-    const days = (Date.parse(body.until) - Date.parse(body.since)) / 864e5;
-    if (days > 90) {
-      return true;
-    }
-  }
-  return false;
-}
-function wantsAsync(asyncFlag, body) {
-  if (asyncFlag === true) return true;
-  if (asyncFlag === false) return false;
-  return shouldAutoAsync(body);
-}
-function applyDateRange(body, args) {
-  const range = getDateRange(args);
-  if (range.datePreset) body.datePreset = range.datePreset;
-  if (range.since) body.since = range.since;
-  if (range.until) body.until = range.until;
-  if (!body.datePreset && !(body.since && body.until)) {
-    body.datePreset = "last_7d";
-  }
-}
-function buildFiltering(args) {
-  const explicit = parseFiltering(args.filtering);
-  if (explicit) return explicit;
-  if (args["include-undelivered"]) return void 0;
-  return DEFAULT_FILTERING;
-}
-function buildAttributionWindows(args) {
-  const explicit = commaSplit(args["attribution-windows"]);
-  if (explicit) return explicit;
-  return DEFAULT_ATTRIBUTION_WINDOWS;
-}
-function buildBody(args) {
-  const intent = pickIntent(args.intent);
-  const level = pickLevel(args);
-  const intentDef = getIntent(intent);
-  const explicitFields = commaSplit(args.fields);
-  const fields = explicitFields ?? composeFields(intent, level);
-  const breakdowns = commaSplit(args.breakdowns);
-  const actionBreakdowns = commaSplit(args["action-breakdowns"]) ?? intentDef?.actionBreakdowns;
-  const body = {
-    object: args.object,
-    level,
-    fields,
-    timeIncrement: args["time-increment"],
-    breakdowns,
-    actionBreakdowns,
-    filtering: buildFiltering(args),
-    attributionWindows: buildAttributionWindows(args),
-    useAccountAttributionSetting: Boolean(args["use-account-attribution"]),
-    useUnifiedAttributionSetting: Boolean(args["use-unified-attribution"]),
-    limit: args.limit ? Number(args.limit) : 1e3,
-    skipCache: Boolean(args["no-cache"])
-  };
-  applyDateRange(body, args);
-  return body;
-}
-async function pollAsync(reportRunId) {
-  const start = Date.now();
-  while (Date.now() - start < POLL_MAX_MS) {
-    const status = await apiGet(
-      "/api/ads/meta/insights/async/status",
-      { "report-run-id": reportRunId }
-    );
-    if (status.async_status === "Job Completed") return;
-    if (status.async_status === "Job Failed" || status.async_status === "Job Skipped") {
-      handleMetaError(new Error(`Async insights job ${status.async_status}`));
-    }
-    process.stderr.write(
-      `Async insights ${status.async_status ?? "queued"} (${Math.round(status.async_percent_completion ?? 0)}%)\u2026
-`
-    );
-    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
-  }
-  handleMetaError(new Error("Async insights polling timed out after 10 minutes"));
-}
-async function runAsync(body) {
-  const submit = await apiPost("/api/ads/meta/insights/async", body);
-  process.stderr.write(`Async insights job: ${submit.reportRunId}
-`);
-  await pollAsync(submit.reportRunId);
-  return apiPost("/api/ads/meta/insights/async/result", {
-    reportRunId: submit.reportRunId,
-    fields: body.fields,
-    limit: body.limit
-  });
-}
-function sortRowsBySpendDesc(rows) {
-  return [...rows].sort((a, b) => {
-    const sa = Number(a.spend ?? 0);
-    const sb = Number(b.spend ?? 0);
-    if (Number.isNaN(sa) || Number.isNaN(sb)) return 0;
-    return sb - sa;
-  });
-}
-var insightsCommand = defineCommand({
-  meta: {
-    name: "insights",
-    description: `Performance reporting \u2014 the main Meta tool for AI agents.
-
-Smart defaults so the AI doesn't have to remember every flag:
-  --level account                       (set --level campaign|adset|ad to drill in)
-  --intent baseline                     (or revenue|funnel|ranking|video|identity)
-  --date-preset last_7d                 (override with --since/--until)
-  --attribution-windows 7d_click,1d_view  (the only ones still working post Jan 2026)
-  filter: impressions > 0               (skip undelivered rows; --include-undelivered to keep)
-  sort: spend descending                (when result fits in memory)
-  auto-async when query is heavy (level=ad + breakdowns, big date ranges, etc.)
-
-Identity fields (campaign_name, ad_name etc.) are appended automatically based on --level so rows
-are self-describing.
-
-Examples \u2014 common AI questions:
-  # "How is GreenLeaf doing this week?"
-  baker ads meta insights --object act_123
-
-  # "Which campaigns are profitable?"
-  baker ads meta insights --object act_123 --level campaign --intent revenue --date-preset last_28d
-
-  # "Which creatives need a refresh?"
-  baker ads meta insights --object act_123 --level ad --intent ranking --date-preset last_14d
-
-  # "Where do users drop off the funnel?"
-  baker ads meta insights --object act_123 --intent funnel
-
-  # "Should we shift budget to Instagram?"
-  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,platform_position
-
-  # Custom field set (escape hatch)
-  baker ads meta insights --object act_123 --fields impressions,spend,actions
-
-Async is automatic for heavy queries; pass --async to force it, or --no-async to refuse fallback.`
-  },
-  args: {
-    object: {
-      type: "string",
-      description: "Object ID \u2014 act_<id> for account, or a campaign/adset/ad ID"
-    },
-    level: { type: "string", description: "account|campaign|adset|ad (default: account)" },
-    intent: { type: "string", description: "baseline|revenue|funnel|ranking|video|identity (default: baseline)" },
-    fields: { type: "string", description: "Comma-separated field list (overrides --intent bundle)" },
-    "list-intents": { type: "boolean", description: "Print available intents and exit" },
-    "date-preset": { type: "string", description: "Meta date preset (last_7d, last_28d, today, ...)" },
-    since: { type: "string", description: "Custom start date YYYY-MM-DD" },
-    until: { type: "string", description: "Custom end date YYYY-MM-DD" },
-    "time-increment": { type: "string", description: "1 (day) | monthly | all_days" },
-    breakdowns: { type: "string", description: "Comma-separated breakdowns (e.g. publisher_platform,age)" },
-    "action-breakdowns": {
-      type: "string",
-      description: "Slice the actions[] array (default: action_type for revenue/funnel)"
-    },
-    filtering: { type: "string", description: "Override default filter \u2014 JSON array of {field,operator,value}" },
-    "include-undelivered": { type: "boolean", description: "Keep rows where impressions=0 (off by default)" },
-    "attribution-windows": {
-      type: "string",
-      description: "Override default 7d_click,1d_view (only 1d_view, 1d_click, 7d_click, 28d_click work post Jan 2026)"
-    },
-    "use-account-attribution": { type: "boolean", description: "Use account-saved attribution setting" },
-    "use-unified-attribution": { type: "boolean", description: "Use ad-set unified attribution setting" },
-    limit: { type: "string", description: "Max rows (default 1000)" },
-    // Declaring `no-async` too would be a trap: citty resolves it to `async: false`
-    // and never fills an arg of that name, so the declaration reads as supported
-    // while nothing consumes it.
-    async: { type: "boolean", description: "Force the async submit-and-poll path (--no-async refuses it)" },
-    "no-sort": { type: "boolean", description: "Skip default spend-desc sort" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "Output format", default: "json" }
-  },
-  run: async ({ args }) => {
-    if (args["list-intents"]) {
-      writeAdsJson({ ok: true, data: listIntents() });
-      return;
-    }
-    if (!args.object) {
-      writeAdsJson({
-        ok: false,
-        error: { code: "VALIDATION_ERROR", message: "Missing required argument: --object" }
-      });
-      process.exit(1);
-    }
-    const body = buildBody(args);
-    const fmt = csvOrJson(args);
-    const wantAsync = wantsAsync(args.async, body);
-    try {
-      const rows = wantAsync ? await runAsync(body) : await apiPost("/api/ads/meta/insights", body);
-      const sorted = args["no-sort"] ? rows : sortRowsBySpendDesc(rows);
-      if (fmt !== "json") {
-        writeAdsOutput(sorted, fmt, body.fields);
-        return;
-      }
-      const hints = placementDeliveryHints(sorted);
-      if (hints.length > 0) {
-        writeJsonEnvelope({ ok: true, data: sorted, hints });
-        return;
-      }
-      writeAdsJson({ ok: true, data: sorted });
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-export {
-  insightsCommand,
-  wantsAsync
-};
-//# sourceMappingURL=insights-BPKB6VSU.js.map

package/dist/insights-BPKB6VSU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ads/meta/insights.ts","../src/commands/ads/meta/placement-delivery.ts","../src/commands/ads/meta/presets.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet, apiPost } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport { placementDeliveryHints } from \"./placement-delivery.ts\";\nimport { composeFields, getIntent, type InsightsIntent, type InsightsLevel, listIntents } from \"./presets.ts\";\nimport { csvOrJson, getDateRange, handleMetaError } from \"./shared.ts\";\n\nconst POLL_INTERVAL_MS = 5_000;\nconst POLL_MAX_MS = 10 * 60_000;\n\n/** Default attribution windows — only these still work as of Jan 2026 (1d_view + 28d_click also valid but rarely used). */\nconst DEFAULT_ATTRIBUTION_WINDOWS = [\"7d_click\", \"1d_view\"];\n\n/** Default filter — strip rows that didn't deliver. Almost always what we want. */\nconst DEFAULT_FILTERING = [{ field: \"impressions\", operator: \"GREATER_THAN\", value: 0 }];\n\nexport interface InsightsBody {\n  object: string;\n  level: InsightsLevel;\n  fields: string[];\n  datePreset?: string;\n  since?: string;\n  until?: string;\n  timeIncrement?: string;\n  breakdowns?: string[];\n  actionBreakdowns?: string[];\n  filtering?: Array<{ field: string; operator: string; value: string | number | string[] }>;\n  attributionWindows?: string[];\n  useAccountAttributionSetting?: boolean;\n  useUnifiedAttributionSetting?: boolean;\n  limit?: number;\n  skipCache?: boolean;\n}\n\nfunction commaSplit(input: string | undefined): string[] | undefined {\n  if (!input) return undefined;\n  return input\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n}\n\nfunction parseFiltering(raw: string | undefined): InsightsBody[\"filtering\"] {\n  if (!raw) return undefined;\n  try {\n    return JSON.parse(raw) as InsightsBody[\"filtering\"];\n  } catch {\n    handleMetaError(new Error(\"Invalid --filtering JSON\"));\n  }\n}\n\nfunction pickIntent(name: string | undefined): InsightsIntent {\n  if (!name) return \"baseline\";\n  const found = getIntent(name);\n  if (!found) {\n    handleMetaError(new Error(`Unknown --intent: ${name}. Use --list-intents to see options.`));\n  }\n  return found.name;\n}\n\nfunction pickLevel(args: Record<string, unknown>): InsightsLevel {\n  const raw = args.level as string | undefined;\n  if (!raw) return \"account\";\n  if (raw !== \"account\" && raw !== \"campaign\" && raw !== \"adset\" && raw !== \"ad\") {\n    handleMetaError(new Error(\"--level must be one of: account|campaign|adset|ad\"));\n  }\n  return raw;\n}\n\n/**\n * Auto-async heuristic. Heavy queries that would time out as sync go async\n * automatically — the user shouldn't have to think about it.\n *\n *   - level=ad with breakdowns\n *   - >2 breakdowns at any level\n *   - explicit time range > 90 days\n *   - level=ad over an account-level object with a wide window\n */\nfunction shouldAutoAsync(body: InsightsBody): boolean {\n  const breakdownCount = (body.breakdowns ?? []).length;\n  if (body.level === \"ad\" && breakdownCount > 0 && body.object.startsWith(\"act_\")) {\n    return true;\n  }\n  if (breakdownCount > 2) {\n    return true;\n  }\n  if (body.since && body.until) {\n    const days = (Date.parse(body.until) - Date.parse(body.since)) / 86_400_000;\n    if (days > 90) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Whether to take the async path — three states, not two.\n *\n * citty resolves `--no-async` to `async: false` rather than filling a separate\n * `no-async` arg, so reading `args[\"no-async\"]` (as this did) always saw\n * undefined and the documented refusal never applied: a heavy query went async\n * no matter what the caller asked for.\n */\nexport function wantsAsync(asyncFlag: unknown, body: InsightsBody): boolean {\n  if (asyncFlag === true) return true;\n  if (asyncFlag === false) return false;\n  return shouldAutoAsync(body);\n}\n\nfunction applyDateRange(body: InsightsBody, args: Record<string, unknown>): void {\n  const range = getDateRange(args);\n  if (range.datePreset) body.datePreset = range.datePreset;\n  if (range.since) body.since = range.since;\n  if (range.until) body.until = range.until;\n  if (!body.datePreset && !(body.since && body.until)) {\n    body.datePreset = \"last_7d\";\n  }\n}\n\nfunction buildFiltering(args: Record<string, unknown>): InsightsBody[\"filtering\"] {\n  const explicit = parseFiltering(args.filtering as string | undefined);\n  if (explicit) return explicit;\n  if (args[\"include-undelivered\"]) return undefined;\n  return DEFAULT_FILTERING;\n}\n\nfunction buildAttributionWindows(args: Record<string, unknown>): string[] | undefined {\n  const explicit = commaSplit(args[\"attribution-windows\"] as string | undefined);\n  if (explicit) return explicit;\n  return DEFAULT_ATTRIBUTION_WINDOWS;\n}\n\nfunction buildBody(args: Record<string, unknown>): InsightsBody {\n  const intent = pickIntent(args.intent as string | undefined);\n  const level = pickLevel(args);\n  const intentDef = getIntent(intent);\n  const explicitFields = commaSplit(args.fields as string | undefined);\n  const fields = explicitFields ?? composeFields(intent, level);\n  const breakdowns = commaSplit(args.breakdowns as string | undefined);\n  const actionBreakdowns = commaSplit(args[\"action-breakdowns\"] as string | undefined) ?? intentDef?.actionBreakdowns;\n\n  const body: InsightsBody = {\n    object: args.object as string,\n    level,\n    fields,\n    timeIncrement: args[\"time-increment\"] as string | undefined,\n    breakdowns,\n    actionBreakdowns,\n    filtering: buildFiltering(args),\n    attributionWindows: buildAttributionWindows(args),\n    useAccountAttributionSetting: Boolean(args[\"use-account-attribution\"]),\n    useUnifiedAttributionSetting: Boolean(args[\"use-unified-attribution\"]),\n    limit: args.limit ? Number(args.limit) : 1000,\n    skipCache: Boolean(args[\"no-cache\"]),\n  };\n  applyDateRange(body, args);\n  return body;\n}\n\nasync function pollAsync(reportRunId: string): Promise<void> {\n  const start = Date.now();\n  while (Date.now() - start < POLL_MAX_MS) {\n    // The status route is a GET reading `report-run-id` from the query string.\n    // Posting to it matched no route at all, so every heavy query died on a\n    // bare 404 the moment it went async.\n    const status = await apiGet<{ async_status?: string; async_percent_completion?: number }>(\n      \"/api/ads/meta/insights/async/status\",\n      { \"report-run-id\": reportRunId },\n    );\n    if (status.async_status === \"Job Completed\") return;\n    if (status.async_status === \"Job Failed\" || status.async_status === \"Job Skipped\") {\n      handleMetaError(new Error(`Async insights job ${status.async_status}`));\n    }\n    process.stderr.write(\n      `Async insights ${status.async_status ?? \"queued\"} (${Math.round(status.async_percent_completion ?? 0)}%)…\\n`,\n    );\n    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));\n  }\n  handleMetaError(new Error(\"Async insights polling timed out after 10 minutes\"));\n}\n\nasync function runAsync(body: InsightsBody): Promise<Array<Record<string, unknown>>> {\n  const submit = await apiPost<{ reportRunId: string }>(\"/api/ads/meta/insights/async\", body);\n  process.stderr.write(`Async insights job: ${submit.reportRunId}\\n`);\n  await pollAsync(submit.reportRunId);\n  return apiPost<Array<Record<string, unknown>>>(\"/api/ads/meta/insights/async/result\", {\n    reportRunId: submit.reportRunId,\n    fields: body.fields,\n    limit: body.limit,\n  });\n}\n\n/** Insights rows have nested `actions[]` arrays. Sort by the named action_type's value descending. */\nfunction sortRowsBySpendDesc(rows: Array<Record<string, unknown>>): Array<Record<string, unknown>> {\n  return [...rows].sort((a, b) => {\n    const sa = Number(a.spend ?? 0);\n    const sb = Number(b.spend ?? 0);\n    if (Number.isNaN(sa) || Number.isNaN(sb)) return 0;\n    return sb - sa;\n  });\n}\n\nexport const insightsCommand = defineCommand({\n  meta: {\n    name: \"insights\",\n    description: `Performance reporting — the main Meta tool for AI agents.\n\nSmart defaults so the AI doesn't have to remember every flag:\n  --level account                       (set --level campaign|adset|ad to drill in)\n  --intent baseline                     (or revenue|funnel|ranking|video|identity)\n  --date-preset last_7d                 (override with --since/--until)\n  --attribution-windows 7d_click,1d_view  (the only ones still working post Jan 2026)\n  filter: impressions > 0               (skip undelivered rows; --include-undelivered to keep)\n  sort: spend descending                (when result fits in memory)\n  auto-async when query is heavy (level=ad + breakdowns, big date ranges, etc.)\n\nIdentity fields (campaign_name, ad_name etc.) are appended automatically based on --level so rows\nare self-describing.\n\nExamples — common AI questions:\n  # \"How is GreenLeaf doing this week?\"\n  baker ads meta insights --object act_123\n\n  # \"Which campaigns are profitable?\"\n  baker ads meta insights --object act_123 --level campaign --intent revenue --date-preset last_28d\n\n  # \"Which creatives need a refresh?\"\n  baker ads meta insights --object act_123 --level ad --intent ranking --date-preset last_14d\n\n  # \"Where do users drop off the funnel?\"\n  baker ads meta insights --object act_123 --intent funnel\n\n  # \"Should we shift budget to Instagram?\"\n  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,platform_position\n\n  # Custom field set (escape hatch)\n  baker ads meta insights --object act_123 --fields impressions,spend,actions\n\nAsync is automatic for heavy queries; pass --async to force it, or --no-async to refuse fallback.`,\n  },\n  args: {\n    object: {\n      type: \"string\",\n      description: \"Object ID — act_<id> for account, or a campaign/adset/ad ID\",\n    },\n    level: { type: \"string\", description: \"account|campaign|adset|ad (default: account)\" },\n    intent: { type: \"string\", description: \"baseline|revenue|funnel|ranking|video|identity (default: baseline)\" },\n    fields: { type: \"string\", description: \"Comma-separated field list (overrides --intent bundle)\" },\n    \"list-intents\": { type: \"boolean\", description: \"Print available intents and exit\" },\n    \"date-preset\": { type: \"string\", description: \"Meta date preset (last_7d, last_28d, today, ...)\" },\n    since: { type: \"string\", description: \"Custom start date YYYY-MM-DD\" },\n    until: { type: \"string\", description: \"Custom end date YYYY-MM-DD\" },\n    \"time-increment\": { type: \"string\", description: \"1 (day) | monthly | all_days\" },\n    breakdowns: { type: \"string\", description: \"Comma-separated breakdowns (e.g. publisher_platform,age)\" },\n    \"action-breakdowns\": {\n      type: \"string\",\n      description: \"Slice the actions[] array (default: action_type for revenue/funnel)\",\n    },\n    filtering: { type: \"string\", description: \"Override default filter — JSON array of {field,operator,value}\" },\n    \"include-undelivered\": { type: \"boolean\", description: \"Keep rows where impressions=0 (off by default)\" },\n    \"attribution-windows\": {\n      type: \"string\",\n      description: \"Override default 7d_click,1d_view (only 1d_view, 1d_click, 7d_click, 28d_click work post Jan 2026)\",\n    },\n    \"use-account-attribution\": { type: \"boolean\", description: \"Use account-saved attribution setting\" },\n    \"use-unified-attribution\": { type: \"boolean\", description: \"Use ad-set unified attribution setting\" },\n    limit: { type: \"string\", description: \"Max rows (default 1000)\" },\n    // Declaring `no-async` too would be a trap: citty resolves it to `async: false`\n    // and never fills an arg of that name, so the declaration reads as supported\n    // while nothing consumes it.\n    async: { type: \"boolean\", description: \"Force the async submit-and-poll path (--no-async refuses it)\" },\n    \"no-sort\": { type: \"boolean\", description: \"Skip default spend-desc sort\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"Output format\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    if (args[\"list-intents\"]) {\n      writeAdsJson({ ok: true, data: listIntents() });\n      return;\n    }\n\n    if (!args.object) {\n      writeAdsJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Missing required argument: --object\" },\n      });\n      process.exit(1);\n    }\n\n    const body = buildBody(args);\n    const fmt = csvOrJson(args);\n    const wantAsync = wantsAsync(args.async, body);\n\n    try {\n      const rows = wantAsync\n        ? await runAsync(body)\n        : await apiPost<Array<Record<string, unknown>>>(\"/api/ads/meta/insights\", body);\n      const sorted = args[\"no-sort\"] ? rows : sortRowsBySpendDesc(rows);\n\n      if (fmt !== \"json\") {\n        writeAdsOutput(sorted, fmt, body.fields);\n        return;\n      }\n      const hints = placementDeliveryHints(sorted);\n      if (hints.length > 0) {\n        writeJsonEnvelope({ ok: true, data: sorted, hints });\n        return;\n      }\n      writeAdsJson({ ok: true, data: sorted });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n","import { placementFormatNote, previewFormatForPosition } from \"@baker/api/ads-meta\";\n\n/**\n * Reads a placement breakdown the way the question \"why does my video show as a\n * still image?\" actually needs to be answered: with this account's own numbers.\n *\n * The failure this replaces is an agent recalling a list of \"image-only\n * placements\" (most of it wrong) and inventing a mechanism Meta does not\n * document. Impressions against video plays, per placement, is the cheap\n * empirical check — it costs one query the agent already ran, and it is\n * account evidence rather than a rule. So the hints below name a suspect and\n * hand over the command that confirms it; they never conclude.\n */\n\n/**\n * Below this, a placement's play rate is arithmetic on too few impressions to\n * carry a claim. Set against a 90%-ish reference rate, seeing no plays in 20\n * impressions is not something chance produces — so this is low enough to reach\n * the long tail where format problems actually live, and the placements it\n * excludes are the ones nobody could have concluded anything from anyway.\n */\nconst MIN_IMPRESSIONS = 20;\n\n/**\n * How far below the ad's own play rate counts as \"this placement is not playing\".\n *\n * Judged against the ad, not against zero. The account this was built from is\n * the reason: it plays at 93% overall, and the one placement carrying a\n * documented format constraint played at 3.85% — 24x worse, and still above any\n * absolute \"under 2%\" bar. An absolute rule cannot see that at any impression\n * threshold; a relative one calibrates itself per creative and per account.\n */\nconst SILENT_FRACTION_OF_REFERENCE = 0.1;\n\n/** Proof the creative plays at all somewhere, so a flagged placement means something. */\nconst PLAYING_REFERENCE_RATE = 0.5;\n\ninterface PlacementDelivery {\n  platform: string;\n  position: string;\n  impressions: number;\n  plays: number;\n  playRate: number;\n  share: number;\n}\n\nfunction toNumber(value: unknown): number {\n  const n = Number(value);\n  return Number.isFinite(n) ? n : 0;\n}\n\n/** Meta returns action metrics as `[{ action_type, value }]`; the total is what matters here. */\nfunction sumActionValues(value: unknown): number {\n  if (!Array.isArray(value)) return 0;\n  return value.reduce<number>((total, entry) => {\n    const item = entry as { value?: unknown };\n    return total + toNumber(item?.value);\n  }, 0);\n}\n\nfunction aggregate(rows: Array<Record<string, unknown>>): PlacementDelivery[] {\n  const byPlacement = new Map<string, PlacementDelivery>();\n  let totalImpressions = 0;\n\n  for (const row of rows) {\n    const position = row.platform_position;\n    if (typeof position !== \"string\" || position.length === 0) continue;\n    const platform = typeof row.publisher_platform === \"string\" ? row.publisher_platform : \"\";\n    const impressions = toNumber(row.impressions);\n    totalImpressions += impressions;\n    const key = `${platform}/${position}`;\n    const current = byPlacement.get(key) ?? { platform, position, impressions: 0, plays: 0, playRate: 0, share: 0 };\n    current.impressions += impressions;\n    current.plays += sumActionValues(row.video_play_actions);\n    byPlacement.set(key, current);\n  }\n\n  return [...byPlacement.values()].map((placement) => ({\n    ...placement,\n    playRate: placement.impressions > 0 ? placement.plays / placement.impressions : 0,\n    share: totalImpressions > 0 ? placement.impressions / totalImpressions : 0,\n  }));\n}\n\nfunction previewCommand(placement: PlacementDelivery): string {\n  const format = previewFormatForPosition(placement.position, placement.platform);\n  return format\n    ? `\\`baker ads meta preview --creative-id <id> --placement ${placement.position} --platform ${placement.platform}\\``\n    : `no preview format is known for ${placement.position}, so Meta's renderer cannot confirm it — say the placement is unverified rather than filling the gap`;\n}\n\n/**\n * The play rate only means something when every row describes the same\n * creative. Aggregating placements across ads puts an image ad's impressions in\n * the same bucket as a video's plays, which reads as \"this placement doesn't\n * render video\" when it only means \"an image ad ran there\" — the exact wrong\n * conclusion this module exists to prevent. So a query that does not pin one ad\n * (`--level ad --object <adId>`) gets no hint rather than a confounded one.\n */\nfunction isSingleAdQuery(rows: Array<Record<string, unknown>>): boolean {\n  const adIds = new Set<string>();\n  for (const row of rows) {\n    if (typeof row.ad_id !== \"string\" || row.ad_id.length === 0) return false;\n    adIds.add(row.ad_id);\n  }\n  return adIds.size === 1;\n}\n\n/**\n * Placements this account delivered into without the video ever playing.\n *\n * Silent unless the query carried video metrics AND the creative demonstrably\n * plays somewhere else: without a playing reference, a zero everywhere means\n * \"not a video query\", not \"the placement is broken\".\n */\nexport function placementDeliveryHints(rows: Array<Record<string, unknown>>): string[] {\n  const carriesVideoMetrics = rows.some((row) => Array.isArray(row.video_play_actions));\n  if (!carriesVideoMetrics || !isSingleAdQuery(rows)) return [];\n\n  const placements = aggregate(rows);\n  const judgeable = placements.filter((p) => p.impressions >= MIN_IMPRESSIONS);\n  const impressions = judgeable.reduce((total, p) => total + p.impressions, 0);\n  const reference = impressions > 0 ? judgeable.reduce((total, p) => total + p.plays, 0) / impressions : 0;\n  if (reference < PLAYING_REFERENCE_RATE) return [];\n\n  const silent = judgeable\n    .filter((p) => p.playRate < reference * SILENT_FRACTION_OF_REFERENCE)\n    .sort((a, b) => b.impressions - a.impressions);\n\n  // Never go quiet on a video placement query. Silence is what the agent fills\n  // in with a remembered rule, and \"every placement plays\" is the answer to\n  // \"why does it show as a still image\" far more often than a placement is.\n  if (silent.length === 0) {\n    const worst = [...judgeable].sort((a, b) => a.playRate - b.playRate)[0];\n    return [\n      `Checked every placement above ${MIN_IMPRESSIONS} impressions against this ad's own play rate (${(reference * 100).toFixed(0)}%): no placement is failing to play the video${worst ? `, the lowest being ${worst.platform}/${worst.position} at ${(worst.playRate * 100).toFixed(0)}%` : \"\"}. So placements do not explain a \"it shows as a still image\" report — rule out autoplay off or data saver in the viewer's own app, which renders every video as its cover frame account-wide.`,\n    ];\n  }\n\n  const hints = silent.map((placement) => {\n    const note = placementFormatNote(placement.position);\n    const documented = note ? ` Meta documents this placement: ${note.note}` : \"\";\n    return `${placement.platform}/${placement.position} delivered ${placement.impressions.toLocaleString(\"en-US\")} impressions (${(placement.share * 100).toFixed(1)}% of the total) and ${placement.plays.toLocaleString(\"en-US\")} video plays — it may not be rendering the video. This is account evidence, not a rule: confirm what Meta renders there with ${previewCommand(placement)} before you say anything about it.${documented}`;\n  });\n\n  const combinedShare = silent.reduce((total, placement) => total + placement.share, 0) * 100;\n  hints.push(\n    `Those placements are ${combinedShare.toFixed(1)}% of delivery in this query. State that share before proposing to remove them — and note that removing placements from a live ad set is a targeting change, which Meta counts as a significant edit that re-enters the learning phase.`,\n  );\n  return hints;\n}\n","/**\n * Insights field bundles. Picked for AI agent ergonomics: small, focused field\n * lists that answer one specific question without forcing the AI to enumerate\n * Meta's 500+ insights fields.\n *\n * Two-axis design:\n *   --intent (field bundle, default: baseline)   — what data to ask for\n *   --level  (object granularity, default: account) — at what granularity\n *\n * Intents are independent of level — pass `--intent ranking --level ad` to flag\n * creatives, or `--intent revenue --level campaign` for ROAS by campaign.\n *\n * Identity fields (campaign_name etc.) are appended automatically based on\n * level so the AI can read rows without joining.\n */\n\nexport type InsightsLevel = \"account\" | \"campaign\" | \"adset\" | \"ad\";\n\nexport type InsightsIntent = \"baseline\" | \"revenue\" | \"funnel\" | \"ranking\" | \"video\" | \"identity\";\n\ninterface IntentDefinition {\n  name: InsightsIntent;\n  description: string;\n  fields: string[];\n  /** Action breakdowns to slice the actions[] array — empty if not needed. */\n  actionBreakdowns?: string[];\n}\n\nconst INSIGHTS_INTENTS: Record<InsightsIntent, IntentDefinition> = {\n  baseline: {\n    name: \"baseline\",\n    description: \"Spend, impressions, clicks, CTR, CPC, CPM. The default question: 'how is delivery?'\",\n    fields: [\"impressions\", \"reach\", \"frequency\", \"spend\", \"clicks\", \"ctr\", \"cpc\", \"cpm\"],\n  },\n  revenue: {\n    name: \"revenue\",\n    description: \"Spend, conversions, action_values, purchase_roas. 'How much money are we making?'\",\n    fields: [\"spend\", \"actions\", \"action_values\", \"conversions\", \"conversion_values\", \"purchase_roas\"],\n    actionBreakdowns: [\"action_type\"],\n  },\n  funnel: {\n    name: \"funnel\",\n    description: \"Impression → click → landing page → action. 'Where do users drop off?'\",\n    fields: [\"impressions\", \"clicks\", \"inline_link_clicks\", \"outbound_clicks\", \"actions\", \"spend\"],\n    actionBreakdowns: [\"action_type\"],\n  },\n  ranking: {\n    name: \"ranking\",\n    description: \"Quality, engagement, conversion-rate rankings. 'Which creatives need a refresh?'\",\n    fields: [\"impressions\", \"spend\", \"ctr\", \"quality_ranking\", \"engagement_rate_ranking\", \"conversion_rate_ranking\"],\n  },\n  video: {\n    name: \"video\",\n    description: \"Watch funnel, thruplay cost. 'How are video creatives holding attention?'\",\n    fields: [\n      \"impressions\",\n      \"spend\",\n      \"video_play_actions\",\n      \"video_p25_watched_actions\",\n      \"video_p50_watched_actions\",\n      \"video_p75_watched_actions\",\n      \"video_p100_watched_actions\",\n      \"video_thruplay_watched_actions\",\n      \"cost_per_thruplay\",\n    ],\n  },\n  identity: {\n    name: \"identity\",\n    description: \"Just the names + spend — for cheap roll-up summaries.\",\n    fields: [\"spend\", \"impressions\"],\n  },\n};\n\nconst IDENTITY_FIELDS_BY_LEVEL: Record<InsightsLevel, string[]> = {\n  account: [\"account_id\", \"account_name\", \"account_currency\"],\n  campaign: [\"campaign_id\", \"campaign_name\", \"objective\"],\n  adset: [\"adset_id\", \"adset_name\", \"campaign_id\", \"campaign_name\"],\n  ad: [\"ad_id\", \"ad_name\", \"adset_id\", \"adset_name\", \"campaign_id\", \"campaign_name\"],\n};\n\n/** Compose final field list: intent metrics + level-specific identity fields, deduplicated. */\nexport function composeFields(intent: InsightsIntent, level: InsightsLevel): string[] {\n  const intentFields = INSIGHTS_INTENTS[intent].fields;\n  const identity = IDENTITY_FIELDS_BY_LEVEL[level];\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const f of [...identity, ...intentFields]) {\n    if (!seen.has(f)) {\n      seen.add(f);\n      out.push(f);\n    }\n  }\n  return out;\n}\n\nexport function getIntent(name: string): IntentDefinition | undefined {\n  return INSIGHTS_INTENTS[name as InsightsIntent];\n}\n\nexport function listIntents(): IntentDefinition[] {\n  return Object.values(INSIGHTS_INTENTS);\n}\n"],"mappings":"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","names":[]}

package/dist/insights-EU45J56U.js

@@ -1,122 +0,0 @@
-import {
-  CHATGPT_ADS_GRANULARITIES,
-  CHATGPT_ADS_LEVELS,
-  CHATGPT_ADS_METRICS,
-  CHATGPT_ADS_REFERENCE,
-  CHATGPT_ADS_SEGMENTS,
-  chatgptAdsInsightsRequestSchema,
-  insightsRequestFromArgs,
-  runChatgptRead
-} from "./chunk-ACDLKTUP.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-2VIZ4UUZ.js";
-import {
-  apiPost
-} from "./chunk-6YLNY6CK.js";
-import "./chunk-D5NEIESR.js";
-import "./chunk-57KKVDDR.js";
-import {
-  registerSchema
-} from "./chunk-QANGHND7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/chatgpt/insights.ts
-import { defineCommand } from "citty";
-var args = {
-  level: {
-    type: "string",
-    description: `What one row is: ${CHATGPT_ADS_LEVELS.join("|")} (default campaign)`,
-    required: false
-  },
-  "campaign-id": { type: "string", description: "Report on one campaign (cmpn_\u2026)", required: false },
-  "ad-group-id": { type: "string", description: "Report on one ad group (adgrp_\u2026)", required: false },
-  "ad-id": { type: "string", description: "Report on one ad (ad_\u2026)", required: false },
-  days: {
-    type: "string",
-    description: "Last N complete days, ending the account's yesterday (default 7)",
-    required: false
-  },
-  since: {
-    type: "string",
-    description: "First day, YYYY-MM-DD, account timezone (instead of --days)",
-    required: false
-  },
-  until: { type: "string", description: "Last day, inclusive, YYYY-MM-DD", required: false },
-  granularity: {
-    type: "string",
-    description: `${CHATGPT_ADS_GRANULARITIES.join("|")} (default none: one total per row)`,
-    required: false
-  },
-  segment: {
-    type: "string",
-    description: `Break rows down by one of ${CHATGPT_ADS_SEGMENTS.join("|")}`,
-    required: false
-  },
-  metrics: {
-    type: "string",
-    description: `CSV of ${CHATGPT_ADS_METRICS.join(",")} (default impressions,clicks,spend,ctr,cpc,conversions,cpa)`,
-    required: false
-  },
-  sort: { type: "string", description: "Metric to rank rows by, highest first", required: false },
-  limit: { type: "string", description: "Rows, 1-2000 (default 200)", required: false }
-};
-registerSchema({
-  command: "ads.chatgpt.insights",
-  description: "Performance of the connected ChatGPT Ads account: impressions, clicks, spend, CTR, CPC, CPM, conversions, CPA, attributed sales and ROAS, per account, campaign, ad group or ad, over a window, optionally per day and broken down by country, device, platform or product. Spend and costs are in the account currency; null means not reported, not zero.",
-  args
-});
-function insightsHints(report) {
-  const hints = [];
-  if (report.rows.length === 0) {
-    hints.push(
-      "No delivery in this window. Check `baker ads chatgpt campaigns` for serving issues before concluding the ads do not work."
-    );
-  }
-  if (report.truncated) {
-    hints.push("More rows matched than --limit allowed. Narrow the report or raise --limit (max 2000).");
-  }
-  hints.push(
-    "Conversions come from ChatGPT Ads' own pixel or Conversions API and take at least a day to appear; the most recent days are still filling in."
-  );
-  return hints;
-}
-var insightsCommand = defineCommand({
-  meta: {
-    name: "insights",
-    description: `How a ChatGPT Ads account performs. Start here for "how are the ChatGPT campaigns doing".
-
-Examples:
-  baker ads chatgpt insights                                          # last 7 days, one row per campaign
-  baker ads chatgpt insights --days 30 --granularity daily --level account
-  baker ads chatgpt insights --campaign-id cmpn_123 --level ad --sort spend
-  baker ads chatgpt insights --segment country --metrics spend,clicks,conversions
-  baker ads chatgpt insights --since 2026-09-01 --until 2026-09-07 --metrics spend,order_created_roas`
-  },
-  args,
-  run: async ({ args: input }) => {
-    const parsed = chatgptAdsInsightsRequestSchema.safeParse(insightsRequestFromArgs(input));
-    if (!parsed.success) {
-      const message = parsed.error.issues[0]?.message ?? "Invalid report request";
-      writeJsonEnvelope({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message,
-          fix: { action: "retry_with_modified_query", explanation: message },
-          retryable: false
-        }
-      });
-      process.exit(1);
-    }
-    await runChatgptRead(
-      CHATGPT_ADS_REFERENCE.insights,
-      () => apiPost("/api/ads/chatgpt/insights", parsed.data),
-      insightsHints
-    );
-  }
-});
-export {
-  insightsCommand
-};
-//# sourceMappingURL=insights-EU45J56U.js.map