@epilot/sdk 2.15.6 → 2.15.8

package/dist/{blueprint-manifest.d-D2I9nhZa.d.cts → blueprint-manifest.d-BiaeSTI3.d.cts}

@@ -41,6 +41,21 @@ declare namespace Components {
                  */
                 postinstall?: string;
             };
+            /**
+             * Internal collaboration notes, oldest first. Append-only: each entry is
+             * stamped with its author and creation time server-side and is never
+             * rewritten, so the history of who noted what stays intact. Written via
+             * `addBlueprintNote` / `deleteBlueprintNote`, not by `updateBlueprint`.
+             *
+             * Available on every blueprint including marketplace ones (whose
+             * `description` is read-only), and never included in the published
+             * marketplace package — see `buildMetadata` in
+             * `services/blueprint-v3/published-blueprint.ts`. Carried to a
+             * destination org only when an install/sync passes
+             * `options.sync_notes: true`.
+             *
+             */
+            notes?: /* A single internal note on a blueprint. */ BlueprintNote[];
             version?: string;
             deployments?: {
                 source_org_id?: string;
@@ -296,6 +311,13 @@ declare namespace Components {
              * List of resource addresses to ignore changes for. When a resource is marked as create, it will be ignored and not created.
              */
             resources_to_ignore?: string[];
+            /**
+             * When `true`, the source blueprint's `notes` overwrite the destination
+             * blueprint's `notes`. Defaults to `false`, which leaves the
+             * destination's notes untouched.
+             *
+             */
+            sync_notes?: boolean;
         }
         export type BlueprintJob = BlueprintExportJob | BlueprintInstallationJob | BlueprintRestoreJob | BlueprintDependenciesSyncJob | BlueprintValidateJob | BlueprintVerificationJob;
         export interface BlueprintJobEvent {
@@ -325,6 +347,25 @@ declare namespace Components {
          * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
          */
         export type BlueprintJobID = string;
+        /**
+         * A single internal note on a blueprint.
+         */
+        export interface BlueprintNote {
+            /**
+             * Server-generated note id.
+             * example:
+             * 3f1c9b0e-2f3a-4a1f-9a3e-6f2b8c7d1e40
+             */
+            id: string;
+            /**
+             * Plain-text note body.
+             * example:
+             * Adjusted the meter-reading journey for the §14a rollout.
+             */
+            text: string;
+            created_at: string; // date-time
+            created_by?: CallerIdentity;
+        }
         export interface BlueprintPatch {
             patch_id?: string;
             version?: number;
@@ -563,12 +604,12 @@ declare namespace Components {
              * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
              */
             BlueprintID;
-            installation_job_id?: /**
-             * ID of a job
+            /**
+             * Install job this verification is checking, when known.
              * example:
              * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
              */
-            BlueprintJobID;
+            installation_job_id?: string;
             /**
              * Install engine used by the linked installation job, when known.
              */
@@ -907,6 +948,21 @@ declare namespace Components {
                  */
                 postinstall?: string;
             };
+            /**
+             * Internal collaboration notes, oldest first. Append-only: each entry is
+             * stamped with its author and creation time server-side and is never
+             * rewritten, so the history of who noted what stays intact. Written via
+             * `addBlueprintNote` / `deleteBlueprintNote`, not by `updateBlueprint`.
+             *
+             * Available on every blueprint including marketplace ones (whose
+             * `description` is read-only), and never included in the published
+             * marketplace package — see `buildMetadata` in
+             * `services/blueprint-v3/published-blueprint.ts`. Carried to a
+             * destination org only when an install/sync passes
+             * `options.sync_notes: true`.
+             *
+             */
+            notes?: /* A single internal note on a blueprint. */ BlueprintNote[];
             version?: string;
             deployments?: {
                 source_org_id?: string;
@@ -1278,6 +1334,21 @@ declare namespace Components {
                  */
                 postinstall?: string;
             };
+            /**
+             * Internal collaboration notes, oldest first. Append-only: each entry is
+             * stamped with its author and creation time server-side and is never
+             * rewritten, so the history of who noted what stays intact. Written via
+             * `addBlueprintNote` / `deleteBlueprintNote`, not by `updateBlueprint`.
+             *
+             * Available on every blueprint including marketplace ones (whose
+             * `description` is read-only), and never included in the published
+             * marketplace package — see `buildMetadata` in
+             * `services/blueprint-v3/published-blueprint.ts`. Carried to a
+             * destination org only when an install/sync passes
+             * `options.sync_notes: true`.
+             *
+             */
+            notes?: /* A single internal note on a blueprint. */ BlueprintNote[];
             version?: string;
             deployments?: {
                 source_org_id?: string;
@@ -1465,6 +1536,21 @@ declare namespace Components {
                  */
                 postinstall?: string;
             };
+            /**
+             * Internal collaboration notes, oldest first. Append-only: each entry is
+             * stamped with its author and creation time server-side and is never
+             * rewritten, so the history of who noted what stays intact. Written via
+             * `addBlueprintNote` / `deleteBlueprintNote`, not by `updateBlueprint`.
+             *
+             * Available on every blueprint including marketplace ones (whose
+             * `description` is read-only), and never included in the published
+             * marketplace package — see `buildMetadata` in
+             * `services/blueprint-v3/published-blueprint.ts`. Carried to a
+             * destination org only when an install/sync passes
+             * `options.sync_notes: true`.
+             *
+             */
+            notes?: /* A single internal note on a blueprint. */ BlueprintNote[];
             version?: string;
             deployments?: {
                 source_org_id?: string;
@@ -1627,6 +1713,40 @@ declare namespace Components {
             source_type: "deploy";
             resources?: BlueprintResource[];
         }
+        export interface DeploymentHealthReport {
+            status: "running" | "completed" | "failed";
+            job_id: /**
+             * ID of a job
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintJobID;
+            blueprint_instance_id: /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintID;
+            destination_org_id: string;
+            generated_at: string; // date-time
+            /**
+             * Presigned link to the rendered HTML report (present once the check completed)
+             */
+            html_url?: string;
+            summary?: {
+                resources_scanned?: number;
+                unchecked?: number;
+                errors?: number;
+                warnings?: number;
+                infos?: number;
+            };
+            findings?: HealthFinding[];
+            coverage?: HealthScanCoverage;
+            /**
+             * Failure reason when status is `failed`.
+             */
+            error?: string;
+        }
         export interface DetectChangesResult {
             resources?: PatchResourceDiff[];
         }
@@ -1664,6 +1784,21 @@ declare namespace Components {
                  */
                 postinstall?: string;
             };
+            /**
+             * Internal collaboration notes, oldest first. Append-only: each entry is
+             * stamped with its author and creation time server-side and is never
+             * rewritten, so the history of who noted what stays intact. Written via
+             * `addBlueprintNote` / `deleteBlueprintNote`, not by `updateBlueprint`.
+             *
+             * Available on every blueprint including marketplace ones (whose
+             * `description` is read-only), and never included in the published
+             * marketplace package — see `buildMetadata` in
+             * `services/blueprint-v3/published-blueprint.ts`. Carried to a
+             * destination org only when an install/sync passes
+             * `options.sync_notes: true`.
+             *
+             */
+            notes?: /* A single internal note on a blueprint. */ BlueprintNote[];
             version?: string;
             deployments?: {
                 source_org_id?: string;
@@ -1846,6 +1981,75 @@ declare namespace Components {
             name?: string;
             type?: string;
         }
+        export interface HealthCheckCoverage {
+            check_id: "live_readability" | "referential_integrity" | "install_completeness" | "schema_consistency" | "mapping_integrity" | "execution_readiness" | "spec_conformance";
+            status: "completed" | "partial" | "skipped" | "not_applicable";
+            scope: "tracked_resources" | "org_wide" | "source_comparison";
+            resources_considered: number;
+            details: string[];
+        }
+        export interface HealthFinding {
+            check_id: "live_readability" | "referential_integrity" | "install_completeness" | "schema_consistency" | "mapping_integrity" | "execution_readiness" | "catalog_hygiene" | "spec_conformance";
+            code: "missing_in_destination" | "fetch_error" | "no_readback" | "unreplaced_source_reference" | "broken_internal_reference" | "dropped_at_install" | "orphaned_group_reference" | "uuid_group_label" | "unreachable_attribute_purpose" | "duplicate_attribute_name" | "duplicate_headline" | "broken_mapping_reference" | "stale_mapping_version" | "mapping_slot_mismatch" | "mapping_parity_mismatch" | "stale_lineage" | "broken_trigger_reference" | "broken_action_reference" | "broken_workflow_step" | "invalid_mapping_target" | "invalid_mapping_source" | "invalid_mapping_version" | "unknown_mapping_attribute" | "workflow_edge_limit" | "dead_purpose_reference" | "broken_portal_reference" | "orphaned_portal_block" | "broken_closing_reason" | "broken_journey_settings" | "unresolved_assignee" | "current_write_invalid" | "duplicate_live_resource" | "missing_file_content" | "file_etag_mismatch" | "incomplete_webhook" | "broken_template_reference" | "orphaned_price" | "duplicate_price" | "inactive_price_in_use" | "cross_org_reference";
+            severity: "error" | "warning" | "info";
+            resource_type: string;
+            lineage_id: string;
+            target_id?: string;
+            /**
+             * Human-readable name of the affected resource
+             */
+            resource_name?: string;
+            message: string;
+            /**
+             * Mechanical root-cause classification and suggested fix, when determinable
+             */
+            verdict?: string;
+            /**
+             * Check-specific evidence, e.g. the JSON path and referenced id of a broken reference.
+             */
+            evidence?: {
+                path?: string;
+                referenced_id?: string;
+                referenced_type?: string;
+                /**
+                 * Human-readable name or logical slug of the referenced source resource
+                 */
+                referenced_name?: string;
+                /**
+                 * Logical source lineage identity of the referenced resource
+                 */
+                referenced_lineage_id?: string;
+                /**
+                 * Destination id that should have replaced the source reference
+                 */
+                expected_target_id?: string;
+                /**
+                 * Human-readable description of the exact field carrying the reference
+                 */
+                reference_kind?: string;
+                operation?: string;
+                rejection_reason?: string;
+                error_message?: string;
+                response_status?: number;
+            };
+        }
+        export interface HealthResourceTypeCoverage {
+            resource_type: string;
+            tracked: number;
+            readable_by_lineage: number;
+            missing_by_lineage: number;
+            read_errors: number;
+            unchecked: number;
+            specialized_checks: ("live_readability" | "referential_integrity" | "install_completeness" | "schema_consistency" | "mapping_integrity" | "execution_readiness" | "spec_conformance")[];
+            /**
+             * Type-specific contracts the current scanner explicitly does not claim to validate.
+             */
+            known_blind_spots: string[];
+        }
+        export interface HealthScanCoverage {
+            checks: HealthCheckCoverage[];
+            resource_types: HealthResourceTypeCoverage[];
+        }
         /**
          * Summary of an installed marketplace blueprint for version tracking
          */
@@ -2466,6 +2670,21 @@ declare namespace Components {
                  */
                 postinstall?: string;
             };
+            /**
+             * Internal collaboration notes, oldest first. Append-only: each entry is
+             * stamped with its author and creation time server-side and is never
+             * rewritten, so the history of who noted what stays intact. Written via
+             * `addBlueprintNote` / `deleteBlueprintNote`, not by `updateBlueprint`.
+             *
+             * Available on every blueprint including marketplace ones (whose
+             * `description` is read-only), and never included in the published
+             * marketplace package — see `buildMetadata` in
+             * `services/blueprint-v3/published-blueprint.ts`. Carried to a
+             * destination org only when an install/sync passes
+             * `options.sync_notes: true`.
+             *
+             */
+            notes?: /* A single internal note on a blueprint. */ BlueprintNote[];
             version?: string;
             deployments?: {
                 source_org_id?: string;
@@ -3096,6 +3315,31 @@ declare namespace Components {
     }
 }
 declare namespace Paths {
+    namespace AddBlueprintNote {
+        namespace Parameters {
+            export type BlueprintId = /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            Components.Schemas.BlueprintID;
+        }
+        export interface PathParameters {
+            blueprint_id: Parameters.BlueprintId;
+        }
+        export interface RequestBody {
+            /**
+             * Plain-text note body. Must not be blank.
+             */
+            text: string;
+        }
+        namespace Responses {
+            export type $201 = /* A single internal note on a blueprint. */ Components.Schemas.BlueprintNote;
+            export interface $400 {
+                message?: string;
+            }
+        }
+    }
     namespace AddBlueprintResource {
         namespace Parameters {
             /**
@@ -3509,6 +3753,29 @@ declare namespace Paths {
             export type $200 = Components.Schemas.Blueprint;
         }
     }
+    namespace DeleteBlueprintNote {
+        namespace Parameters {
+            export type BlueprintId = /**
+             * ID of a blueprint
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            Components.Schemas.BlueprintID;
+            export type NoteId = string;
+        }
+        export interface PathParameters {
+            blueprint_id: Parameters.BlueprintId;
+            note_id: Parameters.NoteId;
+        }
+        namespace Responses {
+            export interface $200 {
+                notes?: /* A single internal note on a blueprint. */ Components.Schemas.BlueprintNote[];
+            }
+            export interface $404 {
+                message?: string;
+            }
+        }
+    }
     namespace DeleteBlueprintResource {
         namespace Parameters {
             export type BlueprintId = /**
@@ -3790,6 +4057,31 @@ declare namespace Paths {
             }
         }
     }
+    namespace GetDeploymentHealthReportV3 {
+        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.DeploymentHealthReport;
+            export interface $404 {
+            }
+        }
+    }
     namespace GetJob {
         namespace Parameters {
             export type JobId = /**
@@ -4068,6 +4360,7 @@ declare namespace Paths {
              * Auth token for the destination org. Required for cross-org installs where the caller's token belongs to the source org. Defaults to the caller's bearer token.
              */
             destination_auth_token?: string;
+            source_blueprint_type?: "marketplace";
             options?: Components.Schemas.BlueprintInstallationJobOptions;
             /**
              * Slug for marketplace blueprint consistency
@@ -4103,6 +4396,7 @@ declare namespace Paths {
              * Auth token for the destination org. Required for cross-org installs where the caller's token belongs to the source org. Defaults to the caller's bearer token.
              */
             destination_auth_token?: string;
+            source_blueprint_type?: "marketplace";
             options?: Components.Schemas.BlueprintInstallationJobOptions;
             /**
              * Slug for marketplace blueprint consistency
@@ -4320,6 +4614,26 @@ declare namespace Paths {
             export type $200 = /* Preview data for a blueprint before installation. Stored temporarily with TTL. */ Components.Schemas.BlueprintPreview;
         }
     }
+    namespace PreInstallBlueprintV3 {
+        export interface RequestBody {
+            /**
+             * S3 key of a V3 blueprint package previously uploaded through uploadManifest
+             */
+            blueprint_file: string;
+            source_blueprint_type?: "marketplace";
+            /**
+             * Marketplace slug to preserve across updates
+             */
+            slug?: string;
+        }
+        namespace Responses {
+            export type $200 = /* Preview data for a blueprint before installation. Stored temporarily with TTL. */ Components.Schemas.BlueprintPreview;
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+        }
+    }
     namespace PublishBlueprint {
         export interface RequestBody {
             blueprint_id: /**
@@ -4547,6 +4861,41 @@ declare namespace Paths {
             }
         }
     }
+    namespace TriggerDeploymentHealthCheckV3 {
+        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;
+        }
+        export interface RequestBody {
+            /**
+             * Source/sandbox org to deep-compare entity mappings against.
+             */
+            source_org_id?: string;
+            /**
+             * Read token for the source org. Never persisted; used only for this scan.
+             */
+            source_auth_token?: string;
+        }
+        namespace Responses {
+            export type $202 = Components.Schemas.DeploymentHealthReport;
+            export interface $404 {
+            }
+        }
+    }
     namespace UpdateBlueprint {
         namespace Parameters {
             export type BlueprintId = /**
@@ -4732,13 +5081,10 @@ declare namespace Paths {
             destination_auth_token?: string;
             /**
              * Optional install job this verification is checking. If omitted, the latest destination blueprint installation job is used when available.
-             */
-            installation_job_id?: /**
-             * ID of a job
              * example:
              * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
              */
-            Components.Schemas.BlueprintJobID;
+            installation_job_id?: string;
             /**
              * Optional install engine hint. Usually inferred from installation_job_id.
              */
@@ -4965,6 +5311,29 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DeleteBlueprint.Responses.$200>
+  /**
+   * addBlueprintNote - addBlueprintNote
+   * 
+   * Append an internal note to a blueprint. `id`, `created_at` and `created_by`
+   * are stamped server-side from the caller, so notes cannot be backdated or
+   * attributed to someone else. Existing notes are never modified.
+   * 
+   */
+  'addBlueprintNote'(
+    parameters?: Parameters<Paths.AddBlueprintNote.PathParameters> | null,
+    data?: Paths.AddBlueprintNote.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.AddBlueprintNote.Responses.$201>
+  /**
+   * deleteBlueprintNote - deleteBlueprintNote
+   * 
+   * Remove a single internal note from a blueprint.
+   */
+  'deleteBlueprintNote'(
+    parameters?: Parameters<Paths.DeleteBlueprintNote.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteBlueprintNote.Responses.$200>
   /**
    * validateBlueprint - validateBlueprint
    * 
@@ -5206,7 +5575,7 @@ interface OperationMethods {
    * check `sync_engine` (`terraform` | `v3`) to tell them apart. V3 jobs additionally
    * expose live `resource_progress[]`. V3 single-install and bulk-install child jobs
    * are polled here.
-   *
+   * 
    */
   'getBlueprintJob'(
     parameters?: Parameters<Paths.GetBlueprintJob.PathParameters> | null,
@@ -5220,7 +5589,7 @@ interface OperationMethods {
    * planning. Works for both Terraform and V3 jobs. Not needed for V3 installs created
    * with `auto_apply: true` (including all bulk-install child jobs), which apply
    * without pausing.
-   *
+   * 
    */
   'continueInstallationJob'(
     parameters?: Parameters<Paths.ContinueInstallationJob.PathParameters> | null,
@@ -5339,21 +5708,31 @@ interface OperationMethods {
   ): OperationResponse<Paths.PublishMarketplaceListingVersion.Responses.$200>
   /**
    * publishBlueprintV3 - Publish Blueprint V3
-   *
+   * 
    * Starts an asynchronous V3 publication. The result is a signed, portable package; poll the existing blueprint job endpoint for completion.
    */
   'publishBlueprintV3'(
     parameters?: Parameters<Paths.PublishBlueprintV3.PathParameters> | null,
     data?: any,
-    config?: AxiosRequestConfig
+    config?: AxiosRequestConfig  
   ): OperationResponse<Paths.PublishBlueprintV3.Responses.$202>
+  /**
+   * preInstallBlueprintV3 - Preview a V3 blueprint package before installation
+   * 
+   * Validates a signed V3 package and returns the destination-specific resource plan used by the install UI.
+   */
+  'preInstallBlueprintV3'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.PreInstallBlueprintV3.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PreInstallBlueprintV3.Responses.$200>
   /**
    * installBlueprintV3 - Install Blueprint V3
    * 
    * Install a blueprint into a single destination org using the V3 engine (direct API
    * calls, no Terraform). Creates resources in topological order with global ID
    * replacement and supports checkpoint-based resume on failure.
-   *
+   * 
    * **Lifecycle (how to drive an install to completion):**
    * 1. `POST /v3/blueprint-manifest/blueprint:install` returns `{ job_id }` (202).
    * 2. Poll the job with `GET /v2/blueprint-manifest/jobs/{job_id}` — V3 jobs are
@@ -5365,7 +5744,7 @@ interface OperationMethods {
    * 4. If `auto_apply` is `true`, the engine applies automatically after plan +
    *    snapshot — no `:continue` call is needed. This is what the bulk-install worker
    *    uses; to install into many orgs at once prefer `POST .../bulk-installs`.
-   *
+   * 
    * For cross-org installs, pass `destination_auth_token` (the destination org's
    * token); reads use the caller's bearer token, writes use that token.
    * 
@@ -5424,6 +5803,43 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetRestorePreview.Responses.$200>
+  /**
+   * triggerDeploymentHealthCheckV3 - Run a health check on a deployment
+   * 
+   * Starts a read-only health scan of the resources this deployment's
+   * blueprint instance tracks in the destination org (see
+   * docs/rfcs/RFC-org-health-check.md, Phase 0). Checks:
+   * 
+   *   - live readability — every lineage-tracked resource is read back
+   *     via its adapter; tracked-but-unreadable resources are flagged.
+   *   - referential integrity — destination payloads containing
+   *     unreplaced source-org ids, or references to tracked resources
+   *     that are not readable.
+   *   - install completeness — install operations whose final attempt
+   *     ended `failed` or `skipped`, with their rejection reasons.
+   * 
+   * Async — returns 202 immediately with a `running` report stub. Poll
+   * the health-report endpoint until `status` is `completed` or
+   * `failed`. Never mutates any resource.
+   * 
+   */
+  'triggerDeploymentHealthCheckV3'(
+    parameters?: Parameters<Paths.TriggerDeploymentHealthCheckV3.PathParameters> | null,
+    data?: Paths.TriggerDeploymentHealthCheckV3.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.TriggerDeploymentHealthCheckV3.Responses.$202>
+  /**
+   * getDeploymentHealthReportV3 - Get the latest health report of a deployment
+   * 
+   * Returns the most recent health report produced for this deployment
+   * by the `:health-check` endpoint. Idempotent and side-effect free.
+   * 
+   */
+  'getDeploymentHealthReportV3'(
+    parameters?: Parameters<Paths.GetDeploymentHealthReportV3.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetDeploymentHealthReportV3.Responses.$200>
   /**
    * getBlueprintLineageV3 - Get Blueprint Lineage V3
    * 
@@ -5438,61 +5854,61 @@ interface OperationMethods {
   ): OperationResponse<Paths.GetBlueprintLineageV3.Responses.$200>
   /**
    * createBulkInstallV3 - Create Bulk Install V3
-   *
+   * 
    * Install one source blueprint into many destination organizations in a single
    * request. The server schedules child V3 installs with `auto_apply=true` and caps
    * active installs at `max_concurrency`. Per-target failures are isolated and
    * retryable; they do not stop the remaining targets.
-   *
+   * 
    * Each target carries its own write-only `destination_auth_token` (org-scoped).
    * Tokens are passed to the worker via Step Functions input only — they are never
    * persisted in DynamoDB nor returned by any endpoint.
-   *
+   * 
    */
   'createBulkInstallV3'(
     parameters?: Parameters<UnknownParamsObject> | null,
     data?: Paths.CreateBulkInstallV3.RequestBody,
-    config?: AxiosRequestConfig
+    config?: AxiosRequestConfig  
   ): OperationResponse<Paths.CreateBulkInstallV3.Responses.$202>
   /**
    * getBulkInstallV3 - Get Bulk Install V3
-   *
+   * 
    * Returns the bulk install parent with aggregate status and counts. Scoped by the
    * caller org as `source_org_id`. Target rows are not included — use the targets
    * endpoint to page through them.
-   *
+   * 
    */
   'getBulkInstallV3'(
     parameters?: Parameters<Paths.GetBulkInstallV3.PathParameters> | null,
     data?: any,
-    config?: AxiosRequestConfig
+    config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetBulkInstallV3.Responses.$200>
   /**
    * listBulkInstallTargetsV3 - List Bulk Install Targets V3
-   *
+   * 
    * Pages through the bulk install's target rows. Each row hydrates its latest child
    * install job (`job_ids.at(-1)`) with the standard V3 job shape (`events[]`,
    * `resource_progress[]`) so callers can inspect per-resource progress and errors.
-   *
+   * 
    */
   'listBulkInstallTargetsV3'(
     parameters?: Parameters<Paths.ListBulkInstallTargetsV3.QueryParameters & Paths.ListBulkInstallTargetsV3.PathParameters> | null,
     data?: any,
-    config?: AxiosRequestConfig
+    config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ListBulkInstallTargetsV3.Responses.$200>
   /**
    * retryBulkInstallTargetV3 - Retry Bulk Install Target V3
-   *
+   * 
    * Retries a single failed target. Allowed only for `FAILED` and `PARTIAL_SUCCESS`
    * targets. Starts a new child install with `auto_apply=true`, appends its job id to
    * `job_ids`, and reuses the same target row. Only the destination auth token may be
    * supplied for the new attempt; source/destination identifiers are immutable.
-   *
+   * 
    */
   'retryBulkInstallTargetV3'(
     parameters?: Parameters<Paths.RetryBulkInstallTargetV3.PathParameters> | null,
     data?: Paths.RetryBulkInstallTargetV3.RequestBody,
-    config?: AxiosRequestConfig
+    config?: AxiosRequestConfig  
   ): OperationResponse<Paths.RetryBulkInstallTargetV3.Responses.$200>
   /**
    * listUniquenessCriteria - listUniquenessCriteria
@@ -5776,6 +6192,33 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.DeleteBlueprint.Responses.$200>
   }
+  ['/v2/blueprint-manifest/blueprints/{blueprint_id}/notes']: {
+    /**
+     * addBlueprintNote - addBlueprintNote
+     * 
+     * Append an internal note to a blueprint. `id`, `created_at` and `created_by`
+     * are stamped server-side from the caller, so notes cannot be backdated or
+     * attributed to someone else. Existing notes are never modified.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.AddBlueprintNote.PathParameters> | null,
+      data?: Paths.AddBlueprintNote.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.AddBlueprintNote.Responses.$201>
+  }
+  ['/v2/blueprint-manifest/blueprints/{blueprint_id}/notes/{note_id}']: {
+    /**
+     * deleteBlueprintNote - deleteBlueprintNote
+     * 
+     * Remove a single internal note from a blueprint.
+     */
+    'delete'(
+      parameters?: Parameters<Paths.DeleteBlueprintNote.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteBlueprintNote.Responses.$200>
+  }
   ['/v2/blueprint-manifest/blueprints/{blueprint_id}/validate']: {
     /**
      * validateBlueprint - validateBlueprint
@@ -6052,7 +6495,7 @@ interface PathsDictionary {
      * check `sync_engine` (`terraform` | `v3`) to tell them apart. V3 jobs additionally
      * expose live `resource_progress[]`. V3 single-install and bulk-install child jobs
      * are polled here.
-     *
+     * 
      */
     'get'(
       parameters?: Parameters<Paths.GetBlueprintJob.PathParameters> | null,
@@ -6068,7 +6511,7 @@ interface PathsDictionary {
      * planning. Works for both Terraform and V3 jobs. Not needed for V3 installs created
      * with `auto_apply: true` (including all bulk-install child jobs), which apply
      * without pausing.
-     *
+     * 
      */
     'post'(
       parameters?: Parameters<Paths.ContinueInstallationJob.PathParameters> | null,
@@ -6203,15 +6646,27 @@ interface PathsDictionary {
   ['/v3/blueprint-manifest/blueprints/{blueprint_id}:publish']: {
     /**
      * publishBlueprintV3 - Publish Blueprint V3
-     *
+     * 
      * Starts an asynchronous V3 publication. The result is a signed, portable package; poll the existing blueprint job endpoint for completion.
      */
     'post'(
       parameters?: Parameters<Paths.PublishBlueprintV3.PathParameters> | null,
       data?: any,
-      config?: AxiosRequestConfig
+      config?: AxiosRequestConfig  
     ): OperationResponse<Paths.PublishBlueprintV3.Responses.$202>
   }
+  ['/v3/blueprint-manifest/blueprints:pre-install']: {
+    /**
+     * preInstallBlueprintV3 - Preview a V3 blueprint package before installation
+     * 
+     * Validates a signed V3 package and returns the destination-specific resource plan used by the install UI.
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.PreInstallBlueprintV3.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PreInstallBlueprintV3.Responses.$200>
+  }
   ['/v3/blueprint-manifest/blueprint:install']: {
     /**
      * installBlueprintV3 - Install Blueprint V3
@@ -6219,7 +6674,7 @@ interface PathsDictionary {
      * Install a blueprint into a single destination org using the V3 engine (direct API
      * calls, no Terraform). Creates resources in topological order with global ID
      * replacement and supports checkpoint-based resume on failure.
-     *
+     * 
      * **Lifecycle (how to drive an install to completion):**
      * 1. `POST /v3/blueprint-manifest/blueprint:install` returns `{ job_id }` (202).
      * 2. Poll the job with `GET /v2/blueprint-manifest/jobs/{job_id}` — V3 jobs are
@@ -6231,7 +6686,7 @@ interface PathsDictionary {
      * 4. If `auto_apply` is `true`, the engine applies automatically after plan +
      *    snapshot — no `:continue` call is needed. This is what the bulk-install worker
      *    uses; to install into many orgs at once prefer `POST .../bulk-installs`.
-     *
+     * 
      * For cross-org installs, pass `destination_auth_token` (the destination org's
      * token); reads use the caller's bearer token, writes use that token.
      * 
@@ -6295,6 +6750,47 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetRestorePreview.Responses.$200>
   }
+  ['/v3/blueprint-manifest/blueprints/{blueprint_id}/deployments/{job_id}:health-check']: {
+    /**
+     * triggerDeploymentHealthCheckV3 - Run a health check on a deployment
+     * 
+     * Starts a read-only health scan of the resources this deployment's
+     * blueprint instance tracks in the destination org (see
+     * docs/rfcs/RFC-org-health-check.md, Phase 0). Checks:
+     * 
+     *   - live readability — every lineage-tracked resource is read back
+     *     via its adapter; tracked-but-unreadable resources are flagged.
+     *   - referential integrity — destination payloads containing
+     *     unreplaced source-org ids, or references to tracked resources
+     *     that are not readable.
+     *   - install completeness — install operations whose final attempt
+     *     ended `failed` or `skipped`, with their rejection reasons.
+     * 
+     * Async — returns 202 immediately with a `running` report stub. Poll
+     * the health-report endpoint until `status` is `completed` or
+     * `failed`. Never mutates any resource.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.TriggerDeploymentHealthCheckV3.PathParameters> | null,
+      data?: Paths.TriggerDeploymentHealthCheckV3.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.TriggerDeploymentHealthCheckV3.Responses.$202>
+  }
+  ['/v3/blueprint-manifest/blueprints/{blueprint_id}/deployments/{job_id}/health-report']: {
+    /**
+     * getDeploymentHealthReportV3 - Get the latest health report of a deployment
+     * 
+     * Returns the most recent health report produced for this deployment
+     * by the `:health-check` endpoint. Idempotent and side-effect free.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetDeploymentHealthReportV3.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetDeploymentHealthReportV3.Responses.$200>
+  }
   ['/v3/blueprint-manifest/blueprints/{blueprint_id}/lineage']: {
     /**
      * getBlueprintLineageV3 - Get Blueprint Lineage V3
@@ -6312,67 +6808,67 @@ interface PathsDictionary {
   ['/v3/blueprint-manifest/bulk-installs']: {
     /**
      * createBulkInstallV3 - Create Bulk Install V3
-     *
+     * 
      * Install one source blueprint into many destination organizations in a single
      * request. The server schedules child V3 installs with `auto_apply=true` and caps
      * active installs at `max_concurrency`. Per-target failures are isolated and
      * retryable; they do not stop the remaining targets.
-     *
+     * 
      * Each target carries its own write-only `destination_auth_token` (org-scoped).
      * Tokens are passed to the worker via Step Functions input only — they are never
      * persisted in DynamoDB nor returned by any endpoint.
-     *
+     * 
      */
     'post'(
       parameters?: Parameters<UnknownParamsObject> | null,
       data?: Paths.CreateBulkInstallV3.RequestBody,
-      config?: AxiosRequestConfig
+      config?: AxiosRequestConfig  
     ): OperationResponse<Paths.CreateBulkInstallV3.Responses.$202>
   }
   ['/v3/blueprint-manifest/bulk-installs/{bulk_job_id}']: {
     /**
      * getBulkInstallV3 - Get Bulk Install V3
-     *
+     * 
      * Returns the bulk install parent with aggregate status and counts. Scoped by the
      * caller org as `source_org_id`. Target rows are not included — use the targets
      * endpoint to page through them.
-     *
+     * 
      */
     'get'(
       parameters?: Parameters<Paths.GetBulkInstallV3.PathParameters> | null,
       data?: any,
-      config?: AxiosRequestConfig
+      config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetBulkInstallV3.Responses.$200>
   }
   ['/v3/blueprint-manifest/bulk-installs/{bulk_job_id}/targets']: {
     /**
      * listBulkInstallTargetsV3 - List Bulk Install Targets V3
-     *
+     * 
      * Pages through the bulk install's target rows. Each row hydrates its latest child
      * install job (`job_ids.at(-1)`) with the standard V3 job shape (`events[]`,
      * `resource_progress[]`) so callers can inspect per-resource progress and errors.
-     *
+     * 
      */
     'get'(
       parameters?: Parameters<Paths.ListBulkInstallTargetsV3.QueryParameters & Paths.ListBulkInstallTargetsV3.PathParameters> | null,
       data?: any,
-      config?: AxiosRequestConfig
+      config?: AxiosRequestConfig  
     ): OperationResponse<Paths.ListBulkInstallTargetsV3.Responses.$200>
   }
   ['/v3/blueprint-manifest/bulk-installs/{bulk_job_id}/targets/{destination_org_id}:retry']: {
     /**
      * retryBulkInstallTargetV3 - Retry Bulk Install Target V3
-     *
+     * 
      * Retries a single failed target. Allowed only for `FAILED` and `PARTIAL_SUCCESS`
      * targets. Starts a new child install with `auto_apply=true`, appends its job id to
      * `job_ids`, and reuses the same target row. Only the destination auth token may be
      * supplied for the new attempt; source/destination identifiers are immutable.
-     *
+     * 
      */
     'post'(
       parameters?: Parameters<Paths.RetryBulkInstallTargetV3.PathParameters> | null,
       data?: Paths.RetryBulkInstallTargetV3.RequestBody,
-      config?: AxiosRequestConfig
+      config?: AxiosRequestConfig  
     ): OperationResponse<Paths.RetryBulkInstallTargetV3.Responses.$200>
   }
   ['/v1/blueprint-manifest/uniqueness-criteria']: {
@@ -6442,6 +6938,7 @@ type BlueprintInstallationJobOptions = Components.Schemas.BlueprintInstallationJ
 type BlueprintJob = Components.Schemas.BlueprintJob;
 type BlueprintJobEvent = Components.Schemas.BlueprintJobEvent;
 type BlueprintJobID = Components.Schemas.BlueprintJobID;
+type BlueprintNote = Components.Schemas.BlueprintNote;
 type BlueprintPatch = Components.Schemas.BlueprintPatch;
 type BlueprintPatchWithResults = Components.Schemas.BlueprintPatchWithResults;
 type BlueprintPreview = Components.Schemas.BlueprintPreview;
@@ -6466,12 +6963,17 @@ type CommonMarkdownFields = Components.Schemas.CommonMarkdownFields;
 type CommonResourceNode = Components.Schemas.CommonResourceNode;
 type CustomBlueprint = Components.Schemas.CustomBlueprint;
 type DeployedBlueprint = Components.Schemas.DeployedBlueprint;
+type DeploymentHealthReport = Components.Schemas.DeploymentHealthReport;
 type DetectChangesResult = Components.Schemas.DetectChangesResult;
 type FieldDiff = Components.Schemas.FieldDiff;
 type FileBlueprint = Components.Schemas.FileBlueprint;
 type FormattedError = Components.Schemas.FormattedError;
 type FormattedErrorCodes = Components.Schemas.FormattedErrorCodes;
 type FormattedErrorData = Components.Schemas.FormattedErrorData;
+type HealthCheckCoverage = Components.Schemas.HealthCheckCoverage;
+type HealthFinding = Components.Schemas.HealthFinding;
+type HealthResourceTypeCoverage = Components.Schemas.HealthResourceTypeCoverage;
+type HealthScanCoverage = Components.Schemas.HealthScanCoverage;
 type InstalledMarketplaceBlueprintItem = Components.Schemas.InstalledMarketplaceBlueprintItem;
 type Job = Components.Schemas.Job;
 type JobID = Components.Schemas.JobID;
@@ -6511,4 +7013,4 @@ type V3ResourceProgressEntry = Components.Schemas.V3ResourceProgressEntry;
 type VerificationSummary = Components.Schemas.VerificationSummary;
 type VirtualResourceNodeGroup = Components.Schemas.VirtualResourceNodeGroup;
 
-export { type ManifestID as $, type AppBlueprint as A, type Blueprint as B, type Client as C, type CallerIdentity as D, type CommonBlueprintFields as E, type CommonBlueprintJobFields as F, type CommonImportFields as G, type CommonManifestFields as H, type CommonMarkdownFields as I, type CommonResourceNode as J, type CustomBlueprint as K, type DeployedBlueprint as L, type DetectChangesResult as M, type FieldDiff as N, type OperationMethods as O, Paths as P, type FileBlueprint as Q, type FormattedError as R, type FormattedErrorCodes as S, type FormattedErrorData as T, type InstalledMarketplaceBlueprintItem as U, type Job as V, type JobID as W, type JobStatus as X, type LatestBlueprintVerification as Y, type LineageEntry as Z, type Manifest as _, Components as a, type ManifestItem as a0, type ManifestSource as a1, type ManifestTimestampFields as a2, type MarketplaceBlueprint as a3, type MarketplaceListing as a4, type MarketplaceListingUpdate as a5, type MarketplaceListingVersion as a6, type OrgPatchExecution as a7, type PatchFieldDiff as a8, type PatchResourceDiff as a9, type PlanChanges as aa, type PreInstallRequirements as ab, type PutManifestPayload as ac, type ResourceNode as ad, type ResourceNodeType as ae, type ResourceReplacement as af, type ResourceVerificationResult as ag, type RestoreOutcome as ah, type RestoreOutcomeItem as ai, type RootResourceNode as aj, type S3Reference as ak, type SelectedResources as al, type SuggestBlueprintResourcesRequest as am, type SuggestBlueprintResourcesResponse as an, type UniquenessCriteria as ao, type UniquenessCriteriaResourceType as ap, type UploadFilePayload as aq, type V3ResourceProgressEntry as ar, type VerificationSummary as as, type VirtualResourceNodeGroup as at, 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 BulkInstall as t, type BulkInstallCounts as u, type BulkInstallCreateRequest as v, type BulkInstallStatus as w, type BulkInstallTarget as x, type BulkInstallTargetInput as y, type BulkInstallTargetList as z };
+export { type Job as $, type AppBlueprint as A, type Blueprint as B, type Client as C, type BulkInstallTargetList as D, type CallerIdentity as E, type CommonBlueprintFields as F, type CommonBlueprintJobFields as G, type CommonImportFields as H, type CommonManifestFields as I, type CommonMarkdownFields as J, type CommonResourceNode as K, type CustomBlueprint as L, type DeployedBlueprint as M, type DeploymentHealthReport as N, type OperationMethods as O, Paths as P, type DetectChangesResult as Q, type FieldDiff as R, type FileBlueprint as S, type FormattedError as T, type FormattedErrorCodes as U, type FormattedErrorData as V, type HealthCheckCoverage as W, type HealthFinding as X, type HealthResourceTypeCoverage as Y, type HealthScanCoverage as Z, type InstalledMarketplaceBlueprintItem as _, Components as a, type JobID as a0, type JobStatus as a1, type LatestBlueprintVerification as a2, type LineageEntry as a3, type Manifest as a4, type ManifestID as a5, type ManifestItem as a6, type ManifestSource as a7, type ManifestTimestampFields as a8, type MarketplaceBlueprint as a9, type MarketplaceListing as aa, type MarketplaceListingUpdate as ab, type MarketplaceListingVersion as ac, type OrgPatchExecution as ad, type PatchFieldDiff as ae, type PatchResourceDiff as af, type PlanChanges as ag, type PreInstallRequirements as ah, type PutManifestPayload as ai, type ResourceNode as aj, type ResourceNodeType as ak, type ResourceReplacement as al, type ResourceVerificationResult as am, type RestoreOutcome as an, type RestoreOutcomeItem as ao, type RootResourceNode as ap, type S3Reference as aq, type SelectedResources as ar, type SuggestBlueprintResourcesRequest as as, type SuggestBlueprintResourcesResponse as at, type UniquenessCriteria as au, type UniquenessCriteriaResourceType as av, type UploadFilePayload as aw, type V3ResourceProgressEntry as ax, type VerificationSummary as ay, type VirtualResourceNodeGroup as az, 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 BlueprintNote as l, type BlueprintPatch as m, type BlueprintPatchWithResults as n, type BlueprintPreview as o, type BlueprintResource as p, type BlueprintResourceID as q, type BlueprintRestoreJob as r, type BlueprintValidateJob as s, type BlueprintVerificationJob as t, type BulkInstall as u, type BulkInstallCounts as v, type BulkInstallCreateRequest as w, type BulkInstallStatus as x, type BulkInstallTarget as y, type BulkInstallTargetInput as z };