@koda-sl/baker-cli 0.25.1 → 0.27.0

package/README.md

@@ -27,6 +27,9 @@ 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>"
 ```
@@ -36,6 +39,7 @@ 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
 
@@ -688,6 +692,75 @@ All errors include a `fix` object with `action`, `correctedCommand` (when applic
 
 ---
 
+### X (Twitter) Ads (`baker ads x`)
+
+Read X Ads campaigns, line items, promoted tweets, creatives, audiences, and analytics. Powered by the X Ads API v12.
+
+**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.
+
+**Subcommands:**
+
+| 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 |
+
+**Examples:**
+
+```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
+
+# Sync analytics with a preset (saves tokens)
+baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+
+# 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
+
+# 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
+
+# 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>
+
+# List sync presets
+baker ads x stats sync --list-presets
+
+# Targeting lookups
+baker ads x targeting-constants --constant locations --q "Madrid" --country-code ES
+baker ads x targeting-constants --constant interests
+```
+
+**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.
+
+**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.
+
+---
+
 ### 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.
@@ -784,6 +857,151 @@ The HTTP backend exposes more endpoints (catalogs, ad-studies, ad-images, labels
 
 ---
 
+### LinkedIn Ads (`baker ads linkedin`)
+
+LinkedIn Marketing API for B2B ad insights. Connect via OAuth in the dashboard, pick which ad accounts to scope to, then call from the CLI. Account ID via `--account-id 503001492` (numeric) or `--account-urn urn:li:sponsoredAccount:503001492`, or set `BAKER_LINKEDIN_AD_ACCOUNT_ID` env.
+
+**LinkedIn's superpower over Meta/Google:** firmographic pivots on every analytics query — `pivot=job-title|company|industry|seniority|function|company-size`. Meta has nothing like `MEMBER_COMPANY` returning company URNs of every account whose employees saw the ad. AI agents should reach for `linkedin demographics` and `linkedin top-companies` first when answering ABM/persona questions.
+
+**Read-only v1.** No campaign/creative writes. The surface is curated for AI agents per the LinkedIn Ads playbook (B2B operating manual covering audits, ABM, attribution, scaling).
+
+#### Common AI questions, mapped to commands
+
+```bash
+# "How is account X doing this week?"
+baker ads linkedin analytics
+
+# "Who are we reaching, by job title?" (the LinkedIn killer)
+baker ads linkedin analytics --level campaign --campaign-id 1234 \
+  --pivot job-title --intent baseline --last-days 30
+
+# "Top companies seeing this campaign" (ABM feedback loop)
+baker ads linkedin top-companies --campaign-id 1234 --last-days 30
+
+# "Who is in our audience by industry/seniority/function/title — all at once?"
+baker ads linkedin demographics --campaign-id 1234 --last-days 30
+
+# "Revenue by campaign over Q1"
+baker ads linkedin analytics --level campaign --campaign-id 1,2,3 \
+  --intent revenue --start 2026-01-01 --end 2026-03-31 --granularity MONTHLY
+
+# "How is the lead form converting?"
+baker ads linkedin analytics --level campaign --campaign-id 1234 --intent lead-gen
+
+# "Which creatives are fatigued?"
+baker ads linkedin analytics --level creative --creative-id 1,2,3 --intent ranking
+
+# "Run the playbook audit"
+baker ads linkedin audit --account-id 503001492
+baker ads linkedin audit --account-id 503001492 --format md             # deliverable-ready table
+
+# "Pull the leads from the last 7 days"
+baker ads linkedin leads --account-id 503001492 --since-days 7
+
+# "Is the Insight Tag healthy?"
+baker ads linkedin conversions health --account-id 503001492
+
+# "Pre-launch sanity check: is this audience too narrow?"
+baker ads linkedin audience-size --account-id 503001492 --targeting-file targeting.json
+
+# "What bid should I start at?"
+baker ads linkedin bid-pricing --account-id 503001492 \
+  --objective LEAD_GENERATION --cost-type CPC --targeting-file targeting.json
+```
+
+#### Smart defaults
+
+**`analytics`** — the 3-axis workhorse:
+- `--level account` (override: `campaign-group|campaign|creative`)
+- `--intent baseline` field bundle. Intents: `baseline | revenue | funnel | engagement | video | lead-gen | inmail | document | ranking | identity`. List with `--list-intents`.
+- `--pivot none`. Pivots: `none | campaign | campaign-group | creative | company | account | conversion | job-title | job-function | seniority | industry | company-size | country | region | device | placement | serving-location | card-index | objective | conversation-node | conversation-node-button`. List with `--list-pivots`.
+- `--granularity DAILY`. Auto-forced to `ALL` when pivoting on a `MEMBER_*` dim (LinkedIn rejects DAILY + demographic) — surfaced in stderr + `warnings`.
+- `--last-days 7` unless you pass `--start`/`--end`.
+- Sort: `costInUsd` descending. `--no-sort` to disable.
+- Derived metrics injected client-side: `ctr`, `cpc`, `cpm`, `frequency`, `leadCompletionRate` — LinkedIn doesn't return these.
+- URN normalization: every URN field becomes `{type, id, urn}` so rows are self-describing.
+- Wide windows (>180d) auto-segment into 30-day chunks and combine, since `q=analytics` caps at 15,000 rows with no pagination.
+
+**Listings** (`campaign-groups`/`campaigns`/`creatives`) default to `ACTIVE` only — pass `--all-statuses` to widen, or `--statuses ACTIVE,PAUSED` for a custom set.
+
+**Pagination** is auto-drained (start/count loop hidden).
+
+**Demographic pivots** (`MEMBER_*`) come back delayed 12-24h with a ≥3-event privacy floor — small buckets are dropped. The CLI surfaces `DELAYED_DEMOGRAPHIC` and (when results are unexpectedly empty) `BELOW_PRIVACY_FLOOR` warnings.
+
+#### Full command surface
+
+```
+accounts                       # accounts in the connected picker scope
+accounts --include-all         # every account the token can see
+account                        # single-account detail (currency, type, status)
+
+campaign-groups                # default ACTIVE-only
+campaigns                      # default ACTIVE-only; reveals audit-relevant settings
+creatives                      # default ACTIVE intended-status
+
+analytics                      # see "Smart defaults" above (3-axis: level × intent × pivot)
+demographics                   # sweep all firmographic pivots in one call
+top-companies                  # pivot=MEMBER_COMPANY shortcut (ABM)
+conversation                   # pivot=CONVERSATION_NODE_BUTTON shortcut (Sponsored Messaging)
+
+facets list                    # all targeting facets (industries, seniorities, titles, employers, …)
+facets values --facet titles --query "..."   # typeahead → URNs
+audience-size                  # estimate reach for a targetingCriteria payload + sweet-spot warnings
+bid-pricing                    # min/suggested/max bid + playbook §06 floor (2/3 of suggested)
+forecast                       # adSupplyForecasts wrapper for greenfield planning
+
+leads                          # Lead Gen Form responses (90d retention — sync to your CRM)
+conversions list               # conversion rules (Insight Tag + CAPI)
+conversions health             # 5-point Insight Tag / CAPI health check (playbook §07)
+
+audit                          # 30+ playbook checks → severity-tagged findings
+audit --format md              # deliverable-ready markdown table
+```
+
+#### `audit` — playbook diagnostic
+
+Runs in parallel: account detail + every campaign + every creative + conversion rules + account-level analytics + per-campaign frequency. Synthesizes findings across:
+
+- **Settings** — Audience Expansion disabled, LinkedIn Audience Network disabled, Manual CPC bidding (not Maximum Delivery), daily budget ≥ $50, lifetime budget cap set, budget-fragmentation guard
+- **Tracking** — at least one enabled rule, lead/purchase event configured, CAPI events recent (≤7d), `ONE_TIME_EACH_MEMBER` for leads, view-through window ≤7d, click attribution 7-90d
+- **Creative** — ≥3 ad formats per campaign, TLA presence, no creative active >90d, frequency <7, REJECTED creatives flagged
+- **Performance** — account CTR ≥ 0.4%, LP CVR ≥ 2%, lead-form completion ≥ 10%, delivered impressions in window, spend > $0
+- **Hygiene** — no abandoned DRAFT campaigns, every active campaign has at least one creative
+
+Each finding: `{id, area, check, status, severity, evidence, fix: {explanation, playbookRef}}`. Filter with `--severity critical,high` or `--area Settings,Tracking`. The JSON `summary` counts pass/critical/high/medium/low/n_a.
+
+#### Auth + caching
+
+- OAuth tokens auto-refresh server-side. On 401, reconnect LinkedIn from dashboard → integrations.
+- Account scoping: backend rejects calls against an account not in the picker selection.
+- Pinned API version: `Linkedin-Version: 202604` (declared in `oauth/constants.ts`). Bump as a coordinated change — LinkedIn deprecates monthly with a ~12-month support window.
+- Cache TTLs: accounts/account-detail 1h, listings 30m, analytics 15m–6h (depends on date range), facets 7d, urn-resolve 1h, bid-pricing/forecast 6h, audience-size 1h.
+- `--skip-cache` (server-side) and `--no-cache` (client-side, where supported) on any command.
+
+#### LinkedIn-specific gotchas
+
+- **Demographic + DAILY = error.** CLI auto-forces granularity=ALL when pivoting on `MEMBER_*` and warns.
+- **3-event privacy floor.** Small demographic buckets are dropped silently — widen the date range if results are sparse.
+- **15,000-row cap on `q=analytics`** (no pagination). CLI auto-segments by month for wide windows.
+- **Lead Gen Form 90-day retention.** Sync via `baker ads linkedin leads` regularly or lose them.
+- **LinkedIn can overspend daily budget by 50%** — only `totalBudget` lifetime cap stops runaway spend (audit check).
+- **CPC can look high** ($8–14 NA baseline) but CPL competitive thanks to firmographic targeting. Use playbook §00 dynamic benchmarks (geo + industry multipliers) before judging.
+- **No native change-history API.** Activity logs are not surfaced — playbook §24 calls this out as a gap.
+
+#### Error codes
+
+| HTTP | LinkedIn `serviceErrorCode` | CLI maps to | Action |
+|------|---|---|---|
+| 401  | 100 | `UNAUTHORIZED` | Reconnect LinkedIn in dashboard |
+| 403  | — | `FORBIDDEN` | Token lacks scope or account role |
+| 404  | 65604 | `NOT_FOUND` | Entity removed or not in scope |
+| 410  | — | `GONE` | Entity deleted; URN no longer queryable |
+| 426  | — | `INTERNAL_ERROR` | LinkedIn-Version deprecated; backend bump required |
+| 429  | 101 | `RATE_LIMITED` | Auto-backoff with Retry-After; if you see this, retry budget exhausted |
+| 400  | 65601 / 65603 | `VALIDATION_ERROR` | Fix request — see `error.fix.explanation` |
+
+---
+
 ### 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.25.1",
+        version: "0.27.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":"AAIA,eAAO,MAAM,UAAU,qDAoBrB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ads/index.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,UAAU,qDA2BrB,CAAC"}

package/dist/commands/ads/index.js

@@ -1,25 +1,34 @@
 import { defineCommand } from "citty";
 import { googleCommand } from "./google/index.js";
+import { linkedinCommand } from "./linkedin/index.js";
 import { metaCommand } from "./meta/index.js";
+import { xCommand } from "./x/index.js";
 export const adsCommand = defineCommand({
     meta: {
         name: "ads",
         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)
+  google    — Google Ads (GAQL queries, keywords, accounts, ad library)
+  meta      — Meta Ads (campaigns, adsets, ads, insights, previews)
+  linkedin  — LinkedIn Ads (firmographic analytics — job-title × company × industry × seniority pivots)
+  x         — X (Twitter) Ads (campaigns, line items, promoted tweets, analytics)
 
 Examples:
   baker ads google accounts
   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`,
