bambu-printer-mcp 1.1.27 → 1.1.29

package/src/printers/bambu.ts

@@ -7,8 +7,9 @@ import os from "node:os";
 import { Readable } from "node:stream";
 import { readSafe3mfArchive } from "../safety/archive.js";
 import { inspectPrintFile, type PrintFileInspection } from "../safety/print-file.js";
-import { normalizeModel, validateTemperature } from "../safety/limits.js";
-import { validatePrinterState, manualHeatingRequirements, type PrinterStateRequirements } 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, type PrinterStateRequirements } 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";
@@ -85,7 +86,7 @@ const H2_MODEL_NAMES = new Set(["h2", "h2c", "h2d", "h2dpro", "h2d pro", "h2s",
 export function assertDirectPrintSupported(model: string | undefined, serial?: string): void {
   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. " +
+      "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."
     );
   }
@@ -461,6 +462,9 @@ class BambuClientStore {
   }
 }
 
+/** What the human confirmed in confirmPrintPreflight, checked again before dispatch. */
+export type PrintPreflight = { finishedJob?: string; serial: string; model: string; notices: string[] };
+
 export class BambuImplementation {
   private printerStore: BambuClientStore;
   private checkedJobs = new Map<string, { remotePath: string; requirements: PrinterStateRequirements }>();
@@ -481,25 +485,41 @@ export class BambuImplementation {
     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;
   }
 
-  async confirmPrintPreflight(serial: string, status: any, inspection: Awaited<ReturnType<typeof inspectPrintFile>>): Promise<string | 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: string, status: any, inspection: Awaited<ReturnType<typeof inspectPrintFile>>): Promise<PrintPreflight> {
     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.` : ""),
+      (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;
+    return { finishedJob, serial, model: inspection.model, notices };
   }
 
-  assertBedClearance(status: any, confirmedFinishedJob: string | undefined): void {
+  /** Stop a print whose confirmed situation changed: a newly finished job, or a hidden HMS notice the preflight did not name. */
+  assertBedClearance(status: any, preflight: PrintPreflight): void {
     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.");
+    }
   }
 
   private async getPrinter(host: string, serial: string, token: string): Promise<BambuClient> {
@@ -728,15 +748,20 @@ 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: unknown, label: string): void => {
       if (
         !Number.isInteger(v) ||
         (v as number) < -1 ||
         ((v as number) > 15 && (v as number) < 128) ||
-        (v as number) > 254
+        (v as number) > (dualNozzle ? 255 : 254)
       ) {
         throw new Error(
-          `${label} values must be integers in [-1, 15] (absolute tray) or 128-254 (HT/external); got ${v}`
+          `${label} values must be integers in ${describeAmsTrayRange({ dualNozzle })}; got ${v}`
         );
       }
     };
@@ -775,7 +800,7 @@ export class BambuImplementation {
       );
       baseMapping = Array<number>(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;
       });
     }
 
@@ -786,12 +811,7 @@ export class BambuImplementation {
       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
@@ -803,8 +823,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;
@@ -879,7 +899,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,
         },
       };
@@ -944,6 +964,21 @@ export class BambuImplementation {
     }
   }
 
+  /** Raw MQTT stop for routes that already ran the shared cancellation steps. */
+  async sendStopOverMqtt(host: string, serial: string, token: string): Promise<any> {
+    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: string, serial: string, token: string, heater: "bed" | "nozzle"): Promise<any> {
+    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: string, serial: string, token: string, dispatch?: () => Promise<any>): Promise<any> {
     const printer = dispatch ? undefined : await this.getPrinter(host, serial, token);
     try {
@@ -982,10 +1017,12 @@ export class BambuImplementation {
     return withPrinterOperation(host, serial, async assertActive => {
       const codesFor = (status: any): string[] => {
         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: any) => `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: string) => !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));
@@ -1141,9 +1178,12 @@ export class BambuImplementation {
       }
       const printer = dispatch ? undefined : await this.getPrinter(host, serial, token);
       assertActive();
-      if (dispatch) await dispatch(heater, targetTemperature, assertActive, beforeDispatch);
-      else await invokeWithoutAck(printer!, new GCodeLineCommand({ gcodes: [gcode] }));
-      return { status: "success", message: `Temperature command sent for ${normalizedComponent}.`, command: gcode };
+      const dispatched = dispatch ? await dispatch(heater, targetTemperature, assertActive, beforeDispatch) : undefined;
+      if (!dispatch) await invokeWithoutAck(printer!, new GCodeLineCommand({ gcodes: [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/src/safety/hidden-hms.ts

@@ -0,0 +1,406 @@
+// 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" },
+  },
+} as const;
+
+export const HIDDEN_HMS: Readonly<Record<string, readonly string[]>> = {
+  "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/src/safety/limits.ts

@@ -31,6 +31,15 @@ export const MACHINE_LIMITS: Readonly<Record<string, {nozzle: number; bed: numbe
   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: ReadonlySet<string> = new Set(['h2d','h2dpro','h2c','x2d']);
+export function isDualNozzleModel(model: unknown): boolean {
+  const normalized = normalizeModel(model);
+  return normalized !== undefined && DUAL_NOZZLE_MODELS.has(normalized);
+}
 export function normalizeModel(value: unknown): string | undefined {
   if (typeof value !== 'string') return undefined;
   let model = value.trim().toLowerCase().replace(/^bambu\s*(?:lab\s*)?/, '').replace(/[\s_-]/g, '');