fluidcad 0.0.34 → 0.0.35

package/llm-docs/api/bezier.md

@@ -1,7 +1,7 @@
 ---
 id: api/bezier
 title: bezier(...points)
-summary: Free-form bezier curve. The last point is the endpoint; preceding points are control points (degree = args − 1).
+summary: Free-form bezier curve. The first point is the explicit start, the last is the endpoint; points in between are control points (degree = args − 1).
 tags: [api, 2d, primitive, curve]
 symbols: [bezier]
 seeAlso: [api/arc, api/line]
@@ -15,16 +15,15 @@ Imported from `fluidcad/core`.
 bezier(...points: Point2D[])
 ```
 
-The last argument is the endpoint; preceding arguments are control points.
+The first argument is the explicit start, the last is the endpoint; any
+arguments in between are control points. Sets the sketch cursor to the
+endpoint.
 
-| Args | Degree   | Shape              |
-|------|----------|--------------------|
-| 1    | 1 (line) | straight segment   |
-| 2    | 2        | quadratic bezier   |
-| 3    | 3        | cubic bezier       |
-
-The curve starts from the current cursor and ends at the final argument;
-intermediate arguments are control handles that shape the curve.
+| Args | Degree   | Shape                                |
+|------|----------|--------------------------------------|
+| 2    | 1 (line) | straight segment from start to end   |
+| 3    | 2        | quadratic bezier (start, ctrl, end)  |
+| 4    | 3        | cubic bezier (start, c1, c2, end)    |
 
 ## Example
 
@@ -33,7 +32,7 @@ import { bezier, extrude, line, sketch } from "fluidcad/core";
 
 sketch("xy", () => {
   line([0, 0], [0, 40]);
-  bezier([20, 80], [80, 80], [100, 40]);   // cubic bezier
+  bezier([0, 40], [20, 80], [80, 80], [100, 40]);   // cubic bezier
   line([0, 0]);
 });
 extrude(4);

package/llm-docs/api/index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-05-23T14:34:43.886Z",
+  "generatedAt": "2026-05-29T18:50:46.977Z",
   "symbols": {
     "arc": "api/arc",
     "axis": "api/axis",

package/llm-docs/api/types/arc-points.md

@@ -10,7 +10,7 @@ seeAlso: [api/arc, api/types/extrudable-geometry]
 
 ```ts
 interface ArcPoints extends ExtrudableGeometry {
-  radius(value: number): IArcRadius;
+  radius(value: NumberParam): IArcRadius;
   center(value: Point2DLike): IArcCenter;
 }
 ```
@@ -28,7 +28,7 @@ Positive = CCW, negative = CW.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `value` | `number` | The bulge radius. |
+| `value` | `NumberParam` | The bulge radius. |
 
 ### `center()`
 

package/llm-docs/api/types/cut.md

@@ -12,15 +12,15 @@ seeAlso: [api/cut, api/types/scene-object]
 interface Cut extends SceneObject {
   symmetric(): this;
   scope(...objects: SceneObject[]): this;
-  draft(value: number | [number, number]): this;
-  endOffset(value: number): this;
+  draft(value: NumberParam | [NumberParam, NumberParam]): this;
+  endOffset(value: NumberParam): this;
   startEdges(...args: (number | EdgeFilter)[]): SceneObject;
   endEdges(...args: (number | EdgeFilter)[]): SceneObject;
   internalEdges(...args: (number | EdgeFilter)[]): SceneObject;
   internalFaces(...args: (number | FaceFilter)[]): SceneObject;
   pick(...points: Point2DLike[]): this;
-  thin(offset: number): this;
-  thin(offset1: number, offset2: number): this;
+  thin(offset: NumberParam): this;
+  thin(offset1: NumberParam, offset2: NumberParam): this;
 }
 ```
 
@@ -47,7 +47,7 @@ Applies a draft (taper) angle to the cut walls.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `value` | `number` \| `[number, number]` | A single angle for uniform draft, or a `[start, end]` tuple for asymmetric draft. |
+| `value` | `NumberParam` \| `[NumberParam, NumberParam]` | A single angle for uniform draft, or a `[start, end]` tuple for asymmetric draft. |
 
 ### `endOffset()`
 
@@ -55,7 +55,7 @@ Offsets the cut end face by a specified distance along the cut direction.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `value` | `number` | The offset distance. |
+| `value` | `NumberParam` | The offset distance. |
 
 ### `startEdges()`
 
