mcp-3d-printer-server 1.2.28 → 1.2.30

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.2.30] – 2026-11-04
+
+### Added
+
+- `slice_stl` and `slice_with_template` take `quality` (`draft`, `standard`, `fine`) and `strength` (`standard`, `strong`, `max`). The server turns them into the slicer's own settings: Draft and Fine set the layer height for the nozzle in use (0.28 and 0.12 mm on a 0.4 mm nozzle, scaled with it), Strong and Max set walls and infill (4 walls at 25%, 6 at 40%), and Standard leaves the resolved preset alone. An explicit `layer_height`, `wall_loops` or `sparse_infill_density` still wins. Clients such as Counterpart can now send the person's choice instead of carrying slicer numbers. Checked with stand-in slicers only. For PrusaSlicer, Slic3r and generic OrcaSlicer the layer height scales with `nozzle_diameter` (or `NOZZLE_DIAMETER`), which must match the profile's nozzle; Cura takes only Standard. Same change as bambu-printer-mcp 1.1.56.
+
+## [1.2.29] – 2026-11-04
+
+### Changed
+
+- With no method given, a FULU print over Bambu Cloud goes the way Bambu Studio sends it to a cloud-bound printer it can reach on the LAN (`PrintJob.cpp`): `start_local_print_with_record`, which uploads to the printer over the LAN and records the task in the account, in the account's cloud session. When that fails before the print command (the plug-in's `-2010` to `-2140` preparation results, other than a missing or oversized file), the same checked job goes once through `start_print`, with the printer checked again first. Any other failure may have reached the printer and is not sent again. A printer that reports no storage goes straight to `start_print`, as in Studio. Same change as bambu-printer-mcp 1.1.55. On a P1S with firmware 01.10.00.00, `start_print` alone returns `-3120`, HTTP 403 "internal blocking", every time. Errors name `-2120`, `-2130` and `-3120`. Checked with the stand-in host and intercepted transports only; not yet on a printer.
+
 ## [1.2.28] – 2026-11-04
 
 ### Added

package/README.md

@@ -688,6 +688,8 @@ Options for the Bambu-compatible path:
 | `scale`, `rotate`, `rotate_x`, `rotate_y` | Transform before slicing (uniform scale; rotations in degrees). For OrcaSlicer STL input the server applies them to a mesh copy in Orca's order to avoid a CLI crash; see [OrcaSlicer CLI limits](https://github.com/DMontgomery40/mcp-3D-printer-server/blob/main/docs/SLICING.md#bambu-compatible-slicing) |
 | `enable_timelapse`, `allow_mix_temp` | Insert timelapse parking moves; allow filaments with different temperature needs on one plate |
 
+`slice_stl` and `slice_with_template` take `quality` (`draft`, `standard`, `fine`) and `strength` (`standard`, `strong`, `max`), so a client can send the person's choice without slicer numbers. The server picks the layer height for the nozzle (0.28 and 0.12 mm on a 0.4 mm nozzle; it scales with `nozzle_diameter`, or `NOZZLE_DIAMETER` when that's not given, which for PrusaSlicer, Slic3r and generic OrcaSlicer must match the nozzle in `slicer_profile`) and the walls and infill (4 walls at 25%, 6 at 40%). Standard keeps the preset; explicit values win. Cura takes only Standard.
+
 `layer_height` (mm), `wall_loops` (a whole number), and `sparse_infill_density` (such as `"15%"`) are written over the selected profile on every slicer: as the process keys `layer_height`, `wall_loops`, and `sparse_infill_density` for Bambu Studio and OrcaSlicer, and as `--layer-height`, `--perimeters`, and `--fill-density` for PrusaSlicer and Slic3r. They win over a template. Cura refuses them; set them in its definition file. Your profile files are never modified.
 
 `enable_support` (true or false), `support_type` (`normal(auto)`, `tree(auto)`, `normal(manual)` or `tree(manual)`) and `support_threshold_angle` (0 to 90 degrees; 0 lets the slicer decide) are written over the selected process profile as the same-named Bambu Studio and OrcaSlicer keys. PrusaSlicer, Slic3r and Cura refuse them; set supports in their own profile.

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

