@printhive/api 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -143,6 +143,120 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/printers/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Search organization printers with the web palette matcher */
+        get: {
+            parameters: {
+                query: {
+                    q: string;
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            printers: {
+                                id: string;
+                                name: string;
+                                model: string;
+                                serial_number: string;
+                                status: string;
+                                location_text: string;
+                                score: number;
+                                /** @enum {string} */
+                                match: "text" | "typo" | "server";
+                            }[];
+                            total: number;
+                            query: string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/filaments/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Search available catalog filaments with the web picker */
+        get: {
+            parameters: {
+                query: {
+                    q: string;
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            filaments: {
+                                id: string;
+                                filamentId: string;
+                                acceptedByCreate: boolean;
+                                name: string;
+                                brand: null | string;
+                                material_type: string;
+                                color: null | string;
+                                diameter: null | number;
+                                /** @enum {string} */
+                                category: "filament";
+                                sku?: null | string;
+                                organization_id: null | string;
+                            }[];
+                            total: number;
+                            hasMore: boolean;
+                            /** @enum {string} */
+                            matchMode: "strict" | "broadened";
+                            originalQuery: null | string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/partner-production/uploads": {
         parameters: {
             query?: never;
@@ -283,6 +397,16 @@ interface paths {
                                     status: "missing";
                                 };
                                 printerModel?: string;
+                                machine?: {
+                                    sourceMachine: {
+                                        preset: string;
+                                        model: string;
+                                        nozzleDiameterMm: number;
+                                    };
+                                    compatibleMachines: string[];
+                                    materials: string[];
+                                    bed: string;
+                                };
                             };
                         } | {
                             /** Format: uuid */
@@ -364,6 +488,16 @@ interface paths {
                                     status: "missing";
                                 };
                                 printerModel?: string;
+                                machine?: {
+                                    sourceMachine: {
+                                        preset: string;
+                                        model: string;
+                                        nozzleDiameterMm: number;
+                                    };
+                                    compatibleMachines: string[];
+                                    materials: string[];
+                                    bed: string;
+                                };
                             } | null;
                             error: {
                                 /** @enum {string} */
@@ -491,6 +625,16 @@ interface paths {
                                     status: "missing";
                                 };
                                 printerModel?: string;
+                                machine?: {
+                                    sourceMachine: {
+                                        preset: string;
+                                        model: string;
+                                        nozzleDiameterMm: number;
+                                    };
+                                    compatibleMachines: string[];
+                                    materials: string[];
+                                    bed: string;
+                                };
                             };
                         } | {
                             /** Format: uuid */
@@ -572,6 +716,16 @@ interface paths {
                                     status: "missing";
                                 };
                                 printerModel?: string;
+                                machine?: {
+                                    sourceMachine: {
+                                        preset: string;
+                                        model: string;
+                                        nozzleDiameterMm: number;
+                                    };
+                                    compatibleMachines: string[];
+                                    materials: string[];
+                                    bed: string;
+                                };
                             } | null;
                             error: {
                                 /** @enum {string} */
@@ -916,6 +1070,16 @@ interface paths {
                                     status: "missing";
                                 };
                                 printerModel?: string;
+                                machine?: {
+                                    sourceMachine: {
+                                        preset: string;
+                                        model: string;
+                                        nozzleDiameterMm: number;
+                                    };
+                                    compatibleMachines: string[];
+                                    materials: string[];
+                                    bed: string;
+                                };
                             };
                         } | {
                             /** Format: uuid */
@@ -997,6 +1161,16 @@ interface paths {
                                     status: "missing";
                                 };
                                 printerModel?: string;
+                                machine?: {
+                                    sourceMachine: {
+                                        preset: string;
+                                        model: string;
+                                        nozzleDiameterMm: number;
+                                    };
+                                    compatibleMachines: string[];
+                                    materials: string[];
+                                    bed: string;
+                                };
                             } | null;
                             error: {
                                 /** @enum {string} */
@@ -1219,6 +1393,16 @@ interface paths {
                                         status: "missing";
                                     };
                                     printerModel?: string;
+                                    machine?: {
+                                        sourceMachine: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        compatibleMachines: string[];
+                                        materials: string[];
+                                        bed: string;
+                                    };
                                 };
                             } | {
                                 /** Format: uuid */
@@ -1300,6 +1484,16 @@ interface paths {
                                         status: "missing";
                                     };
                                     printerModel?: string;
+                                    machine?: {
+                                        sourceMachine: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        compatibleMachines: string[];
+                                        materials: string[];
+                                        bed: string;
+                                    };
                                 } | null;
                                 error: {
                                     /** @enum {string} */
@@ -1541,6 +1735,16 @@ interface paths {
                                         status: "missing";
                                     };
                                     printerModel?: string;
+                                    machine?: {
+                                        sourceMachine: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        compatibleMachines: string[];
+                                        materials: string[];
+                                        bed: string;
+                                    };
                                 };
                             } | {
                                 /** Format: uuid */
@@ -1622,6 +1826,16 @@ interface paths {
                                         status: "missing";
                                     };
                                     printerModel?: string;
+                                    machine?: {
+                                        sourceMachine: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        compatibleMachines: string[];
+                                        materials: string[];
+                                        bed: string;
+                                    };
                                 } | null;
                                 error: {
                                     /** @enum {string} */
@@ -1753,6 +1967,8 @@ interface paths {
                     "application/json": {
                         name: string;
                         externalId?: string;
+                        /** @default false */
+                        acceptEngineSettingUpdates?: boolean;
                         model_file_id: string;
                         organization_id?: string;
                         /** @description Organization ID (optional, defaults to user's primary organization) */
@@ -1762,16 +1978,21 @@ interface paths {
                         /** @description One-based plate number in the project archive */
                         plate?: number;
                         /** @description Complete filament requirements for the selected plate. Cannot be combined with raw AMS mappings. Matched using Smart Queue material and color proximity rules. */
-                        filaments?: {
+                        filaments?: ({
                             /** @description Zero-based project filament index */
                             sourceSlot: number;
-                            material: string;
-                            color: string;
+                            /**
+                             * Format: uuid
+                             * @description Organization catalog filament ID. Derives material and color; explicit values must agree.
+                             */
+                            filamentId?: string;
+                            material?: string;
+                            color?: string;
                             targetSlot?: {
                                 ams_id: number;
                                 slot_id: number;
                             };
-                        }[];
+                        } | unknown | unknown)[];
                         /**
                          * @description Create assigned jobs waiting for filament, or reject mismatches with 422
                          * @default wait
@@ -1801,16 +2022,21 @@ interface paths {
                         /** @description One-based plate number in the project archive */
                         plate: number;
                         /** @description Complete filament requirements for the selected plate. Cannot be combined with raw AMS mappings. Matched using Smart Queue material and color proximity rules. */
-                        filaments: {
+                        filaments: ({
                             /** @description Zero-based project filament index */
                             sourceSlot: number;
-                            material: string;
-                            color: string;
+                            /**
+                             * Format: uuid
+                             * @description Organization catalog filament ID. Derives material and color; explicit values must agree.
+                             */
+                            filamentId?: string;
+                            material?: string;
+                            color?: string;
                             targetSlot?: {
                                 ams_id: number;
                                 slot_id: number;
                             };
-                        }[];
+                        } | unknown | unknown)[];
                         /** Format: uuid */
                         printer_id?: string;
                         /**
@@ -1820,6 +2046,8 @@ interface paths {
                          */
                         on_filament_mismatch?: "wait" | "reject";
                         externalId?: string;
+                        /** @default false */
+                        acceptEngineSettingUpdates?: boolean;
                         /**
                          * @default automatic
                          * @enum {string}
@@ -1846,9 +2074,32 @@ interface paths {
                                 model_file_id?: string | null;
                                 printer_id?: string | null;
                                 organization_id?: string;
-                                print_options?: {
+                                print_options?: ({
+                                    /** @enum {string} */
+                                    filament_route_state?: "waiting" | "resolved";
+                                    /** @description Assigned job is waiting for a complete material route; rechecked before claim */
+                                    filament_waiting_reasons?: {
+                                        /** @enum {string} */
+                                        code: "filament_not_loaded" | "material_route_changed";
+                                        /** @enum {string} */
+                                        cause?: "slot_empty" | "missing_material" | "color_distance" | "slot_conflict";
+                                        /** Format: uuid */
+                                        filamentId?: string;
+                                        brand?: string | null;
+                                        name?: string;
+                                        colorName?: string | null;
+                                        colorHex?: string;
+                                        sourceSlot?: number;
+                                        material?: string;
+                                        color?: string;
+                                        suggestedTargetSlot?: {
+                                            ams_id?: number;
+                                            slot_id?: number;
+                                        };
+                                    }[];
+                                } & {
                                     [key: string]: unknown;
-                                } | null;
+                                }) | null;
                             } & {
                                 [key: string]: unknown;
                             };
@@ -1901,15 +2152,97 @@ interface paths {
                                 model_file_id: string | null;
                                 /** Format: uuid */
                                 printer_id: string | null;
-                                print_options: {
+                                print_options: ({
+                                    /** @enum {string} */
+                                    filament_route_state?: "waiting" | "resolved";
+                                    filament_waiting_reasons?: {
+                                        /** Format: uuid */
+                                        filamentId?: string;
+                                        brand?: string | null;
+                                        name?: string;
+                                        colorName?: string | null;
+                                        material?: string;
+                                        colorHex?: string;
+                                        /** @enum {string} */
+                                        code: "filament_not_loaded" | "material_route_changed";
+                                        sourceSlot?: number;
+                                        color?: string;
+                                        /** @enum {string} */
+                                        cause?: "slot_empty" | "missing_material" | "color_distance" | "slot_conflict";
+                                        suggestedTargetSlot?: {
+                                            ams_id: number;
+                                            slot_id: number;
+                                        };
+                                    }[];
+                                } & {
                                     [key: string]: unknown;
-                                } | null;
+                                }) | null;
                             } & {
                                 [key: string]: unknown;
                             }) | null;
