@epilot/sdk 2.4.4 → 2.6.0

package/dist/{entity.d-BHR9dEon.d.cts → entity.d-fospShiN.d.cts}

@@ -513,10 +513,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -733,10 +731,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -970,10 +966,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -1222,10 +1216,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -1344,8 +1336,12 @@ declare namespace Components {
             _manifest?: string /* uuid */[] | null;
             /**
              * Pending attribute changesets for attributes configured with external or approval edit mode.
-             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+             * and is what `:apply` / `:dismiss` operate on.
+             *
+             * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+             * from request bodies. Use the changeset management endpoints to mutate this field.
              *
              */
             _changesets?: {
@@ -1510,10 +1506,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -1817,10 +1811,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -2020,10 +2012,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -2216,10 +2206,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -2410,10 +2398,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -2614,10 +2600,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -2690,6 +2674,19 @@ declare namespace Components {
              */
             cluster?: string;
         }
+        /**
+         * Controls whether a write goes through immediately or is held as a pending entry
+         * on the parent entity's `_changesets` map.
+         *
+         * - `direct`: write applied immediately. No changeset created.
+         * - `external`: write held as a pending changeset; auto-cleared on a matching direct/ERP write.
+         * - `approval`: write held as a pending changeset; requires explicit human apply/dismiss.
+         *
+         * Used at two levels: per-attribute (entity-attribute changesets) and per-capability
+         * (currently the `meter_readings` capability on the Meter schema, gating reading submissions).
+         *
+         */
+        export type EditMode = "direct" | "external" | "approval";
         /**
          * Configuration for `edit_mode: external` auto-clear matching.
          * Fields here (`match_strategy`, `fuzzy_config`) only take effect when
@@ -2876,10 +2873,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -2999,8 +2994,12 @@ declare namespace Components {
             _manifest?: string /* uuid */[] | null;
             /**
              * Pending attribute changesets for attributes configured with external or approval edit mode.
-             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+             * and is what `:apply` / `:dismiss` operate on.
+             *
+             * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+             * from request bodies. Use the changeset management endpoints to mutate this field.
              *
              */
             _changesets?: {
@@ -3503,8 +3502,12 @@ declare namespace Components {
             _manifest?: string /* uuid */[] | null;
             /**
              * Pending attribute changesets for attributes configured with external or approval edit mode.
-             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+             * and is what `:apply` / `:dismiss` operate on.
+             *
+             * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+             * from request bodies. Use the changeset management endpoints to mutate this field.
              *
              */
             _changesets?: {
@@ -3794,8 +3797,12 @@ declare namespace Components {
                 _manifest?: string /* uuid */[] | null;
                 /**
                  * Pending attribute changesets for attributes configured with external or approval edit mode.
-                 * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-                 * Use the changeset management endpoints to apply or dismiss changesets.
+                 *
+                 * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+                 * and is what `:apply` / `:dismiss` operate on.
+                 *
+                 * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+                 * from request bodies. Use the changeset management endpoints to mutate this field.
                  *
                  */
                 _changesets?: {
@@ -3887,8 +3894,12 @@ declare namespace Components {
                     _manifest?: string /* uuid */[] | null;
                     /**
                      * Pending attribute changesets for attributes configured with external or approval edit mode.
-                     * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-                     * Use the changeset management endpoints to apply or dismiss changesets.
+                     *
+                     * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+                     * and is what `:apply` / `:dismiss` operate on.
+                     *
+                     * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+                     * from request bodies. Use the changeset management endpoints to mutate this field.
                      *
                      */
                     _changesets?: {
@@ -3979,8 +3990,12 @@ declare namespace Components {
                     _manifest?: string /* uuid */[] | null;
                     /**
                      * Pending attribute changesets for attributes configured with external or approval edit mode.
-                     * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-                     * Use the changeset management endpoints to apply or dismiss changesets.
+                     *
+                     * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+                     * and is what `:apply` / `:dismiss` operate on.
+                     *
+                     * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+                     * from request bodies. Use the changeset management endpoints to mutate this field.
                      *
                      */
                     _changesets?: {
@@ -4071,8 +4086,12 @@ declare namespace Components {
                     _manifest?: string /* uuid */[] | null;
                     /**
                      * Pending attribute changesets for attributes configured with external or approval edit mode.
-                     * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-                     * Use the changeset management endpoints to apply or dismiss changesets.
+                     *
+                     * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+                     * and is what `:apply` / `:dismiss` operate on.
+                     *
+                     * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+                     * from request bodies. Use the changeset management endpoints to mutate this field.
                      *
                      */
                     _changesets?: {
@@ -5412,10 +5431,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -6122,8 +6139,12 @@ declare namespace Components {
             _manifest?: string /* uuid */[] | null;
             /**
              * Pending attribute changesets for attributes configured with external or approval edit mode.
-             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+             * and is what `:apply` / `:dismiss` operate on.
+             *
+             * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+             * from request bodies. Use the changeset management endpoints to mutate this field.
              *
              */
             _changesets?: {
@@ -6287,10 +6308,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -6481,10 +6500,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -6675,10 +6692,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -6877,10 +6892,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -7090,10 +7103,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -7133,6 +7144,90 @@ declare namespace Components {
             send_status?: string;
             email_type?: string;
         }
+        /**
+         * A meter readings changeset entry — service-managed by metering-api.
+         * Stored on `Meter._meter_readings_changeset` array attribute. Each entry mirrors a
+         * ClickHouse meter reading row plus a changeset metadata overlay.
+         *
+         * Note: `org_id` is NOT stored on the entry. The entries live on the Meter entity,
+         * which is already org-scoped (`_org`). Round-tripping it would only invite drift;
+         * downstream consumers receive the org from the meter / handler context.
+         *
+         */
+        export interface MeterReadingChangesetEntry {
+            value: number;
+            direction?: "feed-in" | "feed-out";
+            timestamp?: string; // date-time
+            meter_id: string; // uuid
+            counter_id: string; // uuid
+            source?: string;
+            reason?: string;
+            read_by?: string;
+            status?: "valid" | "in-validation" | "implausible";
+            external_id?: string;
+            remark?: string;
+            metadata?: {
+                [name: string]: string;
+            };
+            /**
+             * Unique changeset identifier (UUID v4).
+             */
+            changeset_id: string;
+            edit_mode: "external" | "approval";
+            match_strategy?: "exact" | "fuzzy";
+            /**
+             * Slack on `reading.timestamp` when metering-api auto-clear matches an
+             * incoming reading against this pending changeset.
+             *
+             * Variants:
+             * - `'exact'`: strict millisecond equality.
+             * - `{ type: 'same-day', timezone? }`: strip the time component and
+             *   compare year-month-day. Optional `timezone` is an IANA name
+             *   (e.g. `'Europe/Berlin'`); the day is bucketed in that zone.
+             *   Defaults to UTC when omitted.
+             * - `{ type: 'within-seconds', seconds }`: symmetric ±N-second window.
+             *
+             */
+            timestamp_tolerance?: /**
+             * Slack on `reading.timestamp` when metering-api auto-clear matches an
+             * incoming reading against this pending changeset.
+             *
+             * Variants:
+             * - `'exact'`: strict millisecond equality.
+             * - `{ type: 'same-day', timezone? }`: strip the time component and
+             *   compare year-month-day. Optional `timezone` is an IANA name
+             *   (e.g. `'Europe/Berlin'`); the day is bucketed in that zone.
+             *   Defaults to UTC when omitted.
+             * - `{ type: 'within-seconds', seconds }`: symmetric ±N-second window.
+             *
+             */
+            ("exact") | {
+                type: "same-day";
+                /**
+                 * IANA timezone identifier (e.g. `'Europe/Berlin'`, `'UTC'`).
+                 * When omitted, the day is bucketed in UTC.
+                 *
+                 */
+                timezone?: string;
+            } | {
+                type: "within-seconds";
+                /**
+                 * Tolerance in seconds. e.g. 60 = ±1 minute, 3600 = ±1 hour.
+                 */
+                seconds: number;
+            };
+            fuzzy_config?: {
+                percentage_threshold?: number;
+                absolute_threshold?: number;
+            };
+            created_at: string; // date-time
+            created_by?: /* Identifies the actor that created the changeset. */ ChangesetCreator;
+            previous?: {
+                value?: number;
+                direction?: "feed-in" | "feed-out";
+                timestamp?: string; // date-time
+            };
+        }
         /**
          * Multi Choice Selection
          */
@@ -7287,10 +7382,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -7426,8 +7519,12 @@ declare namespace Components {
             _manifest?: string /* uuid */[] | null;
             /**
              * Pending attribute changesets for attributes configured with external or approval edit mode.
-             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+             * and is what `:apply` / `:dismiss` operate on.
+             *
+             * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+             * from request bodies. Use the changeset management endpoints to mutate this field.
              *
              */
             _changesets?: {
@@ -7588,10 +7685,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -7791,10 +7886,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -7985,10 +8078,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -8179,10 +8270,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -8373,10 +8462,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -8567,10 +8654,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -8761,10 +8846,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -8955,10 +9038,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -9149,10 +9230,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -9343,10 +9422,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -9552,10 +9629,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval" | "list-view";
@@ -9786,8 +9861,12 @@ declare namespace Components {
             _manifest?: string /* uuid */[] | null;
             /**
              * Pending attribute changesets for attributes configured with external or approval edit mode.
-             * Read-only via normal entity PATCH/PUT operations — cannot be set directly.
-             * Use the changeset management endpoints to apply or dismiss changesets.
+             *
+             * The value shape is `Changeset` (`proposed_value`, `created_at`, `edit_mode`, ...)
+             * and is what `:apply` / `:dismiss` operate on.
+             *
+             * Read-only via normal entity PATCH/PUT operations — those handlers strip `_changesets`
+             * from request bodies. Use the changeset management endpoints to mutate this field.
              *
              */
             _changesets?: {
@@ -9968,10 +10047,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -10566,10 +10643,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -10768,10 +10843,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -10979,10 +11052,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -11269,10 +11340,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -11519,10 +11588,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -11915,10 +11982,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -12122,10 +12187,8 @@ declare namespace Components {
             repeatable?: boolean;
             has_primary?: boolean;
             /**
-             * Controls how updates to this attribute are handled.
-             * - `direct` (default): update is applied immediately. No changeset created.
-             * - `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).
-             * - `approval`: update creates a changeset, requires explicit human approval.
+             * Controls how updates to this attribute are handled. See the `EditMode`
+             * schema for the per-mode semantics. Defaults to `direct`.
              *
              */
             edit_mode?: "direct" | "external" | "approval";
@@ -18366,6 +18429,7 @@ type CurrencyAttribute = Components.Schemas.CurrencyAttribute;
 type DateAttribute = Components.Schemas.DateAttribute;
 type DefaultAddressFields = Components.Schemas.DefaultAddressFields;
 type ESClusterAssignment = Components.Schemas.ESClusterAssignment;
+type EditMode = Components.Schemas.EditMode;
 type EditModeConfig = Components.Schemas.EditModeConfig;
 type EmailAttribute = Components.Schemas.EmailAttribute;
 type Entity = Components.Schemas.Entity;
@@ -18431,6 +18495,7 @@ type LinkAttribute = Components.Schemas.LinkAttribute;
 type ListSavedViewsResults = Components.Schemas.ListSavedViewsResults;
 type MatchStrategy = Components.Schemas.MatchStrategy;
 type MessageEmailAddressAttribute = Components.Schemas.MessageEmailAddressAttribute;
+type MeterReadingChangesetEntry = Components.Schemas.MeterReadingChangesetEntry;
 type MultiSelectAttribute = Components.Schemas.MultiSelectAttribute;
 type NullableEntity = Components.Schemas.NullableEntity;
 type NumberAttribute = Components.Schemas.NumberAttribute;
@@ -18476,4 +18541,4 @@ type TaxonomySlug = Components.Schemas.TaxonomySlug;
 type TextAttribute = Components.Schemas.TextAttribute;
 type UserRelationAttribute = Components.Schemas.UserRelationAttribute;
 
-export { type EntitySchemaItem as $, type Activity as A, type BaseActivityItem as B, type Client as C, type DateAttribute as D, type DefaultAddressFields as E, type ESClusterAssignment as F, type EditModeConfig as G, type EmailAttribute as H, type Entity as I, type EntityAcl as J, type EntityAction as K, type EntityCapability as L, type EntityCapabilityWithCompositeID as M, type EntityDefaultCreate as N, type OperationMethods as O, Paths as P, type EntityDefaultEdit as Q, type EntityDefaultTable as R, type EntityId as S, type EntityImportParams as T, type EntityItem as U, type EntityListParams as V, type EntityOperation as W, type EntityOwner as X, type EntitySchema as Y, type EntitySchemaGroup as Z, type EntitySchemaGroupWithCompositeID as _, Components as a, type SavedViewId as a$, type EntitySearchIncludeDeletedParam as a0, type EntitySearchOptions as a1, type EntitySearchParams as a2, type EntitySearchResults as a3, type EntitySlug as a4, type EntityTableFilterOption as a5, type EntityTableFilterSearch as a6, type EntityValidationError as a7, type EntityValidationResult as a8, type EntityValidationResultError as a9, type InternalAttribute as aA, type InternalUserAttribute as aB, type InvitationEmailAttribute as aC, type IsTemplate as aD, type Language as aE, type LinkAttribute as aF, type ListSavedViewsResults as aG, type MatchStrategy as aH, type MessageEmailAddressAttribute as aI, type MultiSelectAttribute as aJ, type NullableEntity as aK, type NumberAttribute as aL, type OrderedListAttribute as aM, type PartnerOrganisationAttribute as aN, type PartnerStatusAttribute as aO, type PaymentAttribute as aP, type PaymentMethodRelationAttribute as aQ, type PhoneAttribute as aR, type PortalAccessAttribute as aS, type PriceComponentAttribute as aT, type PurposeAttribute as aU, type RedirectEntityView as aV, type RelationAttribute as aW, type RelationEntity as aX, type RelationItem as aY, type RepeatableAttribute as aZ, type SavedView as a_, type EntityValidationResultSuccess as aa, type EntityValidationV2Error as ab, type EntityValidationV2Result as ac, type EntityValidationV2ResultError as ad, type EntityValidationV2ResultSuccess as ae, type EntityViewDisabled as af, type ErrorObject as ag, type ExportJobId as ah, type FieldsParam as ai, type FileAttribute as aj, type FuzzyConfig as ak, type GenerateEntityTableAIFiltersRequest as al, type GenerateEntityTableAIFiltersResponse as am, GetRelatedEntitiesCount as an, type GetRelationsResp as ao, type GetRelationsRespWithPagination as ap, type GraphDefinition as aq, type GraphEdge as ar, type GraphNode as as, type GraphQueryRequest as at, type GraphQueryResponse as au, type GraphSeed as av, type GroupHeadline as aw, type GroupHeadlineWithCompositeID as ax, type HydratedEntity as ay, type HydratedEntityItem as az, type PathsDictionary as b, type SavedViewItem as b0, type SavedViewPartial as b1, type SchemaId as b2, type SearchFilter as b3, type SearchFilterValue as b4, type SearchMappings as b5, type SelectAttribute as b6, type SequenceAttribute as b7, type SettingFlag as b8, type StatusAttribute as b9, type SummaryAttribute as ba, type SummaryField as bb, type TableAttribute as bc, type TagsAttribute as bd, type Taxonomy as be, type TaxonomyBulkJob as bf, type TaxonomyBulkJobActionType as bg, type TaxonomyBulkJobStatus as bh, type TaxonomyBulkJobTriggerResponse as bi, type TaxonomyClassification as bj, type TaxonomyLocationId as bk, type TaxonomySearchIncludeArchivedParam as bl, type TaxonomySlug as bm, type TextAttribute as bn, type UserRelationAttribute as bo, type ActivityCallerContext as c, type ActivityId as d, type ActivityItem as e, type ActivityType as f, type AddressAttribute as g, type AddressRelationAttribute as h, type Attribute as i, type AttributeWithCompositeID as j, type AutomationAttribute as k, type BaseAttribute as l, type BaseEntity as m, type BlueprintEntityId as n, type BooleanAttribute as o, type Changeset as p, type ChangesetCreator as q, type ChangesetMap as r, type ClassificationId as s, type ClassificationIdOrPattern as t, type ClassificationSlug as u, type ClassificationsUpdate as v, type ComputedAttribute as w, type ConsentAttribute as x, type CountryAttribute as y, type CurrencyAttribute as z };
+export { type EntitySchemaGroupWithCompositeID as $, type Activity as A, type BaseActivityItem as B, type Client as C, type DateAttribute as D, type DefaultAddressFields as E, type ESClusterAssignment as F, type EditMode as G, type EditModeConfig as H, type EmailAttribute as I, type Entity as J, type EntityAcl as K, type EntityAction as L, type EntityCapability as M, type EntityCapabilityWithCompositeID as N, type OperationMethods as O, Paths as P, type EntityDefaultCreate as Q, type EntityDefaultEdit as R, type EntityDefaultTable as S, type EntityId as T, type EntityImportParams as U, type EntityItem as V, type EntityListParams as W, type EntityOperation as X, type EntityOwner as Y, type EntitySchema as Z, type EntitySchemaGroup as _, Components as a, type RepeatableAttribute as a$, type EntitySchemaItem as a0, type EntitySearchIncludeDeletedParam as a1, type EntitySearchOptions as a2, type EntitySearchParams as a3, type EntitySearchResults as a4, type EntitySlug as a5, type EntityTableFilterOption as a6, type EntityTableFilterSearch as a7, type EntityValidationError as a8, type EntityValidationResult as a9, type HydratedEntityItem as aA, type InternalAttribute as aB, type InternalUserAttribute as aC, type InvitationEmailAttribute as aD, type IsTemplate as aE, type Language as aF, type LinkAttribute as aG, type ListSavedViewsResults as aH, type MatchStrategy as aI, type MessageEmailAddressAttribute as aJ, type MeterReadingChangesetEntry as aK, type MultiSelectAttribute as aL, type NullableEntity as aM, type NumberAttribute as aN, type OrderedListAttribute as aO, type PartnerOrganisationAttribute as aP, type PartnerStatusAttribute as aQ, type PaymentAttribute as aR, type PaymentMethodRelationAttribute as aS, type PhoneAttribute as aT, type PortalAccessAttribute as aU, type PriceComponentAttribute as aV, type PurposeAttribute as aW, type RedirectEntityView as aX, type RelationAttribute as aY, type RelationEntity as aZ, type RelationItem as a_, type EntityValidationResultError as aa, type EntityValidationResultSuccess as ab, type EntityValidationV2Error as ac, type EntityValidationV2Result as ad, type EntityValidationV2ResultError as ae, type EntityValidationV2ResultSuccess as af, type EntityViewDisabled as ag, type ErrorObject as ah, type ExportJobId as ai, type FieldsParam as aj, type FileAttribute as ak, type FuzzyConfig as al, type GenerateEntityTableAIFiltersRequest as am, type GenerateEntityTableAIFiltersResponse as an, GetRelatedEntitiesCount as ao, type GetRelationsResp as ap, type GetRelationsRespWithPagination as aq, type GraphDefinition as ar, type GraphEdge as as, type GraphNode as at, type GraphQueryRequest as au, type GraphQueryResponse as av, type GraphSeed as aw, type GroupHeadline as ax, type GroupHeadlineWithCompositeID as ay, type HydratedEntity as az, type PathsDictionary as b, type SavedView as b0, type SavedViewId as b1, type SavedViewItem as b2, type SavedViewPartial as b3, type SchemaId as b4, type SearchFilter as b5, type SearchFilterValue as b6, type SearchMappings as b7, type SelectAttribute as b8, type SequenceAttribute as b9, type SettingFlag as ba, type StatusAttribute as bb, type SummaryAttribute as bc, type SummaryField as bd, type TableAttribute as be, type TagsAttribute as bf, type Taxonomy as bg, type TaxonomyBulkJob as bh, type TaxonomyBulkJobActionType as bi, type TaxonomyBulkJobStatus as bj, type TaxonomyBulkJobTriggerResponse as bk, type TaxonomyClassification as bl, type TaxonomyLocationId as bm, type TaxonomySearchIncludeArchivedParam as bn, type TaxonomySlug as bo, type TextAttribute as bp, type UserRelationAttribute as bq, type ActivityCallerContext as c, type ActivityId as d, type ActivityItem as e, type ActivityType as f, type AddressAttribute as g, type AddressRelationAttribute as h, type Attribute as i, type AttributeWithCompositeID as j, type AutomationAttribute as k, type BaseAttribute as l, type BaseEntity as m, type BlueprintEntityId as n, type BooleanAttribute as o, type Changeset as p, type ChangesetCreator as q, type ChangesetMap as r, type ClassificationId as s, type ClassificationIdOrPattern as t, type ClassificationSlug as u, type ClassificationsUpdate as v, type ComputedAttribute as w, type ConsentAttribute as x, type CountryAttribute as y, type CurrencyAttribute as z };