@revturbine/sdk 0.7.12 → 0.8.0

package/dist/index.d.ts

@@ -3330,6 +3330,23 @@ declare const AnalyticsCatalogMetricSchema: z.ZodObject<{
     }>>;
     numerator_metric: z.ZodOptional<z.ZodString>;
     denominator_metric: z.ZodOptional<z.ZodString>;
+    derivation: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            derived: "derived";
+            observed: "observed";
+            unavailable: "unavailable";
+        }>;
+        input_origin: z.ZodEnum<{
+            none: "none";
+            platform: "platform";
+            customer_authored: "customer_authored";
+            mixed: "mixed";
+        }>;
+        ingested_events: z.ZodArray<z.ZodString>;
+        ingested_datasources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        carried_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     deprecation: z.ZodOptional<z.ZodObject<{
         deprecated: z.ZodBoolean;
         replaced_by: z.ZodOptional<z.ZodString>;
@@ -3401,6 +3418,23 @@ declare const AnalyticsCatalogMetricValidatedSchema: z.ZodObject<{
     }>>;
     numerator_metric: z.ZodOptional<z.ZodString>;
     denominator_metric: z.ZodOptional<z.ZodString>;
+    derivation: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            derived: "derived";
+            observed: "observed";
+            unavailable: "unavailable";
+        }>;
+        input_origin: z.ZodEnum<{
+            none: "none";
+            platform: "platform";
+            customer_authored: "customer_authored";
+            mixed: "mixed";
+        }>;
+        ingested_events: z.ZodArray<z.ZodString>;
+        ingested_datasources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        carried_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     deprecation: z.ZodOptional<z.ZodObject<{
         deprecated: z.ZodBoolean;
         replaced_by: z.ZodOptional<z.ZodString>;
@@ -3441,6 +3475,16 @@ declare const AnalyticsCatalogConceptSchema: z.ZodObject<{
         revturbine_influenced: "revturbine_influenced";
     }>;
     coverage_metric: z.ZodOptional<z.ZodString>;
+    dimension_groundings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        kind: z.ZodEnum<{
+            derived: "derived";
+            stamped: "stamped";
+            membership_join: "membership_join";
+            config_join: "config_join";
+        }>;
+        source: z.ZodString;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     deprecation: z.ZodOptional<z.ZodObject<{
         deprecated: z.ZodBoolean;
         replaced_by: z.ZodOptional<z.ZodString>;
@@ -5565,6 +5609,16 @@ declare const AnalyticsCatalogSchema: z.ZodObject<{
             revturbine_influenced: "revturbine_influenced";
         }>;
         coverage_metric: z.ZodOptional<z.ZodString>;
+        dimension_groundings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            kind: z.ZodEnum<{
+                derived: "derived";
+                stamped: "stamped";
+                membership_join: "membership_join";
+                config_join: "config_join";
+            }>;
+            source: z.ZodString;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
         deprecation: z.ZodOptional<z.ZodObject<{
             deprecated: z.ZodBoolean;
             replaced_by: z.ZodOptional<z.ZodString>;
@@ -5689,6 +5743,23 @@ declare const AnalyticsCatalogSchema: z.ZodObject<{
         }>>;
         numerator_metric: z.ZodOptional<z.ZodString>;
         denominator_metric: z.ZodOptional<z.ZodString>;
+        derivation: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                derived: "derived";
+                observed: "observed";
+                unavailable: "unavailable";
+            }>;
+            input_origin: z.ZodEnum<{
+                none: "none";
+                platform: "platform";
+                customer_authored: "customer_authored";
+                mixed: "mixed";
+            }>;
+            ingested_events: z.ZodArray<z.ZodString>;
+            ingested_datasources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            carried_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         deprecation: z.ZodOptional<z.ZodObject<{
             deprecated: z.ZodBoolean;
             replaced_by: z.ZodOptional<z.ZodString>;
@@ -6050,6 +6121,33 @@ interface AnalyticsCatalogView {
     metricsFor(conceptId: string): AnalyticsCatalogMetric$1[];
     /** The annotation-kind vocabulary this catalog carries, sorted by kind. */
     listAnnotationKinds(): AnalyticsCatalogAnnotationKind$1[];
+    /**
+     * The derived data products one INGESTED EVENT feeds, sorted by metric id.
+     *
+     * The question this answers is the one nobody could answer before: "a tenant
+     * emits `gate_evaluated` — what lights up?" and, read backwards, "this chart
+     * is empty, which event is missing?" Pass a platform event name from the
+     * taxonomy or a datasource name; both sides of a metric's declared inputs
+     * are indexed.
+     */
+    metricsFromIngestedSource(sourceName: string): AnalyticsCatalogMetric$1[];
+    /**
+     * Every ingested event and datasource the catalog reads, sorted. The set of
+     * inputs the product depends on — useful for asking what a new tenant must
+     * emit before its analytics are populated.
+     */
+    listIngestedSources(): string[];
+    /**
+     * The metrics one Tinybird pipe carries, sorted by metric id (plan 228
+     * TASK-3). "Carries" is pipe-allowlist truth — the pipe accepts and serves
+     * the metric id — not a claim that rows exist for it (a carried metric with
+     * derivation.kind='unavailable' is exactly the carried-but-dark state the
+     * register surfaces). This is the read the web execution layer derives its
+     * pipe allowlists from, replacing hand-maintained Record maps.
+     */
+    metricsForPipe(pipeName: string): AnalyticsCatalogMetric$1[];
+    /** Every pipe name any metric declares carriage on, sorted. */
+    listCarryingPipes(): string[];
 }
 declare function createInMemoryAnalyticsCatalog(data: unknown): AnalyticsCatalogView;
 /**
@@ -6606,9 +6704,9 @@ declare const GrowthSignalSeriesSchema: z.ZodObject<{
 /** Normalized output of a GrowthSignalProvider. */
 declare const GrowthSignalBundleSchema: z.ZodObject<{
     availability: z.ZodEnum<{
+        unavailable: "unavailable";
         available: "available";
         stale: "stale";
-        unavailable: "unavailable";
         unsupported: "unsupported";
         partial: "partial";
     }>;
@@ -6766,20 +6864,20 @@ declare const OpportunityCandidateSchema: z.ZodObject<{
 
 declare const EventSourceSchema: z.ZodEnum<{
     system: "system";
+    workflow: "workflow";
     clickstream: "clickstream";
     telemetry: "telemetry";
     sdk: "sdk";
-    workflow: "workflow";
 }>;
 declare const EventEnvelopeSchema: z.ZodObject<{
     id: z.ZodString;
     event_type: z.ZodString;
     source: z.ZodDefault<z.ZodEnum<{
         system: "system";
+        workflow: "workflow";
         clickstream: "clickstream";
         telemetry: "telemetry";
         sdk: "sdk";
-        workflow: "workflow";
     }>>;
     tenant_id: z.ZodOptional<z.ZodString>;
     user_id: z.ZodOptional<z.ZodString>;
@@ -6794,10 +6892,10 @@ declare const IngestedEventSchema: z.ZodObject<{
     event_type: z.ZodString;
     source: z.ZodDefault<z.ZodEnum<{
         system: "system";
+        workflow: "workflow";
         clickstream: "clickstream";
         telemetry: "telemetry";
         sdk: "sdk";
-        workflow: "workflow";
     }>>;
     tenant_id: z.ZodOptional<z.ZodString>;
     user_id: z.ZodOptional<z.ZodString>;
@@ -6831,6 +6929,7 @@ declare const TreatmentInteractionTypeSchema: z.ZodEnum<{
 }>;
 declare const TreatmentInteractionInputSchema: z.ZodObject<{
     user_id: z.ZodString;
+    account_id: z.ZodOptional<z.ZodString>;
     placement_id: z.ZodString;
     treatment_id: z.ZodOptional<z.ZodString>;
     surface_slot_id: z.ZodOptional<z.ZodString>;
@@ -6852,12 +6951,105 @@ declare const TreatmentInteractionInputSchema: z.ZodObject<{
     test: z.ZodOptional<z.ZodBoolean>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
+/**
+ * Batch ceiling for `/api/events/interactions`, mirroring the clickstream
+ * batch bound so both ingest surfaces refuse at the same size.
+ */
+declare const MAX_TREATMENT_INTERACTIONS_PER_BATCH = 500;
+/**
+ * The array wire shape for treatment interactions.
+ *
+ * The SDK's `flushInteractionQueue` sends a bare {@link TreatmentInteractionInputSchema}
+ * when one interaction is queued and this array when two or more are. Only the
+ * bare shape was ever declared, so the route parsed only that — every
+ * multi-item flush 422'd and its interactions were lost (plan 232). Declaring
+ * the array here makes the batch bound and the item shape one definition that
+ * the route and the SDK both consume, so the two cannot drift apart silently
+ * again; a wire-contract test asserts the exact bodies the SDK builds parse
+ * against {@link TreatmentInteractionRequestSchema}.
+ */
+declare const TreatmentInteractionBatchSchema: z.ZodArray<z.ZodObject<{
+    user_id: z.ZodString;
+    account_id: z.ZodOptional<z.ZodString>;
+    placement_id: z.ZodString;
+    treatment_id: z.ZodOptional<z.ZodString>;
+    surface_slot_id: z.ZodOptional<z.ZodString>;
+    surface_template_id: z.ZodOptional<z.ZodString>;
+    payload_id: z.ZodOptional<z.ZodString>;
+    interaction_type: z.ZodEnum<{
+        dismiss: "dismiss";
+        impression: "impression";
+        remind_me_later: "remind_me_later";
+        cta_clicked: "cta_clicked";
+        cta_completed: "cta_completed";
+        suppress: "suppress";
+    }>;
+    interaction_at: z.ZodOptional<z.ZodString>;
+    message_block_handle: z.ZodOptional<z.ZodString>;
+    message_block_id: z.ZodOptional<z.ZodString>;
+    experiment_id: z.ZodOptional<z.ZodString>;
+    variant_key: z.ZodOptional<z.ZodString>;
+    test: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>>;
+/**
+ * Either wire shape, as the route accepts them. This is what the OpenAPI
+ * request body declares, so a generated client can send either without
+ * reaching past the contract.
+ */
+declare const TreatmentInteractionRequestSchema: z.ZodUnion<readonly [z.ZodObject<{
+    user_id: z.ZodString;
+    account_id: z.ZodOptional<z.ZodString>;
+    placement_id: z.ZodString;
+    treatment_id: z.ZodOptional<z.ZodString>;
+    surface_slot_id: z.ZodOptional<z.ZodString>;
+    surface_template_id: z.ZodOptional<z.ZodString>;
+    payload_id: z.ZodOptional<z.ZodString>;
+    interaction_type: z.ZodEnum<{
+        dismiss: "dismiss";
+        impression: "impression";
+        remind_me_later: "remind_me_later";
+        cta_clicked: "cta_clicked";
+        cta_completed: "cta_completed";
+        suppress: "suppress";
+    }>;
+    interaction_at: z.ZodOptional<z.ZodString>;
+    message_block_handle: z.ZodOptional<z.ZodString>;
+    message_block_id: z.ZodOptional<z.ZodString>;
+    experiment_id: z.ZodOptional<z.ZodString>;
+    variant_key: z.ZodOptional<z.ZodString>;
+    test: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodArray<z.ZodObject<{
+    user_id: z.ZodString;
+    account_id: z.ZodOptional<z.ZodString>;
+    placement_id: z.ZodString;
+    treatment_id: z.ZodOptional<z.ZodString>;
+    surface_slot_id: z.ZodOptional<z.ZodString>;
+    surface_template_id: z.ZodOptional<z.ZodString>;
+    payload_id: z.ZodOptional<z.ZodString>;
+    interaction_type: z.ZodEnum<{
+        dismiss: "dismiss";
+        impression: "impression";
+        remind_me_later: "remind_me_later";
+        cta_clicked: "cta_clicked";
+        cta_completed: "cta_completed";
+        suppress: "suppress";
+    }>;
+    interaction_at: z.ZodOptional<z.ZodString>;
+    message_block_handle: z.ZodOptional<z.ZodString>;
+    message_block_id: z.ZodOptional<z.ZodString>;
+    experiment_id: z.ZodOptional<z.ZodString>;
+    variant_key: z.ZodOptional<z.ZodString>;
+    test: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>>]>;
 declare const TriggerEventTypeSchema: z.ZodEnum<{
     payment_failed: "payment_failed";
     feature_gated: "feature_gated";
+    trial_expired: "trial_expired";
     trial_midpoint: "trial_midpoint";
     trial_expiring: "trial_expiring";
-    trial_expired: "trial_expired";
     usage_limit_approaching: "usage_limit_approaching";
     usage_limit_reached: "usage_limit_reached";
     credit_balance_low: "credit_balance_low";
@@ -6904,17 +7096,17 @@ declare const ControlPlaneEventTypeSchema: z.ZodEnum<{
     cli_signed_up: "cli_signed_up";
     cli_signed_in: "cli_signed_in";
     cli_command_executed: "cli_command_executed";
-    changeset_submitted: "changeset_submitted";
-    changeset_approved: "changeset_approved";
-    changeset_rejected: "changeset_rejected";
-    changeset_deployed: "changeset_deployed";
-    changeset_launched: "changeset_launched";
-    changeset_parked: "changeset_parked";
-    changeset_resumed: "changeset_resumed";
-    changeset_discarded: "changeset_discarded";
-    changeset_archived: "changeset_archived";
-    config_imported: "config_imported";
-    config_exported: "config_exported";
+    playbook_version_submitted: "playbook_version_submitted";
+    playbook_version_approved: "playbook_version_approved";
+    playbook_version_rejected: "playbook_version_rejected";
+    playbook_version_deployed: "playbook_version_deployed";
+    playbook_version_launched: "playbook_version_launched";
+    playbook_version_parked: "playbook_version_parked";
+    playbook_version_resumed: "playbook_version_resumed";
+    playbook_version_discarded: "playbook_version_discarded";
+    playbook_version_archived: "playbook_version_archived";
+    playbook_imported: "playbook_imported";
+    playbook_exported: "playbook_exported";
     entity_created: "entity_created";
     entity_updated: "entity_updated";
     entity_deleted: "entity_deleted";
@@ -6927,17 +7119,17 @@ declare const ControlPlaneSemanticEventSchema: z.ZodObject<{
         cli_signed_up: "cli_signed_up";
         cli_signed_in: "cli_signed_in";
         cli_command_executed: "cli_command_executed";
-        changeset_submitted: "changeset_submitted";
-        changeset_approved: "changeset_approved";
-        changeset_rejected: "changeset_rejected";
-        changeset_deployed: "changeset_deployed";
-        changeset_launched: "changeset_launched";
-        changeset_parked: "changeset_parked";
-        changeset_resumed: "changeset_resumed";
-        changeset_discarded: "changeset_discarded";
-        changeset_archived: "changeset_archived";
-        config_imported: "config_imported";
-        config_exported: "config_exported";
+        playbook_version_submitted: "playbook_version_submitted";
+        playbook_version_approved: "playbook_version_approved";
+        playbook_version_rejected: "playbook_version_rejected";
+        playbook_version_deployed: "playbook_version_deployed";
+        playbook_version_launched: "playbook_version_launched";
+        playbook_version_parked: "playbook_version_parked";
+        playbook_version_resumed: "playbook_version_resumed";
+        playbook_version_discarded: "playbook_version_discarded";
+        playbook_version_archived: "playbook_version_archived";
+        playbook_imported: "playbook_imported";
+        playbook_exported: "playbook_exported";
         entity_created: "entity_created";
         entity_updated: "entity_updated";
         entity_deleted: "entity_deleted";
@@ -6953,10 +7145,10 @@ declare const EventSearchParamsSchema: z.ZodObject<{
     q: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodEnum<{
         system: "system";
+        workflow: "workflow";
         clickstream: "clickstream";
         telemetry: "telemetry";
         sdk: "sdk";
-        workflow: "workflow";
     }>>;
     event_type: z.ZodOptional<z.ZodString>;
     from: z.ZodOptional<z.ZodString>;
@@ -7011,9 +7203,9 @@ declare const TrackEventSchema: z.ZodObject<{
     tenant_id: z.ZodOptional<z.ZodString>;
     event_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     origin: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        derived: "derived";
         explicit: "explicit";
         automatic: "automatic";
-        derived: "derived";
         raw: "raw";
     }>>>;
     playbook_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7037,9 +7229,9 @@ declare const TrackIngestBatchSchema: z.ZodObject<{
         tenant_id: z.ZodOptional<z.ZodString>;
         event_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         origin: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            derived: "derived";
             explicit: "explicit";
             automatic: "automatic";
-            derived: "derived";
             raw: "raw";
         }>>>;
         playbook_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7240,16 +7432,24 @@ declare const EventTaxonomySchema: z.ZodObject<{
  * Control-plane events, emitted by revturbine-web itself (plan 112).
  * `source` (system vs workflow) is a separate axis carried on the event.
  */
-declare const CONTROL_PLANE_EVENT_NAMES: readonly ["web_signed_up", "web_signed_in", "cli_signed_up", "cli_signed_in", "cli_command_executed", "changeset_submitted", "changeset_approved", "changeset_rejected", "changeset_deployed", "changeset_launched", "changeset_parked", "changeset_resumed", "changeset_discarded", "changeset_archived", "config_imported", "config_exported", "entity_created", "entity_updated", "entity_deleted", "web_api_error"];
+declare const CONTROL_PLANE_EVENT_NAMES: readonly ["web_signed_up", "web_signed_in", "cli_signed_up", "cli_signed_in", "cli_command_executed", "playbook_version_submitted", "playbook_version_approved", "playbook_version_rejected", "playbook_version_deployed", "playbook_version_launched", "playbook_version_parked", "playbook_version_resumed", "playbook_version_discarded", "playbook_version_archived", "playbook_imported", "playbook_exported", "entity_created", "entity_updated", "entity_deleted", "web_api_error"];
 /**
  * SDK-automatic client events with fixed names. Prefix-family members
  * (`engagement_*`) are NOT listed here — see {@link EVENT_PREFIX_FAMILIES}.
  */
-declare const SDK_CLIENT_EVENT_NAMES: readonly ["placement_resolved", "placement_rendered", "placement_exposed", "placement_outcome", "placement_interaction", "gate_evaluated", "gate_attempted", "gate_allowed", "gate_denied", "slot_evaluated", "slot_filled", "slot_empty", "slot_suppressed", "slot_error", "segment_enrolled", "segment_unenrolled", "experiment_assigned", "user_context_observed", "page_view"];
+declare const SDK_CLIENT_EVENT_NAMES: readonly ["placement_resolved", "placement_rendered", "placement_exposed", "placement_outcome", "placement_interaction", "gate_evaluated", "gate_attempted", "gate_allowed", "gate_denied", "slot_evaluated", "slot_filled", "slot_empty", "slot_suppressed", "slot_error", "segment_enrolled", "segment_unenrolled", "experiment_assigned", "user_context_observed", "clickstream_page_view", "account_created", "user_signed_up", "onboarding_completed", "account_activated", "product_used", "value_realized", "usage_recorded", "plan_viewed", "promotion_applied", "promotion_converted"];
 /**
  * Anonymous SDK telemetry on the keyless meta lane (plan 95/144). These carry
  * no tenant and no user context, so they are `internal` by construction.
  */
+/**
+ * Server-produced derived observations (plan 228 TASK-2 audit). Not emitted by
+ * the client SDK — written by producers that aggregate facts into windowed
+ * metric observations (today: the Growth Lab loader; tomorrow: any in-engine
+ * aggregator). Declared so the parity scan and every reader can SEE the name;
+ * excluded from the sdk_client emit-parity direction by surface.
+ */
+declare const SDK_SERVER_EVENT_NAMES: readonly ["growth_signal_observed"];
 declare const SDK_META_EVENT_NAMES: readonly ["sdk_init", "sdk_error", "sdk_validation_warning", "resolution_failure"];
 /**
  * Product signals revturbine-web emits about ITSELF, through the customer
@@ -7265,14 +7465,32 @@ declare const SDK_META_EVENT_NAMES: readonly ["sdk_init", "sdk_error", "sdk_vali
  *    from `ControlPlaneEventType`; a name on both lanes double-counts one
  *    operator action.
  *
- * They are `control_plane` by SURFACE — they originate in revturbine-web — and
- * so are excluded from the SDK's two-directional parity scan, which is scoped
- * to `sdk_client`. That is correct: no SDK emit site produces them, and
- * declaring them as SDK-emitted would manufacture exactly the
- * declared-but-never-emitted defect that scan exists to catch.
+ * SURFACE (plan 228 TASK-5 dogfood ruling): `sdk_client`, reclassified from
+ * `control_plane`. These are generic product-usage telemetry any tenant's
+ * app could legitimately report about itself through the SDK's typed emit
+ * surface — "RevTurbine's own vocabulary" was never load-bearing for them,
+ * unlike the CP proper (auth, playbook-version lifecycle, entity CRUD),
+ * which stays structurally unforgeable. revturbine-web swaps its `track()`
+ * call sites to `emitPlatformEvent` at its next SDK pin bump; until then
+ * its emissions ride the generic lane of a pre-namespacing SDK and land
+ * raw, exactly as before.
  */
 declare const DOGFOOD_CLIENT_EVENT_NAMES: readonly ["area_viewed", "feature_gated"];
-type EventName = (typeof CONTROL_PLANE_EVENT_NAMES)[number] | (typeof DOGFOOD_CLIENT_EVENT_NAMES)[number] | (typeof SDK_CLIENT_EVENT_NAMES)[number] | (typeof SDK_META_EVENT_NAMES)[number];
+/**
+ * Billing lifecycle events (plan 228 R-2). Dual-source BY CONTRACT: the Stripe
+ * webhook processor translates `stripe_event_type` onto these names, AND the
+ * SDK exposes a typed emit path for each under the same payload schema — so a
+ * tenant on a different biller (or none) produces identical facts. The surface
+ * is `webhook_derived` because that is the historically-primary producer; it
+ * does NOT mean webhook-only, and the emit↔taxonomy parity scan includes these
+ * on the SDK side.
+ *
+ * Every payload carries `billing_ref` — the producer-minted idempotency key
+ * that makes a Stripe delivery and an SDK emission of the same commercial fact
+ * collapse to one row (the identity key, consumed by datasource derivation).
+ */
+declare const WEBHOOK_DERIVED_EVENT_NAMES: readonly ["subscription_started", "subscription_renewed", "subscription_expanded", "subscription_canceled", "trial_started", "trial_converted", "trial_expired", "payment_succeeded", "payment_failed"];
+type EventName = (typeof CONTROL_PLANE_EVENT_NAMES)[number] | (typeof DOGFOOD_CLIENT_EVENT_NAMES)[number] | (typeof SDK_CLIENT_EVENT_NAMES)[number] | (typeof SDK_SERVER_EVENT_NAMES)[number] | (typeof SDK_META_EVENT_NAMES)[number] | (typeof WEBHOOK_DERIVED_EVENT_NAMES)[number];
 /**
  * Names the SDK classifies as platform-automatic for ORIGIN tagging without
  * emitting them itself. `impression` is the clearest case: it is an
@@ -7314,9 +7532,744 @@ declare const PLATFORM_EVENT_TAXONOMY: {
 };
 /** Every platform-emitted event name, for the cross-repo parity assertion. */
 declare const PLATFORM_EMITTED_EVENT_NAMES: readonly string[];
+/**
+ * Namespace a customer-supplied event name that collides with platform
+ * vocabulary (plan 228 TASK-4). The generic `track()` lane — SDK and
+ * `/api/track` ingest alike — runs every ALREADY-NORMALIZED name through
+ * this, so platform events are unforgeable from the untyped path: a
+ * customer's `track('gate_attempted')` lands as `clickstream_gate_attempted`
+ * while the typed emit surface sends `gate_attempted` raw.
+ *
+ * Derived from the taxonomy, not a hardcoded switch, so a name added to the
+ * taxonomy is protected the moment it exists. Names already carrying the
+ * `clickstream_` namespace pass through — `clickstream_page_view` IS the
+ * platform name for the generic page-view alias (wire truth), and the guard
+ * also makes the function idempotent.
+ */
+declare function namespacePlatformCollision(normalizedName: string): string;
 /** Names exempt from the declared-but-never-emitted parity direction. */
 declare const DEPRECATED_EVENT_NAMES: readonly string[];
 
+/**
+ * Per-event payload contracts (plan 228 REQ-1) — one Zod schema for EVERY
+ * taxonomy event, plus the identity key that makes two emissions the same
+ * fact.
+ *
+ * Before this file, event NAMES were declared (plan 181) but payloads were
+ * untyped bags: `EventEnvelopeSchema.payload` is `z.record(z.string(),
+ * z.unknown())`, and each contract lived only in the body of its emit site.
+ * That is how R-10 shipped — `emitGateEvaluated`'s property set existed
+ * nowhere a validator, a reader, or a simulator could check against, so a
+ * double-wrapped payload validated fine and read as empty everywhere.
+ *
+ * Every schema below is transcribed from a VERIFIED producer, not designed at
+ * a desk: the control-plane shapes from revturbine-web's `emitControlPlaneEvent`
+ * call sites, the SDK client shapes from `web-sdk/customer-side.ts` +
+ * `controllers.ts` emit sites, the meta-lane shapes from the
+ * `events_sdk_meta` / `events_sdk_diagnostics` datasource columns they land
+ * in. The billing band (plan 228 R-2) is the one designed-first set — it is
+ * NEW vocabulary, dual-source by contract (Stripe webhook processor and typed
+ * SDK emit share these schemas), and its fields exist to ground the catalog
+ * dimensions REQ-11 names (`commercial.plan`, `commercial.billing_period`,
+ * `trial.rule`).
+ *
+ * Three deliberate contract decisions:
+ *
+ *  - **Loose objects.** REQ-9's evolution policy is additive-only, and its
+ *    reader half is that a validator built against schema rev N accepts a
+ *    payload from rev N+1. `z.looseObject` preserves unknown keys instead of
+ *    stripping or rejecting them — an old ingest never mangles a newer
+ *    producer's additive field.
+ *  - **Identity keys are part of the contract.** `identity` names the payload
+ *    fields that make two emissions the same fact; `'event_id'` means the
+ *    envelope-level id is the only identity (the common case for telemetry).
+ *    Datasource sorting keys and dedup discriminators DERIVE from this
+ *    (REQ-4) — the `experiment_assignments` partition-key near-miss is why
+ *    keys are declared here rather than chosen per datasource.
+ *  - **Classification rides every field** (house `DataClassification` meta),
+ *    so PII handling derives from the contract; `pii-redact` remains
+ *    defense-in-depth, not the source of truth.
+ */
+
+type PlatformEventName = (typeof CONTROL_PLANE_EVENT_NAMES)[number] | (typeof DOGFOOD_CLIENT_EVENT_NAMES)[number] | (typeof SDK_CLIENT_EVENT_NAMES)[number] | (typeof SDK_SERVER_EVENT_NAMES)[number] | (typeof SDK_META_EVENT_NAMES)[number] | (typeof WEBHOOK_DERIVED_EVENT_NAMES)[number];
+interface EventPayloadContract {
+    /** The payload's Zod schema — loose, additive-tolerant (REQ-9). */
+    schema: z.ZodType;
+    /**
+     * Payload fields that make two emissions the same fact. `['event_id']`
+     * means the envelope id is the only identity (plain telemetry). Datasource
+     * sorting keys and dedup discriminators derive from this (REQ-4).
+     */
+    identity: readonly string[];
+}
+/**
+ * Total over every taxonomy name — adding an event in `taxonomy.ts` without a
+ * payload contract here is a COMPILE error, and the parity test holds the
+ * reverse direction.
+ *
+ * Declared with `satisfies` rather than an annotation so each entry keeps its
+ * SPECIFIC schema type: `EventPayloadInput<'gate_evaluated'>` resolves to the
+ * gate payload's input shape, which is what the SDK's typed emit surface
+ * infers its per-event parameter types from (plan 228 TASK-4).
+ */
+declare const EVENT_PAYLOAD_CONTRACTS: {
+    readonly web_signed_up: {
+        readonly schema: z.ZodObject<{
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly web_signed_in: {
+        readonly schema: z.ZodObject<{
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly cli_signed_up: {
+        readonly schema: z.ZodObject<{
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly cli_signed_in: {
+        readonly schema: z.ZodObject<{
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly cli_command_executed: {
+        readonly schema: z.ZodObject<{
+            command: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_version_submitted: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_version_approved: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_version_rejected: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_version_deployed: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_version_launched: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_version_parked: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_version_resumed: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_version_discarded: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_version_archived: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_imported: {
+        readonly schema: z.ZodObject<{
+            playbook_version_id: z.ZodString;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly playbook_exported: {
+        readonly schema: z.ZodObject<{
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly entity_created: {
+        readonly schema: z.ZodObject<{
+            resource: z.ZodString;
+            resource_id: z.ZodOptional<z.ZodString>;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly entity_updated: {
+        readonly schema: z.ZodObject<{
+            resource: z.ZodString;
+            resource_id: z.ZodOptional<z.ZodString>;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly entity_deleted: {
+        readonly schema: z.ZodObject<{
+            resource: z.ZodString;
+            resource_id: z.ZodOptional<z.ZodString>;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly web_api_error: {
+        readonly schema: z.ZodObject<{
+            request_id: z.ZodString;
+            status: z.ZodNumber;
+            route: z.ZodOptional<z.ZodString>;
+            method: z.ZodOptional<z.ZodString>;
+            error_code: z.ZodOptional<z.ZodString>;
+            control_plane_source: z.ZodEnum<{
+                system: "system";
+                workflow: "workflow";
+            }>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly area_viewed: {
+        readonly schema: z.ZodObject<{
+            area: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly feature_gated: {
+        readonly schema: z.ZodObject<{
+            pathname: z.ZodNullable<z.ZodString>;
+            reason: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly placement_resolved: {
+        readonly schema: z.ZodObject<{
+            placement_id: z.ZodString;
+            surface_slot_id: z.ZodNullable<z.ZodString>;
+            payload_id: z.ZodNullable<z.ZodString>;
+            decision_id: z.ZodNullable<z.ZodString>;
+            decision_source: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly placement_rendered: {
+        readonly schema: z.ZodObject<{
+            placement_id: z.ZodString;
+            surface_slot_id: z.ZodNullable<z.ZodString>;
+            payload_id: z.ZodNullable<z.ZodString>;
+            decision_id: z.ZodNullable<z.ZodString>;
+            decision_source: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly placement_exposed: {
+        readonly schema: z.ZodObject<{
+            exposure_basis: z.ZodOptional<z.ZodString>;
+            placement_id: z.ZodString;
+            surface_slot_id: z.ZodNullable<z.ZodString>;
+            payload_id: z.ZodNullable<z.ZodString>;
+            decision_id: z.ZodNullable<z.ZodString>;
+            decision_source: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly placement_outcome: {
+        readonly schema: z.ZodObject<{
+            outcome: z.ZodString;
+            cta_target: z.ZodNullable<z.ZodString>;
+            placement_id: z.ZodString;
+            surface_slot_id: z.ZodNullable<z.ZodString>;
+            payload_id: z.ZodNullable<z.ZodString>;
+            decision_id: z.ZodNullable<z.ZodString>;
+            decision_source: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly placement_interaction: {
+        readonly schema: z.ZodObject<{
+            interaction_type: z.ZodString;
+            placement_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            payload_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            decision_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            action_type: z.ZodOptional<z.ZodString>;
+            action_success: z.ZodOptional<z.ZodBoolean>;
+            interaction_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            remind_after_seconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly gate_evaluated: {
+        readonly schema: z.ZodObject<{
+            entitlement_handle: z.ZodString;
+            outcome: z.ZodEnum<{
+                allowed: "allowed";
+                limited: "limited";
+                denied: "denied";
+            }>;
+            gated: z.ZodBoolean;
+            reason: z.ZodNullable<z.ZodString>;
+            limit: z.ZodNullable<z.ZodNumber>;
+            used: z.ZodNullable<z.ZodNumber>;
+            remaining: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly gate_attempted: {
+        readonly schema: z.ZodObject<{
+            entitlement_handle: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly gate_allowed: {
+        readonly schema: z.ZodObject<{
+            entitlement_handle: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly gate_denied: {
+        readonly schema: z.ZodObject<{
+            entitlement_handle: z.ZodString;
+            reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly slot_evaluated: {
+        readonly schema: z.ZodObject<{
+            surface_slot_id: z.ZodNullable<z.ZodString>;
+            slot_name: z.ZodNullable<z.ZodString>;
+            template_ids: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            template_id: z.ZodNullable<z.ZodString>;
+            surface_type: z.ZodNullable<z.ZodString>;
+            category: z.ZodNullable<z.ZodString>;
+            decision_source: z.ZodNullable<z.ZodString>;
+            reason_codes: z.ZodArray<z.ZodString>;
+            decision_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly slot_filled: {
+        readonly schema: z.ZodObject<{
+            surface_slot_id: z.ZodNullable<z.ZodString>;
+            slot_name: z.ZodNullable<z.ZodString>;
+            template_ids: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            template_id: z.ZodNullable<z.ZodString>;
+            surface_type: z.ZodNullable<z.ZodString>;
+            category: z.ZodNullable<z.ZodString>;
+            decision_source: z.ZodNullable<z.ZodString>;
+            reason_codes: z.ZodArray<z.ZodString>;
+            decision_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly slot_empty: {
+        readonly schema: z.ZodObject<{
+            surface_slot_id: z.ZodNullable<z.ZodString>;
+            slot_name: z.ZodNullable<z.ZodString>;
+            template_ids: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            template_id: z.ZodNullable<z.ZodString>;
+            surface_type: z.ZodNullable<z.ZodString>;
+            category: z.ZodNullable<z.ZodString>;
+            decision_source: z.ZodNullable<z.ZodString>;
+            reason_codes: z.ZodArray<z.ZodString>;
+            decision_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly slot_suppressed: {
+        readonly schema: z.ZodObject<{
+            surface_slot_id: z.ZodNullable<z.ZodString>;
+            slot_name: z.ZodNullable<z.ZodString>;
+            template_ids: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            template_id: z.ZodNullable<z.ZodString>;
+            surface_type: z.ZodNullable<z.ZodString>;
+            category: z.ZodNullable<z.ZodString>;
+            decision_source: z.ZodNullable<z.ZodString>;
+            reason_codes: z.ZodArray<z.ZodString>;
+            decision_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly slot_error: {
+        readonly schema: z.ZodObject<{
+            message: z.ZodOptional<z.ZodString>;
+            surface_slot_id: z.ZodNullable<z.ZodString>;
+            slot_name: z.ZodNullable<z.ZodString>;
+            template_ids: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            template_id: z.ZodNullable<z.ZodString>;
+            surface_type: z.ZodNullable<z.ZodString>;
+            category: z.ZodNullable<z.ZodString>;
+            decision_source: z.ZodNullable<z.ZodString>;
+            reason_codes: z.ZodArray<z.ZodString>;
+            decision_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly segment_enrolled: {
+        readonly schema: z.ZodObject<{
+            segment_id: z.ZodString;
+            user_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly segment_unenrolled: {
+        readonly schema: z.ZodObject<{
+            segment_id: z.ZodString;
+            user_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly experiment_assigned: {
+        readonly schema: z.ZodObject<{
+            schema_version: z.ZodNumber;
+            assignment_id: z.ZodString;
+            experiment_id: z.ZodString;
+            experiment_version: z.ZodNumber;
+            variant_key: z.ZodString;
+            assignment_unit: z.ZodEnum<{
+                account: "account";
+                user: "user";
+                billing_unit: "billing_unit";
+                organization: "organization";
+            }>;
+            subject_id: z.ZodString;
+            assigned_at: z.ZodString;
+            provider_handle: z.ZodOptional<z.ZodString>;
+            provider_revision: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["assignment_id"];
+    };
+    readonly user_context_observed: {
+        readonly schema: z.ZodObject<{
+            context_fields: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly clickstream_page_view: {
+        readonly schema: z.ZodObject<{
+            mode: z.ZodOptional<z.ZodString>;
+            runtime_mode: z.ZodOptional<z.ZodString>;
+            source: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly account_created: {
+        readonly schema: z.ZodObject<{
+            acquisition_source: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly user_signed_up: {
+        readonly schema: z.ZodObject<{
+            acquisition_source: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly onboarding_completed: {
+        readonly schema: z.ZodObject<{}, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly account_activated: {
+        readonly schema: z.ZodObject<{}, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly product_used: {
+        readonly schema: z.ZodObject<{}, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly value_realized: {
+        readonly schema: z.ZodObject<{}, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly usage_recorded: {
+        readonly schema: z.ZodObject<{
+            metered_units: z.ZodNumber;
+            included_allowance: z.ZodNumber;
+            utilization: z.ZodNumber;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly plan_viewed: {
+        readonly schema: z.ZodObject<{
+            plan_handle: z.ZodString;
+            entry_tier: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly promotion_applied: {
+        readonly schema: z.ZodObject<{
+            promotion_handle: z.ZodString;
+            plan_handle: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly promotion_converted: {
+        readonly schema: z.ZodObject<{
+            promotion_handle: z.ZodString;
+            full_price: z.ZodOptional<z.ZodBoolean>;
+            plan_handle: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly growth_signal_observed: {
+        readonly schema: z.ZodObject<{
+            metric: z.ZodString;
+            dimension_key: z.ZodString;
+            dimension_value: z.ZodString;
+            window_start: z.ZodString;
+            window_end: z.ZodString;
+            value: z.ZodNumber;
+            numerator: z.ZodOptional<z.ZodNumber>;
+            denominator: z.ZodOptional<z.ZodNumber>;
+            sample_size: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly sdk_init: {
+        readonly schema: z.ZodObject<{
+            config_hash_id: z.ZodOptional<z.ZodString>;
+            sdk_version: z.ZodOptional<z.ZodString>;
+            runtime_mode: z.ZodOptional<z.ZodString>;
+            schema_version: z.ZodOptional<z.ZodString>;
+            bundle_version: z.ZodOptional<z.ZodString>;
+            config_shape: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly sdk_error: {
+        readonly schema: z.ZodObject<{
+            message: z.ZodString;
+            config_hash_id: z.ZodOptional<z.ZodString>;
+            sdk_version: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly sdk_validation_warning: {
+        readonly schema: z.ZodObject<{
+            message: z.ZodString;
+            config_hash_id: z.ZodOptional<z.ZodString>;
+            sdk_version: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly resolution_failure: {
+        readonly schema: z.ZodObject<{
+            reason: z.ZodString;
+            placement_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            slot_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            surface: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            plan_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            entitlement_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            message: z.ZodOptional<z.ZodString>;
+            config_hash_id: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["event_id"];
+    };
+    readonly subscription_started: {
+        readonly schema: z.ZodObject<{
+            billing_period: z.ZodString;
+            amount_cents: z.ZodNumber;
+            currency: z.ZodString;
+            billing_ref: z.ZodString;
+            plan_handle: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["billing_ref"];
+    };
+    readonly subscription_renewed: {
+        readonly schema: z.ZodObject<{
+            billing_period: z.ZodString;
+            amount_cents: z.ZodNumber;
+            currency: z.ZodString;
+            billing_ref: z.ZodString;
+            plan_handle: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["billing_ref"];
+    };
+    readonly subscription_expanded: {
+        readonly schema: z.ZodObject<{
+            previous_plan_handle: z.ZodOptional<z.ZodString>;
+            delta_cents: z.ZodOptional<z.ZodNumber>;
+            self_serve: z.ZodOptional<z.ZodBoolean>;
+            billing_period: z.ZodString;
+            amount_cents: z.ZodNumber;
+            currency: z.ZodString;
+            billing_ref: z.ZodString;
+            plan_handle: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["billing_ref"];
+    };
+    readonly subscription_canceled: {
+        readonly schema: z.ZodObject<{
+            reason: z.ZodOptional<z.ZodString>;
+            billing_ref: z.ZodString;
+            plan_handle: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["billing_ref"];
+    };
+    readonly trial_started: {
+        readonly schema: z.ZodObject<{
+            trial_rule_handle: z.ZodString;
+            ends_at: z.ZodString;
+            billing_ref: z.ZodString;
+            plan_handle: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["billing_ref"];
+    };
+    readonly trial_converted: {
+        readonly schema: z.ZodObject<{
+            trial_rule_handle: z.ZodString;
+            billing_period: z.ZodString;
+            amount_cents: z.ZodNumber;
+            currency: z.ZodString;
+            billing_ref: z.ZodString;
+            plan_handle: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["billing_ref"];
+    };
+    readonly trial_expired: {
+        readonly schema: z.ZodObject<{
+            trial_rule_handle: z.ZodString;
+            billing_ref: z.ZodString;
+            plan_handle: z.ZodString;
+        }, z.core.$loose>;
+        readonly identity: readonly ["billing_ref"];
+    };
+    readonly payment_succeeded: {
+        readonly schema: z.ZodObject<{
+            billing_ref: z.ZodString;
+            amount_cents: z.ZodNumber;
+            currency: z.ZodString;
+            plan_handle: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["billing_ref"];
+    };
+    readonly payment_failed: {
+        readonly schema: z.ZodObject<{
+            billing_ref: z.ZodString;
+            reason: z.ZodString;
+            amount_cents: z.ZodOptional<z.ZodNumber>;
+            currency: z.ZodOptional<z.ZodString>;
+            plan_handle: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly identity: readonly ["billing_ref"];
+    };
+};
+/** The contracts map with per-event schema types preserved (plan 228 TASK-4). */
+type EventPayloadContractMap = typeof EVENT_PAYLOAD_CONTRACTS;
+/**
+ * The input (pre-parse) payload shape for one platform event, inferred from
+ * its contract schema. The SDK's typed emit surface takes exactly this per
+ * event name, so the emit API cannot drift from the contract it validates
+ * against.
+ */
+type EventPayloadInput<K extends PlatformEventName> = z.input<EventPayloadContractMap[K]['schema']>;
+/**
+ * Every contracted event name, sorted in UTF-16 code-unit order (the default
+ * string sort — deliberately NOT localeCompare, per the single-canonicalizer
+ * rule; names are lowercase snake_case ASCII, where the two orders coincide,
+ * but the manifest must never depend on a locale).
+ */
+declare const EVENT_PAYLOAD_EVENT_NAMES: readonly string[];
+/**
+ * Validate a payload against its event's contract. Unknown events are a
+ * structured failure, not an exception — `/api/track` routes those (and
+ * schema violations) to the REQ-10 quarantine lane rather than dropping.
+ */
+declare function validateEventPayload(eventName: string, payload: unknown): {
+    ok: true;
+    payload: Record<string, unknown>;
+} | {
+    ok: false;
+    reason: 'unknown_event' | 'schema_violation';
+    detail?: string;
+};
+
 /**
  * Trial schemas — free trial rules, reverse trial rules, and trial instances.
  */
@@ -8925,8 +9878,8 @@ declare const ExperimentSchema: z.ZodObject<{
         provider_handle: z.ZodString;
         capability: z.ZodLiteral<"experiment_assignment">;
         allocation_mode: z.ZodEnum<{
-            managed: "managed";
             observed: "observed";
+            managed: "managed";
         }>;
     }, z.core.$strip>>;
     evidence_provider_binding: z.ZodOptional<z.ZodObject<{
@@ -14141,9 +15094,9 @@ declare const ProviderConnectionSchema: z.ZodObject<{
     credential_reference: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     environment_id: z.ZodDefault<z.ZodString>;
     health_state: z.ZodDefault<z.ZodEnum<{
+        unavailable: "unavailable";
         available: "available";
         stale: "stale";
-        unavailable: "unavailable";
         unsupported: "unsupported";
         partial: "partial";
     }>>;
@@ -14698,9 +15651,9 @@ declare const ProviderCapabilitySchema: z.ZodEnum<{
  * configuration error rather than an outage.
  */
 declare const ProviderAvailabilitySchema: z.ZodEnum<{
+    unavailable: "unavailable";
     available: "available";
     stale: "stale";
-    unavailable: "unavailable";
     unsupported: "unsupported";
     partial: "partial";
 }>;
@@ -15087,7 +16040,9 @@ type TenantStatus = z.infer<typeof TenantStatusSchema>;
 type Theme = z.infer<typeof ThemeSchema>;
 type TrackEvent = z.infer<typeof TrackEventSchema>;
 type TrackIngestBatch = z.infer<typeof TrackIngestBatchSchema>;
+type TreatmentInteractionBatch = z.infer<typeof TreatmentInteractionBatchSchema>;
 type TreatmentInteractionInput = z.infer<typeof TreatmentInteractionInputSchema>;
+type TreatmentInteractionRequest = z.infer<typeof TreatmentInteractionRequestSchema>;
 type TreatmentInteractionType = z.infer<typeof TreatmentInteractionTypeSchema>;
 type TrendFeatures = z.infer<typeof TrendFeaturesSchema>;
 type TrialEligibilityScope = z.infer<typeof TrialEligibilityScopeSchema>;
@@ -15116,26 +16071,67 @@ type WebhookEventLog = z.infer<typeof WebhookEventLogSchema>;
 type WebhookEventSource = z.infer<typeof WebhookEventSourceSchema>;
 type WebhookEventStatus = z.infer<typeof WebhookEventStatusSchema>;
 
+declare const REQUIRED_BODY_ARRAY_FIELDS: readonly ["plans", "entitlements", "entitlement_rules", "segments", "content_ui_paths"];
 /** A canonical Playbook or the deprecated RevTurbineConfig wire shape. */
 type ConfigArtifact = Playbook | RevTurbineConfig;
 /**
  * A config artifact as raw parsed JSON — what
  * `import playbook from './revturbine.playbook.json'` produces.
  *
- * TypeScript widens JSON modules to plain `string`/`number` property types,
- * which can never satisfy the literal-typed {@link ConfigArtifact}
- * (`artifact_type: "playbook"` etc.), so a strict-mode project could not pass
- * the imported JSON without a cast. The SDK therefore accepts this raw shape
- * everywhere a {@link ConfigArtifact} is accepted at the `localRuntime`
- * boundary and validates it at runtime ({@link normalizeConfigArtifactOrThrow}
- * — a malformed artifact fails fast at init with a descriptive error).
- */
-type UnvalidatedConfigArtifact = Record<string, unknown>;
-/** Target values used only when an older legacy artifact predates target stamping. */
-interface LegacyConfigTargetDefaults {
+ * This exists because TypeScript widens JSON modules to plain `string`/`number`
+ * property types, which can never satisfy the literal-typed
+ * {@link ConfigArtifact} (`artifact_type: "playbook"` etc.), so a strict-mode
+ * project could not pass the imported JSON without a cast.
+ *
+ * Widening affects only *literal* types, so it is no reason to give up on the
+ * rest of the shape. The body arrays are structurally required here, which
+ * makes a truncated artifact a **compile** error at the `localRuntime`
+ * boundary rather than a runtime one — the whole point of plan 233. The header
+ * fields stay unconstrained because those are exactly the widened ones.
+ *
+ * The required-field list is *derived* from {@link REQUIRED_BODY_ARRAY_FIELDS},
+ * the same constant {@link normalizeConfigArtifactOrThrow} validates against at
+ * runtime, so the compile-time and runtime contracts cannot drift apart.
+ *
+ * The index signature keeps every other field open: a Playbook carries many
+ * optional header fields, and a *fetched* artifact (`await res.json()`, typed
+ * `any`) still satisfies this, so the served path is not made harder to write —
+ * only harder to get silently wrong. Values are still validated at runtime by
+ * {@link normalizeConfigArtifactOrThrow}, which fails fast with a descriptive
+ * error; this type constrains the *shape*, never the values.
+ */
+type UnvalidatedConfigArtifact = {
+    [K in (typeof REQUIRED_BODY_ARRAY_FIELDS)[number]]: unknown[];
+} & {
+    [key: string]: unknown;
+};
+/**
+ * The target (tenant + environment) the SDK was initialized against.
+ *
+ * These are the **authority** on which tenant a runtime decides for. An
+ * artifact's own `tenant_id` / `environment_id` are a *guard*: they exist so the
+ * CLI can refuse to upload a config to the wrong tenant while setting up demo
+ * environments, and they are not a runtime input (plan 233 REQ-2, Kent 2026-09-10).
+ *
+ * A disagreement between the two warns and proceeds on these values — it never
+ * fails init. See {@link normalizeConfigArtifactOrThrow}.
+ *
+ * @public
+ */
+interface ConfigTargetDefaults {
+    /** Tenant the SDK was initialized with. Wins over the artifact's `tenant_id`. */
     tenantId: string;
+    /** Environment the SDK was initialized with. Wins over the artifact's `environment_id`. */
     environmentId: string;
 }
+/**
+ * @deprecated Renamed to {@link ConfigTargetDefaults} in plan 233 — these values
+ * are no longer "legacy defaults" applied only to pre-stamping artifacts; they
+ * are the authoritative target for every artifact shape. Kept as an alias so the
+ * already-shipped export keeps resolving.
+ * @public
+ */
+type LegacyConfigTargetDefaults = ConfigTargetDefaults;
 /**
  * Parse either supported wire shape into the canonical Playbook shape.
  *
@@ -15143,7 +16139,7 @@ interface LegacyConfigTargetDefaults {
  * an unsupported future `format_version` can never fall back to legacy.
  */
 declare function normalizeConfigArtifactOrThrow(raw: unknown, // sdk-ok: boundary-parse
-source: string, legacyTargetDefaults?: LegacyConfigTargetDefaults): Playbook | undefined;
+source: string, targetDefaults?: ConfigTargetDefaults): Playbook | undefined;
 
 /**
  * Core type definitions shared across the isomorphic SDK.
@@ -17198,10 +18194,10 @@ declare function resolveBranding(input?: BrandingResolutionInput): ResolvedBrand
 /**
  * Control-plane semantic events (plan 112).
  *
- * A typed layer over the SDK's generic event emit path for RevTurbine's OWN
- * control-plane activity — web/CLI auth, change-set lifecycle, config, and
- * product-entity actions. This is the "dogfood" surface: RevTurbine emits its
- * product usage through the same SDK a customer uses.
+ * A typed layer over the SDK's raw event emit path for RevTurbine's OWN
+ * control-plane activity — web/CLI auth, playbook-version lifecycle, playbook
+ * transfer, and product-entity actions. This is the "dogfood" surface:
+ * RevTurbine emits its product usage through the same SDK a customer uses.
  *
  * The taxonomy itself is the canonical `ControlPlaneEventType` /
  * `ControlPlaneEventSource` enums from `@revt-eng/schema`; this module adds the
@@ -17219,7 +18215,8 @@ declare function resolveBranding(input?: BrandingResolutionInput): ResolvedBrand
 /**
  * Canonical source classification for every control-plane event type — mirrors
  * the scaffold taxonomy. `system` covers identity/auth + CLI command telemetry;
- * `workflow` covers change-set lifecycle, config, and product-entity actions.
+ * `workflow` covers playbook-version lifecycle, playbook transfer, and
+ * product-entity actions.
  *
  * Typed as a total `Record`, so adding a new `ControlPlaneEventType` in scaffold
  * without classifying it here is a compile error.
@@ -17921,6 +18918,43 @@ type RevTurbineLocalOnlyMinimalInitOptions = Omit<RevTurbineInitOptions, 'tenant
  * alias) is provided.
  */
 type RevTurbineInitInputOptions = RevTurbineInitWithProviderOptions | (RevTurbineLocalOnlyMinimalInitOptions & RevTurbineProviderOptionAugmentations);
+/**
+ * Every key any init-options branch accepts.
+ *
+ * Built from the branches rather than written as `keyof RevTurbineInitInputOptions`:
+ * `keyof` over a union yields the INTERSECTION of its members' keys, so that
+ * form would reject `localRuntime` (local-only branch) and `provider`
+ * (augmentation branch) — every key that makes the union worth having.
+ */
+type RevTurbineInitOptionKey = keyof RevTurbineInitOptions | keyof RevTurbineProviderOptionAugmentations;
+/**
+ * Exact-check for init options (plan 233 REQ-2b).
+ *
+ * A key the options do not declare becomes `never`, which turns a typo or a
+ * stale option into a compile error instead of a value the SDK silently ignores.
+ *
+ * The motivating shape is the same one `Exact` was introduced for in plan 191:
+ * TypeScript's excess-property check applies only to fresh object literals, so
+ * options assembled in a variable — or in an un-annotated `useMemo`, which is
+ * exactly how React integrations build them — carried unknown keys with no
+ * diagnostic at all.
+ *
+ * Scope limit worth stating: this cannot catch a wrong VALUE. The escalated
+ * `tenant_id` defect was never reachable from here — that one is caught by
+ * init-time validation (REQ-1/REQ-2) and the reachable init status (REQ-3).
+ *
+ * It is *not* true that a Playbook is beyond compile-time reach. An earlier
+ * version of this note claimed a served artifact is `Record<string, unknown>`
+ * “by necessity”; that was wrong. {@link UnvalidatedConfigArtifact} structurally
+ * requires the body arrays, so a truncated Playbook fails to compile at the
+ * `localRuntime` boundary. What genuinely cannot be checked is the artifact's
+ * *contents* — whether a plan handle exists, whether a rule is satisfiable.
+ *
+ * @public
+ */
+type ExactInitOptions<T> = {
+    [K in keyof T]: K extends RevTurbineInitOptionKey ? T[K] : never;
+};
 /**
  * SDK integration mode.
  * - `snippet` — lightweight script tag embed
@@ -18625,7 +19659,14 @@ interface RevTurbineEndpointOverrides {
     /** Keyless anonymous SDK telemetry endpoint (`POST /api/sdk/meta`). */
     ingestSdkMeta: string;
     touchpointTransition: string;
-    legacyInteractions: string;
+    /**
+     * @deprecated Ignored since plan 232. This pointed at a fallback the SDK
+     * retried when the interactions POST failed — against a route the app does
+     * not serve, with the internal queue shape rather than the wire shape, so it
+     * could only ever 404. Setting it has no effect; the key remains so an
+     * existing integration that passes it still compiles.
+     */
+    legacyInteractions?: string;
     placementTypes: string;
     surfaceSlots: string;
 }
@@ -18975,6 +20016,67 @@ declare function createTreatmentInteraction(userId: string, placementId: string,
 interface RevTurbineEventOptions {
     immediate?: boolean;
 }
+/**
+ * One surface slot this app currently has mounted.
+ *
+ * @public
+ */
+interface RevTurbineRegisteredSlot {
+    /**
+     * The author-facing slot id — what a Playbook placement's `trigger.slot_id`
+     * must equal. NOT the internal hashed registry key.
+     */
+    slotId: string;
+    /** Display name supplied at registration. */
+    name: string;
+    /** Normalized route the slot was mounted on. */
+    route: string;
+    /** The SDK's internal registry id (hashed). Useful when correlating logs. */
+    internalId: string;
+    /** Surface template ids the slot declared it can render, if any. */
+    surfaceTemplateIds: string[];
+}
+/**
+ * A Playbook placement that targets a surface slot.
+ *
+ * @public
+ */
+interface RevTurbineAuthoredSlotRef {
+    /** The slot id the placement targets (`trigger.slot_id`). */
+    slotId: string;
+    /** The authored placement's id. */
+    placementId: string;
+    /** The placement's category, when the Playbook declares one. */
+    category?: string;
+}
+/**
+ * Result of {@link RevTurbineCustomerSdk.diagnoseSlotInventory}.
+ *
+ * @public
+ */
+interface RevTurbineSlotInventoryDiagnosis {
+    /** Every slot mounted by this app right now. */
+    mounted: RevTurbineRegisteredSlot[];
+    /** Every slot-targeted placement in the Playbook. */
+    authored: RevTurbineAuthoredSlotRef[];
+    /**
+     * Placements targeting a slot no code renders. **These can never show**, and
+     * nothing else reports them — the decision path is never asked about a slot
+     * that was never mounted, so there is no error and no reason code.
+     */
+    authoredButUnmounted: RevTurbineAuthoredSlotRef[];
+    /**
+     * Slots mounted that no placement targets. They render their fallback
+     * forever; usually a typo in the slot id, or config that was never deployed.
+     */
+    mountedButUnauthored: RevTurbineRegisteredSlot[];
+    /**
+     * Whether a Playbook was available to diff against. When `false`, `authored`
+     * is empty because nothing could be read — which is NOT the same as "nothing
+     * is authored", and a caller must not treat the two alike.
+     */
+    configAvailable: boolean;
+}
 
 /** A named semantic event with structured payload. */
 interface RevTurbineSemanticEvent {
@@ -19027,6 +20129,31 @@ type RevTurbineTriggerPayload = TrialTriggerPayload | UsageTriggerPayload | Feat
  */
 declare function createSemanticEvent(eventType: string, payload: SdkEventProperties, options?: RevTurbineEventOptions): RevTurbineSemanticEvent;
 
+/**
+ * Every event name on the taxonomy's `control_plane` surface — emitted via
+ * {@link RevTurbineCustomerSdk.trackControlPlaneEvent}, never the platform
+ * surface. The TYPE is the CP ingest enum; the runtime set below derives
+ * from the taxonomy's surface field, so a scaffold surface reclassification
+ * (plan 228's dogfood ruling moved `area_viewed`/`feature_gated` OUT of
+ * this surface) flows through on a pin bump with no SDK edit.
+ */
+type ControlPlaneEventName = (typeof CONTROL_PLANE_EVENT_NAMES)[number];
+/**
+ * Every platform event the typed emit surface accepts: the full taxonomy
+ * MINUS the control-plane surface (structural exclusion — the CP has its own
+ * typed path with source classification, and a customer emitting
+ * `playbook_version_deployed` would be forging RevTurbine's own product
+ * telemetry). Includes the R-2 billing vocabulary: billing facts consumed
+ * from Stripe must be equally emittable first-party (plan 228 R-1).
+ */
+type EmittablePlatformEventName = Exclude<PlatformEventName, ControlPlaneEventName>;
+/**
+ * Runtime mirror of {@link EmittablePlatformEventName}, derived from the
+ * payload-contract map so the emit surface and the taxonomy cannot drift —
+ * the parity test asserts this set plus the control-plane surface IS the
+ * taxonomy.
+ */
+declare const EMITTABLE_PLATFORM_EVENT_NAMES: readonly string[];
 /**
  * The core RevTurbine customer-facing SDK.
  *
@@ -19035,7 +20162,9 @@ declare function createSemanticEvent(eventType: string, payload: SdkEventPropert
  * - **Placements** — `registerPlacement()`, `getPlacementDecision()`, `getPlacement()`
  * - **Entitlements** — `checkEntitlement()`, `updateUsage()`
  * - **Trials** — `getTrialStatus()`
- * - **Events** — `capture()`, `trackEvent()`, `emitSemantic()`
+ * - **Events** — `track()` / `capture()` (generic lane; platform-name
+ *   collisions are namespaced), `emitPlatformEvent()` (typed platform lane,
+ *   contract-validated payloads)
  * - **Interactions** — `trackTreatmentInteraction()`, `dismiss()`, `convert()`
  * - **Context** — `setUserContext()`, `setPageContext()`, `refreshPageContext()`
  *
@@ -19091,6 +20220,22 @@ declare class RevTurbineCustomerSdk {
     private readonly anonymousId;
     private readonly sessionId;
     private readonly decisionCache;
+    /**
+     * `output_id` → the placement it was decided for, plus the attribution fields
+     * the interaction path needs.
+     *
+     * The public `dismiss()` / `snooze()` / `convert()` take an **output** id,
+     * while every terminal-state write is keyed by the **placement** id. Without
+     * this index those three methods cannot reach the interaction path at all,
+     * which is why `convert()` only ever emitted an event (plan 233 TASK-14).
+     *
+     * It outlives the decision cache deliberately. A conversion is confirmed after
+     * the user comes back from a checkout redirect, long after a 60-second
+     * decision TTL has expired and often in a fresh page load — so this persists,
+     * and is bounded so a long session cannot grow it without limit.
+     */
+    private readonly outputPlacementIndex;
+    private readonly outputPlacementIndexLimit;
     private readonly interactionState;
     private readonly interactionQueue;
     private readonly defaultDecisionTtlMs;
@@ -19115,6 +20260,14 @@ declare class RevTurbineCustomerSdk {
     private emittedAssignmentFactRevision?;
     private providerResolutionController;
     private lastEffectiveContext?;
+    /**
+     * The effective segment memberships from the most recent provider
+     * resolution — resolved provider segments ∪ locally evaluated segments.
+     * Stamped onto every event envelope as `segment_ids`, exactly as
+     * `experiment_assignments` is stamped (plan 228 TASK-4 / REQ-11a), so
+     * segment cuts read as-of-event truth instead of requiring a config join.
+     */
+    private lastEffectiveSegmentIds;
     private pageContext;
     /**
      * Secure per-user client token (`rt_client_`, plan 157). Minted by the
@@ -19263,6 +20416,16 @@ declare class RevTurbineCustomerSdk {
     private decisionCacheStorageKey;
     private interactionStateStorageKey;
     private presentationCapsStorageKey;
+    private outputPlacementIndexStorageKey;
+    /**
+     * Remember which placement an output belonged to.
+     *
+     * Called from every path that hands a decision to a caller, because any
+     * output a caller can see is an output they can later pass to `convert()`.
+     */
+    private indexDecisionOutput;
+    private hydrateOutputPlacementIndex;
+    private persistOutputPlacementIndex;
     private hydrateDecisionCache;
     private persistDecisionCache;
     private hydrateInteractionState;
@@ -19566,6 +20729,34 @@ declare class RevTurbineCustomerSdk {
      */
     getTelemetryCounters(): TelemetryCounters;
     capture(eventName: string, properties: SdkEventProperties, options?: RevTurbineEventOptions): Promise<void>;
+    /**
+     * Emit a typed platform event (plan 228 TASK-4).
+     *
+     * The sanctioned first-party path for every platform event OUTSIDE the
+     * control plane — SDK lifecycle, gates, placements, milestones, growth
+     * signals, and the R-2 billing vocabulary (a billing fact consumed from
+     * Stripe is equally emittable here; the ingest path dedupes on the
+     * contract's identity keys, e.g. `billing_ref`). The payload parameter type
+     * is inferred from the event's payload contract, so the API cannot drift
+     * from the schema the payload is validated against.
+     *
+     * The name is sent RAW — no `clickstream_*` namespacing — which is exactly
+     * what distinguishes this from {@link track}: the generic lane namespaces
+     * platform collisions, the typed lane IS the platform.
+     *
+     * In development/test builds the payload is validated against its contract
+     * at emit time; a violation emits an `sdk_validation_warning` alongside
+     * (never a throw — telemetry must not break the host app). Production
+     * builds skip validation; the ingest boundary re-validates authoritatively.
+     */
+    emitPlatformEvent<K extends EmittablePlatformEventName>(eventName: K, payload: EventPayloadInput<K>, options?: RevTurbineEventOptions): Promise<void>;
+    /**
+     * Emit an `sdk_validation_warning` conforming to its own payload contract
+     * (`message` is the contract's required field; `reason` rides along for
+     * pre-228 consumers). Fire-and-forget — never throws into the host app.
+     */
+    private emitSdkWarning;
+    private captureRaw;
     /**
      * Emit a typed control-plane semantic event (plan 112).
      *
@@ -19589,7 +20780,7 @@ declare class RevTurbineCustomerSdk {
      * @example
      * ```ts
      * sdk.identify('operator_42', { account_id: 'tn_acme' });
-     * await sdk.trackControlPlaneEvent('changeset_deployed', { change_set_id: 'cs_9' });
+     * await sdk.trackControlPlaneEvent('playbook_version_deployed', { change_set_id: 'cs_9' });
      * ```
      */
     trackControlPlaneEvent(eventType: ControlPlaneEventType, payload?: SdkEventProperties, options?: RevTurbineEventOptions): Promise<void>;
@@ -19615,6 +20806,36 @@ declare class RevTurbineCustomerSdk {
      * instance (e.g. SPA unmount) to avoid a dangling interval/listeners.
      */
     dispose(): void;
+    /**
+     * Emit a semantic event through the GENERIC string lane.
+     *
+     * Since plan 228 TASK-4 this is a customer-lane API, not a platform one: it
+     * rides {@link capture}, so a name colliding with platform vocabulary is
+     * namespaced `clickstream_*` — platform events cannot be forged from here.
+     * The SDK's own platform emissions use {@link emitPlatformEvent}, whose
+     * payloads are typed and contract-validated.
+     *
+     * The fields are passed to {@link capture} DIRECTLY, exactly as a customer's
+     * own `capture(name, {...})` call would. Anything else double-wraps them.
+     *
+     * This used to send `{semantic: true, payload: fields}`. The wire mapping
+     * already stores an envelope's properties under the key `payload`, so that
+     * inner wrapper landed the fields at `properties.payload.payload.<field>` in
+     * `events_clickstream` — one level deeper than every `capture()` event and
+     * than the canonical carrier this SDK documents. Readers that followed the
+     * documented shape (`user_context_fields`, any analytics pipe) found nothing
+     * on a semantic event, which is why gate telemetry was invisible to the
+     * entitlement metrics despite being emitted correctly.
+     *
+     * The `semantic: true` marker went with it: it was written here and read
+     * nowhere in the SDK, the web app, or any pipe. It marked nothing and cost a
+     * whole nesting level.
+     *
+     * `liftClickstreamFields` / `pickClickstreamField` are unaffected — they
+     * resolve top-level first and fall back to the nested bag, so they read the
+     * fields either way. Only the STORED JSON changes shape, and it changes to
+     * the shape everything else already expects.
+     */
     emitSemantic(eventType: string, payload: SdkEventProperties, options?: RevTurbineEventOptions): Promise<void>;
     /**
      * Optimized routine to evaluate segment membership and usage thresholds.
@@ -19678,6 +20899,50 @@ declare class RevTurbineCustomerSdk {
         placementScopeKey?: string;
         normalizedPageRoute?: string;
     }): Promise<string>;
+    /**
+     * Every surface slot this SDK instance currently has mounted.
+     *
+     * Plan 233 TASK-10. `verify-integration` names the gap this closes in its own
+     * text: *"A placement targeting a slot no code renders can never show, and
+     * nothing reports this; there is no probe, so walk the Playbook's placement
+     * triggers against your inventory of rendered slots."* There was no way to
+     * obtain that inventory at runtime — the registry is private and keyed by a
+     * hashed id, not by the slot id the author wrote.
+     *
+     * `slotId` is the author-facing identity (what a Playbook's
+     * `trigger.slot_id` must match), not the internal hash. That distinction is
+     * the whole point: a diff against authored config is meaningless in hash
+     * space.
+     *
+     * @public
+     */
+    getRegisteredSlots(): RevTurbineRegisteredSlot[];
+    /**
+     * Diff the authored Playbook against what this app actually mounted, in both
+     * directions.
+     *
+     * Plan 233 TASK-10 / AC-12. Both directions matter and they fail differently:
+     *
+     * - **authoredButUnmounted** — a placement targets a slot no code renders. It
+     *   can never show. Nothing reports this today; the decision path is never
+     *   even asked about a slot that was never mounted, so there is no error, no
+     *   warning, and no reason code. This is the silent one.
+     * - **mountedButUnauthored** — a slot is mounted that no placement targets. It
+     *   renders its fallback forever, which usually means a typo in the slot id
+     *   or config that was never deployed.
+     *
+     * This is a diagnostic and deliberately reports rather than throws: it is run
+     * against a live app, and an integration with a stale slot should keep
+     * working while someone reads the output.
+     *
+     * A config-side audit **cannot** produce this. That is the lesson from the
+     * August diagnosis of the escalated integration, which concluded the fixed
+     * slots were unmounted: they were mounted, and the call sites passed slot ids
+     * that no placement targeted. Only the running app knows what it mounted.
+     *
+     * @public
+     */
+    diagnoseSlotInventory(): RevTurbineSlotInventoryDiagnosis;
     /**
      * @deprecated Use `registerSurfaceSlot`.
      */
@@ -19725,8 +20990,37 @@ declare class RevTurbineCustomerSdk {
     getPlacementDecision(input: RevTurbinePlacementDecisionInput): Promise<RevTurbinePlacementDecision>;
     preloadPlacementDecisions(inputs: RevTurbinePlacementDecisionInput[]): Promise<void>;
     bootstrapPlacementDecisions(inputs: RevTurbinePlacementDecisionInput[]): Promise<void>;
+    /**
+     * The authored suppression windows for a payload, in milliseconds.
+     *
+     * Plan 233 TASK-8b/8c. `caps.cooldown_days` and `remind_later_minutes` are
+     * authored per payload and round-trip through export/import (plan 167 AC-8,
+     * AC-11), but nothing ever read them back: the only consumer was the
+     * `hasAuthoredCaps` feature-flag derivation, which uses their PRESENCE to
+     * switch caps enforcement on and discards their values. So a Playbook saying
+     * `cooldown_days: 7` flipped a boolean and otherwise did nothing.
+     *
+     * The decision's `output_id` is the payload id (the resolver sets
+     * `output_id: payload.id`), so the authored values are recoverable from the
+     * loaded config at interaction time.
+     */
+    private authoredSuppressionWindows;
     private updateInteractionState;
     private flushInteractionQueue;
+    /**
+     * Re-queue a failed interaction flush and make the failure VISIBLE.
+     *
+     * This used to retry against a legacy path that does not exist in the app,
+     * with the internal queue shape rather than the wire shape — so a failure
+     * produced a silent 404, the batch went back on the queue, and it was
+     * discarded at page unload with nothing recorded anywhere. That is how a
+     * whole class of dropped presentations stayed invisible (plan 232).
+     *
+     * Re-queuing is still right — a transient failure should retry on the next
+     * flush — but it is now paired with a counter and a diagnostic, so a
+     * persistent failure is observable instead of merely quiet.
+     */
+    private failInteractionFlush;
     trackTreatmentInteraction(input: RevTurbineTreatmentInteractionInput): Promise<void>;
     getPlacementContent(placementId: string, request?: JsonObject): Promise<RevTurbinePlacementContent>;
     /**
@@ -20008,6 +21302,23 @@ declare class RevTurbineCustomerSdk {
      * throwOnMissing: true })` remains the strict opt-in.
      */
     private warnOnUiPathResolverCoverageGaps;
+    /**
+     * Route an output-addressed interaction through the one interaction path.
+     *
+     * Plan 233 TASK-14. These three methods each emitted a `placement_interaction`
+     * event and stopped, so none of them wrote any terminal state:
+     * `sdk.dismiss()` did not suppress, and `sdk.convert()` did not retire. Only
+     * the controller path (`trackTreatmentInteraction`) ever did, which is why the
+     * defect was invisible to every React integration test.
+     *
+     * The public API takes an **output** id while every terminal-state write is
+     * keyed by the **placement** id, so the output is resolved through
+     * `outputPlacementIndex`. When it cannot be resolved — an output this SDK
+     * instance never decided, or one evicted from a very long session — we emit
+     * the bare event as before and say so. Silently doing nothing is what shipped;
+     * being loud about the one case we cannot serve is the point.
+     */
+    private trackOutputInteraction;
     dismiss(outputId: string): Promise<void>;
     snooze(outputId: string, seconds?: number): Promise<void>;
     convert(outputId: string): Promise<void>;
@@ -20018,10 +21329,22 @@ declare class RevTurbineCustomerSdk {
      * name to {@link RevTurbineTriggerEvent} and attaches standard context
      * (user_id, plan, timestamp) automatically.
      *
+     * **Three trigger names land namespaced on the wire.** This rides the
+     * generic emit lane, which prefixes `clickstream_` to any name the platform
+     * taxonomy already declares — the rule that stops a client forging a
+     * first-party fact by naming an event after one. `trial_expired`,
+     * `payment_failed` and `feature_gated` collide, so they are stored as
+     * `clickstream_trial_expired`, `clickstream_payment_failed` and
+     * `clickstream_feature_gated`. Query those names, not the raw ones. The
+     * remaining triggers are unaffected, and the platform's own versions of the
+     * three are emitted first-party through the typed surface. Pinned by
+     * `trigger-namespacing-parity.test.ts` (plan 231 REQ-4).
+     *
      * @example
      * ```ts
      * await sdk.emitTrigger('usage_limit_approaching', { usage_percent: 85, threshold: 80 });
      * await sdk.emitTrigger('trial_expiring', { days_remaining: 2 });
+     * // stored as `clickstream_feature_gated` — see the collision note above
      * await sdk.emitTrigger('feature_gated', { feature: 'advanced_automation' });
      * ```
      */
@@ -20163,7 +21486,7 @@ declare class RevTurbineCustomerSdk {
  * });
  * ```
  */
-declare function initRevTurbine$1(options: RevTurbineInitInputOptions): RevTurbineCustomerSdk;
+declare function initRevTurbine$1<T extends RevTurbineInitInputOptions>(options: T & ExactInitOptions<T>): RevTurbineCustomerSdk;
 declare global {
     interface Window {
         RevTurbine?: {
@@ -20493,8 +21816,25 @@ declare class PlacementController {
     /** Re-fetch the placement decision (clears impression + render + exposure tracking). */
     refresh(): Promise<RevTurbinePlacementDecision | null>;
     /** Record a dismiss interaction and hide the placement. */
+    /**
+     * Record a dismissal.
+     *
+     * @param cooldownMs - Optional explicit window. Omit it — which is the normal
+     *   case — and the SDK resolves the payload's authored `caps.cooldown_days`,
+     *   falling back to the 7-day default. This used to default to 24h here and
+     *   pass it ALWAYS, so the authored value and the 7-day default were both
+     *   unreachable from React (plan 233 TASK-8b).
+     */
     dismiss(cooldownMs?: number): Promise<void>;
     /** Record a snooze/remind-me-later interaction and hide the placement. */
+    /**
+     * Record a snooze / remind-me-later.
+     *
+     * @param seconds - Optional explicit window. Omit it and the SDK resolves the
+     *   payload's authored `remind_later_minutes`, falling back to the tenant
+     *   default (plan 233 TASK-8c). Remind-later is a DIFFERENT window from
+     *   dismiss and resolves independently.
+     */
     snooze(seconds?: number): Promise<void>;
     /** Alias for {@link snooze}. */
     remindMeLater(seconds?: number): Promise<void>;
@@ -21636,7 +22976,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Record a placement treatment interaction */
+        /** Record one placement treatment interaction, or a batch of them */
         post: operations["recordTreatmentInteraction"];
         delete?: never;
         options?: never;
@@ -22143,8 +23483,10 @@ interface components {
             content_ui_paths: components["schemas"]["Anon_274ba4ca49d5_6"];
             surface_templates: components["schemas"]["Anon_274ba4ca49d5_7"];
         };
+        TreatmentInteractionRequest: components["schemas"]["TreatmentInteractionInput"] | components["schemas"]["TreatmentInteractionBatch"];
         TreatmentInteractionInput: {
             user_id: components["schemas"]["Anon_761f976a1da1_2"];
+            account_id?: components["schemas"]["Anon_0a729b73253d"];
             placement_id: components["schemas"]["Anon_57796118d046_18"];
             treatment_id?: components["schemas"]["Anon_4e04ec5cc4e6_4"];
             surface_slot_id?: components["schemas"]["Anon_4e04ec5cc4e6_5"];
@@ -22161,6 +23503,7 @@ interface components {
         };
         /** @enum {string} */
         TreatmentInteractionType: "impression" | "dismiss" | "remind_me_later" | "cta_clicked" | "cta_completed" | "suppress";
+        TreatmentInteractionBatch: components["schemas"]["TreatmentInteractionInput"][];
         WebhookEventLog: {
             id: components["schemas"]["Anon_fb248bf5a9f7"];
             created_at: components["schemas"]["Anon_be3e2585472d"];
@@ -23223,27 +24566,29 @@ interface components {
         Anon_e17de468dbc9_10: components["schemas"]["Anon_520c691f88f7_10"];
         Anon_520c691f88f7_10: string;
         Anon_761f976a1da1_2: string;
-        Anon_57796118d046_18: string;
-        Anon_4e04ec5cc4e6_4: components["schemas"]["Anon_9ac136edb99a_9"];
+        Anon_0a729b73253d: components["schemas"]["Anon_9ac136edb99a_9"];
         Anon_9ac136edb99a_9: string;
-        Anon_4e04ec5cc4e6_5: components["schemas"]["Anon_9ac136edb99a_10"];
+        Anon_57796118d046_18: string;
+        Anon_4e04ec5cc4e6_4: components["schemas"]["Anon_9ac136edb99a_10"];
         Anon_9ac136edb99a_10: string;
-        Anon_4e04ec5cc4e6_6: components["schemas"]["Anon_9ac136edb99a_11"];
+        Anon_4e04ec5cc4e6_5: components["schemas"]["Anon_9ac136edb99a_11"];
         Anon_9ac136edb99a_11: string;
-        Anon_4e04ec5cc4e6_7: components["schemas"]["Anon_9ac136edb99a_12"];
+        Anon_4e04ec5cc4e6_6: components["schemas"]["Anon_9ac136edb99a_12"];
         Anon_9ac136edb99a_12: string;
+        Anon_4e04ec5cc4e6_7: components["schemas"]["Anon_9ac136edb99a_13"];
+        Anon_9ac136edb99a_13: string;
         Anon_b540c131c269: components["schemas"]["TreatmentInteractionType"];
         Anon_e077e17ea982_3: components["schemas"]["Anon_02ecf48bed22_3"];
         /** Format: date-time */
         Anon_02ecf48bed22_3: string;
-        Anon_4e04ec5cc4e6_8: components["schemas"]["Anon_9ac136edb99a_13"];
-        Anon_9ac136edb99a_13: string;
-        Anon_4e04ec5cc4e6_9: components["schemas"]["Anon_9ac136edb99a_14"];
+        Anon_4e04ec5cc4e6_8: components["schemas"]["Anon_9ac136edb99a_14"];
         Anon_9ac136edb99a_14: string;
-        Anon_4e04ec5cc4e6_10: components["schemas"]["Anon_9ac136edb99a_15"];
+        Anon_4e04ec5cc4e6_9: components["schemas"]["Anon_9ac136edb99a_15"];
         Anon_9ac136edb99a_15: string;
-        Anon_4e04ec5cc4e6_11: components["schemas"]["Anon_9ac136edb99a_16"];
+        Anon_4e04ec5cc4e6_10: components["schemas"]["Anon_9ac136edb99a_16"];
         Anon_9ac136edb99a_16: string;
+        Anon_4e04ec5cc4e6_11: components["schemas"]["Anon_9ac136edb99a_17"];
+        Anon_9ac136edb99a_17: string;
         Anon_fb9ddeea992e_3: components["schemas"]["Anon_7cb541e84f22_31"];
         Anon_7cb541e84f22_31: boolean;
         Anon_a249e58b3222: components["schemas"]["Anon_c65c1fbd5acf_8"];
@@ -23272,8 +24617,8 @@ interface components {
         Anon_39a43881005e_1: string | null;
         Anon_96f9066c2fdc_24: components["schemas"]["Anon_00404e686415_27"];
         Anon_00404e686415_27: string;
-        Anon_4e04ec5cc4e6_12: components["schemas"]["Anon_9ac136edb99a_17"];
-        Anon_9ac136edb99a_17: string;
+        Anon_4e04ec5cc4e6_12: components["schemas"]["Anon_9ac136edb99a_18"];
+        Anon_9ac136edb99a_18: string;
         Anon_2fef49d17888: components["schemas"]["UserPlanContext"];
         Anon_57796118d046_21: string;
         Anon_57796118d046_22: string;
@@ -24603,8 +25948,16 @@ interface components {
             query_families: components["schemas"]["Anon_54e2154d1e2d"];
             source_scope: components["schemas"]["Anon_a3ffad10d15c_5"];
             coverage_metric?: components["schemas"]["Anon_473e554f0735_16"];
+            dimension_groundings?: components["schemas"]["Anon_7cdcf9f62dcd"];
             deprecation?: components["schemas"]["Anon_8f09b448c37f"];
         };
+        AnalyticsDimensionGrounding: {
+            kind: components["schemas"]["Anon_02276af6fec4"];
+            source: components["schemas"]["Anon_872e58432369_4"];
+            note?: components["schemas"]["Anon_ac655a3e6b9f"];
+        };
+        /** @enum {string} */
+        AnalyticsDimensionGroundingKind: "stamped" | "membership_join" | "config_join" | "derived";
         AnalyticsCatalogDeprecation: {
             deprecated: components["schemas"]["Anon_a2b04841bdf1_1"];
             replaced_by?: components["schemas"]["Anon_473e554f0735_17"];
@@ -24649,6 +26002,7 @@ interface components {
             preferred_analysis_unit?: components["schemas"]["Anon_612059bf001c_6"];
             numerator_metric?: components["schemas"]["Anon_473e554f0735_20"];
             denominator_metric?: components["schemas"]["Anon_473e554f0735_21"];
+            derivation?: components["schemas"]["Anon_22c006ff8d66"];
             deprecation?: components["schemas"]["Anon_8f09b448c37f_2"];
         };
         /** @enum {string} */
@@ -24659,6 +26013,18 @@ interface components {
         AnalyticsMetricStatisticalType: "binary" | "count" | "continuous" | "ratio" | "revenue";
         /** @enum {string} */
         AnalyticsMetricAggregationSemantics: "additive" | "semi_additive" | "non_additive";
+        AnalyticsMetricDerivation: {
+            kind: components["schemas"]["Anon_a1d7a3ac66b8"];
+            input_origin: components["schemas"]["Anon_8a96081932e9"];
+            ingested_events: components["schemas"]["Anon_304a69e72d83"];
+            ingested_datasources?: components["schemas"]["Anon_6411eaf2b1b5"];
+            carried_by?: components["schemas"]["Anon_04b033dd40a9"];
+            note?: components["schemas"]["Anon_1e68bee50f0f"];
+        };
+        /** @enum {string} */
+        AnalyticsMetricDerivationKind: "derived" | "observed" | "unavailable";
+        /** @enum {string} */
+        AnalyticsIngestedInputOrigin: "platform" | "customer_authored" | "mixed" | "none";
         AnalyticsCatalogAnnotationKind: {
             kind: components["schemas"]["Anon_7ed6fcd5ece3"];
             label: components["schemas"]["Anon_cd76cef95ac8_4"];
@@ -24672,7 +26038,7 @@ interface components {
         AnalyticsAnnotationMarker: "point" | "region";
         AnalyticsCatalogSearchResult: {
             catalog_version: components["schemas"]["Anon_0c649f0987df_4"];
-            query: components["schemas"]["Anon_872e58432369_4"];
+            query: components["schemas"]["Anon_872e58432369_5"];
             entries: components["schemas"]["Anon_57df4039d087"];
         };
         AnalyticsAgentCatalogEntry: {
@@ -24847,7 +26213,7 @@ interface components {
             created_at: components["schemas"]["Anon_be3e2585472d_2"];
             updated_at: components["schemas"]["Anon_be3e2585472d_3"];
             tenant_id: components["schemas"]["Anon_fb248bf5a9f7_10"];
-            workspace_name: components["schemas"]["Anon_872e58432369_5"];
+            workspace_name: components["schemas"]["Anon_872e58432369_6"];
             support_email: components["schemas"]["Anon_7dbd1de5e9ee"];
             timezone: components["schemas"]["Anon_c44ee03a9c5e"];
             default_currency: components["schemas"]["Anon_64586219ef83_1"];
@@ -24875,7 +26241,7 @@ interface components {
             updated_at: components["schemas"]["Anon_be3e2585472d_3"];
             tenant_id: components["schemas"]["Anon_fb248bf5a9f7_10"];
             step_key: components["schemas"]["Anon_3b8fc1cd9e8b_26"];
-            label: components["schemas"]["Anon_872e58432369_6"];
+            label: components["schemas"]["Anon_872e58432369_7"];
             done: components["schemas"]["Anon_062d958a93c4_25"];
             completed_at: components["schemas"]["Anon_24a0ac3f017b_4"];
         };
@@ -24906,7 +26272,7 @@ interface components {
             sequence: components["schemas"]["Anon_ffffc3c874cb_1"];
             base_sequence: components["schemas"]["Anon_71a2fb329804_1"];
             handle: components["schemas"]["Anon_2457cccd64aa_12"];
-            identifier: components["schemas"]["Anon_872e58432369_7"];
+            identifier: components["schemas"]["Anon_872e58432369_8"];
             identifier_type: components["schemas"]["Anon_b07a1e0dbc7b"];
             note: components["schemas"]["Anon_519dcb817ac7"];
             added_by: components["schemas"]["Anon_127eb78cd9c0_12"];
@@ -24947,8 +26313,8 @@ interface components {
             event_type: components["schemas"]["Anon_57796118d046_72"];
             source: components["schemas"]["Anon_eabbbb727ad3"];
             tenant_id?: components["schemas"]["Anon_4e04ec5cc4e6_17"];
-            user_id?: components["schemas"]["Anon_0a729b73253d"];
-            session_id?: components["schemas"]["Anon_0a729b73253d_1"];
+            user_id?: components["schemas"]["Anon_0a729b73253d_1"];
+            session_id?: components["schemas"]["Anon_0a729b73253d_2"];
             occurred_at: components["schemas"]["Anon_3c179513a5d9_19"];
             request_id: components["schemas"]["Anon_57796118d046_73"];
             attributes: components["schemas"]["Anon_5142f8473790_13"];
@@ -24964,8 +26330,8 @@ interface components {
         Anon_be3e2585472d_3: string;
         Anon_fb248bf5a9f7_10: string;
         /** @default production */
-        Anon_51cbbf69cb41_1: components["schemas"]["Anon_9ac136edb99a_18"];
-        Anon_9ac136edb99a_18: string;
+        Anon_51cbbf69cb41_1: components["schemas"]["Anon_9ac136edb99a_19"];
+        Anon_9ac136edb99a_19: string;
         Anon_2457cccd64aa_1: components["schemas"]["Anon_0eb2e3b6e08c_3"];
         Anon_0eb2e3b6e08c_3: string;
         /** @default true */
@@ -25375,7 +26741,7 @@ interface components {
         /** @default [] */
         Anon_3b6346b139c2: components["schemas"]["Anon_f836473839d1"];
         Anon_f836473839d1: components["schemas"]["FieldDefinitionOutput"][];
-        Anon_9ac136edb99a_19: string;
+        Anon_9ac136edb99a_20: string;
         /** @default false */
         Anon_f56777819c8b_3: boolean;
         Anon_44136fa355b3_1: unknown;
@@ -25432,8 +26798,8 @@ interface components {
         /** @default 0 */
         Anon_2aa59aec1f23_4: components["schemas"]["Anon_97cc9ecfdea9_26"];
         Anon_97cc9ecfdea9_26: number;
-        Anon_4e04ec5cc4e6_13: components["schemas"]["Anon_9ac136edb99a_20"];
-        Anon_9ac136edb99a_20: string;
+        Anon_4e04ec5cc4e6_13: components["schemas"]["Anon_9ac136edb99a_21"];
+        Anon_9ac136edb99a_21: string;
         Anon_9717c0445e52_3: components["schemas"]["Anon_ea288f4ef558_13"];
         Anon_ea288f4ef558_13: number;
         /** @default false */
@@ -25464,8 +26830,8 @@ interface components {
         Anon_e7cb93d064a8_3: components["schemas"]["TrialLimitType"];
         Anon_62c32913f8d0_3: components["schemas"]["Anon_3b260614cba4_3"];
         Anon_3b260614cba4_3: number | null;
-        Anon_4e04ec5cc4e6_14: components["schemas"]["Anon_9ac136edb99a_21"];
-        Anon_9ac136edb99a_21: string;
+        Anon_4e04ec5cc4e6_14: components["schemas"]["Anon_9ac136edb99a_22"];
+        Anon_9ac136edb99a_22: string;
         Anon_9717c0445e52_4: components["schemas"]["Anon_ea288f4ef558_15"];
         Anon_ea288f4ef558_15: number;
         /** @default signup */
@@ -25500,8 +26866,8 @@ interface components {
         Anon_b0c21ae8f968_5: string | null;
         /** @default time */
         Anon_e7cb93d064a8_4: components["schemas"]["TrialLimitType"];
-        Anon_4e04ec5cc4e6_15: components["schemas"]["Anon_9ac136edb99a_22"];
-        Anon_9ac136edb99a_22: string;
+        Anon_4e04ec5cc4e6_15: components["schemas"]["Anon_9ac136edb99a_23"];
+        Anon_9ac136edb99a_23: string;
         Anon_9717c0445e52_5: components["schemas"]["Anon_ea288f4ef558_16"];
         Anon_ea288f4ef558_16: number;
         Anon_711dc9708535_9: components["schemas"]["Anon_11c9ad639448_1"];
@@ -25734,8 +27100,8 @@ interface components {
         Anon_c72f37d06352: string[];
         Anon_7734a34f21b6: components["schemas"]["Anon_d573fc9779f1"];
         Anon_d573fc9779f1: components["schemas"]["Anon_0eb2e3b6e08c_3"][];
-        Anon_60e62c272481: components["schemas"]["Anon_9ac136edb99a_23"][];
-        Anon_9ac136edb99a_23: string;
+        Anon_60e62c272481: components["schemas"]["Anon_9ac136edb99a_24"][];
+        Anon_9ac136edb99a_24: string;
         Anon_492895348dbd_12: number;
         Anon_3b8fc1cd9e8b_19: string;
         Anon_829616683b56: components["schemas"]["ExperimentDecisionFinding"][];
@@ -25765,7 +27131,7 @@ interface components {
         Anon_052253c90fb3_1: components["schemas"]["Anon_681004346c78_21"];
         Anon_681004346c78_21: string[];
         Anon_544a3bc583b1: components["schemas"]["ExperimentVariantOutput"][];
-        Anon_9ac136edb99a_24: string;
+        Anon_9ac136edb99a_25: string;
         /** @default 0.5 */
         Anon_7e4345d1e208_1: number;
         /** @default false */
@@ -26130,8 +27496,8 @@ interface components {
         /** @enum {string} */
         Anon_fc6def941f46_1: "template" | "slot";
         Anon_57796118d046_59: string;
-        Anon_4e04ec5cc4e6_16: components["schemas"]["Anon_9ac136edb99a_25"];
-        Anon_9ac136edb99a_25: string;
+        Anon_4e04ec5cc4e6_16: components["schemas"]["Anon_9ac136edb99a_26"];
+        Anon_9ac136edb99a_26: string;
         Anon_c65e883b4e4a: {
             count: components["schemas"]["Anon_492895348dbd_13"];
             period: components["schemas"]["Anon_e78ca35ebc33_1"];
@@ -26521,6 +27887,14 @@ interface components {
         Anon_54e2154d1e2d: components["schemas"]["AnalyticsQueryFamily"][];
         Anon_a3ffad10d15c_5: components["schemas"]["AnalyticsSourceScope"];
         Anon_473e554f0735_16: components["schemas"]["Anon_c8d24748191b_1"];
+        Anon_7cdcf9f62dcd: components["schemas"]["Anon_ebc742463bcd"];
+        Anon_ebc742463bcd: {
+            [key: string]: components["schemas"]["AnalyticsDimensionGrounding"];
+        };
+        Anon_02276af6fec4: components["schemas"]["AnalyticsDimensionGroundingKind"];
+        Anon_872e58432369_4: string;
+        Anon_ac655a3e6b9f: components["schemas"]["Anon_800d95542a20"];
+        Anon_800d95542a20: string;
         Anon_8f09b448c37f: components["schemas"]["AnalyticsCatalogDeprecation"];
         Anon_a2b04841bdf1_1: boolean;
         Anon_473e554f0735_17: components["schemas"]["Anon_c8d24748191b_1"];
@@ -26565,6 +27939,19 @@ interface components {
         Anon_612059bf001c_6: components["schemas"]["AnalyticsAnalyticalUnit"];
         Anon_473e554f0735_20: components["schemas"]["Anon_c8d24748191b_1"];
         Anon_473e554f0735_21: components["schemas"]["Anon_c8d24748191b_1"];
+        Anon_22c006ff8d66: components["schemas"]["AnalyticsMetricDerivation"];
+        Anon_a1d7a3ac66b8: components["schemas"]["AnalyticsMetricDerivationKind"];
+        Anon_8a96081932e9: components["schemas"]["AnalyticsIngestedInputOrigin"];
+        Anon_304a69e72d83: components["schemas"]["Anon_64fcdc575ad5"][];
+        Anon_64fcdc575ad5: string;
+        Anon_6411eaf2b1b5: components["schemas"]["Anon_d36735de5e00"];
+        Anon_d36735de5e00: components["schemas"]["Anon_64fcdc575ad5_1"][];
+        Anon_64fcdc575ad5_1: string;
+        Anon_04b033dd40a9: components["schemas"]["Anon_c6d8e2b09e6d"];
+        Anon_c6d8e2b09e6d: components["schemas"]["Anon_64fcdc575ad5_2"][];
+        Anon_64fcdc575ad5_2: string;
+        Anon_1e68bee50f0f: components["schemas"]["Anon_45ca91dbcd70"];
+        Anon_45ca91dbcd70: string;
         Anon_8f09b448c37f_2: components["schemas"]["AnalyticsCatalogDeprecation"];
         Anon_203017ce4604: components["schemas"]["Anon_d9dbfa5954cd"];
         Anon_d9dbfa5954cd: components["schemas"]["AnalyticsCatalogAnnotationKind"][];
@@ -26574,7 +27961,7 @@ interface components {
         Anon_8783ccc02cda: components["schemas"]["AnalyticsAnnotationSource"];
         Anon_85e861e36da5: components["schemas"]["AnalyticsAnnotationMarker"];
         Anon_0c649f0987df_4: string;
-        Anon_872e58432369_4: string;
+        Anon_872e58432369_5: string;
         Anon_57df4039d087: components["schemas"]["AnalyticsAgentCatalogEntry"][];
         Anon_53c09eaf03ab_7: components["schemas"]["AnalyticsSemanticIdOutput"];
         Anon_33085dabcc5b: components["schemas"]["AnalyticsAgentCatalogEntryKind"];
@@ -26771,7 +28158,7 @@ interface components {
         /** @default true */
         Anon_493deecc809a_15: components["schemas"]["Anon_7cb541e84f22_77"];
         Anon_7cb541e84f22_77: boolean;
-        Anon_872e58432369_5: string;
+        Anon_872e58432369_6: string;
         /** @default null */
         Anon_7dbd1de5e9ee: components["schemas"]["Anon_39a43881005e_2"];
         Anon_39a43881005e_2: string | null;
@@ -26814,14 +28201,14 @@ interface components {
         Anon_062d958a93c4_24: components["schemas"]["Anon_7cb541e84f22_79"];
         Anon_7cb541e84f22_79: boolean;
         Anon_3b8fc1cd9e8b_26: string;
-        Anon_872e58432369_6: string;
+        Anon_872e58432369_7: string;
         /** @default false */
         Anon_062d958a93c4_25: components["schemas"]["Anon_7cb541e84f22_80"];
         Anon_7cb541e84f22_80: boolean;
         Anon_24a0ac3f017b_4: components["schemas"]["Anon_11c9ad639448_1"];
         /** @default production */
-        Anon_a2f8ac1ffbf6: components["schemas"]["Anon_9ac136edb99a_26"];
-        Anon_9ac136edb99a_26: string;
+        Anon_a2f8ac1ffbf6: components["schemas"]["Anon_9ac136edb99a_27"];
+        Anon_9ac136edb99a_27: string;
         Anon_a607427cce0b: components["schemas"]["AuditActorType"];
         /** @default null */
         Anon_f7fb9744a6e4_25: components["schemas"]["Anon_f090cb615c84_47"];
@@ -26841,7 +28228,7 @@ interface components {
         /** Format: date-time */
         Anon_be3e2585472d_10: string;
         Anon_2457cccd64aa_12: components["schemas"]["Anon_0eb2e3b6e08c_3"];
-        Anon_872e58432369_7: string;
+        Anon_872e58432369_8: string;
         /** @default user_id */
         Anon_b07a1e0dbc7b: components["schemas"]["PlacementTestUserIdentifierType"];
         /** @default null */
@@ -26888,12 +28275,12 @@ interface components {
         Anon_57796118d046_72: string;
         /** @default sdk */
         Anon_eabbbb727ad3: components["schemas"]["EventSource"];
-        Anon_4e04ec5cc4e6_17: components["schemas"]["Anon_9ac136edb99a_27"];
-        Anon_9ac136edb99a_27: string;
-        Anon_0a729b73253d: components["schemas"]["Anon_9ac136edb99a_28"];
+        Anon_4e04ec5cc4e6_17: components["schemas"]["Anon_9ac136edb99a_28"];
         Anon_9ac136edb99a_28: string;
         Anon_0a729b73253d_1: components["schemas"]["Anon_9ac136edb99a_29"];
         Anon_9ac136edb99a_29: string;
+        Anon_0a729b73253d_2: components["schemas"]["Anon_9ac136edb99a_30"];
+        Anon_9ac136edb99a_30: string;
         /** Format: date-time */
         Anon_3c179513a5d9_19: string;
         Anon_57796118d046_73: string;
@@ -26935,8 +28322,8 @@ interface components {
         Anon_39a43881005e_3: string | null;
         Anon_96f9066c2fdc_63: components["schemas"]["Anon_00404e686415_67"];
         Anon_00404e686415_67: string;
-        Anon_4e04ec5cc4e6_18: components["schemas"]["Anon_9ac136edb99a_30"];
-        Anon_9ac136edb99a_30: string;
+        Anon_4e04ec5cc4e6_18: components["schemas"]["Anon_9ac136edb99a_31"];
+        Anon_9ac136edb99a_31: string;
         Anon_f104771c9d3e: components["schemas"]["UserPlanContextOutput"];
         Anon_57796118d046_76: string;
         Anon_57796118d046_77: string;
@@ -27109,7 +28496,7 @@ interface components {
             description?: components["schemas"]["Anon_ee9224780226_6"];
         };
         FieldDefinitionOutput: {
-            name: components["schemas"]["Anon_9ac136edb99a_19"];
+            name: components["schemas"]["Anon_9ac136edb99a_20"];
             field_type: components["schemas"]["TemplateFieldType"];
             required: components["schemas"]["Anon_f56777819c8b_3"];
             default_value?: components["schemas"]["Anon_44136fa355b3_1"];
@@ -27282,7 +28669,7 @@ interface components {
             metadata: components["schemas"]["Anon_f27cb44c32f6_22"];
         };
         ExperimentVariantOutput: {
-            variant_id: components["schemas"]["Anon_9ac136edb99a_24"];
+            variant_id: components["schemas"]["Anon_9ac136edb99a_25"];
             name: components["schemas"]["Anon_52ba84a4bbf3_2"];
             weight: components["schemas"]["Anon_7e4345d1e208_1"];
             is_control: components["schemas"]["Anon_f56777819c8b_4"];
@@ -29254,7 +30641,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["TreatmentInteractionInput"];
+                "application/json": components["schemas"]["TreatmentInteractionRequest"];
             };
         };
         responses: {
@@ -29836,10 +31223,51 @@ declare const MESSAGE_SURFACE_TEMPLATE_IDS: readonly string[];
  */
 declare const DEFAULT_THEME: Readonly<RevTurbineTheme>;
 /**
- * Deep-merge a partial theme input with the default theme, producing a
- * complete {@link RevTurbineTheme}.
+ * Dark counterpart to {@link DEFAULT_THEME}.
+ *
+ * Plan 233 TASK-6. The SDK had no sanctioned dark story at all, so a customer
+ * running a dark app either lived with white modals or — as the escalated one
+ * did — injected a palette into the Playbook object and re-initialized the SDK
+ * on every toggle. Shipping the palette is what makes `colorScheme` a swap
+ * rather than a rebuild.
+ *
+ * Only the colors differ. Typography, shape and shadows are scheme-independent,
+ * so they are inherited from {@link DEFAULT_THEME} rather than duplicated —
+ * a second copy would drift the moment either is edited.
+ *
+ * Contrast: every text-on-surface pair here clears WCAG AA at body size against
+ * its intended background.
+ *
+ * @public
+ */
+declare const DARK_THEME: Readonly<RevTurbineTheme>;
+/**
+ * The colour scheme a theme resolves against.
+ *
+ * `'system'` follows the OS/browser `prefers-color-scheme` and keeps following
+ * it as the user changes it.
+ *
+ * @public
+ */
+type RevTurbineColorScheme = 'light' | 'dark' | 'system';
+/**
+ * The base palette for a resolved scheme.
+ *
+ * @param scheme - `'light'` or `'dark'`. Resolve `'system'` before calling.
+ * @returns The matching base theme.
+ * @public
+ */
+declare function baseThemeForScheme(scheme: 'light' | 'dark'): Readonly<RevTurbineTheme>;
+/**
+ * Deep-merge a partial theme input with a base theme, producing a complete
+ * {@link RevTurbineTheme}.
+ *
+ * @param input - Partial tokens. Every omitted token falls back to `base`.
+ * @param base - The palette to merge over. Defaults to {@link DEFAULT_THEME};
+ *   pass {@link DARK_THEME} (or use {@link baseThemeForScheme}) to resolve a
+ *   partial brand theme against the dark palette instead.
  */
-declare function mergeTheme(input?: RevTurbineThemeInput | null): RevTurbineTheme;
+declare function mergeTheme(input?: RevTurbineThemeInput | null, base?: Readonly<RevTurbineTheme>): RevTurbineTheme;
 
 /** Clear persisted theme (useful on identity reset). */
 declare function clearPersistedTheme(tenantId: string, storage?: RevTurbineStorage): void;
@@ -30060,7 +31488,7 @@ declare class RevTurbineServer {
 type BootstrapPlacementInput = Omit<RevTurbinePlacementDecisionInput, 'placementId'> & {
     placement: RevTurbinePlacementConfig;
 };
-type RevTurbineProviderProps<TUser extends RevTurbineUserContext = RevTurbineUserContext> = {
+type RevTurbineProviderProps<TUser extends RevTurbineUserContext = RevTurbineUserContext, TOptions extends RevTurbineInitInputOptions = RevTurbineInitInputOptions> = {
     /**
      * SDK initialization options. Accepts optional provider or factory.
      *
@@ -30070,7 +31498,7 @@ type RevTurbineProviderProps<TUser extends RevTurbineUserContext = RevTurbineUse
      * in an un-annotated `useMemo`, which is precisely where TypeScript's own
      * excess-property check stops applying.
      */
-    options: RevTurbineInitInputOptions & {
+    options: TOptions & ExactInitOptions<TOptions> & {
         user?: Exact<RevTurbineUserContext, TUser>;
     };
     /** Placements to bootstrap (preload decisions) on mount. */
@@ -30085,6 +31513,19 @@ type RevTurbineProviderProps<TUser extends RevTurbineUserContext = RevTurbineUse
      * Omit to disable. Memoize an object value to avoid re-installing.
      */
     domCapture?: boolean | AnnotatedCaptureOptions;
+    /**
+     * Light/dark palette for rendered placements (plan 233 TASK-6).
+     *
+     * Deliberately a provider prop rather than an SDK init option: `options`
+     * identity drives re-initialization, so a scheme toggle placed there would
+     * rebuild the SDK on every switch. That was the customer workaround this
+     * replaces. Defaults to `'system'`, which follows `prefers-color-scheme` and
+     * keeps following it.
+     *
+     * A branding theme still applies on top — the scheme only selects which base
+     * palette its tokens merge over.
+     */
+    colorScheme?: RevTurbineColorScheme;
     /** React children. */
     children: React__default.ReactNode;
 };
@@ -30103,12 +31544,92 @@ type RevTurbineProviderProps<TUser extends RevTurbineUserContext = RevTurbineUse
  * </RevTurbineProvider>
  * ```
  */
-declare function RevTurbineProvider<TUser extends RevTurbineUserContext = RevTurbineUserContext>({ options, bootstrapPlacements, domCapture, children, }: RevTurbineProviderProps<TUser>): React__default.JSX.Element;
+declare function RevTurbineProvider<TUser extends RevTurbineUserContext = RevTurbineUserContext, TOptions extends RevTurbineInitInputOptions = RevTurbineInitInputOptions>({ options, bootstrapPlacements, domCapture, colorScheme, children, }: RevTurbineProviderProps<TUser, TOptions>): React__default.JSX.Element;
+
+/**
+ * Init status — the one surface that is reachable when the SDK is not.
+ *
+ * Plan 233 TASK-2. Every diagnostic the SDK ships (`getPolicy()`,
+ * `getExportedConfig()`, `getTargeting()`, `getTelemetryCounters()`,
+ * `validateUiPathResolvers()`, `explainPlacementDecision()`) is an instance
+ * method, so all of them are unreachable in precisely the failure mode that
+ * matters most: the one where the instance was never created. When init throws,
+ * `useRevTurbine().sdk` is `null` and there is nothing left to ask.
+ *
+ * The provider already caught the error and logged it, but a `console.error` in
+ * an app that renders correctly without us is indistinguishable from silence —
+ * a customer ran dead for 36 hours and found it only by pasting a raw browser
+ * console log. So the status lives on the context value, beside `sdk`, and is
+ * populated exactly when `sdk` is not.
+ */
+/**
+ * Where initialization was when it failed. Useful because the phases fail for
+ * different reasons: `construct` is almost always malformed options, `theme`
+ * a branding/network problem, `bootstrap` a placement that does not resolve.
+ *
+ * @public
+ */
+type RevTurbineInitPhase = 'construct' | 'identify' | 'theme' | 'placements' | 'bootstrap';
+/**
+ * The provider's initialization outcome, readable with no SDK instance.
+ *
+ * `ok: true` with no other fields is the healthy state. On failure every field
+ * is populated — `remediation` is never empty, because a diagnostic that only
+ * restates the error leaves the reader exactly where they started.
+ *
+ * @public
+ */
+interface RevTurbineInitStatus {
+    /** `false` once initialization has thrown; `true` while healthy. */
+    readonly ok: boolean;
+    /** Which phase threw. Absent while healthy. */
+    readonly phase?: RevTurbineInitPhase;
+    /** The underlying error message, unmodified. Absent while healthy. */
+    readonly message?: string;
+    /** What to actually change, in the caller's own code. Absent while healthy. */
+    readonly remediation?: string;
+}
+/** The healthy status. Frozen so a consumer cannot mutate the shared default. */
+declare const INIT_STATUS_OK: RevTurbineInitStatus;
+/**
+ * Resolve the remediation for a thrown init error.
+ *
+ * @param message - The error message as thrown.
+ * @returns Actionable guidance. Never empty.
+ * @public
+ */
+declare function remediationFor(message: string): string;
+/**
+ * Build the failure status for a thrown init error.
+ *
+ * @param phase - The phase that was running when the error was thrown.
+ * @param error - The thrown value; non-Errors are stringified.
+ * @returns A fully-populated failure status.
+ * @public
+ */
+declare function initStatusForError(phase: RevTurbineInitPhase, error: unknown): RevTurbineInitStatus;
 
 type RevTurbineContextValue = {
     sdk: RevTurbineCustomerSdk | null;
     isReady: boolean;
     error: string;
+    /**
+     * Initialization outcome, readable even when {@link sdk} is `null`.
+     *
+     * Every other diagnostic the SDK exposes is an instance method, so all of
+     * them are unreachable when init failed — which is the failure that matters
+     * most (plan 233 TASK-2). On failure this carries the phase, the underlying
+     * message, and a non-empty `remediation` naming what to change.
+     */
+    initStatus: RevTurbineInitStatus;
+    /**
+     * The colour scheme currently painting placements — `'light'` or `'dark'`,
+     * with `'system'` already resolved against `prefers-color-scheme`.
+     *
+     * Read-only: set it with the provider's `colorScheme` prop. Changing it
+     * re-renders placements without re-initializing the SDK (plan 233 TASK-6).
+     */
+    colorScheme: 'light' | 'dark';
     /**
      * Update the SDK's user context. Merges the provided fields into the
      * existing context and triggers segment re-evaluation.
@@ -30119,6 +31640,39 @@ type RevTurbineContextValue = {
 };
 declare function useRevTurbine(): RevTurbineContextValue;
 
+/**
+ * Development-only visual surface for a failed SDK initialization.
+ *
+ * Plan 233 TASK-2. The provider renders this beside `children` when init threw
+ * and the build is not production. It exists because the app renders correctly
+ * without RevTurbine **by design** — a failed init changes nothing a developer
+ * can see, so the only prior signal was one `console.error` line competing with
+ * everything else in the log. That cost a customer 36 hours.
+ *
+ * Deliberately self-contained: inline styles, no theme tokens, no portal. The
+ * theme itself resolves during init, so a diagnostic that depended on it would
+ * be least reliable exactly when it is needed. It must never throw — a crashing
+ * error reporter is worse than none.
+ *
+ * @public
+ */
+interface InitFailureDiagnosticProps {
+    /** The failed status. Rendering is the caller's decision; this only draws. */
+    status: RevTurbineInitStatus;
+}
+/**
+ * Render a development-only banner describing a failed SDK initialization.
+ *
+ * Returns `null` for a healthy status, so the caller can render it
+ * unconditionally in development without branching.
+ *
+ * @public
+ */
+declare function InitFailureDiagnostic({ status }: InitFailureDiagnosticProps): React__default.JSX.Element | null;
+declare namespace InitFailureDiagnostic {
+    var displayName: string;
+}
+
 /**
  * Options for the {@link usePlacement} hook.
  */
@@ -30599,14 +32153,38 @@ type UseSurfaceSlotOptions = {
     acceptedComponentTypes?: readonly RevTurbineComponentType[];
     /** Callback when CTA is clicked. Receives the parsed ui_path. */
     onCtaClick?: (uiPath: PlacementUiPath) => void;
+    /**
+     * Called after the user dismisses the placement (plan 233 TASK-9).
+     *
+     * Fires once per dismissal, after the interaction is recorded.
+     */
+    onDismissed?: () => void;
     /** Custom CSS class for the rendered placement. */
     className?: string;
     /** Custom inline styles for the rendered placement. */
     style?: React__default.CSSProperties;
 };
+/**
+ * Why a slot is rendering nothing.
+ *
+ * `null` while visible. The distinction matters because a slot that always
+ * renders `fallback` when `!visible` shows its fallback content the instant the
+ * user dismisses — a "ghost" that reappears in place of the thing just closed.
+ * The escalated integration needed three attempts and a MutationObserver to
+ * work around it (plan 233 TASK-9).
+ *
+ * @public
+ */
+type SurfaceSlotHiddenReason = 'dismissed' | 'no_match' | null;
 type UseSurfaceSlotResult = UsePlacementResult & {
     /** Pre-built React element that renders the placement using the correct slot type. */
     element: React__default.ReactNode;
+    /**
+     * Why nothing is rendering — `'dismissed'`, `'no_match'`, or `null` when
+     * visible. Lets a slot distinguish "the user closed this" from "nothing
+     * matched", which are the same `visible: false` but want opposite UI.
+     */
+    hiddenReason: SurfaceSlotHiddenReason;
 };
 /**
  * Hook that combines `usePlacement` decision loading with automatic
@@ -30742,11 +32320,22 @@ type FixedSurfaceSlotProps = {
     personalization?: PersonalizationContext;
     registry?: PlacementTypeRegistry;
     onCtaClick?: (uiPath: PlacementUiPath) => void;
+    /**
+     * Called after the user dismisses the placement (plan 233 TASK-9).
+     *
+     * `MessageSurfaceSlot` advertised this prop but never fired it — the handler
+     * was built and then discarded. It is wired for both slots now.
+     */
+    onDismissed?: () => void;
     className?: string;
     style?: React__default.CSSProperties;
     /**
-     * Content to display when no placement decision matches.
-     * Fixed slots always render something — either a placement or the fallback.
+     * Content to display when **no placement matches**.
+     *
+     * NOT shown after the user dismisses. Rendering the fallback on dismissal
+     * puts something back in the space the user just closed — the escalated
+     * integration called it a ghost popup and needed a MutationObserver to
+     * suppress it (plan 233 TASK-9).
      */
     fallback?: React__default.ReactNode;
 };
@@ -30768,7 +32357,7 @@ type FixedSurfaceSlotProps = {
  * />
  * ```
  */
-declare function FixedSurfaceSlot({ id, name, surfaceTemplateIds, metadata, fallback, ...options }: FixedSurfaceSlotProps): React__default.JSX.Element;
+declare function FixedSurfaceSlot({ id, name, surfaceTemplateIds, metadata, fallback, ...options }: FixedSurfaceSlotProps): React__default.JSX.Element | null;
 declare namespace FixedSurfaceSlot {
     var displayName: string;
 }
@@ -31648,14 +33237,40 @@ interface UseAddonsResult {
 /** React access to the active user's public, segment-eligible add-on catalog. */
 declare function useAddons(): UseAddonsResult;
 
+/**
+ * Whether a {@link RevTurbineThemeProvider} is already mounted above the caller.
+ *
+ * Used by {@link RevTurbineProvider} to decide whether to mount its own. Exposed
+ * so an app can make the same check — e.g. a design-system wrapper that only
+ * supplies a theme when nothing upstream has.
+ *
+ * @returns `true` when an ancestor mounted a theme provider.
+ * @public
+ */
+declare function useRevTurbineThemeProviderPresent(): boolean;
 interface RevTurbineThemeProviderProps {
-    theme: RevTurbineTheme;
+    /**
+     * Theme tokens. A **partial** theme is fine — every token you omit falls back
+     * to {@link DEFAULT_THEME}, so `{ colors: { primary: '#f00' } }` is a complete,
+     * valid value (plan 233 TASK-4).
+     */
+    theme: RevTurbineThemeInput;
     children: React__default.ReactNode;
 }
 /**
  * Provides the active {@link RevTurbineTheme} to all child SDK components.
  * Typically rendered internally by {@link RevTurbineProvider} — consumers
  * don't need to add this manually.
+ *
+ * The theme is merged over {@link DEFAULT_THEME} here, so
+ * {@link useRevTurbineTheme} always returns a complete theme.
+ *
+ * That merge used to be the caller's job while the prop was typed as a complete
+ * `RevTurbineTheme`, which made a partial theme a runtime crash rather than a
+ * type error: components read `theme.typography.fontSize` and got `undefined`
+ * on a theme that only set colors. `RevTurbineThemeInput` has always documented
+ * itself as "all values are optional — the SDK deep-merges with defaults"; this
+ * is the component honouring that.
  */
 declare function RevTurbineThemeProvider({ theme, children }: RevTurbineThemeProviderProps): React__default.JSX.Element;
 /**
@@ -31664,5 +33279,18 @@ declare function RevTurbineThemeProvider({ theme, children }: RevTurbineThemePro
  */
 declare function useRevTurbineTheme(): RevTurbineTheme;
 
-export { ANALYTICS_ANNOTATION_KINDS, ANALYTICS_DATE_RANGE_FILTER_VALUE_TYPE, ANALYTICS_VALIDATION_CODES, ANALYTICS_VIEW_SCHEMA_VERSION, AccessGateSurfaceSlot, ActivityLevelSchema, AddOnSchema, AddOnVariationSchema, AgentConnectorSlot as AgentConnectorComponent, AgentConnectorSlot, AlertSchema, AnalysisProvenanceSchema, AnalyticsAgentCatalogEntryKindSchema, AnalyticsAgentCatalogEntrySchema, AnalyticsAnalyticalUnitSchema, AnalyticsAnnotationKindSchema, AnalyticsAnnotationMarkerSchema, AnalyticsAnnotationRequestSchema, AnalyticsAnnotationResponseSchema, AnalyticsAnnotationSchema, AnalyticsAnnotationSourceSchema, AnalyticsBlockErrorSchema, AnalyticsBlockResultSchema, AnalyticsCardinalityClassSchema, AnalyticsCatalogAnnotationKindSchema, AnalyticsCatalogConceptSchema, AnalyticsCatalogDeprecationSchema, AnalyticsCatalogDimensionSchema, AnalyticsCatalogMetricSchema, AnalyticsCatalogMetricValidatedSchema, AnalyticsCatalogProvenanceKindSchema, AnalyticsCatalogProvenanceSchema, AnalyticsCatalogSchema, AnalyticsCatalogSearchResultSchema, AnalyticsCatalogSourceSchema, AnalyticsClassificationSchema, AnalyticsCompareDeltaSchema, AnalyticsCompareExperimentSchema, AnalyticsCompareModeSchema, AnalyticsCompareSegmentSchema, AnalyticsCompileResolutionSchema, AnalyticsCoverageSchema, AnalyticsCustomizationCapabilitySchema, AnalyticsCustomizationPolicySchema, AnalyticsDimensionCapabilitySchema, AnalyticsDimensionTypeSchema, AnalyticsFieldTypeSchema, AnalyticsFilterControlSchema, AnalyticsFilterOperatorSchema, AnalyticsFilterStateSchema, AnalyticsFilterValueSchema, AnalyticsFormatSpecSchema, AnalyticsHistoricalModeSchema, AnalyticsMetricAggregationSemanticsSchema, AnalyticsMetricDirectionSchema, AnalyticsMetricStatisticalTypeSchema, AnalyticsPeriodCompareModeSchema, AnalyticsQueryFamilySchema, AnalyticsQueryOverridesSchema, AnalyticsQueryRequestSchema, AnalyticsQueryResponseSchema, AnalyticsRenderCartesianSchema, AnalyticsRenderFunnelSchema, AnalyticsRenderMetricSchema, AnalyticsRenderRecommendationsSchema, AnalyticsRenderSpecSchema, AnalyticsRenderTableSchema, AnalyticsRenderTimelineSchema, AnalyticsResultFieldSchema, AnalyticsResultMetaSchema, AnalyticsResultSchema, AnalyticsSafeChartOptionsSchema, AnalyticsSavedViewSchema, AnalyticsSemanticFilterSchema, AnalyticsSemanticIdSchema, AnalyticsSourceScopeSchema, AnalyticsSuggestedPatchOpSchema, AnalyticsTemplateSummarySchema, AnalyticsTimeGrainSchema, AnalyticsValidationIssueSchema, AnalyticsValidationResultSchema, AnalyticsViewAccessRoleSchema, AnalyticsViewAccessSchema, AnalyticsViewBlockDraftSchema, AnalyticsViewBlockSchema, AnalyticsViewDraftSchema, AnalyticsViewFilterDraftSchema, AnalyticsViewFilterSchema, AnalyticsViewHandoffDraftSchema, AnalyticsViewHandoffSchema, AnalyticsViewLayoutSchema, AnalyticsViewQuerySchema, AnalyticsViewRevisionSchema, AnalyticsViewSchema, AnalyticsViewVisibilitySchema, AnalyticsWarningSchema, AnchorFields, AuditActorTypeSchema, AuditEventSchema, AuthAccountSchema, AuthApiKeySchema, AuthInvitationSchema, AuthMemberSchema, AuthOrganizationSchema, AuthPasskeySchema, AuthSessionSchema, AuthSsoProviderSchema, AuthTwoFactorSchema, AuthUserSchema, AuthVerificationSchema, BUILT_IN_TEMPLATE_COMPONENT_TYPES, BannerSlot as BannerComponent, BannerFrame, BannerSlot, BannerSurface, BillingCadenceSchema, BillingHealthStatusSchema, BrandingConfigSchema, BrowserRuntime, BrowserStorage, ButtonSlot as ButtonComponent, ButtonSlot, ButtonSurface, CONTROL_PLANE_EVENT_NAMES, CONTROL_PLANE_EVENT_SOURCE, CONTROL_PLANE_SOURCE_KEY, CapEnforcer, CapPeriodSchema$1 as CapPeriodSchema, ChangeLogActionSchema, ChangeLogEntrySchema, CliSlot as CliComponent, CliSlot, ClientContextSchema, ClientSafe, CohortMonthSchema, CompactCircularGauge, ComponentTypeSchema, ContentPayloadSegmentEntrySchema, ContentPlacementPayloadSchema, ContentPromotionSchema, ContentUiPathSchema, ContextVisibility, ControlPlaneEventSourceSchema, ControlPlaneEventTypeSchema, ControlPlaneSemanticEventSchema, CreditBalanceSlot as CreditBalanceComponent, CreditBalanceSlot, CtaActionTypeSchema, CtaObjectSchema, CtaPathSchema, CtaPathTypeSchema, CtaResolverRegistry, CurrencySchema, CustomerOverrideDurationSchema, CustomerOverrideSchema, CustomerOverrideStatusSchema, CustomerOverrideTypeSchema, CustomerSchema, DEFAULT_ANALYTICS_RETENTION_DAYS, DEFAULT_BRANDING, DEFAULT_TEMPLATE_COMPONENT_TYPES, DEFAULT_THEME, DEPRECATED_EVENT_NAMES, DOGFOOD_CLIENT_EVENT_NAMES, DataClassification, DecisionEngine, DecisionOnly, DefaultTemplateIdsSchema, DescriptionField, DetectorRequirementsSchema, DimensionCategorySchema, DimensionSourceTypeSchema, DiscountTypeSchema, DomainProviderRegistry, DriftReportSchema, ENTITLEMENT_STATUS_VALUES, EVENT_PREFIX_FAMILIES, EmailPreviewSlot as EmailPreviewComponent, EmailPreviewSlot, EnforcementActionSchema, EnforcementModeSchema, EngagementArea, EntitlementCheckResultSchema, EntitlementGate, EntitlementGrantSchema, EntitlementGrantSetSchema, EntitlementGrantSourceSchema, EntitlementGrantStatusSchema, EntitlementRulePeriodUnitSchema, EntitlementRuleSchema, EntitlementRuleTargetKindSchema, EntitlementRuleTargetSchema, EntitlementRuleValidatedSchema, EntitlementRuleVariantSchema, EntitlementSchema, EntitlementStatusSchema, EntitlementTypeSchema, EnvironmentPromotionRequestSchema, EnvironmentSchema, EnvironmentStatusSchema, EventEnvelopeSchema, EventIngestBatchSchema, EventPrefixFamilySchema, EventSearchParamsSchema, EventSourceSchema, EventStabilitySchema, EventSurfaceSchema, EventTaxonomyEntrySchema, EventTaxonomySchema, EvidenceRequirementSchema, ExperimentAnalysisConfigSchema, ExperimentAnalysisConfigVersionError, ExperimentAnalysisDefinitionSchema, ExperimentAnalysisResultRecordSchema, ExperimentAnalysisResultSchema, ExperimentAssignmentFactSchema, ExperimentAssignmentSourceSchema, ExperimentDecisionFindingCodeSchema, ExperimentDecisionPolicySchema, ExperimentDecisionPolicyVersionError, ExperimentDecisionRecordSchema, ExperimentDecisionTypeSchema, ExperimentEvidenceSchema, ExperimentEvidenceSnapshotSchema, ExperimentHealthSchema, ExperimentMetricEvidencePlanSchema, ExperimentMetricResultSchema, ExperimentSchema, ExperimentStatusSchema, ExperimentTypeSchema, ExperimentVariantSchema, ExperimentVariantTargetSchema, RevTurbineConfigPlacementItemSchema as ExportedConfigPlacementItemSchema, RevTurbineConfigSchema as ExportedConfigSchema, RevTurbineConfigSegmentsItemPredicatesItemSchema as ExportedConfigSegmentsItemPredicatesItemSchema, RevTurbineConfigSegmentsItemSchema as ExportedConfigSegmentsItemSchema, RevTurbineConfigUiPathActionTypeSchema as ExportedConfigUiPathActionTypeSchema, FAMILY_RENDER_COMPATIBILITY, FIXED_BANNER_TEMPLATE_IDS, FIXED_SURFACE_TEMPLATE_IDS, FIXTURE_ANALYTICS_CATALOG, FeatureFlagSchema, FeatureFlagValueSchema, FeatureGateTriggerPayloadSchema, FieldDefinitionSchema, FixedSurfaceSlot, FlagValueTypeSchema, FreeTrialRuleSchema, FreeTrialSettingsSchema, FullPageSlot as FullPageComponent, FullPageSlot, FunnelStepSchema, GATED_SURFACE_TEMPLATE_IDS, GENERAL_BANNER_TEMPLATE_IDS, GENERAL_MODAL_TEMPLATE_IDS, GENERAL_TOAST_TEMPLATE_IDS, AccessGateSurfaceSlot as Gate, GrowthSignalBundleSchema, GrowthSignalPointSchema, GrowthSignalSeriesSchema, HANDLE_PATTERN, HandleField, INGEST_WRITE_SCOPE, IdField, IdentityKind, IdentitySchema, InMemoryStorage, InPageSlot as InPageComponent, InPageSlot, InPageSurface, IngestedEventSchema, InlineCardPlacement, InlineEmbedSlot as InlineEmbedComponent, InlineEmbedSlot, InteractionTracker, InvitationStatusSchema, KpiAggregateSchema, LocalizedTextSchema, MESSAGE_SURFACE_TEMPLATE_IDS, McpConfigSchema, McpTokenScopeSchema, MessageBlockContentSchema, MessageBlockRecordSchema, MessageBlockSchema, MessageSchema, MessageSurfaceSlot, MetadataField, MeteringConfigSchema, ModalSlot as ModalComponent, ModalFrame, ModalSlot, ModalSurface, NameField, NullableDatetimeField, ObservationMaturitySchema, OnboardingChecklistSchema, OnboardingStateSchema, OpportunityCandidateSchema, OpportunityEvidenceSchema, OpportunityInterpretationSchema, OptimizationSuggestionSchema, OrgMemberRoleSchema, PERSISTED_SCHEMA_FACET_EXEMPTIONS, PLATFORM_EMITTED_EVENT_NAMES, PLATFORM_EVENT_TAXONOMY, PLAYBOOK_FORMAT_VERSION, PaginatedResponseSchema, PaginationParamsSchema, PaymentTriggerPayloadSchema, PermissionActionSchema, PermissionResourceSchema, PermissionSchema, PersonalizationTokenSchema, Placement, PlacementCapRuleSchema, PlacementCategorySchema, PlacementController, PlacementDecisionInspector, PlacementDecisionOutputSchema, PlacementPayloadSchema, PlacementPerformanceRowSchema, PlacementRenderer, PlacementSchema, PlacementSettingsCapRuleGroupItemSchema, PlacementSettingsCapRuleSchema, PlacementSettingsCapStateSchema, PlacementSettingsSchema, PlacementTestModeSchema, PlacementTestUserIdentifierTypeSchema, PlacementTestUserSchema, PlacementTypeRegistry, PlacementWarningCodeSchema, PlacementWarningSchema, PlanSchema, PlanVariationSchema, PlanVisibilitySchema, PlaybookBodySchema, PlaybookHeaderSchema, PlaybookObjectSchema, PlaybookSchema, PlaybookStrictSchema, PlaybookVersionDeployResultSchema, PlaybookVersionDiffSchema, PlaybookVersionEntrySummarySchema, PlaybookVersionSchema, PlaybookVersionStatusSchema, PresentationOutcomeSchema, PriceSourceSchema, PricingModelSchema, PromotionSchema, PromotionStatusSchema, ProviderAvailabilitySchema, ProviderBindingRefSchema, ProviderCapabilitySchema, ProviderConnectionSchema, ProviderProvenanceSchema, PushPreviewSlot as PushPreviewComponent, PushPreviewSlot, QuotaMeterSlot as QuotaMeterComponent, QuotaMeterFrame, QuotaMeterSlot, RECOGNIZED_UPDATE_KEYS, ROLE_PERMISSIONS, ROLE_RANK, SurfaceSlotComponent as RTSlot, ApiError as RevTurbineApiError, RevTurbineConfigAddonVariationsItemSchema, RevTurbineConfigAddonsItemSchema, RevTurbineConfigEnforcementDefaultsItemSchema, RevTurbineConfigEntitlementRulesItemSchema, RevTurbineConfigEntitlementsItemSchema, RevTurbineConfigMeterBindingsItemSchema, RevTurbineConfigPeriodCapSchema, RevTurbineConfigPersonalizationTokensItemSchema, RevTurbineConfigPlacementCategorySchema, RevTurbineConfigPlacementItemSchema, RevTurbineConfigPlacementPayloadItemSchema, RevTurbineConfigPlacementSettingsItemSchema, RevTurbineConfigPlacementSlotsItemSchema, RevTurbineConfigPlacementTriggerSchema, RevTurbineConfigPlanVariationsItemSchema, RevTurbineConfigPlansItemSchema, RevTurbineConfigSchema, RevTurbineConfigSeatTypesItemSchema, RevTurbineConfigSegmentDimensionsItemSchema, RevTurbineConfigSegmentsItemPredicatesItemSchema, RevTurbineConfigSegmentsItemSchema, RevTurbineConfigSlotConfigsItemSchema, RevTurbineConfigStudioCtaConfigSchema, RevTurbineConfigStudioPayloadCapsSchema, RevTurbineConfigStudioPayloadSchema, RevTurbineConfigStudioPayloadSurfaceSchema, RevTurbineConfigStudioPayloadTargetSchema, RevTurbineConfigSurfaceTemplatesItemFieldsItemSchema, RevTurbineConfigSurfaceTemplatesItemSchema, RevTurbineConfigUiPathActionTypeSchema, RevTurbineCustomerSdk, RevTurbineProvider, RevTurbineServer, RevTurbineThemeProvider, RevenueMetricSchema, ReverseTrialRuleSchema, ReverseTrialSettingsSchema, ReverseTrialStartPolicySchema, RoleSchema, RuleVisibilitySchema, RuntimeMode, RuntimePromotionSnapshotSchema, SDK_AUTOMATIC_NON_EMITTED_NAMES, SDK_CLIENT_EVENT_NAMES, SDK_META_EVENT_NAMES, SEMANTIC_ID_PATTERN, SERVER_TRAITS_DOMAIN, SchemaContext, SchemaExposure, SchemaPersistence, SchemaSource, SdkConfigShapeSchema, SdkMetaEventSchema, SdkMetaEventTypeSchema, SdkMetaIngestBatchSchema, SdkSession, SeatTypeSchema, SegmentDimensionSchema, SegmentSchema, SegmentValueSchema, SemanticEventSchema, ServerEvaluationPayloadDecisionsItemSchema, ServerEvaluationPayloadEntitlementsValueSchema, ServerEvaluationPayloadSchema, ServerEvaluationPayloadTrialStatusSchema, ServerEvaluationPayloadUserContextSchema, ServerEvaluationPayloadUserSchema, ServerOnly, ServerUserContextProvider, SeveritySchema, SurfaceSlotComponent as Slot, SmsPreviewSlot as SmsPreviewComponent, SmsPreviewSlot, StripeIntegrationConfigSchema, StripePriceBillingPeriodSchema, StripePriceMockBillingPeriodSchema, StripePriceMockSchema, StripePriceSchema, StudioSurfaceTypeSchema, SuggestionSeveritySchema, SupersessionReasonSchema, SupersessionRecordSchema, SurfaceSlotComponent, SurfaceSlotSchema, SurfaceTemplateSchema, SurfaceTypeCapRuleSchema, SurfaceTypeSchema, TelemetryScope, TelemetryScopeContext, TemplateFieldTypeSchema, TenantConfigSchema, TenantIdField, TenantSchema, TenantStatusSchema, ThemeSchema, TimestampFields, ToastSlot as ToastComponent, ToastSlot, ToastSurface, TooltipSlot as TooltipComponent, TooltipSlot, Track, TrackEventSchema, TrackIngestBatchSchema, TrackOnView, TreatmentInteractionInputSchema, TreatmentInteractionTypeSchema, TrendFeaturesSchema, TrialEligibilityScopeSchema, TrialInstanceSchema, TrialLimitPolicySchema, TrialStatusSchema, TrialTriggerPayloadSchema, TriggerEventTypeSchema, UiPreferenceSchema, UnsupportedExperimentAssignmentUnitError, UsageAllocationSchema$1 as UsageAllocationSchema, UsageEnforcementSettingsSchema, UsagePeriodScopeSchema, UsageTriggerPayloadSchema, UserContextSchema, UserInstanceContextSchema, UserPlanContextSchema, UserProfile, UserRoleSchema, UserTrialStatusSchema, UserUsageEntrySchema, VIEW_ELEMENT_ID_PATTERN, VariantStatisticalSummarySchema, VersionFields, WarGameCapabilityRequirementsSchema, WarGameCategorySchema, WarGameGradeSchema, WarGameOracleSchema, WarGameQualificationLevelSchema, WarGameScenarioSchema, WebhookEventLogSchema, WebhookEventSourceSchema, WebhookEventStatusSchema, adaptExperimentVersionToBucketer, analyticsPaths, analyticsViewPaths, applyValueMaps, assertExperimentAnalysisConfigUpdateAllowed, assertExperimentDecisionPolicyUpdateAllowed, bridgeUiPathResolversIntoRegistry, bucketSubject, buildAgentCatalogProjection, buildControlPlaneEvent, categorizeActionError, changelogPaths, clearPersistedTheme, collectAssignmentFactDeclarations, collectPersistedSchemas, collectVersionedConfigEntities, compileAnalyticsDraft, composeEffectiveExperimentContext, configPaths, contentPaths, createAnalyticsProvider, createBasicExperimentProvider, createChainedPlacementRequest, createCompositeExperimentProvider, createCustomEndpointRuntimeConfig, createEntitlementPlacementRequest, createFixtureAnalyticsCatalog, createHydrationProviders, createInMemoryAnalyticsCatalog, createLocalRuntimeConfig, createNativeExperimentAssignmentProvider, createPostHogAnalyticsProvider, createPostHogIntegration, createRevTurbineApiClient, createSemanticEvent, createServerRuntimeConfig, createSlotPlacementRequest, createStaticPlacementContentLookupProvider, createStaticPlacementResolver, createStaticProviders, createStrictLocalRuntimeConfig, createTreatmentInteraction, customerPaths, defaultRenderForQuery, defineUiPathResolvers, deriveLocalTrialStatusFromInstance, derivePlacementPersonalizationTokens, deriveReverseTrialGrants, dispatchCtaClick, entitlementPaths, entitlementResultDenies, environmentPaths, evaluateSegments, evaluateTrialStatus, eventPaths, experimentPaths, filterExternalSchemas, filterPersistedSchemas, findActiveTrialInstance, findLatestStartedTrialInstance, formatCurrencyMinorUnits, getDefaultCtaResolverRegistry, getDefaultRegistry, getFieldClassification, getFieldVisibility, getObjectFieldClassifications, getObjectFieldVisibilities, getSchemaClassification, getSchemaDeprecation, getSchemaExposure, getSchemaFacets, getSchemaIdentity, getSchemaPersistence, initRevTurbine, isAnalyticsDateRangeFilterValue, isBrowser, isExperimentAssignmentFactDeclaration, isLegacyDateRangeArray, isServer, isVersionedConfigEntity, loadTheme, makeAnchor, mergeTheme, mintedIdentity, namedIdentity, normalizeConfigArtifactOrThrow, normalizeLegacyConfig, parsePlaybook, parsePromotion, parseUiPath, placementPaths, planPaths, playbookVersionPaths, projectClientSafe, promotionPaths, registerBuiltinSlotTypes, registerBuiltinSnoozeResolver, registerCtaResolver, registerServerActionResolvers, requireSchemaFacets, resetDefaultCtaResolverRegistry, resetDefaultRegistry, resolveBranding, resolveComponentType, resolveContent, resolveLocalPlaybook, resolvePayloadForUser, resolvePayloadForUserWithProvider, resolvePersistentStorage, resolveSessionStorage, resolveTokens, schemaDeprecation, schemaFacets, scopesSubsetOfRole, searchAgentCatalog, segmentPaths, settingsPaths, tenantPaths, toCreateSchema, toWritableSchema, trialPaths, uiPreferencePaths, unregisterCtaResolver, useAddons, useCan, useEntitlement, useGatedAction, usePlacement, usePlacementPersonalization, usePlans, useRevTurbine, useRevTurbineTheme, useSurfaceSlot, useTelemetryProps, useTelemetryScope, useTrack, useTrackedAction, useUsageSnapshot, userContextPaths, validateAnalyticsQuery, validateAnalyticsView, validatePlacementThresholdWarnings };
-export type { AccessGateCheck, AccessGateSurfaceSlotProps, ActionErrorCategory, ActivityLevel, AdapterBaseOptions, AddOn, AddOnVariation, AgentConnectorSlotProps as AgentConnectorComponentProps, AgentConnectorSlotProps, Alert, AnalysisProvenance, AnalyticsAgentCatalogEntry, AnalyticsAgentCatalogEntryKind, AnalyticsAnalyticalUnit, AnalyticsAnnotation, AnalyticsAnnotationKind, AnalyticsAnnotationMarker, AnalyticsAnnotationRequest, AnalyticsAnnotationResponse, AnalyticsAnnotationSource, AnalyticsBlockError, AnalyticsBlockResult, AnalyticsCardinalityClass, AnalyticsCatalog, AnalyticsCatalogAnnotationKind, AnalyticsCatalogConcept, AnalyticsCatalogData, AnalyticsCatalogDeprecation, AnalyticsCatalogDimension, AnalyticsCatalogMetric, AnalyticsCatalogMetricValidated, AnalyticsCatalogProvenance, AnalyticsCatalogProvenanceKind, AnalyticsCatalogSearchResult, AnalyticsCatalogSource, AnalyticsCatalogView, AnalyticsClassification, AnalyticsCompareDelta, AnalyticsCompareExperiment, AnalyticsCompareMode, AnalyticsCompareSegment, AnalyticsCompileOutput, AnalyticsCompileResolution, AnalyticsCoverage, AnalyticsCustomizationCapability, AnalyticsCustomizationPolicy, AnalyticsDateRangeFilterValue, AnalyticsDimensionCapability, AnalyticsDimensionType, AnalyticsEventHandler, AnalyticsEventProperties, AnalyticsEventTransformer, AnalyticsFieldType, AnalyticsFilterControl, AnalyticsFilterOperator, AnalyticsFilterState, AnalyticsFilterValue, AnalyticsFormatSpec, AnalyticsHistoricalMode, AnalyticsMetricAggregationSemantics, AnalyticsMetricDirection, AnalyticsMetricStatisticalType, AnalyticsPeriodCompareMode, AnalyticsProviderOptions, AnalyticsQueryFamily, AnalyticsQueryOverrides, AnalyticsQueryRequest, AnalyticsQueryResponse, AnalyticsRenderCartesian, AnalyticsRenderFunnel, AnalyticsRenderMetric, AnalyticsRenderRecommendations, AnalyticsRenderSpec, AnalyticsRenderTable, AnalyticsRenderTimeline, AnalyticsResult, AnalyticsResultField, AnalyticsResultMeta, AnalyticsSafeChartOptions, AnalyticsSavedView, AnalyticsSemanticFilter, AnalyticsSemanticId, AnalyticsSourceScope, AnalyticsSuggestedPatchOp, AnalyticsTemplateSummary, AnalyticsTimeGrain, AnalyticsValidationCode, AnalyticsValidationIssue, AnalyticsValidationResult, AnalyticsView, AnalyticsViewAccess, AnalyticsViewAccessRole, AnalyticsViewBlock, AnalyticsViewBlockDraft, AnalyticsViewDraft, AnalyticsViewFilter, AnalyticsViewFilterDraft, AnalyticsViewHandoff, AnalyticsViewHandoffDraft, AnalyticsViewLayout, AnalyticsViewQuery, AnalyticsViewRevision, AnalyticsViewVisibility, AnalyticsWarning, AnyDomainProvider, AssignmentFactUnit, AuditActorType, AuditEvent, AuthAccount, AuthApiKey, AuthInvitation, AuthMember, AuthOrganization, AuthPasskey, AuthSession, AuthSsoProvider, AuthTwoFactor, AuthUser, AuthVerification, BannerSlotProps as BannerComponentProps, BannerFrameProps, BannerSlotProps, BannerSurfaceProps, BasicBucketerExperiment, BasicBucketerOptions, BillingCadence, BillingHealthStatus, BrandingConfig, BrandingResolutionInput, BrandingSource, BrowserRuntimeOptions, ButtonSlotProps as ButtonComponentProps, ButtonSlotProps, ButtonSurfaceProps, CanonicalExperimentAllocation, CapEnforcementResult, CapPeriod, ChangeListener, ChangeLogAction, ChangeLogEntry, CliSlotProps as CliComponentProps, CliSlotProps, ClientContext, CohortMonth, CompactCircularGaugeProps, CompileAnalyticsDraftOptions, ComponentType, CompositeExperimentProviderOptions, ConfigArtifact, ContentPayloadSegmentEntry, ContentPlacementPayload, ContentPromotion, ContentProvider, ContentProviderState, ContentUiPath, ControlPlaneEmitInput, ControlPlaneEventSource, ControlPlaneEventType, ControlPlaneSemanticEvent, CreditBalanceSlotProps as CreditBalanceComponentProps, CreditBalanceSlotProps, CtaActionType, CtaHandler, CtaHandlerMap, CtaHandlerProvider, CtaHandlerProviderState, CtaObject, CtaPath, CtaPathType, CtaResolver, CtaResolverContext, Currency, Customer, CustomerOverride, CustomerOverrideDuration, CustomerOverrideStatus, CustomerOverrideType, DataClassificationValue, DecisionEngineOptions, DefaultTemplateIds, DeriveTrialStatusInput, DetectorRequirements, DimensionCategory, DimensionSourceType, DiscountType, DomainProvider, DomainProviderName, DomainProviderResolutionInput, DriftReport, EffectiveUserContextResolution, EligibleAddon, EligiblePlan, EligiblePrice, EnforcementAction, EnforcementMode, EngagementAreaProps, Entitlement, EntitlementCheckResult$1 as EntitlementCheckResult, EntitlementGateOptions, EntitlementGateState, EntitlementGrant$1 as EntitlementGrant, EntitlementGrantSet$1 as EntitlementGrantSet, EntitlementGrantSource, EntitlementGrantStatus, EntitlementProvider, EntitlementProviderState, EntitlementResult, EntitlementRule, EntitlementRulePeriodUnit, EntitlementRuleSnapshot, EntitlementRuleTarget, EntitlementRuleTargetKind$1 as EntitlementRuleTargetKind, EntitlementRuleValidated, EntitlementRuleVariant, EntitlementStatus, EntitlementType, EntitlementUsageEntry, Environment, EnvironmentPromotionRequest, EnvironmentStatus, EvaluateTrialStatusInput, EvaluateTrialStatusResult, EvaluationContext, EventConsumer, EventConsumerProvider, EventConsumerProviderState, EventEnvelope, EventIngestBatch, EventPrefixFamily, EventSearchParams, EventSource, EventStability, EventSurface, EventTaxonomy, EventTaxonomyEntry, EvidenceRequirement, Exact, Experiment, ExperimentAnalysisConfig, ExperimentAnalysisDefinition, ExperimentAnalysisResult, ExperimentAnalysisResultRecord, ExperimentAssignmentFact, ExperimentAssignmentFactDeclaration, ExperimentAssignmentFactMetadataCarrier, ExperimentAssignmentProvider, ExperimentAssignmentSource, ExperimentDecisionFindingCode, ExperimentDecisionPolicy, ExperimentDecisionRecord, ExperimentDecisionType, ExperimentEvidence, ExperimentEvidenceSnapshot, ExperimentHealth, ExperimentMetricEvidencePlan, ExperimentMetricResult, ExperimentProvider, ExperimentProviderState, ExperimentStatus, ExperimentType, ExperimentVariant, ExperimentVariantNonAssignmentReason, ExperimentVariantSelection, ExperimentVariantTarget, Playbook as ExportedConfig, ExportedConfigPlacementItem, ExportedConfigProvider, ExportedConfigSegmentsItem, ExportedConfigSegmentsItemPredicatesItem, ExportedConfigUiPathActionType, FeatureFlag, FeatureFlagValue, FeatureGateTriggerPayload, FieldDefinition, FixedSurfaceSlotProps, FlagValueType, FreeTrialRule, FreeTrialSettings, FullPageSlotProps as FullPageComponentProps, FullPageSlotProps, FunnelStep, AccessGateSurfaceSlotProps as GateProps, GatedAction, GrowthSignalBundle, GrowthSignalPoint, GrowthSignalSeries, IdentifyContextInput, Identity, IdentityDeclaration, InPageSlotProps as InPageComponentProps, InPageSlotProps, InPageSurfaceProps, IngestWriteScope, IngestedEvent, InlineCardPlacementProps, InlineEmbedSlotProps as InlineEmbedComponentProps, InlineEmbedSlotProps, InteractionState, InvitationStatus, JsonObject, JsonValue, KpiAggregate, LegacyConfigTargetDefaults, LocalPlacementDataset, LocalPlacementEntry, LocalPlacementPayload, LocalPlacementSurface, LocalizedText, McpConfig, McpTokenScope, Message, MessageBlock, MessageBlockContent, MessageBlockRecord, MessageBlockSnapshot, MessageSurfaceSlotProps, MessageSurfaceSlotRef, MessageTriggerType, MeteringConfig, ModalSlotProps as ModalComponentProps, ModalFrameProps, ModalLayout, ModalSlotProps, ModalSurfaceProps, NativeExperimentAssignmentOptions, NativeExperimentAssignmentUnit, ObservationMaturity, OnboardingChecklist, OnboardingState, OpportunityCandidate, OpportunityEvidence, OpportunityInterpretation, OptimizationSuggestion, OrgMemberRole, PaginationParams, PaymentTriggerPayload, Permission, PermissionAction, PermissionResource, PersonalizationContext, PersonalizationToken, PlacementCapPolicy, PlacementCapRule, PlacementCategory, PlacementContentFields, PlacementContentLookupProvider, PlacementControllerOptions, PlacementControllerState, PlacementCustomCode, PlacementDecisionInspectorProps, PlacementDecisionOutput, PlacementEmittedThresholdLookup, PlacementOutput, PlacementPayload, PlacementPayloadSnapshot, PlacementPerformanceRow, PlacementPreviewConfig, PlacementPromotion, PlacementProps, PlacementRendererProps, PlacementSettings, PlacementSettingsCapRule, PlacementSettingsCapRuleGroupItem, PlacementSettingsCapState, PlacementSlotProps, PlacementSlotType, PlacementTestMode, PlacementTestUser, PlacementTestUserIdentifierType, PlacementUiPath, PlacementUiPathActionType, PlacementWarning, PlacementWarningCode, Plan, PlanProvider, PlanProviderState, PlanRuleSnapshot, PlanVariation, PlanVisibility, Playbook, PlaybookBody, PlaybookHeader, PlaybookObject, PlaybookStrict, PlaybookVersion, PlaybookVersionDeployResult, PlaybookVersionDiff, PlaybookVersionEntrySummary, PlaybookVersionStatus, PostHogAnalyticsProviderOptions, PostHogIntegrationOptions, PostHogLike, PresentationCapState, PresentationOutcome, PriceSource, PricingModel, Promotion, PromotionStatus, ProviderAvailability, ProviderBindingRef, ProviderCapability, ProviderConnection, ProviderProvenance, QuotaMeterSlotProps as QuotaMeterComponentProps, QuotaMeterFrameProps, QuotaMeterSlotProps, SurfaceSlotComponentProps as RTSlotProps, RegisterPlacementSlotTypeOptions, ResolvedBranding, ResolvedContent, ResolvedDomainType, ResolvedPayload, ResolvedProviderContext, RevTurbineApiClient, RevTurbineApiClientConfig, paths as RevTurbineApiPaths, RevTurbineBootstrapDecisionInput, RevTurbineChainedPlacementRequestOptions, RevTurbineClientSessionProvider, RevTurbineComponentType, Playbook as RevTurbineConfig, RevTurbineConfigAddonVariationsItem, RevTurbineConfigAddonsItem, RevTurbineConfigEnforcementDefaultsItem, RevTurbineConfigEntitlementRulesItem, RevTurbineConfigEntitlementsItem, RevTurbineConfigMeterBindingsItem, RevTurbineConfigPeriodCap, RevTurbineConfigPersonalizationTokensItem, RevTurbineConfigPlacementCategory, RevTurbineConfigPlacementItem, RevTurbineConfigPlacementPayloadItem, RevTurbineConfigPlacementSettingsItem, RevTurbineConfigPlacementSlotsItem, RevTurbineConfigPlacementTrigger, RevTurbineConfigPlanVariationsItem, RevTurbineConfigPlansItem, RevTurbineConfigProvider, RevTurbineConfigSeatTypesItem, RevTurbineConfigSegmentDimensionsItem, RevTurbineConfigSegmentsItem, RevTurbineConfigSegmentsItemPredicatesItem, RevTurbineConfigSlotConfigsItem, RevTurbineConfigStudioCtaConfig, RevTurbineConfigStudioPayload, RevTurbineConfigStudioPayloadCaps, RevTurbineConfigStudioPayloadSurface, RevTurbineConfigStudioPayloadTarget, RevTurbineConfigSurfaceTemplatesItem, RevTurbineConfigSurfaceTemplatesItemFieldsItem, RevTurbineConfigUiPathActionType, RevTurbineContextMode, RevTurbineContextPolicy, RevTurbineDecisionContent, RevTurbineEndpointOverrides, RevTurbineEntitlementContext, RevTurbineEntitlementPlacementRequestOptions, RevTurbineEntitlementRuleEvaluation, RevTurbineEventBatchingOptions, RevTurbineEventEnvelope, RevTurbineEventOptions, RevTurbineGateResult, RevTurbineImpressionMetadata, RevTurbineInitBaseOptions, RevTurbineInitInputOptions, RevTurbineInitOptions, RevTurbineInitOptionsStrict, RevTurbineInitWithProviderOptions, RevTurbineLocalOnlyMinimalInitOptions, RevTurbineLocalRuntimeData, RevTurbineLocalRuntimeOptions, RevTurbineLocalRuntimeResolvers, RevTurbineMeterUsageOverride, RevTurbinePageContext, RevTurbinePersonalizationTokens, RevTurbinePlacementBehaviorFlags, RevTurbinePlacementConfig, RevTurbinePlacementContent, RevTurbinePlacementDecision, RevTurbinePlacementDecisionExplanation, RevTurbinePlacementDecisionInput, RevTurbinePlacementDecisionOverrides, RevTurbinePlacementPayloadEvaluation, RevTurbinePlacementRecord, RevTurbinePlacementRequestConfig, RevTurbinePlacementRuleEvaluation, RevTurbinePlacementTypeEntity, RevTurbinePolicySnapshot, RevTurbineProviderFactory, RevTurbineProviderFailureSlotBehavior, RevTurbineProviderProps, RevTurbineRequiredUiPathResolvers, RevTurbineRuntimeMode, RevTurbineSdkMode, RevTurbineSdkProvider, RevTurbineSegmentEvaluation, RevTurbineSegmentPredicateEvaluation, RevTurbineSemanticEvent, RevTurbineServerOptions, RevTurbineSlotPlacementRequestOptions, RevTurbineStorage, RevTurbineSurfaceSlotConfig, RevTurbineSurfaceType, RevTurbineTargeting, RevTurbineTelemetryOptions, RevTurbineTheme, RevTurbineThemeColors, RevTurbineThemeInput, RevTurbineThemeShadows, RevTurbineThemeShape, RevTurbineThemeTypography, RevTurbineTreatmentInteractionInput, RevTurbineTreatmentInteractionOptions, RevTurbineTreatmentInteractionType, RevTurbineTrialContext, RevTurbineTriggerEvent, RevTurbineTriggerPayload, RevTurbineUiPathActionTypes, RevTurbineUiPathResolver, RevTurbineUiPathResolverMap, RevTurbineUiPathResolverValidationIssue, RevTurbineUiPathResolverValidationOptions, RevTurbineUiPathResolverValidationReport, RevTurbineUpdateInput, RevTurbineUsageSnapshot, RevTurbineUsageSnapshotEntry, RevTurbineUserContext, RevenueMetric, ReverseTrialRule, ReverseTrialSettings, ReverseTrialStartPolicy, Role, RuleProvider, RuleProviderState, RuleVisibility, RuntimePromotionSnapshot, SchemaDeprecation, SchemaFacetOptions, SchemaFacets, SdkConfigShape, SdkEventProperties, SdkMetaEvent, SdkMetaEventType, SdkMetaIngestBatch, SdkMetadata, SdkSessionOptions, SdkTraits, SeatType, Segment, SegmentDimension, SegmentProvider, SegmentProviderState, SegmentValue, SemanticEvent, ServerActionContext, ServerActionHandler, ServerActionMap, ServerActionResult, ServerEntitlementResult, ServerEvaluationHydrationPayload, ServerEvaluationPayload, ServerEvaluationPayloadDecisionsItem, ServerEvaluationPayloadEntitlementsValue, ServerEvaluationPayloadTrialStatus, ServerEvaluationPayloadUser, ServerEvaluationPayloadUserContext, ServerEvaluationRequest, ServerPlacementDecision, ServerPlacementRequest, ServerUserContext, ServerUserContextSnapshot, Severity, SurfaceSlotComponentProps as SlotProps, StaticPlacementResolverOptions, StripeIntegrationConfig, StripePrice, StripePriceBillingPeriod, StripePriceMock, StripePriceMockBillingPeriod, StudioSurfaceType, SuggestionSeverity, SupersessionReason, SupersessionRecord, SuppressionResult, SurfaceSlot, SurfaceSlotCategory, SurfaceSlotComponentProps, SurfaceTemplate, SurfaceType, SurfaceTypeCapRule, TelemetryConsent, TelemetryScopeProps, TelemetryScopeValue, TemplateFieldType, Tenant, TenantConfig, TenantStatus, Theme, ThemeLoaderOptions, ThemeProvider, ThemeProviderState, ToastSlotProps as ToastComponentProps, ToastSlotProps, ToastSurfaceProps, TooltipSlotProps as TooltipComponentProps, TooltipSlotProps, TrackEvent, TrackFn, TrackIngestBatch, TrackOnViewProps, TrackOptions, TrackProps, TrackPurpose, TrackedAction, Trait, TraitsNamespace, TraitsProvider, TraitsProviderState, TreatmentInteractionInput, TreatmentInteractionType, TrendFeatures, TrialEligibilityScope, TrialInstance, TrialLimitPolicy, TrialStatus, TrialStatusProvider, TrialStatusTraits, TrialTriggerPayload, TriggerEventType, UiPreference, UnvalidatedConfigArtifact, UsageAllocation, UsageBalances, UsageEnforcementSettings, UsagePeriodScope, UsageTraits, UsageTraitsProvider, UsageTriggerPayload, UseAddonsResult, UseCanResult, UseEntitlementOptions, UseEntitlementResult, UsePlacementOptions, UsePlacementPersonalizationOptions, UsePlacementResult, UsePlansResult, UseSurfaceSlotOptions, UseSurfaceSlotResult, UseUsageSnapshotResult, UserContext, UserContextInput, UserInstanceContext, UserPlanContext, UserProfileProps, UserRole, UserTargetingContext, UserTrialStatus, UserUsageEntry, ValidateAnalyticsViewOptions, VariantStatisticalSummary, WarGameCapabilityRequirements, WarGameCategory, WarGameGrade, WarGameOracle, WarGameQualificationLevel, WarGameScenario, WebhookEventLog, WebhookEventSource, WebhookEventStatus };
+/**
+ * Resolve a {@link RevTurbineColorScheme} to the concrete scheme to paint.
+ *
+ * `'system'` tracks `prefers-color-scheme` and keeps tracking it: a user
+ * flipping their OS theme updates the resolved value without a remount, which
+ * is the difference between following the system and sampling it once at init.
+ *
+ * @param preference - The requested scheme. `'system'` follows the OS.
+ * @returns `'light'` or `'dark'`.
+ * @public
+ */
+declare function useResolvedColorScheme(preference: RevTurbineColorScheme): 'light' | 'dark';
+
+export { ANALYTICS_ANNOTATION_KINDS, ANALYTICS_DATE_RANGE_FILTER_VALUE_TYPE, ANALYTICS_VALIDATION_CODES, ANALYTICS_VIEW_SCHEMA_VERSION, AccessGateSurfaceSlot, ActivityLevelSchema, AddOnSchema, AddOnVariationSchema, AgentConnectorSlot as AgentConnectorComponent, AgentConnectorSlot, AlertSchema, AnalysisProvenanceSchema, AnalyticsAgentCatalogEntryKindSchema, AnalyticsAgentCatalogEntrySchema, AnalyticsAnalyticalUnitSchema, AnalyticsAnnotationKindSchema, AnalyticsAnnotationMarkerSchema, AnalyticsAnnotationRequestSchema, AnalyticsAnnotationResponseSchema, AnalyticsAnnotationSchema, AnalyticsAnnotationSourceSchema, AnalyticsBlockErrorSchema, AnalyticsBlockResultSchema, AnalyticsCardinalityClassSchema, AnalyticsCatalogAnnotationKindSchema, AnalyticsCatalogConceptSchema, AnalyticsCatalogDeprecationSchema, AnalyticsCatalogDimensionSchema, AnalyticsCatalogMetricSchema, AnalyticsCatalogMetricValidatedSchema, AnalyticsCatalogProvenanceKindSchema, AnalyticsCatalogProvenanceSchema, AnalyticsCatalogSchema, AnalyticsCatalogSearchResultSchema, AnalyticsCatalogSourceSchema, AnalyticsClassificationSchema, AnalyticsCompareDeltaSchema, AnalyticsCompareExperimentSchema, AnalyticsCompareModeSchema, AnalyticsCompareSegmentSchema, AnalyticsCompileResolutionSchema, AnalyticsCoverageSchema, AnalyticsCustomizationCapabilitySchema, AnalyticsCustomizationPolicySchema, AnalyticsDimensionCapabilitySchema, AnalyticsDimensionTypeSchema, AnalyticsFieldTypeSchema, AnalyticsFilterControlSchema, AnalyticsFilterOperatorSchema, AnalyticsFilterStateSchema, AnalyticsFilterValueSchema, AnalyticsFormatSpecSchema, AnalyticsHistoricalModeSchema, AnalyticsMetricAggregationSemanticsSchema, AnalyticsMetricDirectionSchema, AnalyticsMetricStatisticalTypeSchema, AnalyticsPeriodCompareModeSchema, AnalyticsQueryFamilySchema, AnalyticsQueryOverridesSchema, AnalyticsQueryRequestSchema, AnalyticsQueryResponseSchema, AnalyticsRenderCartesianSchema, AnalyticsRenderFunnelSchema, AnalyticsRenderMetricSchema, AnalyticsRenderRecommendationsSchema, AnalyticsRenderSpecSchema, AnalyticsRenderTableSchema, AnalyticsRenderTimelineSchema, AnalyticsResultFieldSchema, AnalyticsResultMetaSchema, AnalyticsResultSchema, AnalyticsSafeChartOptionsSchema, AnalyticsSavedViewSchema, AnalyticsSemanticFilterSchema, AnalyticsSemanticIdSchema, AnalyticsSourceScopeSchema, AnalyticsSuggestedPatchOpSchema, AnalyticsTemplateSummarySchema, AnalyticsTimeGrainSchema, AnalyticsValidationIssueSchema, AnalyticsValidationResultSchema, AnalyticsViewAccessRoleSchema, AnalyticsViewAccessSchema, AnalyticsViewBlockDraftSchema, AnalyticsViewBlockSchema, AnalyticsViewDraftSchema, AnalyticsViewFilterDraftSchema, AnalyticsViewFilterSchema, AnalyticsViewHandoffDraftSchema, AnalyticsViewHandoffSchema, AnalyticsViewLayoutSchema, AnalyticsViewQuerySchema, AnalyticsViewRevisionSchema, AnalyticsViewSchema, AnalyticsViewVisibilitySchema, AnalyticsWarningSchema, AnchorFields, AuditActorTypeSchema, AuditEventSchema, AuthAccountSchema, AuthApiKeySchema, AuthInvitationSchema, AuthMemberSchema, AuthOrganizationSchema, AuthPasskeySchema, AuthSessionSchema, AuthSsoProviderSchema, AuthTwoFactorSchema, AuthUserSchema, AuthVerificationSchema, BUILT_IN_TEMPLATE_COMPONENT_TYPES, BannerSlot as BannerComponent, BannerFrame, BannerSlot, BannerSurface, BillingCadenceSchema, BillingHealthStatusSchema, BrandingConfigSchema, BrowserRuntime, BrowserStorage, ButtonSlot as ButtonComponent, ButtonSlot, ButtonSurface, CONTROL_PLANE_EVENT_NAMES, CONTROL_PLANE_EVENT_SOURCE, CONTROL_PLANE_SOURCE_KEY, CapEnforcer, CapPeriodSchema$1 as CapPeriodSchema, ChangeLogActionSchema, ChangeLogEntrySchema, CliSlot as CliComponent, CliSlot, ClientContextSchema, ClientSafe, CohortMonthSchema, CompactCircularGauge, ComponentTypeSchema, ContentPayloadSegmentEntrySchema, ContentPlacementPayloadSchema, ContentPromotionSchema, ContentUiPathSchema, ContextVisibility, ControlPlaneEventSourceSchema, ControlPlaneEventTypeSchema, ControlPlaneSemanticEventSchema, CreditBalanceSlot as CreditBalanceComponent, CreditBalanceSlot, CtaActionTypeSchema, CtaObjectSchema, CtaPathSchema, CtaPathTypeSchema, CtaResolverRegistry, CurrencySchema, CustomerOverrideDurationSchema, CustomerOverrideSchema, CustomerOverrideStatusSchema, CustomerOverrideTypeSchema, CustomerSchema, DARK_THEME, DEFAULT_ANALYTICS_RETENTION_DAYS, DEFAULT_BRANDING, DEFAULT_TEMPLATE_COMPONENT_TYPES, DEFAULT_THEME, DEPRECATED_EVENT_NAMES, DOGFOOD_CLIENT_EVENT_NAMES, DataClassification, DecisionEngine, DecisionOnly, DefaultTemplateIdsSchema, DescriptionField, DetectorRequirementsSchema, DimensionCategorySchema, DimensionSourceTypeSchema, DiscountTypeSchema, DomainProviderRegistry, DriftReportSchema, EMITTABLE_PLATFORM_EVENT_NAMES, ENTITLEMENT_STATUS_VALUES, EVENT_PAYLOAD_CONTRACTS, EVENT_PAYLOAD_EVENT_NAMES, EVENT_PREFIX_FAMILIES, EmailPreviewSlot as EmailPreviewComponent, EmailPreviewSlot, EnforcementActionSchema, EnforcementModeSchema, EngagementArea, EntitlementCheckResultSchema, EntitlementGate, EntitlementGrantSchema, EntitlementGrantSetSchema, EntitlementGrantSourceSchema, EntitlementGrantStatusSchema, EntitlementRulePeriodUnitSchema, EntitlementRuleSchema, EntitlementRuleTargetKindSchema, EntitlementRuleTargetSchema, EntitlementRuleValidatedSchema, EntitlementRuleVariantSchema, EntitlementSchema, EntitlementStatusSchema, EntitlementTypeSchema, EnvironmentPromotionRequestSchema, EnvironmentSchema, EnvironmentStatusSchema, EventEnvelopeSchema, EventIngestBatchSchema, EventPrefixFamilySchema, EventSearchParamsSchema, EventSourceSchema, EventStabilitySchema, EventSurfaceSchema, EventTaxonomyEntrySchema, EventTaxonomySchema, EvidenceRequirementSchema, ExperimentAnalysisConfigSchema, ExperimentAnalysisConfigVersionError, ExperimentAnalysisDefinitionSchema, ExperimentAnalysisResultRecordSchema, ExperimentAnalysisResultSchema, ExperimentAssignmentFactSchema, ExperimentAssignmentSourceSchema, ExperimentDecisionFindingCodeSchema, ExperimentDecisionPolicySchema, ExperimentDecisionPolicyVersionError, ExperimentDecisionRecordSchema, ExperimentDecisionTypeSchema, ExperimentEvidenceSchema, ExperimentEvidenceSnapshotSchema, ExperimentHealthSchema, ExperimentMetricEvidencePlanSchema, ExperimentMetricResultSchema, ExperimentSchema, ExperimentStatusSchema, ExperimentTypeSchema, ExperimentVariantSchema, ExperimentVariantTargetSchema, RevTurbineConfigPlacementItemSchema as ExportedConfigPlacementItemSchema, RevTurbineConfigSchema as ExportedConfigSchema, RevTurbineConfigSegmentsItemPredicatesItemSchema as ExportedConfigSegmentsItemPredicatesItemSchema, RevTurbineConfigSegmentsItemSchema as ExportedConfigSegmentsItemSchema, RevTurbineConfigUiPathActionTypeSchema as ExportedConfigUiPathActionTypeSchema, FAMILY_RENDER_COMPATIBILITY, FIXED_BANNER_TEMPLATE_IDS, FIXED_SURFACE_TEMPLATE_IDS, FIXTURE_ANALYTICS_CATALOG, FeatureFlagSchema, FeatureFlagValueSchema, FeatureGateTriggerPayloadSchema, FieldDefinitionSchema, FixedSurfaceSlot, FlagValueTypeSchema, FreeTrialRuleSchema, FreeTrialSettingsSchema, FullPageSlot as FullPageComponent, FullPageSlot, FunnelStepSchema, GATED_SURFACE_TEMPLATE_IDS, GENERAL_BANNER_TEMPLATE_IDS, GENERAL_MODAL_TEMPLATE_IDS, GENERAL_TOAST_TEMPLATE_IDS, AccessGateSurfaceSlot as Gate, GrowthSignalBundleSchema, GrowthSignalPointSchema, GrowthSignalSeriesSchema, HANDLE_PATTERN, HandleField, INGEST_WRITE_SCOPE, INIT_STATUS_OK, IdField, IdentityKind, IdentitySchema, InMemoryStorage, InPageSlot as InPageComponent, InPageSlot, InPageSurface, IngestedEventSchema, InitFailureDiagnostic, InlineCardPlacement, InlineEmbedSlot as InlineEmbedComponent, InlineEmbedSlot, InteractionTracker, InvitationStatusSchema, KpiAggregateSchema, LocalizedTextSchema, MAX_TREATMENT_INTERACTIONS_PER_BATCH, MESSAGE_SURFACE_TEMPLATE_IDS, McpConfigSchema, McpTokenScopeSchema, MessageBlockContentSchema, MessageBlockRecordSchema, MessageBlockSchema, MessageSchema, MessageSurfaceSlot, MetadataField, MeteringConfigSchema, ModalSlot as ModalComponent, ModalFrame, ModalSlot, ModalSurface, NameField, NullableDatetimeField, ObservationMaturitySchema, OnboardingChecklistSchema, OnboardingStateSchema, OpportunityCandidateSchema, OpportunityEvidenceSchema, OpportunityInterpretationSchema, OptimizationSuggestionSchema, OrgMemberRoleSchema, PERSISTED_SCHEMA_FACET_EXEMPTIONS, PLATFORM_EMITTED_EVENT_NAMES, PLATFORM_EVENT_TAXONOMY, PLAYBOOK_FORMAT_VERSION, PaginatedResponseSchema, PaginationParamsSchema, PaymentTriggerPayloadSchema, PermissionActionSchema, PermissionResourceSchema, PermissionSchema, PersonalizationTokenSchema, Placement, PlacementCapRuleSchema, PlacementCategorySchema, PlacementController, PlacementDecisionInspector, PlacementDecisionOutputSchema, PlacementPayloadSchema, PlacementPerformanceRowSchema, PlacementRenderer, PlacementSchema, PlacementSettingsCapRuleGroupItemSchema, PlacementSettingsCapRuleSchema, PlacementSettingsCapStateSchema, PlacementSettingsSchema, PlacementTestModeSchema, PlacementTestUserIdentifierTypeSchema, PlacementTestUserSchema, PlacementTypeRegistry, PlacementWarningCodeSchema, PlacementWarningSchema, PlanSchema, PlanVariationSchema, PlanVisibilitySchema, PlaybookBodySchema, PlaybookHeaderSchema, PlaybookObjectSchema, PlaybookSchema, PlaybookStrictSchema, PlaybookVersionDeployResultSchema, PlaybookVersionDiffSchema, PlaybookVersionEntrySummarySchema, PlaybookVersionSchema, PlaybookVersionStatusSchema, PresentationOutcomeSchema, PriceSourceSchema, PricingModelSchema, PromotionSchema, PromotionStatusSchema, ProviderAvailabilitySchema, ProviderBindingRefSchema, ProviderCapabilitySchema, ProviderConnectionSchema, ProviderProvenanceSchema, PushPreviewSlot as PushPreviewComponent, PushPreviewSlot, QuotaMeterSlot as QuotaMeterComponent, QuotaMeterFrame, QuotaMeterSlot, RECOGNIZED_UPDATE_KEYS, ROLE_PERMISSIONS, ROLE_RANK, SurfaceSlotComponent as RTSlot, ApiError as RevTurbineApiError, RevTurbineConfigAddonVariationsItemSchema, RevTurbineConfigAddonsItemSchema, RevTurbineConfigEnforcementDefaultsItemSchema, RevTurbineConfigEntitlementRulesItemSchema, RevTurbineConfigEntitlementsItemSchema, RevTurbineConfigMeterBindingsItemSchema, RevTurbineConfigPeriodCapSchema, RevTurbineConfigPersonalizationTokensItemSchema, RevTurbineConfigPlacementCategorySchema, RevTurbineConfigPlacementItemSchema, RevTurbineConfigPlacementPayloadItemSchema, RevTurbineConfigPlacementSettingsItemSchema, RevTurbineConfigPlacementSlotsItemSchema, RevTurbineConfigPlacementTriggerSchema, RevTurbineConfigPlanVariationsItemSchema, RevTurbineConfigPlansItemSchema, RevTurbineConfigSchema, RevTurbineConfigSeatTypesItemSchema, RevTurbineConfigSegmentDimensionsItemSchema, RevTurbineConfigSegmentsItemPredicatesItemSchema, RevTurbineConfigSegmentsItemSchema, RevTurbineConfigSlotConfigsItemSchema, RevTurbineConfigStudioCtaConfigSchema, RevTurbineConfigStudioPayloadCapsSchema, RevTurbineConfigStudioPayloadSchema, RevTurbineConfigStudioPayloadSurfaceSchema, RevTurbineConfigStudioPayloadTargetSchema, RevTurbineConfigSurfaceTemplatesItemFieldsItemSchema, RevTurbineConfigSurfaceTemplatesItemSchema, RevTurbineConfigUiPathActionTypeSchema, RevTurbineCustomerSdk, RevTurbineProvider, RevTurbineServer, RevTurbineThemeProvider, RevenueMetricSchema, ReverseTrialRuleSchema, ReverseTrialSettingsSchema, ReverseTrialStartPolicySchema, RoleSchema, RuleVisibilitySchema, RuntimeMode, RuntimePromotionSnapshotSchema, SDK_AUTOMATIC_NON_EMITTED_NAMES, SDK_CLIENT_EVENT_NAMES, SDK_META_EVENT_NAMES, SDK_SERVER_EVENT_NAMES, SEMANTIC_ID_PATTERN, SERVER_TRAITS_DOMAIN, SchemaContext, SchemaExposure, SchemaPersistence, SchemaSource, SdkConfigShapeSchema, SdkMetaEventSchema, SdkMetaEventTypeSchema, SdkMetaIngestBatchSchema, SdkSession, SeatTypeSchema, SegmentDimensionSchema, SegmentSchema, SegmentValueSchema, SemanticEventSchema, ServerEvaluationPayloadDecisionsItemSchema, ServerEvaluationPayloadEntitlementsValueSchema, ServerEvaluationPayloadSchema, ServerEvaluationPayloadTrialStatusSchema, ServerEvaluationPayloadUserContextSchema, ServerEvaluationPayloadUserSchema, ServerOnly, ServerUserContextProvider, SeveritySchema, SurfaceSlotComponent as Slot, SmsPreviewSlot as SmsPreviewComponent, SmsPreviewSlot, StripeIntegrationConfigSchema, StripePriceBillingPeriodSchema, StripePriceMockBillingPeriodSchema, StripePriceMockSchema, StripePriceSchema, StudioSurfaceTypeSchema, SuggestionSeveritySchema, SupersessionReasonSchema, SupersessionRecordSchema, SurfaceSlotComponent, SurfaceSlotSchema, SurfaceTemplateSchema, SurfaceTypeCapRuleSchema, SurfaceTypeSchema, TelemetryScope, TelemetryScopeContext, TemplateFieldTypeSchema, TenantConfigSchema, TenantIdField, TenantSchema, TenantStatusSchema, ThemeSchema, TimestampFields, ToastSlot as ToastComponent, ToastSlot, ToastSurface, TooltipSlot as TooltipComponent, TooltipSlot, Track, TrackEventSchema, TrackIngestBatchSchema, TrackOnView, TreatmentInteractionBatchSchema, TreatmentInteractionInputSchema, TreatmentInteractionRequestSchema, TreatmentInteractionTypeSchema, TrendFeaturesSchema, TrialEligibilityScopeSchema, TrialInstanceSchema, TrialLimitPolicySchema, TrialStatusSchema, TrialTriggerPayloadSchema, TriggerEventTypeSchema, UiPreferenceSchema, UnsupportedExperimentAssignmentUnitError, UsageAllocationSchema$1 as UsageAllocationSchema, UsageEnforcementSettingsSchema, UsagePeriodScopeSchema, UsageTriggerPayloadSchema, UserContextSchema, UserInstanceContextSchema, UserPlanContextSchema, UserProfile, UserRoleSchema, UserTrialStatusSchema, UserUsageEntrySchema, VIEW_ELEMENT_ID_PATTERN, VariantStatisticalSummarySchema, VersionFields, WEBHOOK_DERIVED_EVENT_NAMES, WarGameCapabilityRequirementsSchema, WarGameCategorySchema, WarGameGradeSchema, WarGameOracleSchema, WarGameQualificationLevelSchema, WarGameScenarioSchema, WebhookEventLogSchema, WebhookEventSourceSchema, WebhookEventStatusSchema, adaptExperimentVersionToBucketer, analyticsPaths, analyticsViewPaths, applyValueMaps, assertExperimentAnalysisConfigUpdateAllowed, assertExperimentDecisionPolicyUpdateAllowed, baseThemeForScheme, bridgeUiPathResolversIntoRegistry, bucketSubject, buildAgentCatalogProjection, buildControlPlaneEvent, categorizeActionError, changelogPaths, clearPersistedTheme, collectAssignmentFactDeclarations, collectPersistedSchemas, collectVersionedConfigEntities, compileAnalyticsDraft, composeEffectiveExperimentContext, configPaths, contentPaths, createAnalyticsProvider, createBasicExperimentProvider, createChainedPlacementRequest, createCompositeExperimentProvider, createCustomEndpointRuntimeConfig, createEntitlementPlacementRequest, createFixtureAnalyticsCatalog, createHydrationProviders, createInMemoryAnalyticsCatalog, createLocalRuntimeConfig, createNativeExperimentAssignmentProvider, createPostHogAnalyticsProvider, createPostHogIntegration, createRevTurbineApiClient, createSemanticEvent, createServerRuntimeConfig, createSlotPlacementRequest, createStaticPlacementContentLookupProvider, createStaticPlacementResolver, createStaticProviders, createStrictLocalRuntimeConfig, createTreatmentInteraction, customerPaths, defaultRenderForQuery, defineUiPathResolvers, deriveLocalTrialStatusFromInstance, derivePlacementPersonalizationTokens, deriveReverseTrialGrants, dispatchCtaClick, entitlementPaths, entitlementResultDenies, environmentPaths, evaluateSegments, evaluateTrialStatus, eventPaths, experimentPaths, filterExternalSchemas, filterPersistedSchemas, findActiveTrialInstance, findLatestStartedTrialInstance, formatCurrencyMinorUnits, getDefaultCtaResolverRegistry, getDefaultRegistry, getFieldClassification, getFieldVisibility, getObjectFieldClassifications, getObjectFieldVisibilities, getSchemaClassification, getSchemaDeprecation, getSchemaExposure, getSchemaFacets, getSchemaIdentity, getSchemaPersistence, initRevTurbine, initStatusForError, isAnalyticsDateRangeFilterValue, isBrowser, isExperimentAssignmentFactDeclaration, isLegacyDateRangeArray, isServer, isVersionedConfigEntity, loadTheme, makeAnchor, mergeTheme, mintedIdentity, namedIdentity, namespacePlatformCollision, normalizeConfigArtifactOrThrow, normalizeLegacyConfig, parsePlaybook, parsePromotion, parseUiPath, placementPaths, planPaths, playbookVersionPaths, projectClientSafe, promotionPaths, registerBuiltinSlotTypes, registerBuiltinSnoozeResolver, registerCtaResolver, registerServerActionResolvers, remediationFor, requireSchemaFacets, resetDefaultCtaResolverRegistry, resetDefaultRegistry, resolveBranding, resolveComponentType, resolveContent, resolveLocalPlaybook, resolvePayloadForUser, resolvePayloadForUserWithProvider, resolvePersistentStorage, resolveSessionStorage, resolveTokens, schemaDeprecation, schemaFacets, scopesSubsetOfRole, searchAgentCatalog, segmentPaths, settingsPaths, tenantPaths, toCreateSchema, toWritableSchema, trialPaths, uiPreferencePaths, unregisterCtaResolver, useAddons, useCan, useEntitlement, useGatedAction, usePlacement, usePlacementPersonalization, usePlans, useResolvedColorScheme, useRevTurbine, useRevTurbineTheme, useRevTurbineThemeProviderPresent, useSurfaceSlot, useTelemetryProps, useTelemetryScope, useTrack, useTrackedAction, useUsageSnapshot, userContextPaths, validateAnalyticsQuery, validateAnalyticsView, validateEventPayload, validatePlacementThresholdWarnings };
+export type { AccessGateCheck, AccessGateSurfaceSlotProps, ActionErrorCategory, ActivityLevel, AdapterBaseOptions, AddOn, AddOnVariation, AgentConnectorSlotProps as AgentConnectorComponentProps, AgentConnectorSlotProps, Alert, AnalysisProvenance, AnalyticsAgentCatalogEntry, AnalyticsAgentCatalogEntryKind, AnalyticsAnalyticalUnit, AnalyticsAnnotation, AnalyticsAnnotationKind, AnalyticsAnnotationMarker, AnalyticsAnnotationRequest, AnalyticsAnnotationResponse, AnalyticsAnnotationSource, AnalyticsBlockError, AnalyticsBlockResult, AnalyticsCardinalityClass, AnalyticsCatalog, AnalyticsCatalogAnnotationKind, AnalyticsCatalogConcept, AnalyticsCatalogData, AnalyticsCatalogDeprecation, AnalyticsCatalogDimension, AnalyticsCatalogMetric, AnalyticsCatalogMetricValidated, AnalyticsCatalogProvenance, AnalyticsCatalogProvenanceKind, AnalyticsCatalogSearchResult, AnalyticsCatalogSource, AnalyticsCatalogView, AnalyticsClassification, AnalyticsCompareDelta, AnalyticsCompareExperiment, AnalyticsCompareMode, AnalyticsCompareSegment, AnalyticsCompileOutput, AnalyticsCompileResolution, AnalyticsCoverage, AnalyticsCustomizationCapability, AnalyticsCustomizationPolicy, AnalyticsDateRangeFilterValue, AnalyticsDimensionCapability, AnalyticsDimensionType, AnalyticsEventHandler, AnalyticsEventProperties, AnalyticsEventTransformer, AnalyticsFieldType, AnalyticsFilterControl, AnalyticsFilterOperator, AnalyticsFilterState, AnalyticsFilterValue, AnalyticsFormatSpec, AnalyticsHistoricalMode, AnalyticsMetricAggregationSemantics, AnalyticsMetricDirection, AnalyticsMetricStatisticalType, AnalyticsPeriodCompareMode, AnalyticsProviderOptions, AnalyticsQueryFamily, AnalyticsQueryOverrides, AnalyticsQueryRequest, AnalyticsQueryResponse, AnalyticsRenderCartesian, AnalyticsRenderFunnel, AnalyticsRenderMetric, AnalyticsRenderRecommendations, AnalyticsRenderSpec, AnalyticsRenderTable, AnalyticsRenderTimeline, AnalyticsResult, AnalyticsResultField, AnalyticsResultMeta, AnalyticsSafeChartOptions, AnalyticsSavedView, AnalyticsSemanticFilter, AnalyticsSemanticId, AnalyticsSourceScope, AnalyticsSuggestedPatchOp, AnalyticsTemplateSummary, AnalyticsTimeGrain, AnalyticsValidationCode, AnalyticsValidationIssue, AnalyticsValidationResult, AnalyticsView, AnalyticsViewAccess, AnalyticsViewAccessRole, AnalyticsViewBlock, AnalyticsViewBlockDraft, AnalyticsViewDraft, AnalyticsViewFilter, AnalyticsViewFilterDraft, AnalyticsViewHandoff, AnalyticsViewHandoffDraft, AnalyticsViewLayout, AnalyticsViewQuery, AnalyticsViewRevision, AnalyticsViewVisibility, AnalyticsWarning, AnyDomainProvider, AssignmentFactUnit, AuditActorType, AuditEvent, AuthAccount, AuthApiKey, AuthInvitation, AuthMember, AuthOrganization, AuthPasskey, AuthSession, AuthSsoProvider, AuthTwoFactor, AuthUser, AuthVerification, BannerSlotProps as BannerComponentProps, BannerFrameProps, BannerSlotProps, BannerSurfaceProps, BasicBucketerExperiment, BasicBucketerOptions, BillingCadence, BillingHealthStatus, BrandingConfig, BrandingResolutionInput, BrandingSource, BrowserRuntimeOptions, ButtonSlotProps as ButtonComponentProps, ButtonSlotProps, ButtonSurfaceProps, CanonicalExperimentAllocation, CapEnforcementResult, CapPeriod, ChangeListener, ChangeLogAction, ChangeLogEntry, CliSlotProps as CliComponentProps, CliSlotProps, ClientContext, CohortMonth, CompactCircularGaugeProps, CompileAnalyticsDraftOptions, ComponentType, CompositeExperimentProviderOptions, ConfigArtifact, ConfigTargetDefaults, ContentPayloadSegmentEntry, ContentPlacementPayload, ContentPromotion, ContentProvider, ContentProviderState, ContentUiPath, ControlPlaneEmitInput, ControlPlaneEventSource, ControlPlaneEventType, ControlPlaneSemanticEvent, CreditBalanceSlotProps as CreditBalanceComponentProps, CreditBalanceSlotProps, CtaActionType, CtaHandler, CtaHandlerMap, CtaHandlerProvider, CtaHandlerProviderState, CtaObject, CtaPath, CtaPathType, CtaResolver, CtaResolverContext, Currency, Customer, CustomerOverride, CustomerOverrideDuration, CustomerOverrideStatus, CustomerOverrideType, DataClassificationValue, DecisionEngineOptions, DefaultTemplateIds, DeriveTrialStatusInput, DetectorRequirements, DimensionCategory, DimensionSourceType, DiscountType, DomainProvider, DomainProviderName, DomainProviderResolutionInput, DriftReport, EffectiveUserContextResolution, EligibleAddon, EligiblePlan, EligiblePrice, EmittablePlatformEventName, EnforcementAction, EnforcementMode, EngagementAreaProps, Entitlement, EntitlementCheckResult$1 as EntitlementCheckResult, EntitlementGateOptions, EntitlementGateState, EntitlementGrant$1 as EntitlementGrant, EntitlementGrantSet$1 as EntitlementGrantSet, EntitlementGrantSource, EntitlementGrantStatus, EntitlementProvider, EntitlementProviderState, EntitlementResult, EntitlementRule, EntitlementRulePeriodUnit, EntitlementRuleSnapshot, EntitlementRuleTarget, EntitlementRuleTargetKind$1 as EntitlementRuleTargetKind, EntitlementRuleValidated, EntitlementRuleVariant, EntitlementStatus, EntitlementType, EntitlementUsageEntry, Environment, EnvironmentPromotionRequest, EnvironmentStatus, EvaluateTrialStatusInput, EvaluateTrialStatusResult, EvaluationContext, EventConsumer, EventConsumerProvider, EventConsumerProviderState, EventEnvelope, EventIngestBatch, EventPayloadContract, EventPayloadContractMap, EventPayloadInput, EventPrefixFamily, EventSearchParams, EventSource, EventStability, EventSurface, EventTaxonomy, EventTaxonomyEntry, EvidenceRequirement, Exact, ExactInitOptions, Experiment, ExperimentAnalysisConfig, ExperimentAnalysisDefinition, ExperimentAnalysisResult, ExperimentAnalysisResultRecord, ExperimentAssignmentFact, ExperimentAssignmentFactDeclaration, ExperimentAssignmentFactMetadataCarrier, ExperimentAssignmentProvider, ExperimentAssignmentSource, ExperimentDecisionFindingCode, ExperimentDecisionPolicy, ExperimentDecisionRecord, ExperimentDecisionType, ExperimentEvidence, ExperimentEvidenceSnapshot, ExperimentHealth, ExperimentMetricEvidencePlan, ExperimentMetricResult, ExperimentProvider, ExperimentProviderState, ExperimentStatus, ExperimentType, ExperimentVariant, ExperimentVariantNonAssignmentReason, ExperimentVariantSelection, ExperimentVariantTarget, Playbook as ExportedConfig, ExportedConfigPlacementItem, ExportedConfigProvider, ExportedConfigSegmentsItem, ExportedConfigSegmentsItemPredicatesItem, ExportedConfigUiPathActionType, FeatureFlag, FeatureFlagValue, FeatureGateTriggerPayload, FieldDefinition, FixedSurfaceSlotProps, FlagValueType, FreeTrialRule, FreeTrialSettings, FullPageSlotProps as FullPageComponentProps, FullPageSlotProps, FunnelStep, AccessGateSurfaceSlotProps as GateProps, GatedAction, GrowthSignalBundle, GrowthSignalPoint, GrowthSignalSeries, IdentifyContextInput, Identity, IdentityDeclaration, InPageSlotProps as InPageComponentProps, InPageSlotProps, InPageSurfaceProps, IngestWriteScope, IngestedEvent, InitFailureDiagnosticProps, InlineCardPlacementProps, InlineEmbedSlotProps as InlineEmbedComponentProps, InlineEmbedSlotProps, InteractionState, InvitationStatus, JsonObject, JsonValue, KpiAggregate, LegacyConfigTargetDefaults, LocalPlacementDataset, LocalPlacementEntry, LocalPlacementPayload, LocalPlacementSurface, LocalizedText, McpConfig, McpTokenScope, Message, MessageBlock, MessageBlockContent, MessageBlockRecord, MessageBlockSnapshot, MessageSurfaceSlotProps, MessageSurfaceSlotRef, MessageTriggerType, MeteringConfig, ModalSlotProps as ModalComponentProps, ModalFrameProps, ModalLayout, ModalSlotProps, ModalSurfaceProps, NativeExperimentAssignmentOptions, NativeExperimentAssignmentUnit, ObservationMaturity, OnboardingChecklist, OnboardingState, OpportunityCandidate, OpportunityEvidence, OpportunityInterpretation, OptimizationSuggestion, OrgMemberRole, PaginationParams, PaymentTriggerPayload, Permission, PermissionAction, PermissionResource, PersonalizationContext, PersonalizationToken, PlacementCapPolicy, PlacementCapRule, PlacementCategory, PlacementContentFields, PlacementContentLookupProvider, PlacementControllerOptions, PlacementControllerState, PlacementCustomCode, PlacementDecisionInspectorProps, PlacementDecisionOutput, PlacementEmittedThresholdLookup, PlacementOutput, PlacementPayload, PlacementPayloadSnapshot, PlacementPerformanceRow, PlacementPreviewConfig, PlacementPromotion, PlacementProps, PlacementRendererProps, PlacementSettings, PlacementSettingsCapRule, PlacementSettingsCapRuleGroupItem, PlacementSettingsCapState, PlacementSlotProps, PlacementSlotType, PlacementTestMode, PlacementTestUser, PlacementTestUserIdentifierType, PlacementUiPath, PlacementUiPathActionType, PlacementWarning, PlacementWarningCode, Plan, PlanProvider, PlanProviderState, PlanRuleSnapshot, PlanVariation, PlanVisibility, PlatformEventName, Playbook, PlaybookBody, PlaybookHeader, PlaybookObject, PlaybookStrict, PlaybookVersion, PlaybookVersionDeployResult, PlaybookVersionDiff, PlaybookVersionEntrySummary, PlaybookVersionStatus, PostHogAnalyticsProviderOptions, PostHogIntegrationOptions, PostHogLike, PresentationCapState, PresentationOutcome, PriceSource, PricingModel, Promotion, PromotionStatus, ProviderAvailability, ProviderBindingRef, ProviderCapability, ProviderConnection, ProviderProvenance, QuotaMeterSlotProps as QuotaMeterComponentProps, QuotaMeterFrameProps, QuotaMeterSlotProps, SurfaceSlotComponentProps as RTSlotProps, RegisterPlacementSlotTypeOptions, ResolvedBranding, ResolvedContent, ResolvedDomainType, ResolvedPayload, ResolvedProviderContext, RevTurbineApiClient, RevTurbineApiClientConfig, paths as RevTurbineApiPaths, RevTurbineAuthoredSlotRef, RevTurbineBootstrapDecisionInput, RevTurbineChainedPlacementRequestOptions, RevTurbineClientSessionProvider, RevTurbineColorScheme, RevTurbineComponentType, Playbook as RevTurbineConfig, RevTurbineConfigAddonVariationsItem, RevTurbineConfigAddonsItem, RevTurbineConfigEnforcementDefaultsItem, RevTurbineConfigEntitlementRulesItem, RevTurbineConfigEntitlementsItem, RevTurbineConfigMeterBindingsItem, RevTurbineConfigPeriodCap, RevTurbineConfigPersonalizationTokensItem, RevTurbineConfigPlacementCategory, RevTurbineConfigPlacementItem, RevTurbineConfigPlacementPayloadItem, RevTurbineConfigPlacementSettingsItem, RevTurbineConfigPlacementSlotsItem, RevTurbineConfigPlacementTrigger, RevTurbineConfigPlanVariationsItem, RevTurbineConfigPlansItem, RevTurbineConfigProvider, RevTurbineConfigSeatTypesItem, RevTurbineConfigSegmentDimensionsItem, RevTurbineConfigSegmentsItem, RevTurbineConfigSegmentsItemPredicatesItem, RevTurbineConfigSlotConfigsItem, RevTurbineConfigStudioCtaConfig, RevTurbineConfigStudioPayload, RevTurbineConfigStudioPayloadCaps, RevTurbineConfigStudioPayloadSurface, RevTurbineConfigStudioPayloadTarget, RevTurbineConfigSurfaceTemplatesItem, RevTurbineConfigSurfaceTemplatesItemFieldsItem, RevTurbineConfigUiPathActionType, RevTurbineContextMode, RevTurbineContextPolicy, RevTurbineDecisionContent, RevTurbineEndpointOverrides, RevTurbineEntitlementContext, RevTurbineEntitlementPlacementRequestOptions, RevTurbineEntitlementRuleEvaluation, RevTurbineEventBatchingOptions, RevTurbineEventEnvelope, RevTurbineEventOptions, RevTurbineGateResult, RevTurbineImpressionMetadata, RevTurbineInitBaseOptions, RevTurbineInitInputOptions, RevTurbineInitOptions, RevTurbineInitOptionsStrict, RevTurbineInitPhase, RevTurbineInitStatus, RevTurbineInitWithProviderOptions, RevTurbineLocalOnlyMinimalInitOptions, RevTurbineLocalRuntimeData, RevTurbineLocalRuntimeOptions, RevTurbineLocalRuntimeResolvers, RevTurbineMeterUsageOverride, RevTurbinePageContext, RevTurbinePersonalizationTokens, RevTurbinePlacementBehaviorFlags, RevTurbinePlacementConfig, RevTurbinePlacementContent, RevTurbinePlacementDecision, RevTurbinePlacementDecisionExplanation, RevTurbinePlacementDecisionInput, RevTurbinePlacementDecisionOverrides, RevTurbinePlacementPayloadEvaluation, RevTurbinePlacementRecord, RevTurbinePlacementRequestConfig, RevTurbinePlacementRuleEvaluation, RevTurbinePlacementTypeEntity, RevTurbinePolicySnapshot, RevTurbineProviderFactory, RevTurbineProviderFailureSlotBehavior, RevTurbineProviderProps, RevTurbineRegisteredSlot, RevTurbineRequiredUiPathResolvers, RevTurbineRuntimeMode, RevTurbineSdkMode, RevTurbineSdkProvider, RevTurbineSegmentEvaluation, RevTurbineSegmentPredicateEvaluation, RevTurbineSemanticEvent, RevTurbineServerOptions, RevTurbineSlotInventoryDiagnosis, RevTurbineSlotPlacementRequestOptions, RevTurbineStorage, RevTurbineSurfaceSlotConfig, RevTurbineSurfaceType, RevTurbineTargeting, RevTurbineTelemetryOptions, RevTurbineTheme, RevTurbineThemeColors, RevTurbineThemeInput, RevTurbineThemeShadows, RevTurbineThemeShape, RevTurbineThemeTypography, RevTurbineTreatmentInteractionInput, RevTurbineTreatmentInteractionOptions, RevTurbineTreatmentInteractionType, RevTurbineTrialContext, RevTurbineTriggerEvent, RevTurbineTriggerPayload, RevTurbineUiPathActionTypes, RevTurbineUiPathResolver, RevTurbineUiPathResolverMap, RevTurbineUiPathResolverValidationIssue, RevTurbineUiPathResolverValidationOptions, RevTurbineUiPathResolverValidationReport, RevTurbineUpdateInput, RevTurbineUsageSnapshot, RevTurbineUsageSnapshotEntry, RevTurbineUserContext, RevenueMetric, ReverseTrialRule, ReverseTrialSettings, ReverseTrialStartPolicy, Role, RuleProvider, RuleProviderState, RuleVisibility, RuntimePromotionSnapshot, SchemaDeprecation, SchemaFacetOptions, SchemaFacets, SdkConfigShape, SdkEventProperties, SdkMetaEvent, SdkMetaEventType, SdkMetaIngestBatch, SdkMetadata, SdkSessionOptions, SdkTraits, SeatType, Segment, SegmentDimension, SegmentProvider, SegmentProviderState, SegmentValue, SemanticEvent, ServerActionContext, ServerActionHandler, ServerActionMap, ServerActionResult, ServerEntitlementResult, ServerEvaluationHydrationPayload, ServerEvaluationPayload, ServerEvaluationPayloadDecisionsItem, ServerEvaluationPayloadEntitlementsValue, ServerEvaluationPayloadTrialStatus, ServerEvaluationPayloadUser, ServerEvaluationPayloadUserContext, ServerEvaluationRequest, ServerPlacementDecision, ServerPlacementRequest, ServerUserContext, ServerUserContextSnapshot, Severity, SurfaceSlotComponentProps as SlotProps, StaticPlacementResolverOptions, StripeIntegrationConfig, StripePrice, StripePriceBillingPeriod, StripePriceMock, StripePriceMockBillingPeriod, StudioSurfaceType, SuggestionSeverity, SupersessionReason, SupersessionRecord, SuppressionResult, SurfaceSlot, SurfaceSlotCategory, SurfaceSlotComponentProps, SurfaceTemplate, SurfaceType, SurfaceTypeCapRule, TelemetryConsent, TelemetryScopeProps, TelemetryScopeValue, TemplateFieldType, Tenant, TenantConfig, TenantStatus, Theme, ThemeLoaderOptions, ThemeProvider, ThemeProviderState, ToastSlotProps as ToastComponentProps, ToastSlotProps, ToastSurfaceProps, TooltipSlotProps as TooltipComponentProps, TooltipSlotProps, TrackEvent, TrackFn, TrackIngestBatch, TrackOnViewProps, TrackOptions, TrackProps, TrackPurpose, TrackedAction, Trait, TraitsNamespace, TraitsProvider, TraitsProviderState, TreatmentInteractionBatch, TreatmentInteractionInput, TreatmentInteractionRequest, TreatmentInteractionType, TrendFeatures, TrialEligibilityScope, TrialInstance, TrialLimitPolicy, TrialStatus, TrialStatusProvider, TrialStatusTraits, TrialTriggerPayload, TriggerEventType, UiPreference, UnvalidatedConfigArtifact, UsageAllocation, UsageBalances, UsageEnforcementSettings, UsagePeriodScope, UsageTraits, UsageTraitsProvider, UsageTriggerPayload, UseAddonsResult, UseCanResult, UseEntitlementOptions, UseEntitlementResult, UsePlacementOptions, UsePlacementPersonalizationOptions, UsePlacementResult, UsePlansResult, UseSurfaceSlotOptions, UseSurfaceSlotResult, UseUsageSnapshotResult, UserContext, UserContextInput, UserInstanceContext, UserPlanContext, UserProfileProps, UserRole, UserTargetingContext, UserTrialStatus, UserUsageEntry, ValidateAnalyticsViewOptions, VariantStatisticalSummary, WarGameCapabilityRequirements, WarGameCategory, WarGameGrade, WarGameOracle, WarGameQualificationLevel, WarGameScenario, WebhookEventLog, WebhookEventSource, WebhookEventStatus };