@koda-sl/baker-cli 0.542.0 → 0.544.0

package/dist/linkedin-FTZZWW6D.js

@@ -0,0 +1,1328 @@
+import {
+  TOTAL_BUDGET_HELP
+} from "./chunk-I6YWF2RA.js";
+import {
+  statusesArgDescription
+} from "./chunk-XJSEDW63.js";
+import "./chunk-3W4IORXH.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-NGQ5J4FV.js";
+import {
+  AVAILABLE_ARG
+} from "./chunk-USVTT74J.js";
+import "./chunk-MGWAZXY6.js";
+import "./chunk-VWOKPC3T.js";
+import "./chunk-BGT5ZA4L.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-FPTEBOB5.js";
+import "./chunk-JF2XP76K.js";
+import "./chunk-SYLPRIFM.js";
+import "./chunk-XBR7TSZN.js";
+import "./chunk-DGUN7FUH.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-NFXW6C6I.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-TI4UL56R.js";
+import "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/index.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/linkedin/schemas.ts
+var CHAT_READ_ARG_DESCRIPTION = CHAT_READ_ARG.description;
+registerSchema({
+  command: "ads.linkedin.accounts",
+  description: "List LinkedIn ad accounts in the company's connected scope.",
+  args: {
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" },
+    available: AVAILABLE_ARG
+  }
+});
+var accountDetailSchema = {
+  description: "Single LinkedIn ad account detail (currency, status, type). Resolves the urn \u2192 {id, name, currency, status, type}.",
+  args: {
+    "account-id": { type: "string", description: "Numeric ID or urn:li:sponsoredAccount:N", required: false },
+    "account-urn": { type: "string", description: "Alias for --account-id", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+};
+registerSchema({ command: "ads.linkedin.account", ...accountDetailSchema });
+registerSchema({ command: "ads.linkedin.account.detail", ...accountDetailSchema });
+registerSchema({
+  command: "ads.linkedin.campaign-groups",
+  description: "List LinkedIn campaign groups in an account. Default ACTIVE-only \u2014 pass --all-statuses to widen.",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias for --account-id", required: false },
+    "all-statuses": { type: "boolean", description: "Drop the ACTIVE filter", required: false },
+    statuses: { type: "string", description: statusesArgDescription("campaignGroups"), required: false },
+    limit: { type: "string", description: "Max rows (default 500)", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.campaigns",
+  description: "List LinkedIn campaigns. Returns audit-relevant settings (audienceExpansionEnabled, offsiteDeliveryEnabled, optimizationTargetType, costType, budgets, runSchedule, targetingCriteria).",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    "campaign-group-id": { type: "string", description: "Filter by campaign group", required: false },
+    "all-statuses": { type: "boolean", description: "Drop the ACTIVE filter", required: false },
+    statuses: { type: "string", description: statusesArgDescription("campaigns"), required: false },
+    limit: { type: "string", description: "Max rows", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.creatives",
+  description: "List LinkedIn creatives. Compact by default: id, urn, campaign, status, review status, format, and the resolved destination (landingUrl, or postUrn for post-based ads). The opaque 'content' block is NOT returned unless you pass --full; --fields takes dotted paths for anything narrower.",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    "campaign-id": { type: "string", description: "Filter by campaign", required: false },
+    "all-statuses": { type: "boolean", description: "Drop the ACTIVE filter", required: false },
+    statuses: { type: "string", description: statusesArgDescription("creatives"), required: false },
+    fields: {
+      type: "string",
+      description: "CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Return the complete raw records, including the opaque 'content' block",
+      required: false
+    },
+    limit: { type: "string", description: "Max rows", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.analytics",
+  description: "Performance reporting (3-axis: --level \xD7 --intent \xD7 --pivot). LinkedIn's superpower: pivot=job-title|company|industry|seniority. Demographic pivots auto-force granularity=ALL and surface a delayed-data warning.",
+  args: {
+    level: {
+      type: "string",
+      description: "account|campaign-group|campaign|creative",
+      required: false,
+      default: "account"
+    },
+    "account-id": { type: "string", description: "When level=account", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    "campaign-group-id": { type: "string", description: "CSV when level=campaign-group", required: false },
+    "campaign-id": { type: "string", description: "CSV when level=campaign", required: false },
+    "creative-id": { type: "string", description: "CSV when level=creative", required: false },
+    ids: { type: "string", description: "Generic CSV alternative", required: false },
+    intent: {
+      type: "string",
+      description: "Field bundle",
+      required: false,
+      default: "baseline",
+      enum: [
+        "baseline",
+        "revenue",
+        "funnel",
+        "engagement",
+        "video",
+        "lead-gen",
+        "inmail",
+        "document",
+        "ranking",
+        "identity"
+      ]
+    },
+    pivot: {
+      type: "string",
+      description: "Demographic / firmographic dim",
+      required: false,
+      default: "none",
+      enum: [
+        "none",
+        "campaign",
+        "campaign-group",
+        "creative",
+        "company",
+        "account",
+        "conversion",
+        "job-title",
+        "job-function",
+        "seniority",
+        "industry",
+        "company-size",
+        "country",
+        "region",
+        "dma",
+        "device",
+        "placement",
+        "serving-location",
+        "card-index",
+        "objective",
+        "conversation-node",
+        "conversation-node-button"
+      ]
+    },
+    metrics: { type: "string", description: "CSV metric override (escape hatch)", required: false },
+    start: { type: "string", description: "YYYY-MM-DD", required: false },
+    end: { type: "string", description: "YYYY-MM-DD", required: false },
+    "last-days": { type: "string", description: "Window (default 7)", required: false },
+    granularity: {
+      type: "string",
+      description: "DAILY|MONTHLY|YEARLY|ALL",
+      required: false,
+      default: "DAILY",
+      enum: ["DAILY", "MONTHLY", "YEARLY", "ALL"]
+    },
+    limit: { type: "string", description: "Max rows", required: false },
+    "no-sort": { type: "boolean", description: "Skip default sort", required: false },
+    "list-intents": { type: "boolean", description: "List intents and exit", required: false },
+    "list-pivots": { type: "boolean", description: "List pivots and exit", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.demographics",
+  description: "Sweep all firmographic pivots (job-title, company, industry, seniority, function, company-size) in one call. Returns top-N rows per pivot.",
+  args: {
+    "campaign-id": { type: "string", description: "CSV campaign IDs", required: true },
+    pivots: { type: "string", description: "CSV of pivots (default: all firmographic)", required: false },
+    "top-n": { type: "string", description: "Top rows per pivot (default 10)", required: false },
+    intent: { type: "string", description: "Field bundle", required: false, default: "baseline" },
+    start: { type: "string", description: "YYYY-MM-DD", required: false },
+    end: { type: "string", description: "YYYY-MM-DD", required: false },
+    "last-days": { type: "string", description: "Window (default 30)", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.companies",
+  description: "Which companies the LinkedIn ads reached \u2014 one row per company over the whole period ({org, name, impressions, clicks, engagements, costLocal}), most engaged first. Start here for warm accounts / ABM reporting. Defaults: last 12 calendar months, the only selected ad account, 100 companies a page (--page N for the next, --full for all; totalCompanies counts them all). --by month|campaign adds a months[] or campaigns[] breakdown; --with-domains adds domain + domainSource for CRM matching; --stats adds row counts and cost/reach/domain coverage (no names). LinkedIn drops companies under 3 events a month.",
+  args: {
+    "account-id": {
+      type: "string",
+      description: "Ad account id (numeric or urn:li:sponsoredAccount:N). Default: the only selected account",
+      required: false
+    },
+    "campaign-id": { type: "string", description: "CSV campaign ids \u2014 read only these campaigns", required: false },
+    "last-months": {
+      type: "string",
+      description: "Calendar months back incl. this one (1-24, default 12)",
+      required: false
+    },
+    start: { type: "string", description: "YYYY-MM-DD (instead of --last-months)", required: false },
+    end: { type: "string", description: "YYYY-MM-DD (default today)", required: false },
+    by: { type: "string", description: "none | month | campaign (default none)", required: false },
+    "with-domains": { type: "boolean", description: "Add website domain + domainSource per company", required: false },
+    "min-impressions": { type: "string", description: "Leave out companies under N impressions", required: false },
+    full: { type: "boolean", description: "Every company, plus videoViews", required: false },
+    page: {
+      type: "string",
+      description: "Which page of 100 companies, most engaged first (default 1)",
+      required: false
+    },
+    stats: { type: "boolean", description: "Add read-quality stats (counts and rates only)", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.top-companies",
+  description: "Top companies whose employees saw / clicked / converted. Wrapper for analytics --pivot company. The ABM feedback loop.",
+  args: {
+    "campaign-id": { type: "string", description: "CSV campaign IDs", required: true },
+    intent: { type: "string", description: "Field bundle (default baseline)", required: false },
+    "top-n": { type: "string", description: "Top rows by impressions (default 25)", required: false },
+    start: { type: "string", description: "YYYY-MM-DD", required: false },
+    end: { type: "string", description: "YYYY-MM-DD", required: false },
+    "last-days": { type: "string", description: "Window (default 30)", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.resolve",
+  description: "Resolve organization URNs (from top-companies / analytics --pivot company) to company names. With --with-domains, returns each org's LinkedIn page (vanityName), website and registrable domain instead \u2014 ready to match against CRM company domains. domainSource: website (the org's own domain), subdomain (e.g. news.microsoft.com \u2192 microsoft.com; lower confidence), none (shortlink/redirector or no website). Unknown ids come back in errors.",
+  args: {
+    urns: { type: "string", description: "Comma-separated org URNs (urn:li:organization:NNN)", required: false },
+    ids: { type: "string", description: "Comma-separated bare org ids (17719,19022)", required: false },
+    "with-domains": {
+      type: "boolean",
+      description: "Return vanityName, website, domain and domainSource per org (+ errors for unknown ids)",
+      required: false
+    },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.facets.list",
+  description: "List every targeting facet LinkedIn supports (industries, seniorities, titles, employers, growthRate, etc).",
+  args: {
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.facets.values",
+  description: "Look up entity values for a facet \u2014 full list (q=adTargetingFacet) or typeahead search (q=typeahead, with --query).",
+  args: {
+    facet: { type: "string", description: "Facet name (industries) or URN", required: true },
+    query: { type: "string", description: "Typeahead query (auto-switches finder)", required: false },
+    finder: { type: "string", description: "adTargetingFacet|typeahead|similarEntities", required: false },
+    locale: { type: "string", description: "Locale (default en_US)", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.audience-size",
+  description: "Estimate audience size for a targetingCriteria payload. Returns total + active + playbook \xA704 sweet-spot warnings.",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria", required: false },
+    "targeting-file": { type: "string", description: "Path to JSON file", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.bid-pricing",
+  description: "LinkedIn's suggested bid (min/default/max), bid limits and daily budget range for a targeting + objective + bid type, in the account's currency, plus the playbook \xA706 floor (2/3 of suggested).",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    objective: {
+      type: "string",
+      description: "Objective type (LEAD_GENERATION, WEBSITE_VISIT, etc.)",
+      required: true
+    },
+    "cost-type": {
+      type: "string",
+      description: "CPC|CPM|CPV",
+      required: false,
+      default: "CPC",
+      enum: ["CPC", "CPM", "CPV"]
+    },
+    "campaign-type": {
+      type: "string",
+      description: "Campaign type",
+      required: false,
+      default: "SPONSORED_UPDATES",
+      enum: ["SPONSORED_UPDATES", "SPONSORED_INMAILS", "TEXT_AD"]
+    },
+    "audience-expansion": {
+      type: "boolean",
+      description: "Price with audience expansion on",
+      required: false,
+      default: false
+    },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria", required: false },
+    "targeting-file": { type: "string", description: "Path to JSON file", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.forecast",
+  description: "LinkedIn's forecast for a campaign that doesn't exist yet: impressions, clicks, leads, spend, unit costs (cpc, cpm, costPerLead) and rates over a period, each { value, low, high }. Needs a budget; --bid forecasts a manual bid, without it LinkedIn's automated bidding.",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    objective: { type: "string", description: "Objective type", required: false },
+    "cost-type": {
+      type: "string",
+      description: "Bid type of --bid",
+      required: false,
+      default: "CPC",
+      enum: ["CPC", "CPM", "CPV"]
+    },
+    "campaign-type": {
+      type: "string",
+      description: "Campaign type",
+      required: false,
+      default: "SPONSORED_UPDATES",
+      enum: ["SPONSORED_UPDATES", "SPONSORED_INMAILS", "DYNAMIC"]
+    },
+    "daily-budget": { type: "string", description: "e.g. '250' or '250 EUR'", required: false },
+    "total-budget": { type: "string", description: "e.g. '7250' or '7250 EUR'", required: false },
+    bid: { type: "string", description: "Manual bid e.g. '5.57'; omit for automated bidding", required: false },
+    "optimization-target": { type: "string", description: "Automated-bidding goal, e.g. MAX_LEAD", required: false },
+    start: { type: "string", description: "First day YYYY-MM-DD (default tomorrow)", required: false },
+    days: { type: "string", description: "Period length in days (default 30)", required: false },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria", required: false },
+    "targeting-file": { type: "string", description: "Path to JSON file", required: false },
+    full: { type: "boolean", description: "Include LinkedIn's raw series", required: false, default: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.leads",
+  description: "List Lead Gen Form responses (90-day LinkedIn retention \u2014 sync to CRM via this endpoint). Filter by --form-id, --campaign-id, or --since-days.",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    "form-id": { type: "string", description: "Filter by form ID", required: false },
+    "campaign-id": { type: "string", description: "Filter by campaign", required: false },
+    "since-days": { type: "string", description: "Last N days", required: false },
+    "since-ms": { type: "string", description: "Epoch ms (alternative to --since-days)", required: false },
+    until: { type: "string", description: "Submitted before (YYYY-MM-DD or epoch ms)", required: false },
+    "test-leads": { type: "boolean", description: "Only test leads", required: false },
+    limit: { type: "string", description: "Max rows", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.conversions.list",
+  description: "List conversion rules (Insight Tag + Conversions API).",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.conversions.health",
+  description: "Playbook \xA707 5-point health check: rules enabled? lead/purchase event? CAPI fired in 7d? view-through \u22647d? lead de-dup correct?",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.conversation",
+  description: "Per-button click rates inside Sponsored Messaging / Conversation Ads. Wraps analytics --pivot conversation-node-button.",
+  args: {
+    "campaign-id": { type: "string", description: "CSV campaign IDs", required: true },
+    start: { type: "string", description: "YYYY-MM-DD", required: false },
+    end: { type: "string", description: "YYYY-MM-DD", required: false },
+    "last-days": { type: "string", description: "Window (default 30)", required: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.audit",
+  description: "Run a 30+ check playbook audit (Settings, Tracking, Audience, Campaigns, Creative, Performance, Bidding, Compliance, Hygiene). Each finding: {id, area, check, status, severity, evidence, fix} with playbook citations. --format md renders a deliverable-ready table.",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    "campaign-id": { type: "string", description: "Narrow to a single campaign", required: false },
+    "window-days": { type: "string", description: "Performance lookback (default 30)", required: false },
+    severity: { type: "string", description: "CSV severity filter (critical,high,medium,low)", required: false },
+    area: { type: "string", description: "CSV area filter", required: false },
+    format: { type: "string", description: "json | md", required: false, default: "json" },
+    "no-cache": NO_CACHE_ARG
+  }
+});
+var writeAccountArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N", required: false },
+  "account-urn": { type: "string", description: "Alias for --account-id", required: false }
+};
+registerSchema({
+  command: "ads.linkedin.campaign-groups.create",
+  description: "Stage a new campaign group (staged until publish; review with `baker ads linkedin draft`). Returns a li_temp_* ref that later `campaigns create --group` calls can reference.",
+  args: {
+    ...writeAccountArgs,
+    name: { type: "string", description: "Name (\u2264100 chars)", required: true },
+    start: {
+      type: "string",
+      description: "Run schedule start: now (default), ISO date or epoch ms \u2014 a passed start moves to publish",
+      required: false
+    },
+    end: { type: "string", description: "Run schedule end", required: false },
+    "total-budget": { type: "string", description: TOTAL_BUDGET_HELP, required: false },
+    currency: {
+      type: "string",
+      description: "3-letter currency code (defaults to the ad account currency)",
+      required: false
+    },
+    objective: { type: "string", description: "Objective every ad set takes, create-only", required: false },
+    "shared-budget": {
+      type: "string",
+      description: "MAXIMUM_DELIVERY|MANUAL|COST_CAP \u2014 share the total budget across its ad sets (needs --total-budget, --end)",
+      required: false
+    },
+    status: {
+      type: "string",
+      description: "DRAFT|ACTIVE (default DRAFT) \u2014 LinkedIn refuses a new group created PAUSED",
+      required: false
+    },
+    file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.campaign-groups.update",
+  description: "Stage changes to an existing campaign group (name, schedule, budget, status). Captures a before-snapshot for the dashboard diff. Pass a li_temp_* ref to AMEND a group staged in this chat. Applies on chat publish.",
+  args: {
+    id: {
+      type: "positional",
+      description: "Campaign group id/URN, or li_temp_* ref staged in this chat",
+      required: true
+    },
+    ...writeAccountArgs,
+    name: { type: "string", description: "New name", required: false },
+    start: { type: "string", description: "New schedule start", required: false },
+    end: { type: "string", description: "New schedule end", required: false },
+    "total-budget": { type: "string", description: TOTAL_BUDGET_HELP, required: false },
+    currency: {
+      type: "string",
+      description: "3-letter currency code (defaults to the ad account currency)",
+      required: false
+    },
+    "shared-budget": {
+      type: "string",
+      description: "MAXIMUM_DELIVERY|MANUAL|COST_CAP \u2014 share the budget across its ad sets",
+      required: false
+    },
+    status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED", required: false },
+    file: { type: "string", description: "JSON file with fields to change", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.campaigns.create",
+  description: "Stage a new campaign. --group accepts a real id/URN or a li_temp_* ref staged earlier in this chat. Targeting goes in --targeting-file as LinkedIn criteria: {include:{and:[{or:{'urn:li:adTargetingFacet:locations':['urn:li:geo:\u2026']}}]}} \u2014 find facet values with `baker ads linkedin facets values`. Playbook defaults: manual bid (--bid), audience expansion off, LAN off. Staged until publish.",
+  args: {
+    ...writeAccountArgs,
+    name: { type: "string", description: "Name (\u2264255 chars)", required: true },
+    group: { type: "string", description: "Campaign group id/URN or li_temp_* ref", required: true },
+    type: { type: "string", description: "SPONSORED_UPDATES|TEXT_AD|SPONSORED_INMAILS|DYNAMIC", required: true },
+    objective: { type: "string", description: "LEAD_GENERATION|WEBSITE_VISIT|BRAND_AWARENESS|\u2026", required: false },
+    "cost-type": { type: "string", description: "CPC|CPM|CPV", required: true },
+    bid: { type: "string", description: "Manual bid amount (unitCost)", required: false },
+    "daily-budget": { type: "string", description: "Daily budget amount", required: false },
+    "total-budget": { type: "string", description: TOTAL_BUDGET_HELP, required: false },
+    currency: {
+      type: "string",
+      description: "3-letter currency code (defaults to the ad account currency)",
+      required: false
+    },
+    start: {
+      type: "string",
+      description: "Run schedule start: now (default \u2014 when the chat publishes), ISO date or epoch ms",
+      required: false
+    },
+    end: { type: "string", description: "Run schedule end", required: false },
+    locale: { type: "string", description: "Profile locale like en_US (default en_US)", required: false },
+    "targeting-file": { type: "string", description: "JSON file with targetingCriteria", required: true },
+    "audience-expansion": { type: "string", description: "on|off (playbook: off; default off)", required: false },
+    lan: {
+      type: "string",
+      description: "LinkedIn Audience Network on|off (playbook: off; default off)",
+      required: false
+    },
+    ctv: { type: "string", description: "Connected TV on|off (default off)", required: false },
+    "creative-selection": { type: "string", description: "OPTIMIZED|ROUND_ROBIN", required: false },
+    "associated-entity": { type: "string", description: "Organization URN", required: false },
+    "political-intent": {
+      type: "string",
+      description: "NOT_POLITICAL (default)|POLITICAL|NOT_DECLARED \u2014 the advertiser's declaration; new ad sets are declared not political unless the ads are political advertising",
+      required: false
+    },
+    optimization: {
+      type: "string",
+      description: "optimizationTargetType \u2014 NONE (manual, default)|ENHANCED_CONVERSION|MAX_LEAD|MAX_QUALIFIED_LEAD|MAX_CONVERSION|MAX_CLICK|MAX_IMPRESSION|MAX_REACH|MAX_VIDEO_VIEW (CPM)|TARGET_COST_PER_CLICK|TARGET_COST_PER_IMPRESSION|TARGET_COST_PER_VIDEO_VIEW|CAP_COST_AND_MAXIMIZE_LEADS|\u2026_CLICKS|\u2026_IMPRESSIONS|\u2026_VIDEO_VIEWS (CPM); target cost and cost cap need --bid",
+      required: false
+    },
+    format: {
+      type: "string",
+      description: "Ad format, create-only: STANDARD_UPDATE|SINGLE_VIDEO|CAROUSEL|TEXT_AD|SPOTLIGHT|FOLLOW_COMPANY|JOBS|SPONSORED_INMAIL|SPONSORED_MESSAGE|SPONSORED_UPDATE_EVENT|SPONSORED_UPDATE_NATIVE_DOCUMENT",
+      required: false
+    },
+    pacing: { type: "string", description: "LIFETIME|ACCELERATED, create-only", required: false },
+    "frequency-cap": {
+      type: "string",
+      description: "At most N impressions per member a week (3\u201330), Brand awareness only",
+      required: false
+    },
+    status: {
+      type: "string",
+      description: "DRAFT|ACTIVE|PAUSED (default DRAFT) \u2014 PAUSED needs a group that is not DRAFT",
+      required: false
+    },
+    file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.campaigns.update",
+  description: "Stage changes to an existing campaign \u2014 budget, bid, targeting, schedule, flags, status. Only pass what changes; a before-snapshot powers the dashboard diff. Pass a li_temp_* ref to AMEND a campaign staged in this chat (fields merge into the staged create). Applies on chat publish.",
+  args: {
+    id: { type: "positional", description: "Campaign id/URN, or li_temp_* ref staged in this chat", required: true },
+    ...writeAccountArgs,
+    name: { type: "string", description: "New name", required: false },
+    objective: { type: "string", description: "New objective", required: false },
+    "cost-type": { type: "string", description: "CPC|CPM|CPV", required: false },
+    bid: { type: "string", description: "New manual bid", required: false },
+    "daily-budget": { type: "string", description: "New daily budget", required: false },
+    "total-budget": { type: "string", description: TOTAL_BUDGET_HELP, required: false },
+    currency: {
+      type: "string",
+      description: "3-letter currency code (defaults to the ad account currency)",
+      required: false
+    },
+    start: { type: "string", description: "New schedule start", required: false },
+    end: { type: "string", description: "New schedule end", required: false },
+    "targeting-file": { type: "string", description: "JSON file with replacement targetingCriteria", required: false },
+    "audience-expansion": { type: "string", description: "on|off", required: false },
+    lan: { type: "string", description: "on|off", required: false },
+    ctv: { type: "string", description: "on|off", required: false },
+    "creative-selection": { type: "string", description: "OPTIMIZED|ROUND_ROBIN", required: false },
+    "political-intent": {
+      type: "string",
+      description: "NOT_POLITICAL|POLITICAL|NOT_DECLARED \u2014 corrects the ad set's political-advertising declaration; leave it out to keep the current one",
+      required: false
+    },
+    status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED", required: false },
+    optimization: {
+      type: "string",
+      description: "optimizationTargetType \u2014 NONE (manual, default)|ENHANCED_CONVERSION|MAX_LEAD|MAX_QUALIFIED_LEAD|MAX_CONVERSION|MAX_CLICK|MAX_IMPRESSION|MAX_REACH|MAX_VIDEO_VIEW (CPM)|TARGET_COST_PER_CLICK|TARGET_COST_PER_IMPRESSION|TARGET_COST_PER_VIDEO_VIEW|CAP_COST_AND_MAXIMIZE_LEADS|\u2026_CLICKS|\u2026_IMPRESSIONS|\u2026_VIDEO_VIEWS (CPM); target cost and cost cap need --bid",
+      required: false
+    },
+    format: {
+      type: "string",
+      description: "Ad format, create-only: STANDARD_UPDATE|SINGLE_VIDEO|CAROUSEL|TEXT_AD|SPOTLIGHT|FOLLOW_COMPANY|JOBS|SPONSORED_INMAIL|SPONSORED_MESSAGE|SPONSORED_UPDATE_EVENT|SPONSORED_UPDATE_NATIVE_DOCUMENT",
+      required: false
+    },
+    pacing: { type: "string", description: "LIFETIME|ACCELERATED, create-only", required: false },
+    "frequency-cap": {
+      type: "string",
+      description: "At most N impressions per member a week (3\u201330), Brand awareness only",
+      required: false
+    },
+    file: { type: "string", description: "JSON file with fields to change", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.campaigns.exclude-companies",
+  description: "Stop a live ad set reaching some companies (customers, open deals, competitors). Add-only \u2014 never removes an exclusion. At publish Baker re-reads the ad set and merges into its targeting as it stands then, keeping audience, locations and every existing exclusion. --org takes company ids (as `companies` / `top-companies` print them) or urn:li:organization URNs, comma-separated, up to 200 per call; a longer list goes into a company-list audience passed to --segment. Staged until publish.",
+  args: {
+    id: {
+      type: "positional",
+      description: "Ad set (campaign) id or URN \u2014 must already be on LinkedIn",
+      required: true
+    },
+    ...writeAccountArgs,
+    org: {
+      type: "string",
+      description: "Company ids or urn:li:organization URNs, comma-separated \u2014 e.g. 1035,1441",
+      required: false
+    },
+    segment: {
+      type: "string",
+      description: "Matched audiences, comma-separated: urn:li:dmpSegment:N / urn:li:adSegment:N or a li_temp_* ref",
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.campaigns.url-params",
+  description: "Start here for UTMs: stage the URL tracking parameters on an ad set. LinkedIn appends them to the link of EVERY ad in the ad set, including ads already running, so this is the level to set campaign-wide UTMs at \u2014 editing each ad's landing URL instead risks the same key landing twice. For a value that never varies across the whole account, set it once with `account url-params` instead; LinkedIn appends BOTH levels, so a key set at both lands in the URL twice. REPLACES the ad set's whole parameter set \u2014 LinkedIn does not merge, so read `ads.linkedin.url-params` first and re-send every pair that should survive. --param takes fixed values (repeatable or &-joined); --dynamic takes a value LinkedIn fills in per ad (ACCOUNT_ID, ACCOUNT_NAME, CAMPAIGN_GROUP_ID, CAMPAIGN_GROUP_NAME, CAMPAIGN_ID, CAMPAIGN_NAME, CREATIVE_ID, CREATIVE_NAME). Applies on chat publish; message and conversation ads are unaffected.",
+  args: {
+    id: { type: "positional", description: "Ad set (campaign) id or URN", required: true },
+    ...writeAccountArgs,
+    param: {
+      type: "string",
+      description: 'Fixed key=value, repeatable or &-joined \u2014 e.g. "utm_source=linkedin&utm_medium=paid-social"',
+      required: false
+    },
+    dynamic: {
+      type: "string",
+      description: "key=PLACEHOLDER filled in per ad, repeatable \u2014 e.g. utm_campaign=CAMPAIGN_NAME",
+      required: false
+    },
+    clear: { type: "boolean", description: "Remove every tracking parameter from this ad set", required: false },
+    file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.url-params",
+  description: "Read the URL tracking parameters in effect: the ad account's, optionally every ad set's, and the keys set at BOTH levels \u2014 which LinkedIn appends twice into the served URL. Run this BEFORE setting UTMs on an ad set, because whatever the account already carries is appended on top. Account-only by default (there is no batch read, so each ad set costs its own call); --ad-sets sweeps them, capped, and the response says how many of how many were examined.",
+  args: {
+    "account-id": { type: "string", description: "Numeric ID or urn:li:sponsoredAccount:N", required: false },
+    "account-urn": { type: "string", description: "Alias for --account-id", required: false },
+    "ad-sets": { type: "boolean", description: "Also read every ad set's parameters", required: false },
+    "campaign-ids": {
+      type: "string",
+      description: "Comma-separated ad set ids to read instead of all",
+      required: false
+    },
+    "collisions-only": { type: "boolean", description: "Only the keys set at more than one level", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.account.url-params",
+  description: "Stage the URL tracking parameters on the whole AD ACCOUNT \u2014 LinkedIn appends them to the link of every ad in every ad set, including ads already running. Use it for the values that never vary across the account (utm_source, utm_medium, an agency tag); anything naming a specific ad set belongs on the ad set (`campaigns url-params`), because LinkedIn appends BOTH levels and a key set at both lands in the URL twice. REPLACES the account's whole parameter set \u2014 LinkedIn does not merge, so read `ads.linkedin.url-params` first and re-send every pair that should survive. --param takes fixed values (repeatable or &-joined); --dynamic takes a value LinkedIn fills in per ad (ACCOUNT_ID, ACCOUNT_NAME, CAMPAIGN_GROUP_ID, CAMPAIGN_GROUP_NAME, CAMPAIGN_ID, CAMPAIGN_NAME, CREATIVE_ID, CREATIVE_NAME). Applies on chat publish; message and conversation ads are unaffected.",
+  args: {
+    ...writeAccountArgs,
+    param: {
+      type: "string",
+      description: 'Fixed key=value, repeatable or &-joined \u2014 e.g. "utm_source=linkedin&utm_medium=paid-social"',
+      required: false
+    },
+    dynamic: {
+      type: "string",
+      description: "key=PLACEHOLDER filled in per ad, repeatable \u2014 e.g. utm_campaign=CAMPAIGN_NAME",
+      required: false
+    },
+    clear: { type: "boolean", description: "Remove every tracking parameter set on the ad account", required: false },
+    file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
+  }
+});
+var statusSugarArgs = {
+  id: {
+    type: "positional",
+    description: "Entity id or URN \u2014 comma-separate several to change them all in one call",
+    required: false
+  },
+  "ids-file": { type: "string", description: "File of ids, one per line or comma-separated", required: false },
+  ...writeAccountArgs
+};
+var MULTI_ID_NOTE = "Takes one id or many: comma-separate the ids, or pass --ids-file. Several ids stage together as one set \u2014 all of them or none. The list form is for real ids/URNs only: a li_temp_* ref AMENDS what this chat already staged, and an amend must be passed on its own.";
+registerSchema({
+  command: "ads.linkedin.campaigns.pause",
+  description: `Stage pausing a campaign (status \u2192 PAUSED on publish). ${MULTI_ID_NOTE}`,
+  args: statusSugarArgs
+});
+registerSchema({
+  command: "ads.linkedin.campaigns.resume",
+  description: `Stage resuming a paused campaign (status \u2192 ACTIVE on publish). ${MULTI_ID_NOTE}`,
+  args: statusSugarArgs
+});
+registerSchema({
+  command: "ads.linkedin.campaigns.archive",
+  description: `Stage archiving a campaign (status \u2192 ARCHIVED on publish). ${MULTI_ID_NOTE}`,
+  args: statusSugarArgs
+});
+registerSchema({
+  command: "ads.linkedin.campaign-groups.pause",
+  description: `Stage pausing a campaign group. ${MULTI_ID_NOTE}`,
+  args: statusSugarArgs
+});
+registerSchema({
+  command: "ads.linkedin.campaign-groups.resume",
+  description: `Stage resuming a campaign group. ${MULTI_ID_NOTE}`,
+  args: statusSugarArgs
+});
+registerSchema({
+  command: "ads.linkedin.creatives.pause",
+  description: `Stage pausing a creative (intendedStatus \u2192 PAUSED on publish). Playbook early-kill rule: >30 impressions with 0 clicks. ${MULTI_ID_NOTE}`,
+  args: statusSugarArgs
+});
+registerSchema({
+  command: "ads.linkedin.creatives.resume",
+  description: `Stage resuming a paused creative. ${MULTI_ID_NOTE}`,
+  args: statusSugarArgs
+});
+for (const [entity, what] of [
+  ["campaign-groups", "campaign"],
+  ["campaigns", "ad set"],
+  ["creatives", "ad"]
+]) {
+  registerSchema({
+    command: `ads.linkedin.${entity}.delete`,
+    description: `Stage deleting a ${what} that is still a DRAFT on LinkedIn; anything that has left draft is paused or archived instead. Deletes run last at publish, ads before ad sets before campaigns. ${MULTI_ID_NOTE}`,
+    args: statusSugarArgs
+  });
+}
+var duplicateArgs = {
+  id: { type: "positional", description: "Source id or URN", required: true },
+  ...writeAccountArgs,
+  name: { type: "string", description: "Name for the copy", required: false },
+  file: { type: "string", description: "JSON file with field overrides for the copy", required: false }
+};
+registerSchema({
+  command: "ads.linkedin.campaigns.duplicate",
+  description: "Stage a copy of an existing campaign as a new DRAFT create (playbook: duplicate, never link-to-original). Reads the source at stage time; override fields via --name/--file.",
+  args: duplicateArgs
+});
+registerSchema({
+  command: "ads.linkedin.campaign-groups.duplicate",
+  description: "Stage a copy of an existing campaign group as a new DRAFT create.",
+  args: duplicateArgs
+});
+registerSchema({
+  command: "ads.linkedin.creatives.duplicate",
+  description: "Stage a copy of an existing ad, optionally with new content. Direct-content ads (text/spotlight/follower/jobs) copy field-by-field, so a copy is how their immutable content changes (they can also update in place via creatives.update). Post-based ads re-sponsor the SAME post \u2014 the post owns the copy, media and destination, so content flags are rejected here: stage creatives.create with the new content instead, then pause the old ad. --replace stages pausing the original, gated on the new ad publishing successfully, and the copy inherits the source's status.",
+  args: {
+    id: { type: "positional", description: "Source creative id or URN", required: true },
+    ...writeAccountArgs,
+    campaign: { type: "string", description: "Stage the copy under a different ad set", required: false },
+    "intended-status": { type: "string", description: "Status for the copy (default DRAFT)", required: false },
+    replace: { type: "boolean", description: "Also pause the original once the new ad publishes", required: false },
+    headline: { type: "string", description: "New headline", required: false },
+    description: { type: "string", description: "New description (text/spotlight)", required: false },
+    intro: { type: "string", description: "New commentary / intro text", required: false },
+    "landing-url": { type: "string", description: "New https destination URL", required: false },
+    cta: { type: "string", description: "New CTA", required: false },
+    "cta-label": { type: "string", description: "Spotlight custom CTA label", required: false },
+    "image-id": { type: "string", description: "Baker image library id", required: false },
+    "image-urn": { type: "string", description: "Existing urn:li:image:*", required: false },
+    "video-id": {
+      type: "string",
+      description: "Baker video library id (`baker videos`) \u2014 uploaded to LinkedIn at publish; a first publish may ask to retry while the full-quality copy is prepared",
+      required: false
+    },
+    "video-urn": { type: "string", description: "Existing urn:li:video:*", required: false },
+    "logo-image-id": { type: "string", description: "Baker image id for the logo", required: false },
+    title: { type: "string", description: "Media title", required: false },
+    file: { type: "string", description: "JSON file with field overrides for the copy", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.creatives.create",
+  description: "Stage a new creative (ad). Formats: image|video|text|spotlight|follower|document|carousel|conversation|tla|jobs|event|article. Media: --image-id references the Baker library (`baker images`) and uploads to LinkedIn at publish, any format; --video-id uploads a Baker library video at publish; --image-urn/--video-urn reference media already on LinkedIn. Limits: headline \u226470 (text ads \u226425), intro soft-truncates at 600 chars, landing URL must be https. Complex formats take --file with the full content object; conversation ads take --file with the message flow ({message: {subject, body (\u2264500), senderName?, buttons \u22645 \xD7 {label \u226425, type NESTED|LANDING_PAGE|LEAD_FORM, nestedMessage?|landingPageUrl?|leadForm?}}}, \u226425 messages) and arrive from --sender (default: whoever connected LinkedIn). --format tla boosts an existing post (Thought Leader ad): name it with --post <Baker post id from `baker posts list`>, --post-url <any link to the post>, or --post-urn <urn:li:share|ugcPost:*>. --format document (in a SPONSORED_UPDATE_NATIVE_DOCUMENT ad set) takes --document <Baker document name> or --document-url <PDF link> and --title; gate it with --lead-form + --preview-pages N. Staged until publish.",
+  args: {
+    ...writeAccountArgs,
+    campaign: { type: "string", description: "Campaign id/URN or li_temp_* ref", required: true },
+    format: {
+      type: "string",
+      description: "image|video|text|spotlight|follower|document|carousel|conversation|tla|jobs|event|article",
+      required: true
+    },
+    "image-id": { type: "string", description: "Baker image library id", required: false },
+    "image-urn": { type: "string", description: "Existing urn:li:image:*", required: false },
+    "video-id": {
+      type: "string",
+      description: "Baker video library id (`baker videos`) \u2014 uploaded to LinkedIn at publish; a first publish may ask to retry while the full-quality copy is prepared",
+      required: false
+    },
+    "video-urn": { type: "string", description: "Existing urn:li:video:*", required: false },
+    "logo-image-id": { type: "string", description: "Baker image id for the logo", required: false },
+    intro: { type: "string", description: "Commentary / intro text", required: false },
+    headline: { type: "string", description: "Headline", required: false },
+    description: { type: "string", description: "Description (text/spotlight)", required: false },
+    "landing-url": { type: "string", description: "https destination URL", required: false },
+    cta: { type: "string", description: "LEARN_MORE|REQUEST_DEMO|SIGN_UP|REGISTER|DOWNLOAD|\u2026", required: false },
+    "cta-label": { type: "string", description: "Spotlight CTA label (\u226418 chars)", required: false },
+    post: {
+      type: "string",
+      description: "TLA: the post to sponsor, by its Baker post id (`baker posts list`). Staging refuses one that can't run as an ad.",
+      required: false
+    },
+    "post-urn": {
+      type: "string",
+      description: "TLA: the post to sponsor by its URN \u2014 urn:li:share|ugcPost:*",
+      required: false
+    },
+    "post-url": {
+      type: "string",
+      description: "TLA: any link to the post, normal or embed \u2014 Baker reads it and adds it to Posts",
+      required: false
+    },
+    sender: {
+      type: "string",
+      description: "Conversation ads: urn:li:person:* sender from `account-users` (default: whoever connected LinkedIn)",
+      required: false
+    },
+    document: {
+      type: "string",
+      description: "Document ads: a Baker document's folder name (src/documents/<name>), uploaded at publish",
+      required: false
+    },
+    "document-url": {
+      type: "string",
+      description: "Document ads: https link to a PDF, PowerPoint or Word file (\u2264100 MB, \u2264300 pages)",
+      required: false
+    },
+    "document-urn": { type: "string", description: "Document ads: existing urn:li:document:*", required: false },
+    "preview-pages": {
+      type: "string",
+      description: "Gated document ads: pages shown before the lead gen form (needs --lead-form)",
+      required: false
+    },
+    "event-urn": {
+      type: "string",
+      description: "Event ads: the LinkedIn event to sponsor (urn:li:event:*)",
+      required: false
+    },
+    "article-url": {
+      type: "string",
+      description: "Article ads: https URL of the article/newsletter to sponsor",
+      required: false
+    },
+    "thumbnail-image-id": {
+      type: "string",
+      description: "Article ads: Baker image id for the link thumbnail",
+      required: false
+    },
+    "thumbnail-urn": { type: "string", description: "Article ads: existing urn:li:image:* thumbnail", required: false },
+    "intended-status": {
+      type: "string",
+      description: "DRAFT|ACTIVE (default DRAFT) \u2014 a new ad can't start PAUSED; DRAFT holds it back",
+      required: false
+    },
+    title: {
+      type: "string",
+      description: "Media title (image/video), article title, or document title",
+      required: false
+    },
+    "lead-form": {
+      type: "string",
+      description: "Lead gen form the ad opens (image|video|carousel|document|tla): li_temp_* from `lead-forms create` or a form id from `lead-forms`. Required in a LEAD_GENERATION ad set; replaces --landing-url",
+      required: false
+    },
+    "lead-form-button": {
+      type: "string",
+      description: "APPLY|DOWNLOAD|VIEW_QUOTE|LEARN_MORE|SIGN_UP (default)|SUBSCRIBE|REGISTER|REQUEST_DEMO|JOIN|ATTEND|UNLOCK_FULL_DOCUMENT|SHOP_NOW|BUY_NOW|SEE_MORE",
+      required: false
+    },
+    file: { type: "string", description: "JSON file with the full content object", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.creatives.update",
+  description: `Stage changes to an existing creative. Direct-content ads (text/spotlight/follower/jobs) update copy/media/URL IN PLACE \u2014 pass only the changed fields (headline, description, landing-url, image-id, \u2026); the ad's current content carries over. Post-based ads (image/video/carousel/\u2026) sponsor a post that owns the copy, media and destination \u2014 neither this command nor creatives.duplicate can change it; stage creatives.create with the new content, then pause the old ad. Passing a li_temp_* ref AMENDS the creative staged in this chat instead. ${MULTI_ID_NOTE} Applies on chat publish.`,
+  args: {
+    id: {
+      type: "positional",
+      description: "Creative id/URN \u2014 comma-separate several. A li_temp_* ref amends what this chat staged and must be passed on its own.",
+      required: false
+    },
+    "ids-file": {
+      type: "string",
+      description: "File of creative ids, one per line or comma-separated",
+      required: false
+    },
+    ...writeAccountArgs,
+    "intended-status": { type: "string", description: "ACTIVE|PAUSED|ARCHIVED|DRAFT", required: false },
+    name: { type: "string", description: "New creative name", required: false },
+    campaign: {
+      type: "string",
+      description: "Re-parent to a different ad set (id/URN or li_temp_*) \u2014 staged creatives only",
+      required: false
+    },
+    headline: { type: "string", description: "New headline", required: false },
+    intro: { type: "string", description: "Commentary / intro text", required: false },
+    description: { type: "string", description: "Description (text/spotlight)", required: false },
+    "landing-url": { type: "string", description: "New https destination URL", required: false },
+    cta: { type: "string", description: "New CTA", required: false },
+    "cta-label": { type: "string", description: "Spotlight custom CTA label", required: false },
+    "image-id": { type: "string", description: "Baker image library id", required: false },
+    "image-urn": { type: "string", description: "Existing urn:li:image:*", required: false },
+    "video-id": {
+      type: "string",
+      description: "Baker video library id (`baker videos`) \u2014 uploaded to LinkedIn at publish; a first publish may ask to retry while the full-quality copy is prepared",
+      required: false
+    },
+    "video-urn": { type: "string", description: "Existing urn:li:video:*", required: false },
+    "logo-image-id": { type: "string", description: "Baker image id for the logo", required: false },
+    "thumbnail-image-id": {
+      type: "string",
+      description: "Baker image id for the article thumbnail",
+      required: false
+    },
+    "thumbnail-urn": { type: "string", description: "Existing urn:li:image:* thumbnail", required: false },
+    title: { type: "string", description: "Media or article title", required: false },
+    "lead-form": {
+      type: "string",
+      description: "Lead gen form the ad opens (image|video|carousel|document|tla): li_temp_* from `lead-forms create` or a form id from `lead-forms`. Required in a LEAD_GENERATION ad set; replaces --landing-url",
+      required: false
+    },
+    "lead-form-button": {
+      type: "string",
+      description: "APPLY|DOWNLOAD|VIEW_QUOTE|LEARN_MORE|SIGN_UP (default)|SUBSCRIBE|REGISTER|REQUEST_DEMO|JOIN|ATTEND|UNLOCK_FULL_DOCUMENT|SHOP_NOW|BUY_NOW|SEE_MORE",
+      required: false
+    },
+    file: { type: "string", description: "JSON file with fields to change; flags override file keys", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.audiences.create",
+  description: "Stage a new matched audience. company-list/user-list take --list-file (CSV with header; companies by companyName, domain and the LinkedIn page \u2014 a linkedinCompanyPageUrl column (LinkedIn's own template; https://www.linkedin.com/company/<slug>) or organizationUrn \u2014 which matches the company exactly, so keep it, never drop it; email column is SHA-256 hashed locally). LinkedIn needs 300+ MATCHED members to serve \u2014 a contact list needs well above 300 rows; a company list counts every employee of its companies. retargeting/engagement configs go in --file. Staged until publish.",
+  args: {
+    ...writeAccountArgs,
+    name: { type: "string", description: "Audience name (\u2264100 chars)", required: true },
+    type: { type: "string", description: "company-list|user-list|retargeting|engagement", required: true },
+    "list-file": { type: "string", description: "CSV file with the list rows", required: false },
+    file: {
+      type: "string",
+      description: "JSON raw source config for retargeting/engagement \u2014 sourcePlatform, type USER, and engagementRules (engagementSource, engagementTrigger, timeFrame)",
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.audiences.upload",
+  description: "Stage REPLACING an audience's list with a new file (LinkedIn keeps one list per audience and has no row-level add or remove for this app): send the whole list \u2014 to add people, the old rows plus the new; to remove people, the list without them. Same CSV rules as audiences.create.",
+  args: {
+    id: { type: "positional", description: "Segment URN/id or li_temp_* ref", required: true },
+    ...writeAccountArgs,
+    "list-file": {
+      type: "string",
+      description: "CSV file with the WHOLE list the audience should hold",
+      required: true
+    }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.conversions.create",
+  description: "Stage a new conversion rule. Playbook defaults: --post-click-window 30 --view-window 7, counting ONE_TIME_EACH_MEMBER for leads. Staged until publish.",
+  args: {
+    ...writeAccountArgs,
+    name: { type: "string", description: "Rule name", required: true },
+    type: {
+      type: "string",
+      description: "Conversion type. Common: LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, SIGN_UP, DOWNLOAD, PURCHASE, KEY_PAGE_VIEW, ADD_TO_CART, BOOK_APPOINTMENT, SUBMIT_APPLICATION, OTHER \u2014 `baker schema ads.linkedin.conversions.create` lists all 34",
+      required: true
+    },
+    method: { type: "string", description: "INSIGHT_TAG|CONVERSIONS_API", required: true },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
+    "attribution-type": {
+      type: "string",
+      description: "LAST_TOUCH_BY_CAMPAIGN|LAST_TOUCH_BY_CONVERSION",
+      required: false
+    },
+    "associate-all-campaigns": {
+      type: "boolean",
+      description: "Auto-associate with active campaigns",
+      required: false
+    },
+    file: { type: "string", description: "JSON payload file (e.g. urlMatchRuleExpression)", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.conversions.update",
+  description: "Stage changes to a conversion rule (windows, attribution, enabled, name). Applies on chat publish.",
+  args: {
+    id: { type: "positional", description: "Conversion rule id or URN", required: true },
+    ...writeAccountArgs,
+    name: { type: "string", description: "New name", required: false },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
+    "attribution-type": { type: "string", description: "New attribution type", required: false },
+    enabled: { type: "string", description: "on|off", required: false },
+    file: { type: "string", description: "JSON file with fields to change", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.conversions.associate-campaign",
+  description: "Count an existing conversion rule for one ad set. Which ad sets a rule counts for is a separate LinkedIn record, not a field on the rule \u2014 `conversions update` cannot change it, and `--associate-all-campaigns` exists only on create. Staged until publish.",
+  args: {
+    id: { type: "positional", description: "Conversion rule id or URN", required: true },
+    ...writeAccountArgs,
+    campaign: { type: "string", description: "Ad set (campaign) id or URN", required: true }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.conversions.dissociate-campaign",
+  description: "Stop counting an existing conversion rule for one ad set. Staged until publish.",
+  args: {
+    id: { type: "positional", description: "Conversion rule id or URN", required: true },
+    ...writeAccountArgs,
+    campaign: { type: "string", description: "Ad set (campaign) id or URN", required: true }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.lead-forms.create",
+  description: "Stage a new Lead Gen Form from a JSON file: {name, headline \u226460, description? \u2264160, privacyPolicyUrl, questions[] \u226412 (playbook: \u22644 for completion), thankYou?, legalDisclaimer?}. Staged until publish.",
+  args: {
+    ...writeAccountArgs,
+    file: { type: "string", description: "JSON form definition file", required: true },
+    name: { type: "string", description: "Override the form name", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.lead-forms.update",
+  description: "Stage changes to a Lead Gen Form. Once its ads are live LinkedIn keeps only the copy editable (headline, description, privacy policy URL, legal disclaimer, thank-you message and link) and the state. Copy is written in the form's own language. Applies on chat publish.",
+  args: {
+    id: { type: "positional", description: "Lead form id or URN", required: true },
+    ...writeAccountArgs,
+    name: { type: "string", description: "New form name", required: false },
+    state: { type: "string", description: "PUBLISHED|ARCHIVED", required: false },
+    headline: { type: "string", description: "Form headline (\u226460)", required: false },
+    description: { type: "string", description: "Form details text", required: false },
+    "privacy-policy-url": { type: "string", description: "https privacy policy URL", required: false },
+    "legal-disclaimer": { type: "string", description: "Custom legal disclaimer", required: false },
+    "thank-you-message": { type: "string", description: "Confirmation message", required: false },
+    "thank-you-url": { type: "string", description: "https link on the confirmation screen", required: false },
+    file: { type: "string", description: "JSON file with any of the fields above", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.lead-forms.list",
+  description: "List the ad account's lead gen forms \u2014 id, name, state (a DRAFT form can't serve), version, how many questions. --full spells out every form's questions and options; --form-id reads one form in full.",
+  args: {
+    ...writeAccountArgs,
+    "form-id": { type: "string", description: "Read one form (id or urn:li:leadGenForm:N)", required: false },
+    full: { type: "boolean", description: "Every form's questions and options", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.lead-forms.publish",
+  description: "Stage publishing a DRAFT lead gen form so ads that open it can serve. Applies on chat publish.",
+  args: { id: { type: "positional", description: "Lead form id or URN", required: true }, ...writeAccountArgs }
+});
+registerSchema({
+  command: "ads.linkedin.lead-forms.archive",
+  description: "Stage archiving a lead gen form \u2014 every ad that opens it stops serving. Applies on chat publish.",
+  args: { id: { type: "positional", description: "Lead form id or URN", required: true }, ...writeAccountArgs }
+});
+registerSchema({
+  command: "ads.linkedin.audiences.delete",
+  description: "Stage deleting a matched audience already on LinkedIn (its list and targetable twin go too). Refused by LinkedIn while a live ad set targets it. Applies on chat publish.",
+  args: {
+    id: { type: "positional", description: "Audience URN (urn:li:dmpSegment:\u2026) or id", required: true },
+    ...writeAccountArgs
+  }
+});
+registerSchema({
+  command: "ads.linkedin.account-users",
+  description: "Who works on the ad account and their Campaign Manager role; connectedLinkedin marks the person Baker publishes as \u2014 the default sender of a conversation ad.",
+  args: { ...writeAccountArgs }
+});
+registerSchema({
+  command: "ads.linkedin.conversions.upload",
+  description: "Stage CRM / offline conversions (deals won, qualified leads) into a Conversions API rule \u2014 LinkedIn credits the ads and bids toward them. --file is a CSV or JSON array: eventId (CRM id; LinkedIn counts a re-sent id once), happenedAt (ISO WITH timezone, last 90 days), and email, or firstName + lastName (+ companyName, title, countryCode), or liFatId; optional value + currency. Emails and names are hashed on the sandbox. \u22642,000 per upload; re-staging for the same rule replaces the rows. Applies on chat publish.",
+  args: {
+    id: { type: "positional", description: "Conversions API rule id", required: true },
+    ...writeAccountArgs,
+    file: { type: "string", description: "CSV or JSON file of conversions", required: true }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.revenue",
+  description: "LinkedIn revenue attribution: CRM deals credited to the ads \u2014 revenue won (USD), return on ad spend, deals won, win rate, average deal size, days to close \u2014 per campaign, campaign group or account. Needs the ad account in a Business Manager with Salesforce, Dynamics 365 or HubSpot connected. 30\u2013366 days within the last year (default last 90).",
+  args: {
+    ...writeAccountArgs,
+    pivot: { type: "string", description: "campaign (default)|campaign-group|account", required: false },
+    start: { type: "string", description: "First day, YYYY-MM-DD", required: false },
+    end: { type: "string", description: "Last day, YYYY-MM-DD (default today)", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.audiences.list",
+  description: "List matched audiences: status (BUILDING/READY), rows uploaded vs matched, targetingUrn (urn:li:adSegment:\u2026) for targeting and exclusions.",
+  args: { ...writeAccountArgs }
+});
+registerSchema({
+  command: "ads.linkedin.creatives.get",
+  description: "Read one ad as LinkedIn holds it: headline, intro text, landing URL, lead gen form, review status and rejection reasons, and why it isn't serving (notServingBecause).",
+  args: {
+    id: { type: "positional", description: "Creative id or urn:li:sponsoredCreative:N", required: true },
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.draft.list",
+  description: "Show every LinkedIn write op staged in this chat: ref, summary, dependencies, warnings, and post-publish results. Ops are invisible to the read commands until publish, and publishing reaches the real ad account \u2014 check here before finishing.",
+  args: {
+    json: {
+      type: "boolean",
+      description: "Print the raw JSON envelope instead of the readable tree",
+      required: false
+    },
+    chat: { type: "string", description: CHAT_READ_ARG_DESCRIPTION, required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.draft.remove",
+  description: "Drop one staged LinkedIn op from this chat's draft. Removing a create cascades to every op that depends on it (a campaign removal drops its staged creatives).",
+  args: {
+    ref: {
+      type: "positional",
+      description: "Op ref (li_temp_* for creates, target id/URN for updates)",
+      required: true
+    }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.draft.show",
+  description: "Print the full staged payload for one LinkedIn op \u2014 the receipt to verify a change looks right before publish (never truncated), and the only way to read back verbatim what an earlier chat wrote.",
+  args: {
+    ref: {
+      type: "positional",
+      description: "Op ref (li_temp_* for creates, target id/URN for updates)",
+      required: true
+    },
+    chat: { type: "string", description: CHAT_READ_ARG_DESCRIPTION, required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.draft.clear",
+  description: "Discard ALL staged LinkedIn ops in this chat's draft. Nothing applies on publish.",
+  args: {}
+});
+var experimentAccountArgs = { ...writeAccountArgs };
+registerSchema({
+  command: "ads.linkedin.experiments.list",
+  description: "List A/B tests: state, running (PENDING|RUNNING|ON_HOLD|STOPPED|ENDED), metric, dates, the two versions.",
+  args: experimentAccountArgs
+});
+registerSchema({
+  command: "ads.linkedin.experiments.get",
+  description: "One A/B test with LinkedIn's setup checks (ERROR blocks it) and the latest result (winner, p-value, intervals).",
+  args: { id: { type: "positional", description: "A/B test id", required: true }, ...experimentAccountArgs }
+});
+registerSchema({
+  command: "ads.linkedin.experiments.create",
+  description: "Stage an A/B test between two ad sets of one campaign (no shared budget), \u226490 days, winner on CPC|CPM|CPV|CPMS. Applies on chat publish.",
+  args: {
+    ...experimentAccountArgs,
+    name: { type: "string", description: "Test name", required: true },
+    description: { type: "string", description: "What is being tested", required: false },
+    "version-a": { type: "string", description: "Ad set for version A (id/URN/li_temp_*)", required: true },
+    "version-b": { type: "string", description: "Ad set for version B (id/URN/li_temp_*)", required: true },
+    "name-a": { type: "string", description: "Version A label", required: false },
+    "name-b": { type: "string", description: "Version B label", required: false },
+    "weight-a": { type: "string", description: "Version A audience share 1\u201399 (default 50)", required: false },
+    metric: { type: "string", description: "CPC|CPM|CPV|CPMS", required: true },
+    confidence: { type: "string", description: "51\u201399 (default 90)", required: false },
+    start: { type: "string", description: "Start date", required: true },
+    end: { type: "string", description: "End date (\u226490 days)", required: true },
+    "stop-at": { type: "string", description: "end-date|winner|never", required: false },
+    draft: { type: "boolean", description: "Set up but not running", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.experiments.update",
+  description: "Stage changes to an A/B test (name, description, end, confidence, stop-at). Applies on chat publish.",
+  args: {
+    id: { type: "positional", description: "A/B test id", required: true },
+    ...experimentAccountArgs,
+    name: { type: "string", description: "New name", required: false },
+    description: { type: "string", description: "New description", required: false },
+    end: { type: "string", description: "New end date", required: false },
+    confidence: { type: "string", description: "51\u201399", required: false },
+    "stop-at": { type: "string", description: "end-date|winner|never", required: false }
+  }
+});
+for (const [verb, what] of [
+  ["start", "Stage starting or resuming an A/B test."],
+  ["pause", "Stage pausing an A/B test (both ad sets pause)."],
+  ["end", "Stage ending an A/B test for good."]
+]) {
+  registerSchema({
+    command: `ads.linkedin.experiments.${verb}`,
+    description: `${what} Applies on chat publish.`,
+    args: { id: { type: "positional", description: "A/B test id", required: true }, ...experimentAccountArgs }
+  });
+}
+
+// src/commands/ads/linkedin/index.ts
+var linkedinCommand = defineCommand({
+  meta: {
+    name: "linkedin",
+    description: `LinkedIn Marketing API \u2014 AI-first command surface for B2B ad insights.
+
+Discovery:
+  baker ads linkedin accounts                                    \u2014 accounts in this company's connected scope
+  baker ads linkedin account --account-id 503001492              \u2014 single-account detail (currency, type, status)
+  baker ads linkedin url-params [--ad-sets]                      \u2014 UTMs in effect today, and keys set at two levels
+  baker ads linkedin account-users                               \u2014 who is on the ad account, their role, who connected LinkedIn
+
+Hierarchy (default ACTIVE-only \u2014 pass --all-statuses to widen):
+  baker ads linkedin campaign-groups --account-id 503001492
+  baker ads linkedin campaigns --account-id 503001492
+  baker ads linkedin campaigns --account-id 503001492 --campaign-group-id 12345
+  baker ads linkedin creatives --account-id 503001492 --campaign-id 67890
+  baker ads linkedin creatives get <id>                                \u2014 one ad: headline, landing URL, form, review, why not serving
+  baker ads linkedin lead-forms                                        \u2014 lead gen forms: state, version, questions
+
+Revenue (CRM deals credited to the ads; needs Business Manager + CRM):
+  baker ads linkedin revenue [--pivot campaign|campaign-group|account] [--start --end]
+
+Performance \u2014 the workhorse (3 axes):
+  baker ads linkedin analytics                                                      \u2014 defaults: level=account, intent=baseline, last_7d, DAILY
+  baker ads linkedin analytics --intent revenue --last-days 28
+  baker ads linkedin analytics --level campaign --campaign-id 1234 --pivot job-title \u2014 LinkedIn's superpower (per-title perf)
+  baker ads linkedin analytics --level campaign --campaign-id 1234 --pivot company   \u2014 top companies seeing the ad (ABM gold; names auto-resolved)
+  baker ads linkedin companies --last-months 12 --by month                           \u2014 which companies the ads reached, per month (ABM / warm accounts)
+  baker ads linkedin resolve --urns urn:li:organization:17719                         \u2014 resolve org URNs to company names
+  baker ads linkedin analytics --level campaign --campaign-id 1234 --intent ranking  \u2014 fatigue: derives frequency
+  baker ads linkedin analytics --list-intents
+  baker ads linkedin analytics --list-pivots
+
+Staged writes (never hit LinkedIn directly \u2014 ops stage on this chat's draft,
+show in the dashboard as pending LinkedIn changes, and apply when the chat is
+published, at which point they reach the real ad account):
+  baker ads linkedin account url-params                             \u2014 UTMs for every ad in the account
+  baker ads linkedin campaign-groups create|update|pause|resume|duplicate|delete
+  baker ads linkedin campaigns create|update|pause|resume|archive|duplicate|delete
+  baker ads linkedin creatives create|update|pause|resume|duplicate|delete
+  baker ads linkedin audiences create|upload|delete
+  baker ads linkedin conversions create|update
+  baker ads linkedin lead-forms create|update|publish|archive
+  baker ads linkedin experiments create|update|start|pause|end    \u2014 A/B test two ad sets (list/get to read)
+  baker ads linkedin draft list                                    \u2014 review staged ops
+  baker ads linkedin draft remove <ref>                            \u2014 undo one (draft clear: all)
+
+Account ID format:
+  --account-id accepts numeric (503001492) or URN (urn:li:sponsoredAccount:503001492).
+  Set BAKER_LINKEDIN_AD_ACCOUNT_ID env to skip --account-id on every call.
+Full guide: __tooling__/docs/tools/baker/ads-linkedin.md`
+  },
+  subCommands: {
+    accounts: () => import("./accounts-CN32WCRF.js").then((m) => m.accountsCommand),
+    account: () => import("./account-QG2AFCRO.js").then((m) => m.accountCommand),
+    "account-users": () => import("./account-users-TTWSAGAL.js").then((m) => m.accountUsersCommand),
+    "campaign-groups": () => import("./campaign-groups-FUJEB5LG.js").then((m) => m.campaignGroupsCommand),
+    campaigns: () => import("./campaigns-CGYH7I2R.js").then((m) => m.campaignsCommand),
+    creatives: () => import("./creatives-HJ2R6HRF.js").then((m) => m.creativesCommand),
+    audiences: () => import("./write-commands-RSN3MPBW.js").then((m) => m.audiencesCommand),
+    "lead-forms": () => import("./write-commands-RSN3MPBW.js").then((m) => m.leadFormsCommand),
+    experiments: () => import("./experiments-CQMEMZXO.js").then((m) => m.experimentsCommand),
+    draft: () => import("./draft-ZTOUHIXC.js").then((m) => m.linkedinDraftCommand),
+    analytics: () => import("./analytics-BG72H654.js").then((m) => m.analyticsCommand),
+    demographics: () => import("./demographics-YQRCDSKX.js").then((m) => m.demographicsCommand),
+    companies: () => import("./companies-KVOWGAFU.js").then((m) => m.companiesCommand),
+    "top-companies": () => import("./top-companies-672JEIYA.js").then((m) => m.topCompaniesCommand),
+    resolve: () => import("./resolve-7DTGRVQ5.js").then((m) => m.resolveCommand),
+    facets: () => import("./facets-FVJHPNQE.js").then((m) => m.facetsCommand),
+    "audience-size": () => import("./audience-size-3J4WYUTM.js").then((m) => m.audienceSizeCommand),
+    "bid-pricing": () => import("./bid-pricing-4BJ4HU3F.js").then((m) => m.bidPricingCommand),
+    forecast: () => import("./forecast-7I6YKTYU.js").then((m) => m.forecastCommand),
+    leads: () => import("./leads-ZDH4PLRE.js").then((m) => m.leadsCommand),
+    revenue: () => import("./revenue-TXR2Z3LQ.js").then((m) => m.revenueCommand),
+    conversions: () => import("./conversions-VFSX6NYO.js").then((m) => m.conversionsCommand),
+    conversation: () => import("./conversation-CCW2J2G6.js").then((m) => m.conversationCommand),
+    audit: () => import("./audit-QC4VORTD.js").then((m) => m.auditCommand),
+    "url-params": () => import("./url-params-DUEOK2Y3.js").then((m) => m.urlParamsCommand)
+  }
+});
+export {
+  linkedinCommand
+};
+//# sourceMappingURL=linkedin-FTZZWW6D.js.map