@epilot/entity-client 7.4.0 → 7.5.2

package/dist/openapi.d.ts

@@ -397,8 +397,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -632,8 +636,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -897,8 +905,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -1164,8 +1176,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -1496,8 +1512,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -1808,8 +1828,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -2005,13 +2029,13 @@ declare namespace Components {
         }
         /**
          * One dimension that conditional variants of an entity type are keyed by. `type`
-         * discriminates the variants: only a `select` condition carries `values`, and only a
+         * discriminates the variants: only a `select` condition carries `options`, and only a
          * `location` condition carries `format`.
          *
          */
         export type ConditionDefinition = /**
          * One dimension that conditional variants of an entity type are keyed by. `type`
-         * discriminates the variants: only a `select` condition carries `values`, and only a
+         * discriminates the variants: only a `select` condition carries `options`, and only a
          * `location` condition carries `format`.
          *
          */
@@ -2049,8 +2073,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -2260,8 +2288,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -2469,8 +2501,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -2688,8 +2724,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -2978,8 +3018,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -3311,14 +3355,23 @@ declare namespace Components {
             title?: string;
             attributes?: Attribute[];
             /**
-             * Allow conditional variants of the entity to override the values managed by this
-             * capability. Only meaningful on schemas that declare `conditions` and on capabilities
-             * that render an attribute group (`EntityAttributes:Group` ui hook), e.g. pricing tiers.
-             * Attributes carried by the capability opt in individually via their own
-             * `variant_overridable` flag.
+             * Allow conditional variants to override the fields this capability manages. Only
+             * meaningful on schemas that declare `conditions`, and requires `managed_fields`: the
+             * flag covers exactly what that lists, not the capability's name.
+             *
+             */
+            overridable_attribute?: boolean;
+            /**
+             * Every entity field this capability writes, including one named after the capability
+             * itself. With `overridable_attribute`, this is the definitive list of what a variant
+             * may override through the capability, applied as a single patch.
+             *
+             * Fields, not attributes: a capability may write entity fields that have no attribute
+             * definition, so entries need not resolve to one. Where an entry does resolve to an
+             * attribute, `hidden` and `computed` do not disqualify it.
              *
              */
-            variant_overridable?: boolean;
+            managed_fields?: string /* ^[a-z0-9_]+$ */[];
             _purpose?: /**
              * example:
              * taxonomy-slug:classification-slug
@@ -3491,14 +3544,23 @@ declare namespace Components {
             title?: string;
             attributes?: Attribute[];
             /**
-             * Allow conditional variants of the entity to override the values managed by this
-             * capability. Only meaningful on schemas that declare `conditions` and on capabilities
-             * that render an attribute group (`EntityAttributes:Group` ui hook), e.g. pricing tiers.
-             * Attributes carried by the capability opt in individually via their own
-             * `variant_overridable` flag.
+             * Allow conditional variants to override the fields this capability manages. Only
+             * meaningful on schemas that declare `conditions`, and requires `managed_fields`: the
+             * flag covers exactly what that lists, not the capability's name.
+             *
+             */
+            overridable_attribute?: boolean;
+            /**
+             * Every entity field this capability writes, including one named after the capability
+             * itself. With `overridable_attribute`, this is the definitive list of what a variant
+             * may override through the capability, applied as a single patch.
+             *
+             * Fields, not attributes: a capability may write entity fields that have no attribute
+             * definition, so entries need not resolve to one. Where an entry does resolve to an
+             * attribute, `hidden` and `computed` do not disqualify it.
              *
              */
-            variant_overridable?: boolean;
+            managed_fields?: string /* ^[a-z0-9_]+$ */[];
             _purpose?: /**
              * example:
              * taxonomy-slug:classification-slug
@@ -4660,6 +4722,83 @@ declare namespace Components {
                 widget_widths?: {
                     [name: string]: "one_third_width" | "half_width" | "two_third_width" | "full_width";
                 };
+                /**
+                 * Configured tabs that host widgets, shown alongside capability tabs in entity details. Interleaves with capability `EntityDetailsV2:Tab` ui_hooks on a shared `order`: the host merges both lists and sorts by `order`, with capability tabs winning ties. Unlike the header grid, a tab's `widgets` list is the entire membership — a widget's ui_hook `default_visible` is never consulted for tab placement.
+                 * example:
+                 * [
+                 *   {
+                 *     "id": "8f14e45f-ceea-467e-a0d6-c8a4ea1c9e6d",
+                 *     "slug": "sales-overview",
+                 *     "title": "Sales Overview",
+                 *     "order": 10,
+                 *     "type": "widgets",
+                 *     "widgets": [
+                 *       {
+                 *         "id": "next_best_action",
+                 *         "width": "full_width"
+                 *       },
+                 *       {
+                 *         "id": "recent_communications",
+                 *         "width": "one_third_width"
+                 *       }
+                 *     ]
+                 *   }
+                 * ]
+                 */
+                custom_tabs?: {
+                    [name: string]: any;
+                    /**
+                     * Generated when the tab is created and never edited afterward, so a blueprint-authored tab and a customer-authored tab can never collide and identity survives a rename.
+                     * example:
+                     * 8f14e45f-ceea-467e-a0d6-c8a4ea1c9e6d
+                     */
+                    id: string;
+                    /**
+                     * URL route segment for the tab, derived from `title`. Unique within the schema, and against capability tab ids, since both share one route-segment namespace.
+                     * example:
+                     * sales-overview
+                     */
+                    slug: string;
+                    /**
+                     * Tab label, authored by the configuring user.
+                     * example:
+                     * Sales Overview
+                     */
+                    title: string;
+                    /**
+                     * Authoritative render position; array position carries no meaning. Shares one ordering space with capability tab ui_hook `order` — at equal `order`, capability tabs sort first.
+                     * example:
+                     * 10
+                     */
+                    order: number;
+                    /**
+                     * Icon name from the existing entity icon set.
+                     * example:
+                     * person
+                     */
+                    icon?: string;
+                    /**
+                     * Discriminator for the tab's payload. Currently `widgets`, carried by the `widgets` property below; a future tab kind adds its own payload property rather than reusing this one. Deliberately not an enum, so a type introduced by a newer host still round-trips through an older one instead of failing validation.
+                     * example:
+                     * widgets
+                     */
+                    type: string;
+                    /**
+                     * Payload for `type: widgets`. Membership in this list IS the tab's widget set, in render order — there is no separate visibility map, and a widget's ui_hook `default_visible` is not consulted.
+                     */
+                    widgets?: {
+                        /**
+                         * Widget id — a capability widget's `component`, or `summary` for the synthesized summary card.
+                         * example:
+                         * next_best_action
+                         */
+                        id: string;
+                        /**
+                         * Width for this widget within the tab's grid. Falls back the same way as the header's `widget_widths` when omitted: widget's ui_hook `default_width`, then `full_width`.
+                         */
+                        width?: "one_third_width" | "half_width" | "two_third_width" | "full_width";
+                    }[];
+                }[];
             };
             capabilities: /* Capabilities the Entity has. Turn features on/off for entities. */ EntityCapability[];
             /**
@@ -4775,12 +4914,12 @@ declare namespace Components {
              * Dimensions that conditional variants of this entity type are keyed by.
              *
              * Absent or `null` means entities of this type are not conditional. Attributes whose
-             * values a variant may override are marked with `variant_overridable`.
+             * values a variant may override are marked with `overridable_attribute`.
              *
              */
             conditions?: /**
              * One dimension that conditional variants of an entity type are keyed by. `type`
-             * discriminates the variants: only a `select` condition carries `values`, and only a
+             * discriminates the variants: only a `select` condition carries `options`, and only a
              * `location` condition carries `format`.
              *
              */
