@epilot/sdk 2.8.2 → 2.8.4

package/dist/{blueprint-manifest.d-B8yDxagC.d.ts → blueprint-manifest.d-2-TORV8o.d.ts}

@@ -60,6 +60,90 @@ declare namespace Components {
                  * Outcome of this deployment
                  */
                 status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
+                /**
+                 * Restore lifecycle metadata for this deployment.
+                 */
+                restore_details?: {
+                    /**
+                     * Whether this sync changed destination resources in a way that can
+                     * be reverted. `false` means the sync completed without create,
+                     * update, internal-update, or delete impacts, so there is no revert
+                     * action to offer.
+                     *
+                     */
+                    has_revertible_changes?: boolean;
+                    /**
+                     * Counts of resource impact values from the V3 apply result.
+                     */
+                    resource_impact_summary?: {
+                        create?: number;
+                        update?: number;
+                        internal_update?: number;
+                        delete?: number;
+                        no_op?: number;
+                        ignored?: number;
+                    };
+                    /**
+                     * BlueprintInstallationJob id of the most recent restore that ran
+                     * against this deployment. Used by the FE to keep the restore-status
+                     * badge visible across page reloads. Frontends poll this job to
+                     * render the latest restore outcome.
+                     *
+                     */
+                    last_restore_job_id?: string;
+                    /**
+                     * Timestamp of the most recent restore that ran against this
+                     * deployment. Stamped when the restore sweep finishes. Used by the
+                     * FE to show when a sync was reverted.
+                     *
+                     */
+                    last_restore_at?: string; // date-time
+                    /**
+                     * Identity of the caller who triggered the most recent restore.
+                     * Stamped when the restore sweep finishes. Used by the FE to show
+                     * who reverted a sync.
+                     *
+                     */
+                    last_restored_by?: {
+                        /**
+                         * Display name (email or token name) of the restorer.
+                         */
+                        name?: string;
+                        /**
+                         * User id of the restorer, when triggered by a user.
+                         */
+                        user_id?: string;
+                    };
+                    /**
+                     * Computed server-side from `(job_id, restore_details.last_restore_job_id, installation_status)`.
+                     * `available` when the deployment is restorable but has no prior
+                     * restore (including pure-create deployments without `snapshot_id`,
+                     * reverted via sweep-only);
+                     * `in_progress` while an install or restore is running on this
+                     * blueprint instance;
+                     * `restored` / `partially_restored` / `restore_failed` reflect the
+                     * terminal status of the job referenced by `last_restore_job_id`;
+                     * `unavailable` means there is no revert action, for example
+                     * malformed deployment rows missing `job_id` or no-change syncs.
+                     *
+                     */
+                    status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
+                };
+                /**
+                 * Deprecated. Use `restore_details.has_revertible_changes`.
+                 *
+                 */
+                has_revertible_changes?: boolean;
+                /**
+                 * Deprecated. Use `restore_details.last_restore_job_id`.
+                 *
+                 */
+                last_restore_job_id?: string;
+                /**
+                 * Deprecated. Use `restore_details.status`.
+                 *
+                 */
+                restore_status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
             }[];
             /**
              * Whether the blueprint is verified by epilot
@@ -130,6 +214,7 @@ declare namespace Components {
             events?: BlueprintJobEvent[];
             triggered_at?: string; // date-time
             created_by?: CallerIdentity;
+            job_type?: "dependencies_sync";
             blueprint_id?: /**
              * ID of a blueprint
              * example:
@@ -148,6 +233,7 @@ declare namespace Components {
             events?: BlueprintJobEvent[];
             triggered_at?: string; // date-time
             created_by?: CallerIdentity;
+            job_type?: "export";
             blueprint_id?: /**
              * ID of a blueprint
              * example:
@@ -174,6 +260,7 @@ declare namespace Components {
             events?: BlueprintJobEvent[];
             triggered_at?: string; // date-time
             created_by?: CallerIdentity;
+            job_type?: "install";
             source_blueprint_id?: /**
              * ID of a blueprint
              * example:
@@ -210,7 +297,7 @@ declare namespace Components {
              */
             resources_to_ignore?: string[];
         }
