bambu-printer-mcp 1.1.27 → 1.1.28

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

@@ -57,6 +57,11 @@ function stripComments(line: string): string {
 /** 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: Map<string,number>, key: string, low: number, high: number): boolean {
+  const value=args.get(key);
+  return value!==undefined && Number.isFinite(value) && value>=low && value<=high;
+}
 function parameters(text: string, flags = ''): Map<string,number> {
   const result=new Map<string,number>();let rest=text.trim();
   while(rest) {
@@ -292,6 +297,26 @@ export async function inspectPrintFile(filePath: string, options: {model:string;
       if(!command) fail(`unsupported G-code command syntax '${line.slice(0,100)}'`);
       const [base,subcode]=command![2].split('.');
       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:Map<string,number>;
+        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:Record<string,number>={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
       // source omits layer comments. Retraction also closes it conservatively.
@@ -409,7 +434,18 @@ export async function inspectPrintFile(filePath: string, options: {model:string;
         const args=parameters(argumentsText);
         if(!args.has('S') || !args.has('L') || !args.has('T') || !Number.isInteger(args.get('T')) || args.get('T')!<0 || args.get('T')!>=nozzleDiameters.length) fail('unsupported M620.17 nozzle/material temperature mapping');
         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}`);
       } else if(code==='M145') {

package/src/safety/printer-state.ts

@@ -1,3 +1,4 @@
+import { HIDDEN_HMS } from "./hidden-hms.js";
 import { BambuClient, GetVersionCommand, PushAllCommand } from "bambu-node";
 import { normalizeMaterial, normalizeModel } from "./limits.js";
 
@@ -6,7 +7,7 @@ const MODEL_IDS: Record<string, string> = {
   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: Record<string, string> = {
+export const SERIAL_MODELS: Record<string, string> = {
   "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",
 };
@@ -183,24 +184,95 @@ function reportedNozzles(raw: Record<string,any>): ReportedNozzle[] {
   return output;
 }
 
-function validateErrors(raw: Record<string,any>, requireIdle: boolean) {
+const hiddenHmsSets = new Map(Object.entries(HIDDEN_HMS).map(([prefix, codes]) => [prefix, new Set(codes)]));
+
+type HmsEntry = { attr: number; code: number; severity: number; hex: string };
+function hmsCode(entry: any): HmsEntry | undefined {
+  const code = finiteNumber(entry?.code);
+  const attr = finiteNumber(entry?.attr);
+  const valid = (value: number | undefined): value is number => 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: string) => `HMS ${hex.slice(0, 4)}-${hex.slice(4, 8)}-${hex.slice(8, 12)}-${hex.slice(12)}`;
+const hmsKey = (entry: HmsEntry) => `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: unknown): string {
+  const parsed = hmsCode(entry);
+  return parsed ? hmsKey(parsed) : `hms:${(entry as any)?.attr}:${(entry as any)?.code}`;
+}
+
+/** Bambu's display form of a cleared-code key such as "hms:83887616:131184"; other keys unchanged. */
+export function describeHmsKey(key: string): string {
+  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: string, model: string, entry: HmsEntry): boolean {
+  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: unknown, serial: string, model: string): HmsEntry[] {
+  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<string>();
+  return entries.map(hmsCode).filter((entry): entry is HmsEntry =>
+    !!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: unknown, serial: string, model: string): string[] {
+  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: unknown, serial: string, model: string): string[] {
+  return hiddenHmsEntries(raw, serial, model).map(hmsKey);
+}
+
+const loggedHiddenNotices = new Set<string>();
+/** Name each hidden entry a check passed once per printer on stderr, so headless runs still record it. */
+function logHiddenNotices(raw: Record<string, any>, serial: string, model: string): void {
+  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: Record<string,any>, requireIdle: boolean, serial: string, model: string) {
   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.`);
   if (!requireIdle && !["IDLE","FINISH","RUNNING","PAUSE"].includes(state)) throw new Error(`Printer state ${state} is unknown or failed.`);
   if (finiteNumber(raw.print_error) !== 0) 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: number) => 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: unknown, label: string): number | undefined {
   if (value === undefined || value === null || value === "" || value === "0" || value === 0) return undefined;
@@ -248,7 +320,7 @@ export function validatePrinterState(status: any, requirements: PrinterStateRequ
   const identity = observedIdentity(raw, String(status.serial ?? ""));
   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) throw new Error("The nozzle is explicitly reported unloaded. Load the declared filament before starting or resuming this G-code job.");

package/src/slicer/profile-flatten.ts

@@ -335,6 +335,37 @@ function enforceMatchingNozzles(arr: unknown[]): void {
   }
 }
 
+/**
+ * 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: Record<string, unknown>,
+  volumeType: string,
+  machineLeaf: string
+): void {
+  const strings = (key: string): string[] =>
+    Array.isArray(flat[key]) ? (flat[key] as unknown[]).map(String) : [];
+  const extruderTypes = strings("extruder_type");
+  const declaredLists = strings("extruder_variant_list");
+  const count = (flat["nozzle_volume_type"] as unknown[]).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: string) =>
+      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";
@@ -687,6 +718,7 @@ export async function flattenForCli(opts: FlattenOptions): Promise<FlattenedProf
 
   // 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/src/stl/stl-manipulator.ts

@@ -166,6 +166,7 @@ export interface BambuSliceOptions {
   filamentColours?: string[];  // positional #RRGGBB per loaded filament slot
   bedType?: string;            // Bambu bed type, e.g. textured_plate or cool_plate
   nozzleType?: string;         // installed hotend material written into the machine preset
+  nozzleVolumeType?: 'Standard' | 'High Flow'; // installed nozzle flow, the machine preset's nozzle_volume_type
   enableTimelapse?: boolean;   // --enable-timelapse: timelapse-aware slicing
   allowMixTemp?: boolean;      // --allow-mix-temp: allow mixed-temp filaments
   scale?: number;              // --scale factor: uniform scale
@@ -563,6 +564,7 @@ export class STLManipulator extends EventEmitter {
       userProfileRoots: configuredBambuProfileDirs(),
       tempDir: this.tempDir,
       bedType: this.resolveBambuStudioBedType(bambuOptions?.bedType),
+      nozzleVolumeType: bambuOptions?.nozzleVolumeType,
       filamentColours: bambuOptions?.filamentColours ?? bundle.filamentColours,
       projectTowerPosition: bundle.projectTowerPosition,
       sourceProfiles: {