@koda-sl/baker-cli 0.26.0 → 0.27.1-dev.bcbc31f8

package/README.md

@@ -857,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.
@@ -1544,6 +1689,7 @@ baker actions claim <action-id>            # live — required before update/com
 baker actions release <action-id>
 
 baker actions create --name "Build hero" --description "..." --tag copy,landing
+# → returns { ok, data: { tempId }, hints: [...] } — check hints for dependencies/tags/description reminders
 baker actions update <action-id> --name "Better name"
 baker actions complete <action-id> --note "What was done"  # stages — applies on chat publish
 baker actions discard <action-id> --reason "obsolete"

package/dist/cli.js

@@ -12,7 +12,7 @@ import { videosCommand } from "./commands/videos/index.js";
 const main = defineCommand({
     meta: {
         name: "baker",
-        version: "0.26.0",
+        version: "0.27.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/actions/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/actions/create.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EAsCxB,CAAC"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/actions/create.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EAgDxB,CAAC"}

package/dist/commands/actions/create.js

@@ -6,7 +6,7 @@ import { registerSchema } from "../../schemas.js";
 import { failApi, failValidation, generateTempId } from "./shared.js";
 registerSchema({
     command: "actions.create",
-    description: "Stage creation of a new action (applies when the chat is published). Returns a tempId you can use to link/tag in the same draft.",
+    description: "Stage creation of a new action (applies when the chat is published). Returns a tempId you can use to link/tag in the same draft. After creating, check if this action blocks or is blocked by other actions and wire dependencies with `baker actions link`.",
     args: {
         name: { type: "string", description: "Action name (short, action-verb, ≤6 words)", required: true },
         description: {
@@ -50,7 +50,15 @@ export const createCommand = defineCommand({
                 description: args.description ?? "",
                 tagSlugs,
             });
-            writeJson(response);
+            const hints = [];
+            hints.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);
+            if (!tagSlugs || tagSlugs.length === 0) {
+                hints.push("Add tags: baker actions tag add <tempId> --slug <tag-slug>");
+            }
+            if (!args.description) {
+                hints.push("Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)");
+            }
+            writeJson({ ...response, hints });
         }
         catch (err) {
             failApi(err);

package/dist/commands/actions/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/actions/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEtE,cAAc,CAAC;IACb,OAAO,EAAE,gBAAgB;IACzB,WAAW,EACT,kIAAkI;IACpI,IAAI,EAAE;QACJ,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE,QAAQ,EAAE,IAAI,EAAE;QACnG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8DAA8D;YAC3E,QAAQ,EAAE,KAAK;SAChB;QACD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE,QAAQ,EAAE,KAAK,EAAE;QACpF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE,QAAQ,EAAE,KAAK,EAAE;KACzG;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,sHAAsH;KACzH;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;QACrE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;QACzF,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAChG,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,KAAK,EAAE;KACtF;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAA0B,CAAC;YAC7C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtC,cAAc,CAAC,qBAAqB,CAAC,CAAC;YACxC,CAAC;YACD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAI,IAAI,CAAC,SAAS,CAAwB,IAAI,cAAc,EAAE,CAAC;YAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG;gBACvB,CAAC,CAAE,IAAI,CAAC,GAAc;qBACjB,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;qBACpB,MAAM,CAAC,OAAO,CAAC;gBACpB,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAyC,qBAAqB,EAAE;gBAC5F,MAAM;gBACN,MAAM;gBACN,IAAI;gBACJ,WAAW,EAAG,IAAI,CAAC,WAAsB,IAAI,EAAE;gBAC/C,QAAQ;aACT,CAAC,CAAC;YACH,SAAS,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/actions/create.ts"],"names":[],"mappings":"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"}

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":"AAKA,eAAO,MAAM,UAAU,qDAwBrB,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,5 +1,6 @@
 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({
@@ -8,9 +9,10 @@ export const adsCommand = defineCommand({
         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)
-  meta    — Meta Ads (campaigns, adsets, ads, insights, previews)
-  x       — X (Twitter) Ads (campaigns, line items, promoted tweets, analytics)
+  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
@@ -18,12 +20,14 @@ Examples:
   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 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,
     },
 });

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;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;;;;;;;;;;;;;;8EAc6D;KAC3E;IACD,WAAW,EAAE;QACX,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,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,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"}