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

package/README.md

@@ -27,9 +27,6 @@ export BAKER_GA4_PROPERTY_ID="properties/123456789"
 # Optional: default GSC site URL
 export BAKER_GSC_SITE_URL="https://example.com/"
 
-# Optional: default X Ads account ID (base36)
-export BAKER_X_ADS_ACCOUNT_ID="18ce53xyz"
-
 # Required for `baker actions ...` commands that stage against a chat
 export BAKER_CHAT_ID="<chat-id>"
 ```
@@ -39,7 +36,6 @@ export BAKER_CHAT_ID="<chat-id>"
 - `BAKER_GOOGLE_ADS_CUSTOMER_ID` — default Google Ads customer ID (10 digits). Used when `--customer-id` is not passed. If neither is set and the account has exactly one Google Ads customer, it is auto-selected.
 - `BAKER_GA4_PROPERTY_ID` — default GA4 property ID. Used when `--property-id` is not passed. If neither is set and exactly one property is connected, it is auto-selected.
 - `BAKER_GSC_SITE_URL` — default GSC site URL. Used when `--site-url` is not passed. If neither is set and exactly one site is verified, it is auto-selected.
-- `BAKER_X_ADS_ACCOUNT_ID` — default X Ads account ID (base36). Used when `--account-id` is not passed. If neither is set and exactly one X Ads account is connected, it is auto-selected.
 
 ## Output Format
 
@@ -692,72 +688,99 @@ All errors include a `fix` object with `action`, `correctedCommand` (when applic
 
 ---
 
-### X (Twitter) Ads (`baker ads x`)
+### 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.
 
-Read X Ads campaigns, line items, promoted tweets, creatives, audiences, and analytics. Powered by the X Ads API v12.
+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.
 
-**Environment:**
-- `BAKER_X_ADS_ACCOUNT_ID` — default account ID (base36). Used when `--account-id` is not passed. If neither is set and exactly one X Ads account is connected, it's auto-selected.
+#### Common AI questions, mapped to commands
 
-**Subcommands:**
+```bash
+# "How is account X doing this week?"
+baker ads meta insights --object act_123
 
-| Subcommand | What it returns |
-|---|---|
-| `accounts` | All accessible X Ads accounts |
-| `funding` | Funding instruments for an account |
-| `campaigns` | Campaigns (filter by `--funding-instrument-ids`, `--campaign-ids`) |
-| `line-items` | Line items / ad groups (filter by `--campaign-ids`, `--line-item-ids`) |
-| `promoted-tweets` | Promoted tweets (filter by `--line-item-ids`) |
-| `cards` | Website cards, video cards, carousels |
-| `media` | Media library (images / GIFs / videos) — `--media-type IMAGE\|GIF\|VIDEO` |
-| `audiences` | Custom audiences (size, targetable status) |
-| `targeting-criteria` | Targeting attached to line items |
-| `targeting-constants` | Lookup locations / interests / events / devices etc. — `--constant <name> --q "Madrid"` |
-| `active-entities` | Entities with metric activity in a time range |
-| `stats sync` | Synchronous analytics (≤7 days, no segmentation) |
-| `stats job` | Async stats end-to-end (creates + polls + downloads + decompresses). Must run in the background (the harness enforces this). Use for ranges >7 days, segmented stats, or when sync limits are hit. |
-| `stats job-create` | Low-level: create async stats job, return ID immediately |
-| `stats job-status` | Low-level: poll job status / get download URL |
+# "Which campaigns are profitable?"
+baker ads meta insights --object act_123 --level campaign --intent revenue --date-preset last_28d
 
-**Examples:**
+# "Which creatives need a refresh?"
+baker ads meta insights --object act_123 --level ad --intent ranking --date-preset last_14d
 