@@ -4929,11 +5068,13 @@ declare namespace Components {
                 type?: string;
             };
             /**
-             * Indicates this schema is currently frozen. Present when the returned version is the frozen version.
+             * No longer returned: schema freezing is retired.
+             *
              */
             frozen?: boolean;
             /**
-             * Indicates this is the latest version of the schema. Both frozen and latest can be true if no changes were made since freezing.
+             * No longer returned: every read returns the latest version.
+             *
              */
             latest?: boolean;
             /**
@@ -5113,6 +5254,83 @@ declare namespace Components {
                 widget_widths?: {
                     [name: string]: "one_third_width" | "half_width" | "two_third_width" | "full_width";
                 };
+                /**
+                 * Configured tabs that host widgets, shown alongside capability tabs in entity details. Interleaves with capability `EntityDetailsV2:Tab` ui_hooks on a shared `order`: the host merges both lists and sorts by `order`, with capability tabs winning ties. Unlike the header grid, a tab's `widgets` list is the entire membership — a widget's ui_hook `default_visible` is never consulted for tab placement.
+                 * example:
+                 * [
+                 *   {
+                 *     "id": "8f14e45f-ceea-467e-a0d6-c8a4ea1c9e6d",
+                 *     "slug": "sales-overview",
+                 *     "title": "Sales Overview",
+                 *     "order": 10,
+                 *     "type": "widgets",
+                 *     "widgets": [
+                 *       {
+                 *         "id": "next_best_action",
+                 *         "width": "full_width"
+                 *       },
+                 *       {
+                 *         "id": "recent_communications",
+                 *         "width": "one_third_width"
+                 *       }
+                 *     ]
+                 *   }
+                 * ]
+                 */
+                custom_tabs?: {
+                    [name: string]: any;
+                    /**
+                     * Generated when the tab is created and never edited afterward, so a blueprint-authored tab and a customer-authored tab can never collide and identity survives a rename.
+                     * example:
+                     * 8f14e45f-ceea-467e-a0d6-c8a4ea1c9e6d
+                     */
+                    id: string;
+                    /**
+                     * URL route segment for the tab, derived from `title`. Unique within the schema, and against capability tab ids, since both share one route-segment namespace.
+                     * example:
+                     * sales-overview
+                     */
+                    slug: string;
+                    /**
+                     * Tab label, authored by the configuring user.
+                     * example:
+                     * Sales Overview
+                     */
+                    title: string;
+                    /**
+                     * Authoritative render position; array position carries no meaning. Shares one ordering space with capability tab ui_hook `order` — at equal `order`, capability tabs sort first.
+                     * example:
+                     * 10
+                     */
+                    order: number;
+                    /**
+                     * Icon name from the existing entity icon set.
+                     * example:
+                     * person
+                     */
+                    icon?: string;
+                    /**
+                     * Discriminator for the tab's payload. Currently `widgets`, carried by the `widgets` property below; a future tab kind adds its own payload property rather than reusing this one. Deliberately not an enum, so a type introduced by a newer host still round-trips through an older one instead of failing validation.
+                     * example:
+                     * widgets
+                     */
+                    type: string;
+                    /**
+                     * Payload for `type: widgets`. Membership in this list IS the tab's widget set, in render order — there is no separate visibility map, and a widget's ui_hook `default_visible` is not consulted.
+                     */
+                    widgets?: {
+                        /**
+                         * Widget id — a capability widget's `component`, or `summary` for the synthesized summary card.
+                         * example:
+                         * next_best_action
+                         */
+                        id: string;
+                        /**
+                         * Width for this widget within the tab's grid. Falls back the same way as the header's `widget_widths` when omitted: widget's ui_hook `default_width`, then `full_width`.
+                         */
+                        width?: "one_third_width" | "half_width" | "two_third_width" | "full_width";
+                    }[];
+                }[];
             };
             capabilities: /* Capabilities the Entity has. Turn features on/off for entities. */ EntityCapability[];
             /**
@@ -5228,12 +5446,12 @@ declare namespace Components {
              * Dimensions that conditional variants of this entity type are keyed by.
              *
              * Absent or `null` means entities of this type are not conditional. Attributes whose
-             * values a variant may override are marked with `variant_overridable`.
+             * values a variant may override are marked with `overridable_attribute`.
              *
              */
             conditions?: /**
              * One dimension that conditional variants of an entity type are keyed by. `type`
-             * discriminates the variants: only a `select` condition carries `values`, and only a
+             * discriminates the variants: only a `select` condition carries `options`, and only a
              * `location` condition carries `format`.
              *
              */
