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

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 3b9087f300b569c70aa24cebc52af06d15e59187 at 2026-07-26T13:20:01.737Z. Source: https://github.com/ecto/vcad
+Built from 254d4e9d13825ac74a895590703959d77898e1f3 at 2026-07-26T13:42:07.736Z. Source: https://github.com/ecto/vcad

package/index.mjs

@@ -11559,6 +11559,7 @@ var init_dist = __esm({
           circuitTransient: wasmModule7.circuitTransient,
           circuitTune: wasmModule7.circuitTune,
           feaAnalyzeMesh: wasmModule7.feaAnalyzeMesh,
+          feaCheckBeam: wasmModule7.feaCheckBeam,
           emSimulate: wasmModule7.emSimulate,
           antennaAnalyze: wasmModule7.antennaAnalyze,
           photonicsSimulate: wasmModule7.photonicsSimulate,
@@ -11887,6 +11888,22 @@ var init_dist = __esm({
         }
         return fn(specJson, optionsJson, positions, indices);
       }
+      /**
+       * Closed-form check of a prismatic member: exact section properties,
+       * beam bending with the Timoshenko shear term, Bredt thin-wall (or
+       * Saint-Venant series) torsion, and Euler buckling — the route for
+       * thin-walled sheet-metal and tube-frame members, which no affordable
+       * lattice pitch can resolve. Same fail-closed contract and
+       * `vcad.fea-claims/1` predicted claims as `feaAnalyzeMesh`; see
+       * `vcad-kernel-fea::section`.
+       */
+      feaCheckBeam(caseJson) {
+        const fn = this.kernel.feaCheckBeam;
+        if (typeof fn !== "function") {
+          throw new Error("feaCheckBeam is not exported by this kernel WASM build \u2014 rebuild packages/kernel-wasm");
+        }
+        return fn(caseJson);
+      }
       /**
        * EM field simulation (2D/axisymmetric finite-volume magnetostatics or
        * electrostatics): inductance, force, torque, capacitance extraction and
@@ -40984,6 +41001,25 @@ var init_CHANGELOG = __esm({
             "export_cad"
           ]
         },
+        {
+          id: "2026-07-26-fastener-forms",
+          version: "0.9.4",
+          date: "2026-07-26",
+          category: "feat",
+          title: "Fasteners are a first-class form",
+          summary: "bolt, bolt-circle, clearance-hole and tapped-hole: catalog-backed hardware oriented by its own axis, with real countersunk heads, length checks, and BOM lines counted off the geometry.",
+          features: [
+            "loon",
+            "fasteners",
+            "bom",
+            "assembly"
+          ],
+          mcpTools: [
+            "create_cad_loon",
+            "bom_create",
+            "search_mechanical_parts"
+          ]
+        },
         {
           id: "2026-07-26-document-source-provenance",
           version: "0.9.4",
@@ -41003,6 +41039,23 @@ var init_CHANGELOG = __esm({
             "load_document"
           ]
         },
+        {
+          id: "2026-07-26-beam-check-thin-walled-fea",
+          version: "0.9.4",
+          date: "2026-07-26",
+          category: "feat",
+          title: "beam_check: audited structural answer for thin walls",
+          summary: "Sheet-metal and tube-frame members had no audited FEA answer at any resolution; beam_check prices them in closed form (Bredt torsion, beam bending, Euler buckling), and analyze_structure now measures the wall and refuses with the cell arithmetic instead of a bare Unverifiable.",
+          features: [
+            "fea",
+            "sheet-metal",
+            "receipts"
+          ],
+          mcpTools: [
+            "beam_check",
+            "analyze_structure"
+          ]
+        },
         {
           id: "2026-07-26-backwards-extrude-inverted-winding",
           version: "0.9.4",
@@ -53324,6 +53377,7 @@ var init_tool_metadata = __esm({
       solve_thermal: { title: "Solve Thermal", annotations: RO },
       simulate_flow: { title: "Simulate Flow", annotations: RO },
       analyze_structure: { title: "Analyze Structure", annotations: RO },
+      beam_check: { title: "Check Beam / Section", annotations: RO },
       simulate_neutron_shield: {
         title: "Simulate Neutron Shield",
         annotations: RO
@@ -57148,6 +57202,14 @@ function totalsSummary(totals) {
     currency: totals.currency
   };
 }
+function documentHardware(documentId) {
+  try {
+    const doc = documents.get(documentId);
+    return Array.isArray(doc?.hardware) ? doc.hardware : [];
+  } catch {
+    return [];
+  }
+}
 async function bomCreate(input, store, user) {
   const args = input ?? {};
   const owner = ownerId(user);
@@ -57162,7 +57224,23 @@ async function bomCreate(input, store, user) {
     created_at: now,
     updated_at: now
   };
-  const lineInputs = Array.isArray(args.lines) ? args.lines : [];
+  const fromGeometry = args.from_geometry !== false;
+  const geometryLines = [];
+  if (fromGeometry && bom.document_id) {
+    for (const hw of documentHardware(bom.document_id)) {
+      geometryLines.push({
+        kind: "cots",
+        name: hw.spec,
+        catalog_id: hw.catalog_id ?? void 0,
+        qty: hw.qty,
+        notes: "counted from the model geometry"
+      });
+    }
+  }
+  const lineInputs = [
+    ...geometryLines,
+    ...Array.isArray(args.lines) ? args.lines : []
+  ];
   for (let i = 0; i < lineInputs.length; i++) {
     const built = await buildLine(lineInputs[i] ?? {}, store, owner);
     if ("error" in built) return err4(`lines[${i}]: ${built.error}`);
@@ -57338,6 +57416,7 @@ var init_bom = __esm({
     init_pricing();
     init_types4();
     init_mech_parts();
+    init_session_core();
     init_tool_def();
     PRICING_NOTE = "All prices are ESTIMATES (Phase-0 quote estimates, catalog price bands, or caller-supplied numbers) \u2014 not binding quotes.";
     memBoms = /* @__PURE__ */ new Map();
@@ -57403,6 +57482,10 @@ var init_bom = __esm({
           type: "array",
           items: { type: "object", properties: lineProperties, required: ["kind"] },
           description: "Optional full line list to build the BOM in ONE call (recommended on serverless \u2014 BOMs are in-memory per instance, so one-shot creation is the robust path)."
+        },
+        from_geometry: {
+          type: "boolean",
+          description: "Seed COTS lines from the hardware the document's geometry declares \u2014 every loon `bolt`/`bolt-circle` (plus its washers and nuts), with quantities already multiplied through patterns. Default true when document_id is given."
         }
       },
       required: []
@@ -57437,7 +57520,7 @@ var init_bom = __esm({
       {
         name: "bom_create",
         pack: "bom",
-        description: "Create a project bill of materials \u2014 the deliverable that collects every manufactured part (PCBs, sheet metal, 3D prints; link quote_manufacturing quotes by quote_id) and COTS part (bearings, shafts, screws, magnets; link search_mechanical_parts entries by catalog_id) in one place. Optionally attach a document_id and assembly notes. Pass the full `lines` array to build the whole BOM in ONE call \u2014 recommended, since BOMs are in-memory per server instance. All prices are estimates and flagged as such.",
+        description: "Create a project bill of materials \u2014 the deliverable that collects every manufactured part (PCBs, sheet metal, 3D prints; link quote_manufacturing quotes by quote_id) and COTS part (bearings, shafts, screws, magnets; link search_mechanical_parts entries by catalog_id) in one place. Optionally attach a document_id and assembly notes. Pass the full `lines` array to build the whole BOM in ONE call \u2014 recommended, since BOMs are in-memory per server instance. When document_id names a resident session, fastener lines are seeded from the geometry itself (every loon `bolt`/`bolt-circle`, quantities multiplied through patterns) \u2014 pass from_geometry:false to opt out. All prices are estimates and flagged as such.",
         inputSchema: bomCreateSchema,
         handler: (a, c) => bomCreate(a, c.fabricateStore, c.user),
         behavior: behavior({})
@@ -72230,7 +72313,7 @@ var init_structure = __esm({
       {
         name: "analyze_structure",
         pack: null,
-        description: 'Static structural FEA on a part\'s real geometry with fail-closed mesh-convergence gating: linear-tet fill of the tessellated interior at 2+ refinement levels, linear-elastic solve (PCG), returning max von Mises stress, max displacement, discretization-error estimates, and (with yield_strength_mpa) a safety factor \u2014 plus `vcad.fea-claims/1` and unified-receipt claims. If QoIs disagree across levels the verdict is Unverifiable and NO stress/displacement claim is emitted (raise resolution, or fillet the singular corner it points at). Claims carry basis "predicted" and roll up Provisional until hardware is load-tested. Scope: small-displacement linear elasticity, one isotropic material; no plasticity, buckling, contact, or dynamic loads; boundary is staircase-approximated at the lattice pitch. Use predict_physics for the fast coarse steering loop; use this for the audited answer.',
+        description: 'Static structural FEA on a part\'s real geometry with fail-closed mesh-convergence gating: linear-tet fill of the tessellated interior at 2+ refinement levels, linear-elastic solve (PCG), returning max von Mises stress, max displacement, discretization-error estimates, and (with yield_strength_mpa) a safety factor \u2014 plus `vcad.fea-claims/1` and unified-receipt claims. If QoIs disagree across levels the verdict is Unverifiable and NO stress/displacement claim is emitted (raise resolution, or fillet the singular corner it points at). Claims carry basis "predicted" and roll up Provisional until hardware is load-tested. Scope: small-displacement linear elasticity, one isotropic material; no plasticity, buckling, contact, or dynamic loads; boundary is staircase-approximated at the lattice pitch. THIN-WALLED PARTS (sheet metal, tube frame, plate) are outside this tool: it measures the thinnest load-bearing section and fails closed with the cell arithmetic and a pointer to beam_check, which is the more accurate answer for a prismatic member anyway. Use predict_physics for the fast coarse steering loop; use this for the audited answer on chunky geometry.',
         inputSchema: {
           type: "object",
           required: ["document_id", "part", "loads", "supports"],
@@ -72295,7 +72378,7 @@ var init_structure = __esm({
             },
             resolution: {
               type: "number",
-              description: "Coarse-level lattice cells along the longest bbox axis (default 24). The finest level is resolution * 2^(levels-1), capped at 160 for this tier. Keep >= ~6 cells through the thinnest load-bearing section."
+              description: "Coarse-level lattice cells along the longest bbox axis (default 24). The finest level is resolution * 2^(levels-1), capped at 160 for this tier. Keep >= ~6 cells through the thinnest load-bearing section \u2014 the tool measures the part and refuses below ~4, with the cell arithmetic attached. Raising this is NOT the lever for a thin wall (a 2 mm wall on a 300 mm member needs ~950 cells): use beam_check."
             },
             levels: {
               type: "number",
@@ -72346,6 +72429,89 @@ var init_structure = __esm({
           });
         },
         behavior: behavior({})
+      },
+      {
+        name: "beam_check",
+        pack: null,
+        description: 'Closed-form structural check of a PRISMATIC member \u2014 the audited answer for thin-walled geometry, where the lattice in analyze_structure cannot put enough cells through the wall at any affordable resolution. Give it a profile (rect, rect_tube, round, round_tube, i_beam), a span, an end condition, and a load case; get section properties (A, I_y, I_z, J, section moduli, torsional stiffness), stresses (bending, axial, torsional and transverse shear, von Mises), deflection with the Timoshenko shear term, twist, the Euler buckling load under compression, and a safety factor \u2014 plus `vcad.fea-claims/1` and unified-receipt claims under `structure.beam.*`. Exact integrals where they exist (round, round tube, rectangle bending), the convergent Saint-Venant series for solid-rectangle torsion, Bredt closed thin-wall theory for tube torsion \u2014 every approximation is stated in the returned notes. For a constant cross-section this is not a fallback: it beats a staircased lattice on accuracy and costs microseconds. Fail-closed: too stubby for beam theory (L/depth < 5), too thick-walled for Bredt, deflecting past a tenth of the span, torque on an open section, or buckling before it yields \u2014 any of those makes the verdict Unverifiable and NO QoI is claimed, with the reason naming the route forward. Claims carry basis "predicted" and roll up Provisional until hardware is load-tested. Scope: one uniform section over the whole span, idealized ends, no stress concentrations (holes, welds, corner radii), no local wall buckling, no fatigue. Needs no document \u2014 it is geometry-by-description, so it works before the part exists.',
+        inputSchema: {
+          type: "object",
+          required: ["profile", "length_mm", "end_condition"],
+          properties: {
+            profile: {
+              type: "object",
+              required: ["type"],
+              description: 'Cross-section. The member runs along X and the section lives in (Y, Z): width_mm is the Y extent, height_mm the Z extent. One of: {"type":"rect",width_mm,height_mm}, {"type":"rect_tube",width_mm,height_mm,wall_mm}, {"type":"round",diameter_mm}, {"type":"round_tube",diameter_mm,wall_mm}, {"type":"i_beam",width_mm,height_mm,flange_mm,web_mm}. Tube dimensions are OUTSIDE dimensions.',
+              properties: {
+                type: {
+                  type: "string",
+                  enum: ["rect", "rect_tube", "round", "round_tube", "i_beam"]
+                },
+                width_mm: { type: "number", description: "Y extent, mm." },
+                height_mm: { type: "number", description: "Z extent, mm." },
+                wall_mm: { type: "number", description: "Wall thickness, mm." },
+                diameter_mm: { type: "number", description: "Outside diameter, mm." },
+                flange_mm: { type: "number", description: "Flange thickness, mm." },
+                web_mm: { type: "number", description: "Web thickness, mm." }
+              }
+            },
+            length_mm: {
+              type: "number",
+              description: "Free span between supports, mm."
+            },
+            end_condition: {
+              type: "string",
+              enum: [
+                "cantilever_tip",
+                "cantilever_uniform",
+                "simple_center",
+                "simple_uniform",
+                "fixed_fixed_center",
+                "fixed_fixed_uniform"
+              ],
+              description: "Support and load arrangement. `*_uniform` spreads the transverse force over the span; `*_center`/`*_tip` concentrates it. Also sets the Euler effective-length factor (cantilever K=2, simple K=1, fixed-fixed K=0.5)."
+            },
+            transverse_force_n: {
+              type: "number",
+              description: "Total transverse force, N (magnitude). Default 0."
+            },
+            bend_axis: {
+              type: "string",
+              enum: ["y", "z"],
+              description: "Which principal axis to bend about: `y` uses I_y and deflects along Z (default), `z` uses I_z and deflects along Y. Matters for any non-square section."
+            },
+            torque_nmm: {
+              type: "number",
+              description: "Torque about the member axis, N\xB7mm (1 N\xB7m = 1000 N\xB7mm). Default 0. This is the case closed-form theory answers best and the lattice answers worst."
+            },
+            axial_force_n: {
+              type: "number",
+              description: "Axial force, N \u2014 positive tension, negative compression. Compression is also checked against Euler buckling, and a member that buckles is reported Unverifiable rather than 'safe'. Default 0."
+            },
+            youngs_modulus_mpa: {
+              type: "number",
+              description: "Young's modulus, MPa. Default 69000 (6061 aluminum); steel ~200000, PLA ~2300."
+            },
+            poisson: {
+              type: "number",
+              description: "Poisson's ratio in [0, 0.5). Default 0.33; sets G = E/(2(1+nu))."
+            },
+            yield_strength_mpa: {
+              type: "number",
+              description: "Yield strength, MPa. When given, safety_factor = yield / von Mises is computed and claimed (applicable checks only)."
+            }
+          }
+        },
+        handler: (args, ctx) => {
+          const a = args;
+          const started = performance.now();
+          const out = ctx.engine.feaCheckBeam(JSON.stringify(a));
+          return textResult7({
+            solve_ms: Math.round(performance.now() - started),
+            ...out
+          });
+        },
+        behavior: behavior({})
       }
     ];
   }
@@ -80049,8 +80215,8 @@ var init_server3 = __esm({
     init_order_feed();
     init_animate();
     PKG_VERSION = (() => {
-      if ("0.9.4-main.36") {
-        return "0.9.4-main.36";
+      if ("0.9.4-main.38") {
+        return "0.9.4-main.38";
       }
       try {
         const req = createRequire2(import.meta.url);
@@ -80059,8 +80225,8 @@ var init_server3 = __esm({
         return "0.0.0";
       }
     })();
-    BUILD_SHA = "3b9087f300b569c70aa24cebc52af06d15e59187";
-    BUILD_TIME = "2026-07-26T13:20:01.737Z";
+    BUILD_SHA = "254d4e9d13825ac74a895590703959d77898e1f3";
+    BUILD_TIME = "2026-07-26T13:42:07.736Z";
     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);
@@ -80208,6 +80374,7 @@ var init_server3 = __esm({
       "solve_thermal",
       "simulate_flow",
       "analyze_structure",
+      "beam_check",
       "simulate_neutron_shield",
       "simulate_lattice_gauge",
       "analyze_tolerance_stackup",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vcad/mcp",
-  "version": "0.9.4-main.36",
+  "version": "0.9.4-main.38",
   "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": "3b9087f300b569c70aa24cebc52af06d15e59187",
-    "builtAt": "2026-07-26T13:20:01.737Z"
+    "sha": "254d4e9d13825ac74a895590703959d77898e1f3",
+    "builtAt": "2026-07-26T13:42:07.736Z"
   }
 }