-                            requiredActions: {
+                            requiredActions: (({
+                                item: number;
+                                plateNumber: number;
+                                hold: {
+                                    /** @enum {string} */
+                                    code: "material_change_requires_qualification";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "inspection_review_required";
+                                    reason: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "unmapped_used_slot";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_source_too_large";
+                                    limit: {
+                                        /** @enum {string} */
+                                        name: "projectSourceBytes";
+                                        max: number;
+                                        observed: number;
+                                    };
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_review_required";
+                                    detail: string;
+                                    changes?: {
+                                        key: string;
+                                        sourceValue: (string | null) | string[] | number | boolean;
+                                        engineValue: (string | null) | string[] | number | boolean;
+                                        slots: number[];
+                                    }[];
+                                    sourceRelease?: string | null;
+                                    engineRelease?: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "preview_mismatch_after_remap";
+                                    detail: string;
+                                };
+                            } & {
                                 [key: string]: unknown;
-                            }[];
+                            }) | ({
+                                code: string;
+                            } & {
+                                [key: string]: unknown;
+                            }))[];
+                            /** @default [] */
+                            warnings: ({
+                                /** @enum {string} */
+                                code: "custom_instructions_kept";
+                                keys: string[];
+                            } | {
+                                /** @enum {string} */
+                                code: "custom_instructions_replaced";
+                                keys: string[];
+                            } | {
+                                /** @enum {string} */
+                                code: "preview_stale_after_remap";
+                                slots: number[];
+                                bedChanged: boolean;
+                            })[];
                             error: {
                                 [key: string]: unknown;
                             } | null;
@@ -1952,12 +2285,12 @@ interface paths {
                     content: {
                         "application/json": {
                             /** @enum {string} */
-                            error?: "filament_requirements_unsatisfied" | "printer_model_incompatible" | "hardware:nozzle_diameter_mismatch" | "target_slot_unavailable" | "insufficient_filament_routes";
+                            error?: "filament_catalog_conflict" | "catalog_filament_not_found" | "invalid_catalog_filament" | "filament_requirements_unsatisfied" | "printer_model_incompatible" | "hardware:nozzle_diameter_mismatch" | "target_slot_unavailable" | "insufficient_filament_routes";
                             message?: string;
                             filaments?: {
                                 sourceSlot?: number;
                                 /** @enum {string} */
-                                reason?: "missing_material" | "color_distance" | "slot_empty" | "slot_conflict";
+                                reason?: "filament_catalog_conflict" | "catalog_filament_not_found" | "invalid_catalog_filament" | "missing_material" | "color_distance" | "slot_empty" | "slot_conflict";
                             }[];
                         };
                     };
@@ -1982,20 +2315,20 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/print-jobs/create-requests/{requestId}": {
+    "/v1/print-jobs/{id}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Poll one asynchronous single-plate creation request */
+        /** @description Organization-scoped job snapshot for polling. Stored lifecycle and recovery facts are separate from quality acceptance, printer release, accepted-unit counts, and shipping readiness. Null values remain unknown. A terminal status or print_completed_at is not proof of successful output. */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
-                    requestId: string;
+                    id: number;
                 };
                 cookie?: never;
             };
@@ -2008,42 +2341,65 @@ interface paths {
                     };
                     content: {
                         "application/json": {
-                            /** Format: uuid */
-                            requestId: string;
-                            /** @enum {string} */
-                            status: "preparing" | "held" | "created" | "failed" | "cancelled";
-                            externalId: string | null;
-                            createdAt: string;
-                            job: ({
-                                id: number;
-                                status: string;
-                                /** Format: uuid */
-                                model_file_id: string | null;
-                                /** Format: uuid */
-                                printer_id: string | null;
-                                print_options: {
-                                    [key: string]: unknown;
+                            job?: {
+                                id?: number;
+                                name?: string;
+                                organization_id?: string;
+                                printer_id?: string | null;
+                                model_file_id?: string | null;
+                                task_id?: string | null;
+                                status?: string;
+                                /** @description Stored job status version, not a Farm Event cursor or a version of every field. */
+                                status_version?: number;
+                                progress?: number | null;
+                                print_started_at?: string | null;
+                                print_completed_at?: string | null;
+                                verified_at?: string | null;
+                                outcome_resolution_required?: boolean;
+                                outcome_resolution_source?: string | null;
+                                outcome_resolved_at?: string | null;
+                                retry_count?: number | null;
+                                max_retries?: number | null;
+                                recovery_count?: number | null;
+                                next_eligible_at?: string | null;
+                                error_code?: string | null;
+                                updated_at?: string | null;
+                                printer?: {
+                                    id?: string;
+                                    name?: string;
+                                    model?: string;
                                 } | null;
-                            } & {
-                                [key: string]: unknown;
-                            }) | null;
-                            requiredActions: {
-                                [key: string]: unknown;
-                            }[];
-                            error: {
-                                [key: string]: unknown;
-                            } | null;
-                        };
-                    };
-                };
-                /** @description Default Response */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            error?: string;
+                                model_file?: {
+                                    id?: string;
+                                    filename?: string;
+                                    file_type?: string;
+                                    file_size?: number | null;
+                                } | null;
+                                print_options?: ({
+                                    /** @description Assigned job is waiting for a complete material route; rechecked before claim */
+                                    filament_waiting_reasons?: {
+                                        /** @enum {string} */
+                                        code: "filament_not_loaded" | "material_route_changed";
+                                        /** @enum {string} */
+                                        cause?: "slot_empty" | "missing_material" | "color_distance" | "slot_conflict";
+                                        /** Format: uuid */
+                                        filamentId?: string;
+                                        brand?: string | null;
+                                        name?: string;
+                                        colorName?: string | null;
+                                        colorHex?: string;
+                                        sourceSlot?: number;
+                                        material?: string;
+                                        color?: string;
+                                        suggestedTargetSlot?: {
+                                            ams_id?: number;
+                                            slot_id?: number;
+                                        };
+                                    }[];
+                                } & {
+                                    [key: string]: unknown;
+                                }) | null;
+                            };
                         };
                     };
                 };
@@ -2051,46 +2407,33 @@ interface paths {
         };
         put?: never;
         post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/print-jobs/create-requests/{requestId}/release": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** Authorize admission of a manually held creation request */
-        post: {
+        delete: {
             parameters: {
-                query?: never;
+                query?: {
+                    organizationId?: string;
+                };
                 header?: never;
                 path: {
-                    requestId: string;
+                    id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
                 /** @description Default Response */
-                202: {
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            authorized: boolean;
+                            success?: boolean;
+                            message?: string;
                         };
                     };
                 };
-                /** @description Authentication required */
-                401: {
+                /** @description Cannot delete job - invalid status */
+                400: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -2098,14 +2441,11 @@ interface paths {
                         "application/json": {
                             error?: string;
                             message?: string;
-                            requestId?: string;
-                            code?: string;
-                            statusCode?: number;
                         };
                     };
                 };
-                /** @description API key requires control scope */
-                403: {
+                /** @description Default Response */
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -2113,13 +2453,10 @@ interface paths {
                         "application/json": {
                             error?: string;
                             message?: string;
-                            requestId?: string;
-                            code?: string;
-                            statusCode?: number;
                         };
                     };
                 };
-                /** @description Creation request not found */
+                /** @description Default Response */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -2128,12 +2465,11 @@ interface paths {
                         "application/json": {
                             error?: string;
                             message?: string;
-                            requestId?: string;
                         };
                     };
                 };
-                /** @description Creation request no longer supports this action */
-                409: {
+                /** @description Default Response */
+                500: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -2141,28 +2477,296 @@ interface paths {
                         "application/json": {
                             error?: string;
                             message?: string;
-                            requestId?: string;
                         };
                     };
                 };
             };
         };
