bambu-printer-mcp 1.1.12 → 1.1.13

package/CONTRIBUTORS.md

@@ -6,6 +6,8 @@ Thank you to everyone who builds, tests, reports problems, and shares real print
 
 | Contributor | Contribution |
 | --- | --- |
+| [Boardy (@boardyai)](https://x.com/boardyai) | Raises the nozzle-verification question that informs the added printer safety checks. |
+| Fable red-team review, shared by David Montgomery | Supplies archive-ambiguity reproductions and hardware-safety review findings used for plate binding, upload checks, temperature policy, and human preflight. Network/security suggestions remain outside this hardware-safety release. |
 | [Sebastian (sebas1986)](https://github.com/sebas1986) | Isolates the multi-filament CLI crash with real BambuStudio bisection, contributes per-slot colours and multi-nozzle prime-tower placement, and verifies X2D identification, status, and slicing in [#18](https://github.com/DMontgomery40/bambu-printer-mcp/pull/18). Direct X2D printing remains deferred pending the native transport. |
 | [Stenslaen](https://github.com/Stenslaen) | Traces the delayed H2 crash to OTA model detection, documents a multi-day workaround, and reports unexpected state-transition crashes in [#7](https://github.com/DMontgomery40/bambu-printer-mcp/issues/7). |
 | [Alejandro Oñate (alexol91)](https://github.com/alexol91) | Reports the missing machine-template G-code and multi-filament override problems in [#12](https://github.com/DMontgomery40/bambu-printer-mcp/issues/12), with measured output and a proposed fix in [#13](https://github.com/DMontgomery40/bambu-printer-mcp/pull/13). |
@@ -19,7 +21,7 @@ Thank you to everyone who builds, tests, reports problems, and shares real print
 
 Thank you also to the existing contributors whose work the project builds on:
 
-- [David Montgomery (DMontgomery40)](https://github.com/DMontgomery40) — project maintainer; flags the FULU/Orca missing-machine-preset safety gap during article review, prompting the 1.1.11 fix.
+- [David Montgomery (DMontgomery40)](https://github.com/DMontgomery40) — project maintainer; contributes the printer-profile, temperature, and hardware-safety reports informing the shared slicing and print checks.
 - [rowbotik](https://github.com/rowbotik) — printer, AMS, slicing, and operational work across the existing release history.
 - [len-foss](https://github.com/len-foss) — project code contribution.
 - [thebitrock](https://github.com/thebitrock) — project code contribution.

package/README.md

@@ -194,7 +194,7 @@ The optional FULU **BambuNetwork bridge** exposes `bambu_network_bridge_status`,
 - Query live AMS inventory with resolved Bambu/Orca filament profile paths via `get_printer_filaments`. Includes per-tray display names, match confidence (`high`/`medium`/`low`/`none`), resolution tier (`exact-model-nozzle`/`model`/`generic`/`unresolved`), and a summary with recommended auto-slice filament. Retries automatically when AMS data hasn't arrived yet (common on first MQTT push from idle printers).
 - List, upload, and delete files on the printer's SD card via FTPS
 - Capture a JPEG snapshot from the chamber camera. Supports A1, A1 mini, P1S, P1P (TCP-on-6000), and X1, X1C, X1E, P2S, H2, H2S, H2D, H2C, H2D Pro, X2D (RTSP via ffmpeg). Requires ffmpeg in PATH for the RTSP path.
-- Upload and print pre-sliced `.gcode.3mf` files with full plate selection and calibration flag control (recommended path — see [slicing guide](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SLICING.md))
+- Upload and print pre-sliced `.3mf` projects with checked plate selection and calibration flags. Legacy `.gcode.3mf` routes require a single external-spool-only plate; see the [slicing guide](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SLICING.md).
 - Slice through BambuStudio CLI with automatic BBL inheritance/include resolution, per-slot filament colours, and fallback prime-tower placement for multi-nozzle printers. Missing dependencies stop the slice; custom settings and saved project tower positions are preserved. Multi-colour slicing is verified by the contributor on BambuStudio 02.08.02.60 for Windows; older CLI versions have separate limitations. See [slicing guide](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SLICING.md).
 - Recognize X2D status and slice with its own installed BambuStudio preset (`BAMBU_MODEL=x2d`). **Direct X2D printing is not supported yet**: the internal eMMC transport is pending. These print requests stop before slicing, uploading, or issuing printer commands. Print exported projects through a supported slicer instead.
 - Parse AMS mapping from the 3MF's embedded slicer metadata (`Metadata/plate_<n>.json` + gcode filament header) and send it correctly formatted per the OpenBambuAPI spec, with correct H2S/H2D/H2C `ams_mapping2` parallel array format
@@ -204,6 +204,7 @@ The optional FULU **BambuNetwork bridge** exposes `bambu_network_bridge_status`,
 - Set print speed mode (`silent`/`standard`/`sport`/`ludicrous`), clear HMS/print errors, trigger AMS RFID re-read, and control H2/P2 airduct mode (`cooling`/`heating`) via MQTT
 - **Start/stop AMS filament drying** (`set_ams_drying`) on heated AMS units (AMS Pro / AMS-HT). Sends `print.ams_control` MQTT command.
 - Set nozzle and bed temperature via G-code dispatch over MQTT
+- Confirm print starts and positive manual heating through a human preflight prompt. Finished-bed clearance and hardware-error clearing require explicit human acknowledgment; see [hardware safety and headless configuration](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SLICING.md).
 - Set fan speed (part, auxiliary, chamber) and chamber light mode (on/off/flashing) via MQTT
 - Read HMS (Health Management System) diagnostics as an MCP resource at `printer://{host}/hms` — read-only error summary from the printer, with automatic settle retry
 - Start G-code files already stored on the printer
@@ -792,12 +793,17 @@ Trigger a Bambu AMS RFID re-read for one AMS slot. This can move AMS filament; u
 
 #### set_temperature
 
-Set the target temperature for the bed or nozzle. Dispatches an M140 (bed) or M104 (nozzle) G-code command via MQTT. Valid range is 0 to 300 degrees Celsius. Accepted values for `component` are `bed`, `nozzle`, `extruder`, `tool`, and `tool0`.
+Set a checked target temperature for the bed or nozzle through MQTT. Positive targets require the printer model and fresh matching printer telemetry; nozzle heating also requires the declared loaded `material` and matching `nozzle_diameter` (default 0.4). Independent model/component and material ceilings apply. A target of zero turns the heater off without requiring material or nozzle metadata. Accepted `component` values are `bed`, `nozzle`, `extruder`, `tool`, and `tool0`.
+
+Manual nozzle heating checks the reported currently loaded AMS tray or external spool. It refuses ambiguous active-nozzle/material selection on multi-nozzle printers; use a checked sliced job or the printer's own controls there. Stop and heater-off commands cancel pending server print/heating operations. Resuming through MCP requires the same paused job inspected and started by this server instance, with fresh matching telemetry; other paused jobs remain controllable at the printer.
 
 ```json
 {
   "component": "nozzle",
   "temperature": 220,
+  "bambu_model": "p1s",
+  "material": "PLA",
+  "nozzle_diameter": 0.4,
   "host": "192.168.1.100",
   "bambu_serial": "01P00A123456789",
   "bambu_token": "your_access_token"
@@ -912,11 +918,11 @@ Inspect the configured FULU bridge without starting it using `{}`. Use `{"connec
 
 #### bambu_network_call
 
-Call a runtime method such as `{"method": "net.is_user_login", "payload": {}}`. The default injects the initialized agent; use `with_agent: false` for `bridge.handshake`. Raw methods can mutate runtime or printer state; use the method contract from your installed FULU build.
+Call an allowed read-only probe such as `{"method": "net.is_user_login", "payload": {}}`. The default injects the initialized agent; use `with_agent: false` for `bridge.handshake`. Raw printer mutations and unknown methods are refused; use the dedicated checked print or printer tools.
 
 #### print_3mf_bambu_network
 
-Submit a sliced project through FULU's separately configured networking runtime. `connection_type` defaults to `cloud`; LAN bridge jobs also require a printer IP and access code. `bambu_model` and a device ID are required. See [print examples and AMS requirements](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#print-through-the-bridge). A zero bridge return code confirms submission, not a physical print or direct X2D support.
+Submit a sliced project through FULU's separately configured networking runtime. `connection_type` defaults to `cloud`. Both cloud and LAN bridge jobs require a printer IP, LAN access code, matching serial/device ID, and fresh MQTT safety telemetry. File, raw AMS/nozzle mapping, and extra-option overrides cannot replace checked parameters. See [print examples and AMS requirements](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#print-through-the-bridge). A zero bridge return code confirms submission, not a physical print or direct X2D support.
 
 #### resolve_3mf_ams_slots
 

package/dist/bambu-network-bridge.d.ts

@@ -5,6 +5,10 @@ export type BambuNetworkBridgeOptions = {
     countryCode?: string;
     userInfo?: string;
     timeoutMs?: number;
+    /** Trusted in-process preflight; never populated from tool arguments. */
+    beforeDispatch?: (method: string) => Promise<void>;
+    assertDispatchAllowed?: (method: string) => void;
+    onDispatched?: (method: string) => void;
 };
 export type BambuNetworkBridgeStatus = {
     configured: boolean;

package/dist/bambu-network-bridge.js

@@ -161,6 +161,7 @@ export class BambuNetworkBridge {
             throw new Error("BambuNetwork bridge method is required.");
         }
         await this.ensureStarted(options.bridgeCommand);
+        await options.beforeDispatch?.(method);
         const id = this.nextRequestId++;
         const requestPayload = Buffer.from(JSON.stringify({ method, payload }), "utf8");
         const frame = Buffer.alloc(FRAME_HEADER_SIZE + requestPayload.length);
@@ -176,6 +177,7 @@ export class BambuNetworkBridge {
             }, options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);
             this.pending.set(id, { method, resolve, reject, timer });
             try {
+                options.assertDispatchAllowed?.(method);
                 this.child.stdin.write(frame, (error) => {
                     if (error) {
                         const pending = this.pending.get(id);
@@ -186,6 +188,7 @@ export class BambuNetworkBridge {
                         }
                     }
                 });
+                options.onDispatched?.(method);
             }
             catch (error) {
                 clearTimeout(timer);

package/dist/index.js

@@ -15,6 +15,9 @@ import { BlenderMcpBridge } from "./blender-mcp-bridge.js";
 import { hasAmsMappingInput, normalizeAmsMappingObject, normalizeBridgeAmsTrayValue } from "./ams-mapping.js";
 import { analyze3MFAmsRequirements, analyze3MFPlateObjects, analyzeCollarCharm3MF, extractBambuTemplateSettings, getCollarCharmRolePolicy, parse3MF } from './3mf_parser.js';
 import { BambuImplementation, assertDirectPrintSupported } from "./printers/bambu.js";
+import { inspectPrintFile } from "./safety/print-file.js";
+import { validatePrinterState } from "./safety/printer-state.js";
+import { withPrinterOperation, withPrintSnapshot, uniquePrintName } from "./safety/artifact.js";
 dotenv.config();
 const DEFAULT_HOST = process.env.BAMBU_PRINTER_HOST || process.env.PRINTER_HOST || "localhost";
 const DEFAULT_BAMBU_SERIAL = process.env.BAMBU_PRINTER_SERIAL || process.env.BAMBU_SERIAL || "";
@@ -44,6 +47,27 @@ const DEFAULT_BAMBU_MODEL = process.env.BAMBU_PRINTER_MODEL?.trim().toLowerCase(
     "";
 const DEFAULT_BED_TYPE = process.env.BED_TYPE?.trim().toLowerCase() || "textured_plate";
 const DEFAULT_NOZZLE_DIAMETER = process.env.NOZZLE_DIAMETER?.trim() || "0.4";
+function requestedPrintNozzles(args) {
+    if (args.nozzle_diameters !== undefined && args.nozzle_diameter !== undefined) {
+        throw new Error("Supply nozzle_diameters or nozzle_diameter, not both.");
+    }
+    const raw = args.nozzle_diameters !== undefined ? args.nozzle_diameters :
+        args.nozzle_diameter !== undefined ? [args.nozzle_diameter] : undefined;
+    // A pre-sliced job already declares every nozzle; compare those with the
+    // printer rather than broadcasting the CLI's default diameter over them.
+    if (raw === undefined)
+        return undefined;
+    if (!Array.isArray(raw) || !raw.length || raw.length > 2 || raw.some(value => (typeof value !== "number" && typeof value !== "string") || ![0.2, 0.4, 0.6, 0.8].includes(Number(value)))) {
+        throw new Error("Nozzle diameters must contain one or two supported sizes: 0.2, 0.4, 0.6, 0.8 mm.");
+    }
+    return raw.map(Number);
+}
+function assertUniformCliNozzles(args) {
+    const nozzles = requestedPrintNozzles(args);
+    if (nozzles && new Set(nozzles).size > 1) {
+        throw new Error("Mixed nozzle diameters require a pre-sliced 3MF with complete per-nozzle metadata. Export it from the slicer GUI before printing.");
+    }
+}
 const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c", "x2d"];
 const H2_BAMBU_MODELS = new Set(["h2d", "h2s", "h2c"]);
 const VALID_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"];
@@ -789,7 +813,23 @@ class BambuPrinterMCPServer {
                 tools: {}
             }
         });
-        this.bambu = new BambuImplementation();
+        this.bambu = new BambuImplementation(async (message) => {
+            try {
+                const response = await this.server.elicitInput({
+                    mode: "form",
+                    message,
+                    requestedSchema: {
+                        type: "object",
+                        properties: { confirmed: { type: "boolean", title: "I checked the printer and confirm this operation", default: false } },
+                        required: ["confirmed"],
+                    },
+                });
+                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.");
+            }
+        });
         this.bambuNetwork = new BambuNetworkBridge();
         this.stlManipulator = new STLManipulator(TEMP_DIR);
         this.setupHandlers();
@@ -903,10 +943,11 @@ class BambuPrinterMCPServer {
         const JSZip = (await import('jszip')).default;
         const zipData = fs.readFileSync(threeMFPath);
         const zip = await JSZip.loadAsync(zipData);
-        const hasGcode = Object.keys(zip.files).some(f => f.match(/Metadata\/plate_\d+\.gcode/i) || f.endsWith('.gcode'));
+        const hasGcode = Object.values(zip.files).some(entry => !entry.dir && /\.gcode$/i.test(entry.name));
         if (hasGcode) {
             return { threeMFPath, autoSliced: false };
         }
+        assertUniformCliNozzles(args);
         if (bedType === "supertack_plate") {
             throw new Error('BambuStudio CLI SuperTack bed type is not verified; use a pre-sliced 3MF for SuperTack or choose textured_plate, cool_plate, engineering_plate, or hot_plate.');
         }
@@ -983,7 +1024,8 @@ class BambuPrinterMCPServer {
         }
         const printModel = await this.resolveBambuModel(args?.bambu_model);
         const printBedType = resolveBedType(args?.bed_type);
-        const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
+        const printNozzles = requestedPrintNozzles(args);
+        const printNozzle = String(printNozzles?.[0] ?? DEFAULT_NOZZLE_DIAMETER);
         const printPreset = BAMBU_MODEL_PRESETS[printModel]?.(printNozzle);
         const plateIndex = args?.plate_index !== undefined ? Number(args.plate_index) : 0;
         if (!Number.isInteger(plateIndex) || plateIndex < 0) {
@@ -1009,82 +1051,130 @@ class BambuPrinterMCPServer {
         if (isLocalBridgePrint && !password) {
             throw new Error("bambu_token/access code is required for FULU BambuNetwork LAN/local print methods.");
         }
+        if (!bambuSerial || devId !== bambuSerial || !devIp || devIp === "localhost" || !(password || bambuToken)) {
+            throw new Error("Bridge printing requires a matching bambu_serial/dev_id, printer host, and LAN access token for fresh MQTT safety verification, including cloud dispatch.");
+        }
+        for (const field of ["config_filename", "ftp_file", "ftp_file_md5", "ams_mapping_bridge", "ams_mapping2", "ams_mapping_info", "nozzle_mapping", "nozzles_info", "extra_options"]) {
+            if (args[field] !== undefined && args[field] !== "")
+                throw new Error(`${field} cannot override a verified print. Use the structured plate, nozzle, and AMS arguments.`);
+        }
         const { threeMFPath, autoSliced } = await this.ensurePrintableThreeMFPath(args, printModel, printPreset, printBedType);
         const { useAMS, finalAmsMapping, finalAmsSlots } = await this.resolveAmsPrintSettings(threeMFPath, args, host, bambuSerial, bambuToken, printModel, printNozzle);
         const threeMfFilename = path.basename(threeMFPath);
-        const projectName = String(args?.project_name || threeMfFilename.replace(/\.3mf$/i, ''));
+        const projectName = String(args?.project_name || args?.task_name || threeMfFilename.replace(/\.3mf$/i, ''));
         const presetName = String(args?.preset_name || `${projectName}_plate_${plateIndex + 1}`);
         const clientJobId = args?.client_job_id !== undefined ? Number(args.client_job_id) : Date.now();
-        const amsMapping = stringifyBridgeJson(args?.ams_mapping_bridge ?? finalAmsMapping ?? finalAmsSlots);
-        const params = {
-            dev_id: devId,
-            task_name: String(args?.task_name || projectName),
-            project_name: projectName,
-            preset_name: presetName,
-            filename: threeMFPath,
-            config_filename: String(args?.config_filename || threeMFPath),
-            plate_index: plateIndex + 1,
-            ftp_folder: String(args?.ftp_folder || ""),
-            ftp_file: String(args?.ftp_file || ""),
-            ftp_file_md5: String(args?.ftp_file_md5 || ""),
-            nozzle_mapping: stringifyBridgeJson(args?.nozzle_mapping) || "",
-            ams_mapping: amsMapping || "",
-            ams_mapping2: stringifyBridgeJson(args?.ams_mapping2) || "",
-            ams_mapping_info: stringifyBridgeJson(args?.ams_mapping_info) || "",
-            nozzles_info: stringifyBridgeJson(args?.nozzles_info) || "",
-            connection_type: connectionType,
-            comments: String(args?.comments || ""),
-            origin_profile_id: args?.origin_profile_id !== undefined ? Number(args.origin_profile_id) : 0,
-            stl_design_id: args?.stl_design_id !== undefined ? Number(args.stl_design_id) : 0,
-            origin_model_id: String(args?.origin_model_id || ""),
-            print_type: String(args?.print_type || "from_normal"),
-            dst_file: String(args?.dst_file || ""),
-            dev_name: String(args?.dev_name || ""),
-            dev_ip: devIp,
-            use_ssl_for_ftp: args?.use_ssl_for_ftp !== undefined ? Boolean(args.use_ssl_for_ftp) : true,
-            use_ssl_for_mqtt: args?.use_ssl_for_mqtt !== undefined ? Boolean(args.use_ssl_for_mqtt) : true,
-            username: String(args?.username || "bblp"),
-            password,
-            task_bed_leveling: args?.bed_leveling !== undefined ? Boolean(args.bed_leveling) : true,
-            task_flow_cali: args?.flow_calibration !== undefined ? Boolean(args.flow_calibration) : true,
-            task_vibration_cali: args?.vibration_calibration !== undefined ? Boolean(args.vibration_calibration) : true,
-            task_layer_inspect: args?.layer_inspect !== undefined ? Boolean(args.layer_inspect) : false,
-            task_record_timelapse: args?.timelapse !== undefined ? Boolean(args.timelapse) : false,
-            task_use_ams: useAMS,
-            task_bed_type: printBedType,
-            extra_options: stringifyBridgeJson(args?.extra_options) || "",
-            auto_bed_leveling: args?.auto_bed_leveling !== undefined ? Number(args.auto_bed_leveling) : 0,
-            auto_flow_cali: args?.auto_flow_cali !== undefined ? Number(args.auto_flow_cali) : 0,
-            auto_offset_cali: args?.auto_offset_cali !== undefined ? Number(args.auto_offset_cali) : 0,
-            extruder_cali_manual_mode: args?.extruder_cali_manual_mode !== undefined ? Number(args.extruder_cali_manual_mode) : -1,
-            task_ext_change_assist: args?.external_change_assist !== undefined ? Boolean(args.external_change_assist) : false,
-            try_emmc_print: args?.try_emmc_print !== undefined ? Boolean(args.try_emmc_print) : false,
-        };
-        const bridgeResult = await this.bambuNetwork.callWithAgent(bridgeMethod, { client_job_id: clientJobId, params }, this.bridgeOptionsFromArgs(args, "print_3mf_bambu_network"));
-        if (typeof bridgeResult === "object" && bridgeResult !== null && bridgeResult.ok === false) {
-            throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} failed: ${String(bridgeResult.error || "unknown bridge error")}`);
-        }
-        if (typeof bridgeResult === "object" &&
-            bridgeResult !== null &&
-            typeof bridgeResult.value === "number" &&
-            bridgeResult.value !== 0) {
-            const value = bridgeResult.value;
-            throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} returned non-zero result ${value}.`);
-        }
-        return {
-            status: "success",
-            message: `FULU BambuNetwork ${bridgePrintMethod} command for ${threeMfFilename} sent successfully.`,
-            bridgeMethod,
-            bridgeResult,
-            clientJobId,
-            autoSliced,
-            projectName,
-            plateIndex,
-            bridgePlateIndex: plateIndex + 1,
-            useAMS,
-            amsMapping: finalAmsMapping ?? finalAmsSlots,
-            params: redactPrintParams(params),
-        };
+        return withPrinterOperation(devIp, devId, assertActive => withPrintSnapshot(threeMFPath, async (snapshot, retainForDispatchedUpload) => {
+            const inspection = await inspectPrintFile(snapshot, { model: printModel, nozzleDiameters: printNozzles, plateIndex, bedType: printBedType });
+            let mapping = finalAmsMapping?.slice();
+            if (finalAmsSlots) {
+                if (finalAmsSlots.length !== inspection.usedFilamentPositions.length)
+                    throw new Error("ams_slots must supply exactly one physical tray per used filament.");
+                mapping = Array(inspection.materials.length).fill(-1);
+                inspection.usedFilamentPositions.forEach((position, index) => { mapping[position] = finalAmsSlots[index]; });
+            }
+            if (!useAMS) {
+                mapping = Array(inspection.materials.length).fill(-1);
+                inspection.usedFilamentPositions.forEach(position => { mapping[position] = 254; });
+            }
+            const requirements = { ...inspection, amsMapping: mapping, useAMS };
+            const initialStatus = await this.bambu.getSafetyStatus(devIp, devId, password || bambuToken);
+            validatePrinterState(initialStatus, requirements);
+            const bedClearance = await this.bambu.confirmPrintPreflight(devId, initialStatus, inspection);
+            const confirmedStatus = await this.bambu.getSafetyStatus(devIp, devId, password || bambuToken);
+            validatePrinterState(confirmedStatus, requirements);
+            this.bambu.assertBedClearance(confirmedStatus, bedClearance);
+            const amsMapping = stringifyBridgeJson(mapping);
+            const remoteFileName = uniquePrintName(threeMFPath);
+            const params = {
+                dev_id: devId,
+                // Firmware can report the task name instead of the uploaded filename.
+                // Bind either report to this inspected artifact for a later safe resume.
+                task_name: remoteFileName.replace(/(?:\.gcode)?\.3mf$/i, ""),
+                project_name: projectName,
+                preset_name: presetName,
+                filename: snapshot,
+                config_filename: snapshot,
+                plate_index: plateIndex + 1,
+                ftp_folder: String(args?.ftp_folder || ""),
+                ftp_file: String(args?.ftp_file || ""),
+                ftp_file_md5: String(args?.ftp_file_md5 || ""),
+                nozzle_mapping: stringifyBridgeJson(args?.nozzle_mapping) || "",
+                ams_mapping: amsMapping || "",
+                ams_mapping2: stringifyBridgeJson(args?.ams_mapping2) || "",
+                ams_mapping_info: stringifyBridgeJson(args?.ams_mapping_info) || "",
+                nozzles_info: stringifyBridgeJson(args?.nozzles_info) || "",
+                connection_type: connectionType,
+                comments: String(args?.comments || ""),
+                origin_profile_id: args?.origin_profile_id !== undefined ? Number(args.origin_profile_id) : 0,
+                stl_design_id: args?.stl_design_id !== undefined ? Number(args.stl_design_id) : 0,
+                origin_model_id: String(args?.origin_model_id || ""),
+                print_type: String(args?.print_type || "from_normal"),
+                dst_file: remoteFileName,
+                dev_name: String(args?.dev_name || ""),
+                dev_ip: devIp,
+                use_ssl_for_ftp: args?.use_ssl_for_ftp !== undefined ? Boolean(args.use_ssl_for_ftp) : true,
+                use_ssl_for_mqtt: args?.use_ssl_for_mqtt !== undefined ? Boolean(args.use_ssl_for_mqtt) : true,
+                username: String(args?.username || "bblp"),
+                password,
+                task_bed_leveling: args?.bed_leveling !== undefined ? Boolean(args.bed_leveling) : true,
+                task_flow_cali: args?.flow_calibration !== undefined ? Boolean(args.flow_calibration) : true,
+                task_vibration_cali: args?.vibration_calibration !== undefined ? Boolean(args.vibration_calibration) : true,
+                task_layer_inspect: args?.layer_inspect !== undefined ? Boolean(args.layer_inspect) : false,
+                task_record_timelapse: args?.timelapse !== undefined ? Boolean(args.timelapse) : false,
+                task_use_ams: useAMS,
+                task_bed_type: printBedType,
+                extra_options: stringifyBridgeJson(args?.extra_options) || "",
+                auto_bed_leveling: args?.auto_bed_leveling !== undefined ? Number(args.auto_bed_leveling) : 0,
+                auto_flow_cali: args?.auto_flow_cali !== undefined ? Number(args.auto_flow_cali) : 0,
+                auto_offset_cali: args?.auto_offset_cali !== undefined ? Number(args.auto_offset_cali) : 0,
+                extruder_cali_manual_mode: args?.extruder_cali_manual_mode !== undefined ? Number(args.extruder_cali_manual_mode) : -1,
+                task_ext_change_assist: args?.external_change_assist !== undefined ? Boolean(args.external_change_assist) : false,
+                try_emmc_print: args?.try_emmc_print !== undefined ? Boolean(args.try_emmc_print) : false,
+            };
+            assertActive();
+            const bridgeResult = await this.bambuNetwork.callWithAgent(bridgeMethod, { client_job_id: clientJobId, params }, {
+                ...this.bridgeOptionsFromArgs(args, "print_3mf_bambu_network"),
+                beforeDispatch: async (method) => {
+                    if (method !== bridgeMethod)
+                        return;
+                    assertActive();
+                    const dispatchStatus = await this.bambu.getSafetyStatus(devIp, devId, password || bambuToken);
+                    validatePrinterState(dispatchStatus, requirements);
+                    this.bambu.assertBedClearance(dispatchStatus, bedClearance);
+                },
+                assertDispatchAllowed: method => { if (method === bridgeMethod)
+                    assertActive(); },
+                onDispatched: method => { if (method === bridgeMethod)
+                    retainForDispatchedUpload(); },
+            });
+            if (typeof bridgeResult === "object" && bridgeResult !== null && bridgeResult.ok === false) {
+                throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} failed: ${String(bridgeResult.error || "unknown bridge error")}`);
+            }
+            if (typeof bridgeResult === "object" &&
+                bridgeResult !== null &&
+                typeof bridgeResult.value === "number" &&
+                bridgeResult.value !== 0) {
+                const value = bridgeResult.value;
+                throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} returned non-zero result ${value}.`);
+            }
+            assertActive();
+            this.bambu.recordCheckedJob(devIp, devId, remoteFileName, requirements);
+            return {
+                status: "success",
+                message: `FULU BambuNetwork ${bridgePrintMethod} command for ${threeMfFilename} sent successfully.`,
+                bridgeMethod,
+                bridgeResult,
+                clientJobId,
+                autoSliced,
+                projectName,
+                plateIndex,
+                bridgePlateIndex: plateIndex + 1,
+                useAMS,
+                amsMapping: mapping,
+                params: redactPrintParams(params),
+            };
+        }));
     }
     async getResolvedPrinterFilamentInventory(host, bambuSerial, bambuToken, bambuModel, nozzleDiameter) {
         const status = await this.bambu.getStatus(host, bambuSerial, bambuToken);
@@ -1704,7 +1794,7 @@ class BambuPrinterMCPServer {
                                 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." },
-                                task_name: { type: "string", description: "Optional BambuNetwork task name; defaults to the project name." },
+                                task_name: { type: "string", description: "Optional project label when project_name is omitted. The submitted task name uses a unique inspected-job identity for safe resume." },
                                 config_filename: { type: "string", description: "Optional config 3MF path for cloud print; defaults to the same 3MF path." },
                                 bridge_command: { type: "string", description: "Override command for the FULU bridge host or macOS/WSL wrapper; defaults to BAMBU_NETWORK_BRIDGE_COMMAND. Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1." },
                                 bambu_network_config_dir: { type: "string", description: "Config/log directory used by the BambuNetwork agent; defaults to BAMBU_NETWORK_CONFIG_DIR or a user config directory." },
@@ -1715,6 +1805,7 @@ class BambuPrinterMCPServer {
                                 slicer_path: { type: "string", description: "Path to the slicer executable for auto-slicing; defaults to value from env or a platform default. Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1." },
                                 slicer_profile: { type: "string", description: "Path to an optional slicer profile/config file for auto-slicing." },
                                 nozzle_diameter: { type: "string", description: "Nozzle diameter in mm for auto-slicing (default: 0.4)." },
+                                nozzle_diameters: { type: "array", minItems: 1, maxItems: 2, items: { type: "number", enum: [0.2, 0.4, 0.6, 0.8] }, description: "Complete per-nozzle diameters for pre-sliced jobs, e.g. [0.4, 0.6]. Omit to verify file metadata against every reported nozzle; cannot combine with nozzle_diameter." },
                                 use_ams: { type: "boolean", description: "Whether to use the AMS; defaults to auto-detect from the 3MF mapping." },
                                 ams_mapping: { type: "array", description: "AMS slot mapping array used by both local MCP printing and FULU PrintParams.", items: { type: "number" } },
                                 ams_slots: { type: "array", description: "Per-used-filament AMS slot list, matching the local LAN print path.", items: { type: "number" } },
@@ -1778,13 +1869,14 @@ class BambuPrinterMCPServer {
                     },
                     {
                         name: "upload_gcode",
-                        description: "Upload a G-code file to the Bambu Lab printer",
+                        description: "Inspect a G-code file and upload a uniquely named copy without overwriting existing printer files.",
                         inputSchema: {
                             type: "object",
                             properties: {
                                 filename: { type: "string", description: "Name for the file on the printer" },
                                 gcode: { type: "string", description: "G-code content to upload, or a readable local .gcode path. Required unless gcode_path is provided. For large files, prefer gcode_path." },
                                 gcode_path: { type: "string", description: "Local path to a .gcode file to upload. Required unless gcode is provided. This avoids sending large G-code bodies through the MCP request." },
+                                bambu_model: { type: "string", enum: [...VALID_BAMBU_MODELS], description: "Required printer model for inspecting the uploaded G-code, even when not starting it." },
                                 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)" }
@@ -1804,7 +1896,7 @@ class BambuPrinterMCPServer {
                                 bambu_model: {
                                     type: "string",
                                     enum: [...VALID_BAMBU_MODELS],
-                                    description: "Required when print is true. Bambu Lab printer model used as a safety confirmation before starting the uploaded file."
+                                    description: "Required for every printable .gcode or .3mf upload, including upload-only operations."
                                 },
                                 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)" },
@@ -1952,12 +2044,15 @@ class BambuPrinterMCPServer {
                     },
                     {
                         name: "set_temperature",
-                        description: "Set the temperature of a printer component (bed, nozzle)",
+                        description: "Set a checked bed or nozzle temperature. Positive heating requires matching fresh printer telemetry; nozzle heating also requires declared material. Zero turns the heater off.",
                         inputSchema: {
                             type: "object",
                             properties: {
                                 component: { type: "string", description: "Component to heat: bed, nozzle, or extruder" },
-                                temperature: { type: "number", description: "Target temperature in °C" },
+                                temperature: { type: "number", minimum: 0, description: "Finite target temperature in °C, checked against model/component and declared material limits" },
+                                bambu_model: { type: "string", enum: [...VALID_BAMBU_MODELS], description: "Printer model, required for positive heating unless configured in the environment" },
+                                material: { type: "string", description: "Loaded material, for example PLA or PETG. Required for positive nozzle heating, including non-RFID spools." },
+                                nozzle_diameter: { type: "number", enum: [0.2, 0.4, 0.6, 0.8], description: "Installed nozzle diameter to compare with printer-reported configuration (default 0.4)" },
                                 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)" }
@@ -2108,7 +2203,8 @@ class BambuPrinterMCPServer {
                                 template_3mf_path: { type: "string", description: "Optional template 3MF whose embedded Bambu slicer settings should be reused when auto-slicing this print job." },
                                 template_name: { type: "string", description: "Optional named template from the local registry. Resolves to template_3mf_path automatically." },
                                 template_dir: { type: "string", description: "Optional template directory override when resolving template_name." },
-                                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm for auto-slicing (default: 0.4)" }
+                                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm for auto-slicing (default: 0.4)" },
+                                nozzle_diameters: { type: "array", minItems: 1, maxItems: 2, items: { type: "number", enum: [0.2, 0.4, 0.6, 0.8] }, description: "Complete per-nozzle diameters for a pre-sliced job, e.g. [0.4, 0.6]. Omit to verify its declared diameters against live telemetry; cannot combine with nozzle_diameter." }
                             },
                             required: ["three_mf_path", "bambu_model"]
                         }
@@ -2316,6 +2412,10 @@ class BambuPrinterMCPServer {
                             throw new Error("Missing required parameter: method");
                         }
                         const bridgeArgs = args;
+                        const readMethods = new Set(["bridge.handshake", "net.is_user_login", "net.get_user_id", "net.get_user_name", "net.get_user_avatar", "net.get_user_nickanme"]);
+                        if (!readMethods.has(String(bridgeArgs.method))) {
+                            throw new Error("Raw bridge mutations and unknown methods are disabled. Use print_3mf_bambu_network for verified printing or a dedicated printer tool.");
+                        }
                         const payload = bridgeArgs.payload && typeof bridgeArgs.payload === "object"
                             ? bridgeArgs.payload
                             : {};
@@ -2352,7 +2452,8 @@ class BambuPrinterMCPServer {
                         }
                         const uploadSource = resolveUploadGcodeSource(args);
                         try {
-                            result = await this.bambu.uploadFile(host, bambuSerial, bambuToken, uploadSource.filePath, String(args.filename), false);
+                            const uploadModel = await this.resolveBambuModel(args?.bambu_model);
+                            result = await this.bambu.uploadFile(host, bambuSerial, bambuToken, uploadSource.filePath, String(args.filename), false, uploadModel);
                         }
                         finally {
                             if (uploadSource.cleanupDir) {
@@ -2366,7 +2467,8 @@ class BambuPrinterMCPServer {
                             throw new Error("Missing required parameters: file_path and filename");
                         }
                         const print = Boolean(args.print ?? false);
-                        const uploadModel = print ? await this.resolveBambuModel(args?.bambu_model) : undefined;
+                        const printableUpload = /\.(?:gcode|3mf)$/i.test(String(args.file_path)) || /\.(?:gcode|3mf)$/i.test(String(args.filename));
+                        const uploadModel = print || printableUpload ? await this.resolveBambuModel(args?.bambu_model) : undefined;
                         if (print)
                             assertDirectPrintSupported(uploadModel, bambuSerial);
                         result = await this.bambu.uploadFile(host, bambuSerial, bambuToken, String(args.file_path), String(args.filename), print, uploadModel);
@@ -2412,12 +2514,16 @@ class BambuPrinterMCPServer {
                         }
                         result = await this.bambu.rereadAmsRfid(host, bambuSerial, bambuToken, Number(args.ams_id), Number(args.slot_id));
                         break;
-                    case "set_temperature":
+                    case "set_temperature": {
                         if (!args?.component || args?.temperature === undefined) {
                             throw new Error("Missing required parameters: component and temperature");
                         }
-                        result = await this.bambu.setTemperature(host, bambuSerial, bambuToken, String(args.component), Number(args.temperature));
+                        if (typeof args.temperature !== "number" || !Number.isFinite(args.temperature) || args.temperature < 0) {
+                            throw new Error("Temperature must be a finite, non-negative number in °C.");
+                        }
+                        result = await this.bambu.setTemperature(host, bambuSerial, bambuToken, String(args.component), args.temperature, args.temperature === 0 ? undefined : await this.resolveBambuModel(args?.bambu_model), args?.material !== undefined ? String(args.material) : undefined, Number(args?.nozzle_diameter ?? DEFAULT_NOZZLE_DIAMETER));
                         break;
+                    }
                     case "set_fan_speed":
                         if (!args?.fan || args?.speed === undefined) {
                             throw new Error("Missing required parameters: fan and speed");
@@ -2656,7 +2762,8 @@ class BambuPrinterMCPServer {
                         const printModel = await this.resolveBambuModel(args?.bambu_model);
                         assertDirectPrintSupported(printModel, bambuSerial);
                         const printBedType = resolveBedType(args?.bed_type);
-                        const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
+                        const printNozzles = requestedPrintNozzles(args);
+                        const printNozzle = String(printNozzles?.[0] ?? DEFAULT_NOZZLE_DIAMETER);
                         const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(args, slicerProfile || undefined, resolveTemplatePathFromName(["json", "config", "3mf"]) || explicitTemplatePath || undefined, TEMP_DIR);
                         const explicitSlicerProfile = hasExplicitSlicerProfile(args);
                         const printPreset = BAMBU_MODEL_PRESETS[printModel]?.(printNozzle);
@@ -2671,6 +2778,7 @@ class BambuPrinterMCPServer {
                         const zip = await JSZip.loadAsync(zipData);
                         const hasGcode = Object.values(zip.files).some(entry => !entry.dir && /\.gcode$/i.test(entry.name));
                         if (!hasGcode) {
+                            assertUniformCliNozzles(args);
                             if (printBedType === "supertack_plate") {
                                 throw new Error('BambuStudio CLI SuperTack bed type is not verified; use a pre-sliced 3MF for SuperTack or choose textured_plate, cool_plate, engineering_plate, or hot_plate.');
                             }
@@ -2746,6 +2854,7 @@ class BambuPrinterMCPServer {
                             useAMS = finalAmsSlots.length > 0;
                         }
                         if (isH2Print &&
+                            args?.use_ams !== false &&
                             !hasUserAmsMapping &&
                             !hasUserAmsSlots &&
                             args?.auto_match_ams !== true &&
@@ -2770,6 +2879,7 @@ class BambuPrinterMCPServer {
                             projectName,
                             filePath: threeMFPath,
                             bambuModel: printModel,
+                            nozzleDiameters: printNozzles,
                             plateIndex,
                             useAMS: useAMS,
                             amsMapping: finalAmsMapping,
@@ -2807,6 +2917,7 @@ class BambuPrinterMCPServer {
                             projectName,
                             filePath: preparedThreeMFPath,
                             bambuModel: printModel,
+                            nozzleDiameters: [Number(printNozzle)],
                             plateIndex: collarAnalysis.plateIndex,
                             useAMS: true,
                             amsSlots: collarAnalysis.amsSlots,