@vitrina/api 13.5.0 → 13.7.0

package/dist/index.d.cts

@@ -7451,7 +7451,7 @@ interface paths {
         };
         /**
          * Get the funnel report
-         * @description The board's Pasos del embudo (ADR 0132) with the number of leads that reached each one in the period, the conversion from the step before, the split by stage inside each step, and Perdido apart. Counts only: this is the door the aggregates-only Consultor seat reads, next to `boards` lists the sales boards that can be read (id + name) so a board picker needs no other scope; `pipeline_id` selects one. `leads:read`. WHAT A COUNT MEANS. The cohort is the leads of the board CREATED in the period (`from` to `to`, both days inclusive, in the workspace clock). A lead counts in a step when it has ever stood on a stage of that step OR OF A LATER ONE — from its stage history, or from its current stage when it has none — so a lead that skipped a step still counts for the steps before it, and every cohort lead counts in the first step. The cohort is fixed by the creation date but how far it got is read as of now: a lead created in the period and sold next month counts in the last step the next time you look. `current` is where the cohort stands today. `lost` is the cohort leads standing on a lost stage today, split by the step they were lost from; `step_key: null` is history that cannot say (never guessed into a step). `sum(steps[].current) + lost.total + unplaced = cohort`.
+         * @description The board's Pasos del embudo (ADR 0132) with the number of leads that reached each one in the period, the conversion from the step before, the split by stage inside each step, and Perdido apart. Counts only: this is the door the aggregates-only Consultor seat reads, next to `boards` lists the sales boards that can be read (id + name) so a board picker needs no other scope; `pipeline_id` selects one. The last step (Venta) carries `money`: what its people paid since their lead was created (`null` = more than 2 000 people, or unknown). `leads:read`. WHAT A COUNT MEANS. The cohort is the leads of the board CREATED in the period (`from` to `to`, both days inclusive, in the workspace clock). A lead counts in a step when it has ever stood on a stage of that step OR OF A LATER ONE — from its stage history, or from its current stage when it has none — so a lead that skipped a step still counts for the steps before it, and every cohort lead counts in the first step. The cohort is fixed by the creation date but how far it got is read as of now: a lead created in the period and sold next month counts in the last step the next time you look. `current` is where the cohort stands today. `lost` is the cohort leads standing on a lost stage today, split by the step they were lost from; `step_key: null` is history that cannot say (never guessed into a step). `sum(steps[].current) + lost.total + unplaced = cohort`.
          */
         get: {
             parameters: {
@@ -7517,7 +7517,8 @@ interface paths {
                          *             "current": 14,
                          *             "conversion_from_previous": 0.4,
                          *             "conversion_from_start": 0.4,
-                         *             "stages": []
+                         *             "stages": [],
+                         *             "money": 3450000
                          *           }
                          *         ],
                          *         "lost": {
@@ -7813,7 +7814,7 @@ interface paths {
         };
         /**
          * List the people behind a funnel count
-         * @description The leads behind one number of `GET /funnel-report`, read through the same cohort and the same rules, so the list always has as many rows as the count says (`total`). `measure=reached&step=` is a step headline; `measure=current` is who stands there today; `measure=lost` is Perdido (narrow with `step`, or `lost_from_unknown=true`); `measure=unplaced` is the leads on a stage that belongs to no step. Add `stage_id` for one stage of a step. Newest activity first. Needs `leads:read`; the contact name rides only with `contacts:read`. WHAT A COUNT MEANS. The cohort is the leads of the board CREATED in the period (`from` to `to`, both days inclusive, in the workspace clock). A lead counts in a step when it has ever stood on a stage of that step OR OF A LATER ONE — from its stage history, or from its current stage when it has none — so a lead that skipped a step still counts for the steps before it, and every cohort lead counts in the first step. The cohort is fixed by the creation date but how far it got is read as of now: a lead created in the period and sold next month counts in the last step the next time you look. `current` is where the cohort stands today. `lost` is the cohort leads standing on a lost stage today, split by the step they were lost from; `step_key: null` is history that cannot say (never guessed into a step). `sum(steps[].current) + lost.total + unplaced = cohort`.
+         * @description The leads behind one number of `GET /funnel-report`, read through the same cohort and the same rules, so the list always has as many rows as the count says (`total`). `measure=reached&step=` is a step headline; `measure=current` is who stands there today; `measure=lost` is Perdido (narrow with `step`, or `lost_from_unknown=true`); `measure=unplaced` is the leads on a stage that belongs to no step. Add `stage_id` for one stage of a step. Newest activity first. Needs `leads:read`; the contact name and phone ride only with `contacts:read`. D60: each person also carries `score` and `score_reason` («qué pasó»), `lost_reason` («motivo»), the next cita (else the last, `cita_at`/`cita_status`), `paid` (CLP the clinic recorded since the lead was created) and, for a clinic, `origin` (Meta naming the ad, Orgánico, Sin dato). WHAT A COUNT MEANS. The cohort is the leads of the board CREATED in the period (`from` to `to`, both days inclusive, in the workspace clock). A lead counts in a step when it has ever stood on a stage of that step OR OF A LATER ONE — from its stage history, or from its current stage when it has none — so a lead that skipped a step still counts for the steps before it, and every cohort lead counts in the first step. The cohort is fixed by the creation date but how far it got is read as of now: a lead created in the period and sold next month counts in the last step the next time you look. `current` is where the cohort stands today. `lost` is the cohort leads standing on a lost stage today, split by the step they were lost from; `step_key: null` is history that cannot say (never guessed into a step). `sum(steps[].current) + lost.total + unplaced = cohort`.
          */
         get: {
             parameters: {
@@ -7878,7 +7879,24 @@ interface paths {
                          *             "last_activity_at": "2026-10-08T09:30:00.000Z",
                          *             "last_move_at": "2026-09-20T16:00:00.000Z",
                          *             "last_move_stage_name": "Evaluación agendada",
-                         *             "reached_step_key": "scheduled"
+                         *             "reached_step_key": "scheduled",
+                         *             "phone": "+56 9 1234 5678",
+                         *             "score": 72,
+                         *             "score_reason": "Pidió hora para evaluación de implante; preguntó por cuotas.",
+                         *             "lost_reason": null,
+                         *             "cita_at": "2026-10-14T13:00:00.000Z",
+                         *             "cita_status": "confirmed",
+                         *             "paid": 45000,
+                         *             "origin": {
+                         *               "kind": "meta",
+                         *               "label": "Meta · Implantes 2",
+                         *               "ad_id": "120210000000000101",
+                         *               "ad_name": "Implantes 2",
+                         *               "ad_set_name": "INTERESES",
+                         *               "campaign_name": "IMPLANTES",
+                         *               "first_touch_at": "2026-09-12T14:01:00.000Z",
+                         *               "via": "first_message"
+                         *             }
                          *           }
                          *         ]
                          *       }
@@ -12690,7 +12708,7 @@ interface paths {
                     "application/json": {
                         /** Format: uri */
                         url?: string;
-                        events?: ("*" | "ai_agent.publish" | "ai_agent_graph.publish" | "agent_scenario_run.completed" | "agent_scenario_suite.completed" | "conversation.created" | "conversation.assigned" | "conversation.resolved" | "message.received" | "message.sent" | "ticket.opened" | "ticket.reopened" | "ticket.resolved" | "ticket.closed" | "sla.breached" | "kb.source.create" | "kb.source.embed" | "kb.source.update" | "kb.source.delete" | "kb_file.uploaded" | "kb_file.deleted" | "skill.created" | "skill.updated" | "skill.deleted" | "custom_tool.created" | "custom_tool.updated" | "custom_tool.deleted" | "macro.applied" | "cost.budget_alert" | "runtime.budget_exceeded" | "lead.created" | "lead.stage_changed" | "lead.pipeline_changed" | "lead.assigned" | "lead.won" | "lead.lost" | "lead.unqualified" | "stock.synced" | "stock.source_retired" | "vehicle.published" | "vehicle.unpublished" | "vehicle.publish_failed" | "vehicle.created" | "vehicle.attachment.created" | "mercadolibre.order" | "mercadolibre.vis_lead" | "chileautos.lead" | "yapo.lead" | "website.lead" | "demo_lead.created" | "demo_lead.pending_scheduling" | "demo_lead.routed" | "demo_booking.booked" | "demo_booking.rescheduled" | "demo_booking.cancelled" | "consignment.candidate.created" | "quote.issued" | "quote.voided" | "quote.extended" | "quote.archived" | "reservation.created" | "reservation.voided" | "reservation.abono_disposed" | "reservation.converted" | "sale_note.issued" | "sale_note.approved" | "sale_note.voided" | "purchase_note.issued" | "purchase_note.corrected" | "purchase_note.voided" | "payment.recorded" | "consignment.created" | "consignment.returned" | "consignment.sold" | "credit_application.recorded" | "credit_application.submitted" | "credit_application.decided" | "credit_application.withdrawn" | "price_approval.requested" | "price_approval.decided" | "contact.created" | "contact.updated" | "contact.merged" | "appointment.booked" | "appointment.rescheduled" | "appointment.cancelled" | "appointment.completed" | "appointment.no_show" | "appointment.reminded" | "appointment.imported" | "campaign.sent" | "campaign.paused" | "sending_domain.verified" | "coach.proposals_ready" | "coach.finding_ready" | "voice.autonomous_call" | "safety_hold.placed" | "safety_hold.ack_overdue" | "safety_hold.first_response_overdue" | "team.created" | "team.updated" | "team.deleted" | "custom_role.created" | "custom_role.updated" | "custom_role.deleted" | "macro.created" | "macro.updated" | "macro.deleted" | "assignment_rule.created" | "assignment_rule.updated" | "assignment_rule.deleted" | "sla_policy.created" | "sla_policy.updated" | "sla_policy.deleted" | "automation_trigger.created" | "automation_trigger.updated" | "automation_trigger.deleted" | "sending_domain.created" | "sending_domain.deleted" | "whatsapp_template.created" | "whatsapp_template.status_changed" | "whatsapp_template.deleted" | "whatsapp_flow.created" | "whatsapp_flow.published" | "whatsapp_flow.deprecated" | "whatsapp_flow.deleted" | "whatsapp_flow.completed" | "channel.connected" | "channel.updated" | "channel.disconnected" | "membership.created" | "membership.updated" | "membership.removed" | "clinic_professional.created" | "clinic_professional.updated" | "clinic_professional.deleted" | "clinic_service.created" | "clinic_service.updated" | "clinic_service.deleted" | "clinic_price_list.updated" | "clinic_pack_purchase.created" | "clinic_pack_purchase.session_consumed" | "clinic_pack_purchase.cancelled" | "clinic_budget.created" | "clinic_budget.sent" | "clinic_budget.accepted" | "clinic_budget.rejected" | "clinic_budget.voided" | "clinic_budget.mirror_changed" | "clinic_cash_session.opened" | "clinic_cash_session.closed" | "clinic_patient.created" | "clinic_patient.updated" | "clinic_patient.deleted" | "clinic_patient.merged" | "clinic_encounter.opened" | "clinic_encounter.closed" | "clinic_note.signed" | "clinic_note.amended" | "clinic_consent.signed" | "clinic_consent.revoked" | "clinic_document.uploaded" | "clinic_document.deleted" | "clinic_privacy_request.completed")[];
+                        events?: ("*" | "ai_agent.publish" | "ai_agent_graph.publish" | "agent_scenario_run.completed" | "agent_scenario_suite.completed" | "conversation.created" | "conversation.assigned" | "conversation.resolved" | "message.received" | "message.sent" | "ticket.opened" | "ticket.reopened" | "ticket.resolved" | "ticket.closed" | "sla.breached" | "kb.source.create" | "kb.source.embed" | "kb.source.update" | "kb.source.delete" | "kb_file.uploaded" | "kb_file.deleted" | "skill.created" | "skill.updated" | "skill.deleted" | "custom_tool.created" | "custom_tool.updated" | "custom_tool.deleted" | "macro.applied" | "cost.budget_alert" | "runtime.budget_exceeded" | "lead.created" | "lead.stage_changed" | "lead.pipeline_changed" | "lead.assigned" | "lead.won" | "lead.lost" | "lead.unqualified" | "stock.synced" | "stock.source_retired" | "vehicle.published" | "vehicle.unpublished" | "vehicle.publish_failed" | "vehicle.created" | "vehicle.attachment.created" | "mercadolibre.order" | "mercadolibre.vis_lead" | "chileautos.lead" | "yapo.lead" | "website.lead" | "demo_lead.created" | "demo_lead.pending_scheduling" | "demo_lead.routed" | "demo_booking.booked" | "demo_booking.rescheduled" | "demo_booking.cancelled" | "demo_booking.held" | "demo_booking.no_show" | "consignment.candidate.created" | "quote.issued" | "quote.voided" | "quote.extended" | "quote.archived" | "reservation.created" | "reservation.voided" | "reservation.abono_disposed" | "reservation.converted" | "sale_note.issued" | "sale_note.approved" | "sale_note.voided" | "purchase_note.issued" | "purchase_note.corrected" | "purchase_note.voided" | "payment.recorded" | "consignment.created" | "consignment.returned" | "consignment.sold" | "credit_application.recorded" | "credit_application.submitted" | "credit_application.decided" | "credit_application.withdrawn" | "price_approval.requested" | "price_approval.decided" | "contact.created" | "contact.updated" | "contact.merged" | "appointment.booked" | "appointment.rescheduled" | "appointment.cancelled" | "appointment.completed" | "appointment.no_show" | "appointment.reminded" | "appointment.imported" | "campaign.sent" | "campaign.paused" | "sending_domain.verified" | "coach.proposals_ready" | "coach.finding_ready" | "voice.autonomous_call" | "safety_hold.placed" | "safety_hold.ack_overdue" | "safety_hold.first_response_overdue" | "team.created" | "team.updated" | "team.deleted" | "custom_role.created" | "custom_role.updated" | "custom_role.deleted" | "macro.created" | "macro.updated" | "macro.deleted" | "assignment_rule.created" | "assignment_rule.updated" | "assignment_rule.deleted" | "sla_policy.created" | "sla_policy.updated" | "sla_policy.deleted" | "automation_trigger.created" | "automation_trigger.updated" | "automation_trigger.deleted" | "sending_domain.created" | "sending_domain.deleted" | "whatsapp_template.created" | "whatsapp_template.status_changed" | "whatsapp_template.deleted" | "whatsapp_flow.created" | "whatsapp_flow.published" | "whatsapp_flow.deprecated" | "whatsapp_flow.deleted" | "whatsapp_flow.completed" | "channel.connected" | "channel.updated" | "channel.disconnected" | "membership.created" | "membership.updated" | "membership.removed" | "clinic_professional.created" | "clinic_professional.updated" | "clinic_professional.deleted" | "clinic_service.created" | "clinic_service.updated" | "clinic_service.deleted" | "clinic_price_list.updated" | "clinic_pack_purchase.created" | "clinic_pack_purchase.session_consumed" | "clinic_pack_purchase.cancelled" | "clinic_budget.created" | "clinic_budget.sent" | "clinic_budget.accepted" | "clinic_budget.rejected" | "clinic_budget.voided" | "clinic_budget.mirror_changed" | "clinic_cash_session.opened" | "clinic_cash_session.closed" | "clinic_patient.created" | "clinic_patient.updated" | "clinic_patient.deleted" | "clinic_patient.merged" | "clinic_encounter.opened" | "clinic_encounter.closed" | "clinic_note.signed" | "clinic_note.amended" | "clinic_consent.signed" | "clinic_consent.revoked" | "clinic_document.uploaded" | "clinic_document.deleted" | "clinic_privacy_request.completed")[];
                         enabled?: boolean;
                         description?: string | null;
                         /** @description «Incluir datos del recurso». `false` (the default) = every delivery is the notice: resource, changes, author, time and `url`, with `data_omitted: "not_requested"`. `true` = each delivery also carries `data` when, at dispatch time, this subscription's OWNER — whoever created it or last changed its url, events or this flag — holds the resource read scope (`read_scope` in the catalogue) and sees every record; otherwise `data_omitted` says why. An event about a dato sensible is always the notice. */
@@ -82748,7 +82766,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/appointment-types": {
+    "/appointments/reminders/plan": {
         parameters: {
             query?: never;
             header?: never;
@@ -82756,27 +82774,19 @@ interface paths {
             cookie?: never;
         };
         /**
-         * List appointment types
-         * @description The per-tenant bookable catalogue, which is ALSO the «Servicios» catalogue: a servicio is an appointment type with a price (there is no `/services` resource). `kind` and `active_only` are the screen’s tabs and `q` is its search box — free text over name AND description, case-insensitive, with `%` and `_` escaped so "50% off" is a literal rather than a wildcard. All three COMPOSE: `?kind=service&active_only=true&q=limpieza` is "the active services whose name or description mentions limpieza". An empty or omitted `q` is simply no text filter.
-         *
-         *     ELIMINATED types (`deleted_at` non-null, see `DELETE /appointment-types/{id}`) are excluded from EVERY combination of these filters — including `active_only=false`, so they never come back as "inactivos". Every row returned here therefore carries `deleted_at: null`; the field is on the wire as an audit fact, not as a state to branch on.
-         *
-         *     `price_amount` is `null` for «a consultar» and `0` for free of charge — never interchange them, because a client renders one as a price and the other as an invitation to ask. `price_is_from` marks it as a floor («desde $35.000»). `price_currency` is a 3-letter ISO-4217 code, upper-cased on the way in, and `price_clp` is the same amount in pesos for a workspace that prices in another currency.
+         * Get the appointment reminder ladder
+         * @description The rungs, the single-sender declaration, whether anything is being sent right now (`live`) and `blocked_reason` when it is not. A rung has an `event` (`before_start` by default, `booked` for the welcome right after booking, `no_show` for the rebook with three fresh slots), an `email` mode (`never` / `fallback` / `also`, the twin with a .ics) and optional per-kind WhatsApp `templates` (`demo`, `clinic`, `visit`, `generic`). Off for every tenant until its owner saves a plan and declares Vitrina the single sender.
          */
         get: {
             parameters: {
-                query?: {
-                    kind?: ("test_drive" | "external" | "service")[];
-                    active_only?: boolean | null;
-                    q?: string;
-                };
+                query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Appointment types */
+                /** @description Reminder plan */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -82784,52 +82794,62 @@ interface paths {
                     content: {
                         /**
                          * @example {
-                         *       "data": [
-                         *         {
-                         *           "id": "eeee0000-0000-4000-8000-000000000001",
-                         *           "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
-                         *           "name": "Consulta de evaluación",
-                         *           "description": "Primera visita: revisión y presupuesto.",
-                         *           "kind": "service",
-                         *           "engine": "native",
-                         *           "external_ref": null,
-                         *           "buffer_minutes": null,
-                         *           "duration_minutes": 45,
-                         *           "price_amount": 35000,
-                         *           "price_clp": 35000,
-                         *           "price_currency": "CLP",
-                         *           "price_is_from": true,
-                         *           "eligible_staff_ids": [],
-                         *           "is_active": true,
-                         *           "is_default": false,
-                         *           "deleted_at": null,
-                         *           "created_at": "2026-09-22T12:50:27.458Z",
-                         *           "updated_at": "2026-09-22T12:50:27.458Z"
-                         *         },
-                         *         {
-                         *           "id": "eeee0000-0000-4000-8000-000000000002",
-                         *           "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
-                         *           "name": "Test drive",
-                         *           "description": "Prueba de manejo de 30 minutos, con ejecutivo.",
-                         *           "kind": "test_drive",
-                         *           "engine": "native",
-                         *           "external_ref": null,
-                         *           "buffer_minutes": null,
-                         *           "duration_minutes": 30,
-                         *           "price_amount": null,
-                         *           "price_clp": null,
-                         *           "price_currency": "CLP",
-                         *           "price_is_from": false,
-                         *           "eligible_staff_ids": [],
-                         *           "is_active": true,
-                         *           "is_default": true,
-                         *           "deleted_at": null,
-                         *           "created_at": "2026-06-02T11:02:10.004Z",
-                         *           "updated_at": "2026-06-02T11:02:10.004Z"
-                         *         }
-                         *       ],
-                         *       "meta": {
-                         *         "total": 2
+                         *       "data": {
+                         *         "id": "0198f3c2-6d1e-7a52-9c5b-3f1d2e7a4b10",
+                         *         "name": "Recordatorios de cita",
+                         *         "rungs": [
+                         *           {
+                         *             "key": "welcome",
+                         *             "event": "booked",
+                         *             "offset_hours": 0,
+                         *             "channel": "whatsapp",
+                         *             "email": "also",
+                         *             "template_name": null,
+                         *             "templates": {
+                         *               "demo": "demo_confirmada_v1"
+                         *             },
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": true
+                         *           },
+                         *           {
+                         *             "key": "h24",
+                         *             "offset_hours": 24,
+                         *             "channel": "whatsapp",
+                         *             "email": "fallback",
+                         *             "template_name": "recordatorio_24h",
+                         *             "asks_confirmation": true,
+                         *             "include_reschedule_link": true
+                         *           },
+                         *           {
+                         *             "key": "h2",
+                         *             "offset_hours": 2,
+                         *             "channel": "whatsapp",
+                         *             "template_name": "recordatorio_2h",
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": false
+                         *           },
+                         *           {
+                         *             "key": "no_show",
+                         *             "event": "no_show",
+                         *             "offset_hours": 0.17,
+                         *             "channel": "whatsapp",
+                         *             "email": "fallback",
+                         *             "template_name": "reagendar",
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": true
+                         *           }
+                         *         ],
+                         *         "active": true,
+                         *         "single_sender_confirmed_at": "2026-10-11T12:00:00.000Z",
+                         *         "single_sender_confirmed_by": null,
+                         *         "vendor_sends_reminders": false,
+                         *         "live": true,
+                         *         "blocked_reason": null,
+                         *         "defaults": [],
+                         *         "updated_at": "2026-10-11T12:00:00.000Z",
+                         *         "confirm_status_id": null,
+                         *         "confirm_status": null,
+                         *         "create_contacts_from_patient_phone": false
                          *       }
                          *     }
                          */
@@ -82897,26 +82917,14 @@ interface paths {
                 };
             };
         };
-        put?: never;
         /**
-         * Create an appointment type
-         * @description Adds a bookable type to the catalogue — a servicio once it carries a price. `duration_minutes` is what sets the slot LENGTH when this type is booked, while the agenda grid stays `slot_minutes` (`GET /appointments/config`).
-         *
-         *     `eligible_staff_ids` narrows who may take it: booking assigns round-robin from that pool, and an empty list means the workspace’s whole sales/professional team. `kind` defaults to `external`.
-         *
-         *     The NAME is unique among the live rows, so re-creating a type you eliminated is allowed and yields a NEW id.
-         *
-         *     `price_amount` is `null` for «a consultar» and `0` for free of charge — never interchange them, because a client renders one as a price and the other as an invitation to ask. `price_is_from` marks it as a floor («desde $35.000»). `price_currency` is a 3-letter ISO-4217 code, upper-cased on the way in, and `price_clp` is the same amount in pesos for a workspace that prices in another currency.
-         *
-         *     **Depósito / abono.** The deposit rule for this service is NOT on this resource: it is a `deposit_policy` row scoped to `appointment_type`, read and written through `GET|PUT /deposit-policies`. Each booking still takes a SNAPSHOT — the resolved amount and deadline land on the cita’s own `customer_obligation` — so editing the policy never changes what an already-booked customer was told to transfer.
+         * Save the appointment reminder ladder
+         * @description Replaces the rungs. 400 `single_sender_not_confirmed` when `active` is requested without the declaration. Outside the 24 h WhatsApp window a rung needs an APPROVED template on the number (named variables: `nombre`, `fecha`, `hora`, `anfitrion`, `reunion`, `enlace`, `opcion_1`..`opcion_3`); with `email: "fallback"` a missing template falls back to email instead of staying silent.
          */
-        post: {
+        put: {
             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;
-                };
+                header?: never;
                 path?: never;
                 cookie?: never;
             };
@@ -82924,149 +82932,88 @@ interface paths {
                 content: {
                     /**
                      * @example {
-                     *       "name": "Consulta de evaluación",
-                     *       "description": "Primera visita: revisión y presupuesto.",
-                     *       "kind": "service",
-                     *       "duration_minutes": 45,
-                     *       "price_amount": 35000,
-                     *       "price_currency": "CLP",
-                     *       "price_is_from": true
+                     *       "rungs": [
+                     *         {
+                     *           "key": "welcome",
+                     *           "event": "booked",
+                     *           "offset_hours": 0,
+                     *           "channel": "whatsapp",
+                     *           "email": "also",
+                     *           "template_name": null,
+                     *           "templates": {
+                     *             "demo": "demo_confirmada_v1"
+                     *           },
+                     *           "asks_confirmation": false,
+                     *           "include_reschedule_link": true
+                     *         },
+                     *         {
+                     *           "key": "h24",
+                     *           "offset_hours": 24,
+                     *           "channel": "whatsapp",
+                     *           "email": "fallback",
+                     *           "template_name": "recordatorio_24h",
+                     *           "asks_confirmation": true,
+                     *           "include_reschedule_link": true
+                     *         },
+                     *         {
+                     *           "key": "h2",
+                     *           "offset_hours": 2,
+                     *           "channel": "whatsapp",
+                     *           "template_name": "recordatorio_2h",
+                     *           "asks_confirmation": false,
+                     *           "include_reschedule_link": false
+                     *         },
+                     *         {
+                     *           "key": "no_show",
+                     *           "event": "no_show",
+                     *           "offset_hours": 0.17,
+                     *           "channel": "whatsapp",
+                     *           "email": "fallback",
+                     *           "template_name": "reagendar",
+                     *           "asks_confirmation": false,
+                     *           "include_reschedule_link": true
+                     *         }
+                     *       ],
+                     *       "active": true
                      *     }
                      */
                     "application/json": {
-                        name: string;
-                        description?: string | null;
-                        /** @enum {string} */
-                        kind?: "test_drive" | "external" | "service";
-                        duration_minutes: number;
-                        price_amount?: number | null;
-                        price_currency?: string;
-                        price_is_from?: boolean;
-                        eligible_staff_ids?: string[];
-                        is_active?: boolean;
-                    };
-                };
-            };
-            responses: {
-                /** @description Appointment type */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "id": "eeee0000-0000-4000-8000-000000000001",
-                         *       "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
-                         *       "name": "Consulta de evaluación",
-                         *       "description": "Primera visita: revisión y presupuesto.",
-                         *       "kind": "service",
-                         *       "engine": "native",
-                         *       "external_ref": null,
-                         *       "buffer_minutes": null,
-                         *       "duration_minutes": 45,
-                         *       "price_amount": 35000,
-                         *       "price_clp": 35000,
-                         *       "price_currency": "CLP",
-                         *       "price_is_from": true,
-                         *       "eligible_staff_ids": [],
-                         *       "is_active": true,
-                         *       "is_default": false,
-                         *       "deleted_at": null,
-                         *       "created_at": "2026-09-22T12:50:27.458Z",
-                         *       "updated_at": "2026-09-22T12:50:27.458Z"
-                         *     }
-                         */
-                        "application/json": {
-                            data?: 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"];
+                        name?: string;
+                        rungs: {
+                            key: string;
+                            offset_hours: number;
+                            /** @enum {string} */
+                            event?: "before_start" | "booked" | "no_show";
+                            /** @enum {string} */
+                            email?: "never" | "fallback" | "also";
+                            templates?: {
+                                demo?: string;
+                                clinic?: string;
+                                visit?: string;
+                                generic?: string;
+                            };
+                            /**
+                             * @default whatsapp
+                             * @enum {string}
+                             */
+                            channel?: "whatsapp" | "email";
+                            template_name?: string | null;
+                            /** @default false */
+                            asks_confirmation?: boolean;
+                            /** @default true */
+                            include_reschedule_link?: boolean;
+                        }[];
+                        active: boolean;
+                        vendor_sends_reminders?: boolean;
+                        /** Format: uuid */
+                        confirm_status_id?: string | null;
+                        create_contacts_from_patient_phone?: boolean;
+                        quiet_hours_enforced?: boolean;
                     };
                 };
             };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/appointment-types/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get an appointment type
-         * @description By uuid. An ELIMINATED type is a 404 here even though the appointments booked against it still resolve its name — the catalogue and the history answer different questions.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
             responses: {
-                /** @description Appointment type */
+                /** @description Reminder plan */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -83074,25 +83021,935 @@ interface paths {
                     content: {
                         /**
                          * @example {
-                         *       "id": "eeee0000-0000-4000-8000-000000000001",
-                         *       "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
-                         *       "name": "Consulta de evaluación",
-                         *       "description": "Primera visita: revisión y presupuesto.",
-                         *       "kind": "service",
-                         *       "engine": "native",
-                         *       "external_ref": null,
-                         *       "buffer_minutes": null,
-                         *       "duration_minutes": 45,
-                         *       "price_amount": 35000,
-                         *       "price_clp": 35000,
-                         *       "price_currency": "CLP",
-                         *       "price_is_from": true,
-                         *       "eligible_staff_ids": [],
-                         *       "is_active": true,
-                         *       "is_default": false,
-                         *       "deleted_at": null,
-                         *       "created_at": "2026-09-22T12:50:27.458Z",
-                         *       "updated_at": "2026-09-22T12:50:27.458Z"
+                         *       "data": {
+                         *         "id": "0198f3c2-6d1e-7a52-9c5b-3f1d2e7a4b10",
+                         *         "name": "Recordatorios de cita",
+                         *         "rungs": [
+                         *           {
+                         *             "key": "welcome",
+                         *             "event": "booked",
+                         *             "offset_hours": 0,
+                         *             "channel": "whatsapp",
+                         *             "email": "also",
+                         *             "template_name": null,
+                         *             "templates": {
+                         *               "demo": "demo_confirmada_v1"
+                         *             },
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": true
+                         *           },
+                         *           {
+                         *             "key": "h24",
+                         *             "offset_hours": 24,
+                         *             "channel": "whatsapp",
+                         *             "email": "fallback",
+                         *             "template_name": "recordatorio_24h",
+                         *             "asks_confirmation": true,
+                         *             "include_reschedule_link": true
+                         *           },
+                         *           {
+                         *             "key": "h2",
+                         *             "offset_hours": 2,
+                         *             "channel": "whatsapp",
+                         *             "template_name": "recordatorio_2h",
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": false
+                         *           },
+                         *           {
+                         *             "key": "no_show",
+                         *             "event": "no_show",
+                         *             "offset_hours": 0.17,
+                         *             "channel": "whatsapp",
+                         *             "email": "fallback",
+                         *             "template_name": "reagendar",
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": true
+                         *           }
+                         *         ],
+                         *         "active": true,
+                         *         "single_sender_confirmed_at": "2026-10-11T12:00:00.000Z",
+                         *         "single_sender_confirmed_by": null,
+                         *         "vendor_sends_reminders": false,
+                         *         "live": true,
+                         *         "blocked_reason": null,
+                         *         "defaults": [],
+                         *         "updated_at": "2026-10-11T12:00:00.000Z",
+                         *         "confirm_status_id": null,
+                         *         "confirm_status": null,
+                         *         "create_contacts_from_patient_phone": false
+                         *       }
+                         *     }
+                         */
+                        "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"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/appointments/reminders/plan/confirm-single-sender": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Declare Vitrina the single sender of reminders
+         * @description Records who declared that no other system reminds these people (the only thing that makes an active ladder legal). Reversible with POST /appointments/reminders/plan/revoke-single-sender.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Reminder plan */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "id": "0198f3c2-6d1e-7a52-9c5b-3f1d2e7a4b10",
+                         *         "name": "Recordatorios de cita",
+                         *         "rungs": [
+                         *           {
+                         *             "key": "welcome",
+                         *             "event": "booked",
+                         *             "offset_hours": 0,
+                         *             "channel": "whatsapp",
+                         *             "email": "also",
+                         *             "template_name": null,
+                         *             "templates": {
+                         *               "demo": "demo_confirmada_v1"
+                         *             },
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": true
+                         *           },
+                         *           {
+                         *             "key": "h24",
+                         *             "offset_hours": 24,
+                         *             "channel": "whatsapp",
+                         *             "email": "fallback",
+                         *             "template_name": "recordatorio_24h",
+                         *             "asks_confirmation": true,
+                         *             "include_reschedule_link": true
+                         *           },
+                         *           {
+                         *             "key": "h2",
+                         *             "offset_hours": 2,
+                         *             "channel": "whatsapp",
+                         *             "template_name": "recordatorio_2h",
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": false
+                         *           },
+                         *           {
+                         *             "key": "no_show",
+                         *             "event": "no_show",
+                         *             "offset_hours": 0.17,
+                         *             "channel": "whatsapp",
+                         *             "email": "fallback",
+                         *             "template_name": "reagendar",
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": true
+                         *           }
+                         *         ],
+                         *         "active": true,
+                         *         "single_sender_confirmed_at": "2026-10-11T12:00:00.000Z",
+                         *         "single_sender_confirmed_by": null,
+                         *         "vendor_sends_reminders": false,
+                         *         "live": true,
+                         *         "blocked_reason": null,
+                         *         "defaults": [],
+                         *         "updated_at": "2026-10-11T12:00:00.000Z",
+                         *         "confirm_status_id": null,
+                         *         "confirm_status": null,
+                         *         "create_contacts_from_patient_phone": false
+                         *       }
+                         *     }
+                         */
+                        "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;
+    };
+    "/appointments/reminders/plan/revoke-single-sender": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Stop sending reminders
+         * @description Clears the declaration and deactivates the ladder in the same write.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Replay-safe retries: resending the SAME key with the SAME body returns the original response (`X-Idempotent-Replay: 1`) instead of creating a second copy — safe to send whenever a response might not have arrived. The same key with a DIFFERENT body answers `409 IDEMPOTENCY_KEY_CONFLICT`; use a fresh key per operation. */
+                    "Idempotency-Key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Reminder plan */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "id": "0198f3c2-6d1e-7a52-9c5b-3f1d2e7a4b10",
+                         *         "name": "Recordatorios de cita",
+                         *         "rungs": [
+                         *           {
+                         *             "key": "welcome",
+                         *             "event": "booked",
+                         *             "offset_hours": 0,
+                         *             "channel": "whatsapp",
+                         *             "email": "also",
+                         *             "template_name": null,
+                         *             "templates": {
+                         *               "demo": "demo_confirmada_v1"
+                         *             },
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": true
+                         *           },
+                         *           {
+                         *             "key": "h24",
+                         *             "offset_hours": 24,
+                         *             "channel": "whatsapp",
+                         *             "email": "fallback",
+                         *             "template_name": "recordatorio_24h",
+                         *             "asks_confirmation": true,
+                         *             "include_reschedule_link": true
+                         *           },
+                         *           {
+                         *             "key": "h2",
+                         *             "offset_hours": 2,
+                         *             "channel": "whatsapp",
+                         *             "template_name": "recordatorio_2h",
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": false
+                         *           },
+                         *           {
+                         *             "key": "no_show",
+                         *             "event": "no_show",
+                         *             "offset_hours": 0.17,
+                         *             "channel": "whatsapp",
+                         *             "email": "fallback",
+                         *             "template_name": "reagendar",
+                         *             "asks_confirmation": false,
+                         *             "include_reschedule_link": true
+                         *           }
+                         *         ],
+                         *         "active": true,
+                         *         "single_sender_confirmed_at": "2026-10-11T12:00:00.000Z",
+                         *         "single_sender_confirmed_by": null,
+                         *         "vendor_sends_reminders": false,
+                         *         "live": true,
+                         *         "blocked_reason": null,
+                         *         "defaults": [],
+                         *         "updated_at": "2026-10-11T12:00:00.000Z",
+                         *         "confirm_status_id": null,
+                         *         "confirm_status": null,
+                         *         "create_contacts_from_patient_phone": false
+                         *       }
+                         *     }
+                         */
+                        "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;
+    };
+    "/appointments/reminders": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List sent appointment reminders
+         * @description The send ledger: one row per appointment per rung (and per email twin, keyed `<rung>_email`) with the outcome, the reason when skipped, the manage link that went out and the person's confirm/cancel reply.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                    offset?: number | null;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Appointment reminders */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "items": [
+                         *           {
+                         *             "id": "0198f3c2-6d1e-7a52-9c5b-3f1d2e7a4b11",
+                         *             "appointment_id": "0198f3c2-6d1e-7a52-9c5b-3f1d2e7a4b12",
+                         *             "rung_key": "welcome",
+                         *             "offset_minutes": 0,
+                         *             "channel": "whatsapp",
+                         *             "asks_confirmation": false,
+                         *             "template_name": "demo_confirmada_v1",
+                         *             "status": "sent",
+                         *             "reason_code": null,
+                         *             "detail": null,
+                         *             "conversation_id": "0198f3c2-6d1e-7a52-9c5b-3f1d2e7a4b13",
+                         *             "sent_at": "2026-10-11T12:01:00.000Z",
+                         *             "manage_url": null,
+                         *             "reply_kind": null,
+                         *             "reply_text": null,
+                         *             "replied_at": null,
+                         *             "applied_status_id": null,
+                         *             "apply_error": null,
+                         *             "created_at": "2026-10-11T12:01:00.000Z"
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "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;
+    };
+    "/appointment-types": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List appointment types
+         * @description The per-tenant bookable catalogue, which is ALSO the «Servicios» catalogue: a servicio is an appointment type with a price (there is no `/services` resource). `kind` and `active_only` are the screen’s tabs and `q` is its search box — free text over name AND description, case-insensitive, with `%` and `_` escaped so "50% off" is a literal rather than a wildcard. All three COMPOSE: `?kind=service&active_only=true&q=limpieza` is "the active services whose name or description mentions limpieza". An empty or omitted `q` is simply no text filter.
+         *
+         *     ELIMINATED types (`deleted_at` non-null, see `DELETE /appointment-types/{id}`) are excluded from EVERY combination of these filters — including `active_only=false`, so they never come back as "inactivos". Every row returned here therefore carries `deleted_at: null`; the field is on the wire as an audit fact, not as a state to branch on.
+         *
+         *     `price_amount` is `null` for «a consultar» and `0` for free of charge — never interchange them, because a client renders one as a price and the other as an invitation to ask. `price_is_from` marks it as a floor («desde $35.000»). `price_currency` is a 3-letter ISO-4217 code, upper-cased on the way in, and `price_clp` is the same amount in pesos for a workspace that prices in another currency.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    kind?: ("test_drive" | "external" | "service")[];
+                    active_only?: boolean | null;
+                    q?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Appointment types */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": [
+                         *         {
+                         *           "id": "eeee0000-0000-4000-8000-000000000001",
+                         *           "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
+                         *           "name": "Consulta de evaluación",
+                         *           "description": "Primera visita: revisión y presupuesto.",
+                         *           "kind": "service",
+                         *           "engine": "native",
+                         *           "external_ref": null,
+                         *           "buffer_minutes": null,
+                         *           "duration_minutes": 45,
+                         *           "price_amount": 35000,
+                         *           "price_clp": 35000,
+                         *           "price_currency": "CLP",
+                         *           "price_is_from": true,
+                         *           "eligible_staff_ids": [],
+                         *           "is_active": true,
+                         *           "is_default": false,
+                         *           "deleted_at": null,
+                         *           "created_at": "2026-09-22T12:50:27.458Z",
+                         *           "updated_at": "2026-09-22T12:50:27.458Z"
+                         *         },
+                         *         {
+                         *           "id": "eeee0000-0000-4000-8000-000000000002",
+                         *           "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
+                         *           "name": "Test drive",
+                         *           "description": "Prueba de manejo de 30 minutos, con ejecutivo.",
+                         *           "kind": "test_drive",
+                         *           "engine": "native",
+                         *           "external_ref": null,
+                         *           "buffer_minutes": null,
+                         *           "duration_minutes": 30,
+                         *           "price_amount": null,
+                         *           "price_clp": null,
+                         *           "price_currency": "CLP",
+                         *           "price_is_from": false,
+                         *           "eligible_staff_ids": [],
+                         *           "is_active": true,
+                         *           "is_default": true,
+                         *           "deleted_at": null,
+                         *           "created_at": "2026-06-02T11:02:10.004Z",
+                         *           "updated_at": "2026-06-02T11:02:10.004Z"
+                         *         }
+                         *       ],
+                         *       "meta": {
+                         *         "total": 2
+                         *       }
+                         *     }
+                         */
+                        "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;
+        /**
+         * Create an appointment type
+         * @description Adds a bookable type to the catalogue — a servicio once it carries a price. `duration_minutes` is what sets the slot LENGTH when this type is booked, while the agenda grid stays `slot_minutes` (`GET /appointments/config`).
+         *
+         *     `eligible_staff_ids` narrows who may take it: booking assigns round-robin from that pool, and an empty list means the workspace’s whole sales/professional team. `kind` defaults to `external`.
+         *
+         *     The NAME is unique among the live rows, so re-creating a type you eliminated is allowed and yields a NEW id.
+         *
+         *     `price_amount` is `null` for «a consultar» and `0` for free of charge — never interchange them, because a client renders one as a price and the other as an invitation to ask. `price_is_from` marks it as a floor («desde $35.000»). `price_currency` is a 3-letter ISO-4217 code, upper-cased on the way in, and `price_clp` is the same amount in pesos for a workspace that prices in another currency.
+         *
+         *     **Depósito / abono.** The deposit rule for this service is NOT on this resource: it is a `deposit_policy` row scoped to `appointment_type`, read and written through `GET|PUT /deposit-policies`. Each booking still takes a SNAPSHOT — the resolved amount and deadline land on the cita’s own `customer_obligation` — so editing the policy never changes what an already-booked customer was told to transfer.
+         */
+        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 {
+                     *       "name": "Consulta de evaluación",
+                     *       "description": "Primera visita: revisión y presupuesto.",
+                     *       "kind": "service",
+                     *       "duration_minutes": 45,
+                     *       "price_amount": 35000,
+                     *       "price_currency": "CLP",
+                     *       "price_is_from": true
+                     *     }
+                     */
+                    "application/json": {
+                        name: string;
+                        description?: string | null;
+                        /** @enum {string} */
+                        kind?: "test_drive" | "external" | "service";
+                        duration_minutes: number;
+                        price_amount?: number | null;
+                        price_currency?: string;
+                        price_is_from?: boolean;
+                        eligible_staff_ids?: string[];
+                        is_active?: boolean;
+                    };
+                };
+            };
+            responses: {
+                /** @description Appointment type */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "id": "eeee0000-0000-4000-8000-000000000001",
+                         *       "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
+                         *       "name": "Consulta de evaluación",
+                         *       "description": "Primera visita: revisión y presupuesto.",
+                         *       "kind": "service",
+                         *       "engine": "native",
+                         *       "external_ref": null,
+                         *       "buffer_minutes": null,
+                         *       "duration_minutes": 45,
+                         *       "price_amount": 35000,
+                         *       "price_clp": 35000,
+                         *       "price_currency": "CLP",
+                         *       "price_is_from": true,
+                         *       "eligible_staff_ids": [],
+                         *       "is_active": true,
+                         *       "is_default": false,
+                         *       "deleted_at": null,
+                         *       "created_at": "2026-09-22T12:50:27.458Z",
+                         *       "updated_at": "2026-09-22T12:50:27.458Z"
+                         *     }
+                         */
+                        "application/json": {
+                            data?: 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;
+    };
+    "/appointment-types/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get an appointment type
+         * @description By uuid. An ELIMINATED type is a 404 here even though the appointments booked against it still resolve its name — the catalogue and the history answer different questions.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Appointment type */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "id": "eeee0000-0000-4000-8000-000000000001",
+                         *       "tenant_id": "a1a1a1a1-0000-4000-8000-000000000001",
+                         *       "name": "Consulta de evaluación",
+                         *       "description": "Primera visita: revisión y presupuesto.",
+                         *       "kind": "service",
+                         *       "engine": "native",
+                         *       "external_ref": null,
+                         *       "buffer_minutes": null,
+                         *       "duration_minutes": 45,
+                         *       "price_amount": 35000,
+                         *       "price_clp": 35000,
+                         *       "price_currency": "CLP",
+                         *       "price_is_from": true,
+                         *       "eligible_staff_ids": [],
+                         *       "is_active": true,
+                         *       "is_default": false,
+                         *       "deleted_at": null,
+                         *       "created_at": "2026-09-22T12:50:27.458Z",
+                         *       "updated_at": "2026-09-22T12:50:27.458Z"
                          *     }
                          */
                         "application/json": {
@@ -140052,6 +140909,219 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/ads/paid-funnel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Paid funnel: spend, leads, qualified, booked, held and paid per arm, campaign, ad set and ad
+         * @description The scoreboard that judges a paid test on cost per demo HELD. Per row: people at each step (lead → ICP-qualified → demo booked → demo held → first paid invoice), the cost of each step, contacted within 24 h, lead-to-booked, show rate and qualified share, for one destination `arm` (`whatsapp`, `instant_form`, `website`, `other`; an ad with spend and nobody is `unassigned`). Steps are read from the outcome ledger the Meta events leave from, so a column equals the events sent for the same period (`basis=event`; `reconciliation.events` prints them). People with no id at the level sit on the arm’s `unattributed` row, so rows sum to `totals`; `reconciliation.spend_matches` checks Σ spend against `/ads/overview`. A failed read is `null`, never 0.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Window start (inclusive), YYYY-MM-DD, Santiago. */
+                    from: string;
+                    /** @description Window end (inclusive), YYYY-MM-DD, Santiago. */
+                    to: string;
+                    /** @description `arm` (WhatsApp / Instant Form / website), `campaign`, `ad_set` or `ad`. `arms` is always returned whatever the level. */
+                    level?: "arm" | "campaign" | "ad_set" | "ad";
+                    /** @description `cohort` (default): the people whose lead fell in the window, every later step counted whenever it happened. `event`: every column is the number of people whose event of that step fell in the window, so each equals the events sent to Meta for the same period. */
+                    basis?: "cohort" | "event";
+                    /** @description The attribution model for the spend read. Default `last_touch`. */
+                    model?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The funnel at the requested level */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "level": "arm",
+                         *         "basis": "cohort",
+                         *         "window": {
+                         *           "from": "2026-11-16",
+                         *           "to": "2026-11-29"
+                         *         },
+                         *         "rows": [
+                         *           {
+                         *             "arm": "whatsapp",
+                         *             "external_id": null,
+                         *             "name": null,
+                         *             "parent": null,
+                         *             "unattributed": false,
+                         *             "leads": 100,
+                         *             "qualified": 50,
+                         *             "booked": 25,
+                         *             "held": 12,
+                         *             "paid": 0,
+                         *             "contacted_24h": 90,
+                         *             "spend": 1400000,
+                         *             "costs": {
+                         *               "per_lead": 14000,
+                         *               "per_qualified": 28000,
+                         *               "per_booked": 56000,
+                         *               "per_held": 112000,
+                         *               "per_paid": null
+                         *             },
+                         *             "rates": {
+                         *               "qualified_share": 0.5,
+                         *               "contacted_24h_rate": 0.9,
+                         *               "lead_to_booked": 0.25,
+                         *               "show_rate": 0.5
+                         *             }
+                         *           }
+                         *         ],
+                         *         "arms": [],
+                         *         "totals": {
+                         *           "leads": 100,
+                         *           "qualified": 50,
+                         *           "booked": 25,
+                         *           "held": 12,
+                         *           "paid": 0,
+                         *           "contacted_24h": 90,
+                         *           "spend": 1400000,
+                         *           "costs": {
+                         *             "per_lead": 14000,
+                         *             "per_qualified": 28000,
+                         *             "per_booked": 56000,
+                         *             "per_held": 112000,
+                         *             "per_paid": null
+                         *           },
+                         *           "rates": {
+                         *             "qualified_share": 0.5,
+                         *             "contacted_24h_rate": 0.9,
+                         *             "lead_to_booked": 0.25,
+                         *             "show_rate": 0.5
+                         *           }
+                         *         },
+                         *         "reconciliation": {
+                         *           "overview_spend": 1400000,
+                         *           "spend_matches": true,
+                         *           "events": null,
+                         *           "counts_match": null,
+                         *           "leads_without_ad": 0
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["AdsDemoFunnel"];
+                        };
+                    };
+                };
+                /** @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;
@@ -145230,6 +146300,43 @@ interface paths {
                          *           "dismissed_until": null
                          *         },
                          *         {
+                         *           "key": "budget_change:120210000000000002:2026-09-23",
+                         *           "kind": "budget_change",
+                         *           "screen": [
+                         *             "campanas",
+                         *             "resumen"
+                         *           ],
+                         *           "primary": false,
+                         *           "title": "Bajar 20 % el presupuesto de la campaña «Blanqueamiento · Octubre»",
+                         *           "why": "Se lleva el **46 %** del gasto de tus campañas (**$412.000** en septiembre) y agenda el **2,1 %** (3 de 140); «Implantes · Septiembre» agenda el **9,8 %** (12 de 122). La campaña reparte su presupuesto sola, así que se baja ahí: de **$25.000** a **$20.000** al día; 20 % es el paso máximo, y el siguiente, en 3 días.",
+                         *           "effect": "El presupuesto diario de la campaña baja 20 %; puedes deshacerlo.",
+                         *           "target": {
+                         *             "level": "campaign",
+                         *             "external_id": "120210000000000002",
+                         *             "name": "Blanqueamiento · Octubre",
+                         *             "campaign_external_id": null,
+                         *             "campaign": {
+                         *               "external_id": "120210000000000002",
+                         *               "name": "Blanqueamiento · Octubre"
+                         *             }
+                         *           },
+                         *           "params": {
+                         *             "budget_change_pct": -20,
+                         *             "budget_level": "campaign",
+                         *             "budget_type": "daily",
+                         *             "daily_budget": 25000,
+                         *             "new_daily_budget": 20000,
+                         *             "step_pct": 20
+                         *           },
+                         *           "reversible": true,
+                         *           "risk": "reversible",
+                         *           "engine_ref": {
+                         *             "op": "campaigns.budget"
+                         *           },
+                         *           "facts": [],
+                         *           "dismissed_until": null
+                         *         },
+                         *         {
                          *           "key": "nav:cheapest:120210000000000002:2026-09-23",
                          *           "kind": "nav",
                          *           "screen": [
@@ -149431,7 +150538,10 @@ interface paths {
                          *       "data": {
                          *         "offer": {
                          *           "available": false,
-                         *           "reason": "already_open"
+                         *           "reason": "already_open",
+                         *           "suggested_test_event": "appointment_booked",
+                         *           "weekly_first_payments": 12,
+                         *           "first_payment_threshold": 50
                          *         },
                          *         "experiments": [
                          *           {
@@ -149579,7 +150689,7 @@ interface paths {
         put?: never;
         /**
          * Record an optimisation experiment (draft)
-         * @description Records the control (today’s «conversaciones» ad sets) and the test arm (ad sets optimising on `test_event`, default the first payment). No Meta write: Meta’s API cannot re-optimise a published click-to-WhatsApp ad set on a purchase (the Sales objective belongs to the campaign and a published ad set’s optimisation is frozen), so the test arm is built in Ads Manager and its ids recorded here (now or with PATCH). 409 when not offered (`details.reason`).
+         * @description Records the control (today’s «conversaciones» ad sets) and the test arm (ad sets optimising on `test_event`; default, D81: the offer’s `suggested_test_event` — «cita agendada» until ~50 first payments a week, then the first payment). No Meta write: Meta’s API cannot re-optimise a published click-to-WhatsApp ad set on a purchase (the Sales objective belongs to the campaign and a published ad set’s optimisation is frozen), so the test arm is built in Ads Manager and its ids recorded here (now or with PATCH). 409 when not offered (`details.reason`).
          */
         post: {
             parameters: {
@@ -150133,108 +151243,866 @@ interface paths {
                 };
             };
         };
