@vcad/mcp 0.9.4-main.38 → 0.9.4-main.39

package/README.md

@@ -6,4 +6,4 @@ vcad's MCP server as a self-contained bundle (server + BRep kernel WASM).
 { "mcpServers": { "vcad": { "command": "npx", "args": ["-y", "@vcad/mcp"] } } }
 ```
 
-Built from 254d4e9d13825ac74a895590703959d77898e1f3 at 2026-07-26T13:42:07.736Z. Source: https://github.com/ecto/vcad
+Built from 08cd95d4487b522463d0a1a3b58b84935a1f7d08 at 2026-07-26T13:56:33.334Z. Source: https://github.com/ecto/vcad

package/index.mjs

@@ -177,6 +177,7 @@ __export(vcad_kernel_wasm_exports, {
   exprEvaluate: () => exprEvaluate,
   exprParse: () => exprParse,
   feaAnalyzeMesh: () => feaAnalyzeMesh,
+  feaCheckBeam: () => feaCheckBeam,
   generate3mf: () => generate3mf,
   generate3mfWithGcode: () => generate3mfWithGcode,
   generateGcode: () => generateGcode,
@@ -1925,6 +1926,15 @@ function feaAnalyzeMesh(spec_json, options_json, positions, indices) {
   }
   return takeFromExternrefTable0(ret[0]);
 }
+function feaCheckBeam(case_json) {
+  const ptr0 = passStringToWasm0(case_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+  const len0 = WASM_VECTOR_LEN;
+  const ret = wasm.feaCheckBeam(ptr0, len0);
+  if (ret[2]) {
+    throw takeFromExternrefTable0(ret[1]);
+  }
+  return takeFromExternrefTable0(ret[0]);
+}
 function generate3mf(name, vertices, indices, settings_json) {
   const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
   const len0 = WASM_VECTOR_LEN;
@@ -11526,6 +11536,7 @@ var init_dist = __esm({
           evaluateDocument: wasmModule7.evaluateDocument,
           evalVcadSource: wasmModule7.evalVcadSource,
           evalVcadSourceWithModules: wasmModule7.evalVcadSourceWithModules,
+          evalVcadSourceParametric: wasmModule7.evalVcadSourceParametric,
           documentParameterGradient: wasmModule7.documentParameterGradient,
           getPartsManifest: wasmModule7.getPartsManifest,
           buildPart: wasmModule7.buildPart,
@@ -12230,6 +12241,22 @@ var init_dist = __esm({
         const json = this.kernel.evalVcadSourceWithModules(source, JSON.stringify(modules));
         return JSON.parse(json);
       }
+      /**
+       * Evaluate loon source, returning the document alongside any parametric
+       * warnings — intent the bridge could *not* preserve, such as a declared
+       * parameter that ends up driving no geometry, or a field whose dependence
+       * on a parameter is not affine and so keeps its literal.
+       *
+       * The document is identical to {@link evalVcadSourceWithModules}; only the
+       * authoring feedback is extra. Returns null on kernels predating the
+       * parametric loon forms, so callers can fall back.
+       */
+      evalVcadSourceParametric(source, modules = {}) {
+        if (!this.kernel.evalVcadSourceParametric)
+          return null;
+        const json = this.kernel.evalVcadSourceParametric(source, Object.keys(modules).length ? JSON.stringify(modules) : void 0);
+        return JSON.parse(json);
+      }
       /** Evaluate a preview extrusion without adding to document */
       evaluateExtrudePreview(origin, xDir, yDir, segments, direction) {
         if (segments.length === 0)
@@ -40963,6 +40990,26 @@ var init_CHANGELOG = __esm({
             "rendering"
           ]
         },
+        {
+          id: "2026-07-26-parametric-loon-datums",
+          version: "0.9.4",
+          date: "2026-07-26",
+          category: "feat",
+          title: "Named parameters, datums and stacks in loon",
+          summary: "Values named with [defparam] survive into the document and are settable with set_parameters; [datum-plane]/[stack] make shared planes and packing clearances named entities instead of repeated literals.",
+          features: [
+            "loon",
+            "parameters",
+            "datums",
+            "assemblies"
+          ],
+          mcpTools: [
+            "create_cad_loon",
+            "list_parameters",
+            "set_parameters",
+            "parameter_gradient"
+          ]
+        },
         {
           id: "2026-07-26-loon-mirror-symmetry",
           version: "0.9.4",
@@ -48729,9 +48776,45 @@ function createCadLoon(input, engine) {
     return { content: [{ type: "text", text: text2 }] };
   }
   const text = format === "json" ? JSON.stringify(doc, null, 2) : toVCode2(doc);
-  return {
-    content: [{ type: "text", text }]
-  };
+  const content = [{ type: "text", text }];
+  const note = parametricNote(source, modules, engine, doc);
+  if (note) content.push({ type: "text", text: note });
+  return { content };
+}
+function parametricNote(source, modules, engine, doc) {
+  const names = Object.keys(doc.parameters ?? {}).sort();
+  if (!names.length) return null;
+  const lines = [];
+  const value = (n) => doc.parameters[n].value;
+  const bound = new Set(
+    Object.values(doc.bindings ?? {}).flatMap(
+      (expr) => typeof expr === "string" ? expr.match(/[A-Za-z_]\w*/g) ?? [] : []
+    )
+  );
+  const base = names.filter((n) => typeof value(n) === "number");
+  const derived = names.filter((n) => typeof value(n) === "string");
+  if (base.length) {
+    lines.push(
+      `Parameters (${base.length}, settable): ${base.map((n) => bound.has(n) ? n : `${n} (drives nothing)`).join(", ")}`
+    );
+  }
+  if (derived.length) {
+    lines.push(
+      `Derived (${derived.length}, follow from the above): ${derived.map((n) => `${n} = "${value(n)}"`).join(", ")}`
+    );
+  }
+  const datums = Object.keys(doc.datums ?? {}).sort();
+  if (datums.length) lines.push(`Datums (${datums.length}): ${datums.join(", ")}`);
+  if (base.length) {
+    lines.push("Change any settable parameter with set_parameters \u2014 no re-authoring needed.");
+  }
+  let warnings = [];
+  try {
+    warnings = engine.evalVcadSourceParametric(source, modules)?.warnings ?? [];
+  } catch {
+  }
+  for (const w of warnings) lines.push(`- ${w}`);
+  return lines.join("\n");
 }
 var createCadLoonSchema, toolDefs2;
 var init_loon = __esm({
@@ -48793,7 +48876,7 @@ var init_loon = __esm({
       {
         name: "create_cad_loon",
         pack: null,
-        description: 'The preferred authoring tool for whole parts and multi-feature models \u2014 one call, full vocabulary. Create a CAD document from loon source code. Loon is a Lisp-like language for parametric CAD \u2014 the FULL modeling vocabulary (patterns, sketches, extrude/revolve/sweep/loft, assemblies) is available here even where no dedicated MCP tool exists. For incremental single-node edits to an open session, use create/update/delete instead.\n\nPrimitives: [cube x y z], [cylinder r h], [sphere r], [cone r-bottom r-top h], [torus major-r minor-r], [wedge x y z], [prism sides radius height]\nBooleans (subject-last): [difference tool subject], [union other subject], [intersection other subject]\nTransforms (subject-last): [translate x y z s], [rotate rx ry rz s], [scale sx sy sz s], [mirror ox oy oz nx ny nz s] (plane through the origin point with that normal) \u2014 plus the axis sugar [mirror-x s] / [mirror-y s] / [mirror-z s], which mirror through the origin, negating that one coordinate. NEVER hand-mirror by negating coordinates; use these.\nFeatures: [fillet r s], [chamfer d s], [shell t s]\nPatterns (subject-last): [linear-pattern dx dy dz count spacing s], [circular-pattern ox oy oz ax ay az count angle s] \u2014 e.g. a bolt circle is [circular-pattern 0 0 0 0 0 1 6 360 bolt-hole]\nSymmetric patterns (subject-last): [mirror-pattern nx ny nz s] and its sugar [mirror-pattern-x s] / -y / -z union a solid with its mirror image (a left/right pair in one expression, so the halves can\'t drift apart); [quad-pattern s] is the 4-fold X-and-Y version \u2014 a quadruped\'s legs, a 4-post frame, a vehicle chassis\nSketches: [sketch ox oy oz xx xy xz yx yy yz #[segments]] with [line x1 y1 x2 y2] and [arc x1 y1 x2 y2 cx cy ccw]\nSketch ops (sketch-last): [extrude dx dy dz sk], [revolve aox aoy aoz adx ady adz angle sk], [sweep-line sx sy sz ex ey ez sk], [sweep-helix radius pitch height turns sk], [loft #[sk1 sk2 \u2026]], [loft-closed #[sk1 sk2 \u2026]]\nAssemblies: [assembly #[parts] #[instances] #[joints] ground-id] with [part name solid "material"], [instance name part-name x y z], [revolute-joint \u2026], [prismatic-joint \u2026], [fixed-joint \u2026], [ball-joint \u2026]\nAssembly symmetry: author ONE side as an assembly, then [mirror-group-x "-r" side] (or -y / -z) returns it plus a mirrored, suffixed copy \u2014 parts reflected, placements and joint anchors mirrored, and joint axes flipped by the correct rule (a hinge across its own mirror normal keeps its axis; the other two flip), so the same joint state drives both sides symmetrically. Splice it back with [assembly-join chassis mirrored]. NEVER hand-mirror an assembly.\nPipe: [pipe [cube 50 30 5] [difference [cylinder 3 10]] [fillet 1.0]]\nLet bindings: [let body [cube 50 30 5]]\nScene: [root solid "material-name"], with [material name r g b metallic roughness] to define one\nModules: [use bracket] then [bracket.plate] \u2014 multi-file projects work here, with sources passed in `modules` (or read from `base_dir`); [use bracket :as b] aliases, [use bracket [plate]] imports selectively, and `pub` in a module picks what it exports',
+        description: 'The preferred authoring tool for whole parts and multi-feature models \u2014 one call, full vocabulary. Create a CAD document from loon source code. Loon is a Lisp-like language for parametric CAD \u2014 the FULL modeling vocabulary (patterns, sketches, extrude/revolve/sweep/loft, assemblies) is available here even where no dedicated MCP tool exists. For incremental single-node edits to an open session, use create/update/delete instead.\n\nPrimitives: [cube x y z], [cylinder r h], [sphere r], [cone r-bottom r-top h], [torus major-r minor-r], [wedge x y z], [prism sides radius height]\nBooleans (subject-last): [difference tool subject], [union other subject], [intersection other subject]\nTransforms (subject-last): [translate x y z s], [rotate rx ry rz s], [scale sx sy sz s], [mirror ox oy oz nx ny nz s] (plane through the origin point with that normal) \u2014 plus the axis sugar [mirror-x s] / [mirror-y s] / [mirror-z s], which mirror through the origin, negating that one coordinate. NEVER hand-mirror by negating coordinates; use these.\nFeatures: [fillet r s], [chamfer d s], [shell t s]\nPatterns (subject-last): [linear-pattern dx dy dz count spacing s], [circular-pattern ox oy oz ax ay az count angle s] \u2014 e.g. a bolt circle is [circular-pattern 0 0 0 0 0 1 6 360 bolt-hole]\nSymmetric patterns (subject-last): [mirror-pattern nx ny nz s] and its sugar [mirror-pattern-x s] / -y / -z union a solid with its mirror image (a left/right pair in one expression, so the halves can\'t drift apart); [quad-pattern s] is the 4-fold X-and-Y version \u2014 a quadruped\'s legs, a 4-post frame, a vehicle chassis\nSketches: [sketch ox oy oz xx xy xz yx yy yz #[segments]] with [line x1 y1 x2 y2] and [arc x1 y1 x2 y2 cx cy ccw]\nSketch ops (sketch-last): [extrude dx dy dz sk], [revolve aox aoy aoz adx ady adz angle sk], [sweep-line sx sy sz ex ey ez sk], [sweep-helix radius pitch height turns sk], [loft #[sk1 sk2 \u2026]], [loft-closed #[sk1 sk2 \u2026]]\nAssemblies: [assembly #[parts] #[instances] #[joints] ground-id] with [part name solid "material"], [instance name part-name x y z], [revolute-joint \u2026], [prismatic-joint \u2026], [fixed-joint \u2026], [ball-joint \u2026]\nAssembly symmetry: author ONE side as an assembly, then [mirror-group-x "-r" side] (or -y / -z) returns it plus a mirrored, suffixed copy \u2014 parts reflected, placements and joint anchors mirrored, and joint axes flipped by the correct rule (a hinge across its own mirror normal keeps its axis; the other two flip), so the same joint state drives both sides symmetrically. Splice it back with [assembly-join chassis mirrored]. NEVER hand-mirror an assembly.\nPipe: [pipe [cube 50 30 5] [difference [cylinder 3 10]] [fillet 1.0]]\nLet bindings: [let body [cube 50 30 5]] \u2014 note these are inlined and do NOT survive into the document; use [defparam ...] for a value you want to change later\nParameters (survive into the document and are settable afterwards with set_parameters, and differentiable with parameter_gradient): [defparam pitch_axis_x 310.0], [defparam wall "bore * 0.2"] for derived values, plus optional :unit/:min/:max/:description. Names must be identifier-safe (underscores, not dashes)\nDatums \u2014 named reference geometry, so two parts cannot each hold their own copy of a shared plane: [datum-plane "femur_inner" y 131.0], [datum-axis "pitch" x 0 0 310], [datum-point "hip" 0 0 310], read back with [datum "femur_inner"], [datum+ "femur_inner" 3.0] (3 mm outboard), [datum-x/-y/-z "pitch"]\nStacks \u2014 declarative packing, where each running clearance is a named value instead of an arbitrary number: [stack y "leg" 131.0 [lane "femur_inner" 5.0] [gap "idler_run" 1.0] [lane "idler_boss" 3.0]] declares datum planes leg_femur_inner_lo/_hi, leg_idler_boss_lo/_hi and leg_end; widening leg_idler_run slides everything outboard of it\nScene: [root solid "material-name"], with [material name r g b metallic roughness] to define one\nModules: [use bracket] then [bracket.plate] \u2014 multi-file projects work here, with sources passed in `modules` (or read from `base_dir`); [use bracket :as b] aliases, [use bracket [plate]] imports selectively, and `pub` in a module picks what it exports',
         inputSchema: createCadLoonSchema,
         handler: async (args, ctx) => {
           const useLoons = Array.isArray(args.use_loons) ? args.use_loons : void 0;
@@ -58029,6 +58112,18 @@ function listParameters(input) {
   );
   return jsonResult({ count: parameters.length, parameters });
 }
+function referencedNames(doc) {
+  const out = /* @__PURE__ */ new Set();
+  const harvest = (expr) => {
+    if (typeof expr !== "string") return;
+    for (const v of expr.match(/[A-Za-z_]\w*/g) ?? []) out.add(v);
+  };
+  for (const expr of Object.values(doc.bindings ?? {})) harvest(expr);
+  for (const c of doc.constraints ?? []) {
+    for (const v of Object.values(c)) harvest(v);
+  }
+  return out;
+}
 async function setParameters(input, engine) {
   const args = input ?? {};
   const documentId = String(args.document_id ?? "");
@@ -58058,6 +58153,18 @@ async function setParameters(input, engine) {
       `Unknown parameter(s): ${unknown2.join(", ")}. Use list_parameters to see declared names.`
     );
   }
+  const referenced = referencedNames(doc);
+  const noEffect = entries.map(([name]) => name).filter((name) => !referenced.has(name)).map((name) => {
+    const value = doc.parameters[name].value;
+    const inputs = typeof value === "string" ? [...new Set(value.match(/[A-Za-z_]\w*/g) ?? [])].filter(
+      (v) => v in doc.parameters && referenced.has(v)
+    ) : [];
+    return {
+      name,
+      reason: typeof value === "string" ? `derived (${JSON.stringify(value)}) \u2014 no field is bound to it` : "no field is bound to it",
+      ...inputs.length ? { set_instead: inputs } : {}
+    };
+  });
   const changed = [];
   for (const [name, value] of entries) {
     const param = doc.parameters[name];
@@ -58079,6 +58186,7 @@ async function setParameters(input, engine) {
     document_id: documentId,
     updated: changed.length,
     changed,
+    ...noEffect.length ? { no_effect: noEffect } : {},
     ...constraintSolve ? { constraint_solve: constraintSolve } : {}
   });
   result.structuredContent = { changed };
@@ -80215,8 +80323,8 @@ var init_server3 = __esm({
     init_order_feed();
     init_animate();
     PKG_VERSION = (() => {
-      if ("0.9.4-main.38") {
-        return "0.9.4-main.38";
+      if ("0.9.4-main.39") {
+        return "0.9.4-main.39";
       }
       try {
         const req = createRequire2(import.meta.url);
@@ -80225,8 +80333,8 @@ var init_server3 = __esm({
         return "0.0.0";
       }
     })();
-    BUILD_SHA = "254d4e9d13825ac74a895590703959d77898e1f3";
-    BUILD_TIME = "2026-07-26T13:42:07.736Z";
+    BUILD_SHA = "08cd95d4487b522463d0a1a3b58b84935a1f7d08";
+    BUILD_TIME = "2026-07-26T13:56:33.334Z";
     SHORT_SHA = BUILD_SHA === "unknown" ? "unknown" : BUILD_SHA.slice(0, 7);
     VERSION_WITH_BUILD = SHORT_SHA === "unknown" ? PKG_VERSION : `${PKG_VERSION}+${SHORT_SHA}`;
     INSTANCE_ID = randomUUID6().slice(0, 8);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vcad/mcp",
-  "version": "0.9.4-main.38",
+  "version": "0.9.4-main.39",
   "description": "vcad MCP server — parametric CAD + PCB design tools for AI agents (self-contained: bundled server + kernel WASM)",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
   },
   "homepage": "https://vcad.io",
   "vcadBuild": {
-    "sha": "254d4e9d13825ac74a895590703959d77898e1f3",
-    "builtAt": "2026-07-26T13:42:07.736Z"
+    "sha": "08cd95d4487b522463d0a1a3b58b84935a1f7d08",
+    "builtAt": "2026-07-26T13:56:33.334Z"
   }
 }