mcp-3d-printer-server 1.2.30 → 1.2.32

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [1.2.32] – 2026-11-04
+
+### Added
+
+- `counterpart_printer_info` reports `capabilities.slicing`: whether `slice_stl` can apply supports, copies (`repetitions`) and auto-orient with the slicer this server uses for that printer. The Bambu-compatible CLI route takes all three, generic OrcaSlicer takes supports, and PrusaSlicer, Slic3r and Cura take none. For a Bambu printer on OrcaSlicer, that assumes the call passes the printer's `bambu_model`. Clients such as Counterpart offer those choices from this instead of knowing which slicers accept what. Same field as bambu-printer-mcp 1.1.58. Checked with mocked transports only.
+
+### Changed
+
+- `slice_stl` with `repetitions` above 1 on a slicer that can't make copies (anything but the Bambu-compatible CLI route) now says so and slices nothing; it used to slice one copy without a word. Checked with stand-in slicers only.
+
+## [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

package/README.md

@@ -210,6 +210,8 @@ 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)
+- `counterpart_printer_info` reports `capabilities.slicing` (`supports`, `copies`, `orient`) for the slicer route this server uses for that printer (for a Bambu printer on OrcaSlicer, when the call passes its `bambu_model`), so a client can offer those choices without knowing the slicer.
+- 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

package/dist/counterpart/contract.d.ts

@@ -55,6 +55,13 @@ export interface CounterpartCapabilities {
     cancel: boolean;
     print3mf: boolean;
     gcode: boolean;
+    /** What slice_stl can apply with this server's slicer for this printer (src/slicer/capabilities.ts). For a Bambu printer on
+     *  OrcaSlicer this assumes the call passes the printer's bambu_model, as Counterpart does; without one, OrcaSlicer slices generically. */
+    slicing?: {
+        supports: boolean;
+        copies: boolean;
+        orient: boolean;
+    };
 }
 export interface PrinterIdentity {
     model?: string;
@@ -172,6 +179,21 @@ export declare const PRINTER_INFO_OUTPUT_SCHEMA: {
                 readonly gcode: {
                     readonly type: "boolean";
                 };
+                readonly slicing: {
+                    readonly type: "object";
+                    readonly required: readonly ["supports", "copies", "orient"];
+                    readonly properties: {
+                        readonly supports: {
+                            readonly type: "boolean";
+                        };
+                        readonly copies: {
+                            readonly type: "boolean";
+                        };
+                        readonly orient: {
+                            readonly type: "boolean";
+                        };
+                    };
+                };
             };
         };
     };

package/dist/counterpart/contract.js

@@ -59,6 +59,11 @@ export const PRINTER_INFO_OUTPUT_SCHEMA = {
                 cancel: { type: "boolean" },
                 print3mf: { type: "boolean" },
                 gcode: { type: "boolean" },
+                slicing: {
+                    type: "object",
+                    required: ["supports", "copies", "orient"],
+                    properties: { supports: { type: "boolean" }, copies: { type: "boolean" }, orient: { type: "boolean" } },
+                },
             },
         },
     },

package/dist/counterpart/service.js

@@ -3,6 +3,7 @@
  * adapters supply firmware reads; this module turns them into the shared
  * results, detects capabilities, and fetches camera snapshots.
  */
+import { sliceCapabilities } from "../slicer/capabilities.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { isAxiosError } from "axios";
@@ -83,6 +84,7 @@ export class CounterpartService {
             capabilities = {
                 progress: true, layers: true, camera: overrideSnapshotUrl() ? "http-snapshot" : "none", filaments: "ams",
                 pause: true, resume: true, cancel: true, print3mf: true, gcode: true,
+                slicing: sliceCapabilities(this.bambuProfileSource().slicerType ?? "bambustudio", true),
             };
         }
         else {
@@ -96,6 +98,7 @@ export class CounterpartService {
             capabilities = {
                 progress: true, layers, camera, filaments: "single",
                 pause: pauseResume, resume: pauseResume, cancel: true, print3mf: false, gcode: true,
+                slicing: sliceCapabilities(this.bambuProfileSource().slicerType ?? "prusaslicer", false),
             };
         }
         const streamCandidates = await this.cameraCandidates(target).catch(() => []);

package/dist/index.js

@@ -20,6 +20,8 @@ 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 { isBambuProjectSlicer, usesBambuCli } from "./slicer/capabilities.js";
 import { CounterpartService } from "./counterpart/service.js";
 import { CAMERA_STREAM_TOOLS } from "./counterpart/camera-tools.js";
 import { annotateTools } from "./tool-annotations.js";
@@ -100,9 +102,6 @@ function normalizeSlicerType(rawValue) {
     }
     return resolved;
 }
