@vcad/mcp 0.11.0-main.162 → 0.11.0-main.164

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 7d787f258ea026c36d80b9cb137c3f0064fcce3c at 2026-11-11T19:59:54.944Z. Source: https://github.com/muni-works/vcad
+Built from f36361fa47f1a47d196b4d9a8bcdb421c1cc785f at 2026-11-11T21:56:09.744Z. Source: https://github.com/muni-works/vcad

package/index.mjs

@@ -11312,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()
@@ -12193,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) {
@@ -12221,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);
         }));
       }
@@ -12840,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);
@@ -13067,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;
@@ -13077,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));
             }
@@ -17365,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;
@@ -17375,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;
     }
@@ -17386,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;
     }
@@ -17450,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;
     }
@@ -22204,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);
           }
         });
       }
@@ -23246,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) {
@@ -23263,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);
           };
@@ -23341,7 +23341,7 @@ var init_protocol = __esm({
               if (!parseResult.success) {
                 reject(parseResult.error);
               } else {
-                resolve8(parseResult.data);
+                resolve9(parseResult.data);
               }
             } catch (error2) {
               reject(error2);
@@ -23602,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"));
@@ -26634,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;
@@ -26661,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;
@@ -27236,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;
@@ -27463,7 +27463,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize2,
-      resolve: resolve8,
+      resolve: resolve9,
       resolveComponent,
       equal,
       serialize,
@@ -33635,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) {
@@ -33836,7 +33836,7 @@ var require_react_development = __commonJS({
             ));
           });
           return {
-            then: function(resolve8, reject) {
+            then: function(resolve9, reject) {
               didAwaitActCall = true;
               thenable.then(
                 function(returnValue) {
@@ -33846,7 +33846,7 @@ var require_react_development = __commonJS({
                       flushActQueue(queue), enqueueTask(function() {
                         return recursivelyFlushAsyncActWork(
                           returnValue,
-                          resolve8,
+                          resolve9,
                           reject
                         );
                       });
@@ -33860,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);
@@ -33882,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);
           }
         };
       };
@@ -44853,6 +44853,19 @@ var init_CHANGELOG = __esm({
             "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",
@@ -44919,6 +44932,34 @@ var init_CHANGELOG = __esm({
             "ask_user"
           ]
         },
+        {
+          id: "2026-11-11-live-qa-round-2",
+          version: "0.11.0",
+          date: "2026-11-11",
+          category: "fix",
+          title: "Mac app: Find works on a new file; print orient fits bed",
+          summary: "Find offers Sketch/Extrude/Fillet before the first edit and closes on click-outside, Esc, or a mode switch; Orient never defaults to a pose that overflows the printer.",
+          features: [
+            "mac-app",
+            "command-palette",
+            "3d-print"
+          ]
+        },
+        {
+          id: "2026-11-11-huge-assembly-open",
+          version: "0.11.0",
+          date: "2026-11-11",
+          category: "perf",
+          title: "Huge STEP assemblies open in seconds",
+          summary: "Identical imported parts tessellate once and are instanced, parts stream in as they finish, and big assemblies draw a quick preview first, then refine. Voron 2.4: first part 425 s \u2192 1.4 s.",
+          features: [
+            "step",
+            "import",
+            "assembly",
+            "native-app",
+            "performance"
+          ]
+        },
         {
           id: "2026-11-11-history-edits-keep-references",
           version: "undefined",
@@ -44932,6 +44973,19 @@ var init_CHANGELOG = __esm({
             "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",
@@ -57378,10 +57432,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);
 }
@@ -57393,13 +57523,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);
@@ -57613,14 +57757,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;
@@ -57690,7 +57837,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() {
@@ -57716,8 +57863,16 @@ function runInSessionScope(user, fn) {
   return out;
 }
 async function hydrateSession(store, documentId) {
-  if (documents.has(documentId)) return true;
+  const proxied = process.env.VCAD_MCP_PROXIED === "1";
+  if (documents.has(documentId) && !proxied) return true;
   const doc = await store.load(documentId);
+  if (doc && proxied && documents.has(documentId)) {
+    if (JSON.stringify(documents.get(documentId)) !== JSON.stringify(doc)) {
+      documents.set(documentId, doc);
+      runDocumentEnterHooks(doc);
+    }
+    return true;
+  }
   if (doc) {
     documents.set(documentId, doc);
     runDocumentEnterHooks(doc);
@@ -57762,7 +57917,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);
@@ -57975,7 +58130,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");
@@ -61780,8 +61935,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,
@@ -62118,8 +62273,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");
   });
 }
@@ -62144,11 +62299,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}`);
@@ -62160,10 +62315,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");
   }
@@ -62841,7 +62996,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;
@@ -62861,15 +63016,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;
   }
@@ -67532,7 +67687,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;
@@ -67560,7 +67715,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`
@@ -67584,9 +67739,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 = {};
@@ -69141,12 +69296,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 {
@@ -83028,7 +83183,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
@@ -83086,7 +83241,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"));
@@ -87474,14 +87629,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) {
@@ -87492,7 +87647,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 };
   }
@@ -87568,7 +87723,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);
@@ -87741,11 +87896,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;
@@ -87754,14 +87909,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) {
@@ -91004,13 +91159,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;
@@ -91049,13 +91204,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);
@@ -91066,15 +91221,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);
@@ -92634,8 +92789,8 @@ var init_server3 = __esm({
       resolveLoonAssets(doc, { base_dir }, engine);
     });
     PKG_VERSION = (() => {
-      if ("0.11.0-main.162") {
-        return "0.11.0-main.162";
+      if ("0.11.0-main.164") {
+        return "0.11.0-main.164";
       }
       try {
         const req = createRequire3(import.meta.url);
@@ -92644,8 +92799,8 @@ var init_server3 = __esm({
         return "0.0.0";
       }
     })();
-    BUILD_SHA = "7d787f258ea026c36d80b9cb137c3f0064fcce3c";
-    BUILD_TIME = "2026-11-11T19:59:54.944Z";
+    BUILD_SHA = "f36361fa47f1a47d196b4d9a8bcdb421c1cc785f";
+    BUILD_TIME = "2026-11-11T21:56:09.744Z";
     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.162",
+  "version": "0.11.0-main.164",
   "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": "7d787f258ea026c36d80b9cb137c3f0064fcce3c",
-    "builtAt": "2026-11-11T19:59:54.944Z"
+    "sha": "f36361fa47f1a47d196b4d9a8bcdb421c1cc785f",
+    "builtAt": "2026-11-11T21:56:09.744Z"
   }
 }

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,