-        export type BlueprintJob = BlueprintExportJob | BlueprintInstallationJob | BlueprintDependenciesSyncJob | BlueprintValidateJob | BlueprintVerificationJob;
+        export type BlueprintJob = BlueprintExportJob | BlueprintInstallationJob | BlueprintRestoreJob | BlueprintDependenciesSyncJob | BlueprintValidateJob | BlueprintVerificationJob;
         export interface BlueprintJobEvent {
             timestamp?: string; // date-time
             message?: string;
@@ -369,6 +456,52 @@ declare namespace Components {
          * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
          */
         export type BlueprintResourceID = string;
+        export interface BlueprintRestoreJob {
+            id?: /**
+             * ID of a job
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintJobID;
+            events?: BlueprintJobEvent[];
+            triggered_at?: string; // date-time
+            created_by?: CallerIdentity;
+            job_type?: "restore";
+            destination_blueprint_id?: /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintID;
+            destination_org_id?: string;
+            /**
+             * The install job whose deployment is being reverted. Maps back
+             * to the entry in `Blueprint.deployments[]`.
+             *
+             */
+            install_job_id?: string | null;
+            /**
+             * The snapshot driving Phase 1 of the restore. Null for sweep-only
+             * restores (pure-create deployments with no captured manifest).
+             *
+             */
+            snapshot_id?: string | null;
+            sync_engine?: "v3";
+            status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
+            /**
+             * Absent while the job is still IN_PROGRESS.
+             */
+            restore_result?: {
+                /**
+                 * The snapshot driving Phase 1 of the restore. Null/absent for
+                 * sweep-only restores (pure-create deployments with no captured
+                 * manifest).
+                 *
+                 */
+                snapshot_id?: string | null;
+                resources?: RestoreOutcomeItem[];
+            } | null;
+        }
         export interface BlueprintValidateJob {
             id?: /**
              * ID of a job
@@ -379,6 +512,7 @@ declare namespace Components {
             events?: BlueprintJobEvent[];
             triggered_at?: string; // date-time
             created_by?: CallerIdentity;
+            job_type?: "validate";
             blueprint_id?: /**
              * ID of a blueprint
              * example:
@@ -405,6 +539,7 @@ declare namespace Components {
             events?: BlueprintJobEvent[];
             triggered_at?: string; // date-time
             created_by?: CallerIdentity;
+            job_type?: "verification";
             source_org_id?: string;
             source_blueprint_id?: /**
              * ID of a blueprint
@@ -419,7 +554,7 @@ declare namespace Components {
              * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
              */
             BlueprintID;
-            status?: "IN_PROGRESS" | "SUCCESS" | "FAILED";
+            status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
             summary?: VerificationSummary;
             resource_results?: ResourceVerificationResult[];
             /**
@@ -497,6 +632,90 @@ declare namespace Components {
                  * Outcome of this deployment
                  */
                 status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
+                /**
+                 * Restore lifecycle metadata for this deployment.
+                 */
+                restore_details?: {
+                    /**
+                     * Whether this sync changed destination resources in a way that can
+                     * be reverted. `false` means the sync completed without create,
+                     * update, internal-update, or delete impacts, so there is no revert
+                     * action to offer.
+                     *
+                     */
+                    has_revertible_changes?: boolean;
+                    /**
+                     * Counts of resource impact values from the V3 apply result.
+                     */
+                    resource_impact_summary?: {
+                        create?: number;
+                        update?: number;
+                        internal_update?: number;
+                        delete?: number;
+                        no_op?: number;
+                        ignored?: number;
+                    };
+                    /**
+                     * BlueprintInstallationJob id of the most recent restore that ran
+                     * against this deployment. Used by the FE to keep the restore-status
+                     * badge visible across page reloads. Frontends poll this job to
+                     * render the latest restore outcome.
+                     *
+                     */
+                    last_restore_job_id?: string;
+                    /**
+                     * Timestamp of the most recent restore that ran against this
+                     * deployment. Stamped when the restore sweep finishes. Used by the
+                     * FE to show when a sync was reverted.
+                     *
+                     */
+                    last_restore_at?: string; // date-time
+                    /**
+                     * Identity of the caller who triggered the most recent restore.
+                     * Stamped when the restore sweep finishes. Used by the FE to show
+                     * who reverted a sync.
+                     *
+                     */
+                    last_restored_by?: {
+                        /**
+                         * Display name (email or token name) of the restorer.
+                         */
+                        name?: string;
+                        /**
+                         * User id of the restorer, when triggered by a user.
+                         */
+                        user_id?: string;
+                    };
+                    /**
+                     * Computed server-side from `(job_id, restore_details.last_restore_job_id, installation_status)`.
+                     * `available` when the deployment is restorable but has no prior
+                     * restore (including pure-create deployments without `snapshot_id`,
+                     * reverted via sweep-only);
+                     * `in_progress` while an install or restore is running on this
+                     * blueprint instance;
+                     * `restored` / `partially_restored` / `restore_failed` reflect the
+                     * terminal status of the job referenced by `last_restore_job_id`;
+                     * `unavailable` means there is no revert action, for example
+                     * malformed deployment rows missing `job_id` or no-change syncs.
+                     *
+                     */
+                    status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
+                };
+                /**
+                 * Deprecated. Use `restore_details.has_revertible_changes`.
+                 *
+                 */
+                has_revertible_changes?: boolean;
+                /**
+                 * Deprecated. Use `restore_details.last_restore_job_id`.
+                 *
+                 */
+                last_restore_job_id?: string;
+                /**
+                 * Deprecated. Use `restore_details.status`.
+                 *
+                 */
+                restore_status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
             }[];
             /**
              * Whether the blueprint is verified by epilot
@@ -784,6 +1003,90 @@ declare namespace Components {
                  * Outcome of this deployment
                  */
                 status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
+                /**
+                 * Restore lifecycle metadata for this deployment.
+                 */
+                restore_details?: {
+                    /**
+                     * Whether this sync changed destination resources in a way that can
+                     * be reverted. `false` means the sync completed without create,
+                     * update, internal-update, or delete impacts, so there is no revert
+                     * action to offer.
+                     *
+                     */
+                    has_revertible_changes?: boolean;
+                    /**
+                     * Counts of resource impact values from the V3 apply result.
+                     */
+                    resource_impact_summary?: {
+                        create?: number;
+                        update?: number;
+                        internal_update?: number;
+                        delete?: number;
+                        no_op?: number;
+                        ignored?: number;
+                    };
+                    /**
+                     * BlueprintInstallationJob id of the most recent restore that ran
+                     * against this deployment. Used by the FE to keep the restore-status
+                     * badge visible across page reloads. Frontends poll this job to
+                     * render the latest restore outcome.
+                     *
+                     */
+                    last_restore_job_id?: string;
+                    /**
+                     * Timestamp of the most recent restore that ran against this
+                     * deployment. Stamped when the restore sweep finishes. Used by the
+                     * FE to show when a sync was reverted.
+                     *
+                     */
+                    last_restore_at?: string; // date-time
+                    /**
+                     * Identity of the caller who triggered the most recent restore.
+                     * Stamped when the restore sweep finishes. Used by the FE to show
+                     * who reverted a sync.
+                     *
+                     */
+                    last_restored_by?: {
+                        /**
+                         * Display name (email or token name) of the restorer.
+                         */
+                        name?: string;
+                        /**
+                         * User id of the restorer, when triggered by a user.
+                         */
+                        user_id?: string;
+                    };
+                    /**
+                     * Computed server-side from `(job_id, restore_details.last_restore_job_id, installation_status)`.
+                     * `available` when the deployment is restorable but has no prior
+                     * restore (including pure-create deployments without `snapshot_id`,
+                     * reverted via sweep-only);
+                     * `in_progress` while an install or restore is running on this
+                     * blueprint instance;
+                     * `restored` / `partially_restored` / `restore_failed` reflect the
+                     * terminal status of the job referenced by `last_restore_job_id`;
+                     * `unavailable` means there is no revert action, for example
+                     * malformed deployment rows missing `job_id` or no-change syncs.
+                     *
+                     */
+                    status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
+                };
+                /**
+                 * Deprecated. Use `restore_details.has_revertible_changes`.
+                 *
+                 */
+                has_revertible_changes?: boolean;
+                /**
+                 * Deprecated. Use `restore_details.last_restore_job_id`.
+                 *
+                 */
+                last_restore_job_id?: string;
+                /**
+                 * Deprecated. Use `restore_details.status`.
+                 *
+                 */
+                restore_status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
             }[];
             /**
              * Whether the blueprint is verified by epilot
@@ -887,6 +1190,90 @@ declare namespace Components {
                  * Outcome of this deployment
                  */
                 status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
+                /**
+                 * Restore lifecycle metadata for this deployment.
+                 */
+                restore_details?: {
+                    /**
+                     * Whether this sync changed destination resources in a way that can
+                     * be reverted. `false` means the sync completed without create,
+                     * update, internal-update, or delete impacts, so there is no revert
+                     * action to offer.
+                     *
+                     */
+                    has_revertible_changes?: boolean;
+                    /**
+                     * Counts of resource impact values from the V3 apply result.
+                     */
+                    resource_impact_summary?: {
+                        create?: number;
+                        update?: number;
+                        internal_update?: number;
+                        delete?: number;
+                        no_op?: number;
+                        ignored?: number;
+                    };
+                    /**
+                     * BlueprintInstallationJob id of the most recent restore that ran
+                     * against this deployment. Used by the FE to keep the restore-status
+                     * badge visible across page reloads. Frontends poll this job to
+                     * render the latest restore outcome.
+                     *
+                     */
+                    last_restore_job_id?: string;
+                    /**
+                     * Timestamp of the most recent restore that ran against this
+                     * deployment. Stamped when the restore sweep finishes. Used by the
+                     * FE to show when a sync was reverted.
+                     *
+                     */
+                    last_restore_at?: string; // date-time
+                    /**
+                     * Identity of the caller who triggered the most recent restore.
+                     * Stamped when the restore sweep finishes. Used by the FE to show
+                     * who reverted a sync.
+                     *
+                     */
+                    last_restored_by?: {
+                        /**
+                         * Display name (email or token name) of the restorer.
+                         */
+                        name?: string;
+                        /**
+                         * User id of the restorer, when triggered by a user.
+                         */
+                        user_id?: string;
+                    };
+                    /**
+                     * Computed server-side from `(job_id, restore_details.last_restore_job_id, installation_status)`.
+                     * `available` when the deployment is restorable but has no prior
+                     * restore (including pure-create deployments without `snapshot_id`,
+                     * reverted via sweep-only);
+                     * `in_progress` while an install or restore is running on this
+                     * blueprint instance;
+                     * `restored` / `partially_restored` / `restore_failed` reflect the
+                     * terminal status of the job referenced by `last_restore_job_id`;
+                     * `unavailable` means there is no revert action, for example
+                     * malformed deployment rows missing `job_id` or no-change syncs.
+                     *
+                     */
+                    status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
+                };
+                /**
+                 * Deprecated. Use `restore_details.has_revertible_changes`.
+                 *
+                 */
+                has_revertible_changes?: boolean;
+                /**
+                 * Deprecated. Use `restore_details.last_restore_job_id`.
+                 *
+                 */
+                last_restore_job_id?: string;
+                /**
+                 * Deprecated. Use `restore_details.status`.
+                 *
+                 */
+                restore_status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
             }[];
             /**
              * Whether the blueprint is verified by epilot
@@ -1002,6 +1389,90 @@ declare namespace Components {
                  * Outcome of this deployment
                  */
                 status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
