@classcad/mcp 0.1.0

package/dist/engine/wasm-worker.js

@@ -0,0 +1,176 @@
+// wasm-worker.ts — the published ClassCAD WASM engine inside a Node
+// worker_thread. This is what ClassCADWasmWorker.js does in the browser,
+// minus the browser: the engine is synchronous and blocks its thread for the
+// duration of a command, so it lives in its own thread and the daemon's
+// event loop (other sessions, the bridge, /health) stays responsive.
+//
+// Two shims make the web-built engine run in Node:
+//   • location: the engine's license key is bound to "allowed origins"
+//     (configured on classcad.ch/user). The engine compares
+//     globalThis.location.origin with the siteLocation handed to init() and
+//     with the key's origins. The MCP presents itself as one of those
+//     origins (CLASSCAD_WASM_ORIGIN, default http://localhost:3000 - the
+//     origin most dev keys already allow).
+//   • XMLHttpRequest: the glue was built with -sENVIRONMENT=web and loads its
+//     side modules (lgs2d, lgs3d, ExpWasm) through XHR. We answer those from
+//     the local asset directory. A real XHR completes on a later task; the
+//     glue relies on that ordering while linking, hence the deferred onload.
+//
+// Protocol with the parent (see wasm.ts):
+//   → { type:'init', dir, key, origin }         ← { type:'ready', ms, memoryMB } | { type:'error', message }
+//   → { type:'execute', id, command }           ← { type:'result', id, messages, binaryMessages, decodeErrors }
+//                                                 | { type:'error', id, message, fatal? } (fatal: the engine trapped — retire it)
+import { parentPort } from 'node:worker_threads';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { inflateRawSync } from 'node:zlib';
+const port = parentPort;
+let engine = null;
+function installShims(dir, origin) {
+    const u = new URL(origin);
+    const loc = {
+        href: u.href,
+        origin: u.origin,
+        protocol: u.protocol,
+        host: u.host,
+        hostname: u.hostname,
+        port: u.port,
+        pathname: '/',
+        search: '',
+        hash: '',
+    };
+    globalThis.location = loc;
+    globalThis.XMLHttpRequest = class {
+        url = '';
+        async = true;
+        status = 0;
+        responseType = '';
+        response = null;
+        responseText = '';
+        onload = null;
+        onerror = null;
+        open(_method, url, async = true) {
+            this.url = String(url);
+            this.async = async;
+        }
+        setRequestHeader() { }
+        send() {
+            const name = this.url.replace(/^.*\//, '');
+            let buf;
+            try {
+                buf = readFileSync(join(dir, name));
+            }
+            catch (err) {
+                this.status = 404;
+                if (this.onerror)
+                    this.onerror(err);
+                return;
+            }
+            this.status = 200;
+            this.response = this.responseType === 'arraybuffer' ? buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) : buf.toString();
+            this.responseText = this.responseType === 'arraybuffer' ? '' : buf.toString();
+            if (this.async && this.onload)
+                setImmediate(() => this.onload());
+        }
+    };
+    return loc;
+}
+/** What the engine printed while starting: the only reason it gives when it refuses to run (a bad key exits silently). */
+const initLogs = [];
+async function init(msg) {
+    const t0 = Date.now();
+    const loc = installShims(msg.dir, msg.origin);
+    const factory = (await import(pathToFileURL(join(msg.dir, 'ClassCADWasm.js')).href)).default;
+    const logs = initLogs;
+    engine = await factory({
+        wasmBinary: readFileSync(join(msg.dir, 'ClassCADWasm.wasm')),
+        locateFile: (f) => f,
+        print: (s) => logs.push(s),
+        printErr: (s) => logs.push(s),
+    });
+    // Same file layout ClassCADWasmWorker.js prepares (classcadkey mode).
+    const { FS } = engine;
+    FS.mkdir('/home/web_user/ClassCAD/');
+    FS.mkdir('/home/web_user/data');
+    FS.writeFile('.classcad.appkey', msg.key);
+    FS.writeFile('classcad.cfe', new Int8Array(readFileSync(join(msg.dir, 'classcad.cfe'))));
+    FS.writeFile('/home/web_user/ClassCAD/classcad.ini', '[common]\n"datapath"="/home/web_user/data"\n"verbosefilename"="/home/web_user/data/classcad.log"\n"verboselevel"="16583"\n"loglevel"="info"\n"tessellatecurves"="0"\n"cc_productrefcreation"="3"\n\n[classes]\nsystem = "classcad.cfe"\n');
+    FS.writeFile('filterconfig.json', readFileSync(join(msg.dir, 'filterconfig.json'), 'utf8'));
+    engine.init(JSON.stringify({
+        configurationType: 'file',
+        configurationData: '/home/web_user/ClassCAD/classcad.ini',
+        sendTreePatches: true,
+        compression: false,
+        siteLocation: JSON.stringify(loc),
+    }), false);
+    port.postMessage({ type: 'ready', ms: Date.now() - t0, memoryMB: Math.round(engine.HEAPU8.length / 1048576), logs: logs.slice(0, 10) });
+}
+// The engine throws plain objects too (e.g. a refused license key): show their fields, not "[object Object]".
+const errorText = (err) => {
+    if (err instanceof Error)
+        return err.message;
+    if (err && typeof err === 'object') {
+        try {
+            return JSON.stringify(err);
+        }
+        catch {
+            /* circular: fall through */
+        }
+    }
+    return String(err);
+};
+function execute(msg) {
+    const messages = [];
+    const binaryMessages = [];
+    const decodeErrors = [];
+    const command = JSON.stringify(msg.command);
+    // The callbacks run INSIDE engine.execute, between WASM frames. An exception
+    // thrown here would unwind through the engine and leave it in an undefined
+    // state — so they never throw; what cannot be decoded is reported instead.
+    try {
+        engine.execute(command, engine, (_m, text) => {
+            try {
+                messages.push(JSON.parse(text));
+            }
+            catch (err) {
+                decodeErrors.push(`message: ${errorText(err)}`);
+            }
+        }, (mod, ptr, len) => {
+            try {
+                const bytes = mod.HEAPU8.slice(ptr, ptr + len);
+                binaryMessages.push(JSON.parse(inflateRawSync(Buffer.from(bytes)).toString()));
+            }
+            catch (err) {
+                decodeErrors.push(`binary package: ${errorText(err)}`);
+            }
+        });
+    }
+    catch (err) {
+        // A throw out of engine.execute is a trap or an abort (the engine handles
+        // its own errors and reports them in the Result). Its state is undefined
+        // from here on: the parent retires this engine.
+        port.postMessage({ type: 'error', id: msg.id, fatal: true, message: `${String(msg.command.command)}: ${errorText(err)}` });
+        return;
+    }
+    port.postMessage({ type: 'result', id: msg.id, messages, binaryMessages, decodeErrors });
+}
+port.on('message', (msg) => {
+    try {
+        if (msg.type === 'init') {
+            init(msg).catch(err => {
+                const said = initLogs.filter(l => l.trim()).slice(-8).join(' | ');
+                port.postMessage({ type: 'error', message: errorText(err) + (said ? ` — engine output: ${said}` : '') });
+            });
+        }
+        else if (msg.type === 'execute') {
+            if (!engine)
+                throw new Error('engine not initialized');
+            execute(msg);
+        }
+    }
+    catch (err) {
+        port.postMessage({ type: 'error', id: msg.id, message: errorText(err) });
+    }
+});
+//# sourceMappingURL=wasm-worker.js.map