-        delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/print-jobs/create-requests/{requestId}/cancel": {
-        parameters: {
-            query?: never;
-            header?: never;
+        /**
+         * Update print job
+         * @description Update a queued print job's printer assignment and/or print options. Only QUEUED jobs can be updated.
+         */
+        patch: {
+            parameters: {
+                query?: {
+                    /** @description Organization ID (optional, defaults to user's primary organization) */
+                    organizationId?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Print job ID */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Printer ID to assign. Set to null to un-assign and enable auto-assign. */
+                        printer_id?: string | null;
+                        /** @description Print options including AMS mapping */
+                        print_options?: {
+                            enable_ams?: boolean;
+                            enable_bed_leveling?: boolean;
+                            start_immediately?: boolean;
+                            /** @description Deprecated compatibility alias for start_immediately */
+                            set_printer_ready?: boolean;
+                            enable_filament_backup?: boolean;
+                            auto_assign?: boolean;
+                            ams_mapping?: number[];
+                            ams_mapping2?: (number | {
+                                ams_id: number;
+                                slot_id: number;
+                            })[];
+                            ams_mapping_info?: {
+                                sourceColor?: string;
+                                targetColor?: string;
+                                filamentType?: string;
+                            }[];
+                        } & {
+                            [key: string]: unknown;
+                        };
+                        /** @description Organization ID (optional, defaults to user's primary organization) */
+                        organizationId?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Job updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success?: boolean;
+                            /** @description Updated print job */
+                            job?: Record<string, never>;
+                        };
+                    };
+                };
+                /** @description Bad request - job not in QUEUED status */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                        };
+                    };
+                };
+                /** @description Forbidden - not authorized to update this job */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            code?: string;
+                            message?: string;
+                        };
+                    };
+                };
+                /** @description Job not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                        };
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                        };
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/v1/print-jobs/create-requests/{requestId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Poll one asynchronous single-plate creation request */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    requestId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** Format: uuid */
+                            requestId: string;
+                            /** @enum {string} */
+                            status: "preparing" | "held" | "created" | "failed" | "cancelled";
+                            externalId: string | null;
+                            createdAt: string;
+                            job: ({
+                                id: number;
+                                status: string;
+                                /** Format: uuid */
+                                model_file_id: string | null;
+                                /** Format: uuid */
+                                printer_id: string | null;
+                                print_options: ({
+                                    /** @enum {string} */
+                                    filament_route_state?: "waiting" | "resolved";
+                                    filament_waiting_reasons?: {
+                                        /** Format: uuid */
+                                        filamentId?: string;
+                                        brand?: string | null;
+                                        name?: string;
+                                        colorName?: string | null;
+                                        material?: string;
+                                        colorHex?: string;
+                                        /** @enum {string} */
+                                        code: "filament_not_loaded" | "material_route_changed";
+                                        sourceSlot?: number;
+                                        color?: string;
+                                        /** @enum {string} */
+                                        cause?: "slot_empty" | "missing_material" | "color_distance" | "slot_conflict";
+                                        suggestedTargetSlot?: {
+                                            ams_id: number;
+                                            slot_id: number;
+                                        };
+                                    }[];
+                                } & {
+                                    [key: string]: unknown;
+                                }) | null;
+                            } & {
+                                [key: string]: unknown;
+                            }) | null;
+                            requiredActions: (({
+                                item: number;
+                                plateNumber: number;
+                                hold: {
+                                    /** @enum {string} */
+                                    code: "material_change_requires_qualification";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "inspection_review_required";
+                                    reason: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "unmapped_used_slot";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_source_too_large";
+                                    limit: {
+                                        /** @enum {string} */
+                                        name: "projectSourceBytes";
+                                        max: number;
+                                        observed: number;
+                                    };
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_review_required";
+                                    detail: string;
+                                    changes?: {
+                                        key: string;
+                                        sourceValue: (string | null) | string[] | number | boolean;
+                                        engineValue: (string | null) | string[] | number | boolean;
+                                        slots: number[];
+                                    }[];
+                                    sourceRelease?: string | null;
+                                    engineRelease?: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "preview_mismatch_after_remap";
+                                    detail: string;
+                                };
+                            } & {
+                                [key: string]: unknown;
+                            }) | ({
+                                code: string;
+                            } & {
+                                [key: string]: unknown;
+                            }))[];
+                            /** @default [] */
+                            warnings: ({
+                                /** @enum {string} */
+                                code: "custom_instructions_kept";
+                                keys: string[];
+                            } | {
+                                /** @enum {string} */
+                                code: "custom_instructions_replaced";
+                                keys: string[];
+                            } | {
+                                /** @enum {string} */
+                                code: "preview_stale_after_remap";
+                                slots: number[];
+                                bedChanged: boolean;
+                            })[];
+                            error: {
+                                [key: string]: unknown;
+                            } | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/print-jobs/create-requests/{requestId}/release": {
+        parameters: {
+            query?: never;
+            header?: never;
             path?: never;
             cookie?: never;
         };
         get?: never;
         put?: never;