+  baker ads meta insights --object act_123 --level ad --date-preset last_7d --fields impressions,spend,ctr
+  baker ads linkedin accounts
+  baker ads x accounts
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def`,
     },
     subCommands: {
         google: googleCommand,
         meta: metaCommand,
+        linkedin: linkedinCommand,
+        x: xCommand,
     },
 });
 //# 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,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"}
+{"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,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,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;;;;;;;;;;;;;;;;8EAgB6D;KAC3E;IACD,WAAW,EAAE;QACX,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,eAAe;QACzB,CAAC,EAAE,QAAQ;KACZ;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,20 @@
+export declare const accountCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Numeric account ID or urn:li:sponsoredAccount:N";
+    };
+    readonly "account-urn": {
+        readonly type: "string";
+        readonly description: "Alias for --account-id";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "json|csv|jsonl|md";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=account.d.ts.map

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

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

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

@@ -0,0 +1,39 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleLinkedinError, resolveAccountIdArg } from "./shared.js";
+export const accountCommand = defineCommand({
+    meta: {
+        name: "account",
+        description: `Single LinkedIn ad account detail (currency, status, type).
+
+Examples:
+  baker ads linkedin account --account-id 503001492
+  baker ads linkedin account --account-urn urn:li:sponsoredAccount:503001492 --output md`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+        "account-urn": { type: "string", description: "Alias for --account-id" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "json|csv|jsonl|md", default: "json" },
+    },
+    run: async ({ args }) => {
+        const accountId = resolveAccountIdArg(args);
+        try {
+            const params = { "account-id": accountId };
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/linkedin/account", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput([data], fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+//# sourceMappingURL=account.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/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,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAYlF,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EAAE;;;;yFAIwE;KACtF;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;QAChG,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE;KAC9E;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,CAAsB,2BAA2B,EAAE,MAAM,CAAC,CAAC;YACpF,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,CAAC,IAAI,CAA8C,EAAE,GAAG,CAAC,CAAC;gBACzE,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/ads/linkedin/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/linkedin/accounts.d.ts.map

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

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

@@ -0,0 +1,56 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { cacheGet, cacheSet } from "../cache.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleLinkedinError } from "./shared.js";
+const ACCOUNTS_TTL_MS = 60 * 60 * 1000;
+export const accountsCommand = defineCommand({
+    meta: {
+        name: "accounts",
+        description: `List LinkedIn ad accounts in this company's connected scope.
+
+Examples:
+  baker ads linkedin accounts
+  baker ads linkedin accounts --include-all   # ignore picker scope, list every account the token can see
+  baker ads linkedin 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("linkedin-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/linkedin/accounts", params);
+            if (useCache) {
+                cacheSet("linkedin-accounts", cacheKey, data, ACCOUNTS_TTL_MS);
+            }
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+//# sourceMappingURL=accounts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/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,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAY7D,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvC,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;2CAK0B;KACxC;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,CAAoB,mBAAmB,EAAE,QAAQ,CAAC,CAAC;YAC1E,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,CAAoB,4BAA4B,EAAE,MAAM,CAAC,CAAC;YACnF,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;YACjE,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,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/ads/linkedin/analytics.d.ts

