@vitrina/api 11.35.0 → 11.36.1

package/dist/index.d.ts

@@ -13919,7 +13919,7 @@ interface paths {
         };
         /**
          * List the add-on catalog, this workspace's entitlements, and live usage
-         * @description The Complementos hub read. `catalog` is the typed feature catalog (prices are PR-reviewed code, never a runtime SKU table); `entitlements` is one row per add-on this workspace has ever held; `usage` carries the live meter for each metered add-on over the current **Santiago** month — `usage.tasador` is `{ used, free_allowance, period }`, where `used` is aggregated on read from `usage_event` (never a counter) and `free_allowance` reflects any per-workspace override, so it is the same pair of numbers the access gate decides on. Each entitlement carries `billed_by`: `vitrina` when Vitrina invoices the add-on, any other value when another party covers it (Vitrina charges nothing, so a client shows it as included rather than at the catalog price).
+         * @description The Complementos hub read. `catalog` is the typed feature catalog (prices are PR-reviewed code, never a runtime SKU table); `entitlements` is one row per add-on this workspace has ever held; `usage` carries the live meter for each metered add-on over the current **Santiago** month — `usage.tasador` is `{ used, free_allowance, period }`, where `used` is aggregated on read from `usage_event` (never a counter) and `free_allowance` reflects any per-workspace override, so it is the same pair of numbers the access gate decides on. Each entitlement carries `billed_by`: `vitrina` when Vitrina invoices the add-on, any other value when another party covers it (Vitrina charges nothing, so a client shows it as included rather than at the catalog price). A row may also carry a time-boxed waiver: `waiver_until` is the last free calendar day (America/Santiago) and `waiver_active` says whether it covers the add-on right now; once it lapses the add-on bills normally with no further action.
          */
         get: {
             parameters: {
@@ -13963,9 +13963,11 @@ interface paths {
                          *             "cancel_at_period_end": false,
                          *             "canceled_at": null,
                          *             "metadata": {},
+                         *             "waiver_until": "2026-10-31",
                          *             "created_at": "2026-09-01T12:00:00.000Z",
                          *             "updated_at": "2026-09-01T12:00:00.000Z",
-                         *             "billed_by": "vitrina"
+                         *             "billed_by": "vitrina",
+                         *             "waiver_active": true
                          *           }
                          *         ],
                          *         "usage": {
@@ -14005,10 +14007,14 @@ interface paths {
                                     metadata: {
                                         [key: string]: unknown;
                                     };
+                                    /** @description Last calendar day (`YYYY-MM-DD`, America/Santiago) this add-on is free under a time-boxed waiver: no charge accrues through the end of that day and activation needs no payment method. It bills normally from 00:00 Santiago of the next day. `null` = no waiver. */
+                                    waiver_until?: string | null;
                                     created_at: string;
                                     updated_at: string;
                                     /** @description Who invoices this add-on. `vitrina` (default) = Vitrina bills it at the catalog price. Any other value names the partner whose plan covers it; Vitrina charges nothing, so show the add-on as included and never render the partner value or the catalog price. */
                                     billed_by: string;
+                                    /** @description True while the `waiver_until` waiver covers the add-on right now (resolved server-side in America/Santiago). While true, show the add-on as included until that date instead of the catalog price. */
+                                    waiver_active: boolean;
                                 }[];
                                 usage: {
                                     tasador: {
@@ -14096,7 +14102,7 @@ interface paths {
         put?: never;
         /**
          * Self-serve activate an add-on (returns needs_enrollment without a payment mandate)
-         * @description Grants `feature` to the workspace once an active payment mandate exists (`{ status: "active", entitlement }`); with none, answers `{ status: "needs_enrollment" }` and grants nothing — the caller routes the dealer through the Fintoc/Mercado Pago enrollment step and retries. Idempotent on an already-active feature (re-answers the same `active` row rather than erroring).
+         * @description Grants `feature` to the workspace once an active payment mandate exists (`{ status: "active", entitlement }`); with none, answers `{ status: "needs_enrollment" }` and grants nothing — the caller routes the dealer through the Fintoc/Mercado Pago enrollment step and retries. No payment method is needed when the add-on costs the workspace nothing: its row is covered by another biller (`billed_by` other than `vitrina`) or sits inside an active `waiver_until` waiver; such an activation answers `active` and accrues no charge for the covered days. Idempotent on an already-active feature (re-answers the same `active` row rather than erroring).
          */
         post: {
             parameters: {
@@ -14131,6 +14137,7 @@ interface paths {
                          *           "cancel_at_period_end": false,
                          *           "canceled_at": null,
                          *           "metadata": {},
+                         *           "waiver_until": null,
                          *           "created_at": "2026-09-23T15:00:00.000Z",
                          *           "updated_at": "2026-09-23T15:00:00.000Z"
                          *         }
@@ -19946,6 +19953,9 @@ interface paths {
                          *           "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *           "temperature_at": "2026-09-21T14:02:11.000Z",
                          *           "won_lost_reason": null,
+                         *           "lost_reason": null,
+                         *           "lost_reason_source": null,
+                         *           "lost_reason_at": null,
                          *           "closed_at": null,
                          *           "created_by": "11111111-0000-4000-8000-000000000001",
                          *           "created_at": "2026-09-18T13:44:02.115Z",
@@ -20000,6 +20010,9 @@ interface paths {
                          *           "temperature_reason": null,
                          *           "temperature_at": null,
                          *           "won_lost_reason": null,
+                         *           "lost_reason": null,
+                         *           "lost_reason_source": null,
+                         *           "lost_reason_at": null,
                          *           "closed_at": null,
                          *           "created_by": null,
                          *           "created_at": "2026-09-19T09:12:44.000Z",
@@ -20194,6 +20207,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": null,
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": null,
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -20374,6 +20390,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": null,
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": null,
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -21064,6 +21083,9 @@ interface paths {
                          *                 "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *                 "temperature_at": "2026-09-21T14:02:11.000Z",
                          *                 "won_lost_reason": null,
+                         *                 "lost_reason": null,
+                         *                 "lost_reason_source": null,
+                         *                 "lost_reason_at": null,
                          *                 "closed_at": null,
                          *                 "created_by": "11111111-0000-4000-8000-000000000001",
                          *                 "created_at": "2026-09-18T13:44:02.115Z",
@@ -21128,6 +21150,9 @@ interface paths {
                          *                 "temperature_reason": null,
                          *                 "temperature_at": null,
                          *                 "won_lost_reason": null,
+                         *                 "lost_reason": null,
+                         *                 "lost_reason_source": null,
+                         *                 "lost_reason_at": null,
                          *                 "closed_at": null,
                          *                 "created_by": null,
                          *                 "created_at": "2026-09-19T09:12:44.000Z",
@@ -21405,6 +21430,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": null,
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": null,
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -21534,6 +21562,8 @@ interface paths {
                         /** @enum {string|null} */
                         temperature?: "hot" | "warm" | "cold" | null;
                         temperature_reason?: string | null;
+                        /** @enum {string} */
+                        lost_reason?: "bought_elsewhere" | "financing_rejected" | "unit_unavailable" | "price" | "not_ready" | "unresponsive" | "other";
                     };
                 };
             };
@@ -21575,6 +21605,9 @@ interface paths {
                          *         "temperature_reason": "volvió a escribir pidiendo la reserva",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": null,
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": null,
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -21993,6 +22026,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": null,
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": null,
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -22165,6 +22201,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": null,
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": null,
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -22338,6 +22377,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": null,
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": null,
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -22513,6 +22555,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": "cerró con financiamiento propio",
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": "2026-09-22T08:41:32.977Z",
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -22686,6 +22731,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": "compró en otra parte",
+                         *         "lost_reason": "bought_elsewhere",
+                         *         "lost_reason_source": "jev",
+                         *         "lost_reason_at": "2026-09-22T08:44:12.501Z",
                          *         "closed_at": "2026-09-22T08:44:10.331Z",
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -22859,6 +22907,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": "buscaba un servicio que no ofrecemos",
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": "2026-09-22T08:44:10.331Z",
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -23017,6 +23068,9 @@ interface paths {
                          *         "temperature_reason": "respondió pidiendo confirmar la hora y no ha vuelto a escribir",
                          *         "temperature_at": "2026-09-21T14:02:11.000Z",
                          *         "won_lost_reason": null,
+                         *         "lost_reason": null,
+                         *         "lost_reason_source": null,
+                         *         "lost_reason_at": null,
                          *         "closed_at": null,
                          *         "created_by": "11111111-0000-4000-8000-000000000001",
                          *         "created_at": "2026-09-18T13:44:02.115Z",
@@ -28118,7 +28172,7 @@ interface paths {
          * A contact’s scope-aware consent / do-not-contact ledger
          * @description Append-only history, newest fact first — this is the surface that can answer «since when, and how do you know».
          *
-         *     Each row is one fact about one `channel` (`whatsapp|email|voice|any`) in one `scope` (`marketing|service|promised_followup|all_proactive`). A marketing block does NOT block service messages; a current `all_proactive` block outranks every scope.
+         *     Each row is one fact about one `channel` (`whatsapp|email|voice|instagram|messenger|any`) in one `scope` (`marketing|service|promised_followup|all_proactive`). A marketing block does NOT block service messages; a current `all_proactive` block outranks every scope.
          *
          *     A superseded row stays readable rather than being overwritten, so the evidence trail survives the revocation.
          */
@@ -28260,7 +28314,7 @@ interface paths {
                      */
                     "application/json": {
                         /** @enum {string} */
-                        channel: "whatsapp" | "email" | "voice" | "any";
+                        channel: "whatsapp" | "email" | "voice" | "instagram" | "messenger" | "any";
                         /** @enum {string} */
                         scope: "marketing" | "service" | "promised_followup" | "all_proactive";
                         /** @enum {string} */
@@ -69292,7 +69346,7 @@ interface paths {
         };
         trace?: never;
     };
-    "/clinic/insights/comercial": {
+    "/clinic/patients/{id}/auto-links": {
         parameters: {
             query?: never;
             header?: never;
@@ -69300,30 +69354,23 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Commercial numbers: presupuesto acceptance, cierres, cash, botados
-         * @description The clinic's commercial numbers, aggregates only (counts, CLP, percentages, months and professional names; never a patient). `regime` says how acceptance is read: `evidencia` when the revenue mirror is on (a non-entry line performed, or a cita booked after the presupuesto, inside its window), `explicita` otherwise (the acceptance the clinic recorded). Acceptance is by COUNT of presupuestos, one per lineage; $0 and entry-only presupuestos are out of both sides; the window is 60 days (90 for ortodoncia and implantología); the rate goes to the professional who issued the presupuesto. Presupuestos ISSUED in the window form the acceptance cohort (`cohorts` by issue month with 30- and 60-day reads). A cierre is the first payment on an accepted presupuesto: once per presupuesto, dated on that payment, valued at the full accepted value. `headline` is the cash collected in the window against the previous window of the same length. `first_visit`, `second_visit` and `botados` carry `formula: propuesta`; `botados` is a live worklist over the last six months. Every KPI carries its `formula` and a printable `rule`; a rate with no denominator is `null`, never 0. `state` is `empty`, `settling` (presupuesto lines still being read; `state_reason` says so) or `ready`. Requires `clinic_money:read` (or `clinic_insights:read`, which reads the same aggregates). Accepts `from` / `to` (bare `YYYY-MM-DD`, `to` INCLUSIVE; default the 90 days ending today in the clinic's zone), `location_id` and `professional_id`. With `professional_id`, cash (`headline`, `months[].collected_clp`) is `null`: a payment belongs to the patient, not to a professional. A caller WITHOUT `clinic_money:read` always reads one fixed window — the last 3 closed calendar months — whatever range or filter it asks (`suppression.filters_ignored`), with every count or CLP resting on 1–4 cases `null`, rates over fewer than 5 cases `null`, complementary suppression over professionals, cohorts and botados lists, and month rows carrying only cash.
+         * Automatic contact links of a patient (Ads identity only)
+         * @description The contacts Vitrina matched to this ficha AUTOMATICALLY for Ads outcomes: an E.164 phone or an exact email held by exactly one patient and exactly one contact of the clinic, the patient an adult with a plausible birth date and not a carga, and no family bond or booking link on either side. It is identity for Ads only — it grants no booking and no access to the clinical record, and a family bond or a booking link always outranks it. Each row: `id`, `clinic_patient_id`, `contact_id`, `patient_name`, `contact_name`, `status` (`live` | `revoked` — a run found it no longer unique or ineligible — | `rejected` — a person said it is not this person, never re-opened), `method` (`phone_unique` | `email_unique`: which identifier was held by exactly one patient and one contact — the value itself is never stored), `matched_at`, `run_id` (the matching run, provenance), `revoked_at`, `revoked_reason`, `sent_count` / `last_sent_at` (Ads outcomes sent under the pair). Live first.
          *
-         *     **Connected apps:** every patient and contact in the response is a Seudónimo de paciente — initials plus a stable number, `"M.F. · #1001"` — unless the clinic allowed patient names, with RUT, phone and email masked in free text and `meta.patient_privacy` saying so. Clinical alerts (`flags`) are withheld in both modes, and a non-JSON body (an export, a file) is refused with `403 CONNECTED_APP_SENSITIVE_DATA`.
+         *     **Connected apps:** refused with `403 CONNECTED_APP_SENSITIVE_DATA`, whatever scopes they hold — this operation carries a dato sensible (ADR 0106 §4). Only an API key or a personal token of the workspace that holds the scope reaches it.
          */
         get: {
             parameters: {
-                query?: {
-                    /** @description First day of the window, inclusive. Defaults to 90 days before `to`. */
-                    from?: string;
-                    /** @description Last day of the window, INCLUSIVE. Defaults to today in the clinic's zone. */
-                    to?: string;
-                    /** @description One sucursal. Omit for all of them. */
-                    location_id?: string;
-                    /** @description One profesional. A foreign id is a 404, never an empty report. */
-                    professional_id?: string;
-                };
+                query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    id: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Clinic commercial numbers */
+                /** @description Patient auto-links */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -69332,151 +69379,538 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "from": "2026-06-01",
-                         *         "to": "2026-08-29",
-                         *         "timezone": "America/Santiago",
-                         *         "location_id": null,
-                         *         "professional_id": null,
-                         *         "state": "ready",
-                         *         "state_reason": null,
-                         *         "regime": "evidencia",
-                         *         "regime_label": "Aceptación por evidencia",
-                         *         "regime_rule": "Leído desde tu software de agenda: un presupuesto cuenta como aceptado cuando se realizó una de sus prestaciones o el paciente agendó una cita después de recibirlo.",
-                         *         "source": {
-                         *           "kind": "mirror",
-                         *           "synced_at": "2026-08-30T03:10:00.000Z"
-                         *         },
-                         *         "formulas": {
-                         *           "acceptance": "mentores_2026_09_25",
-                         *           "cierre": "cierre_2026_09_25",
-                         *           "first_visit": "propuesta",
-                         *           "second_visit": "propuesta",
-                         *           "botados": "propuesta"
-                         *         },
-                         *         "headline": {
-                         *           "collected_clp": 48500000,
-                         *           "previous_collected_clp": 44100000,
-                         *           "delta_pct": 10,
-                         *           "previous_from": "2026-03-03",
-                         *           "previous_to": "2026-05-31",
-                         *           "rule": "Lo cobrado en el período: todos los pagos recibidos, sin los anulados. Se compara con el período anterior del mismo largo."
-                         *         },
-                         *         "acceptance": {
-                         *           "presented": 420,
-                         *           "accepted": 231,
-                         *           "rate": 55,
-                         *           "same_day": 118,
-                         *           "later": 113,
-                         *           "cita_only": 14,
-                         *           "pending": 36,
-                         *           "presented_clp": 142000000,
-                         *           "accepted_clp": 71300000,
-                         *           "rate_30d": 47.2,
-                         *           "rate_60d": 53.8,
-                         *           "formula": "mentores_2026_09_25",
-                         *           "window_days": 60,
-                         *           "long_window_days": 90,
-                         *           "rule": "Presupuestos aceptados ÷ presupuestos presentados, cada presupuesto una vez."
-                         *         },
-                         *         "cierres": {
-                         *           "count": 180,
-                         *           "value_clp": 58900000,
-                         *           "accepted_without_payment": 51,
-                         *           "formula": "cierre_2026_09_25",
-                         *           "rule": "Un cierre es el primer pago de un presupuesto aceptado."
-                         *         },
-                         *         "cohorts": [
-                         *           {
-                         *             "month": "2026-06",
-                         *             "presented": 140,
-                         *             "accepted": 80,
-                         *             "rate": 57.1,
-                         *             "same_day": 41,
-                         *             "later": 39,
-                         *             "cita_only": 2,
-                         *             "pending": 0,
-                         *             "presented_clp": 47000000,
-                         *             "accepted_clp": 24800000,
-                         *             "rate_30d": 49.3,
-                         *             "rate_60d": 56.4,
-                         *             "mature": true
-                         *           }
-                         *         ],
-                         *         "by_professional": [
+                         *         "data": [
                          *           {
-                         *             "professional_id": "0f3c2a9e-5b1d-4c7e-9a42-6d8e1f2b3c4d",
-                         *             "professional_name": "Dra. Camila Soto",
-                         *             "presented": 96,
-                         *             "accepted": 61,
-                         *             "rate": 63.5,
-                         *             "same_day": 30,
-                         *             "later": 31,
-                         *             "cita_only": 3,
-                         *             "pending": 8,
-                         *             "presented_clp": 33400000,
-                         *             "accepted_clp": 19900000,
-                         *             "cierres": 47,
-                         *             "cierres_clp": 15100000
+                         *             "id": "a7a7a7a7-0000-4000-8000-000000000001",
+                         *             "clinic_patient_id": "b1b0b8de-0000-4000-8000-000000000001",
+                         *             "contact_id": "1a73af9e-0000-4000-8000-000000000001",
+                         *             "patient_name": "María José Fuentes Lagos",
+                         *             "contact_name": "María José Fuentes Lagos",
+                         *             "status": "live",
+                         *             "method": "phone_unique",
+                         *             "matched_at": "2026-09-27T14:10:02.118Z",
+                         *             "run_id": "a8a8a8a8-0000-4000-8000-000000000001",
+                         *             "revoked_at": null,
+                         *             "revoked_reason": null,
+                         *             "sent_count": 3,
+                         *             "last_sent_at": "2026-09-28T12:02:40.551Z"
                          *           }
-                         *         ],
-                         *         "unassigned_presented": 0,
-                         *         "unassigned_cierres": 0,
-                         *         "months": [
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data?: unknown;
+                            meta?: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/clinic/contacts/{contactId}/auto-links": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Patients automatically linked to a contact (Ads identity only)
+         * @description The contact side of the same automatic links — what the contact ficha shows as «Vinculado automáticamente». An empty list, not a 404, when there is none. Each row: `id`, `clinic_patient_id`, `contact_id`, `patient_name`, `contact_name`, `status` (`live` | `revoked` — a run found it no longer unique or ineligible — | `rejected` — a person said it is not this person, never re-opened), `method` (`phone_unique` | `email_unique`: which identifier was held by exactly one patient and one contact — the value itself is never stored), `matched_at`, `run_id` (the matching run, provenance), `revoked_at`, `revoked_reason`, `sent_count` / `last_sent_at` (Ads outcomes sent under the pair). Live first.
+         *
+         *     **Connected apps:** refused with `403 CONNECTED_APP_SENSITIVE_DATA`, whatever scopes they hold — this operation carries a dato sensible (ADR 0106 §4). Only an API key or a personal token of the workspace that holds the scope reaches it.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    contactId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Contact auto-links */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "data": [
                          *           {
-                         *             "month": "2026-06",
-                         *             "accepted_clp": 24100000,
-                         *             "produced_clp": 19700000,
-                         *             "collected_clp": 16200000,
-                         *             "cierres": 62,
-                         *             "cierres_clp": 20300000
+                         *             "id": "a7a7a7a7-0000-4000-8000-000000000001",
+                         *             "clinic_patient_id": "b1b0b8de-0000-4000-8000-000000000001",
+                         *             "contact_id": "1a73af9e-0000-4000-8000-000000000001",
+                         *             "patient_name": "María José Fuentes Lagos",
+                         *             "contact_name": "María José Fuentes Lagos",
+                         *             "status": "live",
+                         *             "method": "phone_unique",
+                         *             "matched_at": "2026-09-27T14:10:02.118Z",
+                         *             "run_id": "a8a8a8a8-0000-4000-8000-000000000001",
+                         *             "revoked_at": null,
+                         *             "revoked_reason": null,
+                         *             "sent_count": 3,
+                         *             "last_sent_at": "2026-09-28T12:02:40.551Z"
                          *           }
-                         *         ],
-                         *         "first_visit": {
-                         *           "formula": "propuesta",
-                         *           "patients": 210,
-                         *           "paid": 97,
-                         *           "rate": 46.2,
-                         *           "rule": "Fórmula propuesta."
-                         *         },
-                         *         "second_visit": {
-                         *           "formula": "propuesta",
-                         *           "eligible": 113,
-                         *           "converted": 29,
-                         *           "rate": 25.7,
-                         *           "rule": "Fórmula propuesta."
-                         *         },
-                         *         "botados": {
-                         *           "unaccepted": {
-                         *             "count": 88,
-                         *             "clp": 31200000
-                         *           },
-                         *           "accepted_unscheduled": {
-                         *             "count": 17,
-                         *             "clp": 6400000
-                         *           },
-                         *           "mid_treatment_no_future_cita": {
-                         *             "count": 23,
-                         *             "clp": 9800000
-                         *           },
-                         *           "formula": "propuesta",
-                         *           "basis": "live_last_6_months",
-                         *           "total": {
-                         *             "count": 128,
-                         *             "clp": 47400000
-                         *           },
-                         *           "focus": "unaccepted",
-                         *           "rule": "Fórmula propuesta."
-                         *         },
-                         *         "coverage": {
-                         *           "plans_without_lines": 0,
-                         *           "excluded_zero": 301,
-                         *           "excluded_entry_only": 92
-                         *         }
+                         *         ]
                          *       }
                          *     }
                          */
                         "application/json": {
-                            data: components["schemas"]["ClinicComercialReport"];
+                            data?: unknown;
+                            meta?: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/clinic/auto-links/{id}/reject": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * «No es esta persona» — reject an automatic link for good
+         * @description Marks the pair `rejected`: no later matching run re-opens it, and the Ads outcomes sent under it that have not left Vitrina yet are withheld (`withheld_outcomes` says how many). What already reached the ad platforms is not recalled. Idempotent. Answers the row. 404 when the id is not this clinic’s.
+         *
+         *     **Connected apps:** refused with `403 CONNECTED_APP_SENSITIVE_DATA`, whatever scopes they hold — this operation carries a dato sensible (ADR 0106 §4). Only an API key or a personal token of the workspace that holds the scope reaches it.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    /** @example {} */
+                    "application/json": Record<string, never>;
+                };
+            };
+            responses: {
+                /** @description Rejected auto-link */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "id": "a7a7a7a7-0000-4000-8000-000000000001",
+                         *         "clinic_patient_id": "b1b0b8de-0000-4000-8000-000000000001",
+                         *         "contact_id": "1a73af9e-0000-4000-8000-000000000001",
+                         *         "patient_name": "María José Fuentes Lagos",
+                         *         "contact_name": "María José Fuentes Lagos",
+                         *         "status": "rejected",
+                         *         "method": "phone_unique",
+                         *         "matched_at": "2026-09-27T14:10:02.118Z",
+                         *         "run_id": "a8a8a8a8-0000-4000-8000-000000000001",
+                         *         "revoked_at": "2026-09-28T15:31:09.004Z",
+                         *         "revoked_reason": "rejected",
+                         *         "sent_count": 3,
+                         *         "last_sent_at": "2026-09-28T12:02:40.551Z",
+                         *         "withheld_outcomes": 1
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data?: unknown;
+                            meta?: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/clinic/insights/comercial": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Commercial numbers: presupuesto acceptance, cierres, cash, botados
+         * @description The clinic's commercial numbers, aggregates only (counts, CLP, percentages, months and professional names; never a patient). `regime` says how acceptance is read: `evidencia` when the revenue mirror is on (a non-entry line performed, or a cita booked after the presupuesto, inside its window), `explicita` otherwise (the acceptance the clinic recorded). Acceptance is by COUNT of presupuestos, one per lineage; $0 and entry-only presupuestos are out of both sides; the window is 60 days (90 for ortodoncia and implantología); the rate goes to the professional who issued the presupuesto. Presupuestos ISSUED in the window form the acceptance cohort (`cohorts` by issue month with 30- and 60-day reads). A cierre is the first payment on an accepted presupuesto: once per presupuesto, dated on that payment, valued at the full accepted value. `headline` is the cash collected in the window against the previous window of the same length. `first_visit`, `second_visit` and `botados` carry `formula: propuesta`; `botados` is a live worklist over the last six months. Every KPI carries its `formula` and a printable `rule`; a rate with no denominator is `null`, never 0. `state` is `empty`, `settling` (presupuesto lines still being read; `state_reason` says so) or `ready`. Requires `clinic_money:read` (or `clinic_insights:read`, which reads the same aggregates). Accepts `from` / `to` (bare `YYYY-MM-DD`, `to` INCLUSIVE; default the 90 days ending today in the clinic's zone), `location_id` and `professional_id`. With `professional_id`, cash (`headline`, `months[].collected_clp`) is `null`: a payment belongs to the patient, not to a professional. A caller WITHOUT `clinic_money:read` always reads one fixed window — the last 3 closed calendar months — whatever range or filter it asks (`suppression.filters_ignored`), with every count or CLP resting on 1–4 cases `null`, rates over fewer than 5 cases `null`, complementary suppression over professionals, cohorts and botados lists, and month rows carrying only cash.
+         *
+         *     **Connected apps:** every patient and contact in the response is a Seudónimo de paciente — initials plus a stable number, `"M.F. · #1001"` — unless the clinic allowed patient names, with RUT, phone and email masked in free text and `meta.patient_privacy` saying so. Clinical alerts (`flags`) are withheld in both modes, and a non-JSON body (an export, a file) is refused with `403 CONNECTED_APP_SENSITIVE_DATA`.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description First day of the window, inclusive. Defaults to 90 days before `to`. */
+                    from?: string;
+                    /** @description Last day of the window, INCLUSIVE. Defaults to today in the clinic's zone. */
+                    to?: string;
+                    /** @description One sucursal. Omit for all of them. */
+                    location_id?: string;
+                    /** @description One profesional. A foreign id is a 404, never an empty report. */
+                    professional_id?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Clinic commercial numbers */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "from": "2026-06-01",
+                         *         "to": "2026-08-29",
+                         *         "timezone": "America/Santiago",
+                         *         "location_id": null,
+                         *         "professional_id": null,
+                         *         "state": "ready",
+                         *         "state_reason": null,
+                         *         "regime": "evidencia",
+                         *         "regime_label": "Aceptación por evidencia",
+                         *         "regime_rule": "Leído desde tu software de agenda: un presupuesto cuenta como aceptado cuando se realizó una de sus prestaciones o el paciente agendó una cita después de recibirlo.",
+                         *         "source": {
+                         *           "kind": "mirror",
+                         *           "synced_at": "2026-08-30T03:10:00.000Z"
+                         *         },
+                         *         "formulas": {
+                         *           "acceptance": "mentores_2026_09_25",
+                         *           "cierre": "cierre_2026_09_25",
+                         *           "first_visit": "propuesta",
+                         *           "second_visit": "propuesta",
+                         *           "botados": "propuesta"
+                         *         },
+                         *         "headline": {
+                         *           "collected_clp": 48500000,
+                         *           "previous_collected_clp": 44100000,
+                         *           "delta_pct": 10,
+                         *           "previous_from": "2026-03-03",
+                         *           "previous_to": "2026-05-31",
+                         *           "rule": "Lo cobrado en el período: todos los pagos recibidos, sin los anulados. Se compara con el período anterior del mismo largo."
+                         *         },
+                         *         "acceptance": {
+                         *           "presented": 420,
+                         *           "accepted": 231,
+                         *           "rate": 55,
+                         *           "same_day": 118,
+                         *           "later": 113,
+                         *           "cita_only": 14,
+                         *           "pending": 36,
+                         *           "presented_clp": 142000000,
+                         *           "accepted_clp": 71300000,
+                         *           "rate_30d": 47.2,
+                         *           "rate_60d": 53.8,
+                         *           "formula": "mentores_2026_09_25",
+                         *           "window_days": 60,
+                         *           "long_window_days": 90,
+                         *           "rule": "Presupuestos aceptados ÷ presupuestos presentados, cada presupuesto una vez."
+                         *         },
+                         *         "cierres": {
+                         *           "count": 180,
+                         *           "value_clp": 58900000,
+                         *           "accepted_without_payment": 51,
+                         *           "formula": "cierre_2026_09_25",
+                         *           "rule": "Un cierre es el primer pago de un presupuesto aceptado."
+                         *         },
+                         *         "cohorts": [
+                         *           {
+                         *             "month": "2026-06",
+                         *             "presented": 140,
+                         *             "accepted": 80,
+                         *             "rate": 57.1,
+                         *             "same_day": 41,
+                         *             "later": 39,
+                         *             "cita_only": 2,
+                         *             "pending": 0,
+                         *             "presented_clp": 47000000,
+                         *             "accepted_clp": 24800000,
+                         *             "rate_30d": 49.3,
+                         *             "rate_60d": 56.4,
+                         *             "mature": true
+                         *           }
+                         *         ],
+                         *         "by_professional": [
+                         *           {
+                         *             "professional_id": "0f3c2a9e-5b1d-4c7e-9a42-6d8e1f2b3c4d",
+                         *             "professional_name": "Dra. Camila Soto",
+                         *             "presented": 96,
+                         *             "accepted": 61,
+                         *             "rate": 63.5,
+                         *             "same_day": 30,
+                         *             "later": 31,
+                         *             "cita_only": 3,
+                         *             "pending": 8,
+                         *             "presented_clp": 33400000,
+                         *             "accepted_clp": 19900000,
+                         *             "cierres": 47,
+                         *             "cierres_clp": 15100000
+                         *           }
+                         *         ],
+                         *         "unassigned_presented": 0,
+                         *         "unassigned_cierres": 0,
+                         *         "months": [
+                         *           {
+                         *             "month": "2026-06",
+                         *             "accepted_clp": 24100000,
+                         *             "produced_clp": 19700000,
+                         *             "collected_clp": 16200000,
+                         *             "cierres": 62,
+                         *             "cierres_clp": 20300000
+                         *           }
+                         *         ],
+                         *         "first_visit": {
+                         *           "formula": "propuesta",
+                         *           "patients": 210,
+                         *           "paid": 97,
+                         *           "rate": 46.2,
+                         *           "rule": "Fórmula propuesta."
+                         *         },
+                         *         "second_visit": {
+                         *           "formula": "propuesta",
+                         *           "eligible": 113,
+                         *           "converted": 29,
+                         *           "rate": 25.7,
+                         *           "rule": "Fórmula propuesta."
+                         *         },
+                         *         "botados": {
+                         *           "unaccepted": {
+                         *             "count": 88,
+                         *             "clp": 31200000
+                         *           },
+                         *           "accepted_unscheduled": {
+                         *             "count": 17,
+                         *             "clp": 6400000
+                         *           },
+                         *           "mid_treatment_no_future_cita": {
+                         *             "count": 23,
+                         *             "clp": 9800000
+                         *           },
+                         *           "formula": "propuesta",
+                         *           "basis": "live_last_6_months",
+                         *           "total": {
+                         *             "count": 128,
+                         *             "clp": 47400000
+                         *           },
+                         *           "focus": "unaccepted",
+                         *           "rule": "Fórmula propuesta."
+                         *         },
+                         *         "coverage": {
+                         *           "plans_without_lines": 0,
+                         *           "excluded_zero": 301,
+                         *           "excluded_entry_only": 92
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["ClinicComercialReport"];
                         };
                     };
                 };
@@ -76199,7 +76633,8 @@ interface paths {
                          *               "display_name": "Garantía"
                          *             }
                          *           ],
-                         *           "last_call": null
+                         *           "last_call": null,
+                         *           "handoff_urgent": false
                          *         },
                          *         {
                          *           "id": "bbbbbbbb-0000-4000-8000-000000000002",
@@ -76335,7 +76770,8 @@ interface paths {
                          *             "captured_at": "2026-09-22T10:41:12.004Z"
                          *           },
                          *           "tags": [],
-                         *           "last_call": null
+                         *           "last_call": null,
+                         *           "handoff_urgent": false
                          *         }
                          *       ],
                          *       "meta": {
@@ -76740,7 +77176,9 @@ interface paths {
          *
          *     Also carries `ad_origin_nudge: 'connect_meta_ads' | null`, non-null ONLY when the caller holds `integrations:write`, the conversation came from a Meta ad (click-to-WhatsApp or an Instagram DM ad), and the workspace has no connected `meta_ads` integration. THIS ROUTE ONLY — deliberately absent from the list, where the predicate would be an N+1.
          *
-         *     And `handoff_resolved_suggested: boolean` (#2968) — true only on an open/pending AI-handoff thread whose customer is still waiting on us AND Jev already read their own pending words as saying the matter is resolved (checked once per customer message, at the next handoff re-notify tick). The inbox reads this to offer a one-click close. THIS ROUTE ONLY, same N+1 reasoning as `ad_origin_nudge`.
+         *     And `handoff_resolved_suggested: boolean` (#2968) — true only on an open/pending AI-handoff thread whose customer is still waiting on us AND Jev already read their own pending words as saying the matter is resolved (checked once per customer message, at the next handoff re-notify tick). The inbox reads this to offer a one-click close. THIS ROUTE ONLY, same N+1 reasoning as `ad_origin_nudge` — unlike `handoff_urgent` below, this one was never worth a column since only the open thread needs it.
+         *
+         *     `handoff_urgent: boolean` (#2969) is a plain `conversation` column, not a per-route annotation: true while an open/pending AI-handoff thread's customer is still waiting on us and Jev read their newest pending message as urgent (a clinic post-treatment complication, or an explicit same-day deadline) — kept in sync by the same classification that also tightens the re-notify cadence, and present on every conversation read, list included, because the inbox shows the flag on the conversation ROW too, not only its header.
          *
          *     Carries `ad_origin` exactly as `GET /conversations` rows do.
          */
@@ -76883,6 +77321,7 @@ interface paths {
                          *           }
                          *         ],
                          *         "last_call": null,
+                         *         "handoff_urgent": false,
                          *         "ad_origin_nudge": null,
                          *         "handoff_resolved_suggested": false,
                          *         "message": [
@@ -92624,75 +93063,982 @@ interface paths {
                 };
             };
         };
-        put?: never;
-        post?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/insights/generate-pdf": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Render a report as a PDF
+         * @description **The one endpoint on the tenant API that does not answer the `{ data }` envelope.** It replies with raw `application/pdf` bytes and a `Content-Disposition: attachment` header, so a client that pipes every response through the usual JSON parse will fail here. On an error it reverts to the JSON error envelope, which means the response content-type is what tells the two apart.
+         *
+         *     Generation is SYNCHRONOUS: it queries the report, runs an LLM pass to write the narrative, then renders. The connection is held for all of that, there is no job id, and nothing is persisted — a client or proxy timeout loses the document with no way to retrieve it other than asking again. Treat a wide range as a slow request.
+         *
+         *     The LLM pass degrades rather than fails: if the narrative cannot be generated you still get a 200 and a complete PDF, with a Spanish note in place of the executive summary and every raw figure intact. So a successful response does not by itself mean the analysis is there.
+         *
+         *     `range.preset` is not a range selector — `from`/`to` alone decide the data. It is the window’s NAME: printed as the cover subtitle and passed into the summariser’s prompt, so a preset that disagrees with `from`/`to` mislabels the cover and misleads the narrative while the figures stay correct. Defaults to `custom`. Needs only `analytics:read`.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    /**
+                     * @example {
+                     *       "report": "conversations",
+                     *       "window": {
+                     *         "preset": "7d"
+                     *       },
+                     *       "range": {
+                     *         "preset": "7d"
+                     *       }
+                     *     }
+                     */
+                    "application/json": {
+                        /** @enum {string} */
+                        report_type: "overview" | "conversations" | "agents" | "ai_agents" | "bots" | "tags" | "channels" | "teams" | "leads" | "csat" | "sla" | "clinic_ocupacion" | "clinic_inasistencias" | "clinic_produccion" | "clinic_packs";
+                        range: {
+                            from: string;
+                            to: string;
+                            preset?: string;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description The rendered PDF as an attachment */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/pdf": string;
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/insights/schedules": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List report schedules
+         * @description The standing subscriptions that mail a rendered report out on a cadence. Unpaginated, and with no `meta.total` — this list is small by construction.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Report schedules */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": [
+                         *         {
+                         *           "id": "cccccccc-2000-4000-8000-000000000001",
+                         *           "report_type": "conversations",
+                         *           "range_preset": "7d",
+                         *           "cadence": "weekly",
+                         *           "recipients": [
+                         *             "gerencia@midealer.cl"
+                         *           ],
+                         *           "next_run_at": "2026-09-29T09:00:00.000Z",
+                         *           "enabled": true
+                         *         }
+                         *       ]
+                         *     }
+                         */
+                        "application/json": {
+                            data?: unknown;
+                            meta?: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/integrations/meta-ads": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read the workspace’s Meta Ads connection
+         * @description The tenant’s single Meta Ads row, or `null` when it has never started a connect. A placeholder object with `status: "disconnected"` is deliberately NOT returned in its place: "never connected" and "was connected and is not any more" are different states and the card says different things about them.
+         *
+         *     `handoff` is populated only while `status` is `pending` and `candidates` only while it is `pending_selection` — a spent consent URL would render a button leading to a dead page.
+         *
+         *     Requires `integrations:read` or `ads:read` (owner, admin and the Marketing role); a `supervisor` or `agent` gets 403 here and never sees the card. The writes need `integrations:write` or `ads:write`.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The Meta Ads integration, or `null` */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": null
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["MetaAdsIntegration"];
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/integrations/meta-ads/connect": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Start a Meta Ads connect and get the consent URL
+         * @description Mints the connection provider’s **connect hand-off** for `meta_ads` and answers the session-less consent URL to redirect the WHOLE PAGE to. It is not an iframe target: Meta’s own consent dialog renders inside it.
+         *
+         *     `return_to` must be an absolute URL on the app’s own origin. The backend appends `meta_ads=return` and a short opaque `state`, preserving any query the URL already carried, and passes the result to the provider as `return_url`. An origin that is not the app’s is a 400 here rather than a silent substitution — the provider itself only checks the origin when the human CLICKS, where it surfaces as a failed hand-off (`result.reason: origin_not_allowed`) after the dealer has already walked through a consent screen for nothing.
+         *
+         *     **A second click reuses the live hand-off.** The provider’s URL is single-use and 45-minute-lived, and minting twice yields two hand-offs rather than an error, so a dealer who clicks, gets distracted and clicks again gets the SAME `url` and `handoff_id` back until it expires.
+         *
+         *     Before anything is minted, the tenant’s attribution profile and its delegated key are ensured (ADR 0099). This rail never uses a platform-wide provider key.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    /**
+                     * @example {
+                     *       "return_to": "https://app.vitrinadev.com/settings/integraciones?meta_ads=return"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["MetaAdsConnectBody"];
+                };
+            };
+            responses: {
+                /** @description The consent URL, its hand-off id, and its expiry */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "url": "https://consent.example.com/connect/meta-ads/ho_4d8f2a91c6b3",
+                         *         "handoff_id": "ho_4d8f2a91c6b3",
+                         *         "expires_at": "2026-09-23T15:45:00.000Z"
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["MetaAdsConnectResult"];
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/integrations/meta-ads/return": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Settle a Meta Ads connect after the dealer comes back
+         * @description Reads the hand-off ONCE and settles the row:
+         *
+         *     * `completed` with a connection id → the connection is read back from the provider and the row becomes `connected`, carrying the ad account’s name, id, currency, timezone and whether the platform has ever delivered spend.
+         *     * `completed` with a pending selection → the row becomes `pending_selection` and carries the candidates the picker renders. **A consent that resolved to exactly one account never reaches this branch** — the provider finalizes it in its own callback, which is why there is no auto-finalize step on this side.
+         *     * `expired` / `cancelled` / `failed` → the row becomes `error` with a retryable `reason` of `handoff_<status>`. The recovery is identical for all three: mint a fresh hand-off.
+         *     * still `pending` → nothing is settled and the row comes back unchanged.
+         *
+         *     **Neither field is required.** The hand-off id only exists in the RESPONSE to the mint while `return_url` is an argument to that same mint, so the return URL structurally cannot carry it — it carries `meta_ads=return` and the opaque `state` instead. Send `handoff_id` if you kept it, `state` if you read it off the URL, or an empty body, in which case the backend settles the row’s own pending hand-off (unambiguous: a tenant has at most one).
+         *
+         *     Safe to repeat — a settled hand-off stays readable at the provider, so a re-post on a refresh re-derives the same state.
+         *
+         *     409 `handoff_mismatch` when the id or state presented does not name the hand-off this tenant’s row is waiting on, and for a tenant with no connect in flight at all (the two are deliberately the same answer).
+         *
+         *     502 `UPSTREAM_ERROR` when the provider could not be read; the row is left unchanged and the call is safe to repeat.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    /**
+                     * @example {
+                     *       "state": "9f3a2d7c8b1e4a2f"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["MetaAdsReturnBody"];
+                };
+            };
+            responses: {
+                /** @description The settled integration */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "id": "22222222-2222-4222-8222-222222222222",
+                         *         "provider": "meta_ads",
+                         *         "status": "connected",
+                         *         "account_label": "Cuenta Meta Ads",
+                         *         "connected_at": "2026-09-23T15:04:00.000Z",
+                         *         "disconnected_at": null,
+                         *         "account": {
+                         *           "external_account_id": "act_1234567890",
+                         *           "name": "Automotora Ejemplo",
+                         *           "currency": "CLP",
+                         *           "timezone": "America/Santiago",
+                         *           "delivers_spend": true,
+                         *           "provider_connection_id": "c0c0c0c0-0000-4000-8000-000000000001",
+                         *           "atribu_connection_id": "c0c0c0c0-0000-4000-8000-000000000001"
+                         *         },
+                         *         "error": null,
+                         *         "handoff": null,
+                         *         "candidates": null,
+                         *         "updated_at": "2026-09-23T15:04:00.000Z"
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["MetaAdsIntegration"] & Record<string, never>;
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/integrations/meta-ads/disconnect": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Disconnect the workspace’s Meta Ads ad account
+         * @description Calls the provider’s disconnect for the connection on the delegated key and settles the row `disconnected`, keeping its history: `account_label` and `connected_at` stay, and `config.last_account` remembers which account this was so the card can still name it. Reconnecting afterwards is a plain new `/connect` — it mints a fresh hand-off. A tenant must always be able to walk away from a connection it made.
+         *
+         *     A row with nothing at the provider to revoke — `pending` / `pending_selection` with no connection — is cancelled LOCALLY: no provider call, the row moves straight to `disconnected`, and the pending hand-off simply expires on its own (the provider has no endpoint to cancel one early). A row already `disconnected` answers 200 unchanged (idempotent).
+         *
+         *     409 `sync_in_flight` when the provider is mid-sync on the connection — the row is left exactly as it was; the whole recovery is trying again in a few minutes. 502 `disconnect_refused` when the provider’s own 403 says the delegated key is no longer good for this connection — also left unchanged. A 404 from the provider (the connection is already gone there) is treated as success: the state this call exists to ensure already holds.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The disconnected integration */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "id": "22222222-2222-4222-8222-222222222222",
+                         *         "provider": "meta_ads",
+                         *         "status": "disconnected",
+                         *         "account_label": "Cuenta Meta Ads",
+                         *         "connected_at": "2026-09-20T12:00:00.000Z",
+                         *         "disconnected_at": "2026-09-23T15:10:00.000Z",
+                         *         "account": null,
+                         *         "error": null,
+                         *         "handoff": null,
+                         *         "candidates": null,
+                         *         "updated_at": "2026-09-23T15:10:00.000Z"
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["MetaAdsIntegration"] & Record<string, never>;
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/integrations/meta-ads/finalize": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Finalize a Meta Ads pending selection with a chosen candidate
+         * @description Only meaningful while `status` is `pending_selection`. Calls the provider’s finalize on the parked provider token with the chosen `candidate_id` — a `MetaAdsCandidate.candidate_id` from the SAME row’s `candidates`, sent back verbatim — reads the resulting connection back (the provider’s Meta Ads connections read) and runs it through the same settle path `/return` uses, so the row reads identically whichever produced it: `connected`, with `account` populated.
+         *
+         *     **Retrying the same `candidate_id` is safe** and answers 200 with the current row — the provider’s `already_finalized: true` on its own idempotent replay, reapplied through the same write path a fresh finalize uses.
+         *
+         *     **A DIFFERENT `candidate_id`** after the provider’s parked token already finalized a choice is 409 `start_again` (the row moves to `error`, `reason: selection_conflict`, retryable) — switching accounts needs a fresh connect, there is no token left to retarget.
+         *
+         *     **The picker’s 60-minute parked token already gone** (elapsed, or never existed for this profile) is 410 `reconnect` (the row moves to `error`, `reason: selection_expired`, retryable).
+         *
+         *     **The row is not `pending_selection`** — nothing started, already connected, or already in `error` — is 409 `handoff_mismatch`, checked before the provider is ever called.
+         *
+         *     502 `UPSTREAM_ERROR` when the provider could not be read; the row is left unchanged and the call is safe to repeat.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    /**
+                     * @example {
+                     *       "candidate_id": "cnd_7b1f0a4e9d2c"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["MetaAdsFinalizeBody"];
+                };
+            };
+            responses: {
+                /** @description The finalized integration, now `connected` */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "id": "22222222-2222-4222-8222-222222222222",
+                         *         "provider": "meta_ads",
+                         *         "status": "connected",
+                         *         "account_label": "Cuenta Meta Ads",
+                         *         "connected_at": "2026-09-23T15:04:00.000Z",
+                         *         "disconnected_at": null,
+                         *         "account": {
+                         *           "external_account_id": "act_1234567890",
+                         *           "name": "Automotora Ejemplo",
+                         *           "currency": "CLP",
+                         *           "timezone": "America/Santiago",
+                         *           "delivers_spend": true,
+                         *           "provider_connection_id": "c0c0c0c0-0000-4000-8000-000000000001",
+                         *           "atribu_connection_id": "c0c0c0c0-0000-4000-8000-000000000001"
+                         *         },
+                         *         "error": null,
+                         *         "handoff": null,
+                         *         "candidates": null,
+                         *         "updated_at": "2026-09-23T15:04:00.000Z"
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["MetaAdsIntegration"] & Record<string, never>;
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The picker’s parked provider token is gone — `{ error: { code: "reconnect" } }` */
+                410: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/insights/generate-pdf": {
+    "/integrations/meta-ads/ads": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Render a report as a PDF
-         * @description **The one endpoint on the tenant API that does not answer the `{ data }` envelope.** It replies with raw `application/pdf` bytes and a `Content-Disposition: attachment` header, so a client that pipes every response through the usual JSON parse will fail here. On an error it reverts to the JSON error envelope, which means the response content-type is what tells the two apart.
+         * The tenant's click-to-WhatsApp ads, with connect/greeting checks
+         * @description Reads the partner click-to-WhatsApp ads list with the tenant’s WhatsApp **partner** token — a different credential than the connect rail above’s delegated key — and derives two facts per ad: `checks.destination_connected` (the ad’s WhatsApp number, compared as E.164, is one of the tenant’s connected WhatsApp messaging accounts) and `checks.greeting_configured` (a "Saludo automático" — text or tappable ice breakers — is actually set).
          *
-         *     Generation is SYNCHRONOUS: it queries the report, runs an LLM pass to write the narrative, then renders. The connection is held for all of that, there is no job id, and nothing is persisted — a client or proxy timeout loses the document with no way to retrieve it other than asking again. Treat a wide range as a slow request.
+         *     Requires `integrations:read` or `ads:read` (owner, admin and the Marketing role — not "any member"), free for every tenant (no Add-on gate).
          *
-         *     The LLM pass degrades rather than fails: if the narrative cannot be generated you still get a 200 and a complete PDF, with a Spanish note in place of the executive summary and every raw figure intact. So a successful response does not by itself mean the analysis is there.
+         *     `data.state` is `not_connected` in TWO cases, told apart by an optional `reason`:
+         *     * no `reason` — the tenant has never connected a Meta Ads account (the integration row is missing or not `connected`).
+         *     * `reason: "whatsapp_not_connected"` — Meta Ads may be connected, but the tenant holds no `whatsapp_cloud` account carrying an partner token, so there is no scope to list ads under.
          *
-         *     `range.preset` is not a range selector — `from`/`to` alone decide the data. It is the window’s NAME: printed as the cover subtitle and passed into the summariser’s prompt, so a preset that disagrees with `from`/`to` mislabels the cover and misleads the narrative while the figures stay correct. Defaults to `custom`. Needs only `analytics:read`.
+         *     `cursor` is the provider’s own opaque keyset cursor (its `pagination.cursor`, a Meta ad id ascending), passed straight through as `after`. `next_cursor` is `null` once the provider reports `has_next: false`. `last_synced_at` is the max over the returned PAGE only, not a tenant-wide sync timestamp.
+         *
+         *     502 `UPSTREAM_ERROR` on a provider 5xx, timeout, or a response shape this route does not recognise. 502 `partner_token_invalid` when the provider answers 401 on the WhatsApp partner token — that token is never auto-rotated; the dealer must reconnect WhatsApp.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
-                header?: {
-                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
-                    "Idempotency-Key"?: string;
+                query?: {
+                    cursor?: string;
+                    limit?: number;
                 };
+                header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    /**
-                     * @example {
-                     *       "report": "conversations",
-                     *       "window": {
-                     *         "preset": "7d"
-                     *       },
-                     *       "range": {
-                     *         "preset": "7d"
-                     *       }
-                     *     }
-                     */
-                    "application/json": {
-                        /** @enum {string} */
-                        report_type: "overview" | "conversations" | "agents" | "ai_agents" | "bots" | "tags" | "channels" | "teams" | "leads" | "csat" | "sla" | "clinic_ocupacion" | "clinic_inasistencias" | "clinic_produccion" | "clinic_packs";
-                        range: {
-                            from: string;
-                            to: string;
-                            preset?: string;
-                        };
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description The rendered PDF as an attachment */
+                /** @description A `not_connected` state (with or without a `reason`), or the connected page of ads */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/pdf": string;
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "state": "connected",
+                         *         "items": [
+                         *           {
+                         *             "ad_id": "1234567890123",
+                         *             "ad_name": "Test drive fin de semana",
+                         *             "ad_status": "ACTIVE",
+                         *             "campaign": {
+                         *               "id": "6543210987654",
+                         *               "name": "Leads · WhatsApp"
+                         *             },
+                         *             "ad_set": {
+                         *               "id": "6543210987655",
+                         *               "name": "Región Metropolitana"
+                         *             },
+                         *             "destination": {
+                         *               "type": "whatsapp",
+                         *               "whatsapp_phone_number": "+56912345678",
+                         *               "page_id": "998877665544"
+                         *             },
+                         *             "cta_type": "WHATSAPP_MESSAGE",
+                         *             "greeting": {
+                         *               "text": "¡Hola! Cuéntanos qué auto buscas.",
+                         *               "autofill_message": "Quiero agendar un test drive",
+                         *               "ice_breakers": [
+                         *                 "Ver stock disponible",
+                         *                 "Agendar test drive"
+                         *               ],
+                         *               "landing_screen_type": "welcome_message"
+                         *             },
+                         *             "greeting_status": "present",
+                         *             "checks": {
+                         *               "destination_connected": true,
+                         *               "greeting_configured": true
+                         *             },
+                         *             "last_synced_at": "2026-09-23T14:00:00.000Z"
+                         *           }
+                         *         ],
+                         *         "next_cursor": null,
+                         *         "last_synced_at": "2026-09-23T14:00:00.000Z"
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["MetaAdsAdsResponse"];
+                        };
                     };
                 };
                 /** @description Validation error */
@@ -92751,13 +94097,15 @@ interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/insights/schedules": {
+    "/integrations/connections": {
         parameters: {
             query?: never;
             header?: never;
@@ -92765,8 +94113,10 @@ interface paths {
             cookie?: never;
         };
         /**
-         * List report schedules
-         * @description The standing subscriptions that mail a rendered report out on a cadence. Unpaginated, and with no `meta.total` — this list is small by construction.
+         * List the workspace’s provider connections (CRM, payments)
+         * @description One card per connectable provider — GoHighLevel, Mercado Pago — ALWAYS every provider, never-connected ones included (`state: "not_connected"`), so an integrations screen renders from this one read. Each card is exactly what `GET /integrations/connections/{provider}` returns.
+         *
+         *     Requires `integrations:read` (owner and admin).
          */
         get: {
             parameters: {
@@ -92777,7 +94127,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Report schedules */
+                /** @description Every provider connection card */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -92787,24 +94137,72 @@ interface paths {
                          * @example {
                          *       "data": [
                          *         {
-                         *           "id": "cccccccc-2000-4000-8000-000000000001",
-                         *           "report_type": "conversations",
-                         *           "range_preset": "7d",
-                         *           "cadence": "weekly",
-                         *           "recipients": [
-                         *             "gerencia@midealer.cl"
-                         *           ],
-                         *           "next_run_at": "2026-09-29T09:00:00.000Z",
-                         *           "enabled": true
+                         *           "provider": "gohighlevel",
+                         *           "display_name": "GoHighLevel",
+                         *           "category": "crm",
+                         *           "description": "Trae los formularios y las oportunidades de tu CRM para seguir cada lead hasta la venta.",
+                         *           "last_account": null,
+                         *           "last_attempt": null,
+                         *           "disconnected_at": null,
+                         *           "addon_active": true,
+                         *           "state": "connecting",
+                         *           "state_label": "Elige la subcuenta",
+                         *           "account": null,
+                         *           "reason": null,
+                         *           "next_step": {
+                         *             "action": "choose_account",
+                         *             "label": "Elegir subcuenta"
+                         *           },
+                         *           "attempt": {
+                         *             "step": "choose_account",
+                         *             "handoff": {
+                         *               "id": "0f2f6b0a-9a2c-4f4e-9a1e-6f7f2a5c3b21",
+                         *               "expires_at": "2026-09-27T15:45:00.000Z"
+                         *             },
+                         *             "candidates": [
+                         *               {
+                         *                 "external_id": "loc_8XkP2qR5tV",
+                         *                 "name": "Agencia Ejemplo — Ventas"
+                         *               },
+                         *               {
+                         *                 "external_id": "loc_3MnB7wQ1yZ",
+                         *                 "name": "Agencia Ejemplo — Soporte"
+                         *               }
+                         *             ],
+                         *             "selection_expires_at": "2026-09-27T16:00:00.000Z",
+                         *             "prompt": "Elige la subcuenta de GoHighLevel que quieres conectar."
+                         *           },
+                         *           "connected_at": null,
+                         *           "last_synced_at": null,
+                         *           "updated_at": "2026-09-27T15:02:00.000Z"
+                         *         },
+                         *         {
+                         *           "provider": "mercadopago",
+                         *           "display_name": "Mercado Pago",
+                         *           "category": "payments",
+                         *           "description": "Registra los pagos que recibes para saber cuántas ventas trae cada campaña.",
+                         *           "state": "not_connected",
+                         *           "state_label": "Sin conectar",
+                         *           "account": null,
+                         *           "last_account": null,
+                         *           "reason": null,
+                         *           "last_attempt": null,
+                         *           "next_step": {
+                         *             "action": "connect",
+                         *             "label": "Conectar"
+                         *           },
+                         *           "attempt": null,
+                         *           "connected_at": null,
+                         *           "disconnected_at": null,
+                         *           "last_synced_at": null,
+                         *           "updated_at": null,
+                         *           "addon_active": true
                          *         }
                          *       ]
                          *     }
                          */
                         "application/json": {
-                            data?: unknown;
-                            meta?: {
-                                [key: string]: unknown;
-                            };
+                            data: components["schemas"]["ProviderConnection"][];
                         };
                     };
                 };
@@ -92872,7 +94270,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/integrations/meta-ads": {
+    "/integrations/connections/{provider}": {
         parameters: {
             query?: never;
             header?: never;
@@ -92880,23 +94278,27 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Read the workspace’s Meta Ads connection
-         * @description The tenant’s single Meta Ads row, or `null` when it has never started a connect. A placeholder object with `status: "disconnected"` is deliberately NOT returned in its place: "never connected" and "was connected and is not any more" are different states and the card says different things about them.
+         * Read one provider connection card
+         * @description Everything the card renders, in one read: the state and its label, the connected account, the reason with a ready-to-render sentence, how the latest re-authorization ended (`last_attempt`), the next step with its button label, when it connected / stopped / last synced, and — only while a connect is in flight — the attempt. Never null: a workspace that never connected gets `state: "not_connected"`.
          *
-         *     `handoff` is populated only while `status` is `pending` and `candidates` only while it is `pending_selection` — a spent consent URL would render a button leading to a dead page.
+         *     A connection whose last sync failed stays `connected` with `reason.code: "sync_error"` (label «Problema de sincronización») and a `reconnect` next step; only a grant the provider no longer honours is `needs_reconnect`.
          *
-         *     Requires `integrations:read` or `ads:read` (owner, admin and the Marketing role); a `supervisor` or `agent` gets 403 here and never sees the card. The writes need `integrations:write` or `ads:write`.
+         *     While an account picker is open the candidates are re-read from the provider when older than five minutes; every other state is a database read only.
+         *
+         *     Requires `integrations:read` (owner and admin).
          */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    provider: "gohighlevel" | "mercadopago";
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description The Meta Ads integration, or `null` */
+                /** @description The provider connection card */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -92904,11 +94306,35 @@ interface paths {
                     content: {
                         /**
                          * @example {
-                         *       "data": null
+                         *       "data": {
+                         *         "provider": "gohighlevel",
+                         *         "display_name": "GoHighLevel",
+                         *         "category": "crm",
+                         *         "description": "Trae los formularios y las oportunidades de tu CRM para seguir cada lead hasta la venta.",
+                         *         "last_account": null,
+                         *         "last_attempt": null,
+                         *         "disconnected_at": null,
+                         *         "addon_active": true,
+                         *         "state": "connected",
+                         *         "state_label": "Conectado",
+                         *         "account": {
+                         *           "external_id": "loc_8XkP2qR5tV",
+                         *           "name": "Agencia Ejemplo"
+                         *         },
+                         *         "reason": null,
+                         *         "next_step": {
+                         *           "action": "none",
+                         *           "label": null
+                         *         },
+                         *         "attempt": null,
+                         *         "connected_at": "2026-09-27T15:04:00.000Z",
+                         *         "last_synced_at": "2026-09-27T15:20:00.000Z",
+                         *         "updated_at": "2026-09-27T15:20:00.000Z"
+                         *       }
                          *     }
                          */
                         "application/json": {
-                            data: components["schemas"]["MetaAdsIntegration"];
+                            data: components["schemas"]["ProviderConnection"];
                         };
                     };
                 };
@@ -92930,6 +94356,31 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description The Vitrina Ads add-on is not active and nothing is connected (or in flight) for this provider. `error.code` is `ENTITLEMENT_NOT_ACTIVE`, `error.details.feature` is `vitrina_ads`. A connection that outlived the add-on is never refused here: it stays readable, finishable and disconnectable. */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "ENTITLEMENT_NOT_ACTIVE",
+                         *         "message": "El complemento Vitrina Ads no está activo en este espacio de trabajo.",
+                         *         "details": {
+                         *           "required": [
+                         *             "vitrina_ads"
+                         *           ],
+                         *           "active": [],
+                         *           "feature": "vitrina_ads",
+                         *           "entitlement_state": "off"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Forbidden */
                 403: {
                     headers: {
@@ -92976,7 +94427,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/integrations/meta-ads/connect": {
+    "/integrations/connections/{provider}/connect": {
         parameters: {
             query?: never;
             header?: never;
@@ -92986,14 +94437,14 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Start a Meta Ads connect and get the consent URL
-         * @description Mints the connection provider’s **connect hand-off** for `meta_ads` and answers the session-less consent URL to redirect the WHOLE PAGE to. It is not an iframe target: Meta’s own consent dialog renders inside it.
+         * Start (or resume) a provider connect
+         * @description Starts the provider’s consent and answers the URL to send the WHOLE page to — straight to the provider’s own consent screen, which names this app. Every ending (connected, several accounts to choose from, cancelled, refused, expired) comes back to `return_to` with `connection_return=<provider>`, `connection_state`, and the provider’s `status`, `reason` and `handoff_id`; pass all of them to `POST …/return`, then strip them from the address bar.
          *
-         *     `return_to` must be an absolute URL on the app’s own origin. The backend appends `meta_ads=return` and a short opaque `state`, preserving any query the URL already carried, and passes the result to the provider as `return_url`. An origin that is not the app’s is a 400 here rather than a silent substitution — the provider itself only checks the origin when the human CLICKS, where it surfaces as a failed hand-off (`result.reason: origin_not_allowed`) after the dealer has already walked through a consent screen for nothing.
+         *     `return_to` must be an absolute URL on the app’s own origin (400 otherwise).
          *
-         *     **A second click reuses the live hand-off.** The provider’s URL is single-use and 45-minute-lived, and minting twice yields two hand-offs rather than an error, so a dealer who clicks, gets distracted and clicks again gets the SAME `url` and `handoff_id` back until it expires.
+         *     **Idempotent.** A second click while a consent is live for the same `return_to` answers the SAME `url` and `handoff_id`. It works from every state: a first connect, a retry, a reconnect (`needs_reconnect`), a re-authorization of a connected account. Only a first connect moves the card to `connecting`; a reconnect keeps its state until the new consent lands.
          *
-         *     Before anything is minted, the tenant’s attribution profile and its delegated key are ensured (ADR 0099). This rail never uses a platform-wide provider key.
+         *     Requires `integrations:write` (owner and admin).
          */
         post: {
             parameters: {
@@ -93002,21 +94453,23 @@ interface paths {
                     /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
                     "Idempotency-Key"?: string;
                 };
-                path?: never;
+                path: {
+                    provider: "gohighlevel" | "mercadopago";
+                };
                 cookie?: never;
             };
             requestBody?: {
                 content: {
                     /**
                      * @example {
-                     *       "return_to": "https://app.vitrinadev.com/settings/integraciones?meta_ads=return"
+                     *       "return_to": "https://app.vitrinadev.com/w/agencia/settings/integraciones"
                      *     }
                      */
-                    "application/json": components["schemas"]["MetaAdsConnectBody"];
+                    "application/json": components["schemas"]["ProviderConnectBody"];
                 };
             };
             responses: {
-                /** @description The consent URL, its hand-off id, and its expiry */
+                /** @description The consent URL, its hand-off id and expiry, and the card */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93025,14 +94478,45 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "url": "https://consent.example.com/connect/meta-ads/ho_4d8f2a91c6b3",
-                         *         "handoff_id": "ho_4d8f2a91c6b3",
-                         *         "expires_at": "2026-09-23T15:45:00.000Z"
+                         *         "url": "https://connect.example.com/gohighlevel/start?h=4d8f2a91c6b3",
+                         *         "handoff_id": "0f2f6b0a-9a2c-4f4e-9a1e-6f7f2a5c3b21",
+                         *         "expires_at": "2026-09-27T15:45:00.000Z",
+                         *         "connection": {
+                         *           "provider": "gohighlevel",
+                         *           "display_name": "GoHighLevel",
+                         *           "category": "crm",
+                         *           "description": "Trae los formularios y las oportunidades de tu CRM para seguir cada lead hasta la venta.",
+                         *           "last_account": null,
+                         *           "last_attempt": null,
+                         *           "disconnected_at": null,
+                         *           "addon_active": true,
+                         *           "state": "connecting",
+                         *           "state_label": "Conectando",
+                         *           "account": null,
+                         *           "reason": null,
+                         *           "next_step": {
+                         *             "action": "resume",
+                         *             "label": "Continuar en GoHighLevel"
+                         *           },
+                         *           "attempt": {
+                         *             "step": "consent",
+                         *             "handoff": {
+                         *               "id": "0f2f6b0a-9a2c-4f4e-9a1e-6f7f2a5c3b21",
+                         *               "expires_at": "2026-09-27T15:45:00.000Z"
+                         *             },
+                         *             "candidates": null,
+                         *             "selection_expires_at": null,
+                         *             "prompt": "Termina la autorización en GoHighLevel para conectar."
+                         *           },
+                         *           "connected_at": null,
+                         *           "last_synced_at": null,
+                         *           "updated_at": "2026-09-27T15:00:00.000Z"
+                         *         }
                          *       }
                          *     }
                          */
                         "application/json": {
-                            data: components["schemas"]["MetaAdsConnectResult"];
+                            data: components["schemas"]["ProviderConnectResult"];
                         };
                     };
                 };
@@ -93054,6 +94538,31 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description The Vitrina Ads add-on is not active and nothing is connected (or in flight) for this provider. `error.code` is `ENTITLEMENT_NOT_ACTIVE`, `error.details.feature` is `vitrina_ads`. A connection that outlived the add-on is never refused here: it stays readable, finishable and disconnectable. */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "ENTITLEMENT_NOT_ACTIVE",
+                         *         "message": "El complemento Vitrina Ads no está activo en este espacio de trabajo.",
+                         *         "details": {
+                         *           "required": [
+                         *             "vitrina_ads"
+                         *           ],
+                         *           "active": [],
+                         *           "feature": "vitrina_ads",
+                         *           "entitlement_state": "off"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Forbidden */
                 403: {
                     headers: {
@@ -93098,7 +94607,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/integrations/meta-ads/return": {
+    "/integrations/connections/{provider}/return": {
         parameters: {
             query?: never;
             header?: never;
@@ -93108,19 +94617,19 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Settle a Meta Ads connect after the dealer comes back
-         * @description Reads the hand-off ONCE and settles the row:
+         * Settle a provider connect after the admin comes back
+         * @description Settles the connect on the provider’s own record of the consent — the `status` and `reason` from the return URL are hints only (a URL can be typed):
          *
-         *     * `completed` with a connection id → the connection is read back from the provider and the row becomes `connected`, carrying the ad account’s name, id, currency, timezone and whether the platform has ever delivered spend.
-         *     * `completed` with a pending selection → the row becomes `pending_selection` and carries the candidates the picker renders. **A consent that resolved to exactly one account never reaches this branch** — the provider finalizes it in its own callback, which is why there is no auto-finalize step on this side.
-         *     * `expired` / `cancelled` / `failed` → the row becomes `error` with a retryable `reason` of `handoff_<status>`. The recovery is identical for all three: mint a fresh hand-off.
-         *     * still `pending` → nothing is settled and the row comes back unchanged.
+         *     * connected → `state: "connected"` with the account read back from the provider;
+         *     * several accounts (GoHighLevel) → `attempt.step: "choose_account"` with `attempt.candidates`;
+         *     * cancelled / refused / expired → the attempt ends with a SPECIFIC `reason` (`user_cancelled`, `account_connected_elsewhere`, `no_candidates`, `provider_denied`, …), never folded into one generic failure. On a card that was already connected the state is unchanged and the outcome is `last_attempt`;
+         *     * not finished yet → the card comes back unchanged. If the return URL says the attempt failed with the retryable `internal_error`, the reason is recorded and the SAME consent link stays live for a retry; any other failure ends the attempt.
          *
-         *     **Neither field is required.** The hand-off id only exists in the RESPONSE to the mint while `return_url` is an argument to that same mint, so the return URL structurally cannot carry it — it carries `meta_ads=return` and the opaque `state` instead. Send `handoff_id` if you kept it, `state` if you read it off the URL, or an empty body, in which case the backend settles the row’s own pending hand-off (unambiguous: a tenant has at most one).
+         *     Every field is optional: a stripped query string still settles the workspace’s own pending consent (there is at most one). **Idempotent:** re-posting for a consent already settled answers the card as it stands. A consent finished in an OLDER tab after a newer connect answers the connected card.
          *
-         *     Safe to repeat — a settled hand-off stays readable at the provider, so a re-post on a refresh re-derives the same state.
+         *     409 `handoff_mismatch` when the `handoff_id`/`state` presented is neither this card’s consent nor its last one and nothing is connected. 502 when the provider could not be reached — nothing is settled; retry.
          *
-         *     409 `handoff_mismatch` when the id or state presented does not name the hand-off this tenant’s row is waiting on, and for a tenant with no connect in flight at all (the two are deliberately the same answer).
+         *     Requires `integrations:write`.
          */
         post: {
             parameters: {
@@ -93129,21 +94638,25 @@ interface paths {
                     /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
                     "Idempotency-Key"?: string;
                 };
-                path?: never;
+                path: {
+                    provider: "gohighlevel" | "mercadopago";
+                };
                 cookie?: never;
             };
             requestBody?: {
                 content: {
                     /**
                      * @example {
-                     *       "state": "9f3a2d7c8b1e4a2f"
+                     *       "handoff_id": "0f2f6b0a-9a2c-4f4e-9a1e-6f7f2a5c3b21",
+                     *       "state": "9f3a2d7c8b1e4a2f",
+                     *       "status": "success"
                      *     }
                      */
-                    "application/json": components["schemas"]["MetaAdsReturnBody"];
+                    "application/json": components["schemas"]["ProviderReturnBody"];
                 };
             };
             responses: {
-                /** @description The settled integration */
+                /** @description The settled card */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93152,30 +94665,34 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "id": "22222222-2222-4222-8222-222222222222",
-                         *         "provider": "meta_ads",
-                         *         "status": "connected",
-                         *         "account_label": "Cuenta Meta Ads",
-                         *         "connected_at": "2026-09-23T15:04:00.000Z",
+                         *         "provider": "gohighlevel",
+                         *         "display_name": "GoHighLevel",
+                         *         "category": "crm",
+                         *         "description": "Trae los formularios y las oportunidades de tu CRM para seguir cada lead hasta la venta.",
+                         *         "last_account": null,
+                         *         "last_attempt": null,
                          *         "disconnected_at": null,
+                         *         "addon_active": true,
+                         *         "state": "connected",
+                         *         "state_label": "Conectado",
                          *         "account": {
-                         *           "external_account_id": "act_1234567890",
-                         *           "name": "Automotora Ejemplo",
-                         *           "currency": "CLP",
-                         *           "timezone": "America/Santiago",
-                         *           "delivers_spend": true,
-                         *           "provider_connection_id": "c0c0c0c0-0000-4000-8000-000000000001",
-                         *           "atribu_connection_id": "c0c0c0c0-0000-4000-8000-000000000001"
+                         *           "external_id": "loc_8XkP2qR5tV",
+                         *           "name": "Agencia Ejemplo"
                          *         },
-                         *         "error": null,
-                         *         "handoff": null,
-                         *         "candidates": null,
-                         *         "updated_at": "2026-09-23T15:04:00.000Z"
+                         *         "reason": null,
+                         *         "next_step": {
+                         *           "action": "none",
+                         *           "label": null
+                         *         },
+                         *         "attempt": null,
+                         *         "connected_at": "2026-09-27T15:04:00.000Z",
+                         *         "last_synced_at": "2026-09-27T15:20:00.000Z",
+                         *         "updated_at": "2026-09-27T15:20:00.000Z"
                          *       }
                          *     }
                          */
                         "application/json": {
-                            data: components["schemas"]["MetaAdsIntegration"] & Record<string, never>;
+                            data: components["schemas"]["ProviderConnection"];
                         };
                     };
                 };
@@ -93197,6 +94714,31 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description The Vitrina Ads add-on is not active and nothing is connected (or in flight) for this provider. `error.code` is `ENTITLEMENT_NOT_ACTIVE`, `error.details.feature` is `vitrina_ads`. A connection that outlived the add-on is never refused here: it stays readable, finishable and disconnectable. */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "ENTITLEMENT_NOT_ACTIVE",
+                         *         "message": "El complemento Vitrina Ads no está activo en este espacio de trabajo.",
+                         *         "details": {
+                         *           "required": [
+                         *             "vitrina_ads"
+                         *           ],
+                         *           "active": [],
+                         *           "feature": "vitrina_ads",
+                         *           "entitlement_state": "off"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Forbidden */
                 403: {
                     headers: {
@@ -93215,131 +94757,20 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                /** @description `handoff_mismatch` — a stale tab finishing another consent. */
                 409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Rate limited */
-                429: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/integrations/meta-ads/disconnect": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Disconnect the workspace’s Meta Ads ad account
-         * @description Calls the provider’s disconnect for the connection on the delegated key and settles the row `disconnected`, keeping its history: `account_label` and `connected_at` stay, and `config.last_account` remembers which account this was so the card can still name it. Reconnecting afterwards is a plain new `/connect` — it mints a fresh hand-off. A tenant must always be able to walk away from a connection it made.
-         *
-         *     A row with nothing at the provider to revoke — `pending` / `pending_selection` with no connection — is cancelled LOCALLY: no provider call, the row moves straight to `disconnected`, and the pending hand-off simply expires on its own (the provider has no endpoint to cancel one early). A row already `disconnected` answers 200 unchanged (idempotent).
-         *
-         *     409 `sync_in_flight` when the provider is mid-sync on the connection — the row is left exactly as it was; the whole recovery is trying again in a few minutes. 502 `atribu_refused` when the provider’s own 403 says the delegated key is no longer good for this connection — also left unchanged. A 404 from the provider (the connection is already gone there) is treated as success: the state this call exists to ensure already holds.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: {
-                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
-                    "Idempotency-Key"?: string;
-                };
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description The disconnected integration */
-                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         /**
                          * @example {
-                         *       "data": {
-                         *         "id": "22222222-2222-4222-8222-222222222222",
-                         *         "provider": "meta_ads",
-                         *         "status": "disconnected",
-                         *         "account_label": "Cuenta Meta Ads",
-                         *         "connected_at": "2026-09-20T12:00:00.000Z",
-                         *         "disconnected_at": "2026-09-23T15:10:00.000Z",
-                         *         "account": null,
-                         *         "error": null,
-                         *         "handoff": null,
-                         *         "candidates": null,
-                         *         "updated_at": "2026-09-23T15:10:00.000Z"
+                         *       "error": {
+                         *         "code": "handoff_mismatch",
+                         *         "message": "Esta conexión ya no está esperando ese enlace. Actualiza la página y vuelve a conectar."
                          *       }
                          *     }
                          */
-                        "application/json": {
-                            data: components["schemas"]["MetaAdsIntegration"] & Record<string, never>;
-                        };
-                    };
-                };
-                /** @description Validation error */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
@@ -93360,7 +94791,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/integrations/meta-ads/finalize": {
+    "/integrations/connections/{provider}/finalize": {
         parameters: {
             query?: never;
             header?: never;
@@ -93370,16 +94801,17 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Finalize a Meta Ads pending selection with a chosen candidate
-         * @description Only meaningful while `status` is `pending_selection`. Calls the provider’s finalize on the parked provider token with the chosen `candidate_id` — a `MetaAdsCandidate.candidate_id` from the SAME row’s `candidates`, sent back verbatim — reads the resulting connection back (the provider’s Meta Ads connections read) and runs it through the same settle path `/return` uses, so the row reads identically whichever produced it: `connected`, with `account` populated.
+         * Choose the account to connect from an open picker
+         * @description Completes an open account picker (`attempt.step: "choose_account"`) with one `attempt.candidates[].external_id`. Served only for providers whose consent can end in a choice (GoHighLevel sub-accounts); any other provider is 404. **Idempotent:** the same account again on a card it already connected answers the card.
          *
-         *     **Retrying the same `candidate_id` is safe** and answers 200 with the current row — the provider’s `already_finalized: true` on its own idempotent replay, reapplied through the same write path a fresh finalize uses.
-         *
-         *     **A DIFFERENT `candidate_id`** after the provider’s parked token already finalized a choice is 409 `start_again` (the row moves to `error`, `reason: selection_conflict`, retryable) — switching accounts needs a fresh connect, there is no token left to retarget.
-         *
-         *     **The picker’s 60-minute parked token already gone** (elapsed, or never existed for this profile) is 410 `reconnect` (the row moves to `error`, `reason: selection_expired`, retryable).
+         *     * 409 `handoff_mismatch` — `handoff_id` was sent and is not the consent this card is waiting on (a stale tab); refresh the card;
+         *     * 409 `not_selecting` — no choice is owed (refresh the card);
+         *     * 409 `account_connected_elsewhere` — that account lives on another Vitrina workspace; the picker STAYS open, choose another;
+         *     * 409 `selection_conflict` — another account was already chosen on this consent; connect again to change it;
+         *     * 410 `selection_expired` — the picker’s 60-minute window ended; connect again;
+         *     * 422 `candidate_unavailable` — the account is no longer reachable; the next card read refreshes the list.
          *
-         *     **The row is not `pending_selection`** — nothing started, already connected, or already in `error` — is 409 `handoff_mismatch`, checked before the provider is ever called.
+         *     Requires `integrations:write`.
          */
         post: {
             parameters: {
@@ -93388,21 +94820,24 @@ interface paths {
                     /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
                     "Idempotency-Key"?: string;
                 };
-                path?: never;
+                path: {
+                    provider: "gohighlevel";
+                };
                 cookie?: never;
             };
             requestBody?: {
                 content: {
                     /**
                      * @example {
-                     *       "candidate_id": "cnd_7b1f0a4e9d2c"
+                     *       "external_id": "loc_8XkP2qR5tV",
+                     *       "handoff_id": "0f2f6b0a-9a2c-4f4e-9a1e-6f7f2a5c3b21"
                      *     }
                      */
-                    "application/json": components["schemas"]["MetaAdsFinalizeBody"];
+                    "application/json": components["schemas"]["ProviderFinalizeBody"];
                 };
             };
             responses: {
-                /** @description The finalized integration, now `connected` */
+                /** @description The connected card */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93411,30 +94846,34 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "id": "22222222-2222-4222-8222-222222222222",
-                         *         "provider": "meta_ads",
-                         *         "status": "connected",
-                         *         "account_label": "Cuenta Meta Ads",
-                         *         "connected_at": "2026-09-23T15:04:00.000Z",
+                         *         "provider": "gohighlevel",
+                         *         "display_name": "GoHighLevel",
+                         *         "category": "crm",
+                         *         "description": "Trae los formularios y las oportunidades de tu CRM para seguir cada lead hasta la venta.",
+                         *         "last_account": null,
+                         *         "last_attempt": null,
                          *         "disconnected_at": null,
+                         *         "addon_active": true,
+                         *         "state": "connected",
+                         *         "state_label": "Conectado",
                          *         "account": {
-                         *           "external_account_id": "act_1234567890",
-                         *           "name": "Automotora Ejemplo",
-                         *           "currency": "CLP",
-                         *           "timezone": "America/Santiago",
-                         *           "delivers_spend": true,
-                         *           "provider_connection_id": "c0c0c0c0-0000-4000-8000-000000000001",
-                         *           "atribu_connection_id": "c0c0c0c0-0000-4000-8000-000000000001"
+                         *           "external_id": "loc_8XkP2qR5tV",
+                         *           "name": "Agencia Ejemplo"
                          *         },
-                         *         "error": null,
-                         *         "handoff": null,
-                         *         "candidates": null,
-                         *         "updated_at": "2026-09-23T15:04:00.000Z"
+                         *         "reason": null,
+                         *         "next_step": {
+                         *           "action": "none",
+                         *           "label": null
+                         *         },
+                         *         "attempt": null,
+                         *         "connected_at": "2026-09-27T15:04:00.000Z",
+                         *         "last_synced_at": "2026-09-27T15:20:00.000Z",
+                         *         "updated_at": "2026-09-27T15:20:00.000Z"
                          *       }
                          *     }
                          */
                         "application/json": {
-                            data: components["schemas"]["MetaAdsIntegration"] & Record<string, never>;
+                            data: components["schemas"]["ProviderConnection"];
                         };
                     };
                 };
@@ -93456,6 +94895,31 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description The Vitrina Ads add-on is not active and nothing is connected (or in flight) for this provider. `error.code` is `ENTITLEMENT_NOT_ACTIVE`, `error.details.feature` is `vitrina_ads`. A connection that outlived the add-on is never refused here: it stays readable, finishable and disconnectable. */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "ENTITLEMENT_NOT_ACTIVE",
+                         *         "message": "El complemento Vitrina Ads no está activo en este espacio de trabajo.",
+                         *         "details": {
+                         *           "required": [
+                         *             "vitrina_ads"
+                         *           ],
+                         *           "active": [],
+                         *           "feature": "vitrina_ads",
+                         *           "entitlement_state": "off"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Forbidden */
                 403: {
                     headers: {
@@ -93474,21 +94938,54 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                /** @description `handoff_mismatch` (a stale tab), `not_selecting` (no choice owed), `account_connected_elsewhere` (the picker stays open) or `selection_conflict` (connect again). */
                 409: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "not_selecting",
+                         *         "message": "Esta conexión no está esperando que elijas una subcuenta. Actualiza la página."
+                         *       }
+                         *     }
+                         */
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description The picker’s parked provider token is gone — `{ error: { code: "reconnect" } }` */
+                /** @description `selection_expired` — the picker’s 60-minute window ended; connect again. */
                 410: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "selection_expired",
+                         *         "message": "Pasó demasiado tiempo para elegir la subcuenta. Vuelve a conectar GoHighLevel."
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description `candidate_unavailable` — the account is no longer reachable; the next card read refreshes the list. */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "candidate_unavailable",
+                         *         "message": "Esa subcuenta ya no está disponible. Elige otra de la lista."
+                         *       }
+                         *     }
+                         */
                         "application/json": components["schemas"]["Error"];
                     };
                 };
@@ -93509,40 +95006,38 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/integrations/meta-ads/ads": {
+    "/integrations/connections/{provider}/disconnect": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * The tenant's click-to-WhatsApp ads, with connect/greeting checks
-         * @description Reads the partner click-to-WhatsApp ads list with the tenant’s WhatsApp **partner** token — a different credential than the connect rail above’s delegated key — and derives two facts per ad: `checks.destination_connected` (the ad’s WhatsApp number, compared as E.164, is one of the tenant’s connected WhatsApp messaging accounts) and `checks.greeting_configured` (a "Saludo automático" — text or tappable ice breakers — is actually set).
+         * Disconnect a provider
+         * @description Disconnects the account at the provider and settles the card `disconnected` with `reason.code: "disconnected_by_user"`, keeping `last_account` so the card can say what was disconnected. A connect in flight with nothing connected yet is cancelled locally. **Idempotent:** a card with nothing live answers as it stands.
          *
-         *     Requires `integrations:read` or `ads:read` (owner, admin and the Marketing role — not "any member"), free for every tenant (no Add-on gate).
-         *
-         *     `data.state` is `not_connected` in TWO cases, told apart by an optional `reason`:
-         *     * no `reason` — the tenant has never connected a Meta Ads account (the integration row is missing or not `connected`).
-         *     * `reason: "whatsapp_not_connected"` — Meta Ads may be connected, but the tenant holds no `whatsapp_cloud` account carrying an partner token, so there is no scope to list ads under.
+         *     409 `sync_in_flight` — the provider is mid-sync; nothing changed, try again in a few minutes. 502 `disconnect_refused` — the provider refused; nothing changed. 502 `UPSTREAM_ERROR` — the provider could not be reached; nothing changed.
          *
-         *     `cursor` is the provider’s own opaque keyset cursor (its `pagination.cursor`, a Meta ad id ascending), passed straight through as `after`. `next_cursor` is `null` once the provider reports `has_next: false`. `last_synced_at` is the max over the returned PAGE only, not a tenant-wide sync timestamp.
-         *
-         *     502 `UPSTREAM_ERROR` on a provider 5xx, timeout, or a response shape this route does not recognise. 502 `partner_token_invalid` when the provider answers 401 on the WhatsApp partner token — that token is never auto-rotated; the dealer must reconnect WhatsApp.
+         *     Requires `integrations:write`.
          */
-        get: {
+        post: {
             parameters: {
-                query?: {
-                    cursor?: string;
-                    limit?: number;
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path: {
+                    provider: "gohighlevel" | "mercadopago";
                 };
-                header?: never;
-                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description A `not_connected` state (with or without a `reason`), or the connected page of ads */
+                /** @description The disconnected card */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93551,50 +95046,38 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "state": "connected",
-                         *         "items": [
-                         *           {
-                         *             "ad_id": "1234567890123",
-                         *             "ad_name": "Test drive fin de semana",
-                         *             "ad_status": "ACTIVE",
-                         *             "campaign": {
-                         *               "id": "6543210987654",
-                         *               "name": "Leads · WhatsApp"
-                         *             },
-                         *             "ad_set": {
-                         *               "id": "6543210987655",
-                         *               "name": "Región Metropolitana"
-                         *             },
-                         *             "destination": {
-                         *               "type": "whatsapp",
-                         *               "whatsapp_phone_number": "+56912345678",
-                         *               "page_id": "998877665544"
-                         *             },
-                         *             "cta_type": "WHATSAPP_MESSAGE",
-                         *             "greeting": {
-                         *               "text": "¡Hola! Cuéntanos qué auto buscas.",
-                         *               "autofill_message": "Quiero agendar un test drive",
-                         *               "ice_breakers": [
-                         *                 "Ver stock disponible",
-                         *                 "Agendar test drive"
-                         *               ],
-                         *               "landing_screen_type": "welcome_message"
-                         *             },
-                         *             "greeting_status": "present",
-                         *             "checks": {
-                         *               "destination_connected": true,
-                         *               "greeting_configured": true
-                         *             },
-                         *             "last_synced_at": "2026-09-23T14:00:00.000Z"
-                         *           }
-                         *         ],
-                         *         "next_cursor": null,
-                         *         "last_synced_at": "2026-09-23T14:00:00.000Z"
+                         *         "provider": "gohighlevel",
+                         *         "display_name": "GoHighLevel",
+                         *         "category": "crm",
+                         *         "description": "Trae los formularios y las oportunidades de tu CRM para seguir cada lead hasta la venta.",
+                         *         "last_account": {
+                         *           "external_id": "loc_8XkP2qR5tV",
+                         *           "name": "Agencia Ejemplo"
+                         *         },
+                         *         "last_attempt": null,
+                         *         "disconnected_at": "2026-09-28T10:00:00.000Z",
+                         *         "addon_active": true,
+                         *         "state": "disconnected",
+                         *         "state_label": "Desconectado",
+                         *         "account": null,
+                         *         "reason": {
+                         *           "code": "disconnected_by_user",
+                         *           "label": "Desconectaste GoHighLevel.",
+                         *           "retryable": true
+                         *         },
+                         *         "next_step": {
+                         *           "action": "connect",
+                         *           "label": "Conectar"
+                         *         },
+                         *         "attempt": null,
+                         *         "connected_at": null,
+                         *         "last_synced_at": "2026-09-27T15:20:00.000Z",
+                         *         "updated_at": "2026-09-28T10:00:00.000Z"
                          *       }
                          *     }
                          */
                         "application/json": {
-                            data: components["schemas"]["MetaAdsAdsResponse"];
+                            data: components["schemas"]["ProviderConnection"];
                         };
                     };
                 };
@@ -93616,6 +95099,31 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description The Vitrina Ads add-on is not active and nothing is connected (or in flight) for this provider. `error.code` is `ENTITLEMENT_NOT_ACTIVE`, `error.details.feature` is `vitrina_ads`. A connection that outlived the add-on is never refused here: it stays readable, finishable and disconnectable. */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "ENTITLEMENT_NOT_ACTIVE",
+                         *         "message": "El complemento Vitrina Ads no está activo en este espacio de trabajo.",
+                         *         "details": {
+                         *           "required": [
+                         *             "vitrina_ads"
+                         *           ],
+                         *           "active": [],
+                         *           "feature": "vitrina_ads",
+                         *           "entitlement_state": "off"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Forbidden */
                 403: {
                     headers: {
@@ -93654,8 +95162,6 @@ interface paths {
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
@@ -95153,7 +96659,13 @@ interface paths {
                          *             "verdict": "healthy_tracking",
                          *             "tracking_healthy": true,
                          *             "coverage_interpretation": "La mayoría de las ventas llegan con su origen publicitario.",
-                         *             "missing": []
+                         *             "missing": [],
+                         *             "tracker": {
+                         *               "status": "live",
+                         *               "web_touches": 1842,
+                         *               "last_web_touch": "2026-08-31T21:14:00Z",
+                         *               "fresh": true
+                         *             }
                          *           },
                          *           "traceable_roas_trend": {
                          *             "recent_roas": 3.4,
@@ -96289,7 +97801,7 @@ interface paths {
          *
          *     `window` (Creativos only) derives the rail on the same rolling creatives window as `GET /ads/creatives`; pass the same `window` to preview.
          *
-         *     A `key` is `<kind>:<target external id>:<YYYY-MM-DD>` and is stable for the day. Dismissed actions stay on the list with `dismissed_until` set, sorted last. `include=adset_duplicate_swap` also lists the duplicate-and-swap actions (hidden by default).
+         *     A `key` is `<kind>:<target external id>:<YYYY-MM-DD>` and is stable for the day. Dismissed actions stay on the list with `dismissed_until` set, sorted last. `include=adset_duplicate_swap` also lists the duplicate-and-swap actions (hidden by default). `include=campaign_pause` (Campañas, Resumen) marks a client that renders the whole-campaign pause card (`campaign_pause`: one atomic change in Meta, undone with «Reanudar»). **Not offered yet** — its eligibility rule is pending — so today the list never contains it, with or without the include, and a campaign that spent with no results keeps the per-ad cards.
          *
          *     Card state machine (client): `proposed → previewing → confirming → running → done | failed | refused → (done) reverted`; `dismissed` for 7 days; `simulated` replaces `done` in sample mode.
          */
@@ -96302,8 +97814,8 @@ interface paths {
                     to: string;
                     /** @description `creativos` only: the creatives window the rail is derived for — the same rolling lookback as `GET /ads/creatives?window=`, so a card’s figures (the worn-out ad’s spend) match the gallery. Defaults to `28d`. Sent with any other screen → 400. */
                     window?: "7d" | "14d" | "28d" | "lifetime";
-                    /** @description `adset_duplicate_swap` also lists the duplicate-and-swap actions (Salud). Hidden by default: it rebuilds an ad set (new id, learning reset) and is offered as the alternative after a `promoted_object_frozen` refusal. */
-                    include?: "adset_duplicate_swap";
+                    /** @description `adset_duplicate_swap` also lists the duplicate-and-swap actions (Salud). Hidden by default: it rebuilds an ad set (new id, learning reset) and is offered as the alternative after a `promoted_object_frozen` refusal. `campaign_pause` (Campañas, Resumen): the client renders the whole-campaign pause card. Not offered yet (its rule is pending): accepted, and the list does not contain the card today. */
+                    include?: "adset_duplicate_swap" | "campaign_pause";
                     /** @description `1` serves the deterministic sample dataset («Ver con datos de ejemplo»): same shapes, invented but internally consistent figures, no entitlement required (the scope still is). A sandbox workspace is always served the sample, with or without this parameter. */
                     sample?: "1" | "true";
                 };
@@ -96591,9 +98103,9 @@ interface paths {
         put?: never;
         /**
          * Preview an action before confirming it
-         * @description Reads the target’s live state and returns what will change (`rows`: before → after), the warnings, and — for a duplicate-and-swap or a URL-parameter fix — the consent lines the owner must accept. A `url_tags_fix` preview lists `untagged_ads` («{n} → 0») first, then one row per ad (`ad:<id>`): its current parameters → exactly what it gets; an ad changed in Meta after the preview is skipped at execute, never rewritten blind. It also records ONE single-use approval bound to the caller, the action and its exact parameters, valid for 10 minutes (`expires_at`): `preview_id` is what `execute` spends. No engine write happens here.
+         * @description Reads the target’s live state and returns what will change (`rows`: before → after), the warnings, and — for a duplicate-and-swap or a URL-parameter fix — the consent lines the owner must accept. A `url_tags_fix` preview lists `untagged_ads` («{n} → 0») first, then one row per ad (`ad:<id>`): its current parameters → exactly what it gets; an ad changed in Meta after the preview is skipped at execute, never rewritten blind. A `campaign_pause` preview reads the campaign live ONCE and returns everything its sheet and card draw: `summary` («Pausar «{campaign}» · detiene {n} anuncios · ~$X al día»), `campaign` (status, the ads it stops, the mean daily spend and the budget as exact decimal strings with their currency, and where the budget lives) and the rows `status`, `delivering_ads`, `avg_daily_spend`, `budget`, plus its consent. It also records ONE single-use approval bound to the caller, the action and its exact parameters, valid for 10 minutes (`expires_at`): `preview_id` is what `execute` spends. No engine write happens here.
          *
-         *     409 `ADS_ACTION_NOT_AVAILABLE` when the action is no longer on today’s list (or is a `nav` card, which has nothing to execute).
+         *     409 `ADS_ACTION_NOT_AVAILABLE` when the action is no longer on today’s list (or is a `nav` card, which has nothing to execute). A `campaign_pause` key answers it with `details.reason: not_offered` while that action is not offered; once it is, it also answers it when the live read says the pause cannot run now — `details.reason`: `not_active` (already paused), `not_pausable` (archived or deleted), `campaign_not_found`, `meta_connection_missing`, `permission_gap`, `reconnect_required`, `not_available` (any other refusal of the read), `too_recent` (less than 7 complete days of spend) — with `details.explanation`, Spanish copy for the owner; an already-paused, archived or missing campaign also hides the card for 7 days, and a too-recent one until the day it can be judged. 503 `ADS_ACTION_READ_UNAVAILABLE` (`details.reason: meta_unavailable`) when the campaign could not be read right now — retry in a moment.
          */
         post: {
             parameters: {
@@ -96754,6 +98266,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description `campaign_pause` only: the campaign could not be read right now (no answer, an upstream error or a rate limit). `error.code` is `ADS_ACTION_READ_UNAVAILABLE`, `details.reason: meta_unavailable`, `details.explanation` Spanish copy for the owner. Nothing was recorded; retry in a moment. */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -96777,11 +98298,13 @@ interface paths {
          *
          *     409 `ADS_ACTION_REPLAY_BLOCKED` when the approval cannot be spent — `details.reason` is `expired` (preview older than 10 minutes), `consumed` (already confirmed, e.g. from another tab), `not_found` or `binding_mismatch` (another person’s preview, or another action — incl. a real preview sent with `sample: true`). In sample mode nothing reaches the engine: the execution is born `succeeded` with `simulated: true`, and only a sample preview can be spent.
          *
-         *     **Duplicate-and-swap** and **`url_tags_fix`** need the owner’s acceptance of the preview’s `consent_terms` (the verbatim consent text): send `consent: { version, text_hash, accepted_at? }`. Missing, different or older than 24 h → 409 `ADS_ACTION_CONSENT_REQUIRED` (`details.reason` missing|mismatch|stale, `details.consent` = the current version and hash) — nothing is spent and nothing reaches the engine.
+         *     **`campaign_pause`**, **duplicate-and-swap** and **`url_tags_fix`** need the owner’s acceptance of the preview’s `consent_terms` (the verbatim consent text): send `consent: { version, text_hash, accepted_at? }`. Missing, different or older than 24 h → 409 `ADS_ACTION_CONSENT_REQUIRED` (`details.reason` missing|mismatch|stale, `details.consent` = the current version and hash) — nothing is spent and nothing reaches the engine.
          *
          *     If the job cannot be queued the answer is still 202, with `status: failed`: the execution exists and says why (`error.code: queue_unavailable`).
          *
          *     A `url_tags_fix` corrects each ad on its own: `outcome.summary` reads «{k} de {n} anuncios corregidos», `outcome.partial` is true when k < n, and `outcome.ads[]` says what happened to each ad. None corrected → `failed`/`refused` with the first ad’s reason, still with `outcome.ads[]`.
+         *
+         *     A `campaign_pause` is ONE change in Meta. Each execution is its own request: a second confirm (another tab, an agent) finds the campaign already paused and answers `outcome.engine_outcome: no_change` — nothing written, no journal line, nothing to undo. Otherwise `engine_outcome` is `applied`, or `replayed` (a retry of this same execution); `outcome.affected_ads_count` is how many ads stopped.
          */
         post: {
             parameters: {
@@ -96810,7 +98333,7 @@ interface paths {
                          */
                         preview_id: string;
                         sample?: boolean;
-                        /** @description Required whenever the preview returned `consent_terms` (a duplicate-and-swap, a URL-parameter fix `url_tags_fix`, «Enviar a Meta»'s `send_setup` and `send_dataset`, and a `send_stage` off / `send_stop` that stops an event active ad sets optimise on), ignored otherwise: the owner's acceptance of `consent_terms` — echo its `version` and `text_hash`. The accepting person is always the caller. */
+                        /** @description Required whenever the preview returned `consent_terms` (a campaign pause `campaign_pause`, a duplicate-and-swap, a URL-parameter fix `url_tags_fix`, «Enviar a Meta»'s `send_setup` and `send_dataset`, and a `send_stage` off / `send_stop` that stops an event active ad sets optimise on), ignored otherwise: the owner's acceptance of `consent_terms` — echo its `version` and `text_hash`. The accepting person is always the caller. */
                         consent?: {
                             version: string;
                             text_hash: string;
@@ -97219,7 +98742,7 @@ interface paths {
         };
         /**
          * The status of an action execution
-         * @description `queued → running → succeeded | failed | refused`; a succeeded execution becomes `rolled_back` when its rollback succeeds. `error.reason` is one of `promoted_object_frozen` (Meta froze the ad set’s conversion — the duplicate-and-swap is the alternative), `reconnect_required`, `permission_gap` (Meta connected without permission to manage ads — reconnect keeping it), `rate_limited`, `not_reversible`, `forbidden` (no person could be put on the record for the change — not a Meta grant problem), `consent_required` (the duplicate-and-swap consent is missing or stale — preview again), `engine_error` (incl. `code: budget_change_out_of_bounds` — outside the ±50 % allowed per change — `code: not_active` and `code: no_recommendation`). `error.message` is Spanish copy ready for the card. `target` is what the action touched (with `campaign_name`, the campaign the card named, on an ad-set budget change).
+         * @description `queued → running → succeeded | failed | refused`; a succeeded execution becomes `rolled_back` when its rollback succeeds. `error.reason` is one of `promoted_object_frozen` (Meta froze the ad set’s conversion — the duplicate-and-swap is the alternative), `reconnect_required`, `permission_gap` (Meta connected without permission to manage ads — reconnect keeping it), `rate_limited`, `not_reversible`, `forbidden` (no person could be put on the record for the change — not a Meta grant problem), `consent_required` (the duplicate-and-swap consent is missing or stale — preview again), `engine_error` (incl. `code: budget_change_out_of_bounds` — outside the ±50 % allowed per change — `code: not_active` and `code: no_recommendation`). Campaign pause codes: `campaign_not_found` / `campaign_not_pausable` (archived or deleted — never written) / `meta_refused` (`engine_error`), `campaign_not_resumable` (`not_reversible`), a dead Meta token → `reconnect_required`, `meta_permission_denied` (`permission_gap` — Meta refused for a missing permission), `applied_by_not_allowed` (`forbidden`), `meta_rate_limited` (`rate_limited`, retried first). `error.message` is Spanish copy ready for the card. `target` is what the action touched (with `campaign_name`, the campaign the card named, on an ad-set budget change).
          */
         get: {
             parameters: {
@@ -97385,7 +98908,7 @@ interface paths {
         put?: never;
         /**
          * Undo an executed action
-         * @description Queues the engine’s rollback of a `succeeded` execution with `rollback_available: true` and answers the NEW execution (`rollback_of` = the original). The engine restores the pre-change state only while the object still carries what the action wrote; otherwise the rollback is `refused` with `reason: not_reversible` (`code: state_drifted`). A `url_tags_fix` is undone ad by ad (each ad back on its previous parameters): an ad changed in Meta since is left alone (final), an ad whose undo got no answer stays pending — the original keeps `rollback_available: true` and the next rollback sends only those ads; the original reads `rolled_back` once nothing is pending. **`Idempotency-Key` is required.** 409 `ADS_ACTION_NOT_REVERSIBLE` when the execution has nothing to undo.
+         * @description Queues the engine’s rollback of a `succeeded` execution with `rollback_available: true` and answers the NEW execution (`rollback_of` = the original). The engine restores the pre-change state only while the object still carries what the action wrote; otherwise the rollback is `refused` with `reason: not_reversible` (`code: state_drifted`). A `url_tags_fix` is undone ad by ad (each ad back on its previous parameters): an ad changed in Meta since is left alone (final), an ad whose undo got no answer stays pending — the original keeps `rollback_available: true` and the next rollback sends only those ads; the original reads `rolled_back` once nothing is pending. A `campaign_pause` is undone with «Reanudar»: one resume in Meta, with a fresh key per request; ads that were paused on their own stay paused. A campaign already active answers `outcome.engine_outcome: no_change` (the pause is then no longer undoable, never marked as undone by Vitrina); an archived or deleted one is `refused` `not_reversible` (`code: campaign_not_resumable`), and so is one paused again by someone else since (`code: paused_since`): «Reanudar» only ever undoes this pause. **`Idempotency-Key` is required.** 409 `ADS_ACTION_NOT_REVERSIBLE` when the execution has nothing to undo.
          */
         post: {
             parameters: {
@@ -98217,7 +99740,24 @@ interface paths {
                          *             }
                          *           },
                          *           "credited_weight": 1,
-                         *           "touch_count": 3
+                         *           "touch_count": 3,
+                         *           "origin": {
+                         *             "platform": "whatsapp",
+                         *             "external_id": "120211000000000101",
+                         *             "name": "Reel · Antes y después",
+                         *             "ad_name": "Reel · Antes y después",
+                         *             "headline": "Evaluación sin costo",
+                         *             "campaign": {
+                         *               "external_id": "120211000000000001",
+                         *               "name": "Ortodoncia invisible · Septiembre"
+                         *             },
+                         *             "thumbnail_url": null,
+                         *             "media_archived": false,
+                         *             "first_message_at": "2026-09-20T13:02:30.000Z",
+                         *             "matches_credit": true
+                         *           },
+                         *           "origin_source": "engine",
+                         *           "attribution": "credited"
                          *         },
                          *         {
                          *           "id": "01926f3a-1b2c-7d3e-8f40-5a6b7c8d9e0f",
@@ -98234,7 +99774,21 @@ interface paths {
                          *           },
                          *           "ad": null,
                          *           "credited_weight": null,
-                         *           "touch_count": null
+                         *           "touch_count": null,
+                         *           "origin": {
+                         *             "platform": "instagram",
+                         *             "external_id": "120211000000000205",
+                         *             "name": "Limpieza facial",
+                         *             "ad_name": null,
+                         *             "headline": "Limpieza facial",
+                         *             "campaign": null,
+                         *             "thumbnail_url": null,
+                         *             "media_archived": false,
+                         *             "first_message_at": "2026-09-22T17:40:05.000Z",
+                         *             "matches_credit": null
+                         *           },
+                         *           "origin_source": "conversation",
+                         *           "attribution": "pending"
                          *         }
                          *       ],
                          *       "meta": {
@@ -98456,6 +100010,31 @@ interface paths {
                          *             "channel": "meta"
                          *           },
                          *           {
+                         *             "stage": null,
+                         *             "detail": "Ortodoncia invisible · Septiembre",
+                         *             "credited": false,
+                         *             "join_method": "ctwa_referral",
+                         *             "click_id_kind": "ctwa_clid",
+                         *             "ad": {
+                         *               "external_id": "120211000000000101",
+                         *               "name": "Reel · Antes y después",
+                         *               "ad_set_name": "Mujeres 30-45 · Providencia",
+                         *               "campaign": {
+                         *                 "external_id": "120211000000000100",
+                         *                 "name": "Ortodoncia invisible · Septiembre"
+                         *               },
+                         *               "creative_thumbnail_url": null
+                         *             },
+                         *             "value": null,
+                         *             "current": false,
+                         *             "id": "7d7d7d7d-1111-4222-8333-444455556666",
+                         *             "kind": "chat",
+                         *             "origin": "vitrina",
+                         *             "label": "Mensaje por el anuncio «Reel · Antes y después»",
+                         *             "at": "2026-09-20T13:02:30.000Z",
+                         *             "channel": "whatsapp"
+                         *           },
+                         *           {
                          *             "stage": "lead_created",
                          *             "detail": "Por WhatsApp",
                          *             "credited": false,
@@ -108794,6 +110373,151 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/whatsapp-templates/category-check": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Predict whether Meta will reclassify a UTILITY draft as MARKETING
+         * @description Jev-calibrated preview the template editor calls before submit (#2972). Meta silently reclassifies UTILITY templates as MARKETING at review time; this warns before that happens instead of after. `category` other than `UTILITY` always answers `applicable: false` — Meta’s reclassification only runs that one direction, so nothing is asked. Never changes what gets submitted and never writes to the Jev ledger (a preview is not an acted-on decision — the actual submission is what gets ledgered and later graded against Meta’s verdict). `cause` is a deterministic guess (never Jev’s own answer) set only when `likely_marketing` is true.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    /**
+                     * @example {
+                     *       "category": "UTILITY",
+                     *       "body_text": "Hola {{1}}, ¿sigues interesado en el {{2}}? Si quieres, coordinamos una visita para que lo veas.",
+                     *       "footer_text": "Autos del Valle"
+                     *     }
+                     */
+                    "application/json": {
+                        /** @enum {string} */
+                        category: "MARKETING" | "UTILITY" | "AUTHENTICATION";
+                        body_text: string;
+                        header_text?: string | null;
+                        footer_text?: string | null;
+                        buttons?: ({
+                            /** @enum {string} */
+                            type: "QUICK_REPLY";
+                            text: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "URL";
+                            text: string;
+                            /** Format: uri */
+                            url: string;
+                            /** Format: uri */
+                            example?: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "PHONE_NUMBER";
+                            text: string;
+                            phone_number: string;
+                        })[];
+                    };
+                };
+            };
+            responses: {
+                /** @description The prediction */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "applicable": true,
+                         *         "likely_marketing": true,
+                         *         "cause": "promotional_wording"
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data?: unknown;
+                            meta?: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+                /** @description Validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conflict (incl. Idempotency-Key reuse with different body) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/whatsapp-templates/{id}/param-meta": {
         parameters: {
             query?: never;
@@ -118859,11 +120583,11 @@ interface components {
             stage_count: number;
             /** @description Clinics: the Purchase volume of the first payment, counted before the switch too. `null` outside clinics or when it could not be read. */
             first_payment_candidates: {
-                /** @description First payments of accepted plans over the last 28 days in Vitrina’s payment ledger — what reaches Meta as Purchase once switched. */
+                /** @description First payments of accepted plans over the last 28 days — in Vitrina’s payment ledger and in the clinic system’s mirror, one per sale — what reaches Meta as Purchase once switched. */
                 count_28d: number;
                 /** @description `count_28d / 4`, one decimal. */
                 weekly_28d: number;
-                /** @description The same volume in the clinic system’s mirror, for information: mirrored payments do not reach Meta. `null` without a mirror opt-in. */
+                /** @description Of `count_28d`, the first payments claimed from the clinic system’s mirror (they reach Meta like the ledger’s). `null` without a mirror opt-in. */
                 mirror_count_28d: number | null;
                 mirror_weekly_28d: number | null;
             } | null;
@@ -119171,6 +120895,107 @@ interface components {
             last_synced_at: string | null;
         };
         MetaAdsAdsResponse: components["schemas"]["MetaAdsAdsNotConnected"] | components["schemas"]["MetaAdsAdsConnected"];
+        /** @description The connected account. Present on `connected` and `needs_reconnect` (the card must name what needs reconnecting). */
+        ProviderConnectionAccount: {
+            /** @description The provider’s own id for the account (GoHighLevel location id, Mercado Pago user id). Opaque; relayed verbatim. */
+            external_id: string;
+            /** @description The account’s display name at the provider. */
+            name: string;
+        } | null;
+        /** @description Why the card is in this state: a failed first connect, `reconnect_required`, `sync_error` (connected, last sync failed), `access_revoked`, `disconnected_by_user`. */
+        ProviderConnectionReason: {
+            /**
+             * @description A STABLE code — also the copy key. `user_cancelled`, `provider_denied`, `provider_error`, `token_exchange_failed`, `account_connected_elsewhere`, `no_candidates`, `connect_failed`, `internal_error`, `state_expired`, `state_invalid`, `handoff_expired`, `handoff_used`, `provider_not_configured`, `origin_not_allowed` come from the consent itself; `selection_expired`, `selection_conflict`, `reconnect_required`, `sync_error`, `access_revoked`, `disconnected_by_user`, `connection_not_found`, `handoff_not_found`, `unknown_error` are Vitrina’s own.
+             * @enum {string}
+             */
+            code: "user_cancelled" | "provider_denied" | "provider_error" | "token_exchange_failed" | "account_connected_elsewhere" | "no_candidates" | "connect_failed" | "internal_error" | "state_expired" | "state_invalid" | "handoff_expired" | "handoff_used" | "provider_not_configured" | "origin_not_allowed" | "selection_expired" | "selection_conflict" | "reconnect_required" | "sync_error" | "access_revoked" | "disconnected_by_user" | "connection_not_found" | "handoff_not_found" | "unknown_error";
+            /** @description A ready Spanish sentence for the card, naming the provider. */
+            label: string;
+            /** @description Is trying the same thing again, right away, likely to work? */
+            retryable: boolean;
+        } | null;
+        ProviderConnection: {
+            /** @enum {string} */
+            provider: "gohighlevel" | "mercadopago";
+            display_name: string;
+            /** @enum {string} */
+            category: "crm" | "payments";
+            /** @description One sentence: what connecting it does for the workspace. */
+            description: string;
+            /**
+             * @description `not_connected` (never connected) → `connecting` (first consent in flight) → `connected` → `needs_reconnect` (the provider stopped honouring the grant; data is not updating) → `disconnected` (was connected, is not any more).
+             * @enum {string}
+             */
+            state: "not_connected" | "connecting" | "connected" | "needs_reconnect" | "disconnected";
+            /** @description The state in Spanish, ready to render. */
+            state_label: string;
+            account: components["schemas"]["ProviderConnectionAccount"];
+            last_account: components["schemas"]["ProviderConnectionAccount"] & unknown;
+            reason: components["schemas"]["ProviderConnectionReason"];
+            last_attempt: components["schemas"]["ProviderConnectionReason"] & unknown;
+            /** @description The one thing the card should offer next. Never a dead end. */
+            next_step: {
+                /**
+                 * @description `connect` / `resume` / `reconnect` / `retry` → `POST …/connect`; `activate_addon` → the Vitrina Ads add-on; `choose_account` → `POST …/finalize`; `contact_support` and `none` call nothing. Disconnect is always available on a card that is not `not_connected`.
+                 * @enum {string}
+                 */
+                action: "connect" | "resume" | "choose_account" | "reconnect" | "retry" | "activate_addon" | "contact_support" | "none";
+                /** @description The primary button’s label, or null for `none`. */
+                label: string | null;
+            };
+            /** @description A connect in flight, if any — a consent the admin is on, or an account choice still owed. Rides on top of `state`: reconnecting a connected account does not make the card read `connecting`. */
+            attempt: {
+                /** @enum {string} */
+                step: "consent" | "choose_account";
+                /** @description The consent this attempt belongs to. On `choose_account`, send its `id` to `/finalize` as `handoff_id`. */
+                handoff: {
+                    /** Format: uuid */
+                    id: string;
+                    expires_at: string;
+                } | null;
+                /** @description Step `choose_account` only: the accounts the consent can connect. Send one `external_id` to `/finalize`. */
+                candidates: (components["schemas"]["ProviderConnectionAccount"] & Record<string, never>)[] | null;
+                selection_expires_at: string | null;
+                /** @description The picker / waiting title, in Spanish. */
+                prompt: string;
+            } | null;
+            connected_at: string | null;
+            disconnected_at: string | null;
+            /** @description When the provider’s data last finished syncing. */
+            last_synced_at: string | null;
+            updated_at: string | null;
+            /** @description Whether the Vitrina Ads add-on is active. `false` only on a card that outlived a lapsed add-on (a connection or a consent in flight): it stays visible and can be disconnected, and any step that would start a new consent becomes `activate_addon`. */
+            addon_active: boolean;
+        };
+        ProviderConnectResult: {
+            /** @description Send the WHOLE page here: it goes straight to the provider’s consent screen. Single-use, 45 minutes. */
+            url: string;
+            /** Format: uuid */
+            handoff_id: string;
+            expires_at: string;
+            connection: components["schemas"]["ProviderConnection"];
+        };
+        ProviderConnectBody: {
+            /** Format: uri */
+            return_to: string;
+        };
+        ProviderReturnBody: {
+            /** Format: uuid */
+            handoff_id?: string;
+            state?: string;
+            /** @enum {string} */
+            status?: "success" | "pending_selection" | "failed" | "cancelled";
+            reason?: string;
+        };
+        ProviderFinalizeBody: {
+            /** @description An `attempt.candidates[].external_id`, verbatim. */
+            external_id: string;
+            /**
+             * Format: uuid
+             * @description The `attempt.handoff.id` of the picker being answered. When sent and it is not the consent this card is waiting on, the answer is 409 `handoff_mismatch` — a stale tab cannot finalize a newer consent’s choice. Omitted: the current picker is finalized.
+             */
+            handoff_id?: string;
+        };
         AdsOverviewDay: {
             date: string;
             /** @description `null` exactly when the engine could not scope spend. */
@@ -119240,6 +121065,33 @@ interface components {
             /** @description `grain=day` only: every day of the previous window of equal length. */
             previous_days?: components["schemas"]["AdsOverviewDay"][];
         };
+        /** @description Present on a conversational row: a message-only objective (`MESSAGES`), or conversations the platform reports, or conversations Vitrina counts. Also present with `data_complete: false` (figures `null`) when a read failed on a row that may be conversational (its objective unknown or in the messaging family) in a workspace with ad-opened conversations. ABSENT otherwise — never a row of zeros, never partial counts. */
+        AdsConversational: {
+            /** @description `false` when a read behind the line failed or timed out: the `null` figures are unknown, not zero («sin datos de Meta por ahora»). `true` = every figure was read. */
+            data_complete: boolean;
+            /** @description The campaign objective as the ad platform names it (`OUTCOME_ENGAGEMENT`, `MESSAGES`, …); `null` when unknown. */
+            objective: string | null;
+            /** @description The ad platform’s own count («conversaciones iniciadas», its 7-day window, every sender) — a DIFFERENT population from `vitrina`; never add or compare the two. `null` when it reports none. */
+            started: {
+                /** @description Conversations started, as the ad platform reports them. */
+                conversations: number;
+                /** @description The row’s `spend` ÷ conversations started, whole CLP — the same spend basis as `vitrina.cost_per_conversation`; `null` when unknown. */
+                cost_per_conversation: number | null;
+            } | null;
+            /** @description Vitrina’s own conversations from the ad — deterministic counts, never a credited share. `null` when Vitrina counts none in the period (or the ad → campaign map could not be read now). */
+            vitrina: {
+                /** @description Conversations whose first message came from this ad (or an ad of this campaign), opened in the period (America/Santiago days) — Vitrina’s own count. */
+                conversations: number;
+                /** @description «Respondidas»: of those, answered at least once by the team, the AI agent or an integration. */
+                replied: number;
+                /** @description Of those, with a booked appointment (cita / visita) recorded against them, whenever it was booked. */
+                appointments: number;
+                /** @description Of those, closed (a sale / an accepted plan) recorded against them, whenever it closed. */
+                closed: number;
+                /** @description The row’s `spend` ÷ `conversations`, whole CLP — the same spend basis as `started.cost_per_conversation`. */
+                cost_per_conversation: number | null;
+            } | null;
+        };
         AdsCampaigns: {
             data: {
                 campaign_id: string;
@@ -119268,6 +121120,7 @@ interface components {
                     /** @description Conversions credited primarily to the campaign that day (each conversion counted once, on its largest-credit campaign). `null` when unknown: credit not available yet, the campaign outside the credited set read (top 25 by outcomes), or a day before the credit window (the last 92 days). Under a multi-touch model the days can sum to less than the row’s `outcome_count`. */
                     outcome_count: number | null;
                 }[] | null;
+                conversational?: components["schemas"]["AdsConversational"];
             }[];
         };
         AdsAttributedSales: {
@@ -119332,6 +121185,7 @@ interface components {
                     /** @description Percent (clicks ÷ impressions × 100), like the row’s `ctr`; `null` on a day without impressions. */
                     ctr: number | null;
                 }[] | null;
+                conversational?: components["schemas"]["AdsConversational"] & unknown;
             }[];
         };
         AdsHealth: {
@@ -119349,6 +121203,18 @@ interface components {
                     tracking_healthy: boolean;
                     coverage_interpretation: string;
                     missing: string[];
+                    /** @description The website tag signal behind `missing[tracker]`. `null` when the engine did not report it (unknown, never «silent»). */
+                    tracker: {
+                        /**
+                         * @description `live` = 10 or more web-tag touches in the window and one in the last 7 days; `sparse` = at least one touch but not live (few visits, or none in the last 7 days); `missing` = no touch at all. `missing[]` lists `tracker` for both `sparse` and `missing` — only `missing` means the tag sent nothing.
+                         * @enum {string}
+                         */
+                        status: "live" | "sparse" | "missing";
+                        web_touches: number;
+                        last_web_touch: string | null;
+                        /** @description A web-tag touch inside the last 7 days. */
+                        fresh: boolean;
+                    } | null;
                 };
                 traceable_roas_trend: {
                     recent_roas: number | null;
@@ -119530,7 +121396,7 @@ interface components {
             /** @description `<kind>:<target external id>:<YYYY-MM-DD>` — a composite key, stable for a day. */
             key: string;
             /** @enum {string} */
-            kind: "pause_ad" | "budget_change" | "adset_duplicate_swap" | "utm_refresh" | "wiring_recheck" | "url_tags_fix" | "send_setup" | "send_stage" | "send_dataset" | "send_stop" | "send_protected_move" | "nav";
+            kind: "pause_ad" | "campaign_pause" | "budget_change" | "adset_duplicate_swap" | "utm_refresh" | "wiring_recheck" | "url_tags_fix" | "send_setup" | "send_stage" | "send_dataset" | "send_stop" | "send_protected_move" | "nav";
             screen: ("resumen" | "campanas" | "creativos" | "salud" | "envio")[];
             /** @description The one card the rail leads with. */
             primary: boolean;
@@ -119552,7 +121418,7 @@ interface components {
                     external_id: string;
                     name: string | null;
                 } | null;
-                /** @description `url_tags_fix` (and its read-only `nav` fallback) only: the ads whose «Parámetros de URL» do not carry the ad id where attribution reads it, busiest first, at most what one fix accepts (25). Ad set and campaign are named, not identified (the audit carries names only). */
+                /** @description `url_tags_fix` (and its read-only `nav` fallback): the ads whose «Parámetros de URL» do not carry the ad id where attribution reads it, busiest first, at most what one fix accepts (25). Ad set and campaign are named, not identified (the audit carries names only). `campaign_pause`: the campaign’s delivering ads, busiest first (at most 6 — the card’s thumbnails; the live count is the preview’s). */
                 ads?: {
                     /** @description The ad’s Meta id. */
                     external_id: string;
@@ -119561,7 +121427,7 @@ interface components {
                     campaign_name: string | null;
                 }[];
             };
-            /** @description The engine’s own vocabulary, e.g. `{ budget_change_pct: 20 }`. `url_tags_fix`: `{ ads: [{ external_id, expected_url_tags, url_tags }] }` — each ad’s current parameters (null = none) and exactly what it gets. «Enviar a Meta»: `send_setup`/`send_dataset` `{ dataset_id }`, `send_stage` `{ stage, enabled, meta_event, active_ad_sets }`. */
+            /** @description The engine’s own vocabulary, e.g. `{ budget_change_pct: 20 }`. `url_tags_fix`: `{ ads: [{ external_id, expected_url_tags, url_tags }] }` — each ad’s current parameters (null = none) and exactly what it gets. «Enviar a Meta»: `send_setup`/`send_dataset` `{ dataset_id }`, `send_stage` `{ stage, enabled, meta_event, active_ad_sets }`. `campaign_pause`: `{ period_spend, period_days, delivering_ads_count, avg_daily_spend_7d }` — the campaign’s spend in the listed period (the account currency’s major units), the period’s days and its delivering ads, what the card draws at rest (spend → 0, ~spend/days a day); `avg_daily_spend_7d` is the live 7-day daily mean the preview shows (`AdsMoney`: exact decimal + currency), `null` when the list could not know it (real mode reads it only at preview) — fall back to `period_spend / period_days`, labelled as the period. */
             params: {
                 [key: string]: unknown;
             };
@@ -119571,7 +121437,7 @@ interface components {
             /** @description Which operation executes it; `null` for `nav`. */
             engine_ref: {
                 /** @enum {string} */
-                op: "recommendations.apply" | "ads.pause" | "wiring.ad_sets" | "quality.utm_refresh" | "wiring.recheck" | "actions.rollback" | "quality.url_tags_apply" | "quality.url_tags_undo" | "send.setup" | "send.dataset" | "send.stage" | "send.stop" | "send.restore";
+                op: "recommendations.apply" | "ads.pause" | "campaigns.pause" | "campaigns.resume" | "wiring.ad_sets" | "quality.utm_refresh" | "wiring.recheck" | "actions.rollback" | "quality.url_tags_apply" | "quality.url_tags_undo" | "send.setup" | "send.dataset" | "send.stage" | "send.stop" | "send.restore";
                 recommendation_id?: string;
             } | null;
             /** @description `nav` only: a workspace-relative path (`/anuncios/atribuidos?c=…`, `/anuncios/activar?paso=tag`), or an absolute Meta Ads Manager URL built from Meta ids (`https://www.facebook.com/adsmanager/…`) — open it in a new tab; it changes nothing by itself. */
@@ -119586,6 +121452,43 @@ interface components {
              */
             disabled_reason?: "consent_pending";
         };
+        /** @description Mean daily spend over the last `spend_window_days` complete days — the «~$X al día» the pause stops. `null` = nothing spent / unknown. */
+        AdsMoney: {
+            /** @description Exact decimal string in the currency’s MAJOR units (never a float): `"12345.5"`. Parse before arithmetic. */
+            amount: string;
+            /** @description ISO 4217, e.g. `CLP`. */
+            currency: string | null;
+            /** @description Formatted for display (`$12.346`); `null` when the currency is unknown. */
+            display: string | null;
+        } | null;
+        /** @description `campaign_pause` only: the live campaign, from ONE status read — everything the sheet and the card’s delta draw, no second call. */
+        AdsCampaignPauseSnapshot: {
+            /** @description The campaign’s Meta id. */
+            external_id: string;
+            name: string | null;
+            /** @description Configured status: ACTIVE | PAUSED | ARCHIVED | DELETED. */
+            status: string | null;
+            /** @description Meta’s delivery verdict (ACTIVE, IN_PROCESS, WITH_ISSUES, …). */
+            effective_status: string | null;
+            /**
+             * @description `live` — read from Meta just now. A preview answers only on a live read: when Meta cannot be read it is 503 `ADS_ACTION_READ_UNAVAILABLE` (retry in a moment).
+             * @enum {string}
+             */
+            status_source: "live" | "synced";
+            /** @description Ads the pause stops right now — «detiene {n} anuncios». `null` = unknown. */
+            delivering_ads_count: number | null;
+            avg_daily_spend: components["schemas"]["AdsMoney"];
+            spend_window_days: number | null;
+            /**
+             * @description `campaign` — one campaign budget; `ad_set` — each ad set has its own.
+             * @enum {string|null}
+             */
+            budget_level: "campaign" | "ad_set" | null;
+            daily_budget: components["schemas"]["AdsMoney"] & unknown;
+            lifetime_budget: components["schemas"]["AdsMoney"] & unknown;
+            /** @description When the status was read (ISO). */
+            as_of: string | null;
+        };
         AdsActionPreview: {
             /** Format: uuid */
             preview_id: string;
@@ -119596,11 +121499,18 @@ interface components {
                 label: string;
                 before: string;
                 after: string;
+                /**
+                 * @description `kept`: a fact the action does not change — render ONE value (`before`; `after` repeats it) with `note`. Absent: a before → after change.
+                 * @enum {string}
+                 */
+                kind?: "kept";
+                /** @description `kept` rows: why it stays («Se conserva …»). */
+                note?: string;
             }[];
             warnings: string[];
             /** @description The consent-bearing previews only (duplicate-and-swap, `url_tags_fix`, «Enviar a Meta» when it asks): `consent_terms.text` split into lines, for display (verbatim). */
             consent: string[];
-            /** @description The consent-bearing previews only: what the owner accepts before confirming. Execute must send `consent: { version, text_hash }`. For `url_tags_fix` the text is one sentence: rewriting an ad’s parameters replaces its creative, which can restart the learning phase of the affected ad sets. «Enviar a Meta»: `send_setup` always carries the owner’s authorisation of the send; `send_dataset`, and a `send_stage` off or `send_stop` that stops an event active ad sets optimise on, carry the learning-reset line. */
+            /** @description The consent-bearing previews only: what the owner accepts before confirming. Execute must send `consent: { version, text_hash }`. For `campaign_pause`: every ad stops at once; «Reanudar» brings it back with the same budget, ads paused on their own stay paused, and a pause of 7 days or more can restart Meta’s learning phase. For `url_tags_fix` the text is one sentence: rewriting an ad’s parameters replaces its creative, which can restart the learning phase of the affected ad sets. «Enviar a Meta»: `send_setup` always carries the owner’s authorisation of the send; `send_dataset`, and a `send_stage` off or `send_stop` that stops an event active ad sets optimise on, carry the learning-reset line. */
             consent_terms: {
                 version: string;
                 /** @enum {string} */
@@ -119612,14 +121522,17 @@ interface components {
             } | null;
             reversible: boolean;
             /** @enum {string|null} */
-            engine_op: "recommendations.apply" | "ads.pause" | "wiring.ad_sets" | "quality.utm_refresh" | "wiring.recheck" | "actions.rollback" | "quality.url_tags_apply" | "quality.url_tags_undo" | "send.setup" | "send.dataset" | "send.stage" | "send.stop" | "send.restore" | null;
+            engine_op: "recommendations.apply" | "ads.pause" | "campaigns.pause" | "campaigns.resume" | "wiring.ad_sets" | "quality.utm_refresh" | "wiring.recheck" | "actions.rollback" | "quality.url_tags_apply" | "quality.url_tags_undo" | "send.setup" | "send.dataset" | "send.stage" | "send.stop" | "send.restore" | null;
+            /** @description `campaign_pause` only: the line the sheet leads with — «Pausar «{campaign}» · detiene {n} anuncios · ~$X al día» (the count and the daily figure are dropped when unknown). */
+            summary?: string;
+            campaign?: components["schemas"]["AdsCampaignPauseSnapshot"];
         };
         AdsActionExecution: {
             /** Format: uuid */
             id: string;
             action_key: string;
             /** @enum {string} */
-            kind: "pause_ad" | "budget_change" | "adset_duplicate_swap" | "utm_refresh" | "wiring_recheck" | "url_tags_fix" | "send_setup" | "send_stage" | "send_dataset" | "send_stop";
+            kind: "pause_ad" | "campaign_pause" | "budget_change" | "adset_duplicate_swap" | "utm_refresh" | "wiring_recheck" | "url_tags_fix" | "send_setup" | "send_stage" | "send_dataset" | "send_stop";
             /** @enum {string} */
             status: "queued" | "running" | "succeeded" | "failed" | "refused" | "rolled_back";
             target: {
@@ -119637,7 +121550,7 @@ interface components {
                     name: string | null;
                 }[];
             };
-            /** @description What happened. `url_tags_fix` adds `partial` (true when fewer ads were corrected than asked — never show «Hecho» then), `corrected_count`, `requested_count` and `ads[]`: per ad `{external_id, name, result: corrected|skipped|failed, code, message, url_tags_after, engine_action_id, undo_available}` (an ad that already carried the parameters counts as corrected; it is undoable when this fix wrote it). Its undo (a rollback row) reports `undone_count`, `drifted_count` (changed in Meta since — never touched), `gone_count` (already undone elsewhere — no longer undoable from here), `reconnect_count` (Meta asks to reconnect), `retryable_count` (no answer or reconnect — the original stays undoable and the next rollback sends only those ads), `requested_count`, `partial` and `ads[]` `{external_id, name, result: undone|drifted|gone|retryable|reconnect, code, message}`; a failed or refused fix still carries `ads[]`. */
+            /** @description What happened. `url_tags_fix` adds `partial` (true when fewer ads were corrected than asked — never show «Hecho» then), `corrected_count`, `requested_count` and `ads[]`: per ad `{external_id, name, result: corrected|skipped|failed, code, message, url_tags_after, engine_action_id, undo_available}` (an ad that already carried the parameters counts as corrected; it is undoable when this fix wrote it). Its undo (a rollback row) reports `undone_count`, `drifted_count` (changed in Meta since — never touched), `gone_count` (already undone elsewhere — no longer undoable from here), `reconnect_count` (Meta asks to reconnect), `retryable_count` (no answer or reconnect — the original stays undoable and the next rollback sends only those ads), `requested_count`, `partial` and `ads[]` `{external_id, name, result: undone|drifted|gone|retryable|reconnect, code, message}`; a failed or refused fix still carries `ads[]`. `campaign_pause` (and its «Reanudar», a rollback row) adds `engine_outcome` (`applied` | `no_change` — already in that state, nothing written | `replayed`), `status`, `previous_status`, `campaign_name`, `affected_ads_count` (ads stopped, or freed by the resume; `null` when Meta gave no count) and `journal_line` («pausaste la campaña «X» · 4 anuncios» / «reanudaste …»; `null` on `no_change`). A «Reanudar» never brings back ads that were paused on their own. */
             outcome: {
                 summary: string;
                 engine_action_id: string | null;
@@ -119694,6 +121607,35 @@ interface components {
              */
             collector: "same_origin" | "cname" | "none" | null;
         };
+        /** @description The ad that opened the originating conversation — Vitrina’s own fact from the first message (a click-to-WhatsApp or Instagram / Messenger ad referral), known at once. Not a credit claim: `ad` is the credit. `null` when no ad opened the thread (or it was a boosted post). */
+        AdsFeedOrigin: {
+            /**
+             * @description Where the person wrote from the ad.
+             * @enum {string}
+             */
+            platform: "whatsapp" | "instagram" | "messenger";
+            /** @description The AD’s platform id (never a post id). */
+            external_id: string;
+            /** @description What to render: the ad’s name in the ad account, else its headline, else `null` («Mensaje por un anuncio de Instagram»). */
+            name: string | null;
+            /** @description The ad’s name in the ad account; `null` when unknown. */
+            ad_name: string | null;
+            /** @description The ad’s headline — the advertiser’s copy, never the customer’s words. */
+            headline: string | null;
+            /** @description The ad’s campaign, when the ads read knows it. */
+            campaign: {
+                /** @description The campaign’s platform id, when known. */
+                external_id: string | null;
+                name: string | null;
+            } | null;
+            /** @description Still image of the creative: Vitrina’s durable copy when `media_archived`, else the platform’s own link, which expires (render with a fallback). */
+            thumbnail_url: string | null;
+            media_archived: boolean;
+            /** @description When the person first wrote from the ad (ISO 8601). */
+            first_message_at: string | null;
+            /** @description `true` when the credited campaign (`ad.campaign`) is this ad’s campaign, `false` when the credit went to another campaign, `null` when unknown or not credited yet. */
+            matches_credit: boolean | null;
+        } | null;
         AdsFeedItem: {
             /** Format: uuid */
             id: string;
@@ -119706,7 +121648,7 @@ interface components {
             occurred_at: string;
             /** @description When Vitrina recorded it — the cursor field, microsecond-exact. */
             created_at: string;
-            /** @description The engine accepted the outcome as a conversion it can attribute. `true` with `ad: null` = «anuncio por confirmar». */
+            /** @description The engine accepted the outcome as a conversion it can attribute. Whether the credit can still arrive is `attribution`. */
             matched: boolean;
             /** @description CLP for money stages; `null` otherwise (never 0). */
             value: number | null;
@@ -119733,6 +121675,24 @@ interface components {
             } | null;
             credited_weight: number | null;
             touch_count: number | null;
+            /** @description Set when the contact was matched to the patient AUTOMATICALLY (an identifier held by exactly one patient and one contact) — show «Vinculado automáticamente» with the method. `null`/absent = a family bond, a booking link or the contact itself. Undo with `POST /clinic/auto-links/{id}/reject`. */
+            identity?: {
+                /** @enum {string} */
+                source: "auto_link";
+                /** @enum {string} */
+                method: "phone_unique" | "email_unique";
+            } | null;
+            origin: components["schemas"]["AdsFeedOrigin"];
+            /**
+             * @description Which source the row names its ad from: `engine` — `ad` (the credited campaign) is set; `conversation` — `ad` is `null` and `origin` is set: show the origin, never «anuncio por confirmar» (whether the credit may still come is `attribution`); `null` — neither is known.
+             * @enum {string|null}
+             */
+            origin_source: "engine" | "conversation" | null;
+            /**
+             * @description Whether the credit (`ad`) can still arrive: `credited` — `ad` is set; `pending` — not yet («atribución por confirmar» beside `origin`, else «anuncio por confirmar»); `final` — it never will: the contact was removed from attribution, the outcome is not one an ad can be credited with, or 72 hours after the outcome’s time a complete credit read still names no campaign. Show `origin` alone, or «sin anuncio» — never «por confirmar». A row is never settled while the credit read is incomplete (`meta.enrichment` not `ready`).
+             * @enum {string}
+             */
+            attribution: "credited" | "pending" | "final";
         };
         AdsJourneyStepAd: {
             /** @description The ad’s PLATFORM id; `null` when only the campaign is known. */
@@ -119751,7 +121711,7 @@ interface components {
             /** @description Stable key for the step. For a step recorded by Vitrina it is the feed item id (`GET /ads/feed` `data[].id`). */
             id: string;
             /**
-             * @description Touches: `ad` (an off-site ad touch — an ad click or a click-to-WhatsApp referral), `click` (a visit that landed from an ad click, or a tracked link click), `visit` (a site visit), `chat` (the first message, or a social interaction). Recorded steps, in funnel order: `chat` (first message), `booking`, `attended`, `quote`, `accepted` (a presupuesto accepted / a sale closed), `payment`; `outcome` for anything else.
+             * @description Touches: `ad` (an off-site ad touch — an ad click or a click-to-WhatsApp referral), `click` (a visit that landed from an ad click, or a tracked link click), `visit` (a site visit), `chat` (the first message, or a social interaction). «Mensaje por el anuncio X»: a `chat` step with `origin: vitrina`, `stage: null`, `id` = the conversation’s id and the ad on `ad`, at the moment the person first wrote from the ad — one per ad-opened conversation; the same ad is never also on the first-message fact, and the engine’s touch of that same referral (the ad’s, or a click-id-only one) is folded into it, credit mark included. Recorded steps, in funnel order: `chat` (first message), `booking`, `attended`, `quote`, `accepted` (a presupuesto accepted / a sale closed), `payment`; `outcome` for anything else.
              * @enum {string}
              */
             kind: "ad" | "click" | "visit" | "chat" | "outcome" | "booking" | "attended" | "quote" | "accepted" | "payment";
@@ -119775,7 +121735,7 @@ interface components {
             /** @description The touch the outcome was credited to, under `model`. */
             credited: boolean;
             /**
-             * @description How the touch is tied to this person, when proven: `ctwa_referral` (the click-to-WhatsApp / Instagram ad referral), `click_id` (the ad click id the outcome carried), `link_token` (a link Vitrina sent), `anonymous_id` (the same browser). `null` on recorded steps.
+             * @description How the touch is tied to this person, when proven: `ctwa_referral` (the click-to-WhatsApp / Instagram ad referral), `click_id` (the ad click id the outcome carried), `link_token` (a link Vitrina sent), `anonymous_id` (the same browser). `null` on recorded steps; `ctwa_referral` on the «Mensaje por el anuncio» step.
              * @enum {string|null}
              */
             join_method: "ctwa_referral" | "click_id" | "link_token" | "anonymous_id" | null;
@@ -119883,7 +121843,7 @@ declare function createClient(opts: CreateClientOptions): VitrinaClient;
  * is regenerated — narrow on the ones you handle, never assume this
  * list is exhaustive at runtime.
  */
-type ErrorCode = 'VALIDATION_ERROR' | 'NOT_FOUND' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'CONFLICT' | 'UNIQUE_CONFLICT' | 'IDEMPOTENCY_KEY_CONFLICT' | 'VERTICAL_NOT_ENABLED' | 'ENTITLEMENT_NOT_ACTIVE' | 'UNSUPPORTED_VEHICLE_TYPE' | 'NO_OFFERING_ADAPTER' | 'PAYLOAD_TOO_LARGE' | 'UNSUPPORTED_MEDIA_TYPE' | 'UPSTREAM_ERROR' | 'RATE_LIMITED' | 'GONE' | 'INTERNAL_ERROR' | 'MESSAGING_ACCOUNT_TENANT_MISSING' | 'COPILOT_APPROVALS_UNAVAILABLE' | 'COPILOT_APPROVAL_REPLAY_BLOCKED' | 'COPILOT_DISABLED' | 'COPILOT_BUDGET_EXCEEDED' | 'DEALER_SITES_NOT_CONFIGURED' | 'STOREFRONT_ZONES_NOT_CONFIGURED' | 'RECONTACTO_NOT_ENABLED' | 'SYNC_QUEUE_UNAVAILABLE' | 'SHARE_IMAGE_UNAVAILABLE' | 'ATTRIBUTION_PROFILE_UNAVAILABLE' | 'DOCUMENT_LOGO_UNAVAILABLE' | 'ATTRIBUTION_PROFILE_MISMATCH' | 'ADS_KEY_NEEDS_REMINT' | 'ADS_ACTION_REPLAY_BLOCKED' | 'ADS_ACTION_NOT_AVAILABLE' | 'ADS_ACTION_NOT_REVERSIBLE' | 'ADS_ACTION_CONSENT_REQUIRED' | 'MISSING_SIGNATURE' | 'MALFORMED_SIGNATURE' | 'STALE_SIGNATURE' | 'INVALID_SIGNATURE' | 'REPLAY_DETECTED' | 'TURNSTILE_UNAVAILABLE' | 'TASADOR_QUOTA_EXHAUSTED' | 'TASADOR_ANON_DAILY_LIMIT' | 'TASADOR_CAPACITY_REACHED' | 'CLINIC_PLAN_REQUIRED' | 'TENANT_BILLING_PAUSED' | 'FACEBOOK_MARKETPLACE_NOT_AVAILABLE' | 'WORKSPACE_MEMBER_INACTIVE' | 'DEVICE_AGENT_ALREADY_PAIRED' | 'DEVICE_AGENT_SELF_REQUIRES_USER' | 'DEVICE_AGENT_KIND_NOT_ALLOWED' | 'DEVICE_TASK_STATUS_NOT_ALLOWED' | 'FACEBOOK_MARKETPLACE_NO_PHONE_AGENT' | 'FACEBOOK_MARKETPLACE_THREAD_NOT_ADDRESSABLE' | 'FACEBOOK_MARKETPLACE_ATTACHMENT_UNSUPPORTED' | 'REPLY_PACING_LOCKED' | 'SANDBOX_CHANNEL_FORBIDDEN' | 'SANDBOX_BILLING_FORBIDDEN' | 'SANDBOX_NOT_PROVISIONED' | 'SANDBOX_RESET_UNAVAILABLE' | 'CONNECTED_APP_SENSITIVE_DATA' | 'handoff_mismatch' | 'sync_in_flight' | 'atribu_refused' | 'start_again' | 'reconnect' | 'partner_token_invalid' | 'OUTBOUND_BLOCKED' | 'OUTBOUND_WARNING' | 'dpa_acceptance_required' | 'EMAIL_SENDER_UNRESOLVED' | 'CAMPAIGN_FROM_CONNECTED_MAILBOX' | 'BANK_FEED_NOT_CONFIGURED' | 'ADDON_NOT_PRICED' | 'MIRROR_LINES_UNMAPPED';
+type ErrorCode = 'VALIDATION_ERROR' | 'NOT_FOUND' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'CONFLICT' | 'UNIQUE_CONFLICT' | 'IDEMPOTENCY_KEY_CONFLICT' | 'VERTICAL_NOT_ENABLED' | 'ENTITLEMENT_NOT_ACTIVE' | 'UNSUPPORTED_VEHICLE_TYPE' | 'NO_OFFERING_ADAPTER' | 'PAYLOAD_TOO_LARGE' | 'UNSUPPORTED_MEDIA_TYPE' | 'UPSTREAM_ERROR' | 'RATE_LIMITED' | 'GONE' | 'INTERNAL_ERROR' | 'MESSAGING_ACCOUNT_TENANT_MISSING' | 'COPILOT_APPROVALS_UNAVAILABLE' | 'COPILOT_APPROVAL_REPLAY_BLOCKED' | 'COPILOT_DISABLED' | 'COPILOT_BUDGET_EXCEEDED' | 'DEALER_SITES_NOT_CONFIGURED' | 'STOREFRONT_ZONES_NOT_CONFIGURED' | 'RECONTACTO_NOT_ENABLED' | 'SYNC_QUEUE_UNAVAILABLE' | 'SHARE_IMAGE_UNAVAILABLE' | 'ATTRIBUTION_PROFILE_UNAVAILABLE' | 'DOCUMENT_LOGO_UNAVAILABLE' | 'ATTRIBUTION_PROFILE_MISMATCH' | 'ADS_KEY_NEEDS_REMINT' | 'ADS_ACTION_READ_UNAVAILABLE' | 'ADS_ACTION_REPLAY_BLOCKED' | 'ADS_ACTION_NOT_AVAILABLE' | 'ADS_ACTION_NOT_REVERSIBLE' | 'ADS_ACTION_CONSENT_REQUIRED' | 'MISSING_SIGNATURE' | 'MALFORMED_SIGNATURE' | 'STALE_SIGNATURE' | 'INVALID_SIGNATURE' | 'REPLAY_DETECTED' | 'TURNSTILE_UNAVAILABLE' | 'TASADOR_QUOTA_EXHAUSTED' | 'TASADOR_ANON_DAILY_LIMIT' | 'TASADOR_CAPACITY_REACHED' | 'CLINIC_PLAN_REQUIRED' | 'TENANT_BILLING_PAUSED' | 'FACEBOOK_MARKETPLACE_NOT_AVAILABLE' | 'WORKSPACE_MEMBER_INACTIVE' | 'DEVICE_AGENT_ALREADY_PAIRED' | 'DEVICE_AGENT_SELF_REQUIRES_USER' | 'DEVICE_AGENT_KIND_NOT_ALLOWED' | 'DEVICE_TASK_STATUS_NOT_ALLOWED' | 'FACEBOOK_MARKETPLACE_NO_PHONE_AGENT' | 'FACEBOOK_MARKETPLACE_THREAD_NOT_ADDRESSABLE' | 'FACEBOOK_MARKETPLACE_ATTACHMENT_UNSUPPORTED' | 'REPLY_PACING_LOCKED' | 'SANDBOX_CHANNEL_FORBIDDEN' | 'SANDBOX_BILLING_FORBIDDEN' | 'SANDBOX_NOT_PROVISIONED' | 'SANDBOX_RESET_UNAVAILABLE' | 'CONNECTED_APP_SENSITIVE_DATA' | 'handoff_mismatch' | 'sync_in_flight' | 'disconnect_refused' | 'start_again' | 'reconnect' | 'not_selecting' | 'selection_expired' | 'selection_conflict' | 'account_connected_elsewhere' | 'candidate_unavailable' | 'integration_managed' | 'partner_token_invalid' | 'OUTBOUND_BLOCKED' | 'OUTBOUND_WARNING' | 'dpa_acceptance_required' | 'EMAIL_SENDER_UNRESOLVED' | 'CAMPAIGN_FROM_CONNECTED_MAILBOX' | 'BANK_FEED_NOT_CONFIGURED' | 'ADDON_NOT_PRICED' | 'MIRROR_LINES_UNMAPPED';
 declare const ERROR_CODES: readonly ErrorCode[];
 
 /**