@@ -108,8 +108,8 @@ Restricts the cut to only the sketch regions containing the given points.
 ### `thin()`
 
 ```ts
-thin(offset: number): this
-thin(offset1: number, offset2: number): this
+thin(offset: NumberParam): this
+thin(offset1: NumberParam, offset2: NumberParam): this
 ```
 
 Enables thin cut mode — offsets the profile edges to cut a thin-walled shape
@@ -117,8 +117,8 @@ instead of cutting filled faces. Positive values offset outward, negative values
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `offset1` | `number` | The first wall offset distance. Positive = outward, negative = inward. |
-| `offset2` | `number` | The second wall offset distance, in the opposite direction of offset1. |
+| `offset1` | `NumberParam` | The first wall offset distance. Positive = outward, negative = inward. |
+| `offset2` | `NumberParam` | The second wall offset distance, in the opposite direction of offset1. |
 
 ## Inherited
 

package/llm-docs/api/types/extrude.md

@@ -21,12 +21,12 @@ interface Extrude extends BooleanOperation {
   internalEdges(...args: (number | EdgeFilter)[]): SceneObject;
   capFaces(...args: (number | FaceFilter)[]): SceneObject;
   capEdges(...args: (number | EdgeFilter)[]): SceneObject;
-  draft(value: number | [number, number]): this;
-  endOffset(value: number): this;
+  draft(value: NumberParam | [NumberParam, NumberParam]): this;
+  endOffset(value: NumberParam): this;
   drill(value?: boolean): this;
   pick(...points: Point2DLike[]): this;
-  thin(offset: number): this;
-  thin(offset1: number, offset2: number): this;
+  thin(offset: NumberParam): this;
+  thin(offset1: NumberParam, offset2: NumberParam): this;
 }
 ```
 
@@ -145,7 +145,7 @@ Applies a draft (taper) angle to the extrusion walls.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `value` | `number` \| `[number, number]` | A single angle for uniform draft, or a `[start, end]` tuple for asymmetric draft. |
+| `value` | `NumberParam` \| `[NumberParam, NumberParam]` | A single angle for uniform draft, or a `[start, end]` tuple for asymmetric draft. |
 
 ### `endOffset()`
 
@@ -153,7 +153,7 @@ Offsets the end face by a specified distance along the extrusion direction.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `value` | `number` | The offset distance. |
+| `value` | `NumberParam` | The offset distance. |
 
 ### `drill()`
 
@@ -175,8 +175,8 @@ Restricts extrusion to only the sketch regions containing the given points.
 ### `thin()`
 
 ```ts
-thin(offset: number): this
-thin(offset1: number, offset2: number): this
+thin(offset: NumberParam): this
+thin(offset1: NumberParam, offset2: NumberParam): this
 ```
 
 Enables thin extrude mode — offsets the profile edges to create a thin-walled solid
@@ -184,8 +184,8 @@ instead of extruding filled faces. Positive values offset outward, negative valu
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `offset1` | `number` | The first wall offset distance. Positive = outward, negative = inward. |
-| `offset2` | `number` | The second wall offset distance, in the opposite direction of offset1. |
+| `offset1` | `NumberParam` | The first wall offset distance. Positive = outward, negative = inward. |
+| `offset2` | `NumberParam` | The second wall offset distance, in the opposite direction of offset1. |
 
 ## Inherited
 

package/llm-docs/api/types/loft.md

@@ -16,8 +16,8 @@ interface Loft extends BooleanOperation {
   startEdges(...args: (number | EdgeFilter)[]): SceneObject;
   endEdges(...args: (number | EdgeFilter)[]): SceneObject;
   sideEdges(...args: (number | EdgeFilter)[]): SceneObject;
-  thin(offset: number): this;
-  thin(offset1: number, offset2: number): this;
+  thin(offset: NumberParam): this;
+  thin(offset1: NumberParam, offset2: NumberParam): this;
   internalFaces(...args: (number | FaceFilter)[]): SceneObject;
   internalEdges(...args: (number | EdgeFilter)[]): SceneObject;
   capFaces(...args: (number | FaceFilter)[]): SceneObject;
@@ -92,8 +92,8 @@ Selects edges on the side faces, excluding edges shared with start/end faces.
 ### `thin()`
 
 ```ts
