mcp-3d-printer-server 1.2.28 → 1.2.29

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.2.29] – 2026-11-04
+
+### Changed
+
+- With no method given, a FULU print over Bambu Cloud goes the way Bambu Studio sends it to a cloud-bound printer it can reach on the LAN (`PrintJob.cpp`): `start_local_print_with_record`, which uploads to the printer over the LAN and records the task in the account, in the account's cloud session. When that fails before the print command (the plug-in's `-2010` to `-2140` preparation results, other than a missing or oversized file), the same checked job goes once through `start_print`, with the printer checked again first. Any other failure may have reached the printer and is not sent again. A printer that reports no storage goes straight to `start_print`, as in Studio. Same change as bambu-printer-mcp 1.1.55. On a P1S with firmware 01.10.00.00, `start_print` alone returns `-3120`, HTTP 403 "internal blocking", every time. Errors name `-2120`, `-2130` and `-3120`. Checked with the stand-in host and intercepted transports only; not yet on a printer.
+
 ## [1.2.28] – 2026-11-04
 
 ### Added

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

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

package/dist/bambu-network-bridge.js

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

package/dist/index.js

@@ -34,7 +34,7 @@ import { BambuNetworkBridge, describeBambuNetworkPrintError } from "./bambu-netw
 import { PRINT_ROUTES, connectionForRoute, routeOf, routeOptions, writeEnvValues } from "./counterpart/route.js";
 import { resolveStudioPrintOptions, usedNozzleCount } from "./studio-print-options.js";
 import { inspectPrintFile } from "./safety/print-file.js";
-import { validatePrinterState } from "./safety/printer-state.js";
+import { externalStorageState, validatePrinterState } from "./safety/printer-state.js";
 import { uniquePrintName, withPrinterOperation, withPrintSnapshot } from "./safety/artifact.js";
 import { checkedFile } from "./printers/bambu.js";
 import { CONFIRMATION_UNAVAILABLE, confirmationTimedOut, confirmationTimeoutMs } from "./safety/confirmation.js";
@@ -881,8 +881,10 @@ class ThreeDPrinterMCPServer {
             throw new Error("FULU BambuNetwork printing requires bambu_serial, the printer host and its LAN access code: fresh printer state is checked over MQTT before every bridge print, including cloud dispatch.");
         }
         const isLocalBridgePrint = connectionType === "lan";
-        const bridgePrintMethod = isLocalBridgePrint ? "start_local_print" : "start_print";
-        const bridgeMethod = `net.${bridgePrintMethod}`;
+        // Bambu Studio sends a cloud-bound printer it can reach on the LAN with record first, in the cloud
+        // session, then start_print (PrintJob.cpp). This server always has the printer's IP and access code.
+        let bridgeMethod = isLocalBridgePrint ? "net.start_local_print" : "net.start_local_print_with_record";
+        let cloudFallbackMethod = isLocalBridgePrint ? undefined : "net.start_print";
         const { plateIndex } = options;
         const threeMfFilename = path.basename(options.threeMFPath);
         const projectName = threeMfFilename.replace(/\.3mf$/i, "");
