bambu-printer-mcp 1.1.82 → 1.1.83

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/README.md CHANGED
@@ -1251,6 +1251,45 @@ These defaults reduce stale-profile problems; inspect downloaded models and thei
1251
1251
 
1252
1252
  </details>
1253
1253
 
1254
+ <details>
1255
+ <summary><strong>Optional code-CAD engine</strong></summary>
1256
+
1257
+ ### Code-CAD
1258
+
1259
+ This MCP includes an optional headless design engine built on **build123d**, with trimesh and Manifold for mesh checks. It supports dimensioned parts and script-based captured-mesh work, saving editable Python, named dimensions, STL, and STEP for solid designs without starting Blender or Fusion. Nothing is downloaded until you explicitly call `cad_setup` with `install: true`. Allow about **1.5 GiB** for its isolated Python, packages and download cache; the exact size varies by platform. It needs `uv`, plus macOS Seatbelt or Linux `bubblewrap`; it refuses to run without confinement.
1260
+
1261
+ Why include it: a local comparison made a bottle-holder cavity at 65.800 × 28.800 mm, changed its height by exactly 1 mm with one parameter edit in 137 seconds, and exported an articulated unicorn in 657 seconds where two recorded Blender attempts reached 901 seconds without a model. Initial holder worker passes took 238–893 seconds; this is not a speed guarantee. The unicorn still had dimension and pose errors. These few runs do not establish general superiority, reliable articulation or physical print fit. Both holders collided with an oversized raw scan; numerical checks exposed that rather than silently resizing it.
1262
+
1263
+ **Don't want it?** Set `CAD_ENABLED=0` in the MCP's environment and restart the MCP. Its CAD tools, prompt and advertised capability disappear; printer tools and the existing Blender/Fusion bridges stay available. To remove a downloaded environment, stop the MCP and move its CAD data folder to Trash (default locations and `CAD_DATA_DIR` are in [the CAD guide](docs/CAD.md)). Your saved model outputs are separate. Leaving it disabled installs nothing and starts no Python.
1264
+
1265
+ #### cad_status
1266
+
1267
+ Read the pinned version, Python path, platform and last verified readiness. No installation or Python process is started.
1268
+
1269
+ #### cad_setup
1270
+
1271
+ Check only by default. `{"install":true}` installs a pinned isolated environment in the MCP's data directory and proves a confined small build plus STL/STEP round trip. On macOS it requires an internal disk with file ownership enabled. USB/network data volumes are refused before installation because the experiment found native-import stalls there; nothing is re-signed.
1272
+
1273
+ #### cad_run
1274
+
1275
+ Read the `cad_design` prompt first. Supply `script` or a saved `script_path`, `output_dir`, and `name`. Scripts declare literal `P = {...}` parameters and a `build()` function returning a build123d shape. One later call with `script_path` and `parameters` changes a dimension and rebuilds. Each run creates a new subfolder and preserves its source/parameter checkpoint, even on failure. The result contains STL/STEP paths, measured geometry, validity checks, six views and a contact sheet.
1276
+
1277
+ Explicit `inputs: [{"name": "scan", "path": "/allowed/scan.stl"}]` snapshots the files a script may read as `INPUTS["scan"]`. For a mesh-only edit, use `mode: "mesh"` and return `trimesh.Trimesh`: it exports and validates STL plus renders, with `step: null` and a clear reason. For captured meshes, the injected `load_scan` helper takes explicit source units and an up-axis, converts coordinates to millimetres/Z-up, and grounds the mesh without fitting its size. Cleanup choices and labels belong to the caller’s rules; the MCP supplies execution, mesh libraries, checks and renders.
1278
+
1279
+ `cad_status` and `cad_setup` expose `storage.expected_download_bytes`, `expected_installed_bytes` and cached measured `installed_bytes`; the first two are fresh-install budget estimates, not remaining transfer sizes. Setup failures carry `structuredContent.code`, `message`, `suggestion` and `retryable`, so clients do not parse wording.
1280
+
1281
+ Runs wait for the environment's execution slot up to their own total timeout and return `queue_wait_ms`. Mark the selected result with `final: true`: each run's script-protected `cad-result.json` keeps the flag, full validation and artifact paths for recovery after restart. Check `status`, `valid` and the checks as well as `final`.
1282
+
1283
+ Unchanged declared inputs reuse immutable content-hash bundles, with `snapshot_bytes_added` and `snapshot_bytes_reused` in the result. Keep the referenced `.cad-inputs` bundles with saved designs. Previews now use depth cues and feature edges to reveal windows and recesses without a heavy renderer.
1284
+
1285
+ #### cad_check_fit
1286
+
1287
+ Check a model and reference STL with an explicit rigid transform. Returns interference volume and minimum surface gap, without quietly scaling a scan. Open/nonmanifold meshes are refused. A gap of zero includes intentional floor contact, so choose clearance checks to match the interface you actually want to measure.
1288
+
1289
+ See [CAD setup, confinement, script contract and removal](docs/CAD.md) for configuration, examples and limits.
1290
+
1291
+ </details>
1292
+
1254
1293
  <details>
