bambu-printer-mcp 1.1.27 → 1.1.29

package/dist/printers/bambu.js

@@ -7,8 +7,9 @@ import os from "node:os";
 import { Readable } from "node:stream";
 import { readSafe3mfArchive } from "../safety/archive.js";
 import { inspectPrintFile } from "../safety/print-file.js";
-import { normalizeModel, validateTemperature } from "../safety/limits.js";
-import { validatePrinterState, manualHeatingRequirements } from "../safety/printer-state.js";
+import { isDualNozzleModel, normalizeModel, validateTemperature } from "../safety/limits.js";
+import { bridgeAmsMapping2Entry, bridgeAmsMappingValue, externalTrayForNozzle, describeAmsTrayRange } from "../ams-mapping.js";
+import { describeHmsKey, hiddenHmsKeys, hiddenHmsNotices, reportedHmsKey, validatePrinterState, manualHeatingRequirements } from "../safety/printer-state.js";
 import { withPrinterOperation, withPrintSnapshot, uniquePrintName, normalizedRemotePath, cancelPendingPrinterOperations } from "../safety/artifact.js";
 import { Client as FTPClient } from "basic-ftp";
 import { BambuPrinter } from "bambu-js";
@@ -69,7 +70,7 @@ const MODEL_ID_TO_NAME = {
 const H2_MODEL_NAMES = new Set(["h2", "h2c", "h2d", "h2dpro", "h2d pro", "h2s", "x2d"]);
 export function assertDirectPrintSupported(model, serial) {
     if (model?.trim().toLowerCase() === "x2d" || serial?.trim().toUpperCase().startsWith("20P")) {
-        throw new Error("X2D direct printing is not supported through legacy MQTT/FTPS. Use the macOS native eMMC route via print_3mf. " +
+        throw new Error("X2D direct printing is not supported through legacy MQTT/FTPS. Use the native eMMC route via print_3mf (macOS, or Linux with the native helper installed). " +
             "X2D status and slicing remain available on all supported platforms.");
     }
 }
@@ -392,21 +393,37 @@ export class BambuImplementation {
     finishedJobIdentity(status) {
         return status.raw.gcode_state === "FINISH" ? JSON.stringify([status.raw.gcode_file, status.raw.subtask_name, status.raw.task_id, status.raw.subtask_id]) : undefined;
     }
+    /**
+     * The human print confirmation. Its result goes to assertBedClearance at
+     * every later state check of the same print, which stops the print if the
+     * situation the human confirmed has changed.
+     */
     async confirmPrintPreflight(serial, status, inspection) {
         const finishedJob = this.finishedJobIdentity(status);
         const cleared = this.clearedErrors.get(serial);
+        const notices = hiddenHmsNotices(status?.raw, serial, inspection.model);
         await this.confirmHardwareAction(`Start a checked print on ${inspection.model.toUpperCase()} (${serial})? Nozzles: ${inspection.nozzleDiameters.join(", ")} mm. ` +
             `Materials: ${inspection.materials.join(", ")}. Peak targets: nozzle ${inspection.maxNozzleTemperature}°C, bed ${inspection.maxBedTemperature}°C, chamber ${inspection.maxChamberTemperature}°C. ` +
             `File SHA-256: ${inspection.sha256}. Confirm the physical spool labels and that the build plate is clear.` +
             (finishedJob !== undefined ? " The printer reports FINISH: remove the previous part and debris before confirming." : "") +
-            (cleared ? ` Previously cleared hardware codes: ${cleared.join(", ")}. Confirm their physical causes have been resolved.` : ""), finishedJob !== undefined || !!cleared);
-        return finishedJob;
+            (cleared ? ` Previously cleared hardware codes: ${cleared.map(describeHmsKey).join(", ")}. Confirm their physical causes have been resolved.` : "") +
+            (notices.length ? ` The printer also reports ${notices.join(", ")}, which Bambu lists for this model without text and never shows as a fault; ` +
+                `${notices.length === 1 ? "it does" : "they do"} not block printing.` : ""), finishedJob !== undefined || !!cleared);
+        return { finishedJob, serial, model: inspection.model, notices };
     }
-    assertBedClearance(status, confirmedFinishedJob) {
+    /** Stop a print whose confirmed situation changed: a newly finished job, or a hidden HMS notice the preflight did not name. */
+    assertBedClearance(status, preflight) {
         const current = this.finishedJobIdentity(status);
-        if (current !== undefined && current !== confirmedFinishedJob) {
+        if (current !== undefined && current !== preflight.finishedJob) {
             throw new Error("Printer reports a newly finished job. Confirm that its part and debris have been removed before retrying the print.");
         }
+        // An X2D raises its hidden camera notice about 15 seconds after boot, so it
+        // can appear after the human confirmed. Never pass a notice nobody was told about.
+        const unnamed = hiddenHmsNotices(status?.raw, preflight.serial, preflight.model).filter(notice => !preflight.notices.includes(notice));
+        if (unnamed.length) {
+            throw new Error(`Printer reported ${unnamed.join(", ")} after the print confirmation. ` +
+                "Bambu hides it and it does not block printing, but it was not named when you confirmed; start the print again to review it.");
+        }
     }
     async getPrinter(host, serial, token) {
         return this.printerStore.getPrinter(host, serial, token);
@@ -604,12 +621,17 @@ export class BambuImplementation {
         // `plate_N.json.filament_ids` -- and expand to a full project-level
         // array here. `amsMapping` is the raw escape hatch (takes precedence
         // when both are supplied).
+        // Dual-nozzle printers address two external spools: 254 feeds the left/deputy
+        // nozzle and 255 the right/main nozzle (Bambu Studio VIRTUAL_TRAY_DEPUTY_ID /
+        // VIRTUAL_TRAY_MAIN_ID). Single-nozzle printers keep 254 as the only external tray.
+        const dualNozzle = isDualNozzleModel(model);
+        const externalTrays = dualNozzle ? [254, 255] : [254];
         const validateTrayValue = (v, label) => {
             if (!Number.isInteger(v) ||
                 v < -1 ||
                 (v > 15 && v < 128) ||
-                v > 254) {
-                throw new Error(`${label} values must be integers in [-1, 15] (absolute tray) or 128-254 (HT/external); got ${v}`);
+                v > (dualNozzle ? 255 : 254)) {
+                throw new Error(`${label} values must be integers in ${describeAmsTrayRange({ dualNozzle })}; got ${v}`);
             }
         };
         let baseMapping;
@@ -639,7 +661,7 @@ export class BambuImplementation {
             const projectLen = Math.max(projectMetadata.projectFilamentCount, ...positions.map((p) => p + 1), 1);
             baseMapping = Array(projectLen).fill(-1);
             positions.forEach((pos, i) => {
-                baseMapping[pos] = options.useAMS === false ? 254 : i;
+                baseMapping[pos] = options.useAMS === false ? externalTrayForNozzle(inspection.filamentNozzleIndices?.[pos], dualNozzle) : i;
             });
         }
         let amsMapping;
@@ -647,15 +669,7 @@ export class BambuImplementation {
         if (usesH2ProjectFile) {
             const projLen = Math.max(projectMetadata.projectFilamentCount, baseMapping.length, 1);
             amsMapping = Array.from({ length: projLen }, (_, i) => i < baseMapping.length ? baseMapping[i] : -1);
-            amsMapping2 = amsMapping.map((v) => {
-                if (v < 0 || v === 255)
-                    return { ams_id: 255, slot_id: 255 };
-                if (v === 254)
-                    return { ams_id: 254, slot_id: 254 };
-                if (v >= 128)
-                    return { ams_id: 128, slot_id: v - 128 };
-                return { ams_id: Math.floor(v / 4), slot_id: v % 4 };
-            });
+            amsMapping2 = amsMapping.map((v) => bridgeAmsMapping2Entry(v, dualNozzle));
         }
         else {
             amsMapping = Array.from({ length: Math.max(5, baseMapping.length, projectMetadata.projectFilamentCount) }, (_, i) => i < baseMapping.length ? baseMapping[i] : -1);
@@ -665,8 +679,8 @@ export class BambuImplementation {
             if (baseMapping[position] === undefined || baseMapping[position] < 0) {
                 throw new Error(`Missing physical filament mapping for project filament ${position}.`);
             }
-            if (options.useAMS === false && baseMapping[position] !== 254) {
-                throw new Error("External-spool printing requires external spool mapping (254).");
+            if (options.useAMS === false && !externalTrays.includes(baseMapping[position])) {
+                throw new Error(`External-spool printing requires external spool mapping (${externalTrays.join(" or ")}).`);
             }
         }
         const legacyContainer = options.filePath.toLowerCase().endsWith(".gcode.3mf") && !usesH2ProjectFile && !isA1;
@@ -752,7 +766,7 @@ export class BambuImplementation {
                     project_id: submissionId,
                     subtask_id: submissionId,
                     task_id: submissionId,
-                    ams_mapping: amsMapping,
+                    ams_mapping: amsMapping.map(value => bridgeAmsMappingValue(value, dualNozzle)),
                     ams_mapping2: amsMapping2,
                 },
             };
@@ -822,6 +836,19 @@ export class BambuImplementation {
             throw new Error(`Failed to cancel print: ${error.message}`);
         }
     }
+    /** Raw MQTT stop for routes that already ran the shared cancellation steps. */
+    async sendStopOverMqtt(host, serial, token) {
+        const printer = await this.getPrinter(host, serial, token);
+        await invokeWithoutAck(printer, new UpdateStateCommand({ state: "stop" }));
+        return { status: "success", message: "Cancel command sent over MQTT." };
+    }
+    /** Raw MQTT heater-off; switching off needs no material or model declaration. */
+    async sendHeaterOffOverMqtt(host, serial, token, heater) {
+        const printer = await this.getPrinter(host, serial, token);
+        const gcode = `${heater === "bed" ? "M140" : "M104"} S0`;
+        await invokeWithoutAck(printer, new GCodeLineCommand({ gcodes: [gcode] }));
+        return { status: "success", message: `Heater-off sent over MQTT for ${heater}.`, command: gcode };
+    }
     async pauseJob(host, serial, token, dispatch) {
         const printer = dispatch ? undefined : await this.getPrinter(host, serial, token);
         try {
@@ -867,10 +894,12 @@ export class BambuImplementation {
             const codesFor = (status) => {
                 if (!Array.isArray(status.raw?.hms) || status.raw?.print_error === undefined)
                     throw new Error("Fresh error codes are required before clearing hardware errors.");
-                return [`print_error:${status.raw.print_error}`, ...status.raw.hms.map((entry) => `hms:${entry.attr}:${entry.code}`)].sort();
+                // Hidden notices never block and survive clean_print_error, so they are not errors to clear or re-acknowledge.
+                const hidden = new Set(hiddenHmsKeys(status.raw, serial, String(status.model ?? "")));
+                return [`print_error:${status.raw.print_error}`, ...status.raw.hms.map(reportedHmsKey).filter((key) => !hidden.has(key))].sort();
             };
             const codes = codesFor(await this.getSafetyStatus(host, serial, token));
-            await this.confirmHardwareAction(`Clear reported hardware errors on ${serial}: ${codes.join(", ")}? Inspect the printer and resolve the physical cause first. Confirm only after removing obstructions and correcting the fault.`, true);
+            await this.confirmHardwareAction(`Clear reported hardware errors on ${serial}: ${codes.map(describeHmsKey).join(", ")}? Inspect the printer and resolve the physical cause first. Confirm only after removing obstructions and correcting the fault.`, true);
             const beforeDispatch = async () => {
                 assertActive();
                 const current = codesFor(await this.getSafetyStatus(host, serial, token));
@@ -1001,11 +1030,13 @@ export class BambuImplementation {
             }
             const printer = dispatch ? undefined : await this.getPrinter(host, serial, token);
             assertActive();
-            if (dispatch)
-                await dispatch(heater, targetTemperature, assertActive, beforeDispatch);
-            else
+            const dispatched = dispatch ? await dispatch(heater, targetTemperature, assertActive, beforeDispatch) : undefined;
+            if (!dispatch)
                 await invokeWithoutAck(printer, new GCodeLineCommand({ gcodes: [gcode] }));
-            return { status: "success", message: `Temperature command sent for ${normalizedComponent}.`, command: gcode };
+            // Keep route details from a dual-route Linux heater-off.
+            const routeDetails = dispatched && typeof dispatched === "object" && "routes" in dispatched
+                ? { routes: dispatched.routes, native_error: dispatched.native_error, mqtt_error: dispatched.mqtt_error } : {};
+            return { status: "success", message: `Temperature command sent for ${normalizedComponent}.`, command: gcode, ...routeDetails };
         };
         if (targetTemperature === 0) {
             cancelPendingPrinterOperations(host, serial);

package/dist/safety/hidden-hms.d.ts

@@ -0,0 +1,32 @@
+export declare const HIDDEN_HMS_SOURCE: {
+    readonly studioTag: "v02.08.02.61";
+    readonly studioCommit: "926a7192574bcb9b3a732e1ec59a46d79cb45466";
+    /** Per table: Bambu's device_hms version and the SHA-256 of the English file used. */
+    readonly tables: {
+        readonly "093": {
+            readonly version: 202508191204;
+            readonly sha256: "7801fd6c355854b62ecb62ee32727b4e5dcca908841dbcfd5e5de45b3dfd1c25";
+        };
+        readonly "094": {
+            readonly version: 202503231214;
+            readonly sha256: "047c15e2140738ec08258b74536e6cb996cddf0c586c5c39e2318e54125a9e76";
+        };
+        readonly "20P": {
+            readonly version: 202511162200;
+            readonly sha256: "e4f067d027b9bcbb9bbf6cb90f41f11130cf4d83dffd3dee101db7826dc808c3";
+        };
+        readonly "22E": {
+            readonly version: 202510142200;
+            readonly sha256: "87426021aea2bd4e8d721e46e1c86808fd7c6fc06f52baf6d952ead9e8d14d1e";
+        };
+        readonly "239": {
+            readonly version: 202506171403;
+            readonly sha256: "c1d23d5302756d57df5cb9bc795d95fc54ef1db7565dca1f04b69a024886426a";
+        };
+        readonly "31B": {
+            readonly version: 202511162200;
+            readonly sha256: "dcf63657bff5451f0715ea3c032efe482279bc8cbc28cb9b8ae51c7354826574";
+        };
+    };
+};
+export declare const HIDDEN_HMS: Readonly<Record<string, readonly string[]>>;

package/dist/safety/hidden-hms.js

@@ -0,0 +1,405 @@
+// GENERATED by scripts/generate-hidden-hms.mjs from Bambu Studio v02.08.02.61
+// (commit 926a7192574bcb9b3a732e1ec59a46d79cb45466, resources/hms/hms_en_<serial prefix>.json).
+// Codes Bambu lists for a serial prefix with empty text in every entry. Do not edit by hand.
+export const HIDDEN_HMS_SOURCE = {
+    studioTag: "v02.08.02.61",
+    studioCommit: "926a7192574bcb9b3a732e1ec59a46d79cb45466",
+    /** Per table: Bambu's device_hms version and the SHA-256 of the English file used. */
+    tables: {
+        "093": { version: 202508191204, sha256: "7801fd6c355854b62ecb62ee32727b4e5dcca908841dbcfd5e5de45b3dfd1c25" },
+        "094": { version: 202503231214, sha256: "047c15e2140738ec08258b74536e6cb996cddf0c586c5c39e2318e54125a9e76" },
+        "20P": { version: 202511162200, sha256: "e4f067d027b9bcbb9bbf6cb90f41f11130cf4d83dffd3dee101db7826dc808c3" },
+        "22E": { version: 202510142200, sha256: "87426021aea2bd4e8d721e46e1c86808fd7c6fc06f52baf6d952ead9e8d14d1e" },
+        "239": { version: 202506171403, sha256: "c1d23d5302756d57df5cb9bc795d95fc54ef1db7565dca1f04b69a024886426a" },
+        "31B": { version: 202511162200, sha256: "dcf63657bff5451f0715ea3c032efe482279bc8cbc28cb9b8ae51c7354826574" },
+    },
+};
+export const HIDDEN_HMS = {
+    "093": [
+        "0300180000000000",
+        "050001000001000A",
+        "0500010000020003",
+        "0500010000020008",
+        "0500010000020009",
+        "0500010000030009",
+        "0500030000010053",
+        "0500030000020010",
+        "0500030000020011",
+        "0500030000020012",
+        "0500030000020013",
+        "0500030000020014",
+        "0500030000020015",
+        "0500030000020016",
+        "0500030000020017",
+        "0500030000020018",
+        "0500030000030007",
+        "0500040000020020",
+        "0500050000010008",
+        "0500050000010009",
+        "050005000001000A",
+        "050005000001000B",
+        "050005000001000C",
+        "0500050000020030",
+        "0500060000020005",
+        "0500060000020007",
+        "0500060000020008",
+        "0500060000020011",
+        "0500060000020012",
+        "0500060000020013",
+        "0500060000020014",
+        "0500060000020021",
+        "0500060000020022",
+        "0500060000020023",
+        "0500060000020024",
+        "0500060000020041",
+        "0500060000020043",
+        "0500060000020044",
+        "0500060000020051",
+        "0500060000020053",
+        "0500060000020054",
+        "0500060000020061",
+        "0500060000020062",
+        "05000600000200A0",
+        "05000600000200A1",
+        "0C00010000010018",
+        "0C0001000002000E",
+        "0C00010000020015",
+        "0C00010000020016",
+        "0C00010000020019",
+        "0C0001000002001A",
+        "0C0001000002001B",
+        "0C00040000020006",
+    ],
+    "094": [
+        "0300180000000000",
+        "0300260000000000",
+        "050001000001000A",
+        "0500010000020003",
+        "0500010000020008",
+        "0500010000020009",
+        "0500010000030009",
+        "0500030000020010",
+        "0500030000020011",
+        "0500030000020012",
+        "0500030000020013",
+        "0500030000020014",
+        "0500030000020015",
+        "0500030000020016",
+        "0500030000020017",
+        "0500030000020018",
+        "0500030000030007",
+        "0500040000020020",
+        "0500050000010008",
+        "0500050000010009",
+        "050005000001000A",
+        "050005000001000B",
+        "050005000001000C",
+        "0500060000020001",
+        "0500060000020002",
+        "0500060000020003",
+        "0500060000020005",
+        "0500060000020006",
+        "0500060000020007",
+        "0500060000020008",
+        "0500060000020011",
+        "0500060000020012",
+        "0500060000020013",
+        "0500060000020014",
+        "0500060000020021",
+        "0500060000020022",
+        "0500060000020023",
+        "0500060000020024",
+        "0500060000020041",
+        "0500060000020042",
+        "0500060000020043",
+        "0500060000020044",
+        "0500060000020051",
+        "0500060000020052",
+        "0500060000020053",
+        "0500060000020054",
+        "0500060000020061",
+        "0500060000020062",
+        "05000600000200A0",
+        "05000600000200A1",
+        "0C00010000020015",
+        "0C00010000020016",
+        "0C00010000020019",
+        "0C0001000002001A",
+        "0C0001000002001B",
+        "0C00040000020006",
+    ],
+    "20P": [
+        "0300180000000000",
+        "0300260000000000",
+        "050001000001000A",
+        "0500010000020003",
+        "0500010000020008",
+        "0500010000020009",
+        "050001000002000B",
+        "050001000002000F",
+        "0500010000020010",
+        "0500010000020011",
+        "0500010000030009",
+        "0500020000030009",
+        "050002000003000A",
+        "050002000003000B",
+        "050002000003000C",
+        "0500030000010053",
+        "0500030000020010",
+        "0500030000020011",
+        "0500030000020012",
+        "0500030000020013",
+        "0500030000020014",
+        "0500030000020015",
+        "0500030000020016",
+        "0500030000020017",
+        "0500030000020018",
+        "0500030000020019",
+        "0500030000020050",
+        "0500030000020051",
+        "0500030000020052",
+        "0500030000020053",
+        "0500030000020054",
+        "0500030000030007",
+        "0500040000010056",
+        "0500040000010060",
+        "0500040000010061",
+        "0500040000020020",
+        "0500050000010008",
+        "0500050000010009",
+        "050005000001000A",
+        "050005000001000B",
+        "050005000001000C",
+        "0500050000020023",
+        "0500050000020030",
+        "0500060000020005",
+        "0500060000020006",
+        "0500060000020007",
+        "0500060000020008",
+        "0500060000020009",
+        "0500060000020011",
+        "0500060000020012",
+        "0500060000020013",
+        "0500060000020014",
+        "0500060000020015",
+        "0500060000020021",
+        "0500060000020022",
+        "0500060000020023",
+        "0500060000020024",
+        "0500060000020025",
+        "0500060000020035",
+        "0500060000020041",
+        "0500060000020042",
+        "0500060000020044",
+        "0500060000020045",
+        "0500060000020051",
+        "0500060000020052",
+        "0500060000020054",
+        "0500060000020061",
+        "0500060000020062",
+        "0500060000020070",
+        "0500060000020071",
+        "05000600000200A0",
+        "05000600000200A1",
+        "0500070000020001",
+        "0500070000020002",
+        "0500070000020003",
+        "0500070000020101",
+        "0500070000020201",
+        "0503000000030027",
+        "0503000000030028",
+        "0503000000030029",
+        "0C00010000010018",
+        "0C0001000002000E",
+        "0C00010000020015",
+        "0C00010000020016",
+        "0C00010000020019",
+        "0C0001000002001A",
+        "0C0001000002001B",
+        "0C0003000003001A",
+        "0C00040000020006",
+    ],
+    "22E": [
+        "0300180000000000",
+        "050001000001000A",
+        "0500010000020003",
+        "0500010000020008",
+        "0500010000020009",
+        "0500010000030009",
+        "0500030000010053",
+        "0500030000020010",
+        "0500030000020011",
+        "0500030000020012",
+        "0500030000020013",
+        "0500030000020014",
+        "0500030000020015",
+        "0500030000020016",
+        "0500030000020017",
+        "0500030000020018",
+        "0500030000030007",
+        "0500040000010056",
+        "0500040000020020",
+        "0500050000010008",
+        "0500050000010009",
+        "050005000001000A",
+        "050005000001000B",
+        "050005000001000C",
+        "0500050000020030",
+        "0500060000020005",
+        "0500060000020007",
+        "0500060000020008",
+        "0500060000020011",
+        "0500060000020012",
+        "0500060000020013",
+        "0500060000020014",
+        "0500060000020021",
+        "0500060000020022",
+        "0500060000020023",
+        "0500060000020024",
+        "0500060000020044",
+        "0500060000020054",
+        "0500060000020061",
+        "0500060000020062",
+        "05000600000200A0",
+        "05000600000200A1",
+        "0500070000020001",
+        "0500070000020002",
+        "0500070000020003",
+        "0500070000020101",
+        "0500070000020201",
+        "0503000000030027",
+        "0503000000030028",
+        "0503000000030029",
+        "0C00010000010018",
+        "0C0001000002000E",
+        "0C00010000020015",
+        "0C00010000020016",
+        "0C00010000020019",
+        "0C0001000002001A",
+        "0C0001000002001B",
+        "0C00040000020006",
+    ],
+    "239": [
+        "0300180000000000",
+        "0300260000000000",
+        "0500010000020003",
+        "0500010000020008",
+        "0500010000020009",
+        "0500010000030009",
+        "0500030000020010",
+        "0500030000020011",
+        "0500030000020012",
+        "0500030000020013",
+        "0500030000020014",
+        "0500030000020015",
+        "0500030000020016",
+        "0500030000020017",
+        "0500030000020018",
+        "0500030000030007",
+        "0500040000020020",
+        "0500050000010008",
+        "0500050000010009",
+        "050005000001000A",
+        "050005000001000B",
+        "050005000001000C",
+        "0500060000020005",
+        "0500060000020006",
+        "0500060000020007",
+        "0500060000020008",
+        "0500060000020011",
+        "0500060000020012",
+        "0500060000020013",
+        "0500060000020014",
+        "0500060000020021",
+        "0500060000020022",
+        "0500060000020023",
+        "0500060000020024",
+        "0500060000020041",
+        "0500060000020042",
+        "0500060000020043",
+        "0500060000020044",
+        "0500060000020051",
+        "0500060000020052",
+        "0500060000020053",
+        "0500060000020054",
+        "0500060000020061",
+        "0500060000020062",
+        "05000600000200A0",
+        "05000600000200A1",
+        "0C00010000020015",
+        "0C00010000020016",
+        "0C00010000020019",
+        "0C0001000002001A",
+        "0C0001000002001B",
+        "0C00040000020006",
+    ],
+    "31B": [
+        "0300180000000000",
+        "0300260000000000",
+        "050001000001000A",
+        "0500010000020003",
+        "0500010000020008",
+        "0500010000020009",
+        "0500010000030009",
+        "0500030000010053",
+        "0500030000020010",
+        "0500030000020011",
+        "0500030000020012",
+        "0500030000020013",
+        "0500030000020014",
+        "0500030000020015",
+        "0500030000020016",
+        "0500030000020017",
+        "0500030000020018",
+        "0500030000030007",
+        "0500040000010056",
+        "0500040000020020",
+        "0500050000010008",
+        "0500050000010009",
+        "050005000001000A",
+        "050005000001000B",
+        "050005000001000C",
+        "0500050000020030",
+        "0500060000020005",
+        "0500060000020006",
+        "0500060000020007",
+        "0500060000020008",
+        "0500060000020011",
+        "0500060000020012",
+        "0500060000020013",
+        "0500060000020014",
+        "0500060000020021",
+        "0500060000020022",
+        "0500060000020023",
+        "0500060000020024",
+        "0500060000020041",
+        "0500060000020042",
+        "0500060000020043",
+        "0500060000020044",
+        "0500060000020051",
+        "0500060000020052",
+        "0500060000020053",
+        "0500060000020054",
+        "0500060000020061",
+        "0500060000020062",
+        "05000600000200A0",
+        "05000600000200A1",
+        "0500070000020001",
+        "0500070000020002",
+        "0500070000020003",
+        "0500070000020101",
+        "0500070000020201",
+        "0503000000030027",
+        "0503000000030028",
+        "0503000000030029",
+        "0C00010000010018",
+        "0C0001000002000E",
+        "0C00010000020015",
+        "0C00010000020016",
+        "0C00010000020019",
+        "0C0001000002001A",
+        "0C0001000002001B",
+        "0C0003000003001A",
+        "0C00040000020006",
+    ],
+};

package/dist/safety/limits.d.ts

@@ -21,6 +21,12 @@ export declare const MACHINE_LIMITS: Readonly<Record<string, {
     chamber: number;
     volume: readonly number[];
 }>>;
+/** Printers with two physical nozzles. Bambu Studio numbers the right/main nozzle 0
+ * (MAIN_EXTRUDER_ID) and the left/deputy nozzle 1 (DEPUTY_EXTRUDER_ID), and reports one
+ * virtual external-spool slot per nozzle: 255 (VIRTUAL_TRAY_MAIN_ID) and 254
+ * (VIRTUAL_TRAY_DEPUTY_ID). The single-nozzle H2S is deliberately absent. */
+export declare const DUAL_NOZZLE_MODELS: ReadonlySet<string>;
+export declare function isDualNozzleModel(model: unknown): boolean;
 export declare function normalizeModel(value: unknown): string | undefined;
 export declare function normalizeMaterial(value: unknown): string | undefined;
 export declare function validateTemperature(component: 'nozzle' | 'bed' | 'chamber', value: unknown, model: string, materials?: string[]): number;

package/dist/safety/limits.js

@@ -30,6 +30,15 @@ export const MACHINE_LIMITS = {
     h2s: { nozzle: 350, bed: 120, chamber: 65, volume: [340, 320, 340] },
     x2d: { nozzle: 300, bed: 120, chamber: 65, volume: [256, 256, 260] },
 };
+/** Printers with two physical nozzles. Bambu Studio numbers the right/main nozzle 0
+ * (MAIN_EXTRUDER_ID) and the left/deputy nozzle 1 (DEPUTY_EXTRUDER_ID), and reports one
+ * virtual external-spool slot per nozzle: 255 (VIRTUAL_TRAY_MAIN_ID) and 254
+ * (VIRTUAL_TRAY_DEPUTY_ID). The single-nozzle H2S is deliberately absent. */
+export const DUAL_NOZZLE_MODELS = new Set(['h2d', 'h2dpro', 'h2c', 'x2d']);
+export function isDualNozzleModel(model) {
+    const normalized = normalizeModel(model);
+    return normalized !== undefined && DUAL_NOZZLE_MODELS.has(normalized);
+}
 export function normalizeModel(value) {
     if (typeof value !== 'string')
         return undefined;

package/dist/safety/print-file.d.ts

@@ -12,6 +12,8 @@ export interface PrintFileInspection {
     selectsAms: boolean;
     nozzleTypes?: string[];
     nozzleFlows?: string[];
+    /** Physical nozzle index for each declared filament, composed from the selected plate headers. */
+    filamentNozzleIndices?: number[];
 }
 /** Inspect the exact selected plate. This does not simulate firmware or arbitrary motion:
  * only declared object bounds are checked, never purge/homing/wipe travel coordinates.