-        put?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Record an arm’s ad sets, start, end or read early
+         * @description `arm` records the ad sets (and campaign) an arm runs on, as built in Ads Manager — their learning read restarts. `status: running` once the test arm is live (reads learning right away); `ended` closes it and keeps the record. `read_from` compares from a day before every arm left learning (the readout then says `read_early: true`).
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    /**
+                     * @example {
+                     *       "arm": {
+                     *         "arm_key": "first_payment",
+                     *         "ad_sets": [
+                     *           "120211000000000301"
+                     *         ],
+                     *         "campaign": "120211000000000300"
+                     *       },
+                     *       "status": "running"
+                     *     }
+                     */
+                    "application/json": {
+                        arm?: {
+                            arm_key: string;
+                            ad_sets?: string[];
+                            campaign?: string | null;
+                            budget_share?: number | null;
+                        };
+                        /**
+                         * @description `running` once the test arm is live in Meta (needs its ad sets); `ended` closes it (the record is kept).
+                         * @enum {string}
+                         */
+                        status?: "running" | "ended";
+                        /** @description Compare from this clinic day even if an arm is still learning (the readout then says `read_early: true`); `null` = wait for learning. */
+                        read_from?: string | null;
+                    };
+                };
+            };
+            responses: {
+                /** @description The experiment after the change. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "id": "01926f3e-7c1a-7b2e-9f10-3a5b7c9d0e1f",
+                         *         "name": "Conversaciones vs primer pago",
+                         *         "status": "running",
+                         *         "started_at": "2026-10-02T13:00:00.000Z",
+                         *         "ended_at": null,
+                         *         "readout_from": null,
+                         *         "read_early": false,
+                         *         "created_at": "2026-10-01T21:10:00.000Z",
+                         *         "arms": [
+                         *           {
+                         *             "arm_key": "control",
+                         *             "role": "control",
+                         *             "optimization_event": "conversations",
+                         *             "meta_campaign": null,
+                         *             "meta_ad_sets": [
+                         *               "120211000000000201"
+                         *             ],
+                         *             "budget_share": 50,
+                         *             "learning_status": "active",
+                         *             "learning_checked_at": "2026-10-03T12:00:00.000Z",
+                         *             "left_learning_at": "2026-10-02T18:00:00.000Z"
+                         *           },
+                         *           {
+                         *             "arm_key": "first_payment",
+                         *             "role": "test",
+                         *             "optimization_event": "first_payment",
+                         *             "meta_campaign": "120211000000000300",
+                         *             "meta_ad_sets": [
+                         *               "120211000000000301"
+                         *             ],
+                         *             "budget_share": 50,
+                         *             "learning_status": "learning",
+                         *             "learning_checked_at": "2026-10-03T12:00:00.000Z",
+                         *             "left_learning_at": null
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: components["schemas"]["AdsExperiment"];
+                        };
+                    };
+                };
+                /** @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"];
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/ads/experiments/{id}/readout": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * The experiment readout, per arm
+         * @description Per arm: spend, people whose WhatsApp conversation the arm’s ads opened, «pacientes nuevos que pagaron» (a first payment), accepted presupuestos, and the two costs — cost per paying patient and cost per accepted presupuesto — side by side with the days of data. No winner and no probability. Numbers appear from the day the last arm left Meta’s learning phase (`phase: learning` until then), or from the day the owner chose to read early (`read_early: true`).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The readout. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "experiment": {
+                         *           "id": "01926f3e-7c1a-7b2e-9f10-3a5b7c9d0e1f",
+                         *           "name": "Conversaciones vs primer pago",
+                         *           "status": "running",
+                         *           "started_at": "2026-10-02T13:00:00.000Z",
+                         *           "ended_at": null,
+                         *           "readout_from": null,
+                         *           "read_early": false,
+                         *           "created_at": "2026-10-01T21:10:00.000Z",
+                         *           "arms": [
+                         *             {
+                         *               "arm_key": "control",
+                         *               "role": "control",
+                         *               "optimization_event": "conversations",
+                         *               "meta_campaign": null,
+                         *               "meta_ad_sets": [
+                         *                 "120211000000000201"
+                         *               ],
+                         *               "budget_share": 50,
+                         *               "learning_status": "active",
+                         *               "learning_checked_at": "2026-10-03T12:00:00.000Z",
+                         *               "left_learning_at": "2026-10-02T18:00:00.000Z"
+                         *             },
+                         *             {
+                         *               "arm_key": "first_payment",
+                         *               "role": "test",
+                         *               "optimization_event": "first_payment",
+                         *               "meta_campaign": "120211000000000300",
+                         *               "meta_ad_sets": [
+                         *                 "120211000000000301"
+                         *               ],
+                         *               "budget_share": 50,
+                         *               "learning_status": "learning",
+                         *               "learning_checked_at": "2026-10-03T12:00:00.000Z",
+                         *               "left_learning_at": null
+                         *             }
+                         *           ]
+                         *         },
+                         *         "readout": {
+                         *           "phase": "comparing",
+                         *           "from": "2026-10-09",
+                         *           "to": "2026-10-30",
+                         *           "days_of_data": 22,
+                         *           "day_number": 29,
+                         *           "planned_days": 28,
+                         *           "learning_finished": true,
+                         *           "read_early": false,
+                         *           "planned_end_from": "2026-10-30",
+                         *           "planned_end_to": "2026-11-13",
+                         *           "arms": [
+                         *             {
+                         *               "arm_key": "control",
+                         *               "role": "control",
+                         *               "optimization_event": "conversations",
+                         *               "ad_set_count": 1,
+                         *               "learning_status": "active",
+                         *               "left_learning_at": "2026-10-02T18:00:00.000Z",
+                         *               "spend_clp": 650000,
+                         *               "people": 210,
+                         *               "paying_patients": 6,
+                         *               "accepted_quotes": 9,
+                         *               "attended": 14,
+                         *               "cost_per_paying_patient": 108333,
+                         *               "cost_per_accepted_quote": 72222,
+                         *               "sales_objective": false
+                         *             },
+                         *             {
+                         *               "arm_key": "first_payment",
+                         *               "role": "test",
+                         *               "optimization_event": "first_payment",
+                         *               "ad_set_count": 1,
+                         *               "learning_status": "learning_limited",
+                         *               "left_learning_at": "2026-10-09T12:00:00.000Z",
+                         *               "spend_clp": 640000,
+                         *               "people": 150,
+                         *               "paying_patients": 8,
+                         *               "accepted_quotes": 10,
+                         *               "attended": 13,
+                         *               "cost_per_paying_patient": 80000,
+                         *               "cost_per_accepted_quote": 64000,
+                         *               "sales_objective": true
+                         *             }
+                         *           ]
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: {
+                                experiment: components["schemas"]["AdsExperiment"];
+                                readout: {
+                                    /**
+                                     * @description `setup` (test arm not recorded) → `learning` (an arm is still learning; no numbers) → `comparing` → `ended`.
+                                     * @enum {string}
+                                     */
+                                    phase: "setup" | "learning" | "comparing" | "ended";
+                                    from: string | null;
+                                    to: string;
+                                    days_of_data: number;
+                                    /** @description «Día N de 28»: days since the start, 1 on the start day, while the test runs; `null` before it starts and once it ended. */
+                                    day_number: number | null;
+                                    /** @description The planned length: 28. */
+                                    planned_days: number;
+                                    learning_finished: boolean;
+                                    read_early: boolean;
+                                    /** @description 4 weeks after the start. */
+                                    planned_end_from: string | null;
+                                    /** @description 6 weeks after the start. */
+                                    planned_end_to: string | null;
+                                    arms: {
+                                        arm_key: string;
+                                        /** @enum {string} */
+                                        role: "control" | "test";
+                                        /**
+                                         * @description What the arm’s ad sets optimise for: `conversations` (Meta’s own «conversaciones», the control) or a stage Vitrina sends to Meta (`first_payment` = «primer pago», `closed_won` = «presupuesto aceptado», `appointment_attended` = «cita atendida»).
+                                         * @enum {string}
+                                         */
+                                        optimization_event: "conversations" | "first_payment" | "closed_won" | "appointment_attended" | "appointment_booked" | "lead_created";
+                                        ad_set_count: number;
+                                        /**
+                                         * @description Meta’s learning stage for the arm’s ad sets, READ from Meta (never guessed): `learning` (Aprendiendo), `learning_limited` (Aprendizaje limitado — too few events to stabilise), `active` (out of learning), `unknown` until a read answers. The least advanced ad set decides.
+                                         * @enum {string}
+                                         */
+                                        learning_status: "learning" | "learning_limited" | "active" | "unknown";
+                                        left_learning_at: string | null;
+                                        /** @description Spend over the window, CLP; `null` = unknown or not started. */
+                                        spend_clp: number | null;
+                                        /** @description People whose WhatsApp conversation one of the arm’s ads opened in the window («personas»). */
+                                        people: number;
+                                        /** @description Of them, with a first payment recorded afterwards («pacientes nuevos que pagaron»). */
+                                        paying_patients: number;
+                                        accepted_quotes: number;
+                                        attended: number;
+                                        /** @description spend / paying_patients, CLP; `null` with none (never 0). */
+                                        cost_per_paying_patient: number | null;
+                                        cost_per_accepted_quote: number | null;
+                                        /** @description The arm runs under a Sales objective (required to optimise click-to-WhatsApp ads on the first payment); `null` = the engine does not report the objective. */
+                                        sales_objective: boolean | null;
+                                    }[];
+                                };
+                            };
+                        };
+                    };
+                };
+                /** @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/leadgen-forms": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Instant Form mappings
+         * @description The Meta Instant Forms this workspace mapped, and the built-in presets. A form with no entry uses the default mapping (Meta’s standard fields — name, phone, email, company — and every other answer kept in the lead note) and the inbox intake. Submissions arrive from Atribu once Meta approves lead access for the app.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The forms and presets. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "forms": [
+                         *           {
+                         *             "form_id": "1234567890123456",
+                         *             "name": "Vitrina · Automotoras · Higher intent v1",
+                         *             "intake": "demo",
+                         *             "enabled": true,
+                         *             "mapping": {
+                         *               "vertical": "automotora",
+                         *               "rules": []
+                         *             },
+                         *             "updated_at": "2026-10-11T15:00:00.000Z"
+                         *           }
+                         *         ],
+                         *         "presets": [
+                         *           "vitrina_automotora_v1"
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: {
+                                forms: {
+                                    form_id: string;
+                                    name: string | null;
+                                    /** @enum {string} */
+                                    intake: "inbox" | "demo";
+                                    enabled: boolean;
+                                    mapping: {
+                                        [key: string]: unknown;
+                                    };
+                                    updated_at: string;
+                                }[];
+                                presets: 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/leadgen-forms/{form_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Map an Instant Form
+         * @description Creates or replaces the mapping of one Instant Form: which question is the name, phone, email and company, how fit answers are read, which checkbox is the marketing opt-in and whether contacting the person is allowed by the submission itself (`contact_consent`). `intake: demo` feeds the founders’ demo intake (409 `no_demo_booking` for a workspace that takes none). A missing answer never blocks the lead.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The Instant Form's id in Meta (`form_id` of the lead). */
+                    form_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    /**
+                     * @example {
+                     *       "name": "Vitrina · Automotoras · Higher intent v1",
+                     *       "intake": "demo",
+                     *       "preset": "vitrina_automotora_v1"
+                     *     }
+                     */
+                    "application/json": {
+                        name?: string;
+                        /**
+                         * @description `inbox`: a contact, a lead and an inbox conversation. `demo`: the form feeds the founders’ demo intake (only workspaces that take demo bookings): fit score, Lead / QualifiedLead events and the 7-day follow-up.
+                         * @default inbox
+                         * @enum {string}
+                         */
+                        intake?: "inbox" | "demo";
+                        /**
+                         * @description A built-in mapping (`vitrina_automotora_v1`: the Vitrina «Automotoras» form). Replaces `mapping`.
+                         * @enum {string}
+                         */
+                        preset?: "vitrina_automotora_v1";
+                        /** @description Per-question rules. A rule names the Meta question (`source`, compared lowercase / without accents / with `_` for spaces; `aliases` add more spellings), where its answer goes (`target`: contact.name, contact.first_name, contact.last_name, contact.phone, contact.email, contact.company, qualification.role, qualification.size, qualification.sellers, note), and optionally `values` (normalised answer → stored value). Every answer is kept in the lead note whatever its rule; a missing answer never blocks the lead. */
+                        mapping?: {
+                            /** @default [] */
+                            rules?: {
+                                source: string;
+                                aliases?: string[];
+                                /** @enum {string} */
+                                target: "contact.name" | "contact.first_name" | "contact.last_name" | "contact.phone" | "contact.email" | "contact.company" | "qualification.role" | "qualification.size" | "qualification.sellers" | "note";
+                                label?: string;
+                                values?: {
+                                    [key: string]: string;
+                                };
+                            }[];
+                            marketing_checkbox_key?: string;
+                            notice_version?: string;
+                            marketing_text_version?: string;
+                            /** @enum {string} */
+                            contact_consent?: "none" | "submission" | "disclaimer";
+                            /** @enum {string} */
+                            vertical?: "automotora" | "clinica" | "otro";
+                        };
+                        /** @default true */
+                        enabled?: boolean;
+                    };
+                };
+            };
+            responses: {
+                /** @description The stored mapping. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "form_id": "1234567890123456",
+                         *         "name": "Vitrina · Automotoras · Higher intent v1",
+                         *         "intake": "demo",
+                         *         "enabled": true,
+                         *         "mapping": {
+                         *           "vertical": "automotora",
+                         *           "rules": []
+                         *         },
+                         *         "updated_at": "2026-10-11T15:00:00.000Z"
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            data: {
+                                form_id: string;
+                                name: string | null;
+                                /** @enum {string} */
+                                intake: "inbox" | "demo";
+                                enabled: boolean;
+                                mapping: {
+                                    [key: string]: unknown;
+                                };
+                                updated_at: 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"];
+                    };
+                };
+            };
+        };
         post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
         /**
-         * Record an arm’s ad sets, start, end or read early
-         * @description `arm` records the ad sets (and campaign) an arm runs on, as built in Ads Manager — their learning read restarts. `status: running` once the test arm is live (reads learning right away); `ended` closes it and keeps the record. `read_from` compares from a day before every arm left learning (the readout then says `read_early: true`).
+         * Remove an Instant Form mapping
+         * @description Back to the default mapping and the inbox intake for that form. Leads already created are untouched.
          */