-```bash
-baker ads x accounts
-baker ads x campaigns --account-id 18ce53xyz
-baker ads x line-items --account-id 18ce53xyz --campaign-ids abc
-baker ads x promoted-tweets --account-id 18ce53xyz
+# "Where do users drop off the funnel?"
+baker ads meta insights --object act_123 --intent funnel
 
-# Sync analytics with a preset (saves tokens)
-baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+# "Should we shift budget to Instagram?"
+baker ads meta insights --object act_123 --level adset \
+  --breakdowns publisher_platform,platform_position
 
-# Free-form sync stats
-baker ads x stats sync --account-id 18ce53xyz --entity LINE_ITEM \
-  --entity-ids abc,def --start-time 2026-05-01T00:00:00Z --end-time 2026-05-07T00:00:00Z \
-  --metric-groups ENGAGEMENT,BILLING --granularity DAY
+# "Why did spend drop yesterday?"
+baker ads meta activities --account-id act_123 --days 7
 
-# Async job, sync from the CLI's perspective (creates → polls → downloads → returns).
-# Must be invoked with run_in_background: true. The harness will block otherwise.
-baker ads x stats job --account-id 18ce53xyz --entity CAMPAIGN \
-  --entity-ids abc --start-time 2026-04-01T00:00:00Z --end-time 2026-05-01T00:00:00Z \
-  --metric-groups ENGAGEMENT,BILLING --segmentation-type LOCATIONS
+# "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
 
-# Low-level (don't wait, manage polling yourself):
-baker ads x stats job-create --account-id 18ce53xyz --entity CAMPAIGN \
-  --entity-ids abc --start-time 2026-04-01T00:00:00Z --end-time 2026-05-01T00:00:00Z \
-  --metric-groups ENGAGEMENT,BILLING --segmentation-type LOCATIONS
-baker ads x stats job-status --account-id 18ce53xyz --job-id <jobId>
+# "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
 
-# List sync presets
-baker ads x stats sync --list-presets
+# "What audience is this targeting?"
+baker ads meta audiences --account-id act_123
 
-# Targeting lookups
-baker ads x targeting-constants --constant locations --q "Madrid" --country-code ES
-baker ads x targeting-constants --constant interests
+# "Is the pixel firing?"
+baker ads meta pixels --account-id act_123
+baker ads meta pixels --pixel-id 9988 --stats --days 7
 ```
 
-**Caching:** account list 1h · campaigns/line items/promoted tweets 1h (date-keyed) · cards/media/audiences 6h · stats sync 1h · targeting constants 7 days. Pass `--no-cache` to bypass.
+#### 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
 
-**Rate limits:** server-side buckets (`xAds:read`, `xAds:write`, `xAds:analyticsSync`, `xAds:analyticsAsync`, `xAds:audiences`) sit well under X's published quotas; 429s honor `x-account-rate-limit-reset` / `x-rate-limit-reset` headers.
+- `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.
 
 ---
 

package/dist/cli.js

@@ -12,7 +12,7 @@ import { videosCommand } from "./commands/videos/index.js";
 const main = defineCommand({
     meta: {
         name: "baker",
-        version: "0.25.0",
+        version: "0.25.1",
         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":"AAIA,eAAO,MAAM,UAAU,qDAmBrB,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,24 +1,25 @@
 import { defineCommand } from "citty";
 import { googleCommand } from "./google/index.js";
-import { xCommand } from "./x/index.js";
+import { metaCommand } from "./meta/index.js";
 export const adsCommand = defineCommand({
     meta: {
         name: "ads",
-        description: `Ad platform commands. Supports Google Ads and X (Twitter) Ads.
+        description: `Ad platform commands. Each platform exposes its own native command surface — no forced parity.
 
 Platforms:
-  google  — Google Ads (GAQL queries, keywords, accounts, ad library)
-  x       — X (Twitter) Ads (campaigns, line items, promoted tweets, analytics)
+  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 x accounts
-  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def`,
+  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,
-        x: xCommand,
+        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;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;IACtC,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;;;;;;;;;;8EAU6D;KAC3E;IACD,WAAW,EAAE;QACX,MAAM,EAAE,aAAa;QACrB,CAAC,EAAE,QAAQ;KACZ;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"}