@@ -186,10 +186,16 @@ export declare class BambuNetworkBridge {
      * Shares the LAN session queue: one reader of the plug-in's events at a time.
      */
     withCloudSession<T>(devId: string, options: BambuNetworkBridgeOptions, assertActive: () => void, timing: Readonly<CloudTiming>, run: (session: CloudSession) => Promise<T>): Promise<T>;
-    /** A cloud print method (start_print) in a cloud session, so the plug-in has the printer's state. */
-    startCloudPrint(devId: string, method: string, payload: JsonObject, options?: BambuNetworkBridgeOptions, assertActive?: () => void, timing?: Readonly<CloudTiming>): Promise<{
+    /**
+     * A cloud print in a cloud session, so the plug-in has the printer's state. With a fallback this is
+     * Bambu Studio's order for a cloud-bound printer it can also reach on the LAN (PrintJob.cpp,
+     * SendAttemptRoute::LanWithRecord, then ::Cloud): start_local_print_with_record, then start_print
+     * when the first failed before its print command was sent. `firstFailure` is the first method's result.
+     */
+    startCloudPrint(devId: string, method: string, payload: JsonObject, options?: BambuNetworkBridgeOptions, assertActive?: () => void, timing?: Readonly<CloudTiming>, fallbackMethod?: string): Promise<{
         result: unknown;
         jobUpdates: BridgeJobUpdate[];
+        firstFailure?: number;
     }>;
     /**
      * A print control over Bambu Cloud: how Bambu Studio and FULU's slicer control a printer

package/dist/bambu-network-bridge.js

@@ -21,8 +21,16 @@ const DEFAULT_REQUEST_TIMEOUT_MS = 120000;
 const LOCAL_CONNECT_STATUS = ["ok", "failed", "lost"];
 // bambu_networking.hpp BAMBU_NETWORK_ERR_PRINT_LP_PUBLISH_MSG_FAILED.
 const LOCAL_PRINT_PUBLISH_FAILED = -4030;
+// A with-record send falls back to start_print only on its own preparation failures (the plug-in's
+// PRINT_WR_* results, -2010 to -2140: project, upload, task record, FTPS), which come before the print
+// command, so the printer has no job. Any other result may have reached the printer and is never
+// replayed. Of those, Studio also stops on a file missing or too large (should_stop_without_fallback).
+const WITH_RECORD_PREPARATION_FAILURE = (value) => value <= -2010 && value >= -2140 && value !== -2040 && value !== -2100;
 // bambu_networking.hpp print errors that name a recoverable cause.
 const BAMBU_NETWORK_PRINT_ERRORS = {
+    [-2120]: "Bambu Cloud refused to create the print task",
+    [-2130]: "FTPS upload to the printer failed",
+    [-3120]: "Bambu Cloud refused to create the print task",
     [-4010]: "the file exceeds the 1 GB upload limit",
     [-4020]: "FTPS upload to the printer failed",
     [LOCAL_PRINT_PUBLISH_FAILED]: "the networking plug-in could not send the print command to the printer over MQTT",
@@ -703,9 +711,23 @@ export class BambuNetworkBridge {
             release();
         }
     }
-    /** A cloud print method (start_print) in a cloud session, so the plug-in has the printer's state. */
-    async startCloudPrint(devId, method, payload, options = {}, assertActive = () => { }, timing = CLOUD_PRINT_TIMING) {
-        return await this.withCloudSession(devId, options, assertActive, timing, async (session) => ({ result: await this.callWithAgent(method, payload, options), jobUpdates: session.jobUpdates }));
+    /**
+     * A cloud print in a cloud session, so the plug-in has the printer's state. With a fallback this is
+     * Bambu Studio's order for a cloud-bound printer it can also reach on the LAN (PrintJob.cpp,
+     * SendAttemptRoute::LanWithRecord, then ::Cloud): start_local_print_with_record, then start_print
+     * when the first failed before its print command was sent. `firstFailure` is the first method's result.
+     */
+    async startCloudPrint(devId, method, payload, options = {}, assertActive = () => { }, timing = CLOUD_PRINT_TIMING, fallbackMethod) {
+        return await this.withCloudSession(devId, options, assertActive, timing, async (session) => {
+            const result = await this.callWithAgent(method, payload, options);
+            const value = bridgeNumericResult(result);
+            if (!fallbackMethod || value === undefined || !WITH_RECORD_PREPARATION_FAILURE(value))
+                return { result, jobUpdates: session.jobUpdates };
+            options.trace?.({ step: "fallback", from: method, to: fallbackMethod, result: value });
+            const params = payload.params;
+            const fallbackPayload = params ? { ...payload, params: { ...params, comments: `failed(${value})` } } : payload;
+            return { result: await this.callWithAgent(fallbackMethod, fallbackPayload, options), jobUpdates: session.jobUpdates, firstFailure: value };
+        });
     }
     /**
      * A print control over Bambu Cloud: how Bambu Studio and FULU's slicer control a printer

package/dist/index.js

@@ -19,6 +19,7 @@ import * as THREE from 'three';
 import { PrinterFactory } from "./printers/printer-factory.js";
 import { STLManipulator, SUPPORT_TYPES } from "./stl/stl-manipulator.js";
 import { parsePauseLayers, readPlateGcode, pausedLayers, machinePauseGcode } from "./slicer/layer-pauses.js";
+import { PRINT_QUALITY_PROPERTIES, withPrintQuality } from "./slicer/print-quality.js";
 import { CounterpartService } from "./counterpart/service.js";
 import { CAMERA_STREAM_TOOLS } from "./counterpart/camera-tools.js";
 import { annotateTools } from "./tool-annotations.js";
@@ -34,7 +35,7 @@ import { BambuNetworkBridge, describeBambuNetworkPrintError } from "./bambu-netw
 import { PRINT_ROUTES, connectionForRoute, routeOf, routeOptions, writeEnvValues } from "./counterpart/route.js";
 import { resolveStudioPrintOptions, usedNozzleCount } from "./studio-print-options.js";
 import { inspectPrintFile } from "./safety/print-file.js";
-import { validatePrinterState } from "./safety/printer-state.js";
+import { externalStorageState, validatePrinterState } from "./safety/printer-state.js";
 import { uniquePrintName, withPrinterOperation, withPrintSnapshot } from "./safety/artifact.js";
 import { checkedFile } from "./printers/bambu.js";
 import { CONFIRMATION_UNAVAILABLE, confirmationTimedOut, confirmationTimeoutMs } from "./safety/confirmation.js";
@@ -306,6 +307,7 @@ const SLICE_TOOL_PROPERTIES = {
     min_save: { type: "boolean", description: "Bambu-compatible slicing: write a smaller output 3MF (--min-save)." },
     skip_modified_gcodes: { type: "boolean", description: "Bambu-compatible slicing: ignore custom G-code embedded in an input 3MF (--skip-modified-gcodes)." },
     slice_plate: { type: "number", description: "Bambu-compatible slicing: plate number to slice; 0 slices all plates (default)." },
+    ...PRINT_QUALITY_PROPERTIES,
     layer_height: {
         type: "number", exclusiveMinimum: 0, maximum: 2,
         description: "Layer height in mm, written over the selected process profile (Orca/Bambu Studio layer_height; PrusaSlicer --layer-height). Not mapped for Cura.",
@@ -748,7 +750,7 @@ class ThreeDPrinterMCPServer {
         if (!args?.stl_path) {
             throw new Error("Missing required parameter: stl_path");
         }
-        const processOverrides = parseProcessOverrides(args);
+        const processOverrides = parseProcessOverrides(withPrintQuality(args, Number(args.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER)));
         const slicerType = normalizeSlicerType(String(args.slicer_type || DEFAULT_SLICER_TYPE));
         const explicitModel = typeof args.bambu_model === "string" && args.bambu_model.trim() ? args.bambu_model : undefined;
         // Generic OrcaSlicer keeps its user-supplied machine profile unless the
@@ -881,8 +883,10 @@ class ThreeDPrinterMCPServer {
             throw new Error("FULU BambuNetwork printing requires bambu_serial, the printer host and its LAN access code: fresh printer state is checked over MQTT before every bridge print, including cloud dispatch.");
         }
         const isLocalBridgePrint = connectionType === "lan";
-        const bridgePrintMethod = isLocalBridgePrint ? "start_local_print" : "start_print";
-        const bridgeMethod = `net.${bridgePrintMethod}`;
+        // Bambu Studio sends a cloud-bound printer it can reach on the LAN with record first, in the cloud
+        // session, then start_print (PrintJob.cpp). This server always has the printer's IP and access code.
+        let bridgeMethod = isLocalBridgePrint ? "net.start_local_print" : "net.start_local_print_with_record";
+        let cloudFallbackMethod = isLocalBridgePrint ? undefined : "net.start_print";
         const { plateIndex } = options;
         const threeMfFilename = path.basename(options.threeMFPath);
         const projectName = threeMfFilename.replace(/\.3mf$/i, "");
@@ -923,6 +927,11 @@ class ThreeDPrinterMCPServer {
             validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
             const confirmedStatus = await bambu.getSafetyStatus(devIp, devId, password);
             validatePrinterState(confirmedStatus, requirements);
+            if (cloudFallbackMethod && externalStorageState(confirmedStatus.raw) !== "normal") {
+                // Studio sends straight through the cloud when the printer has no storage for the LAN upload.
+                bridgeMethod = cloudFallbackMethod;
+                cloudFallbackMethod = undefined;
+            }
             const wireMapping = mapping.map((value) => bridgeAmsMappingValue(value, dualNozzle));
             const remoteFileName = uniquePrintName(options.threeMFPath);
             const checkedName = remoteFileName.replace(/(?:\.gcode)?\.3mf$/i, "");
@@ -979,23 +988,29 @@ class ThreeDPrinterMCPServer {
             const bridgeOptions = {
                 // Trusted in-process preflight immediately before the print frame.
                 beforeDispatch: async (method) => {
-                    if (method !== bridgeMethod)
+                    if (method !== bridgeMethod && method !== cloudFallbackMethod)
                         return;
                     assertActive();
                     validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
                 },
-                assertDispatchAllowed: (method) => { if (method === bridgeMethod)
+                assertDispatchAllowed: (method) => { if (method === bridgeMethod || method === cloudFallbackMethod)
                     assertActive(); },
-                onDispatched: (method) => { if (method === bridgeMethod)
+                onDispatched: (method) => { if (method === bridgeMethod || method === cloudFallbackMethod)
                     retainForDispatchedUpload(); },
             };
             let jobUpdates = [];
             let bridgeResult;
+            let firstAttempt = "";
             if (isLocalBridgePrint) {
                 ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startLocalPrint({ devId, devIp, username: "bblp", password, useSsl: true }, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive));
             }
             else {
-                ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive));
+                let firstFailure;
+                ({ result: bridgeResult, jobUpdates, firstFailure } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive, undefined, cloudFallbackMethod));
+                if (firstFailure !== undefined) {
+                    bridgeMethod = cloudFallbackMethod;
+                    firstAttempt = ` It first tried net.start_local_print_with_record, as Bambu Studio does, which returned ${firstFailure}${describeBambuNetworkPrintError(firstFailure)}.`;
+                }
             }
             if (typeof bridgeResult === "object" && bridgeResult !== null && bridgeResult.ok === false) {
                 throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} failed: ${String(bridgeResult.error || "unknown bridge error")}`);
@@ -1005,14 +1020,14 @@ class ThreeDPrinterMCPServer {
                 const reported = jobUpdates.filter((update) => update.code !== 0 || update.msg).slice(-3)
                     .map((update) => `status ${update.status}, code ${update.code}${update.msg ? `: ${update.msg}` : ""}`).join("; ");
                 throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} returned non-zero result ${value}${describeBambuNetworkPrintError(value)}.` +
-                    (reported ? ` Plug-in reported: ${reported}.` : ""));
+                    (reported ? ` Plug-in reported: ${reported}.` : "") + firstAttempt);
             }
             assertActive();
             // Bambu's plug-in placed the file, so a resume re-reads it if it can and otherwise asks a person.
             bambu.recordCheckedJob(devIp, devId, remoteFileName, requirements, resumeFile, false);
             return {
                 status: "success",
-                message: `FULU BambuNetwork ${bridgePrintMethod} command for ${threeMfFilename} sent successfully.`,
+                message: `FULU BambuNetwork ${bridgeMethod.replace(/^net\./, "")} command for ${threeMfFilename} sent successfully.${firstAttempt}`,
                 connectionMode: "bambu_network",
                 connectionType,
                 bridgeMethod,

package/dist/slicer/print-quality.d.ts

@@ -0,0 +1,26 @@
+/**
+ * slice_stl's `quality` and `strength` (PRD §8.4): a client's print-sheet choice, mapped here to the
+ * slicer's own numbers so no client carries layer heights, wall counts or infill. Draft and Fine set
+ * the layer height for the nozzle in use (0.28 and 0.12 mm on a 0.4 mm nozzle, scaled with it); Strong
+ * and Max set walls and infill. Standard sends nothing: the resolved preset decides. An explicit
+ * layer_height, wall_loops or sparse_infill_density in the same call wins over these.
+ */
+export declare const PRINT_QUALITIES: readonly ["draft", "standard", "fine"];
+export declare const PRINT_STRENGTHS: readonly ["standard", "strong", "max"];
+export type PrintQuality = (typeof PRINT_QUALITIES)[number];
+export type PrintStrength = (typeof PRINT_STRENGTHS)[number];
+/** The call's arguments with `quality` and `strength` written out as slicer settings. */
+export declare function withPrintQuality(args: Record<string, unknown>, nozzleDiameter?: number): Record<string, unknown>;
+/** slice_stl input-schema properties for both arguments. */
+export declare const PRINT_QUALITY_PROPERTIES: {
+    readonly quality: {
+        readonly type: "string";
+        readonly enum: readonly ["draft", "standard", "fine"];
+        readonly description: "Print quality: draft (thicker layers, faster), standard (the preset's own layer height) or fine (thinner layers). The server picks the layer height for the nozzle in use; an explicit layer_height wins.";
+    };
+    readonly strength: {
+        readonly type: "string";
+        readonly enum: readonly ["standard", "strong", "max"];
+        readonly description: "Part strength: standard (the preset's walls and infill), strong or max (more walls and denser infill). The server picks the values; explicit wall_loops or sparse_infill_density win.";
+    };
+};

package/dist/slicer/print-quality.js

@@ -0,0 +1,53 @@
+/**
+ * slice_stl's `quality` and `strength` (PRD §8.4): a client's print-sheet choice, mapped here to the
+ * slicer's own numbers so no client carries layer heights, wall counts or infill. Draft and Fine set
+ * the layer height for the nozzle in use (0.28 and 0.12 mm on a 0.4 mm nozzle, scaled with it); Strong
+ * and Max set walls and infill. Standard sends nothing: the resolved preset decides. An explicit
+ * layer_height, wall_loops or sparse_infill_density in the same call wins over these.
+ */
+export const PRINT_QUALITIES = ["draft", "standard", "fine"];
+export const PRINT_STRENGTHS = ["standard", "strong", "max"];
+/** Layer heights on the reference 0.4 mm nozzle; other nozzles scale from it. */
+const REFERENCE_NOZZLE_MM = 0.4;
+const LAYER_MM_ON_REFERENCE = { draft: 0.28, fine: 0.12 };
+const STRENGTH = {
+    strong: { wall_loops: 4, sparse_infill_density: "25%" },
+    max: { wall_loops: 6, sparse_infill_density: "40%" },
+};
+/** The call's arguments with `quality` and `strength` written out as slicer settings. */
+export function withPrintQuality(args, nozzleDiameter) {
+    if (args.quality === undefined && args.strength === undefined)
+        return args;
+    const quality = args.quality === undefined ? "standard" : args.quality;
+    const strength = args.strength === undefined ? "standard" : args.strength;
+    if (typeof quality !== "string" || !PRINT_QUALITIES.includes(quality)) {
+        throw new Error(`quality must be one of ${PRINT_QUALITIES.join(", ")}.`);
+    }
+    if (typeof strength !== "string" || !PRINT_STRENGTHS.includes(strength)) {
+        throw new Error(`strength must be one of ${PRINT_STRENGTHS.join(", ")}.`);
+    }
+    const out = { ...args };
+    const scale = typeof nozzleDiameter === "number" && Number.isFinite(nozzleDiameter) && nozzleDiameter > 0 ? nozzleDiameter / REFERENCE_NOZZLE_MM : 1;
+    const layer = LAYER_MM_ON_REFERENCE[quality];
+    if (layer !== undefined && out.layer_height === undefined)
+        out.layer_height = Math.round(layer * scale * 100) / 100;
+    const walls = STRENGTH[strength];
+    if (walls) {
+        if (out.wall_loops === undefined)
+            out.wall_loops = walls.wall_loops;
+        if (out.sparse_infill_density === undefined)
+            out.sparse_infill_density = walls.sparse_infill_density;
+    }
+    return out;
+}
+/** slice_stl input-schema properties for both arguments. */
+export const PRINT_QUALITY_PROPERTIES = {
+    quality: {
+        type: "string", enum: [...PRINT_QUALITIES],
+        description: "Print quality: draft (thicker layers, faster), standard (the preset's own layer height) or fine (thinner layers). The server picks the layer height for the nozzle in use; an explicit layer_height wins.",
+    },
+    strength: {
+        type: "string", enum: [...PRINT_STRENGTHS],
+        description: "Part strength: standard (the preset's walls and infill), strong or max (more walls and denser infill). The server picks the values; explicit wall_loops or sparse_infill_density win.",
+    },
+};

package/dist/stl/stl-manipulator.js

@@ -1019,7 +1019,7 @@ export class STLManipulator extends EventEmitter {
                         break;
                     case 'cura':
                         if (Object.keys(orcaProcessOverrides(processOverrides)).length) {
-                            throw new SlicerError('preparation', 'layer_height, wall_loops, sparse_infill_density and the support settings are not mapped for Cura; set them in the Cura definition passed as slicer_profile.', { slicerType, slicerPath });
+                            throw new SlicerError('preparation', 'quality, strength, layer_height, wall_loops, sparse_infill_density and the support settings are not mapped for Cura; set them in the Cura definition passed as slicer_profile.', { slicerType, slicerPath });
                         }
                         // CuraEngine CLI args are different, often requiring -s for settings
                         // Example: curaengine slice -v -j cura_settings.json -s layer_height=0.2 -o output.gcode -l input.stl

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "mcp-3d-printer-server",
     "mcpName": "io.github.DMontgomery40/mcp-3d-printer-server",
-    "version": "1.2.28",
+    "version": "1.2.30",
     "description": "MCP server for connecting Claude with 3D printer management systems",
     "main": "dist/index.js",
     "repository": "https://github.com/DMontgomery40/mcp-3D-printer-server",

package/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/DMontgomery40/mcp-3D-printer-server",
     "source": "github"
   },
-  "version": "1.2.28",
+  "version": "1.2.30",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "mcp-3d-printer-server",
-      "version": "1.2.28",
+      "version": "1.2.30",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/src/bambu-network-bridge.ts

@@ -23,8 +23,16 @@ const DEFAULT_REQUEST_TIMEOUT_MS = 120_000;
 const LOCAL_CONNECT_STATUS = ["ok", "failed", "lost"];
 // bambu_networking.hpp BAMBU_NETWORK_ERR_PRINT_LP_PUBLISH_MSG_FAILED.
 const LOCAL_PRINT_PUBLISH_FAILED = -4030;
+// A with-record send falls back to start_print only on its own preparation failures (the plug-in's
+// PRINT_WR_* results, -2010 to -2140: project, upload, task record, FTPS), which come before the print
+// command, so the printer has no job. Any other result may have reached the printer and is never
+// replayed. Of those, Studio also stops on a file missing or too large (should_stop_without_fallback).
+const WITH_RECORD_PREPARATION_FAILURE = (value: number) => value <= -2010 && value >= -2140 && value !== -2040 && value !== -2100;
 // bambu_networking.hpp print errors that name a recoverable cause.
 const BAMBU_NETWORK_PRINT_ERRORS: Record<number, string> = {
+  [-2120]: "Bambu Cloud refused to create the print task",
+  [-2130]: "FTPS upload to the printer failed",
+  [-3120]: "Bambu Cloud refused to create the print task",
   [-4010]: "the file exceeds the 1 GB upload limit",
   [-4020]: "FTPS upload to the printer failed",
   [LOCAL_PRINT_PUBLISH_FAILED]: "the networking plug-in could not send the print command to the printer over MQTT",
@@ -853,10 +861,24 @@ export class BambuNetworkBridge {
     }
   }
 
-  /** A cloud print method (start_print) in a cloud session, so the plug-in has the printer's state. */
+  /**
+   * A cloud print in a cloud session, so the plug-in has the printer's state. With a fallback this is
+   * Bambu Studio's order for a cloud-bound printer it can also reach on the LAN (PrintJob.cpp,
+   * SendAttemptRoute::LanWithRecord, then ::Cloud): start_local_print_with_record, then start_print
+   * when the first failed before its print command was sent. `firstFailure` is the first method's result.
+   */
   async startCloudPrint(devId: string, method: string, payload: JsonObject, options: BambuNetworkBridgeOptions = {},
-    assertActive: () => void = () => {}, timing: Readonly<CloudTiming> = CLOUD_PRINT_TIMING): Promise<{ result: unknown; jobUpdates: BridgeJobUpdate[] }> {
-    return await this.withCloudSession(devId, options, assertActive, timing, async session => ({ result: await this.callWithAgent(method, payload, options), jobUpdates: session.jobUpdates }));
+    assertActive: () => void = () => {}, timing: Readonly<CloudTiming> = CLOUD_PRINT_TIMING, fallbackMethod?: string
+  ): Promise<{ result: unknown; jobUpdates: BridgeJobUpdate[]; firstFailure?: number }> {
+    return await this.withCloudSession(devId, options, assertActive, timing, async session => {
+      const result = await this.callWithAgent(method, payload, options);
+      const value = bridgeNumericResult(result);
+      if (!fallbackMethod || value === undefined || !WITH_RECORD_PREPARATION_FAILURE(value)) return { result, jobUpdates: session.jobUpdates };
+      options.trace?.({ step: "fallback", from: method, to: fallbackMethod, result: value });
+      const params = (payload as { params?: JsonObject }).params;
+      const fallbackPayload = params ? { ...payload, params: { ...params, comments: `failed(${value})` } } : payload;
+      return { result: await this.callWithAgent(fallbackMethod, fallbackPayload, options), jobUpdates: session.jobUpdates, firstFailure: value };
+    });
   }
 
   /**

package/src/index.ts

@@ -36,6 +36,7 @@ import * as THREE from 'three';
 import { PrinterFactory } from "./printers/printer-factory.js";
 import { STLManipulator, SUPPORT_TYPES, type BambuSliceOptions, type ProcessOverrides, type SliceOutput } from "./stl/stl-manipulator.js";
 import { parsePauseLayers, readPlateGcode, pausedLayers, machinePauseGcode } from "./slicer/layer-pauses.js";
+import { PRINT_QUALITY_PROPERTIES, withPrintQuality } from "./slicer/print-quality.js";
 import { CounterpartService, type BambuControlRoute, type PrinterTarget } from "./counterpart/service.js";
 import {CAMERA_STREAM_TOOLS} from "./counterpart/camera-tools.js";
 import { annotateTools } from "./tool-annotations.js";
@@ -75,7 +76,7 @@ import { BambuNetworkBridge, describeBambuNetworkPrintError, type BridgeJobUpdat
 import { PRINT_ROUTES, connectionForRoute, routeOf, routeOptions, writeEnvValues, type PrintRoute } from "./counterpart/route.js";
 import { resolveStudioPrintOptions, usedNozzleCount, type CallerPrintOptions } from "./studio-print-options.js";
 import { inspectPrintFile } from "./safety/print-file.js";
-import { validatePrinterState } from "./safety/printer-state.js";
+import { externalStorageState, validatePrinterState } from "./safety/printer-state.js";
 import { uniquePrintName, withPrinterOperation, withPrintSnapshot } from "./safety/artifact.js";
 import { checkedFile } from "./printers/bambu.js";
 import { CONFIRMATION_UNAVAILABLE, confirmationTimedOut, confirmationTimeoutMs } from "./safety/confirmation.js";
@@ -384,6 +385,7 @@ const SLICE_TOOL_PROPERTIES = {
   min_save: { type: "boolean", description: "Bambu-compatible slicing: write a smaller output 3MF (--min-save)." },
   skip_modified_gcodes: { type: "boolean", description: "Bambu-compatible slicing: ignore custom G-code embedded in an input 3MF (--skip-modified-gcodes)." },
   slice_plate: { type: "number", description: "Bambu-compatible slicing: plate number to slice; 0 slices all plates (default)." },
+  ...PRINT_QUALITY_PROPERTIES,
   layer_height: {
     type: "number", exclusiveMinimum: 0, maximum: 2,
     description: "Layer height in mm, written over the selected process profile (Orca/Bambu Studio layer_height; PrusaSlicer --layer-height). Not mapped for Cura.",
@@ -904,7 +906,7 @@ class ThreeDPrinterMCPServer {
     if (!args?.stl_path) {
       throw new Error("Missing required parameter: stl_path");
     }
-    const processOverrides = parseProcessOverrides(args);
+    const processOverrides = parseProcessOverrides(withPrintQuality(args, Number(args.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER)));
     const slicerType = normalizeSlicerType(String(args.slicer_type || DEFAULT_SLICER_TYPE));
     const explicitModel =
       typeof args.bambu_model === "string" && args.bambu_model.trim() ? args.bambu_model : undefined;
@@ -1074,8 +1076,10 @@ class ThreeDPrinterMCPServer {
       throw new Error("FULU BambuNetwork printing requires bambu_serial, the printer host and its LAN access code: fresh printer state is checked over MQTT before every bridge print, including cloud dispatch.");
     }
     const isLocalBridgePrint = connectionType === "lan";
-    const bridgePrintMethod = isLocalBridgePrint ? "start_local_print" : "start_print";
-    const bridgeMethod = `net.${bridgePrintMethod}`;
+    // Bambu Studio sends a cloud-bound printer it can reach on the LAN with record first, in the cloud
+    // session, then start_print (PrintJob.cpp). This server always has the printer's IP and access code.
+    let bridgeMethod = isLocalBridgePrint ? "net.start_local_print" : "net.start_local_print_with_record";
+    let cloudFallbackMethod = isLocalBridgePrint ? undefined : "net.start_print";
     const { plateIndex } = options;
     const threeMfFilename = path.basename(options.threeMFPath);
     const projectName = threeMfFilename.replace(/\.3mf$/i, "");
@@ -1116,6 +1120,11 @@ class ThreeDPrinterMCPServer {
       validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
       const confirmedStatus = await bambu.getSafetyStatus(devIp, devId, password);
       validatePrinterState(confirmedStatus, requirements);
+      if (cloudFallbackMethod && externalStorageState(confirmedStatus.raw) !== "normal") {
+        // Studio sends straight through the cloud when the printer has no storage for the LAN upload.
+        bridgeMethod = cloudFallbackMethod;
+        cloudFallbackMethod = undefined;
+      }
       const wireMapping = mapping!.map((value) => bridgeAmsMappingValue(value, dualNozzle));
       const remoteFileName = uniquePrintName(options.threeMFPath);
       const checkedName = remoteFileName.replace(/(?:\.gcode)?\.3mf$/i, "");
@@ -1172,22 +1181,28 @@ class ThreeDPrinterMCPServer {
       const bridgeOptions = {
         // Trusted in-process preflight immediately before the print frame.
         beforeDispatch: async (method: string) => {
-          if (method !== bridgeMethod) return;
+          if (method !== bridgeMethod && method !== cloudFallbackMethod) return;
           assertActive();
           validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
         },
-        assertDispatchAllowed: (method: string) => { if (method === bridgeMethod) assertActive(); },
-        onDispatched: (method: string) => { if (method === bridgeMethod) retainForDispatchedUpload(); },
+        assertDispatchAllowed: (method: string) => { if (method === bridgeMethod || method === cloudFallbackMethod) assertActive(); },
+        onDispatched: (method: string) => { if (method === bridgeMethod || method === cloudFallbackMethod) retainForDispatchedUpload(); },
       };
       let jobUpdates: BridgeJobUpdate[] = [];
       let bridgeResult: unknown;
+      let firstAttempt = "";
       if (isLocalBridgePrint) {
         ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startLocalPrint(
           { devId, devIp, username: "bblp", password, useSsl: true },
           bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive
         ));
       } else {
-        ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive));
+        let firstFailure: number | undefined;
+        ({ result: bridgeResult, jobUpdates, firstFailure } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive, undefined, cloudFallbackMethod));
+        if (firstFailure !== undefined) {
+          bridgeMethod = cloudFallbackMethod!;
+          firstAttempt = ` It first tried net.start_local_print_with_record, as Bambu Studio does, which returned ${firstFailure}${describeBambuNetworkPrintError(firstFailure)}.`;
+        }
       }
       if (typeof bridgeResult === "object" && bridgeResult !== null && (bridgeResult as { ok?: unknown }).ok === false) {
         throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} failed: ${String((bridgeResult as { error?: unknown }).error || "unknown bridge error")}`);
@@ -1197,14 +1212,14 @@ class ThreeDPrinterMCPServer {
         const reported = jobUpdates.filter((update) => update.code !== 0 || update.msg).slice(-3)
           .map((update) => `status ${update.status}, code ${update.code}${update.msg ? `: ${update.msg}` : ""}`).join("; ");
         throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} returned non-zero result ${value}${describeBambuNetworkPrintError(value)}.` +
-          (reported ? ` Plug-in reported: ${reported}.` : ""));
+          (reported ? ` Plug-in reported: ${reported}.` : "") + firstAttempt);
       }
       assertActive();
       // Bambu's plug-in placed the file, so a resume re-reads it if it can and otherwise asks a person.
       bambu.recordCheckedJob(devIp, devId, remoteFileName, requirements, resumeFile, false);
       return {
         status: "success",
-        message: `FULU BambuNetwork ${bridgePrintMethod} command for ${threeMfFilename} sent successfully.`,
+        message: `FULU BambuNetwork ${bridgeMethod.replace(/^net\./, "")} command for ${threeMfFilename} sent successfully.${firstAttempt}`,
         connectionMode: "bambu_network",
         connectionType,
         bridgeMethod,

package/src/slicer/print-quality.ts

@@ -0,0 +1,55 @@
+/**
+ * slice_stl's `quality` and `strength` (PRD §8.4): a client's print-sheet choice, mapped here to the
+ * slicer's own numbers so no client carries layer heights, wall counts or infill. Draft and Fine set
+ * the layer height for the nozzle in use (0.28 and 0.12 mm on a 0.4 mm nozzle, scaled with it); Strong
+ * and Max set walls and infill. Standard sends nothing: the resolved preset decides. An explicit
+ * layer_height, wall_loops or sparse_infill_density in the same call wins over these.
+ */
+export const PRINT_QUALITIES = ["draft", "standard", "fine"] as const;
+export const PRINT_STRENGTHS = ["standard", "strong", "max"] as const;
+
+export type PrintQuality = (typeof PRINT_QUALITIES)[number];
+export type PrintStrength = (typeof PRINT_STRENGTHS)[number];
+
+/** Layer heights on the reference 0.4 mm nozzle; other nozzles scale from it. */
+const REFERENCE_NOZZLE_MM = 0.4;
+const LAYER_MM_ON_REFERENCE: Partial<Record<PrintQuality, number>> = { draft: 0.28, fine: 0.12 };
+const STRENGTH: Partial<Record<PrintStrength, { wall_loops: number; sparse_infill_density: string }>> = {
+  strong: { wall_loops: 4, sparse_infill_density: "25%" },
+  max: { wall_loops: 6, sparse_infill_density: "40%" },
+};
+
+/** The call's arguments with `quality` and `strength` written out as slicer settings. */
+export function withPrintQuality(args: Record<string, unknown>, nozzleDiameter?: number): Record<string, unknown> {
+  if (args.quality === undefined && args.strength === undefined) return args;
+  const quality = args.quality === undefined ? "standard" : args.quality;
+  const strength = args.strength === undefined ? "standard" : args.strength;
+  if (typeof quality !== "string" || !(PRINT_QUALITIES as readonly string[]).includes(quality)) {
+    throw new Error(`quality must be one of ${PRINT_QUALITIES.join(", ")}.`);
+  }
+  if (typeof strength !== "string" || !(PRINT_STRENGTHS as readonly string[]).includes(strength)) {
+    throw new Error(`strength must be one of ${PRINT_STRENGTHS.join(", ")}.`);
+  }
+  const out: Record<string, unknown> = { ...args };
+  const scale = typeof nozzleDiameter === "number" && Number.isFinite(nozzleDiameter) && nozzleDiameter > 0 ? nozzleDiameter / REFERENCE_NOZZLE_MM : 1;
+  const layer = LAYER_MM_ON_REFERENCE[quality as PrintQuality];
+  if (layer !== undefined && out.layer_height === undefined) out.layer_height = Math.round(layer * scale * 100) / 100;
+  const walls = STRENGTH[strength as PrintStrength];
+  if (walls) {
+    if (out.wall_loops === undefined) out.wall_loops = walls.wall_loops;
+    if (out.sparse_infill_density === undefined) out.sparse_infill_density = walls.sparse_infill_density;
+  }
+  return out;
+}
+
+/** slice_stl input-schema properties for both arguments. */
+export const PRINT_QUALITY_PROPERTIES = {
+  quality: {
+    type: "string", enum: [...PRINT_QUALITIES],
+    description: "Print quality: draft (thicker layers, faster), standard (the preset's own layer height) or fine (thinner layers). The server picks the layer height for the nozzle in use; an explicit layer_height wins.",
+  },
+  strength: {
+    type: "string", enum: [...PRINT_STRENGTHS],
+    description: "Part strength: standard (the preset's walls and infill), strong or max (more walls and denser infill). The server picks the values; explicit wall_loops or sparse_infill_density win.",
+  },
+} as const;

package/src/stl/stl-manipulator.ts

@@ -1317,7 +1317,7 @@ export class STLManipulator extends EventEmitter {
           case 'cura':
             if (Object.keys(orcaProcessOverrides(processOverrides)).length) {
               throw new SlicerError('preparation',
-                'layer_height, wall_loops, sparse_infill_density and the support settings are not mapped for Cura; set them in the Cura definition passed as slicer_profile.',
+                'quality, strength, layer_height, wall_loops, sparse_infill_density and the support settings are not mapped for Cura; set them in the Cura definition passed as slicer_profile.',
                 { slicerType, slicerPath });
             }
             // CuraEngine CLI args are different, often requiring -s for settings