@epilot/sdk 2.18.1 → 2.18.3

package/dist/{blueprint-manifest.d-BiaeSTI3.d.ts → blueprint-manifest.d-CjsI-JqR.d.ts}

@@ -42,10 +42,11 @@ 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`.
+             * Internal collaboration notes, oldest first. Each entry is stamped with
+             * its author and creation time server-side; an edit rewrites only `text`
+             * and stamps `updated_at`, so the history of who noted what stays intact.
+             * Written via `addBlueprintNote` / `updateBlueprintNote` /
+             * `deleteBlueprintNote`, not by `updateBlueprint`.
              *
              * Available on every blueprint including marketplace ones (whose
              * `description` is read-only), and never included in the published
@@ -67,6 +68,38 @@ declare namespace Components {
                  */
                 job_id?: string;
                 triggered_at?: string; // date-time
+                /**
+                 * Who actually ran this synchronization — the caller of the install job.
+                 * Absent on deployments recorded before this field existed; consumers
+                 * should fall back to the blueprint's `updated_by` for those.
+                 *
+                 */
+                performed_by?: {
+                    /**
+                     * a human readable name of the caller (e.g. user name, token name or email address)
+                     * example:
+                     * manifest@epilot.cloud
+                     */
+                    name?: any;
+                    /**
+                     * epilot organization id
+                     * example:
+                     * 911690
+                     */
+                    org_id: string;
+                    /**
+                     * epilot user id, when called by a user
+                     * example:
+                     * 11001045
+                     */
+                    user_id?: string;
+                    /**
+                     * token id, when called by API token
+                     * example:
+                     * api_5ZugdRXasLfWBypHi93Fk
+                     */
+                    token_id?: string;
+                };
                 /**
                  * User-provided note about this synchronization
                  */
@@ -364,6 +397,10 @@ declare namespace Components {
              */
             text: string;
             created_at: string; // date-time
+            /**
+             * Set the first time the note text is edited.
+             */
+            updated_at?: string; // date-time
             created_by?: CallerIdentity;
         }
         export interface BlueprintPatch {
@@ -426,6 +463,10 @@ declare namespace Components {
             version?: string;
             slug?: string;
             source_type: "marketplace" | "file";
+            /**
+             * Engine that must install this preview, detected from the uploaded archive's own format (never from a feature flag or request parameter). `v3` is only reported for a correctly shaped and validly signed V3 package. Clients must install a `v3` preview through `POST /v3/blueprint-manifest/blueprint:install` and a `terraform` preview through `POST /v2/blueprint-manifest/blueprints:install`. Absent only on previews created before format detection shipped; treat an absent value as `terraform`.
+             */
+            sync_engine?: "terraform" | "v3";
             /**
              * S3 key of the blueprint zip file
              */
@@ -949,10 +990,11 @@ 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`.
+             * Internal collaboration notes, oldest first. Each entry is stamped with
+             * its author and creation time server-side; an edit rewrites only `text`
+             * and stamps `updated_at`, so the history of who noted what stays intact.
+             * Written via `addBlueprintNote` / `updateBlueprintNote` /
+             * `deleteBlueprintNote`, not by `updateBlueprint`.
              *
              * Available on every blueprint including marketplace ones (whose
              * `description` is read-only), and never included in the published