-thin(offset: number): this
-thin(offset1: number, offset2: number): this
+thin(offset: NumberParam): this
+thin(offset1: NumberParam, offset2: NumberParam): this
 ```
 
 Enables thin loft mode — offsets the profile edges of each section to create a
@@ -102,8 +102,8 @@ and share the same topology. Positive values offset outward, negative offsets in
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `offset1` | `number` | The first wall offset distance. Positive = outward, negative = inward. |
-| `offset2` | `number` | The second wall offset distance, in the opposite direction of offset1. |
+| `offset1` | `NumberParam` | The first wall offset distance. Positive = outward, negative = inward. |
+| `offset2` | `NumberParam` | The second wall offset distance, in the opposite direction of offset1. |
 
 ### `internalFaces()`
 

package/llm-docs/api/types/revolve.md

@@ -12,8 +12,8 @@ seeAlso: [api/revolve, api/types/boolean-operation]
 interface Revolve extends BooleanOperation {
   symmetric(): this;
   pick(...points: Point2DLike[]): this;
-  thin(offset: number): this;
-  thin(offset1: number, offset2: number): this;
+  thin(offset: NumberParam): this;
+  thin(offset1: NumberParam, offset2: NumberParam): this;
   internalFaces(...args: (number | FaceFilter)[]): SceneObject;
   internalEdges(...args: (number | EdgeFilter)[]): SceneObject;
   capFaces(...args: (number | FaceFilter)[]): SceneObject;
@@ -40,8 +40,8 @@ Restricts the revolve to only the sketch regions containing the given points.
 ### `thin()`
 
 ```ts
-thin(offset: number): this
-thin(offset1: number, offset2: number): this
+thin(offset: NumberParam): this
+thin(offset1: NumberParam, offset2: NumberParam): this
 ```
 
 Enables thin revolve mode — offsets the profile edges to create a thin-walled
@@ -50,8 +50,8 @@ outward, negative values offset inward.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `offset1` | `number` | The first wall offset distance. Positive = outward, negative = inward. |
-| `offset2` | `number` | The second wall offset distance, in the opposite direction of offset1. |
+| `offset1` | `NumberParam` | The first wall offset distance. Positive = outward, negative = inward. |
+| `offset2` | `NumberParam` | The second wall offset distance, in the opposite direction of offset1. |
 
 ### `internalFaces()`
 

package/llm-docs/api/types/rib.md

@@ -18,7 +18,7 @@ interface Rib extends BooleanOperation {
   endEdges(...args: (number | EdgeFilter)[]): SceneObject;
   sideEdges(...args: (number | EdgeFilter)[]): SceneObject;
   capEdges(...args: (number | EdgeFilter)[]): SceneObject;
-  draft(value: number | [number, number]): this;
+  draft(value: NumberParam | [NumberParam, NumberParam]): this;
   parallel(): this;
   extend(): this;
 }
@@ -114,7 +114,7 @@ Applies a draft (taper) angle to the rib walls.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `value` | `number` \| `[number, number]` | A single angle for uniform draft, or a `[start, end]` tuple for asymmetric draft. |
+| `value` | `NumberParam` \| `[NumberParam, NumberParam]` | A single angle for uniform draft, or a `[start, end]` tuple for asymmetric draft. |
 
 ### `parallel()`
 

package/llm-docs/api/types/slot.md

@@ -11,7 +11,7 @@ seeAlso: [api/slot, api/types/extrudable-geometry]
 ```ts
 interface Slot extends ExtrudableGeometry {
   centered(value?: boolean): this;
-  rotate(angle: number): this;
+  rotate(angle: NumberParam): this;
 }
 ```
 
@@ -34,7 +34,7 @@ Sets the rotation angle of the slot's primary axis.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `angle` | `number` | Rotation in degrees. |
+| `angle` | `NumberParam` | Rotation in degrees. |
 
 ## Inherited
 

package/llm-docs/api/types/sweep.md

@@ -18,12 +18,12 @@ interface Sweep extends BooleanOperation {
   sideEdges(...args: (number | EdgeFilter)[]): SceneObject;
   internalFaces(...args: (number | FaceFilter)[]): SceneObject;
   internalEdges(...args: (number | EdgeFilter)[]): SceneObject;
-  draft(value: number | [number, number]): this;
-  endOffset(value: number): this;
+  draft(value: NumberParam | [NumberParam, NumberParam]): this;
+  endOffset(value: NumberParam): this;
   drill(value?: boolean): this;
   pick(...points: Point2DLike[]): this;
-  thin(offset: number): this;
-  thin(offset1: number, offset2: number): this;
+  thin(offset: NumberParam): this;
+  thin(offset1: NumberParam, offset2: NumberParam): this;
   capFaces(...args: (number | FaceFilter)[]): SceneObject;
   capEdges(...args: (number | EdgeFilter)[]): SceneObject;
 }
@@ -119,7 +119,7 @@ Applies a draft (taper) angle to the sweep walls.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `value` | `number` \| `[number, number]` | A single angle for uniform draft, or a `[start, end]` tuple for asymmetric draft. |
+| `value` | `NumberParam` \| `[NumberParam, NumberParam]` | A single angle for uniform draft, or a `[start, end]` tuple for asymmetric draft. |
 
 ### `endOffset()`
 
@@ -127,7 +127,7 @@ Offsets the end face by a specified distance along the sweep direction.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `value` | `number` | The offset distance. |
+| `value` | `NumberParam` | The offset distance. |
 
 ### `drill()`
 
@@ -148,8 +148,8 @@ Restricts the sweep to only the sketch regions containing the given points.
 ### `thin()`
 
 ```ts
