@koda-sl/baker-cli 0.24.0-dev.55a07065 → 0.25.0-dev.55a07065

package/dist/commands/ads/meta/insights.js

@@ -1,10 +1,14 @@
 import { defineCommand } from "citty";
 import { apiPost } from "../../../client.js";
 import { writeAdsJson, writeAdsOutput } from "../output.js";
-import { getPreset, listPresets } from "./presets.js";
+import { composeFields, getIntent, listIntents } from "./presets.js";
 import { csvOrJson, getDateRange, handleMetaError } from "./shared.js";
 const POLL_INTERVAL_MS = 5_000;
 const POLL_MAX_MS = 10 * 60_000;
+/** Default attribution windows — only these still work as of Jan 2026 (1d_view + 28d_click also valid but rarely used). */
+const DEFAULT_ATTRIBUTION_WINDOWS = ["7d_click", "1d_view"];
+/** Default filter — strip rows that didn't deliver. Almost always what we want. */
+const DEFAULT_FILTERING = [{ field: "impressions", operator: "GREATER_THAN", value: 0 }];
 function commaSplit(input) {
     if (!input)
         return undefined;
@@ -23,21 +27,50 @@ function parseFiltering(raw) {
         handleMetaError(new Error("Invalid --filtering JSON"));
     }
 }
-function pickLevel(args, preset) {
-    const level = args.level ?? preset?.level;
-    if (!level) {
-        handleMetaError(new Error("--level is required (account|campaign|adset|ad)"));
+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 level;
+    return found.name;
 }
-function pickFields(fieldsArg, preset) {
-    const fields = fieldsArg ?? preset?.fields;
-    if (!fields || fields.length === 0) {
-        handleMetaError(new Error("--fields is required (comma-separated, e.g. impressions,spend,ctr)"));
+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;
+}
+/**
+ * Auto-async heuristic. Heavy queries that would time out as sync go async
+ * automatically — the user shouldn't have to think about it.
+ *
+ *   - level=ad with breakdowns
+ *   - >2 breakdowns at any level
+ *   - explicit time range > 90 days
+ *   - level=ad over an account-level object with a wide window
+ */
+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)) / 86_400_000;
+        if (days > 90) {
+            return true;
+        }
     }
-    return fields;
+    return false;
 }
