@vitrina/api 11.42.0 → 11.43.0

package/dist/index.d.cts

@@ -16350,7 +16350,7 @@ interface paths {
         };
         /**
          * A vehicle's change history (Historial)
-         * @description Reverse-chronological audit trail for this vehicle — created, field edits (with a before→after diff), publish/unpublish/cierre, and Override local protect/release — with teammate actors resolved to display names. The UI merges it with /activity (leads) into one "Leads y cambios" timeline.
+         * @description Reverse-chronological audit trail for this vehicle — created, field edits (with a before→after diff), publish/unpublish/cierre, and Override local protect/release — with teammate actors resolved to display names. It also carries the deal's milestones, read from each document's own audit rows: nota de compra emitted/voided (`purchase_note_issued`, `purchase_note_voided`), nota de venta emitted/approved/voided (`sale_note_issued`, `sale_note_approved`, `sale_note_voided`), contrato de compraventa first printed (`compraventa_printed`), mandato de consignación first printed (`mandato_issued`), a signed copy filed (`signed_copy_filed`, with `metadata.signed_document_type`) and the liquidación paid to the consignor (`liquidacion_paid`). `metadata.folio` names the document when it has one. Each document type appears only for a caller holding its read scope (`purchase_notes:read`, `sale_notes:read`, `consignments:read`; signed copies also need `vehicle_registry:read`). A download of the Resumen del negocio is `deal_settlement_downloaded`. The UI merges it with /activity (leads) into one "Leads y cambios" timeline.
          */
         get: {
             parameters: {
@@ -16375,6 +16375,22 @@ interface paths {
                          * @example {
                          *       "data": [
                          *         {
+                         *           "id": "99999999-0000-4000-8000-000000000005",
+                         *           "action": "sale_notes.approve",
+                         *           "kind": "sale_note_approved",
+                         *           "actor": {
+                         *             "kind": "user",
+                         *             "id": "11111111-0000-4000-8000-000000000001",
+                         *             "name": "Ana Torres"
+                         *           },
+                         *           "changes": [],
+                         *           "metadata": {
+                         *             "folio": "V-13",
+                         *             "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001"
+                         *           },
+                         *           "at": "2026-09-18T15:02:11.000Z"
+                         *         },
+                         *         {
                          *           "id": "99999999-0000-4000-8000-000000000003",
                          *           "action": "vehicles.create",
                          *           "kind": "created",
@@ -33834,7 +33850,7 @@ interface paths {
         };
         /**
          * Print the nota de compra
-         * @description The nota de compra as a printable PDF (`application/pdf`, served `inline`) on the dealership’s paper: folio, seller, vehicle, lines and totals. Rendered on demand and not stored. Any status prints; a voided note says «Anulada». Accepts the UUID or the folio (`P-47`). Requires `purchase_notes:read`.
+         * @description The nota de compra as a printable PDF (`application/pdf`, served `inline`) on the dealership’s paper, drawn from the workspace’s default nota de compra template (the standard text when there is none): folio, the seller and the dealership with RUT and domicilio, the vehicle, the price with its retentions and the amount paid to the seller, detail lines and signatures. A fact the seller’s contact lacks prints «【PENDIENTE: …】» rather than refusing the print. Rendered on demand and not stored. Any status prints; a voided note says «Anulada». Accepts the UUID or the folio (`P-47`). Requires `purchase_notes:read`.
          */
         get: {
             parameters: {
@@ -34420,7 +34436,7 @@ interface paths {
         };
         /**
          * Placeholder values of the latest issued document of a template's type
-         * @description What the template preview renders against: the `{{NAME}}` values of the most recent documento emitido of the template's document type, built by the SAME code that prints that document, so the preview cannot drift from the print. Covers `sale_note`, `compraventa`, `deal_settlement` (Resumen del negocio), `consignment` (mandato) and `consignment_settlement` (liquidación); nota de compra, reserva, cotización and ficha técnica print fixed layouts and have no values source. `source` names the document (`display_id`: the folio such as `V-12`, or the patente for a consignment, and when it was issued); it is `null` — with an empty `values` — when none exists or the type has no values source; the caller then falls back to the vocabulary examples. A fact the document lacks is absent from `values`, never blank. The values carry buyer/owner identity and money, so this requires `document_templates:read` AND the read scope of that document (`sale_notes:read` for nota de venta and compraventa, `consignments:read` for the two consignment families, `dealership_economics:read` for the Resumen del negocio). Writes and issues nothing.
+         * @description What the template preview renders against: the `{{NAME}}` values of the most recent documento emitido of the template's document type, built by the SAME code that prints that document, so the preview cannot drift from the print. Covers `sale_note`, `compraventa`, `deal_settlement` (Resumen del negocio), `consignment` (mandato), `consignment_settlement` (liquidación) and `purchase_note` (nota de compra); reserva, cotización and ficha técnica print fixed layouts and have no values source. The designed blocks (`BLOQUE_PARTES`, `BLOQUE_VEHICULO`, `BLOQUE_PRECIO`, `BLOQUE_FIRMAS`) are values too: each is the block's text form filled with the same document's values (a fact the document lacks reads «【PENDIENTE: …】»). `source` names the document (`display_id`: the folio such as `V-12`, or the patente for a consignment, and when it was issued); it is `null` — with an empty `values` — when none exists or the type has no values source; the caller then falls back to the vocabulary examples. A fact the document lacks is absent from `values`, never blank. The values carry buyer/owner identity and money, so this requires `document_templates:read` AND the read scope of that document (`sale_notes:read` for nota de venta and compraventa, `consignments:read` for the two consignment families, `dealership_economics:read` for the Resumen del negocio, `purchase_notes:read` for the nota de compra). Writes and issues nothing.
          */
         get: {
             parameters: {
@@ -39637,6 +39653,205 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/margin/preview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Preview the margin of a nota de venta being written
+         * @description The margin a nota de venta WOULD leave if the unit sold today at `net_clp` — what the nota de venta form shows while the price is typed. The same preview the Resumen del negocio serves for a car with no live nota de venta (`GET /vehicles/{id}/deal-settlement`, `state: preview`), at the typed price instead of the published one: no add-ons, no seller commissions, and the one margin definition. The body is the deal-margin DTO of `GET /margin/deals/{id}` without `sale_note_id`, `display_id` and `salesperson_id` — no document exists yet.
+         *
+         *     **A consigned unit is previewed on its contract’s economics**: the split is projected from the active contract’s comisión exactly as the liquidación will compute it (`settlement` carries the projection), so the dealership’s revenue is the comisión, never the whole price. A contract with no comisión on file has no split to project: its revenue is `null` with a `liquidacion` gap.
+         *
+         *     `net_clp` is NET of IVA (cifras del negocio, ADR 0114 §2.2). The price a buyer agrees to on an afecto sale includes IVA, like the published price: send `round(price / 1,19)`. Writes nothing. Requires `dealership_economics:read`; 404 for a unit outside the workspace.
+         */
+        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 {
+                     *       "vehicle_id": "e5e5e5e5-0000-4000-8000-000000000002",
+                     *       "net_clp": 10000000
+                     *     }
+                     */
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description The unit being sold.
+                         * @example 4b1c2d3e-5f60-4a7b-8c9d-0e1f2a3b4c5d
+                         */
+                        vehicle_id: string;
+                        /**
+                         * @description The sale price the nota de venta would record, NET of IVA, in whole CLP pesos. On an afecto sale that is the price the buyer pays divided by 1,19 (rounded); on an exento sale it is the price.
+                         * @example 10084034
+                         */
+                        net_clp: number;
+                        /**
+                         * @description The leg the sale would be issued under. Omitted = the leg the unit’s tenencia suggests (`consignante` for a consigned unit, `automotora` otherwise).
+                         * @enum {string}
+                         */
+                        seller_of_record?: "consignante" | "retoma" | "automotora";
+                    };
+                };
+            };
+            responses: {
+                /** @description The previewed deal margin */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "vehicle_id": "e5e5e5e5-0000-4000-8000-000000000002",
+                         *         "issued_at": "2026-09-29T15:00:00.000Z",
+                         *         "period": "2026-09",
+                         *         "regime": "consignacion",
+                         *         "ingresos_clp": 800000,
+                         *         "revenue_terms": {
+                         *           "precio_venta_clp": 10000000,
+                         *           "add_on_charges_clp": 0,
+                         *           "pass_through_clp": 0,
+                         *           "pass_through_paid_out_clp": 0,
+                         *           "dealer_take_clp": 800000
+                         *         },
+                         *         "costo_venta_clp": 0,
+                         *         "margen_bruto_clp": 800000,
+                         *         "deductions": {
+                         *           "comisiones_vendedores_clp": 0,
+                         *           "gastos_adicionales_clp": 120000,
+                         *           "gastos_unidad_clp": 120000,
+                         *           "ingresos_unidad_clp": 0,
+                         *           "desembolsos_add_on_clp": 0,
+                         *           "gastos_fijos_clp": null
+                         *         },
+                         *         "margen_neto_clp": 680000,
+                         *         "settlement": {
+                         *           "settlement_mode": "stated_commission",
+                         *           "amount_venta_clp": 10000000,
+                         *           "monto_owner_clp": 9200000,
+                         *           "deducciones_clp": 0
+                         *         },
+                         *         "cost_rollup": {
+                         *           "acquisition_net_clp": 0,
+                         *           "expense_total_clp": 120000,
+                         *           "income_total_clp": 0,
+                         *           "total_cost_clp": 120000,
+                         *           "dealership_cost_clp": 120000,
+                         *           "by_party": {
+                         *             "automotora": {
+                         *               "acquisition_clp": 0,
+                         *               "expense_clp": 120000,
+                         *               "income_clp": 0,
+                         *               "total_clp": 120000
+                         *             },
+                         *             "dueno": {
+                         *               "acquisition_clp": 0,
+                         *               "expense_clp": 0,
+                         *               "income_clp": 0,
+                         *               "total_clp": 0
+                         *             },
+                         *             "cliente": {
+                         *               "acquisition_clp": 0,
+                         *               "expense_clp": 0,
+                         *               "income_clp": 0,
+                         *               "total_clp": 0
+                         *             }
+                         *           },
+                         *           "entry_count": 2,
+                         *           "complete": true,
+                         *           "gaps": []
+                         *         },
+                         *         "complete": true,
+                         *         "gaps": []
+                         *       }
+                         *     }
+                         */
+                        "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;
+    };
     "/margin/export": {
         parameters: {
             query?: never;
@@ -71823,6 +72038,263 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/clinic/insights/resultados": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * «Tu agenda con Vitrina»: what the AI did for the diary
+         * @description One canonical read of what Vitrina's agent did for the clinic's agenda, aggregates only (never a patient, cita or conversation id). A cita is «agendada por Vitrina» when the agent booked it in a conversation (`source = 'agent'` and no public booking page); the window is on the day the cita HAPPENS (`starts_at`), blocks and holds out. Blocks: `bookings` (count and share of the agenda, with the previous period of the same length); `money` (the value of those citas — pipeline — and the CASH their patients paid in the period from the day Vitrina booked them, read from the revenue mirror when it is on, else from the native ledger; `null` with `withheld: true` for a caller without `clinic_money:read`); `out_of_hours` (bookings made while the workspace was closed per its business hours, plus a weekday × hour heatmap; `null` when no hours are configured); `autonomy` (bookings with no team message in the conversation, from the patient's first message of the 7 days before); `time_to_book` (median and p95, first patient message → booking); `hours_returned` (AI bookings × 10 minutes, a stated rule); `recovery` (no-shows over known attendance, and no-shows / cancellations the same patient booked again within 30 days, with how many of those Vitrina booked); `confirmation` (attendance of confirmed vs unconfirmed citas, the `confirmaciones` report's own figures); `ads` (cost per cita agendada / asistida / paciente que pagó = the Ads overview's spend ÷ its counts for the same dates; `not_active` without Vitrina Ads); `reminders` (reminders that did not go out, by cause). Every block carries a printable `rule`; every rate is `null` — never 0 — without a denominator, and measured figures carry `measured` / `unknown` counts. Requires `clinic:read`. Accepts `from` / `to` (bare `YYYY-MM-DD`, `to` inclusive; default the 90 days ending today in the clinic's zone) and `location_id`.
+         *
+         *     **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 (by the day the cita happens), 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;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Tu agenda con Vitrina */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "from": "2026-07-01",
+                         *         "to": "2026-09-28",
+                         *         "timezone": "America/Santiago",
+                         *         "location_id": null,
+                         *         "family": "clinic",
+                         *         "previous_period": {
+                         *           "from": "2026-04-02",
+                         *           "to": "2026-06-30"
+                         *         },
+                         *         "bookings": {
+                         *           "ai": 286,
+                         *           "agenda_total": 2011,
+                         *           "share_pct": 14.2,
+                         *           "previous": {
+                         *             "ai": 240,
+                         *             "agenda_total": 1950,
+                         *             "share_pct": 12.3
+                         *           },
+                         *           "rule": "Citas del período (por la fecha de la cita) que agendó el asistente de Vitrina en una conversación, ÷ todas las citas del período."
+                         *         },
+                         *         "money": {
+                         *           "applies": true,
+                         *           "withheld": false,
+                         *           "booked_clp": 11400000,
+                         *           "booked_priced": 271,
+                         *           "booked_unpriced": 15,
+                         *           "agenda_clp": 96000000,
+                         *           "clp_share_pct": 11.9,
+                         *           "paid_clp": 7250000,
+                         *           "paid_patients": 164,
+                         *           "unlinked": 4,
+                         *           "regime": "mirror",
+                         *           "previous": {
+                         *             "booked_clp": 9800000,
+                         *             "paid_clp": 6100000
+                         *           },
+                         *           "rule_booked": "Valor de las citas que agendó Vitrina: el precio de sus prestaciones, o el del catálogo. Es lo agendado, no lo cobrado.",
+                         *           "rule_paid": "Pagos recibidos en el período por los pacientes que Vitrina agendó, desde el día en que los agendó."
+                         *         },
+                         *         "out_of_hours": {
+                         *           "configured": true,
+                         *           "count": 111,
+                         *           "pct": 38.8,
+                         *           "previous_pct": 36.1,
+                         *           "heatmap": [
+                         *             {
+                         *               "weekday": 1,
+                         *               "hour": 21,
+                         *               "count": 9
+                         *             },
+                         *             {
+                         *               "weekday": 6,
+                         *               "hour": 11,
+                         *               "count": 14
+                         *             }
+                         *           ],
+                         *           "rule": "Citas que Vitrina agendó mientras tu negocio estaba cerrado, según tu horario de atención (incluye feriados)."
+                         *         },
+                         *         "autonomy": {
+                         *           "no_human": 158,
+                         *           "pct": 56.6,
+                         *           "measured": 279,
+                         *           "unknown": 7,
+                         *           "previous_pct": 52,
+                         *           "rule": "Citas de Vitrina en las que nadie de tu equipo escribió en la conversación antes de agendar."
+                         *         },
+                         *         "time_to_book": {
+                         *           "median_seconds": 734,
+                         *           "p95_seconds": 80100,
+                         *           "p95_phrase": "5 de cada 100 personas tardan más de 22 h 15 min en quedar agendadas.",
+                         *           "measured": 279,
+                         *           "unknown": 7,
+                         *           "previous_median_seconds": 910,
+                         *           "rule": "Tiempo desde el primer mensaje del paciente hasta que su cita quedó agendada (la mediana)."
+                         *         },
+                         *         "hours_returned": {
+                         *           "minutes_per_booking": 10,
+                         *           "hours": 47.7,
+                         *           "rule": "Cada cita que agenda Vitrina ahorra 10 minutos de responder y agendar a mano."
+                         *         },
+                         *         "recovery": {
+                         *           "window_days": 30,
+                         *           "known_attendance": 1063,
+                         *           "unknown_attendance": 21,
+                         *           "no_show_pct": 10.2,
+                         *           "no_show": {
+                         *             "count": 108,
+                         *             "recovered": 37,
+                         *             "recovered_via_vitrina": 17,
+                         *             "recovered_pct": 34.6,
+                         *             "via_vitrina_pct": 15.9,
+                         *             "pending": 12,
+                         *             "unlinked": 1
+                         *           },
+                         *           "cancelled": {
+                         *             "count": 240,
+                         *             "recovered": 26,
+                         *             "recovered_via_vitrina": 11,
+                         *             "recovered_pct": 10.8,
+                         *             "via_vitrina_pct": 4.6,
+                         *             "pending": 18,
+                         *             "unlinked": 0
+                         *           },
+                         *           "rule_no_show": "Citas pasadas marcadas como «no asistió» ÷ citas con asistencia conocida (asistió + no asistió).",
+                         *           "rule_recovered": "Una cita perdida se recupera cuando el mismo paciente agenda otra dentro de 30 días."
+                         *         },
+                         *         "confirmation": {
+                         *           "applies": true,
+                         *           "confirmed_attendance_pct": 93.1,
+                         *           "unconfirmed_attendance_pct": 78.4,
+                         *           "confirmed_closed": 610,
+                         *           "unconfirmed_closed": 212,
+                         *           "rule": "Asistencia de las citas cuyo paciente confirmó el recordatorio, frente a las que nunca respondieron."
+                         *         },
+                         *         "ads": {
+                         *           "state": "active",
+                         *           "spend_clp": 1648000,
+                         *           "booked": 58,
+                         *           "attended": 41,
+                         *           "paid": 22,
+                         *           "cost_per_booked": 28414,
+                         *           "cost_per_attended": 40195,
+                         *           "cost_per_paid": 74909,
+                         *           "rule": "Inversión en anuncios del período ÷ citas agendadas, asistidas y pacientes que pagaron por primera vez, según Vitrina Ads para las mismas fechas."
+                         *         },
+                         *         "reminders": {
+                         *           "applies": true,
+                         *           "sent": 721,
+                         *           "failed": 120,
+                         *           "failed_pct": 14.3,
+                         *           "by_cause": [
+                         *             {
+                         *               "cause": "no_whatsapp",
+                         *               "count": 61
+                         *             },
+                         *             {
+                         *               "cause": "no_phone",
+                         *               "count": 38
+                         *             },
+                         *             {
+                         *               "cause": "meta_payment_block",
+                         *               "count": 21
+                         *             }
+                         *           ],
+                         *           "rule": "Recordatorios de citas del período que no salieron, agrupados por la causa que registró el envío."
+                         *         },
+                         *         "truncated": false
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["AgendaResults"];
+                        };
+                    };
+                };
+                /** @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/insights/comercial": {
         parameters: {
             query?: never;
@@ -78644,6 +79116,7 @@ interface paths {
                     active?: boolean | null;
                     filtered?: boolean | null;
                     aiReplied?: boolean | null;
+                    fromAd?: boolean | null;
                     sort?: "created_at" | "updated_at" | "last_message_date";
                     order?: "asc" | "desc";
                     include?: "counts";
@@ -92819,7 +93292,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/overview/live": {
+    "/insights/resultados": {
         parameters: {
             query?: never;
             header?: never;
@@ -92827,19 +93300,26 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Current live activity
-         * @description A now-snapshot: open conversations, who is waiting, what is in flight. The one report that takes NO range — it describes the present, so `from`/`to` would mean nothing and are not accepted.
+         * What the AI did for the agenda (any vertical)
+         * @description The same facts as `GET /clinic/insights/resultados`, for any vertical, with the vertical's vocabulary (`family`: a dealer reads visits and test drives, `clientes`). Blocks with no data for the vertical come back `applies: false` (money, confirmation, reminders for a dealer) rather than as zeros. Aggregates only. Requires `analytics:read`; CLP figures additionally require `clinic_money:read`. Accepts `from` / `to` (bare `YYYY-MM-DD`, `to` inclusive; default the 90 days ending today) and `location_id`.
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    /** @description First day of the window (by the day the cita happens), 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;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Live activity snapshot */
+                /** @description Tu día con Vitrina */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -92848,28 +93328,158 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "open": 14,
-                         *         "unattended": 0,
-                         *         "unassigned": 1,
-                         *         "pending": 0,
-                         *         "agents_online": 1,
-                         *         "agents_busy": 0,
-                         *         "agents_offline": 4
-                         *       },
-                         *       "meta": {
-                         *         "window": {
-                         *           "kind": "instant",
-                         *           "at": "2026-09-22T16:38:43.071Z",
-                         *           "label": "ahora"
-                         *         }
+                         *         "from": "2026-07-01",
+                         *         "to": "2026-09-28",
+                         *         "timezone": "America/Santiago",
+                         *         "location_id": null,
+                         *         "family": "clinic",
+                         *         "previous_period": {
+                         *           "from": "2026-04-02",
+                         *           "to": "2026-06-30"
+                         *         },
+                         *         "bookings": {
+                         *           "ai": 286,
+                         *           "agenda_total": 2011,
+                         *           "share_pct": 14.2,
+                         *           "previous": {
+                         *             "ai": 240,
+                         *             "agenda_total": 1950,
+                         *             "share_pct": 12.3
+                         *           },
+                         *           "rule": "Citas del período (por la fecha de la cita) que agendó el asistente de Vitrina en una conversación, ÷ todas las citas del período."
+                         *         },
+                         *         "money": {
+                         *           "applies": true,
+                         *           "withheld": false,
+                         *           "booked_clp": 11400000,
+                         *           "booked_priced": 271,
+                         *           "booked_unpriced": 15,
+                         *           "agenda_clp": 96000000,
+                         *           "clp_share_pct": 11.9,
+                         *           "paid_clp": 7250000,
+                         *           "paid_patients": 164,
+                         *           "unlinked": 4,
+                         *           "regime": "mirror",
+                         *           "previous": {
+                         *             "booked_clp": 9800000,
+                         *             "paid_clp": 6100000
+                         *           },
+                         *           "rule_booked": "Valor de las citas que agendó Vitrina: el precio de sus prestaciones, o el del catálogo. Es lo agendado, no lo cobrado.",
+                         *           "rule_paid": "Pagos recibidos en el período por los pacientes que Vitrina agendó, desde el día en que los agendó."
+                         *         },
+                         *         "out_of_hours": {
+                         *           "configured": true,
+                         *           "count": 111,
+                         *           "pct": 38.8,
+                         *           "previous_pct": 36.1,
+                         *           "heatmap": [
+                         *             {
+                         *               "weekday": 1,
+                         *               "hour": 21,
+                         *               "count": 9
+                         *             },
+                         *             {
+                         *               "weekday": 6,
+                         *               "hour": 11,
+                         *               "count": 14
+                         *             }
+                         *           ],
+                         *           "rule": "Citas que Vitrina agendó mientras tu negocio estaba cerrado, según tu horario de atención (incluye feriados)."
+                         *         },
+                         *         "autonomy": {
+                         *           "no_human": 158,
+                         *           "pct": 56.6,
+                         *           "measured": 279,
+                         *           "unknown": 7,
+                         *           "previous_pct": 52,
+                         *           "rule": "Citas de Vitrina en las que nadie de tu equipo escribió en la conversación antes de agendar."
+                         *         },
+                         *         "time_to_book": {
+                         *           "median_seconds": 734,
+                         *           "p95_seconds": 80100,
+                         *           "p95_phrase": "5 de cada 100 personas tardan más de 22 h 15 min en quedar agendadas.",
+                         *           "measured": 279,
+                         *           "unknown": 7,
+                         *           "previous_median_seconds": 910,
+                         *           "rule": "Tiempo desde el primer mensaje del paciente hasta que su cita quedó agendada (la mediana)."
+                         *         },
+                         *         "hours_returned": {
+                         *           "minutes_per_booking": 10,
+                         *           "hours": 47.7,
+                         *           "rule": "Cada cita que agenda Vitrina ahorra 10 minutos de responder y agendar a mano."
+                         *         },
+                         *         "recovery": {
+                         *           "window_days": 30,
+                         *           "known_attendance": 1063,
+                         *           "unknown_attendance": 21,
+                         *           "no_show_pct": 10.2,
+                         *           "no_show": {
+                         *             "count": 108,
+                         *             "recovered": 37,
+                         *             "recovered_via_vitrina": 17,
+                         *             "recovered_pct": 34.6,
+                         *             "via_vitrina_pct": 15.9,
+                         *             "pending": 12,
+                         *             "unlinked": 1
+                         *           },
+                         *           "cancelled": {
+                         *             "count": 240,
+                         *             "recovered": 26,
+                         *             "recovered_via_vitrina": 11,
+                         *             "recovered_pct": 10.8,
+                         *             "via_vitrina_pct": 4.6,
+                         *             "pending": 18,
+                         *             "unlinked": 0
+                         *           },
+                         *           "rule_no_show": "Citas pasadas marcadas como «no asistió» ÷ citas con asistencia conocida (asistió + no asistió).",
+                         *           "rule_recovered": "Una cita perdida se recupera cuando el mismo paciente agenda otra dentro de 30 días."
+                         *         },
+                         *         "confirmation": {
+                         *           "applies": true,
+                         *           "confirmed_attendance_pct": 93.1,
+                         *           "unconfirmed_attendance_pct": 78.4,
+                         *           "confirmed_closed": 610,
+                         *           "unconfirmed_closed": 212,
+                         *           "rule": "Asistencia de las citas cuyo paciente confirmó el recordatorio, frente a las que nunca respondieron."
+                         *         },
+                         *         "ads": {
+                         *           "state": "active",
+                         *           "spend_clp": 1648000,
+                         *           "booked": 58,
+                         *           "attended": 41,
+                         *           "paid": 22,
+                         *           "cost_per_booked": 28414,
+                         *           "cost_per_attended": 40195,
+                         *           "cost_per_paid": 74909,
+                         *           "rule": "Inversión en anuncios del período ÷ citas agendadas, asistidas y pacientes que pagaron por primera vez, según Vitrina Ads para las mismas fechas."
+                         *         },
+                         *         "reminders": {
+                         *           "applies": true,
+                         *           "sent": 721,
+                         *           "failed": 120,
+                         *           "failed_pct": 14.3,
+                         *           "by_cause": [
+                         *             {
+                         *               "cause": "no_whatsapp",
+                         *               "count": 61
+                         *             },
+                         *             {
+                         *               "cause": "no_phone",
+                         *               "count": 38
+                         *             },
+                         *             {
+                         *               "cause": "meta_payment_block",
+                         *               "count": 21
+                         *             }
+                         *           ],
+                         *           "rule": "Recordatorios de citas del período que no salieron, agrupados por la causa que registró el envío."
+                         *         },
+                         *         "truncated": false
                          *       }
                          *     }
                          */
                         "application/json": {
-                            data?: unknown;
-                            meta?: {
-                                [key: string]: unknown;
-                            };
+                            data: components["schemas"]["AgendaResults"];
                         };
                     };
                 };