+                /**
+                 * Restore lifecycle metadata for this deployment.
+                 */
+                restore_details?: {
+                    /**
+                     * Whether this sync changed destination resources in a way that can
+                     * be reverted. `false` means the sync completed without create,
+                     * update, internal-update, or delete impacts, so there is no revert
+                     * action to offer.
+                     *
+                     */
+                    has_revertible_changes?: boolean;
+                    /**
+                     * Counts of resource impact values from the V3 apply result.
+                     */
+                    resource_impact_summary?: {
+                        create?: number;
+                        update?: number;
+                        internal_update?: number;
+                        delete?: number;
+                        no_op?: number;
+                        ignored?: number;
+                    };
+                    /**
+                     * BlueprintInstallationJob id of the most recent restore that ran
+                     * against this deployment. Used by the FE to keep the restore-status
+                     * badge visible across page reloads. Frontends poll this job to
+                     * render the latest restore outcome.
+                     *
+                     */
+                    last_restore_job_id?: string;
+                    /**
+                     * Timestamp of the most recent restore that ran against this
+                     * deployment. Stamped when the restore sweep finishes. Used by the
+                     * FE to show when a sync was reverted.
+                     *
+                     */
+                    last_restore_at?: string; // date-time
+                    /**
+                     * Identity of the caller who triggered the most recent restore.
+                     * Stamped when the restore sweep finishes. Used by the FE to show
+                     * who reverted a sync.
+                     *
+                     */
+                    last_restored_by?: {
+                        /**
+                         * Display name (email or token name) of the restorer.
+                         */
+                        name?: string;
+                        /**
+                         * User id of the restorer, when triggered by a user.
+                         */
+                        user_id?: string;
+                    };
+                    /**
+                     * Computed server-side from `(job_id, restore_details.last_restore_job_id, installation_status)`.
+                     * `available` when the deployment is restorable but has no prior
+                     * restore (including pure-create deployments without `snapshot_id`,
+                     * reverted via sweep-only);
+                     * `in_progress` while an install or restore is running on this
+                     * blueprint instance;
+                     * `restored` / `partially_restored` / `restore_failed` reflect the
+                     * terminal status of the job referenced by `last_restore_job_id`;
+                     * `unavailable` means there is no revert action, for example
+                     * malformed deployment rows missing `job_id` or no-change syncs.
+                     *
+                     */
+                    status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
+                };
+                /**
+                 * Deprecated. Use `restore_details.has_revertible_changes`.
+                 *
+                 */
+                has_revertible_changes?: boolean;
+                /**
+                 * Deprecated. Use `restore_details.last_restore_job_id`.
+                 *
+                 */
+                last_restore_job_id?: string;
+                /**
+                 * Deprecated. Use `restore_details.status`.
+                 *
+                 */
+                restore_status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
             }[];
             /**
              * Whether the blueprint is verified by epilot
@@ -1324,7 +1795,7 @@ declare namespace Components {
              * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
              */
             BlueprintJobID;