-        /** Cancel a creation request before job admission */
+        /** Authorize admission of a manually held creation request */
         post: {
             parameters: {
                 query?: never;
@@ -2170,79 +2774,1872 @@ interface paths {
                 path: {
                     requestId: string;
                 };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            authorized: boolean;
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                            code?: string;
+                            statusCode?: number;
+                        };
+                    };
+                };
+                /** @description API key requires control scope */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                            code?: string;
+                            statusCode?: number;
+                        };
+                    };
+                };
+                /** @description Creation request not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Creation request no longer supports this action */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/print-jobs/create-requests/{requestId}/approve-review": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Approve exactly the reported engine setting changes and re-slice */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    requestId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        changes: {
+                            key: string;
+                            sourceValue: (string | null) | string[] | number | boolean;
+                            engineValue: (string | null) | string[] | number | boolean;
+                            slots: number[];
+                        }[];
+                        sourceRelease: string | null;
+                        engineRelease: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            approved: boolean;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                            code?: string;
+                            statusCode?: number;
+                        };
+                    };
+                };
+                /** @description API key requires control scope */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                            code?: string;
+                            statusCode?: number;
+                        };
+                    };
+                };
+                /** @description Creation request not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Creation request no longer supports this action */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/print-jobs/create-requests/{requestId}/cancel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Cancel a creation request before job admission */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    requestId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            cancelled: boolean;
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                            code?: string;
+                            statusCode?: number;
+                        };
+                    };
+                };
+                /** @description API key requires control scope */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                            code?: string;
+                            statusCode?: number;
+                        };
+                    };
+                };
+                /** @description Creation request not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Creation request no longer supports this action */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/partner-production/preparations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Prepare plates of partner sources for an exact printer
+         * @description Creates a durable asynchronous preparation request. Each item names a source version or a partner externalId, plates ("all" or a list), a plate-run quantity, optional material mappings and guidance, and an exact qualified printer. Requires Idempotency-Key. Creates no print job.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "idempotency-key": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        items: ({
+                            /** Format: uuid */
+                            sourceVersionId: string;
+                            plates: "all" | number[];
+                            quantity: number;
+                            materialMappings?: {
+                                sourceSlot: number;
+                                material: string;
+                                color: string;
+                            }[];
+                            guidance?: {
+                                allowedMaterials?: string[];
+                                preferredFilaments?: {
+                                    sourceSlot?: number;
+                                    material: string;
+                                    color?: string;
+                                    brand?: string;
+                                    name?: string;
+                                }[];
+                            };
+                            target: {
+                                /** Format: uuid */
+                                printerId: string;
+                            };
+                        } | {
+                            externalId: string;
+                            plates: "all" | number[];
+                            quantity: number;
+                            materialMappings?: {
+                                sourceSlot: number;
+                                material: string;
+                                color: string;
+                            }[];
+                            guidance?: {
+                                allowedMaterials?: string[];
+                                preferredFilaments?: {
+                                    sourceSlot?: number;
+                                    material: string;
+                                    color?: string;
+                                    brand?: string;
+                                    name?: string;
+                                }[];
+                            };
+                            target: {
+                                /** Format: uuid */
+                                printerId: string;
+                            };
+                        })[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** Format: uuid */
+                            preparationId: string;
+                            /** @enum {string} */
+                            status: "waiting_for_source" | "preparing" | "held" | "ready" | "failed";
+                            /** Format: date-time */
+                            createdAt: string;
+                            holds: {
+                                item: number;
+                                plateNumber: number;
+                                hold: {
+                                    /** @enum {string} */
+                                    code: "material_change_requires_qualification";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "inspection_review_required";
+                                    reason: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "unmapped_used_slot";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_source_too_large";
+                                    limit: {
+                                        /** @enum {string} */
+                                        name: "projectSourceBytes";
+                                        max: number;
+                                        observed: number;
+                                    };
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_review_required";
+                                    detail: string;
+                                    changes?: {
+                                        key: string;
+                                        sourceValue: (string | null) | string[] | number | boolean;
+                                        engineValue: (string | null) | string[] | number | boolean;
+                                        slots: number[];
+                                    }[];
+                                    sourceRelease?: string | null;
+                                    engineRelease?: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "preview_mismatch_after_remap";
+                                    detail: string;
+                                };
+                            }[];
+                            items: {
+                                index: number;
+                                /** @enum {string} */
+                                status: "waiting_for_source" | "preparing" | "held" | "ready" | "failed";
+                                source: {
+                                    /** Format: uuid */
+                                    sourceVersionId: string;
+                                    externalId: string | null;
+                                    /** @enum {string} */
+                                    status: "queued" | "inspecting" | "ready" | "failed";
+                                };
+                                plates: "all" | number[];
+                                resolvedPlates: number[] | null;
+                                quantity: number;
+                                materialMappings: {
+                                    sourceSlot: number;
+                                    material: string;
+                                    color: string;
+                                }[];
+                                guidance: {
+                                    allowedMaterials: string[] | null;
+                                    preferredFilaments: {
+                                        sourceSlot?: number;
+                                        material: string;
+                                        color?: string;
+                                        brand?: string;
+                                        name?: string;
+                                    }[] | null;
+                                };
+                                target: {
+                                    /** Format: uuid */
+                                    printerId: string;
+                                    printerName: string;
+                                    /** @enum {string} */
+                                    qualification?: "bambu-p1s-0.4-standard-petg-v1";
+                                    /** @enum {string} */
+                                    path?: "native" | "qualified";
+                                    targetMachine?: {
+                                        preset: string;
+                                        model: string;
+                                        nozzleDiameterMm: number;
+                                    };
+                                    printerModel: string;
+                                    nozzleDiameterMm: number;
+                                    /** @enum {string} */
+                                    nozzleFlow: "standard";
+                                    buildSurface: string;
+                                    profiles?: {
+                                        printer: {
+                                            /** Format: uuid */
+                                            catalogId: string;
+                                            name: string;
+                                        };
+                                        process: {
+                                            /** Format: uuid */
+                                            catalogId: string;
+                                            name: string;
+                                        };
+                                        filament: {
+                                            /** Format: uuid */
+                                            catalogId: string;
+                                            name: string;
+                                        };
+                                    };
+                                };
+                                failure: {
+                                    /** @enum {string} */
+                                    code: "source_failed" | "plate_not_found" | "no_plates" | "mapping_slot_not_found" | "inspection_unreadable";
+                                    sourceError?: {
+                                        /** @enum {string} */
+                                        code: "invalid_archive" | "unsafe_path" | "unsafe_xml" | "resource_limit" | "invalid_project" | "toolpath_only" | "processing_timeout" | "storage_object_changed" | "inspection_interrupted" | "upload_interrupted";
+                                        message: string;
+                                        limit?: {
+                                            /** @enum {string} */
+                                            name: "uploadBytes" | "concurrentUploads" | "concurrentUploadsPerOrganization" | "uploadIdleTimeoutMs" | "uploadTimeoutMs" | "entries" | "compressionRatio" | "modelPartExpandedBytes" | "expandedBytes" | "parserBytesPerDocument" | "parserBytesPerArchive" | "xmlDepth" | "xmlElementsPerDocument" | "objects" | "plates" | "materialSlots" | "inspectionTimeoutMs" | "inspectorHeapMb";
+                                            max: number;
+                                            observed?: number;
+                                        };
+                                    };
+                                    plates?: number[];
+                                    slots?: number[];
+                                } | null;
+                                preparedPlates: {
+                                    /** Format: uuid */
+                                    plateId: string;
+                                    plateNumber: number;
+                                    runs: number;
+                                    /** @enum {string} */
+                                    status: "preparing" | "held" | "ready" | "failed";
+                                    usedSlots: number[];
+                                    materialMappings: {
+                                        sourceSlot: number;
+                                        material: string;
+                                        color: string;
+                                        /** @enum {string} */
+                                        origin: "partner" | "inspection" | "placeholder";
+                                    }[];
+                                    holds: ({
+                                        /** @enum {string} */
+                                        code: "material_change_requires_qualification";
+                                        slots: number[];
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "inspection_review_required";
+                                        reason: string;
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "unmapped_used_slot";
+                                        slots: number[];
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "project_source_too_large";
+                                        limit: {
+                                            /** @enum {string} */
+                                            name: "projectSourceBytes";
+                                            max: number;
+                                            observed: number;
+                                        };
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "project_review_required";
+                                        detail: string;
+                                        changes?: {
+                                            key: string;
+                                            sourceValue: (string | null) | string[] | number | boolean;
+                                            engineValue: (string | null) | string[] | number | boolean;
+                                            slots: number[];
+                                        }[];
+                                        sourceRelease?: string | null;
+                                        engineRelease?: string;
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "preview_mismatch_after_remap";
+                                        detail: string;
+                                    })[];
+                                    failure: {
+                                        /** @enum {string} */
+                                        code: "slice_failed";
+                                        sliceCode: string;
+                                        message: string;
+                                        retryable: boolean;
+                                        attempts: number;
+                                    } | null;
+                                    output: {
+                                        /** Format: uuid */
+                                        outputFileId: string;
+                                        filename: string;
+                                        bytes: number;
+                                        sha256: string;
+                                    } | null;
+                                    lineage: {
+                                        /** Format: uuid */
+                                        sourceVersionId: string;
+                                        sourceSha256: string;
+                                        plateNumber: number;
+                                        /** @enum {string} */
+                                        qualification?: "bambu-p1s-0.4-standard-petg-v1";
+                                        /** @enum {string} */
+                                        path?: "native" | "qualified";
+                                        sourceMachine?: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        materialQualifications?: {
+                                            sourceSlot: number;
+                                            /** @enum {string} */
+                                            qualification: "bambu-p1s-0.4-standard-petg-v1";
+                                        }[];
+                                        targetMachine?: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        buildSurface: string;
+                                        materialMappings: {
+                                            sourceSlot: number;
+                                            material: string;
+                                            color: string;
+                                        }[];
+                                        engineSha256: string;
+                                        resolvedProfilesSha256: string;
+                                        derivedInputSha256: string;
+                                        qualifiedProfileSourceHashes: {
+                                            [key: string]: string;
+                                        };
+                                        replacedSettings: {
+                                            key: string;
+                                            source: string | string[] | number | boolean;
+                                            target?: string | string[] | number | boolean;
+                                        }[];
+                                        omittedSettings: string[];
+                                        settingFilterPolicy: {
+                                            hold: string[];
+                                            omit: string[];
+                                        };
+                                        ignoredSettings: string[];
+                                        warnings: ({
+                                            /** @enum {string} */
+                                            code: "custom_instructions_kept";
+                                            keys: string[];
+                                        } | {
+                                            /** @enum {string} */
+                                            code: "custom_instructions_replaced";
+                                            keys: string[];
+                                        } | {
+                                            /** @enum {string} */
+                                            code: "preview_stale_after_remap";
+                                            slots: number[];
+                                            bedChanged: boolean;
+                                        })[];
+                                        engineFallback: {
+                                            authoringVersion: string | null;
+                                            selectedVersion: string;
+                                        } | null;
+                                        acceptedEngineSettingChanges?: {
+                                            changes: {
+                                                key: string;
+                                                sourceValue: (string | null) | string[] | number | boolean;
+                                                engineValue: (string | null) | string[] | number | boolean;
+                                                slots: number[];
+                                            }[];
+                                            sourceRelease: string | null;
+                                            engineRelease: string;
+                                        };
+                                        /** @enum {string} */
+                                        preview: "source" | "engine" | "none";
+                                        previewFile: string | null;
+                                        finalArtifactSha256: string;
+                                    } | null;
+                                }[];
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** Format: uuid */
+                            preparationId: string;
+                            /** @enum {string} */
+                            status: "waiting_for_source" | "preparing" | "held" | "ready" | "failed";
+                            /** Format: date-time */
+                            createdAt: string;
+                            holds: {
+                                item: number;
+                                plateNumber: number;
+                                hold: {
+                                    /** @enum {string} */
+                                    code: "material_change_requires_qualification";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "inspection_review_required";
+                                    reason: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "unmapped_used_slot";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_source_too_large";
+                                    limit: {
+                                        /** @enum {string} */
+                                        name: "projectSourceBytes";
+                                        max: number;
+                                        observed: number;
+                                    };
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_review_required";
+                                    detail: string;
+                                    changes?: {
+                                        key: string;
+                                        sourceValue: (string | null) | string[] | number | boolean;
+                                        engineValue: (string | null) | string[] | number | boolean;
+                                        slots: number[];
+                                    }[];
+                                    sourceRelease?: string | null;
+                                    engineRelease?: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "preview_mismatch_after_remap";
+                                    detail: string;
+                                };
+                            }[];
+                            items: {
+                                index: number;
+                                /** @enum {string} */
+                                status: "waiting_for_source" | "preparing" | "held" | "ready" | "failed";
+                                source: {
+                                    /** Format: uuid */
+                                    sourceVersionId: string;
+                                    externalId: string | null;
+                                    /** @enum {string} */
+                                    status: "queued" | "inspecting" | "ready" | "failed";
+                                };
+                                plates: "all" | number[];
+                                resolvedPlates: number[] | null;
+                                quantity: number;
+                                materialMappings: {
+                                    sourceSlot: number;
+                                    material: string;
+                                    color: string;
+                                }[];
+                                guidance: {
+                                    allowedMaterials: string[] | null;
+                                    preferredFilaments: {
+                                        sourceSlot?: number;
+                                        material: string;
+                                        color?: string;
+                                        brand?: string;
+                                        name?: string;
+                                    }[] | null;
+                                };
+                                target: {
+                                    /** Format: uuid */
+                                    printerId: string;
+                                    printerName: string;
+                                    /** @enum {string} */
+                                    qualification?: "bambu-p1s-0.4-standard-petg-v1";
+                                    /** @enum {string} */
+                                    path?: "native" | "qualified";
+                                    targetMachine?: {
+                                        preset: string;
+                                        model: string;
+                                        nozzleDiameterMm: number;
+                                    };
+                                    printerModel: string;
+                                    nozzleDiameterMm: number;
+                                    /** @enum {string} */
+                                    nozzleFlow: "standard";
+                                    buildSurface: string;
+                                    profiles?: {
+                                        printer: {
+                                            /** Format: uuid */
+                                            catalogId: string;
+                                            name: string;
+                                        };
+                                        process: {
+                                            /** Format: uuid */
+                                            catalogId: string;
+                                            name: string;
+                                        };
+                                        filament: {
+                                            /** Format: uuid */
+                                            catalogId: string;
+                                            name: string;
+                                        };
+                                    };
+                                };
+                                failure: {
+                                    /** @enum {string} */
+                                    code: "source_failed" | "plate_not_found" | "no_plates" | "mapping_slot_not_found" | "inspection_unreadable";
+                                    sourceError?: {
+                                        /** @enum {string} */
+                                        code: "invalid_archive" | "unsafe_path" | "unsafe_xml" | "resource_limit" | "invalid_project" | "toolpath_only" | "processing_timeout" | "storage_object_changed" | "inspection_interrupted" | "upload_interrupted";
+                                        message: string;
+                                        limit?: {
+                                            /** @enum {string} */
+                                            name: "uploadBytes" | "concurrentUploads" | "concurrentUploadsPerOrganization" | "uploadIdleTimeoutMs" | "uploadTimeoutMs" | "entries" | "compressionRatio" | "modelPartExpandedBytes" | "expandedBytes" | "parserBytesPerDocument" | "parserBytesPerArchive" | "xmlDepth" | "xmlElementsPerDocument" | "objects" | "plates" | "materialSlots" | "inspectionTimeoutMs" | "inspectorHeapMb";
+                                            max: number;
+                                            observed?: number;
+                                        };
+                                    };
+                                    plates?: number[];
+                                    slots?: number[];
+                                } | null;
+                                preparedPlates: {
+                                    /** Format: uuid */
+                                    plateId: string;
+                                    plateNumber: number;
+                                    runs: number;
+                                    /** @enum {string} */
+                                    status: "preparing" | "held" | "ready" | "failed";
+                                    usedSlots: number[];
+                                    materialMappings: {
+                                        sourceSlot: number;
+                                        material: string;
+                                        color: string;
+                                        /** @enum {string} */
+                                        origin: "partner" | "inspection" | "placeholder";
+                                    }[];
+                                    holds: ({
+                                        /** @enum {string} */
+                                        code: "material_change_requires_qualification";
+                                        slots: number[];
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "inspection_review_required";
+                                        reason: string;
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "unmapped_used_slot";
+                                        slots: number[];
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "project_source_too_large";
+                                        limit: {
+                                            /** @enum {string} */
+                                            name: "projectSourceBytes";
+                                            max: number;
+                                            observed: number;
+                                        };
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "project_review_required";
+                                        detail: string;
+                                        changes?: {
+                                            key: string;
+                                            sourceValue: (string | null) | string[] | number | boolean;
+                                            engineValue: (string | null) | string[] | number | boolean;
+                                            slots: number[];
+                                        }[];
+                                        sourceRelease?: string | null;
+                                        engineRelease?: string;
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "preview_mismatch_after_remap";
+                                        detail: string;
+                                    })[];
+                                    failure: {
+                                        /** @enum {string} */
+                                        code: "slice_failed";
+                                        sliceCode: string;
+                                        message: string;
+                                        retryable: boolean;
+                                        attempts: number;
+                                    } | null;
+                                    output: {
+                                        /** Format: uuid */
+                                        outputFileId: string;
+                                        filename: string;
+                                        bytes: number;
+                                        sha256: string;
+                                    } | null;
+                                    lineage: {
+                                        /** Format: uuid */
+                                        sourceVersionId: string;
+                                        sourceSha256: string;
+                                        plateNumber: number;
+                                        /** @enum {string} */
+                                        qualification?: "bambu-p1s-0.4-standard-petg-v1";
+                                        /** @enum {string} */
+                                        path?: "native" | "qualified";
+                                        sourceMachine?: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        materialQualifications?: {
+                                            sourceSlot: number;
+                                            /** @enum {string} */
+                                            qualification: "bambu-p1s-0.4-standard-petg-v1";
+                                        }[];
+                                        targetMachine?: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        buildSurface: string;
+                                        materialMappings: {
+                                            sourceSlot: number;
+                                            material: string;
+                                            color: string;
+                                        }[];
+                                        engineSha256: string;
+                                        resolvedProfilesSha256: string;
+                                        derivedInputSha256: string;
+                                        qualifiedProfileSourceHashes: {
+                                            [key: string]: string;
+                                        };
+                                        replacedSettings: {
+                                            key: string;
+                                            source: string | string[] | number | boolean;
+                                            target?: string | string[] | number | boolean;
+                                        }[];
+                                        omittedSettings: string[];
+                                        settingFilterPolicy: {
+                                            hold: string[];
+                                            omit: string[];
+                                        };
+                                        ignoredSettings: string[];
+                                        warnings: ({
+                                            /** @enum {string} */
+                                            code: "custom_instructions_kept";
+                                            keys: string[];
+                                        } | {
+                                            /** @enum {string} */
+                                            code: "custom_instructions_replaced";
+                                            keys: string[];
+                                        } | {
+                                            /** @enum {string} */
+                                            code: "preview_stale_after_remap";
+                                            slots: number[];
+                                            bedChanged: boolean;
+                                        })[];
+                                        engineFallback: {
+                                            authoringVersion: string | null;
+                                            selectedVersion: string;
+                                        } | null;
+                                        acceptedEngineSettingChanges?: {
+                                            changes: {
+                                                key: string;
+                                                sourceValue: (string | null) | string[] | number | boolean;
+                                                engineValue: (string | null) | string[] | number | boolean;
+                                                slots: number[];
+                                            }[];
+                                            sourceRelease: string | null;
+                                            engineRelease: string;
+                                        };
+                                        /** @enum {string} */
+                                        preview: "source" | "engine" | "none";
+                                        previewFile: string | null;
+                                        finalArtifactSha256: string;
+                                    } | null;
+                                }[];
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/partner-production/preparations/{preparationId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Poll a partner preparation request */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    preparationId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** Format: uuid */
+                            preparationId: string;
+                            /** @enum {string} */
+                            status: "waiting_for_source" | "preparing" | "held" | "ready" | "failed";
+                            /** Format: date-time */
+                            createdAt: string;
+                            holds: {
+                                item: number;
+                                plateNumber: number;
+                                hold: {
+                                    /** @enum {string} */
+                                    code: "material_change_requires_qualification";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "inspection_review_required";
+                                    reason: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "unmapped_used_slot";
+                                    slots: number[];
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_source_too_large";
+                                    limit: {
+                                        /** @enum {string} */
+                                        name: "projectSourceBytes";
+                                        max: number;
+                                        observed: number;
+                                    };
+                                } | {
+                                    /** @enum {string} */
+                                    code: "project_review_required";
+                                    detail: string;
+                                    changes?: {
+                                        key: string;
+                                        sourceValue: (string | null) | string[] | number | boolean;
+                                        engineValue: (string | null) | string[] | number | boolean;
+                                        slots: number[];
+                                    }[];
+                                    sourceRelease?: string | null;
+                                    engineRelease?: string;
+                                } | {
+                                    /** @enum {string} */
+                                    code: "preview_mismatch_after_remap";
+                                    detail: string;
+                                };
+                            }[];
+                            items: {
+                                index: number;
+                                /** @enum {string} */
+                                status: "waiting_for_source" | "preparing" | "held" | "ready" | "failed";
+                                source: {
+                                    /** Format: uuid */
+                                    sourceVersionId: string;
+                                    externalId: string | null;
+                                    /** @enum {string} */
+                                    status: "queued" | "inspecting" | "ready" | "failed";
+                                };
+                                plates: "all" | number[];
+                                resolvedPlates: number[] | null;
+                                quantity: number;
+                                materialMappings: {
+                                    sourceSlot: number;
+                                    material: string;
+                                    color: string;
+                                }[];
+                                guidance: {
+                                    allowedMaterials: string[] | null;
+                                    preferredFilaments: {
+                                        sourceSlot?: number;
+                                        material: string;
+                                        color?: string;
+                                        brand?: string;
+                                        name?: string;
+                                    }[] | null;
+                                };
+                                target: {
+                                    /** Format: uuid */
+                                    printerId: string;
+                                    printerName: string;
+                                    /** @enum {string} */
+                                    qualification?: "bambu-p1s-0.4-standard-petg-v1";
+                                    /** @enum {string} */
+                                    path?: "native" | "qualified";
+                                    targetMachine?: {
+                                        preset: string;
+                                        model: string;
+                                        nozzleDiameterMm: number;
+                                    };
+                                    printerModel: string;
+                                    nozzleDiameterMm: number;
+                                    /** @enum {string} */
+                                    nozzleFlow: "standard";
+                                    buildSurface: string;
+                                    profiles?: {
+                                        printer: {
+                                            /** Format: uuid */
+                                            catalogId: string;
+                                            name: string;
+                                        };
+                                        process: {
+                                            /** Format: uuid */
+                                            catalogId: string;
+                                            name: string;
+                                        };
+                                        filament: {
+                                            /** Format: uuid */
+                                            catalogId: string;
+                                            name: string;
+                                        };
+                                    };
+                                };
+                                failure: {
+                                    /** @enum {string} */
+                                    code: "source_failed" | "plate_not_found" | "no_plates" | "mapping_slot_not_found" | "inspection_unreadable";
+                                    sourceError?: {
+                                        /** @enum {string} */
+                                        code: "invalid_archive" | "unsafe_path" | "unsafe_xml" | "resource_limit" | "invalid_project" | "toolpath_only" | "processing_timeout" | "storage_object_changed" | "inspection_interrupted" | "upload_interrupted";
+                                        message: string;
+                                        limit?: {
+                                            /** @enum {string} */
+                                            name: "uploadBytes" | "concurrentUploads" | "concurrentUploadsPerOrganization" | "uploadIdleTimeoutMs" | "uploadTimeoutMs" | "entries" | "compressionRatio" | "modelPartExpandedBytes" | "expandedBytes" | "parserBytesPerDocument" | "parserBytesPerArchive" | "xmlDepth" | "xmlElementsPerDocument" | "objects" | "plates" | "materialSlots" | "inspectionTimeoutMs" | "inspectorHeapMb";
+                                            max: number;
+                                            observed?: number;
+                                        };
+                                    };
+                                    plates?: number[];
+                                    slots?: number[];
+                                } | null;
+                                preparedPlates: {
+                                    /** Format: uuid */
+                                    plateId: string;
+                                    plateNumber: number;
+                                    runs: number;
+                                    /** @enum {string} */
+                                    status: "preparing" | "held" | "ready" | "failed";
+                                    usedSlots: number[];
+                                    materialMappings: {
+                                        sourceSlot: number;
+                                        material: string;
+                                        color: string;
+                                        /** @enum {string} */
+                                        origin: "partner" | "inspection" | "placeholder";
+                                    }[];
+                                    holds: ({
+                                        /** @enum {string} */
+                                        code: "material_change_requires_qualification";
+                                        slots: number[];
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "inspection_review_required";
+                                        reason: string;
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "unmapped_used_slot";
+                                        slots: number[];
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "project_source_too_large";
+                                        limit: {
+                                            /** @enum {string} */
+                                            name: "projectSourceBytes";
+                                            max: number;
+                                            observed: number;
+                                        };
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "project_review_required";
+                                        detail: string;
+                                        changes?: {
+                                            key: string;
+                                            sourceValue: (string | null) | string[] | number | boolean;
+                                            engineValue: (string | null) | string[] | number | boolean;
+                                            slots: number[];
+                                        }[];
+                                        sourceRelease?: string | null;
+                                        engineRelease?: string;
+                                    } | {
+                                        /** @enum {string} */
+                                        code: "preview_mismatch_after_remap";
+                                        detail: string;
+                                    })[];
+                                    failure: {
+                                        /** @enum {string} */
+                                        code: "slice_failed";
+                                        sliceCode: string;
+                                        message: string;
+                                        retryable: boolean;
+                                        attempts: number;
+                                    } | null;
+                                    output: {
+                                        /** Format: uuid */
+                                        outputFileId: string;
+                                        filename: string;
+                                        bytes: number;
+                                        sha256: string;
+                                    } | null;
+                                    lineage: {
+                                        /** Format: uuid */
+                                        sourceVersionId: string;
+                                        sourceSha256: string;
+                                        plateNumber: number;
+                                        /** @enum {string} */
+                                        qualification?: "bambu-p1s-0.4-standard-petg-v1";
+                                        /** @enum {string} */
+                                        path?: "native" | "qualified";
+                                        sourceMachine?: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        materialQualifications?: {
+                                            sourceSlot: number;
+                                            /** @enum {string} */
+                                            qualification: "bambu-p1s-0.4-standard-petg-v1";
+                                        }[];
+                                        targetMachine?: {
+                                            preset: string;
+                                            model: string;
+                                            nozzleDiameterMm: number;
+                                        };
+                                        buildSurface: string;
+                                        materialMappings: {
+                                            sourceSlot: number;
+                                            material: string;
+                                            color: string;
+                                        }[];
+                                        engineSha256: string;
+                                        resolvedProfilesSha256: string;
+                                        derivedInputSha256: string;
+                                        qualifiedProfileSourceHashes: {
+                                            [key: string]: string;
+                                        };
+                                        replacedSettings: {
+                                            key: string;
+                                            source: string | string[] | number | boolean;
+                                            target?: string | string[] | number | boolean;
+                                        }[];
+                                        omittedSettings: string[];
+                                        settingFilterPolicy: {
+                                            hold: string[];
+                                            omit: string[];
+                                        };
+                                        ignoredSettings: string[];
+                                        warnings: ({
+                                            /** @enum {string} */
+                                            code: "custom_instructions_kept";
+                                            keys: string[];
+                                        } | {
+                                            /** @enum {string} */
+                                            code: "custom_instructions_replaced";
+                                            keys: string[];
+                                        } | {
+                                            /** @enum {string} */
+                                            code: "preview_stale_after_remap";
+                                            slots: number[];
+                                            bedChanged: boolean;
+                                        })[];
+                                        engineFallback: {
+                                            authoringVersion: string | null;
+                                            selectedVersion: string;
+                                        } | null;
+                                        acceptedEngineSettingChanges?: {
+                                            changes: {
+                                                key: string;
+                                                sourceValue: (string | null) | string[] | number | boolean;
+                                                engineValue: (string | null) | string[] | number | boolean;
+                                                slots: number[];
+                                            }[];
+                                            sourceRelease: string | null;
+                                            engineRelease: string;
+                                        };
+                                        /** @enum {string} */
+                                        preview: "source" | "engine" | "none";
+                                        previewFile: string | null;
+                                        finalArtifactSha256: string;
+                                    } | null;
+                                }[];
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/partner-production/preparations/{preparationId}/plates/{plateId}/download": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a short-lived download URL for a prepared plate */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    preparationId: string;
+                    plateId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** Format: uri */
+                            url: string;
+                            /** Format: date-time */
+                            expiresAt: string;
+                            filename: string;
+                            bytes: number;
+                            sha256: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error?: string;
+                            message?: string;
+                            requestId?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
+                        };
+                    };
+                };
                 /** @description Default Response */
-                202: {
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            cancelled: boolean;
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
                         };
                     };
                 };