-        patch: {
+        delete: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
-                    id: string;
+                    /** @description The Instant Form's id in Meta (`form_id` of the lead). */
+                    form_id: string;
                 };
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    /**
-                     * @example {
-                     *       "arm": {
-                     *         "arm_key": "first_payment",
-                     *         "ad_sets": [
-                     *           "120211000000000301"
-                     *         ],
-                     *         "campaign": "120211000000000300"
-                     *       },
-                     *       "status": "running"
-                     *     }
-                     */
-                    "application/json": {
-                        arm?: {
-                            arm_key: string;
-                            ad_sets?: string[];
-                            campaign?: string | null;
-                            budget_share?: number | null;
-                        };
-                        /**
-                         * @description `running` once the test arm is live in Meta (needs its ad sets); `ended` closes it (the record is kept).
-                         * @enum {string}
-                         */
-                        status?: "running" | "ended";
-                        /** @description Compare from this clinic day even if an arm is still learning (the readout then says `read_early: true`); `null` = wait for learning. */
-                        read_from?: string | null;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description The experiment after the change. */
-                200: {
+                /** @description Removed. */
+                204: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        /**
-                         * @example {
-                         *       "data": {
-                         *         "id": "01926f3e-7c1a-7b2e-9f10-3a5b7c9d0e1f",
-                         *         "name": "Conversaciones vs primer pago",
-                         *         "status": "running",
-                         *         "started_at": "2026-10-02T13:00:00.000Z",
-                         *         "ended_at": null,
-                         *         "readout_from": null,
-                         *         "read_early": false,
-                         *         "created_at": "2026-10-01T21:10:00.000Z",
-                         *         "arms": [
-                         *           {
-                         *             "arm_key": "control",
-                         *             "role": "control",
-                         *             "optimization_event": "conversations",
-                         *             "meta_campaign": null,
-                         *             "meta_ad_sets": [
-                         *               "120211000000000201"
-                         *             ],
-                         *             "budget_share": 50,
-                         *             "learning_status": "active",
-                         *             "learning_checked_at": "2026-10-03T12:00:00.000Z",
-                         *             "left_learning_at": "2026-10-02T18:00:00.000Z"
-                         *           },
-                         *           {
-                         *             "arm_key": "first_payment",
-                         *             "role": "test",
-                         *             "optimization_event": "first_payment",
-                         *             "meta_campaign": "120211000000000300",
-                         *             "meta_ad_sets": [
-                         *               "120211000000000301"
-                         *             ],
-                         *             "budget_share": 50,
-                         *             "learning_status": "learning",
-                         *             "learning_checked_at": "2026-10-03T12:00:00.000Z",
-                         *             "left_learning_at": null
-                         *           }
-                         *         ]
-                         *       }
-                         *     }
-                         */
-                        "application/json": {
-                            data: components["schemas"]["AdsExperiment"];
-                        };
-                    };
+                    content?: never;
                 };
                 /** @description Validation error */
                 400: {
@@ -150328,9 +152196,12 @@ interface paths {
                 };
             };
         };
