bambu-printer-mcp 1.1.45 → 1.1.46
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/printers/bambu.d.ts
CHANGED
package/dist/printers/bambu.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
|
-
import { isCancelledX2DJob, readFreshPrinterStatus } from "../safety/printer-state.js";
|
|
2
|
+
import { isFinishedP1SJob, isCancelledX2DJob, readFreshPrinterStatus } from "../safety/printer-state.js";
|
|
3
3
|
import fs from "node:fs/promises";
|
|
4
4
|
import { readFileSync, existsSync } from "node:fs";
|
|
5
5
|
import path from "node:path";
|
|
@@ -386,6 +386,10 @@ class BambuClientStore {
|
|
|
386
386
|
this.initialReportResolvers.clear();
|
|
387
387
|
}
|
|
388
388
|
}
|
|
389
|
+
/** What the human confirmed in confirmPrintPreflight, checked again before dispatch. */
|
|
390
|
+
function printJobIdentity(raw) {
|
|
391
|
+
return JSON.stringify([raw.gcode_file, raw.subtask_name, raw.task_id, raw.subtask_id, raw.job_id]);
|
|
392
|
+
}
|
|
389
393
|
/**
|
|
390
394
|
* Split the A1/P1 camera stream on port 6000 into JPEG frames. Each frame is
|
|
391
395
|
* a 16-byte header (payload size LE, itrack, flags, reserved) and the JPEG.
|
|
@@ -439,8 +443,8 @@ export class BambuImplementation {
|
|
|
439
443
|
}
|
|
440
444
|
finishedJobIdentity(status) {
|
|
441
445
|
const raw = status.raw;
|
|
442
|
-
return raw.gcode_state === "FINISH" || isCancelledX2DJob(raw, String(status.model ?? ""))
|
|
443
|
-
?
|
|
446
|
+
return raw.gcode_state === "FINISH" || (isCancelledX2DJob(raw, String(status.model ?? "")) || isFinishedP1SJob(raw, String(status.model ?? "")))
|
|
447
|
+
? printJobIdentity(raw)
|
|
444
448
|
: undefined;
|
|
445
449
|
}
|
|
446
450
|
/**
|
|
@@ -457,7 +461,9 @@ export class BambuImplementation {
|
|
|
457
461
|
`Materials: ${inspection.materials.join(", ")}. Peak targets: nozzle ${inspection.maxNozzleTemperature}°C, bed ${inspection.maxBedTemperature}°C, chamber ${inspection.maxChamberTemperature}°C. ` +
|
|
458
462
|
`File SHA-256: ${inspection.sha256}. Confirm the physical spool labels and that the build plate is clear.` +
|
|
459
463
|
(finishedJob !== undefined ? (status.raw.gcode_state === "FAILED"
|
|
460
|
-
?
|
|
464
|
+
? (isFinishedP1SJob(status.raw, inspection.model)
|
|
465
|
+
? " The previous P1S job ended in FAILED and the printer now reports idle with no print or HMS errors. Remove the previous part and every detached part, support and strand from the plate and nozzle before confirming. No error-reset command is sent."
|
|
466
|
+
: " The previous X2D task was canceled (0300400C): remove every detached part, support and strand from the plate and nozzle before confirming. FAILED is the previous job's terminal state; no error-reset command is sent.")
|
|
461
467
|
: " The printer reports FINISH: remove the previous part and debris before confirming.") : "") +
|
|
462
468
|
(cleared ? ` Previously cleared hardware codes: ${cleared.map(describeHmsKey).join(", ")}. Confirm their physical causes have been resolved.` : "") +
|
|
463
469
|
(notices.length ? ` The printer also reports ${notices.join(", ")}, which Bambu lists for this model without text and never shows as a fault; ` +
|
|
@@ -469,7 +475,8 @@ export class BambuImplementation {
|
|
|
469
475
|
/** Stop a print whose confirmed situation changed: a newly finished job, or a hidden HMS notice the preflight did not name. */
|
|
470
476
|
assertBedClearance(status, preflight) {
|
|
471
477
|
const current = this.finishedJobIdentity(status);
|
|
472
|
-
if (
|
|
478
|
+
if ((preflight.finishedJob !== undefined && printJobIdentity(status.raw) !== preflight.finishedJob)
|
|
479
|
+
|| (current !== undefined && preflight.finishedJob === undefined)) {
|
|
473
480
|
throw new Error("Printer reports a newly finished job. Confirm that its part and debris have been removed before retrying the print.");
|
|
474
481
|
}
|
|
475
482
|
// An X2D raises its hidden camera notice about 15 seconds after boot, so it
|
|
@@ -49,6 +49,10 @@ export interface ValidatedPrinterState {
|
|
|
49
49
|
* and print dispatch must obtain job-bound physical bed-clearance confirmation.
|
|
50
50
|
*/
|
|
51
51
|
export declare function isCancelledX2DJob(raw: Record<string, any>, model: string): boolean;
|
|
52
|
+
/** Bambu Studio 2.8.2.61 marks FAILED as finished. Limit P1S recovery to
|
|
53
|
+
* a named prior job explicitly reporting idle, no print error and no HMS.
|
|
54
|
+
* Its bed still needs job-bound human clearance before every print. */
|
|
55
|
+
export declare function isFinishedP1SJob(raw: Record<string, any>, model: string): boolean;
|
|
52
56
|
/** Nozzles whose reported diameter and type are configured settings rather than chip readings. */
|
|
53
57
|
export declare function unchippedNozzles(raw: unknown): number[];
|
|
54
58
|
/** The one key format for a reported entry, shared by the gate and clear_hms_errors. */
|
|
@@ -130,6 +130,14 @@ export function isCancelledX2DJob(raw, model) {
|
|
|
130
130
|
finiteNumber(raw.print_error) === 0 && finiteNumber(raw.fail_reason) === 0x0300400c &&
|
|
131
131
|
[raw.gcode_file, raw.subtask_name].some(value => typeof value === "string" && value.trim().length > 0);
|
|
132
132
|
}
|
|
133
|
+
/** Bambu Studio 2.8.2.61 marks FAILED as finished. Limit P1S recovery to
|
|
134
|
+
* a named prior job explicitly reporting idle, no print error and no HMS.
|
|
135
|
+
* Its bed still needs job-bound human clearance before every print. */
|
|
136
|
+
export function isFinishedP1SJob(raw, model) {
|
|
137
|
+
return normalizeModel(model) === "p1s" && raw.gcode_state === "FAILED" && raw.print_type === "idle" &&
|
|
138
|
+
finiteNumber(raw.print_error) === 0 && Array.isArray(raw.hms) && raw.hms.length === 0 &&
|
|
139
|
+
[raw.gcode_file, raw.subtask_name].some(value => typeof value === "string" && value.trim().length > 0);
|
|
140
|
+
}
|
|
133
141
|
const token = (value) => typeof value === "string" ? value.trim().toLowerCase().replace(/[\s_-]/g, "") : "";
|
|
134
142
|
function nozzleTypeAndFlow(value) {
|
|
135
143
|
const text = String(value ?? "");
|
|
@@ -310,10 +318,10 @@ function logHiddenNotices(raw, serial, model) {
|
|
|
310
318
|
}
|
|
311
319
|
function validateErrors(raw, requireIdle, serial, model) {
|
|
312
320
|
const state = typeof raw.gcode_state === "string" ? raw.gcode_state.toUpperCase() : "UNKNOWN";
|
|
313
|
-
const
|
|
314
|
-
if (requireIdle && !["IDLE", "FINISH"].includes(state) && !
|
|
321
|
+
const terminal = isCancelledX2DJob(raw, model) || isFinishedP1SJob(raw, model);
|
|
322
|
+
if (requireIdle && !["IDLE", "FINISH"].includes(state) && !terminal)
|
|
315
323
|
throw new Error(`Printer state ${state} is not safely idle.`);
|
|
316
|
-
if (!requireIdle && !["IDLE", "FINISH", "RUNNING", "PAUSE"].includes(state) && !
|
|
324
|
+
if (!requireIdle && !["IDLE", "FINISH", "RUNNING", "PAUSE"].includes(state) && !terminal)
|
|
317
325
|
throw new Error(`Printer state ${state} is unknown or failed.`);
|
|
318
326
|
if (finiteNumber(raw.print_error) !== 0)
|
|
319
327
|
throw new Error("Printer reports a print error or did not report its error state.");
|
package/package.json
CHANGED
package/src/printers/bambu.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
|
-
import { isCancelledX2DJob, readFreshPrinterStatus } from "../safety/printer-state.js";
|
|
2
|
+
import { isFinishedP1SJob, isCancelledX2DJob, readFreshPrinterStatus } from "../safety/printer-state.js";
|
|
3
3
|
import fs from "node:fs/promises";
|
|
4
4
|
import { readFileSync, existsSync } from "node:fs";
|
|
5
5
|
import path from "node:path";
|
|
@@ -472,6 +472,10 @@ class BambuClientStore {
|
|
|
472
472
|
}
|
|
473
473
|
|
|
474
474
|
/** What the human confirmed in confirmPrintPreflight, checked again before dispatch. */
|
|
475
|
+
function printJobIdentity(raw: Record<string, any>): string {
|
|
476
|
+
return JSON.stringify([raw.gcode_file, raw.subtask_name, raw.task_id, raw.subtask_id, raw.job_id]);
|
|
477
|
+
}
|
|
478
|
+
|
|
475
479
|
export type PrintPreflight = { finishedJob?: string; serial: string; model: string; notices: string[] };
|
|
476
480
|
|
|
477
481
|
/**
|
|
@@ -528,8 +532,8 @@ export class BambuImplementation {
|
|
|
528
532
|
|
|
529
533
|
private finishedJobIdentity(status: any): string | undefined {
|
|
530
534
|
const raw = status.raw;
|
|
531
|
-
return raw.gcode_state === "FINISH" || isCancelledX2DJob(raw, String(status.model ?? ""))
|
|
532
|
-
?
|
|
535
|
+
return raw.gcode_state === "FINISH" || (isCancelledX2DJob(raw, String(status.model ?? "")) || isFinishedP1SJob(raw, String(status.model ?? "")))
|
|
536
|
+
? printJobIdentity(raw)
|
|
533
537
|
: undefined;
|
|
534
538
|
}
|
|
535
539
|
|
|
@@ -548,7 +552,9 @@ export class BambuImplementation {
|
|
|
548
552
|
`Materials: ${inspection.materials.join(", ")}. Peak targets: nozzle ${inspection.maxNozzleTemperature}°C, bed ${inspection.maxBedTemperature}°C, chamber ${inspection.maxChamberTemperature}°C. ` +
|
|
549
553
|
`File SHA-256: ${inspection.sha256}. Confirm the physical spool labels and that the build plate is clear.` +
|
|
550
554
|
(finishedJob !== undefined ? (status.raw.gcode_state === "FAILED"
|
|
551
|
-
?
|
|
555
|
+
? (isFinishedP1SJob(status.raw, inspection.model)
|
|
556
|
+
? " The previous P1S job ended in FAILED and the printer now reports idle with no print or HMS errors. Remove the previous part and every detached part, support and strand from the plate and nozzle before confirming. No error-reset command is sent."
|
|
557
|
+
: " The previous X2D task was canceled (0300400C): remove every detached part, support and strand from the plate and nozzle before confirming. FAILED is the previous job's terminal state; no error-reset command is sent.")
|
|
552
558
|
: " The printer reports FINISH: remove the previous part and debris before confirming.") : "") +
|
|
553
559
|
(cleared ? ` Previously cleared hardware codes: ${cleared.map(describeHmsKey).join(", ")}. Confirm their physical causes have been resolved.` : "") +
|
|
554
560
|
(notices.length ? ` The printer also reports ${notices.join(", ")}, which Bambu lists for this model without text and never shows as a fault; ` +
|
|
@@ -563,7 +569,8 @@ export class BambuImplementation {
|
|
|
563
569
|
/** Stop a print whose confirmed situation changed: a newly finished job, or a hidden HMS notice the preflight did not name. */
|
|
564
570
|
assertBedClearance(status: any, preflight: PrintPreflight): void {
|
|
565
571
|
const current = this.finishedJobIdentity(status);
|
|
566
|
-
if (
|
|
572
|
+
if ((preflight.finishedJob !== undefined && printJobIdentity(status.raw) !== preflight.finishedJob)
|
|
573
|
+
|| (current !== undefined && preflight.finishedJob === undefined)) {
|
|
567
574
|
throw new Error("Printer reports a newly finished job. Confirm that its part and debris have been removed before retrying the print.");
|
|
568
575
|
}
|
|
569
576
|
// An X2D raises its hidden camera notice about 15 seconds after boot, so it
|
|
@@ -141,6 +141,14 @@ export function isCancelledX2DJob(raw: Record<string, any>, model: string): bool
|
|
|
141
141
|
finiteNumber(raw.print_error) === 0 && finiteNumber(raw.fail_reason) === 0x0300400c &&
|
|
142
142
|
[raw.gcode_file, raw.subtask_name].some(value => typeof value === "string" && value.trim().length > 0);
|
|
143
143
|
}
|
|
144
|
+
/** Bambu Studio 2.8.2.61 marks FAILED as finished. Limit P1S recovery to
|
|
145
|
+
* a named prior job explicitly reporting idle, no print error and no HMS.
|
|
146
|
+
* Its bed still needs job-bound human clearance before every print. */
|
|
147
|
+
export function isFinishedP1SJob(raw: Record<string, any>, model: string): boolean {
|
|
148
|
+
return normalizeModel(model) === "p1s" && raw.gcode_state === "FAILED" && raw.print_type === "idle" &&
|
|
149
|
+
finiteNumber(raw.print_error) === 0 && Array.isArray(raw.hms) && raw.hms.length === 0 &&
|
|
150
|
+
[raw.gcode_file, raw.subtask_name].some(value => typeof value === "string" && value.trim().length > 0);
|
|
151
|
+
}
|
|
144
152
|
const token = (value: unknown) => typeof value === "string" ? value.trim().toLowerCase().replace(/[\s_-]/g, "") : "";
|
|
145
153
|
function nozzleTypeAndFlow(value: unknown): {type?: string; flow?: string} {
|
|
146
154
|
const text = String(value ?? "");
|
|
@@ -319,9 +327,9 @@ function logHiddenNotices(raw: Record<string, any>, serial: string, model: strin
|
|
|
319
327
|
|
|
320
328
|
function validateErrors(raw: Record<string,any>, requireIdle: boolean, serial: string, model: string) {
|
|
321
329
|
const state = typeof raw.gcode_state === "string" ? raw.gcode_state.toUpperCase() : "UNKNOWN";
|
|
322
|
-
const
|
|
323
|
-
if (requireIdle && !["IDLE","FINISH"].includes(state) && !
|
|
324
|
-
if (!requireIdle && !["IDLE","FINISH","RUNNING","PAUSE"].includes(state) && !
|
|
330
|
+
const terminal = isCancelledX2DJob(raw, model) || isFinishedP1SJob(raw, model);
|
|
331
|
+
if (requireIdle && !["IDLE","FINISH"].includes(state) && !terminal) throw new Error(`Printer state ${state} is not safely idle.`);
|
|
332
|
+
if (!requireIdle && !["IDLE","FINISH","RUNNING","PAUSE"].includes(state) && !terminal) throw new Error(`Printer state ${state} is unknown or failed.`);
|
|
325
333
|
if (finiteNumber(raw.print_error) !== 0) throw new Error("Printer reports a print error or did not report its error state.");
|
|
326
334
|
if (!Array.isArray(raw.hms)) throw new Error("Printer HMS error state is missing or malformed.");
|
|
327
335
|
for (const reported of raw.hms) {
|