@@ -0,0 +1,84 @@
+export declare const analyticsCommand: import("citty").CommandDef<{
+    readonly level: {
+        readonly type: "string";
+        readonly description: "Object scope (default: account)";
+    };
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Account ID — numeric or urn:li:sponsoredAccount:N (level=account)";
+    };
+    readonly "account-urn": {
+        readonly type: "string";
+        readonly description: "Alias for --account-id (URN form)";
+    };
+    readonly "campaign-group-id": {
+        readonly type: "string";
+        readonly description: "Comma-separated IDs (level=campaign-group)";
+    };
+    readonly "campaign-id": {
+        readonly type: "string";
+        readonly description: "Comma-separated IDs (level=campaign)";
+    };
+    readonly "creative-id": {
+        readonly type: "string";
+        readonly description: "Comma-separated IDs (level=creative)";
+    };
+    readonly ids: {
+        readonly type: "string";
+        readonly description: "Generic CSV of IDs at the chosen level (alternative to per-level flags)";
+    };
+    readonly intent: {
+        readonly type: "string";
+        readonly description: "baseline|revenue|funnel|engagement|video|lead-gen|inmail|document|ranking|identity";
+    };
+    readonly pivot: {
+        readonly type: "string";
+        readonly description: "Pivot dim. Default: none. See `--list-pivots`.";
+    };
+    readonly metrics: {
+        readonly type: "string";
+        readonly description: "CSV metric override — bypass --intent's bundle";
+    };
+    readonly "list-intents": {
+        readonly type: "boolean";
+        readonly description: "Print intent definitions and exit";
+    };
+    readonly "list-pivots": {
+        readonly type: "boolean";
+        readonly description: "Print pivot slugs and exit";
+    };
+    readonly start: {
+        readonly type: "string";
+        readonly description: "Start date YYYY-MM-DD (overrides --last-days)";
+    };
+    readonly end: {
+        readonly type: "string";
+        readonly description: "End date YYYY-MM-DD";
+    };
+    readonly "last-days": {
+        readonly type: "string";
+        readonly description: "Window relative to today (default: 7)";
+    };
+    readonly granularity: {
+        readonly type: "string";
+        readonly description: "DAILY|MONTHLY|YEARLY|ALL (default: DAILY)";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max rows (default: 1000)";
+    };
+    readonly "no-sort": {
+        readonly type: "boolean";
+        readonly description: "Skip default sort by costInUsd desc";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format json|csv|jsonl|md";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/commands/ads/linkedin/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/analytics.ts"],"names":[],"mappings":"AAgKA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmI3B,CAAC"}