@@ -92937,7 +93547,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/overview/heatmap": {
+    "/insights/overview/live": {
         parameters: {
             query?: never;
             header?: never;
@@ -92945,32 +93555,19 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Activity heatmap by day and hour
-         * @description The only report that accepts `tz`. Pass the viewer’s IANA zone (`America/Santiago`) and the day/hour buckets follow their wall clock; omit it and the grid is UTC, which shifts a Chilean workspace’s busy hours by three or four columns depending on DST. The name is validated by Postgres, so an unknown zone is a 500 rather than a 400.
+         * Current live activity
+         * @description A now-snapshot: open conversations, who is waiting, what is in flight. The one report that takes NO range — it describes the present, so `from`/`to` would mean nothing and are not accepted.
          */
         get: {
             parameters: {
-                query?: {
-                    /** @description Which period. Omit it (with `from`/`to`) for an explicit range — the shape every ranged Insights report has always accepted, and which still works unchanged. The calendar windows are the DEALERSHIP’s (America/Santiago), so a month closes when a person would say it closed. */
-                    window?: "24h" | "7d" | "30d" | "90d" | "calendar_month" | "calendar_year" | "custom";
-                    /** @description `window=calendar_month` only. ISO month, `YYYY-MM`. Defaults to the month in progress. */
-                    month?: string;
-                    /** @description `window=calendar_year` only. `YYYY`. Defaults to the year in progress. */
-                    year?: string;
-                    /** @description Explicit range only. Checked for non-emptiness and handed to Postgres, so a malformed value surfaces as a 500 from the query rather than a 400 from the edge — send an ISO-8601 instant. */
-                    from?: string;
-                    /** @description Explicit range only. ISO instant, see `from`. */
-                    to?: string;
-                    /** @description IANA timezone for the date/hour buckets. Defaults to UTC. */
-                    tz?: string;
-                };
+                query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Day/hour activity buckets */
+                /** @description Live activity snapshot */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -92979,27 +93576,19 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "buckets": [
-                         *           {
-                         *             "day": 1,
-                         *             "hour": 10,
-                         *             "conversations": 3
-                         *           },
-                         *           {
-                         *             "day": 1,
-                         *             "hour": 11,
-                         *             "conversations": 5
-                         *           }
-                         *         ]
+                         *         "open": 14,
+                         *         "unattended": 0,
+                         *         "unassigned": 1,
+                         *         "pending": 0,
+                         *         "agents_online": 1,
+                         *         "agents_busy": 0,
+                         *         "agents_offline": 4
                          *       },
                          *       "meta": {
                          *         "window": {
-                         *           "kind": "rolling",
-                         *           "preset": "7d",
-                         *           "hours": 168,
-                         *           "from": "2026-09-15T16:38:51.000Z",
-                         *           "to": "2026-09-22T16:38:51.000Z",
-                         *           "label": "últimos 7d"
+                         *           "kind": "instant",
+                         *           "at": "2026-09-22T16:38:43.071Z",
+                         *           "label": "ahora"
                          *         }
                          *       }
                          *     }
@@ -93076,7 +93665,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/calls": {
+    "/insights/overview/heatmap": {
         parameters: {
             query?: never;
             header?: never;
@@ -93084,8 +93673,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Voice call statistics
-         * @description Voice-channel call stats for the window. Served by the voice insights service rather than the general reporting one, so its shape does not match the other reports.
+         * Activity heatmap by day and hour
+         * @description The only report that accepts `tz`. Pass the viewer’s IANA zone (`America/Santiago`) and the day/hour buckets follow their wall clock; omit it and the grid is UTC, which shifts a Chilean workspace’s busy hours by three or four columns depending on DST. The name is validated by Postgres, so an unknown zone is a 500 rather than a 400.
          */
         get: {
             parameters: {
@@ -93100,6 +93689,8 @@ interface paths {
                     from?: string;
                     /** @description Explicit range only. ISO instant, see `from`. */
                     to?: string;
+                    /** @description IANA timezone for the date/hour buckets. Defaults to UTC. */
+                    tz?: string;
                 };
                 header?: never;
                 path?: never;
@@ -93107,7 +93698,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Call statistics */
+                /** @description Day/hour activity buckets */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93116,30 +93707,18 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "range": {
-                         *           "from": "2026-09-15T16:38:51.540Z",
-                         *           "to": "2026-09-22T16:38:51.540Z"
-                         *         },
-                         *         "calls": {
-                         *           "total": 6,
-                         *           "answered": 5,
-                         *           "avg_duration_s": 142,
-                         *           "by_outcome": {
-                         *             "completed": 5,
-                         *             "no_answer": 1
-                         *           },
-                         *           "by_direction": {
-                         *             "inbound": 4,
-                         *             "outbound": 2
+                         *         "buckets": [
+                         *           {
+                         *             "day": 1,
+                         *             "hour": 10,
+                         *             "conversations": 3
                          *           },
-                         *           "by_amd": {}
-                         *         },
-                         *         "latency": {
-                         *           "voice_to_voice": 820,
-                         *           "voice_llm_turn": 410,
-                         *           "voice_llm_first_token": 190,
-                         *           "tool_execution": 260
-                         *         }
+                         *           {
+                         *             "day": 1,
+                         *             "hour": 11,
+                         *             "conversations": 5
+                         *           }
+                         *         ]
                          *       },
                          *       "meta": {
                          *         "window": {
@@ -93225,7 +93804,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/conversations": {
+    "/insights/calls": {
         parameters: {
             query?: never;
             header?: never;
@@ -93233,8 +93812,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Conversation volume and resolution
-         * @description Volume, resolution and handling time over the window — the top-level view the other reports break down.
+         * Voice call statistics
+         * @description Voice-channel call stats for the window. Served by the voice insights service rather than the general reporting one, so its shape does not match the other reports.
          */
         get: {
             parameters: {
@@ -93256,7 +93835,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Conversation volume and resolution */
+                /** @description Call statistics */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93265,84 +93844,30 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "conversations": {
-                         *           "total": 18,
-                         *           "delta_pct": 17,
-                         *           "series": [
-                         *             {
-                         *               "bucket": "2026-09-21",
-                         *               "value": 0
-                         *             },
-                         *             {
-                         *               "bucket": "2026-09-22",
-                         *               "value": 18
-                         *             }
-                         *           ]
-                         *         },
-                         *         "messages_in": {
-                         *           "total": 11,
-                         *           "delta_pct": null,
-                         *           "series": [
-                         *             {
-                         *               "bucket": "2026-09-22",
-                         *               "value": 10
-                         *             }
-                         *           ]
-                         *         },
-                         *         "messages_out": {
-                         *           "total": 25,
-                         *           "delta_pct": null,
-                         *           "series": [
-                         *             {
-                         *               "bucket": "2026-09-22",
-                         *               "value": 25
-                         *             }
-                         *           ]
-                         *         },
-                         *         "first_response_seconds": {
-                         *           "avg": 728.65,
-                         *           "delta_pct": null,
-                         *           "series": [
-                         *             {
-                         *               "bucket": "2026-09-22",
-                         *               "value": 728.65
-                         *             }
-                         *           ]
-                         *         },
-                         *         "first_response_p50_seconds": 388.36,
-                         *         "first_response_p90_seconds": 1411.41,
-                         *         "resolution_seconds": {
-                         *           "avg": 9891.67,
-                         *           "delta_pct": -91.3,
-                         *           "series": [
-                         *             {
-                         *               "bucket": "2026-09-22",
-                         *               "value": 9891.67
-                         *             }
-                         *           ]
-                         *         },
-                         *         "resolutions": {
-                         *           "total": 5,
-                         *           "delta_pct": -16.7,
-                         *           "series": [
-                         *             {
-                         *               "bucket": "2026-09-22",
-                         *               "value": 4
-                         *             }
-                         *           ]
+                         *         "range": {
+                         *           "from": "2026-09-15T16:38:51.540Z",
+                         *           "to": "2026-09-22T16:38:51.540Z"
                          *         },
-                         *         "customer_wait_seconds": {
-                         *           "avg": 728.65,
-                         *           "delta_pct": null,
-                         *           "series": [
-                         *             {
-                         *               "bucket": "2026-09-22",
-                         *               "value": 728.65
-                         *             }
-                         *           ]
+                         *         "calls": {
+                         *           "total": 6,
+                         *           "answered": 5,
+                         *           "avg_duration_s": 142,
+                         *           "by_outcome": {
+                         *             "completed": 5,
+                         *             "no_answer": 1
+                         *           },
+                         *           "by_direction": {
+                         *             "inbound": 4,
+                         *             "outbound": 2
+                         *           },
+                         *           "by_amd": {}
                          *         },
-                         *         "facturables": 4,
-                         *         "solo_humano": 14
+                         *         "latency": {
+                         *           "voice_to_voice": 820,
+                         *           "voice_llm_turn": 410,
+                         *           "voice_llm_first_token": 190,
+                         *           "tool_execution": 260
+                         *         }
                          *       },
                          *       "meta": {
                          *         "window": {
@@ -93428,7 +93953,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/agents": {
+    "/insights/conversations": {
         parameters: {
             query?: never;
             header?: never;
@@ -93436,8 +93961,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Human agent performance
-         * @description Per-human-agent throughput and response times. `/insights/ai-agents` is the machine-side counterpart; the two are not comparable row for row, because a human is assigned a conversation and an AI agent runs turns within one.
+         * Conversation volume and resolution
+         * @description Volume, resolution and handling time over the window — the top-level view the other reports break down.
          */
         get: {
             parameters: {
@@ -93459,7 +93984,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Human agent performance */
+                /** @description Conversation volume and resolution */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93467,20 +93992,86 @@ interface paths {
                     content: {
                         /**
                          * @example {
-                         *       "data": [
-                         *         {
-                         *           "user_id": "11111111-0000-4000-8000-000000000001",
-                         *           "name": "Carolina Muñoz",
-                         *           "email": "carolina@example.cl",
-                         *           "conversations": 8,
-                         *           "replies": 5,
-                         *           "avg_first_response_seconds": 733.76,
-                         *           "avg_response_seconds": 28197.49,
-                         *           "avg_resolution_seconds": 9891.67,
-                         *           "avg_customer_wait_seconds": 733.76,
-                         *           "resolutions": 4
-                         *         }
-                         *       ],
+                         *       "data": {
+                         *         "conversations": {
+                         *           "total": 18,
+                         *           "delta_pct": 17,
+                         *           "series": [
+                         *             {
+                         *               "bucket": "2026-09-21",
+                         *               "value": 0
+                         *             },
+                         *             {
+                         *               "bucket": "2026-09-22",
+                         *               "value": 18
+                         *             }
+                         *           ]
+                         *         },
+                         *         "messages_in": {
+                         *           "total": 11,
+                         *           "delta_pct": null,
+                         *           "series": [
+                         *             {
+                         *               "bucket": "2026-09-22",
+                         *               "value": 10
+                         *             }
+                         *           ]
+                         *         },
+                         *         "messages_out": {
+                         *           "total": 25,
+                         *           "delta_pct": null,
+                         *           "series": [
+                         *             {
+                         *               "bucket": "2026-09-22",
+                         *               "value": 25
+                         *             }
+                         *           ]
+                         *         },
+                         *         "first_response_seconds": {
+                         *           "avg": 728.65,
+                         *           "delta_pct": null,
+                         *           "series": [
+                         *             {
+                         *               "bucket": "2026-09-22",
+                         *               "value": 728.65
+                         *             }
+                         *           ]
+                         *         },
+                         *         "first_response_p50_seconds": 388.36,
+                         *         "first_response_p90_seconds": 1411.41,
+                         *         "resolution_seconds": {
+                         *           "avg": 9891.67,
+                         *           "delta_pct": -91.3,
+                         *           "series": [
+                         *             {
+                         *               "bucket": "2026-09-22",
+                         *               "value": 9891.67
+                         *             }
+                         *           ]
+                         *         },
+                         *         "resolutions": {
+                         *           "total": 5,
+                         *           "delta_pct": -16.7,
+                         *           "series": [
+                         *             {
+                         *               "bucket": "2026-09-22",
+                         *               "value": 4
+                         *             }
+                         *           ]
+                         *         },
+                         *         "customer_wait_seconds": {
+                         *           "avg": 728.65,
+                         *           "delta_pct": null,
+                         *           "series": [
+                         *             {
+                         *               "bucket": "2026-09-22",
+                         *               "value": 728.65
+                         *             }
+                         *           ]
+                         *         },
+                         *         "facturables": 4,
+                         *         "solo_humano": 14
+                         *       },
                          *       "meta": {
                          *         "window": {
                          *           "kind": "rolling",
@@ -93565,7 +94156,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/ai-agents": {
+    "/insights/agents": {
         parameters: {
             query?: never;
             header?: never;
@@ -93573,8 +94164,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Per-AI-agent performance breakdown
-         * @description One row per `ai_agent`. `/insights/bots` answers the same question in aggregate — use that for a single headline number and this to find which agent moved it.
+         * Human agent performance
+         * @description Per-human-agent throughput and response times. `/insights/ai-agents` is the machine-side counterpart; the two are not comparable row for row, because a human is assigned a conversation and an AI agent runs turns within one.
          */
         get: {
             parameters: {
@@ -93596,7 +94187,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Per-AI-agent performance breakdown */
+                /** @description Human agent performance */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93606,22 +94197,16 @@ interface paths {
                          * @example {
                          *       "data": [
                          *         {
-                         *           "ai_agent_id": "a3a3a3a3-0000-4000-8000-000000000001",
-                         *           "name": "Asistente de ventas",
-                         *           "status": "active",
-                         *           "is_default": true,
-                         *           "conversations": 12,
-                         *           "responses": 30,
-                         *           "avg_response_seconds": 4.2,
-                         *           "automated_conversations": 8,
-                         *           "handoffs": 2,
-                         *           "resolutions": 4,
-                         *           "tool_calls": 21,
-                         *           "cost_usd": 0.0508,
-                         *           "tokens": 322522,
-                         *           "avg_gen_latency_ms": 7938,
-                         *           "handoffs_requested": 2,
-                         *           "handoffs_answered": 2
+                         *           "user_id": "11111111-0000-4000-8000-000000000001",
+                         *           "name": "Carolina Muñoz",
+                         *           "email": "carolina@example.cl",
+                         *           "conversations": 8,
+                         *           "replies": 5,
+                         *           "avg_first_response_seconds": 733.76,
+                         *           "avg_response_seconds": 28197.49,
+                         *           "avg_resolution_seconds": 9891.67,
+                         *           "avg_customer_wait_seconds": 733.76,
+                         *           "resolutions": 4
                          *         }
                          *       ],
                          *       "meta": {
@@ -93708,7 +94293,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/bots": {
+    "/insights/ai-agents": {
         parameters: {
             query?: never;
             header?: never;
@@ -93716,8 +94301,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Aggregate AI handling
-         * @description AI handling across the workspace as one figure, not split by agent. The aggregate counterpart to `/insights/ai-agents`.
+         * Per-AI-agent performance breakdown
+         * @description One row per `ai_agent`. `/insights/bots` answers the same question in aggregate — use that for a single headline number and this to find which agent moved it.
          */
         get: {
             parameters: {
@@ -93739,7 +94324,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Aggregate AI handling */
+                /** @description Per-AI-agent performance breakdown */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93747,43 +94332,26 @@ interface paths {
                     content: {
                         /**
                          * @example {
-                         *       "data": {
-                         *         "conversations": 12,
-                         *         "automated_conversations": 8,
-                         *         "total_conversations": 18,
-                         *         "engaged_conversations": 11,
-                         *         "deflection_rate": 0.44,
-                         *         "total_responses": 30,
-                         *         "avg_response_seconds": 4.2,
-                         *         "resolutions": 4,
-                         *         "handoff_rate": 0.17,
-                         *         "resolved_by_bot": 3,
-                         *         "resolved_by_human": 1,
-                         *         "resolved_by_auto": 0,
-                         *         "cost_usd": 0.0508,
-                         *         "cost_per_conversation": 0.0042,
-                         *         "tokens": 322522,
-                         *         "avg_gen_latency_ms": 7938,
-                         *         "tool_calls": 21,
-                         *         "resolutions_series": [
-                         *           {
-                         *             "bucket": "2026-09-22",
-                         *             "value": 3
-                         *           }
-                         *         ],
-                         *         "handoff_series": [
-                         *           {
-                         *             "bucket": "2026-09-22",
-                         *             "value": 1
-                         *           }
-                         *         ],
-                         *         "cost_series": [
-                         *           {
-                         *             "bucket": "2026-09-22",
-                         *             "value": 0.0064
-                         *           }
-                         *         ]
-                         *       },
+                         *       "data": [
+                         *         {
+                         *           "ai_agent_id": "a3a3a3a3-0000-4000-8000-000000000001",
+                         *           "name": "Asistente de ventas",
+                         *           "status": "active",
+                         *           "is_default": true,
+                         *           "conversations": 12,
+                         *           "responses": 30,
+                         *           "avg_response_seconds": 4.2,
+                         *           "automated_conversations": 8,
+                         *           "handoffs": 2,
+                         *           "resolutions": 4,
+                         *           "tool_calls": 21,
+                         *           "cost_usd": 0.0508,
+                         *           "tokens": 322522,
+                         *           "avg_gen_latency_ms": 7938,
+                         *           "handoffs_requested": 2,
+                         *           "handoffs_answered": 2
+                         *         }
+                         *       ],
                          *       "meta": {
                          *         "window": {
                          *           "kind": "rolling",
@@ -93868,7 +94436,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/tags": {
+    "/insights/bots": {
         parameters: {
             query?: never;
             header?: never;
@@ -93876,8 +94444,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Volume by tag
-         * @description Conversation counts grouped by the tags applied to them.
+         * Aggregate AI handling
+         * @description AI handling across the workspace as one figure, not split by agent. The aggregate counterpart to `/insights/ai-agents`.
          */
         get: {
             parameters: {
@@ -93899,7 +94467,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Volume by tag */
+                /** @description Aggregate AI handling */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -93907,26 +94475,43 @@ interface paths {
                     content: {
                         /**
                          * @example {
-                         *       "data": [
-                         *         {
-                         *           "key": "__none__",
-                         *           "label": "Sin etiqueta",
-                         *           "conversations": 17,
-                         *           "avg_first_response_seconds": 728.65,
-                         *           "avg_resolution_seconds": 9891.67,
-                         *           "avg_customer_wait_seconds": 728.65,
-                         *           "resolutions": 4
-                         *         },
-                         *         {
-                         *           "key": "e1e1e1e1-9000-4000-8000-000000000001",
-                         *           "label": "garantia",
-                         *           "conversations": 1,
-                         *           "avg_first_response_seconds": 0,
-                         *           "avg_resolution_seconds": 0,
-                         *           "avg_customer_wait_seconds": 0,
-                         *           "resolutions": 0
-                         *         }
-                         *       ],
+                         *       "data": {
+                         *         "conversations": 12,
+                         *         "automated_conversations": 8,
+                         *         "total_conversations": 18,
+                         *         "engaged_conversations": 11,
+                         *         "deflection_rate": 0.44,
+                         *         "total_responses": 30,
+                         *         "avg_response_seconds": 4.2,
+                         *         "resolutions": 4,
+                         *         "handoff_rate": 0.17,
+                         *         "resolved_by_bot": 3,
+                         *         "resolved_by_human": 1,
+                         *         "resolved_by_auto": 0,
+                         *         "cost_usd": 0.0508,
+                         *         "cost_per_conversation": 0.0042,
+                         *         "tokens": 322522,
+                         *         "avg_gen_latency_ms": 7938,
+                         *         "tool_calls": 21,
+                         *         "resolutions_series": [
+                         *           {
+                         *             "bucket": "2026-09-22",
+                         *             "value": 3
+                         *           }
+                         *         ],
+                         *         "handoff_series": [
+                         *           {
+                         *             "bucket": "2026-09-22",
+                         *             "value": 1
+                         *           }
+                         *         ],
+                         *         "cost_series": [
+                         *           {
+                         *             "bucket": "2026-09-22",
+                         *             "value": 0.0064
+                         *           }
+                         *         ]
+                         *       },
                          *       "meta": {
                          *         "window": {
                          *           "kind": "rolling",
@@ -94011,7 +94596,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/channels": {
+    "/insights/tags": {
         parameters: {
             query?: never;
             header?: never;
@@ -94019,8 +94604,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Volume by channel
-         * @description Grouped by messaging channel (WhatsApp, Instagram, email, voice, …), so a channel with no traffic in the window is simply absent rather than present with a zero.
+         * Volume by tag
+         * @description Conversation counts grouped by the tags applied to them.
          */
         get: {
             parameters: {
@@ -94042,7 +94627,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Volume by channel */
+                /** @description Volume by tag */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -94052,18 +94637,18 @@ interface paths {
                          * @example {
                          *       "data": [
                          *         {
-                         *           "key": "00000000-0000-4000-8000-000000005001",
-                         *           "label": "WhatsApp · Acme",
-                         *           "conversations": 5,
-                         *           "avg_first_response_seconds": 450.43,
-                         *           "avg_resolution_seconds": 101.4,
-                         *           "avg_customer_wait_seconds": 450.43,
-                         *           "resolutions": 1
+                         *           "key": "__none__",
+                         *           "label": "Sin etiqueta",
+                         *           "conversations": 17,
+                         *           "avg_first_response_seconds": 728.65,
+                         *           "avg_resolution_seconds": 9891.67,
+                         *           "avg_customer_wait_seconds": 728.65,
+                         *           "resolutions": 4
                          *         },
                          *         {
-                         *           "key": "__none__",
-                         *           "label": "Directo / sin canal",
-                         *           "conversations": 4,
+                         *           "key": "e1e1e1e1-9000-4000-8000-000000000001",
+                         *           "label": "garantia",
+                         *           "conversations": 1,
                          *           "avg_first_response_seconds": 0,
                          *           "avg_resolution_seconds": 0,
                          *           "avg_customer_wait_seconds": 0,
@@ -94154,7 +94739,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/teams": {
+    "/insights/channels": {
         parameters: {
             query?: never;
             header?: never;
@@ -94162,8 +94747,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Volume by team
-         * @description Conversation counts grouped by the team they were routed to.
+         * Volume by channel
+         * @description Grouped by messaging channel (WhatsApp, Instagram, email, voice, …), so a channel with no traffic in the window is simply absent rather than present with a zero.
          */
         get: {
             parameters: {
@@ -94185,7 +94770,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Volume by team */
+                /** @description Volume by channel */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -94195,18 +94780,18 @@ interface paths {
                          * @example {
                          *       "data": [
                          *         {
-                         *           "key": "__none__",
-                         *           "label": "Sin equipo",
-                         *           "conversations": 18,
-                         *           "avg_first_response_seconds": 728.65,
-                         *           "avg_resolution_seconds": 9891.67,
-                         *           "avg_customer_wait_seconds": 728.65,
-                         *           "resolutions": 4
+                         *           "key": "00000000-0000-4000-8000-000000005001",
+                         *           "label": "WhatsApp · Acme",
+                         *           "conversations": 5,
+                         *           "avg_first_response_seconds": 450.43,
+                         *           "avg_resolution_seconds": 101.4,
+                         *           "avg_customer_wait_seconds": 450.43,
+                         *           "resolutions": 1
                          *         },
                          *         {
-                         *           "key": "cccccccc-0000-4000-8000-000000000001",
-                         *           "label": "Marketing",
-                         *           "conversations": 0,
+                         *           "key": "__none__",
+                         *           "label": "Directo / sin canal",
+                         *           "conversations": 4,
                          *           "avg_first_response_seconds": 0,
                          *           "avg_resolution_seconds": 0,
                          *           "avg_customer_wait_seconds": 0,
@@ -94297,7 +94882,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/sources": {
+    "/insights/teams": {
         parameters: {
             query?: never;
             header?: never;
@@ -94305,8 +94890,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Volume by origin
-         * @description The same row shape as `/insights/channels`, grouped by where the conversation CAME FROM (`mercadolibre`, `yapo`, `chileautos`, `ai_agent`, `website`, …) rather than which messaging account it rode in on. The two are not interchangeable: marketplace leads all arrive on the same WhatsApp number, so `/insights/channels` collapses every paid origin into one row. Unlike channels there is no catalogue to zero-fill from, so an origin with no traffic is absent rather than present with a zero; `__none__` is the no-origin bucket.
+         * Volume by team
+         * @description Conversation counts grouped by the team they were routed to.
          */
         get: {
             parameters: {
@@ -94328,7 +94913,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Volume by origin */
+                /** @description Volume by team */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -94339,17 +94924,17 @@ interface paths {
                          *       "data": [
                          *         {
                          *           "key": "__none__",
-                         *           "label": "Directo / sin origen",
-                         *           "conversations": 14,
+                         *           "label": "Sin equipo",
+                         *           "conversations": 18,
                          *           "avg_first_response_seconds": 728.65,
                          *           "avg_resolution_seconds": 9891.67,
                          *           "avg_customer_wait_seconds": 728.65,
                          *           "resolutions": 4
                          *         },
                          *         {
-                         *           "key": "website",
-                         *           "label": "Sitio web",
-                         *           "conversations": 4,
+                         *           "key": "cccccccc-0000-4000-8000-000000000001",
+                         *           "label": "Marketing",
+                         *           "conversations": 0,
                          *           "avg_first_response_seconds": 0,
                          *           "avg_resolution_seconds": 0,
                          *           "avg_customer_wait_seconds": 0,
@@ -94440,7 +95025,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/leads": {
+    "/insights/sources": {
         parameters: {
             query?: never;
             header?: never;
@@ -94448,8 +95033,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Lead capture
-         * @description Leads created over the window and where they came from.
+         * Volume by origin
+         * @description The same row shape as `/insights/channels`, grouped by where the conversation CAME FROM (`mercadolibre`, `yapo`, `chileautos`, `ai_agent`, `website`, …) rather than which messaging account it rode in on. The two are not interchangeable: marketplace leads all arrive on the same WhatsApp number, so `/insights/channels` collapses every paid origin into one row. Unlike channels there is no catalogue to zero-fill from, so an origin with no traffic is absent rather than present with a zero; `__none__` is the no-origin bucket.
          */
         get: {
             parameters: {
@@ -94471,7 +95056,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Lead capture */
+                /** @description Volume by origin */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -94479,60 +95064,26 @@ interface paths {
                     content: {
                         /**
                          * @example {
-                         *       "data": {
-                         *         "open": 16,
-                         *         "won": 2,
-                         *         "lost": 1,
-                         *         "unqualified": 0,
-                         *         "total_value_open": 19407775,
-                         *         "total_value_won": 4500000,
-                         *         "total_value_open_by_currency": {
-                         *           "CLP": 19399000
-                         *         },
-                         *         "total_value_won_by_currency": {
-                         *           "CLP": 4500000
+                         *       "data": [
+                         *         {
+                         *           "key": "__none__",
+                         *           "label": "Directo / sin origen",
+                         *           "conversations": 14,
+                         *           "avg_first_response_seconds": 728.65,
+                         *           "avg_resolution_seconds": 9891.67,
+                         *           "avg_customer_wait_seconds": 728.65,
+                         *           "resolutions": 4
                          *         },
-                         *         "is_mixed_currency": false,
-                         *         "is_mixed_currency_open": false,
-                         *         "win_rate": 0.67,
-                         *         "avg_cycle_seconds": 432000,
-                         *         "created_series": [
-                         *           {
-                         *             "bucket": "2026-09-22",
-                         *             "value": 6
-                         *           }
-                         *         ],
-                         *         "won_series": [
-                         *           {
-                         *             "bucket": "2026-09-22",
-                         *             "value": 1
-                         *           }
-                         *         ],
-                         *         "revenue_series": [
-                         *           {
-                         *             "bucket": "2026-09-22",
-                         *             "value": 4500000,
-                         *             "value_by_currency": {
-                         *               "CLP": 4500000
-                         *             },
-                         *             "is_mixed_currency": false
-                         *           }
-                         *         ],
-                         *         "funnel": [
-                         *           {
-                         *             "stage_id": "55555555-0000-4000-8000-000000000001",
-                         *             "stage_name": "Nuevo",
-                         *             "position": 0,
-                         *             "open_count": 9,
-                         *             "total_value": 19401030,
-                         *             "total_value_by_currency": {
-                         *               "CLP": 19399000
-                         *             },
-                         *             "is_mixed_currency": false,
-                         *             "median_time_in_stage_hours": 6.5
-                         *           }
-                         *         ]
-                         *       },
+                         *         {
+                         *           "key": "website",
+                         *           "label": "Sitio web",
+                         *           "conversations": 4,
+                         *           "avg_first_response_seconds": 0,
+                         *           "avg_resolution_seconds": 0,
+                         *           "avg_customer_wait_seconds": 0,
+                         *           "resolutions": 0
+                         *         }
+                         *       ],
                          *       "meta": {
                          *         "window": {
                          *           "kind": "rolling",
@@ -94617,7 +95168,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/csat": {
+    "/insights/leads": {
         parameters: {
             query?: never;
             header?: never;
@@ -94625,8 +95176,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Estimated satisfaction
-         * @description CSAT is AI-ESTIMATED from the conversation, not collected from a survey — no customer was asked to rate anything. Read it as a model judgement about tone and outcome, which is why it exists for every conversation rather than the small fraction that would answer a survey.
+         * Lead capture
+         * @description Leads created over the window and where they came from.
          */
         get: {
             parameters: {
@@ -94648,7 +95199,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Estimated satisfaction */
+                /** @description Lead capture */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -94657,27 +95208,58 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "total_responses": 9,
-                         *         "satisfaction_score": 0.82,
-                         *         "response_rate": 0.5,
-                         *         "positive": 7,
-                         *         "neutral": 1,
-                         *         "negative": 1,
-                         *         "recommend_rate": 0.78,
-                         *         "avg_confidence": 0.9,
-                         *         "review_requests_sent": 18,
-                         *         "resolved_tickets": 5,
-                         *         "distribution": {
-                         *           "positive": 7,
-                         *           "neutral": 1,
-                         *           "negative": 1
+                         *         "open": 16,
+                         *         "won": 2,
+                         *         "lost": 1,
+                         *         "unqualified": 0,
+                         *         "total_value_open": 19407775,
+                         *         "total_value_won": 4500000,
+                         *         "total_value_open_by_currency": {
+                         *           "CLP": 19399000
                          *         },
-                         *         "resolution_quality": {
-                         *           "good": 8,
-                         *           "poor": 1
+                         *         "total_value_won_by_currency": {
+                         *           "CLP": 4500000
                          *         },
-                         *         "agent_performance": {},
-                         *         "recent": []
+                         *         "is_mixed_currency": false,
+                         *         "is_mixed_currency_open": false,
+                         *         "win_rate": 0.67,
+                         *         "avg_cycle_seconds": 432000,
+                         *         "created_series": [
+                         *           {
+                         *             "bucket": "2026-09-22",
+                         *             "value": 6
+                         *           }
+                         *         ],
+                         *         "won_series": [
+                         *           {
+                         *             "bucket": "2026-09-22",
+                         *             "value": 1
+                         *           }
+                         *         ],
+                         *         "revenue_series": [
+                         *           {
+                         *             "bucket": "2026-09-22",
+                         *             "value": 4500000,
+                         *             "value_by_currency": {
+                         *               "CLP": 4500000
+                         *             },
+                         *             "is_mixed_currency": false
+                         *           }
+                         *         ],
+                         *         "funnel": [
+                         *           {
+                         *             "stage_id": "55555555-0000-4000-8000-000000000001",
+                         *             "stage_name": "Nuevo",
+                         *             "position": 0,
+                         *             "open_count": 9,
+                         *             "total_value": 19401030,
+                         *             "total_value_by_currency": {
+                         *               "CLP": 19399000
+                         *             },
+                         *             "is_mixed_currency": false,
+                         *             "median_time_in_stage_hours": 6.5
+                         *           }
+                         *         ]
                          *       },
                          *       "meta": {
                          *         "window": {
@@ -94763,7 +95345,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/insights/sla": {
+    "/insights/csat": {
         parameters: {
             query?: never;
             header?: never;
@@ -94771,8 +95353,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * SLA compliance
-         * @description Breach and compliance counts against the workspace SLA policies. A window with no policy configured reports nothing to comply with, not full compliance.
+         * Estimated satisfaction
+         * @description CSAT is AI-ESTIMATED from the conversation, not collected from a survey — no customer was asked to rate anything. Read it as a model judgement about tone and outcome, which is why it exists for every conversation rather than the small fraction that would answer a survey.
          */
         get: {
             parameters: {
@@ -94794,7 +95376,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description SLA compliance */
+                /** @description Estimated satisfaction */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -94803,32 +95385,178 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "has_policies": true,
-                         *         "policy_count": 2,
-                         *         "target_first_response_minutes": 15,
-                         *         "target_resolution_minutes": 480,
-                         *         "tracked": 18,
-                         *         "breached": 2,
-                         *         "hits": 16,
-                         *         "hit_rate": 0.89,
-                         *         "first_response": {
-                         *           "evaluated": 18,
-                         *           "breached": 1,
-                         *           "hit_rate": 0.94
+                         *         "total_responses": 9,
+                         *         "satisfaction_score": 0.82,
+                         *         "response_rate": 0.5,
+                         *         "positive": 7,
+                         *         "neutral": 1,
+                         *         "negative": 1,
+                         *         "recommend_rate": 0.78,
+                         *         "avg_confidence": 0.9,
+                         *         "review_requests_sent": 18,
+                         *         "resolved_tickets": 5,
+                         *         "distribution": {
+                         *           "positive": 7,
+                         *           "neutral": 1,
+                         *           "negative": 1
                          *         },
-                         *         "resolution": {
-                         *           "evaluated": 5,
-                         *           "breached": 1,
-                         *           "hit_rate": 0.8
+                         *         "resolution_quality": {
+                         *           "good": 8,
+                         *           "poor": 1
                          *         },
-                         *         "by_policy": [
-                         *           {
-                         *             "policy_id": "cccccccc-1000-4000-8000-000000000001",
-                         *             "name": "SLA estándar",
-                         *             "hit_rate": 0.89
-                         *           }
-                         *         ],
-                         *         "breaches": []
+                         *         "agent_performance": {},
+                         *         "recent": []
+                         *       },
+                         *       "meta": {
+                         *         "window": {
+                         *           "kind": "rolling",
+                         *           "preset": "7d",
+                         *           "hours": 168,
+                         *           "from": "2026-09-15T16:38:51.000Z",
+                         *           "to": "2026-09-22T16:38:51.000Z",
+                         *           "label": "últimos 7d"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "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;
+    };
+    "/insights/sla": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * SLA compliance
+         * @description Breach and compliance counts against the workspace SLA policies. A window with no policy configured reports nothing to comply with, not full compliance.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Which period. Omit it (with `from`/`to`) for an explicit range — the shape every ranged Insights report has always accepted, and which still works unchanged. The calendar windows are the DEALERSHIP’s (America/Santiago), so a month closes when a person would say it closed. */
+                    window?: "24h" | "7d" | "30d" | "90d" | "calendar_month" | "calendar_year" | "custom";
+                    /** @description `window=calendar_month` only. ISO month, `YYYY-MM`. Defaults to the month in progress. */
+                    month?: string;
+                    /** @description `window=calendar_year` only. `YYYY`. Defaults to the year in progress. */
+                    year?: string;
+                    /** @description Explicit range only. Checked for non-emptiness and handed to Postgres, so a malformed value surfaces as a 500 from the query rather than a 400 from the edge — send an ISO-8601 instant. */
+                    from?: string;
+                    /** @description Explicit range only. ISO instant, see `from`. */
+                    to?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description SLA compliance */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "has_policies": true,
+                         *         "policy_count": 2,
+                         *         "target_first_response_minutes": 15,
+                         *         "target_resolution_minutes": 480,
+                         *         "tracked": 18,
+                         *         "breached": 2,
+                         *         "hits": 16,
+                         *         "hit_rate": 0.89,
+                         *         "first_response": {
+                         *           "evaluated": 18,
+                         *           "breached": 1,
+                         *           "hit_rate": 0.94
+                         *         },
+                         *         "resolution": {
+                         *           "evaluated": 5,
+                         *           "breached": 1,
+                         *           "hit_rate": 0.8
+                         *         },
+                         *         "by_policy": [
+                         *           {
+                         *             "policy_id": "cccccccc-1000-4000-8000-000000000001",
+                         *             "name": "SLA estándar",
+                         *             "hit_rate": 0.89
+                         *           }
+                         *         ],
+                         *         "breaches": []
                          *       },
                          *       "meta": {
                          *         "window": {
@@ -97321,6 +98049,593 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/ads/report": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Reporte: campaigns, ad sets or ads with their funnel, costs and cash return
+         * @description One table at `level` (campaign, ad set or ad) for the window. Per row: the spend and the cash credited by the attribution engine, Vitrina’s own conversational funnel (conversations each ad opened → answered → citas → attended → closes) with the cost of each step, «Retorno» = cash ÷ spend (`null` when no payment was recorded in the period), and Meta’s own figures apart. `tail` holds the period’s conversations with no ad behind them, so from-ads + tail = the workspace total; `reconciliation` states Σ spend against `/ads/overview`. A failed read is `null`, never 0.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Window start (inclusive), YYYY-MM-DD. */
+                    from: string;
+                    /** @description Window end (inclusive), YYYY-MM-DD. */
+                    to: string;
+                    /** @description The attribution model. Defaults to `last_touch`. */
+                    model?: string;
+                    /** @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";
+                    /** @description Campaña, conjunto (ad set) or anuncio. Default `campaign`. */
+                    level?: "campaign" | "ad_set" | "ad";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The report at the requested level */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "level": "campaign",
+                         *         "window": {
+                         *           "from": "2026-08-30",
+                         *           "to": "2026-09-28"
+                         *         },
+                         *         "rows": [
+                         *           {
+                         *             "external_id": "120211000000000001",
+                         *             "level": "campaign",
+                         *             "name": "Implantes · Septiembre",
+                         *             "parent": null,
+                         *             "thumbnail_url": null,
+                         *             "spark": [
+                         *               13200,
+                         *               14100,
+                         *               13900
+                         *             ],
+                         *             "spend": 412300,
+                         *             "funnel": {
+                         *               "conversations": 120,
+                         *               "replied": 110,
+                         *               "appointments": 20,
+                         *               "attended": 12,
+                         *               "closes": 2
+                         *             },
+                         *             "cost_per": {
+                         *               "conversation": 3436,
+                         *               "appointment": 20615,
+                         *               "attended": 34358,
+                         *               "close": 206150
+                         *             },
+                         *             "cash": 0,
+                         *             "return": null,
+                         *             "meta": {
+                         *               "conversations_started": 131,
+                         *               "cost_per_conversation": 3147
+                         *             }
+                         *           }
+                         *         ],
+                         *         "tail": [
+                         *           {
+                         *             "key": "direct",
+                         *             "conversations": 210
+                         *           },
+                         *           {
+                         *             "key": "website",
+                         *             "conversations": 40
+                         *           }
+                         *         ],
+                         *         "totals": {
+                         *           "spend": 412300,
+                         *           "funnel": {
+                         *             "conversations": 120,
+                         *             "replied": 110,
+                         *             "appointments": 20,
+                         *             "attended": 12,
+                         *             "closes": 2
+                         *           },
+                         *           "cost_per": {
+                         *             "conversation": 3436,
+                         *             "appointment": 20615,
+                         *             "attended": 34358,
+                         *             "close": 206150
+                         *           },
+                         *           "cash": 0,
+                         *           "return": null,
+                         *           "meta": {
+                         *             "conversations_started": 131,
+                         *             "cost_per_conversation": 3147
+                         *           }
+                         *         },
+                         *         "pipeline": {
+                         *           "closed_count": 3,
+                         *           "closed_value": 93082
+                         *         },
+                         *         "cash_recorded": false,
+                         *         "reconciliation": {
+                         *           "overview_spend": 412300,
+                         *           "spend_matches": true,
+                         *           "conversations_total": 370,
+                         *           "conversations_from_ads": 120,
+                         *           "conversations_without_ad": 250
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["AdsReport"];
+                        };
+                    };
+                };
+                /** @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 Vitrina Ads is not active for this workspace. `error.code` is `ENTITLEMENT_NOT_ACTIVE`, `error.details.feature` is `vitrina_ads`. */
+                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: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Vitrina Ads is active but the delegated key has not finished rotating (`ADS_KEY_NEEDS_REMINT`) — retry once `GET /ads/state` reports `needs_remint: false`. Also the generic conflict of a write. */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "ADS_KEY_NEEDS_REMINT",
+                         *         "message": "Vitrina Ads is active but the delegated key has not finished rotating (key_kind: core)",
+                         *         "details": {
+                         *           "key_kind": "core"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "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;
+    };
+    "/ads/report/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Export the Reporte (aggregates only)
+         * @description The same table as `GET /ads/report`, as a file. CSV: `;`, Spanish headers, `dd-mm-aaaa` dates, a preamble with the period, the model and «Retorno = caja». XLSX: the table plus a «Notas» sheet. No row names a person. Audited as `ads.report.export`.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Window start (inclusive), YYYY-MM-DD. */
+                    from: string;
+                    /** @description Window end (inclusive), YYYY-MM-DD. */
+                    to: string;
+                    /** @description The attribution model. Defaults to `last_touch`. */
+                    model?: string;
+                    /** @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";
+                    /** @description Campaña, conjunto (ad set) or anuncio. Default `campaign`. */
+                    level?: "campaign" | "ad_set" | "ad";
+                    /** @description `csv`: `;`-separated, Spanish headers, `dd-mm-aaaa` dates, a preamble with the period, the model and «Retorno = caja». `xlsx`: the same table plus a «Notas» sheet. Aggregates only — no person rows. */
+                    format?: "csv" | "xlsx";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The file */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "text/csv": string;
+                        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": 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 Vitrina Ads is not active for this workspace. `error.code` is `ENTITLEMENT_NOT_ACTIVE`, `error.details.feature` is `vitrina_ads`. */
+                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: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Vitrina Ads is active but the delegated key has not finished rotating (`ADS_KEY_NEEDS_REMINT`) — retry once `GET /ads/state` reports `needs_remint: false`. Also the generic conflict of a write. */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "ADS_KEY_NEEDS_REMINT",
+                         *         "message": "Vitrina Ads is active but the delegated key has not finished rotating (key_kind: core)",
+                         *         "details": {
+                         *           "key_kind": "core"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "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;
+    };
+    "/ads/ads/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * The ad sheet: creative, funnel and the people it brought (masked)
+         * @description One ad: the creative and delivery metrics, the SAME funnel/costs/cash as its Reporte row for the window, and the conversations it opened (a label, the furthest stage, its value). Never a phone or an e-mail; for healthcare the label is always initials. There is no export of people.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Window start (inclusive), YYYY-MM-DD. */
+                    from: string;
+                    /** @description Window end (inclusive), YYYY-MM-DD. */
+                    to: string;
+                    /** @description The attribution model. Defaults to `last_touch`. */
+                    model?: string;
+                    /** @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";
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The ad sheet */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "ad": {
+                         *           "external_id": "120212000000000009",
+                         *           "name": "Video testimonio 15s",
+                         *           "ad_set": {
+                         *             "external_id": "120213000000000004",
+                         *             "name": "INTERESES"
+                         *           },
+                         *           "campaign": {
+                         *             "external_id": "120211000000000001"
+                         *           },
+                         *           "thumbnail_url": null,
+                         *           "title": "Implantes en un día",
+                         *           "body": "Agenda tu evaluación.",
+                         *           "has_video": true,
+                         *           "spend": 168000,
+                         *           "impressions": 24100,
+                         *           "clicks": 337,
+                         *           "ctr": 1.4,
+                         *           "cpm": 6971,
+                         *           "cpc": 498,
+                         *           "cash_count": 0,
+                         *           "cash_value": 0,
+                         *           "meta_conversations_started": 22
+                         *         },
+                         *         "window": {
+                         *           "from": "2026-08-30",
+                         *           "to": "2026-09-28"
+                         *         },
+                         *         "row": {
+                         *           "spend": 412300,
+                         *           "funnel": {
+                         *             "conversations": 120,
+                         *             "replied": 110,
+                         *             "appointments": 20,
+                         *             "attended": 12,
+                         *             "closes": 2
+                         *           },
+                         *           "cost_per": {
+                         *             "conversation": 3436,
+                         *             "appointment": 20615,
+                         *             "attended": 34358,
+                         *             "close": 206150
+                         *           },
+                         *           "cash": 0,
+                         *           "return": null,
+                         *           "meta": {
+                         *             "conversations_started": 131,
+                         *             "cost_per_conversation": 3147
+                         *           }
+                         *         },
+                         *         "cash_recorded": false,
+                         *         "people": [
+                         *           {
+                         *             "conversation_id": "00000000-0000-4000-8000-00000000c0a1",
+                         *             "contact_id": "00000000-0000-4000-8000-00000000c0a2",
+                         *             "label": "M. R.",
+                         *             "masked": true,
+                         *             "stage": "closed_won",
+                         *             "stage_at": "2026-09-25T15:00:00.000Z",
+                         *             "opened_at": "2026-09-20T13:10:00.000Z",
+                         *             "value": 1250000
+                         *           }
+                         *         ],
+                         *         "people_more": false,
+                         *         "people_hidden": false
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["AdsAdSheet"];
+                        };
+                    };
+                };
+                /** @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 Vitrina Ads is not active for this workspace. `error.code` is `ENTITLEMENT_NOT_ACTIVE`, `error.details.feature` is `vitrina_ads`. */
+                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: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Vitrina Ads is active but the delegated key has not finished rotating (`ADS_KEY_NEEDS_REMINT`) — retry once `GET /ads/state` reports `needs_remint: false`. Also the generic conflict of a write. */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "ADS_KEY_NEEDS_REMINT",
+                         *         "message": "Vitrina Ads is active but the delegated key has not finished rotating (key_kind: core)",
+                         *         "details": {
+                         *           "key_kind": "core"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "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;
+    };
     "/ads/overview": {
         parameters: {
             query?: never;
@@ -97906,6 +99221,17 @@ interface paths {
                          *             "attributed_outcomes": 1,
                          *             "partial": false
                          *           }
+                         *         ],
+                         *         "gaps": [
+                         *           {
+                         *             "from": "2026-09-12",
+                         *             "to": "2026-09-15",
+                         *             "cause": "meta_disconnected",
+                         *             "metrics": [
+                         *               "spend"
+                         *             ],
+                         *             "incident_id": "b1b1b1b1-0000-4000-8000-000000000002"
+                         *           }
                          *         ]
                          *       }
                          *     }
@@ -98015,6 +99341,186 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/ads/measurement": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Measurement incidents: what stopped measuring, since when
+         * @description The measurement watchdog’s ledger (W1.1, «Vigilancia de la medición»). `open` are the legs broken right now — the Meta ad account read (disconnected or stale), the site tag’s heartbeat, the Conversions API sends, a WhatsApp channel, clinic facts not reaching the attribution — each with the day the data stopped and its ONE fix (`action.path`). `recent` are the ones resolved in the last 14 days, with who fixed them.
+         *
+         *     The owner and admins are told by WhatsApp and email at +0 h, +3 d and +7 d while an incident stays open. `/ads/overview` and `/ads/campaigns` carry the same incidents as `gaps` over their window.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @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";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Open and recently resolved incidents */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "open": [
+                         *           {
+                         *             "id": "b1b1b1b1-0000-4000-8000-000000000001",
+                         *             "cause": "tag_silent",
+                         *             "label": "Etiqueta del sitio sin señal",
+                         *             "sentence": "La etiqueta de tu sitio web no envía visitas desde el 20 sep",
+                         *             "action": {
+                         *               "label": "Revisar la etiqueta",
+                         *               "path": "/anuncios/activar?paso=tag"
+                         *             },
+                         *             "since": "2026-09-20T14:05:00.000Z",
+                         *             "opened_at": "2026-09-27T15:00:00.000Z",
+                         *             "resolved_at": null,
+                         *             "resolution": null,
+                         *             "resolved_by_name": null,
+                         *             "metrics": []
+                         *           }
+                         *         ],
+                         *         "recent": [
+                         *           {
+                         *             "id": "b1b1b1b1-0000-4000-8000-000000000002",
+                         *             "cause": "meta_disconnected",
+                         *             "label": "Meta Ads desconectado",
+                         *             "sentence": "Tus anuncios de Meta dejaron de medirse el 12 sep",
+                         *             "action": {
+                         *               "label": "Reconectar Meta",
+                         *               "path": "/anuncios/activar?paso=meta"
+                         *             },
+                         *             "since": "2026-09-12T11:20:00.000Z",
+                         *             "opened_at": "2026-09-12T12:00:00.000Z",
+                         *             "resolved_at": "2026-09-15T13:42:00.000Z",
+                         *             "resolution": "reconnected",
+                         *             "resolved_by_name": "Camila",
+                         *             "metrics": [
+                         *               "spend"
+                         *             ]
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["AdsMeasurement"];
+                        };
+                    };
+                };
+                /** @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 Vitrina Ads is not active for this workspace. `error.code` is `ENTITLEMENT_NOT_ACTIVE`, `error.details.feature` is `vitrina_ads`. */
+                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: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Vitrina Ads is active but the delegated key has not finished rotating (`ADS_KEY_NEEDS_REMINT`) — retry once `GET /ads/state` reports `needs_remint: false`. Also the generic conflict of a write. */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": {
+                         *         "code": "ADS_KEY_NEEDS_REMINT",
+                         *         "message": "Vitrina Ads is active but the delegated key has not finished rotating (key_kind: core)",
+                         *         "details": {
+                         *           "key_kind": "core"
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "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;
+    };
     "/ads/campaigns": {
         parameters: {
             query?: never;
@@ -98230,6 +99736,17 @@ interface paths {
                          *               }
                          *             ]
                          *           }
+                         *         ],
+                         *         "gaps": [
+                         *           {
+                         *             "from": "2026-09-12",
+                         *             "to": "2026-09-15",
+                         *             "cause": "meta_disconnected",
+                         *             "metrics": [
+                         *               "spend"
+                         *             ],
+                         *             "incident_id": "b1b1b1b1-0000-4000-8000-000000000002"
+                         *           }
                          *         ]
                          *       }
                          *     }
@@ -122361,6 +123878,178 @@ interface components {
             from: string;
             to: string;
         };
+        AgendaResults: {
+            from: string;
+            to: string;
+            timezone: string;
+            /** Format: uuid */
+            location_id: string | null;
+            /**
+             * @description Vocabulary: citas/pacientes, visitas/clientes, citas/clientes.
+             * @enum {string}
+             */
+            family: "clinic" | "dealer" | "generic";
+            previous_period: {
+                from: string;
+                to: string;
+            };
+            bookings: {
+                /** @description Citas of the period booked by Vitrina's agent in a conversation (`source='agent'`, not a public booking page). */
+                ai: number;
+                /** @description Every cita of the period (blocks and holds excluded). */
+                agenda_total: number;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                share_pct: number | null;
+                previous: {
+                    ai: number;
+                    agenda_total: number;
+                    /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                    share_pct: number | null;
+                };
+                rule: string;
+            };
+            money: {
+                /** @description False for a vertical with no priced citas. */
+                applies: boolean;
+                withheld: boolean;
+                /** @description Value of the AI-booked citas whose value is known (pipeline, not cash). */
+                booked_clp: number | null;
+                booked_priced: number;
+                /** @description AI-booked citas with no price — «sin dato». */
+                booked_unpriced: number;
+                /** @description CLP. `null` when unknown or when the caller lacks `clinic_money:read` (`money.withheld`). */
+                agenda_clp: number | null;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                clp_share_pct: number | null;
+                /** @description Cash received in the period by the patients Vitrina booked, from the day it booked them. */
+                paid_clp: number | null;
+                paid_patients: number | null;
+                /** @description AI-booked citas with no patient to match a payment to. */
+                unlinked: number;
+                /** @enum {string|null} */
+                regime: "mirror" | "native" | null;
+                previous: {
+                    /** @description CLP. `null` when unknown or when the caller lacks `clinic_money:read` (`money.withheld`). */
+                    booked_clp: number | null;
+                    /** @description CLP. `null` when unknown or when the caller lacks `clinic_money:read` (`money.withheld`). */
+                    paid_clp: number | null;
+                };
+                rule_booked: string;
+                rule_paid: string;
+            };
+            out_of_hours: {
+                /** @description False when the workspace has no business hours; count/pct are then null. */
+                configured: boolean;
+                count: number | null;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                pct: number | null;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                previous_pct: number | null;
+                /** @description AI bookings by weekday × hour of the booking, in `timezone`. Empty cells omitted. */
+                heatmap: {
+                    /** @description 1 = Monday … 7 = Sunday. */
+                    weekday: number;
+                    hour: number;
+                    count: number;
+                }[];
+                rule: string;
+            };
+            autonomy: {
+                no_human: number;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                pct: number | null;
+                measured: number;
+                unknown: number;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                previous_pct: number | null;
+                rule: string;
+            };
+            time_to_book: {
+                median_seconds: number | null;
+                p95_seconds: number | null;
+                p95_phrase: string | null;
+                measured: number;
+                unknown: number;
+                previous_median_seconds: number | null;
+                rule: string;
+            };
+            hours_returned: {
+                minutes_per_booking: number;
+                hours: number;
+                rule: string;
+            };
+            recovery: {
+                window_days: number;
+                known_attendance: number;
+                unknown_attendance: number;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                no_show_pct: number | null;
+                no_show: {
+                    count: number;
+                    recovered: number;
+                    recovered_via_vitrina: number;
+                    /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                    recovered_pct: number | null;
+                    /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                    via_vitrina_pct: number | null;
+                    /** @description Not recovered yet, still inside the 30 days. */
+                    pending: number;
+                    /** @description Missed with no identifiable patient. */
+                    unlinked: number;
+                };
+                cancelled: {
+                    count: number;
+                    recovered: number;
+                    recovered_via_vitrina: number;
+                    /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                    recovered_pct: number | null;
+                    /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                    via_vitrina_pct: number | null;
+                    /** @description Not recovered yet, still inside the 30 days. */
+                    pending: number;
+                    /** @description Missed with no identifiable patient. */
+                    unlinked: number;
+                };
+                rule_no_show: string;
+                rule_recovered: string;
+            };
+            confirmation: {
+                applies: boolean;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                confirmed_attendance_pct: number | null;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                unconfirmed_attendance_pct: number | null;
+                confirmed_closed: number | null;
+                unconfirmed_closed: number | null;
+                rule: string;
+            };
+            ads: {
+                /** @enum {string} */
+                state: "active" | "not_active" | "unavailable";
+                spend_clp: number | null;
+                booked: number | null;
+                attended: number | null;
+                paid: number | null;
+                cost_per_booked: number | null;
+                cost_per_attended: number | null;
+                cost_per_paid: number | null;
+                rule: string;
+            };
+            reminders: {
+                applies: boolean;
+                sent: number;
+                failed: number;
+                /** @description Percent, one decimal. `null` — never 0 — with no denominator. */
+                failed_pct: number | null;
+                by_cause: {
+                    /** @enum {string} */
+                    cause: "no_patient_link" | "no_phone" | "no_channel" | "opted_out" | "template_not_approved" | "meta_payment_block" | "no_whatsapp" | "window_closed" | "template_rejected" | "send_error";
+                    count: number;
+                }[];
+                rule: string;
+            };
+            truncated: boolean;
+        };
         ClinicComercialReport: {
             from: string;
             to: string;
@@ -123178,6 +124867,180 @@ interface components {
              */
             handoff_id?: string;
         };
+        AdsReportRow: {
+            spend: number | null;
+            /** @description Vitrina’s own funnel: conversations each ad OPENED in the period and the stages recorded against them (a campaign / ad set sums its ads). `null` = unknown (the read failed), never 0. */
+            funnel: {
+                conversations: number | null;
+                replied: number | null;
+                appointments: number | null;
+                attended: number | null;
+                closes: number | null;
+            };
+            cost_per: {
+                conversation: number | null;
+                appointment: number | null;
+                attended: number | null;
+                close: number | null;
+            };
+            /** @description Payments credited to the entity (CLP). Cash only. */
+            cash: number | null;
+            /** @description cash ÷ spend. `null` when no payment was recorded in the period (see `cash_recorded`) — the return is unknown then, never 0×. */
+            return: number | null;
+            /** @description Meta’s OWN figures (its 7-day window, every sender) — never added to Vitrina’s. */
+            meta: {
+                conversations_started: number | null;
+                cost_per_conversation: number | null;
+            };
+            /** @description Platform id; `null` for the unmapped bucket. */
+            external_id: string | null;
+            /** @enum {string} */
+            level: "campaign" | "ad_set" | "ad";
+            name: string;
+            /** @description An ad’s ad set / an ad set’s campaign; `null` for a campaign. */
+            parent: {
+                external_id: string | null;
+                name: string | null;
+            } | null;
+            thumbnail_url: string | null;
+            /** @description Daily spend, oldest first; `null` unread. */
+            spark: number[] | null;
+            /**
+             * @description Ads that opened conversations but have no row at this level yet.
+             * @enum {boolean}
+             */
+            unmapped?: true;
+        };
+        AdsReport: {
+            /** @enum {string} */
+            level: "campaign" | "ad_set" | "ad";
+            window: {
+                from: string;
+                to: string;
+            };
+            rows: components["schemas"]["AdsReportRow"][];
+            /** @description «Sin anuncio»: the period’s conversations with no ad behind them. `null` = unknown. */
+            tail: {
+                /** @enum {string} */
+                key: "website" | "portals" | "direct";
+                conversations: number;
+            }[] | null;
+            totals: {
+                spend: number | null;
+                /** @description Vitrina’s own funnel: conversations each ad OPENED in the period and the stages recorded against them (a campaign / ad set sums its ads). `null` = unknown (the read failed), never 0. */
+                funnel: {
+                    conversations: number | null;
+                    replied: number | null;
+                    appointments: number | null;
+                    attended: number | null;
+                    closes: number | null;
+                };
+                cost_per: {
+                    conversation: number | null;
+                    appointment: number | null;
+                    attended: number | null;
+                    close: number | null;
+                };
+                /** @description Payments credited to the entity (CLP). Cash only. */
+                cash: number | null;
+                /** @description cash ÷ spend. `null` when no payment was recorded in the period (see `cash_recorded`) — the return is unknown then, never 0×. */
+                return: number | null;
+                /** @description Meta’s OWN figures (its 7-day window, every sender) — never added to Vitrina’s. */
+                meta: {
+                    conversations_started: number | null;
+                    cost_per_conversation: number | null;
+                };
+            };
+            /** @description Closes credited to an ad and their recorded value — PIPELINE, never in `return`. */
+            pipeline: {
+                closed_count: number;
+                closed_value: number;
+            } | null;
+            cash_recorded: boolean;
+            reconciliation: {
+                overview_spend: number | null;
+                spend_matches: boolean | null;
+                conversations_total: number | null;
+                conversations_from_ads: number | null;
+                conversations_without_ad: number | null;
+            };
+        };
+        AdsAdSheet: {
+            /** @description The creative and the delivery metrics; `null` when the engine read failed. */
+            ad: {
+                external_id: string;
+                name: string;
+                ad_set: {
+                    external_id: string | null;
+                    name: string | null;
+                } | null;
+                campaign: {
+                    external_id: string;
+                } | null;
+                thumbnail_url: string | null;
+                title: string | null;
+                body: string | null;
+                has_video: boolean;
+                spend: number | null;
+                impressions: number;
+                clicks: number;
+                ctr: number;
+                cpm: number;
+                cpc: number;
+                cash_count: number;
+                cash_value: number;
+                meta_conversations_started: number | null;
+            } | null;
+            window: {
+                from: string;
+                to: string;
+            };
+            /** @description The same figures as the Reporte row for this ad. */
+            row: {
+                spend: number | null;
+                /** @description Vitrina’s own funnel: conversations each ad OPENED in the period and the stages recorded against them (a campaign / ad set sums its ads). `null` = unknown (the read failed), never 0. */
+                funnel: {
+                    conversations: number | null;
+                    replied: number | null;
+                    appointments: number | null;
+                    attended: number | null;
+                    closes: number | null;
+                };
+                cost_per: {
+                    conversation: number | null;
+                    appointment: number | null;
+                    attended: number | null;
+                    close: number | null;
+                };
+                /** @description Payments credited to the entity (CLP). Cash only. */
+                cash: number | null;
+                /** @description cash ÷ spend. `null` when no payment was recorded in the period (see `cash_recorded`) — the return is unknown then, never 0×. */
+                return: number | null;
+                /** @description Meta’s OWN figures (its 7-day window, every sender) — never added to Vitrina’s. */
+                meta: {
+                    conversations_started: number | null;
+                    cost_per_conversation: number | null;
+                };
+            };
+            cash_recorded: boolean;
+            /** @description The conversations this ad opened, newest first. Healthcare: always initials. Elsewhere a name only with `contacts:read`. No export. */
+            people: {
+                /** Format: uuid */
+                conversation_id: string;
+                /** Format: uuid */
+                contact_id: string | null;
+                /** @description Initials, or the name where allowed. Never a phone or an e-mail. */
+                label: string;
+                masked: boolean;
+                stage: string | null;
+                stage_at: string | null;
+                opened_at: string;
+                value: number | null;
+            }[];
+            people_more: boolean;
+            /** @description The caller lacks `contacts:read`: `people` is empty on purpose. */
+            people_hidden: boolean;
+        };
         AdsOverviewDay: {
             date: string;
             /** @description `null` exactly when the engine could not scope spend. */
@@ -123189,6 +125052,21 @@ interface components {
             /** @description `true` on the day still running (today, America/Santiago): end the solid line before it. */
             partial: boolean;
         };
+        AdsGap: {
+            /** @description First day with missing data, YYYY-MM-DD. */
+            from: string;
+            /** @description Last day with missing data, YYYY-MM-DD; `null` = still ongoing. */
+            to: string | null;
+            /**
+             * @description What broke: `meta_disconnected` / `meta_stale` (the ad account read), `tag_silent` (the site tag stopped reporting), `capi_failing` (the Conversions API sends), `whatsapp_disconnected`, `engine_facts_missing` (clinic payments/plans not reaching the attribution).
+             * @enum {string}
+             */
+            cause: "meta_disconnected" | "meta_stale" | "tag_silent" | "capi_failing" | "whatsapp_disconnected" | "engine_facts_missing";
+            /** @description The figures UNKNOWN inside the gap: draw them as missing (a break in the line, «sin datos»), never as 0. Empty = nothing Vitrina shows is blanked; the window is annotated only. */
+            metrics: ("spend" | "conversations" | "outcomes")[];
+            /** Format: uuid */
+            incident_id: string;
+        };
         AdsOverview: {
             current: {
                 spend: number | null;
@@ -123256,6 +125134,44 @@ interface components {
             days?: components["schemas"]["AdsOverviewDay"][];
             /** @description `grain=day` only: every day of the previous window of equal length. */
             previous_days?: components["schemas"]["AdsOverviewDay"][];
+            /** @description Measurement gaps overlapping the window (W1.1). Days inside a gap whose `metrics` list a figure carry NO measured value for it — the engine may report 0 there; render «sin datos», never the 0. */
+            gaps: components["schemas"]["AdsGap"][];
+        };
+        AdsMeasurementIncident: {
+            /** Format: uuid */
+            id: string;
+            /** @enum {string} */
+            cause: "meta_disconnected" | "meta_stale" | "tag_silent" | "capi_failing" | "whatsapp_disconnected" | "engine_facts_missing";
+            /** @description «Meta Ads desconectado». */
+            label: string;
+            /** @description «Tus anuncios de Meta dejaron de medirse el 12 sep». */
+            sentence: string;
+            /** @description The one primary action. */
+            action: {
+                /** @description «Reconectar Meta». */
+                label: string;
+                /** @description Workspace-relative path of the ONE fix, e.g. `/anuncios/activar?paso=meta`. */
+                path: string;
+            };
+            /** @description When the data stopped (ISO instant). */
+            since: string;
+            /** @description When the watchdog opened it (ISO). */
+            opened_at: string;
+            resolved_at: string | null;
+            /**
+             * @description `reconnected` — a member fixed it; `recovered` — the leg came back on its own; `withdrawn` — it was switched off on purpose.
+             * @enum {string|null}
+             */
+            resolution: "reconnected" | "recovered" | "withdrawn" | null;
+            /** @description The member who fixed it. `null` when it recovered on its own, or when the caller lacks `memberships:read`. */
+            resolved_by_name: string | null;
+            metrics: ("spend" | "conversations" | "outcomes")[];
+        };
+        AdsMeasurement: {
+            /** @description Open incidents, oldest first — the banner. */
+            open: components["schemas"]["AdsMeasurementIncident"][];
+            /** @description Incidents resolved in the last 14 days, newest first. */
+            recent: components["schemas"]["AdsMeasurementIncident"][];
         };
         /** @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: {
@@ -123314,6 +125230,8 @@ interface components {
                 }[] | null;
                 conversational?: components["schemas"]["AdsConversational"];
             }[];
+            /** @description Measurement gaps overlapping the window (W1.1). Days inside a gap whose `metrics` list a figure carry NO measured value for it — the engine may report 0 there; render «sin datos», never the 0. */
+            gaps: components["schemas"]["AdsGap"][];
         };
         AdsAttributedSales: {
             data: {