-thin(offset: number): this
-thin(offset1: number, offset2: number): this
+thin(offset: NumberParam): this
+thin(offset1: NumberParam, offset2: NumberParam): this
 ```
 
 Enables thin sweep mode — offsets the profile edges to create a thin-walled
@@ -158,8 +158,8 @@ negative values offset inward.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `offset1` | `number` | The first wall offset distance. Positive = outward, negative = inward. |
-| `offset2` | `number` | The second wall offset distance, in the opposite direction of offset1. |
+| `offset1` | `NumberParam` | The first wall offset distance. Positive = outward, negative = inward. |
+| `offset2` | `NumberParam` | The second wall offset distance, in the opposite direction of offset1. |
 
 ### `capFaces()`
 

package/llm-docs/api/types/transformable.md

@@ -11,12 +11,12 @@ seeAlso: [api/types/scene-object, api/translate, api/rotate]
 ```ts
 interface Transformable extends SceneObject {
   transform(matrix: Matrix4): this;
-  translate(x: number): this;
-  translate(x: number, y: number): this;
-  translate(x: number, y: number, z: number): this;
+  translate(x: NumberParam): this;
+  translate(x: NumberParam, y: NumberParam): this;
+  translate(x: NumberParam, y: NumberParam, z: NumberParam): this;
   translate(offset: PointLike): this;
-  rotate(angle: number): this;
-  rotate(axis: AxisLike, angle: number): this;
+  rotate(angle: NumberParam): this;
+  rotate(axis: AxisLike, angle: NumberParam): this;
   mirror(plane: PlaneLike): this;
   mirror(axis: AxisLike): this;
 }
@@ -47,9 +47,9 @@ object's own shapes after build. Chained calls compose left-to-right:
 ### `translate()`
 
 ```ts
-translate(x: number): this
-translate(x: number, y: number): this
-translate(x: number, y: number, z: number): this
+translate(x: NumberParam): this
+translate(x: NumberParam, y: NumberParam): this
+translate(x: NumberParam, y: NumberParam, z: NumberParam): this
 translate(offset: PointLike): this
 ```
 
@@ -57,15 +57,15 @@ Translate along X.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `x` | `number` |  |
-| `y` | `number` |  |
-| `z` | `number` |  |
+| `x` | `NumberParam` |  |
+| `y` | `NumberParam` |  |
+| `z` | `NumberParam` |  |
 
 ### `rotate()`
 
 ```ts
-rotate(angle: number): this
-rotate(axis: AxisLike, angle: number): this
+rotate(angle: NumberParam): this
+rotate(axis: AxisLike, angle: NumberParam): this
 ```
 
 Rotate by an angle around world Z through the origin.
@@ -73,7 +73,7 @@ Rotate by an angle around world Z through the origin.
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `axis` | [[api/types/axis-like]] | The axis to rotate around. Use `local(...)` to reference a sketch-local axis. |
-| `angle` | `number` | Rotation in degrees. |
+| `angle` | `NumberParam` | Rotation in degrees. |
 
 ### `mirror()`
 