+        options?: never;
+        head?: never;
+        patch?: never;
         trace?: never;
     };
-    "/ads/experiments/{id}/readout": {
+    "/ads/leadgen-submissions": {
         parameters: {
             query?: never;
             header?: never;
@@ -150338,21 +152209,21 @@ interface paths {
             cookie?: never;
         };
         /**
-         * The experiment readout, per arm
-         * @description Per arm: spend, people whose WhatsApp conversation the arm’s ads opened, «pacientes nuevos que pagaron» (a first payment), accepted presupuestos, and the two costs — cost per paying patient and cost per accepted presupuesto — side by side with the days of data. No winner and no probability. Numbers appear from the day the last arm left Meta’s learning phase (`phase: learning` until then), or from the day the owner chose to read early (`read_early: true`).
+         * Latest Instant Form submissions
+         * @description The latest submissions received, newest first: whether each was applied (`processed`), is being applied (`received`) or failed and will be retried (`failed`, with the error), which intake took it, and the lead and contact it produced. No answers.
          */
         get: {
             parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
+                query?: {
+                    limit?: number;
                 };
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description The readout. */
+                /** @description The submissions. */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -150361,146 +152232,33 @@ interface paths {
                         /**
                          * @example {
                          *       "data": {
-                         *         "experiment": {
-                         *           "id": "01926f3e-7c1a-7b2e-9f10-3a5b7c9d0e1f",
-                         *           "name": "Conversaciones vs primer pago",
-                         *           "status": "running",
-                         *           "started_at": "2026-10-02T13:00:00.000Z",
-                         *           "ended_at": null,
-                         *           "readout_from": null,
-                         *           "read_early": false,
-                         *           "created_at": "2026-10-01T21:10:00.000Z",
-                         *           "arms": [
-                         *             {
-                         *               "arm_key": "control",
-                         *               "role": "control",
-                         *               "optimization_event": "conversations",
-                         *               "meta_campaign": null,
-                         *               "meta_ad_sets": [
-                         *                 "120211000000000201"
-                         *               ],
-                         *               "budget_share": 50,
-                         *               "learning_status": "active",
-                         *               "learning_checked_at": "2026-10-03T12:00:00.000Z",
-                         *               "left_learning_at": "2026-10-02T18:00:00.000Z"
-                         *             },
-                         *             {
-                         *               "arm_key": "first_payment",
-                         *               "role": "test",
-                         *               "optimization_event": "first_payment",
-                         *               "meta_campaign": "120211000000000300",
-                         *               "meta_ad_sets": [
-                         *                 "120211000000000301"
-                         *               ],
-                         *               "budget_share": 50,
-                         *               "learning_status": "learning",
-                         *               "learning_checked_at": "2026-10-03T12:00:00.000Z",
-                         *               "left_learning_at": null
-                         *             }
-                         *           ]
-                         *         },
-                         *         "readout": {
-                         *           "phase": "comparing",
-                         *           "from": "2026-10-09",
-                         *           "to": "2026-10-30",
-                         *           "days_of_data": 22,
-                         *           "day_number": 29,
-                         *           "planned_days": 28,
-                         *           "learning_finished": true,
-                         *           "read_early": false,
-                         *           "planned_end_from": "2026-10-30",
-                         *           "planned_end_to": "2026-11-13",
-                         *           "arms": [
-                         *             {
-                         *               "arm_key": "control",
-                         *               "role": "control",
-                         *               "optimization_event": "conversations",
-                         *               "ad_set_count": 1,
-                         *               "learning_status": "active",
-                         *               "left_learning_at": "2026-10-02T18:00:00.000Z",
-                         *               "spend_clp": 650000,
-                         *               "people": 210,
-                         *               "paying_patients": 6,
-                         *               "accepted_quotes": 9,
-                         *               "attended": 14,
-                         *               "cost_per_paying_patient": 108333,
-                         *               "cost_per_accepted_quote": 72222,
-                         *               "sales_objective": false
-                         *             },
-                         *             {
-                         *               "arm_key": "first_payment",
-                         *               "role": "test",
-                         *               "optimization_event": "first_payment",
-                         *               "ad_set_count": 1,
-                         *               "learning_status": "learning_limited",
-                         *               "left_learning_at": "2026-10-09T12:00:00.000Z",
-                         *               "spend_clp": 640000,
-                         *               "people": 150,
-                         *               "paying_patients": 8,
-                         *               "accepted_quotes": 10,
-                         *               "attended": 13,
-                         *               "cost_per_paying_patient": 80000,
-                         *               "cost_per_accepted_quote": 64000,
-                         *               "sales_objective": true
-                         *             }
-                         *           ]
-                         *         }
+                         *         "submissions": [
+                         *           {
+                         *             "leadgen_id": "444444444444",
+                         *             "status": "processed",
+                         *             "route": "demo",
+                         *             "attempts": 1,
+                         *             "lead_id": "01926f3e-7c1a-7b2e-9f10-3a5b7c9d0e1f",
+                         *             "contact_id": "01926f3e-7c1a-7b2e-9f10-3a5b7c9d0e20",
+                         *             "error": null
+                         *           }
+                         *         ]
                          *       }
                          *     }
                          */
                         "application/json": {
                             data: {
-                                experiment: components["schemas"]["AdsExperiment"];
-                                readout: {
-                                    /**
-                                     * @description `setup` (test arm not recorded) → `learning` (an arm is still learning; no numbers) → `comparing` → `ended`.
-                                     * @enum {string}
-                                     */
-                                    phase: "setup" | "learning" | "comparing" | "ended";
-                                    from: string | null;
-                                    to: string;
-                                    days_of_data: number;
-                                    /** @description «Día N de 28»: days since the start, 1 on the start day, while the test runs; `null` before it starts and once it ended. */
-                                    day_number: number | null;
-                                    /** @description The planned length: 28. */
-                                    planned_days: number;
-                                    learning_finished: boolean;
-                                    read_early: boolean;
-                                    /** @description 4 weeks after the start. */
-                                    planned_end_from: string | null;
-                                    /** @description 6 weeks after the start. */
-                                    planned_end_to: string | null;
-                                    arms: {
-                                        arm_key: string;
-                                        /** @enum {string} */
-                                        role: "control" | "test";
-                                        /**
-                                         * @description What the arm’s ad sets optimise for: `conversations` (Meta’s own «conversaciones», the control) or a stage Vitrina sends to Meta (`first_payment` = «primer pago», `closed_won` = «presupuesto aceptado», `appointment_attended` = «cita atendida»).
-                                         * @enum {string}
-                                         */
-                                        optimization_event: "conversations" | "first_payment" | "closed_won" | "appointment_attended" | "appointment_booked" | "lead_created";
-                                        ad_set_count: number;
-                                        /**
-                                         * @description Meta’s learning stage for the arm’s ad sets, READ from Meta (never guessed): `learning` (Aprendiendo), `learning_limited` (Aprendizaje limitado — too few events to stabilise), `active` (out of learning), `unknown` until a read answers. The least advanced ad set decides.
-                                         * @enum {string}
-                                         */
-                                        learning_status: "learning" | "learning_limited" | "active" | "unknown";
-                                        left_learning_at: string | null;
-                                        /** @description Spend over the window, CLP; `null` = unknown or not started. */
-                                        spend_clp: number | null;
-                                        /** @description People whose WhatsApp conversation one of the arm’s ads opened in the window («personas»). */
-                                        people: number;
-                                        /** @description Of them, with a first payment recorded afterwards («pacientes nuevos que pagaron»). */
-                                        paying_patients: number;
-                                        accepted_quotes: number;
-                                        attended: number;
-                                        /** @description spend / paying_patients, CLP; `null` with none (never 0). */
-                                        cost_per_paying_patient: number | null;
-                                        cost_per_accepted_quote: number | null;
-                                        /** @description The arm runs under a Sales objective (required to optimise click-to-WhatsApp ads on the first payment); `null` = the engine does not report the objective. */
-                                        sales_objective: boolean | null;
-                                    }[];
-                                };
+                                submissions: {
+                                    leadgen_id: string;
+                                    /** @enum {string} */
+                                    status: "received" | "processed" | "failed";
+                                    /** @enum {string|null} */
+                                    route: "demo" | "inbox" | "inbox_fallback" | null;
+                                    attempts: number;
+                                    lead_id: string | null;
+                                    contact_id: string | null;
+                                    error: string | null;
+                                }[];
                             };
                         };
                     };
@@ -175593,7 +177351,7 @@ interface components {
         };
         WebhookEventDoc: {
             /** @enum {string} */
-            name: "ai_agent.publish" | "ai_agent_graph.publish" | "agent_scenario_run.completed" | "agent_scenario_suite.completed" | "conversation.created" | "conversation.assigned" | "conversation.resolved" | "message.received" | "message.sent" | "ticket.opened" | "ticket.reopened" | "ticket.resolved" | "ticket.closed" | "sla.breached" | "kb.source.create" | "kb.source.embed" | "kb.source.update" | "kb.source.delete" | "kb_file.uploaded" | "kb_file.deleted" | "skill.created" | "skill.updated" | "skill.deleted" | "custom_tool.created" | "custom_tool.updated" | "custom_tool.deleted" | "macro.applied" | "cost.budget_alert" | "runtime.budget_exceeded" | "lead.created" | "lead.stage_changed" | "lead.pipeline_changed" | "lead.assigned" | "lead.won" | "lead.lost" | "lead.unqualified" | "stock.synced" | "stock.source_retired" | "vehicle.published" | "vehicle.unpublished" | "vehicle.publish_failed" | "vehicle.created" | "vehicle.attachment.created" | "mercadolibre.order" | "mercadolibre.vis_lead" | "chileautos.lead" | "yapo.lead" | "website.lead" | "demo_lead.created" | "demo_lead.pending_scheduling" | "demo_lead.routed" | "demo_booking.booked" | "demo_booking.rescheduled" | "demo_booking.cancelled" | "consignment.candidate.created" | "quote.issued" | "quote.voided" | "quote.extended" | "quote.archived" | "reservation.created" | "reservation.voided" | "reservation.abono_disposed" | "reservation.converted" | "sale_note.issued" | "sale_note.approved" | "sale_note.voided" | "purchase_note.issued" | "purchase_note.corrected" | "purchase_note.voided" | "payment.recorded" | "consignment.created" | "consignment.returned" | "consignment.sold" | "credit_application.recorded" | "credit_application.submitted" | "credit_application.decided" | "credit_application.withdrawn" | "price_approval.requested" | "price_approval.decided" | "contact.created" | "contact.updated" | "contact.merged" | "appointment.booked" | "appointment.rescheduled" | "appointment.cancelled" | "appointment.completed" | "appointment.no_show" | "appointment.reminded" | "appointment.imported" | "campaign.sent" | "campaign.paused" | "sending_domain.verified" | "coach.proposals_ready" | "coach.finding_ready" | "voice.autonomous_call" | "safety_hold.placed" | "safety_hold.ack_overdue" | "safety_hold.first_response_overdue" | "team.created" | "team.updated" | "team.deleted" | "custom_role.created" | "custom_role.updated" | "custom_role.deleted" | "macro.created" | "macro.updated" | "macro.deleted" | "assignment_rule.created" | "assignment_rule.updated" | "assignment_rule.deleted" | "sla_policy.created" | "sla_policy.updated" | "sla_policy.deleted" | "automation_trigger.created" | "automation_trigger.updated" | "automation_trigger.deleted" | "sending_domain.created" | "sending_domain.deleted" | "whatsapp_template.created" | "whatsapp_template.status_changed" | "whatsapp_template.deleted" | "whatsapp_flow.created" | "whatsapp_flow.published" | "whatsapp_flow.deprecated" | "whatsapp_flow.deleted" | "whatsapp_flow.completed" | "channel.connected" | "channel.updated" | "channel.disconnected" | "membership.created" | "membership.updated" | "membership.removed" | "clinic_professional.created" | "clinic_professional.updated" | "clinic_professional.deleted" | "clinic_service.created" | "clinic_service.updated" | "clinic_service.deleted" | "clinic_price_list.updated" | "clinic_pack_purchase.created" | "clinic_pack_purchase.session_consumed" | "clinic_pack_purchase.cancelled" | "clinic_budget.created" | "clinic_budget.sent" | "clinic_budget.accepted" | "clinic_budget.rejected" | "clinic_budget.voided" | "clinic_budget.mirror_changed" | "clinic_cash_session.opened" | "clinic_cash_session.closed" | "clinic_patient.created" | "clinic_patient.updated" | "clinic_patient.deleted" | "clinic_patient.merged" | "clinic_encounter.opened" | "clinic_encounter.closed" | "clinic_note.signed" | "clinic_note.amended" | "clinic_consent.signed" | "clinic_consent.revoked" | "clinic_document.uploaded" | "clinic_document.deleted" | "clinic_privacy_request.completed";
+            name: "ai_agent.publish" | "ai_agent_graph.publish" | "agent_scenario_run.completed" | "agent_scenario_suite.completed" | "conversation.created" | "conversation.assigned" | "conversation.resolved" | "message.received" | "message.sent" | "ticket.opened" | "ticket.reopened" | "ticket.resolved" | "ticket.closed" | "sla.breached" | "kb.source.create" | "kb.source.embed" | "kb.source.update" | "kb.source.delete" | "kb_file.uploaded" | "kb_file.deleted" | "skill.created" | "skill.updated" | "skill.deleted" | "custom_tool.created" | "custom_tool.updated" | "custom_tool.deleted" | "macro.applied" | "cost.budget_alert" | "runtime.budget_exceeded" | "lead.created" | "lead.stage_changed" | "lead.pipeline_changed" | "lead.assigned" | "lead.won" | "lead.lost" | "lead.unqualified" | "stock.synced" | "stock.source_retired" | "vehicle.published" | "vehicle.unpublished" | "vehicle.publish_failed" | "vehicle.created" | "vehicle.attachment.created" | "mercadolibre.order" | "mercadolibre.vis_lead" | "chileautos.lead" | "yapo.lead" | "website.lead" | "demo_lead.created" | "demo_lead.pending_scheduling" | "demo_lead.routed" | "demo_booking.booked" | "demo_booking.rescheduled" | "demo_booking.cancelled" | "demo_booking.held" | "demo_booking.no_show" | "consignment.candidate.created" | "quote.issued" | "quote.voided" | "quote.extended" | "quote.archived" | "reservation.created" | "reservation.voided" | "reservation.abono_disposed" | "reservation.converted" | "sale_note.issued" | "sale_note.approved" | "sale_note.voided" | "purchase_note.issued" | "purchase_note.corrected" | "purchase_note.voided" | "payment.recorded" | "consignment.created" | "consignment.returned" | "consignment.sold" | "credit_application.recorded" | "credit_application.submitted" | "credit_application.decided" | "credit_application.withdrawn" | "price_approval.requested" | "price_approval.decided" | "contact.created" | "contact.updated" | "contact.merged" | "appointment.booked" | "appointment.rescheduled" | "appointment.cancelled" | "appointment.completed" | "appointment.no_show" | "appointment.reminded" | "appointment.imported" | "campaign.sent" | "campaign.paused" | "sending_domain.verified" | "coach.proposals_ready" | "coach.finding_ready" | "voice.autonomous_call" | "safety_hold.placed" | "safety_hold.ack_overdue" | "safety_hold.first_response_overdue" | "team.created" | "team.updated" | "team.deleted" | "custom_role.created" | "custom_role.updated" | "custom_role.deleted" | "macro.created" | "macro.updated" | "macro.deleted" | "assignment_rule.created" | "assignment_rule.updated" | "assignment_rule.deleted" | "sla_policy.created" | "sla_policy.updated" | "sla_policy.deleted" | "automation_trigger.created" | "automation_trigger.updated" | "automation_trigger.deleted" | "sending_domain.created" | "sending_domain.deleted" | "whatsapp_template.created" | "whatsapp_template.status_changed" | "whatsapp_template.deleted" | "whatsapp_flow.created" | "whatsapp_flow.published" | "whatsapp_flow.deprecated" | "whatsapp_flow.deleted" | "whatsapp_flow.completed" | "channel.connected" | "channel.updated" | "channel.disconnected" | "membership.created" | "membership.updated" | "membership.removed" | "clinic_professional.created" | "clinic_professional.updated" | "clinic_professional.deleted" | "clinic_service.created" | "clinic_service.updated" | "clinic_service.deleted" | "clinic_price_list.updated" | "clinic_pack_purchase.created" | "clinic_pack_purchase.session_consumed" | "clinic_pack_purchase.cancelled" | "clinic_budget.created" | "clinic_budget.sent" | "clinic_budget.accepted" | "clinic_budget.rejected" | "clinic_budget.voided" | "clinic_budget.mirror_changed" | "clinic_cash_session.opened" | "clinic_cash_session.closed" | "clinic_patient.created" | "clinic_patient.updated" | "clinic_patient.deleted" | "clinic_patient.merged" | "clinic_encounter.opened" | "clinic_encounter.closed" | "clinic_note.signed" | "clinic_note.amended" | "clinic_consent.signed" | "clinic_consent.revoked" | "clinic_document.uploaded" | "clinic_document.deleted" | "clinic_privacy_request.completed";
             /** @description The schema version of this event type — every delivery carries it as `version`. Bumped only on a breaking change to `data`. */
             version: number;
             /** @description What the event is about — the `resource.type` of every delivery (`lead`, `vehicle`, `contact`, …). */
@@ -175660,7 +177418,7 @@ interface components {
         CreateWebhookBody: {
             /** Format: uri */
             url: string;
-            events: ("*" | "ai_agent.publish" | "ai_agent_graph.publish" | "agent_scenario_run.completed" | "agent_scenario_suite.completed" | "conversation.created" | "conversation.assigned" | "conversation.resolved" | "message.received" | "message.sent" | "ticket.opened" | "ticket.reopened" | "ticket.resolved" | "ticket.closed" | "sla.breached" | "kb.source.create" | "kb.source.embed" | "kb.source.update" | "kb.source.delete" | "kb_file.uploaded" | "kb_file.deleted" | "skill.created" | "skill.updated" | "skill.deleted" | "custom_tool.created" | "custom_tool.updated" | "custom_tool.deleted" | "macro.applied" | "cost.budget_alert" | "runtime.budget_exceeded" | "lead.created" | "lead.stage_changed" | "lead.pipeline_changed" | "lead.assigned" | "lead.won" | "lead.lost" | "lead.unqualified" | "stock.synced" | "stock.source_retired" | "vehicle.published" | "vehicle.unpublished" | "vehicle.publish_failed" | "vehicle.created" | "vehicle.attachment.created" | "mercadolibre.order" | "mercadolibre.vis_lead" | "chileautos.lead" | "yapo.lead" | "website.lead" | "demo_lead.created" | "demo_lead.pending_scheduling" | "demo_lead.routed" | "demo_booking.booked" | "demo_booking.rescheduled" | "demo_booking.cancelled" | "consignment.candidate.created" | "quote.issued" | "quote.voided" | "quote.extended" | "quote.archived" | "reservation.created" | "reservation.voided" | "reservation.abono_disposed" | "reservation.converted" | "sale_note.issued" | "sale_note.approved" | "sale_note.voided" | "purchase_note.issued" | "purchase_note.corrected" | "purchase_note.voided" | "payment.recorded" | "consignment.created" | "consignment.returned" | "consignment.sold" | "credit_application.recorded" | "credit_application.submitted" | "credit_application.decided" | "credit_application.withdrawn" | "price_approval.requested" | "price_approval.decided" | "contact.created" | "contact.updated" | "contact.merged" | "appointment.booked" | "appointment.rescheduled" | "appointment.cancelled" | "appointment.completed" | "appointment.no_show" | "appointment.reminded" | "appointment.imported" | "campaign.sent" | "campaign.paused" | "sending_domain.verified" | "coach.proposals_ready" | "coach.finding_ready" | "voice.autonomous_call" | "safety_hold.placed" | "safety_hold.ack_overdue" | "safety_hold.first_response_overdue" | "team.created" | "team.updated" | "team.deleted" | "custom_role.created" | "custom_role.updated" | "custom_role.deleted" | "macro.created" | "macro.updated" | "macro.deleted" | "assignment_rule.created" | "assignment_rule.updated" | "assignment_rule.deleted" | "sla_policy.created" | "sla_policy.updated" | "sla_policy.deleted" | "automation_trigger.created" | "automation_trigger.updated" | "automation_trigger.deleted" | "sending_domain.created" | "sending_domain.deleted" | "whatsapp_template.created" | "whatsapp_template.status_changed" | "whatsapp_template.deleted" | "whatsapp_flow.created" | "whatsapp_flow.published" | "whatsapp_flow.deprecated" | "whatsapp_flow.deleted" | "whatsapp_flow.completed" | "channel.connected" | "channel.updated" | "channel.disconnected" | "membership.created" | "membership.updated" | "membership.removed" | "clinic_professional.created" | "clinic_professional.updated" | "clinic_professional.deleted" | "clinic_service.created" | "clinic_service.updated" | "clinic_service.deleted" | "clinic_price_list.updated" | "clinic_pack_purchase.created" | "clinic_pack_purchase.session_consumed" | "clinic_pack_purchase.cancelled" | "clinic_budget.created" | "clinic_budget.sent" | "clinic_budget.accepted" | "clinic_budget.rejected" | "clinic_budget.voided" | "clinic_budget.mirror_changed" | "clinic_cash_session.opened" | "clinic_cash_session.closed" | "clinic_patient.created" | "clinic_patient.updated" | "clinic_patient.deleted" | "clinic_patient.merged" | "clinic_encounter.opened" | "clinic_encounter.closed" | "clinic_note.signed" | "clinic_note.amended" | "clinic_consent.signed" | "clinic_consent.revoked" | "clinic_document.uploaded" | "clinic_document.deleted" | "clinic_privacy_request.completed")[];
+            events: ("*" | "ai_agent.publish" | "ai_agent_graph.publish" | "agent_scenario_run.completed" | "agent_scenario_suite.completed" | "conversation.created" | "conversation.assigned" | "conversation.resolved" | "message.received" | "message.sent" | "ticket.opened" | "ticket.reopened" | "ticket.resolved" | "ticket.closed" | "sla.breached" | "kb.source.create" | "kb.source.embed" | "kb.source.update" | "kb.source.delete" | "kb_file.uploaded" | "kb_file.deleted" | "skill.created" | "skill.updated" | "skill.deleted" | "custom_tool.created" | "custom_tool.updated" | "custom_tool.deleted" | "macro.applied" | "cost.budget_alert" | "runtime.budget_exceeded" | "lead.created" | "lead.stage_changed" | "lead.pipeline_changed" | "lead.assigned" | "lead.won" | "lead.lost" | "lead.unqualified" | "stock.synced" | "stock.source_retired" | "vehicle.published" | "vehicle.unpublished" | "vehicle.publish_failed" | "vehicle.created" | "vehicle.attachment.created" | "mercadolibre.order" | "mercadolibre.vis_lead" | "chileautos.lead" | "yapo.lead" | "website.lead" | "demo_lead.created" | "demo_lead.pending_scheduling" | "demo_lead.routed" | "demo_booking.booked" | "demo_booking.rescheduled" | "demo_booking.cancelled" | "demo_booking.held" | "demo_booking.no_show" | "consignment.candidate.created" | "quote.issued" | "quote.voided" | "quote.extended" | "quote.archived" | "reservation.created" | "reservation.voided" | "reservation.abono_disposed" | "reservation.converted" | "sale_note.issued" | "sale_note.approved" | "sale_note.voided" | "purchase_note.issued" | "purchase_note.corrected" | "purchase_note.voided" | "payment.recorded" | "consignment.created" | "consignment.returned" | "consignment.sold" | "credit_application.recorded" | "credit_application.submitted" | "credit_application.decided" | "credit_application.withdrawn" | "price_approval.requested" | "price_approval.decided" | "contact.created" | "contact.updated" | "contact.merged" | "appointment.booked" | "appointment.rescheduled" | "appointment.cancelled" | "appointment.completed" | "appointment.no_show" | "appointment.reminded" | "appointment.imported" | "campaign.sent" | "campaign.paused" | "sending_domain.verified" | "coach.proposals_ready" | "coach.finding_ready" | "voice.autonomous_call" | "safety_hold.placed" | "safety_hold.ack_overdue" | "safety_hold.first_response_overdue" | "team.created" | "team.updated" | "team.deleted" | "custom_role.created" | "custom_role.updated" | "custom_role.deleted" | "macro.created" | "macro.updated" | "macro.deleted" | "assignment_rule.created" | "assignment_rule.updated" | "assignment_rule.deleted" | "sla_policy.created" | "sla_policy.updated" | "sla_policy.deleted" | "automation_trigger.created" | "automation_trigger.updated" | "automation_trigger.deleted" | "sending_domain.created" | "sending_domain.deleted" | "whatsapp_template.created" | "whatsapp_template.status_changed" | "whatsapp_template.deleted" | "whatsapp_flow.created" | "whatsapp_flow.published" | "whatsapp_flow.deprecated" | "whatsapp_flow.deleted" | "whatsapp_flow.completed" | "channel.connected" | "channel.updated" | "channel.disconnected" | "membership.created" | "membership.updated" | "membership.removed" | "clinic_professional.created" | "clinic_professional.updated" | "clinic_professional.deleted" | "clinic_service.created" | "clinic_service.updated" | "clinic_service.deleted" | "clinic_price_list.updated" | "clinic_pack_purchase.created" | "clinic_pack_purchase.session_consumed" | "clinic_pack_purchase.cancelled" | "clinic_budget.created" | "clinic_budget.sent" | "clinic_budget.accepted" | "clinic_budget.rejected" | "clinic_budget.voided" | "clinic_budget.mirror_changed" | "clinic_cash_session.opened" | "clinic_cash_session.closed" | "clinic_patient.created" | "clinic_patient.updated" | "clinic_patient.deleted" | "clinic_patient.merged" | "clinic_encounter.opened" | "clinic_encounter.closed" | "clinic_note.signed" | "clinic_note.amended" | "clinic_consent.signed" | "clinic_consent.revoked" | "clinic_document.uploaded" | "clinic_document.deleted" | "clinic_privacy_request.completed")[];
             description?: string | null;
             /** @description «Incluir datos del recurso». `false` (the default) = every delivery is the notice: resource, changes, author, time and `url`, with `data_omitted: "not_requested"`. `true` = each delivery also carries `data` when, at dispatch time, this subscription's OWNER — whoever created it or last changed its url, events or this flag — holds the resource read scope (`read_scope` in the catalogue) and sees every record; otherwise `data_omitted` says why. An event about a dato sensible is always the notice. */
             include_data?: boolean;
@@ -178690,6 +180448,8 @@ interface components {
             accepted_value?: number | null;
             /** @description How many accepted presupuestos / closed sales `accepted_value` is. Totals and campaign rows: the engine-credited list Resumen sums. */
             accepted_count?: number | null;
+            /** @description D60 · «Con diagnóstico»: people whose conversation the entity opened and who got a presupuesto presented. Absent = unknown. */
+            diagnosed?: number | null;
             /** @description `accepted_value` ÷ spend («Retorno en presupuestos»). `null` = unknown or no spend. */
             accepted_return?: number | null;
             patient_return?: components["schemas"]["AdsPatientReturn"];
@@ -178757,6 +180517,8 @@ interface components {
                 accepted_value?: number | null;
                 /** @description How many accepted presupuestos / closed sales `accepted_value` is. Totals and campaign rows: the engine-credited list Resumen sums. */
                 accepted_count?: number | null;
+                /** @description D60 · «Con diagnóstico»: people whose conversation the entity opened and who got a presupuesto presented. Absent = unknown. */
+                diagnosed?: number | null;
                 /** @description `accepted_value` ÷ spend («Retorno en presupuestos»). `null` = unknown or no spend. */
                 accepted_return?: number | null;
                 patient_return?: components["schemas"]["AdsPatientReturn"];
@@ -178839,6 +180601,8 @@ interface components {
                 accepted_value?: number | null;
                 /** @description How many accepted presupuestos / closed sales `accepted_value` is. Totals and campaign rows: the engine-credited list Resumen sums. */
                 accepted_count?: number | null;
+                /** @description D60 · «Con diagnóstico»: people whose conversation the entity opened and who got a presupuesto presented. Absent = unknown. */
+                diagnosed?: number | null;
                 /** @description `accepted_value` ÷ spend («Retorno en presupuestos»). `null` = unknown or no spend. */
                 accepted_return?: number | null;
                 patient_return?: components["schemas"]["AdsPatientReturn"];
@@ -178878,6 +180642,124 @@ interface components {
             /** @description The public Facebook watch page: the fallback link. */
             watch_url: string | null;
         };
+        AdsDemoFunnelRow: {
+            /** @enum {string} */
+            arm: "whatsapp" | "instant_form" | "website" | "other" | "unassigned";
+            /** @description Meta id at this level; `null` on an arm row and on the «sin atribución» row. */
+            external_id: string | null;
+            name: string | null;
+            parent: {
+                external_id: string | null;
+                name: string | null;
+            } | null;
+            /** @description The arm’s people with no id at this level. */
+            unattributed: boolean;
+            /** @description People with a lead (`lead_created`). */
+            leads: number;
+            /** @description Of those, ICP-qualified (`lead_qualified`). */
+            qualified: number;
+            /** @description People with a demo booked (`appointment_booked`). */
+            booked: number;
+            /** @description People whose demo was held (`appointment_attended`). */
+            held: number;
+            /** @description People with a first paid invoice (`first_payment`). */
+            paid: number;
+            /** @description Leads that got a reply (agent, human or API) within 24 h of the lead. */
+            contacted_24h: number;
+            /** @description `null` = unknown or none on this row. */
+            spend: number | null;
+            costs: {
+                per_lead: number | null;
+                per_qualified: number | null;
+                per_booked: number | null;
+                /** @description THE metric the A/B is judged on (D5). */
+                per_held: number | null;
+                per_paid: number | null;
+            };
+            rates: {
+                /** @description qualified ÷ leads */
+                qualified_share: number | null;
+                /** @description contacted within 24 h ÷ leads */
+                contacted_24h_rate: number | null;
+                /** @description booked ÷ leads */
+                lead_to_booked: number | null;
+                /** @description held ÷ booked */
+                show_rate: number | null;
+            };
+        };
+        AdsDemoFunnel: {
+            /** @enum {string} */
+            level: "arm" | "campaign" | "ad_set" | "ad";
+            /** @enum {string} */
+            basis: "cohort" | "event";
+            window: {
+                from: string;
+                to: string;
+            };
+            rows: components["schemas"]["AdsDemoFunnelRow"][];
+            arms: components["schemas"]["AdsDemoFunnelRow"][];
+            totals: {
+                /** @description People with a lead (`lead_created`). */
+                leads: number;
+                /** @description Of those, ICP-qualified (`lead_qualified`). */
+                qualified: number;
+                /** @description People with a demo booked (`appointment_booked`). */
+                booked: number;
+                /** @description People whose demo was held (`appointment_attended`). */
+                held: number;
+                /** @description People with a first paid invoice (`first_payment`). */
+                paid: number;
+                /** @description Leads that got a reply (agent, human or API) within 24 h of the lead. */
+                contacted_24h: number;
+                spend: number | null;
+                costs: {
+                    per_lead: number | null;
+                    per_qualified: number | null;
+                    per_booked: number | null;
+                    /** @description THE metric the A/B is judged on (D5). */
+                    per_held: number | null;
+                    per_paid: number | null;
+                };
+                rates: {
+                    /** @description qualified ÷ leads */
+                    qualified_share: number | null;
+                    /** @description contacted within 24 h ÷ leads */
+                    contacted_24h_rate: number | null;
+                    /** @description booked ÷ leads */
+                    lead_to_booked: number | null;
+                    /** @description held ÷ booked */
+                    show_rate: number | null;
+                };
+            };
+            reconciliation: {
+                overview_spend: number | null;
+                spend_matches: boolean | null;
+                events: {
+                    lead_created: {
+                        events: number;
+                        people: number;
+                    };
+                    lead_qualified: {
+                        events: number;
+                        people: number;
+                    };
+                    appointment_booked: {
+                        events: number;
+                        people: number;
+                    };
+                    appointment_attended: {
+                        events: number;
+                        people: number;
+                    };
+                    first_payment: {
+                        events: number;
+                        people: number;
+                    };
+                } | null;
+                counts_match: boolean | null;
+                leads_without_ad: number;
+            };
+        };
         /** @description «Retorno total de pacientes de anuncios (primer pago + cuotas)» over the money-covered window. On `current` only; `null` = unknown (the credit is still warming). */
         AdsPatientReturnTotal: components["schemas"]["AdsPatientReturn"] & ({
             /** @description Median days from the ad touch that counts it to each person’s first payment, over the first payments of the period. */
@@ -180440,7 +182322,7 @@ interface components {
                     campaign_name: string | null;
                 }[];
             };
-            /** @description The engine’s own vocabulary, e.g. `{ budget_change_pct: 20 }`. `url_tags_fix`: `{ ads: [{ external_id, expected_url_tags, url_tags }] }` — each ad’s current parameters (null = none) and exactly what it gets. «Enviar a Meta»: `send_setup`/`send_dataset` `{ dataset_id }`, `send_stage` `{ stage, enabled, meta_event, active_ad_sets }`. `campaign_pause`: `{ period_spend, period_days, delivering_ads_count, avg_daily_spend_7d }` — the campaign’s spend in the listed period (the account currency’s major units), the period’s days and its delivering ads, what the card draws at rest (spend → 0, ~spend/days a day); `avg_daily_spend_7d` is the live 7-day daily mean the preview shows (`AdsMoney`: exact decimal + currency), `null` when the list could not know it (real mode reads it only at preview) — fall back to `period_spend / period_days`, labelled as the period. `adset_pause` (D62): `{ ad_ids, period_spend, share, booking_rate, sibling_ad_set, sibling_booking_rate, budget_level }` — the ad set’s delivering ads (bound into the approval: only those the preview read as showing), its share of the campaign’s spend and its booking rate vs its best sibling’s; with a campaign budget Meta moves the money to the sibling. A `nav` card with `params.card = "campaign_budget"` is a scale on a campaign that owns its budget: `{ campaign_external_id, daily_budget, new_daily_budget, step_pct }` — the change is made in Meta (`href`). `params.card = "funnel_leak"` (D66): the account books under 10 % of the people who write from ads — `{ people, booked, booking_rate, booking_interval, benchmark, by_ad }`. Agenda capacity (clinics): a `nav` card with `params.card = "capacity_bottleneck"` REPLACES an ad's «Pausar» (`variant: "pause"`) or a «Subir» (`variant: "budget"`) when the specialty the ad books has no usable hour for more than 7 days (or under 2 bookable hours in 14): `{ card, variant, especialidad, mapping_source: "map" | "booked" | "name", unmapped: false, next_slot_day, searched_through, free_minutes_14, booked_minutes_14, fill_14, visit_minutes, evaluation_price, price_above_median, people, booked, booking_rate, median_booking_rate, waitlist_30d }` — counts, minutes and dates, never a probability; `waitlist_30d` = people waiting now for that specialty (the clinic waitlist demand feed), `null` when the feed is absent or 0 — the card then carries no «N personas esperan hora con X hoy» sentence. A `pause_ad` whose ad books an unknown specialty carries `params.capacity = { unmapped: true }` (ask which specialty; `tenant.settings.ads.specialty_map`). */
+            /** @description The engine’s own vocabulary, e.g. `{ budget_change_pct: 20 }`. `url_tags_fix`: `{ ads: [{ external_id, expected_url_tags, url_tags }] }` — each ad’s current parameters (null = none) and exactly what it gets. «Enviar a Meta»: `send_setup`/`send_dataset` `{ dataset_id }`, `send_stage` `{ stage, enabled, meta_event, active_ad_sets }`. `campaign_pause`: `{ period_spend, period_days, delivering_ads_count, avg_daily_spend_7d }` — the campaign’s spend in the listed period (the account currency’s major units), the period’s days and its delivering ads, what the card draws at rest (spend → 0, ~spend/days a day); `avg_daily_spend_7d` is the live 7-day daily mean the preview shows (`AdsMoney`: exact decimal + currency), `null` when the list could not know it (real mode reads it only at preview) — fall back to `period_spend / period_days`, labelled as the period. `adset_pause` (D62): `{ ad_ids, period_spend, share, booking_rate, sibling_ad_set, sibling_booking_rate, budget_level }` — the ad set’s delivering ads (bound into the approval: only those the preview read as showing), its share of the campaign’s spend and its booking rate vs its best sibling’s; with a campaign budget Meta moves the money to the sibling. `budget_change` on a campaign (`target.level = "campaign"`, `engine_ref.op = "campaigns.budget"`, D78) raises or lowers a campaign that owns its budget (Advantage campaign budget) by `budget_change_pct` (±20 % at most, D68): `{ budget_change_pct, budget_level: "campaign", budget_type: "daily" | "lifetime", daily_budget, new_daily_budget (or lifetime_budget, new_lifetime_budget), step_pct }` — amounts in the account currency’s major units, `null` when the status read could not give them; the worker applies the step to the LIVE budget. A raise follows a winner; a lower is the D62 trim one level up (a campaign with more than its even share of the account’s spend booking under half the best other campaign’s rate). Undo = rollback. The optimisation-event cards (the duplicate card `params.optimization_event`, the experiment card, `adset_duplicate_swap`) follow D81: `appointment_booked` until the account reaches ~`first_payment_threshold` (50) first payments a week (`weekly_first_payments`), then `first_payment`. `params.card = "funnel_leak"` (D66): the account books under 10 % of the people who write from ads — `{ people, booked, booking_rate, booking_interval, benchmark, by_ad }`. Agenda capacity (clinics): a `nav` card with `params.card = "capacity_bottleneck"` REPLACES an ad's «Pausar» (`variant: "pause"`) or a «Subir» (`variant: "budget"`) when the specialty the ad books has no usable hour for more than 7 days (or under 2 bookable hours in 14): `{ card, variant, especialidad, mapping_source: "map" | "booked" | "name", unmapped: false, next_slot_day, searched_through, free_minutes_14, booked_minutes_14, fill_14, visit_minutes, evaluation_price, price_above_median, people, booked, booking_rate, median_booking_rate, waitlist_30d }` — counts, minutes and dates, never a probability; `waitlist_30d` = people waiting now for that specialty (the clinic waitlist demand feed), `null` when the feed is absent or 0 — the card then carries no «N personas esperan hora con X hoy» sentence. A `pause_ad` whose ad books an unknown specialty carries `params.capacity = { unmapped: true }` (ask which specialty; `tenant.settings.ads.specialty_map`). */
             params: {
                 [key: string]: unknown;
             };
@@ -180450,7 +182332,7 @@ interface components {
             /** @description Which operation executes it; `null` for `nav`. */
             engine_ref: {
                 /** @enum {string} */
-                op: "recommendations.apply" | "ads.pause" | "ads.pause_set" | "ads.resume" | "ads.resume_set" | "adsets.budget" | "campaigns.pause" | "campaigns.resume" | "wiring.ad_sets" | "quality.utm_refresh" | "wiring.recheck" | "actions.rollback" | "quality.url_tags_apply" | "quality.url_tags_undo" | "send.setup" | "send.dataset" | "send.stage" | "send.stop" | "send.restore";
+                op: "recommendations.apply" | "ads.pause" | "ads.pause_set" | "ads.resume" | "ads.resume_set" | "adsets.budget" | "campaigns.budget" | "campaigns.pause" | "campaigns.resume" | "wiring.ad_sets" | "quality.utm_refresh" | "wiring.recheck" | "actions.rollback" | "quality.url_tags_apply" | "quality.url_tags_undo" | "send.setup" | "send.dataset" | "send.stage" | "send.stop" | "send.restore";
                 recommendation_id?: string;
             } | null;
             /** @description `nav` only: a workspace-relative path (`/anuncios/atribuidos?c=…`, `/anuncios/activar?paso=tag`), or an absolute Meta Ads Manager URL built from Meta ids (`https://www.facebook.com/adsmanager/…`) — open it in a new tab; it changes nothing by itself. */
@@ -180541,7 +182423,7 @@ interface components {
             } | null;
             reversible: boolean;
             /** @enum {string|null} */
-            engine_op: "recommendations.apply" | "ads.pause" | "ads.pause_set" | "ads.resume" | "ads.resume_set" | "adsets.budget" | "campaigns.pause" | "campaigns.resume" | "wiring.ad_sets" | "quality.utm_refresh" | "wiring.recheck" | "actions.rollback" | "quality.url_tags_apply" | "quality.url_tags_undo" | "send.setup" | "send.dataset" | "send.stage" | "send.stop" | "send.restore" | null;
+            engine_op: "recommendations.apply" | "ads.pause" | "ads.pause_set" | "ads.resume" | "ads.resume_set" | "adsets.budget" | "campaigns.budget" | "campaigns.pause" | "campaigns.resume" | "wiring.ad_sets" | "quality.utm_refresh" | "wiring.recheck" | "actions.rollback" | "quality.url_tags_apply" | "quality.url_tags_undo" | "send.setup" | "send.dataset" | "send.stage" | "send.stop" | "send.restore" | null;
             /** @description `campaign_pause` only: the line the sheet leads with — «Pausar «{campaign}» · detiene {n} anuncios · ~$X al día» (the count and the daily figure are dropped when unknown). */
             summary?: string;
             campaign?: components["schemas"]["AdsCampaignPauseSnapshot"];
@@ -181073,6 +182955,15 @@ interface components {
              * @enum {string|null}
              */
             reason: "not_sending" | "dataset_restricted" | "dataset_unknown" | "already_open" | null;
+            /**
+             * @description D81: the event the test arm should optimise for — `appointment_booked` («cita agendada») until the account reaches ~`first_payment_threshold` new patients’ first payments a week, then `first_payment`. The default `test_event` of `POST /ads/experiments`. Absent when the count could not be read.
+             * @enum {string}
+             */
+            suggested_test_event?: "appointment_booked" | "first_payment";
+            /** @description New patients’ first payments a week (one decimal; «Envío a Meta»’s «Por semana»), `null` = unknown. */
+            weekly_first_payments?: number | null;
+            /** @description First payments a week from which Meta optimises on the first payment (~50). */
+            first_payment_threshold?: number;
         };
         AdsExperiment: {
             /** Format: uuid */