-                /** @description Authentication required */
-                401: {
+                /** @description Default Response */
+                410: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            error?: string;
-                            message?: string;
-                            requestId?: string;
-                            code?: string;
-                            statusCode?: number;
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
                         };
                     };
                 };
-                /** @description API key requires control scope */
-                403: {
+                /** @description Default Response */
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            error?: string;
-                            message?: string;
-                            requestId?: string;
-                            code?: string;
-                            statusCode?: number;
+                            /** @enum {string} */
+                            error: "invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable";
+                            item?: number;
+                            limit?: {
+                                /** @enum {string} */
+                                name: "items";
+                                max: number;
+                                observed: number;
+                            };
+                            /** @description Present on target_not_qualified: one entry for each refused item. */
+                            reasons?: {
+                                /** @description Index of the request item that names this printer. */
+                                item: number;
+                                /** @enum {string} */
+                                code: "printer_brand_not_qualified" | "printer_model_not_qualified" | "nozzle_diameter_not_qualified" | "nozzle_diameter_unknown";
+                                /** Format: uuid */
+                                printerId: string;
+                                printerName: string;
+                                /**
+                                 * @description The printer setting that an operator must correct.
+                                 * @enum {string}
+                                 */
+                                field: "printer_brand" | "model" | "nozzle_diameter";
+                                /** @description The value the qualification needs, such as 0.4 for nozzle_diameter. */
+                                required: string | number;
+                            }[];
                         };
                     };
                 };