@@ -923,6 +925,11 @@ class ThreeDPrinterMCPServer {
             validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
             const confirmedStatus = await bambu.getSafetyStatus(devIp, devId, password);
             validatePrinterState(confirmedStatus, requirements);
+            if (cloudFallbackMethod && externalStorageState(confirmedStatus.raw) !== "normal") {
+                // Studio sends straight through the cloud when the printer has no storage for the LAN upload.
+                bridgeMethod = cloudFallbackMethod;
+                cloudFallbackMethod = undefined;
+            }
             const wireMapping = mapping.map((value) => bridgeAmsMappingValue(value, dualNozzle));
             const remoteFileName = uniquePrintName(options.threeMFPath);
             const checkedName = remoteFileName.replace(/(?:\.gcode)?\.3mf$/i, "");
@@ -979,23 +986,29 @@ class ThreeDPrinterMCPServer {
             const bridgeOptions = {
                 // Trusted in-process preflight immediately before the print frame.
                 beforeDispatch: async (method) => {
-                    if (method !== bridgeMethod)
+                    if (method !== bridgeMethod && method !== cloudFallbackMethod)
                         return;
                     assertActive();
                     validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
                 },
-                assertDispatchAllowed: (method) => { if (method === bridgeMethod)
+                assertDispatchAllowed: (method) => { if (method === bridgeMethod || method === cloudFallbackMethod)
                     assertActive(); },
-                onDispatched: (method) => { if (method === bridgeMethod)
+                onDispatched: (method) => { if (method === bridgeMethod || method === cloudFallbackMethod)
                     retainForDispatchedUpload(); },
             };
             let jobUpdates = [];
             let bridgeResult;
+            let firstAttempt = "";
             if (isLocalBridgePrint) {
                 ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startLocalPrint({ devId, devIp, username: "bblp", password, useSsl: true }, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive));
             }
             else {
-                ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive));
+                let firstFailure;
+                ({ result: bridgeResult, jobUpdates, firstFailure } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive, undefined, cloudFallbackMethod));
+                if (firstFailure !== undefined) {
+                    bridgeMethod = cloudFallbackMethod;
+                    firstAttempt = ` It first tried net.start_local_print_with_record, as Bambu Studio does, which returned ${firstFailure}${describeBambuNetworkPrintError(firstFailure)}.`;
+                }
             }
             if (typeof bridgeResult === "object" && bridgeResult !== null && bridgeResult.ok === false) {
                 throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} failed: ${String(bridgeResult.error || "unknown bridge error")}`);
@@ -1005,14 +1018,14 @@ class ThreeDPrinterMCPServer {
                 const reported = jobUpdates.filter((update) => update.code !== 0 || update.msg).slice(-3)
                     .map((update) => `status ${update.status}, code ${update.code}${update.msg ? `: ${update.msg}` : ""}`).join("; ");
                 throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} returned non-zero result ${value}${describeBambuNetworkPrintError(value)}.` +
