bambu-printer-mcp 1.1.17 → 1.1.19

package/README.md

@@ -906,7 +906,7 @@ The primary tool for starting a Bambu print. **Recommended input: a pre-sliced `
 
 `bambu_model` is **required** for model-specific routing and preset selection. It does not by itself validate pre-sliced G-code. BambuStudio, FULU, and Orca CLI preparation additionally require the exact model/nozzle machine preset and reject incomplete profiles. Using the wrong model can damage hardware. If `bambu_model` is not provided in the tool call and `BAMBU_MODEL` is not set in the environment, the server will ask you interactively via MCP elicitation (if your client supports it) or return a clear error.
 
-`bed_type` defaults to `textured_plate` if omitted. `ams_slots` is the preferred override input; `ams_mapping` remains the raw escape hatch. On AMS-equipped H2 printers, `use_ams: false` does not suppress mapping lookup if the sliced file declares filaments. If no mapping is provided for an H2 pre-sliced job with declared filaments, the server fails before sending; pass explicit `ams_slots`, raw `ams_mapping`, or `auto_match_ams: true`.
+`bed_type` defaults to `textured_plate` if omitted. `nozzle_type` (`stainless_steel`, `hardened_steel`, `tungsten_carbide`, `brass`; default `BAMBU_NOZZLE_TYPE`) sets the installed nozzle when the project must be auto-sliced; the job's nozzle type must match the printer's report, and stock P1S/P1P/A1 presets assume stainless steel. After an MQTT print command the server listens to the printer's pushed reports for up to 15 seconds (`BAMBU_DISPATCH_CHECK_MS`) and returns `dispatch: "started"` or `"unconfirmed"`; if firmware 01.08.05+ refuses the command (HMS 0500-0500-0001-0007, needs LAN Only Mode and Developer Mode), the call fails and says so; clear that fatal HMS entry with `clear_hms_errors` before printing again. `ams_slots` is the preferred override input; `ams_mapping` remains the raw escape hatch. On AMS-equipped H2 printers, `use_ams: false` does not suppress mapping lookup if the sliced file declares filaments. If no mapping is provided for an H2 pre-sliced job with declared filaments, the server fails before sending; pass explicit `ams_slots`, raw `ams_mapping`, or `auto_match_ams: true`.
 
 Set `auto_match_ams: true` to match the sliced 3MF's `tray_info_idx` values against the live AMS inventory and use the matching `ams_slots`. The matcher joins on `(tray_info_idx, tray_color)` and tracks already-claimed slots, so prints with two filaments of the same SKU but different colors (e.g. two GFG02 PETG HF in black and white) resolve correctly. Falls back to SKU-only when the 3MF's filament has no color set or only one tray of that SKU is loaded. Returns a structured `missing` report (`reason: "no_loaded_match" | "color_mismatch" | "exhausted" | "no_sku"`) when a filament can't be resolved. Ignored when you provide `ams_slots` or `ams_mapping` explicitly.
 

package/dist/index.js

@@ -77,6 +77,18 @@ const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "
 // jobs take the correct branch instead of the legacy 5-slot mapping.
 const H2_BAMBU_MODELS = new Set(["h2d", "h2s", "h2c", "x2d"]);
 const VALID_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"];
+const VALID_NOZZLE_TYPES = ["stainless_steel", "hardened_steel", "tungsten_carbide", "brass"];
+/** The installed hotend material. Bambu machine presets assume the stock nozzle; the print gate compares this with the printer. */
+function resolveNozzleType(value) {
+    const raw = value === undefined || value === null || value === "" ? process.env.BAMBU_NOZZLE_TYPE?.trim() : value;
+    if (raw === undefined || raw === "")
+        return undefined;
+    const normalized = String(raw).trim().toLowerCase().replace(/[\s-]+/g, "_");
+    if (!VALID_NOZZLE_TYPES.includes(normalized)) {
+        throw new Error(`Invalid nozzle type "${raw}". Valid types: ${VALID_NOZZLE_TYPES.join(", ")}`);
+    }
+    return normalized;
+}
 const VALID_BAMBUSTUDIO_CLI_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate"];
 // Map model IDs to BambuStudio --load-machine preset names
 const BAMBU_MODEL_PRESETS = {
@@ -1010,6 +1022,7 @@ class BambuPrinterMCPServer {
             minSave: true,
             skipModifiedGcodes: true,
             bedType: bedType ? resolveBambuStudioCliBedType(bedType) : undefined,
+            nozzleType: resolveNozzleType(args?.nozzle_type),
         };
         threeMFPath = await this.stlManipulator.sliceSTL(threeMFPath, slicerType, slicerPath, slicerProfile || undefined, undefined, printPreset, autoSliceOptions);
         console.log("Auto-sliced to: " + threeMFPath);
@@ -1806,6 +1819,11 @@ class BambuPrinterMCPServer {
                                     enum: ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"],
                                     description: "Bed plate type for slicing (default: textured_plate). SuperTack is accepted only for pre-sliced print jobs until the BambuStudio CLI identifier is verified."
                                 },
+                                nozzle_type: {
+                                    type: "string",
+                                    enum: [...VALID_NOZZLE_TYPES],
+                                    description: "Bambu-compatible slicing: the hotend nozzle material installed on the printer (default: BAMBU_NOZZLE_TYPE, else the model preset's stock nozzle, usually stainless_steel). Printing compares it with the printer's reported nozzle."
+                                },
                                 use_printer_filaments: { type: "boolean", description: "When true, and no explicit slicer profile or load_filaments override is provided, use the printer's current or first loaded AMS filament as the slicer filament profile." },
                                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
                                 bambu_serial: { type: "string", description: "Serial number (default: value from env)" },
@@ -1856,6 +1874,11 @@ class BambuPrinterMCPServer {
                                     enum: ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"],
                                     description: "Bed plate type for slicing (default: textured_plate). SuperTack is accepted only for pre-sliced print jobs until the BambuStudio CLI identifier is verified."
                                 },
+                                nozzle_type: {
+                                    type: "string",
+                                    enum: [...VALID_NOZZLE_TYPES],
+                                    description: "Bambu-compatible slicing: the hotend nozzle material installed on the printer (default: BAMBU_NOZZLE_TYPE, else the model preset's stock nozzle, usually stainless_steel). Printing compares it with the printer's reported nozzle."
+                                },
                                 use_printer_filaments: { type: "boolean", description: "When true, and no explicit slicer profile or load_filaments override is provided, use the printer's current or first loaded AMS filament as the slicer filament profile. Template 3MF process settings can still be used at the same time." },
                                 uptodate: { type: "boolean", description: "Refresh 3MF preset configs to match the latest BambuStudio version. Use when slicing downloaded or older 3MF files to prevent stale-config failures." },
                                 repetitions: { type: "number", description: "Print N identical copies of the model. Each copy gets its own plate placement. Example: 3 prints three copies." },
@@ -1961,6 +1984,7 @@ class BambuPrinterMCPServer {
                                 username: { type: "string", description: "Printer username for LAN/local bridge methods; defaults to bblp." },
                                 password: { type: "string", description: "Printer password/access code override for LAN/local bridge methods." },
                                 bed_type: { type: "string", enum: ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"], description: "Bed plate type currently installed (default: textured_plate)." },
+                                nozzle_type: { type: "string", enum: [...VALID_NOZZLE_TYPES], description: "Installed nozzle material, used when the 3MF must be auto-sliced (default: BAMBU_NOZZLE_TYPE, else the preset's stock nozzle)." },
                                 plate_index: { type: "number", description: "Zero-based plate index to print from the sliced 3MF; converted to FULU's one-based PrintParams plate_index." },
                                 project_name: { type: "string", description: "Optional project name sent in FULU PrintParams; defaults to the 3MF filename without extension." },
                                 preset_name: { type: "string", description: "Optional preset name sent in FULU PrintParams; defaults to project plus one-based plate index." },
@@ -2366,6 +2390,11 @@ class BambuPrinterMCPServer {
                                     enum: ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"],
                                     description: "Bed plate type currently installed (default: textured_plate)"
                                 },
+                                nozzle_type: {
+                                    type: "string",
+                                    enum: [...VALID_NOZZLE_TYPES],
+                                    description: "Installed nozzle material, used when the 3MF must be auto-sliced (default: BAMBU_NOZZLE_TYPE, else the preset's stock nozzle)."
+                                },
                                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
                                 bambu_serial: { type: "string", description: "Serial number (default: value from env)" },
                                 bambu_token: { type: "string", description: "Access token (default: value from env)" },
@@ -3064,6 +3093,7 @@ class BambuPrinterMCPServer {
                         if (args?.filament_colours !== undefined)
                             sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
                         sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type);
+                        sliceBambuOptions.nozzleType = resolveNozzleType(args?.nozzle_type);
                         if (args?.enable_timelapse !== undefined)
                             sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
                         if (args?.allow_mix_temp !== undefined)
@@ -3143,6 +3173,7 @@ class BambuPrinterMCPServer {
                         if (args?.filament_colours !== undefined)
                             sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
                         sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type);
+                        sliceBambuOptions.nozzleType = resolveNozzleType(args?.nozzle_type);
                         if (args?.enable_timelapse !== undefined)
                             sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
                         if (args?.allow_mix_temp !== undefined)
@@ -3245,6 +3276,7 @@ class BambuPrinterMCPServer {
                                 minSave: true,
                                 skipModifiedGcodes: true,
                                 bedType: printBedType,
+                                nozzleType: resolveNozzleType(args?.nozzle_type),
                             };
                             if (!explicitSlicerProfile) {
                                 try {
@@ -3347,7 +3379,7 @@ class BambuPrinterMCPServer {
                             layerInspect: args?.layer_inspect !== undefined ? Boolean(args.layer_inspect) : undefined,
                             timelapse: args?.timelapse !== undefined ? Boolean(args.timelapse) : undefined,
                         });
-                        result = `Print command for ${threeMfFilename} sent successfully.`;
+                        // Report what the printer did, not merely that a command was published.
                         break;
                     }
                     case "print_collar_charm": {
@@ -3448,10 +3480,14 @@ class BambuPrinterMCPServer {
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
+                // Refusals and printer rejections repeat unchanged; say what to fix instead of "try again".
+                const refused = /nothing was (?:sent|uploaded)|no command was sent|does not match the job|is ambiguous|is missing or ambiguous|rejected the print command|are refused|is refused|refused because|refused until|refused before/i.test(message);
                 const structured = {
                     status: "error",
                     retryable: false,
-                    suggestion: `Check parameters and try again. Error: ${message}`,
+                    suggestion: refused
+                        ? `Retrying unchanged repeats this refusal. Fix the reported cause (file, arguments, printer settings, or printer state) first. Error: ${message}`
+                        : `Check parameters and try again. Error: ${message}`,
                     message,
                     tool: name,
                 };

package/dist/printers/bambu.d.ts

@@ -94,14 +94,23 @@ export declare class BambuImplementation {
         status: string;
         uploaded: boolean;
         printRequested: boolean;
+        dispatch: "started" | "unconfirmed";
         remotePath: string;
         message: string;
     }>;
     private printRawPrepared;
+    /**
+     * A published print command is not proof the printer took it. Listen to the
+     * reports the printer pushes anyway (no extra pushall polling on weak P1
+     * boards): a new command-verification HMS means the firmware refused the
+     * command; PREPARE/SLICING/RUNNING means it started. Attach before publishing.
+     */
+    private watchDispatch;
     startJob(host: string, serial: string, token: string, filename: string, bambuModel?: string): Promise<{
         status: string;
         uploaded: boolean;
         printRequested: boolean;
+        dispatch: "started" | "unconfirmed";
         remotePath: string;
         message: string;
     }>;

package/dist/printers/bambu.js

@@ -36,6 +36,21 @@ function loadClientCreds() {
 }
 const CLIENT_CREDS = loadClientCreds();
 const COMMAND_SETTLE_MS = 300;
+/** HMS 0500-0500-0001-0007: firmware 01.08.05+ rejected an unsigned MQTT command. */
+const COMMAND_VERIFICATION_HMS = { attr: 0x05000500, code: 0x00010007 };
+const COMMAND_REJECTED_MESSAGE = "The printer rejected the print command (HMS 0500-0500-0001-0007, \"MQTT command verification failed\"). " +
+    "Bambu firmware 01.08.05 and later only accept third-party LAN control with LAN Only Mode and Developer Mode " +
+    "enabled (Settings > WLAN on the printer). The checked file is on the printer's storage, but nothing is printing. " +
+    "The rejection stays on the printer as a fatal HMS entry that blocks later prints: after enabling those modes, " +
+    "clear it with clear_hms_errors or dismiss it on the printer's screen, then print again.";
+const DISPATCH_CANCELLED_MESSAGE = "A stop or heater-off request arrived after the print command was sent, so this call does not report the print as started. " +
+    "Check get_printer_status.";
+/** How long to watch fresh reports after a print command (BAMBU_DISPATCH_CHECK_MS, 0 disables). */
+function dispatchCheckMs() {
+    const raw = process.env.BAMBU_DISPATCH_CHECK_MS?.trim();
+    const value = raw ? Number(raw) : 15000;
+    return Number.isInteger(value) && value >= 0 && value <= 60000 ? value : 15000;
+}
 const MODEL_ID_TO_NAME = {
     O1C: "H2C",
     O1C2: "H2C",
@@ -685,9 +700,23 @@ export class BambuImplementation {
         const printer = await this.getPrinter(host, serial, token);
         assertActive();
         if (legacyContainer) {
-            await invokeWithoutAck(printer, new GCodeFileCommand({ fileName: remoteProjectPath }));
+            const watcher = this.watchDispatch(printer, host, serial, token, dispatchStatus, assertActive);
+            try {
+                await invokeWithoutAck(printer, new GCodeFileCommand({ fileName: remoteProjectPath }));
+            }
+            catch (error) {
+                watcher.dispose();
+                throw error;
+            }
             this.recordCheckedJob(host, serial, remoteProjectPath, requirements);
-            return { status: "success", message: `Uploaded and started gcode.3mf print: ${options.projectName}`, remoteProjectPath };
+            const dispatch = await watcher.settled();
+            return {
+                status: "success", dispatch, remoteProjectPath,
+                message: dispatch === "started"
+                    ? `The printer accepted and started the checked gcode.3mf print: ${options.projectName}`
+                    : `Uploaded the checked gcode.3mf and sent the print command for ${options.projectName}; the printer has not reported starting yet. ` +
+                        "Check get_printer_status before assuming it is printing.",
+            };
         }
         const b = (v) => (v ? 1 : 0);
         let projectFileCmd;
@@ -747,12 +776,24 @@ export class BambuImplementation {
                 },
             };
         }
-        await printer.publish(projectFileCmd);
+        const watcher = this.watchDispatch(printer, host, serial, token, dispatchStatus, assertActive);
+        try {
+            await printer.publish(projectFileCmd);
+        }
+        catch (error) {
+            watcher.dispose();
+            throw error;
+        }
         this.recordCheckedJob(host, serial, remoteProjectPath, requirements);
         await new Promise((resolve) => setTimeout(resolve, 300));
+        const dispatch = await watcher.settled();
         return {
             status: "success",
-            message: `Uploaded and started 3MF print: ${options.projectName}`,
+            dispatch,
+            message: dispatch === "started"
+                ? `The printer accepted and started the checked 3MF print: ${options.projectName}`
+                : `Uploaded the checked 3MF and sent the print command for ${options.projectName}; the printer has not reported starting yet. ` +
+                    "Check get_printer_status before assuming it is printing.",
             remoteProjectPath,
             plateFile: projectMetadata.plateFileName,
             platePath: projectMetadata.plateInternalPath,
@@ -1190,9 +1231,105 @@ export class BambuImplementation {
         this.assertBedClearance(dispatchStatus, bedClearance);
         const printer = await this.getPrinter(host, serial, token);
         assertActive();
-        await invokeWithoutAck(printer, new GCodeFileCommand({ fileName: remotePath }));
+        const watcher = this.watchDispatch(printer, host, serial, token, dispatchStatus, assertActive);
+        try {
+            await invokeWithoutAck(printer, new GCodeFileCommand({ fileName: remotePath }));
+        }
+        catch (error) {
+            watcher.dispose();
+            throw error;
+        }
         this.recordCheckedJob(host, serial, remotePath, requirements);
-        return { status: "success", uploaded: true, printRequested: true, remotePath, message: `Checked and started ${remotePath}.` };
+        const dispatch = await watcher.settled();
+        return {
+            status: "success", uploaded: true, printRequested: true, dispatch, remotePath,
+            message: dispatch === "started"
+                ? `The printer accepted and started ${remotePath}.`
+                : `Sent the print command for ${remotePath}; the printer has not reported starting yet. Check get_printer_status before assuming it is printing.`,
+        };
+    }
+    /**
+     * A published print command is not proof the printer took it. Listen to the
+     * reports the printer pushes anyway (no extra pushall polling on weak P1
+     * boards): a new command-verification HMS means the firmware refused the
+     * command; PREPARE/SLICING/RUNNING means it started. Attach before publishing.
+     */
+    watchDispatch(printer, host, serial, token, before, assertActive) {
+        const windowMs = dispatchCheckMs();
+        if (windowMs === 0)
+            return { settled: async () => { assertActive(); return "unconfirmed"; }, dispose: () => { } };
+        const key = (entry) => `${Number(entry?.attr)}:${Number(entry?.code)}:${entry?.timestamp ?? ""}`;
+        const known = new Set((Array.isArray(before?.raw?.hms) ? before.raw.hms : []).map(key));
+        const judge = (report) => {
+            const hms = Array.isArray(report?.hms) ? report.hms : [];
+            if (hms.some((entry) => Number(entry?.attr) === COMMAND_VERIFICATION_HMS.attr &&
+                Number(entry?.code) === COMMAND_VERIFICATION_HMS.code && !known.has(key(entry))))
+                return "rejected";
+            if (["PREPARE", "SLICING", "RUNNING"].includes(String(report?.gcode_state ?? "").toUpperCase()))
+                return "started";
+            return undefined;
+        };
+        let resolveOutcome;
+        const outcome = new Promise((resolve) => { resolveOutcome = resolve; });
+        const onRaw = (topic, payload) => {
+            if (topic !== `device/${serial}/report`)
+                return;
+            let parsed;
+            try {
+                parsed = JSON.parse(payload.toString());
+            }
+            catch {
+                return;
+            }
+            const verdict = judge(parsed?.print);
+            if (verdict)
+                resolveOutcome(verdict);
+        };
+        const cancelled = () => { try {
+            assertActive();
+            return false;
+        }
+        catch {
+            return true;
+        } };
+        printer?.on?.("rawMessage", onRaw);
+        const timer = setTimeout(() => resolveOutcome(undefined), windowMs);
+        // A stop during the window must not end as "accepted and started".
+        const cancelCheck = setInterval(() => { if (cancelled())
+            resolveOutcome("cancelled"); }, 250);
+        const dispose = () => {
+            clearTimeout(timer);
+            clearInterval(cancelCheck);
+            printer?.off?.("rawMessage", onRaw);
+            resolveOutcome(undefined);
+        };
+        return {
+            dispose,
+            settled: async () => {
+                let verdict;
+                try {
+                    verdict = await outcome;
+                }
+                finally {
+                    dispose();
+                }
+                // Nothing pushed during the window: take one full report, not a polling loop.
+                if (verdict === undefined && !cancelled()) {
+                    try {
+                        verdict = judge((await this.getSafetyStatus(host, serial, token))?.raw);
+                    }
+                    catch { /* stays unconfirmed */ }
+                }
+                if (verdict === "rejected") {
+                    // Nothing started, so there is no checked job to resume or clear later.
+                    this.checkedJobs.delete(`${host}\n${serial}`);
+                    throw new Error(COMMAND_REJECTED_MESSAGE);
+                }
+                if (verdict === "cancelled" || cancelled())
+                    throw new Error(DISPATCH_CANCELLED_MESSAGE);
+                return verdict ?? "unconfirmed";
+            },
+        };
     }
     async startJob(host, serial, token, filename, bambuModel) {
         assertDirectPrintSupported(bambuModel, serial);

package/dist/safety/printer-state.js

@@ -194,7 +194,10 @@ function validateErrors(raw, requireIdle) {
         // BambuStudio DevHMS.cpp: code >> 16; DevHMS.h: 1=fatal,2=serious,3=common,4=info.
         // 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) {
-            throw new Error("Printer reports actionable or unknown HMS errors; inspect and resolve them before proceeding.");
+            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.`);
         }
     }
 }

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

