@classcad/mcp 0.1.0

package/dist/mcp-server.js.map

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

package/dist/ports.d.ts

@@ -0,0 +1,2 @@
+/** Daemon HTTP port. Not 9095: a ClassCAD worker listens on 9094 (ws) AND 9095 (wss). */
+export declare const DEFAULT_DAEMON_PORT = 9097;

package/dist/ports.js

@@ -0,0 +1,5 @@
+// Default ports, in a leaf module so tool docs can name them without importing
+// the daemon (which imports the MCP server, which imports the tool docs).
+/** Daemon HTTP port. Not 9095: a ClassCAD worker listens on 9094 (ws) AND 9095 (wss). */
+export const DEFAULT_DAEMON_PORT = 9097;
+//# sourceMappingURL=ports.js.map

package/dist/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0EAA0E;AAE1E,yFAAyF;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAA"}

package/dist/queue.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function setDrawingBusy(server: McpServer, check: () => boolean): void;
+export declare const UNQUEUED_TOOLS: Set<string>;
+/**
+ * Patches `server.registerTool` so every handler registered afterwards runs
+ * through the shared queue (except the tools in `exclude`). Call it once,
+ * before the first registerTool call.
+ */
+export declare function serializeTools(server: McpServer, exclude?: Set<string>): void;

package/dist/queue.js