1255
1294
  <summary><strong>Advanced Tools</strong></summary>
1256
1295
 
@@ -0,0 +1,424 @@
1
+ /** cad/1 is an optional engine owned by the printer MCP. Readiness comes from cad_status, not the capability. */
2
+ export declare function cadEnabled(env?: NodeJS.ProcessEnv): boolean;
3
+ export declare const CAD_CAPABILITY: {
4
+ readonly contract: "cad/1";
5
+ readonly status: "cad_status";
6
+ readonly setup: "cad_setup";
7
+ readonly run: "cad_run";
8
+ readonly checkFit: "cad_check_fit";
9
+ readonly prompt: "cad_design";
10
+ };
11
+ export declare const CAD_TOOLS: ({
12
+ name: string;
13
+ description: string;
14
+ inputSchema: {
15
+ type: "object";
16
+ properties: {
17
+ install?: undefined;
18
+ inputs?: undefined;
19
+ mode?: undefined;
20
+ script?: undefined;
21
+ script_path?: undefined;
22
+ parameters?: undefined;
23
+ output_dir?: undefined;
24
+ name?: undefined;
25
+ final?: undefined;
26
+ timeout_ms?: undefined;
27
+ model?: undefined;
28
+ reference?: undefined;
29
+ transform?: undefined;
30
+ clearance_mm?: undefined;
31
+ };
32
+ additionalProperties: boolean;
33
+ required?: undefined;
34
+ };
35
+ outputSchema: {
36
+ type: "object";
37
+ anyOf: ({
38
+ type: string;
39
+ properties: {
40
+ status: {
41
+ type: string;
42
+ const: string;
43
+ };
44
+ code: {
45
+ type: string;
46
+ enum: ("cad-uv-missing" | "cad-data-volume-refused" | "cad-setup-busy" | "cad-operation-busy" | "cad-queue-timeout" | "cad-not-ready" | "cad-confinement-unavailable" | "cad-disabled" | "cad-failed")[];
47
+ };
48
+ message: {
49
+ type: string;
50
+ };
51
+ tool: {
52
+ type: string;
53
+ };
54
+ retryable: {
55
+ type: string;
56
+ };
57
+ suggestion: {
58
+ type: string;
59
+ };
60
+ storage: {
61
+ type: string;
62
+ properties: {
63
+ expected_download_bytes: {
64
+ type: string;
65
+ };
66
+ expected_installed_bytes: {
67
+ type: string;
68
+ };
69
+ installed_bytes: {
70
+ type: string[];
71
+ };
72
+ measurement: {
73
+ type: string;
74
+ const: string;
75
+ };
76
+ measured_at: {
77
+ type: string;
78
+ };
79
+ };
80
+ required: string[];
81
+ };
82
+ };
83
+ required: string[];
84
+ } | {
85
+ type: string;
86
+ properties: Record<string, unknown>;
87
+ required: string[];
88
+ })[];
89
+ };
90
+ } | {
91
+ name: string;
92
+ description: string;
93
+ inputSchema: {
94
+ type: "object";
95
+ properties: {
96
+ install: {
97
+ type: string;
98
+ default: boolean;
99
+ description: string;
100
+ };
101
+ inputs?: undefined;
102
+ mode?: undefined;
103
+ script?: undefined;
104
+ script_path?: undefined;
105
+ parameters?: undefined;
106
+ output_dir?: undefined;
107
+ name?: undefined;
108
+ final?: undefined;
109
+ timeout_ms?: undefined;
110
+ model?: undefined;
111
+ reference?: undefined;
112
+ transform?: undefined;
113
+ clearance_mm?: undefined;
114
+ };
115
+ additionalProperties: boolean;
116
+ required?: undefined;
117
+ };
118
+ outputSchema: {
119
+ type: "object";
120
+ anyOf: ({
121
+ type: string;
122
+ properties: {
123
+ status: {
124
+ type: string;
125
+ const: string;
126
+ };
127
+ code: {
128
+ type: string;
129
+ enum: ("cad-uv-missing" | "cad-data-volume-refused" | "cad-setup-busy" | "cad-operation-busy" | "cad-queue-timeout" | "cad-not-ready" | "cad-confinement-unavailable" | "cad-disabled" | "cad-failed")[];
130
+ };
131
+ message: {
132
+ type: string;
133
+ };
134
+ tool: {
135
+ type: string;
136
+ };
137
+ retryable: {
138
+ type: string;
139
+ };
140
+ suggestion: {
141
+ type: string;
142
+ };
143
+ storage: {
144
+ type: string;
145
+ properties: {
146
+ expected_download_bytes: {
147
+ type: string;
148
+ };
149
+ expected_installed_bytes: {
150
+ type: string;
151
+ };
152
+ installed_bytes: {
153
+ type: string[];
154
+ };
155
+ measurement: {
156
+ type: string;
157
+ const: string;
158
+ };
159
+ measured_at: {
160
+ type: string;
161
+ };
162
+ };
163
+ required: string[];
164
+ };
165
+ };
166
+ required: string[];
167
+ } | {
168
+ type: string;
169
+ properties: Record<string, unknown>;
170
+ required: string[];
171
+ })[];
172
+ };
173
+ } | {
174
+ name: string;
175
+ description: string;
176
+ inputSchema: {
177
+ type: "object";
178
+ properties: {
179
+ inputs: {
180
+ type: string;
181
+ maxItems: number;
182
+ items: {
183
+ type: string;
184
+ properties: {
185
+ name: {
186
+ type: string;
187
+ };
188
+ path: {
189
+ type: string;
190
+ };
191
+ };
192
+ required: string[];
193
+ additionalProperties: boolean;
194
+ };
195
+ description: string;
196
+ };
197
+ mode: {
198
+ type: string;
199
+ enum: string[];
200
+ default: string;
201
+ description: string;
202
+ };
203
+ script: {
204
+ type: string;
205
+ maxLength: number;
206
+ description: string;
207
+ };
208
+ script_path: {
209
+ type: string;
210
+ description: string;
211
+ };
212
+ parameters: {
213
+ type: string;
214
+ additionalProperties: boolean;
215
+ description: string;
216
+ };
217
+ output_dir: {
218
+ type: string;
219
+ description: string;
220
+ };
221
+ name: {
222
+ type: string;
223
+ maxLength: number;
224
+ description: string;
225
+ };
226
+ final: {
227
+ type: string;
228
+ default: boolean;
229
+ description: string;
230
+ };
231
+ timeout_ms: {
232
+ type: string;
233
+ minimum: number;
234
+ maximum: number;
235
+ description: string;
236
+ };
237
+ install?: undefined;
238
+ model?: undefined;
239
+ reference?: undefined;
240
+ transform?: undefined;
241
+ clearance_mm?: undefined;
242
+ };
243
+ required: string[];
244
+ additionalProperties: boolean;
245
+ };
246
+ outputSchema: {
247
+ type: "object";
248
+ anyOf: ({
249
+ type: string;
250
+ properties: {
251
+ status: {
252
+ type: string;
253
+ const: string;
254
+ };
255
+ code: {
256
+ type: string;
257
+ enum: ("cad-uv-missing" | "cad-data-volume-refused" | "cad-setup-busy" | "cad-operation-busy" | "cad-queue-timeout" | "cad-not-ready" | "cad-confinement-unavailable" | "cad-disabled" | "cad-failed")[];
258
+ };
259
+ message: {
260
+ type: string;
261
+ };
262
+ tool: {
263
+ type: string;
264
+ };
265
+ retryable: {
266
+ type: string;
267
+ };
268
+ suggestion: {
269
+ type: string;
270
+ };
271
+ storage: {
272
+ type: string;
273
+ properties: {
274
+ expected_download_bytes: {
275
+ type: string;
276
+ };
277
+ expected_installed_bytes: {
278
+ type: string;
279
+ };
280
+ installed_bytes: {
281
+ type: string[];
282
+ };
283
+ measurement: {
284
+ type: string;
285
+ const: string;
286
+ };
287
+ measured_at: {
288
+ type: string;
289
+ };
290
+ };
291
+ required: string[];
292
+ };
293
+ };
294
+ required: string[];
295
+ } | {
296
+ type: string;
297
+ properties: Record<string, unknown>;
298
+ required: string[];
299
+ })[];
300
+ };
301
+ } | {
302
+ name: string;
303
+ description: string;
304
+ inputSchema: {
305
+ type: "object";
306
+ properties: {
307
+ model: {
308
+ type: string;
309
+ description: string;
310
+ };
311
+ reference: {
312
+ type: string;
313
+ description: string;
314
+ };
315
+ transform: {
316
+ type: string;
317
+ description: string;
318
+ properties: {
319
+ translation_mm: {
320
+ type: string;
321
+ items: {
322
+ type: string;
323
+ };
324
+ minItems: number;
325
+ maxItems: number;
326
+ };
327
+ rotation_deg: {
328
+ type: string;
329
+ items: {
330
+ type: string;
331
+ };
332
+ minItems: number;
333
+ maxItems: number;
334
+ };
335
+ };
336
+ additionalProperties: boolean;
337
+ };
338
+ clearance_mm: {
339
+ type: string;
340
+ minimum: number;
341
+ maximum: number;
342
+ description: string;
343
+ };
344
+ timeout_ms: {
345
+ type: string;
346
+ minimum: number;
347
+ maximum: number;
348
+ description: string;
349
+ };
350
+ install?: undefined;
351
+ inputs?: undefined;
352
+ mode?: undefined;
353
+ script?: undefined;
354
+ script_path?: undefined;
355
+ parameters?: undefined;
356
+ output_dir?: undefined;
357
+ name?: undefined;
358
+ final?: undefined;
359
+ };
360
+ required: string[];
361
+ additionalProperties: boolean;
362
+ };
363
+ outputSchema: {
364
+ type: "object";
365
+ anyOf: ({
366
+ type: string;
367
+ properties: {
368
+ status: {
369
+ type: string;
370
+ const: string;
371
+ };
372
+ code: {
373
+ type: string;
374
+ enum: ("cad-uv-missing" | "cad-data-volume-refused" | "cad-setup-busy" | "cad-operation-busy" | "cad-queue-timeout" | "cad-not-ready" | "cad-confinement-unavailable" | "cad-disabled" | "cad-failed")[];
375
+ };
376
+ message: {
377
+ type: string;
378
+ };
379
+ tool: {
380
+ type: string;
381
+ };
382
+ retryable: {
383
+ type: string;
384
+ };
385
+ suggestion: {
386
+ type: string;
387
+ };
388
+ storage: {
389
+ type: string;
390
+ properties: {
391
+ expected_download_bytes: {
392
+ type: string;
393
+ };
394
+ expected_installed_bytes: {
395
+ type: string;
396
+ };
397
+ installed_bytes: {
398
+ type: string[];
399
+ };
400
+ measurement: {
401
+ type: string;
402
+ const: string;
403
+ };
404
+ measured_at: {
405
+ type: string;
406
+ };
407
+ };
408
+ required: string[];
409
+ };
410
+ };
411
+ required: string[];
412
+ } | {
413
+ type: string;
414
+ properties: Record<string, unknown>;
415
+ required: string[];
416
+ })[];
417
+ };
418
+ })[];
419
+ export declare const CAD_DESIGN_PROMPT: {
420
+ name: string;
421
+ title: string;
422
+ description: string;
423
+ text: string;
424
+ };