bambu-printer-mcp 1.1.31 → 1.1.32

package/CONTRIBUTORS.md

@@ -6,7 +6,8 @@ Thank you to everyone who builds, tests, reports problems, and shares real print
 
 | Contributor | Contribution |
 | --- | --- |
-| [mygrexit](https://github.com/mygrexit) | Contributes pinned x86-64 Linux X2D native setup, emergency routing and one-shot cleanup in [#56](https://github.com/DMontgomery40/bambu-printer-mcp/pull/56), checked Orca/time-lapse G-code forms in [#57](https://github.com/DMontgomery40/bambu-printer-mcp/pull/57), and model-specific hidden-HMS notices in [#58](https://github.com/DMontgomery40/bambu-printer-mcp/pull/58). Supplies regressions, review corrections, and contributor-reported Debian/X2D read-only, heater-off and print-start evidence in [#55](https://github.com/DMontgomery40/bambu-printer-mcp/issues/55); maintainer validation is offline and mocked. Also reports and fixes hanging Linux X2D stop/heater-off calls in [#61](https://github.com/DMontgomery40/bambu-printer-mcp/pull/61), with never-connecting transport and helper-exit regressions; the release adds protection against expired commands dispatching after reconnection. |
+| [mygrexit](https://github.com/mygrexit) | Contributes pinned x86-64 Linux X2D native setup, emergency routing and one-shot cleanup in [#56](https://github.com/DMontgomery40/bambu-printer-mcp/pull/56), checked Orca/time-lapse G-code forms in [#57](https://github.com/DMontgomery40/bambu-printer-mcp/pull/57), and model-specific hidden-HMS notices in [#58](https://github.com/DMontgomery40/bambu-printer-mcp/pull/58). Supplies regressions, review corrections, and contributor-reported Debian/X2D read-only, heater-off and print-start evidence in [#55](https://github.com/DMontgomery40/bambu-printer-mcp/issues/55); maintainer validation is offline and mocked. Also reports and fixes hanging Linux X2D stop/heater-off calls in [#61](https://github.com/DMontgomery40/bambu-printer-mcp/pull/61), with never-connecting transport and helper-exit regressions; the release adds protection against expired commands dispatching after reconnection. In [#64](https://github.com/DMontgomery40/bambu-printer-mcp/pull/64), contributes ready-card native job storage, fresh dispatch rechecks and tests, and reports Linux X2D firmware 01.01.01.00 printing to external storage with plug-in 02.08.02.54 and a Bambuddy thumbnail; maintainer verification uses source and mocked transports. |
+| [maziggy](https://github.com/maziggy) | Proposes choosing ready external storage by default in [Bambu Studio #12146](https://github.com/bambulab/BambuStudio/pull/12146), a related upstream proposal supporting the storage choice in [#64](https://github.com/DMontgomery40/bambu-printer-mcp/pull/64). The upstream proposal remains unmerged; this credit does not claim it shipped in Bambu Studio. |
 | [patrikmadoran-cyber](https://github.com/patrikmadoran-cyber) | Adds explicit Standard/High Flow nozzle selection across slicing and print auto-slicing in [#54](https://github.com/DMontgomery40/bambu-printer-mcp/pull/54), with unsupported-variant regressions and real Windows BambuStudio 02.06.00.51 H2S 0.6 slicing evidence. No physical print is claimed. |
 | [Patrick Juchli (@patrickjuchli)](https://github.com/patrickjuchli) | Maintains basic-ftp and supplies the 6.2.3 fixes for rejected-command recovery, asynchronous credential-error crashes, and password redaction used by direct FTPS transfers. |
 | [Aleksei Popovich (alexpapay)](https://github.com/alexpapay) | Fixes cross-platform AMS profile resolution and packed P2S chamber status in [#43](https://github.com/DMontgomery40/bambu-printer-mcp/pull/43), contributes regressions, and supplies read-only Windows P2S/AMS 2 Pro status and local slicing evidence. No physical print is claimed for this contribution. |

package/README.md

@@ -196,7 +196,7 @@ The optional FULU **BambuNetwork bridge** exposes `bambu_network_bridge_status`,
 - 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 `.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`). On macOS and x86-64 Linux, `print_3mf` selects the native eMMC route after resolving the model, including an elicited model. Install the optional helper as described below; Windows native print requests, and Linux requests without the helper, fail before slicing or contacting the printer. Legacy FTPS and remote G-code starts remain unsupported for X2D.
+- Recognize X2D status and slice with its own installed BambuStudio preset (`BAMBU_MODEL=x2d`). On macOS and x86-64 Linux, `print_3mf` selects the native route after resolving the model, including an elicited model. Install the optional helper as described below; Windows native print requests, and Linux requests without the helper, fail before slicing or contacting the printer. Legacy FTPS and remote G-code starts remain unsupported for X2D.
 - 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
 - **Auto-match AMS slots by RFID** (`auto_match_ams` flag on `print_3mf`). Resolves required `tray_info_idx` from the sliced 3MF against live AMS inventory. Handles same-SKU different-color filaments by matching on `(tray_info_idx, tray_color)` and tracking already-claimed slots. Dry-run with `resolve_3mf_ams_slots` before printing.
 - Cancel, pause, and resume in-progress print jobs via MQTT
@@ -906,7 +906,7 @@ The primary tool for starting a Bambu print. **Recommended input: a pre-sliced `
 2. If no G-code is found, attempts to auto-slice via the configured slicer. Profile preparation or slicing failures stop the operation before upload. See the slicing guide for tested CLI versions and combinations.
 3. Parses the sliced 3MF to extract the correct plate file and compute its MD5 hash.
 4. Reads slicer metadata and any explicit AMS selection to build the filament mapping.
-5. Uploads via `basic-ftp` to the model-specific location: SD root for H2/full-size A1, `cache/` for P1/X1/A1 mini/P2S. X2D `print_3mf` instead uses its checked native eMMC route on macOS or Linux.
+5. Uploads via `basic-ftp` to the model-specific location: SD root for H2/full-size A1, `cache/` for P1/X1/A1 mini/P2S. X2D `print_3mf` instead uses its checked native route on macOS or Linux, which stores the job on a ready SD card or USB stick and otherwise on internal storage (eMMC).
 6. Sends the correct MQTT print command for the target printer family. For H2S/H2D/H2C that means `project_file` with project-length `ams_mapping`, parallel `ams_mapping2`, and H2-compatible calibration flags.
 
 ```json
@@ -966,7 +966,7 @@ Use the same package version as the server, for example `bambu-printer-mcp@1.2.3
 
 `--check-update` asks Bambu's plug-in service for the newest Linux plug-in and compares the `PrintParams` layout in the matching Bambu Studio header with the helper. It reports only: the setup never installs an unpinned plug-in, because a changed layout would send wrong print parameters. A pin is raised by a package release after the check passes and a hardware test.
 
-Once the helper, plug-in and certificates are installed, X2D printing, upload and controls use the same routing, safety checks and authorization handshake described for macOS above. On Linux, stop and heater-off go out over the native route and MQTT at the same time, so a stuck helper cannot delay them. MQTT is sent again once every older print or heating helper for that printer has exited and the immediate MQTT attempt has settled, so none can dispatch after it; either the native route or that later MQTT send succeeding counts, and the result lists all sends under `routes`. Each MQTT send gives up after 15 seconds (`BAMBU_EMERGENCY_MQTT_TIMEOUT_MS`), so an unreachable MQTT connection cannot hold back a stop the native route already sent. A connection completing after that deadline cannot dispatch its expired command; an already queued MQTT publish is discarded by force-closing and invalidating that client. A repeated stop or heater-off is harmless. macOS keeps its native-only route. The server accepts only the pinned plug-in checksums; `BAMBU_NATIVE_ALLOW_UNPINNED_PLUGIN=1` is a trusted override for testing another build at your own risk. Without a complete installation, Linux keeps its previous behavior: X2D status and slicing work, stop, pause and heater-off use MQTT, and native print requests name the setup command before contacting the printer. Bambu publishes the Linux plug-in for x86-64 only; other architectures keep the MQTT behavior.
+Once the helper, plug-in and certificates are installed, X2D printing, upload and controls use the same routing, safety checks and authorization handshake described for macOS above. On Linux, stop and heater-off go out over the native route and MQTT at the same time, so a stuck helper cannot delay them. MQTT is sent again once every older print or heating helper for that printer has exited and the immediate MQTT attempt has settled, so none can dispatch after it; either the native route or that later MQTT send succeeding counts, and the result lists all sends under `routes`. Each MQTT send gives up after 15 seconds (`BAMBU_EMERGENCY_MQTT_TIMEOUT_MS`), so an unreachable MQTT connection cannot hold back a stop the native route already sent. A connection completing after that deadline cannot dispatch its expired command; an already queued MQTT publish is discarded by force-closing and invalidating that client. A repeated stop or heater-off is harmless. macOS keeps its native-only route. On both systems a print goes to the printer's SD card or USB stick when the printer reports one ready, so it can be reprinted from the printer and archived by tools that read the card; otherwise it goes to internal storage (eMMC), as Bambu Studio's Print button always does. `BAMBU_NATIVE_TRY_EMMC_PRINT=1` (or `0`) forces the choice. The server accepts only the pinned plug-in checksums; `BAMBU_NATIVE_ALLOW_UNPINNED_PLUGIN=1` is a trusted override for testing another build at your own risk. Without a complete installation, Linux keeps its previous behavior: X2D status and slicing work, stop, pause and heater-off use MQTT, and native print requests name the setup command before contacting the printer. Bambu publishes the Linux plug-in for x86-64 only; other architectures keep the MQTT behavior.
 
 #### x2d_native_control
 

package/dist/bambu-native.d.ts

@@ -19,6 +19,8 @@ export type BambuNativePrintOptions = {
     vibrationCalibration?: boolean;
     layerInspect?: boolean;
     timelapse?: boolean;
+    /** true: the SD card or USB stick; false: internal storage (eMMC); unset: BAMBU_NATIVE_TRY_EMMC_PRINT or internal. Reported as the requested storage. */
+    externalStorage?: boolean;
 };
 export type BambuNativeControlOptions = {
     host: string;

package/dist/bambu-native.js

@@ -748,6 +748,7 @@ export async function printWithBambuNative(options, onUpdate, execution) {
         BAMBU_NATIVE_VIBRATION_CALIBRATION: boolEnv(options.vibrationCalibration, true),
         BAMBU_NATIVE_LAYER_INSPECT: boolEnv(options.layerInspect, false),
         BAMBU_NATIVE_TIMELAPSE: boolEnv(options.timelapse, false),
+        ...(options.externalStorage === undefined ? {} : { BAMBU_NATIVE_TRY_EMMC_PRINT: String(!options.externalStorage) }),
     }, 300000, onUpdate, execution);
     if (result.resultCode !== 0) {
         const explicitRejection = result.updates.some(line => /^native_print result=-?[1-9]\d*$/.test(line));
@@ -765,6 +766,7 @@ export async function printWithBambuNative(options, onUpdate, execution) {
     return {
         status: "success",
         route: "bambu:///local",
+        ...(options.externalStorage === undefined ? {} : { storage: options.externalStorage ? "external" : "internal" }),
         updates: result.updates,
     };
 }

package/dist/index.js

@@ -18,7 +18,7 @@ import { bridgeAmsMapping2Entry, bridgeAmsMappingValue, externalTrayForNozzle, h
 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 { externalStorageState, validatePrinterState } from "./safety/printer-state.js";
 import { isDualNozzleModel } from "./safety/limits.js";
 import { withPrinterOperation, withPrintSnapshot, uniquePrintName } from "./safety/artifact.js";
 import { detectProfilesRoot } from "./slicer/profile-flatten.js";
@@ -67,6 +67,21 @@ function withEmergencyMqttTimeout(send) {
     });
     return Promise.race([Promise.resolve().then(() => send(controller.signal)), timeout]).finally(() => clearTimeout(timer));
 }
+/**
+ * Whether an X2D native print stores its job on the SD card or USB stick
+ * (true) or internal storage (eMMC). An explicit try_emmc_print wins, then
+ * BAMBU_NATIVE_TRY_EMMC_PRINT read as the helper reads it; otherwise a ready
+ * card is used, as OrcaSlicer does, so the job can be reprinted from the
+ * printer and read over FTPS.
+ */
+function nativeExternalStorage(tryEmmcPrint, raw) {
+    if (tryEmmcPrint !== undefined)
+        return !tryEmmcPrint;
+    const configured = process.env.BAMBU_NATIVE_TRY_EMMC_PRINT?.trim();
+    if (configured)
+        return !["1", "true", "TRUE", "yes"].includes(configured);
+    return externalStorageState(raw) === "normal";
+}
 function requestedPrintNozzles(args) {
     if (args.nozzle_diameters !== undefined && args.nozzle_diameter !== undefined) {
         throw new Error("Supply nozzle_diameters or nozzle_diameter, not both.");
@@ -1136,6 +1151,9 @@ class BambuPrinterMCPServer {
         if (!args?.three_mf_path) {
             throw new Error("Missing required parameter: three_mf_path");
         }
+        if (args?.try_emmc_print !== undefined && typeof args.try_emmc_print !== "boolean") {
+            throw new Error("try_emmc_print must be true or false.");
+        }
         const printModel = await this.resolveBambuModel(args?.bambu_model);
         const printBedType = resolveBedType(args?.bed_type);
         const printNozzles = requestedPrintNozzles(args);
@@ -1259,6 +1277,10 @@ class BambuPrinterMCPServer {
             };
             assertActive();
             if (native) {
+                const externalStorage = nativeExternalStorage(args?.try_emmc_print, confirmedStatus.raw);
+                if (externalStorage && externalStorageState(confirmedStatus.raw) !== "normal") {
+                    throw new Error("External storage was requested, but the printer reports no ready SD card or USB stick.");
+                }
                 // Release the telemetry client before the installed plug-in opens its session.
                 await this.bambu.disconnectAll();
                 assertActive();
@@ -1272,11 +1294,15 @@ class BambuPrinterMCPServer {
                     vibrationCalibration: params.task_vibration_cali,
                     layerInspect: params.task_layer_inspect,
                     timelapse: params.task_record_timelapse,
+                    externalStorage,
                 }, native.onUpdate, { signal: native.signal, assertActive, beforeDispatch: async () => {
                         assertActive();
                         const dispatchStatus = await this.bambu.getSafetyStatus(devIp, devId, password || bambuToken);
                         validatePrinterState(dispatchStatus, requirements);
                         this.bambu.assertBedClearance(dispatchStatus, bedClearance);
+                        if (externalStorage && externalStorageState(dispatchStatus.raw) !== "normal") {
+                            throw new Error("The printer's SD card or USB stick is no longer ready. Check it and start the print again.");
+                        }
                         assertActive();
                     } });
                 assertActive();
@@ -2082,7 +2108,7 @@ class BambuPrinterMCPServer {
                                 use_ssl_for_ftp: { type: "boolean", description: "Whether FULU local print should use SSL for FTP (default: true)." },
                                 use_ssl_for_mqtt: { type: "boolean", description: "Whether FULU local print should use SSL for MQTT (default: true)." },
                                 external_change_assist: { type: "boolean", description: "Enable FULU PrintParams task_ext_change_assist for external filament change assistance." },
-                                try_emmc_print: { type: "boolean", description: "Enable FULU PrintParams try_emmc_print for printers that support internal storage printing." },
+                                try_emmc_print: { type: "boolean", description: "Store the job on internal storage (eMMC) instead of the SD card or USB stick. FULU bridge: default false. X2D native printing: omit to use a ready card, else eMMC." },
                                 extra_options: { type: "string", description: "Raw JSON string or text for FULU PrintParams extra_options." },
                                 client_job_id: { type: "number", description: "Optional client job id sent to the bridge; defaults to the current timestamp." }
                             },
@@ -2458,8 +2484,9 @@ class BambuPrinterMCPServer {
                                 connection_mode: {
                                     type: "string",
                                     enum: ["lan_mqtt_ftps", "bambu_network", "bambu_native", "bambu_connect"],
-                                    description: "Print path: bambu_connect hands a printable file to the signed-in Bambu Connect app for cloud-mode review; X2D otherwise defaults to bambu_native (Bambu Studio's installed local networking plug-in and emmc tunnel); lan_mqtt_ftps is the legacy direct MQTT/FTPS path; bambu_network uses the FULU bridge."
+                                    description: "Print path: bambu_connect hands a printable file to the signed-in Bambu Connect app for cloud-mode review; X2D otherwise defaults to bambu_native (Bambu Studio's installed local networking plug-in, storing the job on a ready SD card or USB stick, otherwise internal eMMC); lan_mqtt_ftps is the legacy direct MQTT/FTPS path; bambu_network uses the FULU bridge."
                                 },
+                                try_emmc_print: { type: "boolean", description: "X2D native printing: true stores the job on internal storage (eMMC), false on the SD card or USB stick (refused unless the printer reports one ready). Omit to use the card when ready, else eMMC; BAMBU_NATIVE_TRY_EMMC_PRINT sets a server default." },
                                 connection_type: { type: "string", enum: ["cloud", "lan"], description: "BambuNetwork connection type when connection_mode is bambu_network; cloud uses restored internet printing, lan uses local bridge printing." },
                                 bambu_network_method: { type: "string", enum: BAMBU_NETWORK_PRINT_METHODS, description: "FULU print method when connection_mode is bambu_network; defaults to start_print for cloud and start_local_print for lan." },
                                 dev_id: { type: "string", description: "Bambu device id for FULU BambuNetwork printing; defaults to BAMBU_DEV_ID or BAMBU_SERIAL." },

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

@@ -51,4 +51,12 @@ export declare function hiddenHmsKeys(raw: unknown, serial: string, model: strin
 export declare function validatePrinterState(status: any, requirements: PrinterStateRequirements): ValidatedPrinterState;
 /** Manual M104 cannot remap filament slots. Validate the material already at the nozzle. */
 export declare function manualHeatingRequirements(status: any, model: string, nozzleDiameter: number, material: string): PrinterStateRequirements;
+export type ExternalStorageState = "none" | "normal" | "abnormal" | "readonly";
+/**
+ * The SD card or USB stick state, read as Bambu Studio does: the `sdcard`
+ * flag, then `home_flag` bits 8-9, then on firmware that reports cfg/fun/aux/stat
+ * the `aux` bits 12-13, each later source overriding the earlier one
+ * (DevStorage.cpp, DeviceManager.cpp parse_home_flag and parse_new_info).
+ */
+export declare function externalStorageState(raw: unknown): ExternalStorageState;
 export {};

package/dist/safety/printer-state.js

@@ -451,3 +451,21 @@ export function manualHeatingRequirements(status, model, nozzleDiameter, materia
     }
     return requirements;
 }
+const EXTERNAL_STORAGE_STATES = ["none", "normal", "abnormal", "readonly"];
+/**
+ * The SD card or USB stick state, read as Bambu Studio does: the `sdcard`
+ * flag, then `home_flag` bits 8-9, then on firmware that reports cfg/fun/aux/stat
+ * the `aux` bits 12-13, each later source overriding the earlier one
+ * (DevStorage.cpp, DeviceManager.cpp parse_home_flag and parse_new_info).
+ */
+export function externalStorageState(raw) {
+    if (!object(raw))
+        return "none";
+    let state = raw.sdcard === true ? "normal" : "none";
+    if (Number.isInteger(raw.home_flag))
+        state = EXTERNAL_STORAGE_STATES[(raw.home_flag >> 8) & 3];
+    if (["cfg", "fun", "aux", "stat"].every(key => key in raw) && typeof raw.aux === "string" && /^[0-9a-f]+$/i.test(raw.aux)) {
+        state = EXTERNAL_STORAGE_STATES[Number((BigInt(`0x${raw.aux}`) >> 12n) & 3n)];
+    }
+    return state;
+}

package/package.json

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

package/src/bambu-native.ts

@@ -26,6 +26,8 @@ export type BambuNativePrintOptions = {
   vibrationCalibration?: boolean;
   layerInspect?: boolean;
   timelapse?: boolean;
+  /** true: the SD card or USB stick; false: internal storage (eMMC); unset: BAMBU_NATIVE_TRY_EMMC_PRINT or internal. Reported as the requested storage. */
+  externalStorage?: boolean;
 };
 
 export type BambuNativeControlOptions = {
@@ -864,6 +866,7 @@ export async function printWithBambuNative(
       BAMBU_NATIVE_VIBRATION_CALIBRATION: boolEnv(options.vibrationCalibration, true),
       BAMBU_NATIVE_LAYER_INSPECT: boolEnv(options.layerInspect, false),
       BAMBU_NATIVE_TIMELAPSE: boolEnv(options.timelapse, false),
+      ...(options.externalStorage === undefined ? {} : { BAMBU_NATIVE_TRY_EMMC_PRINT: String(!options.externalStorage) }),
     },
     300_000,
     onUpdate,
@@ -885,6 +888,7 @@ export async function printWithBambuNative(
   return {
     status: "success",
     route: "bambu:///local",
+    ...(options.externalStorage === undefined ? {} : { storage: options.externalStorage ? "external" : "internal" }),
     updates: result.updates,
   };
 }

package/src/index.ts

@@ -45,7 +45,7 @@ import { analyze3MFAmsRequirements, analyze3MFPlateObjects, analyzeCollarCharm3M
 import type { ThreeMFAmsRequirements } from "./types.js";
 import { BambuImplementation, assertDirectPrintSupported } from "./printers/bambu.js";
 import { inspectPrintFile } from "./safety/print-file.js";
-import { validatePrinterState } from "./safety/printer-state.js";
+import { externalStorageState, validatePrinterState } from "./safety/printer-state.js";
 import { isDualNozzleModel } from "./safety/limits.js";
 import { withPrinterOperation, withPrintSnapshot, uniquePrintName } from "./safety/artifact.js";
 import { detectProfilesRoot } from "./slicer/profile-flatten.js";
@@ -101,6 +101,20 @@ function withEmergencyMqttTimeout<T>(send: (signal: AbortSignal) => Promise<T>):
   return Promise.race([Promise.resolve().then(() => send(controller.signal)), timeout]).finally(() => clearTimeout(timer));
 }
 
+/**
+ * Whether an X2D native print stores its job on the SD card or USB stick
+ * (true) or internal storage (eMMC). An explicit try_emmc_print wins, then
+ * BAMBU_NATIVE_TRY_EMMC_PRINT read as the helper reads it; otherwise a ready
+ * card is used, as OrcaSlicer does, so the job can be reprinted from the
+ * printer and read over FTPS.
+ */
+function nativeExternalStorage(tryEmmcPrint: boolean | undefined, raw: unknown): boolean {
+  if (tryEmmcPrint !== undefined) return !tryEmmcPrint;
+  const configured = process.env.BAMBU_NATIVE_TRY_EMMC_PRINT?.trim();
+  if (configured) return !["1", "true", "TRUE", "yes"].includes(configured);
+  return externalStorageState(raw) === "normal";
+}
+
 function requestedPrintNozzles(args: Record<string, any>): number[] | undefined {
   if (args.nozzle_diameters !== undefined && args.nozzle_diameter !== undefined) {
     throw new Error("Supply nozzle_diameters or nozzle_diameter, not both.");
@@ -1527,6 +1541,9 @@ class BambuPrinterMCPServer {
     if (!args?.three_mf_path) {
       throw new Error("Missing required parameter: three_mf_path");
     }
+    if (args?.try_emmc_print !== undefined && typeof args.try_emmc_print !== "boolean") {
+      throw new Error("try_emmc_print must be true or false.");
+    }
 
     const printModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
     const printBedType = resolveBedType(args?.bed_type as string | undefined);
@@ -1674,6 +1691,10 @@ class BambuPrinterMCPServer {
 
       assertActive();
       if (native) {
+        const externalStorage = nativeExternalStorage(args?.try_emmc_print, confirmedStatus.raw);
+        if (externalStorage && externalStorageState(confirmedStatus.raw) !== "normal") {
+          throw new Error("External storage was requested, but the printer reports no ready SD card or USB stick.");
+        }
         // Release the telemetry client before the installed plug-in opens its session.
         await this.bambu.disconnectAll();
         assertActive();
@@ -1687,11 +1708,15 @@ class BambuPrinterMCPServer {
           vibrationCalibration: params.task_vibration_cali as boolean,
           layerInspect: params.task_layer_inspect as boolean,
           timelapse: params.task_record_timelapse as boolean,
+          externalStorage,
         }, native.onUpdate, { signal: native.signal, assertActive, beforeDispatch: async () => {
           assertActive();
           const dispatchStatus = await this.bambu.getSafetyStatus(devIp, devId, password || bambuToken);
           validatePrinterState(dispatchStatus, requirements);
           this.bambu.assertBedClearance(dispatchStatus, bedClearance);
+          if (externalStorage && externalStorageState(dispatchStatus.raw) !== "normal") {
+            throw new Error("The printer's SD card or USB stick is no longer ready. Check it and start the print again.");
+          }
           assertActive();
         } });
         assertActive();
@@ -2611,7 +2636,7 @@ class BambuPrinterMCPServer {
                 use_ssl_for_ftp: { type: "boolean", description: "Whether FULU local print should use SSL for FTP (default: true)." },
                 use_ssl_for_mqtt: { type: "boolean", description: "Whether FULU local print should use SSL for MQTT (default: true)." },
                 external_change_assist: { type: "boolean", description: "Enable FULU PrintParams task_ext_change_assist for external filament change assistance." },
-                try_emmc_print: { type: "boolean", description: "Enable FULU PrintParams try_emmc_print for printers that support internal storage printing." },
+                try_emmc_print: { type: "boolean", description: "Store the job on internal storage (eMMC) instead of the SD card or USB stick. FULU bridge: default false. X2D native printing: omit to use a ready card, else eMMC." },
                 extra_options: { type: "string", description: "Raw JSON string or text for FULU PrintParams extra_options." },
                 client_job_id: { type: "number", description: "Optional client job id sent to the bridge; defaults to the current timestamp." }
               },
@@ -2987,8 +3012,9 @@ class BambuPrinterMCPServer {
                 connection_mode: {
                   type: "string",
                   enum: ["lan_mqtt_ftps", "bambu_network", "bambu_native", "bambu_connect"],
-                  description: "Print path: bambu_connect hands a printable file to the signed-in Bambu Connect app for cloud-mode review; X2D otherwise defaults to bambu_native (Bambu Studio's installed local networking plug-in and emmc tunnel); lan_mqtt_ftps is the legacy direct MQTT/FTPS path; bambu_network uses the FULU bridge."
+                  description: "Print path: bambu_connect hands a printable file to the signed-in Bambu Connect app for cloud-mode review; X2D otherwise defaults to bambu_native (Bambu Studio's installed local networking plug-in, storing the job on a ready SD card or USB stick, otherwise internal eMMC); lan_mqtt_ftps is the legacy direct MQTT/FTPS path; bambu_network uses the FULU bridge."
                 },
+                try_emmc_print: { type: "boolean", description: "X2D native printing: true stores the job on internal storage (eMMC), false on the SD card or USB stick (refused unless the printer reports one ready). Omit to use the card when ready, else eMMC; BAMBU_NATIVE_TRY_EMMC_PRINT sets a server default." },
                 connection_type: { type: "string", enum: ["cloud", "lan"], description: "BambuNetwork connection type when connection_mode is bambu_network; cloud uses restored internet printing, lan uses local bridge printing." },
                 bambu_network_method: { type: "string", enum: BAMBU_NETWORK_PRINT_METHODS, description: "FULU print method when connection_mode is bambu_network; defaults to start_print for cloud and start_local_print for lan." },
                 dev_id: { type: "string", description: "Bambu device id for FULU BambuNetwork printing; defaults to BAMBU_DEV_ID or BAMBU_SERIAL." },

package/src/safety/printer-state.ts

@@ -424,3 +424,22 @@ export function manualHeatingRequirements(status: any, model: string, nozzleDiam
   if (tray < 254) { requirements.useAMS = true; requirements.amsMapping = [tray]; }
   return requirements;
 }
+
+export type ExternalStorageState = "none" | "normal" | "abnormal" | "readonly";
+const EXTERNAL_STORAGE_STATES: readonly ExternalStorageState[] = ["none", "normal", "abnormal", "readonly"];
+
+/**
+ * The SD card or USB stick state, read as Bambu Studio does: the `sdcard`
+ * flag, then `home_flag` bits 8-9, then on firmware that reports cfg/fun/aux/stat
+ * the `aux` bits 12-13, each later source overriding the earlier one
+ * (DevStorage.cpp, DeviceManager.cpp parse_home_flag and parse_new_info).
+ */
+export function externalStorageState(raw: unknown): ExternalStorageState {
+  if (!object(raw)) return "none";
+  let state: ExternalStorageState = raw.sdcard === true ? "normal" : "none";
+  if (Number.isInteger(raw.home_flag)) state = EXTERNAL_STORAGE_STATES[(raw.home_flag >> 8) & 3];
+  if (["cfg", "fun", "aux", "stat"].every(key => key in raw) && typeof raw.aux === "string" && /^[0-9a-f]+$/i.test(raw.aux)) {
+    state = EXTERNAL_STORAGE_STATES[Number((BigInt(`0x${raw.aux}`) >> 12n) & 3n)];
+  }
+  return state;
+}