bambu-printer-mcp 1.1.28 → 1.1.30

package/dist/stl/stl-manipulator.js

@@ -11,6 +11,7 @@ import * as crypto from 'crypto';
 import { execFile } from 'child_process';
 import { flattenForCli, detectProfilesRoot, resolveBblMachineProfile } from '../slicer/profile-flatten.js';
 import { profileJsonFiles } from '../slicer/profile-files.js';
+import { sliceWithOrcaApi, validateRemoteSliceOptions } from '../slicer/remote-slicer.js';
 const readFileAsync = promisify(fs.readFile);
 const writeFileAsync = promisify(fs.writeFile);
 const BAMBU_PROFILE_ROOTS = [
@@ -27,6 +28,7 @@ export const SLICER_TYPES = [
     'bambustudio',
     'orcaslicer',
     'orcaslicer-bambulab',
+    'orca-slicer-api',
     'prusaslicer',
     'cura',
     'slic3r',
@@ -48,6 +50,8 @@ const SLICER_TYPE_ALIASES = {
     orcastudio: 'orcaslicer-bambulab',
     'orcaslicer-bmcu': 'orcaslicer-bambulab',
     'orca-bmcu': 'orcaslicer-bambulab',
+    'orca-slicer-api': 'orca-slicer-api',
+    'orcaslicer-api': 'orca-slicer-api',
     prusaslicer: 'prusaslicer',
     'prusa-slicer': 'prusaslicer',
     cura: 'cura',
@@ -65,7 +69,8 @@ export function normalizeSlicerType(rawSlicerType) {
 export function isBambuCompatibleSlicer(slicerType) {
     return (slicerType === 'bambustudio' ||
         slicerType === 'orcaslicer' ||
-        slicerType === 'orcaslicer-bambulab');
+        slicerType === 'orcaslicer-bambulab' ||
+        slicerType === 'orca-slicer-api');
 }
 function isPathLikeExecutable(slicerPath) {
     return (path.isAbsolute(slicerPath) ||
@@ -1225,7 +1230,7 @@ export class STLManipulator extends EventEmitter {
     async sliceSTL(stlFilePath, slicerType, slicerPath, slicerProfile, progressCallback, printerPreset, bambuOptions) {
         const operationId = this.generateOperationId();
         this.activeOperations.set(operationId, true);
-        if (isPathLikeExecutable(slicerPath) && !fs.existsSync(slicerPath)) {
+        if (slicerType !== 'orca-slicer-api' && isPathLikeExecutable(slicerPath) && !fs.existsSync(slicerPath)) {
             throw new Error(`Slicer executable not found at: ${slicerPath}`);
         }
         if (slicerProfile && !fs.existsSync(slicerProfile)) {
@@ -1267,6 +1272,7 @@ export class STLManipulator extends EventEmitter {
                 case 'bambustudio':
                 case 'orcaslicer':
                 case 'orcaslicer-bambulab':
+                case 'orca-slicer-api':
                     // Bambu-compatible CLI: slice and export as 3MF with embedded gcode.
                     // FULU's OrcaSlicer-bambulab fork keeps this Bambu-style path.
                     // For 3MF input: slice in place and export sliced 3MF
@@ -1274,10 +1280,19 @@ export class STLManipulator extends EventEmitter {
                     {
                         const is3mf = stlFilePath.toLowerCase().endsWith('.3mf');
                         const outputBase = path.basename(stlFilePath, is3mf ? '.3mf' : '.stl');
-                        const bambuOutputPath = path.join(this.tempDir, outputBase + '_sliced.3mf');
+                        const remote = slicerType === 'orca-slicer-api';
+                        if (remote) {
+                            validateRemoteSliceOptions(bambuOptions);
+                            if (!process.env.BAMBU_PROFILES_ROOT)
+                                throw new Error('Remote slicing requires BAMBU_PROFILES_ROOT pointing to the matching Orca profile tree (a read-only mount is sufficient).');
+                            if (slicerProfile && !fs.existsSync(slicerProfile))
+                                throw new Error('Remote slicing process profile does not exist.');
+                        }
+                        const profileSlicerType = remote ? 'orcaslicer' : slicerType;
+                        const bambuOutputPath = path.join(this.tempDir, outputBase + (remote ? `_${operationId}` : '') + '_sliced.3mf');
                         const outputDir = path.dirname(bambuOutputPath);
-                        const profilesRoot = detectProfilesRoot(slicerPath, slicerType);
-                        const rawBundle = await this.resolveBambuLikeSettingsBundle(outputBase, slicerType, slicerProfile, printerPreset, bambuOptions, profilesRoot);
+                        const profilesRoot = detectProfilesRoot(remote ? undefined : slicerPath, profileSlicerType);
+                        const rawBundle = await this.resolveBambuLikeSettingsBundle(outputBase, profileSlicerType, slicerProfile, printerPreset, bambuOptions, profilesRoot);
                         // Resolve every BBL dependency before launching the slicer.
                         const settingsBundle = await this.maybeFlattenBundle(await this.expandProjectFilaments(stlFilePath, rawBundle), bambuOptions, profilesRoot);
                         // The machine preset assumes the stock hotend; record the installed one so
@@ -1297,7 +1312,7 @@ export class STLManipulator extends EventEmitter {
                         // absolute-extrusion normalization after resolving those ancestors.
                         // The machine owns the extrusion mode and layer G-code once process
                         // files lose machine keys, so normalize it there as well.
-                        if (slicerType === 'orcaslicer' && settingsBundle.settingsArg) {
+                        if (profileSlicerType === 'orcaslicer' && settingsBundle.settingsArg) {
                             const [machinePath, processPath] = settingsBundle.settingsArg.split(';');
                             settingsBundle.settingsArg = [
                                 this.writeTempJson(outputBase, 'machine_orca_resolved', this.useAbsoluteExtrusionForOrca(this.readJsonFile(machinePath))),
@@ -1305,6 +1320,17 @@ export class STLManipulator extends EventEmitter {
                             ].join(';');
                         }
                         const cliBundle = this.isolateMachineSettings(settingsBundle);
+                        if (remote) {
+                            const [machinePath, processPath] = cliBundle.settingsArg?.split(';') ?? [];
+                            if (!machinePath || !processPath)
+                                throw new Error('Remote slicing requires complete prepared machine and process profiles.');
+                            outputFilePath = await sliceWithOrcaApi({
+                                inputPath: stlFilePath, machinePath, processPath,
+                                filamentPaths: cliBundle.filamentPaths, outputPath: bambuOutputPath,
+                                options: bambuOptions, isCancelled: () => !this.activeOperations.get(operationId),
+                            });
+                            break;
+                        }
                         args = [
                             '--slice', String(bambuOptions?.slicePlate ?? 0),
                             '--outputdir', outputDir,
@@ -1360,45 +1386,47 @@ export class STLManipulator extends EventEmitter {
                 default:
                     throw new Error(`Unsupported slicer type: ${slicerType}`);
             }
-            if (progressCallback)
-                progressCallback(20, `Executing slicer: ${slicerPath} ${args.join(' ')}`);
-            console.error(`Executing: ${slicerPath} ${args.join(' ')}`);
-            // Execute the slicer
-            await new Promise((resolve, reject) => {
-                const process = execFile(slicerPath, args, (error, stdout, stderr) => {
-                    if (error) {
-                        console.error(`Slicer Error: ${error.message}`);
-                        console.error(`Slicer Stderr: ${stderr}`);
-                        reject(new Error(`Slicer failed: ${error.message}. Stderr: ${stderr}`));
-                    }
-                    else {
-                        console.error(`Slicer Stdout: ${stdout}`);
-                        if (stderr) {
-                            console.warn(`Slicer Stderr: ${stderr}`); // Log stderr even on success
+            if (slicerType !== 'orca-slicer-api') {
+                if (progressCallback)
+                    progressCallback(20, `Executing slicer: ${slicerPath} ${args.join(' ')}`);
+                console.error(`Executing: ${slicerPath} ${args.join(' ')}`);
+                // Execute the slicer
+                await new Promise((resolve, reject) => {
+                    const process = execFile(slicerPath, args, (error, stdout, stderr) => {
+                        if (error) {
+                            console.error(`Slicer Error: ${error.message}`);
+                            console.error(`Slicer Stderr: ${stderr}`);
+                            reject(new Error(`Slicer failed: ${error.message}. Stderr: ${stderr}`));
                         }
-                        resolve();
-                    }
-                });
-                // Optional: Add listeners for stdout/stderr for real-time progress if slicer provides it
-                // process.stdout?.on('data', (data) => { console.error(`Slicer stdout: ${data}`); });
-                // process.stderr?.on('data', (data) => { console.error(`Slicer stderr: ${data}`); });
-                // Check for cancellation periodically
-                const checkCancel = setInterval(() => {
-                    if (!this.activeOperations.get(operationId)) {
-                        clearInterval(checkCancel);
-                        try {
-                            process.kill(); // Attempt to kill the slicer process
-                            reject(new Error("Slicing operation cancelled"));
+                        else {
+                            console.error(`Slicer Stdout: ${stdout}`);
+                            if (stderr) {
+                                console.warn(`Slicer Stderr: ${stderr}`); // Log stderr even on success
+                            }
+                            resolve();
                         }
-                        catch (killError) {
-                            console.error("Error attempting to kill slicer process:", killError);
-                            reject(new Error("Slicing operation cancelled, but failed to kill process."));
+                    });
+                    // Optional: Add listeners for stdout/stderr for real-time progress if slicer provides it
+                    // process.stdout?.on('data', (data) => { console.error(`Slicer stdout: ${data}`); });
+                    // process.stderr?.on('data', (data) => { console.error(`Slicer stderr: ${data}`); });
+                    // Check for cancellation periodically
+                    const checkCancel = setInterval(() => {
+                        if (!this.activeOperations.get(operationId)) {
+                            clearInterval(checkCancel);
+                            try {
+                                process.kill(); // Attempt to kill the slicer process
+                                reject(new Error("Slicing operation cancelled"));
+                            }
+                            catch (killError) {
+                                console.error("Error attempting to kill slicer process:", killError);
+                                reject(new Error("Slicing operation cancelled, but failed to kill process."));
+                            }
                         }
-                    }
-                }, 500);
-                process.on('exit', () => clearInterval(checkCancel));
-                process.on('error', () => clearInterval(checkCancel)); // Ensure interval cleared on process error too
-            });
+                    }, 500);
+                    process.on('exit', () => clearInterval(checkCancel));
+                    process.on('error', () => clearInterval(checkCancel)); // Ensure interval cleared on process error too
+                });
+            }
             if (!this.activeOperations.get(operationId)) {
                 // This check might be redundant if the promise rejected on kill, but good safety
                 throw new Error("Slicing operation cancelled after process finished");

package/package.json

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

package/src/ams-mapping.ts

@@ -1,4 +1,15 @@
-export function normalizeBridgeAmsTrayValue(value: 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 function describeAmsTrayRange(options: AmsTrayValueOptions = {}): string {
+  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: unknown, label: string, options: AmsTrayValueOptions = {}): number {
   let numeric: number;
   if (typeof value === "number") {
     numeric = value;
@@ -12,10 +23,10 @@ export function normalizeBridgeAmsTrayValue(value: unknown, label: string): numb
     !Number.isInteger(numeric) ||
     numeric < -1 ||
     (numeric > 15 && numeric < 128) ||
-    numeric > 254
+    numeric > (options.dualNozzle ? 255 : 254)
   ) {
     throw new Error(
-      `${label} must be an integer in [-1, 15] (absolute tray) or 128-254 (HT/external); got ${JSON.stringify(value)}`
+      `${label} must be an integer in ${describeAmsTrayRange(options)}; got ${JSON.stringify(value)}`
     );
   }
 
@@ -27,7 +38,7 @@ function isNumericMappingKey(key: string): boolean {
   return Number.isInteger(numeric) && numeric >= 0;
 }
 
-export function normalizeAmsMappingObject(mapping: Record<string, unknown>, label = "ams_mapping"): number[] {
+export function normalizeAmsMappingObject(mapping: Record<string, unknown>, label = "ams_mapping", options: AmsTrayValueOptions = {}): number[] {
   return Object.entries(mapping)
     .sort(([leftKey], [rightKey]) => {
       const leftNumeric = isNumericMappingKey(leftKey);
@@ -37,7 +48,7 @@ export function normalizeAmsMappingObject(mapping: Record<string, unknown>, labe
       if (rightNumeric) return 1;
       return 0;
     })
-    .map(([key, value]) => normalizeBridgeAmsTrayValue(value, `${label}[${key}]`));
+    .map(([key, value]) => normalizeBridgeAmsTrayValue(value, `${label}[${key}]`, options));
 }
 
 export function hasAmsMappingInput(value: unknown): boolean {
@@ -45,3 +56,25 @@ export function hasAmsMappingInput(value: unknown): boolean {
   if (value && typeof value === "object") return Object.keys(value as Record<string, unknown>).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: number, dualNozzle = false): number {
+  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: number | undefined, dualNozzle = false): number {
+  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: number, dualNozzle = false): { ams_id: number; slot_id: number } {
+  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/src/index.ts

@@ -40,12 +40,13 @@ import {
 } 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 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 { isDualNozzleModel } from "./safety/limits.js";
 import { withPrinterOperation, withPrintSnapshot, uniquePrintName } from "./safety/artifact.js";
 import { detectProfilesRoot } from "./slicer/profile-flatten.js";
 
@@ -84,6 +85,22 @@ const DEFAULT_BAMBU_CONNECTION_MODE =
 const DEFAULT_BED_TYPE = process.env.BED_TYPE?.trim().toLowerCase() || "textured_plate";
 const DEFAULT_NOZZLE_DIAMETER = process.env.NOZZLE_DIAMETER?.trim() || "0.4";
 
+/** Bound for each Linux X2D emergency MQTT send (BAMBU_EMERGENCY_MQTT_TIMEOUT_MS, 1–60000 ms). */
+function withEmergencyMqttTimeout<T>(send: (signal: AbortSignal) => Promise<T>): Promise<T> {
+  const raw = Number(process.env.BAMBU_EMERGENCY_MQTT_TIMEOUT_MS?.trim() || 15_000);
+  const ms = Number.isInteger(raw) && raw >= 1 && raw <= 60_000 ? raw : 15_000;
+  const controller = new AbortController();
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  const timeout = new Promise<never>((_, reject) => {
+    timer = setTimeout(() => {
+      const error = new Error(`no MQTT confirmation within ${ms / 1000} s`);
+      controller.abort(error);
+      reject(error);
+    }, ms);
+  });
+  return Promise.race([Promise.resolve().then(() => send(controller.signal)), timeout]).finally(() => clearTimeout(timer));
+}
+
 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.");
@@ -703,7 +720,7 @@ function resolveSlicerConfig(args: Record<string, unknown> | undefined): {
   slicerProfile: string;
 } {
   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 };
 }
@@ -994,14 +1011,9 @@ function stringifyBridgeJson(value: unknown): string | undefined {
   return JSON.stringify(value);
 }
 
-function nativeAmsMapping2(mapping: number[] | undefined): string | undefined {
+function nativeAmsMapping2(mapping: number[] | undefined, dualNozzle = false): string | undefined {
   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: Record<string, unknown>): Record<string, unknown> {
@@ -1357,6 +1369,9 @@ class BambuPrinterMCPServer {
   ): ReturnType<typeof resolveSlicerConfig> {
     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,
@@ -1397,10 +1412,10 @@ class BambuPrinterMCPServer {
 
     console.error(`3MF has no gcode - auto-slicing with ${slicerType} for ${printModel}`);
     const autoSliceOptions: BambuSliceOptions = {
-      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),
@@ -1426,9 +1441,10 @@ class BambuPrinterMCPServer {
   ): Promise<{ useAMS: boolean; finalAmsMapping?: number[]; finalAmsSlots?: number[] }> {
     const parsed3MFData = await parse3MF(threeMFPath);
     let parsedAmsMapping: number[] | undefined;
+    const trayOptions = { dualNozzle: isDualNozzleModel(printModel) };
 
     if (parsed3MFData.slicerConfig?.ams_mapping) {
-      const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping as Record<string, unknown>);
+      const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping as Record<string, unknown>, "ams_mapping", trayOptions);
       if (slots.length > 0) {
         parsedAmsMapping = slots;
       }
@@ -1444,10 +1460,10 @@ class BambuPrinterMCPServer {
       let userMappingOverride: number[] | undefined;
       if (Array.isArray(args.ams_mapping)) {
         userMappingOverride = args.ams_mapping.map((v: unknown, i: number) =>
-          normalizeBridgeAmsTrayValue(v, `ams_mapping[${i}]`)
+          normalizeBridgeAmsTrayValue(v, `ams_mapping[${i}]`, trayOptions)
         );
       } else if (args.ams_mapping && typeof args.ams_mapping === 'object') {
-        userMappingOverride = normalizeAmsMappingObject(args.ams_mapping as Record<string, unknown>);
+        userMappingOverride = normalizeAmsMappingObject(args.ams_mapping as Record<string, unknown>, "ams_mapping", trayOptions);
       }
       if (userMappingOverride && userMappingOverride.length > 0) {
         finalAmsMapping = userMappingOverride;
@@ -1458,7 +1474,7 @@ class BambuPrinterMCPServer {
 
     if (!hasUserAmsMapping && hasUserAmsSlots) {
       const userSlots = args.ams_slots.map((slot: unknown, i: number) =>
-        normalizeBridgeAmsTrayValue(slot, `ams_slots[${i}]`)
+        normalizeBridgeAmsTrayValue(slot, `ams_slots[${i}]`, trayOptions)
       );
       finalAmsSlots = userSlots;
       finalAmsMapping = undefined;
@@ -1487,8 +1503,8 @@ 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)) {
@@ -1589,8 +1605,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 ??= 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);
@@ -1599,7 +1623,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: Record<string, unknown> = {
         dev_id: devId,
@@ -1616,7 +1640,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,
@@ -1657,7 +1681,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 as boolean,
           flowCalibration: params.task_flow_cali as boolean,
           vibrationCalibration: params.task_vibration_cali as boolean,
@@ -1916,10 +1940,9 @@ class BambuPrinterMCPServer {
       );
     }
     const autoSliceOptions: BambuSliceOptions = {
-      uptodate: true,
-      ensureOnBed: true,
-      minSave: true,
-      skipModifiedGcodes: true,
+      ...(slicerType === "orca-slicer-api" ? {} : {
+        uptodate: true, ensureOnBed: true, minSave: true, skipModifiedGcodes: true,
+      }),
       bedType,
     };
 
@@ -2470,7 +2493,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"]
             }
@@ -2573,8 +2596,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." },
@@ -3002,12 +3025,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: {
@@ -3201,12 +3224,20 @@ class BambuPrinterMCPServer {
       // again once every older helper for this printer has exited, and only
       // that send counts. Either counted route succeeding is success. macOS
       // stays native-only.
-      const linuxEmergency = (native: () => Promise<any>, mqtt: () => Promise<any>) => async () => {
+      const linuxEmergency = (native: () => Promise<any>, mqtt: (signal: AbortSignal) => Promise<any>) => async () => {
         if (process.platform !== "linux") return native();
+        // An unreachable printer makes the MQTT connect retry forever; bound each
+        // MQTT send so it cannot hold back a stop the native route already sent.
+        const immediate = withEmergencyMqttTimeout(mqtt);
         const [nativeResult, immediateResult, mqttResult] = await Promise.allSettled([
           native(),
-          mqtt(),
-          interruptNativeOperations(bambuSerial).then(() => mqtt()),
+          immediate,
+          // Finish the first attempt before reusing its cached publisher: its
+          // expiry must never close the later, counted send's transport.
+          Promise.allSettled([interruptNativeOperations(bambuSerial), immediate]).then(results => {
+            if (results[0].status === "rejected") throw results[0].reason;
+            return withEmergencyMqttTimeout(mqtt);
+          }),
         ]);
         const reason = (result: PromiseSettledResult<any>) =>
           result.status === "rejected" ? (result.reason instanceof Error ? result.reason.message : String(result.reason)) : undefined;
@@ -3480,7 +3511,7 @@ class BambuPrinterMCPServer {
                 ? linuxEmergency(
                     () => sendNativeCommand({ host, serial: bambuSerial, token: bambuToken,
                       messageJson: JSON.stringify({ print: { command: "stop", param: "", sequence_id: String(Date.now()) } }), qos: 1 }),
-                    () => this.bambu.sendStopOverMqtt(host, bambuSerial, bambuToken))
+                    signal => this.bambu.sendStopOverMqtt(host, bambuSerial, bambuToken, signal))
                 : undefined);
             break;
 
@@ -3640,7 +3671,7 @@ class BambuPrinterMCPServer {
                     const native = () => sendNativeCommand({ host, serial: bambuSerial, token: bambuToken,
                       messageJson: buildBambuNativeTemperatureCommand(heater, target).messageJson }, { signal: extra.signal, assertActive, beforeDispatch });
                     return target === 0
-                      ? linuxEmergency(native, () => this.bambu.sendHeaterOffOverMqtt(host, bambuSerial, bambuToken, heater))()
+                      ? linuxEmergency(native, signal => this.bambu.sendHeaterOffOverMqtt(host, bambuSerial, bambuToken, heater, signal))()
                       : native();
                   }
                 : undefined
@@ -4098,10 +4129,9 @@ class BambuPrinterMCPServer {
               }
               console.error(`3MF has no gcode — auto-slicing with ${slicerType} for ${printModel}`);
               const autoSliceOptions: BambuSliceOptions = {
-                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),
@@ -4133,9 +4163,10 @@ class BambuPrinterMCPServer {
 
             const parsed3MFData = await parse3MF(threeMFPath);
             const isH2Print = H2_BAMBU_MODELS.has(printModel);
+            const trayOptions = { dualNozzle: isDualNozzleModel(printModel) };
             let parsedAmsMapping: number[] | undefined;
             if (!isH2Print && parsed3MFData.slicerConfig?.ams_mapping) {
-              const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping as Record<string, unknown>);
+              const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping as Record<string, unknown>, "ams_mapping", trayOptions);
               if (slots.length > 0) {
                 parsedAmsMapping = slots;
               }
@@ -4151,10 +4182,10 @@ class BambuPrinterMCPServer {
               let userMappingOverride: number[] | undefined;
               if (Array.isArray(args.ams_mapping)) {
                 userMappingOverride = args.ams_mapping.map((v: unknown, i: number) =>
-                  normalizeBridgeAmsTrayValue(v, `ams_mapping[${i}]`)
+                  normalizeBridgeAmsTrayValue(v, `ams_mapping[${i}]`, trayOptions)
                 );
               } else if (args.ams_mapping && typeof args.ams_mapping === 'object') {
-                userMappingOverride = normalizeAmsMappingObject(args.ams_mapping as Record<string, unknown>);
+                userMappingOverride = normalizeAmsMappingObject(args.ams_mapping as Record<string, unknown>, "ams_mapping", trayOptions);
               }
               if (userMappingOverride && userMappingOverride.length > 0) {
                 finalAmsMapping = userMappingOverride;
@@ -4208,8 +4239,8 @@ 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)) {