bambu-printer-mcp 1.1.28 → 1.1.29

package/CONTRIBUTORS.md

@@ -11,7 +11,9 @@ Thank you to everyone who builds, tests, reports problems, and shares real print
 | [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. |
 | [Adam (@adamkaplan)](https://github.com/adamkaplan) | Identifies the reversed H2C/H2D Pro serial prefixes in [#47](https://github.com/DMontgomery40/bambu-printer-mcp/issues/47), verifies corrected H2C status locally, and isolates the official H2C startup commands and config-block marker failure in [#48](https://github.com/DMontgomery40/bambu-printer-mcp/issues/48). Provides exact Bambu Studio version/template hash and unsafe-file reproductions; maintainer validation is offline and mocked. |
-| [travismcashan](https://github.com/travismcashan) | Reports stock X2D material-switch and runout-purge rejection, misleading unchecked confirmation, and stdout diagnostics in [#44](https://github.com/DMontgomery40/bambu-printer-mcp/issues/44). Supplies exact preset syntax and firmware evidence, then reports a clean physical X2D cube print with a local workaround; maintainer validation remains isolated and mocked. Reports the accepted native job and subsequent helper teardown crash in [#46](https://github.com/DMontgomery40/bambu-printer-mcp/issues/46), with completed-print and macOS crash evidence informing result preservation and duplicate-print warnings. |
+| [Pavel Bukhatkin (welderpb)](https://github.com/welderpb) | Requests remote API slicing for containerized deployments and specifies authentication, timeout and async needs in [#50](https://github.com/DMontgomery40/bambu-printer-mcp/issues/50). This informs the optional single-slot Orca API backend; validation uses HTTP fixtures and the genuine API application with a fake CLI, without a physical print. |
+| [AFKFelix](https://github.com/AFKFelix) and [orca-slicer-api contributors](https://github.com/AFKFelix/orca-slicer-api) | Provide the upstream HTTP slicing application and published multipart/job contracts used by the optional remote backend. |
+| [travismcashan](https://github.com/travismcashan) | Reports stock X2D material-switch and runout-purge rejection, misleading unchecked confirmation, and stdout diagnostics in [#44](https://github.com/DMontgomery40/bambu-printer-mcp/issues/44). Supplies exact preset syntax and firmware evidence, then reports a clean physical X2D cube print with a local workaround; maintainer validation remains isolated and mocked. Reports the accepted native job and subsequent helper teardown crash in [#46](https://github.com/DMontgomery40/bambu-printer-mcp/issues/46), with completed-print and macOS crash evidence informing result preservation and duplicate-print warnings. Contributes the X2D dual-nozzle slicer-output and dual-external-spool fix in [#59](https://github.com/DMontgomery40/bambu-printer-mcp/pull/59), with a real five-filament X2D job, live `vir_slot` evidence and the Bambu Studio virtual-tray conventions; the change is validated offline and mocked, and no physical print is claimed for it. |
 | [nitpreet22](https://github.com/nitpreet22) | Fixes rejection of the stock A1/A1 mini `M109 H` startup waits in [#41](https://github.com/DMontgomery40/bambu-printer-mcp/pull/41), contributes temperature and model regressions, and supplies Windows Bambu Studio profile and real sliced A1 job inspection evidence. Their physical print used Bambu Studio, not this MCP change. |
 | [Steavie (steavie)](https://github.com/steavie) | Reports the reversed A1/A1 mini serial prefixes in [#39](https://github.com/DMontgomery40/bambu-printer-mcp/issues/39), with A1 status and configuration evidence that identifies the status and fresh-identity regression. |
 | [JaviOFC](https://github.com/JaviOFC) | Reports the X2D identity rejection in [#36](https://github.com/DMontgomery40/bambu-printer-mcp/issues/36) and supplies current firmware, connection-mode, status-field, serial-prefix, and cloud-job evidence showing that `model_id` can contain a print-job identifier while `model` correctly identifies the printer. |

package/README.md

@@ -210,7 +210,7 @@ The optional FULU **BambuNetwork bridge** exposes `bambu_network_bridge_status`,
 - Start G-code files already stored on the printer
 - **Collar charm print wrapper** (`print_collar_charm`) — specialized two-color workflow with fixed tray policy for inner (black, AMS 1 slot 1) and outer (white, AMS 2 slot 1) charm parts
 - STL manipulation: scale, rotate, extend base, merge vertices, center at origin, lay flat, and inspect model info
-- Slice STL or 3MF files using an external CLI. BambuStudio, FULU, and Orca require the exact machine preset and resolve BBL dependencies before slicing; see [FULU/Orca CLI setup and validation limits](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#fulu-and-orca-cli-safety-limit).
+- Slice STL or 3MF files using an external CLI, or use the optional [`orca-slicer-api` backend](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SLICING.md) in a separate container without a local slicer executable. Remote slicing requires a matching read-only Orca profile tree and currently supports one filament slot and one selected plate. BambuStudio, FULU, and Orca require the exact machine preset and resolve BBL dependencies before slicing; see [FULU/Orca CLI setup and validation limits](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#fulu-and-orca-cli-safety-limit).
 - Inspect slicer settings from a saved 3MF template or extracted profile via `get_slice_settings`
 - Enumerate saved slicing templates from the local registry via `list_templates`
 - Save templates into the local registry via `save_template`
@@ -279,6 +279,8 @@ If you are using the direct-feed spool holder (no AMS attached) or want to bypas
 
 For H2 projects with declared filaments, also provide the required mapping; `use_ams: false` alone does not remove the firmware's mapping requirement. See [`print_3mf`](#print_3mf).
 
+Dual-nozzle printers (H2D, H2D Pro, H2C, X2D) have two external spool holders, and the printer reports one virtual slot per nozzle. Use Bambu Studio's ids in `ams_slots`/`ams_mapping`: `254` is the left/deputy nozzle's external spool and `255` the right/main nozzle's. The server composes the selected plate's `filament_map` with `physical_extruder_map` to verify each filament's physical nozzle (`0` = right, `1` = left), and requires the matching fresh `vir_slot` report. An explicit external-spool mapping is preserved with `use_ams: false`; a missing mapping is derived only from these inspected headers. Single-nozzle printers keep `254` as their only external tray.
+
 ### Auto-match AMS by RFID
 
 For pre-sliced 3MFs that declare filament types, the `auto_match_ams` flag on `print_3mf` (or the standalone `resolve_3mf_ams_slots` dry-run tool) automatically resolves the required filaments against your live AMS inventory. The matcher works as follows:
@@ -948,7 +950,7 @@ Install Bambu Studio and its networking plug-in, plus the Apple command-line dev
 
 The npm package and desktop bundle include `native/bambu-native-print.cpp`, `scripts/build-bambu-native.sh` and the Linux setup script, never a developer's compiled binary. The server finds the built helper relative to its installed package, regardless of the launch directory. A trusted server setting `BAMBU_NATIVE_HELPER` can select an alternate executable.
 
-For X2D, `print_3mf` defaults to `connection_mode: "bambu_native"`; legacy `lan_mqtt_ftps` requests are redirected to it. Supply `ams_slots`, a complete project-level `ams_mapping`, or `auto_match_ams: true`. An external-spool job requires explicit `use_ams: false`. Raw `ams_mapping2` and nozzle/extra-option overrides are rejected before dispatch; the server derives both AMS representations from the checked structured mapping. Model/nozzle/material inspection, fresh printer-state checks, and human preflight apply before the helper receives a private snapshot. The native helper requests fresh shared printer-state authorization immediately before each print submission, including a certificate retry, and before checked heating, resume, or error-clearing commands; custom helpers must support this handshake. Stop and heater-off remain available without preflight. Native upload-only requests use the same all-plate inspection as FTPS uploads. They accept `project_name`, `preset_name`, `bed_type`, and an existing `plate_index`; AMS, nozzle, and calibration print options are rejected. Use `print_3mf` for checked print settings.
+For X2D, `print_3mf` defaults to `connection_mode: "bambu_native"`; legacy `lan_mqtt_ftps` requests are redirected to it. Supply `ams_slots`, a complete project-level `ams_mapping`, or `auto_match_ams: true`. A job that uses only one external spool requires explicit `use_ams: false`; a job mixing AMS trays with the external spools maps them as `254` (left/deputy nozzle) and `255` (right/main nozzle). Raw `ams_mapping2` and nozzle/extra-option overrides are rejected before dispatch; the server derives both AMS representations from the checked structured mapping. Model/nozzle/material inspection, fresh printer-state checks, and human preflight apply before the helper receives a private snapshot. The native helper requests fresh shared printer-state authorization immediately before each print submission, including a certificate retry, and before checked heating, resume, or error-clearing commands; custom helpers must support this handshake. Stop and heater-off remain available without preflight. Native upload-only requests use the same all-plate inspection as FTPS uploads. They accept `project_name`, `preset_name`, `bed_type`, and an existing `plate_index`; AMS, nozzle, and calibration print options are rejected. Use `print_3mf` for checked print settings.
 
 The helper waits for connection/certificate exchange and retries only the initial `-4030` send once. Rebuild the helper after upgrading to receive the teardown fix. A successful dispatch receipt ends the helper before plug-in cleanup can turn an accepted job into an error. If an older/custom helper crashes after dispatch, the server reports uncertainty: check the printer state and job name before retrying, because resending can duplicate a print. Previous hardware testing reached `RUNNING` on X2D; this revision is validated with mocked transport regressions and clean installs, not a new physical print. `bambu_connect` is an optional macOS handoff for user review in Bambu Connect and does not start a print. Native task, heater, and error controls retain the common safety checks; raw controls cannot bypass them. Request cancellation, stop, and heater-off interrupt pending native helpers; the server waits for process exit before releasing a checked file. A command already sent to the printer cannot be recalled by cancelling the request, so verify printer state before retrying.
 

package/dist/ams-mapping.d.ts

@@ -1,3 +1,19 @@
-export declare function normalizeBridgeAmsTrayValue(value: unknown, label: string): number;
-export declare function normalizeAmsMappingObject(mapping: Record<string, unknown>, label?: string): number[];
+/** Tray-value options. `dualNozzle` admits 255, the right/main nozzle external spool that
+ * dual-nozzle printers report beside the left/deputy external spool 254 (Bambu Studio
+ * VIRTUAL_TRAY_MAIN_ID / VIRTUAL_TRAY_DEPUTY_ID). Single-nozzle printers keep 254 only. */
+export interface AmsTrayValueOptions {
+    dualNozzle?: boolean;
+}
+export declare function describeAmsTrayRange(options?: AmsTrayValueOptions): string;
+export declare function normalizeBridgeAmsTrayValue(value: unknown, label: string, options?: AmsTrayValueOptions): number;
+export declare function normalizeAmsMappingObject(mapping: Record<string, unknown>, label?: string, options?: AmsTrayValueOptions): number[];
 export declare function hasAmsMappingInput(value: unknown): boolean;
+/** Flat wire entries use -1 for dual-nozzle virtual trays; ams_mapping2 identifies their spool. */
+export declare function bridgeAmsMappingValue(value: number, dualNozzle?: boolean): number;
+/** Select an external spool only from a verified physical nozzle on dual-nozzle printers. */
+export declare function externalTrayForNozzle(nozzle: number | undefined, dualNozzle?: boolean): number;
+/** Virtual trays use slot zero on dual-nozzle printers; retain the historical single-nozzle form. */
+export declare function bridgeAmsMapping2Entry(value: number, dualNozzle?: boolean): {
+    ams_id: number;
+    slot_id: number;
+};

package/dist/ams-mapping.js

@@ -1,4 +1,9 @@
-export function normalizeBridgeAmsTrayValue(value, label) {
+export function describeAmsTrayRange(options = {}) {
+    return options.dualNozzle
+        ? "[-1, 15] (absolute tray), 128-253 (AMS-HT), 254 (left/deputy external) or 255 (right/main external)"
+        : "[-1, 15] (absolute tray) or 128-254 (HT/external)";
+}
+export function normalizeBridgeAmsTrayValue(value, label, options = {}) {
     let numeric;
     if (typeof value === "number") {
         numeric = value;
@@ -12,8 +17,8 @@ export function normalizeBridgeAmsTrayValue(value, label) {
     if (!Number.isInteger(numeric) ||
         numeric < -1 ||
         (numeric > 15 && numeric < 128) ||
-        numeric > 254) {
-        throw new Error(`${label} must be an integer in [-1, 15] (absolute tray) or 128-254 (HT/external); got ${JSON.stringify(value)}`);
+        numeric > (options.dualNozzle ? 255 : 254)) {
+        throw new Error(`${label} must be an integer in ${describeAmsTrayRange(options)}; got ${JSON.stringify(value)}`);
     }
     return numeric;
 }
@@ -21,7 +26,7 @@ function isNumericMappingKey(key) {
     const numeric = Number(key);
     return Number.isInteger(numeric) && numeric >= 0;
 }
-export function normalizeAmsMappingObject(mapping, label = "ams_mapping") {
+export function normalizeAmsMappingObject(mapping, label = "ams_mapping", options = {}) {
     return Object.entries(mapping)
         .sort(([leftKey], [rightKey]) => {
         const leftNumeric = isNumericMappingKey(leftKey);
@@ -34,7 +39,7 @@ export function normalizeAmsMappingObject(mapping, label = "ams_mapping") {
             return 1;
         return 0;
     })
-        .map(([key, value]) => normalizeBridgeAmsTrayValue(value, `${label}[${key}]`));
+        .map(([key, value]) => normalizeBridgeAmsTrayValue(value, `${label}[${key}]`, options));
 }
 export function hasAmsMappingInput(value) {
     if (Array.isArray(value))
@@ -43,3 +48,29 @@ export function hasAmsMappingInput(value) {
         return Object.keys(value).length > 0;
     return value !== undefined && value !== null;
 }
+/** Flat wire entries use -1 for dual-nozzle virtual trays; ams_mapping2 identifies their spool. */
+export function bridgeAmsMappingValue(value, dualNozzle = false) {
+    return dualNozzle && (value === 254 || value === 255) ? -1 : value;
+}
+/** Select an external spool only from a verified physical nozzle on dual-nozzle printers. */
+export function externalTrayForNozzle(nozzle, dualNozzle = false) {
+    if (!dualNozzle)
+        return 254;
+    if (nozzle === 0)
+        return 255;
+    if (nozzle === 1)
+        return 254;
+    throw new Error("External-spool printing requires inspected filament_map and physical_extruder_map nozzle bindings.");
+}
+/** Virtual trays use slot zero on dual-nozzle printers; retain the historical single-nozzle form. */
+export function bridgeAmsMapping2Entry(value, dualNozzle = false) {
+    if (value < 0)
+        return { ams_id: 255, slot_id: 255 };
+    if (value === 255)
+        return dualNozzle ? { ams_id: 255, slot_id: 0 } : { ams_id: 255, slot_id: 255 };
+    if (value === 254)
+        return { ams_id: 254, slot_id: dualNozzle ? 0 : 254 };
+    if (value >= 128)
+        return { ams_id: 128, slot_id: value - 128 };
+    return { ams_id: Math.floor(value / 4), slot_id: value % 4 };
+}

package/dist/index.js

@@ -14,11 +14,12 @@ import { BambuNetworkBridge } from "./bambu-network-bridge.js";
 import { assertBambuNativeAvailable, bambuNativeControlsAvailable, bambuNativeUnavailableReason, interruptNativeOperations, validateBambuNativeMetadata, buildBambuNativeFanCommand, buildBambuNativeTemperatureCommand, printWithBambuNative, sendCommandWithBambuNative, uploadWithBambuNative, } from "./bambu-native.js";
 import { importFileViaBambuConnect } from "./bambu-connect.js";
 import { BlenderMcpBridge } from "./blender-mcp-bridge.js";
-import { hasAmsMappingInput, normalizeAmsMappingObject, normalizeBridgeAmsTrayValue } from "./ams-mapping.js";
+import { bridgeAmsMapping2Entry, bridgeAmsMappingValue, externalTrayForNozzle, 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 { isDualNozzleModel } from "./safety/limits.js";
 import { withPrinterOperation, withPrintSnapshot, uniquePrintName } from "./safety/artifact.js";
 import { detectProfilesRoot } from "./slicer/profile-flatten.js";
 dotenv.config();
@@ -523,7 +524,7 @@ function defaultSlicerPathFor(slicerType) {
 }
 function resolveSlicerConfig(args) {
     const slicerType = normalizeSlicerType(String(args?.slicer_type || DEFAULT_SLICER_TYPE));
-    const slicerPath = String(args?.slicer_path || process.env.SLICER_PATH || defaultSlicerPathFor(slicerType));
+    const slicerPath = slicerType === "orca-slicer-api" ? "" : String(args?.slicer_path || process.env.SLICER_PATH || defaultSlicerPathFor(slicerType));
     const slicerProfile = String(args?.slicer_profile || DEFAULT_SLICER_PROFILE);
     return { slicerType, slicerPath, slicerProfile };
 }
@@ -735,18 +736,10 @@ function stringifyBridgeJson(value) {
         return value;
     return JSON.stringify(value);
 }
-function nativeAmsMapping2(mapping) {
+function nativeAmsMapping2(mapping, dualNozzle = false) {
     if (!mapping || mapping.length === 0)
         return undefined;
-    return JSON.stringify(mapping.map((value) => {
-        if (value < 0 || value === 255)
-            return { ams_id: 255, slot_id: 255 };
-        if (value === 254)
-            return { ams_id: 254, slot_id: 254 };
-        if (value >= 128)
-            return { ams_id: 128, slot_id: value - 128 };
-        return { ams_id: Math.floor(value / 4), slot_id: value % 4 };
-    }));
+    return JSON.stringify(mapping.map((value) => bridgeAmsMapping2Entry(value, dualNozzle)));
 }
 function redactPrintParams(params) {
     return {
@@ -1025,6 +1018,9 @@ class BambuPrinterMCPServer {
     resolveSlicerConfigFromArgs(args, toolName) {
         const config = resolveSlicerConfig(args);
         if (args?.slicer_path !== undefined) {
+            if (config.slicerType === "orca-slicer-api") {
+                throw new Error(`${toolName}: remote slicing uses trusted SLICER_API_URL and BAMBU_PROFILES_ROOT configuration; slicer_path is unsupported.`);
+            }
             const resolvedSlicerPath = this.resolveExecutableSelectorArg(args.slicer_path, toolName, "slicer_path");
             if (resolvedSlicerPath !== undefined) {
                 config.slicerPath = resolvedSlicerPath;
@@ -1048,10 +1044,10 @@ class BambuPrinterMCPServer {
         }
         console.error(`3MF has no gcode - auto-slicing with ${slicerType} for ${printModel}`);
         const autoSliceOptions = {
-            uptodate: true,
-            ensureOnBed: true,
-            minSave: true,
-            skipModifiedGcodes: true,
+            ...(slicerType === "orca-slicer-api" ? {} : {
+                uptodate: true, ensureOnBed: true, minSave: true, skipModifiedGcodes: true,
+            }),
+            ...(slicerType === "orca-slicer-api" ? { slicePlate: Number(args.plate_index ?? 0) + 1 } : {}),
             bedType: bedType ? resolveBambuStudioCliBedType(bedType) : undefined,
             nozzleType: resolveNozzleType(args?.nozzle_type),
             nozzleVolumeType: resolveNozzleVolumeType(args?.nozzle_volume_type),
@@ -1063,8 +1059,9 @@ class BambuPrinterMCPServer {
     async resolveAmsPrintSettings(threeMFPath, args, host, bambuSerial, bambuToken, printModel, printNozzle) {
         const parsed3MFData = await parse3MF(threeMFPath);
         let parsedAmsMapping;
+        const trayOptions = { dualNozzle: isDualNozzleModel(printModel) };
         if (parsed3MFData.slicerConfig?.ams_mapping) {
-            const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping);
+            const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping, "ams_mapping", trayOptions);
             if (slots.length > 0) {
                 parsedAmsMapping = slots;
             }
@@ -1077,10 +1074,10 @@ class BambuPrinterMCPServer {
         if (hasUserAmsMapping) {
             let userMappingOverride;
             if (Array.isArray(args.ams_mapping)) {
-                userMappingOverride = args.ams_mapping.map((v, i) => normalizeBridgeAmsTrayValue(v, `ams_mapping[${i}]`));
+                userMappingOverride = args.ams_mapping.map((v, i) => normalizeBridgeAmsTrayValue(v, `ams_mapping[${i}]`, trayOptions));
             }
             else if (args.ams_mapping && typeof args.ams_mapping === 'object') {
-                userMappingOverride = normalizeAmsMappingObject(args.ams_mapping);
+                userMappingOverride = normalizeAmsMappingObject(args.ams_mapping, "ams_mapping", trayOptions);
             }
             if (userMappingOverride && userMappingOverride.length > 0) {
                 finalAmsMapping = userMappingOverride;
@@ -1089,7 +1086,7 @@ class BambuPrinterMCPServer {
             }
         }
         if (!hasUserAmsMapping && hasUserAmsSlots) {
-            const userSlots = args.ams_slots.map((slot, i) => normalizeBridgeAmsTrayValue(slot, `ams_slots[${i}]`));
+            const userSlots = args.ams_slots.map((slot, i) => normalizeBridgeAmsTrayValue(slot, `ams_slots[${i}]`, trayOptions));
             finalAmsSlots = userSlots;
             finalAmsMapping = undefined;
             useAMS = userSlots.length > 0;
@@ -1106,8 +1103,10 @@ class BambuPrinterMCPServer {
             useAMS = true;
         }
         if (args?.use_ams === false) {
-            finalAmsMapping = undefined;
-            finalAmsSlots = undefined;
+            if (!hasUserAmsMapping)
+                finalAmsMapping = undefined;
+            if (!hasUserAmsSlots)
+                finalAmsSlots = undefined;
             useAMS = false;
         }
         if ((!finalAmsMapping || finalAmsMapping.length === 0) && (!finalAmsSlots || finalAmsSlots.length === 0)) {
@@ -1177,8 +1176,16 @@ class BambuPrinterMCPServer {
                 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; });
+                mapping ?? (mapping = Array(inspection.materials.length).fill(-1));
+                const dualNozzle = isDualNozzleModel(printModel);
+                for (const position of inspection.usedFilamentPositions) {
+                    if (mapping[position] === undefined || mapping[position] < 0) {
+                        mapping[position] = externalTrayForNozzle(inspection.filamentNozzleIndices?.[position], dualNozzle);
+                    }
+                    if (mapping[position] !== 254 && !(dualNozzle && mapping[position] === 255)) {
+                        throw new Error("use_ams:false requires an external-spool mapping for every used filament.");
+                    }
+                }
             }
             const requirements = { ...inspection, amsMapping: mapping, useAMS };
             const initialStatus = await this.bambu.getSafetyStatus(devIp, devId, password || bambuToken);
@@ -1187,7 +1194,7 @@ class BambuPrinterMCPServer {
             const confirmedStatus = await this.bambu.getSafetyStatus(devIp, devId, password || bambuToken);
             validatePrinterState(confirmedStatus, requirements);
             this.bambu.assertBedClearance(confirmedStatus, bedClearance);
-            const amsMapping = stringifyBridgeJson(mapping);
+            const amsMapping = stringifyBridgeJson(mapping?.map(value => bridgeAmsMappingValue(value, isDualNozzleModel(printModel))));
             const remoteFileName = uniquePrintName(threeMFPath);
             const params = {
                 dev_id: devId,
@@ -1204,7 +1211,7 @@ class BambuPrinterMCPServer {
                 ftp_file_md5: String(args?.ftp_file_md5 || ""),
                 nozzle_mapping: stringifyBridgeJson(args?.nozzle_mapping) || "",
                 ams_mapping: amsMapping || "",
-                ams_mapping2: stringifyBridgeJson(args?.ams_mapping2) || "",
+                ams_mapping2: nativeAmsMapping2(mapping, isDualNozzleModel(printModel)) || "",
                 ams_mapping_info: stringifyBridgeJson(args?.ams_mapping_info) || "",
                 nozzles_info: stringifyBridgeJson(args?.nozzles_info) || "",
                 connection_type: connectionType,
@@ -1244,7 +1251,7 @@ class BambuPrinterMCPServer {
                     host: devIp, serial: devId, token: password || bambuToken, filePath: snapshot,
                     projectName: String(params.task_name), presetName, remoteName: remoteFileName,
                     plateIndex, bedType: printBedType, useAMS,
-                    amsMapping, amsMapping2: nativeAmsMapping2(mapping),
+                    amsMapping, amsMapping2: nativeAmsMapping2(mapping, isDualNozzleModel(printModel)),
                     bedLeveling: params.task_bed_leveling,
                     flowCalibration: params.task_flow_cali,
                     vibrationCalibration: params.task_vibration_cali,
@@ -1447,10 +1454,9 @@ class BambuPrinterMCPServer {
             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.');
         }
         const autoSliceOptions = {
-            uptodate: true,
-            ensureOnBed: true,
-            minSave: true,
-            skipModifiedGcodes: true,
+            ...(slicerType === "orca-slicer-api" ? {} : {
+                uptodate: true, ensureOnBed: true, minSave: true, skipModifiedGcodes: true,
+            }),
             bedType,
         };
         try {
@@ -1943,7 +1949,7 @@ class BambuPrinterMCPServer {
                                 rotate_y: { type: "number", description: "Rotate the model around the Y-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion." },
                                 min_save: { type: "boolean", description: "Write a smaller output 3MF by omitting non-essential metadata. Reduces file size for faster FTP upload to the printer." },
                                 skip_modified_gcodes: { type: "boolean", description: "Strip custom start/end gcodes embedded in the 3MF. Recommended for downloaded 3MFs since custom gcodes from other users' profiles may be unsafe for your printer." },
-                                slice_plate: { type: "number", description: "Which plate index to slice. 0 = all plates (default). Use 1, 2, etc. to slice only a specific plate in multi-plate 3MF projects." }
+                                slice_plate: { type: "number", description: "Which plate index to slice. 0 = all plates for local slicers; remote slicing defaults to plate 1 and rejects 0. Use 1, 2, etc. to slice only a specific plate in multi-plate 3MF projects." }
                             },
                             required: ["stl_path", "bambu_model"]
                         }
@@ -2046,8 +2052,8 @@ class BambuPrinterMCPServer {
                                 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" } },
+                                ams_mapping: { type: "array", description: "AMS slot mapping array used by both local MCP printing and FULU PrintParams. Same tray values as print_3mf: 254 = external spool; on dual-nozzle printers 254 = left/deputy nozzle external and 255 = right/main nozzle external.", items: { type: "number" } },
+                                ams_slots: { type: "array", description: "Per-used-filament AMS slot list, matching the local LAN print path (254/255 external spool rules as in print_3mf).", items: { type: "number" } },
                                 ams_mapping_bridge: { type: "string", description: "Raw JSON string override for FULU PrintParams ams_mapping when the automatic array is not enough." },
                                 ams_mapping2: { type: "string", description: "Raw JSON string for FULU PrintParams ams_mapping2, matching OrcaSlicer-bambulab's v1 AMS mapping field." },
                                 ams_mapping_info: { type: "string", description: "Raw JSON string for FULU PrintParams ams_mapping_info, matching OrcaSlicer-bambulab's detailed AMS mapping field." },
@@ -2475,12 +2481,12 @@ class BambuPrinterMCPServer {
                                 use_ams: { type: "boolean", description: "Whether to use the AMS (default: auto-detect from 3MF)" },
                                 ams_mapping: {
                                     type: "array",
-                                    description: "Project-level AMS mapping array. Position = project filament index, value = absolute AMS tray (0-3=AMS 0, 4-7=AMS 1, 8-11=AMS 2, 128+=AMS-HT, 254=external, -1=unused). Prefer ams_slots unless you know the project-level layout.",
+                                    description: "Project-level AMS mapping array. Position = project filament index, value = absolute AMS tray (0-3=AMS 0, 4-7=AMS 1, 8-11=AMS 2, 128+=AMS-HT, 254=external, -1=unused). On dual-nozzle printers (H2D, H2D Pro, H2C, X2D) 254 is the LEFT/deputy nozzle external spool and 255 the RIGHT/main nozzle external spool, matching Bambu Studio's virtual tray ids; the gcode header's filament_map (1=left, 2=right) says which nozzle each filament was sliced for. Prefer ams_slots unless you know the project-level layout.",
                                     items: { type: "number" }
                                 },
                                 ams_slots: {
                                     type: "array",
-                                    description: "Preferred AMS input: one absolute tray index per USED filament in plate order, e.g. [1] for a single-filament print pulling from AMS 0 slot 1. Expanded to project-level ams_mapping automatically from the 3MF's plate_N.json and gcode header.",
+                                    description: "Preferred AMS input: one absolute tray index per USED filament in plate order, e.g. [1] for a single-filament print pulling from AMS 0 slot 1. Use 254 for the external spool (on dual-nozzle printers: 254 = left/deputy nozzle external, 255 = right/main nozzle external). Expanded to project-level ams_mapping automatically from the 3MF's plate_N.json and gcode header.",
                                     items: { type: "number" }
                                 },
                                 auto_match_ams: {
@@ -3415,10 +3421,9 @@ class BambuPrinterMCPServer {
                             }
                             console.error(`3MF has no gcode — auto-slicing with ${slicerType} for ${printModel}`);
                             const autoSliceOptions = {
-                                uptodate: true,
-                                ensureOnBed: true,
-                                minSave: true,
-                                skipModifiedGcodes: true,
+                                ...(slicerType === "orca-slicer-api" ? { slicePlate: plateIndex + 1 } : {
+                                    uptodate: true, ensureOnBed: true, minSave: true, skipModifiedGcodes: true,
+                                }),
                                 bedType: printBedType,
                                 nozzleType: resolveNozzleType(args?.nozzle_type),
                                 nozzleVolumeType: resolveNozzleVolumeType(args?.nozzle_volume_type),
@@ -3440,9 +3445,10 @@ class BambuPrinterMCPServer {
                         }
                         const parsed3MFData = await parse3MF(threeMFPath);
                         const isH2Print = H2_BAMBU_MODELS.has(printModel);
+                        const trayOptions = { dualNozzle: isDualNozzleModel(printModel) };
                         let parsedAmsMapping;
                         if (!isH2Print && parsed3MFData.slicerConfig?.ams_mapping) {
-                            const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping);
+                            const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping, "ams_mapping", trayOptions);
                             if (slots.length > 0) {
                                 parsedAmsMapping = slots;
                             }
@@ -3455,10 +3461,10 @@ class BambuPrinterMCPServer {
                         if (hasUserAmsMapping) {
                             let userMappingOverride;
                             if (Array.isArray(args.ams_mapping)) {
-                                userMappingOverride = args.ams_mapping.map((v, i) => normalizeBridgeAmsTrayValue(v, `ams_mapping[${i}]`));
+                                userMappingOverride = args.ams_mapping.map((v, i) => normalizeBridgeAmsTrayValue(v, `ams_mapping[${i}]`, trayOptions));
                             }
                             else if (args.ams_mapping && typeof args.ams_mapping === 'object') {
-                                userMappingOverride = normalizeAmsMappingObject(args.ams_mapping);
+                                userMappingOverride = normalizeAmsMappingObject(args.ams_mapping, "ams_mapping", trayOptions);
                             }
                             if (userMappingOverride && userMappingOverride.length > 0) {
                                 finalAmsMapping = userMappingOverride;
@@ -3499,8 +3505,10 @@ class BambuPrinterMCPServer {
                             }
                         }
                         if (args?.use_ams === false) {
-                            finalAmsMapping = undefined;
-                            finalAmsSlots = undefined;
+                            if (!hasUserAmsMapping)
+                                finalAmsMapping = undefined;
+                            if (!hasUserAmsSlots)
+                                finalAmsSlots = undefined;
                             useAMS = false;
                         }
                         if ((!finalAmsMapping || finalAmsMapping.length === 0) && (!finalAmsSlots || finalAmsSlots.length === 0)) {

package/dist/printers/bambu.js

@@ -7,7 +7,8 @@ import os from "node:os";
 import { Readable } from "node:stream";
 import { readSafe3mfArchive } from "../safety/archive.js";
 import { inspectPrintFile } from "../safety/print-file.js";
-import { normalizeModel, validateTemperature } from "../safety/limits.js";
+import { isDualNozzleModel, normalizeModel, validateTemperature } from "../safety/limits.js";
+import { bridgeAmsMapping2Entry, bridgeAmsMappingValue, externalTrayForNozzle, describeAmsTrayRange } from "../ams-mapping.js";
 import { describeHmsKey, hiddenHmsKeys, hiddenHmsNotices, reportedHmsKey, validatePrinterState, manualHeatingRequirements } from "../safety/printer-state.js";
 import { withPrinterOperation, withPrintSnapshot, uniquePrintName, normalizedRemotePath, cancelPendingPrinterOperations } from "../safety/artifact.js";
 import { Client as FTPClient } from "basic-ftp";
@@ -620,12 +621,17 @@ export class BambuImplementation {
         // `plate_N.json.filament_ids` -- and expand to a full project-level
         // array here. `amsMapping` is the raw escape hatch (takes precedence
         // when both are supplied).
+        // Dual-nozzle printers address two external spools: 254 feeds the left/deputy
+        // nozzle and 255 the right/main nozzle (Bambu Studio VIRTUAL_TRAY_DEPUTY_ID /
+        // VIRTUAL_TRAY_MAIN_ID). Single-nozzle printers keep 254 as the only external tray.
+        const dualNozzle = isDualNozzleModel(model);
+        const externalTrays = dualNozzle ? [254, 255] : [254];
         const validateTrayValue = (v, label) => {
             if (!Number.isInteger(v) ||
                 v < -1 ||
                 (v > 15 && v < 128) ||
-                v > 254) {
-                throw new Error(`${label} values must be integers in [-1, 15] (absolute tray) or 128-254 (HT/external); got ${v}`);
+                v > (dualNozzle ? 255 : 254)) {
+                throw new Error(`${label} values must be integers in ${describeAmsTrayRange({ dualNozzle })}; got ${v}`);
             }
         };
         let baseMapping;
@@ -655,7 +661,7 @@ export class BambuImplementation {
             const projectLen = Math.max(projectMetadata.projectFilamentCount, ...positions.map((p) => p + 1), 1);
             baseMapping = Array(projectLen).fill(-1);
             positions.forEach((pos, i) => {
-                baseMapping[pos] = options.useAMS === false ? 254 : i;
+                baseMapping[pos] = options.useAMS === false ? externalTrayForNozzle(inspection.filamentNozzleIndices?.[pos], dualNozzle) : i;
             });
         }
         let amsMapping;
@@ -663,15 +669,7 @@ export class BambuImplementation {
         if (usesH2ProjectFile) {
             const projLen = Math.max(projectMetadata.projectFilamentCount, baseMapping.length, 1);
             amsMapping = Array.from({ length: projLen }, (_, i) => i < baseMapping.length ? baseMapping[i] : -1);
-            amsMapping2 = amsMapping.map((v) => {
-                if (v < 0 || v === 255)
-                    return { ams_id: 255, slot_id: 255 };
-                if (v === 254)
-                    return { ams_id: 254, slot_id: 254 };
-                if (v >= 128)
-                    return { ams_id: 128, slot_id: v - 128 };
-                return { ams_id: Math.floor(v / 4), slot_id: v % 4 };
-            });
+            amsMapping2 = amsMapping.map((v) => bridgeAmsMapping2Entry(v, dualNozzle));
         }
         else {
             amsMapping = Array.from({ length: Math.max(5, baseMapping.length, projectMetadata.projectFilamentCount) }, (_, i) => i < baseMapping.length ? baseMapping[i] : -1);
@@ -681,8 +679,8 @@ export class BambuImplementation {
             if (baseMapping[position] === undefined || baseMapping[position] < 0) {
                 throw new Error(`Missing physical filament mapping for project filament ${position}.`);
             }
-            if (options.useAMS === false && baseMapping[position] !== 254) {
-                throw new Error("External-spool printing requires external spool mapping (254).");
+            if (options.useAMS === false && !externalTrays.includes(baseMapping[position])) {
+                throw new Error(`External-spool printing requires external spool mapping (${externalTrays.join(" or ")}).`);
             }
         }
         const legacyContainer = options.filePath.toLowerCase().endsWith(".gcode.3mf") && !usesH2ProjectFile && !isA1;
@@ -768,7 +766,7 @@ export class BambuImplementation {
                     project_id: submissionId,
                     subtask_id: submissionId,
                     task_id: submissionId,
-                    ams_mapping: amsMapping,
+                    ams_mapping: amsMapping.map(value => bridgeAmsMappingValue(value, dualNozzle)),
                     ams_mapping2: amsMapping2,
                 },
             };

package/dist/safety/limits.d.ts

@@ -21,6 +21,12 @@ export declare const MACHINE_LIMITS: Readonly<Record<string, {
     chamber: number;
     volume: readonly number[];
 }>>;
+/** Printers with two physical nozzles. Bambu Studio numbers the right/main nozzle 0
+ * (MAIN_EXTRUDER_ID) and the left/deputy nozzle 1 (DEPUTY_EXTRUDER_ID), and reports one
+ * virtual external-spool slot per nozzle: 255 (VIRTUAL_TRAY_MAIN_ID) and 254
+ * (VIRTUAL_TRAY_DEPUTY_ID). The single-nozzle H2S is deliberately absent. */
+export declare const DUAL_NOZZLE_MODELS: ReadonlySet<string>;
+export declare function isDualNozzleModel(model: unknown): boolean;
 export declare function normalizeModel(value: unknown): string | undefined;
 export declare function normalizeMaterial(value: unknown): string | undefined;
 export declare function validateTemperature(component: 'nozzle' | 'bed' | 'chamber', value: unknown, model: string, materials?: string[]): number;

package/dist/safety/limits.js

@@ -30,6 +30,15 @@ export const MACHINE_LIMITS = {
     h2s: { nozzle: 350, bed: 120, chamber: 65, volume: [340, 320, 340] },
     x2d: { nozzle: 300, bed: 120, chamber: 65, volume: [256, 256, 260] },
 };
+/** Printers with two physical nozzles. Bambu Studio numbers the right/main nozzle 0
+ * (MAIN_EXTRUDER_ID) and the left/deputy nozzle 1 (DEPUTY_EXTRUDER_ID), and reports one
+ * virtual external-spool slot per nozzle: 255 (VIRTUAL_TRAY_MAIN_ID) and 254
+ * (VIRTUAL_TRAY_DEPUTY_ID). The single-nozzle H2S is deliberately absent. */
+export const DUAL_NOZZLE_MODELS = new Set(['h2d', 'h2dpro', 'h2c', 'x2d']);
+export function isDualNozzleModel(model) {
+    const normalized = normalizeModel(model);
+    return normalized !== undefined && DUAL_NOZZLE_MODELS.has(normalized);
+}
 export function normalizeModel(value) {
     if (typeof value !== 'string')
         return undefined;

package/dist/safety/print-file.d.ts

@@ -12,6 +12,8 @@ export interface PrintFileInspection {
     selectsAms: boolean;
     nozzleTypes?: string[];
     nozzleFlows?: string[];
+    /** Physical nozzle index for each declared filament, composed from the selected plate headers. */
+    filamentNozzleIndices?: number[];
 }
 /** Inspect the exact selected plate. This does not simulate firmware or arbitrary motion:
  * only declared object bounds are checked, never purge/homing/wipe travel coordinates.

package/dist/safety/print-file.js

@@ -1,6 +1,6 @@
 import { createHash } from 'node:crypto';
 import { readBoundedPrintFile, loadSafe3mfArchive } from './archive.js';
-import { MACHINE_LIMITS, normalizeMaterial, normalizeModel, validateStartupPurgeTemperature, validateTemperature } from './limits.js';
+import { MACHINE_LIMITS, isDualNozzleModel, normalizeMaterial, normalizeModel, validateStartupPurgeTemperature, validateTemperature } from './limits.js';
 const NUMBER = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)$/;
 const fail = (message) => { throw new Error(`Print safety: ${message}`); };
 function list(value) {
@@ -168,6 +168,7 @@ export async function inspectPrintFile(filePath, options) {
     const model = normalizeModel(options.model);
     if (!model)
         return fail(`unknown or missing printer model '${options.model}'`);
+    const dualNozzle = isDualNozzleModel(model);
     const plateIndex = options.plateIndex ?? 0;
     if (!Number.isInteger(plateIndex) || plateIndex < 0)
         return fail('selected plate index must be a nonnegative integer');
@@ -308,6 +309,24 @@ export async function inspectPrintFile(filePath, options) {
         const values = list(value);
         return values.length && values.every(v => !!normalizeMaterial(v)) ? values.map(v => normalizeMaterial(v)) : undefined;
     }, 'filament material');
+    // GCode.cpp uses 1-based filament_map logical extruders and then indexes
+    // physical_extruder_map to select the physical nozzle. Only this selected
+    // plate's headers establish that binding; unsliced project defaults do not.
+    const headerMap = (key, count, low, high) => {
+        const values = metadataValues(headers, [key]);
+        if (!values.length)
+            return undefined;
+        return consistent(values, value => {
+            const entries = list(value);
+            return entries.length === count && entries.every(v => NUMBER.test(v) && Number.isInteger(Number(v)) && Number(v) >= low && Number(v) <= high)
+                ? entries.map(Number) : undefined;
+        }, key.replace(/_/g, ' '));
+    };
+    const physicalExtruderMap = headerMap('physical_extruder_map', nozzleDiameters.length, 0, dualNozzle ? Math.min(nozzleDiameters.length, 2) - 1 : nozzleDiameters.length - 1);
+    if (physicalExtruderMap && new Set(physicalExtruderMap).size !== physicalExtruderMap.length)
+        fail('physical extruder map must be a complete permutation');
+    const filamentMap = headerMap('filament_map', materials.length, 1, nozzleDiameters.length);
+    const filamentNozzleIndices = filamentMap && physicalExtruderMap ? filamentMap.map(logical => physicalExtruderMap[logical - 1]) : undefined;
     const bedValues = metadataValues([...metadata, plate], ['curr_bed_type', 'bed_type']);
     const bedType = bedValues.length ? consistent(bedValues, normalizeBed, 'bed type') : undefined;
     if (options.bedType && (!bedType || normalizeBed(options.bedType) !== bedType))
@@ -370,7 +389,11 @@ export async function inspectPrintFile(filePath, options) {
             let line = stripComments(lines[index]);
             if (!line || line === '%')
                 continue;
-            // The official H2C template emits this literal separator without a semicolon.
+            // Accept only the exact vendor banners in their documented model/scope.
+            // X2D emits its filament-change banner throughout a print; H2C's record
+            // separator stays inside its explicitly bounded startup block.
+            if (line === '======== X2D filament_change gcode ==========' && model === 'x2d')
+                continue;
             if (line === '========== record data ==========' && h2cStartup(index))
                 continue;
             line = line.replace(/^N\d+\s*/i, '').replace(/\*\d+\s*$/, '');
@@ -477,9 +500,16 @@ export async function inspectPrintFile(filePath, options) {
                     continue;
                 }
                 const vendorWait = code === 'M109' && ['a1', 'a1mini'].includes(model);
+                // Bambu Studio addresses a physical nozzle on dual-nozzle machines with N<index>
+                // (X2D `M104 T1 S25 N0` multi-extruder pre-cooling and wipe-tower reheats).
+                // N selects a nozzle, never a target, so it is accepted only on those models,
+                // only for nozzle heaters, and only within the declared nozzle count.
+                const nozzleIndex = ['M104', 'M109'].includes(code) && dualNozzle;
                 for (const key of args.keys())
-                    if (!'SRTA'.includes(key) && !(key === 'H' && vendorWait))
+                    if (!'SRTA'.includes(key) && !(key === 'H' && vendorWait) && !(key === 'N' && nozzleIndex))
                         fail(`unsupported ${code} temperature parameter ${key}`);
+                if (args.has('N') && (!Number.isInteger(args.get('N')) || args.get('N') < 0 || args.get('N') >= Math.min(nozzleDiameters.length, 2)))
+                    fail(`unsupported ${code} nozzle index N`);
                 if (args.has('H') && (!Number.isFinite(args.get('H')) || args.get('H') < 0 || args.get('H') > 300))
                     fail(`unsupported ${code} wait parameter H`);
                 if (!args.has('S') && !args.has('R'))
@@ -489,13 +519,13 @@ export async function inspectPrintFile(filePath, options) {
                 // Without a verified per-filament nozzle map, apply all possible materials.
                 if (args.has('T') && (!Number.isInteger(args.get('T')) || args.get('T') < 0 || args.get('T') >= nozzleDiameters.length))
                     fail('physical heater target has no declared nozzle');
-                const position = args.has('T') ? undefined : active;
+                const position = args.has('T') || args.has('N') ? undefined : active;
                 const commonFlush = code === 'M109' && args.size === 1 && args.get('S') === 290 && model === 'x1e' && !depositionStarted && !commonFlushUsed && boundedX1ePurge(lines, index);
                 if (commonFlush)
                     commonFlushUsed = true;
                 for (const key of ['S', 'R'])
                     if (args.has(key))
-                        heat(component, args.get(key), position, args.has('T') || args.has('A'), commonFlush);
+                        heat(component, args.get(key), position, args.has('T') || args.has('N') || args.has('A'), commonFlush);
             }
             else if (code === 'M620' || code === 'M621') {
                 const args = parameters(argumentsText, model === 'x2d' ? 'MAB' : model === 'h2c' ? 'MAN' : 'MA');
@@ -656,5 +686,5 @@ export async function inspectPrintFile(filePath, options) {
         return fail('selected G-code contains no printable commands');
     if (!used.size)
         materials.forEach((_, index) => used.add(index));
-    return { model, nozzleDiameters, materials, usedFilamentPositions: [...used].sort((a, b) => a - b), plateInternalPath, sha256, maxNozzleTemperature, maxBedTemperature, maxChamberTemperature, bedType, selectsAms, nozzleTypes, nozzleFlows };
+    return { model, nozzleDiameters, materials, usedFilamentPositions: [...used].sort((a, b) => a - b), plateInternalPath, sha256, maxNozzleTemperature, maxBedTemperature, maxChamberTemperature, bedType, selectsAms, nozzleTypes, nozzleFlows, filamentNozzleIndices };
 }