-            status?: "IN_PROGRESS" | "SUCCESS" | "FAILED";
+            status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
             triggered_at?: string; // date-time
             source_org_id?: string;
             source_blueprint_id?: /**
@@ -1713,6 +2184,90 @@ declare namespace Components {
                  * Outcome of this deployment
                  */
                 status?: "IN_PROGRESS" | "SUCCESS" | "PARTIAL_SUCCESS" | "FAILED";
+                /**
+                 * Restore lifecycle metadata for this deployment.
+                 */
+                restore_details?: {
+                    /**
+                     * Whether this sync changed destination resources in a way that can
+                     * be reverted. `false` means the sync completed without create,
+                     * update, internal-update, or delete impacts, so there is no revert
+                     * action to offer.
+                     *
+                     */
+                    has_revertible_changes?: boolean;
+                    /**
+                     * Counts of resource impact values from the V3 apply result.
+                     */
+                    resource_impact_summary?: {
+                        create?: number;
+                        update?: number;
+                        internal_update?: number;
+                        delete?: number;
+                        no_op?: number;
+                        ignored?: number;
+                    };
+                    /**
+                     * BlueprintInstallationJob id of the most recent restore that ran
+                     * against this deployment. Used by the FE to keep the restore-status
+                     * badge visible across page reloads. Frontends poll this job to
+                     * render the latest restore outcome.
+                     *
+                     */
+                    last_restore_job_id?: string;
+                    /**
+                     * Timestamp of the most recent restore that ran against this
+                     * deployment. Stamped when the restore sweep finishes. Used by the
+                     * FE to show when a sync was reverted.
+                     *
+                     */
+                    last_restore_at?: string; // date-time
+                    /**
+                     * Identity of the caller who triggered the most recent restore.
+                     * Stamped when the restore sweep finishes. Used by the FE to show
+                     * who reverted a sync.
+                     *
+                     */
+                    last_restored_by?: {
+                        /**
+                         * Display name (email or token name) of the restorer.
+                         */
+                        name?: string;
+                        /**
+                         * User id of the restorer, when triggered by a user.
+                         */
+                        user_id?: string;
+                    };
+                    /**
+                     * Computed server-side from `(job_id, restore_details.last_restore_job_id, installation_status)`.
+                     * `available` when the deployment is restorable but has no prior
+                     * restore (including pure-create deployments without `snapshot_id`,
+                     * reverted via sweep-only);
+                     * `in_progress` while an install or restore is running on this
+                     * blueprint instance;
+                     * `restored` / `partially_restored` / `restore_failed` reflect the
+                     * terminal status of the job referenced by `last_restore_job_id`;
+                     * `unavailable` means there is no revert action, for example
+                     * malformed deployment rows missing `job_id` or no-change syncs.
+                     *
+                     */
+                    status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
+                };
+                /**
+                 * Deprecated. Use `restore_details.has_revertible_changes`.
+                 *
+                 */
+                has_revertible_changes?: boolean;
+                /**
+                 * Deprecated. Use `restore_details.last_restore_job_id`.
+                 *
+                 */
+                last_restore_job_id?: string;
+                /**
+                 * Deprecated. Use `restore_details.status`.
+                 *
+                 */
+                restore_status?: "available" | "in_progress" | "restored" | "partially_restored" | "restore_failed" | "unavailable";
             }[];
             /**
              * Whether the blueprint is verified by epilot
@@ -2003,6 +2558,45 @@ declare namespace Components {
             field_diffs?: FieldDiff[];
             error?: string;
         }
+        export interface RestoreOutcome {
+            /**
+             * The snapshot driving Phase 1 of the restore. Null/absent for
+             * sweep-only restores (pure-create deployments with no captured
+             * manifest).
+             *
+             */
+            snapshot_id?: string | null;
+            resources?: RestoreOutcomeItem[];
+        }
+        export interface RestoreOutcomeItem {
+            lineage_id: string;
+            type: string;
+            name?: string | null;
+            target_id?: string | null;
+            /**
+             * On `restore-preview`: the action the restore would take.
+             * On `restore_result`: the action that was applied.
+             * `failed` only appears on `restore_result`.
+             *
+             */
+            action: "restore" | "delete" | "skip" | "failed";
+            /**
+             * Only set when `action == skip`.
+             */
+            reason?: "modified" | "co_owned" | "delete_unsupported" | "heuristic_match";
+            /**
+             * Only set when `reason == modified`. From the lineage row's last install write.
+             */
+            last_synced_at?: string | null; // date-time
+            /**
+             * Only set when `reason == modified`. From the destination resource's current state.
+             */
+            current_updated_at?: string | null; // date-time
+            /**
+             * Only set when `action == failed`.
+             */
+            error_message?: string | null;
+        }
         export interface RootResourceNode {
             /**
              * ID of the resource
@@ -2104,6 +2698,20 @@ declare namespace Components {
              */
             add_dependencies_recommended?: boolean;
         }