@@ -5787,8 +6005,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -6709,8 +6931,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -6918,8 +7144,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -7127,8 +7357,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -7344,8 +7578,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -7608,8 +7846,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -7904,8 +8146,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -8224,8 +8470,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -8442,8 +8692,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -8651,8 +8905,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -8860,8 +9118,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -9069,8 +9331,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -9278,8 +9544,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -9487,8 +9757,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -9696,8 +9970,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -9905,8 +10183,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -10114,8 +10396,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -10338,8 +10624,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -10773,8 +11063,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -11436,8 +11730,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -11652,14 +11950,23 @@ declare namespace Components {
              */
             type: "select";
             /**
-             * Selectable options. May be empty while the condition is being configured.
+             * Selectable options, in the same shape a `select` attribute's `options` take: a bare
+             * value or a `{ value, title }` object. May be empty while the condition is being
+             * configured.
+             *
              * example:
              * [
              *   "12_months",
-             *   "24_months"
+             *   {
+             *     "value": "24_months",
+             *     "title": "24 months"
+             *   }
              * ]
              */
-            values?: string[];
+            options?: (string | {
+                value: string;
+                title?: string;
+            })[];
         }
         /**
          * Sequence of unique identifiers
@@ -11694,8 +12001,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -11920,8 +12231,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -12225,8 +12540,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -12490,8 +12809,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -12901,8 +13224,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -13123,8 +13450,12 @@ declare namespace Components {
              * Only meaningful on schemas that declare `conditions`. Unflagged attributes stay
              * fixed on the base entity.
              *
+             * Accepted on scalar attributes and on relations — a variant overrides a relation by
+             * replacing its whole `$relation` list (e.g. a product's prices). Rejected on system
+             * (`_`-prefixed), `readonly`, `hidden`, `computed` and `repeatable` attributes.
+             *
              */