-function isBambuProjectSlicer(slicerType) {
-    return slicerType === "orcaslicer-bambulab" || slicerType === "bambustudio";
-}
 function firstExistingPath(candidates) {
     return candidates.find((candidate) => fs.existsSync(candidate));
 }
@@ -755,10 +754,14 @@ class ThreeDPrinterMCPServer {
         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
         // call explicitly targets a Bambu model.
-        const bambuCli = isBambuProjectSlicer(slicerType) || (slicerType === "orcaslicer" && explicitModel !== undefined);
+        const bambuCli = usesBambuCli(slicerType, explicitModel !== undefined);
         if (!bambuCli && parsePauseLayers(args.pause_at_layers)) {
             throw new Error(`Pausing at a layer needs the Bambu Studio or OrcaSlicer CLI, not ${slicerType}.`);
         }
+        // Copies only come from the Bambu-compatible CLI; elsewhere one copy would be sliced without a word.
+        if (!bambuCli && args.repetitions !== undefined && Number(args.repetitions) > 1) {
+            throw new Error(`Copies (repetitions) need the Bambu Studio or OrcaSlicer CLI with a Bambu model, not ${slicerType}; nothing was sliced.`);
+        }
         let printerPreset;
         let options;
         if (bambuCli) {
@@ -2817,7 +2820,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;
                     }
@@ -2910,7 +2915,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/capabilities.d.ts

@@ -0,0 +1,19 @@
+/**
+ * What a slice from this server can do with the slicer it runs (counterpart_printer_info
+ * capabilities.slicing). Clients such as Counterpart offer supports, copies and auto-orient only
+ * when this says so, instead of knowing which slicer accepts what.
+ *
+ * The Bambu-compatible CLI route (Bambu Studio, FULU OrcaSlicer-bambulab, or OrcaSlicer given a
+ * Bambu model) takes all three. Generic OrcaSlicer takes the support keys over its process profile.
+ * PrusaSlicer, Slic3r and Cura take none of them through this server. For a Bambu printer on OrcaSlicer, the
+ * Bambu route needs the call's bambu_model; clients that report these to the person pass it.
+ */
+export interface SliceCapabilities {
+    supports: boolean;
+    copies: boolean;
+    orient: boolean;
+}
+export declare function isBambuProjectSlicer(slicerType: string): boolean;
+/** True when slice_stl uses the Bambu-compatible CLI route for this slicer and target. */
+export declare function usesBambuCli(slicerType: string, bambuModel: boolean): boolean;
+export declare function sliceCapabilities(slicerType: string, bambuModel: boolean): SliceCapabilities;

package/dist/slicer/capabilities.js

@@ -0,0 +1,11 @@
+export function isBambuProjectSlicer(slicerType) {
+    return slicerType === "orcaslicer-bambulab" || slicerType === "bambustudio";
+}
+/** True when slice_stl uses the Bambu-compatible CLI route for this slicer and target. */
+export function usesBambuCli(slicerType, bambuModel) {
+    return isBambuProjectSlicer(slicerType) || (slicerType === "orcaslicer" && bambuModel);
+}
+export function sliceCapabilities(slicerType, bambuModel) {
+    const bambuCli = usesBambuCli(slicerType, bambuModel);
+    return { supports: bambuCli || slicerType === "orcaslicer", copies: bambuCli, orient: bambuCli };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "mcp-3d-printer-server",
     "mcpName": "io.github.DMontgomery40/mcp-3d-printer-server",
-    "version": "1.2.30",
+    "version": "1.2.32",
     "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.30",
+  "version": "1.2.32",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "mcp-3d-printer-server",
-      "version": "1.2.30",
+      "version": "1.2.32",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/src/counterpart/contract.ts

@@ -63,6 +63,9 @@ export interface CounterpartCapabilities {
   cancel: boolean;
   print3mf: boolean;
   gcode: boolean;
+  /** What slice_stl can apply with this server's slicer for this printer (src/slicer/capabilities.ts). For a Bambu printer on
+   *  OrcaSlicer this assumes the call passes the printer's bambu_model, as Counterpart does; without one, OrcaSlicer slices generically. */
+  slicing?: { supports: boolean; copies: boolean; orient: boolean };
 }
 
 export interface PrinterIdentity {
@@ -153,6 +156,11 @@ export const PRINTER_INFO_OUTPUT_SCHEMA = {
         cancel: { type: "boolean" },
         print3mf: { type: "boolean" },
         gcode: { type: "boolean" },
+        slicing: {
+          type: "object",
+          required: ["supports", "copies", "orient"],
+          properties: { supports: { type: "boolean" }, copies: { type: "boolean" }, orient: { type: "boolean" } },
+        },
       },
     },
   },

package/src/counterpart/service.ts

@@ -3,6 +3,7 @@
  * adapters supply firmware reads; this module turns them into the shared
  * results, detects capabilities, and fetches camera snapshots.
  */
+import { sliceCapabilities } from "../slicer/capabilities.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { isAxiosError, type AxiosInstance } from "axios";
@@ -132,6 +133,7 @@ export class CounterpartService {
       capabilities = {
         progress: true, layers: true, camera: overrideSnapshotUrl() ? "http-snapshot" : "none", filaments: "ams",
         pause: true, resume: true, cancel: true, print3mf: true, gcode: true,
+        slicing: sliceCapabilities(this.bambuProfileSource().slicerType ?? "bambustudio", true),
       };
     } else {
       const { host, port, apiKey } = target;
@@ -144,6 +146,7 @@ export class CounterpartService {
       capabilities = {
         progress: true, layers, camera, filaments: "single",
         pause: pauseResume, resume: pauseResume, cancel: true, print3mf: false, gcode: true,
+        slicing: sliceCapabilities(this.bambuProfileSource().slicerType ?? "prusaslicer", false),
       };
     }
     const streamCandidates = await this.cameraCandidates(target).catch(() => []);

package/src/index.ts

@@ -37,6 +37,8 @@ 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 { isBambuProjectSlicer, usesBambuCli } from "./slicer/capabilities.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";
@@ -152,9 +154,6 @@ function normalizeSlicerType(rawValue: string | undefined): SlicerType {
   return resolved;
 }
 
-function isBambuProjectSlicer(slicerType: SlicerType): boolean {
-  return slicerType === "orcaslicer-bambulab" || slicerType === "bambustudio";
-}
 
 function firstExistingPath(candidates: string[]): string | undefined {
   return candidates.find((candidate) => fs.existsSync(candidate));
@@ -736,6 +735,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>;
@@ -912,10 +913,14 @@ class ThreeDPrinterMCPServer {
       typeof args.bambu_model === "string" && args.bambu_model.trim() ? args.bambu_model : undefined;
     // Generic OrcaSlicer keeps its user-supplied machine profile unless the
     // call explicitly targets a Bambu model.
-    const bambuCli = isBambuProjectSlicer(slicerType) || (slicerType === "orcaslicer" && explicitModel !== undefined);
+    const bambuCli = usesBambuCli(slicerType, explicitModel !== undefined);
     if (!bambuCli && parsePauseLayers(args.pause_at_layers)) {
       throw new Error(`Pausing at a layer needs the Bambu Studio or OrcaSlicer CLI, not ${slicerType}.`);
     }
+    // Copies only come from the Bambu-compatible CLI; elsewhere one copy would be sliced without a word.
+    if (!bambuCli && args.repetitions !== undefined && Number(args.repetitions) > 1) {
+      throw new Error(`Copies (repetitions) need the Bambu Studio or OrcaSlicer CLI with a Bambu model, not ${slicerType}; nothing was sliced.`);
+    }
 
     let printerPreset: string | undefined;
     let options: BambuSliceOptions | undefined;
@@ -3185,7 +3190,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;
@@ -3342,7 +3349,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/capabilities.ts

@@ -0,0 +1,29 @@
+/**
+ * What a slice from this server can do with the slicer it runs (counterpart_printer_info
+ * capabilities.slicing). Clients such as Counterpart offer supports, copies and auto-orient only
+ * when this says so, instead of knowing which slicer accepts what.
+ *
+ * The Bambu-compatible CLI route (Bambu Studio, FULU OrcaSlicer-bambulab, or OrcaSlicer given a
+ * Bambu model) takes all three. Generic OrcaSlicer takes the support keys over its process profile.
+ * PrusaSlicer, Slic3r and Cura take none of them through this server. For a Bambu printer on OrcaSlicer, the
+ * Bambu route needs the call's bambu_model; clients that report these to the person pass it.
+ */
+export interface SliceCapabilities {
+  supports: boolean;
+  copies: boolean;
+  orient: boolean;
+}
+
+export function isBambuProjectSlicer(slicerType: string): boolean {
+  return slicerType === "orcaslicer-bambulab" || slicerType === "bambustudio";
+}
+
+/** True when slice_stl uses the Bambu-compatible CLI route for this slicer and target. */
+export function usesBambuCli(slicerType: string, bambuModel: boolean): boolean {
+  return isBambuProjectSlicer(slicerType) || (slicerType === "orcaslicer" && bambuModel);
+}
+
+export function sliceCapabilities(slicerType: string, bambuModel: boolean): SliceCapabilities {
+  const bambuCli = usesBambuCli(slicerType, bambuModel);
+  return { supports: bambuCli || slicerType === "orcaslicer", copies: bambuCli, orient: bambuCli };
+}