@vcad/mcp 0.11.0-main.159 → 0.11.0-main.163

package/README.md

@@ -9,4 +9,4 @@ vcad's MCP server as a self-contained bundle (server + BRep kernel WASM).
 Or install vcad.app, which registers this server with your agents on first launch.
 The agent skill ships at `skill/SKILL.md`.
 
-Built from 6ca36502681cbcd14c0248e16ea270d62193338f at 2026-11-11T16:44:44.291Z. Source: https://github.com/muni-works/vcad
+Built from 816ee12b085c12b403a35ebfedb6c276e175a3af at 2026-11-11T21:40:44.212Z. Source: https://github.com/muni-works/vcad

package/index.mjs

@@ -10277,6 +10277,11 @@ function evaluateOp(op, nodes, Solid2, cache, depth = 0) {
     }
     case "Sketch2D":
       return Solid2.empty();
+    // A sketch attached to a named face: like Sketch2D, it is not a solid
+    // itself. (The native evaluator resolves the face; this legacy TS path
+    // only needs the switch to stay exhaustive.)
+    case "SketchOnFace":
+      return Solid2.empty();
     case "Extrude": {
       const sketchNode = nodes[String(op.sketch)];
       if (!sketchNode) {
@@ -11307,9 +11312,9 @@ function workerTransport(worker) {
     pending.delete(id);
   });
   return {
-    request: (req) => new Promise((resolve8) => {
+    request: (req) => new Promise((resolve9) => {
       const id = next++;
-      pending.set(id, resolve8);
+      pending.set(id, resolve9);
       worker.postMessage({ id, req });
     }),
     dispose: () => worker.terminate()
@@ -12188,11 +12193,11 @@ var init_analyze = __esm({
           type: "module"
         });
         this.worker = worker;
-        this.ready = new Promise((resolve8, reject) => {
+        this.ready = new Promise((resolve9, reject) => {
           const onMessage = (e) => {
             const { type, id, message, analysis } = e.data;
             if (type === "ready") {
-              resolve8();
+              resolve9();
               return;
             }
             if (type === "error" && id === null) {
@@ -12216,9 +12221,9 @@ var init_analyze = __esm({
         return this.ready;
       }
       request(msg, transfer = []) {
-        return this.ensureWorker().then(() => new Promise((resolve8, reject) => {
+        return this.ensureWorker().then(() => new Promise((resolve9, reject) => {
           const id = this.nextId++;
-          this.pending.set(id, { resolve: resolve8, reject });
+          this.pending.set(id, { resolve: resolve9, reject });
           this.worker.postMessage({ ...msg, id }, transfer);
         }));
       }
@@ -12835,11 +12840,11 @@ var init_dist = __esm({
           return;
         try {
           const worker = new Worker(new URL("./eval-worker.js", import.meta.url), { type: "module" });
-          this.workerReady = new Promise((resolve8, reject) => {
+          this.workerReady = new Promise((resolve9, reject) => {
             const onMessage = (e) => {
               if (e.data.type === "ready") {
                 worker.removeEventListener("message", onMessage);
-                resolve8();
+                resolve9();
               } else if (e.data.type === "error" && e.data.id === null) {
                 worker.removeEventListener("message", onMessage);
                 console.warn("[ENGINE] Worker WASM init failed:", e.data.message);
@@ -13062,7 +13067,7 @@ var init_dist = __esm({
         const worker = this.worker;
         const id = Math.random().toString(36).slice(2);
         const skipClash = options.skipClashDetection ?? false;
-        return new Promise((resolve8, reject) => {
+        return new Promise((resolve9, reject) => {
           const onMessage = (e) => {
             if (e.data.id !== id)
               return;
@@ -13072,7 +13077,7 @@ var init_dist = __esm({
               if (scene.timing && _Engine.DEV) {
                 _Engine.logTiming(scene.timing, e.data.workerTotalMs);
               }
-              resolve8(scene);
+              resolve9(scene);
             } else if (e.data.type === "error") {
               reject(new Error(e.data.message));
             }
@@ -17360,7 +17365,7 @@ function isRef(value) {
 function cloneIssues(issues) {
   return issues.map((iss) => iss.path ? { ...iss, path: iss.path.slice() } : { ...iss });
 }
-function isRecursive(inst, stack, resolve8) {
+function isRecursive(inst, stack, resolve9) {
   const cached3 = recursive.get(inst);
   if (cached3 !== void 0)
     return cached3 ? PROVEN : NONE;
@@ -17370,7 +17375,7 @@ function isRecursive(inst, stack, resolve8) {
   let result = NONE;
   const check = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve8);
+      const answer = isRecursive(child, stack, resolve9);
       if (answer > result)
         result = answer;
     }
@@ -17381,7 +17386,7 @@ function isRecursive(inst, stack, resolve8) {
       const desc = Object.getOwnPropertyDescriptor(sh, key3);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve8) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve9) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -17445,7 +17450,7 @@ function isRecursive(inst, stack, resolve8) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve8 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve9 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -22199,12 +22204,12 @@ var init_stdio2 = __esm({
         this.onclose?.();
       }
       send(message) {
-        return new Promise((resolve8) => {
+        return new Promise((resolve9) => {
           const json = serializeMessage(message);
           if (this._stdout.write(json)) {
-            resolve8();
+            resolve9();
           } else {
-            this._stdout.once("drain", resolve8);
+            this._stdout.once("drain", resolve9);
           }
         });
       }
@@ -23241,7 +23246,7 @@ var init_protocol = __esm({
               return;
             }
             const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-            await new Promise((resolve8) => setTimeout(resolve8, pollInterval));
+            await new Promise((resolve9) => setTimeout(resolve9, pollInterval));
             options?.signal?.throwIfAborted();
           }
         } catch (error2) {
@@ -23258,7 +23263,7 @@ var init_protocol = __esm({
        */
       request(request, resultSchema, options) {
         const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-        return new Promise((resolve8, reject) => {
+        return new Promise((resolve9, reject) => {
           const earlyReject = (error2) => {
             reject(error2);
           };
@@ -23336,7 +23341,7 @@ var init_protocol = __esm({
               if (!parseResult.success) {
                 reject(parseResult.error);
               } else {
-                resolve8(parseResult.data);
+                resolve9(parseResult.data);
               }
             } catch (error2) {
               reject(error2);
@@ -23597,12 +23602,12 @@ var init_protocol = __esm({
           }
         } catch {
         }
-        return new Promise((resolve8, reject) => {
+        return new Promise((resolve9, reject) => {
           if (signal.aborted) {
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
             return;
           }
-          const timeoutId = setTimeout(resolve8, interval);
+          const timeoutId = setTimeout(resolve9, interval);
           signal.addEventListener("abort", () => {
             clearTimeout(timeoutId);
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -26629,7 +26634,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve8.call(this, root, ref);
+      let _sch = resolve9.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -26656,7 +26661,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve8(root, ref) {
+    function resolve9(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -27231,7 +27236,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve8(baseURI, relativeURI, options) {
+    function resolve9(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse5(baseURI, schemelessOptions), parse5(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -27458,7 +27463,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize2,
-      resolve: resolve8,
+      resolve: resolve9,
       resolveComponent,
       equal,
       serialize,
@@ -33630,21 +33635,21 @@ var require_react_development = __commonJS({
         );
         actScopeDepth = prevActScopeDepth;
       }
-      function recursivelyFlushAsyncActWork(returnValue, resolve8, reject) {
+      function recursivelyFlushAsyncActWork(returnValue, resolve9, reject) {
         var queue = ReactSharedInternals.actQueue;
         if (null !== queue)
           if (0 !== queue.length)
             try {
               flushActQueue(queue);
               enqueueTask(function() {
-                return recursivelyFlushAsyncActWork(returnValue, resolve8, reject);
+                return recursivelyFlushAsyncActWork(returnValue, resolve9, reject);
               });
               return;
             } catch (error2) {
               ReactSharedInternals.thrownErrors.push(error2);
             }
           else ReactSharedInternals.actQueue = null;
-        0 < ReactSharedInternals.thrownErrors.length ? (queue = aggregateErrors(ReactSharedInternals.thrownErrors), ReactSharedInternals.thrownErrors.length = 0, reject(queue)) : resolve8(returnValue);
+        0 < ReactSharedInternals.thrownErrors.length ? (queue = aggregateErrors(ReactSharedInternals.thrownErrors), ReactSharedInternals.thrownErrors.length = 0, reject(queue)) : resolve9(returnValue);
       }
       function flushActQueue(queue) {
         if (!isFlushing) {
@@ -33831,7 +33836,7 @@ var require_react_development = __commonJS({
             ));
           });
           return {
-            then: function(resolve8, reject) {
+            then: function(resolve9, reject) {
               didAwaitActCall = true;
               thenable.then(
                 function(returnValue) {
@@ -33841,7 +33846,7 @@ var require_react_development = __commonJS({
                       flushActQueue(queue), enqueueTask(function() {
                         return recursivelyFlushAsyncActWork(
                           returnValue,
-                          resolve8,
+                          resolve9,
                           reject
                         );
                       });
@@ -33855,7 +33860,7 @@ var require_react_development = __commonJS({
                       ReactSharedInternals.thrownErrors.length = 0;
                       reject(_thrownError);
                     }
-                  } else resolve8(returnValue);
+                  } else resolve9(returnValue);
                 },
                 function(error2) {
                   popActScope(prevActQueue, prevActScopeDepth);
@@ -33877,15 +33882,15 @@ var require_react_development = __commonJS({
         if (0 < ReactSharedInternals.thrownErrors.length)
           throw callback = aggregateErrors(ReactSharedInternals.thrownErrors), ReactSharedInternals.thrownErrors.length = 0, callback;
         return {
-          then: function(resolve8, reject) {
+          then: function(resolve9, reject) {
             didAwaitActCall = true;
             0 === prevActScopeDepth ? (ReactSharedInternals.actQueue = queue, enqueueTask(function() {
               return recursivelyFlushAsyncActWork(
                 returnValue$jscomp$0,
-                resolve8,
+                resolve9,
                 reject
               );
-            })) : resolve8(returnValue$jscomp$0);
+            })) : resolve9(returnValue$jscomp$0);
           }
         };
       };
@@ -44782,6 +44787,100 @@ var init_CHANGELOG = __esm({
             "export_cad"
           ]
         },
+        {
+          id: "2026-11-11-step-interop-audit",
+          version: "0.11.0",
+          date: "2026-11-11",
+          category: "fix",
+          title: "STEP import: no hangs, colours, assembly placement",
+          summary: "KiCad and FreeCAD STEP files no longer hang; reversed face bounds read right; colours, part names and assembly instance poses import and colours export; rational surfaces export.",
+          features: [
+            "step",
+            "import",
+            "export",
+            "native-app"
+          ]
+        },
+        {
+          id: "2026-11-11-sketch-on-face",
+          version: "undefined",
+          date: "2026-11-11",
+          category: "feat",
+          title: "Sketches drawn on a face follow that face",
+          summary: "A sketch drawn on a named face now re-attaches to it on every rebuild, so a boss on a plate's top stays on top when the plate gets thicker. An unresolvable face fails closed.",
+          features: [
+            "sketch",
+            "naming",
+            "history"
+          ]
+        },
+        {
+          id: "2026-11-11-sketch-inference-smart-dimension",
+          version: "0.11.0",
+          date: "2026-11-11",
+          category: "feat",
+          title: "Mac sketching: inference, Smart Dimension, trim and fillet",
+          summary: "The Mac app's sketcher infers constraints while drawing, sizes or pairs with one Smart Dimension tool, colours by solve state, drags to solve, and adds construction, trim, extend, fillet, mirror, patterns and live profile shading.",
+          features: [
+            "sketch",
+            "constraints",
+            "mac-app"
+          ]
+        },
+        {
+          id: "2026-11-11-revolve-profile-on-axis",
+          version: "0.11.0",
+          date: "2026-11-11",
+          category: "fix",
+          title: "Revolve profiles that touch their axis",
+          summary: "Sketch revolve now accepts profiles with vertices on the axis: axis edges add no face, perpendicular edges become full discs, slanted edges become cones with an apex.",
+          features: [
+            "revolve",
+            "sketch"
+          ]
+        },
+        {
+          id: "2026-11-11-print-from-vcad",
+          version: "0.11.0",
+          date: "2026-11-11",
+          category: "feat",
+          title: "Print to a Bambu printer straight from vcad",
+          summary: "3D Print is now Orient \u2192 Slice \u2192 Printer \u2192 Print: auto-orientation for fewest supports, LAN pairing, live printer and AMS status, a confirmed gated send, and pause/resume/stop.",
+          features: [
+            "3d-print",
+            "slicer",
+            "printer",
+            "mac-app"
+          ]
+        },
+        {
+          id: "2026-11-11-per-instance-agent-discovery",
+          version: "undefined",
+          date: "2026-11-11",
+          category: "fix",
+          title: "Agents no longer drive the wrong vcad.app window",
+          summary: "Each vcad.app instance registers its own discovery file; clients pick one via VCAD_APP_PID/URL/DOCUMENT, every bridge result names its window, and a relaunch is reported.",
+          features: [
+            "agent-bridge",
+            "mcp",
+            "mac-app"
+          ]
+        },
+        {
+          id: "2026-11-11-one-click-drawings",
+          version: "0.11.0",
+          date: "2026-11-11",
+          category: "feat",
+          title: "One-click drawings with automatic dimensions",
+          summary: "Drawing workspace lays out front/top/right/iso on an auto-sized sheet with hole callouts, center marks and editable dimensions; exports vector PDF and true-scale DXF.",
+          features: [
+            "drawings",
+            "drafting",
+            "native-app",
+            "gdt"
+          ],
+          mcpTools: []
+        },
         {
           id: "2026-11-11-one-breath-install",
           version: "0.11.0",
@@ -44798,6 +44897,20 @@ var init_CHANGELOG = __esm({
             "server_info"
           ]
         },
+        {
+          id: "2026-11-11-local-data-trust",
+          version: "undefined",
+          date: "2026-11-11",
+          category: "feat",
+          title: "Autosave, crash recovery, and version history",
+          summary: "The Mac app autosaves every few seconds, offers to restore unsaved work after a crash, and keeps per-document versions you can preview, restore, or duplicate.",
+          features: [
+            "mac-app",
+            "autosave",
+            "versions",
+            "recovery"
+          ]
+        },
         {
           id: "2026-11-11-live-receipt-badges",
           version: "0.11.0",
@@ -44819,6 +44932,46 @@ var init_CHANGELOG = __esm({
             "ask_user"
           ]
         },
+        {
+          id: "2026-11-11-history-edits-keep-references",
+          version: "undefined",
+          date: "2026-11-11",
+          category: "feat",
+          title: "Edits to earlier features keep downstream references",
+          summary: "Extruded faces are named after their sketch segments and fillets, chamfers and shells keep face names, so picked edges survive edits. Move Up/Down refuses moves that would drop a feature.",
+          features: [
+            "naming",
+            "feature-tree",
+            "history"
+          ]
+        },
+        {
+          id: "2026-11-11-fusion-model-edges",
+          version: "1.0.0",
+          date: "2026-11-11",
+          category: "feat",
+          title: "Model edges drawn like Fusion 360",
+          summary: "The Mac app now outlines every B-rep face boundary, tangent fillet edges included, and draws outlines on assembly instances too. Mesh-only parts keep crease edges.",
+          features: [
+            "viewport",
+            "edges",
+            "assembly"
+          ]
+        },
+        {
+          id: "2026-11-11-direct-manipulation",
+          version: "undefined",
+          date: "2026-11-11",
+          category: "feat",
+          title: "Direct manipulation: press-pull, handles, live dimensions",
+          summary: "Mac app: press-pull planar faces into real features, drag on-canvas handles for extrude/fillet/shell, type exact values into a live dimension, and a redesigned hairline gizmo.",
+          features: [
+            "mac-app",
+            "viewport",
+            "gizmo",
+            "press-pull"
+          ]
+        },
         {
           id: "2026-11-11-counterbore-breakout",
           version: "0.11.0",
@@ -44831,6 +44984,32 @@ var init_CHANGELOG = __esm({
             "kernel"
           ]
         },
+        {
+          id: "2026-11-11-assembly-export-clearance-step-cache",
+          version: "undefined",
+          date: "2026-11-11",
+          category: "fix",
+          title: "Assembly export, interference and big STEP opens fixed",
+          summary: "Assembly GLB/STL no longer duplicates every part at the origin, STEP exports posed instances, interference scales to big assemblies, and STEP assemblies parse once.",
+          features: [
+            "assembly",
+            "export",
+            "step",
+            "clearance"
+          ]
+        },
+        {
+          id: "2026-11-11-arc-extrude-boolean-tearing",
+          version: "0.11.0",
+          date: "2026-11-11",
+          category: "fix",
+          title: "No more tearing when cutting into extruded arc walls",
+          summary: "Booleans that split the curved wall of an arc-bearing sketch extrude no longer tear the wall away from its caps; results stay watertight.",
+          features: [
+            "booleans",
+            "extrude"
+          ]
+        },
         {
           id: "2026-11-11-agent-cursor",
           version: "0.11.0",
@@ -45116,6 +45295,22 @@ var init_CHANGELOG = __esm({
             "inspect_cad"
           ]
         },
+        {
+          id: "2026-11-10-import-from-photos",
+          version: "0.11.0",
+          date: "2026-11-10",
+          category: "feat",
+          title: "Experimental: import a part from photos",
+          summary: "Mac app: photos of a part beside a tag36h11 AprilTag become an editable document with named, \xB1\u03C3 dimensions. Tested on synthetic renders only, not yet real photos.",
+          features: [
+            "native",
+            "mac",
+            "import",
+            "image-to-cad",
+            "parameters",
+            "experimental"
+          ]
+        },
         {
           id: "2026-11-10-gym-step-angle-units",
           version: "0.11.0",
@@ -47192,6 +47387,20 @@ var init_CHANGELOG = __esm({
             "manufacture"
           ]
         },
+        {
+          id: "2026-10-13-cone-frustum-radii",
+          version: "0.10.0",
+          date: "2026-10-13",
+          category: "fix",
+          title: "Cone frustum keeps its radii when the top is wider",
+          summary: "A cone/frustum whose top radius exceeds its base no longer swaps the two radii: the apex is now placed from the base radius, so the solid matches the requested geometry.",
+          details: "ConeSurface::from_frustum placed the apex from radius_top in the radius_bottom < radius_top branch, so the lateral surface came out with the radii swapped even though the B-rep circles were correct: Solid::cone(2, 10, 10) produced radius 10 at z=0 and 18 at z=10 instead of 2 and 10, with a volume about 3x the analytic value. Volume and bounding box are symmetric in the two radii, so neither caught it; it only showed in an asymmetric operation or a per-z-band radius sample. This affected any cone with radius_top > radius_bottom, including cylinder(r1 < r2) imported from OpenSCAD and zero-radius cones such as cylinder(h=10, r1=0, r2=5), which additionally tessellated non-watertight.",
+          features: [
+            "kernel",
+            "geometry",
+            "primitives"
+          ]
+        },
         {
           id: "2026-09-17-native-instant-open-contour-cam",
           version: "0.10.0",
@@ -57195,10 +57404,86 @@ var init_source_provenance = __esm({
   }
 });
 
-// src/app-link.ts
-import { readFileSync as readFileSync5 } from "node:fs";
+// src/app-discovery.ts
+import { readdirSync as readdirSync2, readFileSync as readFileSync5 } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, isAbsolute as isAbsolute4, join as join3 } from "node:path";
+import { join as join3, resolve as resolve3 } from "node:path";
+function isAlive(pid) {
+  if (typeof pid !== "number" || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (e) {
+    return e.code === "EPERM";
+  }
+}
+function describeInstance(r) {
+  return `pid ${r.pid} (${r.document_name ?? r.document_path ?? "no document"})`;
+}
+function listInstances({ home = homedir(), alive = isAlive } = {}) {
+  const root = join3(home, ".vcad");
+  const read = (p) => {
+    try {
+      return JSON.parse(readFileSync5(p, "utf8"));
+    } catch {
+      return null;
+    }
+  };
+  let records = [];
+  try {
+    const dir = join3(root, "instances");
+    records = readdirSync2(dir).filter((f) => f.endsWith(".json")).map((f) => read(join3(dir, f))).filter((r) => r !== null);
+  } catch {
+  }
+  if (records.length === 0) {
+    const legacy = read(join3(root, "app.json"));
+    if (legacy) records = [legacy];
+  }
+  return records.filter((r) => alive(r.pid)).sort((a, b) => String(b.started ?? "").localeCompare(String(a.started ?? "")));
+}
+function selectInstance({
+  env = process.env,
+  instances,
+  documentPath
+}) {
+  if (env.VCAD_APP_URL) {
+    const url = env.VCAD_APP_URL;
+    return { url, instance: instances.find((r) => urlOf(r) === url) ?? null };
+  }
+  if (env.VCAD_APP_PID) {
+    const pid = Number(env.VCAD_APP_PID);
+    const instance2 = instances.find((r) => r.pid === pid);
+    if (!instance2) {
+      const others2 = instances.length ? ` Running: ${instances.map(describeInstance).join(", ")}.` : "";
+      return { error: `VCAD_APP_PID=${env.VCAD_APP_PID}: no running vcad.app with that pid.${others2}` };
+    }
+    return { url: urlOf(instance2), instance: instance2 };
+  }
+  if (instances.length === 0) return { error: "no running vcad.app found (~/.vcad/instances is empty)" };
+  const wanted = documentPath ?? env.VCAD_APP_DOCUMENT;
+  if (wanted) {
+    const abs = resolve3(wanted);
+    const instance2 = instances.find((r) => r.document_path && resolve3(r.document_path) === abs);
+    if (instance2) return { url: urlOf(instance2), instance: instance2 };
+  }
+  const [instance, ...others] = instances;
+  if (!others.length) return { url: urlOf(instance), instance };
+  return {
+    url: urlOf(instance),
+    instance,
+    warning: `${instances.length} vcad.app instances are running; using the newest, ${describeInstance(instance)}. Others: ${others.map(describeInstance).join(", ")}. Set VCAD_APP_PID to choose.`
+  };
+}
+var urlOf;
+var init_app_discovery = __esm({
+  "src/app-discovery.ts"() {
+    "use strict";
+    urlOf = (r) => r.url ?? `http://127.0.0.1:${r.port}/mcp`;
+  }
+});
+
+// src/app-link.ts
+import { dirname, isAbsolute as isAbsolute4 } from "node:path";
 function noteDocumentFolder(documentId, folder) {
   folders.set(documentId, folder);
 }
@@ -57210,13 +57495,27 @@ function documentFolder(documentId, document) {
 }
 function endpoint() {
   if (process.env.VCAD_APP === "0") return null;
-  try {
-    const info = JSON.parse(readFileSync5(join3(homedir(), ".vcad", "app.json"), "utf8"));
-    if (typeof info.pid === "number") process.kill(info.pid, 0);
-    return info.url ?? `http://127.0.0.1:${info.port}/mcp`;
-  } catch {
-    return null;
+  const instances = listInstances();
+  if (pinned && (process.env.VCAD_APP_URL || instances.some((r) => r.pid === pinned?.instance?.pid))) {
+    return pinned.url;
+  }
+  const pick2 = selectInstance({ instances });
+  if (pick2.error !== void 0) return null;
+  if (pick2.warning && pick2.warning !== warned) {
+    warned = pick2.warning;
+    process.stderr.write(`[vcad-mcp] ${pick2.warning}
+`);
   }
+  const prev = pinned?.instance;
+  if (prev && pick2.instance && prev.instance_id !== pick2.instance.instance_id) {
+    appChanged(prev, pick2.instance);
+  }
+  pinned = { url: pick2.url, instance: pick2.instance };
+  return pick2.url;
+}
+function appChanged(prev, next) {
+  const why = `The vcad app changed: ${describeInstance(prev)} is gone, now linked to ${describeInstance(next)} (it relaunched, or another window took over). Edits stay in this session. To show it there, call show_in_app.`;
+  for (const id of links.keys()) loseWindow(id, why);
 }
 async function reconcileBeforeWrite(documentId, documents2, call = callApp) {
   const link = links.get(documentId);
@@ -57430,14 +57729,17 @@ function pushPose(documentId, joints, call = callApp, now = Date.now(), base) {
   sendPose(frame, now);
   return true;
 }
-var links, folders, callApp, PUSH_WAIT_MS, RECONCILE_WAIT_MS, wait, pushes, lateNotes, LOST_WINDOW, OPENING_TOOLS, toolDefs3, POSE_INTERVAL_MS, poseBusy, lastPose, pendingRestart, pendingLatest, poseTimer;
+var links, folders, pinned, warned, callApp, PUSH_WAIT_MS, RECONCILE_WAIT_MS, wait, pushes, lateNotes, LOST_WINDOW, OPENING_TOOLS, toolDefs3, POSE_INTERVAL_MS, poseBusy, lastPose, pendingRestart, pendingLatest, poseTimer;
 var init_app_link = __esm({
   "src/app-link.ts"() {
     "use strict";
+    init_app_discovery();
     init_session_core();
     init_tool_def();
     links = /* @__PURE__ */ new Map();
     folders = /* @__PURE__ */ new Map();
+    pinned = null;
+    warned = "";
     callApp = async (tool, args) => {
       const url = endpoint();
       if (!url) return null;
@@ -57507,7 +57809,7 @@ var init_app_link = __esm({
 
 // src/tools/session.ts
 import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, readFileSync as readFileSync6 } from "node:fs";
-import { dirname as dirname2, resolve as resolve3 } from "node:path";
+import { dirname as dirname2, resolve as resolve4 } from "node:path";
 import { randomBytes as randomBytes2 } from "node:crypto";
 import { AsyncLocalStorage } from "node:async_hooks";
 function durabilityWarning() {
@@ -57579,7 +57881,7 @@ function openDocument(args) {
   };
 }
 function writeLocalSnapshot(id, json) {
-  const dir = resolve3(stateRoot(), "get_document");
+  const dir = resolve4(stateRoot(), "get_document");
   mkdirSync2(dir, { recursive: true });
   const path = resolveWithinRoot(`${id}.vcad`, dir);
   writeFileSync2(path, json);
@@ -57792,7 +58094,7 @@ async function loadDocumentFromPath(path, store, engine) {
       "`path` loads are local/stdio only \u2014 this server's filesystem is ephemeral. Pass the source inline to create_cad_loon, or save with save_document and reopen by `name`."
     );
   }
-  const abs = resolve3(path);
+  const abs = resolve4(path);
   let raw;
   try {
     raw = readFileSync6(abs, "utf8");
@@ -61597,8 +61899,8 @@ async function openBridge(createServer2, clientInfo, clientCapabilities, hooks)
   await server.connect(serverSide);
   const rpc = (method, params) => {
     const id = nextId3++;
-    return new Promise((resolve8) => {
-      pending.set(id, (m) => resolve8(m));
+    return new Promise((resolve9) => {
+      pending.set(id, (m) => resolve9(m));
       void clientSide.send({
         jsonrpc: "2.0",
         id,
@@ -61935,8 +62237,8 @@ function taskElicitation(bridge, reqParams) {
     method: "elicitation/create",
     params: cleanParams
   };
-  return new Promise((resolve8) => {
-    record2.pendingInputs.set(key3, resolve8);
+  return new Promise((resolve9) => {
+    record2.pendingInputs.set(key3, resolve9);
     touchTask(record2, "input_required", "waiting for client input");
   });
 }
@@ -61961,11 +62263,11 @@ function handleTaskMethod(id, method, params) {
   if (method === "tasks/update") {
     const responses = params.inputResponses && typeof params.inputResponses === "object" ? params.inputResponses : {};
     for (const [key3, response] of Object.entries(responses)) {
-      const resolve8 = record2.pendingInputs.get(key3);
-      if (!resolve8) continue;
+      const resolve9 = record2.pendingInputs.get(key3);
+      if (!resolve9) continue;
       record2.pendingInputs.delete(key3);
       delete record2.inputRequests[key3];
-      resolve8(response);
+      resolve9(response);
     }
     if (record2.status === "input_required" && Object.keys(record2.inputRequests).length === 0) {
       touchTask(record2, "working", `running ${record2.toolName}`);
@@ -61977,10 +62279,10 @@ function handleTaskMethod(id, method, params) {
   }
   record2.cancelRequested = true;
   if (record2.status === "working" || record2.status === "input_required") {
-    for (const [key3, resolve8] of record2.pendingInputs) {
+    for (const [key3, resolve9] of record2.pendingInputs) {
       record2.pendingInputs.delete(key3);
       delete record2.inputRequests[key3];
-      resolve8({ action: "cancel" });
+      resolve9({ action: "cancel" });
     }
     touchTask(record2, "cancelled", "cancelled by client");
   }
@@ -62658,7 +62960,7 @@ function normalizeOp(op, index) {
   return { name, args };
 }
 function resolveSymbolicRefs(args, createdIds, index) {
-  const resolve8 = (v) => {
+  const resolve9 = (v) => {
     if (typeof v !== "string") return v;
     const m = SYMBOLIC_REF.exec(v);
     if (!m) return v;
@@ -62678,15 +62980,15 @@ function resolveSymbolicRefs(args, createdIds, index) {
   };
   const out = { ...args };
   for (const key3 of ["part_id", "node_id"]) {
-    if (key3 in out) out[key3] = resolve8(out[key3]);
+    if (key3 in out) out[key3] = resolve9(out[key3]);
   }
   if (out.params && typeof out.params === "object" && !Array.isArray(out.params)) {
     const params = { ...out.params };
     for (const key3 of ["child", "left", "right", "sketch"]) {
-      if (key3 in params) params[key3] = resolve8(params[key3]);
+      if (key3 in params) params[key3] = resolve9(params[key3]);
     }
     if (Array.isArray(params.sketches)) {
-      params.sketches = params.sketches.map(resolve8);
+      params.sketches = params.sketches.map(resolve9);
     }
     out.params = params;
   }
@@ -67349,7 +67651,7 @@ async function flattenSchematic(sheet, netlister) {
     if (def.body.hierarchy) {
       err9(`Sheet '${def.name}' body has its own hierarchy \u2014 nest sheets with \`instances\` instead (ignored)`);
     }
-    const resolve8 = (name) => {
+    const resolve9 = (name) => {
       if (ports.has(name)) {
         const bound = binding.get(name);
         if (bound !== void 0) return bound;
@@ -67377,7 +67679,7 @@ async function flattenSchematic(sheet, netlister) {
       if (pins.length === 0) continue;
       if (isAutoName(name) && pins.length < 2) continue;
       usedNames.add(name);
-      const flat = resolve8(name);
+      const flat = resolve9(name);
       if (!ports.has(name) && !globals.has(name) && rootNames.has(flat)) {
         err9(
           `Net scope collision: local net '${name}' of sheet instance '${path}' flattens to '${flat}', which the root sheet also uses`
@@ -67401,9 +67703,9 @@ async function flattenSchematic(sheet, netlister) {
         warn(`Hierarchical port '${port}' of sheet '${def.name}' connects to nothing inside the sheet`);
       }
     }
-    for (const flag of def.body.power_flags ?? []) outFlags.push({ ...flag, net: resolve8(flag.net) });
+    for (const flag of def.body.power_flags ?? []) outFlags.push({ ...flag, net: resolve9(flag.net) });
     instances.push({ path, sheet: def.name, refs });
-    await elaborateAll(def.instances ?? [], path, offset, resolve8, stack);
+    await elaborateAll(def.instances ?? [], path, offset, resolve9, stack);
   };
   await elaborateAll(h.instances ?? [], "", { x: 0, y: 0 }, (n) => n, []);
   const nets = {};
@@ -68958,12 +69260,12 @@ var init_enclosure = __esm({
 // src/wasm/ecad-diff.ts
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
-import { dirname as dirname3, resolve as resolve4 } from "node:path";
+import { dirname as dirname3, resolve as resolve5 } from "node:path";
 function load() {
   if (cached2 !== void 0) return cached2;
   try {
     const here = dirname3(fileURLToPath(import.meta.url));
-    const pkg = resolve4(here, "../../../../crates/vcad-ecad-diff-wasm/pkg/vcad_ecad_diff_wasm.js");
+    const pkg = resolve5(here, "../../../../crates/vcad-ecad-diff-wasm/pkg/vcad_ecad_diff_wasm.js");
     const req = createRequire(import.meta.url);
     cached2 = req(pkg);
   } catch {
@@ -82845,7 +83147,7 @@ import { execFile } from "child_process";
 import {
   existsSync as existsSync4,
   mkdtempSync as mkdtempSync2,
-  readdirSync as readdirSync2,
+  readdirSync as readdirSync3,
   readFileSync as readFileSync8,
   rmSync,
   writeFileSync as writeFileSync5
@@ -82903,7 +83205,7 @@ function listEvalTasks(args) {
   const tasksDir = join6(mechevalRoot, "tasks");
   const suiteFilter = args.suite ? String(args.suite).toUpperCase() : null;
   const tasks2 = [];
-  for (const file of readdirSync2(tasksDir).sort()) {
+  for (const file of readdirSync3(tasksDir).sort()) {
     if (!file.endsWith(".json")) continue;
     try {
       const raw = JSON.parse(readFileSync8(join6(tasksDir, file), "utf8"));
@@ -87291,14 +87593,14 @@ var init_acoustics = __esm({
 // src/tools/import.ts
 import { createHash as createHash6 } from "node:crypto";
 import { readFileSync as readFileSync9, existsSync as existsSync5, statSync as statSync2, mkdirSync as mkdirSync3, writeFileSync as writeFileSync7 } from "node:fs";
-import { basename, join as join7, resolve as resolve5, sep as sep3 } from "node:path";
+import { basename, join as join7, resolve as resolve6, sep as sep3 } from "node:path";
 function exportRoot() {
   return process.env.VCAD_MCP_EXPORT_DIR ?? process.cwd();
 }
 function isWithinExportRoot(path) {
   if (path.includes("\0")) return false;
-  const root = resolve5(exportRoot());
-  const abs = resolve5(path);
+  const root = resolve6(exportRoot());
+  const abs = resolve6(path);
   return abs === root || abs.startsWith(root + sep3);
 }
 function stepNodePath(bytes, diskPath, label) {
@@ -87309,7 +87611,7 @@ function stepNodePath(bytes, diskPath, label) {
     mkdirSync3(dir, { recursive: true });
     const file = join7(dir, `${digest}.step`);
     if (!existsSync5(file)) writeFileSync7(file, bytes);
-    return { path: resolve5(file), portable: true };
+    return { path: resolve6(file), portable: true };
   } catch {
     return { path: `step:${digest}/${label}`, portable: false };
   }
@@ -87385,7 +87687,7 @@ function readStepInput(input) {
   if (stat.size > MAX_STEP_BYTES) {
     throw new Error(`STEP file exceeds ${MAX_STEP_BYTES} byte limit`);
   }
-  return { bytes: readFileSync9(filepath), diskPath: resolve5(filepath) };
+  return { bytes: readFileSync9(filepath), diskPath: resolve6(filepath) };
 }
 function skippedFaceSummary(report, warnings) {
   const skipped = report.reduce((sum, s) => sum + s.skipped_faces.length, 0);
@@ -87558,11 +87860,11 @@ var init_import = __esm({
 
 // src/tools/import-urdf.ts
 import { readFileSync as readFileSync10, existsSync as existsSync6, statSync as statSync3 } from "node:fs";
-import { basename as basename2, dirname as dirname6, isAbsolute as isAbsolute5, resolve as resolve6, sep as sep4 } from "node:path";
+import { basename as basename2, dirname as dirname6, isAbsolute as isAbsolute5, resolve as resolve7, sep as sep4 } from "node:path";
 function resolveMeshPath(filename, urdfDir, packageRoots, confineRoot) {
   const confined = (p) => {
-    const abs = resolve6(p);
-    const root = resolve6(confineRoot);
+    const abs = resolve7(p);
+    const root = resolve7(confineRoot);
     const rootSep = root.endsWith(sep4) ? root : root + sep4;
     if (abs !== root && !abs.startsWith(rootSep)) return null;
     return existsSync6(abs) && statSync3(abs).isFile() ? abs : null;
@@ -87571,14 +87873,14 @@ function resolveMeshPath(filename, urdfDir, packageRoots, confineRoot) {
   const pkgMatch = filename.match(/^package:\/\/([^/]+)\/?(.*)$/);
   if (pkgMatch) {
     for (const root of packageRoots) {
-      const hit = confined(resolve6(root, pkgMatch[1], pkgMatch[2]));
+      const hit = confined(resolve7(root, pkgMatch[1], pkgMatch[2]));
       if (hit) return hit;
     }
     return null;
   }
   const stripped = filename.startsWith("file://") ? filename.slice("file://".length) : filename;
   if (isAbsolute5(stripped)) return confined(stripped);
-  if (urdfDir) return confined(resolve6(urdfDir, stripped));
+  if (urdfDir) return confined(resolve7(urdfDir, stripped));
   return null;
 }
 function inlineMeshImports2(doc, engine, urdfDir, packageRoots, confineRoot) {
@@ -90821,13 +91123,13 @@ ${issues.map((i) => i.problem).join("\n")}`
 }
 async function hasFfmpeg() {
   if (ffmpegAvailable !== null) return ffmpegAvailable;
-  ffmpegAvailable = await new Promise((resolve8) => {
+  ffmpegAvailable = await new Promise((resolve9) => {
     try {
       const p = spawn("ffmpeg", ["-version"], { stdio: "ignore" });
-      p.on("error", () => resolve8(false));
-      p.on("exit", (code) => resolve8(code === 0));
+      p.on("error", () => resolve9(false));
+      p.on("exit", (code) => resolve9(code === 0));
     } catch {
-      resolve8(false);
+      resolve9(false);
     }
   });
   return ffmpegAvailable;
@@ -90866,13 +91168,13 @@ function startMp4Encoder(width, height, fps) {
   const exitError = (code) => new Error(
     `ffmpeg exited ${code}: ${Buffer.concat(errChunks).toString().slice(-400)}`
   );
-  const done = new Promise((resolve8, reject) => {
+  const done = new Promise((resolve9, reject) => {
     p.on("error", (e) => {
       failure2 = e;
       reject(e);
     });
     p.on("close", (code) => {
-      if (code === 0) resolve8(Buffer.concat(out));
+      if (code === 0) resolve9(Buffer.concat(out));
       else {
         failure2 ??= exitError(code);
         reject(failure2);
@@ -90883,15 +91185,15 @@ function startMp4Encoder(width, height, fps) {
   });
   return {
     writeFrame(rgba) {
-      return new Promise((resolve8, reject) => {
+      return new Promise((resolve9, reject) => {
         if (failure2) return reject(failure2);
         if (p.exitCode !== null || p.stdin.destroyed) {
           return reject(failure2 ?? exitError(p.exitCode));
         }
-        if (p.stdin.write(rgba)) return resolve8();
+        if (p.stdin.write(rgba)) return resolve9();
         const onDrain = () => {
           p.removeListener("close", onClose);
-          resolve8();
+          resolve9();
         };
         const onClose = () => {
           p.stdin.removeListener("drain", onDrain);
@@ -92451,8 +92753,8 @@ var init_server3 = __esm({
       resolveLoonAssets(doc, { base_dir }, engine);
     });
     PKG_VERSION = (() => {
-      if ("0.11.0-main.159") {
-        return "0.11.0-main.159";
+      if ("0.11.0-main.163") {
+        return "0.11.0-main.163";
       }
       try {
         const req = createRequire3(import.meta.url);
@@ -92461,8 +92763,8 @@ var init_server3 = __esm({
         return "0.0.0";
       }
     })();
-    BUILD_SHA = "6ca36502681cbcd14c0248e16ea270d62193338f";
-    BUILD_TIME = "2026-11-11T16:44:44.291Z";
+    BUILD_SHA = "816ee12b085c12b403a35ebfedb6c276e175a3af";
+    BUILD_TIME = "2026-11-11T21:40:44.212Z";
     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 = randomUUID5().slice(0, 8);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vcad/mcp",
-  "version": "0.11.0-main.159",
+  "version": "0.11.0-main.163",
   "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://github.com/muni-works/vcad",
   "vcadBuild": {
-    "sha": "6ca36502681cbcd14c0248e16ea270d62193338f",
-    "builtAt": "2026-11-11T16:44:44.291Z"
+    "sha": "816ee12b085c12b403a35ebfedb6c276e175a3af",
+    "builtAt": "2026-11-11T21:40:44.212Z"
   }
 }

package/skill/SKILL.md

@@ -81,6 +81,28 @@ Call `server_info` first.
   Tell the user and suggest restarting their agent (or updating vcad.app).
 - `durable: false` → sessions won't survive a restart; keep the loon source.
 
+## More than one vcad.app
+
+Each running vcad.app registers itself in `~/.vcad/instances/<pid>.json`
+(pid, port, open document, launch time); `~/.vcad/app.json` only points at
+the newest. Every app-bridge result ends with `[vcad.app pid N · document]`
+and carries `_meta["io.vcad/instance"]`: check it names the window you mean.
+A `⚠ vcad.app CHANGED` notice means the app relaunched or another window took
+over — re-check the open document before trusting earlier state.
+
+Pick the window explicitly when more than one runs:
+
+- `VCAD_APP_PID=<pid>` — that instance; fails loudly if it's gone.
+- `VCAD_APP_URL=http://127.0.0.1:<port>/mcp` — that endpoint, verbatim.
+- `VCAD_APP_DOCUMENT=<path>` — the instance with that file open.
+- otherwise the newest, with a warning listing the others. The choice is
+  pinned for the client's lifetime; a later launch never steals it.
+- `VCAD_APP=0` — `@vcad/mcp` doesn't link to any app.
+
+**Never `pkill`/`killall` vcad.app by pattern.** Other sessions may be driving
+other windows, and to them it looks like a crash. Quit only an instance you
+launched, by its pid (`kill <pid>`, from `~/.vcad/instances/`).
+
 ## Ground rules
 
 - vcad has no hosted services. Never send the user to a website to view,