-            variant_overridable?: boolean;
+            overridable_attribute?: boolean;
             default_value?: any;
             /**
              * Which group the attribute should appear in. Accepts group ID or group name
@@ -13502,6 +13833,7 @@ declare namespace Paths {
              * _tags
              */
             export type Attribute = string;
+            export type From = number;
             export type Input = string;
             export type Size = number;
             export type Slug = /**
@@ -13521,10 +13853,14 @@ declare namespace Paths {
             Parameters.Attribute;
             slug?: Parameters.Slug;
             size?: Parameters.Size;
+            from?: Parameters.From;
         }
         namespace Responses {
             export interface $200 {
                 /**
+                 * Number of distinct values matching the input. Exact (independent of `size`, capped at 1000) for
+                 * `_tags`; for other attributes the number of distinct values collected so far, which may grow with `size`.
+                 *
                  * example:
                  * 1
                  */
@@ -15521,7 +15857,8 @@ declare namespace Paths {
                  */
                 drafts_more?: boolean;
                 /**
-                 * The version ID that is currently frozen, if any
+                 * No longer returned: schema freezing is retired.
+                 *
                  */
                 frozen_version?: string; // uuid
             }
@@ -15575,7 +15912,7 @@ declare namespace Paths {
             /**
              * ISO 8601 timestamp to filter jobs created after this time (e.g., 2023-01-01T00:00:00Z).
              * example:
-             * 2023-01-01T00:00:00.000Z
+             * 2023-01-01T00:00:00Z
              */
             export type CreatedAfter = string; // date-time
             /**
@@ -15601,7 +15938,7 @@ declare namespace Paths {
             created_after?: /**
              * ISO 8601 timestamp to filter jobs created after this time (e.g., 2023-01-01T00:00:00Z).
              * example:
-             * 2023-01-01T00:00:00.000Z
+             * 2023-01-01T00:00:00Z
              */
             Parameters.CreatedAfter /* date-time */;
             sort_pending_first?: /* When true, sorts PENDING status jobs to the top of the results. */ Parameters.SortPendingFirst;
@@ -17088,8 +17425,7 @@ export interface OperationMethods {
   /**
    * getSchema - getSchema
    * 
-   * By default gets the current version of the Schema (frozen version if frozen, otherwise latest).
-   * Pass ?latest=true to get the latest version when the schema is frozen.
+   * Gets the latest version of the Schema.
    * Pass ?id= to get a specific version by ID.
    * 
    */
@@ -17102,7 +17438,6 @@ export interface OperationMethods {
    * putSchema - putSchema
    * 
    * Create or update a schema with a new version.
-   * When the schema is frozen, writes update the latest version without affecting the frozen version.
    * 
    */
   'putSchema'(
@@ -17153,9 +17488,8 @@ export interface OperationMethods {
   /**
    * freezeSchema - freezeSchema
    * 
-   * Freeze a schema at its current version, or at a specific version.
-   * When frozen, getSchema returns the frozen version by default.
-   * New edits via putSchema update the latest version without affecting the frozen version.
+   * Deprecated no-op: schema freezing is retired and every read returns the latest version.
+   * Returns the latest version of the schema unchanged. This endpoint will be removed.
    * 
    */
   'freezeSchema'(
@@ -17166,7 +17500,9 @@ export interface OperationMethods {
   /**
    * unfreezeSchema - unfreezeSchema
    * 
-   * Unfreeze a schema. Promotes the latest version to the current version for all users.
+   * Deprecated: schema freezing is retired. Cleans up a leftover frozen pointer by promoting the
+   * latest version to the current version, and succeeds when there is nothing to clean up.
+   * This endpoint will be removed.
    * 
    */
   'unfreezeSchema'(
@@ -17577,7 +17913,20 @@ export interface OperationMethods {
   /**
    * autocomplete - autocomplete
    * 
-   * Autocomplete entity attributes
+   * Autocomplete entity attributes.
+   * 
+   * Suggestions are derived from the values **currently stored on entities** the caller is allowed to read.
+   * A value only shows up while at least one entity carries it, so this endpoint reflects usage, not
+   * configuration.
+   * 
+   * To enumerate the label catalogue managed in the Label Builder (including labels that are not
+   * assigned to any entity yet, and excluding archived ones), use the Taxonomy endpoints instead:
+   * `POST /v1/entity/taxonomies/classifications:search` (`taxonomiesClassificationsSearch`) or
+   * `GET /v1/entity/taxonomies/{taxonomySlug}:autocomplete` (`taxonomyAutocomplete`).
+   * 
+   * For `attribute=_tags` the distinct values are aggregated across all matching entities, `hits` is the exact
+   * number of distinct values (capped at 1000) and results are ordered by usage. For other attributes the
+   * 1000 most recently updated entities are scanned and `hits` is the number of distinct values found so far.
    * 
    */
   'autocomplete'(
@@ -18289,8 +18638,7 @@ export interface PathsDictionary {
     /**
      * getSchema - getSchema
      * 
-     * By default gets the current version of the Schema (frozen version if frozen, otherwise latest).
-     * Pass ?latest=true to get the latest version when the schema is frozen.
+     * Gets the latest version of the Schema.
      * Pass ?id= to get a specific version by ID.
      * 
      */
@@ -18303,7 +18651,6 @@ export interface PathsDictionary {
      * putSchema - putSchema
      * 
      * Create or update a schema with a new version.
-     * When the schema is frozen, writes update the latest version without affecting the frozen version.
      * 
      */
     'put'(
@@ -18362,9 +18709,8 @@ export interface PathsDictionary {
     /**
      * freezeSchema - freezeSchema
      * 
-     * Freeze a schema at its current version, or at a specific version.
-     * When frozen, getSchema returns the frozen version by default.
-     * New edits via putSchema update the latest version without affecting the frozen version.
+     * Deprecated no-op: schema freezing is retired and every read returns the latest version.
+     * Returns the latest version of the schema unchanged. This endpoint will be removed.
      * 
      */
     'post'(
@@ -18377,7 +18723,9 @@ export interface PathsDictionary {
     /**
      * unfreezeSchema - unfreezeSchema
      * 
-     * Unfreeze a schema. Promotes the latest version to the current version for all users.
+     * Deprecated: schema freezing is retired. Cleans up a leftover frozen pointer by promoting the
+     * latest version to the current version, and succeeds when there is nothing to clean up.
+     * This endpoint will be removed.
      * 
      */
     'post'(
@@ -18816,7 +19164,20 @@ export interface PathsDictionary {
     /**
      * autocomplete - autocomplete
      * 
-     * Autocomplete entity attributes
+     * Autocomplete entity attributes.
+     * 
+     * Suggestions are derived from the values **currently stored on entities** the caller is allowed to read.
+     * A value only shows up while at least one entity carries it, so this endpoint reflects usage, not
+     * configuration.
+     * 
+     * To enumerate the label catalogue managed in the Label Builder (including labels that are not
+     * assigned to any entity yet, and excluding archived ones), use the Taxonomy endpoints instead:
+     * `POST /v1/entity/taxonomies/classifications:search` (`taxonomiesClassificationsSearch`) or
+     * `GET /v1/entity/taxonomies/{taxonomySlug}:autocomplete` (`taxonomyAutocomplete`).
+     * 
+     * For `attribute=_tags` the distinct values are aggregated across all matching entities, `hits` is the exact
+     * number of distinct values (capped at 1000) and results are ordered by usage. For other attributes the
+     * 1000 most recently updated entities are scanned and `hits` is the number of distinct values found so far.
      * 
      */
     'get'(