package/llm-docs/index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-05-23T14:34:43.886Z",
+  "generatedAt": "2026-05-29T18:50:46.977Z",
   "docs": [
     {
       "id": "api/arc",
@@ -47,7 +47,7 @@
     {
       "id": "api/bezier",
       "title": "bezier(...points)",
-      "summary": "Free-form bezier curve. The last point is the endpoint; preceding points are control points (degree = args − 1).",
+      "summary": "Free-form bezier curve. The first point is the explicit start, the last is the endpoint; points in between are control points (degree = args − 1).",
       "tags": [
         "api",
         "2d",
@@ -62,7 +62,7 @@
         "api/line"
       ],
       "file": "api/bezier.md",
-      "bodyLength": 788
+      "bodyLength": 826
     },
     {
       "id": "api/booleans",
@@ -986,7 +986,7 @@
         "api/types/extrudable-geometry"
       ],
       "file": "api/types/arc-points.md",
-      "bodyLength": 840
+      "bodyLength": 850
     },
     {
       "id": "api/types/axis-like",
@@ -1106,7 +1106,7 @@
         "api/types/scene-object"
       ],
       "file": "api/types/cut.md",
-      "bodyLength": 3643
+      "bodyLength": 3723
     },
     {
       "id": "api/types/draft",
@@ -1166,7 +1166,7 @@
         "api/types/boolean-operation"
       ],
       "file": "api/types/extrude.md",
-      "bodyLength": 6019
+      "bodyLength": 6099
     },
     {
       "id": "api/types/geometry",
@@ -1243,7 +1243,7 @@
         "api/types/boolean-operation"
       ],
       "file": "api/types/loft.md",
-      "bodyLength": 4832
+      "bodyLength": 4872
     },
     {
       "id": "api/types/mirror",
@@ -1443,7 +1443,7 @@
         "api/types/boolean-operation"
       ],
       "file": "api/types/revolve.md",
-      "bodyLength": 3040
+      "bodyLength": 3080
     },
     {
       "id": "api/types/rib",
@@ -1463,7 +1463,7 @@
         "api/types/boolean-operation"
       ],
       "file": "api/types/rib.md",
-      "bodyLength": 3784
+      "bodyLength": 3814
     },
     {
       "id": "api/types/scene-object",
@@ -1543,7 +1543,7 @@
         "api/types/extrudable-geometry"
       ],
       "file": "api/types/slot.md",
-      "bodyLength": 811
+      "bodyLength": 821
     },
     {
       "id": "api/types/sweep",
@@ -1563,7 +1563,7 @@
         "api/types/boolean-operation"
       ],
       "file": "api/types/sweep.md",
-      "bodyLength": 5797
+      "bodyLength": 5877
     },
     {
       "id": "api/types/tangent-arc-two-objects",
@@ -1604,7 +1604,7 @@
         "api/rotate"
       ],
       "file": "api/types/transformable.md",