-                    (reported ? ` Plug-in reported: ${reported}.` : ""));
+                    (reported ? ` Plug-in reported: ${reported}.` : "") + firstAttempt);
             }
             assertActive();
             // Bambu's plug-in placed the file, so a resume re-reads it if it can and otherwise asks a person.
             bambu.recordCheckedJob(devIp, devId, remoteFileName, requirements, resumeFile, false);
             return {
                 status: "success",
-                message: `FULU BambuNetwork ${bridgePrintMethod} command for ${threeMfFilename} sent successfully.`,
+                message: `FULU BambuNetwork ${bridgeMethod.replace(/^net\./, "")} command for ${threeMfFilename} sent successfully.${firstAttempt}`,
                 connectionMode: "bambu_network",
                 connectionType,
                 bridgeMethod,

package/package.json

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

package/server.json

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

package/src/bambu-network-bridge.ts

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

package/src/index.ts

@@ -75,7 +75,7 @@ import { BambuNetworkBridge, describeBambuNetworkPrintError, type BridgeJobUpdat
 import { PRINT_ROUTES, connectionForRoute, routeOf, routeOptions, writeEnvValues, type PrintRoute } from "./counterpart/route.js";
 import { resolveStudioPrintOptions, usedNozzleCount, type CallerPrintOptions } from "./studio-print-options.js";
 import { inspectPrintFile } from "./safety/print-file.js";
-import { validatePrinterState } from "./safety/printer-state.js";
+import { externalStorageState, validatePrinterState } from "./safety/printer-state.js";
 import { uniquePrintName, withPrinterOperation, withPrintSnapshot } from "./safety/artifact.js";
 import { checkedFile } from "./printers/bambu.js";
 import { CONFIRMATION_UNAVAILABLE, confirmationTimedOut, confirmationTimeoutMs } from "./safety/confirmation.js";
@@ -1074,8 +1074,10 @@ class ThreeDPrinterMCPServer {
       throw new Error("FULU BambuNetwork printing requires bambu_serial, the printer host and its LAN access code: fresh printer state is checked over MQTT before every bridge print, including cloud dispatch.");
     }
     const isLocalBridgePrint = connectionType === "lan";
-    const bridgePrintMethod = isLocalBridgePrint ? "start_local_print" : "start_print";
-    const bridgeMethod = `net.${bridgePrintMethod}`;
+    // Bambu Studio sends a cloud-bound printer it can reach on the LAN with record first, in the cloud
+    // session, then start_print (PrintJob.cpp). This server always has the printer's IP and access code.
+    let bridgeMethod = isLocalBridgePrint ? "net.start_local_print" : "net.start_local_print_with_record";
+    let cloudFallbackMethod = isLocalBridgePrint ? undefined : "net.start_print";
     const { plateIndex } = options;
     const threeMfFilename = path.basename(options.threeMFPath);
     const projectName = threeMfFilename.replace(/\.3mf$/i, "");
@@ -1116,6 +1118,11 @@ class ThreeDPrinterMCPServer {
       validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
       const confirmedStatus = await bambu.getSafetyStatus(devIp, devId, password);
       validatePrinterState(confirmedStatus, requirements);
+      if (cloudFallbackMethod && externalStorageState(confirmedStatus.raw) !== "normal") {
+        // Studio sends straight through the cloud when the printer has no storage for the LAN upload.
+        bridgeMethod = cloudFallbackMethod;
+        cloudFallbackMethod = undefined;
+      }
       const wireMapping = mapping!.map((value) => bridgeAmsMappingValue(value, dualNozzle));
       const remoteFileName = uniquePrintName(options.threeMFPath);
       const checkedName = remoteFileName.replace(/(?:\.gcode)?\.3mf$/i, "");
@@ -1172,22 +1179,28 @@ class ThreeDPrinterMCPServer {
       const bridgeOptions = {
         // Trusted in-process preflight immediately before the print frame.
         beforeDispatch: async (method: string) => {
-          if (method !== bridgeMethod) return;
+          if (method !== bridgeMethod && method !== cloudFallbackMethod) return;
           assertActive();
           validatePrinterState(await bambu.getSafetyStatus(devIp, devId, password), requirements);
         },
-        assertDispatchAllowed: (method: string) => { if (method === bridgeMethod) assertActive(); },
-        onDispatched: (method: string) => { if (method === bridgeMethod) retainForDispatchedUpload(); },
+        assertDispatchAllowed: (method: string) => { if (method === bridgeMethod || method === cloudFallbackMethod) assertActive(); },
+        onDispatched: (method: string) => { if (method === bridgeMethod || method === cloudFallbackMethod) retainForDispatchedUpload(); },
       };
       let jobUpdates: BridgeJobUpdate[] = [];
       let bridgeResult: unknown;
+      let firstAttempt = "";
       if (isLocalBridgePrint) {
         ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startLocalPrint(
           { devId, devIp, username: "bblp", password, useSsl: true },
           bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive
         ));
       } else {
-        ({ result: bridgeResult, jobUpdates } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive));
+        let firstFailure: number | undefined;
+        ({ result: bridgeResult, jobUpdates, firstFailure } = await this.bambuNetwork.startCloudPrint(devId, bridgeMethod, { client_job_id: clientJobId, params }, bridgeOptions, assertActive, undefined, cloudFallbackMethod));
+        if (firstFailure !== undefined) {
+          bridgeMethod = cloudFallbackMethod!;
+          firstAttempt = ` It first tried net.start_local_print_with_record, as Bambu Studio does, which returned ${firstFailure}${describeBambuNetworkPrintError(firstFailure)}.`;
+        }
       }
       if (typeof bridgeResult === "object" && bridgeResult !== null && (bridgeResult as { ok?: unknown }).ok === false) {
         throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} failed: ${String((bridgeResult as { error?: unknown }).error || "unknown bridge error")}`);
@@ -1197,14 +1210,14 @@ class ThreeDPrinterMCPServer {
         const reported = jobUpdates.filter((update) => update.code !== 0 || update.msg).slice(-3)
           .map((update) => `status ${update.status}, code ${update.code}${update.msg ? `: ${update.msg}` : ""}`).join("; ");
         throw new Error(`FULU BambuNetwork bridge method ${bridgeMethod} returned non-zero result ${value}${describeBambuNetworkPrintError(value)}.` +
-          (reported ? ` Plug-in reported: ${reported}.` : ""));
+          (reported ? ` Plug-in reported: ${reported}.` : "") + firstAttempt);
       }
       assertActive();
       // Bambu's plug-in placed the file, so a resume re-reads it if it can and otherwise asks a person.
       bambu.recordCheckedJob(devIp, devId, remoteFileName, requirements, resumeFile, false);
       return {
         status: "success",
-        message: `FULU BambuNetwork ${bridgePrintMethod} command for ${threeMfFilename} sent successfully.`,
+        message: `FULU BambuNetwork ${bridgeMethod.replace(/^net\./, "")} command for ${threeMfFilename} sent successfully.${firstAttempt}`,
         connectionMode: "bambu_network",
         connectionType,
         bridgeMethod,