@@ -0,0 +1,50 @@
+// queue.ts — one tool call at a time.
+//
+// Every MCP tool of this server shares ONE engine connection and ONE
+// drawing. The MCP SDK dispatches tool calls concurrently, and hosts do issue
+// them in parallel (Claude Code sends independent tool calls of one turn at
+// once; subagents spawned by a session talk to the SAME server process and
+// therefore the same drawing). Without serialization a `snapshot` issued next
+// to a `run_script` renders whatever the drawing looked like when its GetTree
+// happened to run - possibly before the script created anything - and two
+// scripts interleave their commands on one connection.
+//
+// So tool executions are queued: each call starts after the previous one
+// settled (resolved OR rejected - a failed call never blocks the queue).
+// Pure lookups that never touch the engine (docs, method index) are exempt
+// and keep answering immediately.
+//
+// Subagents: they share this process and this queue with their parent. A
+// parent's tool call issued while a subagent runs a long script simply waits
+// for it - it would have to anyway, since both act on the same drawing. No
+// tool waits on ANOTHER tool's completion inside its own handler, so the
+// queue cannot deadlock. Separate Claude sessions run separate MCP processes
+// and are unaffected.
+/** Tools that only read package data (no engine access) and stay unqueued. */
+const busyChecks = new WeakMap();
+export function setDrawingBusy(server, check) { busyChecks.set(server, check); }
+export const UNQUEUED_TOOLS = new Set(['list_methods', 'describe_method', 'docs', 'session_info']);
+/**
+ * Patches `server.registerTool` so every handler registered afterwards runs
+ * through the shared queue (except the tools in `exclude`). Call it once,
+ * before the first registerTool call.
+ */
+export function serializeTools(server, exclude = UNQUEUED_TOOLS) {
+    // The tail of the chain: resolves when the most recently queued call settled.
+    let tail = Promise.resolve();
+    const original = server.registerTool.bind(server);
+    server.registerTool = (name, config, handler) => {
+        if (exclude.has(name))
+            return original(name, config, handler);
+        const queued = (...args) => {
+            const run = tail.then(() => busyChecks.get(server)?.()
+                ? { isError: true, content: [{ type: 'text', text: 'Session busy: timed-out work is unresolved. Wait before changing or inspecting the drawing.' }] }
+                : handler(...args));
+            // Whatever happens to this call, the next one may start afterwards.
+            tail = run.then(() => undefined, () => undefined);
+            return run;
+        };
+        return original(name, config, queued);
+    };
+}
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,qEAAqE;AACrE,8EAA8E;AAC9E,4EAA4E;AAC5E,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,0EAA0E;AAC1E,uDAAuD;AACvD,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,2EAA2E;AAC3E,kCAAkC;AAClC,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,sBAAsB;AAItB,8EAA8E;AAC9E,MAAM,UAAU,GAAG,IAAI,OAAO,EAA4B,CAAA;AAC1D,MAAM,UAAU,cAAc,CAAC,MAAiB,EAAE,KAAoB,IAAU,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA,CAAC,CAAC;AAE/G,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,iBAAiB,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;AAElG;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiB,EAAE,UAAuB,cAAc;IACrF,8EAA8E;IAC9E,IAAI,IAAI,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAA;IAC9C,MAAM,QAAQ,GAAI,MAAM,CAAC,YAAwC,CAAC,IAAI,CAAC,MAAM,CAAC,CAC7E;IAAC,MAAc,CAAC,YAAY,GAAG,CAAC,IAAY,EAAE,MAAe,EAAE,OAAgC,EAAE,EAAE;QAClG,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QAC7D,MAAM,MAAM,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE;gBACpD,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6FAA6F,EAAE,CAAC,EAAE;gBACrJ,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;YACrB,oEAAoE;YACpE,IAAI,GAAG,GAAG,CAAC,IAAI,CACb,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;YACD,OAAO,GAAG,CAAA;QACZ,CAAC,CAAA;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,CAAC,CAAA;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,423 @@
+#!/usr/bin/env node
+// server.ts — the `classcad-mcp` entry point hosts spawn over stdio.
+//
+// It is a thin shim: it finds the ClassCAD MCP daemon on this machine (or
+// starts it, detached) and forwards its host's JSON-RPC to the daemon over
+// HTTP (MCP Streamable HTTP). Every tab therefore gets its own session in the
+// ONE daemon process that owns the bridge listener — see daemon.ts for why.
+//
+// If no daemon can be reached at all (the port is held by a foreign program
+// and cannot be freed), the shim serves the MCP in-process as before, minus
+// the bridge listener, so a Drogon-only user is never blocked.
+import { spawn } from 'node:child_process';
+import { connect as tcpConnect } from 'node:net';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { createMcpServer, DEFAULT_WS_URL, VERSION } from './mcp-server.js';
+import { DAEMON_HOST, DEFAULT_DAEMON_PORT, defaultDaemonLogFile, daemonBuildStamp } from './daemon.js';
+import { wasmOptionsFromEnv } from './engine/wasm.js';
+import { authStatus, beginLogin, logout, waitForLogin } from './auth.js';
+const WS_URL = process.env.CLASSCAD_WS_URL ?? DEFAULT_WS_URL;
+/** Engine policy for this tab's session: auto (worker, else local WASM) | drogon | wasm. */
+const ENGINE = process.env.CLASSCAD_ENGINE ?? 'auto';
+const WASM = wasmOptionsFromEnv();
+const DAEMON_PORT = Number(process.env.CLASSCAD_MCP_PORT ?? DEFAULT_DAEMON_PORT);
+/** Full daemon base URL override (tests, unusual setups). */
+const DAEMON_URL = process.env.CLASSCAD_MCP_URL ?? `http://${DAEMON_HOST}:${DAEMON_PORT}`;
+const SPAWN_TIMEOUT_MS = 10_000;
+const log = (msg) => process.stderr.write(`[classcad-mcp] ${msg}\n`);
+async function health() {
+    try {
+        const res = await fetch(`${DAEMON_URL}/health`, { signal: AbortSignal.timeout(1500) });
+        if (!res.ok)
+            return null;
+        const j = (await res.json());
+        return j && j.name === 'classcad-mcp' ? j : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** True when something accepts TCP connections on the daemon port (a foreign program, if /health said no). */
+function portInUse() {
+    const { hostname, port } = new URL(DAEMON_URL);
+    return new Promise(resolve => {
+        const sock = tcpConnect({ host: hostname, port: Number(port) }, () => {
+            sock.destroy();
+            resolve(true);
+        });
+        sock.once('error', () => resolve(false));
+        sock.setTimeout(1000, () => {
+            sock.destroy();
+            resolve(false);
+        });
+    });
+}
+const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+/** Spawns the daemon detached (survives this shim) and waits for /health. */
+async function spawnDaemon() {
+    const daemonPath = join(dirname(fileURLToPath(import.meta.url)), 'daemon.js');
+    const child = spawn(process.execPath, [daemonPath], {
+        detached: true,
+        stdio: 'ignore',
+        windowsHide: true,
+        env: {
+            ...process.env,
+            CLASSCAD_MCP_DAEMON: '1',
+            CLASSCAD_MCP_PORT: String(DAEMON_PORT),
+            // The first shim's worker URL becomes the daemon default; each session
+            // still names its own worker via the x-classcad-ws-url header below.
+            CLASSCAD_WS_URL: WS_URL,
+        },
+    });
+    child.unref();
+    const deadline = Date.now() + SPAWN_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        await sleep(200);
+        const h = await health();
+        if (h)
+            return h;
+    }
+    return null;
+}
+/**
+ * Finds a daemon of this version, or starts one. Returns null when neither is
+ * possible (foreign program on the port) — the caller then serves in-process.
+ */
+/** True when the running daemon is another version or another build of this package. */
+function stale(h) {
+    if (h.version !== VERSION)
+        return true;
+    const mine = daemonBuildStamp();
+    if (mine === 'unknown')
+        return false;
+    // No stamp at all = a daemon from before stamps existed = older.
+    return !h.build || h.build !== mine;
+}
+async function ensureDaemon() {
+    let h = await health();
+    if (h && stale(h)) {
+        // An older daemon (previous install or previous build) — ask it to leave when idle.
+        log(`daemon ${h.version} (build ${h.build ?? '?'}) running, this MCP is ${VERSION} (build ${daemonBuildStamp()}): asking it to shut down`);
+        try {
+            const res = await fetch(`${DAEMON_URL}/shutdown`, { method: 'POST', signal: AbortSignal.timeout(1500) });
+            if (res.ok) {
+                for (let i = 0; i < 25 && (await health()); i++)
+                    await sleep(200);
+                h = await health();
+            }
+        }
+        catch {
+            /* fall through: use it as is */
+        }
+        if (h && stale(h)) {
+            // Busy with other tabs. Tell it to drain (newer daemons stop taking
+            // sessions and exit after the last one) and run THIS tab on the new
+            // code in-process — without the bridge listener, which the old daemon
+            // still holds. The next tab after the old one is gone starts a fresh daemon.
+            try {
+                await fetch(`${DAEMON_URL}/shutdown?drain=1`, { method: 'POST', signal: AbortSignal.timeout(1500) });
+            }
+            catch {
+                /* an old daemon without drain support: it leaves when idle */
+            }
+            log(`daemon ${h.version} (build ${h.build ?? '?'}) still serves ${h.sessions ?? '?'} other tab(s) — this tab runs the current build in-process (no bridge listener until that daemon is gone; restart the other tabs to move them)`);
+            return null;
+        }
+    }
+    if (h?.draining) {
+        log('daemon is draining; this tab runs in-process');
+        return null;
+    }
+    if (h)
+        return h;
+    if (await portInUse()) {
+        log(`port ${DAEMON_PORT} answers but is not a classcad-mcp daemon — set CLASSCAD_MCP_PORT to a free port`);
+        return null;
+    }
+    h = await spawnDaemon();
+    if (!h) {
+        // Lost the race to another shim, or the port was taken meanwhile: one more look.
+        h = await health();
+    }
+    return h;
+}
+/** Id of the initialize request the shim replays on a new daemon; its response is not the host's. */
+const REPLAY_ID = 'classcad-shim-reinitialize';
+/**
+ * Forward stdio (host) ⇄ HTTP (daemon) message by message.
+ *
+ * The daemon may go away under a live tab (`classcad-mcp stop --force`, a
+ * crash). The host initialized once and will not do it again, so the shim
+ * keeps the host's initialize request: when a send fails it finds or starts a
+ * daemon, replays the handshake there and resends. The tab continues on a
+ * fresh session (an empty drawing) instead of hanging on unanswered requests.
+ */
+async function proxyToDaemon() {
+    const stdio = new StdioServerTransport();
+    let upstream;
+    let hostInitialize = null;
+    const replayWaiters = new Set();
+    const connect = async () => {
+        const t = new StreamableHTTPClientTransport(new URL(`${DAEMON_URL}/mcp`), {
+            // Per-session settings travel as loopback headers: the daemon may have
+            // been started by another tab with a different configuration.
+            requestInit: {
+                headers: {
+                    'x-classcad-ws-url': WS_URL,
+                    'x-classcad-engine': ENGINE,
+                    ...(WASM ? { 'x-classcad-wasm-key': WASM.key, ...(WASM.origin ? { 'x-classcad-wasm-origin': WASM.origin } : {}) } : {}),
+                },
+            },
+        });
+        t.onmessage = m => {
+            if ('id' in m && m.id === REPLAY_ID) {
+                for (const resolve of replayWaiters)
+                    resolve();
+                replayWaiters.clear();
+                return;
+            }
+            stdio.send(m).catch(err => log(`stdio send failed: ${err?.message ?? err}`));
+        };
+        t.onerror = err => log(`daemon transport error: ${err.message}`);
+        t.onclose = () => {
+            if (t === upstream)
+                void finish('daemon closed the session');
+        };
+        await t.start();
+        return t;
+    };
+    /** New daemon session for this tab, handshake replayed. False when no daemon can be reached. */
+    const reconnect = async () => {
+        const h = await ensureDaemon();
+        if (!h || !hostInitialize || !('method' in hostInitialize))
+            return false;
+        const previous = upstream;
+        upstream = await connect();
+        previous.close().catch(() => { });
+        const answered = new Promise(resolve => replayWaiters.add(resolve));
+        await upstream.send({ ...hostInitialize, id: REPLAY_ID });
+        await Promise.race([answered, sleep(15_000).then(() => Promise.reject(new Error('initialize not answered')))]);
+        await upstream.send({ jsonrpc: '2.0', method: 'notifications/initialized' });
+        log(`reconnected to daemon ${h.version} (pid ${h.pid}) — new session, previous drawing state is gone`);
+        return true;
+    };
+    const forward = async (m) => {
+        if ('method' in m && m.method === 'initialize')
+            hostInitialize = m;
+        try {
+            await upstream.send(m);
+            return;
+        }
+        catch (err) {
+            log(`daemon send failed: ${err?.message ?? err} — reconnecting`);
+        }
+        try {
+            if (hostInitialize && m !== hostInitialize && (await reconnect())) {
+                await upstream.send(m);
+                return;
+            }
+        }
+        catch (err) {
+            log(`reconnect failed: ${err?.message ?? err}`);
+        }
+        // Unrecoverable: answer the host instead of leaving the request pending, then end the tab's MCP.
+        if ('method' in m && 'id' in m) {
+            await stdio
+                .send({ jsonrpc: '2.0', id: m.id, error: { code: -32000, message: 'ClassCAD MCP daemon unreachable — restart the MCP' } })
+                .catch(() => { });
+        }
+        void finish('daemon unreachable');
+    };
+    // Serial: a reconnect must finish before the next host message goes out.
+    let queue = Promise.resolve();
+    stdio.onmessage = m => {
+        queue = queue.then(() => forward(m));
+    };
+    upstream = await connect();
+    let done = false;
+    const finish = async (why) => {
+        if (done)
+            return;
+        done = true;
+        log(`session ended (${why})`);
+        try {
+            await upstream.terminateSession();
+        }
+        catch {
+            /* daemon may be gone */
+        }
+        try {
+            await upstream.close();
+        }
+        catch { }
+        try {
+            await stdio.close();
+        }
+        catch { }
+        process.exit(0);
+    };
+    stdio.onclose = () => void finish('host closed stdio');
+    process.on('SIGINT', () => void finish('SIGINT'));
+    process.on('SIGTERM', () => void finish('SIGTERM'));
+    // The SDK transport only reads stdin; it does not notice when the host closes it.
+    // A host that ends our stdin (instead of killing us) must still end the daemon session.
+    process.stdin.on('end', () => void finish('host closed stdin'));
+    process.stdin.on('close', () => void finish('host closed stdin'));
+    await stdio.start();
+}
+/** Last resort: the MCP in this process, without a bridge listener. */
+async function serveInProcess() {
+    const { server, client } = await createMcpServer({ wsUrl: WS_URL, bridge: () => null, engine: ENGINE, wasm: WASM, log });
+    const shutdown = () => {
+        try {
+            client.close();
+        }
+        catch { }
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    process.stdin.on('end', shutdown);
+    process.stdin.on('close', shutdown);
+    await server.connect(new StdioServerTransport());
+}
+async function main() {
+    const h = await ensureDaemon();
+    if (h) {
+        log(`using daemon ${h.version} (pid ${h.pid}, ${h.sessions} session(s), bridge ${h.bridge ?? 'none'}) at ${DAEMON_URL}; daemon log: ${h.logFile ?? defaultDaemonLogFile()}`);
+        if (!h.bridge)
+            log(`WARNING: the daemon has no bridge listener (${h.bridgeListen ?? 'unknown'} is taken, probably by an MCP of an older build in another tab) — in-app engines cannot attach until that process is gone; the daemon retries by itself`);
+        await proxyToDaemon();
+        return;
+    }
+    log('serving in-process (no bridge listener: in-app engines cannot attach; the worker and the local WASM engine work as usual)');
+    await serveInProcess();
+}
+const USAGE = `classcad-mcp — ClassCAD MCP server (stdio). Hosts start it without arguments.
+
+Daemon commands:
+  classcad-mcp status          show the running daemon (pid, build, sessions, apps, log file)
+  classcad-mcp stop            stop the daemon if no session is active
+  classcad-mcp stop --force    terminate it now: EVERY connected tab loses its drawing and
+                               reconnects to a fresh daemon on its next tool call
+
+Account commands (the MCP works for signed-in classcad.ch accounts):
+  classcad-mcp login           print a sign-in link and wait until it is used
+  classcad-mcp whoami          show this machine's sign-in
+  classcad-mcp logout          sign this machine out
+`;
+const pidAlive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+};
+/** Waits until the daemon neither answers /health nor has a live pid. */
+async function waitGone(pid, ms) {
+    const deadline = Date.now() + ms;
+    while (Date.now() < deadline) {
+        if (!(await health()) && !(pid && pidAlive(pid)))
+            return true;
+        await sleep(100);
+    }
+    return false;
+}
+async function stopDaemon(force) {
+    const h = await health();
+    if (!h) {
+        console.log(`no classcad-mcp daemon at ${DAEMON_URL}`);
+        return 0;
+    }
+    if (!force) {
+        const res = await fetch(`${DAEMON_URL}/shutdown`, { method: 'POST', signal: AbortSignal.timeout(1500) });
+        if (res.status === 409) {
+            console.error(`daemon pid ${h.pid} has ${h.sessions} active session(s) — not stopped.\n` +
+                `\`classcad-mcp stop --force\` ends them: every connected tab loses its drawing and reconnects on its next tool call.`);
+            return 1;
+        }
+        if (!res.ok) {
+            console.error(`daemon refused to stop: HTTP ${res.status}`);
+            return 1;
+        }
+    }
+    else {
+        if (!h.pid) {
+            console.error('daemon did not report its pid — cannot force it');
+            return 1;
+        }
+        // SIGTERM runs the daemon's own shutdown: sessions closed, bridge and port released.
+        process.kill(h.pid, 'SIGTERM');
+    }
+    if (await waitGone(h.pid, 5000)) {
+        console.log(`stopped daemon pid ${h.pid}${force ? ` (${h.sessions ?? 0} session(s) ended)` : ''}`);
+        return 0;
+    }
+    if (force && h.pid) {
+        process.kill(h.pid, 'SIGKILL');
+        if (await waitGone(h.pid, 2000)) {
+            console.log(`killed daemon pid ${h.pid} (did not exit on SIGTERM)`);
+            return 0;
+        }
+    }
+    console.error(`daemon pid ${h.pid} is still running`);
+    return 1;
+}
+async function cli(command, args) {
+    if (command === 'status') {
+        const h = await health();
+        if (!h) {
+            console.log(`no classcad-mcp daemon at ${DAEMON_URL}`);
+            return 1;
+        }
+        console.log(JSON.stringify(h, null, 2));
+        return 0;
+    }
+    if (command === 'stop')
+        return stopDaemon(args.includes('--force'));
+    if (command === 'whoami' || command === 'login') {
+        const status = await authStatus();
+        if (status.signedIn) {
+            console.log(`signed in as ${status.account.email ?? status.account.name ?? status.account.uid}${status.offline ? ' (offline, not re-checked)' : ''}`);
+            return 0;
+        }
+        if (command === 'whoami') {
+            console.log(status.reason);
+            return 1;
+        }
+        const { url } = await beginLogin('this terminal');
+        console.log(`Open this link to sign in:\n\n  ${url}\n\nWaiting …`);
+        const account = await waitForLogin(15 * 60 * 1000).catch(() => null);
+        if (!account) {
+            console.error('the sign-in link expired');
+            return 1;
+        }
+        console.log(`signed in as ${account.email ?? account.name ?? account.uid}`);
+        return 0;
+    }
+    if (command === 'logout') {
+        console.log(logout() ? 'signed out' : 'was not signed in');
+        return 0;
+    }
+    console.log(USAGE);
+    return 0;
+}
+const [command, ...args] = process.argv.slice(2);
+if (['status', 'stop', 'login', 'logout', 'whoami', 'help', '--help'].includes(command)) {
+    cli(command, args).then(code => process.exit(code), err => {
+        process.stderr.write(`[classcad-mcp] ${err?.message ?? err}\n`);
+        process.exit(1);
+    });
+}
+else {
+    main().catch(err => {
+        process.stderr.write(`[classcad-mcp] FATAL: ${err?.message ?? err}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/auth.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/** Tools that work without a sign-in: the sign-in itself, status, and the public docs. */
+export declare const OPEN_TOOLS: Set<string>;
+export declare const SIGN_IN_NOTE = "SIGN-IN: the ClassCAD MCP needs a free classcad.ch account, once per machine. When a tool answers \"Sign-in required\", show the user the link it gives (as a clickable link, on its own line), then call `login` \u2014 it waits and returns as soon as they have signed in; then repeat the call. Docs tools work without a sign-in.";
+/** Wraps every tool registered after this call, except OPEN_TOOLS, in the sign-in check. */
+export declare function requireSignIn(server: McpServer, open?: Set<string>): void;
+export declare function registerAuthTool(server: McpServer): void;

package/dist/tools/auth.js

@@ -0,0 +1,63 @@
+// tools/auth.ts — the sign-in gate and the `login` tool.
+//
+// requireSignIn() patches registerTool (like serializeTools) so every tool
+// registered afterwards first checks the machine's sign-in. Not signed in,
+// the call starts a sign-in and answers with its link instead of running;
+// the agent shows the link and calls `login`, which returns the moment the
+// browser hands the sign-in back.
+import { z } from 'zod';
+import { authStatus, beginLogin, logout, pendingLogin, waitForLogin } from '../auth.js';
+/** Tools that work without a sign-in: the sign-in itself, status, and the public docs. */
+export const OPEN_TOOLS = new Set(['login', 'session_info', 'list_methods', 'describe_method', 'docs']);
+/** How long one `login` call waits (under Codex's 60 s default tool timeout). */
+const WAIT_MS = 50_000;
+export const SIGN_IN_NOTE = 'SIGN-IN: the ClassCAD MCP needs a free classcad.ch account, once per machine. When a tool answers "Sign-in required", show the user the link it gives (as a clickable link, on its own line), then call `login` — it waits and returns as soon as they have signed in; then repeat the call. Docs tools work without a sign-in.';
+const clientName = (server) => server.server.getClientVersion()?.name;
+function linkText(url) {
+    return ('Sign-in required: the ClassCAD MCP works with a free classcad.ch account (Google, GitHub or email; one click if they already have one).\n\n' +
+        `Show the user this link, as a clickable link on its own line, and ask them to sign in:\n\n${url}\n\n` +
+        'Then call the `login` tool: it waits and returns as soon as the sign-in has arrived. After that, repeat the call that needed it.');
+}
+/** Wraps every tool registered after this call, except OPEN_TOOLS, in the sign-in check. */
+export function requireSignIn(server, open = OPEN_TOOLS) {
+    const original = server.registerTool.bind(server);
+    server.registerTool = (name, config, handler) => {
+        if (open.has(name))
+            return original(name, config, handler);
+        const gated = async (...args) => {
+            const status = await authStatus();
+            if (status.signedIn)
+                return handler(...args);
+            const { url } = await beginLogin(clientName(server));
+            return { isError: true, content: [{ type: 'text', text: (status.reason === 'not signed in' ? '' : `(${status.reason}.) `) + linkText(url) }] };
+        };
+        return original(name, config, gated);
+    };
+}
+export function registerAuthTool(server) {
+    server.registerTool('login', {
+        title: 'Sign in to ClassCAD',
+        description: 'Sign this machine in to ClassCAD (a free classcad.ch account; Google, GitHub or email). Not signed in: the first call returns a link — show it to the user as a clickable link — and the next call WAITS (up to ~50 s per call) until they have signed in in the browser, then returns their account. Call again while it reports "still waiting". Already signed in: returns the account at once. logout: true signs the machine out.',
+        inputSchema: {
+            logout: z.boolean().optional().describe('Sign this machine out instead.'),
+        },
+    }, async ({ logout: out }) => {
+        const text = (t) => ({ content: [{ type: 'text', text: t }] });
+        if (out)
+            return text(logout() ? 'Signed out. The next ClassCAD call asks for a new sign-in.' : 'Was not signed in.');
+        const status = await authStatus();
+        if (status.signedIn)
+            return text(`Signed in as ${status.account.email ?? status.account.name ?? status.account.uid}.`);
+        const waiting = pendingLogin();
+        if (!waiting)
+            return text(linkText((await beginLogin(clientName(server))).url));
+        const account = await waitForLogin(WAIT_MS);
+        if (account)
+            return text(`Signed in as ${account.email ?? account.name ?? account.uid}. Repeat the call that needed it.`);
+        const still = pendingLogin();
+        if (!still)
+            return text(linkText((await beginLogin(clientName(server))).url));
+        return text(`Still waiting for the user to sign in at:\n\n${still.url}\n\nCall \`login\` again to keep waiting.`);
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/tools/auth.js.map

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

package/dist/tools/bridge.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Client } from '../client.js';
+import type { BridgeRegistry } from '../bridge/server.js';
+export declare function registerBridgeTools(server: McpServer, client: Client, registry: BridgeRegistry): void;