-function applyDateRange(body, args, preset) {
+function applyDateRange(body, args) {
     const range = getDateRange(args);
     if (range.datePreset)
         body.datePreset = range.datePreset;
@@ -46,29 +79,46 @@ function applyDateRange(body, args, preset) {
     if (range.until)
         body.until = range.until;
     if (!body.datePreset && !(body.since && body.until)) {
-        body.datePreset = preset?.defaultDatePreset ?? "last_7d";
+        body.datePreset = "last_7d";
     }
 }
-function buildBodyFromArgs(args, preset) {
-    const fieldsArg = commaSplit(args.fields);
+function buildFiltering(args) {
+    const explicit = parseFiltering(args.filtering);
+    if (explicit)
+        return explicit;
+    if (args["include-undelivered"])
+        return undefined;
+    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"]);
-    const attributionWindows = commaSplit(args["attribution-windows"]);
+    const actionBreakdowns = commaSplit(args["action-breakdowns"]) ?? intentDef?.actionBreakdowns;
     const body = {
         object: args.object,
-        level: pickLevel(args, preset),
-        fields: pickFields(fieldsArg, preset),
+        level,
+        fields,
         timeIncrement: args["time-increment"],
-        breakdowns: breakdowns ?? preset?.breakdowns,
-        actionBreakdowns: actionBreakdowns ?? preset?.actionBreakdowns,
-        filtering: parseFiltering(args.filtering),
-        attributionWindows: attributionWindows ?? preset?.attributionWindows,
+        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) : preset?.defaultLimit,
+        limit: args.limit ? Number(args.limit) : 1000,
         skipCache: Boolean(args["skip-cache"]),
     };
-    applyDateRange(body, args, preset);
+    applyDateRange(body, args);
     return body;
 }
 async function pollAsync(reportRunId) {
@@ -85,90 +135,116 @@ async function pollAsync(reportRunId) {
     }
     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}\n`);
+    await pollAsync(submit.reportRunId);
+    return apiPost("/api/ads/meta/insights/async/result", {
+        reportRunId: submit.reportRunId,
+        fields: body.fields,
+        limit: body.limit,
+    });
+}
+/** Insights rows have nested `actions[]` arrays. Sort by the named action_type's value descending. */
+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;
+    });
+}
 export const insightsCommand = defineCommand({
     meta: {
         name: "insights",
-        description: `Run Meta Marketing API insights queries.
+        description: `Performance reporting — the main Meta tool for AI agents.
 
-Synchronous unless --async is set, or auto-fallback if Meta returns a "too large" error.
-Use presets for the marketing team's standard reports.
+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.)
 
-Presets (run with --preset <name>):
-${listPresets()
-            .map((p) => `  ${p.name}  — ${p.description}`)
-            .join("\n")}
+Identity fields (campaign_name, ad_name etc.) are appended automatically based on --level so rows
+are self-describing.
 
-Examples:
-  baker ads meta insights --object act_123 --level ad --fields impressions,spend --date-preset last_7d
-  baker ads meta insights --object 6123456 --preset campaign-performance
-  baker ads meta insights --object act_123 --preset placement-breakdown --since 2026-01-01 --until 2026-03-31 --async
-  baker ads meta insights --object act_123 --level ad --fields ad_id,impressions \\
-    --filtering '[{"field":"spend","operator":"GREATER_THAN","value":0}]'`,
+Examples — 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 — act_<id> for account, or campaign/adset/ad ID",
+            description: "Object ID — act_<id> for account, or a campaign/adset/ad ID",
             required: true,
         },
-        level: { type: "string", description: "account|campaign|adset|ad" },
-        fields: { type: "string", description: "Comma-separated fields list" },
-        preset: { type: "string", description: "Insights preset name" },
-        "list-presets": { type: "boolean", description: "List available presets and exit" },
+        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" },
-        "action-breakdowns": { type: "string", description: "Comma-separated action_breakdowns" },
-        filtering: { type: "string", description: "JSON array of {field,operator,value}" },
+        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 — JSON array of {field,operator,value}" },
+        "include-undelivered": { type: "boolean", description: "Keep rows where impressions=0 (off by default)" },
         "attribution-windows": {
             type: "string",
-            description: "Comma-separated. Only 1d_view, 1d_click, 7d_click, 28d_click work as of Jan 2026",
+            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 per preset)" },
-        async: { type: "boolean", description: "Submit as async job, poll, then dump results" },
+        limit: { type: "string", description: "Max rows (default 1000)" },
+        async: { type: "boolean", description: "Force async submit-and-poll path" },
+        "no-async": { type: "boolean", description: "Refuse the auto-async fallback for heavy queries" },
+        "no-sort": { type: "boolean", description: "Skip default spend-desc sort" },
         "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
         output: { type: "string", description: "Output format", default: "json" },
     },
     run: async ({ args }) => {
-        if (args["list-presets"]) {
-            writeAdsJson({ ok: true, data: listPresets() });
+        if (args["list-intents"]) {
+            writeAdsJson({ ok: true, data: listIntents() });
             return;
         }
-        const presetName = args.preset;
-        const preset = presetName ? getPreset(presetName) : undefined;
-        if (presetName && !preset) {
-            handleMetaError(new Error(`Unknown preset: ${presetName}. Use --list-presets.`));
-        }
-        const body = buildBodyFromArgs(args, preset);
+        const body = buildBody(args);
+        const fmt = csvOrJson(args);
+        const wantAsync = Boolean(args.async) || (!args["no-async"] && shouldAutoAsync(body));
         try {
-            if (args.async) {
-                const submit = await apiPost("/api/ads/meta/insights/async", body);
-                process.stderr.write(`Submitted async insights job: ${submit.reportRunId}\n`);
-                await pollAsync(submit.reportRunId);
-                const result = await apiPost("/api/ads/meta/insights/async/result", {
-                    reportRunId: submit.reportRunId,
-                    fields: body.fields,
-                    limit: body.limit,
-                });
-                const fmt = csvOrJson(args);
-                if (fmt !== "json") {
-                    writeAdsOutput(result, fmt, body.fields);
-                    return;
-                }
-                writeAdsJson({ ok: true, data: result });
-                return;
-            }
-            const data = await apiPost("/api/ads/meta/insights", body);
-            const fmt = csvOrJson(args);
+            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(data, fmt, body.fields);
+                writeAdsOutput(sorted, fmt, body.fields);
                 return;
             }
-            writeAdsJson({ ok: true, data });
+            writeAdsJson({ ok: true, data: sorted });
         }
         catch (err) {
             handleMetaError(err);

package/dist/commands/ads/meta/insights.js.map

@@ -1 +1 @@
-{"version":3,"file":"insights.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"insights.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"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"}

package/dist/commands/ads/meta/presets.d.ts

@@ -1,18 +1,30 @@
 /**
- * Meta-native insights presets. Names + fields chosen for our marketing team's
- * review workflows — not parity-aligned with the Google Ads presets.
+ * Insights field bundles. Picked for AI agent ergonomics: small, focused field
+ * lists that answer one specific question without forcing the AI to enumerate
+ * Meta's 500+ insights fields.
+ *
+ * Two-axis design:
+ *   --intent (field bundle, default: baseline)   — what data to ask for
+ *   --level  (object granularity, default: account) — at what granularity
+ *
+ * Intents are independent of level — pass `--intent ranking --level ad` to flag
+ * creatives, or `--intent revenue --level campaign` for ROAS by campaign.
+ *
+ * Identity fields (campaign_name etc.) are appended automatically based on
+ * level so the AI can read rows without joining.
  */
-export interface MetaInsightsPreset {
-    name: string;
+export type InsightsLevel = "account" | "campaign" | "adset" | "ad";
+export type InsightsIntent = "baseline" | "revenue" | "funnel" | "ranking" | "video" | "identity";
+interface IntentDefinition {
+    name: InsightsIntent;
     description: string;
-    level: "account" | "campaign" | "adset" | "ad";
     fields: string[];
-    breakdowns?: string[];
+    /** Action breakdowns to slice the actions[] array — empty if not needed. */
     actionBreakdowns?: string[];
-    attributionWindows?: string[];
-    defaultDatePreset: string;
-    defaultLimit: number;
 }
-export declare function getPreset(name: string): MetaInsightsPreset | undefined;
-export declare function listPresets(): MetaInsightsPreset[];
+/** Compose final field list: intent metrics + level-specific identity fields, deduplicated. */
+export declare function composeFields(intent: InsightsIntent, level: InsightsLevel): string[];
+export declare function getIntent(name: string): IntentDefinition | undefined;
+export declare function listIntents(): IntentDefinition[];
+export {};
 //# sourceMappingURL=presets.d.ts.map

package/dist/commands/ads/meta/presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/presets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAsGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtE;AAED,wBAAgB,WAAW,IAAI,kBAAkB,EAAE,CAElD"}
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAElG,UAAU,gBAAgB;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAsDD,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAYpF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEpE;AAED,wBAAgB,WAAW,IAAI,gBAAgB,EAAE,CAEhD"}

package/dist/commands/ads/meta/presets.js

@@ -1,92 +1,45 @@
 /**
- * Meta-native insights presets. Names + fields chosen for our marketing team's
- * review workflows — not parity-aligned with the Google Ads presets.
+ * Insights field bundles. Picked for AI agent ergonomics: small, focused field
+ * lists that answer one specific question without forcing the AI to enumerate
+ * Meta's 500+ insights fields.
+ *
+ * Two-axis design:
+ *   --intent (field bundle, default: baseline)   — what data to ask for
+ *   --level  (object granularity, default: account) — at what granularity
+ *
+ * Intents are independent of level — pass `--intent ranking --level ad` to flag
+ * creatives, or `--intent revenue --level campaign` for ROAS by campaign.
+ *
+ * Identity fields (campaign_name etc.) are appended automatically based on
+ * level so the AI can read rows without joining.
  */
-const META_INSIGHTS_PRESETS = {
-    "campaign-performance": {
-        name: "campaign-performance",
-        description: "Per-campaign spend, ROAS, and purchase metrics over the last 7 days.",
-        level: "campaign",
-        fields: [
-            "campaign_id",
-            "campaign_name",
-            "objective",
-            "impressions",
-            "spend",
-            "clicks",
-            "ctr",
-            "cpc",
-            "actions",
-            "action_values",
-            "purchase_roas",
-        ],
-        actionBreakdowns: ["action_type"],
-        defaultDatePreset: "last_7d",
-        defaultLimit: 1000,
+const 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"],
     },
-    "creative-performance": {
-        name: "creative-performance",
-        description: "Per-ad ranking + delivery quality. Use to flag creatives for refresh.",
-        level: "ad",
-        fields: [
-            "ad_id",
-            "ad_name",
-            "campaign_name",
-            "adset_name",
-            "impressions",
-            "spend",
-            "ctr",
-            "cpc",
-            "quality_ranking",
-            "engagement_rate_ranking",
-            "conversion_rate_ranking",
-        ],
-        defaultDatePreset: "last_7d",
-        defaultLimit: 2000,
-    },
-    "placement-breakdown": {
-        name: "placement-breakdown",
-        description: "Spend & CPM by Facebook/Instagram placement and device.",
-        level: "adset",
-        fields: ["adset_id", "adset_name", "impressions", "spend", "ctr", "cpm", "actions"],
-        breakdowns: ["publisher_platform", "platform_position", "impression_device"],
-        defaultDatePreset: "last_14d",
-        defaultLimit: 5000,
-    },
-    "device-breakdown": {
-        name: "device-breakdown",
-        description: "Conversion performance by device + OS.",
-        level: "ad",
-        fields: ["ad_id", "ad_name", "impressions", "clicks", "spend", "actions", "purchase_roas"],
-        breakdowns: ["device_platform", "impression_device"],
-        defaultDatePreset: "last_7d",
-        defaultLimit: 5000,
-    },
-    "audience-breakdown": {
-        name: "audience-breakdown",
-        description: "Demographic split (age/gender/country) at adset level.",
-        level: "adset",
-        fields: ["adset_id", "adset_name", "impressions", "spend", "actions"],
-        breakdowns: ["age", "gender", "country"],
-        defaultDatePreset: "last_28d",
-        defaultLimit: 10000,
+    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 → click → landing page view → lead/purchase funnel.",
-        level: "ad",
-        fields: ["ad_id", "ad_name", "impressions", "clicks", "inline_link_clicks", "actions", "action_values", "spend"],
+        description: "Impression → click → landing page → action. 'Where do users drop off?'",
+        fields: ["impressions", "clicks", "inline_link_clicks", "outbound_clicks", "actions", "spend"],
         actionBreakdowns: ["action_type"],
-        defaultDatePreset: "last_7d",
-        defaultLimit: 2000,
     },
-    "video-performance": {
-        name: "video-performance",
-        description: "Video watch funnel and per-thruplay cost.",
-        level: "ad",
+    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: [
-            "ad_id",
-            "ad_name",
             "impressions",
             "spend",
             "video_play_actions",
@@ -97,14 +50,37 @@ const META_INSIGHTS_PRESETS = {
             "video_thruplay_watched_actions",
             "cost_per_thruplay",
         ],
-        defaultDatePreset: "last_14d",
-        defaultLimit: 2000,
+    },
+    identity: {
+        name: "identity",
+        description: "Just the names + spend — for cheap roll-up summaries.",
+        fields: ["spend", "impressions"],
     },
 };
-export function getPreset(name) {
-    return META_INSIGHTS_PRESETS[name];
+const 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"],
+};
+/** Compose final field list: intent metrics + level-specific identity fields, deduplicated. */
+export function composeFields(intent, level) {
+    const intentFields = INSIGHTS_INTENTS[intent].fields;
+    const identity = IDENTITY_FIELDS_BY_LEVEL[level];
+    const seen = new Set();
+    const out = [];
+    for (const f of [...identity, ...intentFields]) {
+        if (!seen.has(f)) {
+            seen.add(f);
+            out.push(f);
+        }
+    }
+    return out;
+}
+export function getIntent(name) {
+    return INSIGHTS_INTENTS[name];
 }
-export function listPresets() {
-    return Object.values(META_INSIGHTS_PRESETS);
+export function listIntents() {
+    return Object.values(INSIGHTS_INTENTS);
 }
 //# sourceMappingURL=presets.js.map

package/dist/commands/ads/meta/presets.js.map

@@ -1 +1 @@
-{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/presets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,MAAM,gBAAgB,GAA6C;IACjE,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,qFAAqF;QAClG,MAAM,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;KACtF;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,mFAAmF;QAChG,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,CAAC;QAClG,gBAAgB,EAAE,CAAC,aAAa,CAAC;KAClC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wEAAwE;QACrF,MAAM,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,CAAC;QAC9F,gBAAgB,EAAE,CAAC,aAAa,CAAC;KAClC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,kFAAkF;QAC/F,MAAM,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,yBAAyB,CAAC;KACjH;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,2EAA2E;QACxF,MAAM,EAAE;YACN,aAAa;YACb,OAAO;YACP,oBAAoB;YACpB,2BAA2B;YAC3B,2BAA2B;YAC3B,2BAA2B;YAC3B,4BAA4B;YAC5B,gCAAgC;YAChC,mBAAmB;SACpB;KACF;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,uDAAuD;QACpE,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;KACjC;CACF,CAAC;AAEF,MAAM,wBAAwB,GAAoC;IAChE,OAAO,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,kBAAkB,CAAC;IAC3D,QAAQ,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,WAAW,CAAC;IACvD,KAAK,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,CAAC;IACjE,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,CAAC;CACnF,CAAC;AAEF,+FAA+F;AAC/F,MAAM,UAAU,aAAa,CAAC,MAAsB,EAAE,KAAoB;IACxE,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,gBAAgB,CAAC,IAAsB,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACzC,CAAC"}

package/dist/commands/ads/meta/shared.d.ts

@@ -9,4 +9,10 @@ export declare function getDateRange(args: Record<string, unknown>): {
 export declare function todayIso(): string;
 export declare function daysAgoIso(days: number): string;
 export declare function csvOrJson(args: Record<string, unknown>): string;
+/**
+ * Default to ACTIVE-only on listings — that's almost always what an AI agent or
+ * a human glance wants. Pass `--effective-status ACTIVE,PAUSED` to override, or
+ * `--all-statuses` to drop the filter entirely.
+ */
+export declare function resolveEffectiveStatus(args: Record<string, unknown>): string | undefined;
 //# sourceMappingURL=shared.d.ts.map

package/dist/commands/ads/meta/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/shared.ts"],"names":[],"mappings":"AAQA,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAmBnD;AAED,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAczE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAMnH;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE/D"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/shared.ts"],"names":[],"mappings":"AAQA,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAmBnD;AAED,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAczE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAMnH;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CASxF"}