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

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

@@ -0,0 +1,93 @@
+export declare const insightsCommand: import("citty").CommandDef<{
+    readonly object: {
+        readonly type: "string";
+        readonly description: "Object ID — act_<id> for account, or a campaign/adset/ad ID";
+        readonly required: true;
+    };
+    readonly level: {
+        readonly type: "string";
+        readonly description: "account|campaign|adset|ad (default: account)";
+    };
+    readonly intent: {
+        readonly type: "string";
+        readonly description: "baseline|revenue|funnel|ranking|video|identity (default: baseline)";
+    };
+    readonly fields: {
+        readonly type: "string";
+        readonly description: "Comma-separated field list (overrides --intent bundle)";
+    };
+    readonly "list-intents": {
+        readonly type: "boolean";
+        readonly description: "Print available intents and exit";
+    };
+    readonly "date-preset": {
+        readonly type: "string";
+        readonly description: "Meta date preset (last_7d, last_28d, today, ...)";
+    };
+    readonly since: {
+        readonly type: "string";
+        readonly description: "Custom start date YYYY-MM-DD";
+    };
+    readonly until: {
+        readonly type: "string";
+        readonly description: "Custom end date YYYY-MM-DD";
+    };
+    readonly "time-increment": {
+        readonly type: "string";
+        readonly description: "1 (day) | monthly | all_days";
+    };
+    readonly breakdowns: {
+        readonly type: "string";
+        readonly description: "Comma-separated breakdowns (e.g. publisher_platform,age)";
+    };
+    readonly "action-breakdowns": {
+        readonly type: "string";
+        readonly description: "Slice the actions[] array (default: action_type for revenue/funnel)";
+    };
+    readonly filtering: {
+        readonly type: "string";
+        readonly description: "Override default filter — JSON array of {field,operator,value}";
+    };
+    readonly "include-undelivered": {
+        readonly type: "boolean";
+        readonly description: "Keep rows where impressions=0 (off by default)";
+    };
+    readonly "attribution-windows": {
+        readonly type: "string";
+        readonly description: "Override default 7d_click,1d_view (only 1d_view, 1d_click, 7d_click, 28d_click work post Jan 2026)";
+    };
+    readonly "use-account-attribution": {
+        readonly type: "boolean";
+        readonly description: "Use account-saved attribution setting";
+    };
+    readonly "use-unified-attribution": {
+        readonly type: "boolean";
+        readonly description: "Use ad-set unified attribution setting";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max rows (default 1000)";
+    };
+    readonly async: {
+        readonly type: "boolean";
+        readonly description: "Force async submit-and-poll path";
+    };
+    readonly "no-async": {
+        readonly type: "boolean";
+        readonly description: "Refuse the auto-async fallback for heavy queries";
+    };
+    readonly "no-sort": {
+        readonly type: "boolean";
+        readonly description: "Skip default spend-desc sort";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=insights.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"AAwLA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiG1B,CAAC"}

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

@@ -0,0 +1,254 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.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;
+    return input
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function parseFiltering(raw) {
+    if (!raw)
+        return undefined;
+    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;
+}
+/**
+ * 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 false;
+}
+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 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"]) ?? 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) : 1000,
+        skipCache: Boolean(args["skip-cache"]),
+    };
+    applyDateRange(body, args);
+    return body;
+}
+async function pollAsync(reportRunId) {
+    const start = Date.now();
+    while (Date.now() - start < POLL_MAX_MS) {
+        const status = await apiPost(`/api/ads/meta/insights/async/status?report-run-id=${encodeURIComponent(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)}%)…\n`);
+        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}\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: `Performance reporting — 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 — 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 a campaign/adset/ad ID",
+            required: true,
+        },
+        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 — 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)" },
+        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-intents"]) {
+            writeAdsJson({ ok: true, data: listIntents() });
+            return;
+        }
+        const body = buildBody(args);
+        const fmt = csvOrJson(args);
+        const wantAsync = Boolean(args.async) || (!args["no-async"] && shouldAutoAsync(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;
+            }
+            writeAdsJson({ ok: true, data: sorted });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=insights.js.map

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

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

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

@@ -0,0 +1,16 @@
+export declare const labelsCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Meta ad account ID";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/labels.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;EA0BxB,CAAC"}

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

@@ -0,0 +1,34 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+export const labelsCommand = defineCommand({
+    meta: {
+        name: "labels",
+        description: `List ad labels for a Meta ad account.`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        const accountId = resolveAccountIdArg(args);
+        try {
+            const params = { "account-id": accountId };
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/labels", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=labels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uCAAuC;KACrD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,sBAAsB,EAAE,MAAM,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,33 @@
+export declare const pixelsCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Meta ad account ID";
+    };
+    readonly "pixel-id": {
+        readonly type: "string";
+        readonly description: "Pixel ID for --stats";
+    };
+    readonly stats: {
+        readonly type: "boolean";
+        readonly description: "Fetch firing stats for the pixel";
+    };
+    readonly aggregation: {
+        readonly type: "string";
+        readonly description: "stats aggregation: event|browser_type|host|pixel_fire";
+        readonly default: "event";
+    };
+    readonly days: {
+        readonly type: "string";
+        readonly description: "Lookback days for --stats (default 7)";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=pixels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pixels.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/pixels.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DxB,CAAC"}

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

@@ -0,0 +1,69 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, daysAgoIso, handleMetaError, resolveAccountIdArg, todayIso } from "./shared.js";
+export const pixelsCommand = defineCommand({
+    meta: {
+        name: "pixels",
+        description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.
+
+Examples:
+  baker ads meta pixels --account-id act_123
+  baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        "pixel-id": { type: "string", description: "Pixel ID for --stats" },
+        stats: { type: "boolean", description: "Fetch firing stats for the pixel" },
+        aggregation: {
+            type: "string",
+            description: "stats aggregation: event|browser_type|host|pixel_fire",
+            default: "event",
+        },
+        days: { type: "string", description: "Lookback days for --stats (default 7)" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        try {
+            if (args.stats) {
+                const pixelId = args["pixel-id"];
+                if (!pixelId) {
+                    handleMetaError(new Error("--pixel-id is required when --stats is set"));
+                }
+                const days = args.days ? Number(args.days) : 7;
+                const params = {
+                    "pixel-id": pixelId,
+                    aggregation: args.aggregation ?? "event",
+                    "start-time": daysAgoIso(days),
+                    "end-time": todayIso(),
+                };
+                if (args["skip-cache"])
+                    params["skip-cache"] = "true";
+                const data = await apiGet("/api/ads/meta/pixel-stats", params);
+                const fmt = csvOrJson(args);
+                if (fmt !== "json") {
+                    writeAdsOutput(data, fmt);
+                    return;
+                }
+                writeAdsJson({ ok: true, data });
+                return;
+            }
+            const accountId = resolveAccountIdArg(args);
+            const params = { "account-id": accountId };
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/pixels", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=pixels.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * 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 type InsightsLevel = "account" | "campaign" | "adset" | "ad";
+export type InsightsIntent = "baseline" | "revenue" | "funnel" | "ranking" | "video" | "identity";
+interface IntentDefinition {
+    name: InsightsIntent;
+    description: string;
+    fields: string[];
+    /** Action breakdowns to slice the actions[] array — empty if not needed. */
+    actionBreakdowns?: string[];
+}
+/** 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

@@ -0,0 +1 @@
+{"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"}