package/dist/engine/wasm-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-worker.js","sourceRoot":"","sources":["../../src/engine/wasm-worker.ts"],"names":[],"mappings":"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"}

package/dist/engine/wasm.d.ts

@@ -0,0 +1,60 @@
+import type { EngineExecuteResult } from '../bridge/protocol.js';
+/** The ClassCAD release the MCP hosts (the same the buerli apps load). */
+export declare const DEFAULT_WASM_VERSION = "21.2.0";
+/**
+ * The MCP's built-in key: wasm, enterprise, allowed origin http://localhost:3000,
+ * valid for six months (issued 2026-09-30). Built in so the local engine needs
+ * no configuration; CLASSCAD_WASM_KEY overrides it. Renew it before
+ * DEV_WASM_KEY_EXPIRES with buerli-backend/functions/scripts/appkey.mjs and
+ * ship a release: the engine refuses an expired key.
+ */
+export declare const DEV_WASM_KEY = "MS4xLlZZUG51VkNpOGdjQm50RXB0VkE1RnQ1ekVVazNOR1dYMk9weHlxRGJjazRSdGYwTFRPTFl5NVdjYmY4VnFOOXlWTDQ0OUNzSExTbmhQRHZpNEVidXRubFJhZUpQVVA3aW1xZFBlWXlIcFRocFVlamVSZmJUaVM3aWcwWnlpdXNjSm5OaHFnTDhmN2EvSVRsZWxFQy9BRXJSQzZ5VUNLUC9UbFBiTTFINk10UlhNbkYwZm5QN2J0bE5DSWdWWW5RTldFSjFNcGYzaEJ4VjBjTHZlcW9tUXY0bklzVFFWSVl5T0hZVHM4ZU8vbENlaTZhdGxFbERycy9WVldoZHIwNm5DdWRvVEhTNGlmSGRWQ2FSak5QSmVNc1BmK1ZMYm5WVFI4aXl2MENadW1MbEsra2N3L0tqc0hLanZTUXJBTG5EQjcvOWpjcFhwbHlHNkFYRVppeVVESFZ0Ly9EL1VKdndMZ2E3S1ZFcFNRTStmS0xSZDR0RFYrVU41VHBrZ0wvYk5uK2huR3FHU2FtUExybXVGdXQ0T0EycHhiSlNZakZvYjFqbUZEbG5hVk1BTW11c1RqblVyQklGWGFxOUJDZnZRck13eHlGeE1RdEtCdGpnQUd5b1VSNmZmaFRXWVhpOGVtL2ZkU3hMNjFRamF4ejdLVExPS3pFOXJVMVgzcXBPQVo1NEFVenFVVzg0Zk9BeUZ0KzRMT2M0dzJMMWJ1U0YxUkZFby9CZXZ4UGRzQ3A4ZWUxMUxiTDRCQ0pFUEZJMGQyYU9JU0grN0NqOFZhVEpHb2JKVys3cktPemUyTTE4V3hOZnJMWVlhZXJzdDEwdDl1YTFja3lPdUZzRjMwdWFiejUvdGRVeENRRjhhcysxNFR2Slo4THowd1lxRkx2RTgrcG12N2VpT1ZUTzRtVSsvWXpLYkljVXFoNjNRdllkOU5jeWx3c0ZqRkZ4NGJlbGxrcHFuQjFNNHcvZVVmQ2VpNzRXT256ZGtNQzJiYWx2US9VWWJvS3ltbjZHVWtzbjZJczd0ZU5RMGs2TGovTm5mcFllcldNUXQxeEhjWnVySlZxd2hDRjBTTVRhSmhHWFNQODkwd3RFdkNRSS8zSHNYdUpseWFkWkpmZDZHRmJhNTRldEdoNUIveE80aWdNMEVuekVUMWVKa0tWMWhtbTduZjlZZzRwZmw4QnI5Z0ZZdFlPV080S2hWTjczYTB5Y0g5SlpMUUJydmlBVFowQm1uL3RNYnlKWitadmZjYzN1S2lvdXl4VC9ONlJwejlycFdrUmJvSHZSaHF4VkdjY3B4bG1nbnZudkNVaHZSZktFNTYvaDh0eEZXcXFncEo4VFR4cndFQVo3R0liRlVYVWN6TUhoQW9FV2lSWnVMTWxQck0zTVJWQkJ4YXA5a1BUeWVGaUFXU0tzZ2krUHRQbVp4ZTJldlRkekYzTEpvSkc4R25mQjZ5MVE4VWE5Q09wU3pMN05aamFpak9NRmU0dXBFaVI0andrOTUxMDVkcW9TTFExY0JoU2J0MytiNjkxcE1YYmNFZGNjU1ZYSnE5ejdubUJCeGs1THdUaURRdjdDTkQyZGNmejdKa0hXSENFcklvN2ZyMVFKU1V2dG5RRk5YUGxPNWhsTnZGVU9qWngwQkNDMGc2UDFrQUxVUEoweWtaZ3pQSnRYckdHL09XQjFUaERtTVNvMVpmdE1vbTlCdENjVGhMeGJuWDJmODlEcTNHZFE4RUd2UVV0cFRCNkVkeTdBOEE1aVNMemR1OEJhek5nYUwrclFlNk9CTko4VVEweEMzdmUrTFFoTmtVMTVzQWlycmtVdDJmL3JkMDM2bHd5d3ZnZTg2Umlvc1pnOVQ2RHVhNWRoQ1N3L0ZTQmpCOUo0QmI2Kys2TmNEOS9OTGFXNUIwUXJzdDRXYjR0cDEzL3Q3RXlxWEZiV3JLMVdiQlZtMnVhd3pzLzZ4RklR";
+export declare const DEV_WASM_KEY_EXPIRES = "2027-03-30T09:25:07Z";
+export declare const DEFAULT_WASM_ORIGIN = "http://localhost:3000";
+/** Files of one release under https://awvstatic.com/classcad/download/release/<version>/wasm/. */
+export declare const WASM_ASSETS: string[];
+export type LocalWasmOptions = {
+    /** ClassCAD key (classcad.ch/user). Required — without it there is no local engine. */
+    key: string;
+    /** Origin the engine believes it runs on; must be in the key's allowed origins. */
+    origin?: string;
+    /** Release to host. */
+    version?: string;
+    /** Asset directory override. */
+    dir?: string;
+    /** Download base override (default awvstatic release/<version>/wasm). */
+    url?: string;
+    log?: (msg: string) => void;
+};
+export type LocalEngine = {
+    execute: (command: Record<string, unknown>) => Promise<EngineExecuteResult>;
+    /**
+     * Health check: one GetTree must come back as a Result with a tree within
+     * `timeoutMs`. False = the engine is gone or wedged — retire it (close) and
+     * start a new one.
+     */
+    ping: (timeoutMs?: number) => Promise<boolean>;
+    /** `reason` is kept as deathReason. */
+    close: (reason?: string) => void;
+    /** Closed, crashed, trapped or retired: execute() only rejects from here on. */
+    readonly closed: boolean;
+    /** Why the engine is closed (null while it runs). */
+    readonly deathReason: string | null;
+    readonly version: string;
+    readonly origin: string;
+    readonly dir: string;
+    readonly memoryMB: number;
+};
+/** Resolves the local engine settings from the environment (the built-in key unless CLASSCAD_WASM_KEY is set). */
+export declare function wasmOptionsFromEnv(env?: NodeJS.ProcessEnv): LocalWasmOptions | null;
+export declare function defaultWasmDir(version?: string): string;
+export declare function assetBaseUrl(version?: string): string;
+/** Downloads the release assets that are missing from `dir` (atomic per file). */
+export declare function ensureWasmAssets(opts?: {
+    version?: string;
+    dir?: string;
+    url?: string;
+    log?: (m: string) => void;
+}): Promise<string>;
+/** Downloads (if needed) and boots one engine in its own worker thread. */
+export declare function startLocalEngine(opts: LocalWasmOptions): Promise<LocalEngine>;

