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

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,24 @@
+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";
+    };
+    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;;;;;;;;;;;;;;;;;;;;;;EAsC3B,CAAC"}

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

@@ -0,0 +1,48 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+export const campaignsCommand = defineCommand({
+    meta: {
+        name: "campaigns",
+        description: `List campaigns for a Meta ad account.
+
+Note: in Meta's API, "campaign" is what we'd call a campaign group. Status uses effective_status (filterable),
+which can be ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, etc.
+
+Examples:
+  baker ads meta campaigns --account-id act_123
+  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE,PAUSED
+  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" },
+        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);
+        try {
+            const params = { "account-id": accountId };
+            if (args["effective-status"])
+                params["effective-status"] = args["effective-status"];
+            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,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;;;;;6DAQ4C;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,yCAAyC,EAAE;QAC9F,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,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,kBAAkB,CAAC;gBAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAW,CAAC;YAC9F,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/catalogs.d.ts

@@ -0,0 +1,17 @@
+export declare const catalogsCommand: import("citty").CommandDef<{
+    readonly "business-id": {
+        readonly type: "string";
+        readonly description: "Meta Business Manager ID";
+        readonly required: true;
+    };
+    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=catalogs.d.ts.map

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

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

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

@@ -0,0 +1,37 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError } from "./shared.js";
+export const catalogsCommand = defineCommand({
+    meta: {
+        name: "catalogs",
+        description: `List product catalogs owned by a Meta Business. Vertical (commerce, hotels, vehicles, etc.)
+is immutable once set.
+
+Examples:
+  baker ads meta catalogs --business-id 1234567890`,
+    },
+    args: {
+        "business-id": { type: "string", description: "Meta Business Manager ID", required: true },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        try {
+            const params = { "business-id": args["business-id"] };
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/catalogs", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=catalogs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalogs.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/catalogs.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,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;mDAIkC;KAChD;IACD,IAAI,EAAE;QACJ,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1F,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,aAAa,EAAE,IAAI,CAAC,aAAa,CAAW,EAAE,CAAC;YACxF,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,wBAAwB,EAAE,MAAM,CAAC,CAAC;YAC5F,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/currency.d.ts

@@ -0,0 +1,11 @@
+export declare const currencyCommand: 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";
+    };
+}>;
+//# sourceMappingURL=currency.d.ts.map

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

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

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

@@ -0,0 +1,31 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson } from "../output.js";
+import { handleMetaError, resolveAccountIdArg } from "./shared.js";
+export const currencyCommand = defineCommand({
+    meta: {
+        name: "currency",
+        description: `Lookup the currency + timezone for a Meta ad account. Lightweight wrapper around the account detail endpoint, cached 1 day.
+
+Examples:
+  baker ads meta currency --account-id act_123`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+    },
+    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/currency", params);
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=currency.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/currency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;+CAG8B;KAC5C;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;KAC3E;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,CACvB,wBAAwB,EACxB,MAAM,CACP,CAAC;YACF,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/high-demand-periods.d.ts

@@ -0,0 +1,17 @@
+export declare const highDemandPeriodsCommand: import("citty").CommandDef<{
+    readonly "campaign-id": {
+        readonly type: "string";
+        readonly description: "Meta campaign ID";
+        readonly required: true;
+    };
+    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=high-demand-periods.d.ts.map

package/dist/commands/ads/meta/high-demand-periods.d.ts.map

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

package/dist/commands/ads/meta/high-demand-periods.js

@@ -0,0 +1,33 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError } from "./shared.js";
+export const highDemandPeriodsCommand = defineCommand({
+    meta: {
+        name: "high-demand-periods",
+        description: `List scheduled budget bumps (e.g. Black Friday windows) on a campaign.`,
+    },
+    args: {
+        "campaign-id": { type: "string", description: "Meta campaign ID", required: true },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        try {
+            const params = { "campaign-id": args["campaign-id"] };
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/high-demand-periods", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=high-demand-periods.js.map

package/dist/commands/ads/meta/high-demand-periods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"high-demand-periods.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/high-demand-periods.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,wBAAwB,GAAG,aAAa,CAAC;IACpD,IAAI,EAAE;QACJ,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,wEAAwE;KACtF;IACD,IAAI,EAAE;QACJ,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;QAClF,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,aAAa,EAAE,IAAI,CAAC,aAAa,CAAW,EAAE,CAAC;YACxF,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,mCAAmC,EAAE,MAAM,CAAC,CAAC;YACvG,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/images.d.ts

@@ -0,0 +1,24 @@
+export declare const imagesCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Meta ad account ID";
+    };
+    readonly hash: {
+        readonly type: "string";
+        readonly description: "Filter to one image hash";
+    };
+    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=images.d.ts.map

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

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

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

@@ -0,0 +1,45 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+export const imagesCommand = defineCommand({
+    meta: {
+        name: "images",
+        description: `List ad images in a Meta ad account. AdImages are keyed by per-account hash — references in
+creatives use image_hash, not URL.
+
+Examples:
+  baker ads meta images --account-id act_123
+  baker ads meta images --account-id act_123 --hash a1b2c3...`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        hash: { type: "string", description: "Filter to one image hash" },
+        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 }) => {
+        const accountId = resolveAccountIdArg(args);
+        try {
+            const params = { "account-id": accountId };
+            if (args.hash)
+                params.hash = args.hash;
+            if (args.limit)
+                params.limit = args.limit;
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/images", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=images.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/images.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;;;;;8DAK6C;KAC3D;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;QACjE,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,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,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjD,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,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/index.d.ts

@@ -0,0 +1,2 @@
+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":"AAoBA,eAAO,MAAM,WAAW,qDAuDtB,CAAC"}

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

@@ -0,0 +1,76 @@
+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 { catalogsCommand } from "./catalogs.js";
+import { creativesCommand } from "./creatives.js";
+import { currencyCommand } from "./currency.js";
+import { highDemandPeriodsCommand } from "./high-demand-periods.js";
+import { imagesCommand } from "./images.js";
+import { insightsCommand } from "./insights.js";
+import { labelsCommand } from "./labels.js";
+import { pixelsCommand } from "./pixels.js";
+import { previewCommand } from "./preview.js";
+import { studiesCommand } from "./studies.js";
+export const metaCommand = defineCommand({
+    meta: {
+        name: "meta",
+        description: `Meta Marketing API (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
+
+Account-scoped:
+  baker ads meta account --account-id act_123
+  baker ads meta currency --account-id act_123
+  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE
+  baker ads meta adsets --campaign-id 6123
+  baker ads meta ads --account-id act_123 --effective-status ACTIVE
+  baker ads meta creatives --account-id act_123
+  baker ads meta images --account-id act_123
+  baker ads meta labels --account-id act_123
+  baker ads meta audiences --account-id act_123
+  baker ads meta pixels --account-id act_123
+  baker ads meta activities --account-id act_123 --days 14
+
+Insights + previews:
+  baker ads meta insights --object act_123 --preset campaign-performance
+  baker ads meta insights --object act_123 --preset placement-breakdown --async
+  baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html
+
+Business-scoped:
+  baker ads meta studies --business-id 12345
+  baker ads meta catalogs --business-id 12345
+
+Other:
+  baker ads meta high-demand-periods --campaign-id 6123`,
+    },
+    subCommands: {
+        accounts: accountsCommand,
+        account: accountCommand,
+        currency: currencyCommand,
+        businesses: businessesCommand,
+        campaigns: campaignsCommand,
+        adsets: adsetsCommand,
+        ads: adsListCommand,
+        creatives: creativesCommand,
+        images: imagesCommand,
+        labels: labelsCommand,
+        audiences: audiencesCommand,
+        pixels: pixelsCommand,
+        studies: studiesCommand,
+        catalogs: catalogsCommand,
+        "high-demand-periods": highDemandPeriodsCommand,
+        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,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDA8BuC;KACrD;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,iBAAiB;QAC7B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,cAAc;QACnB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,eAAe;QACzB,qBAAqB,EAAE,wBAAwB;QAC/C,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,81 @@
+export declare const insightsCommand: import("citty").CommandDef<{
+    readonly object: {
+        readonly type: "string";
+        readonly description: "Object ID — act_<id> for account, or campaign/adset/ad ID";
+        readonly required: true;
+    };
+    readonly level: {
+        readonly type: "string";
+        readonly description: "account|campaign|adset|ad";
+    };
+    readonly fields: {
+        readonly type: "string";
+        readonly description: "Comma-separated fields list";
+    };
+    readonly preset: {
+        readonly type: "string";
+        readonly description: "Insights preset name";
+    };
+    readonly "list-presets": {
+        readonly type: "boolean";
+        readonly description: "List available presets 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";
+    };
+    readonly "action-breakdowns": {
+        readonly type: "string";
+        readonly description: "Comma-separated action_breakdowns";
+    };
+    readonly filtering: {
+        readonly type: "string";
+        readonly description: "JSON array of {field,operator,value}";
+    };
+    readonly "attribution-windows": {
+        readonly type: "string";
+        readonly description: "Comma-separated. Only 1d_view, 1d_click, 7d_click, 28d_click work as of 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 per preset)";
+    };
+    readonly async: {
+        readonly type: "boolean";
+        readonly description: "Submit as async job, poll, then dump results";
+    };
+    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