@koda-sl/baker-cli 0.169.2 → 0.173.0-dev.6ecd65d29

package/dist/cli.js

@@ -36,7 +36,7 @@ import {
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-CG6OTNUU.js";
+} from "./chunk-K424D3CY.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -2983,6 +2983,117 @@ var hubspotFormsViewResponseSchema = z10.object({
     external: hubspotFormNodeExternalSchema.optional()
   })
 });
+var HUBSPOT_MISSING_GRANT_MARKER = "has not granted access to";
+var hubspotFormSubmissionsRequestSchema = z10.object({
+  formId: z10.string().min(1),
+  /** Window in days, counted back from now. */
+  days: z10.number().int().min(1).max(365).default(30),
+  /** Include each submission's field values — personal data, so opt-in. */
+  full: z10.boolean().optional()
+});
+var hubspotSubmissionValueSchema = z10.object({ name: z10.string(), value: z10.string() });
+var hubspotFormSubmissionsResponseSchema = z10.object({
+  ok: z10.literal(true),
+  data: z10.object({
+    /** Submissions read from HubSpot, across every page fetched. */
+    total: z10.number().int(),
+    /** Submissions inside the requested window. */
+    inWindow: z10.number().int(),
+    lastSubmittedAt: z10.number().nullable(),
+    byDay: z10.array(z10.object({ day: z10.string(), count: z10.number().int() })),
+    /**
+     * True when the page budget ran out before the window was fully covered, so
+     * `inWindow` is a floor rather than a count. Reported rather than hidden:
+     * a truncated read must not be mistaken for a complete one.
+     */
+    truncated: z10.boolean(),
+    /** Present only when `full` was requested; null otherwise. */
+    submissions: z10.array(
+      z10.object({
+        submittedAt: z10.number(),
+        pageUrl: z10.string().nullable(),
+        values: z10.array(hubspotSubmissionValueSchema)
+      })
+    ).nullable()
+  })
+});
+var hubspotWorkflowsListRequestSchema = z10.object({
+  search: z10.string().min(1).max(200).optional(),
+  /** Only workflows that are currently on. */
+  enabledOnly: z10.boolean().optional()
+});
+var hubspotWorkflowSummarySchema = z10.object({
+  id: z10.string(),
+  name: z10.string(),
+  enabled: z10.boolean(),
+  type: z10.string().nullable(),
+  updatedAt: z10.number().nullable()
+});
+var hubspotWorkflowsListResponseSchema = z10.object({
+  ok: z10.literal(true),
+  data: z10.object({ workflows: z10.array(hubspotWorkflowSummarySchema) })
+});
+var hubspotContactsSummaryRequestSchema = z10.object({
+  /** Window in days, counted back from now, over contact creation date. */
+  days: z10.number().int().min(1).max(365).default(30)
+});
+var hubspotContactsSummaryResponseSchema = z10.object({
+  ok: z10.literal(true),
+  data: z10.object({
+    total: z10.number().int(),
+    withOwner: z10.number().int(),
+    withoutOwner: z10.number().int(),
+    byStage: z10.array(z10.object({ stage: z10.string(), count: z10.number().int() })),
+    /** True when the page budget ran out, so the counts are floors. */
+    truncated: z10.boolean()
+  })
+});
+var hubspotContactLookupRequestSchema = z10.object({
+  email: z10.string().min(1).max(320)
+});
+var hubspotContactLookupResponseSchema = z10.object({
+  ok: z10.literal(true),
+  data: z10.object({
+    /** False means the lead never reached the CRM — a finding, not an error. */
+    found: z10.boolean(),
+    contact: z10.object({
+      id: z10.string(),
+      lifecycleStage: z10.string().nullable(),
+      ownerId: z10.string().nullable(),
+      createdAt: z10.string().nullable()
+    }).nullable(),
+    deals: z10.array(z10.object({ id: z10.string(), stage: z10.string().nullable(), pipeline: z10.string().nullable() })),
+    /**
+     * The account the contact was filed under. In B2B a workflow usually
+     * creates it on contact creation, so its absence is a finding — but only
+     * when `companyReadable` is true.
+     */
+    company: z10.object({ id: z10.string(), name: z10.string().nullable(), domain: z10.string().nullable() }).nullable(),
+    /**
+     * False when the connection never granted company access, which makes
+     * `company: null` unknown rather than absent. Company access is granted
+     * separately from contact access, so one can be present without the other.
+     */
+    companyReadable: z10.boolean()
+  })
+});
+var hubspotPipelinesListRequestSchema = z10.object({});
+var hubspotPipelineStageSchema = z10.object({
+  id: z10.string(),
+  label: z10.string(),
+  /** HubSpot's win probability for the stage, as it returns it (a decimal string). */
+  probability: z10.string().nullable()
+});
+var hubspotPipelineSchema = z10.object({
+  id: z10.string(),
+  label: z10.string(),
+  /** Ordered as they appear in HubSpot, so the sequence is the real one. */
+  stages: z10.array(hubspotPipelineStageSchema)
+});
+var hubspotPipelinesListResponseSchema = z10.object({
+  ok: z10.literal(true),
+  data: z10.object({ pipelines: z10.array(hubspotPipelineSchema) })
+});
 var hubspotMeetingFieldSchema = z10.object({
   name: z10.string(),
   label: z10.string(),
@@ -9778,1394 +9889,1161 @@ Full guide: __tooling__/docs/tools/baker/ads-google.md`
 // src/commands/ads/linkedin/index.ts
 import { defineCommand as defineCommand51 } from "citty";
 
-// src/commands/ads/linkedin/schemas.ts
-registerSchema({
-  command: "ads.linkedin.accounts",
-  description: "List LinkedIn ad accounts in the company's connected scope. Pass --include-all to list every account the OAuth token can see.",
-  args: {
-    "include-all": { type: "boolean", description: "Ignore picker scope", required: false },
-    "no-cache": { type: "boolean", description: "Skip CLI-side cache", required: false },
-    "skip-cache": { type: "boolean", description: "Bypass server-side cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
-  }
-});
-registerSchema({
-  command: "ads.linkedin.account",
-  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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+// src/commands/ads/linkedin/write-shared.ts
+import { createHash } from "crypto";
+import { readFileSync as readFileSync4 } from "fs";
+
+// src/commands/ads/linkedin/shared.ts
+var DAY_MS2 = 864e5;
+function handleLinkedinError(err) {
+  if (err instanceof ApiError) {
+    if (err.code === "UNAUTHORIZED") {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    if (err.code === "NOT_FOUND") {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    if (isNoAccountsSelectedError(err.code, err.message)) {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    const explanation = explainLinkedinError(err);
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: {
+          action: explanation.action,
+          explanation: explanation.message,
+          correctedCommand: explanation.correctedCommand
+        },
+        retryable: err.code === "RATE_LIMITED" || err.code === "INTERNAL_ERROR"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
   }
-});
-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: "CSV of statuses", required: false },
-    limit: { type: "string", description: "Max rows (default 500)", required: false },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  const message = err instanceof Error ? err.message : "Unexpected error";
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message } });
+  process.exit(1);
+}
+function isNoAccountsSelectedError(code, message) {
+  return code === "VALIDATION_ERROR" && /no linkedin ad accounts selected/i.test(message);
+}
+function explainLinkedinError(err) {
+  const lower = err.message.toLowerCase();
+  if (err.code === "VALIDATION_ERROR" && lower.includes("granularity") && lower.includes("daily")) {
+    return {
+      action: "retry_with_flag",
+      message: "LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.",
+      correctedCommand: void 0
+    };
   }
-});
-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: "CSV of statuses", required: false },
-    limit: { type: "string", description: "Max rows", required: false },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  if (err.code === "RATE_LIMITED") {
+    return {
+      action: "wait_and_retry",
+      message: "Hit a LinkedIn throttle. The CLI already backs off automatically \u2014 if you see this you've exhausted the retry budget. Wait ~60s and retry."
+    };
   }
-});
-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: "CSV of statuses", 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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  if (err.code === "INTERNAL_ERROR" && lower.includes("deprecat")) {
+    return {
+      action: "reject",
+      message: "LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped \u2014 file an issue or update the constant."
+    };
   }
-});
-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",
-        "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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  return { action: "reject", message: err.message };
+}
+var LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\d+$/;
+function resolveAccountIdArg2(args) {
+  const fromArgs = args["account-id"] ?? args["account-urn"];
+  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;
+  if (!id) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MISSING_ACCOUNT_ID",
+        message: "Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs."
+      }
+    });
+    process.exit(1);
   }
-});
-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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json", required: false, default: "json" }
+  if (!LI_ACCOUNT_ID_RE.test(id)) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_ACCOUNT_ID",
+        message: `Invalid LinkedIn account ID "${id}". Expected numeric or urn:li:sponsoredAccount:N.`
+      }
+    });
+    process.exit(1);
   }
-});
-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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  return id.startsWith("urn:") ? id.split(":").pop() ?? id : id;
+}
+function todayIso2() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function daysAgoIso2(days) {
+  return new Date(Date.now() - days * DAY_MS2).toISOString().slice(0, 10);
+}
+function csvOrJson2(args) {
+  return args.output ?? "json";
+}
+function resolveStatusFilter(args) {
+  if (args["all-statuses"]) {
+    return void 0;
   }
-});
-registerSchema({
-  command: "ads.linkedin.facets.list",
-  description: "List every targeting facet LinkedIn supports (industries, seniorities, titles, employers, growthRate, etc).",
-  args: {
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  const explicit = args.statuses;
+  if (explicit) {
+    return explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
   }
-});
-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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  return ["ACTIVE"];
+}
+
+// src/commands/ads/linkedin/write-shared.ts
+var TOTAL_BUDGET_HELP = "Lifetime budget \u2014 on something already running it must exceed spend to date, or LinkedIn rejects it";
+function bareAccountId(args) {
+  const raw = resolveAccountIdArg2(args);
+  return raw.replace(/^urn:li:sponsoredAccount:/, "").replace(/^sponsoredAccount:/, "");
+}
+function failWriteValidation2(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function loadJsonFileArg2(path28) {
+  if (typeof path28 !== "string" || path28.length === 0) {
+    return {};
   }
-});
-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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json", required: false, default: "json" }
+  try {
+    const parsed = JSON.parse(readFileSync4(path28, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failWriteValidation2(`${path28} must contain a JSON object`);
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      failWriteValidation2(`${path28} is not valid JSON: ${err.message}`);
+    }
+    throw err;
   }
-});
-registerSchema({
-  command: "ads.linkedin.bid-pricing",
-  description: "LinkedIn's suggested bid range + playbook \xA706 floor (2/3 of suggested). Inputs: targeting + objective + cost type.",
-  args: {
-    "account-id": { type: "string", description: "Account ID", required: false },
-    "account-urn": { type: "string", description: "Alias", required: false },
-    objective: {
-      type: "string",
-      description: "Objective type (WEBSITE_CONVERSION, LEAD_GENERATION, etc.)",
-      required: true
-    },
-    "cost-type": { type: "string", description: "CPC|CPM|CPV|CPS", required: true, enum: ["CPC", "CPM", "CPV", "CPS"] },
-    targeting: { type: "string", description: "Inline JSON targetingCriteria", required: false },
-    "targeting-file": { type: "string", description: "Path to JSON file", required: false },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json", required: false, default: "json" }
+}
+function mergePayload2(file, flags) {
+  const merged = { ...file };
+  for (const [key, value] of Object.entries(flags)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
   }
-});
-registerSchema({
-  command: "ads.linkedin.forecast",
-  description: "Forecast reach + impressions + clicks + spend for a hypothetical campaign. Useful for \xA714 greenfield planning.",
-  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: true },
-    "cost-type": { type: "string", description: "CPC|CPM|CPV|CPS", required: true },
-    "daily-budget": { type: "string", description: "e.g. '200 USD'", required: false },
-    "total-budget": { type: "string", description: "e.g. '6000 USD'", required: false },
-    bid: { type: "string", description: "Bid e.g. '8 USD'", required: false },
-    targeting: { type: "string", description: "Inline JSON targetingCriteria", required: false },
-    "targeting-file": { type: "string", description: "Path to JSON file", required: false },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json", required: false, default: "json" }
+  return merged;
+}
+function loadPatchArg2(args) {
+  const file = typeof args.file === "string" && args.file.length > 0 ? args.file : void 0;
+  const inline = typeof args.patch === "string" && args.patch.length > 0 ? args.patch : void 0;
+  if (Boolean(file) === Boolean(inline)) {
+    failWriteValidation2("pass exactly one of --file <patch.json> or --patch '<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 },
-    limit: { type: "string", description: "Max rows", required: false },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  if (file) {
+    return loadJsonFileArg2(file);
   }
-});
-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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  try {
+    const parsed = JSON.parse(inline);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failWriteValidation2("--patch must be a JSON object");
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      failWriteValidation2(`--patch is not valid JSON: ${err.message}`);
+    }
+    throw err;
   }
-});
-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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json", required: false, default: "json" }
+}
+function parseMoneyFlag(amount, currency, flag) {
+  if (amount === void 0 || amount === null || amount === "") {
+    return void 0;
   }
-});
-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 },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  if (currency === void 0 || currency === null || currency === "") {
+    return { amount: String(amount) };
   }
-});
-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" },
-    "skip-cache": { type: "boolean", description: "Bypass cache", required: false }
+  if (typeof currency !== "string" || currency.length !== 3) {
+    failWriteValidation2(`${flag} got an invalid --currency (expected a 3-letter code like EUR)`);
   }
-});
-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 (ISO date or epoch ms)", required: true },
-    end: { type: "string", description: "Run schedule end", required: false },
-    "total-budget": { type: "string", description: "Lifetime budget amount", required: false },
-    currency: {
-      type: "string",
-      description: "3-letter currency code (defaults to the ad account currency)",
-      required: false
-    },
-    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", required: false },
-    file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
+  return { amount: String(amount), currencyCode: currency.toUpperCase() };
+}
+function parseDateFlag(value, flag) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
   }
-});
-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: "New lifetime budget", required: false },
-    currency: {
-      type: "string",
-      description: "3-letter currency code (defaults to the ad account currency)",
-      required: false
-    },
-    status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED", required: false },
-    file: { type: "string", description: "JSON file with fields to change", required: false }
+  const raw = String(value);
+  if (/^\d{10,}$/.test(raw)) {
+    return Number(raw);
   }
-});
-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: "Lifetime budget amount", 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", 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 },
-    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", required: false },
-    file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
+  const parsed = Date.parse(raw);
+  if (Number.isNaN(parsed)) {
+    failWriteValidation2(`${flag} must be an ISO date (2026-07-10) or epoch milliseconds`);
   }
-});
-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: "New lifetime budget", 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 },
-    status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED", required: false },
-    file: { type: "string", description: "JSON file with fields to change", required: false }
+  return parsed;
+}
+function parseOnOffFlag(value, flag) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
   }
-});
-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. --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 }
+  const raw = String(value).toLowerCase();
+  if (raw === "on" || raw === "true") {
+    return true;
   }
-});
-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
-});
-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", 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 }
+  if (raw === "off" || raw === "false") {
+    return 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/--video-id reference the Baker library (`baker images`/`baker videos`) and upload to LinkedIn 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, nestedMessage?|landingPageUrl?}}}, \u226425 messages). 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", 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-urn": { type: "string", description: "TLA: post to sponsor (urn:li:share|ugcPost:*)", 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|PAUSED (default DRAFT)", required: false },
-    title: { type: "string", description: "Media title (image/video) or article title", required: false },
-    file: { type: "string", description: "JSON file with the full content object", required: false }
+  failWriteValidation2(`${flag} must be on|off`);
+}
+function parseLocaleFlag(value) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
   }
-});
-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", 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 },
-    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; companyName,domain for companies; email column is SHA-256 hashed locally). LinkedIn needs 300+ MATCHED members to serve \u2014 upload well above that. 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", required: false }
+  const match = /^([a-z]{2})[_-]([A-Za-z]{2})$/.exec(String(value));
+  if (!match) {
+    failWriteValidation2("--locale must look like en_US (language_COUNTRY)");
   }
-});
-registerSchema({
-  command: "ads.linkedin.audiences.upload",
-  description: "Stage adding rows to an existing audience segment (or a li_temp_* segment staged in this chat). 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 rows to add", required: true }
+  return { language: match[1], country: match[2].toUpperCase() };
+}
+function loadTargetingFileArg(path28) {
+  if (typeof path28 !== "string" || path28.length === 0) {
+    return void 0;
   }
-});
-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: "LEAD|SIGN_UP|DOWNLOAD|PURCHASE|KEY_PAGE_VIEW|ADD_TO_CART|INSTALL|OTHER",
-      required: true
-    },
-    method: { type: "string", description: "INSIGHT_TAG|CONVERSIONS_API", required: true },
-    "post-click-window": { type: "string", description: "1|7|30|90 days", required: false },
-    "view-window": { type: "string", description: "1|7|30 days", 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 }
+  const parsed = loadJsonFileArg2(path28);
+  const criteria = parsed.targetingCriteria ?? parsed;
+  if (!criteria.include) {
+    failWriteValidation2(
+      `${path28} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+    );
   }