package/dist/engine/wasm.js

@@ -0,0 +1,212 @@
+// wasm.ts — the MCP's own ClassCAD engine: the published WASM build, hosted
+// in a worker thread (wasm-worker.ts). No server, no browser tab: the MCP
+// can model on its own wherever Node runs.
+//
+// What it needs:
+//   • the assets of one ClassCAD release (~60 MB: glue, main module, three
+//     side modules, class file, filter config), downloaded once from
+//     awvstatic.com into CLASSCAD_WASM_DIR (default ~/.classcad-mcp/wasm/<version>),
+//   • a ClassCAD key whose allowed origins include the origin the engine is
+//     told it runs on (CLASSCAD_WASM_ORIGIN, default http://localhost:3000).
+//     A six-month key is built in (DEV_WASM_KEY); CLASSCAD_WASM_KEY
+//     overrides it. Keys and origins are managed on classcad.ch/user.
+//
+// One engine = one drawing = one MCP session. execute() has the same shape
+// as the app bridge's engine.execute (messages + inflated binary packages),
+// so the client treats both the same way.
+import { Worker } from 'node:worker_threads';
+import { createWriteStream, existsSync, mkdirSync, renameSync, statSync, unlinkSync } from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** The ClassCAD release the MCP hosts (the same the buerli apps load). */
+export const DEFAULT_WASM_VERSION = '21.2.0';
+/**
+ * The MCP's built-in key: wasm, enterprise, allowed origin http://localhost:3000,
+ * valid for six months (issued 2026-09-30). Built in so the local engine needs
+ * no configuration; CLASSCAD_WASM_KEY overrides it. Renew it before
+ * DEV_WASM_KEY_EXPIRES with buerli-backend/functions/scripts/appkey.mjs and
+ * ship a release: the engine refuses an expired key.
+ */
+export const DEV_WASM_KEY = 'MS4xLlZZUG51VkNpOGdjQm50RXB0VkE1RnQ1ekVVazNOR1dYMk9weHlxRGJjazRSdGYwTFRPTFl5NVdjYmY4VnFOOXlWTDQ0OUNzSExTbmhQRHZpNEVidXRubFJhZUpQVVA3aW1xZFBlWXlIcFRocFVlamVSZmJUaVM3aWcwWnlpdXNjSm5OaHFnTDhmN2EvSVRsZWxFQy9BRXJSQzZ5VUNLUC9UbFBiTTFINk10UlhNbkYwZm5QN2J0bE5DSWdWWW5RTldFSjFNcGYzaEJ4VjBjTHZlcW9tUXY0bklzVFFWSVl5T0hZVHM4ZU8vbENlaTZhdGxFbERycy9WVldoZHIwNm5DdWRvVEhTNGlmSGRWQ2FSak5QSmVNc1BmK1ZMYm5WVFI4aXl2MENadW1MbEsra2N3L0tqc0hLanZTUXJBTG5EQjcvOWpjcFhwbHlHNkFYRVppeVVESFZ0Ly9EL1VKdndMZ2E3S1ZFcFNRTStmS0xSZDR0RFYrVU41VHBrZ0wvYk5uK2huR3FHU2FtUExybXVGdXQ0T0EycHhiSlNZakZvYjFqbUZEbG5hVk1BTW11c1RqblVyQklGWGFxOUJDZnZRck13eHlGeE1RdEtCdGpnQUd5b1VSNmZmaFRXWVhpOGVtL2ZkU3hMNjFRamF4ejdLVExPS3pFOXJVMVgzcXBPQVo1NEFVenFVVzg0Zk9BeUZ0KzRMT2M0dzJMMWJ1U0YxUkZFby9CZXZ4UGRzQ3A4ZWUxMUxiTDRCQ0pFUEZJMGQyYU9JU0grN0NqOFZhVEpHb2JKVys3cktPemUyTTE4V3hOZnJMWVlhZXJzdDEwdDl1YTFja3lPdUZzRjMwdWFiejUvdGRVeENRRjhhcysxNFR2Slo4THowd1lxRkx2RTgrcG12N2VpT1ZUTzRtVSsvWXpLYkljVXFoNjNRdllkOU5jeWx3c0ZqRkZ4NGJlbGxrcHFuQjFNNHcvZVVmQ2VpNzRXT256ZGtNQzJiYWx2US9VWWJvS3ltbjZHVWtzbjZJczd0ZU5RMGs2TGovTm5mcFllcldNUXQxeEhjWnVySlZxd2hDRjBTTVRhSmhHWFNQODkwd3RFdkNRSS8zSHNYdUpseWFkWkpmZDZHRmJhNTRldEdoNUIveE80aWdNMEVuekVUMWVKa0tWMWhtbTduZjlZZzRwZmw4QnI5Z0ZZdFlPV080S2hWTjczYTB5Y0g5SlpMUUJydmlBVFowQm1uL3RNYnlKWitadmZjYzN1S2lvdXl4VC9ONlJwejlycFdrUmJvSHZSaHF4VkdjY3B4bG1nbnZudkNVaHZSZktFNTYvaDh0eEZXcXFncEo4VFR4cndFQVo3R0liRlVYVWN6TUhoQW9FV2lSWnVMTWxQck0zTVJWQkJ4YXA5a1BUeWVGaUFXU0tzZ2krUHRQbVp4ZTJldlRkekYzTEpvSkc4R25mQjZ5MVE4VWE5Q09wU3pMN05aamFpak9NRmU0dXBFaVI0andrOTUxMDVkcW9TTFExY0JoU2J0MytiNjkxcE1YYmNFZGNjU1ZYSnE5ejdubUJCeGs1THdUaURRdjdDTkQyZGNmejdKa0hXSENFcklvN2ZyMVFKU1V2dG5RRk5YUGxPNWhsTnZGVU9qWngwQkNDMGc2UDFrQUxVUEoweWtaZ3pQSnRYckdHL09XQjFUaERtTVNvMVpmdE1vbTlCdENjVGhMeGJuWDJmODlEcTNHZFE4RUd2UVV0cFRCNkVkeTdBOEE1aVNMemR1OEJhek5nYUwrclFlNk9CTko4VVEweEMzdmUrTFFoTmtVMTVzQWlycmtVdDJmL3JkMDM2bHd5d3ZnZTg2Umlvc1pnOVQ2RHVhNWRoQ1N3L0ZTQmpCOUo0QmI2Kys2TmNEOS9OTGFXNUIwUXJzdDRXYjR0cDEzL3Q3RXlxWEZiV3JLMVdiQlZtMnVhd3pzLzZ4RklR';
+export const DEV_WASM_KEY_EXPIRES = '2027-03-30T09:25:07Z';
+export const DEFAULT_WASM_ORIGIN = 'http://localhost:3000';
+/** Files of one release under https://awvstatic.com/classcad/download/release/<version>/wasm/. */
+export const WASM_ASSETS = ['ClassCADWasm.js', 'ClassCADWasm.wasm', 'lgs2d.wasm', 'lgs3d.wasm', 'ExpWasm.wasm', 'classcad.cfe', 'filterconfig.json'];
+/** Resolves the local engine settings from the environment (the built-in key unless CLASSCAD_WASM_KEY is set). */
+export function wasmOptionsFromEnv(env = process.env) {
+    const key = env.CLASSCAD_WASM_KEY || DEV_WASM_KEY;
+    if (!key)
+        return null;
+    return {
+        key,
+        origin: env.CLASSCAD_WASM_ORIGIN,
+        version: env.CLASSCAD_WASM_VERSION,
+        dir: env.CLASSCAD_WASM_DIR,
+        url: env.CLASSCAD_WASM_URL,
+    };
+}
+export function defaultWasmDir(version = DEFAULT_WASM_VERSION) {
+    return join(homedir(), '.classcad-mcp', 'wasm', version);
+}
+export function assetBaseUrl(version = DEFAULT_WASM_VERSION) {
+    return `https://awvstatic.com/classcad/download/release/${version}/wasm`;
+}
+/** Downloads the release assets that are missing from `dir` (atomic per file). */
+export async function ensureWasmAssets(opts = {}) {
+    const version = opts.version ?? DEFAULT_WASM_VERSION;
+    const dir = opts.dir ?? defaultWasmDir(version);
+    const base = (opts.url ?? assetBaseUrl(version)).replace(/\/+$/, '');
+    const log = opts.log ?? (() => { });
+    mkdirSync(dir, { recursive: true });
+    const missing = WASM_ASSETS.filter(f => !existsSync(join(dir, f)) || statSync(join(dir, f)).size === 0);
+    if (missing.length === 0)
+        return dir;
+    log(`downloading ClassCAD ${version} WASM assets (${missing.length} file(s)) from ${base} to ${dir}`);
+    for (const name of missing) {
+        const t0 = Date.now();
+        const res = await fetch(`${base}/${name}`);
+        if (!res.ok || !res.body)
+            throw new Error(`download failed: ${base}/${name} → HTTP ${res.status}`);
+        const part = join(dir, `${name}.part`);
+        try {
+            await pipeline(Readable.fromWeb(res.body), createWriteStream(part));
+            renameSync(part, join(dir, name));
+        }
+        catch (err) {
+            try {
+                unlinkSync(part);
+            }
+            catch { }
+            throw err;
+        }
+        log(`  ${name}: ${Math.round(statSync(join(dir, name)).size / 1048576)} MB in ${Date.now() - t0} ms`);
+    }
+    return dir;
+}
+/** Downloads (if needed) and boots one engine in its own worker thread. */
+export async function startLocalEngine(opts) {
+    if (!opts.key)
+        throw new Error('no ClassCAD key for the local WASM engine (CLASSCAD_WASM_KEY)');
+    const version = opts.version ?? DEFAULT_WASM_VERSION;
+    const origin = opts.origin ?? DEFAULT_WASM_ORIGIN;
+    const log = opts.log ?? (() => { });
+    const dir = await ensureWasmAssets({ version, dir: opts.dir, url: opts.url, log });
+    const workerPath = join(dirname(fileURLToPath(import.meta.url)), 'wasm-worker.js');
+    const worker = new Worker(workerPath);
+    let memoryMB = 0;
+    let closed = false;
+    let deathReason = null;
+    let nextId = 1;
+    const pending = new Map();
+    const failAll = (why) => {
+        for (const [, p] of pending)
+            p.reject(new Error(why));
+        pending.clear();
+    };
+    const retire = (why) => {
+        if (!closed)
+            deathReason = why;
+        closed = true;
+        failAll(why);
+        worker.terminate().catch(() => { });
+    };
+    worker.on('error', err => retire(`WASM engine crashed: ${err.message}`));
+    worker.on('exit', code => retire(`WASM engine exited (code ${code})`));
+    const t0 = Date.now();
+    await new Promise((resolve, reject) => {
+        const onMessage = (m) => {
+            if (m?.type === 'ready') {
+                memoryMB = m.memoryMB;
+                worker.off('message', onMessage);
+                log(`WASM engine ${version} ready in ${m.ms} ms (origin ${origin}, ${m.memoryMB} MB heap)`);
+                resolve();
+            }
+            else if (m?.type === 'error') {
+                worker.off('message', onMessage);
+                // The engine refuses a bad key by exiting without a word: name the likely cause.
+                const expired = opts.key === DEV_WASM_KEY && Date.now() > Date.parse(DEV_WASM_KEY_EXPIRES);
+                const hint = expired
+                    ? ` The MCP's built-in engine key expired on ${DEV_WASM_KEY_EXPIRES.slice(0, 10)}: update the MCP (or set CLASSCAD_WASM_KEY).`
+                    : opts.key !== DEV_WASM_KEY
+                        ? ' Check CLASSCAD_WASM_KEY: the engine refuses an expired key or one whose allowed origins do not include ' + origin + '.'
+                        : '';
+                reject(new Error(`WASM engine failed to start: ${m.message}.${hint}`));
+            }
+        };
+        worker.on('message', onMessage);
+        worker.once('error', err => reject(new Error(`WASM engine failed to start: ${err.message}`)));
+        worker.postMessage({ type: 'init', dir, key: opts.key, origin });
+    }).catch(err => {
+        worker.terminate().catch(() => { });
+        throw err;
+    });
+    void t0;
+    worker.on('message', (m) => {
+        if (m?.type === 'result' || (m?.type === 'error' && typeof m.id === 'number')) {
+            const p = pending.get(m.id);
+            if (!p)
+                return;
+            pending.delete(m.id);
+            if (m.type === 'result') {
+                p.resolve({ messages: m.messages ?? [], binaryMessages: m.binaryMessages ?? [], decodeErrors: m.decodeErrors ?? [] });
+            }
+            else if (m.fatal) {
+                // The engine trapped mid-command: nothing it answers from now on can be trusted.
+                const why = `WASM engine aborted (${m.message})`;
+                log(`${why} — retired; the next command starts a new engine with an empty drawing`);
+                p.reject(new Error(`${why}. The local engine was retired and the drawing is lost; the next command starts a new engine with an empty drawing.`));
+                retire(why);
+            }
+            else
+                p.reject(new Error(m.message));
+        }
+    });
+    const execute = (command) => new Promise((resolve, reject) => {
+        if (closed)
+            return reject(new Error(`WASM engine is closed${deathReason ? ` (${deathReason})` : ''}`));
+        const id = nextId++;
+        pending.set(id, { resolve, reject });
+        worker.postMessage({ type: 'execute', id, command });
+    });
+    return {
+        execute,
+        ping: async (timeoutMs = 10_000) => {
+            if (closed)
+                return false;
+            let timer;
+            const timeout = new Promise(r => (timer = setTimeout(() => r(null), timeoutMs)));
+            try {
+                const res = await Promise.race([execute({ command: 'GetTree', commandVersion: 'v1', transactionID: `ping-${nextId}` }), timeout]);
+                const tree = res?.messages.find(m => m?.command === 'Result');
+                return !!tree && ((tree.result && typeof tree.result === 'object' && 'tree' in tree.result) || !!tree.structure);
+            }
+            catch {
+                return false;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+        close: (reason = 'WASM engine closed') => {
+            if (closed)
+                return;
+            retire(reason);
+        },
+        get closed() {
+            return closed;
+        },
+        get deathReason() {
+            return deathReason;
+        },
+        version,
+        origin,
+        dir,
+        get memoryMB() {
+            return memoryMB;
+        },
+    };
+}
+//# sourceMappingURL=wasm.js.map

package/dist/engine/wasm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm.js","sourceRoot":"","sources":["../../src/engine/wasm.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,23 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Client, type EnginePolicy } from './client.js';
+import { type LocalWasmOptions } from './engine/wasm.js';
+import type { BridgeRegistry } from './bridge/server.js';
+export declare const VERSION = "0.1.0";
+export declare const DEFAULT_WS_URL = "ws://0.0.0.0:9094/";
+export type McpServerOptions = {
+    /** ClassCAD worker this instance connects to (lazily, on the first tool call). */
+    wsUrl: string;
+    /** The shared bridge registry (apps announcing share tokens); null when no listener runs. */
+    bridge: () => BridgeRegistry | null;
+    /** Engine policy when nothing else decides: 'auto' (worker, else local WASM), 'drogon', 'wasm'. Default 'auto'. */
+    engine?: EnginePolicy;
+    /** Local WASM engine settings (key, origin, …); null = not available. */
+    wasm?: LocalWasmOptions | null;
+    /** Where the instance reports engine decisions. */
+    log?: (msg: string) => void;
+};
+/** Builds a connected-ready MCP server: the engine client plus all tools. Nothing is opened yet. */
+export declare function createMcpServer(opts: McpServerOptions): Promise<{
+    server: McpServer;
+    client: Client;
+}>;

package/dist/mcp-server.js

@@ -0,0 +1,141 @@
+// mcp-server.ts — one ClassCAD MCP server instance: an engine client plus
+// every tool, wired the same way whether the instance serves a stdio host
+// directly or one HTTP session of the daemon. The daemon creates one of these
+// per MCP session, so every Claude tab has its own engine connection,
+// emission config and tool queue.
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { connect } from './client.js';
+import { DEFAULT_WASM_ORIGIN, DEFAULT_WASM_VERSION, defaultWasmDir } from './engine/wasm.js';
+import { registerLifecycleTools } from './tools/lifecycle.js';
+import { registerStateTools } from './tools/state.js';
+import { DAEMON_NOTE, registerDocsTools, serverInstructions } from './tools/docs.js';
+import { registerSnapshotTool } from './tools/snapshot.js';
+import { registerScriptTool } from './tools/script.js';
+import { registerBridgeTools } from './tools/bridge.js';
+import { serializeTools } from './queue.js';
+import { registerAuthTool, requireSignIn, SIGN_IN_NOTE } from './tools/auth.js';
+import { authStatus } from './auth.js';
+export const VERSION = '0.1.0';
+export const DEFAULT_WS_URL = 'ws://0.0.0.0:9094/';
+/** Builds a connected-ready MCP server: the engine client plus all tools. Nothing is opened yet. */
+export async function createMcpServer(opts) {
+    const bridgeRegistry = opts.bridge();
+    // Build the client without opening the WS. The first tool call that needs
+    // the worker will open it — either use_session (with a named session) or
+    // any geometry tool (with no session header). This keeps the MCP passive
+    // at startup so it never creates a stray ephemeral session.
+    const client = await connect(opts.wsUrl, { graphics: true, bridge: opts.bridge, engine: opts.engine, wasm: opts.wasm, log: opts.log });
+    const server = new McpServer({
+        name: 'classcad',
+        version: VERSION,
+    }, 
+    // The initialize-handshake instructions carry the full v1 method index —
+    // hosts surface them to the agent, so it knows every method from turn one.
+    { instructions: `${SIGN_IN_NOTE}\n\n${serverInstructions()}` });
+    // One tool call at a time: every tool below shares this client's single
+    // engine connection and drawing (see queue.ts for the reasoning, incl.
+    // subagents). Must run before the first registerTool.
+    serializeTools(server);
+    // Every tool but the sign-in, status and docs needs a signed-in machine.
+    // Registered after the queue patch, so the check runs before queueing.
+    requireSignIn(server);
+    registerAuthTool(server);
+    server.registerTool('session_info', {
+        title: 'Session info',
+        description: 'Return ClassCAD MCP session status: sign-in (auth), transport (ws = ClassCAD worker, bridge = an app\'s in-page engine, wasm = the MCP\'s own local engine), engine policy, whether a local WASM engine is available, WS URL, current session id, share token, connection state, package version. ' + DAEMON_NOTE,
+        inputSchema: {},
+    }, async () => {
+        const local = client.localEngine;
+        const auth = await authStatus();
+        const info = {
+            auth: auth.signedIn ? { signedIn: true, email: auth.account.email, ...(auth.offline ? { offline: true } : {}) } : { signedIn: false, reason: auth.reason },
+            transport: client.transport,
+            enginePolicy: client.engine,
+            wsUrl: client.transport === 'ws' ? client.url : null,
+            sessionId: client.sessionId,
+            shareToken: client.shareToken,
+            connected: client.connected,
+            wasm: {
+                available: client.wasmAvailable,
+                running: local !== null,
+                version: local?.version ?? opts.wasm?.version ?? DEFAULT_WASM_VERSION,
+                origin: local?.origin ?? opts.wasm?.origin ?? DEFAULT_WASM_ORIGIN,
+                dir: local?.dir ?? opts.wasm?.dir ?? defaultWasmDir(opts.wasm?.version ?? DEFAULT_WASM_VERSION),
+                memoryMB: local?.memoryMB ?? null,
+            },
+            version: VERSION,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(info) }] };
+    });
+    server.registerTool('use_session', {
+        title: 'Switch session',
+        description: 'Call this BEFORE any other classcad tool when the user names a session or hands you a session/token URL — the MCP opens its engine link lazily, so the first tool call decides which session is used. Modes: (1) sessionId — attaches to a named ClassCAD session (ClassCAD-Session-Id header) on the configured worker; empty/omitted = fresh worker-assigned session. (2) url — a ws(s):// URL from a multi-client server, typically carrying an invite token (wss://host/?invite=…); connected VERBATIM. (3) an http(s):// APP SHARE LINK from a buerli app\'s Session Management: with ?invite=… the token is applied to the configured worker URL (the app runs against a ClassCAD server); with ?bridge=… the app runs the engine IN-PAGE (WASM) and the MCP attaches to it through the bridge listener — every command then runs inside that app, and the app must stay open. Without either, the MCP runs its own session. (4) engine — WHICH ENGINE runs that own session: "drogon" = the configured ClassCAD worker (server), "wasm" = the MCP\'s OWN local engine (the published WASM build hosted in this process, no server and no browser needed; requires a configured key), "auto" (default) = the worker if reachable, otherwise the local engine. Use "drogon" when the user says to connect to their (Drogon/ClassCAD) server, "wasm" when they say WASM/local/offline; a token or URL always decides by itself. Reconnecting clears cached structure/graphic state — the next tool call repopulates it.',
+        inputSchema: {
+            sessionId: z.string().optional()
+                .describe('Target session id (named-session model, worker only). Empty string or omitted = no header (worker-assigned session).'),
+            url: z.string().optional()
+                .describe('ws(s):// URL to connect to VERBATIM — e.g. a multi-client token/invite URL (wss://host/?invite=…). An http(s):// app share link with ?invite= is accepted too: the invite token is extracted and applied to the configured worker URL. Takes precedence over sessionId.'),
+            engine: z.enum(['auto', 'drogon', 'wasm']).optional()
+                .describe('Engine for the MCP\'s own session when no url is given: auto (worker, else local WASM), drogon (the ClassCAD worker only), wasm (the local engine only). Sticks for the session until changed.'),
+        },
+    }, async ({ sessionId, url, engine }) => {
+        const target = sessionId && sessionId.length > 0 ? sessionId : null;
+        try {
+            let wsUrl = url && url.length > 0 ? url : null;
+            // App share links (http/https) point at the WEB APP, not the CAD
+            // server — carry over only the invite token onto the worker base URL.
+            if (wsUrl && /^https?:\/\//i.test(wsUrl)) {
+                const params = new URL(wsUrl).searchParams;
+                const bridge = params.get('bridge');
+                if (bridge) {
+                    // In-app engine: attach through the bridge, no worker involved.
+                    await client.reconnectBridge(bridge);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ ok: true, transport: 'bridge', shareToken: bridge }) }],
+                    };
+                }
+                const invite = params.get('invite');
+                if (!invite) {
+                    throw new Error(`"${wsUrl}" is an http(s) app link without an ?invite= or ?bridge= token. ` +
+                        'Pass the ws(s):// URL of the ClassCAD server (optionally with ?invite=…), or an app share link that carries ?invite= / ?bridge=.');
+                }
+                const base = client.baseUrl.replace(/\/+$/, '');
+                wsUrl = `${base}/?invite=${encodeURIComponent(invite)}`;
+            }
+            if (wsUrl)
+                await client.reconnectUrl(wsUrl);
+            else
+                await client.reconnect(target, engine);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: JSON.stringify({ ok: false, error: msg }) }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        ok: true,
+                        transport: client.transport,
+                        engine: client.transport === 'wasm' ? 'wasm (local, in this process)' : 'drogon (ClassCAD worker)',
+                        sessionId: client.sessionId,
+                        wsUrl: client.transport === 'ws' ? client.url : null,
+                    }),
+                }],
+        };
+    });
+    registerLifecycleTools(server, client);
+    registerStateTools(server, client);
+    registerDocsTools(server);
+    registerSnapshotTool(server, client);
+    registerScriptTool(server, client);
+    // Bridge tools (app-state read/write) — only when the listener is up.
+    if (bridgeRegistry)
+        registerBridgeTools(server, client, bridgeRegistry);
+    return { server, client };
+}
+//# sourceMappingURL=mcp-server.js.map