@@ -974,6 +1016,38 @@ declare namespace Components {
                  */
                 job_id?: string;
                 triggered_at?: string; // date-time
+                /**
+                 * Who actually ran this synchronization — the caller of the install job.
+                 * Absent on deployments recorded before this field existed; consumers
+                 * should fall back to the blueprint's `updated_by` for those.
+                 *
+                 */
+                performed_by?: {
+                    /**
+                     * a human readable name of the caller (e.g. user name, token name or email address)
+                     * example:
+                     * manifest@epilot.cloud
+                     */
+                    name?: any;
+                    /**
+                     * epilot organization id
+                     * example:
+                     * 911690
+                     */
+                    org_id: string;
+                    /**
+                     * epilot user id, when called by a user
+                     * example:
+                     * 11001045
+                     */
+                    user_id?: string;
+                    /**
+                     * token id, when called by API token
+                     * example:
+                     * api_5ZugdRXasLfWBypHi93Fk
+                     */
+                    token_id?: string;
+                };
                 /**
                  * User-provided note about this synchronization
                  */
@@ -1335,10 +1409,11 @@ 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`.
+             * Internal collaboration notes, oldest first. Each entry is stamped with
+             * its author and creation time server-side; an edit rewrites only `text`
+             * and stamps `updated_at`, so the history of who noted what stays intact.
+             * Written via `addBlueprintNote` / `updateBlueprintNote` /
+             * `deleteBlueprintNote`, not by `updateBlueprint`.
              *
              * Available on every blueprint including marketplace ones (whose
              * `description` is read-only), and never included in the published
@@ -1360,6 +1435,38 @@ declare namespace Components {
                  */
                 job_id?: string;
                 triggered_at?: string; // date-time
+                /**
+                 * Who actually ran this synchronization — the caller of the install job.
+                 * Absent on deployments recorded before this field existed; consumers
+                 * should fall back to the blueprint's `updated_by` for those.
+                 *
+                 */
+                performed_by?: {
+                    /**
+                     * a human readable name of the caller (e.g. user name, token name or email address)
+                     * example:
+                     * manifest@epilot.cloud
+                     */
+                    name?: any;
+                    /**
+                     * epilot organization id
+                     * example:
+                     * 911690
+                     */
+                    org_id: string;
+                    /**
+                     * epilot user id, when called by a user
+                     * example:
+                     * 11001045
+                     */
+                    user_id?: string;
+                    /**
+                     * token id, when called by API token
+                     * example:
+                     * api_5ZugdRXasLfWBypHi93Fk
+                     */
+                    token_id?: string;
+                };
                 /**
                  * User-provided note about this synchronization
                  */
@@ -1537,10 +1644,11 @@ 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`.
+             * Internal collaboration notes, oldest first. Each entry is stamped with
+             * its author and creation time server-side; an edit rewrites only `text`
+             * and stamps `updated_at`, so the history of who noted what stays intact.
+             * Written via `addBlueprintNote` / `updateBlueprintNote` /
+             * `deleteBlueprintNote`, not by `updateBlueprint`.
              *
              * Available on every blueprint including marketplace ones (whose
              * `description` is read-only), and never included in the published
@@ -1562,6 +1670,38 @@ declare namespace Components {
                  */
                 job_id?: string;
                 triggered_at?: string; // date-time
+                /**
+                 * Who actually ran this synchronization — the caller of the install job.
+                 * Absent on deployments recorded before this field existed; consumers
+                 * should fall back to the blueprint's `updated_by` for those.
+                 *
+                 */
+                performed_by?: {
+                    /**
+                     * a human readable name of the caller (e.g. user name, token name or email address)
+                     * example:
+                     * manifest@epilot.cloud
+                     */
+                    name?: any;
+                    /**
+                     * epilot organization id
+                     * example:
+                     * 911690
+                     */
+                    org_id: string;
+                    /**
+                     * epilot user id, when called by a user
+                     * example:
+                     * 11001045
+                     */
+                    user_id?: string;
+                    /**
+                     * token id, when called by API token
+                     * example:
+                     * api_5ZugdRXasLfWBypHi93Fk
+                     */
+                    token_id?: string;
+                };
                 /**
                  * User-provided note about this synchronization
                  */
@@ -1785,10 +1925,11 @@ 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`.
+             * Internal collaboration notes, oldest first. Each entry is stamped with
+             * its author and creation time server-side; an edit rewrites only `text`
+             * and stamps `updated_at`, so the history of who noted what stays intact.
+             * Written via `addBlueprintNote` / `updateBlueprintNote` /
+             * `deleteBlueprintNote`, not by `updateBlueprint`.
              *
              * Available on every blueprint including marketplace ones (whose
              * `description` is read-only), and never included in the published
@@ -1810,6 +1951,38 @@ declare namespace Components {
                  */
                 job_id?: string;
                 triggered_at?: string; // date-time
+                /**
+                 * Who actually ran this synchronization — the caller of the install job.
+                 * Absent on deployments recorded before this field existed; consumers
+                 * should fall back to the blueprint's `updated_by` for those.
+                 *
+                 */
+                performed_by?: {
+                    /**
+                     * a human readable name of the caller (e.g. user name, token name or email address)
+                     * example:
+                     * manifest@epilot.cloud
+                     */
+                    name?: any;
+                    /**
+                     * epilot organization id
+                     * example:
+                     * 911690
+                     */
+                    org_id: string;
+                    /**
+                     * epilot user id, when called by a user
+                     * example:
+                     * 11001045
+                     */
+                    user_id?: string;
+                    /**
+                     * token id, when called by API token
+                     * example:
+                     * api_5ZugdRXasLfWBypHi93Fk
+                     */
+                    token_id?: string;
+                };
                 /**
                  * User-provided note about this synchronization
                  */
@@ -2671,10 +2844,11 @@ 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`.
+             * Internal collaboration notes, oldest first. Each entry is stamped with
+             * its author and creation time server-side; an edit rewrites only `text`
+             * and stamps `updated_at`, so the history of who noted what stays intact.
+             * Written via `addBlueprintNote` / `updateBlueprintNote` /
+             * `deleteBlueprintNote`, not by `updateBlueprint`.
              *
              * Available on every blueprint including marketplace ones (whose
              * `description` is read-only), and never included in the published
@@ -2696,6 +2870,38 @@ declare namespace Components {
                  */
                 job_id?: string;
                 triggered_at?: string; // date-time
+                /**
+                 * Who actually ran this synchronization — the caller of the install job.
+                 * Absent on deployments recorded before this field existed; consumers
+                 * should fall back to the blueprint's `updated_by` for those.
+                 *
+                 */
+                performed_by?: {
+                    /**
+                     * a human readable name of the caller (e.g. user name, token name or email address)
+                     * example:
+                     * manifest@epilot.cloud
+                     */
+                    name?: any;
+                    /**
+                     * epilot organization id
+                     * example:
+                     * 911690
+                     */
+                    org_id: string;
+                    /**
+                     * epilot user id, when called by a user
+                     * example:
+                     * 11001045
+                     */
+                    user_id?: string;
+                    /**
+                     * token id, when called by API token
+                     * example:
+                     * api_5ZugdRXasLfWBypHi93Fk
+                     */
+                    token_id?: string;
+                };
                 /**
                  * User-provided note about this synchronization
                  */
@@ -3054,7 +3260,7 @@ declare namespace Components {
         /**
          * Type of the resource
          */
-        export type ResourceNodeType = "designbuilder" | "journey" | "product" | "price" | "product_recommendation" | "coupon" | "tax" | "automation_flow" | "entity_mapping" | "file" | "emailtemplate" | "schema" | "schema_attribute" | "schema_capability" | "schema_group" | "schema_group_headline" | "workflow_definition" | "closing_reason" | "taxonomy_classification" | "webhook" | "integration" | "dashboard" | "custom_variable" | "usergroup" | "saved_view" | "app" | "role" | "portal_config" | "target" | "kanban" | "validation_rule" | "flow_template" | "taxonomy" | "notification_template" | "environment_variable" | "datasource" | "family" | "permission";
+        export type ResourceNodeType = "designbuilder" | "journey" | "product" | "price" | "product_recommendation" | "coupon" | "tax" | "automation_flow" | "entity_mapping" | "file" | "emailtemplate" | "schema" | "schema_attribute" | "schema_capability" | "schema_group" | "schema_group_headline" | "workflow_definition" | "closing_reason" | "taxonomy_classification" | "webhook" | "integration" | "dashboard" | "insight" | "custom_variable" | "usergroup" | "saved_view" | "app" | "role" | "portal_config" | "target" | "kanban" | "validation_rule" | "flow_template" | "taxonomy" | "notification_template" | "environment_variable" | "datasource" | "family" | "permission";
         export interface ResourceReplacement {
             /**
              * Original resource ID to be replaced
@@ -3212,6 +3418,21 @@ declare namespace Components {
              */
             pipeline_id?: string;
         }
+        /**
+         * A resource that was requested (or discovered as a dependency) but was not
+         * added to the Blueprint. Reasons are stable machine-readable codes.
+         *
+         */
+        export interface SkippedBlueprintResource {
+            id: /**
+             * ID of a blueprint resource
+             * example:
+             * c2d6cac8-bdd5-4ea2-8a6c-1cbdbe77b341
+             */
+            BlueprintResourceID;
+            type: /* Type of the resource */ ResourceNodeType;
+            reason: "not_found" | "source_validation_failed" | "enrichment_failed";
+        }
         export interface SuggestBlueprintResourcesRequest {
             /**
              * Natural-language description of what to include.
@@ -3363,6 +3584,27 @@ declare namespace Paths {
         namespace Responses {
             export interface $200 {
                 resources?: Components.Schemas.BlueprintResource[];
+                /**
+                 * Resources that were dropped during enrichment instead of being added
+                 */
+                skipped?: /**
+                 * A resource that was requested (or discovered as a dependency) but was not
+                 * added to the Blueprint. Reasons are stable machine-readable codes.
+                 *
+                 */
+                Components.Schemas.SkippedBlueprintResource[];
+                /**
+                 * Non-fatal dependency extraction failures encountered while enriching, deduplicated and capped. The listed resources were still added; some of their dependencies may be missing.
+                 */
+                errors?: Components.Schemas.FormattedError[];
+                /**
+                 * Total distinct dependency errors, before the cap applied to `errors`
+                 */
+                total_errors?: number;
+                /**
+                 * Whether `errors` omits some of the distinct errors counted by `total_errors`
+                 */
+                errors_truncated?: boolean;
             }
         }
     }
@@ -3450,6 +3692,27 @@ declare namespace Paths {
         namespace Responses {
             export interface $200 {
                 resources?: Components.Schemas.BlueprintResource[];
+                /**
+                 * Resources that were dropped during enrichment instead of being added
+                 */
+                skipped?: /**
+                 * A resource that was requested (or discovered as a dependency) but was not
+                 * added to the Blueprint. Reasons are stable machine-readable codes.
+                 *
+                 */
+                Components.Schemas.SkippedBlueprintResource[];
+                /**
+                 * Non-fatal dependency extraction failures encountered while enriching, deduplicated and capped. The listed resources were still added; some of their dependencies may be missing.
+                 */
+                errors?: Components.Schemas.FormattedError[];
+                /**
+                 * Total distinct dependency errors, before the cap applied to `errors`
+                 */
+                total_errors?: number;
+                /**
+                 * Whether `errors` omits some of the distinct errors counted by `total_errors`
+                 */
+                errors_truncated?: boolean;
             }
         }
     }
@@ -4612,6 +4875,8 @@ declare namespace Paths {
         }
         namespace Responses {
             export type $200 = /* Preview data for a blueprint before installation. Stored temporarily with TTL. */ Components.Schemas.BlueprintPreview;
+            export interface $400 {
+            }
         }
     }
     namespace PreInstallBlueprintV3 {
@@ -4678,6 +4943,14 @@ declare namespace Paths {
         export interface PathParameters {
             blueprint_id: Parameters.BlueprintId;
         }
+        export interface RequestBody {
+            /**
+             * When true, upload the package with public access and create or overwrite the
+             * blueprint's Webflow CMS listing. Leave unset for a download-only package build.
+             *
+             */
+            publish_to_marketplace?: boolean;
+        }
         namespace Responses {
             export interface $202 {
                 job_id: /**
@@ -4913,6 +5186,36 @@ declare namespace Paths {
             export type $200 = Components.Schemas.Blueprint;
         }
     }
+    namespace UpdateBlueprintNote {
+        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;
+        }
+        export interface RequestBody {
+            /**
+             * Plain-text note body. Must not be blank.
+             */
+            text: string;
+        }
+        namespace Responses {
+            export type $200 = /* A single internal note on a blueprint. */ Components.Schemas.BlueprintNote;
+            export interface $400 {
+                message?: string;
+            }
+            export interface $404 {
+                message?: string;
+            }
+        }
+    }
     namespace UpdateBlueprintResource {
         namespace Parameters {
             export type BlueprintId = /**
@@ -5253,7 +5556,7 @@ interface OperationMethods {
   /**
    * preInstallBlueprint - preInstallBlueprint
    * 
-   * Pre-install a Blueprint based on a blueprint file
+   * Pre-install a Blueprint based on a blueprint file. Format-agnostic: the engine is detected from the uploaded archive, so this endpoint accepts both Terraform exports and signed V3 packages. The returned preview's `sync_engine` says which install endpoint to call next. An archive that is neither a Terraform export nor a validly signed V3 package is rejected with 400.
    */
   'preInstallBlueprint'(
     parameters?: Parameters<UnknownParamsObject> | null,
@@ -5324,6 +5627,19 @@ interface OperationMethods {
     data?: Paths.AddBlueprintNote.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.AddBlueprintNote.Responses.$201>
+  /**
+   * updateBlueprintNote - updateBlueprintNote
+   * 
+   * Rewrite the text of an existing internal note. The note keeps its position in
+   * the list along with `created_at` and `created_by`, so an edit cannot reassign
+   * authorship; `updated_at` is stamped server-side.
+   * 
+   */
+  'updateBlueprintNote'(
+    parameters?: Parameters<Paths.UpdateBlueprintNote.PathParameters> | null,
+    data?: Paths.UpdateBlueprintNote.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.UpdateBlueprintNote.Responses.$200>
   /**
    * deleteBlueprintNote - deleteBlueprintNote
    * 
@@ -5559,7 +5875,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DeleteBlueprintResource.Responses.$200>
   /**
-   * listBlueprintJobs - List Blueprint Jobs
+   * listBlueprintJobs - listBlueprintJobs
    * 
    * List all blueprint jobs
    */
@@ -5569,7 +5885,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ListBlueprintJobs.Responses.$200>
   /**
-   * getBlueprintJob - Get Job
+   * getBlueprintJob - getBlueprintJob
    * 
    * Poll the current state of a job. Serves both Terraform (v2) and V3-engine jobs —
    * check `sync_engine` (`terraform` | `v3`) to tell them apart. V3 jobs additionally
@@ -5583,7 +5899,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetBlueprintJob.Responses.$200>
   /**
-   * continueInstallationJob - Continue Installation Job
+   * continueInstallationJob - continueInstallationJob
    * 
    * Resume an installation job that is paused at `status: "WAITING_USER_ACTION"` after
    * planning. Works for both Terraform and V3 jobs. Not needed for V3 installs created
@@ -5597,7 +5913,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ContinueInstallationJob.Responses.$200>
   /**
-   * cancelBlueprintJob - Cancel Blueprint Job
+   * cancelBlueprintJob - cancelBlueprintJob
    * 
    * Cancel a blueprint job if it is still running.
    */
@@ -5707,17 +6023,21 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.PublishMarketplaceListingVersion.Responses.$200>
   /**
-   * publishBlueprintV3 - Publish Blueprint V3
+   * publishBlueprintV3 - publishBlueprintV3
    * 
    * Starts an asynchronous V3 publication. The result is a signed, portable package; poll the existing blueprint job endpoint for completion.
+   * 
+   * By default this only builds the package and stores it privately for download. Creating or
+   * overwriting the public marketplace listing is opt-in via `publish_to_marketplace`.
+   * 
    */
   'publishBlueprintV3'(
     parameters?: Parameters<Paths.PublishBlueprintV3.PathParameters> | null,
-    data?: any,
+    data?: Paths.PublishBlueprintV3.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.PublishBlueprintV3.Responses.$202>
   /**
-   * preInstallBlueprintV3 - Preview a V3 blueprint package before installation
+   * preInstallBlueprintV3 - preInstallBlueprintV3
    * 
    * Validates a signed V3 package and returns the destination-specific resource plan used by the install UI.
    */
@@ -5727,7 +6047,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.PreInstallBlueprintV3.Responses.$200>
   /**
-   * installBlueprintV3 - Install Blueprint V3
+   * installBlueprintV3 - installBlueprintV3
    * 
    * 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
@@ -5755,7 +6075,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.InstallBlueprintV3.Responses.$202>
   /**
-   * restoreBlueprintDeploymentV3 - Restore a specific deployment by job_id
+   * restoreBlueprintDeploymentV3 - restoreBlueprintDeploymentV3
    * 
    * Roll a deployment back to its pre-install state. Two phases:
    * 
@@ -5785,7 +6105,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.RestoreBlueprintDeploymentV3.Responses.$202>
   /**
-   * getRestorePreview - Predicted outcome of reverting a deployment
+   * getRestorePreview - getRestorePreview
    * 
    * Computes what would happen if the user triggered a restore on this
    * deployment, without performing any writes. The forecast uses the
@@ -5804,7 +6124,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetRestorePreview.Responses.$200>
   /**
-   * triggerDeploymentHealthCheckV3 - Run a health check on a deployment
+   * triggerDeploymentHealthCheckV3 - triggerDeploymentHealthCheckV3
    * 
    * Starts a read-only health scan of the resources this deployment's
    * blueprint instance tracks in the destination org (see
@@ -5829,7 +6149,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.TriggerDeploymentHealthCheckV3.Responses.$202>
   /**
-   * getDeploymentHealthReportV3 - Get the latest health report of a deployment
+   * getDeploymentHealthReportV3 - getDeploymentHealthReportV3
    * 
    * Returns the most recent health report produced for this deployment
    * by the `:health-check` endpoint. Idempotent and side-effect free.
@@ -5841,7 +6161,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetDeploymentHealthReportV3.Responses.$200>
   /**
-   * getBlueprintLineageV3 - Get Blueprint Lineage V3
+   * getBlueprintLineageV3 - getBlueprintLineageV3
    * 
    * Returns the lineage registry entries for a blueprint's resources in the current org.
    * Shows the mapping between source lineage IDs and target resource IDs.
@@ -5853,7 +6173,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetBlueprintLineageV3.Responses.$200>
   /**
-   * createBulkInstallV3 - Create Bulk Install V3
+   * createBulkInstallV3 - createBulkInstallV3
    * 
    * Install one source blueprint into many destination organizations in a single
    * request. The server schedules child V3 installs with `auto_apply=true` and caps
@@ -5871,7 +6191,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.CreateBulkInstallV3.Responses.$202>
   /**
-   * getBulkInstallV3 - Get Bulk Install V3
+   * getBulkInstallV3 - getBulkInstallV3
    * 
    * 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
@@ -5884,7 +6204,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetBulkInstallV3.Responses.$200>
   /**
-   * listBulkInstallTargetsV3 - List Bulk Install Targets V3
+   * listBulkInstallTargetsV3 - listBulkInstallTargetsV3
    * 
    * 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[]`,
@@ -5897,7 +6217,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ListBulkInstallTargetsV3.Responses.$200>
   /**
-   * retryBulkInstallTargetV3 - Retry Bulk Install Target V3
+   * retryBulkInstallTargetV3 - retryBulkInstallTargetV3
    * 
    * 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
@@ -6127,7 +6447,7 @@ interface PathsDictionary {
     /**
      * preInstallBlueprint - preInstallBlueprint
      * 
-     * Pre-install a Blueprint based on a blueprint file
+     * Pre-install a Blueprint based on a blueprint file. Format-agnostic: the engine is detected from the uploaded archive, so this endpoint accepts both Terraform exports and signed V3 packages. The returned preview's `sync_engine` says which install endpoint to call next. An archive that is neither a Terraform export nor a validly signed V3 package is rejected with 400.
      */
     'post'(
       parameters?: Parameters<UnknownParamsObject> | null,
@@ -6208,6 +6528,19 @@ interface PathsDictionary {
     ): OperationResponse<Paths.AddBlueprintNote.Responses.$201>
   }
   ['/v2/blueprint-manifest/blueprints/{blueprint_id}/notes/{note_id}']: {
+    /**
+     * updateBlueprintNote - updateBlueprintNote
+     * 
+     * Rewrite the text of an existing internal note. The note keeps its position in
+     * the list along with `created_at` and `created_by`, so an edit cannot reassign
+     * authorship; `updated_at` is stamped server-side.
+     * 
+     */
+    'patch'(
+      parameters?: Parameters<Paths.UpdateBlueprintNote.PathParameters> | null,
+      data?: Paths.UpdateBlueprintNote.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.UpdateBlueprintNote.Responses.$200>
     /**
      * deleteBlueprintNote - deleteBlueprintNote
      * 
@@ -6477,7 +6810,7 @@ interface PathsDictionary {
   }
   ['/v2/blueprint-manifest/jobs']: {
     /**
-     * listBlueprintJobs - List Blueprint Jobs
+     * listBlueprintJobs - listBlueprintJobs
      * 
      * List all blueprint jobs
      */
@@ -6489,7 +6822,7 @@ interface PathsDictionary {
   }
   ['/v2/blueprint-manifest/jobs/{job_id}']: {
     /**
-     * getBlueprintJob - Get Job
+     * getBlueprintJob - getBlueprintJob
      * 
      * Poll the current state of a job. Serves both Terraform (v2) and V3-engine jobs —
      * check `sync_engine` (`terraform` | `v3`) to tell them apart. V3 jobs additionally
@@ -6505,7 +6838,7 @@ interface PathsDictionary {
   }
   ['/v2/blueprint-manifest/jobs/{job_id}:continue']: {
     /**
-     * continueInstallationJob - Continue Installation Job
+     * continueInstallationJob - continueInstallationJob
      * 
      * Resume an installation job that is paused at `status: "WAITING_USER_ACTION"` after
      * planning. Works for both Terraform and V3 jobs. Not needed for V3 installs created
@@ -6521,7 +6854,7 @@ interface PathsDictionary {
   }
   ['/v2/blueprint-manifest/jobs/{job_id}:cancel']: {
     /**
-     * cancelBlueprintJob - Cancel Blueprint Job
+     * cancelBlueprintJob - cancelBlueprintJob
      * 
      * Cancel a blueprint job if it is still running.
      */
@@ -6645,19 +6978,23 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/blueprints/{blueprint_id}:publish']: {
     /**
-     * publishBlueprintV3 - Publish Blueprint V3
+     * publishBlueprintV3 - publishBlueprintV3
      * 
      * Starts an asynchronous V3 publication. The result is a signed, portable package; poll the existing blueprint job endpoint for completion.
+     * 
+     * By default this only builds the package and stores it privately for download. Creating or
+     * overwriting the public marketplace listing is opt-in via `publish_to_marketplace`.
+     * 
      */
     'post'(
       parameters?: Parameters<Paths.PublishBlueprintV3.PathParameters> | null,
-      data?: any,
+      data?: Paths.PublishBlueprintV3.RequestBody,
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.PublishBlueprintV3.Responses.$202>
   }
   ['/v3/blueprint-manifest/blueprints:pre-install']: {
     /**
-     * preInstallBlueprintV3 - Preview a V3 blueprint package before installation
+     * preInstallBlueprintV3 - preInstallBlueprintV3
      * 
      * Validates a signed V3 package and returns the destination-specific resource plan used by the install UI.
      */
@@ -6669,7 +7006,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/blueprint:install']: {
     /**
-     * installBlueprintV3 - Install Blueprint V3
+     * installBlueprintV3 - installBlueprintV3
      * 
      * 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
@@ -6699,7 +7036,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/blueprints/{blueprint_id}/deployments/{job_id}:restore']: {
     /**
-     * restoreBlueprintDeploymentV3 - Restore a specific deployment by job_id
+     * restoreBlueprintDeploymentV3 - restoreBlueprintDeploymentV3
      * 
      * Roll a deployment back to its pre-install state. Two phases:
      * 
@@ -6731,7 +7068,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/blueprints/{blueprint_id}/deployments/{job_id}/restore-preview']: {
     /**
-     * getRestorePreview - Predicted outcome of reverting a deployment
+     * getRestorePreview - getRestorePreview
      * 
      * Computes what would happen if the user triggered a restore on this
      * deployment, without performing any writes. The forecast uses the
@@ -6752,7 +7089,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/blueprints/{blueprint_id}/deployments/{job_id}:health-check']: {
     /**
-     * triggerDeploymentHealthCheckV3 - Run a health check on a deployment
+     * triggerDeploymentHealthCheckV3 - triggerDeploymentHealthCheckV3
      * 
      * Starts a read-only health scan of the resources this deployment's
      * blueprint instance tracks in the destination org (see
@@ -6779,7 +7116,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/blueprints/{blueprint_id}/deployments/{job_id}/health-report']: {
     /**
-     * getDeploymentHealthReportV3 - Get the latest health report of a deployment
+     * getDeploymentHealthReportV3 - getDeploymentHealthReportV3
      * 
      * Returns the most recent health report produced for this deployment
      * by the `:health-check` endpoint. Idempotent and side-effect free.
@@ -6793,7 +7130,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/blueprints/{blueprint_id}/lineage']: {
     /**
-     * getBlueprintLineageV3 - Get Blueprint Lineage V3
+     * getBlueprintLineageV3 - getBlueprintLineageV3
      * 
      * Returns the lineage registry entries for a blueprint's resources in the current org.
      * Shows the mapping between source lineage IDs and target resource IDs.
@@ -6807,7 +7144,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/bulk-installs']: {
     /**
-     * createBulkInstallV3 - Create Bulk Install V3
+     * createBulkInstallV3 - createBulkInstallV3
      * 
      * Install one source blueprint into many destination organizations in a single
      * request. The server schedules child V3 installs with `auto_apply=true` and caps
@@ -6827,7 +7164,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/bulk-installs/{bulk_job_id}']: {
     /**
-     * getBulkInstallV3 - Get Bulk Install V3
+     * getBulkInstallV3 - getBulkInstallV3
      * 
      * 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
@@ -6842,7 +7179,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/bulk-installs/{bulk_job_id}/targets']: {
     /**
-     * listBulkInstallTargetsV3 - List Bulk Install Targets V3
+     * listBulkInstallTargetsV3 - listBulkInstallTargetsV3
      * 
      * 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[]`,
@@ -6857,7 +7194,7 @@ interface PathsDictionary {
   }
   ['/v3/blueprint-manifest/bulk-installs/{bulk_job_id}/targets/{destination_org_id}:retry']: {
     /**
-     * retryBulkInstallTargetV3 - Retry Bulk Install Target V3
+     * retryBulkInstallTargetV3 - retryBulkInstallTargetV3
      * 
      * 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
@@ -7004,6 +7341,7 @@ type RestoreOutcomeItem = Components.Schemas.RestoreOutcomeItem;
 type RootResourceNode = Components.Schemas.RootResourceNode;
 type S3Reference = Components.Schemas.S3Reference;
 type SelectedResources = Components.Schemas.SelectedResources;
+type SkippedBlueprintResource = Components.Schemas.SkippedBlueprintResource;
 type SuggestBlueprintResourcesRequest = Components.Schemas.SuggestBlueprintResourcesRequest;
 type SuggestBlueprintResourcesResponse = Components.Schemas.SuggestBlueprintResourcesResponse;
 type UniquenessCriteria = Components.Schemas.UniquenessCriteria;
@@ -7013,4 +7351,4 @@ type V3ResourceProgressEntry = Components.Schemas.V3ResourceProgressEntry;
 type VerificationSummary = Components.Schemas.VerificationSummary;
 type VirtualResourceNodeGroup = Components.Schemas.VirtualResourceNodeGroup;
 
-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 };
+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 VirtualResourceNodeGroup as aA, 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 SkippedBlueprintResource as as, type SuggestBlueprintResourcesRequest as at, type SuggestBlueprintResourcesResponse as au, type UniquenessCriteria as av, type UniquenessCriteriaResourceType as aw, type UploadFilePayload as ax, type V3ResourceProgressEntry as ay, type VerificationSummary 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 };