+        export interface UniquenessCriteria {
+            org_id: string;
+            resource_type: /* Resource type for which custom uniqueness criteria can be configured. */ UniquenessCriteriaResourceType;
+            fields: [
+                string,
+                ...string[]
+            ];
+            updated_at: string; // date-time
+            updated_by?: string;
+        }
+        /**
+         * Resource type for which custom uniqueness criteria can be configured.
+         */
+        export type UniquenessCriteriaResourceType = "emailtemplate" | "product" | "price" | "tax" | "coupon" | "product_recommendation" | "file" | "document_template" | "schema" | "taxonomy" | "notification_template" | "family" | "permission" | "journey";
         export interface UploadFilePayload {
             /**
              * example:
@@ -2609,6 +3217,12 @@ declare namespace Paths {
             }
         }
     }
+    namespace DeleteUniquenessCriteria {
+        namespace Responses {
+            export interface $204 {
+            }
+        }
+    }
     namespace DetectPatchChanges {
         namespace Parameters {
             export type BlueprintId = /**
@@ -2978,6 +3592,38 @@ declare namespace Paths {
             }
         }
     }
+    namespace GetRestorePreview {
+        namespace Parameters {
+            export type BlueprintId = /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            Components.Schemas.BlueprintID;
+            export type JobId = /**
+             * ID of a job
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            Components.Schemas.BlueprintJobID;
+        }
+        export interface PathParameters {
+            blueprint_id: Parameters.BlueprintId;
+            job_id: Parameters.JobId;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.RestoreOutcome;
+            export interface $404 {
+            }
+        }
+    }
+    namespace GetUniquenessCriteria {
+        namespace Responses {
+            export type $200 = Components.Schemas.UniquenessCriteria;
+            export interface $404 {
+            }
+        }
+    }
     namespace InstallBlueprint {
         export interface RequestBody {
             source_org_id?: string;
@@ -3244,6 +3890,13 @@ declare namespace Paths {
             }
         }
     }
+    namespace ListUniquenessCriteria {
+        namespace Responses {
+            export interface $200 {
+                results?: Components.Schemas.UniquenessCriteria[];
+            }
+        }
+    }
     namespace PreInstallBlueprint {
         export interface RequestBody {
             /**
@@ -3313,6 +3966,62 @@ declare namespace Paths {
             }
         }
     }
+    namespace PutUniquenessCriteria {
+        export interface RequestBody {
+            fields: [
+                string,
+                ...string[]
+            ];
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.UniquenessCriteria;
+            export interface $400 {
+            }
+        }
+    }
+    namespace RestoreBlueprintDeploymentV3 {
+        namespace Parameters {
+            export type BlueprintId = /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            Components.Schemas.BlueprintID;
+            export type JobId = /**
+             * ID of a job
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            Components.Schemas.BlueprintJobID;
+        }
+        export interface PathParameters {
+            blueprint_id: Parameters.BlueprintId;
+            job_id: Parameters.JobId;
+        }
+        namespace Responses {
+            export interface $202 {
+                job_id?: /**
+                 * ID of a job
+                 * example:
+                 * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+                 */
+                Components.Schemas.BlueprintJobID;
+                blueprint_instance_id?: /**
+                 * ID of a blueprint
+                 * example:
+                 * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+                 */
+                Components.Schemas.BlueprintID;
+                snapshot_id?: string;
+            }
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+            export interface $409 {
+            }
+        }
+    }
     namespace RetryPatchOrg {
         namespace Parameters {
             export type BlueprintId = /**
@@ -3476,6 +4185,14 @@ declare namespace Paths {
             }
         }
     }
+    namespace V1BlueprintManifestUniquenessCriteria$ResourceType {
+        namespace Parameters {
+            export type ResourceType = /* Resource type for which custom uniqueness criteria can be configured. */ Components.Schemas.UniquenessCriteriaResourceType;
+        }
+        export interface PathParameters {
+            resource_type: Parameters.ResourceType;
+        }
+    }
     namespace ValidateBlueprint {
         namespace Parameters {
             export type BlueprintId = /**
@@ -4141,6 +4858,55 @@ interface OperationMethods {
     data?: Paths.InstallBlueprintV3.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.InstallBlueprintV3.Responses.$202>
+  /**
+   * restoreBlueprintDeploymentV3 - Restore a specific deployment by job_id
+   * 
+   * Roll a deployment back to its pre-install state. Two phases:
+   * 
+   *   1. Upsert — re-applies the captured payloads via snapshot-api's
+   *      `:restore` (server-side; runs config-engine.apply with captured
+   *      target ids pre-seeded). Skipped for pure-create deployments
+   *      whose snapshot was empty.
+   *   2. Delete sweep — for lineage rows of this blueprint instance not
+   *      present in the snapshot's captured set, deletes the live
+   *      resource via the type's adapter. Co-ownership / drift /
+   *      no-delete-capability skip the entry with the corresponding
+   *      reason.
+   * 
+   * Resolves `(blueprint_id, job_id)` to the entry in
+   * `Blueprint.deployments[]` and reads its `snapshot_id` and
+   * `destination_blueprint_id` — the caller never needs to handle
+   * snapshot ids directly.
+   * 
+   * Async — returns 202 with a job id. Poll the job to track progress.
+   * The per-instance lock (`installation_status === 'IN_PROGRESS'`)
+   * rejects concurrent installs or restores with 409.
+   * 
+   */
+  'restoreBlueprintDeploymentV3'(
+    parameters?: Parameters<Paths.RestoreBlueprintDeploymentV3.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.RestoreBlueprintDeploymentV3.Responses.$202>
+  /**
+   * getRestorePreview - Predicted outcome of reverting a deployment
+   * 
+   * Computes what would happen if the user triggered a restore on this
+   * deployment, without performing any writes. The forecast uses the
+   * snapshot's captured resources (when present) plus the current lineage
+   * state plus per-adapter gates (co-ownership, no-delete-capability,
+   * heuristic-match, drift when wired).
+   * 
+   * Idempotent and side-effect free. Safe to call repeatedly. The result
+   * may shift between calls if operators edit destination resources or
+   * another blueprint adopts a shared resource in the meantime.
+   * 
+   */
+  'getRestorePreview'(
+    parameters?: Parameters<Paths.GetRestorePreview.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetRestorePreview.Responses.$200>
   /**
    * getBlueprintLineageV3 - Get Blueprint Lineage V3
    * 
@@ -4153,6 +4919,53 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetBlueprintLineageV3.Responses.$200>
+  /**
+   * listUniquenessCriteria - listUniquenessCriteria
+   * 
+   * List all custom uniqueness criteria configured for the caller's organization.
+   * These overrides are applied during install (V2 and V3) when matching incoming
+   * resources against existing ones in the destination org, replacing the default
+   * per-resource-type field set with the caller's chosen fields (AND-combined).
+   * 
+   */
+  'listUniquenessCriteria'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListUniquenessCriteria.Responses.$200>
+  /**
+   * getUniquenessCriteria - getUniquenessCriteria
+   * 
+   * Get the configured uniqueness criteria for a specific resource type, if any.
+   */
+  'getUniquenessCriteria'(
+    parameters?: Parameters<Paths.V1BlueprintManifestUniquenessCriteria$ResourceType.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetUniquenessCriteria.Responses.$200>
+  /**
+   * putUniquenessCriteria - putUniquenessCriteria
+   * 
+   * Set or replace the uniqueness criteria for a resource type. The provided fields
+   * must be valid attributes on the resource's schema (the UI typically loads the
+   * schema to populate options). All listed fields are AND-combined during matching.
+   * 
+   */
+  'putUniquenessCriteria'(
+    parameters?: Parameters<Paths.V1BlueprintManifestUniquenessCriteria$ResourceType.PathParameters> | null,
+    data?: Paths.PutUniquenessCriteria.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PutUniquenessCriteria.Responses.$200>
+  /**
+   * deleteUniquenessCriteria - deleteUniquenessCriteria
+   * 
+   * Remove the custom criteria for a resource type, reverting to the default fields.
+   */
+  'deleteUniquenessCriteria'(
+    parameters?: Parameters<Paths.V1BlueprintManifestUniquenessCriteria$ResourceType.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteUniquenessCriteria.Responses.$204>
 }
 
 interface PathsDictionary {
@@ -4819,6 +5632,59 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.InstallBlueprintV3.Responses.$202>
   }
+  ['/v3/blueprint-manifest/blueprints/{blueprint_id}/deployments/{job_id}:restore']: {
+    /**
+     * restoreBlueprintDeploymentV3 - Restore a specific deployment by job_id
+     * 
+     * Roll a deployment back to its pre-install state. Two phases:
+     * 
+     *   1. Upsert — re-applies the captured payloads via snapshot-api's
+     *      `:restore` (server-side; runs config-engine.apply with captured
+     *      target ids pre-seeded). Skipped for pure-create deployments
+     *      whose snapshot was empty.
+     *   2. Delete sweep — for lineage rows of this blueprint instance not
+     *      present in the snapshot's captured set, deletes the live
+     *      resource via the type's adapter. Co-ownership / drift /
+     *      no-delete-capability skip the entry with the corresponding
+     *      reason.
+     * 
+     * Resolves `(blueprint_id, job_id)` to the entry in
+     * `Blueprint.deployments[]` and reads its `snapshot_id` and
+     * `destination_blueprint_id` — the caller never needs to handle
+     * snapshot ids directly.
+     * 
+     * Async — returns 202 with a job id. Poll the job to track progress.
+     * The per-instance lock (`installation_status === 'IN_PROGRESS'`)
+     * rejects concurrent installs or restores with 409.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.RestoreBlueprintDeploymentV3.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.RestoreBlueprintDeploymentV3.Responses.$202>
+  }
+  ['/v3/blueprint-manifest/blueprints/{blueprint_id}/deployments/{job_id}/restore-preview']: {
+    /**
+     * getRestorePreview - Predicted outcome of reverting a deployment
+     * 
+     * Computes what would happen if the user triggered a restore on this
+     * deployment, without performing any writes. The forecast uses the
+     * snapshot's captured resources (when present) plus the current lineage
+     * state plus per-adapter gates (co-ownership, no-delete-capability,
+     * heuristic-match, drift when wired).
+     * 
+     * Idempotent and side-effect free. Safe to call repeatedly. The result
+     * may shift between calls if operators edit destination resources or
+     * another blueprint adopts a shared resource in the meantime.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetRestorePreview.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetRestorePreview.Responses.$200>
+  }
   ['/v3/blueprint-manifest/blueprints/{blueprint_id}/lineage']: {
     /**
      * getBlueprintLineageV3 - Get Blueprint Lineage V3
@@ -4833,6 +5699,57 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetBlueprintLineageV3.Responses.$200>
   }
+  ['/v1/blueprint-manifest/uniqueness-criteria']: {
+    /**
+     * listUniquenessCriteria - listUniquenessCriteria
+     * 
+     * List all custom uniqueness criteria configured for the caller's organization.
+     * These overrides are applied during install (V2 and V3) when matching incoming
+     * resources against existing ones in the destination org, replacing the default
+     * per-resource-type field set with the caller's chosen fields (AND-combined).
+     * 
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListUniquenessCriteria.Responses.$200>
+  }
+  ['/v1/blueprint-manifest/uniqueness-criteria/{resource_type}']: {
+    /**
+     * getUniquenessCriteria - getUniquenessCriteria
+     * 
+     * Get the configured uniqueness criteria for a specific resource type, if any.
+     */
+    'get'(
+      parameters?: Parameters<Paths.V1BlueprintManifestUniquenessCriteria$ResourceType.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetUniquenessCriteria.Responses.$200>
+    /**
+     * putUniquenessCriteria - putUniquenessCriteria
+     * 
+     * Set or replace the uniqueness criteria for a resource type. The provided fields
+     * must be valid attributes on the resource's schema (the UI typically loads the
+     * schema to populate options). All listed fields are AND-combined during matching.
+     * 
+     */
+    'put'(
+      parameters?: Parameters<Paths.V1BlueprintManifestUniquenessCriteria$ResourceType.PathParameters> | null,
+      data?: Paths.PutUniquenessCriteria.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PutUniquenessCriteria.Responses.$200>
+    /**
+     * deleteUniquenessCriteria - deleteUniquenessCriteria
+     * 
+     * Remove the custom criteria for a resource type, reverting to the default fields.
+     */
+    'delete'(
+      parameters?: Parameters<Paths.V1BlueprintManifestUniquenessCriteria$ResourceType.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteUniquenessCriteria.Responses.$204>
+  }
 }
 
 type Client = OpenAPIClient<OperationMethods, PathsDictionary>
@@ -4854,6 +5771,7 @@ type BlueprintPatchWithResults = Components.Schemas.BlueprintPatchWithResults;
 type BlueprintPreview = Components.Schemas.BlueprintPreview;
 type BlueprintResource = Components.Schemas.BlueprintResource;
 type BlueprintResourceID = Components.Schemas.BlueprintResourceID;
+type BlueprintRestoreJob = Components.Schemas.BlueprintRestoreJob;
 type BlueprintValidateJob = Components.Schemas.BlueprintValidateJob;
 type BlueprintVerificationJob = Components.Schemas.BlueprintVerificationJob;
 type CallerIdentity = Components.Schemas.CallerIdentity;
@@ -4896,14 +5814,18 @@ type ResourceNode = Components.Schemas.ResourceNode;
 type ResourceNodeType = Components.Schemas.ResourceNodeType;
 type ResourceReplacement = Components.Schemas.ResourceReplacement;
 type ResourceVerificationResult = Components.Schemas.ResourceVerificationResult;
+type RestoreOutcome = Components.Schemas.RestoreOutcome;
+type RestoreOutcomeItem = Components.Schemas.RestoreOutcomeItem;
 type RootResourceNode = Components.Schemas.RootResourceNode;
 type S3Reference = Components.Schemas.S3Reference;
 type SelectedResources = Components.Schemas.SelectedResources;
 type SuggestBlueprintResourcesRequest = Components.Schemas.SuggestBlueprintResourcesRequest;
 type SuggestBlueprintResourcesResponse = Components.Schemas.SuggestBlueprintResourcesResponse;
+type UniquenessCriteria = Components.Schemas.UniquenessCriteria;
+type UniquenessCriteriaResourceType = Components.Schemas.UniquenessCriteriaResourceType;
 type UploadFilePayload = Components.Schemas.UploadFilePayload;
 type V3ResourceProgressEntry = Components.Schemas.V3ResourceProgressEntry;
 type VerificationSummary = Components.Schemas.VerificationSummary;
 type VirtualResourceNodeGroup = Components.Schemas.VirtualResourceNodeGroup;
 
-export { type OrgPatchExecution as $, type AppBlueprint as A, type Blueprint as B, type Client as C, type DeployedBlueprint as D, type DetectChangesResult as E, type FieldDiff as F, type FileBlueprint as G, type FormattedError as H, type FormattedErrorCodes as I, type FormattedErrorData as J, type InstalledMarketplaceBlueprintItem as K, type Job as L, type JobID as M, type JobStatus as N, type OperationMethods as O, Paths as P, type LatestBlueprintVerification as Q, type LineageEntry as R, type Manifest as S, type ManifestID as T, type ManifestItem as U, type ManifestSource as V, type ManifestTimestampFields as W, type MarketplaceBlueprint as X, type MarketplaceListing as Y, type MarketplaceListingUpdate as Z, type MarketplaceListingVersion as _, Components as a, type PatchFieldDiff as a0, type PatchResourceDiff as a1, type PlanChanges as a2, type PreInstallRequirements as a3, type PutManifestPayload as a4, type ResourceNode as a5, type ResourceNodeType as a6, type ResourceReplacement as a7, type ResourceVerificationResult as a8, type RootResourceNode as a9, type S3Reference as aa, type SelectedResources as ab, type SuggestBlueprintResourcesRequest as ac, type SuggestBlueprintResourcesResponse as ad, type UploadFilePayload as ae, type V3ResourceProgressEntry as af, type VerificationSummary as ag, type VirtualResourceNodeGroup as ah, type PathsDictionary as b, type BlueprintDependenciesSyncJob as c, type BlueprintExportJob as d, type BlueprintID as e, type BlueprintInstallStatus as f, type BlueprintInstallationJob as g, type BlueprintInstallationJobOptions as h, type BlueprintJob as i, type BlueprintJobEvent as j, type BlueprintJobID as k, type BlueprintPatch as l, type BlueprintPatchWithResults as m, type BlueprintPreview as n, type BlueprintResource as o, type BlueprintResourceID as p, type BlueprintValidateJob as q, type BlueprintVerificationJob as r, type CallerIdentity as s, type CommonBlueprintFields as t, type CommonBlueprintJobFields as u, type CommonImportFields as v, type CommonManifestFields as w, type CommonMarkdownFields as x, type CommonResourceNode as y, type CustomBlueprint as z };
+export { type MarketplaceListingVersion as $, type AppBlueprint as A, type Blueprint as B, type Client as C, type CustomBlueprint as D, type DeployedBlueprint as E, type DetectChangesResult as F, type FieldDiff as G, type FileBlueprint as H, type FormattedError as I, type FormattedErrorCodes as J, type FormattedErrorData as K, type InstalledMarketplaceBlueprintItem as L, type Job as M, type JobID as N, type OperationMethods as O, Paths as P, type JobStatus as Q, type LatestBlueprintVerification as R, type LineageEntry as S, type Manifest as T, type ManifestID as U, type ManifestItem as V, type ManifestSource as W, type ManifestTimestampFields as X, type MarketplaceBlueprint as Y, type MarketplaceListing as Z, type MarketplaceListingUpdate as _, Components as a, type OrgPatchExecution as a0, type PatchFieldDiff as a1, type PatchResourceDiff as a2, type PlanChanges as a3, type PreInstallRequirements as a4, type PutManifestPayload as a5, type ResourceNode as a6, type ResourceNodeType as a7, type ResourceReplacement as a8, type ResourceVerificationResult as a9, type RestoreOutcome as aa, type RestoreOutcomeItem as ab, type RootResourceNode as ac, type S3Reference as ad, type SelectedResources as ae, type SuggestBlueprintResourcesRequest as af, type SuggestBlueprintResourcesResponse as ag, type UniquenessCriteria as ah, type UniquenessCriteriaResourceType as ai, type UploadFilePayload as aj, type V3ResourceProgressEntry as ak, type VerificationSummary as al, type VirtualResourceNodeGroup as am, type PathsDictionary as b, type BlueprintDependenciesSyncJob as c, type BlueprintExportJob as d, type BlueprintID as e, type BlueprintInstallStatus as f, type BlueprintInstallationJob as g, type BlueprintInstallationJobOptions as h, type BlueprintJob as i, type BlueprintJobEvent as j, type BlueprintJobID as k, type BlueprintPatch as l, type BlueprintPatchWithResults as m, type BlueprintPreview as n, type BlueprintResource as o, type BlueprintResourceID as p, type BlueprintRestoreJob as q, type BlueprintValidateJob as r, type BlueprintVerificationJob as s, type CallerIdentity as t, type CommonBlueprintFields as u, type CommonBlueprintJobFields as v, type CommonImportFields as w, type CommonManifestFields as x, type CommonMarkdownFields as y, type CommonResourceNode as z };