bambu-printer-mcp 1.1.12 → 1.1.14

package/dist/printers/bambu.d.ts

@@ -1,8 +1,11 @@
+import { inspectPrintFile } from "../safety/print-file.js";
+import { type PrinterStateRequirements } from "../safety/printer-state.js";
 export declare function assertDirectPrintSupported(model: string | undefined, serial?: string): void;
 interface BambuPrintOptionsInternal {
     projectName: string;
     filePath: string;
     bambuModel?: string;
+    nozzleDiameters?: number[];
     useAMS?: boolean;
     plateIndex?: number;
     bedType?: string;
@@ -24,20 +27,33 @@ interface BambuPrintOptionsInternal {
     md5?: string;
 }
 export declare class BambuImplementation {
+    private readonly confirm?;
     private printerStore;
-    constructor();
+    private checkedJobs;
+    private clearedErrors;
+    constructor(confirm?: ((message: string) => Promise<boolean>) | undefined);
+    confirmHardwareAction(message: string, physicalCheck?: boolean): Promise<void>;
+    private finishedJobIdentity;
+    confirmPrintPreflight(serial: string, status: any, inspection: Awaited<ReturnType<typeof inspectPrintFile>>): Promise<string | undefined>;
+    assertBedClearance(status: any, confirmedFinishedJob: string | undefined): void;
     private getPrinter;
+    /** Internal handoff from a successful inspected transport; never exposed as an MCP tool. */
+    recordCheckedJob(host: string, serial: string, remotePath: string, requirements: PrinterStateRequirements): void;
+    private validateLoadedGcodeState;
     private resolveProjectFileMetadata;
+    /** Safety reads never use the display cache or configured-serial model inference. */
+    getSafetyStatus(host: string, serial: string, token: string): Promise<any>;
     getStatus(host: string, serial: string, token: string): Promise<any>;
     print3mf(host: string, serial: string, token: string, options: BambuPrintOptionsInternal): Promise<any>;
-    cancelJob(host: string, serial: string, token: string): Promise<any>;
-    pauseJob(host: string, serial: string, token: string): Promise<any>;
-    resumeJob(host: string, serial: string, token: string): Promise<any>;
-    clearHmsErrors(host: string, serial: string, token: string): Promise<any>;
+    private print3mfPrepared;
+    cancelJob(host: string, serial: string, token: string, dispatch?: () => Promise<any>): Promise<any>;
+    pauseJob(host: string, serial: string, token: string, dispatch?: () => Promise<any>): Promise<any>;
+    resumeJob(host: string, serial: string, token: string, dispatch?: (assertActive: () => void, beforeDispatch: () => Promise<void>) => Promise<any>): Promise<any>;
+    clearHmsErrors(host: string, serial: string, token: string, dispatch?: (assertActive: () => void, beforeDispatch: () => Promise<void>) => Promise<any>): Promise<any>;
     setPrintSpeed(host: string, serial: string, token: string, speedMode: string | number): Promise<any>;
     setAirductMode(host: string, serial: string, token: string, mode: string): Promise<any>;
     rereadAmsRfid(host: string, serial: string, token: string, amsId: number, slotId: number): Promise<any>;
-    setTemperature(host: string, serial: string, token: string, component: string, temperature: number): Promise<{
+    setTemperature(host: string, serial: string, token: string, component: string, temperature: unknown, bambuModel?: string, material?: string, nozzleDiameter?: number, dispatch?: (heater: "bed" | "nozzle", target: number, assertActive: () => void, beforeDispatch?: () => Promise<void>) => Promise<any>): Promise<{
         status: string;
         message: string;
         command: string;
@@ -68,12 +84,28 @@ export declare class BambuImplementation {
         name: string;
         exists: boolean;
     }>;
-    uploadFile(host: string, serial: string, token: string, filePath: string, filename: string, print: boolean, bambuModel?: string): Promise<Record<string, unknown>>;
+    uploadFile(host: string, serial: string, token: string, filePath: string, filename: string, print: boolean, bambuModel?: string, upload?: (snapshot: string, destination: string, assertActive: () => void) => Promise<void>): Promise<{
+        status: string;
+        uploaded: boolean;
+        remotePath: string;
+        printRequested: boolean;
+        inspected: boolean;
+    } | {
+        status: string;
+        uploaded: boolean;
+        printRequested: boolean;
+        remotePath: string;
+        message: string;
+    }>;
+    private printRawPrepared;
     startJob(host: string, serial: string, token: string, filename: string, bambuModel?: string): Promise<{
         status: string;
+        uploaded: boolean;
+        printRequested: boolean;
+        remotePath: string;
         message: string;
-        file: string;
     }>;
+    private ftpDownload;
     /**
      * Capture a single JPEG frame from the printer's chamber camera.
      *
@@ -96,8 +128,8 @@ export declare class BambuImplementation {
      *     [16..16+payloadSize] JPEG (FF D8 ... FF D9)
      *
      * Verified models per upstream docs: A1, A1 mini, P1S, P1P. X1/X1C/X1E
-     * and P2S use RTSP on port 322 instead. H2/H2S/H2D/H2C
-     * are not documented; we fail fast rather than guess at the protocol.
+     * and P2S use RTSP on port 322 instead. H2/H2S/H2D/H2C/X2D
+     * use the same RTSP path.
      *
      * Read-only; no confirm gate. Default 8s timeout for cold-start latency.
      */
@@ -131,18 +163,21 @@ export declare class BambuImplementation {
     }>;
     /**
      * Pull a single JPEG frame from the printer's RTSP/RTSPS stream using
-     * ffmpeg. Used for X1, P2S, and H2 series.
+     * ffmpeg. Used for X1, P2S, H2-family printers, and X2D.
      *
      * URL pattern verified against HA bambulab's models.py example:
      *   rtsps://bblp:<access_code>@<host>:322/streaming/live/1
      *
      * ffmpeg invocation:
-     *   ffmpeg -rtsp_transport tcp -i <url> -frames:v 1 -f image2 -c:v mjpeg -y <out>
+     *   ffmpeg -tls_verify 0 -rtsp_transport tcp -i <url> -frames:v 1 -f image2 -c:v mjpeg -y <out>
      *
-     * -rtsp_transport tcp avoids UDP NAT/firewall issues. -frames:v 1
-     * makes ffmpeg exit as soon as one frame lands. -y overwrites the temp
-     * file. The Bambu printer presents a self-signed cert; ffmpeg's TLS
-     * layer accepts that by default (no host verification).
+     * -tls_verify 0 accepts the printer's self-signed certificate. This is
+     * consistent with the existing local-device TLS/FTPS paths, which do not
+     * have a public CA chain or hostname that ffmpeg can validate. The
+     * connection is still encrypted and remains scoped to the configured
+     * printer host. -rtsp_transport tcp avoids UDP NAT/firewall issues.
+     * -frames:v 1 makes ffmpeg exit as soon as one frame lands. -y overwrites
+     * the temp file.
      */
     private fetchRtspCameraFrame;
     /**