@@ -38,6 +38,7 @@ export interface BambuSliceOptions {
     loadFilamentIds?: string;
     filamentColours?: string[];
     bedType?: string;
+    nozzleType?: string;
     enableTimelapse?: boolean;
     allowMixTemp?: boolean;
     scale?: number;

package/dist/stl/stl-manipulator.js

@@ -1282,6 +1282,19 @@ export class STLManipulator extends EventEmitter {
                         const rawBundle = await this.resolveBambuLikeSettingsBundle(outputBase, slicerType, slicerProfile, printerPreset, bambuOptions, profilesRoot);
                         // Resolve every BBL dependency before launching the slicer.
                         const settingsBundle = await this.maybeFlattenBundle(await this.expandProjectFilaments(stlFilePath, rawBundle), bambuOptions, profilesRoot);
+                        // The machine preset assumes the stock hotend; record the installed one so
+                        // the sliced job's nozzle_type matches what the printer reports.
+                        if (bambuOptions?.nozzleType && settingsBundle.settingsArg) {
+                            const [machinePath, ...rest] = settingsBundle.settingsArg.split(';');
+                            const machine = this.readJsonFile(machinePath);
+                            const current = machine.nozzle_type;
+                            machine.nozzle_type = Array.isArray(current) && current.length > 0
+                                ? current.map(() => bambuOptions.nozzleType)
+                                : [bambuOptions.nozzleType];
+                            settingsBundle.settingsArg = [
+                                this.writeTempJson(outputBase, `machine_${bambuOptions.nozzleType}`, machine), ...rest,
+                            ].join(';');
+                        }
                         // Inherited process G-code is now present; apply Orca's existing
                         // absolute-extrusion normalization after resolving those ancestors.
                         // The machine owns the extrusion mode and layer G-code once process

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bambu-printer-mcp",
-  "version": "1.1.17",
+  "version": "1.1.19",
   "description": "MCP server for Bambu Lab 3D printers with STL manipulation, slicing, and print management",
   "main": "dist/index.js",
   "repository": {

package/src/index.ts

@@ -111,6 +111,18 @@ type BambuModel = typeof VALID_BAMBU_MODELS[number];
 const H2_BAMBU_MODELS = new Set<string>(["h2d", "h2s", "h2c", "x2d"]);
 
 const VALID_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"] as const;
+const VALID_NOZZLE_TYPES = ["stainless_steel", "hardened_steel", "tungsten_carbide", "brass"] as const;
+
+/** The installed hotend material. Bambu machine presets assume the stock nozzle; the print gate compares this with the printer. */
+function resolveNozzleType(value: unknown): string | undefined {
+  const raw = value === undefined || value === null || value === "" ? process.env.BAMBU_NOZZLE_TYPE?.trim() : value;
+  if (raw === undefined || raw === "") return undefined;
+  const normalized = String(raw).trim().toLowerCase().replace(/[\s-]+/g, "_");
+  if (!(VALID_NOZZLE_TYPES as readonly string[]).includes(normalized)) {
+    throw new Error(`Invalid nozzle type "${raw}". Valid types: ${VALID_NOZZLE_TYPES.join(", ")}`);
+  }
+  return normalized;
+}
 const VALID_BAMBUSTUDIO_CLI_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate"] as const;
 
 // Map model IDs to BambuStudio --load-machine preset names
@@ -1358,6 +1370,7 @@ class BambuPrinterMCPServer {
       minSave: true,
       skipModifiedGcodes: true,
       bedType: bedType ? resolveBambuStudioCliBedType(bedType) : undefined,
+      nozzleType: resolveNozzleType(args?.nozzle_type),
     };
     threeMFPath = await this.stlManipulator.sliceSTL(
       threeMFPath, slicerType, slicerPath, slicerProfile || undefined,
@@ -2332,6 +2345,11 @@ class BambuPrinterMCPServer {
                   enum: ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"],
                   description: "Bed plate type for slicing (default: textured_plate). SuperTack is accepted only for pre-sliced print jobs until the BambuStudio CLI identifier is verified."
                 },
+                nozzle_type: {
+                  type: "string",
+                  enum: [...VALID_NOZZLE_TYPES],
+                  description: "Bambu-compatible slicing: the hotend nozzle material installed on the printer (default: BAMBU_NOZZLE_TYPE, else the model preset's stock nozzle, usually stainless_steel). Printing compares it with the printer's reported nozzle."
+                },
                 use_printer_filaments: { type: "boolean", description: "When true, and no explicit slicer profile or load_filaments override is provided, use the printer's current or first loaded AMS filament as the slicer filament profile." },
                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
                 bambu_serial: { type: "string", description: "Serial number (default: value from env)" },
@@ -2382,6 +2400,11 @@ class BambuPrinterMCPServer {
                   enum: ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"],
                   description: "Bed plate type for slicing (default: textured_plate). SuperTack is accepted only for pre-sliced print jobs until the BambuStudio CLI identifier is verified."
                 },
+                nozzle_type: {
+                  type: "string",
+                  enum: [...VALID_NOZZLE_TYPES],
+                  description: "Bambu-compatible slicing: the hotend nozzle material installed on the printer (default: BAMBU_NOZZLE_TYPE, else the model preset's stock nozzle, usually stainless_steel). Printing compares it with the printer's reported nozzle."
+                },
                 use_printer_filaments: { type: "boolean", description: "When true, and no explicit slicer profile or load_filaments override is provided, use the printer's current or first loaded AMS filament as the slicer filament profile. Template 3MF process settings can still be used at the same time." },
                 uptodate: { type: "boolean", description: "Refresh 3MF preset configs to match the latest BambuStudio version. Use when slicing downloaded or older 3MF files to prevent stale-config failures." },
                 repetitions: { type: "number", description: "Print N identical copies of the model. Each copy gets its own plate placement. Example: 3 prints three copies." },
@@ -2487,6 +2510,7 @@ class BambuPrinterMCPServer {
                 username: { type: "string", description: "Printer username for LAN/local bridge methods; defaults to bblp." },
                 password: { type: "string", description: "Printer password/access code override for LAN/local bridge methods." },
                 bed_type: { type: "string", enum: ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"], description: "Bed plate type currently installed (default: textured_plate)." },
+                nozzle_type: { type: "string", enum: [...VALID_NOZZLE_TYPES], description: "Installed nozzle material, used when the 3MF must be auto-sliced (default: BAMBU_NOZZLE_TYPE, else the preset's stock nozzle)." },
                 plate_index: { type: "number", description: "Zero-based plate index to print from the sliced 3MF; converted to FULU's one-based PrintParams plate_index." },
                 project_name: { type: "string", description: "Optional project name sent in FULU PrintParams; defaults to the 3MF filename without extension." },
                 preset_name: { type: "string", description: "Optional preset name sent in FULU PrintParams; defaults to project plus one-based plate index." },
@@ -2892,6 +2916,11 @@ class BambuPrinterMCPServer {
                   enum: ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"],
                   description: "Bed plate type currently installed (default: textured_plate)"
                 },
+                nozzle_type: {
+                  type: "string",
+                  enum: [...VALID_NOZZLE_TYPES],
+                  description: "Installed nozzle material, used when the 3MF must be auto-sliced (default: BAMBU_NOZZLE_TYPE, else the preset's stock nozzle)."
+                },
                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
                 bambu_serial: { type: "string", description: "Serial number (default: value from env)" },
                 bambu_token: { type: "string", description: "Access token (default: value from env)" },
@@ -3719,6 +3748,7 @@ class BambuPrinterMCPServer {
             if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
             if (args?.filament_colours !== undefined) sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
             sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type as string | undefined);
+            sliceBambuOptions.nozzleType = resolveNozzleType(args?.nozzle_type);
             if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
             if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
             if (args?.scale !== undefined) sliceBambuOptions.scale = Number(args.scale);
@@ -3805,6 +3835,7 @@ class BambuPrinterMCPServer {
             if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
             if (args?.filament_colours !== undefined) sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
             sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type as string | undefined);
+            sliceBambuOptions.nozzleType = resolveNozzleType(args?.nozzle_type);
             if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
             if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
             if (args?.scale !== undefined) sliceBambuOptions.scale = Number(args.scale);
@@ -3932,6 +3963,7 @@ class BambuPrinterMCPServer {
                 minSave: true,
                 skipModifiedGcodes: true,
                 bedType: printBedType,
+                nozzleType: resolveNozzleType(args?.nozzle_type),
               };
               if (!explicitSlicerProfile) {
                 try {
@@ -4062,7 +4094,7 @@ class BambuPrinterMCPServer {
               layerInspect: args?.layer_inspect !== undefined ? Boolean(args.layer_inspect) : undefined,
               timelapse: args?.timelapse !== undefined ? Boolean(args.timelapse) : undefined,
             });
-            result = `Print command for ${threeMfFilename} sent successfully.`;
+            // Report what the printer did, not merely that a command was published.
             break;
           }
 
@@ -4214,10 +4246,14 @@ class BambuPrinterMCPServer {
 
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
+        // Refusals and printer rejections repeat unchanged; say what to fix instead of "try again".
+        const refused = /nothing was (?:sent|uploaded)|no command was sent|does not match the job|is ambiguous|is missing or ambiguous|rejected the print command|are refused|is refused|refused because|refused until|refused before/i.test(message);
         const structured: StructuredToolError = {
           status: "error",
           retryable: false,
-          suggestion: `Check parameters and try again. Error: ${message}`,
+          suggestion: refused
+            ? `Retrying unchanged repeats this refusal. Fix the reported cause (file, arguments, printer settings, or printer state) first. Error: ${message}`
+            : `Check parameters and try again. Error: ${message}`,
           message,
           tool: name,
         };

package/src/printers/bambu.ts

@@ -45,6 +45,24 @@ function loadClientCreds(): { cert: Buffer; key: Buffer } | null {
 const CLIENT_CREDS = loadClientCreds();
 
 const COMMAND_SETTLE_MS = 300;
+/** HMS 0500-0500-0001-0007: firmware 01.08.05+ rejected an unsigned MQTT command. */
+const COMMAND_VERIFICATION_HMS = { attr: 0x05000500, code: 0x00010007 };
+const COMMAND_REJECTED_MESSAGE =
+  "The printer rejected the print command (HMS 0500-0500-0001-0007, \"MQTT command verification failed\"). " +
+  "Bambu firmware 01.08.05 and later only accept third-party LAN control with LAN Only Mode and Developer Mode " +
+  "enabled (Settings > WLAN on the printer). The checked file is on the printer's storage, but nothing is printing. " +
+  "The rejection stays on the printer as a fatal HMS entry that blocks later prints: after enabling those modes, " +
+  "clear it with clear_hms_errors or dismiss it on the printer's screen, then print again.";
+const DISPATCH_CANCELLED_MESSAGE =
+  "A stop or heater-off request arrived after the print command was sent, so this call does not report the print as started. " +
+  "Check get_printer_status.";
+
+/** How long to watch fresh reports after a print command (BAMBU_DISPATCH_CHECK_MS, 0 disables). */
+function dispatchCheckMs(): number {
+  const raw = process.env.BAMBU_DISPATCH_CHECK_MS?.trim();
+  const value = raw ? Number(raw) : 15_000;
+  return Number.isInteger(value) && value >= 0 && value <= 60_000 ? value : 15_000;
+}
 
 const MODEL_ID_TO_NAME: Record<string, string> = {
   O1C: "H2C",
@@ -813,9 +831,17 @@ export class BambuImplementation {
     const printer = await this.getPrinter(host, serial, token);
     assertActive();
     if (legacyContainer) {
-      await invokeWithoutAck(printer, new GCodeFileCommand({ fileName: remoteProjectPath }));
+      const watcher = this.watchDispatch(printer, host, serial, token, dispatchStatus, assertActive);
+      try { await invokeWithoutAck(printer, new GCodeFileCommand({ fileName: remoteProjectPath })); } catch (error) { watcher.dispose(); throw error; }
       this.recordCheckedJob(host, serial, remoteProjectPath, requirements);
-      return { status: "success", message: `Uploaded and started gcode.3mf print: ${options.projectName}`, remoteProjectPath };
+      const dispatch = await watcher.settled();
+      return {
+        status: "success", dispatch, remoteProjectPath,
+        message: dispatch === "started"
+          ? `The printer accepted and started the checked gcode.3mf print: ${options.projectName}`
+          : `Uploaded the checked gcode.3mf and sent the print command for ${options.projectName}; the printer has not reported starting yet. ` +
+            "Check get_printer_status before assuming it is printing.",
+      };
     }
 
     const b = (v: any) => (v ? 1 : 0);
@@ -876,13 +902,19 @@ export class BambuImplementation {
       };
     }
 
-    await printer.publish(projectFileCmd);
+    const watcher = this.watchDispatch(printer, host, serial, token, dispatchStatus, assertActive);
+    try { await printer.publish(projectFileCmd); } catch (error) { watcher.dispose(); throw error; }
     this.recordCheckedJob(host, serial, remoteProjectPath, requirements);
     await new Promise((resolve) => setTimeout(resolve, 300));
+    const dispatch = await watcher.settled();
 
     return {
       status: "success",
-      message: `Uploaded and started 3MF print: ${options.projectName}`,
+      dispatch,
+      message: dispatch === "started"
+        ? `The printer accepted and started the checked 3MF print: ${options.projectName}`
+        : `Uploaded the checked 3MF and sent the print command for ${options.projectName}; the printer has not reported starting yet. ` +
+          "Check get_printer_status before assuming it is printing.",
       remoteProjectPath,
       plateFile: projectMetadata.plateFileName,
       platePath: projectMetadata.plateInternalPath,
@@ -1392,9 +1424,76 @@ export class BambuImplementation {
     this.assertBedClearance(dispatchStatus, bedClearance);
     const printer = await this.getPrinter(host, serial, token);
     assertActive();
-    await invokeWithoutAck(printer, new GCodeFileCommand({ fileName: remotePath }));
+    const watcher = this.watchDispatch(printer, host, serial, token, dispatchStatus, assertActive);
+    try { await invokeWithoutAck(printer, new GCodeFileCommand({ fileName: remotePath })); } catch (error) { watcher.dispose(); throw error; }
     this.recordCheckedJob(host, serial, remotePath, requirements);
-    return { status: "success", uploaded: true, printRequested: true, remotePath, message: `Checked and started ${remotePath}.` };
+    const dispatch = await watcher.settled();
+    return {
+      status: "success", uploaded: true, printRequested: true, dispatch, remotePath,
+      message: dispatch === "started"
+        ? `The printer accepted and started ${remotePath}.`
+        : `Sent the print command for ${remotePath}; the printer has not reported starting yet. Check get_printer_status before assuming it is printing.`,
+    };
+  }
+
+  /**
+   * A published print command is not proof the printer took it. Listen to the
+   * reports the printer pushes anyway (no extra pushall polling on weak P1
+   * boards): a new command-verification HMS means the firmware refused the
+   * command; PREPARE/SLICING/RUNNING means it started. Attach before publishing.
+   */
+  private watchDispatch(printer: any, host: string, serial: string, token: string, before: any, assertActive: () => void):
+    { settled: () => Promise<"started" | "unconfirmed">; dispose: () => void } {
+    const windowMs = dispatchCheckMs();
+    if (windowMs === 0) return { settled: async () => { assertActive(); return "unconfirmed"; }, dispose: () => {} };
+    const key = (entry: any) => `${Number(entry?.attr)}:${Number(entry?.code)}:${entry?.timestamp ?? ""}`;
+    const known = new Set((Array.isArray(before?.raw?.hms) ? before.raw.hms : []).map(key));
+    const judge = (report: any): "started" | "rejected" | undefined => {
+      const hms = Array.isArray(report?.hms) ? report.hms : [];
+      if (hms.some((entry: any) => Number(entry?.attr) === COMMAND_VERIFICATION_HMS.attr &&
+          Number(entry?.code) === COMMAND_VERIFICATION_HMS.code && !known.has(key(entry)))) return "rejected";
+      if (["PREPARE", "SLICING", "RUNNING"].includes(String(report?.gcode_state ?? "").toUpperCase())) return "started";
+      return undefined;
+    };
+    type Verdict = "started" | "rejected" | "cancelled" | undefined;
+    let resolveOutcome!: (value: Verdict) => void;
+    const outcome = new Promise<Verdict>((resolve) => { resolveOutcome = resolve; });
+    const onRaw = (topic: string, payload: Buffer) => {
+      if (topic !== `device/${serial}/report`) return;
+      let parsed: any;
+      try { parsed = JSON.parse(payload.toString()); } catch { return; }
+      const verdict = judge(parsed?.print);
+      if (verdict) resolveOutcome(verdict);
+    };
+    const cancelled = () => { try { assertActive(); return false; } catch { return true; } };
+    printer?.on?.("rawMessage", onRaw);
+    const timer = setTimeout(() => resolveOutcome(undefined), windowMs);
+    // A stop during the window must not end as "accepted and started".
+    const cancelCheck = setInterval(() => { if (cancelled()) resolveOutcome("cancelled"); }, 250);
+    const dispose = () => {
+      clearTimeout(timer);
+      clearInterval(cancelCheck);
+      printer?.off?.("rawMessage", onRaw);
+      resolveOutcome(undefined);
+    };
+    return {
+      dispose,
+      settled: async () => {
+        let verdict: Verdict;
+        try { verdict = await outcome; } finally { dispose(); }
+        // Nothing pushed during the window: take one full report, not a polling loop.
+        if (verdict === undefined && !cancelled()) {
+          try { verdict = judge((await this.getSafetyStatus(host, serial, token))?.raw); } catch { /* stays unconfirmed */ }
+        }
+        if (verdict === "rejected") {
+          // Nothing started, so there is no checked job to resume or clear later.
+          this.checkedJobs.delete(`${host}\n${serial}`);
+          throw new Error(COMMAND_REJECTED_MESSAGE);
+        }
+        if (verdict === "cancelled" || cancelled()) throw new Error(DISPATCH_CANCELLED_MESSAGE);
+        return verdict ?? "unconfirmed";
+      },
+    };
   }
 
   async startJob(host: string, serial: string, token: string, filename: string, bambuModel?: string) {

package/src/safety/printer-state.ts

@@ -190,7 +190,10 @@ function validateErrors(raw: Record<string,any>, requireIdle: boolean) {
     // BambuStudio DevHMS.cpp: code >> 16; DevHMS.h: 1=fatal,2=serious,3=common,4=info.
     // 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) {
-      throw new Error("Printer reports actionable or unknown HMS errors; inspect and resolve them before proceeding.");
+      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.`);
     }
   }
 }

package/src/stl/stl-manipulator.ts

@@ -164,6 +164,7 @@ export interface BambuSliceOptions {
   loadFilamentIds?: string;    // --load-filament-ids "1,2,3,1": filament-to-object mapping
   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
   enableTimelapse?: boolean;   // --enable-timelapse: timelapse-aware slicing
   allowMixTemp?: boolean;      // --allow-mix-temp: allow mixed-temp filaments
   scale?: number;              // --scale factor: uniform scale
@@ -1661,6 +1662,19 @@ export class STLManipulator extends EventEmitter {
             // Resolve every BBL dependency before launching the slicer.
             const settingsBundle = await this.maybeFlattenBundle(
               await this.expandProjectFilaments(stlFilePath, rawBundle), bambuOptions, profilesRoot);
+            // The machine preset assumes the stock hotend; record the installed one so
+            // the sliced job's nozzle_type matches what the printer reports.
+            if (bambuOptions?.nozzleType && settingsBundle.settingsArg) {
+              const [machinePath, ...rest] = settingsBundle.settingsArg.split(';');
+              const machine = this.readJsonFile(machinePath);
+              const current = machine.nozzle_type;
+              machine.nozzle_type = Array.isArray(current) && current.length > 0
+                ? current.map(() => bambuOptions.nozzleType)
+                : [bambuOptions.nozzleType];
+              settingsBundle.settingsArg = [
+                this.writeTempJson(outputBase, `machine_${bambuOptions.nozzleType}`, machine), ...rest,
+              ].join(';');
+            }
             // Inherited process G-code is now present; apply Orca's existing
             // absolute-extrusion normalization after resolving those ancestors.
             // The machine owns the extrusion mode and layer G-code once process