@koda-sl/baker-cli 0.25.0-dev.f89d9a60 → 0.26.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"audiences.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/audiences.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,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;gDAI+B;KAC7C;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;QAClD,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,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,yBAAyB,EAAE,MAAM,CAAC,CAAC;YAC7F,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/businesses.d.ts

@@ -0,0 +1,12 @@
+export declare const businessesCommand: import("citty").CommandDef<{
+    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=businesses.d.ts.map

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

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

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

@@ -0,0 +1,35 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError } from "./shared.js";
+export const businessesCommand = defineCommand({
+    meta: {
+        name: "businesses",
+        description: `List Meta Business Manager accounts the connected user has access to. Required for ad-studies and product-catalogs commands.
+
+Examples:
+  baker ads meta businesses`,
+    },
+    args: {
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        try {
+            const params = {};
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/businesses", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=businesses.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"businesses.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/businesses.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,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;IAC7C,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;;;4BAGW;KACzB;IACD,IAAI,EAAE;QACJ,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,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,0BAA0B,EAAE,MAAM,CAAC,CAAC;YAC9F,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/campaigns.d.ts

@@ -0,0 +1,28 @@
+export declare const campaignsCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Meta ad account ID";
+    };
+    readonly "effective-status": {
+        readonly type: "string";
+        readonly description: "Comma-separated effective_status filter (overrides default)";
+    };
+    readonly "all-statuses": {
+        readonly type: "boolean";
+        readonly description: "Drop the default ACTIVE filter and return everything";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max rows (default 1000)";
+    };
+    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=campaigns.d.ts.map

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

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

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

@@ -0,0 +1,51 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg, resolveEffectiveStatus } from "./shared.js";
+export const campaignsCommand = defineCommand({
+    meta: {
+        name: "campaigns",
+        description: `List campaigns for a Meta ad account. Defaults to ACTIVE only — pass --all-statuses to widen.
+
+In Meta's API "campaign" is the top-of-tree object (what marketers usually call a campaign group).
+The dashboard shows effective_status: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, etc.
+
+Examples:
+  baker ads meta campaigns --account-id act_123                                   # ACTIVE only
+  baker ads meta campaigns --account-id act_123 --all-statuses                    # everything
+  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE,PAUSED  # custom set
+  baker ads meta campaigns --account-id act_123 --output csv`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+        "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter and return everything" },
+        limit: { type: "string", description: "Max rows (default 1000)" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        const accountId = resolveAccountIdArg(args);
+        const effectiveStatus = resolveEffectiveStatus(args);
+        try {
+            const params = { "account-id": accountId };
+            if (effectiveStatus)
+                params["effective-status"] = effectiveStatus;
+            if (args.limit)
+                params.limit = args.limit;
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/campaigns", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=campaigns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaigns.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/campaigns.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,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;;;;;;6DAS4C;KAC1D;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;QAClH,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sDAAsD,EAAE;QACxG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACjE,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,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,eAAe;gBAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,eAAe,CAAC;YAClE,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,yBAAyB,EAAE,MAAM,CAAC,CAAC;YAC7F,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/creatives.d.ts

@@ -0,0 +1,24 @@
+export declare const creativesCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Meta ad account ID (required if no --creative-id)";
+    };
+    readonly "creative-id": {
+        readonly type: "string";
+        readonly description: "Single creative ID";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max rows (default 500)";
+    };
+    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=creatives.d.ts.map

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

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

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

@@ -0,0 +1,51 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+export const creativesCommand = defineCommand({
+    meta: {
+        name: "creatives",
+        description: `List ad creatives in an account, or fetch a single creative by ID.
+
+Important: Meta creatives are effectively immutable once attached to an ad. Editing copy/image/CTA = create
+a new creative + reattach. Bake this into any agentic edit workflow.
+
+Examples:
+  baker ads meta creatives --account-id act_123
+  baker ads meta creatives --creative-id 23842...   # fetch one`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID (required if no --creative-id)" },
+        "creative-id": { type: "string", description: "Single creative ID" },
+        limit: { type: "string", description: "Max rows (default 500)" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        try {
+            const params = {};
+            if (args["creative-id"]) {
+                params["creative-id"] = args["creative-id"];
+            }
+            else {
+                const accountId = resolveAccountIdArg(args);
+                params["account-id"] = accountId;
+            }
+            if (args.limit)
+                params.limit = args.limit;
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/creatives", params);
+            const fmt = csvOrJson(args);
+            if (Array.isArray(data) && fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=creatives.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creatives.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/creatives.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,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;;;;gEAO+C;KAC7D;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;QAClG,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACpE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QAChE,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,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAW,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;YACnC,CAAC;YACD,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAU,yBAAyB,EAAE,MAAM,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBAC1C,cAAc,CAAC,IAAsC,EAAE,GAAG,CAAC,CAAC;gBAC5D,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/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.
+ *
+ * The HTTP backend exposes more endpoints (catalogs, studies, ad-images, labels,
+ * high-demand-periods, currency lookup). They're intentionally not surfaced as
+ * CLI commands because AI agents rarely need them in isolation. Hit them via
+ * curl against the API if you need them.
+ *
+ * Default behaviors that matter:
+ *   - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.
+ *   - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.
+ *   - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).
+ *   - Heavy insights queries auto-fall to async (poll loop hidden).
+ *   - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.
+ */
+export declare const metaCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,qDAiDtB,CAAC"}

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

@@ -0,0 +1,79 @@
+import { defineCommand } from "citty";
+import { accountCommand } from "./account.js";
+import { accountsCommand } from "./accounts.js";
+import { activitiesCommand } from "./activities.js";
+import { adsListCommand } from "./ads.js";
+import { adsetsCommand } from "./adsets.js";
+import { audiencesCommand } from "./audiences.js";
+import { businessesCommand } from "./businesses.js";
+import { campaignsCommand } from "./campaigns.js";
+import { creativesCommand } from "./creatives.js";
+import { insightsCommand } from "./insights.js";
+import { pixelsCommand } from "./pixels.js";
+import { previewCommand } from "./preview.js";
+/**
+ * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.
+ *
+ * The HTTP backend exposes more endpoints (catalogs, studies, ad-images, labels,
+ * high-demand-periods, currency lookup). They're intentionally not surfaced as
+ * CLI commands because AI agents rarely need them in isolation. Hit them via
+ * curl against the API if you need them.
+ *
+ * Default behaviors that matter:
+ *   - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.
+ *   - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.
+ *   - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).
+ *   - Heavy insights queries auto-fall to async (poll loop hidden).
+ *   - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.
+ */
+export const metaCommand = defineCommand({
+    meta: {
+        name: "meta",
+        description: `Meta Marketing API — AI-first command surface (Facebook + Instagram ads).
+
+Discovery:
+  baker ads meta accounts                                — accounts in this company's connected scope
+  baker ads meta accounts --include-all                  — every account the token can see
+  baker ads meta businesses                              — Business Manager IDs
+
+Snapshot a running account (default = ACTIVE only):
+  baker ads meta campaigns --account-id act_123
+  baker ads meta adsets --campaign-id 6123
+  baker ads meta ads --adset-id 6123
+  baker ads meta campaigns --account-id act_123 --all-statuses        — include paused, archived
+
+Drill in:
+  baker ads meta account --account-id act_123                         — currency, balance, business
+  baker ads meta creatives --creative-id 9988                         — single creative detail
+  baker ads meta audiences --account-id act_123
+  baker ads meta pixels --account-id act_123                          — pixel list
+  baker ads meta pixels --pixel-id 9988 --stats --days 7              — firing health
+
+Performance (the workhorse):
+  baker ads meta insights --object act_123                                                    — defaults: level=account, intent=baseline, last_7d
+  baker ads meta insights --object act_123 --intent revenue --date-preset last_28d
+  baker ads meta insights --object act_123 --level ad --intent ranking                        — flag creatives to refresh
+  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age  — placement × age
+  baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31   — auto-async
+  baker ads meta insights --list-presets
+
+Audit & review:
+  baker ads meta activities --account-id act_123 --days 14
+  baker ads meta preview --creative-id 9988 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html`,
+    },
+    subCommands: {
+        accounts: accountsCommand,
+        account: accountCommand,
+        businesses: businessesCommand,
+        campaigns: campaignsCommand,
+        adsets: adsetsCommand,
+        ads: adsListCommand,
+        creatives: creativesCommand,
+        audiences: audiencesCommand,
+        pixels: pixelsCommand,
+        activities: activitiesCommand,
+        insights: insightsCommand,
+        preview: previewCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oGA8BmF;KACjG;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,UAAU,EAAE,iBAAiB;QAC7B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,cAAc;QACnB,SAAS,EAAE,gBAAgB;QAC3B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;KACxB;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,92 @@
+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 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwG1B,CAAC"}