mcp-3d-printer-server 1.2.12 → 1.2.14

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 1.2.14 — 2026-10-25
+
+Ported from [bambu-printer-mcp](https://github.com/DMontgomery40/bambu-printer-mcp) 1.1.34. Its evidence came from real P1S runs and an x86-64 Linux FULU container; this repository's validation is noted in each entry.
+
+### Fixed
+
+- Let H2D printers with stock nozzles print. Every print stopped with `Printer nozzle 0 information is unreliable, abnormal or unknown` because the HS01 nozzles report `stat: 1` permanently. Bambu Studio reads bit 0 of `stat` as "information unreliable" and bits 1-2 as abnormal or unknown. Nozzles that report no identity chip (`sn: "N/A"`) now pass bit 0, and their configured diameter and type are still compared with the job. The Bambu print prompt names them so a person confirms they match the installed hotends, and checks log them once per printer on stderr, so a headless setup still records them. Abnormal or unknown nozzles still block, and a chipped nozzle with unreliable information asks for a refresh on the printer. Reported by [MorganFreeeman](https://github.com/MorganFreeeman) in [bambu-printer-mcp #67](https://github.com/DMontgomery40/bambu-printer-mcp/issues/67) with idle and mid-print H2D firmware 01.04.00.00 reports. Validated here with that report in mocked-status regressions; no H2D hardware was available.
+- Say "declined or cancelled" when a person or the MCP client declines a hardware confirmation, instead of advising a client with elicitation support; clients without elicitation still get that advice. Ordinary print and heating prompts name the opt-out that applies to the printer: `PRINT_REQUIRE_CONFIRMATION=0`, or also `BAMBU_REQUIRE_CONFIRMATION=0` for Bambu printers. Bed-clearance confirmations say a person must accept them. Also from [bambu-printer-mcp #67](https://github.com/DMontgomery40/bambu-printer-mcp/issues/67); validated with mocked Bambu and generic adapters.
+- Stop `get_printer_status` on Bambu printers from reporting `UNKNOWN` when the printer's first MQTT push is a sparse hello (model and modules). The read returned as soon as any data had arrived; it now waits, within its existing 1.5 s bound, until the full status has merged. bambu-printer-mcp saw this twice on a P1S; validated here with a delayed-push regression.
+- Stop `slice_stl` option combinations from crashing OrcaSlicer's CLI. OrcaSlicer 2.4.2 segfaults in `PartPlate::check_outside`, which needs the GUI, when `scale` or `rotate_x`/`rotate_y` moves an object below the bed while arranging, the default for STL input. For STL input with OrcaSlicer or FULU, the server applies scale and rotations to a copy of the mesh in Orca's own order (scale, then X, then Y, then Z) and omits those flags; for 3MF input with `arrange: true` it refuses that combination with an explanation. `repetitions` on an STL now uses Orca's `--clone-objects`, which cannot be combined with `clone_objects`. The `repetitions`, `arrange` and `clone_objects` descriptions now state the CLI's real limits. Bambu Studio keeps every flag. bambu-printer-mcp verified the crash and fix against OrcaSlicer 2.4.2 on Linux, including the 10 × 20 × 30 mm rotation-order check; this repository's regressions use a fake CLI that records the mesh it receives.
+- Report how a Bambu-compatible slicer failed: Bambu Studio and OrcaSlicer failures now name the CLI's own reason, from the `result.json` it writes on Linux or from its exit code, next to the existing exit code or signal and output tails. Validated with a fake CLI.
+- Make FULU BambuNetwork bridge probes work with FULU's v1.0.0 Linux host. The host exits when its input closes, dropping requests it has not answered, so every probe and RPC call returned no responses; the server now keeps the input open until each request is answered. On Linux it passes `PJARCZAK_BAMBU_NETWORK_SO` and `PJARCZAK_BAMBU_SOURCE_SO` inside `PJARCZAK_BAMBU_PLUGIN_DIR` unless set, because the host opens them from its working directory ([FULU #51](https://github.com/FULU-Foundation/OrcaSlicer-bambulab/issues/51)). The default Linux bridge command pipes the host through `cat`, because the host exits 101 on the socket stdout Node.js provides ([FULU #50](https://github.com/FULU-Foundation/OrcaSlicer-bambulab/issues/50)); probes and RPC results explain exit code 101, and the FULU guide documents a wrapper for custom commands. A handshake from a host that could not load the networking plug-in is no longer reported as ready, and `file open failed` names the missing setting. A host that stops answering times out with its stderr, how many requests went unanswered and any hints, and Linux setup checks report the library paths that reach the host, including ones you set. macOS bundle notes and wrapper commands appear only for macOS, and the wrapper command only when the wrapper exists. Linux host bugs were reported with diagnosis and upstream issues by [Aaron Roberts (aaroberts)](https://github.com/aaroberts) in [bambu-printer-mcp #68](https://github.com/DMontgomery40/bambu-printer-mcp/issues/68). Validated with a fake host that exits on end of input, and in the maintainer's x86-64 Linux container (QEMU emulation) against FULU's real v1.0.0 host and networking plug-in 02.05.02.58: probes were ready through the default command and the wrapper, a directly launched host returned exit 101 with its explanation, and a missing plug-in folder returned the `file open failed` explanation. `net.create_agent` through `fulu_bambu_network_rpc` created an agent; the host then aborted while exiting, after answering. No printer was contacted. bambu-printer-mcp's bridge LAN printing, certificate, `-4030` and job-name changes do not apply: this server refuses raw bridge print and printer-connection methods and prints over its direct MQTT/FTPS path.
+
+### Documentation
+
+- Add the FULU guide's Linux host setup and an "Upstream bugs and workarounds" table naming FULU #50 and #51, the FULU runtime's missing `printer.cer`, the FULU v1.0.0 CLI crash, the OrcaSlicer 2.4.2 `check_outside` crash (related to the closed [OrcaSlicer #13328](https://github.com/OrcaSlicer/OrcaSlicer/issues/13328)), and the Bambu plug-in's `-4030` design, with what this server does about each.
+
+### Dependencies
+
+- Move the direct `zod` dependency to 4.6.7 for [GHSA-mrhx-c7xc-m3w5](https://github.com/advisories/GHSA-mrhx-c7xc-m3w5), memory exhaustion when validating oversized constrained collections; every zod 3 release is affected. The MCP SDK and zod-to-json-schema both accept zod 4, and this server does not import zod itself. Update body-parser to 2.4.0 ([GHSA-27r3-jxmh-p828](https://github.com/advisories/GHSA-27r3-jxmh-p828)), fast-uri to 3.1.9, follow-redirects to 1.16.2, hono to 4.13.14 and ip-address to 10.7.5 for their new advisories. `npm audit` now reports no vulnerabilities. The documentation site's VitePress development server still pulls vite 6.4.3 and esbuild with advisories that have no VitePress 1.x fix; they affect only `vitepress dev`, not the published static site.
+
+## 1.2.13 — 2026-10-20
+
+### Dependencies
+
+- Refresh the reproducible installation/test lock from MQTT.js 5.10.4 to 5.16.1, including its fix for reconnecting when the previous stream is already destroyed. Keep bambu-node pinned at 3.22.21 and preserve the server's checked MQTT wire format and rejection guard. Thank you to [Henk Kraal (hkraal)](https://github.com/hkraal) and the [MQTT.js maintainers](https://github.com/mqttjs/MQTT.js/releases/tag/v5.16.1).
+- Update the documentation build's source-map-js to 1.2.2 for [GHSA-68fv-2mgg-jv7q](https://github.com/advisories/GHSA-68fv-2mgg-jv7q), which addresses indexed source-map offsets blocking the event loop. Thank you to [7rulnik](https://github.com/7rulnik/source-map-js/pull/79). Refresh compatible Node 18 typings and MQTT's required transitive packages.
+
+The root lock controls `npm ci`, including CI and reproducible local installs; npm does not ship that lock to consumers. Existing parent projects can retain older transitive MQTT versions and must refresh their own locks. This is not a new published MQTT minimum or a claim that every advisory is resolved. Remaining nodemon/chokidar/braces and VitePress/Vite/esbuild development-server advisories have no compatible automatic fix; no major upgrade or downgrade is forced. Printer safety behavior is unchanged and no physical printer operation is performed.
+
 ## 1.2.12 — 2026-10-13
 
 ### Fixed

package/CONTRIBUTORS.md

@@ -21,6 +21,8 @@ Thank you to everyone who builds, tests, reports problems, and shares real print
 
 | Contributor | Contribution |
 | --- | --- |
+| [MorganFreeeman](https://github.com/MorganFreeeman) | Reports in the Bambu fork's [#67](https://github.com/DMontgomery40/bambu-printer-mcp/issues/67) that every H2D print stopped on stock nozzles, with idle and mid-print H2D firmware 01.04.00.00 reports, and that a declined confirmation pointed to the wrong cause. The nozzle-information and confirmation-wording fixes are ported here with that report as a mocked-status regression; no H2D print is claimed. |
+| [Aaron Roberts (aaroberts)](https://github.com/aaroberts) | Diagnoses FULU's Linux host failures under Node.js in the Bambu fork's [#68](https://github.com/DMontgomery40/bambu-printer-mcp/issues/68), with the upstream issues ([FULU #50](https://github.com/FULU-Foundation/OrcaSlicer-bambulab/issues/50), [FULU #51](https://github.com/FULU-Foundation/OrcaSlicer-bambulab/issues/51)) and a working configuration. The Linux library paths, exit-101 explanation and `cat` wrapper are ported here and checked against FULU's real Linux host without contacting a printer. |
 | [Steavie](https://github.com/Steavie) | Reports reversed A1/A1 mini serial identity in the Bambu fork's [#39](https://github.com/DMontgomery40/bambu-printer-mcp/issues/39). This repository now uses the corrected prefixes for fresh safety identity, with mocked MQTT regressions. |
 | [Travis Cashman (travismcashan)](https://github.com/travismcashan) | Reports MCP stdout pollution from model parsing and slicing in the Bambu fork's [#44](https://github.com/DMontgomery40/bambu-printer-mcp/issues/44). The stderr correction and subprocess regressions are also applied here. Their exact stock material-switch and runout-purge evidence informs the X2D file-inspection port; maintainer validation remains offline and mocked. |
 | [Lickitysplitted](https://github.com/Lickitysplitted) | Diagnoses Bambu FTPS "Premature close" upload failures on an X1C as missing TLS session reuse in [#22](https://github.com/DMontgomery40/mcp-3D-printer-server/issues/22). Release 1.2.9 addresses it; confirmation on that X1C firmware is still outstanding. |
@@ -51,6 +53,8 @@ See the [full contribution history](https://github.com/DMontgomery40/mcp-3D-prin
 
 Thanks to [Patrick Juchli](https://github.com/patrickjuchli) and the basic-ftp maintainers for [6.2.3](https://github.com/patrickjuchli/basic-ftp/releases/tag/v6.2.3), which fixes rejected-command crashes, client recovery, and password exposure in PASS errors. The compatible FTPS security update is validated in this release.
 
+Thanks to [Henk Kraal (hkraal)](https://github.com/hkraal) and the [MQTT.js maintainers](https://github.com/mqttjs/MQTT.js/releases/tag/v5.16.1) for correcting reconnect behavior when the previous stream is destroyed, and to [7rulnik](https://github.com/7rulnik/source-map-js/pull/79) for the indexed source-map offset security fix in source-map-js 1.2.2. Their fixes are incorporated into the installation/test and documentation locks; published consumers still manage their own transitive locks. Thanks also to the [DefinitelyTyped contributors](https://github.com/DefinitelyTyped/DefinitelyTyped) for maintained Node 18 and stream typings.
+
 ## Open-source community and interoperability
 
 Special thanks to the [FULU Foundation](https://www.fulu.org/), [Louis Rossmann](https://www.youtube.com/@rossmanngroup), and the [OrcaSlicer-bambulab contributors](https://github.com/FULU-Foundation/OrcaSlicer-bambulab) for their work supporting user control and interoperable tools. This is community recognition, separate from code authorship in this repository. The Bambu-only fork, [bambu-printer-mcp](https://github.com/DMontgomery40/bambu-printer-mcp), credits its own contributors in its [CONTRIBUTORS.md](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/CONTRIBUTORS.md).

package/README.md

@@ -590,8 +590,8 @@ Options for the Bambu-compatible path:
 | `filament_colours` | One `#RRGGBB` per filament slot, `;`-separated. Defaults to the input 3MF's colours, then each profile's colour |
 | `template_3mf_path`, `template_name`, `template_dir` | Reuse a 3MF's or profile's slicer settings as the process profile (defaults: `BAMBU_TEMPLATE_3MF_PATH`, `BAMBU_TEMPLATE_DIR`). An explicit `slicer_profile` takes precedence |
 | `uptodate`, `min_save`, `skip_modified_gcodes` | Refresh 3MF presets to the installed slicer, write a smaller 3MF, or ignore custom G-code embedded in an input 3MF |
-| `orient`, `arrange`, `ensure_on_bed`, `repetitions`, `clone_objects`, `skip_objects`, `slice_plate` | Placement: auto-orient, auto-arrange (set `false` to keep a layout), drop floating models onto the bed, copies, per-object clone counts, objects to skip, and which plate to slice (0 = all) |
-| `scale`, `rotate`, `rotate_x`, `rotate_y` | Transform before slicing (uniform scale; rotations in degrees) |
+| `orient`, `arrange`, `ensure_on_bed`, `repetitions`, `clone_objects`, `skip_objects`, `slice_plate` | Placement: auto-orient, auto-arrange (STL input is arranged by default; set `false` to keep a 3MF layout), drop floating models onto the bed, copies (OrcaSlicer copies an STL with `--clone-objects`), a total clone count for the loaded model, objects to skip, and which plate to slice (0 = all) |
+| `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 |
 
 Generic slicers keep their own profile formats: PrusaSlicer and Slic3r load one exported config, and generic OrcaSlicer takes `machine.json;process.json`, optionally followed by `|filament.json`. `slicer_type`, `slicer_profile`, and `filament_profile` fall back to `SLICER_TYPE`, `SLICER_PROFILE`, and `FILAMENT_PROFILE`. The slicer executable comes from `SLICER_PATH`; a per-call `slicer_path` requires `MCP_ALLOW_EXECUTABLE_ARG=1`. See the [slicing guide](https://github.com/DMontgomery40/mcp-3D-printer-server/blob/main/docs/SLICING.md#bambu-compatible-slicing).

package/dist/fulu-orca.d.ts

@@ -16,5 +16,13 @@ export type FuluBridgeRpcOptions = {
     bambuModel?: string;
 };
 export declare function isFuluPrintRpcMethod(method: string): boolean;
+/**
+ * FULU's Linux host opens its network and source libraries by bare name from
+ * its working directory instead of PJARCZAK_BAMBU_PLUGIN_DIR
+ * (FULU-Foundation/OrcaSlicer-bambulab#51), so name them in that directory
+ * unless they are already set. macOS wrappers run the host in a Linux guest
+ * that may not see host paths, so they are left alone.
+ */
+export declare function linuxPluginLibraryEnv(env: NodeJS.ProcessEnv, platform: NodeJS.Platform): Record<string, string>;
 export declare function invokeFuluBridgeRpc(options: FuluBridgeRpcOptions): Promise<Record<string, unknown>>;
 export declare function inspectFuluOrcaSetup(options: FuluOrcaSetupOptions): Promise<Record<string, unknown>>;

package/dist/fulu-orca.js

@@ -47,6 +47,43 @@ const SESSION_MUTATING_METHODS = new Set([
 export function isFuluPrintRpcMethod(method) {
     return FULU_PRINT_RPC_METHODS.has(method.trim());
 }
+const FULU_LINUX_DOCS = "https://github.com/DMontgomery40/mcp-3D-printer-server/blob/main/docs/FULU.md#linux";
+/**
+ * FULU's Linux host opens its network and source libraries by bare name from
+ * its working directory instead of PJARCZAK_BAMBU_PLUGIN_DIR
+ * (FULU-Foundation/OrcaSlicer-bambulab#51), so name them in that directory
+ * unless they are already set. macOS wrappers run the host in a Linux guest
+ * that may not see host paths, so they are left alone.
+ */
+export function linuxPluginLibraryEnv(env, platform) {
+    const pluginDir = env.PJARCZAK_BAMBU_PLUGIN_DIR?.trim();
+    if (platform !== "linux" || !pluginDir)
+        return {};
+    const libraries = {};
+    if (!env.PJARCZAK_BAMBU_NETWORK_SO?.trim())
+        libraries.PJARCZAK_BAMBU_NETWORK_SO = path.resolve(pluginDir, "libbambu_networking.so");
+    if (!env.PJARCZAK_BAMBU_SOURCE_SO?.trim())
+        libraries.PJARCZAK_BAMBU_SOURCE_SO = path.resolve(pluginDir, "libBambuSource.so");
+    return libraries;
+}
+/** FULU's Linux host exits 101 when it cannot reopen a socket stdout (FULU-Foundation/OrcaSlicer-bambulab#50). */
+const STDOUT_SOCKET_HINT = "Exit code 101 means FULU's Linux host could not reopen its stdout, which fails when stdout is a socket, as Node.js provides " +
+    "(https://github.com/FULU-Foundation/OrcaSlicer-bambulab/issues/50). Launch the host through a wrapper that pipes its output through cat: " +
+    FULU_LINUX_DOCS;
+/** Actionable hints for a bridge run: the exit-101 socket bug and a host that cannot open the plug-in libraries. */
+function bridgeHints(exitCode, responses) {
+    const hints = [];
+    if (exitCode === 101)
+        hints.push(STDOUT_SOCKET_HINT);
+    const fileOpenFailure = Object.values(responses)
+        .find((value) => [value?.network_status, value?.error].some((text) => typeof text === "string" && /file open failed/i.test(text)));
+    if (fileOpenFailure) {
+        hints.push(`FULU BambuNetwork bridge could not open its networking library (${String(fileOpenFailure.network_status ?? fileOpenFailure.error)}). ` +
+            "Set PJARCZAK_BAMBU_PLUGIN_DIR to the directory containing libbambu_networking.so and libBambuSource.so, " +
+            `or set PJARCZAK_BAMBU_NETWORK_SO and PJARCZAK_BAMBU_SOURCE_SO to their absolute paths: ${FULU_LINUX_DOCS}`);
+    }
+    return hints;
+}
 function normalizePlatform(value) {
     const normalized = (value || process.platform).trim().toLowerCase();
     if (normalized === "mac" || normalized === "macos" || normalized === "darwin") {
@@ -200,7 +237,7 @@ function setupCommands(platform, pluginDir, runtimeDir) {
         const verify = path.join(pluginDir, "verify_runtime_macos.sh");
         const bridgeHost = path.join(runtimeDir || "", "pjarczak_bambu_linux_host");
         const wrapper = path.join(pluginDir, "pjarczak-bambu-linux-host-wrapper");
-        return [
+        const commands = [
             {
                 label: "install macOS Lima runtime",
                 command: `bash ${quoteShell(install)} -PackageDir ${quoteShell(pluginDir)} -PluginDir ${quoteShell(pluginDir)}`,
@@ -213,11 +250,15 @@ function setupCommands(platform, pluginDir, runtimeDir) {
                 label: "verify macOS Lima runtime core before Linux plugin payload is present",
                 command: `bash ${quoteShell(verify)} -PackageDir ${quoteShell(pluginDir)} -PluginDir ${quoteShell(pluginDir)} -AllowMissingLinuxPlugin`,
             },
-            {
+        ];
+        // The wrapper ships in FULU's macOS bundle; suggest it only where it exists.
+        if (fs.existsSync(wrapper)) {
+            commands.push({
                 label: "bridge command for FULU BambuNetwork runtime",
                 command: `${quoteShell(wrapper)} ${quoteShell(bridgeHost)}`,
-            },
-        ];
+            });
+        }
+        return commands;
     }
     if (platform === "win32") {
         return [
@@ -244,6 +285,11 @@ function setupCommands(platform, pluginDir, runtimeDir) {
             label: "configure MCP slicer path",
             command: "SLICER_TYPE=orcaslicer-bambulab SLICER_PATH=/path/to/orcaslicer",
         },
+        {
+            label: "bridge command for FULU's Linux host, piped through cat (FULU #50)",
+            command: `FULU_BAMBU_BRIDGE_COMMAND="${quoteShell(path.join(pluginDir, "pjarczak_bambu_linux_host"))} | cat" ` +
+                "PJARCZAK_BAMBU_PLUGIN_DIR=\"$HOME/.config/OrcaSlicer/plugins\"",
+        },
     ];
 }
 function defaultBridgeCommand(platform, pluginDir, runtimeDir) {
@@ -255,12 +301,16 @@ function defaultBridgeCommand(platform, pluginDir, runtimeDir) {
     }
     if (platform === "darwin") {
         const wrapper = path.join(pluginDir, "pjarczak-bambu-linux-host-wrapper");
+        if (!fs.existsSync(wrapper))
+            return undefined;
         const runtimeHost = path.join(runtimeDir || defaultRuntimeDir(platform) || "", "pjarczak_bambu_linux_host");
         return `${quoteShell(wrapper)} ${quoteShell(runtimeHost)}`;
     }
     if (platform === "linux") {
+        // The v1.0.0 host exits 101 on the socket stdout Node.js gives a child
+        // (FULU-Foundation/OrcaSlicer-bambulab#50); a shell pipe through cat avoids it.
         const host = path.join(pluginDir, "pjarczak_bambu_linux_host");
-        return fs.existsSync(host) ? quoteShell(host) : undefined;
+        return fs.existsSync(host) ? `${quoteShell(host)} | cat` : undefined;
     }
     return undefined;
 }
@@ -301,6 +351,7 @@ async function runBridgeRequests(command, requests, timeoutMs) {
     return await new Promise((resolve, reject) => {
         const child = spawn(command, {
             shell: true,
+            env: { ...process.env, ...linuxPluginLibraryEnv(process.env, process.platform) },
             stdio: ["pipe", "pipe", "pipe"],
         });
         const stdoutChunks = [];
@@ -314,12 +365,40 @@ async function runBridgeRequests(command, requests, timeoutMs) {
             clearTimeout(timer);
             callback();
         };
+        const unanswered = new Set(requests.map((request) => request.id));
         const timer = setTimeout(() => {
+            child.stdin?.end();
             child.kill("SIGKILL");
-            settle(() => reject(new Error(`FULU bridge request timed out after ${timeoutMs}ms.`)));
+            // Keep what the host did say: a hung host is diagnosed from its stderr and partial answers.
+            const responses = Object.fromEntries(parseBridgeFrames(Buffer.concat(stdoutChunks))
+                .filter((frame) => frame.type === FRAME_TYPE_JSON_RESPONSE)
+                .map((frame) => [String(frame.id), (() => { try {
+                    return JSON.parse(frame.payload.toString("utf8"));
+                }
+                catch {
+                    return null;
+                } })()]));
+            const stderr = Buffer.concat(stderrChunks).toString("utf8").trim().slice(-1000);
+            const hints = bridgeHints(null, responses);
+            settle(() => reject(new Error(`FULU bridge request timed out after ${timeoutMs}ms with ${unanswered.size} of ${requests.length} request(s) unanswered.` +
+                (stderr ? ` Host stderr: ${stderr}` : "") + (hints.length ? ` ${hints.join(" ")}` : ""))));
         }, timeoutMs);
-        child.stdout?.on("data", (chunk) => stdoutChunks.push(chunk));
+        // FULU's host exits on stdin EOF without answering requests still in
+        // flight, so stdin closes only once every request has a response.
+        child.stdout?.on("data", (chunk) => {
+            stdoutChunks.push(chunk);
+            if (!unanswered.size)
+                return;
+            for (const frame of parseBridgeFrames(Buffer.concat(stdoutChunks))) {
+                if (frame.type === FRAME_TYPE_JSON_RESPONSE)
+                    unanswered.delete(frame.id);
+            }
+            if (!unanswered.size)
+                child.stdin?.end();
+        });
         child.stderr?.on("data", (chunk) => stderrChunks.push(chunk));
+        // A host that exits early (exit code 101) closes the pipe; close reports the result.
+        child.stdin?.on("error", () => { });
         child.on("error", (error) => {
             settle(() => reject(error));
         });
@@ -357,7 +436,8 @@ async function runBridgeRequests(command, requests, timeoutMs) {
         for (const request of requests) {
             child.stdin?.write(writeJsonRequestFrame(request.id, request.method, request.payload));
         }
-        child.stdin?.end();
+        if (!unanswered.size)
+            child.stdin?.end();
     });
 }
 async function probeFuluBridge(command, timeoutMs) {
@@ -366,9 +446,13 @@ async function probeFuluBridge(command, timeoutMs) {
         { id: 2, method: "bridge.capabilities", payload: {} },
         { id: 3, method: "bridge.runtime_info", payload: {} },
     ], timeoutMs);
+    const handshake = probe.responses["1"];
+    const hints = bridgeHints(probe.exitCode, probe.responses);
     return {
         exitCode: probe.exitCode,
-        ok: probe.ok && Boolean(probe.responses["1"]),
+        // A handshake from a host that could not load the networking plug-in is not a ready bridge.
+        ok: probe.ok && Boolean(handshake) && handshake?.ok !== false && handshake?.network_loaded !== false,
+        ...(hints.length ? { hints } : {}),
         stderr: probe.stderr,
         logs: probe.logs,
         handshake: probe.responses["1"] || null,
@@ -400,6 +484,7 @@ export async function invokeFuluBridgeRpc(options) {
     }
     const command = options.bridgeCommand || process.env.FULU_BAMBU_BRIDGE_COMMAND || "";
     const bridgeResult = await runBridgeRequests(command, [{ id: 1, method, payload: options.payload || {} }], options.timeoutMs || 5000);
+    const hints = bridgeHints(bridgeResult.exitCode, bridgeResult.responses);
     return {
         method,
         readOnly,
@@ -408,6 +493,7 @@ export async function invokeFuluBridgeRpc(options) {
         bambuModel: options.bambuModel || undefined,
         exitCode: bridgeResult.exitCode,
         ok: bridgeResult.ok,
+        ...(hints.length ? { hints } : {}),
         stderr: bridgeResult.stderr,
         logs: bridgeResult.logs,
         response: bridgeResult.responses["1"] || null,
@@ -446,6 +532,12 @@ export async function inspectFuluOrcaSetup(options) {
         pluginDir: pluginDir || null,
         runtimeDir: runtimeDir || null,
         bridgeCommand: bridgeCommand || null,
+        // Linux only: absolute plug-in library paths passed to FULU's host (FULU #51).
+        ...(platform === "linux" ? { pluginLibraries: {
+                ...Object.fromEntries(["PJARCZAK_BAMBU_NETWORK_SO", "PJARCZAK_BAMBU_SOURCE_SO"]
+                    .filter((name) => process.env[name]?.trim()).map((name) => [name, process.env[name].trim()])),
+                ...linuxPluginLibraryEnv(process.env, process.platform),
+            } } : {}),
         fileChecks,
         missingRequiredFiles,
         optionalMissingFiles,
@@ -471,7 +563,12 @@ export async function inspectFuluOrcaSetup(options) {
             "Bambu print start still enforces BAMBU_MODEL before generating or sending project G-code.",
             "Raw bridge print methods are disabled; print_3mf inspects the exact plate, checks the live printer and asks for human confirmation.",
             "The FULU BambuNetwork bridge is a separate runtime from the LAN MQTT/FTPS path; use bridge probing to verify that runtime before relying on cloud behavior.",
-            "FULU macOS release bundles may ship the bridge dylib and host shims before the Linux plugin .so payload is present; missing linux-plugin entries mean the slicer can still be tested, but the BambuNetwork bridge is not fully ready.",
+            ...(platform === "darwin"
+                ? ["FULU macOS release bundles may ship the bridge dylib and host shims before the Linux plugin .so payload is present; missing linux-plugin entries mean the slicer can still be tested, but the BambuNetwork bridge is not fully ready."]
+                : []),
+            ...(platform === "linux"
+                ? ["FULU's v1.0.0 Linux host exits 101 when its stdout is a Node.js socket (FULU #50) and opens the plug-in libraries from its working directory (FULU #51). Pipe the host through cat and set PJARCZAK_BAMBU_PLUGIN_DIR; the server then passes the absolute library paths."]
+                : []),
         ],
     };
 }

package/dist/index.js

@@ -220,11 +220,11 @@ const SLICE_TOOL_PROPERTIES = {
         description: "Template directory override when resolving template_name (default: BAMBU_TEMPLATE_DIR or ~/Sync/bambu/templates).",
     },
     uptodate: { type: "boolean", description: "Bambu-compatible slicing: refresh 3MF preset configs to the installed slicer version (--uptodate)." },
-    repetitions: { type: "number", description: "Bambu-compatible slicing: print N identical copies (--repetitions)." },
+    repetitions: { type: "number", description: "Bambu-compatible slicing: print N identical copies (--repetitions). OrcaSlicer copies an STL with --clone-objects; do not combine with clone_objects." },
     orient: { type: "boolean", description: "Bambu-compatible slicing: auto-orient for printability (--orient)." },
-    arrange: { type: "boolean", description: "Bambu-compatible slicing: auto-arrange objects on the plate (--arrange). Set false to keep an existing layout." },
+    arrange: { type: "boolean", description: "Bambu-compatible slicing: auto-arrange objects on the plate (--arrange); STL input is arranged by default. Set false to keep an existing layout: an STL that is not already on the plate then fails to slice." },
     ensure_on_bed: { type: "boolean", description: "Bambu-compatible slicing: lower floating models onto the bed (--ensure-on-bed)." },
-    clone_objects: { type: "string", description: "Bambu-compatible slicing: comma-separated clone counts per object index, e.g. '1,3,1,10'." },
+    clone_objects: { type: "string", description: "Bambu-compatible slicing: clone the loaded model, total copies as a single integer, e.g. '3' (--clone-objects). The Bambu-style CLIs count copies per input file and this tool loads one file, so a comma-separated list is rejected by the slicer." },
     skip_objects: { type: "string", description: "Bambu-compatible slicing: comma-separated object indices to skip, e.g. '3,5,10'." },
     enable_timelapse: { type: "boolean", description: "Bambu-compatible slicing: insert timelapse parking moves (--enable-timelapse)." },
     allow_mix_temp: { type: "boolean", description: "Bambu-compatible slicing: allow filaments with different temperature requirements on one plate." },

package/dist/printers/bambu.js

@@ -8,7 +8,7 @@ import { BambuClient, PushAllCommand } from "bambu-node";
 import { MAX_PRINT_FILE_BYTES, readSafe3mfArchive } from "../safety/archive.js";
 import { inspectPrintFile } from "../safety/print-file.js";
 import { normalizeModel, validateTemperature } from "../safety/limits.js";
-import { manualHeatingRequirements, publishBambuCommand, readFreshPrinterStatus, validatePrinterState, } from "../safety/printer-state.js";
+import { manualHeatingRequirements, publishBambuCommand, readFreshPrinterStatus, unchippedNozzles, validatePrinterState, } from "../safety/printer-state.js";
 import { cancelPendingPrinterOperations, normalizedRemotePath, uniquePrintName, withPrinterOperation, withPrintSnapshot, } from "../safety/artifact.js";
 import { requireHumanConfirmation } from "../safety/confirmation.js";
 import { installBambuNodeRejectionGuard } from "./bambu-node-guard.js";
@@ -118,10 +118,13 @@ export class BambuImplementation extends PrinterImplementation {
     }
     async confirmPrintPreflight(serial, status, inspection) {
         const finishedJob = this.finishedJobIdentity(status);
+        const unchipped = unchippedNozzles(status?.raw);
         await this.confirmHardwareAction(`Start a checked print on ${inspection.model.toUpperCase()} (${serial})? Nozzles: ${inspection.nozzleDiameters.join(", ")} mm. ` +
             `Materials: ${inspection.materials.join(", ")}. Peak targets: nozzle ${inspection.maxNozzleTemperature}°C, bed ${inspection.maxBedTemperature}°C, chamber ${inspection.maxChamberTemperature}°C. ` +
             `File SHA-256: ${inspection.sha256}. Confirm the physical spool labels and that the build plate is clear.` +
-            (finishedJob !== undefined ? " The printer reports FINISH: remove the previous part and debris before confirming." : ""), finishedJob !== undefined);
+            (finishedJob !== undefined ? " The printer reports FINISH: remove the previous part and debris before confirming." : "") +
+            (unchipped.length ? ` Printer ${unchipped.length === 1 ? `nozzle ${unchipped[0]} reports` : `nozzles ${unchipped.join(" and ")} report`} no identity chip, ` +
+                `so ${unchipped.length === 1 ? "its" : "their"} diameter and type are the printer's configured settings; confirm they match the installed ${unchipped.length === 1 ? "hotend" : "hotends"}.` : ""), finishedJob !== undefined);
         return finishedJob;
     }
     assertBedClearance(status, confirmedFinishedJob) {
@@ -180,8 +183,12 @@ export class BambuImplementation extends PrinterImplementation {
             catch (error) {
                 console.warn("PushAllCommand failed, continuing with cached status", error);
             }
-            if (!printer.data || Object.keys(printer.data).length === 0) {
-                await new Promise((resolve) => setTimeout(resolve, 1500));
+            // The first push after connecting can be a sparse hello (model and
+            // modules); the full status follows. Returning before it merges reported
+            // status UNKNOWN, so wait for gcode_state within the same 1.5 s bound.
+            const deadline = Date.now() + 1500;
+            while (typeof printer.data?.gcode_state !== "string" && Date.now() < deadline) {
+                await sleep(50);
             }
             const data = printer.data;
             return {

package/dist/safety/confirmation.js

@@ -37,7 +37,14 @@ export const CONFIRMATION_UNAVAILABLE = "Human hardware confirmation requires an
 export async function requireHumanConfirmation(confirm, message, scope, physicalCheck = false) {
     if (!physicalCheck && confirmationOptOut(scope))
         return;
-    if (!confirm || !(await confirm(message))) {
-        throw new Error("Hardware safety confirmation was declined or unavailable. Use an MCP client with elicitation support. No command was sent.");
+    if (!confirm)
+        throw new Error(CONFIRMATION_UNAVAILABLE);
+    if (!(await confirm(message))) {
+        throw new Error("Hardware safety confirmation was declined or cancelled in the MCP client. No command was sent. " + (physicalCheck
+            ? "This confirmation covers a physical check at the printer and always needs a person to accept it."
+            : "Some clients decline prompts automatically, for example in a non-interactive permission mode. A deliberately headless " +
+                `setup that approves jobs another way can set ${scope === "bambu"
+                    ? "PRINT_REQUIRE_CONFIRMATION=0 (or BAMBU_REQUIRE_CONFIRMATION=0)"
+                    : "PRINT_REQUIRE_CONFIRMATION=0"} to skip ordinary print and heating prompts.`));
     }
 }

package/dist/safety/printer-state.d.ts

@@ -44,6 +44,8 @@ export interface ValidatedPrinterState {
     reportedNozzles: ReportedNozzle[];
     filaments: ReportedFilament[];
 }
+/** Nozzles whose reported diameter and type are configured settings rather than chip readings. */
+export declare function unchippedNozzles(raw: unknown): number[];
 /** Verifies reported configuration, not a physical nozzle/spool inspection. */
 export declare function validatePrinterState(status: any, requirements: PrinterStateRequirements): ValidatedPrinterState;
 /** Manual M104 cannot remap filament slots. Validate the material already at the nozzle. */

package/dist/safety/printer-state.js

@@ -138,6 +138,41 @@ function nozzleTypeAndFlow(value) {
     const type = token(value);
     return { type: ["stainlesssteel", "hardenedsteel", "tungstencarbide", "brass"].includes(type) ? type : undefined };
 }
+/**
+ * A nozzle without an identity chip reports serial "N/A" and keeps the
+ * unreliable bit set permanently (stock H2D HS01 nozzles), so its diameter
+ * and type are configured settings, as on single-nozzle printers.
+ */
+function hasNoIdentityChip(entry) {
+    return typeof entry?.sn === "string" && entry.sn.trim().toUpperCase() === "N/A";
+}
+/** Bit 0 (information unreliable) is accepted only from a nozzle without an identity chip. */
+function unreliableWithoutChip(entry, stat) {
+    return (stat & 1) !== 0 && hasNoIdentityChip(entry);
+}
+/** Nozzles whose reported diameter and type are configured settings rather than chip readings. */
+export function unchippedNozzles(raw) {
+    const info = raw?.device?.nozzle?.info;
+    if (!Array.isArray(info))
+        return [];
+    return info.flatMap(entry => {
+        const index = finiteNumber(entry?.id);
+        const stat = finiteNumber(entry?.stat);
+        return index !== undefined && Number.isInteger(index) && index >= 0 && index < 16 &&
+            stat !== undefined && Number.isInteger(stat) && stat >= 0 && unreliableWithoutChip(entry, stat) ? [index] : [];
+    });
+}
+const loggedUnchippedNozzles = new Set();
+/** Name each unchipped nozzle a check accepted once per printer on stderr, so headless runs still record it. */
+function logUnchippedNozzles(raw, serial) {
+    for (const index of unchippedNozzles(raw)) {
+        const key = `${serial}:${index}`;
+        if (loggedUnchippedNozzles.has(key))
+            continue;
+        loggedUnchippedNozzles.add(key);
+        console.error(`Printer ${serial || "(unknown serial)"} nozzle ${index} reports no identity chip; its diameter and type are the printer's configured settings.`);
+    }
+}
 function reportedNozzles(raw) {
     const info = raw.device?.nozzle?.info;
     const output = [];
@@ -151,9 +186,13 @@ function reportedNozzles(raw) {
             if (index === undefined || !Number.isInteger(index) || index < 0 || diameter === undefined || diameter <= 0)
                 throw new Error("Printer reported malformed nozzle identity or diameter.");
             if (entry.stat !== undefined) {
+                // BambuStudio DevNozzle: bit 0 set means the information is unreliable;
+                // bits 1-2 are 0 normal, 1 abnormal, 2 unknown.
                 const stat = finiteNumber(entry.stat);
-                if (stat === undefined || !Number.isInteger(stat) || stat < 0 || (stat & 7) !== 0)
+                if (stat === undefined || !Number.isInteger(stat) || stat < 0 || (stat & 6) !== 0)
                     throw new Error(`Printer nozzle ${index} information is unreliable, abnormal or unknown.`);
+                if ((stat & 1) !== 0 && !unreliableWithoutChip(entry, stat))
+                    throw new Error(`Printer nozzle ${index} information is unreliable; refresh the nozzle information on the printer.`);
             }
             if (output.some(nozzle => nozzle.index === index))
                 throw new Error("Printer reported ambiguous duplicate nozzle indices.");
@@ -338,6 +377,8 @@ export function validatePrinterState(status, requirements) {
             filaments.push({ position, material, trayIndex, nozzleMin, nozzleMax });
         }
     }
+    if (nozzles.length)
+        logUnchippedNozzles(raw, identity.observedSerial ?? String(status.serial ?? ""));
     return { model, reportedNozzles: nozzles, filaments };
 }
 /** Manual M104 cannot remap filament slots. Validate the material already at the nozzle. */

package/dist/slicer/bambu-cli.d.ts

@@ -100,8 +100,28 @@ export declare class BambuCliProfilePreparer {
      */
     private isolateMachineSettings;
 }
+/** How the CLI receives the model: Orca STL transforms are applied to a mesh copy first. */
+export interface BambuCliInput {
+    slicerType: BambuCliSlicerType;
+    is3mf: boolean;
+    /** scale and rotations are already applied to the mesh passed to the CLI. */
+    meshTransformed: boolean;
+}
+/**
+ * Decide how the CLI receives the model. OrcaSlicer's CLI (upstream and FULU)
+ * crashes with SIGSEGV in PartPlate::check_outside, which needs the GUI's
+ * Plater, when --scale or --rotate-x/-y move an object below the bed while it
+ * arranges, the default for STL input. An Orca STL's transforms are therefore
+ * applied to a mesh copy; combinations the CLI cannot handle are refused.
+ */
+export declare function planBambuCliInput(slicerType: BambuCliSlicerType, is3mf: boolean, options: BambuSliceOptions): BambuCliInput;
+/**
+ * The CLI's own reason for a failed run: result.json in the run's fresh output
+ * directory (written on Linux for handled errors), else the exit-code table.
+ */
+export declare function bambuCliFailureReason(exitCode: number | null, outputDir: string): string | undefined;
 /** CLI flags for the prepared bundle and caller options (input path appended by the caller). */
-export declare function buildBambuCliArgs(bundle: BambuSettingsBundle, outputDir: string, exportName: string, options: BambuSliceOptions): string[];
+export declare function buildBambuCliArgs(bundle: BambuSettingsBundle, outputDir: string, exportName: string, options: BambuSliceOptions, input: BambuCliInput): string[];
 /**
  * A sliced Bambu project must contain at least one nonempty
  * Metadata/plate_<n>.gcode entry. A .gcode.md5 checksum or the unsliced

package/dist/slicer/bambu-cli.js

@@ -469,8 +469,76 @@ const PROFILE_METADATA_KEYS = new Set([
     "name", "type", "from", "inherits", "instantiation", "setting_id", "version", "is_custom_defined",
     "compatible_printers", "compatible_printers_condition", "compatible_prints", "compatible_prints_condition",
 ]);
+/**
+ * Decide how the CLI receives the model. OrcaSlicer's CLI (upstream and FULU)
+ * crashes with SIGSEGV in PartPlate::check_outside, which needs the GUI's
+ * Plater, when --scale or --rotate-x/-y move an object below the bed while it
+ * arranges, the default for STL input. An Orca STL's transforms are therefore
+ * applied to a mesh copy; combinations the CLI cannot handle are refused.
+ */
+export function planBambuCliInput(slicerType, is3mf, options) {
+    const input = { slicerType, is3mf, meshTransformed: false };
+    if (slicerType === "bambustudio")
+        return input;
+    const tilts = !!options.rotateX || !!options.rotateY;
+    if (is3mf) {
+        if (options.arrange === true && ((options.scale ?? 1) > 1 || tilts)) {
+            throw new Error("OrcaSlicer's CLI crashes when scale above 1, rotate_x or rotate_y moves a 3MF object below the bed while arranging. " +
+                "Set arrange to false, or apply the transform in the slicer and export the project.");
+        }
+        return input;
+    }
+    if (options.repetitions !== undefined && options.cloneObjects) {
+        throw new Error("Use either repetitions or clone_objects for an STL with OrcaSlicer, not both.");
+    }
+    return { ...input, meshTransformed: options.scale !== undefined || tilts };
+}
+/**
+ * Bambu Studio and OrcaSlicer CLI errors (libslic3r/Utils.hpp). The process
+ * exits with the low byte of the code; on Linux result.json names the error.
+ */
+const BAMBU_CLI_ERRORS = {
+    [-2]: "invalid parameters to the slicer",
+    [-3]: "input files not found",
+    [-5]: "preset file cannot be parsed",
+    [-6]: "model file cannot be parsed",
+    [-9]: "copying objects failed",
+    [-17]: "printer is not compatible with the process preset",
+    [-21]: "auto-arranging objects failed",
+    [-22]: "auto-orienting objects failed",
+    [-50]: "a plate is empty or has no object fully inside it; arrange the model or place it on the plate",
+    [-51]: "incorrect slicing parameters",
+    [-52]: "objects extend over the bed boundary",
+    [-60]: "no printable objects remain after skipping",
+    [-61]: "filaments are not compatible with the plate type",
+    [-62]: "the filaments' temperatures differ too much",
+    [-63]: "objects collide in print-by-object mode",
+    [-64]: "objects collide",
+    [-100]: "slicing the model failed",
+    [-101]: "G-code conflicts after slicing",
+    [-102]: "G-code in an unprintable area",
+};
+/**
+ * The CLI's own reason for a failed run: result.json in the run's fresh output
+ * directory (written on Linux for handled errors), else the exit-code table.
+ */
+export function bambuCliFailureReason(exitCode, outputDir) {
+    try {
+        const result = JSON.parse(fs.readFileSync(path.join(outputDir, "result.json"), "utf8"));
+        if (typeof result?.error_string === "string" && result.error_string.trim()) {
+            return `${result.error_string.trim()}${result.return_code !== undefined ? ` [${result.return_code}]` : ""}`;
+        }
+    }
+    catch {
+        // result.json is written only on Linux and only for handled errors.
+    }
+    if (exitCode === null)
+        return undefined;
+    const code = Object.keys(BAMBU_CLI_ERRORS).map(Number).find((value) => value === exitCode || (value & 0xff) === exitCode);
+    return code === undefined ? undefined : `${BAMBU_CLI_ERRORS[code]} [${code}]`;
+}
 /** CLI flags for the prepared bundle and caller options (input path appended by the caller). */
-export function buildBambuCliArgs(bundle, outputDir, exportName, options) {
+export function buildBambuCliArgs(bundle, outputDir, exportName, options, input) {
     const args = [
         "--slice", String(options.slicePlate ?? 0),
         "--outputdir", outputDir,
@@ -496,16 +564,23 @@ export function buildBambuCliArgs(bundle, outputDir, exportName, options) {
         args.push("--orient", options.orient ? "1" : "0");
     if (options.arrange !== undefined)
         args.push("--arrange", options.arrange ? "1" : "0");
-    if (options.repetitions !== undefined)
-        args.push("--repetitions", String(options.repetitions));
-    if (options.scale !== undefined)
-        args.push("--scale", String(options.scale));
-    if (options.rotate !== undefined)
-        args.push("--rotate", String(options.rotate));
-    if (options.rotateX !== undefined)
-        args.push("--rotate-x", String(options.rotateX));
-    if (options.rotateY !== undefined)
-        args.push("--rotate-y", String(options.rotateY));
+    if (options.repetitions !== undefined) {
+        // OrcaSlicer rejects --repetitions for one STL; it copies the loaded model with --clone-objects.
+        if (input.slicerType !== "bambustudio" && !input.is3mf)
+            args.push("--clone-objects", String(options.repetitions));
+        else
+            args.push("--repetitions", String(options.repetitions));
+    }
+    if (!input.meshTransformed) {
+        if (options.scale !== undefined)
+            args.push("--scale", String(options.scale));
+        if (options.rotate !== undefined)
+            args.push("--rotate", String(options.rotate));
+        if (options.rotateX !== undefined)
+            args.push("--rotate-x", String(options.rotateX));
+        if (options.rotateY !== undefined)
+            args.push("--rotate-y", String(options.rotateY));
+    }
     if (options.cloneObjects)
         args.push("--clone-objects", options.cloneObjects);
     if (options.skipObjects)

package/dist/slicer/run-slicer.d.ts

@@ -5,6 +5,8 @@ export interface SlicerRunOptions {
     slicerType: string;
     /** Polled while the slicer runs; returning true kills it. */
     isCancelled?: () => boolean;
+    /** The slicer's own reason for a nonzero exit, read before its output directory is removed. */
+    failureReason?: (exitCode: number | null) => string | undefined;
 }
 export interface SlicerRunResult {
     stdoutTail: string;