-      "bodyLength": 2186
+      "bodyLength": 2286
     },
     {
       "id": "api/types/trim",

package/mcp/dist/client.d.ts

@@ -39,6 +39,7 @@ export declare class FluidCadClient {
         statusCode: number;
         data: Buffer;
         contentType: string;
+        headers: Record<string, string>;
     }>;
     ensureWebSocket(): Promise<WebSocket>;
     /**

package/mcp/dist/client.js

@@ -70,7 +70,14 @@ export class FluidCadClient {
             chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
         }
         const contentType = String(res.headers['content-type'] ?? 'application/octet-stream');
-        return { statusCode: res.statusCode, data: Buffer.concat(chunks), contentType };
+        const headers = {};
+        for (const [k, v] of Object.entries(res.headers)) {
+            if (typeof v === 'string')
+                headers[k.toLowerCase()] = v;
+            else if (Array.isArray(v) && v.length > 0)
+                headers[k.toLowerCase()] = v[0];
+        }
+        return { statusCode: res.statusCode, data: Buffer.concat(chunks), contentType, headers };
     }
     async ensureWebSocket() {
         if (this.closed) {

package/mcp/dist/server.js

@@ -15,7 +15,7 @@ import { getCompileError, getEdgeProperties, getFaceProperties, getSceneSummary,
 import { getCameraState, screenshot, screenshotMulti, screenshotShape, } from "./tools/screenshot.js";
 import { waitForIdle } from "./tools/coordination.js";
 import { editRange, listFluidFiles, readFile, writeFile, } from "./tools/source.js";
-import { addBreakpoint, clearBreakpoints, exportShapes, importStep, recompute, rollbackTo, } from "./tools/engine.js";
+import { addBreakpoint, clearBreakpoints, exportShapes, importStep, packModel, recompute, rollbackTo, } from "./tools/engine.js";
 import { loadDocsIndex } from "./docs-index.js";
 import { registerDocResources } from "./resources.js";
 export const SERVER_NAME = 'FluidCAD';
@@ -441,6 +441,19 @@ export function buildServer(options = {}) {
         resolution,
         includeColors,
     })));
+    server.registerTool('pack_model', {
+        title: 'Package the current model into a shareable .fluidpkg archive',
+        description: 'Produces a self-contained .fluidpkg (zip) capturing the current `.fluid.js` entry as an esbuild ES module bundle, any STEP assets in the workspace (as raw bytes), the live param overrides, and the latest camera state. Inside the archive: `manifest.json`, `bundle.js`, optional `init.js`, and `assets/<path>` entries. Prefer `saveAsPath` — the binary payload can be multi-MB and shouldn\'t round-trip through the agent\'s context as base64. Returns `{ savedTo, bytesWritten, packageName }` when saved, or `{ mimeType, base64, bytes, packageName }` otherwise.',
+        inputSchema: {
+            ...workspaceArg,
+            name: z.string().optional().describe('Optional package name; defaults to the entry file basename. Becomes the file name when `saveAsPath` is omitted.'),
+            description: z.string().optional().describe('Optional human description embedded in manifest.json.'),
+            saveAsPath: z
+                .string()
+                .optional()
+                .describe('Absolute path to write the .fluidpkg to. If omitted, the package is returned inline (base64).'),
+        },
+    }, async ({ workspace, name, description, saveAsPath }) => toMcp(await packModel({ workspace, name, description, saveAsPath })));
     return server;
 }
 export async function runStdio() {

package/mcp/dist/tools/engine.d.ts

@@ -53,4 +53,20 @@ export type ExportBase64Output = {
     bytes: number;
 };
 export type ExportOutput = ExportSavedOutput | ExportBase64Output;
+export type PackModelInput = WorkspaceArg & {
+    name?: string;
+    description?: string;
+    saveAsPath?: string;
+};
+export type PackModelOutput = {
+    savedTo: string;
+    bytesWritten: number;
+    packageName: string;
+} | {
+    mimeType: string;
+    base64: string;
+    bytes: number;
+    packageName: string;
+};
+export declare function packModel(input: PackModelInput): Promise<ToolResult<PackModelOutput>>;
 export declare function exportShapes(input: ExportInput): Promise<ToolResult<ExportOutput>>;

package/mcp/dist/tools/engine.js

@@ -72,6 +72,51 @@ export async function importStep(input) {
     const data = bytes.toString('base64');
     return callWithClient(input, (client) => client.postJson('/api/import-file', { fileName, data }));
 }
+export async function packModel(input) {
+    if (input.saveAsPath !== undefined && typeof input.saveAsPath !== 'string') {
+        return err('invalid-input', '`saveAsPath` must be a string when provided.');
+    }
+    const resolved = resolveClient(input);
+    if (resolved.ok === false) {
+        return resolved;
+    }
+    const { client } = resolved.data;
+    try {
+        const raw = await client.postRaw('/api/pack', {
+            name: input.name,
+            description: input.description,
+        });
+        if (raw.statusCode >= 400) {
+            const text = raw.data.toString('utf8');
+            return err('http-error', `HTTP ${raw.statusCode}: ${text.slice(0, 200)}`, {
+                statusCode: raw.statusCode,
+            });
+        }
+        const packageName = raw.headers['x-fluidcad-package-name'] ?? 'model';
+        if (input.saveAsPath) {
+            const absPath = path.resolve(input.saveAsPath);
+            await fsp.writeFile(absPath, raw.data);
+            return ok({ savedTo: absPath, bytesWritten: raw.data.length, packageName });
+        }
+        return ok({
+            mimeType: raw.contentType,
+            base64: raw.data.toString('base64'),
+            bytes: raw.data.length,
+            packageName,
+        });
+    }
+    catch (e) {
+        if (e instanceof HttpError) {
+            return err('http-error', `HTTP ${e.statusCode}: ${e.body.slice(0, 200)}`, {
+                statusCode: e.statusCode,
+            });
+        }
+        return err('internal', e?.message ?? String(e));
+    }
+    finally {
+        await client.close().catch(() => { });
+    }
+}
 export async function exportShapes(input) {
     if (input?.format !== 'step' && input?.format !== 'stl') {
         return err('invalid-input', '`format` is required and must be "step" or "stl".');