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

package/README.md

@@ -688,6 +688,102 @@ All errors include a `fix` object with `action`, `correctedCommand` (when applic
 
 ---
 
+### Meta Ads (`baker ads meta`)
+
+Meta Marketing API (Facebook + Instagram). Connect via OAuth in the dashboard, pick which ad accounts to scope to, then call from the CLI. Account ID via `--account-id act_123` or `BAKER_META_AD_ACCOUNT_ID` env var.
+
+The command surface is **curated for AI agents**, not 1:1 with the Marketing API. Smart defaults so an agent doesn't need to remember every flag.
+
+#### Common AI questions, mapped to commands
+
+```bash
+# "How is account X 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
+
+# "Why did spend drop yesterday?"
+baker ads meta activities --account-id act_123 --days 7
+
+# "What are we running right now?"
+baker ads meta campaigns --account-id act_123                        # ACTIVE only by default
+baker ads meta ads --account-id act_123 --all-statuses               # widen to everything
+
+# "Tell me about ad 9988"
+baker ads meta creatives --creative-id 9988
+baker ads meta preview --creative-id 9988 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html
+
+# "What audience is this targeting?"
+baker ads meta audiences --account-id act_123
+
+# "Is the pixel firing?"
+baker ads meta pixels --account-id act_123
+baker ads meta pixels --pixel-id 9988 --stats --days 7
+```
+
+#### Smart defaults (so agents don't enumerate the API)
+
+**`insights`** — the workhorse:
+- `--level account` (override: `campaign|adset|ad`)
+- `--intent baseline` field bundle. Intents available: `baseline`, `revenue`, `funnel`, `ranking`, `video`, `identity`. List with `--list-intents`.
+- `--date-preset last_7d` unless you pass `--since`/`--until`.
+- Filter: `impressions > 0` so undelivered rows don't pollute results. Pass `--include-undelivered` to keep them.
+- Sort: `spend` descending — highest-impact rows first. `--no-sort` to disable.
+- Attribution windows: `7d_click, 1d_view` (only `1d_view, 1d_click, 7d_click, 28d_click` work post Jan 2026).
+- Identity columns (`campaign_name`, `ad_name`, etc.) appended automatically per `--level` so rows are self-describing.
+- Auto-async when the query is heavy (level=ad with breakdowns over an account, >2 breakdowns, >90-day range). Pass `--async` to force it or `--no-async` to refuse fallback.
+
+**Listings (`campaigns`/`adsets`/`ads`)** default to `effective_status=ACTIVE` — pass `--all-statuses` to widen, or `--effective-status ACTIVE,PAUSED` for a custom set.
+
+**Pagination** is auto-drained (no manual cursor handling).
+
+#### Full command surface
+
+```
+accounts            # ad accounts in the connected scope
+accounts --include-all   # every account the token can see (admin/debug)
+account             # single-account detail (currency, balance, business, status)
+businesses          # /me/businesses
+campaigns           # ACTIVE-only by default
+adsets              # filter by --campaign-id
+ads                 # filter by --adset-id or --campaign-id
+creatives           # list per account, or fetch single via --creative-id
+audiences           # custom audiences (incl. lookalikes)
+pixels              # list, or --stats for one --pixel-id
+activities          # account audit log, ~90d retention
+insights            # see "Smart defaults" above
+preview             # iframe HTML for a creative or ad in a given ad_format
+```
+
+The HTTP backend exposes more endpoints (catalogs, ad-studies, ad-images, labels, high-demand-periods, raw currency lookup). They're intentionally not surfaced as CLI commands because AI agents rarely need them. Hit them via curl against `/api/ads/meta/*` if needed.
+
+#### Auth + caching
+
+- Tokens auto-refresh server-side (60-day rolling long-lived user tokens). On `code 190` reconnect Meta from the dashboard.
+- Account scoping: backend rejects any call against an account not in the picker selection — pick accounts via Settings → Connections → Meta Ads first.
+- All cached actions are keyed per company; two companies that connect to the same Meta account never share cache entries.
+- `--skip-cache` on any command forces a re-fetch.
+
+#### Notes / gotchas
+
+- `spend` is a decimal string in account currency, not an integer.
+- `effective_status` ≠ `status`. The dashboard shows effective_status (e.g. `WITH_ISSUES`, `PENDING_REVIEW`, `DISAPPROVED`, `ADSET_PAUSED`).
+- Meta creatives are effectively immutable once attached. Editing copy/image/CTA = create a new creative + reattach (writes are out of scope for now).
+- Currency offsets are non-uniform (JPY/KRW = 1, KWD/BHD = 1000, most = 100). Read `account.currency` before doing budget math.
+
+---
+
 ### Google Analytics 4 (`baker ga4`)
 
 GA4 commands for multi-channel audits. Playbook-aligned presets, property health audits, and free-form Data API queries.

package/dist/cli.js

@@ -12,7 +12,7 @@ import { videosCommand } from "./commands/videos/index.js";
 const main = defineCommand({
     meta: {
         name: "baker",
-        version: "0.23.0",
+        version: "0.25.0",
         description: `AI-agent CLI for finding and managing images, videos, testimonials, action items, and ad platform data in Baker.
 
 Auth: Set BAKER_API_KEY (starts with bk_) and BAKER_API_URL environment variables.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ads/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,qDAerB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ads/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,qDAoBrB,CAAC"}

package/dist/commands/ads/index.js

@@ -1,19 +1,25 @@
 import { defineCommand } from "citty";
 import { googleCommand } from "./google/index.js";
+import { metaCommand } from "./meta/index.js";
 export const adsCommand = defineCommand({
     meta: {
         name: "ads",
-        description: `Ad platform commands. Currently supports Google Ads. More platforms coming soon.
+        description: `Ad platform commands. Each platform exposes its own native command surface — no forced parity.
 
 Platforms:
   google  — Google Ads (GAQL queries, keywords, accounts)
+  meta    — Meta Ads (campaigns, adsets, ads, insights, previews)
 
 Examples:
   baker ads google accounts
-  baker ads google query --preset campaign-performance --customer-id 1234567890`,
+  baker ads google query --preset campaign-performance --customer-id 1234567890
+  baker ads meta accounts
+  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE
+  baker ads meta insights --object act_123 --level ad --date-preset last_7d --fields impressions,spend,ctr`,
     },
     subCommands: {
         google: googleCommand,
+        meta: metaCommand,
     },
 });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/ads/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;IACtC,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;;;;;;;gFAO+D;KAC7E;IACD,WAAW,EAAE;QACX,MAAM,EAAE,aAAa;KACtB;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/ads/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;IACtC,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;;;;;;;;;;;2GAW0F;KACxG;IACD,WAAW,EAAE;QACX,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;KAClB;CACF,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,32 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson } from "../output.js";
+import { handleMetaError, resolveAccountIdArg } from "./shared.js";
+export const accountCommand = defineCommand({
+    meta: {
+        name: "account",
+        description: `Show single Meta ad account detail (currency, timezone, balance, business).
+
+Examples:
+  baker ads meta account --account-id act_123
+  BAKER_META_AD_ACCOUNT_ID=act_123 baker ads meta account`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID (act_...)" },
+        "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/account", params);
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=account.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/account.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,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EAAE;;;;0DAIyC;KACvD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;QAC7E,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,CAA0B,uBAAuB,EAAE,MAAM,CAAC,CAAC;YACpF,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/accounts.d.ts

@@ -0,0 +1,20 @@
+export declare const accountsCommand: import("citty").CommandDef<{
+    readonly "include-all": {
+        readonly type: "boolean";
+        readonly description: "List all accessible accounts, ignoring picker scope";
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip CLI-side cache";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache (force re-fetch)";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format: json|csv|jsonl|md";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=accounts.d.ts.map

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

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

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

@@ -0,0 +1,55 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { cacheGet, cacheSet } from "../cache.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError } from "./shared.js";
+export const accountsCommand = defineCommand({
+    meta: {
+        name: "accounts",
+        description: `List Meta ad accounts in this company's connected scope.
+
+Examples:
+  baker ads meta accounts
+  baker ads meta accounts --include-all   # ignore picker scope and list every account the token can see
+  baker ads meta accounts --output csv`,
+    },
+    args: {
+        "include-all": { type: "boolean", description: "List all accessible accounts, ignoring picker scope" },
+        "no-cache": { type: "boolean", description: "Skip CLI-side cache" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache (force re-fetch)" },
+        output: { type: "string", description: "Output format: json|csv|jsonl|md", default: "json" },
+    },
+    run: async ({ args }) => {
+        const includeAll = args["include-all"] === true;
+        const useCache = !args["no-cache"];
+        const cacheKey = `accounts:${includeAll ? "all" : "scoped"}`;
+        if (useCache) {
+            const cached = cacheGet("meta-accounts", cacheKey);
+            if (cached) {
+                writeAdsJson({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const params = {};
+            if (includeAll)
+                params["include-all"] = "true";
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/accounts", params);
+            if (useCache) {
+                cacheSet("meta-accounts", cacheKey, data, 60 * 60 * 1000);
+            }
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=accounts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAczD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;uCAKsB;KACpC;IACD,IAAI,EAAE;QACJ,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,qDAAqD,EAAE;QACtG,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,qBAAqB,EAAE;QACnE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2CAA2C,EAAE;QAC3F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE,OAAO,EAAE,MAAM,EAAE;KAC7F;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;QAChD,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,QAAQ,CAAgB,eAAe,EAAE,QAAQ,CAAC,CAAC;YAClE,IAAI,MAAM,EAAE,CAAC;gBACX,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5D,OAAO;YACT,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,UAAU;gBAAE,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC;YAC/C,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAgB,wBAAwB,EAAE,MAAM,CAAC,CAAC;YAC3E,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAiD,EAAE,GAAG,CAAC,CAAC;gBACvE,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/activities.d.ts

@@ -0,0 +1,24 @@
+export declare const activitiesCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Meta ad account ID";
+    };
+    readonly days: {
+        readonly type: "string";
+        readonly description: "Lookback days (default 7)";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max rows";
+    };
+    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=activities.d.ts.map

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

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

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

@@ -0,0 +1,44 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+export const activitiesCommand = defineCommand({
+    meta: {
+        name: "activities",
+        description: `Audit log of recent ad-account changes (created, paused, edited). Default lookback 7 days,
+~90 day retention server-side.
+
+Examples:
+  baker ads meta activities --account-id act_123 --days 14`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        days: { type: "string", description: "Lookback days (default 7)" },
+        limit: { type: "string", description: "Max rows" },
+        "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.days)
+                params.days = args.days;
+            if (args.limit)
+                params.limit = args.limit;
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/activities", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=activities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activities.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/activities.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,iBAAiB,GAAG,aAAa,CAAC;IAC7C,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;;;;2DAI0C;KACxD;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,2BAA2B,EAAE;QAClE,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,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,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/ads.d.ts

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

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

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

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

@@ -0,0 +1,57 @@
+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 adsListCommand = defineCommand({
+    meta: {
+        name: "ads",
+        description: `List ads in a Meta ad account. Defaults to ACTIVE only — pass --all-statuses to widen.
+
+The dashboard shows effective_status (e.g. WITH_ISSUES, PENDING_REVIEW, DISAPPROVED, ADSET_PAUSED), not status.
+preview_shareable_link returns a Meta-hosted URL useful for design review without calling generatepreviews.
+
+Examples:
+  baker ads meta ads --account-id act_123
+  baker ads meta ads --adset-id 6123
+  baker ads meta ads --campaign-id 6123 --all-statuses
+  baker ads meta ads --account-id act_123 --output csv`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        "adset-id": { type: "string", description: "Filter to one adset" },
+        "campaign-id": { type: "string", description: "Filter to one campaign" },
+        "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+        "all-statuses": { type: "boolean", description: "Drop the default ACTIVE 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);
+        const effectiveStatus = resolveEffectiveStatus(args);
+        try {
+            const params = { "account-id": accountId };
+            if (args["adset-id"])
+                params["adset-id"] = args["adset-id"];
+            if (args["campaign-id"])
+                params["campaign-id"] = args["campaign-id"];
+            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/ads", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=ads.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ads.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/ads.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,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;;;;;;;;;uDASsC;KACpD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;QAClE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;QAClH,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE;QAClF,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,IAAI,CAAC,UAAU,CAAC;gBAAE,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,UAAU,CAAW,CAAC;YACtE,IAAI,IAAI,CAAC,aAAa,CAAC;gBAAE,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAW,CAAC;YAC/E,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,mBAAmB,EAAE,MAAM,CAAC,CAAC;YACvF,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/adsets.d.ts

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

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

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

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

@@ -0,0 +1,50 @@
+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 adsetsCommand = defineCommand({
+    meta: {
+        name: "adsets",
+        description: `List ad sets in a Meta ad account, optionally scoped to one campaign. Defaults to ACTIVE only.
+
+Examples:
+  baker ads meta adsets --account-id act_123
+  baker ads meta adsets --campaign-id 6123456789
+  baker ads meta adsets --campaign-id 6123 --all-statuses`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        "campaign-id": { type: "string", description: "Filter to one campaign" },
+        "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+        "all-statuses": { type: "boolean", description: "Drop the default ACTIVE 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);
+        const effectiveStatus = resolveEffectiveStatus(args);
+        try {
+            const params = { "account-id": accountId };
+            if (args["campaign-id"])
+                params["campaign-id"] = args["campaign-id"];
+            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/adsets", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=adsets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adsets.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/adsets.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,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;0DAKyC;KACvD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;QAClH,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE;QAClF,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,IAAI,CAAC,aAAa,CAAC;gBAAE,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAW,CAAC;YAC/E,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,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/audiences.d.ts

@@ -0,0 +1,20 @@
+export declare const audiencesCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Meta ad account ID";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max rows";
+    };
+    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=audiences.d.ts.map

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

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

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

@@ -0,0 +1,41 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+export const audiencesCommand = defineCommand({
+    meta: {
+        name: "audiences",
+        description: `List custom audiences for a Meta ad account. Includes lookalikes, website-pixel audiences,
+customer-file audiences, etc. Note: Meta hides exact size when count < 1000 (privacy).
+
+Examples:
+  baker ads meta audiences --account-id act_123`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        limit: { type: "string", description: "Max rows" },
+        "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.limit)
+                params.limit = args.limit;
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/meta/audiences", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=audiences.js.map