bambu-printer-mcp 1.1.27 → 1.1.28

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/print-file.js

@@ -62,6 +62,11 @@ function stripComments(line) {
 /** A deliberately narrow parameter lexer for commands affecting heat/material selection.
  * Unknown nonthermal vendor commands do not require a global G-code allowlist.
  */
+/** True when the parameter is present, finite and within [low, high]. */
+function inRange(args, key, low, high) {
+    const value = args.get(key);
+    return value !== undefined && Number.isFinite(value) && value >= low && value <= high;
+}
 function parameters(text, flags = '') {
     const result = new Map();
     let rest = text.trim();
@@ -392,6 +397,33 @@ export async function inspectPrintFile(filePath, options) {
             const code = command[1].toUpperCase() + String(Number(base)) + (subcode === undefined ? '' : '.' + subcode);
             const argumentsText = line.slice(command[0].length).trim();
             commandCount++;
+            if (code === 'M9711') {
+                // Official X2D and H2D time-lapse capture (Bambu Studio and OrcaSlicer
+                // templates), emitted on every layer: M is the time-lapse mode and E the
+                // physical extruder, not a second command; T is a duration, not a heater.
+                // It sets no temperature. Positions stay inside the machine volume.
+                const invalid = () => fail('unsupported M9711 time-lapse parameters');
+                if (!['x2d', 'h2d'].includes(model))
+                    invalid();
+                let args;
+                try {
+                    args = parameters(argumentsText);
+                }
+                catch {
+                    return invalid();
+                }
+                const [width, depth, height] = MACHINE_LIMITS[model].volume;
+                const position = ['X', 'Y', 'U', 'V'].filter(key => args.has(key)).join('');
+                const limit = { X: width, U: width, Y: depth, V: depth };
+                if ([...args.keys()].some(key => !'MEXYUVZSCOT'.includes(key)) ||
+                    // X2D and H2D have two physical extruders, whatever the file declares.
+                    ![0, 1].includes(args.get('M')) || !Number.isInteger(args.get('E')) || !inRange(args, 'E', 0, Math.min(nozzleDiameters.length, 2) - 1) ||
+                    args.get('S') !== 11 || args.get('C') !== 10 || args.get('O') !== 0 || !inRange(args, 'T', 0, 600000) ||
+                    !inRange(args, 'Z', 0, height) ||
+                    !['', 'XY', 'UV'].includes(position) || [...position].some(key => !inRange(args, key, 0, limit[key])))
+                    invalid();
+                continue;
+            }
             if (!['M117', 'M118', 'M1002', 'M1006', 'M900', 'M970', 'M983.1', 'G383'].includes(code) && /[GM]\s*\d/i.test(argumentsText))
                 fail('multiple commands on one line are unsupported');
             // Coordinated extrusion closes the startup-only allowance even when the
@@ -578,7 +610,21 @@ export async function inspectPrintFile(filePath, options) {
                 for (const key of args.keys())
                     if (!'SLT'.includes(key))
                         fail(`unsupported M620.17 parameter ${key}`);
-                heat('nozzle', args.get('S'), requirePosition(args.get('L')));
+                if (args.get('L') === -1 && model === 'x2d') {
+                    // OrcaSlicer's X2D start G-code preheats a nozzle with no assigned
+                    // filament (L-1) for toolhead-offset calibration; Bambu Studio writes
+                    // L0 there. No project filament is selected, so check the target
+                    // against the hardware limit and every declared material, like other
+                    // heater commands without a verified filament. That is never looser
+                    // than an accepted L<position> form. Material left in the nozzle from
+                    // an earlier job is live state that no file can declare. T names one
+                    // of the two physical nozzles, whatever the file declares.
+                    if (args.get('T') > 1)
+                        fail('unsupported M620.17 nozzle/material temperature mapping');
+                    heat('nozzle', args.get('S'), undefined, true);
+                }
+                else
+                    heat('nozzle', args.get('S'), requirePosition(args.get('L')));
             }
             else if ((/^M620\./.test(code) && !['M620.3', 'M620.6', 'M620.11'].includes(code)) || /^M621\./.test(code)) {
                 fail(`unsupported thermal-affecting filament command ${code}`);

package/dist/safety/printer-state.d.ts

@@ -1,4 +1,5 @@
 import { BambuClient } from "bambu-node";
+export declare const SERIAL_MODELS: Record<string, string>;
 /** Only raw reports received after this request are evidence. Never read printer.data here. */
 export declare function readFreshPrinterStatus(printer: BambuClient, serial: string, timeoutMs?: number): Promise<any>;
 export interface PrinterStateRequirements {
@@ -36,6 +37,14 @@ export interface ValidatedPrinterState {
     reportedNozzles: ReportedNozzle[];
     filaments: ReportedFilament[];
 }
+/** The one key format for a reported entry, shared by the gate and clear_hms_errors. */
+export declare function reportedHmsKey(entry: unknown): string;
+/** Bambu's display form of a cleared-code key such as "hms:83887616:131184"; other keys unchanged. */
+export declare function describeHmsKey(key: string): string;
+/** Labels of reported entries that pass only because Bambu hides them for this printer. */
+export declare function hiddenHmsNotices(raw: unknown, serial: string, model: string): string[];
+/** Cleared-code keys of reported hidden entries; clearing never removes them, so they are not re-acknowledged. */
+export declare function hiddenHmsKeys(raw: unknown, serial: string, model: string): string[];
 /** Verifies reported configuration, not a physical nozzle/spool inspection. */
 export declare function validatePrinterState(status: any, requirements: PrinterStateRequirements): ValidatedPrinterState;
 /** Manual M104 cannot remap filament slots. Validate the material already at the nozzle. */

package/dist/safety/printer-state.js

@@ -1,3 +1,4 @@
+import { HIDDEN_HMS } from "./hidden-hms.js";
 import { GetVersionCommand, PushAllCommand } from "bambu-node";
 import { normalizeMaterial, normalizeModel } from "./limits.js";
 const MAX_REPORT_AGE_MS = 15000;
@@ -5,7 +6,7 @@ const MODEL_IDS = {
     O1C: "H2C", O1C2: "H2C", O1D: "H2D", O1E: "H2D Pro", O1S: "H2S", N6: "X2D",
     N2S: "A1", A1M: "A1 Mini", C11: "P1P", C12: "P1S", C13: "X1E", "BL-P001": "X1C", "BL-P002": "X1",
 };
-const SERIAL_MODELS = {
+export const SERIAL_MODELS = {
     "093": "H2S", "094": "H2D", "31B": "H2C", "239": "H2D Pro", "20P": "X2D",
     "00M": "X1C", "00W": "X1", "03W": "X1E", "01S": "P1P", "01P": "P1S", "22E": "P2S", "039": "A1", "030": "A1 Mini",
 };
@@ -184,7 +185,77 @@ function reportedNozzles(raw) {
     }
     return output;
 }
-function validateErrors(raw, requireIdle) {
+const hiddenHmsSets = new Map(Object.entries(HIDDEN_HMS).map(([prefix, codes]) => [prefix, new Set(codes)]));
+function hmsCode(entry) {
+    const code = finiteNumber(entry?.code);
+    const attr = finiteNumber(entry?.attr);
+    const valid = (value) => value !== undefined && Number.isInteger(value) && value >= 0 && value <= 0xffffffff;
+    if (!valid(code) || !valid(attr))
+        return undefined;
+    // BambuStudio DevHMS.cpp: code >> 16; DevHMS.h: 1=fatal,2=serious,3=common,4=info.
+    return { attr, code, severity: Math.floor(code / 65536), hex: (attr.toString(16).padStart(8, "0") + code.toString(16).padStart(8, "0")).toUpperCase() };
+}
+const hmsLabel = (hex) => `HMS ${hex.slice(0, 4)}-${hex.slice(4, 8)}-${hex.slice(8, 12)}-${hex.slice(12)}`;
+const hmsKey = (entry) => `hms:${entry.attr}:${entry.code}`;
+/** The one key format for a reported entry, shared by the gate and clear_hms_errors. */
+export function reportedHmsKey(entry) {
+    const parsed = hmsCode(entry);
+    return parsed ? hmsKey(parsed) : `hms:${entry?.attr}:${entry?.code}`;
+}
+/** Bambu's display form of a cleared-code key such as "hms:83887616:131184"; other keys unchanged. */
+export function describeHmsKey(key) {
+    const match = /^hms:(\d+):(\d+)$/.exec(key);
+    const entry = match ? hmsCode({ attr: Number(match[1]), code: Number(match[2]) }) : undefined;
+    return entry ? hmsLabel(entry.hex) : key;
+}
+/**
+ * A serious or common entry that Bambu lists for this serial prefix with empty
+ * text: Bambu Studio, Bambu Handy and the printer screen never show it, and
+ * the printer keeps printing with it (an X2D raises 0500-0600-0002-0070 at
+ * every boot). Bambu Studio selects the table by serial prefix, so this does
+ * too, but only when that prefix belongs to the verified model: a sparse report
+ * without a serial must not let a misconfigured serial pick another model's
+ * table. Fatal, invalid-level and unlisted entries never qualify.
+ */
+function isHiddenNotice(serial, model, entry) {
+    if (entry.severity !== 2 && entry.severity !== 3)
+        return false;
+    const prefix = serial.trim().toUpperCase().slice(0, 3);
+    const normalized = normalizeModel(model);
+    if (!normalized || normalizeModel(SERIAL_MODELS[prefix] ?? "") !== normalized)
+        return false;
+    return hiddenHmsSets.get(prefix)?.has(entry.hex) === true;
+}
+function hiddenHmsEntries(raw, serial, model) {
+    if (!object(raw))
+        return [];
+    const identity = observedIdentity(raw, serial);
+    if (!identity.observedSerial || identity.model !== normalizeModel(model))
+        return [];
+    const entries = Array.isArray(raw.hms) ? raw.hms : [];
+    const seen = new Set();
+    return entries.map(hmsCode).filter((entry) => !!entry && isHiddenNotice(identity.observedSerial, model, entry) && !seen.has(entry.hex) && !!seen.add(entry.hex));
+}
+/** Labels of reported entries that pass only because Bambu hides them for this printer. */
+export function hiddenHmsNotices(raw, serial, model) {
+    return hiddenHmsEntries(raw, serial, model).map(entry => hmsLabel(entry.hex));
+}
+/** Cleared-code keys of reported hidden entries; clearing never removes them, so they are not re-acknowledged. */
+export function hiddenHmsKeys(raw, serial, model) {
+    return hiddenHmsEntries(raw, serial, model).map(hmsKey);
+}
+const loggedHiddenNotices = new Set();
+/** Name each hidden entry a check passed once per printer on stderr, so headless runs still record it. */
+function logHiddenNotices(raw, serial, model) {
+    for (const entry of hiddenHmsEntries(raw, serial, model)) {
+        const key = `${serial}:${entry.hex}`;
+        if (loggedHiddenNotices.has(key))
+            continue;
+        loggedHiddenNotices.add(key);
+        console.error(`Printer ${serial} reports ${hmsLabel(entry.hex)}, which Bambu lists for it without text and never shows as a fault; it does not block operations.`);
+    }
+}
+function validateErrors(raw, requireIdle, serial, model) {
     const state = typeof raw.gcode_state === "string" ? raw.gcode_state.toUpperCase() : "UNKNOWN";
     if (requireIdle && !["IDLE", "FINISH"].includes(state))
         throw new Error(`Printer state ${state} is not safely idle.`);
@@ -194,18 +265,14 @@ function validateErrors(raw, requireIdle) {
         throw new Error("Printer reports a print error or did not report its error state.");
     if (!Array.isArray(raw.hms))
         throw new Error("Printer HMS error state is missing or malformed.");
-    for (const entry of raw.hms) {
-        const code = finiteNumber(entry?.code);
-        const attr = finiteNumber(entry?.attr);
-        // BambuStudio DevHMS.cpp: code >> 16; DevHMS.h: 1=fatal,2=serious,3=common,4=info.
+    for (const reported of raw.hms) {
+        const entry = hmsCode(reported);
         // Unknown severities fail closed; attr identifies the module and is not a severity bitmask.
-        if (code === undefined || attr === undefined || !Number.isInteger(code) || !Number.isInteger(attr) || code < 0 || code > 0xffffffff || attr < 0 || attr > 0xffffffff || Math.floor(code / 65536) !== 4) {
-            const hex = (value) => value.toString(16).toUpperCase().padStart(8, "0");
-            const label = code !== undefined && attr !== undefined && Number.isInteger(code) && Number.isInteger(attr) && code >= 0 && attr >= 0
-                ? ` (HMS ${hex(attr).slice(0, 4)}-${hex(attr).slice(4)}-${hex(code).slice(0, 4)}-${hex(code).slice(4)})` : "";
-            throw new Error(`Printer reports actionable or unknown HMS errors${label}; inspect and resolve them before proceeding.`);
-        }
+        if (entry && (entry.severity === 4 || isHiddenNotice(serial, model, entry)))
+            continue;
+        throw new Error(`Printer reports actionable or unknown HMS errors${entry ? ` (${hmsLabel(entry.hex)})` : ""}; inspect and resolve them before proceeding.`);
     }
+    logHiddenNotices(raw, serial, model);
 }
 function trayRange(value, label) {
     if (value === undefined || value === null || value === "" || value === "0" || value === 0)
@@ -265,7 +332,7 @@ export function validatePrinterState(status, requirements) {
     const model = normalizeModel(requirements.model);
     if (!model || !identity.model || model !== identity.model)
         throw new Error(`Printer model identity mismatch: requested ${requirements.model}, observed ${identity.model ?? "unknown"}.`);
-    validateErrors(raw, requirements.requireIdle !== false);
+    validateErrors(raw, requirements.requireIdle !== false, identity.observedSerial ?? "", model);
     if (requirements.requireLoadedFilament && (raw.ams?.tray_now !== undefined || Array.isArray(raw.ams?.ams))) {
         const current = finiteNumber(raw.ams?.tray_now);
         if (current === 255)

package/dist/slicer/profile-flatten.js

@@ -228,6 +228,29 @@ function enforceMatchingNozzles(arr) {
         }
     }
 }
+/**
+ * BambuStudio picks each per-variant machine, process, and filament value
+ * (e.g. filament_max_volumetric_speed) by "<extruder_type> <nozzle_volume_type>"
+ * among the variants each extruder declares in extruder_variant_list. A flow
+ * type the preset doesn't declare has no values to pick, so refuse it instead
+ * of labelling a job for a nozzle it wasn't sliced for.
+ */
+function assertNozzleVariantDeclared(flat, volumeType, machineLeaf) {
+    const strings = (key) => Array.isArray(flat[key]) ? flat[key].map(String) : [];
+    const extruderTypes = strings("extruder_type");
+    const declaredLists = strings("extruder_variant_list");
+    const count = flat["nozzle_volume_type"].length;
+    for (let i = 0; i < count; i++) {
+        const extruderType = extruderTypes[i] ?? extruderTypes[0];
+        const declared = (declaredLists[i] ?? declaredLists[0] ?? "").split(",").map((v) => v.trim()).filter(Boolean);
+        const matches = (variant) => extruderType ? variant === `${extruderType} ${volumeType}` : variant.endsWith(` ${volumeType}`);
+        // Presets without variant declarations only have Standard values.
+        if (declared.length === 0 ? volumeType === "Standard" : declared.some(matches))
+            continue;
+        throw new Error(`Slicing for a ${volumeType} nozzle is refused: "${machineLeaf}" declares no ${volumeType} variant ` +
+            `for extruder ${i + 1} (declared: ${declared.join(", ") || "none"}).`);
+    }
+}
 /** Best-effort extruder count for fallback nozzle_volume_type sizing. */
 /** BambuStudio's built-in filament_colour default. */
 export const DEFAULT_FILAMENT_COLOUR = "#00AE42";
@@ -545,6 +568,8 @@ export async function flattenForCli(opts) {
     });
     // CLI-specific post-processing on machine profile only.
     deriveNozzleVolumeType(machineFlat, opts.nozzleVolumeType);
+    if (opts.nozzleVolumeType)
+        assertNozzleVariantDeclared(machineFlat, opts.nozzleVolumeType, opts.machineLeaf);
     applyMachineModelBedMetadata(machineFlat, machineIndex);
     // A standalone custom machine can accompany process/filament profiles that
     // need BBL resolution; do not impose bundled model config on that machine.

package/dist/stl/stl-manipulator.d.ts

@@ -39,6 +39,7 @@ export interface BambuSliceOptions {
     filamentColours?: string[];
     bedType?: string;
     nozzleType?: string;
+    nozzleVolumeType?: 'Standard' | 'High Flow';
     enableTimelapse?: boolean;
     allowMixTemp?: boolean;
     scale?: number;