-});
-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", required: false },
-    "view-window": { type: "string", description: "1|7|30 days", 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 }
+  return criteria;
+}
+function sha256Lower(value) {
+  return createHash("sha256").update(value.trim().toLowerCase()).digest("hex");
+}
+function parseCsvLine(line) {
+  const cells = [];
+  let current = "";
+  let inQuotes = false;
+  for (let i = 0; i < line.length; i++) {
+    const char = line[i];
+    if (inQuotes) {
+      if (char === '"' && line[i + 1] === '"') {
+        current += '"';
+        i++;
+      } else if (char === '"') {
+        inQuotes = false;
+      } else {
+        current += char;
+      }
+    } else if (char === '"') {
+      inQuotes = true;
+    } else if (char === ",") {
+      cells.push(current);
+      current = "";
+    } else {
+      current += char;
+    }
   }
-});
-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 }
+  cells.push(current);
+  return cells.map((cell) => cell.trim());
+}
+function parseListFileArg(path28, maxRows) {
+  if (typeof path28 !== "string" || path28.length === 0) {
+    return void 0;
   }
-});
-registerSchema({
-  command: "ads.linkedin.lead-forms.update",
-  description: "Stage changes to a Lead Gen Form from a JSON file. Applies on chat publish.",
-  args: {
-    id: { type: "positional", description: "Lead form id or URN", required: true },
-    ...writeAccountArgs,
-    file: { type: "string", description: "JSON file with the fields to change", required: true },
-    name: { type: "string", description: "New form name", required: false }
+  const raw = readFileSync4(path28, "utf8");
+  const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
+  if (lines.length < 2) {
+    failWriteValidation2(`${path28} needs a header row and at least one data row`);
   }
-});
-registerSchema({
-  command: "ads.linkedin.draft.list",
-  description: "Show every LinkedIn write op staged in this chat: ref, summary, dependencies, warnings, mode (simulated = publish will NOT hit LinkedIn), and post-publish results (applied/simulated/failed/skipped). Ops are invisible to the read commands until publish \u2014 check here before finishing.",
-  args: {
-    json: {
-      type: "boolean",
-      description: "Print the raw JSON envelope instead of the readable tree",
-      required: false
+  const columns = parseCsvLine(lines[0]).map((column) => column.trim());
+  const rows = [];
+  for (const line of lines.slice(1)) {
+    const cells = parseCsvLine(line);
+    const row = {};
+    columns.forEach((column, index) => {
+      const value = cells[index] ?? "";
+      if (!value) {
+        return;
+      }
+      row[column] = column.toLowerCase() === "email" ? sha256Lower(value) : value;
+    });
+    if (Object.keys(row).length > 0) {
+      rows.push(row);
     }
   }
-});
-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
-    }
+  if (rows.length > maxRows) {
+    failWriteValidation2(`${path28} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
   }
-});
-registerSchema({
-  command: "ads.linkedin.draft.clear",
-  description: "Discard ALL staged LinkedIn ops in this chat's draft. Nothing applies on publish.",
-  args: {}
-});
-
-// src/commands/ads/linkedin/account.ts
-import { defineCommand as defineCommand32 } from "citty";
-
-// src/commands/ads/linkedin/shared.ts
-var DAY_MS2 = 864e5;
-function handleLinkedinError(err) {
-  if (err instanceof ApiError) {
-    if (err.code === "UNAUTHORIZED") {
-      handleConnectionError("linkedin_ads", err.message);
-    }
-    if (err.code === "NOT_FOUND") {
-      handleConnectionError("linkedin_ads", err.message);
-    }
-    if (isNoAccountsSelectedError(err.code, err.message)) {
-      handleConnectionError("linkedin_ads", err.message);
+  return { columns, rows };
+}
+function failPreflight(fields) {
+  writeJsonEnvelope({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; "),
+      fields,
+      fix: capabilityFix("linkedin-ads")
     }
-    const explanation = explainLinkedinError(err);
-    const envelope = {
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: {
-          action: explanation.action,
-          explanation: explanation.message,
-          correctedCommand: explanation.correctedCommand
-        },
-        retryable: err.code === "RATE_LIMITED" || err.code === "INTERNAL_ERROR"
-      }
-    };
-    writeAdsJson(envelope);
-    process.exit(1);
-  }
-  const message = err instanceof Error ? err.message : "Unexpected error";
-  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message } });
+  });
   process.exit(1);
 }
-function isNoAccountsSelectedError(code, message) {
-  return code === "VALIDATION_ERROR" && /no linkedin ad accounts selected/i.test(message);
+var BATCH_NUDGE = "This command takes several ids at once \u2014 pass them comma-separated or with --ids-file instead of one call per id.";
+function batchNudge(data) {
+  return data.sameKindStaged === void 0 ? [] : [BATCH_NUDGE];
 }
-function explainLinkedinError(err) {
-  const lower = err.message.toLowerCase();
-  if (err.code === "VALIDATION_ERROR" && lower.includes("granularity") && lower.includes("daily")) {
-    return {
-      action: "retry_with_flag",
-      message: "LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.",
-      correctedCommand: void 0
-    };
+async function stageOp(raw, hints) {
+  const preflight = linkedinDraftOpInputSchema.safeParse(raw);
+  if (!preflight.success) {
+    failPreflight(preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message })));
   }
-  if (err.code === "RATE_LIMITED") {
-    return {
-      action: "wait_and_retry",
-      message: "Hit a LinkedIn throttle. The CLI already backs off automatically \u2014 if you see this you've exhausted the retry budget. Wait ~60s and retry."
-    };
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/linkedin/draft/stage", {
+      chatId,
+      op: preflight.data
+    });
+    const allHints = [...batchNudge(response.data), ...hints ?? [], ...adCopyHints(preflight.data)];
+    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
+  } catch (err) {
+    handleLinkedinError(err);
   }
-  if (err.code === "INTERNAL_ERROR" && lower.includes("deprecat")) {
-    return {
-      action: "reject",
-      message: "LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped \u2014 file an issue or update the constant."
-    };
+}
+async function stageLinkedinOps(rawOps, hints) {
+  if (rawOps.length === 1 && rawOps[0]) {
+    await stageOp(rawOps[0], hints);
+    return;
+  }
+  const ops = [];
+  for (const [index, raw] of rawOps.entries()) {
+    const preflight = linkedinDraftOpInputSchema.safeParse(raw);
+    if (!preflight.success) {
+      failPreflight(
+        preflight.error.issues.map((issue) => ({
+          path: `ops[${index}]${issue.path.length > 0 ? `.${issue.path.join(".")}` : ""}`,
+          message: issue.message
+        }))
+      );
+    }
+    ops.push(preflight.data);
+  }
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/linkedin/draft/stage-batch", { chatId, ops });
+    const allHints = [...hints ?? [], ...adCopyHints(ops)];
+    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
+  } catch (err) {
+    handleLinkedinError(err);
   }
-  return { action: "reject", message: err.message };
 }
-var LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\d+$/;
-function resolveAccountIdArg2(args) {
-  const fromArgs = args["account-id"] ?? args["account-urn"];
-  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;
-  if (!id) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "MISSING_ACCOUNT_ID",
-        message: "Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs."
-      }
-    });
-    process.exit(1);
+async function stageStatusChange(input) {
+  const payload = input.kind === "creative.update" ? { intendedStatus: input.status } : { status: input.status };
+  await stageLinkedinOps(
+    input.targets.map((target) => ({ kind: input.kind, accountId: input.accountId, target, payload }))
+  );
+}
+function requireTarget2(args, entity) {
+  const inverted = booleanWordPositionalError(args, entity);
+  if (inverted !== void 0) {
+    failWriteValidation2(inverted);
   }
-  if (!LI_ACCOUNT_ID_RE.test(id)) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "INVALID_ACCOUNT_ID",
-        message: `Invalid LinkedIn account ID "${id}". Expected numeric or urn:li:sponsoredAccount:N.`
-      }
-    });
-    process.exit(1);
+  const positionals = readPositionals(args);
+  const target = args.id ?? args.target ?? args.ref ?? positionals[0];
+  if (typeof target !== "string" || target.length === 0) {
+    failWriteValidation2(`pass the ${entity} id or URN as the positional argument`);
   }
-  return id.startsWith("urn:") ? id.split(":").pop() ?? id : id;
+  if (positionals.length > 1 || splitIdList(target).length > 1) {
+    failWriteValidation2(
+      `this command takes one ${entity} id \u2014 run it once per id. Only pause/resume/archive and 'creatives update' accept several ids in one call.`
+    );
+  }
+  return target;
 }
-function todayIso2() {
-  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+function readPositionals(args) {
+  if (!Array.isArray(args._)) {
+    return [];
+  }
+  return args._.filter((value) => typeof value === "string" && value.length > 0);
 }
-function daysAgoIso2(days) {
-  return new Date(Date.now() - days * DAY_MS2).toISOString().slice(0, 10);
+function splitIdList(raw) {
+  return raw.split(",").map((id) => id.trim()).filter(Boolean);
 }
-function csvOrJson2(args) {
-  return args.output ?? "json";
+function idsFileEntries(path28) {
+  if (typeof path28 !== "string" || path28.length === 0) {
+    return [];
+  }
+  return readFileSync4(path28, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
 }
-function resolveStatusFilter(args) {
-  if (args["all-statuses"]) {
-    return void 0;
+function requireTargets(args, entity) {
+  const positionals = readPositionals(args);
+  const named = [args.id, args.target, args.ref].filter(
+    (value) => typeof value === "string" && value.length > 0
+  );
+  const fromArgs = positionals.length > 0 ? positionals : named;
+  const targets = [.../* @__PURE__ */ new Set([...fromArgs.flatMap(splitIdList), ...idsFileEntries(args["ids-file"])])];
+  if (targets.length === 0) {
+    failWriteValidation2(
+      `pass the ${entity} id or URN as the positional argument (comma-separated for several), or --ids-file <path>`
+    );
   }
-  const explicit = args.statuses;
-  if (explicit) {
-    return explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
+  if (targets.length > LINKEDIN_DRAFT_BATCH_MAX) {
+    failWriteValidation2(
+      `${targets.length} ids exceeds the batch limit of ${LINKEDIN_DRAFT_BATCH_MAX} \u2014 split the list`
+    );
   }
-  return ["ACTIVE"];
+  return targets;
 }
 
-// src/commands/ads/linkedin/account.ts
-var accountCommand = defineCommand32({
-  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`
-  },
+// src/commands/ads/linkedin/schemas.ts
+registerSchema({
+  command: "ads.linkedin.accounts",
+  description: "List LinkedIn ad accounts in the company's connected scope. Pass --include-all to list every account the OAuth token can see.",
   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 = resolveAccountIdArg2(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 = csvOrJson2(args);
-      if (fmt !== "json") {
-        writeAdsOutput([data], fmt);
-        return;
-      }
-      writeAdsJson({ ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
+    "include-all": { type: "boolean", description: "Ignore picker scope", required: false },
+    "no-cache": { type: "boolean", description: "Skip CLI-side cache", required: false },
+    "skip-cache": { type: "boolean", description: "Bypass server-side cache", required: false },
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
   }
 });
-
-// src/commands/ads/linkedin/accounts.ts
-import { defineCommand as defineCommand33 } from "citty";
-var ACCOUNTS_TTL_MS = 60 * 60 * 1e3;
-function accountHints2(accounts, includeAll) {
-  if (includeAll) {
-    return [];
+registerSchema({
+  command: "ads.linkedin.account",
+  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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
   }
-  return connectedResourceHints({
-    plural: "LinkedIn ad accounts",
-    singular: "LinkedIn ad account",
-    flag: "--account-id",
-    resources: accounts.map((account) => ({ id: account.externalId, label: account.name }))
-  });
-}
-var accountsCommand2 = defineCommand33({
-  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`
-  },
+});
+registerSchema({
+  command: "ads.linkedin.campaign-groups",
+  description: "List LinkedIn campaign groups in an account. Default ACTIVE-only \u2014 pass --all-statuses to widen.",
   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) {
-        writeJsonEnvelope({
-          ok: true,
-          data: cached.data,
-          cached: true,
-          hints: accountHints2(cached.data, includeAll)
-        });
-        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 = csvOrJson2(args);
-      if (fmt !== "json") {
-        writeAdsOutput(data, fmt);
-        return;
-      }
-      writeJsonEnvelope({ ok: true, data, hints: accountHints2(data, includeAll) });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
+    "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: "CSV of statuses", required: false },
+    limit: { type: "string", description: "Max rows (default 500)", required: false },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
   }
 });
-
-// src/commands/ads/linkedin/analytics.ts
-import { defineCommand as defineCommand34 } from "citty";
-
-// src/commands/ads/linkedin/presets.ts
-var INTENTS = {
-  baseline: {
-    name: "baseline",
-    description: "Spend, impressions, clicks. The default 'how is delivery?' question. Derives CTR, CPC, CPM.",
-    metrics: ["impressions", "clicks", "costInUsd", "costInLocalCurrency", "approximateUniqueImpressions"],
-    derived: ["ctr", "cpc", "cpm", "frequency"]
-  },
-  revenue: {
-    name: "revenue",
-    description: "Spend, conversions, conversion value. 'How much money are we making?'",
-    metrics: [
-      "costInUsd",
-      "externalWebsiteConversions",
-      "externalWebsitePostClickConversions",
-      "externalWebsitePostViewConversions",
-      "conversionValueInLocalCurrency",
-      "oneClickLeads"
-    ]
-  },
-  funnel: {
-    name: "funnel",
-    description: "Impression \u2192 click \u2192 landing \u2192 form open \u2192 lead \u2192 conversion. 'Where do users drop off?'",
-    metrics: [
-      "impressions",
-      "clicks",
-      "landingPageClicks",
-      "oneClickLeadFormOpens",
-      "oneClickLeads",
-      "externalWebsiteConversions",
-      "costInUsd"
-    ],
-    derived: ["ctr", "leadCompletionRate"]
-  },
-  engagement: {
-    name: "engagement",
-    description: "Likes, comments, shares, follows + viral spillover. TLA-aware \u2014 measures organic reach effect.",
-    metrics: [
-      "impressions",
-      "likes",
-      "comments",
-      "shares",
-      "reactions",
-      "follows",
-      "totalEngagements",
-      "viralImpressions",
-      "viralLikes",
-      "viralShares",
-      "viralOneClickLeads",
-      "costInUsd"
-    ]
-  },
-  video: {
-    name: "video",
-    description: "Video watch quartiles + cost. 'How are video creatives holding attention?'",
-    metrics: [
-      "videoStarts",
-      "videoFirstQuartileCompletions",
-      "videoMidpointCompletions",
-      "videoThirdQuartileCompletions",
-      "videoCompletions",
-      "videoViews",
-      "fullScreenPlays",
-      "costInUsd",
-      "impressions"
-    ]
-  },
-  "lead-gen": {
-    name: "lead-gen",
-    description: "Lead Gen Form opens + completions. CLI derives form-completion-rate.",
-    metrics: [
-      "oneClickLeadFormOpens",
-      "oneClickLeads",
-      "viralOneClickLeads",
-      "viralOneClickLeadFormOpens",
-      "costInUsd"
-    ],
-    derived: ["leadCompletionRate"]
-  },
-  inmail: {
-    name: "inmail",
-    description: "Sponsored Message / Conversation Ads \u2014 sends, opens, clicks, lead-gen taps.",
-    metrics: [
-      "sends",
-      "opens",
-      "clicks",
-      "costInUsd",
-      "leadGenerationMailContactInfoShares",
-      "leadGenerationMailInterestedClicks"
-    ]
-  },
-  document: {
-    name: "document",
-    description: "Document Ads \u2014 quartile read-through, completion, downloads.",
-    metrics: [
-      "documentFirstQuartileCompletions",
-      "documentMidpointCompletions",
-      "documentThirdQuartileCompletions",
-      "documentCompletions",
-      "downloadClicks",
-      "costInUsd",
-      "impressions"
-    ]
-  },
-  ranking: {
-    name: "ranking",
-    description: "Frequency + reach metrics for fatigue detection. CLI derives frequency = impressions/uniqueImpressions.",
-    metrics: ["impressions", "clicks", "costInUsd", "approximateUniqueImpressions"],
-    derived: ["frequency", "ctr"]
-  },
-  identity: {
-    name: "identity",
-    description: "Just spend + impressions. Cheap roll-up.",
-    metrics: ["costInUsd", "impressions"]
+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: "CSV of statuses", required: false },
+    limit: { type: "string", description: "Max rows", required: false },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    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: "CSV of statuses", 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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    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",
+        "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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json", 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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    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: {
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.bid-pricing",
+  description: "LinkedIn's suggested bid range + playbook \xA706 floor (2/3 of suggested). Inputs: targeting + objective + cost type.",
+  args: {
+    "account-id": { type: "string", description: "Account ID", required: false },
+    "account-urn": { type: "string", description: "Alias", required: false },
+    objective: {
+      type: "string",
+      description: "Objective type (WEBSITE_CONVERSION, LEAD_GENERATION, etc.)",
+      required: true
+    },
+    "cost-type": { type: "string", description: "CPC|CPM|CPV|CPS", required: true, enum: ["CPC", "CPM", "CPV", "CPS"] },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria", required: false },
+    "targeting-file": { type: "string", description: "Path to JSON file", required: false },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json", required: false, default: "json" }
   }
-};
-var MEMBER_PIVOTS = /* @__PURE__ */ new Set([
-  "company",
-  "job-title",
-  "job-function",
-  "seniority",
-  "industry",
-  "company-size",
-  "country",
-  "region"
-]);
-var ALL_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"
-];
-var ALL_LEVELS = ["account", "campaign-group", "campaign", "creative"];
-function listIntents() {
-  return Object.values(INTENTS);
-}
-function isPivot(slug) {
-  return ALL_PIVOTS.includes(slug);
-}
-function isLevel(slug) {
-  return ALL_LEVELS.includes(slug);
-}
-function composeFields(intent, _level, metricsOverride) {
-  const base = metricsOverride && metricsOverride.length > 0 ? metricsOverride : INTENTS[intent].metrics;
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const f of ["pivotValues", "dateRange", ...base]) {
-    if (!seen.has(f)) {
-      seen.add(f);
-      out.push(f);
-    }
+});
+registerSchema({
+  command: "ads.linkedin.forecast",
+  description: "Forecast reach + impressions + clicks + spend for a hypothetical campaign. Useful for \xA714 greenfield planning.",
+  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: true },
+    "cost-type": { type: "string", description: "CPC|CPM|CPV|CPS", required: true },
+    "daily-budget": { type: "string", description: "e.g. '200 USD'", required: false },
+    "total-budget": { type: "string", description: "e.g. '6000 USD'", required: false },
+    bid: { type: "string", description: "Bid e.g. '8 USD'", required: false },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria", required: false },
+    "targeting-file": { type: "string", description: "Path to JSON file", required: false },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json", required: false, default: "json" }
   }
-  return out;
-}
-
-// src/commands/ads/linkedin/analytics.ts
-function commaSplit(input) {
-  if (!input) return void 0;
-  return input.split(",").map((s) => s.trim()).filter(Boolean);
-}
-function parseGranularity(raw) {
-  const v = (raw ?? "DAILY").toUpperCase();
-  if (v === "DAILY" || v === "MONTHLY" || v === "YEARLY" || v === "ALL") {
-    return v;
+});
+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 },
+    limit: { type: "string", description: "Max rows", required: false },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
   }
-  handleLinkedinError(new Error(`Invalid --granularity "${raw}". Use DAILY | MONTHLY | YEARLY | ALL.`));
-}
-function parseLevel(raw) {
-  const v = raw ?? "account";
-  if (!isLevel(v)) {
-    handleLinkedinError(new Error(`Invalid --level "${raw}". Use one of: ${ALL_LEVELS.join(", ")}.`));
+});
+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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
   }
-  return v;
-}
-function parsePivot(raw) {
-  const v = raw ?? "none";
-  if (!isPivot(v)) {
-    handleLinkedinError(new Error(`Invalid --pivot "${raw}". Use one of: ${ALL_PIVOTS.join(", ")}.`));
+});
+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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json", required: false, default: "json" }
   }
-  return v;
-}
-function parseIntent(raw) {
-  const v = raw ?? "baseline";
-  const known = [
-    "baseline",
-    "revenue",
-    "funnel",
-    "engagement",
-    "video",
-    "lead-gen",
-    "inmail",
-    "document",
-    "ranking",
-    "identity"
-  ];
-  if (!known.includes(v)) {
-    handleLinkedinError(new Error(`Invalid --intent "${raw}". Run --list-intents to see options.`));
+});
+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 },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false },
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
   }
-  return v;
-}
-function resolveDateRange(args) {
-  const start = args.start;
-  const end = args.end;
-  if (start) {
-    return { start, end };
+});
+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" },
+    "skip-cache": { type: "boolean", description: "Bypass cache", required: false }
   }
-  const lastDaysRaw = args["last-days"];
-  const days = lastDaysRaw ? Number(lastDaysRaw) : 7;
-  if (!Number.isFinite(days) || days < 1 || days > 730) {
-    handleLinkedinError(new Error(`Invalid --last-days "${lastDaysRaw}". Use a positive number \u2264 730.`));
+});
+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 (ISO date or epoch ms)", required: true },
+    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
+    },
+    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", 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
+    },
+    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", 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 },
+    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", required: false },
+    file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
   }
-  return { start: daysAgoIso2(days), end: todayIso2() };
-}
-function resolveScopeIds(args, level) {
-  if (level === "account") {
-    const id = resolveAccountIdArg2(args);
-    return [id];
+});
+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 },
+    status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED", required: false },
+    file: { type: "string", description: "JSON file with fields to change", required: false }
   }
-  if (level === "campaign-group") {
-    const raw2 = args["campaign-group-id"] ?? args.ids;
-    if (!raw2) {
-      handleLinkedinError(new Error("Pass --campaign-group-id (CSV for multi) when --level campaign-group."));
-    }
-    return commaSplit(raw2) ?? [];
+});
+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. --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 }
   }
-  if (level === "campaign") {
-    const raw2 = args["campaign-id"] ?? args.ids;
-    if (!raw2) {
-      handleLinkedinError(new Error("Pass --campaign-id (CSV for multi) when --level campaign."));
-    }
-    return commaSplit(raw2) ?? [];
+});
+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
+});
+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", 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 }
   }
-  const raw = args["creative-id"] ?? args.ids;
-  if (!raw) {
-    handleLinkedinError(new Error("Pass --creative-id (CSV for multi) when --level creative."));
+});
+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/--video-id reference the Baker library (`baker images`/`baker videos`) and upload to LinkedIn 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, nestedMessage?|landingPageUrl?}}}, \u226425 messages). 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", 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-urn": { type: "string", description: "TLA: post to sponsor (urn:li:share|ugcPost:*)", 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|PAUSED (default DRAFT)", required: false },
+    title: { type: "string", description: "Media title (image/video) or article title", required: false },
+    file: { type: "string", description: "JSON file with the full content object", required: false }
   }
-  return commaSplit(raw) ?? [];
-}
-function sortRows(rows) {
-  return [...rows].sort((a, b) => {
-    const cs = numberOf(b.costInUsd) - numberOf(a.costInUsd);
-    if (cs !== 0) return cs;
-    return numberOf(b.impressions) - numberOf(a.impressions);
-  });
-}
-function numberOf(v) {
-  if (typeof v === "number") return Number.isFinite(v) ? v : 0;
-  if (typeof v === "string") {
-    const n = Number(v);
-    return Number.isFinite(n) ? n : 0;
+});
+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", 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 },
+    file: { type: "string", description: "JSON file with fields to change; flags override file keys", required: false }
   }
-  return 0;
-}
-var analyticsCommand = defineCommand34({
-  meta: {
-    name: "analytics",
-    description: `Performance reporting \u2014 the workhorse for AI agents.
-
-Three-axis design (LinkedIn's superpower over Meta/Google):
-  --level   account | campaign-group | campaign | creative
-  --intent  baseline | revenue | funnel | engagement | video | lead-gen | inmail | document | ranking | identity
-  --pivot   none | job-title | company | industry | seniority | function | company-size | country | region
-            | device | placement | serving-location | card-index | objective
-            | conversation-node | conversation-node-button
-
-Smart defaults:
-  --level account, --intent baseline, --pivot none, --granularity DAILY, last 7 days
-  Pivot on a MEMBER_* dim \u2192 granularity auto-forced to ALL (LinkedIn rejects DAILY+demographic)
-  Demographic data delayed 12-24h with \u22653-event privacy floor \u2014 the CLI flags this in warnings.
-  Derived metrics injected client-side: ctr, cpc, cpm, frequency, leadCompletionRate
-
-Examples \u2014 common AI questions:
-  # "How is this account 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 my ads" (ABM feedback loop)
-  baker ads linkedin analytics --level campaign --campaign-id 1234 --pivot company --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
-
-  # Custom field set (escape hatch)
-  baker ads linkedin analytics --metrics impressions,clicks,oneClickLeads --intent identity`
-  },
+});
+registerSchema({
+  command: "ads.linkedin.audiences.create",
+  description: "Stage a new matched audience. company-list/user-list take --list-file (CSV with header; companyName,domain for companies; email column is SHA-256 hashed locally). LinkedIn needs 300+ MATCHED members to serve \u2014 upload well above that. retargeting/engagement configs go in --file. Staged until publish.",
   args: {
-    level: { type: "string", description: "Object scope (default: account)" },
-    "account-id": { type: "string", description: "Account ID \u2014 numeric or urn:li:sponsoredAccount:N (level=account)" },
-    "account-urn": { type: "string", description: "Alias for --account-id (URN form)" },
-    "campaign-group-id": { type: "string", description: "Comma-separated IDs (level=campaign-group)" },
-    "campaign-id": { type: "string", description: "Comma-separated IDs (level=campaign)" },
-    "creative-id": { type: "string", description: "Comma-separated IDs (level=creative)" },
-    ids: { type: "string", description: "Generic CSV of IDs at the chosen level (alternative to per-level flags)" },
-    intent: {
+    ...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", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.audiences.upload",
+  description: "Stage adding rows to an existing audience segment (or a li_temp_* segment staged in this chat). 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 rows to add", 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: "baseline|revenue|funnel|engagement|video|lead-gen|inmail|document|ranking|identity"
+      description: "LEAD|SIGN_UP|DOWNLOAD|PURCHASE|KEY_PAGE_VIEW|ADD_TO_CART|INSTALL|OTHER",
+      required: true
     },
-    pivot: { type: "string", description: "Pivot dim. Default: none. See `--list-pivots`." },
-    metrics: { type: "string", description: "CSV metric override \u2014 bypass --intent's bundle" },
-    "list-intents": { type: "boolean", description: "Print intent definitions and exit" },
-    "list-pivots": { type: "boolean", description: "Print pivot slugs and exit" },
-    start: { type: "string", description: "Start date YYYY-MM-DD (overrides --last-days)" },
-    end: { type: "string", description: "End date YYYY-MM-DD" },
-    "last-days": { type: "string", description: "Window relative to today (default: 7)" },
-    granularity: { type: "string", description: "DAILY|MONTHLY|YEARLY|ALL (default: DAILY)" },
-    limit: { type: "string", description: "Max rows (default: 1000)" },
-    "no-sort": { type: "boolean", description: "Skip default sort by costInUsd desc" },
-    "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
-    output: { type: "string", description: "Output format json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    if (args["list-intents"]) {
-      writeAdsJson({ ok: true, data: listIntents() });
-      return;
-    }
-    if (args["list-pivots"]) {
-      writeAdsJson({ ok: true, data: ALL_PIVOTS });
-      return;
-    }
-    const level = parseLevel(args.level);
-    const intent = parseIntent(args.intent);
-    const pivot = parsePivot(args.pivot);
-    let granularity = parseGranularity(args.granularity);
-    if (MEMBER_PIVOTS.has(pivot) && granularity === "DAILY") {
-      process.stderr.write(`note: pivot=${pivot} forces --granularity ALL (LinkedIn rejects DAILY + demographic).
-`);
-      granularity = "ALL";
-    }
-    const ids = resolveScopeIds(args, level);
-    if (ids.length === 0) {
-      handleLinkedinError(new Error(`No IDs resolved for --level ${level}`));
-    }
-    const range = resolveDateRange(args);
-    const metrics = commaSplit(args.metrics);
-    const limit = args.limit ? Number(args.limit) : 1e3;
-    const request = {
-      level,
-      ids,
-      intent,
-      pivot,
-      metrics,
-      start: range.start,
-      end: range.end,
-      granularity,
-      limit
-    };
-    try {
-      const data = await apiPost("/api/ads/linkedin/analytics", {
-        request,
-        skipCache: Boolean(args["skip-cache"])
-      });
-      const rows = args["no-sort"] ? data.rows : sortRows(data.rows);
-      const fmt = csvOrJson2(args);
-      if (fmt !== "json") {
-        writeAdsOutput(rows, fmt, data.fields);
-        return;
-      }
-      writeAdsJson({
-        ok: true,
-        data: {
-          rows,
-          fields: data.fields,
-          warnings: data.warnings,
-          query: data.query,
-          // Echo composed fields so an offline agent can pre-flight w/o this network call.
-          composedFields: composeFields(intent, level, metrics)
-        }
-      });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
+    method: { type: "string", description: "INSIGHT_TAG|CONVERSIONS_API", required: true },
+    "post-click-window": { type: "string", description: "1|7|30|90 days", required: false },
+    "view-window": { type: "string", description: "1|7|30 days", 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 }
   }
 });
-
-// src/commands/ads/linkedin/audience-size.ts
-import { readFileSync as readFileSync4 } from "fs";
-import { defineCommand as defineCommand35 } from "citty";
-function loadTargeting(args) {
-  const inline = args.targeting;
-  if (inline) {
-    try {
-      return JSON.parse(inline);
-    } catch {
-      handleLinkedinError(new Error("--targeting must be valid JSON. See LinkedIn 'targetingCriteria' shape."));
+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", required: false },
+    "view-window": { type: "string", description: "1|7|30 days", 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.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 from a JSON file. Applies on chat publish.",
+  args: {
+    id: { type: "positional", description: "Lead form id or URN", required: true },
+    ...writeAccountArgs,
+    file: { type: "string", description: "JSON file with the fields to change", required: true },
+    name: { type: "string", description: "New form name", required: false }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.draft.list",
+  description: "Show every LinkedIn write op staged in this chat: ref, summary, dependencies, warnings, mode (simulated = publish will NOT hit LinkedIn), and post-publish results (applied/simulated/failed/skipped). Ops are invisible to the read commands until publish \u2014 check here before finishing.",
+  args: {
+    json: {
+      type: "boolean",
+      description: "Print the raw JSON envelope instead of the readable tree",
+      required: false
     }
   }
-  const file = args["targeting-file"];
-  if (file) {
-    try {
-      return JSON.parse(readFileSync4(file, "utf-8"));
-    } catch (e) {
-      handleLinkedinError(
-        new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
-      );
+});
+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
     }
   }
-  handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
-}
-var audienceSizeCommand = defineCommand35({
-  meta: {
-    name: "audience-size",
-    description: `Estimate audience size for a targeting payload \u2014 pre-launch sanity check.
-
-Returns total + active counts plus playbook \xA704 warnings:
-  size <20K      \u2192 too narrow (will not deliver)
-  size <50K      \u2192 outside the 50K\u2013500K sweet spot
-  size >500K     \u2192 outside the sweet spot
-  size >1M       \u2192 too broad, refine ICP
+});
+registerSchema({
+  command: "ads.linkedin.draft.clear",
+  description: "Discard ALL staged LinkedIn ops in this chat's draft. Nothing applies on publish.",
+  args: {}
+});
 
-The targeting payload must follow LinkedIn's 'targetingCriteria' shape \u2014 an
-include/exclude tree of and/or boolean operators with adTargetingFacet keys.
-The simplest form:
-  { "include": { "and": [{ "or": { "urn:li:adTargetingFacet:locations": ["urn:li:geo:103644278"] }}]}}
+// src/commands/ads/linkedin/account.ts
+import { defineCommand as defineCommand32 } from "citty";
+var accountCommand = defineCommand32({
+  meta: {
+    name: "account",
+    description: `Single LinkedIn ad account detail (currency, status, type).
 
 Examples:
-  baker ads linkedin audience-size --account-id 503001492 --targeting-file targeting.json
-  baker ads linkedin audience-size --account-id 503001492 --targeting '{"include":{"and":[]}}'`
+  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" },
-    targeting: { type: "string", description: "Inline JSON targetingCriteria payload" },
-    "targeting-file": { type: "string", description: "Path to JSON file with targetingCriteria" },
     "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
-    output: { type: "string", description: "json", default: "json" }
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
   },
   run: async ({ args }) => {
     const accountId = resolveAccountIdArg2(args);
-    const targetingCriteria = loadTargeting(args);
     try {
-      const data = await apiPost("/api/ads/linkedin/audience-size", {
-        accountId,
-        targetingCriteria,
-        skipCache: Boolean(args["skip-cache"])
-      });
+      const params = { "account-id": accountId };
+      if (args["skip-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/account", params);
+      const fmt = csvOrJson2(args);
+      if (fmt !== "json") {
+        writeAdsOutput([data], fmt);
+        return;
+      }
       writeAdsJson({ ok: true, data });
     } catch (err) {
       handleLinkedinError(err);
@@ -11173,510 +11051,742 @@ Examples:
   }
 });
 
-// src/commands/ads/linkedin/audit.ts
-import { defineCommand as defineCommand36 } from "citty";
-var SEVERITY_RANK = {
-  critical: 0,
-  high: 1,
-  medium: 2,
-  low: 3
-};
-var STATUS_RANK = {
-  fail: 0,
-  warn: 1,
-  partial: 2,
-  pass: 3,
-  n_a: 4
-};
-function filterFindings(findings, severity, area) {
-  return findings.filter((f) => {
-    if (severity && !severity.includes(f.severity)) return false;
-    if (area && !area.includes(f.area)) return false;
-    return true;
-  });
-}
-function sortFindings(findings) {
-  return [...findings].sort((a, b) => {
-    const sa = STATUS_RANK[a.status] - STATUS_RANK[b.status];
-    if (sa !== 0) return sa;
-    return SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity];
-  });
-}
-function renderMarkdown(result) {
-  const lines = [];
-  lines.push(`# LinkedIn Ads Audit \u2014 ${result.account.name} (${result.account.id})`);
-  lines.push("");
-  lines.push(
-    `**Scope:** ${result.scope.campaigns} campaigns, ${result.scope.creatives} creatives, last ${result.scope.windowDays}d`
-  );
-  lines.push("");
-  lines.push(
-    `**Summary:** ${result.summary.pass} pass \u2022 ${result.summary.critical} critical \u2022 ${result.summary.high} high \u2022 ${result.summary.medium} medium \u2022 ${result.summary.low} low \u2022 ${result.summary.n_a} n/a (${result.summary.totalChecks} total)`
-  );
-  lines.push("");
-  lines.push("| # | Area | Check | Status | Severity | Notes |");
-  lines.push("|---|------|-------|--------|----------|-------|");
-  result.findings.forEach((f, idx) => {
-    const note = noteOf(f);
-    lines.push(
-      `| ${idx + 1} | ${f.area} | ${escapeMd(f.check)} | ${f.status.toUpperCase()} | ${f.severity} | ${escapeMd(note)} |`
-    );
+// src/commands/ads/linkedin/accounts.ts
+import { defineCommand as defineCommand33 } from "citty";
+var ACCOUNTS_TTL_MS = 60 * 60 * 1e3;
+function accountHints2(accounts, includeAll) {
+  if (includeAll) {
+    return [];
+  }
+  return connectedResourceHints({
+    plural: "LinkedIn ad accounts",
+    singular: "LinkedIn ad account",
+    flag: "--account-id",
+    resources: accounts.map((account) => ({ id: account.externalId, label: account.name }))
   });
-  return lines.join("\n");
-}
-function escapeMd(text) {
-  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
-}
-function noteOf(f) {
-  if (f.status === "pass") return "";
-  const ev = f.evidence ? JSON.stringify(f.evidence) : "";
-  const fix = f.fix?.explanation ?? "";
-  return [fix, ev].filter(Boolean).join(" \u2014 ");
 }
-var auditCommand = defineCommand36({
+var accountsCommand2 = defineCommand33({
   meta: {
-    name: "audit",
-    description: `Run a LinkedIn Ads playbook audit \u2014 30+ checks across Settings, Tracking,
-Audience, Campaigns, Creative, Performance, Bidding, and Compliance.
-
-Each finding has {id, area, check, status, severity, evidence, fix} fields with
-playbook citations. The default JSON output is agent-friendly; --format md
-renders a deliverable-ready table that mirrors the google-ads-playbook
-10-audit-summary.md style.
-
-Exit code 0 always. Use the JSON 'summary' counts to decide if action is needed.
+    name: "accounts",
+    description: `List LinkedIn ad accounts in this company's connected scope.
 
 Examples:
-  baker ads linkedin audit --account-id 503001492
-  baker ads linkedin audit --account-id 503001492 --campaign-id 1234        # narrow scope
-  baker ads linkedin audit --account-id 503001492 --window-days 90
-  baker ads linkedin audit --account-id 503001492 --severity critical,high
-  baker ads linkedin audit --account-id 503001492 --area Settings,Tracking
-  baker ads linkedin audit --account-id 503001492 --format md`
+  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: {
-    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
-    "account-urn": { type: "string", description: "Alias for --account-id" },
-    "campaign-id": { type: "string", description: "Narrow scope to a single campaign" },
-    "window-days": { type: "string", description: "Lookback window for performance checks (default: 30)" },
-    severity: { type: "string", description: "CSV severity filter: critical,high,medium,low" },
-    area: {
-      type: "string",
-      description: "CSV area filter: Settings,Tracking,Audience,Campaigns,Creative,Performance,Bidding,Compliance,Hygiene"
-    },
-    format: { type: "string", description: "Output format: json | md (default: json)" },
-    "skip-cache": { type: "boolean", description: "Bypass server-side cache" }
+    "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 accountId = resolveAccountIdArg2(args);
-    const windowDays = args["window-days"] ? Number(args["window-days"]) : 30;
-    if (!Number.isFinite(windowDays) || windowDays < 1 || windowDays > 365) {
-      handleLinkedinError(new Error("--window-days must be 1..365"));
+    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) {
+        writeJsonEnvelope({
+          ok: true,
+          data: cached.data,
+          cached: true,
+          hints: accountHints2(cached.data, includeAll)
+        });
+        return;
+      }
     }
     try {
-      const data = await apiPost("/api/ads/linkedin/audit", {
-        accountId,
-        campaignId: args["campaign-id"] ? String(args["campaign-id"]) : void 0,
-        windowDays,
-        skipCache: Boolean(args["skip-cache"])
-      });
-      const severityFilter = args.severity?.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
-      const areaFilter = args.area?.split(",").map((s) => s.trim()).filter(Boolean);
-      const filtered = filterFindings(data.findings, severityFilter, areaFilter);
-      const sorted = sortFindings(filtered);
-      const result = { ...data, findings: sorted };
-      const fmt = args.format ?? "json";
-      if (fmt === "md") {
-        process.stdout.write(`${renderMarkdown(result)}
-`);
+      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 = csvOrJson2(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
         return;
       }
-      writeAdsJson({ ok: true, data: result });
+      writeJsonEnvelope({ ok: true, data, hints: accountHints2(data, includeAll) });
     } catch (err) {
       handleLinkedinError(err);
     }
   }
 });
 
-// src/commands/ads/linkedin/bid-pricing.ts
-import { readFileSync as readFileSync5 } from "fs";
-import { defineCommand as defineCommand37 } from "citty";
-function loadTargeting2(args) {
-  const inline = args.targeting;
-  if (inline) {
-    try {
-      return JSON.parse(inline);
-    } catch {
-      handleLinkedinError(new Error("--targeting must be valid JSON. See LinkedIn 'targetingCriteria' shape."));
-    }
-  }
-  const file = args["targeting-file"];
-  if (file) {
-    try {
-      return JSON.parse(readFileSync5(file, "utf-8"));
-    } catch (e) {
-      handleLinkedinError(
-        new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
-      );
-    }
-  }
-  handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
-}
-var bidPricingCommand = defineCommand37({
-  meta: {
-    name: "bid-pricing",
-    description: `Get LinkedIn's suggested bid range for a targeting + objective + cost type.
-
-Returns LinkedIn's min / suggested / max bid plus the playbook \xA706 floor
-(2/3 of suggested \u2014 the recommended manual CPC starting point).
-
-Objective types: BRAND_AWARENESS | WEBSITE_TRAFFIC | WEBSITE_VISIT |
-                 ENGAGEMENT | WEBSITE_CONVERSION | LEAD_GENERATION |
-                 JOB_APPLICANT | VIDEO_VIEW
-Cost types:      CPC | CPM | CPV | CPS
+// src/commands/ads/linkedin/analytics.ts
+import { defineCommand as defineCommand34 } from "citty";
 
-Examples:
-  baker ads linkedin bid-pricing --account-id 503001492 --objective WEBSITE_CONVERSION --cost-type CPC --targeting-file targeting.json
-  baker ads linkedin bid-pricing --account-id 503001492 --objective LEAD_GENERATION --cost-type CPM --targeting '{"include":...}'`
+// src/commands/ads/linkedin/presets.ts
+var INTENTS = {
+  baseline: {
+    name: "baseline",
+    description: "Spend, impressions, clicks. The default 'how is delivery?' question. Derives CTR, CPC, CPM.",
+    metrics: ["impressions", "clicks", "costInUsd", "costInLocalCurrency", "approximateUniqueImpressions"],
+    derived: ["ctr", "cpc", "cpm", "frequency"]
+  },
+  revenue: {
+    name: "revenue",
+    description: "Spend, conversions, conversion value. 'How much money are we making?'",
+    metrics: [
+      "costInUsd",
+      "externalWebsiteConversions",
+      "externalWebsitePostClickConversions",
+      "externalWebsitePostViewConversions",
+      "conversionValueInLocalCurrency",
+      "oneClickLeads"
+    ]
+  },
+  funnel: {
+    name: "funnel",
+    description: "Impression \u2192 click \u2192 landing \u2192 form open \u2192 lead \u2192 conversion. 'Where do users drop off?'",
+    metrics: [
+      "impressions",
+      "clicks",
+      "landingPageClicks",
+      "oneClickLeadFormOpens",
+      "oneClickLeads",
+      "externalWebsiteConversions",
+      "costInUsd"
+    ],
+    derived: ["ctr", "leadCompletionRate"]
+  },
+  engagement: {
+    name: "engagement",
+    description: "Likes, comments, shares, follows + viral spillover. TLA-aware \u2014 measures organic reach effect.",
+    metrics: [
+      "impressions",
+      "likes",
+      "comments",
+      "shares",
+      "reactions",
+      "follows",
+      "totalEngagements",
+      "viralImpressions",
+      "viralLikes",
+      "viralShares",
+      "viralOneClickLeads",
+      "costInUsd"
+    ]
   },
-  args: {
-    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
-    "account-urn": { type: "string", description: "Alias for --account-id" },
-    objective: {
-      type: "string",
-      description: "Objective type (e.g. WEBSITE_CONVERSION, LEAD_GENERATION)",
-      required: true
-    },
-    "cost-type": { type: "string", description: "CPC | CPM | CPV | CPS", required: true },
-    targeting: { type: "string", description: "Inline JSON targetingCriteria" },
-    "targeting-file": { type: "string", description: "Path to JSON file with targetingCriteria" },
-    "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
-    output: { type: "string", description: "json", default: "json" }
+  video: {
+    name: "video",
+    description: "Video watch quartiles + cost. 'How are video creatives holding attention?'",
+    metrics: [
+      "videoStarts",
+      "videoFirstQuartileCompletions",
+      "videoMidpointCompletions",
+      "videoThirdQuartileCompletions",
+      "videoCompletions",
+      "videoViews",
+      "fullScreenPlays",
+      "costInUsd",
+      "impressions"
+    ]
   },
-  run: async ({ args }) => {
-    const accountId = resolveAccountIdArg2(args);
-    const targetingCriteria = loadTargeting2(args);
-    try {
-      const data = await apiPost("/api/ads/linkedin/bid-pricing", {
-        accountId,
-        objectiveType: String(args.objective),
-        costType: String(args["cost-type"]).toUpperCase(),
-        targetingCriteria,
-        skipCache: Boolean(args["skip-cache"])
-      });
-      writeAdsJson({ ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
+  "lead-gen": {
+    name: "lead-gen",
+    description: "Lead Gen Form opens + completions. CLI derives form-completion-rate.",
+    metrics: [
+      "oneClickLeadFormOpens",
+      "oneClickLeads",
+      "viralOneClickLeads",
+      "viralOneClickLeadFormOpens",
+      "costInUsd"
+    ],
+    derived: ["leadCompletionRate"]
+  },
+  inmail: {
+    name: "inmail",
+    description: "Sponsored Message / Conversation Ads \u2014 sends, opens, clicks, lead-gen taps.",
+    metrics: [
+      "sends",
+      "opens",
+      "clicks",
+      "costInUsd",
+      "leadGenerationMailContactInfoShares",
+      "leadGenerationMailInterestedClicks"
+    ]
+  },
+  document: {
+    name: "document",
+    description: "Document Ads \u2014 quartile read-through, completion, downloads.",
+    metrics: [
+      "documentFirstQuartileCompletions",
+      "documentMidpointCompletions",
+      "documentThirdQuartileCompletions",
+      "documentCompletions",
+      "downloadClicks",
+      "costInUsd",
+      "impressions"
+    ]
+  },
+  ranking: {
+    name: "ranking",
+    description: "Frequency + reach metrics for fatigue detection. CLI derives frequency = impressions/uniqueImpressions.",
+    metrics: ["impressions", "clicks", "costInUsd", "approximateUniqueImpressions"],
+    derived: ["frequency", "ctr"]
+  },
+  identity: {
+    name: "identity",
+    description: "Just spend + impressions. Cheap roll-up.",
+    metrics: ["costInUsd", "impressions"]
   }
-});
-
-// src/commands/ads/linkedin/campaign-groups.ts
-import { defineCommand as defineCommand39 } from "citty";
-
-// src/commands/ads/linkedin/write-commands.ts
-import { defineCommand as defineCommand38 } from "citty";
-
-// src/commands/ads/linkedin/write-shared.ts
-import { createHash } from "crypto";
-import { readFileSync as readFileSync6 } from "fs";
-function bareAccountId(args) {
-  const raw = resolveAccountIdArg2(args);
-  return raw.replace(/^urn:li:sponsoredAccount:/, "").replace(/^sponsoredAccount:/, "");
+};
+var MEMBER_PIVOTS = /* @__PURE__ */ new Set([
+  "company",
+  "job-title",
+  "job-function",
+  "seniority",
+  "industry",
+  "company-size",
+  "country",
+  "region"
+]);
+var ALL_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"
+];
+var ALL_LEVELS = ["account", "campaign-group", "campaign", "creative"];
+function listIntents() {
+  return Object.values(INTENTS);
 }
-function failWriteValidation2(message) {
-  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
+function isPivot(slug) {
+  return ALL_PIVOTS.includes(slug);
 }
-function loadJsonFileArg2(path28) {
-  if (typeof path28 !== "string" || path28.length === 0) {
-    return {};
-  }
-  try {
-    const parsed = JSON.parse(readFileSync6(path28, "utf8"));
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2(`${path28} must contain a JSON object`);
-    }
-    return parsed;
-  } catch (err) {
-    if (err instanceof SyntaxError) {
-      failWriteValidation2(`${path28} is not valid JSON: ${err.message}`);
-    }
-    throw err;
-  }
+function isLevel(slug) {
+  return ALL_LEVELS.includes(slug);
 }
-function mergePayload2(file, flags) {
-  const merged = { ...file };
-  for (const [key, value] of Object.entries(flags)) {
-    if (value !== void 0) {
-      merged[key] = value;
+function composeFields(intent, _level, metricsOverride) {
+  const base = metricsOverride && metricsOverride.length > 0 ? metricsOverride : INTENTS[intent].metrics;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const f of ["pivotValues", "dateRange", ...base]) {
+    if (!seen.has(f)) {
+      seen.add(f);
+      out.push(f);
     }
   }
-  return merged;
+  return out;
 }
-function loadPatchArg2(args) {
-  const file = typeof args.file === "string" && args.file.length > 0 ? args.file : void 0;
-  const inline = typeof args.patch === "string" && args.patch.length > 0 ? args.patch : void 0;
-  if (Boolean(file) === Boolean(inline)) {
-    failWriteValidation2("pass exactly one of --file <patch.json> or --patch '<json>'");
-  }
-  if (file) {
-    return loadJsonFileArg2(file);
-  }
-  try {
-    const parsed = JSON.parse(inline);
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2("--patch must be a JSON object");
-    }
-    return parsed;
-  } catch (err) {
-    if (err instanceof SyntaxError) {
-      failWriteValidation2(`--patch is not valid JSON: ${err.message}`);
-    }
-    throw err;
-  }
+
+// src/commands/ads/linkedin/analytics.ts
+function commaSplit(input) {
+  if (!input) return void 0;
+  return input.split(",").map((s) => s.trim()).filter(Boolean);
 }
-function parseMoneyFlag(amount, currency, flag) {
-  if (amount === void 0 || amount === null || amount === "") {
-    return void 0;
-  }
-  if (currency === void 0 || currency === null || currency === "") {
-    return { amount: String(amount) };
-  }
-  if (typeof currency !== "string" || currency.length !== 3) {
-    failWriteValidation2(`${flag} got an invalid --currency (expected a 3-letter code like EUR)`);
+function parseGranularity(raw) {
+  const v = (raw ?? "DAILY").toUpperCase();
+  if (v === "DAILY" || v === "MONTHLY" || v === "YEARLY" || v === "ALL") {
+    return v;
   }
-  return { amount: String(amount), currencyCode: currency.toUpperCase() };
+  handleLinkedinError(new Error(`Invalid --granularity "${raw}". Use DAILY | MONTHLY | YEARLY | ALL.`));
 }
-function parseDateFlag(value, flag) {
-  if (value === void 0 || value === null || value === "") {
-    return void 0;
-  }
-  const raw = String(value);
-  if (/^\d{10,}$/.test(raw)) {
-    return Number(raw);
+function parseLevel(raw) {
+  const v = raw ?? "account";
+  if (!isLevel(v)) {
+    handleLinkedinError(new Error(`Invalid --level "${raw}". Use one of: ${ALL_LEVELS.join(", ")}.`));
   }
-  const parsed = Date.parse(raw);
-  if (Number.isNaN(parsed)) {
-    failWriteValidation2(`${flag} must be an ISO date (2026-07-10) or epoch milliseconds`);
+  return v;
+}
+function parsePivot(raw) {
+  const v = raw ?? "none";
+  if (!isPivot(v)) {
+    handleLinkedinError(new Error(`Invalid --pivot "${raw}". Use one of: ${ALL_PIVOTS.join(", ")}.`));
   }
-  return parsed;
+  return v;
 }
-function parseOnOffFlag(value, flag) {
-  if (value === void 0 || value === null || value === "") {
-    return void 0;
+function parseIntent(raw) {
+  const v = raw ?? "baseline";
+  const known = [
+    "baseline",
+    "revenue",
+    "funnel",
+    "engagement",
+    "video",
+    "lead-gen",
+    "inmail",
+    "document",
+    "ranking",
+    "identity"
+  ];
+  if (!known.includes(v)) {
+    handleLinkedinError(new Error(`Invalid --intent "${raw}". Run --list-intents to see options.`));
   }
-  const raw = String(value).toLowerCase();
-  if (raw === "on" || raw === "true") {
-    return true;
+  return v;
+}
+function resolveDateRange(args) {
+  const start = args.start;
+  const end = args.end;
+  if (start) {
+    return { start, end };
   }
-  if (raw === "off" || raw === "false") {
-    return false;
+  const lastDaysRaw = args["last-days"];
+  const days = lastDaysRaw ? Number(lastDaysRaw) : 7;
+  if (!Number.isFinite(days) || days < 1 || days > 730) {
+    handleLinkedinError(new Error(`Invalid --last-days "${lastDaysRaw}". Use a positive number \u2264 730.`));
   }
-  failWriteValidation2(`${flag} must be on|off`);
+  return { start: daysAgoIso2(days), end: todayIso2() };
 }
-function parseLocaleFlag(value) {
-  if (value === void 0 || value === null || value === "") {
-    return void 0;
+function resolveScopeIds(args, level) {
+  if (level === "account") {
+    const id = resolveAccountIdArg2(args);
+    return [id];
   }
-  const match = /^([a-z]{2})[_-]([A-Za-z]{2})$/.exec(String(value));
-  if (!match) {
-    failWriteValidation2("--locale must look like en_US (language_COUNTRY)");
+  if (level === "campaign-group") {
+    const raw2 = args["campaign-group-id"] ?? args.ids;
+    if (!raw2) {
+      handleLinkedinError(new Error("Pass --campaign-group-id (CSV for multi) when --level campaign-group."));
+    }
+    return commaSplit(raw2) ?? [];
   }
-  return { language: match[1], country: match[2].toUpperCase() };
-}
-function loadTargetingFileArg(path28) {
-  if (typeof path28 !== "string" || path28.length === 0) {
-    return void 0;
+  if (level === "campaign") {
+    const raw2 = args["campaign-id"] ?? args.ids;
+    if (!raw2) {
+      handleLinkedinError(new Error("Pass --campaign-id (CSV for multi) when --level campaign."));
+    }
+    return commaSplit(raw2) ?? [];
   }
-  const parsed = loadJsonFileArg2(path28);
-  const criteria = parsed.targetingCriteria ?? parsed;
-  if (!criteria.include) {
-    failWriteValidation2(
-      `${path28} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
-    );
+  const raw = args["creative-id"] ?? args.ids;
+  if (!raw) {
+    handleLinkedinError(new Error("Pass --creative-id (CSV for multi) when --level creative."));
   }
-  return criteria;
+  return commaSplit(raw) ?? [];
 }
-function sha256Lower(value) {
-  return createHash("sha256").update(value.trim().toLowerCase()).digest("hex");
+function sortRows(rows) {
+  return [...rows].sort((a, b) => {
+    const cs = numberOf(b.costInUsd) - numberOf(a.costInUsd);
+    if (cs !== 0) return cs;
+    return numberOf(b.impressions) - numberOf(a.impressions);
+  });
 }
-function parseCsvLine(line) {
-  const cells = [];
-  let current = "";
-  let inQuotes = false;
-  for (let i = 0; i < line.length; i++) {
-    const char = line[i];
-    if (inQuotes) {
-      if (char === '"' && line[i + 1] === '"') {
-        current += '"';
-        i++;
-      } else if (char === '"') {
-        inQuotes = false;
-      } else {
-        current += char;
-      }
-    } else if (char === '"') {
-      inQuotes = true;
-    } else if (char === ",") {
-      cells.push(current);
-      current = "";
-    } else {
-      current += char;
-    }
+function numberOf(v) {
+  if (typeof v === "number") return Number.isFinite(v) ? v : 0;
+  if (typeof v === "string") {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
   }
-  cells.push(current);
-  return cells.map((cell) => cell.trim());
+  return 0;
 }
-function parseListFileArg(path28, maxRows) {
-  if (typeof path28 !== "string" || path28.length === 0) {
-    return void 0;
-  }
-  const raw = readFileSync6(path28, "utf8");
-  const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
-  if (lines.length < 2) {
-    failWriteValidation2(`${path28} needs a header row and at least one data row`);
-  }
-  const columns = parseCsvLine(lines[0]).map((column) => column.trim());
-  const rows = [];
-  for (const line of lines.slice(1)) {
-    const cells = parseCsvLine(line);
-    const row = {};
-    columns.forEach((column, index) => {
-      const value = cells[index] ?? "";
-      if (!value) {
+var analyticsCommand = defineCommand34({
+  meta: {
+    name: "analytics",
+    description: `Performance reporting \u2014 the workhorse for AI agents.
+
+Three-axis design (LinkedIn's superpower over Meta/Google):
+  --level   account | campaign-group | campaign | creative
+  --intent  baseline | revenue | funnel | engagement | video | lead-gen | inmail | document | ranking | identity
+  --pivot   none | job-title | company | industry | seniority | function | company-size | country | region
+            | device | placement | serving-location | card-index | objective
+            | conversation-node | conversation-node-button
+
+Smart defaults:
+  --level account, --intent baseline, --pivot none, --granularity DAILY, last 7 days
+  Pivot on a MEMBER_* dim \u2192 granularity auto-forced to ALL (LinkedIn rejects DAILY+demographic)
+  Demographic data delayed 12-24h with \u22653-event privacy floor \u2014 the CLI flags this in warnings.
+  Derived metrics injected client-side: ctr, cpc, cpm, frequency, leadCompletionRate
+
+Examples \u2014 common AI questions:
+  # "How is this account 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 my ads" (ABM feedback loop)
+  baker ads linkedin analytics --level campaign --campaign-id 1234 --pivot company --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
+
+  # Custom field set (escape hatch)
+  baker ads linkedin analytics --metrics impressions,clicks,oneClickLeads --intent identity`
+  },
+  args: {
+    level: { type: "string", description: "Object scope (default: account)" },
+    "account-id": { type: "string", description: "Account ID \u2014 numeric or urn:li:sponsoredAccount:N (level=account)" },
+    "account-urn": { type: "string", description: "Alias for --account-id (URN form)" },
+    "campaign-group-id": { type: "string", description: "Comma-separated IDs (level=campaign-group)" },
+    "campaign-id": { type: "string", description: "Comma-separated IDs (level=campaign)" },
+    "creative-id": { type: "string", description: "Comma-separated IDs (level=creative)" },
+    ids: { type: "string", description: "Generic CSV of IDs at the chosen level (alternative to per-level flags)" },
+    intent: {
+      type: "string",
+      description: "baseline|revenue|funnel|engagement|video|lead-gen|inmail|document|ranking|identity"
+    },
+    pivot: { type: "string", description: "Pivot dim. Default: none. See `--list-pivots`." },
+    metrics: { type: "string", description: "CSV metric override \u2014 bypass --intent's bundle" },
+    "list-intents": { type: "boolean", description: "Print intent definitions and exit" },
+    "list-pivots": { type: "boolean", description: "Print pivot slugs and exit" },
+    start: { type: "string", description: "Start date YYYY-MM-DD (overrides --last-days)" },
+    end: { type: "string", description: "End date YYYY-MM-DD" },
+    "last-days": { type: "string", description: "Window relative to today (default: 7)" },
+    granularity: { type: "string", description: "DAILY|MONTHLY|YEARLY|ALL (default: DAILY)" },
+    limit: { type: "string", description: "Max rows (default: 1000)" },
+    "no-sort": { type: "boolean", description: "Skip default sort by costInUsd desc" },
+    "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+    output: { type: "string", description: "Output format json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    if (args["list-intents"]) {
+      writeAdsJson({ ok: true, data: listIntents() });
+      return;
+    }
+    if (args["list-pivots"]) {
+      writeAdsJson({ ok: true, data: ALL_PIVOTS });
+      return;
+    }
+    const level = parseLevel(args.level);
+    const intent = parseIntent(args.intent);
+    const pivot = parsePivot(args.pivot);
+    let granularity = parseGranularity(args.granularity);
+    if (MEMBER_PIVOTS.has(pivot) && granularity === "DAILY") {
+      process.stderr.write(`note: pivot=${pivot} forces --granularity ALL (LinkedIn rejects DAILY + demographic).
+`);
+      granularity = "ALL";
+    }
+    const ids = resolveScopeIds(args, level);
+    if (ids.length === 0) {
+      handleLinkedinError(new Error(`No IDs resolved for --level ${level}`));
+    }
+    const range = resolveDateRange(args);
+    const metrics = commaSplit(args.metrics);
+    const limit = args.limit ? Number(args.limit) : 1e3;
+    const request = {
+      level,
+      ids,
+      intent,
+      pivot,
+      metrics,
+      start: range.start,
+      end: range.end,
+      granularity,
+      limit
+    };
+    try {
+      const data = await apiPost("/api/ads/linkedin/analytics", {
+        request,
+        skipCache: Boolean(args["skip-cache"])
+      });
+      const rows = args["no-sort"] ? data.rows : sortRows(data.rows);
+      const fmt = csvOrJson2(args);
+      if (fmt !== "json") {
+        writeAdsOutput(rows, fmt, data.fields);
         return;
       }
-      row[column] = column.toLowerCase() === "email" ? sha256Lower(value) : value;
-    });
-    if (Object.keys(row).length > 0) {
-      rows.push(row);
+      writeAdsJson({
+        ok: true,
+        data: {
+          rows,
+          fields: data.fields,
+          warnings: data.warnings,
+          query: data.query,
+          // Echo composed fields so an offline agent can pre-flight w/o this network call.
+          composedFields: composeFields(intent, level, metrics)
+        }
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+
+// src/commands/ads/linkedin/audience-size.ts
+import { readFileSync as readFileSync5 } from "fs";
+import { defineCommand as defineCommand35 } from "citty";
+function loadTargeting(args) {
+  const inline = args.targeting;
+  if (inline) {
+    try {
+      return JSON.parse(inline);
+    } catch {
+      handleLinkedinError(new Error("--targeting must be valid JSON. See LinkedIn 'targetingCriteria' shape."));
     }
   }
-  if (rows.length > maxRows) {
-    failWriteValidation2(`${path28} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+  const file = args["targeting-file"];
+  if (file) {
+    try {
+      return JSON.parse(readFileSync5(file, "utf-8"));
+    } catch (e) {
+      handleLinkedinError(
+        new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
+      );
+    }
   }
-  return { columns, rows };
+  handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
 }
-function failPreflight(fields) {
-  writeJsonEnvelope({
-    ok: false,
-    error: {
-      code: "VALIDATION_ERROR",
-      message: fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; "),
-      fields,
-      fix: capabilityFix("linkedin-ads")
+var audienceSizeCommand = defineCommand35({
+  meta: {
+    name: "audience-size",
+    description: `Estimate audience size for a targeting payload \u2014 pre-launch sanity check.
+
+Returns total + active counts plus playbook \xA704 warnings:
+  size <20K      \u2192 too narrow (will not deliver)
+  size <50K      \u2192 outside the 50K\u2013500K sweet spot
+  size >500K     \u2192 outside the sweet spot
+  size >1M       \u2192 too broad, refine ICP
+
+The targeting payload must follow LinkedIn's 'targetingCriteria' shape \u2014 an
+include/exclude tree of and/or boolean operators with adTargetingFacet keys.
+The simplest form:
+  { "include": { "and": [{ "or": { "urn:li:adTargetingFacet:locations": ["urn:li:geo:103644278"] }}]}}
+
+Examples:
+  baker ads linkedin audience-size --account-id 503001492 --targeting-file targeting.json
+  baker ads linkedin audience-size --account-id 503001492 --targeting '{"include":{"and":[]}}'`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria payload" },
+    "targeting-file": { type: "string", description: "Path to JSON file with targetingCriteria" },
+    "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg2(args);
+    const targetingCriteria = loadTargeting(args);
+    try {
+      const data = await apiPost("/api/ads/linkedin/audience-size", {
+        accountId,
+        targetingCriteria,
+        skipCache: Boolean(args["skip-cache"])
+      });
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
     }
+  }
+});
+
+// src/commands/ads/linkedin/audit.ts
+import { defineCommand as defineCommand36 } from "citty";
+var SEVERITY_RANK = {
+  critical: 0,
+  high: 1,
+  medium: 2,
+  low: 3
+};
+var STATUS_RANK = {
+  fail: 0,
+  warn: 1,
+  partial: 2,
+  pass: 3,
+  n_a: 4
+};
+function filterFindings(findings, severity, area) {
+  return findings.filter((f) => {
+    if (severity && !severity.includes(f.severity)) return false;
+    if (area && !area.includes(f.area)) return false;
+    return true;
   });
-  process.exit(1);
 }
-var BATCH_NUDGE = "This command takes several ids at once \u2014 pass them comma-separated or with --ids-file instead of one call per id.";
-function batchNudge(data) {
-  return data.sameKindStaged === void 0 ? [] : [BATCH_NUDGE];
+function sortFindings(findings) {
+  return [...findings].sort((a, b) => {
+    const sa = STATUS_RANK[a.status] - STATUS_RANK[b.status];
+    if (sa !== 0) return sa;
+    return SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity];
+  });
 }
-async function stageOp(raw, hints) {
-  const preflight = linkedinDraftOpInputSchema.safeParse(raw);
-  if (!preflight.success) {
-    failPreflight(preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message })));
-  }
-  try {
-    const chatId = requireChatId();
-    const response = await apiPost("/api/ads/linkedin/draft/stage", {
-      chatId,
-      op: preflight.data
-    });
-    const allHints = [...batchNudge(response.data), ...hints ?? [], ...adCopyHints(preflight.data)];
-    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
-  } catch (err) {
-    handleLinkedinError(err);
-  }
+function renderMarkdown(result) {
+  const lines = [];
+  lines.push(`# LinkedIn Ads Audit \u2014 ${result.account.name} (${result.account.id})`);
+  lines.push("");
+  lines.push(
+    `**Scope:** ${result.scope.campaigns} campaigns, ${result.scope.creatives} creatives, last ${result.scope.windowDays}d`
+  );
+  lines.push("");
+  lines.push(
+    `**Summary:** ${result.summary.pass} pass \u2022 ${result.summary.critical} critical \u2022 ${result.summary.high} high \u2022 ${result.summary.medium} medium \u2022 ${result.summary.low} low \u2022 ${result.summary.n_a} n/a (${result.summary.totalChecks} total)`
+  );
+  lines.push("");
+  lines.push("| # | Area | Check | Status | Severity | Notes |");
+  lines.push("|---|------|-------|--------|----------|-------|");
+  result.findings.forEach((f, idx) => {
+    const note = noteOf(f);
+    lines.push(
+      `| ${idx + 1} | ${f.area} | ${escapeMd(f.check)} | ${f.status.toUpperCase()} | ${f.severity} | ${escapeMd(note)} |`
+    );
+  });
+  return lines.join("\n");
 }
-async function stageLinkedinOps(rawOps, hints) {
-  if (rawOps.length === 1 && rawOps[0]) {
-    await stageOp(rawOps[0], hints);
-    return;
-  }
-  const ops = [];
-  for (const [index, raw] of rawOps.entries()) {
-    const preflight = linkedinDraftOpInputSchema.safeParse(raw);
-    if (!preflight.success) {
-      failPreflight(
-        preflight.error.issues.map((issue) => ({
-          path: `ops[${index}]${issue.path.length > 0 ? `.${issue.path.join(".")}` : ""}`,
-          message: issue.message
-        }))
-      );
-    }
-    ops.push(preflight.data);
-  }
-  try {
-    const chatId = requireChatId();
-    const response = await apiPost("/api/ads/linkedin/draft/stage-batch", { chatId, ops });
-    const allHints = [...hints ?? [], ...adCopyHints(ops)];
-    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
-  } catch (err) {
-    handleLinkedinError(err);
-  }
+function escapeMd(text) {
+  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
 }
-async function stageStatusChange(input) {
-  const payload = input.kind === "creative.update" ? { intendedStatus: input.status } : { status: input.status };
-  await stageLinkedinOps(
-    input.targets.map((target) => ({ kind: input.kind, accountId: input.accountId, target, payload }))
-  );
+function noteOf(f) {
+  if (f.status === "pass") return "";
+  const ev = f.evidence ? JSON.stringify(f.evidence) : "";
+  const fix = f.fix?.explanation ?? "";
+  return [fix, ev].filter(Boolean).join(" \u2014 ");
 }
-function requireTarget2(args, entity) {
-  const inverted = booleanWordPositionalError(args, entity);
-  if (inverted !== void 0) {
-    failWriteValidation2(inverted);
-  }
-  const positionals = readPositionals(args);
-  const target = args.id ?? args.target ?? args.ref ?? positionals[0];
-  if (typeof target !== "string" || target.length === 0) {
-    failWriteValidation2(`pass the ${entity} id or URN as the positional argument`);
-  }
-  if (positionals.length > 1 || splitIdList(target).length > 1) {
-    failWriteValidation2(
-      `this command takes one ${entity} id \u2014 run it once per id. Only pause/resume/archive and 'creatives update' accept several ids in one call.`
-    );
+var auditCommand = defineCommand36({
+  meta: {
+    name: "audit",
+    description: `Run a LinkedIn Ads playbook audit \u2014 30+ checks across Settings, Tracking,
+Audience, Campaigns, Creative, Performance, Bidding, and Compliance.
+
+Each finding has {id, area, check, status, severity, evidence, fix} fields with
+playbook citations. The default JSON output is agent-friendly; --format md
+renders a deliverable-ready table that mirrors the google-ads-playbook
+10-audit-summary.md style.
+
+Exit code 0 always. Use the JSON 'summary' counts to decide if action is needed.
+
+Examples:
+  baker ads linkedin audit --account-id 503001492
+  baker ads linkedin audit --account-id 503001492 --campaign-id 1234        # narrow scope
+  baker ads linkedin audit --account-id 503001492 --window-days 90
+  baker ads linkedin audit --account-id 503001492 --severity critical,high
+  baker ads linkedin audit --account-id 503001492 --area Settings,Tracking
+  baker ads linkedin audit --account-id 503001492 --format md`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "campaign-id": { type: "string", description: "Narrow scope to a single campaign" },
+    "window-days": { type: "string", description: "Lookback window for performance checks (default: 30)" },
+    severity: { type: "string", description: "CSV severity filter: critical,high,medium,low" },
+    area: {
+      type: "string",
+      description: "CSV area filter: Settings,Tracking,Audience,Campaigns,Creative,Performance,Bidding,Compliance,Hygiene"
+    },
+    format: { type: "string", description: "Output format: json | md (default: json)" },
+    "skip-cache": { type: "boolean", description: "Bypass server-side cache" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg2(args);
+    const windowDays = args["window-days"] ? Number(args["window-days"]) : 30;
+    if (!Number.isFinite(windowDays) || windowDays < 1 || windowDays > 365) {
+      handleLinkedinError(new Error("--window-days must be 1..365"));
+    }
+    try {
+      const data = await apiPost("/api/ads/linkedin/audit", {
+        accountId,
+        campaignId: args["campaign-id"] ? String(args["campaign-id"]) : void 0,
+        windowDays,
+        skipCache: Boolean(args["skip-cache"])
+      });
+      const severityFilter = args.severity?.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+      const areaFilter = args.area?.split(",").map((s) => s.trim()).filter(Boolean);
+      const filtered = filterFindings(data.findings, severityFilter, areaFilter);
+      const sorted = sortFindings(filtered);
+      const result = { ...data, findings: sorted };
+      const fmt = args.format ?? "json";
+      if (fmt === "md") {
+        process.stdout.write(`${renderMarkdown(result)}
+`);
+        return;
+      }
+      writeAdsJson({ ok: true, data: result });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
   }
-  return target;
-}
-function readPositionals(args) {
-  if (!Array.isArray(args._)) {
-    return [];
+});
+
+// src/commands/ads/linkedin/bid-pricing.ts
+import { readFileSync as readFileSync6 } from "fs";
+import { defineCommand as defineCommand37 } from "citty";
+function loadTargeting2(args) {
+  const inline = args.targeting;
+  if (inline) {
+    try {
+      return JSON.parse(inline);
+    } catch {
+      handleLinkedinError(new Error("--targeting must be valid JSON. See LinkedIn 'targetingCriteria' shape."));
+    }
   }
-  return args._.filter((value) => typeof value === "string" && value.length > 0);
-}
-function splitIdList(raw) {
-  return raw.split(",").map((id) => id.trim()).filter(Boolean);
-}
-function idsFileEntries(path28) {
-  if (typeof path28 !== "string" || path28.length === 0) {
-    return [];
+  const file = args["targeting-file"];
+  if (file) {
+    try {
+      return JSON.parse(readFileSync6(file, "utf-8"));
+    } catch (e) {
+      handleLinkedinError(
+        new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
+      );
+    }
   }
-  return readFileSync6(path28, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
+  handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
 }
-function requireTargets(args, entity) {
-  const positionals = readPositionals(args);
-  const named = [args.id, args.target, args.ref].filter(
-    (value) => typeof value === "string" && value.length > 0
-  );
-  const fromArgs = positionals.length > 0 ? positionals : named;
-  const targets = [.../* @__PURE__ */ new Set([...fromArgs.flatMap(splitIdList), ...idsFileEntries(args["ids-file"])])];
-  if (targets.length === 0) {
-    failWriteValidation2(
-      `pass the ${entity} id or URN as the positional argument (comma-separated for several), or --ids-file <path>`
-    );
-  }
-  if (targets.length > LINKEDIN_DRAFT_BATCH_MAX) {
-    failWriteValidation2(
-      `${targets.length} ids exceeds the batch limit of ${LINKEDIN_DRAFT_BATCH_MAX} \u2014 split the list`
-    );
+var bidPricingCommand = defineCommand37({
+  meta: {
+    name: "bid-pricing",
+    description: `Get LinkedIn's suggested bid range for a targeting + objective + cost type.
+
+Returns LinkedIn's min / suggested / max bid plus the playbook \xA706 floor
+(2/3 of suggested \u2014 the recommended manual CPC starting point).
+
+Objective types: BRAND_AWARENESS | WEBSITE_TRAFFIC | WEBSITE_VISIT |
+                 ENGAGEMENT | WEBSITE_CONVERSION | LEAD_GENERATION |
+                 JOB_APPLICANT | VIDEO_VIEW
+Cost types:      CPC | CPM | CPV | CPS
+
+Examples:
+  baker ads linkedin bid-pricing --account-id 503001492 --objective WEBSITE_CONVERSION --cost-type CPC --targeting-file targeting.json
+  baker ads linkedin bid-pricing --account-id 503001492 --objective LEAD_GENERATION --cost-type CPM --targeting '{"include":...}'`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    objective: {
+      type: "string",
+      description: "Objective type (e.g. WEBSITE_CONVERSION, LEAD_GENERATION)",
+      required: true
+    },
+    "cost-type": { type: "string", description: "CPC | CPM | CPV | CPS", required: true },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria" },
+    "targeting-file": { type: "string", description: "Path to JSON file with targetingCriteria" },
+    "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg2(args);
+    const targetingCriteria = loadTargeting2(args);
+    try {
+      const data = await apiPost("/api/ads/linkedin/bid-pricing", {
+        accountId,
+        objectiveType: String(args.objective),
+        costType: String(args["cost-type"]).toUpperCase(),
+        targetingCriteria,
+        skipCache: Boolean(args["skip-cache"])
+      });
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
   }
-  return targets;
-}
+});
+
+// src/commands/ads/linkedin/campaign-groups.ts
+import { defineCommand as defineCommand39 } from "citty";
 
 // src/commands/ads/linkedin/write-commands.ts
+import { defineCommand as defineCommand38 } from "citty";
 var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads linkedin draft`.";
 var accountArgs = {
   "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
@@ -11701,7 +11811,7 @@ Example: baker ads linkedin campaign-groups create --name "Q3 ABM" --start 2026-
     name: { type: "string", description: "Campaign group name (\u2264100 chars)" },
     start: { type: "string", description: "Run schedule start (ISO date or epoch ms)" },
     end: { type: "string", description: "Run schedule end" },
-    "total-budget": { type: "string", description: "Lifetime budget amount" },
+    "total-budget": { type: "string", description: TOTAL_BUDGET_HELP },
     currency: { type: "string", description: "3-letter currency code (defaults to the ad account currency)" },
     status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)" },
     file: { type: "string", description: "JSON file with the full payload; flags override file keys" }
@@ -11730,7 +11840,7 @@ Example: baker ads linkedin campaign-groups update 635137195 --total-budget 8000
     name: { type: "string", description: "New name" },
     start: { type: "string", description: "New run schedule start" },
     end: { type: "string", description: "New run schedule end" },
-    "total-budget": { type: "string", description: "New lifetime budget" },
+    "total-budget": { type: "string", description: TOTAL_BUDGET_HELP },
     currency: { type: "string", description: "3-letter currency code (defaults to the ad account currency)" },
     status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED|\u2026" },
     file: { type: "string", description: "JSON file with fields to change" }
@@ -11781,7 +11891,7 @@ var campaignFlagArgs = {
   "cost-type": { type: "string", description: "CPC|CPM|CPV" },
   bid: { type: "string", description: "Manual bid (unitCost) \u2014 playbook mandates manual bidding" },
   "daily-budget": { type: "string", description: "Daily budget amount" },
-  "total-budget": { type: "string", description: "Lifetime budget amount" },
+  "total-budget": { type: "string", description: TOTAL_BUDGET_HELP },
   currency: { type: "string", description: "3-letter currency code (defaults to the ad account currency)" },
   start: { type: "string", description: "Run schedule start (ISO date or epoch ms)" },
   end: { type: "string", description: "Run schedule end" },
@@ -26508,6 +26618,20 @@ Full guide: __tooling__/docs/tools/baker/history.md`
 import { defineCommand as defineCommand114 } from "citty";
 var EMBED_TYPES = ["legacy", "v4", "unknown"];
 function failNotConnected(err) {
+  if (err instanceof ApiError && err.code === "UNAUTHORIZED" && err.message.includes(HUBSPOT_MISSING_GRANT_MARKER)) {
+    writeJson({
+      ok: false,
+      error: {
+        code: "HUBSPOT_RECONNECT_REQUIRED",
+        message: err.message,
+        fix: {
+          action: "reconnect",
+          explanation: "AGENT INSTRUCTION: HubSpot IS connected \u2014 do not tell the user it is missing, and do not retry. This account was connected before this capability existed, so its access does not cover it. Only the user can widen it: tell them to open the dashboard, go to Brain -> Integrations -> Tools and reconnect HubSpot; it works from their next message. Do not abort the wider task: say which part you could not read, skip it, and finish everything else."
+        }
+      }
+    });
+    process.exit(1);
+  }
   if (err instanceof ApiError && err.code === "NOT_FOUND" && err.message.includes("No HubSpot account is connected")) {
     writeJson({
       ok: false,
@@ -26561,6 +26685,47 @@ registerSchema({
     }
   }
 });
+registerSchema({
+  command: "hubspot.forms.submissions",
+  description: "How many leads a form actually received over a window, and on which days \u2014 the difference between 'this form is live' and 'this form is working'. Start here when asked whether a form or a campaign is producing leads. Returns counts and dates only; the leads' own answers need --full and are personal data, so do not put them in a report. Pair with `hubspot pipelines list` to see whether those leads were then worked.",
+  args: {
+    formId: { type: "positional", description: "HubSpot form id (from `baker hubspot forms list`)", required: true },
+    days: { type: "string", description: "Window in days, 1-365 (default 30)", required: false },
+    full: {
+      type: "boolean",
+      description: "Include each submission's field values \u2014 personal data, request only when actually needed",
+      required: false,
+      default: false
+    }
+  }
+});
+registerSchema({
+  command: "hubspot.contacts.summary",
+  description: "Whether the leads that arrived recently are actually being worked, as counts: how many contacts were created in the window, how many have someone assigned, and how they split across lifecycle stages. This is the 'have these leads been treated?' answer. Returns no names or emails \u2014 use `hubspot contacts lookup` for one specific person.",
+  args: {
+    days: { type: "string", description: "Window in days, 1-365 (default 30)", required: false }
+  }
+});
+registerSchema({
+  command: "hubspot.contacts.lookup",
+  description: "One contact by email: its lifecycle stage, whether anyone is assigned, the account (company) it was filed under, and any deals it is attached to with their stage. Use it to settle whether a specific lead was picked up. `found: false` means the lead never reached the CRM at all \u2014 that is a finding, not an error. `companyReadable: false` means account details were not readable on this connection, so a null company is unknown rather than absent.",
+  args: {
+    email: { type: "positional", description: "The contact's email address", required: true }
+  }
+});
+registerSchema({
+  command: "hubspot.workflows.list",
+  description: "Every workflow on the connected account, with whether it is switched on. Read it when auditing what happens to a lead after it is captured \u2014 a form wired to a workflow that is off looks connected and does nothing.",
+  args: {
+    search: { type: "string", description: "Case-insensitive substring match on the workflow name", required: false },
+    "enabled-only": { type: "boolean", description: "Only workflows that are on", required: false, default: false }
+  }
+});
+registerSchema({
+  command: "hubspot.pipelines.list",
+  description: "The account's deal pipelines and their stages, in the order they run. Use it to answer where a lead lands once captured and whether it moved \u2014 the 'have these leads been worked?' half of a form audit.",
+  args: {}
+});
 registerSchema({
   command: "hubspot.meetings.list",
   description: "Every HubSpot meeting link (calendar) on the connected account, with just enough to choose one: name, slug, link type (personal / group / round-robin), whether booking redirects somewhere, and how many booking fields it asks for (null = unknown, read it with `meetings view`). Next step is usually `hubspot meetings view <slug> --as-node`, which gives you the blob to write straight into a hubspotMeeting step.",
@@ -26770,9 +26935,207 @@ var meetingsViewCommand = defineCommand114({
     }
   }
 });
+var formsSubmissionsCommand = defineCommand114({
+  meta: {
+    name: "submissions",
+    description: "How many leads a form received, and when. Example: baker hubspot forms submissions <formId> --days 30"
+  },
+  args: {
+    formId: { type: "positional", description: "HubSpot form id", required: true },
+    days: { type: "string", description: "Window in days (default 30)", required: false },
+    full: { type: "boolean", description: "Include each lead's answers", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const days = args.days === void 0 ? 30 : Number(args.days);
+      if (!Number.isInteger(days) || days < 1 || days > 365) {
+        throw new ApiError("VALIDATION_ERROR", "--days must be a whole number between 1 and 365.");
+      }
+      const response = await apiPost("/api/hubspot/forms/submissions", {
+        formId: args.formId,
+        days,
+        ...args.full ? { full: true } : {}
+      });
+      const { inWindow, total, truncated, lastSubmittedAt } = response.data;
+      const hints = [];
+      if (inWindow === 0) {
+        hints.push(
+          total === 0 ? "This form has received nothing at all \u2014 check it is the form actually embedded on the page before concluding the campaign is at fault." : `No leads in the last ${days} days, though the form has ${total} older submission(s). It worked once and has gone quiet.`
+        );
+      }
+      if (truncated) {
+        hints.push(
+          "Stopped before reaching the end of the window, so `inWindow` is a floor, not a count. Say so rather than reporting it as exact."
+        );
+      }
+      if (!args.full && inWindow > 0) {
+        hints.push(
+          "Counts only \u2014 the leads' own answers are not included. Add --full if you genuinely need the field values; it returns personal data, so do not paste it into a report or a chat message."
+        );
+      }
+      if (lastSubmittedAt !== null) {
+        hints.push(
+          "To find out whether these leads were worked, cross-check the deal pipeline: `baker hubspot pipelines list`."
+        );
+      }
+      writeJson({ ...response, meta: { count: inWindow }, ...hints.length > 0 ? { hints } : {} });
+    } catch (err) {
+      failNotConnected(err);
+    }
+  }
+});
+var workflowsListCommand = defineCommand114({
+  meta: {
+    name: "list",
+    description: "List HubSpot workflows. Example: baker hubspot workflows list --enabled-only"
+  },
+  args: {
+    search: { type: "string", description: "Match on workflow name", required: false },
+    "enabled-only": { type: "boolean", description: "Only workflows that are on", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = {};
+      if (args.search) {
+        body.search = args.search;
+      }
+      if (args["enabled-only"]) {
+        body.enabledOnly = true;
+      }
+      const response = await apiPost("/api/hubspot/workflows/list", body);
+      const { workflows } = response.data;
+      const off = workflows.filter((workflow) => !workflow.enabled);
+      const hints = [];
+      if (workflows.length === 0) {
+        hints.push("No workflows matched. Drop --search/--enabled-only, or the account genuinely has none.");
+      }
+      if (off.length > 0) {
+        hints.push(
+          `${off.length} of these are switched off. A form wired to a workflow that is off looks connected and does nothing \u2014 worth flagging to the user.`
+        );
+      }
+      writeJson({ ...response, meta: { count: workflows.length }, ...hints.length > 0 ? { hints } : {} });
+    } catch (err) {
+      failNotConnected(err);
+    }
+  }
+});
+var pipelinesListCommand = defineCommand114({
+  meta: {
+    name: "list",
+    description: "List HubSpot deal pipelines and their stages. Example: baker hubspot pipelines list"
+  },
+  args: {},
+  run: async () => {
+    try {
+      const response = await apiPost("/api/hubspot/pipelines/list", {});
+      const { pipelines } = response.data;
+      const hints = pipelines.length === 0 ? ["This account has no deal pipelines, so there is nowhere for a lead to be worked."] : ["Stages are listed in the order they run in HubSpot, so the first stage is where a new lead lands."];
+      writeJson({ ...response, meta: { count: pipelines.length }, hints });
+    } catch (err) {
+      failNotConnected(err);
+    }
+  }
+});
+var contactsSummaryCommand = defineCommand114({
+  meta: {
+    name: "summary",
+    description: "Whether recent leads are being worked, as counts. Example: baker hubspot contacts summary --days 30"
+  },
+  args: {
+    days: { type: "string", description: "Window in days (default 30)", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const days = args.days === void 0 ? 30 : Number(args.days);
+      if (!Number.isInteger(days) || days < 1 || days > 365) {
+        throw new ApiError("VALIDATION_ERROR", "--days must be a whole number between 1 and 365.");
+      }
+      const response = await apiPost("/api/hubspot/contacts/summary", { days });
+      const { total, withOwner, withoutOwner, byStage, truncated } = response.data;
+      const hints = [];
+      if (total === 0) {
+        hints.push(`No contacts were created in the last ${days} days \u2014 nothing reached the CRM in that window.`);
+      } else if (withOwner === 0) {
+        hints.push(
+          `None of these ${total} contacts has anyone assigned. That is the strongest available signal that the leads are arriving and nobody is picking them up \u2014 worth raising with the user.`
+        );
+      } else if (withoutOwner > withOwner) {
+        hints.push(`${withoutOwner} of ${total} contacts have nobody assigned \u2014 more unworked than worked.`);
+      }
+      const unset = byStage.find((entry) => entry.stage === "unset");
+      if (unset && unset.count > 0) {
+        hints.push(
+          `${unset.count} contact(s) have no lifecycle stage set at all, so they were created and never staged.`
+        );
+      }
+      if (truncated) {
+        hints.push("Stopped before reading every contact in the window, so these counts are floors, not totals.");
+      }
+      writeJson({ ...response, meta: { count: total }, ...hints.length > 0 ? { hints } : {} });
+    } catch (err) {
+      failNotConnected(err);
+    }
+  }
+});
+var contactsLookupCommand = defineCommand114({
+  meta: {
+    name: "lookup",
+    description: "Find one contact by email and see whether it was worked. Example: baker hubspot contacts lookup a@b.com"
+  },
+  args: {
+    email: { type: "positional", description: "The contact's email address", required: true }
+  },
+  run: async ({ args }) => {
+    try {
+      const response = await apiPost("/api/hubspot/contacts/lookup", {
+        email: args.email
+      });
+      const { found, contact, deals, company, companyReadable } = response.data;
+      const hints = [];
+      if (!found) {
+        hints.push(
+          "No contact with that email. The lead never reached the CRM \u2014 check the form's submissions before assuming the CRM lost it."
+        );
+      } else {
+        if (contact?.ownerId === null) {
+          hints.push("Nobody is assigned to this contact.");
+        }
+        if (deals.length === 0) {
+          hints.push("No deal is associated, so this contact was never taken into the pipeline.");
+        }
+        if (companyReadable && company === null) {
+          hints.push(
+            "No account is associated either. Most B2B setups create one automatically when a contact arrives, so this usually means the lead was never processed at all \u2014 not that the account is missing."
+          );
+        }
+        if (!companyReadable) {
+          hints.push(
+            "Account details were not read: this HubSpot connection does not cover them. Do not report the lead as having no account \u2014 you cannot tell. The user can enable it by reconnecting HubSpot."
+          );
+        }
+      }
+      writeJson({ ...response, meta: { count: found ? 1 : 0 }, ...hints.length > 0 ? { hints } : {} });
+    } catch (err) {
+      failNotConnected(err);
+    }
+  }
+});
+var contactsCommand = defineCommand114({
+  meta: { name: "contacts", description: "Contacts on the connected HubSpot account." },
+  subCommands: { summary: contactsSummaryCommand, lookup: contactsLookupCommand }
+});
 var formsCommand = defineCommand114({
   meta: { name: "forms", description: "HubSpot forms on the connected account." },
-  subCommands: { list: formsListCommand, view: formsViewCommand }
+  subCommands: { list: formsListCommand, view: formsViewCommand, submissions: formsSubmissionsCommand }
+});
+var workflowsCommand = defineCommand114({
+  meta: { name: "workflows", description: "HubSpot workflows on the connected account." },
+  subCommands: { list: workflowsListCommand }
+});
+var pipelinesCommand = defineCommand114({
+  meta: { name: "pipelines", description: "HubSpot deal pipelines on the connected account." },
+  subCommands: { list: pipelinesListCommand }
 });
 var meetingsCommand = defineCommand114({
   meta: { name: "meetings", description: "HubSpot meeting links (calendars) on the connected account." },
@@ -26781,21 +27144,37 @@ var meetingsCommand = defineCommand114({
 var hubspotCommand = defineCommand114({
   meta: {
     name: "hubspot",
-    description: `Read the connected HubSpot account \u2014 forms and meeting links (calendars) \u2014 and get the blob to wire one into a Form step yourself.
+    description: `Read the connected HubSpot account \u2014 forms, the leads they received, workflows, deal pipelines and
+meeting links (calendars) \u2014 and get the blob to wire a form into a Form step yourself.
 
 Examples:
   baker hubspot forms list                        # every form: embed type + post-submit action
   baker hubspot forms list --redirecting-only     # which forms redirect away on submit
   baker hubspot forms view <formId>               # fields, consent mode, full configuration
   baker hubspot forms view <formId> --as-node     # the form.external blob -> write into the step
+  baker hubspot forms submissions <formId>        # how many leads it got, and when
+  baker hubspot workflows list --enabled-only     # what runs after a lead is captured
+  baker hubspot pipelines list                    # where a lead lands, and the stages after it
+  baker hubspot contacts summary --days 30        # are recent leads being worked? (counts only)
+  baker hubspot contacts lookup a@b.com           # was this one lead picked up?
   baker hubspot meetings list                     # every calendar + whether booking redirects
   baker hubspot meetings view <slug> --as-node    # same, for a hubspotMeeting step
 
+An account connected before one of these existed cannot serve it \u2014 you get HUBSPOT_RECONNECT_REQUIRED, which
+means HubSpot IS connected and the user has to reconnect it to widen what Baker may read. Report that and
+carry on with the rest; never call it broken and never retry.
+
 Nothing here is secret, so HubSpot steps do not need request_flow_input: take --as-node and edit the
 flow's _data.json. Use the approval form only when no account is connected or the right form is unclear.
 Full guide: __tooling__/docs/tools/baker/hubspot.md`
   },
-  subCommands: { forms: formsCommand, meetings: meetingsCommand }
+  subCommands: {
+    forms: formsCommand,
+    workflows: workflowsCommand,
+    pipelines: pipelinesCommand,
+    contacts: contactsCommand,
+    meetings: meetingsCommand
+  }
 });
 
 // src/commands/images/index.ts
@@ -30883,6 +31262,21 @@ Subcommands:
 
 // src/commands/mcp/index.ts
 import { defineCommand as defineCommand141 } from "citty";
+
+// src/commands/mcp/platforms.ts
+function readsKey(label) {
+  const [first = "", ...rest] = label.split(" ");
+  return [first.toLowerCase(), ...rest].join("");
+}
+function platformEntry(platform) {
+  return {
+    platform: platform.label,
+    ...platform.account ? { account: platform.account } : {},
+    ...platform.readsLabel && platform.reads.length > 0 ? { [readsKey(platform.readsLabel)]: platform.reads } : {}
+  };
+}
+
+// src/commands/mcp/index.ts
 var SCOPES = ["user", "user_org", "company", "org"];
 function parseScope(raw) {
   const scope = raw === void 0 ? "company" : String(raw);
@@ -30930,18 +31324,21 @@ function fail6(err) {
   writeJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
   process.exit(1);
 }
+var PLATFORMS_HINT = "`platforms` are connected accounts you reach through `baker` commands (HubSpot, Google Ads, GA4, Search Console, Tag Manager, \u2026), NOT mcp__* tools \u2014 there is no tool to call for them. A platform listed here IS connected: never tell the user to connect it, and never conclude it is missing because it has no mcp__* entry. Read what it holds with its own command family (`baker hubspot \u2026`, `baker ads google \u2026`, `baker ga4 \u2026`, and so on).";
 registerSchema({
   command: "mcp.connected",
-  description: "List every third-party tool this chat can reach: managed integrations (Attio, Slack, Gmail, Google Sheets, \u2026) plus custom MCP servers. Start here when the user mentions an external tool.",
+  description: "List everything this chat can reach: managed integrations (Attio, Slack, Gmail, Google Sheets, \u2026), custom MCP servers, and the platforms the company signed in to (HubSpot, Google Ads, GA4, Search Console, Tag Manager) which you read through their own `baker` commands. Start here when the user mentions an external tool or platform.",
   args: {}
 });
 var connectedCommand = defineCommand141({
   meta: {
     name: "connected",
-    description: `List all connected third-party tools \u2014 managed integrations plus custom MCP servers.
+    description: `Everything this chat can reach \u2014 managed integrations, custom MCP servers, and connected platforms.
 
 Managed tools ride the composio servers (mcp__composio_<scope>__*); custom servers expose mcp__<name>__*.
-A tool the user names that is NOT listed here is simply not connected yet.`
+Platforms (HubSpot, Google Ads, GA4, \u2026) have no mcp__* tools at all \u2014 you read them with their own
+\`baker\` command family, and one listed here is connected and ready to use.
+A tool or platform the user names that is NOT listed anywhere here is simply not connected yet.`
   },
   run: async () => {
     try {
@@ -30955,7 +31352,11 @@ A tool the user names that is NOT listed here is simply not connected yet.`
         ...c.readOnly ? { readOnly: true } : {}
       }));
       const custom = data.custom.map(customEntry);
+      const platforms = (data.platforms ?? []).map(platformEntry);
       const hints = [];
+      if (platforms.length > 0) {
+        hints.push(PLATFORMS_HINT);
+      }
       if (data.custom.some((s) => s.health && !s.health.ok && !s.health.transient)) {
         hints.push(BROKEN_SERVER_HINT);
       }
@@ -30971,11 +31372,11 @@ A tool the user names that is NOT listed here is simply not connected yet.`
         );
       }
       hints.push(
-        "Not listed = not connected. Managed app (Slack, HubSpot, Attio, \u2026) \u2192 the user connects it in the dashboard: Brain \u2192 Integrations \u2192 Tools. Custom HTTPS MCP endpoint \u2192 `baker mcp add`."
+        "Not listed anywhere = not connected. Managed app (Slack, Attio, \u2026) or platform (HubSpot, Google Ads, GA4, \u2026) \u2192 the user connects it in the dashboard: Brain \u2192 Integrations \u2192 Tools. Custom HTTPS MCP endpoint \u2192 `baker mcp add`."
       );
       writeJson({
         ok: true,
-        data: { ...data.managedDisabled ? { managedDisabled: true } : {}, managed, custom },
+        data: { ...data.managedDisabled ? { managedDisabled: true } : {}, managed, custom, platforms },
         hints
       });
     } catch (err) {
@@ -31108,7 +31509,7 @@ Tools from a registered server appear as mcp__<name>__* on the next message.
 Managed here are **company-scoped** servers; user- and org-scoped servers are managed in the dashboard.
 
 Start here:
-  baker mcp connected   # everything this chat can reach: managed integrations + custom servers
+  baker mcp connected   # everything this chat can reach: managed integrations, custom servers, connected platforms
 
 Examples:
   baker mcp add --name weather --url https://mcp.example.com/mcp