mcp-3d-printer-server 1.2.29 → 1.2.31

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.2.31] – 2026-11-04
+
+### Added
+
+- A printer refusal on `print_3mf` carries a stable `code` in its structured error: `printer-command-rejected` when the printer refuses the print command itself (Bambu HMS 0500-0500-0001-0007, MQTT command verification; the file is on the printer, nothing is printing), and `printer-not-ready` when the printer isn't in a state that can start a print. The message and suggestion are unchanged. Clients such as Counterpart can act on the code instead of matching the wording, which changes with printers and firmware. Checked with mocked MQTT only. Same change as bambu-printer-mcp 1.1.57.
+
+## [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

package/README.md

@@ -210,6 +210,7 @@ The optional FULU **BambuNetwork bridge** is a separate runtime. With `BAMBU_DEF
 - Per-call `type`, `host`, `port`, and `api_key` arguments for working with more than one printer
 - Printer status, file listing, G-code upload from inline content or a local path, starting a stored file, pausing, resuming, cancelling a job, and setting bed or nozzle temperatures
 - The `counterpart/1` tools shared with [bambu-printer-mcp](https://github.com/DMontgomery40/bambu-printer-mcp): one progress shape for every firmware (state, job, progress, time left, layers, temperatures, problems), detected printer capabilities, camera snapshots, and the loaded filament (Spoolman on Moonraker)
+- Errors carry their details in `structuredContent` (`status`, `retryable`, `suggestion`, `message`); a printer refusal on `print_3mf` also carries a stable `code`, `printer-command-rejected` or `printer-not-ready`, so a client can act on the code instead of the wording.
 - STL tools: inspect dimensions, scale, rotate, translate, extend the base, merge vertices, center, lay flat, transform one section of a model, and render multi-angle SVG previews
 - A print and heating safety gate on every backend: the exact G-code is inspected, every heater target is checked against hardware and material ceilings, and the printer's state is checked. There is no confirmation prompt and no bed check: your client's own print action is the approval. Heater-off, pause, and cancel are never gated; resume only continues a paused job this server inspected and started, and asks a person only when the printer cannot hand the file back for re-reading
 - Slicing through PrusaSlicer, Slic3r, OrcaSlicer, CuraEngine, FULU OrcaSlicer-bambulab, or Bambu Studio command lines, with G-code peak-temperature checks and a one-call process-and-print pipeline
@@ -688,6 +689,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/index.js

@@ -19,6 +19,8 @@ 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 { PrinterRefusal } from "./refusal.js";
 import { CounterpartService } from "./counterpart/service.js";
 import { CAMERA_STREAM_TOOLS } from "./counterpart/camera-tools.js";
 import { annotateTools } from "./tool-annotations.js";
@@ -306,6 +308,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 +751,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
@@ -2815,7 +2818,9 @@ class ThreeDPrinterMCPServer {
                         }
                         catch (printError) {
                             console.error(`Error starting 3MF print for ${threeMfFilename}:`, printError);
-                            throw new Error(`Failed to start print: ${printError.message}`);
+                            const wrapped = `Failed to start print: ${printError.message}`;
+                            // A printer refusal keeps its code through the wrap: clients act on it (src/refusal.ts).
+                            throw printError instanceof PrinterRefusal ? new PrinterRefusal(printError.code, wrapped) : new Error(wrapped);
                         }
                         break;
                     }
@@ -2908,7 +2913,8 @@ class ThreeDPrinterMCPServer {
             catch (error) {
                 console.error(`Error calling tool ${name}:`, error);
                 const errorMessage = error instanceof Error ? error.message : String(error);
-                const structuredError = this.toStructuredToolError(name, errorMessage, error);
+                // A printer refusal adds its stable code (src/refusal.ts); the message and suggestion stay as they were.
+                const structuredError = { ...this.toStructuredToolError(name, errorMessage, error), ...(error instanceof PrinterRefusal ? { code: error.code } : {}) };
                 return {
                     content: [
                         {

package/dist/printers/bambu.js

@@ -1,3 +1,4 @@
+import { PrinterRefusal } from "../refusal.js";
 import { PrinterImplementation } from "../types.js";
 import { createHash } from "node:crypto";
 import { createReadStream, readFileSync, mkdirSync, writeFileSync, renameSync, rmSync } from "node:fs";
@@ -671,7 +672,7 @@ export class BambuImplementation extends PrinterImplementation {
                     catch { /* stays unconfirmed */ }
                 }
                 if (verdict === "rejected")
-                    throw new Error(COMMAND_REJECTED_MESSAGE);
+                    throw new PrinterRefusal("printer-command-rejected", COMMAND_REJECTED_MESSAGE);
                 stillActive();
                 return verdict ?? "unconfirmed";
             },

package/dist/refusal.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A printer refusal with a stable code, returned as structuredContent.code on the tool's error, so clients
+ * such as Counterpart act on the code instead of matching the message (whose words, HMS numbers and
+ * firmware details change with the printer). Neither one starts a print.
+ *
+ * - printer-command-rejected: the printer refused the print command itself (for Bambu, HMS 0500-0500-0001-0007,
+ *   MQTT command verification); the file was uploaded and the command sent, but nothing is printing.
+ * - printer-not-ready: the printer isn't in a state that can start a print (busy, paused, failed, unknown).
+ */
+export declare const REFUSAL_CODES: readonly ["printer-command-rejected", "printer-not-ready"];
+export type RefusalCode = (typeof REFUSAL_CODES)[number];
+export declare class PrinterRefusal extends Error {
+    readonly code: RefusalCode;
+    constructor(code: RefusalCode, message: string);
+}

package/dist/refusal.js

@@ -0,0 +1,17 @@
+/**
+ * A printer refusal with a stable code, returned as structuredContent.code on the tool's error, so clients
+ * such as Counterpart act on the code instead of matching the message (whose words, HMS numbers and
+ * firmware details change with the printer). Neither one starts a print.
+ *
+ * - printer-command-rejected: the printer refused the print command itself (for Bambu, HMS 0500-0500-0001-0007,
+ *   MQTT command verification); the file was uploaded and the command sent, but nothing is printing.
+ * - printer-not-ready: the printer isn't in a state that can start a print (busy, paused, failed, unknown).
+ */
+export const REFUSAL_CODES = ["printer-command-rejected", "printer-not-ready"];
+export class PrinterRefusal extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "PrinterRefusal";
+    }
+}

package/dist/safety/printer-state.js

@@ -1,3 +1,4 @@
+import { PrinterRefusal } from "../refusal.js";
 import { HIDDEN_HMS } from "./hidden-hms.js";
 import { isDualNozzleModel, normalizeMaterial, normalizeModel } from "./limits.js";
 const MAX_REPORT_AGE_MS = 15000;
@@ -332,7 +333,7 @@ function validateErrors(raw, requireIdle, serial, model) {
     const state = typeof raw.gcode_state === "string" ? raw.gcode_state.toUpperCase() : "UNKNOWN";
     const terminal = isCancelledX2DJob(raw, model) || isFinishedP1SJob(raw, model);
     if (requireIdle && !["IDLE", "FINISH"].includes(state) && !terminal)
-        throw new Error(`Printer state ${state} is not safely idle.`);
+        throw new PrinterRefusal("printer-not-ready", `Printer state ${state} is not safely idle.`);
     if (!requireIdle && !["IDLE", "FINISH", "RUNNING", "PAUSE"].includes(state) && !terminal)
         throw new Error(`Printer state ${state} is unknown or failed.`);
     if (finiteNumber(raw.print_error) !== 0 && !isPauseNotice(raw, requireIdle))

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.29",
+    "version": "1.2.31",
     "description": "MCP server for connecting Claude with 3D printer management systems",
     "main": "dist/index.js",
     "repository": "https://github.com/DMontgomery40/mcp-3D-printer-server",
@@ -32,6 +32,8 @@
         "dist/http-server.js",
         "dist/index.d.ts",
         "dist/index.js",
+        "dist/refusal.d.ts",
+        "dist/refusal.js",
         "dist/printers",
         "dist/safety",
         "dist/sse-server.d.ts",

package/server.json

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

package/src/index.ts

@@ -36,6 +36,8 @@ 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 { PrinterRefusal } from "./refusal.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";
@@ -384,6 +386,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.",
@@ -734,6 +737,8 @@ type StructuredToolError = {
   suggestion: string;
   message: string;
   tool: string;
+  /** A stable refusal code (src/refusal.ts) when the printer refused; clients act on it, not on the words. */
+  code?: string;
   slicer?: Record<string, unknown>;
   /** The slicer's own result.json, verbatim. */
   slicer_result?: Record<string, unknown>;
@@ -904,7 +909,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;
@@ -3183,7 +3188,9 @@ class ThreeDPrinterMCPServer {
                 // Report what the printer did, not merely that a command was published.
             } catch (printError) {
                  console.error(`Error starting 3MF print for ${threeMfFilename}:`, printError);
-                 throw new Error(`Failed to start print: ${(printError as Error).message}`);
+                 const wrapped = `Failed to start print: ${(printError as Error).message}`;
+                 // A printer refusal keeps its code through the wrap: clients act on it (src/refusal.ts).
+                 throw printError instanceof PrinterRefusal ? new PrinterRefusal(printError.code, wrapped) : new Error(wrapped);
             }
 
             break;
@@ -3340,7 +3347,8 @@ class ThreeDPrinterMCPServer {
         console.error(`Error calling tool ${name}:`, error);
         
         const errorMessage = error instanceof Error ? error.message : String(error);
-        const structuredError = this.toStructuredToolError(name, errorMessage, error);
+        // A printer refusal adds its stable code (src/refusal.ts); the message and suggestion stay as they were.
+        const structuredError = { ...this.toStructuredToolError(name, errorMessage, error), ...(error instanceof PrinterRefusal ? { code: error.code } : {}) };
         
         return {
           content: [

package/src/printers/bambu.ts

@@ -1,3 +1,4 @@
+import { PrinterRefusal } from "../refusal.js";
 import { PrinterImplementation } from "../types.js";
 import { createHash } from "node:crypto";
 import { createReadStream, readFileSync, mkdirSync, writeFileSync, renameSync, rmSync } from "node:fs";
@@ -782,7 +783,7 @@ export class BambuImplementation extends PrinterImplementation {
         if (verdict === undefined) {
           try { verdict = judge((await this.getSafetyStatus(host, serial, token))?.raw); } catch { /* stays unconfirmed */ }
         }
-        if (verdict === "rejected") throw new Error(COMMAND_REJECTED_MESSAGE);
+        if (verdict === "rejected") throw new PrinterRefusal("printer-command-rejected", COMMAND_REJECTED_MESSAGE);
         stillActive();
         return verdict ?? "unconfirmed";
       },

package/src/safety/printer-state.ts

@@ -1,3 +1,4 @@
+import { PrinterRefusal } from "../refusal.js";
 import { HIDDEN_HMS } from "./hidden-hms.js";
 import type { BambuClient } from "bambu-node";
 import { isDualNozzleModel, normalizeMaterial, normalizeModel } from "./limits.js";
@@ -341,7 +342,7 @@ export function isPauseNotice(raw: Record<string, any>, requireIdle: boolean): b
 function validateErrors(raw: Record<string,any>, requireIdle: boolean, serial: string, model: string) {
   const state = typeof raw.gcode_state === "string" ? raw.gcode_state.toUpperCase() : "UNKNOWN";
   const terminal = isCancelledX2DJob(raw, model) || isFinishedP1SJob(raw, model);
-  if (requireIdle && !["IDLE","FINISH"].includes(state) && !terminal) throw new Error(`Printer state ${state} is not safely idle.`);
+  if (requireIdle && !["IDLE","FINISH"].includes(state) && !terminal) throw new PrinterRefusal("printer-not-ready", `Printer state ${state} is not safely idle.`);
   if (!requireIdle && !["IDLE","FINISH","RUNNING","PAUSE"].includes(state) && !terminal) throw new Error(`Printer state ${state} is unknown or failed.`);
   if (finiteNumber(raw.print_error) !== 0 && !isPauseNotice(raw, requireIdle)) throw new Error("Printer reports a print error or did not report its error state.");
   if (!Array.isArray(raw.hms)) throw new Error("Printer HMS error state is missing or malformed.");

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