bambu-printer-mcp 1.1.16 → 1.1.18

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 = {
@@ -497,6 +509,30 @@ function parseBooleanEnv(rawValue, fallback) {
         return false;
     return fallback;
 }
+// Someone confirming a hardware action may have to walk to the printer, so the
+// SDK's 60-second request default is too short for human confirmation.
+const DEFAULT_CONFIRMATION_TIMEOUT_MS = 600000;
+const MIN_CONFIRMATION_TIMEOUT_MS = 1000;
+const MAX_CONFIRMATION_TIMEOUT_MS = 3600000;
+/** Out-of-range values fall back to the default; Node clamps huge timer delays to 1 ms. */
+function parseConfirmationTimeout(value) {
+    const parsed = Number(value?.trim() || NaN);
+    return Number.isInteger(parsed) && parsed >= MIN_CONFIRMATION_TIMEOUT_MS && parsed <= MAX_CONFIRMATION_TIMEOUT_MS
+        ? parsed
+        : DEFAULT_CONFIRMATION_TIMEOUT_MS;
+}
+function describeDuration(ms) {
+    return ms >= 60000 ? `${Math.round(ms / 6000) / 10} minute(s)` : `${Math.round(ms / 100) / 10} second(s)`;
+}
+function isElicitationTimeout(error) {
+    return error?.code === ErrorCode.RequestTimeout;
+}
+/** Only a missing method or capability means the client cannot show the prompt. */
+function isElicitationUnsupported(error) {
+    const message = String(error?.message ?? error);
+    return error?.code === ErrorCode.MethodNotFound || error?.code === ErrorCode.InvalidRequest ||
+        /does not support (form |url )?elicitation/i.test(message);
+}
 function parsePort(value, fallback) {
     if (!value)
         return fallback;
@@ -822,6 +858,7 @@ class BambuPrinterMCPServer {
     constructor() {
         this.blender = new BlenderMcpBridge();
         this.shuttingDown = false;
+        this.confirmationTimeoutMs = parseConfirmationTimeout(process.env.BAMBU_CONFIRMATION_TIMEOUT_MS);
         this.runtimeConfig = readRuntimeConfig();
         this.server = new Server({
             name: "bambu-printer-mcp",
@@ -842,11 +879,17 @@ class BambuPrinterMCPServer {
                         properties: { confirmed: { type: "boolean", title: "I checked the printer and confirm this operation", default: false } },
                         required: ["confirmed"],
                     },
-                });
+                }, { timeout: this.confirmationTimeoutMs });
                 return response.action === "accept" && response.content?.confirmed === true;
             }
-            catch {
-                throw new Error("Human hardware confirmation requires an MCP client with elicitation support. For deliberately headless operation, BAMBU_REQUIRE_CONFIRMATION=0 disables ordinary print/heat prompts; finished-bed clearance and hardware-error confirmation still require elicitation.");
+            catch (error) {
+                if (isElicitationTimeout(error)) {
+                    throw new Error(`No hardware confirmation within ${describeDuration(this.confirmationTimeoutMs)}; nothing was sent to the printer. Retry when someone can check the printer, or raise BAMBU_CONFIRMATION_TIMEOUT_MS.`);
+                }
+                if (isElicitationUnsupported(error)) {
+                    throw new Error("Human hardware confirmation requires an MCP client with elicitation support. For deliberately headless operation, BAMBU_REQUIRE_CONFIRMATION=0 disables ordinary print/heat prompts; finished-bed clearance and hardware-error confirmation still require elicitation.");
+                }
+                throw new Error(`Human hardware confirmation failed: ${error?.message ?? error}. Nothing was sent to the printer.`);
             }
         });
         this.bambuNetwork = new BambuNetworkBridge();
@@ -902,17 +945,19 @@ class BambuPrinterMCPServer {
                     },
                     required: ["bambu_model"],
                 },
