mcp-3d-printer-server 1.2.24 → 1.2.26

package/dist/studio-print-options.js

@@ -0,0 +1,179 @@
+/**
+ * The print options Bambu Studio's Send dialog sends, resolved the way it
+ * resolves them, so every print route sends what Bambu's own Print button
+ * would. Source: Bambu Studio v02.08.02.61 (commit 926a7192574b), the version
+ * the hidden-HMS and stage tables are pinned to:
+ *
+ * - SelectMachine.cpp:3344-3356 `set_print_config(bed_type,
+ *   bed_leveling == "on", flow_cali == "on", false, timelapse, true,
+ *   ext_change_assist, bed_leveling.getValueInt(), flow_cali.getValueInt(),
+ *   nozzle_offset_cali.getValueInt(), pa_value_switch ? 0 : 1)`. Vibration
+ *   calibration is always false and layer inspection always true; the
+ *   parameter order is PrintJob.hpp:98-116.
+ * - SelectMachine.cpp:7318-7329 `getValueInt`: off 0, on 1, auto 2.
+ * - SelectMachine.cpp:1117-1123 `update_select_layout`: update_option_opts
+ *   (which choices each option offers on this printer) runs before
+ *   load_option_vals.
+ * - SelectMachine.cpp:2993-3027 `load_option_vals`: the value saved in
+ *   BambuStudio.conf under the printer type, if the option offers it; else
+ *   "auto" if offered; else "on". Dual-nozzle printers then set nozzle offset
+ *   calibration to "auto" for a two-nozzle job and, without a filament
+ *   switcher, "off" for a one-nozzle job.
+ * - SelectMachine.cpp:2586-2615 `update_option_opts`: bed leveling offers
+ *   auto/on/off when the printer's support_bed_leveling is 2 and on/off when it
+ *   is 1; with 0 it is hidden and keeps the auto/on/off it was built with
+ *   (SelectMachine.cpp:676-691), as does flow calibration when the printer has
+ *   no PA calibration. DeviceManager.cpp:1100/4441 give P-series printers
+ *   (series_p1p: P1P, P1S) no PA calibration, so their flow calibration is
+ *   hidden and resolves to "auto". Nozzle offset calibration always offers auto.
+ * - SelectMachine.cpp:705-707: the PA value switch starts on and is not saved,
+ *   so extruder_cali_manual_mode is 0.
+ *
+ * Approximations, outside the P1P/P1S: flow calibration on other printers is
+ * shown when the printer's push status reports PA calibration (assumed here),
+ * and offers auto when support_auto_flow_calibration is true and the mapped
+ * filaments allow it (can_support_pa_auto_cali, assumed true). A filament
+ * switcher on a dual-nozzle printer is assumed absent.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const AUTO_ON_OFF = ["auto", "on", "off"];
+const ON_OFF = ["on", "off"];
+/**
+ * Studio's printer types (resources/printers/<type>.json at the pinned commit:
+ * model_id/printer_type, printer_series, support_bed_leveling,
+ * support_auto_flow_calibration), keyed by this server's model names.
+ */
+const STUDIO_PRINTERS = {
+    p1p: { types: ["C11"], pSeries: true, bedLeveling: 1, autoFlow: false, dualNozzle: false },
+    p1s: { types: ["C12"], pSeries: true, bedLeveling: 1, autoFlow: false, dualNozzle: false },
+    x1c: { types: ["3DPrinter-X1-Carbon"], pSeries: false, bedLeveling: 1, autoFlow: false, dualNozzle: false },
+    x1: { types: ["3DPrinter-X1"], pSeries: false, bedLeveling: 1, autoFlow: false, dualNozzle: false },
+    x1e: { types: ["C13"], pSeries: false, bedLeveling: 1, autoFlow: false, dualNozzle: false },
+    a1mini: { types: ["N1"], pSeries: false, bedLeveling: 1, autoFlow: false, dualNozzle: false },
+    a1: { types: ["N2S"], pSeries: false, bedLeveling: 1, autoFlow: false, dualNozzle: false },
+    p2s: { types: ["N7"], pSeries: false, bedLeveling: 2, autoFlow: true, dualNozzle: false },
+    x2d: { types: ["N6"], pSeries: false, bedLeveling: 2, autoFlow: true, dualNozzle: true },
+    h2s: { types: ["O1S"], pSeries: false, bedLeveling: 2, autoFlow: true, dualNozzle: false },
+    h2d: { types: ["O1D"], pSeries: false, bedLeveling: 2, autoFlow: true, dualNozzle: true },
+    h2dpro: { types: ["O1E"], pSeries: false, bedLeveling: 2, autoFlow: true, dualNozzle: true },
+    h2c: { types: ["O1C", "O1C2"], pSeries: false, bedLeveling: 2, autoFlow: true, dualNozzle: true },
+};
+/** Where Studio keeps BambuStudio.conf; BAMBU_STUDIO_CONFIG overrides it (empty: none). */
+export function studioConfigPath() {
+    const override = process.env.BAMBU_STUDIO_CONFIG;
+    if (override !== undefined)
+        return override.trim() || undefined;
+    if (process.platform === "darwin")
+        return path.join(os.homedir(), "Library", "Application Support", "BambuStudio", "BambuStudio.conf");
+    if (process.platform === "win32")
+        return process.env.APPDATA ? path.join(process.env.APPDATA, "BambuStudio", "BambuStudio.conf") : undefined;
+    return path.join(process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config"), "BambuStudio", "BambuStudio.conf");
+}
+/**
+ * The Send dialog options Studio saved for a printer type, and nothing else:
+ * BambuStudio.conf also holds access codes, so only that one section is kept,
+ * and a parse failure is reported without any of the file's text.
+ */
+export function readStudioSavedOptions(printerTypes, configPath) {
+    if (!configPath)
+        return undefined;
+    let text;
+    try {
+        const stat = fs.statSync(configPath);
+        if (!stat.isFile() || stat.size > 16 * 1024 * 1024)
+            return undefined;
+        text = fs.readFileSync(configPath, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    let config;
+    // Studio appends "# MD5 checksum <hex>" after the JSON.
+    try {
+        config = JSON.parse(text.split("\n").filter(line => !line.trimStart().startsWith("#")).join("\n"));
+    }
+    catch {
+        return undefined;
+    }
+    if (!config || typeof config !== "object")
+        return undefined;
+    for (const type of printerTypes) {
+        const section = config[type];
+        if (!section || typeof section !== "object" || Array.isArray(section))
+            continue;
+        const saved = {};
+        for (const key of ["bed_leveling", "flow_cali", "nozzle_offset_cali", "timelapse"]) {
+            const value = section[key];
+            if (typeof value === "string")
+                saved[key] = value;
+        }
+        return saved;
+    }
+    return undefined;
+}
+function fromInt(value, label) {
+    if (value === 0)
+        return "off";
+    if (value === 1)
+        return "on";
+    if (value === 2)
+        return "auto";
+    throw new Error(`${label} must be 0 (off), 1 (on) or 2 (auto).`);
+}
+const toInt = (value) => value === "off" ? 0 : value === "on" ? 1 : 2;
+/** load_option_vals for one option: saved if offered, else auto if offered, else on. */
+function loaded(saved, offers) {
+    if (saved !== undefined && offers.includes(saved))
+        return { value: saved, source: "studio-config" };
+    return { value: offers.includes("auto") ? "auto" : "on", source: "studio-default" };
+}
+/**
+ * What Studio's Send dialog would send for this model, with the caller's
+ * explicit choices taking precedence. usedNozzles is the number of nozzles the
+ * job uses, for dual-nozzle printers.
+ */
+export function resolveStudioPrintOptions(model, caller = {}, options = {}) {
+    const printer = STUDIO_PRINTERS[model];
+    const saved = printer ? readStudioSavedOptions(printer.types, "configPath" in options ? options.configPath : studioConfigPath()) ?? {} : {};
+    const printerType = printer?.types[0];
+    const bedOffers = !printer || printer.bedLeveling !== 1 ? AUTO_ON_OFF : ON_OFF;
+    const flowOffers = !printer || printer.pSeries || printer.autoFlow ? AUTO_ON_OFF : ON_OFF;
+    const bed = loaded(saved.bed_leveling, bedOffers);
+    const flow = loaded(saved.flow_cali, flowOffers);
+    let offset = loaded(saved.nozzle_offset_cali, AUTO_ON_OFF);
+    if (printer?.dualNozzle && options.usedNozzles !== undefined) {
+        if (options.usedNozzles >= 2)
+            offset = { value: "auto", source: "studio-default" };
+        else if (options.usedNozzles === 1)
+            offset = { value: "off", source: "studio-default" };
+    }
+    const choose = (current, auto, flag, label) => auto !== undefined ? { value: fromInt(auto, label), source: "caller" }
+        : flag !== undefined ? { value: flag ? "on" : "off", source: "caller" }
+            : current;
+    const bedLeveling = choose(bed, caller.autoBedLeveling, caller.bedLeveling, "auto_bed_leveling");
+    const flowCali = choose(flow, caller.autoFlowCali, caller.flowCalibration, "auto_flow_cali");
+    const nozzleOffset = choose(offset, caller.autoOffsetCali, undefined, "auto_offset_cali");
+    const manualMode = caller.extruderCaliManualMode ?? 0;
+    if (!Number.isInteger(manualMode) || manualMode < -1 || manualMode > 1)
+        throw new Error("extruder_cali_manual_mode must be -1, 0 or 1.");
+    return {
+        ...(printerType ? { printerType } : {}),
+        values: { bed_leveling: bedLeveling.value, flow_cali: flowCali.value, nozzle_offset_cali: nozzleOffset.value },
+        sources: { bed_leveling: bedLeveling.source, flow_cali: flowCali.source, nozzle_offset_cali: nozzleOffset.source },
+        task_bed_leveling: bedLeveling.value === "on",
+        task_flow_cali: flowCali.value === "on",
+        task_vibration_cali: caller.vibrationCalibration ?? false,
+        task_layer_inspect: caller.layerInspect ?? true,
+        auto_bed_leveling: toInt(bedLeveling.value),
+        auto_flow_cali: toInt(flowCali.value),
+        auto_offset_cali: toInt(nozzleOffset.value),
+        extruder_cali_manual_mode: manualMode,
+    };
+}
+/** The number of nozzles a job's used filaments print from, when the inspection knows. */
+export function usedNozzleCount(inspection) {
+    const nozzles = inspection.usedFilamentPositions.map(position => inspection.filamentNozzleIndices?.[position]).filter((value) => Number.isInteger(value));
+    return nozzles.length === inspection.usedFilamentPositions.length && nozzles.length ? new Set(nozzles).size : undefined;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "mcp-3d-printer-server",
     "mcpName": "io.github.DMontgomery40/mcp-3d-printer-server",
-    "version": "1.2.24",
+    "version": "1.2.26",
     "description": "MCP server for connecting Claude with 3D printer management systems",
     "main": "dist/index.js",
     "repository": "https://github.com/DMontgomery40/mcp-3D-printer-server",
@@ -12,7 +12,7 @@
         "start:http": "MCP_TRANSPORT=streamable-http node dist/index.js",
         "dev": "nodemon src/index.ts --exec \"npm run build && npm start\"",
         "build": "tsc",
-        "test": "npm run build && node dist/test/stl-manipulator-test.js && node --test tests/*.test.mjs tests/slicer/*.test.mjs tests/safety/*.test.mjs",
+        "test": "npm run build && node dist/test/stl-manipulator-test.js && node --test --import ./tests/support/isolate-resume-records.mjs tests/*.test.mjs tests/slicer/*.test.mjs tests/safety/*.test.mjs",
         "inspect": "npm run build && npx @modelcontextprotocol/inspector dist/index.js",
         "prepack": "npm run build",
         "test:package": "node scripts/test-package.mjs",
@@ -68,9 +68,27 @@
         "server.json",
         "dist/counterpart",
         "src/counterpart",
+        "dist/design-guidance.js",
+        "dist/design-guidance.d.ts",
+        "src/design-guidance.ts",
         "dist/fusion-mcp-bridge.js",
         "dist/fusion-mcp-bridge.d.ts",
-        "src/fusion-mcp-bridge.ts"
+        "src/fusion-mcp-bridge.ts",
+        "dist/ams-mapping.js",
+        "dist/ams-mapping.d.ts",
+        "src/ams-mapping.ts",
+        "dist/bambu-network-bridge.js",
+        "dist/bambu-network-bridge.d.ts",
+        "src/bambu-network-bridge.ts",
+        "dist/control-reply.js",
+        "dist/control-reply.d.ts",
+        "src/control-reply.ts",
+        "dist/bambu-network-certs.js",
+        "dist/bambu-network-certs.d.ts",
+        "src/bambu-network-certs.ts",
+        "dist/studio-print-options.js",
+        "dist/studio-print-options.d.ts",
+        "src/studio-print-options.ts"
     ],
     "keywords": [
         "mcp",
@@ -90,7 +108,7 @@
         "@modelcontextprotocol/sdk": "^1.32.2",
         "axios": "^1.21.0",
         "bambu-node": "3.22.21",
-        "basic-ftp": "^6.2.3",
+        "basic-ftp": "^6.2.5",
         "dotenv": "^16.6.1",
         "form-data": "^4.0.6",
         "jszip": "^3.10.2",
@@ -108,5 +126,8 @@
     },
     "engines": {
         "node": ">=18"
+    },
+    "optionalDependencies": {
+        "sharp": "0.35.5"
     }
 }

package/server.json

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

package/src/ams-mapping.ts

@@ -0,0 +1,132 @@
+/** Tray-value options. `dualNozzle` admits 255, the right/main nozzle external spool that
+ * dual-nozzle printers report beside the left/deputy external spool 254 (Bambu Studio
+ * VIRTUAL_TRAY_MAIN_ID / VIRTUAL_TRAY_DEPUTY_ID). Single-nozzle printers keep 254 only. */
+export interface AmsTrayValueOptions { dualNozzle?: boolean }
+
+export function describeAmsTrayRange(options: AmsTrayValueOptions = {}): string {
+  return options.dualNozzle
+    ? "[-1, 15] (absolute tray), 128-253 (AMS-HT), 254 (left/deputy external) or 255 (right/main external)"
+    : "[-1, 15] (absolute tray) or 128-254 (HT/external)";
+}
+
+export function normalizeBridgeAmsTrayValue(value: unknown, label: string, options: AmsTrayValueOptions = {}): number {
+  let numeric: number;
+  if (typeof value === "number") {
+    numeric = value;
+  } else if (typeof value === "string" && value.trim() !== "") {
+    numeric = Number(value);
+  } else {
+    throw new Error(`${label} must be an integer tray index; got ${JSON.stringify(value)}`);
+  }
+
+  if (
+    !Number.isInteger(numeric) ||
+    numeric < -1 ||
+    (numeric > 15 && numeric < 128) ||
+    numeric > (options.dualNozzle ? 255 : 254)
+  ) {
+    throw new Error(
+      `${label} must be an integer in ${describeAmsTrayRange(options)}; got ${JSON.stringify(value)}`
+    );
+  }
+
+  return numeric;
+}
+
+function isNumericMappingKey(key: string): boolean {
+  const numeric = Number(key);
+  return Number.isInteger(numeric) && numeric >= 0;
+}
+
+export function normalizeAmsMappingObject(mapping: Record<string, unknown>, label = "ams_mapping", options: AmsTrayValueOptions = {}): number[] {
+  return Object.entries(mapping)
+    .sort(([leftKey], [rightKey]) => {
+      const leftNumeric = isNumericMappingKey(leftKey);
+      const rightNumeric = isNumericMappingKey(rightKey);
+      if (leftNumeric && rightNumeric) return Number(leftKey) - Number(rightKey);
+      if (leftNumeric) return -1;
+      if (rightNumeric) return 1;
+      return 0;
+    })
+    .map(([key, value]) => normalizeBridgeAmsTrayValue(value, `${label}[${key}]`, options));
+}
+
+export function hasAmsMappingInput(value: unknown): boolean {
+  if (Array.isArray(value)) return value.length > 0;
+  if (value && typeof value === "object") return Object.keys(value as Record<string, unknown>).length > 0;
+  return value !== undefined && value !== null;
+}
+
+/** Flat wire entries use -1 for dual-nozzle virtual trays; ams_mapping2 identifies their spool. */
+export function bridgeAmsMappingValue(value: number, dualNozzle = false): number {
+  return dualNozzle && (value === 254 || value === 255) ? -1 : value;
+}
+
+/** Select an external spool only from a verified physical nozzle on dual-nozzle printers. */
+export function externalTrayForNozzle(nozzle: number | undefined, dualNozzle = false): number {
+  if (!dualNozzle) return 254;
+  if (nozzle === 0) return 255;
+  if (nozzle === 1) return 254;
+  throw new Error("External-spool printing requires inspected filament_map and physical_extruder_map nozzle bindings.");
+}
+
+/** Virtual trays use slot zero on dual-nozzle printers; retain the historical single-nozzle form. */
+export function bridgeAmsMapping2Entry(value: number, dualNozzle = false): { ams_id: number; slot_id: number } {
+  if (value < 0) return { ams_id: 255, slot_id: 255 };
+  if (value === 255) return dualNozzle ? { ams_id: 255, slot_id: 0 } : { ams_id: 255, slot_id: 255 };
+  if (value === 254) return { ams_id: 254, slot_id: dualNozzle ? 0 : 254 };
+  if (value >= 128) return { ams_id: 128, slot_id: value - 128 };
+  return { ams_id: Math.floor(value / 4), slot_id: value % 4 };
+}
+
+/** A project filament as the sliced 3MF's Metadata/project_settings.config declares it. */
+export interface ProjectFilament { type: string; filamentId: string; colour: string; nozzle?: number }
+
+/** Read every project filament (not just the plate's used ones) from project_settings.config. */
+export function projectFilaments(projectSettings: Record<string, unknown>): ProjectFilament[] {
+  const list = (key: string): string[] => Array.isArray(projectSettings[key]) ? (projectSettings[key] as unknown[]).map(String) : [];
+  const types = list("filament_type"), ids = list("filament_ids"), colours = list("filament_colour"), nozzles = list("filament_map");
+  return types.map((type, index) => ({
+    type, filamentId: ids[index] ?? "", colour: colours[index] ?? "",
+    ...(nozzles[index] !== undefined && Number.isInteger(Number(nozzles[index])) ? { nozzle: Number(nozzles[index]) } : {}),
+  }));
+}
+
+/** The colour the printer reports for an absolute tray value (AMS, AMS-HT or external spool). */
+export function trayColour(rawStatus: any, tray: number): string | undefined {
+  const units: any[] = Array.isArray(rawStatus?.ams?.ams) ? rawStatus.ams.ams : [];
+  let colour: unknown;
+  if (tray === 254 || tray === 255) {
+    const slots: any[] = Array.isArray(rawStatus?.vir_slot) ? rawStatus.vir_slot : [];
+    colour = slots.find(slot => Number(slot?.id) === tray)?.tray_color ?? (tray === 254 ? rawStatus?.vt_tray?.tray_color : undefined);
+  } else if (tray >= 128) {
+    colour = units.find(unit => Number(unit?.id) === tray)?.tray?.[0]?.tray_color;
+  } else if (tray >= 0) {
+    const unit = units.find(candidate => Number(candidate?.id) === Math.floor(tray / 4));
+    colour = (Array.isArray(unit?.tray) ? unit.tray : []).find((slot: any) => Number(slot?.id) === tray % 4)?.tray_color;
+  }
+  return typeof colour === "string" ? colour : undefined;
+}
+
+/**
+ * PrintParams.ams_mapping_info exactly as Bambu Studio and FULU's slicer build it
+ * (SelectMachineDialog::get_ams_mapping_result) and send it with every print: one entry per
+ * project filament. A mapped filament names its tray, its filament id and type, its colour as
+ * #RRGGBBAA and the tray's colour as the printer reports it; an unmapped one carries ams -1.
+ * Filament-map nozzle 1 (left) is cloud nozzle 1 and 2 (right) is 0 (CloudTaskNozzleId).
+ */
+export function studioAmsMappingInfo(filaments: ProjectFilament[], mapping: number[], colourOfTray: (tray: number) => string | undefined): Array<Record<string, unknown>> {
+  return filaments.map((filament, position) => {
+    const tray = mapping[position];
+    if (tray === undefined || tray < 0) return { ams: -1, targetColor: "", filamentId: "", filamentType: "" };
+    const hex = filament.colour.replace(/^#/, "").toUpperCase();
+    return {
+      ams: tray,
+      targetColor: colourOfTray(tray) ?? "",
+      filamentId: filament.filamentId,
+      filamentType: filament.type,
+      ...(filament.nozzle === 1 ? { nozzleId: 1 } : filament.nozzle === 2 ? { nozzleId: 0 } : {}),
+      sourceColor: /^[0-9A-F]{6}$/.test(hex) ? `#${hex}FF` : /^[0-9A-F]{8}$/.test(hex) ? `#${hex}` : "",
+    };
+  });
+}