-                /** @description Creation request not found */
-                404: {
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/filament-catalog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List organization catalog filaments */
+        get: {
+            parameters: {
+                query?: {
+                    externalId?: string;
+                    sku?: string;
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": {
-                            error?: string;
-                            message?: string;
-                            requestId?: string;
-                        };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        /** Upsert an organization catalog filament by partner external id */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        externalId: string;
+                        brand: string;
+                        material: string;
+                        colorName: string;
+                        colorHex?: string;
+                        hex?: string;
+                        sku: string;
+                        replacementFilamentId?: string | null;
                     };
                 };
-                /** @description Creation request no longer supports this action */
-                409: {
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": {
-                            error?: string;
-                            message?: string;
-                            requestId?: string;
-                        };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/filament-catalog/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read an organization catalog filament */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
                     };
+                    content?: never;
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
@@ -2279,9 +4676,69 @@ declare class Transport {
     request<T>(request: Request<T>): Promise<T>;
 }
 
+type PrinterSearchResponse = paths["/v1/printers/search"]["get"]["responses"][200]["content"]["application/json"];
+type FilamentSearchResponse = paths["/v1/filaments/search"]["get"]["responses"][200]["content"]["application/json"];
+type PrinterSearchPage = PrinterSearchResponse;
+type PrinterSearchResult = PrinterSearchPage["printers"][number];
+type FilamentSearchPage = FilamentSearchResponse;
+type FilamentSearchResult = FilamentSearchPage["filaments"][number];
+type SearchOptions = {
+    query: string;
+    limit?: number;
+    offset?: number;
+    signal?: AbortSignal;
+};
+
+type CatalogFilamentInput = {
+    externalId: string;
+    brand: string;
+    material: string;
+    colorName: string;
+    sku: string;
+    replacementFilamentId?: string | null;
+} & ({
+    colorHex: string;
+    hex?: string;
+} | {
+    hex: string;
+    colorHex?: string;
+});
+type CatalogFilament = {
+    id: string;
+    sku: string;
+    organization_id: string;
+    material_type: string;
+    color: string;
+    metadata: {
+        externalId: string;
+        colorName: string;
+        replacementFilamentId: string | null;
+    };
+};
+declare class FilamentCatalog {
+    private readonly transport;
+    constructor(transport: Transport);
+    upsert(input: CatalogFilamentInput): Promise<CatalogFilament>;
+    list(input?: {
+        externalId?: string;
+        sku?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        materials: CatalogFilament[];
+        total: number;
+    }>;
+    get(id: string): Promise<CatalogFilament>;
+}
+
 type CreateOperation = paths["/v1/print-jobs/create"]["post"];
 type CreatedPrintJob = CreateOperation["responses"][201]["content"]["application/json"];
+type FilamentWaitingReason = NonNullable<NonNullable<NonNullable<CreatedPrintJob["job"]>["print_options"]>["filament_waiting_reasons"]>[number];
+type JobReadResponse = paths["/v1/print-jobs/{id}"]["get"]["responses"][200]["content"]["application/json"];
+type JobFields = NonNullable<JobReadResponse["job"]>;
+type PrintJob = JobFields & Required<Pick<JobFields, "id" | "status">>;
 type PrintJobCreateRequest = paths["/v1/print-jobs/create-requests/{requestId}"]["get"]["responses"][200]["content"]["application/json"];
+type EngineSettingReviewApproval = paths["/v1/print-jobs/create-requests/{requestId}/approve-review"]["post"]["requestBody"]["content"]["application/json"];
 type JsonPrintJobInput = CreateOperation["requestBody"]["content"]["application/json"] & {
     idempotencyKey?: string;
 };
@@ -2297,6 +4754,7 @@ declare class PrintJobCreateStoppedError extends Error {
 declare class PrintJobs {
     private readonly transport;
     constructor(transport: Transport);
+    get(id: number, signal?: AbortSignal): Promise<PrintJob>;
     create(input: UploadedPrintJobInput): Promise<PrintJobCreateRequest & {
         idempotencyKey: string;
     }>;
@@ -2304,6 +4762,9 @@ declare class PrintJobs {
         idempotencyKey: string;
     }>;
     getCreateRequest(requestId: string, signal?: AbortSignal): Promise<PrintJobCreateRequest>;
+    approveReview(requestId: string, review: EngineSettingReviewApproval, signal?: AbortSignal): Promise<{
+        approved: boolean;
+    }>;
     waitUntilCreated(requestId: string, options?: WaitOptions): Promise<{
         requestId: string;
         status: "preparing" | "held" | "created" | "failed" | "cancelled";
@@ -2314,15 +4775,82 @@ declare class PrintJobs {
             status: string;
             model_file_id: string | null;
             printer_id: string | null;
-            print_options: {
+            print_options: ({
+                filament_route_state?: "waiting" | "resolved";
+                filament_waiting_reasons?: {
+                    filamentId?: string;
+                    brand?: string | null;
+                    name?: string;
+                    colorName?: string | null;
+                    material?: string;
+                    colorHex?: string;
+                    code: "filament_not_loaded" | "material_route_changed";
+                    sourceSlot?: number;
+                    color?: string;
+                    cause?: "slot_empty" | "missing_material" | "color_distance" | "slot_conflict";
+                    suggestedTargetSlot?: {
+                        ams_id: number;
+                        slot_id: number;
+                    };
+                }[];
+            } & {
                 [key: string]: unknown;
-            } | null;
+            }) | null;
         } & {
             [key: string]: unknown;
         }) | null;
-        requiredActions: {
+        requiredActions: (({
+            item: number;
+            plateNumber: number;
+            hold: {
+                code: "material_change_requires_qualification";
+                slots: number[];
+            } | {
+                code: "inspection_review_required";
+                reason: string;
+            } | {
+                code: "unmapped_used_slot";
+                slots: number[];
+            } | {
+                code: "project_source_too_large";
+                limit: {
+                    name: "projectSourceBytes";
+                    max: number;
+                    observed: number;
+                };
+            } | {
+                code: "project_review_required";
+                detail: string;
+                changes?: {
+                    key: string;
+                    sourceValue: (string | null) | string[] | number | boolean;
+                    engineValue: (string | null) | string[] | number | boolean;
+                    slots: number[];
+                }[];
+                sourceRelease?: string | null;
+                engineRelease?: string;
+            } | {
+                code: "preview_mismatch_after_remap";
+                detail: string;
+            };
+        } & {
+            [key: string]: unknown;
+        }) | ({
+            code: string;
+        } & {
             [key: string]: unknown;
-        }[];
+        }))[];
+        warnings: ({
+            code: "custom_instructions_kept";
+            keys: string[];
+        } | {
+            code: "custom_instructions_replaced";
+            keys: string[];
+        } | {
+            code: "preview_stale_after_remap";
+            slots: number[];
+            bedChanged: boolean;
+        })[];
         error: {
             [key: string]: unknown;
         } | null;
@@ -2352,6 +4880,7 @@ declare class PrintHiveApiError extends Error {
     readonly body?: ApiErrorBody | undefined;
     readonly name = "PrintHiveApiError";
     constructor(status: number, code: string, limit?: ApiLimit | undefined, retryAfterMs?: number | undefined, requestId?: string | undefined, body?: ApiErrorBody | undefined);
+    get reasons(): readonly PartnerPreparationTargetReason[];
 }
 declare class PrintHiveNetworkError extends Error {
     readonly reason: "network" | "timeout" | "aborted";
@@ -2361,6 +4890,21 @@ declare class PrintHiveNetworkError extends Error {
 
 type PartnerSource = paths["/v1/partner-production/uploads/{sourceId}"]["get"]["responses"][200]["content"]["application/json"];
 type PartnerModel = paths["/v1/partner-production/models"]["get"]["responses"][200]["content"]["application/json"];
+type PartnerPreparation = paths["/v1/partner-production/preparations/{preparationId}"]["get"]["responses"][200]["content"]["application/json"];
+type PartnerPreparationCreateBody = paths["/v1/partner-production/preparations"]["post"]["requestBody"]["content"]["application/json"];
+type PartnerPreparationItemInput = PartnerPreparationCreateBody["items"][number];
+type PartnerMaterialMapping = NonNullable<PartnerPreparationItemInput["materialMappings"]>[number];
+type PartnerPreparedPlate = PartnerPreparation["items"][number]["preparedPlates"][number];
+type PartnerPreparationDownload = paths["/v1/partner-production/preparations/{preparationId}/plates/{plateId}/download"]["get"]["responses"][200]["content"]["application/json"];
+type PartnerPreparationErrorBody = paths["/v1/partner-production/preparations"]["post"]["responses"][422]["content"]["application/json"];
+type PartnerPreparationTargetReason = NonNullable<PartnerPreparationErrorBody["reasons"]>[number];
+type PreparationCreateOptions = PartnerPreparationCreateBody & {
+    idempotencyKey?: string;
+    signal?: AbortSignal;
+};
+type SettledPreparation = PartnerPreparation & {
+    status: "ready" | "held" | "failed";
+};
 type UploadOptions = {
     filename: string;
     externalId?: string;
@@ -2463,6 +5007,16 @@ declare class PrintHive {
                     status: "missing";
                 };
                 printerModel?: string;
+                machine?: {
+                    sourceMachine: {
+                        preset: string;
+                        model: string;
+                        nozzleDiameterMm: number;
+                    };
+                    compatibleMachines: string[];
+                    materials: string[];
+                    bed: string;
+                };
             };
         } | {
             sourceVersionId: string;
@@ -2529,6 +5083,16 @@ declare class PrintHive {
                     status: "missing";
                 };
                 printerModel?: string;
+                machine?: {
+                    sourceMachine: {
+                        preset: string;
+                        model: string;
+                        nozzleDiameterMm: number;
+                    };
+                    compatibleMachines: string[];
+                    materials: string[];
+                    bed: string;
+                };
             } | null;
             error: {
                 code: "invalid_archive" | "unsafe_path" | "unsafe_xml" | "resource_limit" | "invalid_project" | "toolpath_only" | "processing_timeout" | "storage_object_changed" | "inspection_interrupted" | "upload_interrupted";
@@ -2634,6 +5198,16 @@ declare class PrintHive {
                         status: "missing";
                     };
                     printerModel?: string;
+                    machine?: {
+                        sourceMachine: {
+                            preset: string;
+                            model: string;
+                            nozzleDiameterMm: number;
+                        };
+                        compatibleMachines: string[];
+                        materials: string[];
+                        bed: string;
+                    };
                 };
             } | {
                 sourceVersionId: string;
@@ -2700,6 +5274,16 @@ declare class PrintHive {
                         status: "missing";
                     };
                     printerModel?: string;
+                    machine?: {
+                        sourceMachine: {
+                            preset: string;
+                            model: string;
+                            nozzleDiameterMm: number;
+                        };
+                        compatibleMachines: string[];
+                        materials: string[];
+                        bed: string;
+                    };
                 } | null;
                 error: {
                     code: "invalid_archive" | "unsafe_path" | "unsafe_xml" | "resource_limit" | "invalid_project" | "toolpath_only" | "processing_timeout" | "storage_object_changed" | "inspection_interrupted" | "upload_interrupted";
@@ -2715,6 +5299,20 @@ declare class PrintHive {
         listSourceFiles(modelId: string): AsyncGenerator<PartnerSource>;
     };
     readonly printers: {
+        search: (input: SearchOptions) => Promise<{
+            printers: {
+                id: string;
+                name: string;
+                model: string;
+                serial_number: string;
+                status: string;
+                location_text: string;
+                score: number;
+                match: "text" | "typo" | "server";
+            }[];
+            total: number;
+            query: string;
+        }>;
         list: (input?: {
             limit?: number;
             cursor?: string;
@@ -2722,7 +5320,281 @@ declare class PrintHive {
         get: (id: string) => Promise<unknown>;
     };
     readonly printJobs: PrintJobs;
+    readonly filamentCatalog: FilamentCatalog;
+    readonly filaments: {
+        search: (input: SearchOptions) => Promise<{
+            filaments: {
+                id: string;
+                filamentId: string;
+                acceptedByCreate: boolean;
+                name: string;
+                brand: null | string;
+                material_type: string;
+                color: null | string;
+                diameter: null | number;
+                category: "filament";
+                sku?: null | string;
+                organization_id: null | string;
+            }[];
+            total: number;
+            hasMore: boolean;
+            matchMode: "strict" | "broadened";
+            originalQuery: null | string;
+        }>;
+    };
+    readonly preparations: {
+        get: (id: string, signal?: AbortSignal) => Promise<{
+            preparationId: string;
+            status: "waiting_for_source" | "preparing" | "held" | "ready" | "failed";
+            createdAt: string;
+            holds: {
+                item: number;
+                plateNumber: number;
+                hold: {
+                    code: "material_change_requires_qualification";
+                    slots: number[];
+                } | {
+                    code: "inspection_review_required";
+                    reason: string;
+                } | {
+                    code: "unmapped_used_slot";
+                    slots: number[];
+                } | {
+                    code: "project_source_too_large";
+                    limit: {
+                        name: "projectSourceBytes";
+                        max: number;
+                        observed: number;
+                    };
+                } | {
+                    code: "project_review_required";
+                    detail: string;
+                    changes?: {
+                        key: string;
+                        sourceValue: (string | null) | string[] | number | boolean;
+                        engineValue: (string | null) | string[] | number | boolean;
+                        slots: number[];
+                    }[];
+                    sourceRelease?: string | null;
+                    engineRelease?: string;
+                } | {
+                    code: "preview_mismatch_after_remap";
+                    detail: string;
+                };
+            }[];
+            items: {
+                index: number;
+                status: "waiting_for_source" | "preparing" | "held" | "ready" | "failed";
+                source: {
+                    sourceVersionId: string;
+                    externalId: string | null;
+                    status: "queued" | "inspecting" | "ready" | "failed";
+                };
+                plates: "all" | number[];
+                resolvedPlates: number[] | null;
+                quantity: number;
+                materialMappings: {
+                    sourceSlot: number;
+                    material: string;
+                    color: string;
+                }[];
+                guidance: {
+                    allowedMaterials: string[] | null;
+                    preferredFilaments: {
+                        sourceSlot?: number;
+                        material: string;
+                        color?: string;
+                        brand?: string;
+                        name?: string;
+                    }[] | null;
+                };
+                target: {
+                    printerId: string;
+                    printerName: string;
+                    qualification?: "bambu-p1s-0.4-standard-petg-v1";
+                    path?: "native" | "qualified";
+                    targetMachine?: {
+                        preset: string;
+                        model: string;
+                        nozzleDiameterMm: number;
+                    };
+                    printerModel: string;
+                    nozzleDiameterMm: number;
+                    nozzleFlow: "standard";
+                    buildSurface: string;
+                    profiles?: {
+                        printer: {
+                            catalogId: string;
+                            name: string;
+                        };
+                        process: {
+                            catalogId: string;
+                            name: string;
+                        };
+                        filament: {
+                            catalogId: string;
+                            name: string;
+                        };
+                    };
+                };
+                failure: {
+                    code: "source_failed" | "plate_not_found" | "no_plates" | "mapping_slot_not_found" | "inspection_unreadable";
+                    sourceError?: {
+                        code: "invalid_archive" | "unsafe_path" | "unsafe_xml" | "resource_limit" | "invalid_project" | "toolpath_only" | "processing_timeout" | "storage_object_changed" | "inspection_interrupted" | "upload_interrupted";
+                        message: string;
+                        limit?: {
+                            name: "uploadBytes" | "concurrentUploads" | "concurrentUploadsPerOrganization" | "uploadIdleTimeoutMs" | "uploadTimeoutMs" | "entries" | "compressionRatio" | "modelPartExpandedBytes" | "expandedBytes" | "parserBytesPerDocument" | "parserBytesPerArchive" | "xmlDepth" | "xmlElementsPerDocument" | "objects" | "plates" | "materialSlots" | "inspectionTimeoutMs" | "inspectorHeapMb";
+                            max: number;
+                            observed?: number;
+                        };
+                    };
+                    plates?: number[];
+                    slots?: number[];
+                } | null;
+                preparedPlates: {
+                    plateId: string;
+                    plateNumber: number;
+                    runs: number;
+                    status: "preparing" | "held" | "ready" | "failed";
+                    usedSlots: number[];
+                    materialMappings: {
+                        sourceSlot: number;
+                        material: string;
+                        color: string;
+                        origin: "partner" | "inspection" | "placeholder";
+                    }[];
+                    holds: ({
+                        code: "material_change_requires_qualification";
+                        slots: number[];
+                    } | {
+                        code: "inspection_review_required";
+                        reason: string;
+                    } | {
+                        code: "unmapped_used_slot";
+                        slots: number[];
+                    } | {
+                        code: "project_source_too_large";
+                        limit: {
+                            name: "projectSourceBytes";
+                            max: number;
+                            observed: number;
+                        };
+                    } | {
+                        code: "project_review_required";
+                        detail: string;
+                        changes?: {
+                            key: string;
+                            sourceValue: (string | null) | string[] | number | boolean;
+                            engineValue: (string | null) | string[] | number | boolean;
+                            slots: number[];
+                        }[];
+                        sourceRelease?: string | null;
+                        engineRelease?: string;
+                    } | {
+                        code: "preview_mismatch_after_remap";
+                        detail: string;
+                    })[];
+                    failure: {
+                        code: "slice_failed";
+                        sliceCode: string;
+                        message: string;
+                        retryable: boolean;
+                        attempts: number;
+                    } | null;
+                    output: {
+                        outputFileId: string;
+                        filename: string;
+                        bytes: number;
+                        sha256: string;
+                    } | null;
+                    lineage: {
+                        sourceVersionId: string;
+                        sourceSha256: string;
+                        plateNumber: number;
+                        qualification?: "bambu-p1s-0.4-standard-petg-v1";
+                        path?: "native" | "qualified";
+                        sourceMachine?: {
+                            preset: string;
+                            model: string;
+                            nozzleDiameterMm: number;
+                        };
+                        materialQualifications?: {
+                            sourceSlot: number;
+                            qualification: "bambu-p1s-0.4-standard-petg-v1";
+                        }[];
+                        targetMachine?: {
+                            preset: string;
+                            model: string;
+                            nozzleDiameterMm: number;
+                        };
+                        buildSurface: string;
+                        materialMappings: {
+                            sourceSlot: number;
+                            material: string;
+                            color: string;
+                        }[];
+                        engineSha256: string;
+                        resolvedProfilesSha256: string;
+                        derivedInputSha256: string;
+                        qualifiedProfileSourceHashes: {
+                            [key: string]: string;
+                        };
+                        replacedSettings: {
+                            key: string;
+                            source: string | string[] | number | boolean;
+                            target?: string | string[] | number | boolean;
+                        }[];
+                        omittedSettings: string[];
+                        settingFilterPolicy: {
+                            hold: string[];
+                            omit: string[];
+                        };
+                        ignoredSettings: string[];
+                        warnings: ({
+                            code: "custom_instructions_kept";
+                            keys: string[];
+                        } | {
+                            code: "custom_instructions_replaced";
+                            keys: string[];
+                        } | {
+                            code: "preview_stale_after_remap";
+                            slots: number[];
+                            bedChanged: boolean;
+                        })[];
+                        engineFallback: {
+                            authoringVersion: string | null;
+                            selectedVersion: string;
+                        } | null;
+                        acceptedEngineSettingChanges?: {
+                            changes: {
+                                key: string;
+                                sourceValue: (string | null) | string[] | number | boolean;
+                                engineValue: (string | null) | string[] | number | boolean;
+                                slots: number[];
+                            }[];
+                            sourceRelease: string | null;
+                            engineRelease: string;
+                        };
+                        preview: "source" | "engine" | "none";
+                        previewFile: string | null;
+                        finalArtifactSha256: string;
+                    } | null;
+                }[];
+            }[];
+        }>;
+        create(input: PreparationCreateOptions): Promise<PartnerPreparation & {
+            idempotencyKey: string;
+        }>;
+        waitUntilSettled(id: string, options?: WaitOptions): Promise<SettledPreparation>;
+        downloadInfo: (id: string, plateId: string, signal?: AbortSignal) => Promise<{
+            url: string;
+            expiresAt: string;
+            filename: string;
+            bytes: number;
+            sha256: string;
+        }>;
+    };
     constructor(options: PrintHiveOptions);
 }
 
-export { type ApiErrorBody, type ApiLimit, type CreatedPrintJob, type JsonPrintJobInput, type PartnerModel, type PartnerSource, PrintHive, PrintHiveApiError, PrintHiveNetworkError, type PrintHiveOptions, type PrintJobCreateRequest, PrintJobCreateStoppedError, type UploadOptions, type UploadedPrintJobInput, type WaitOptions, type paths };
+export { type ApiErrorBody, type ApiLimit, type CatalogFilament, type CatalogFilamentInput, type CreatedPrintJob, type EngineSettingReviewApproval, type FilamentSearchPage, type FilamentSearchResult, type FilamentWaitingReason, type JsonPrintJobInput, type PartnerMaterialMapping, type PartnerModel, type PartnerPreparation, type PartnerPreparationCreateBody, type PartnerPreparationDownload, type PartnerPreparationErrorBody, type PartnerPreparationItemInput, type PartnerPreparationTargetReason, type PartnerPreparedPlate, type PartnerSource, type PreparationCreateOptions, PrintHive, PrintHiveApiError, PrintHiveNetworkError, type PrintHiveOptions, type PrintJob, type PrintJobCreateRequest, PrintJobCreateStoppedError, type PrinterSearchPage, type PrinterSearchResult, type SearchOptions, type SettledPreparation, type UploadOptions, type UploadedPrintJobInput, type WaitOptions, type paths };