-            });
+            }, { timeout: this.confirmationTimeoutMs });
             if (result.action === "accept" && result.content?.bambu_model) {
                 return validateBambuModel(String(result.content.bambu_model));
             }
             throw new Error("Printer model selection was cancelled. Cannot proceed without knowing the printer model.");
         }
         catch (elicitError) {
+            if (isElicitationTimeout(elicitError)) {
+                throw new Error(`No printer model was selected within ${describeDuration(this.confirmationTimeoutMs)}; nothing was sent to the printer. ` +
+                    "Set BAMBU_MODEL or pass bambu_model in the tool call.");
+            }
             // Elicitation not supported by this client — fall back to a clear error
-            const msg = elicitError?.message || String(elicitError);
-            if (elicitError?.code === -32601 || elicitError?.code === -32600 ||
-                msg.includes("does not support") || msg.includes("elicitation")) {
+            if (isElicitationUnsupported(elicitError)) {
                 throw new Error("bambu_model is required but your MCP client does not support elicitation. " +
                     `Set the BAMBU_MODEL environment variable or pass bambu_model in the tool call. ` +
                     `Valid models: ${VALID_BAMBU_MODELS.join(", ")}`);
@@ -977,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);
@@ -1773,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)" },
@@ -1823,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." },
@@ -1928,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." },
@@ -2333,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)" },
@@ -3031,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)
@@ -3110,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)
@@ -3212,6 +3276,7 @@ class BambuPrinterMCPServer {
                                 minSave: true,
                                 skipModifiedGcodes: true,
                                 bedType: printBedType,
+                                nozzleType: resolveNozzleType(args?.nozzle_type),
                             };
                             if (!explicitSlicerProfile) {
                                 try {
@@ -3314,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": {
@@ -3415,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/slicer/profile-flatten.js

@@ -41,6 +41,7 @@ import crypto from "node:crypto";
  */
 async function buildNameIndex(profilesRoot, vendor, userProfileRoots = []) {
     const index = new Map();
+    index.malformed = [];
     const subdirs = ["machine", "process", "filament"];
     const directories = [
         ...subdirs.map(sub => path.join(profilesRoot, vendor, sub)),
@@ -72,11 +73,15 @@ async function buildNameIndex(profilesRoot, vendor, userProfileRoots = []) {
                 data = JSON.parse(raw);
             }
             catch {
-                // Malformed profile -- skip, don't poison the index.
+                // Malformed profile -- skip, don't poison the index. A reference to
+                // it still fails, and the error names the skipped file.
+                index.malformed.push(filePath);
                 continue;
             }
-            if (!data || typeof data !== 'object' || Array.isArray(data))
+            if (!data || typeof data !== 'object' || Array.isArray(data)) {
+                index.malformed.push(filePath);
                 continue;
+            }
             const name = data["name"];
             if (typeof name !== "string" || name.length === 0)
                 continue;
@@ -106,7 +111,7 @@ function flattenByName(leafName, index, visiting = new Set()) {
     }
     const entry = index.get(leafName);
     if (!entry) {
-        throw new Error(`Profile "${leafName}" not found in index. The profile tree is incomplete or the name is misspelled.`);
+        throw new Error(`Profile "${leafName}" not found in index. The profile tree is incomplete or the name is misspelled.${describeMalformed(index)}`);
     }
     visiting.add(leafName);
     try {
@@ -116,6 +121,13 @@ function flattenByName(leafName, index, visiting = new Set()) {
         visiting.delete(leafName);
     }
 }
+function describeMalformed(index) {
+    const malformed = index.malformed ?? [];
+    if (malformed.length === 0)
+        return "";
+    const shown = malformed.slice(0, 5).map((file) => path.basename(file)).join(", ");
+    return ` Skipped ${malformed.length} unreadable or malformed profile file(s): ${shown}${malformed.length > 5 ? ", ..." : ""}.`;
+}
 function flattenData(data, index, visiting = new Set()) {
     const parent = data["inherits"];
     const merged = typeof parent === "string" && parent.length > 0
@@ -157,7 +169,7 @@ function applyIncludes(target, profile, index, visiting) {
         const entry = index.get(name);
         if (!entry) {
             throw new Error(`Profile "${String(profile["name"])}" includes "${name}", which is not in the index. ` +
-                `Refusing to fall back to inherited defaults (wrong G-code for this printer).`);
+                `Refusing to fall back to inherited defaults (wrong G-code for this printer).${describeMalformed(index)}`);
         }
         for (const [key, value] of Object.entries(flattenByName(name, index, visiting))) {
             if (!INCLUDE_METADATA_KEYS.has(key))

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;
@@ -62,10 +63,20 @@ export declare class STLManipulator extends EventEmitter {
     private readJsonFile;
     private stripAbsoluteExtruderResets;
     private sanitizeProcessForOrca;
+    /** Orca slices with absolute E distances; per-layer `G92 E0` resets would break them. */
+    private useAbsoluteExtrusionForOrca;
     private writeTempJson;
     private resolveBambuLikeSettingsBundle;
     /** Resolve BBL dependencies before invoking the CLI; failures stop the slice. */
     private maybeFlattenBundle;
+    /**
+     * The CLI applies every key in every --load-settings/--load-filaments file,
+     * so machine settings carried by a process or filament file (for example a
+     * template 3MF's project_settings from another printer) would replace the
+     * selected preset's start G-code, model, and bed geometry. The machine
+     * preset owns those keys; drop them from the other profiles.
+     */
+    private isolateMachineSettings;
     /** --load-filaments is positional; a single override must cover every project slot. */
     private expandProjectFilaments;
     private resolveBambuStudioBedType;

package/dist/stl/stl-manipulator.js

@@ -100,6 +100,11 @@ function configuredBambuProfileDirs() {
     ];
     return roots.flatMap((root) => appNames.map((appName) => path.join(root, appName, 'system', 'BBL')));
 }
+/** Keys every profile kind carries; they describe the file, not machine hardware. */
+const PROFILE_METADATA_KEYS = new Set([
+    'name', 'type', 'from', 'inherits', 'instantiation', 'setting_id', 'version', 'is_custom_defined',
+    'compatible_printers', 'compatible_printers_condition', 'compatible_prints', 'compatible_prints_condition',
+]);
 export class STLManipulator extends EventEmitter {
     constructor(tempDir = path.join(process.cwd(), 'temp')) {
         super();
@@ -193,11 +198,16 @@ export class STLManipulator extends EventEmitter {
         else if (sanitized.prime_tower_brim_width !== undefined) {
             sanitized.prime_tower_brim_width = String(sanitized.prime_tower_brim_width);
         }
-        sanitized.use_relative_e_distances = '0';
-        sanitized.before_layer_change_gcode = this.stripAbsoluteExtruderResets(sanitized.before_layer_change_gcode);
-        sanitized.layer_gcode = this.stripAbsoluteExtruderResets(sanitized.layer_gcode);
-        sanitized.layer_change_gcode = this.stripAbsoluteExtruderResets(sanitized.layer_change_gcode);
-        return sanitized;
+        return this.useAbsoluteExtrusionForOrca(sanitized);
+    }
+    /** Orca slices with absolute E distances; per-layer `G92 E0` resets would break them. */
+    useAbsoluteExtrusionForOrca(config) {
+        const normalized = { ...config };
+        normalized.use_relative_e_distances = '0';
+        normalized.before_layer_change_gcode = this.stripAbsoluteExtruderResets(normalized.before_layer_change_gcode);
+        normalized.layer_gcode = this.stripAbsoluteExtruderResets(normalized.layer_gcode);
+        normalized.layer_change_gcode = this.stripAbsoluteExtruderResets(normalized.layer_change_gcode);
+        return normalized;
     }
     writeTempJson(outputBase, suffix, value) {
         const serialized = JSON.stringify(value, null, 2);
@@ -426,6 +436,36 @@ export class STLManipulator extends EventEmitter {
                 : withCliFields(bundle.filamentPaths[i], profile, flat.filamentPaths[i], ['filament_colour'])),
         };
     }
+    /**
+     * The CLI applies every key in every --load-settings/--load-filaments file,
+     * so machine settings carried by a process or filament file (for example a
+     * template 3MF's project_settings from another printer) would replace the
+     * selected preset's start G-code, model, and bed geometry. The machine
+     * preset owns those keys; drop them from the other profiles.
+     */
+    isolateMachineSettings(bundle) {
+        const [machinePath, processPath] = bundle.settingsArg?.split(';') ?? [];
+        if (!machinePath || !processPath)
+            return bundle;
+        const machineKeys = Object.keys(this.readJsonFile(machinePath)).filter(key => !PROFILE_METADATA_KEYS.has(key));
+        const isolate = (filePath, label) => {
+            const profile = this.readJsonFile(filePath);
+            const foreign = machineKeys.filter(key => Object.prototype.hasOwnProperty.call(profile, key));
+            if (foreign.length === 0)
+                return filePath;
+            const isolated = { ...profile };
+            for (const key of foreign)
+                delete isolated[key];
+            console.error(`Ignoring ${foreign.length} machine setting(s) in ${label} profile ${filePath} ` +
+                `(the selected machine preset owns them): ${foreign.slice(0, 8).join(', ')}${foreign.length > 8 ? ', ...' : ''}`);
+            return this.writeTempJson(path.basename(filePath, '.json'), `${label}_without_machine`, isolated);
+        };
+        return {
+            ...bundle,
+            settingsArg: [machinePath, isolate(processPath, 'process')].join(';'),
+            filamentPaths: bundle.filamentPaths.map(filePath => isolate(filePath, 'filament')),
+        };
+    }
     /** --load-filaments is positional; a single override must cover every project slot. */
     async expandProjectFilaments(inputPath, bundle) {
         if (!inputPath.toLowerCase().endsWith('.3mf') || bundle.filamentPaths.length === 0)
@@ -1242,19 +1282,38 @@ 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
+                        // files lose machine keys, so normalize it there as well.
                         if (slicerType === 'orcaslicer' && settingsBundle.settingsArg) {
                             const [machinePath, processPath] = settingsBundle.settingsArg.split(';');
-                            settingsBundle.settingsArg = [machinePath, this.writeTempJson(outputBase, 'process_orca_resolved', this.sanitizeProcessForOrca(this.readJsonFile(processPath), printerPreset))].join(';');
+                            settingsBundle.settingsArg = [
+                                this.writeTempJson(outputBase, 'machine_orca_resolved', this.useAbsoluteExtrusionForOrca(this.readJsonFile(machinePath))),
+                                this.writeTempJson(outputBase, 'process_orca_resolved', this.sanitizeProcessForOrca(this.readJsonFile(processPath), printerPreset)),
+                            ].join(';');
                         }
+                        const cliBundle = this.isolateMachineSettings(settingsBundle);
                         args = [
                             '--slice', String(bambuOptions?.slicePlate ?? 0),
                             '--outputdir', outputDir,
                             '--export-3mf', path.basename(bambuOutputPath),
                         ];
-                        if (settingsBundle.settingsArg) {
-                            args.push('--load-settings', settingsBundle.settingsArg);
+                        if (cliBundle.settingsArg) {
+                            args.push('--load-settings', cliBundle.settingsArg);
                         }
                         // Always allow newer-version 3MF files (the CLI rejects them by default)
                         args.push('--allow-newer-file');
@@ -1289,8 +1348,8 @@ export class STLManipulator extends EventEmitter {
                             args.push('--clone-objects', bambuOptions.cloneObjects);
                         if (bambuOptions?.skipObjects)
                             args.push('--skip-objects', bambuOptions.skipObjects);
-                        if (settingsBundle.filamentPaths.length > 0) {
-                            args.push('--load-filaments', settingsBundle.filamentPaths.join(';'));
+                        if (cliBundle.filamentPaths.length > 0) {
+                            args.push('--load-filaments', cliBundle.filamentPaths.join(';'));
                             args.push('--load-defaultfila');
                         }
                         if (bambuOptions?.loadFilamentIds)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bambu-printer-mcp",
-  "version": "1.1.16",
+  "version": "1.1.18",
   "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
@@ -689,6 +701,35 @@ function parseBooleanEnv(rawValue: string | undefined, fallback: boolean): boole
   return fallback;
 }
 
+// Someone confirming a hardware action may have to walk to the printer, so the
+// SDK's 60-second request default is too short for human confirmation.
+const DEFAULT_CONFIRMATION_TIMEOUT_MS = 600_000;
+const MIN_CONFIRMATION_TIMEOUT_MS = 1_000;
+const MAX_CONFIRMATION_TIMEOUT_MS = 3_600_000;
+
+/** Out-of-range values fall back to the default; Node clamps huge timer delays to 1 ms. */
+function parseConfirmationTimeout(value: string | undefined): number {
+  const parsed = Number(value?.trim() || NaN);
+  return Number.isInteger(parsed) && parsed >= MIN_CONFIRMATION_TIMEOUT_MS && parsed <= MAX_CONFIRMATION_TIMEOUT_MS
+    ? parsed
+    : DEFAULT_CONFIRMATION_TIMEOUT_MS;
+}
+
+function describeDuration(ms: number): string {
+  return ms >= 60_000 ? `${Math.round(ms / 6_000) / 10} minute(s)` : `${Math.round(ms / 100) / 10} second(s)`;
+}
+
+function isElicitationTimeout(error: any): boolean {
+  return error?.code === ErrorCode.RequestTimeout;
+}
+
+/** Only a missing method or capability means the client cannot show the prompt. */
+function isElicitationUnsupported(error: any): boolean {
+  const message = String(error?.message ?? error);
+  return error?.code === ErrorCode.MethodNotFound || error?.code === ErrorCode.InvalidRequest ||
+    /does not support (form |url )?elicitation/i.test(message);
+}
+
 function parsePort(value: string | undefined, fallback: number): number {
   if (!value) return fallback;
   const parsed = Number(value);
@@ -1105,6 +1146,7 @@ class BambuPrinterMCPServer {
   private readonly runtimeConfig: RuntimeConfig;
   private httpRuntime?: { transport: StreamableHTTPServerTransport; httpServer: HttpServer };
   private shuttingDown = false;
+  private readonly confirmationTimeoutMs = parseConfirmationTimeout(process.env.BAMBU_CONFIRMATION_TIMEOUT_MS);
 
   constructor() {
     this.runtimeConfig = readRuntimeConfig();
@@ -1131,10 +1173,16 @@ class BambuPrinterMCPServer {
             properties: { confirmed: { type: "boolean", title: "I checked the printer and confirm this operation", default: false } },
             required: ["confirmed"],
           },
-        });
+        }, { timeout: this.confirmationTimeoutMs });
         return response.action === "accept" && response.content?.confirmed === true;
-      } catch {
-        throw new Error("Human hardware confirmation requires an MCP client with elicitation support. For deliberately headless operation, BAMBU_REQUIRE_CONFIRMATION=0 disables ordinary print/heat prompts; finished-bed clearance and hardware-error confirmation still require elicitation.");
+      } catch (error: any) {
+        if (isElicitationTimeout(error)) {
+          throw new Error(`No hardware confirmation within ${describeDuration(this.confirmationTimeoutMs)}; nothing was sent to the printer. Retry when someone can check the printer, or raise BAMBU_CONFIRMATION_TIMEOUT_MS.`);
+        }
+        if (isElicitationUnsupported(error)) {
+          throw new Error("Human hardware confirmation requires an MCP client with elicitation support. For deliberately headless operation, BAMBU_REQUIRE_CONFIRMATION=0 disables ordinary print/heat prompts; finished-bed clearance and hardware-error confirmation still require elicitation.");
+        }
+        throw new Error(`Human hardware confirmation failed: ${error?.message ?? error}. Nothing was sent to the printer.`);
       }
     });
     this.bambuNetwork = new BambuNetworkBridge();
@@ -1196,7 +1244,7 @@ class BambuPrinterMCPServer {
           },
           required: ["bambu_model"],
         },
-      });
+      }, { timeout: this.confirmationTimeoutMs });
 
       if (result.action === "accept" && result.content?.bambu_model) {
         return validateBambuModel(String(result.content.bambu_model));
@@ -1206,12 +1254,14 @@ class BambuPrinterMCPServer {
         "Printer model selection was cancelled. Cannot proceed without knowing the printer model."
       );
     } catch (elicitError: any) {
+      if (isElicitationTimeout(elicitError)) {
+        throw new Error(
+          `No printer model was selected within ${describeDuration(this.confirmationTimeoutMs)}; nothing was sent to the printer. ` +
+          "Set BAMBU_MODEL or pass bambu_model in the tool call."
+        );
+      }
       // Elicitation not supported by this client — fall back to a clear error
-      const msg = elicitError?.message || String(elicitError);
-      if (
-        elicitError?.code === -32601 || elicitError?.code === -32600 ||
-        msg.includes("does not support") || msg.includes("elicitation")
-      ) {
+      if (isElicitationUnsupported(elicitError)) {
         throw new Error(
           "bambu_model is required but your MCP client does not support elicitation. " +
           `Set the BAMBU_MODEL environment variable or pass bambu_model in the tool call. ` +
@@ -1320,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,
@@ -2294,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)" },
@@ -2344,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." },
@@ -2449,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." },
@@ -2854,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)" },
@@ -3681,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);
@@ -3767,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);
@@ -3894,6 +3963,7 @@ class BambuPrinterMCPServer {
                 minSave: true,
                 skipModifiedGcodes: true,
                 bedType: printBedType,
+                nozzleType: resolveNozzleType(args?.nozzle_type),
               };
               if (!explicitSlicerProfile) {
                 try {
@@ -4024,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;
           }
 
@@ -4176,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/slicer/profile-flatten.ts

@@ -95,7 +95,8 @@ interface IndexedProfile {
   data: Record<string, unknown>;
 }
 
-type NameIndex = Map<string, IndexedProfile>;
+/** Name index plus unreadable JSON files, reported when a name is missing. */
+type NameIndex = Map<string, IndexedProfile> & { malformed?: string[] };
 
 /* -------------------------------------------------------------------------- */
 /* Indexing                                                                    */
@@ -116,6 +117,7 @@ async function buildNameIndex(
   userProfileRoots: string[] = []
 ): Promise<NameIndex> {
   const index: NameIndex = new Map();
+  index.malformed = [];
   const subdirs: ProfileKind[] = ["machine", "process", "filament"];
 
   const directories = [
@@ -144,10 +146,15 @@ async function buildNameIndex(
       try {
         data = JSON.parse(raw) as Record<string, unknown>;
       } catch {
-        // Malformed profile -- skip, don't poison the index.
+        // Malformed profile -- skip, don't poison the index. A reference to
+        // it still fails, and the error names the skipped file.
+        index.malformed!.push(filePath);
+        continue;
+      }
+      if (!data || typeof data !== 'object' || Array.isArray(data)) {
+        index.malformed!.push(filePath);
         continue;
       }
-      if (!data || typeof data !== 'object' || Array.isArray(data)) continue;
       const name = data["name"];
       if (typeof name !== "string" || name.length === 0) continue;
       // First-write wins. BBL doesn't have name collisions in practice;
@@ -183,7 +190,7 @@ function flattenByName(
   }
   const entry = index.get(leafName);
   if (!entry) {
-    throw new Error(`Profile "${leafName}" not found in index. The profile tree is incomplete or the name is misspelled.`);
+    throw new Error(`Profile "${leafName}" not found in index. The profile tree is incomplete or the name is misspelled.${describeMalformed(index)}`);
   }
   visiting.add(leafName);
   try {
@@ -193,6 +200,13 @@ function flattenByName(
   }
 }
 
+function describeMalformed(index: NameIndex): string {
+  const malformed = index.malformed ?? [];
+  if (malformed.length === 0) return "";
+  const shown = malformed.slice(0, 5).map((file) => path.basename(file)).join(", ");
+  return ` Skipped ${malformed.length} unreadable or malformed profile file(s): ${shown}${malformed.length > 5 ? ", ..." : ""}.`;
+}
+
 function flattenData(
   data: Record<string, unknown>,
   index: NameIndex,
@@ -249,7 +263,7 @@ function applyIncludes(
     if (!entry) {
       throw new Error(
         `Profile "${String(profile["name"])}" includes "${name}", which is not in the index. ` +
-          `Refusing to fall back to inherited defaults (wrong G-code for this printer).`
+          `Refusing to fall back to inherited defaults (wrong G-code for this printer).${describeMalformed(index)}`
       );
     }
     for (const [key, value] of Object.entries(flattenByName(name, index, visiting))) {

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
@@ -186,6 +187,12 @@ interface BambuSettingsBundle {
   processSource?: { filePath: string; profile: Record<string, unknown> };
 }
 
+/** Keys every profile kind carries; they describe the file, not machine hardware. */
+const PROFILE_METADATA_KEYS = new Set([
+  'name', 'type', 'from', 'inherits', 'instantiation', 'setting_id', 'version', 'is_custom_defined',
+  'compatible_printers', 'compatible_printers_condition', 'compatible_prints', 'compatible_prints_condition',
+]);
+
 export class STLManipulator extends EventEmitter {
   private tempDir: string;
   private activeOperations: Map<string, boolean> = new Map();
@@ -304,16 +311,22 @@ export class STLManipulator extends EventEmitter {
       sanitized.prime_tower_brim_width = String(sanitized.prime_tower_brim_width);
     }
 
-    sanitized.use_relative_e_distances = '0';
-    sanitized.before_layer_change_gcode = this.stripAbsoluteExtruderResets(
-      sanitized.before_layer_change_gcode
+    return this.useAbsoluteExtrusionForOrca(sanitized);
+  }
+
+  /** Orca slices with absolute E distances; per-layer `G92 E0` resets would break them. */
+  private useAbsoluteExtrusionForOrca(config: any): any {
+    const normalized = { ...config };
+    normalized.use_relative_e_distances = '0';
+    normalized.before_layer_change_gcode = this.stripAbsoluteExtruderResets(
+      normalized.before_layer_change_gcode
     );
-    sanitized.layer_gcode = this.stripAbsoluteExtruderResets(sanitized.layer_gcode);
-    sanitized.layer_change_gcode = this.stripAbsoluteExtruderResets(
-      sanitized.layer_change_gcode
+    normalized.layer_gcode = this.stripAbsoluteExtruderResets(normalized.layer_gcode);
+    normalized.layer_change_gcode = this.stripAbsoluteExtruderResets(
+      normalized.layer_change_gcode
     );
 
-    return sanitized;
+    return normalized;
   }
 
   private writeTempJson(outputBase: string, suffix: string, value: any): string {
@@ -584,6 +597,36 @@ export class STLManipulator extends EventEmitter {
     };
   }
 
+  /**
+   * The CLI applies every key in every --load-settings/--load-filaments file,
+   * so machine settings carried by a process or filament file (for example a
+   * template 3MF's project_settings from another printer) would replace the
+   * selected preset's start G-code, model, and bed geometry. The machine
+   * preset owns those keys; drop them from the other profiles.
+   */
+  private isolateMachineSettings(bundle: BambuSettingsBundle): BambuSettingsBundle {
+    const [machinePath, processPath] = bundle.settingsArg?.split(';') ?? [];
+    if (!machinePath || !processPath) return bundle;
+    const machineKeys = Object.keys(this.readJsonFile(machinePath)).filter(key => !PROFILE_METADATA_KEYS.has(key));
+    const isolate = (filePath: string, label: string): string => {
+      const profile = this.readJsonFile(filePath);
+      const foreign = machineKeys.filter(key => Object.prototype.hasOwnProperty.call(profile, key));
+      if (foreign.length === 0) return filePath;
+      const isolated = { ...profile };
+      for (const key of foreign) delete isolated[key];
+      console.error(
+        `Ignoring ${foreign.length} machine setting(s) in ${label} profile ${filePath} ` +
+        `(the selected machine preset owns them): ${foreign.slice(0, 8).join(', ')}${foreign.length > 8 ? ', ...' : ''}`
+      );
+      return this.writeTempJson(path.basename(filePath, '.json'), `${label}_without_machine`, isolated);
+    };
+    return {
+      ...bundle,
+      settingsArg: [machinePath, isolate(processPath, 'process')].join(';'),
+      filamentPaths: bundle.filamentPaths.map(filePath => isolate(filePath, 'filament')),
+    };
+  }
+
   /** --load-filaments is positional; a single override must cover every project slot. */
   private async expandProjectFilaments(
     inputPath: string,
@@ -1619,22 +1662,40 @@ 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
+            // files lose machine keys, so normalize it there as well.
             if (slicerType === 'orcaslicer' && settingsBundle.settingsArg) {
               const [machinePath, processPath] = settingsBundle.settingsArg.split(';');
-              settingsBundle.settingsArg = [machinePath, this.writeTempJson(
-                outputBase, 'process_orca_resolved',
-                this.sanitizeProcessForOrca(this.readJsonFile(processPath), printerPreset)
-              )].join(';');
+              settingsBundle.settingsArg = [
+                this.writeTempJson(outputBase, 'machine_orca_resolved',
+                  this.useAbsoluteExtrusionForOrca(this.readJsonFile(machinePath))),
+                this.writeTempJson(outputBase, 'process_orca_resolved',
+                  this.sanitizeProcessForOrca(this.readJsonFile(processPath), printerPreset)),
+              ].join(';');
             }
+            const cliBundle = this.isolateMachineSettings(settingsBundle);
             args = [
               '--slice', String(bambuOptions?.slicePlate ?? 0),
               '--outputdir', outputDir,
               '--export-3mf', path.basename(bambuOutputPath),
             ];
-            if (settingsBundle.settingsArg) {
-              args.push('--load-settings', settingsBundle.settingsArg);
+            if (cliBundle.settingsArg) {
+              args.push('--load-settings', cliBundle.settingsArg);
             }
             // Always allow newer-version 3MF files (the CLI rejects them by default)
             args.push('--allow-newer-file');
@@ -1655,8 +1716,8 @@ export class STLManipulator extends EventEmitter {
             if (bambuOptions?.rotateY !== undefined) args.push('--rotate-y', String(bambuOptions.rotateY));
             if (bambuOptions?.cloneObjects) args.push('--clone-objects', bambuOptions.cloneObjects);
             if (bambuOptions?.skipObjects) args.push('--skip-objects', bambuOptions.skipObjects);
-            if (settingsBundle.filamentPaths.length > 0) {
-              args.push('--load-filaments', settingsBundle.filamentPaths.join(';'));
+            if (cliBundle.filamentPaths.length > 0) {
+              args.push('--load-filaments', cliBundle.filamentPaths.join(';'));
               args.push('--load-defaultfila');
             }
             if (bambuOptions?.loadFilamentIds) args.push('--load-filament-ids', bambuOptions.loadFilamentIds);