@classcad/mcp 0.1.4 → 0.2.0

package/dist/viewer/server.js

@@ -0,0 +1,229 @@
+// viewer/server.ts — the live 3D view of a session, served to the user's
+// browser from this machine.
+//
+//   http://127.0.0.1:<port>/v/<token>            the page (viewer-page/)
+//   …/v/<token>/scene                            what to draw, as JSON
+//   …/v/<token>/events                           server-sent events: "scene" whenever the model changed
+//   …/v/<token>/export/<name>.{stp,stl,glb}      the model as a file
+//   …/assets/…                                   the page's own files (three.js, the font)
+//
+// One listener per MCP process (the daemon, or a shim serving in-process),
+// shared by all of its sessions. Each session has its own unguessable token:
+// a page shows the model of exactly one session, and two sessions never see
+// each other's. The listener binds 127.0.0.1 and answers only requests that
+// name it as their host.
+//
+// The engine is read in the session's own tool queue (`load`, `exportModel`
+// are queued by the caller), never in the middle of a script.
+import { createServer } from 'node:http';
+import { randomBytes } from 'node:crypto';
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { dirname, extname, join, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { gzipSync } from 'node:zlib';
+import { openBrowser } from '../auth.js';
+import { buildScene, sceneToGlb } from './scene.js';
+const PAGE_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'viewer-page');
+const DEFAULT_PORT = 9098;
+const sessions = new Map();
+let listener = null;
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.woff2': 'font/woff2',
+    '.svg': 'image/svg+xml',
+    '.txt': 'text/plain; charset=utf-8',
+};
+/** The page's files, read once: path under /assets/ → bytes. */
+let assets = null;
+function loadAssets() {
+    if (assets)
+        return assets;
+    assets = new Map();
+    const walk = (dir) => {
+        for (const name of readdirSync(dir)) {
+            const file = join(dir, name);
+            if (statSync(file).isDirectory())
+                walk(file);
+            else
+                assets.set(relative(PAGE_DIR, file).split(sep).join('/'), { body: readFileSync(file), type: MIME[extname(name)] ?? 'application/octet-stream' });
+        }
+    };
+    if (existsSync(PAGE_DIR))
+        walk(PAGE_DIR);
+    return assets;
+}
+function listen() {
+    listener ??= new Promise((resolve, reject) => {
+        const server = createServer((req, res) => {
+            handle(req, res).catch(err => {
+                if (!res.headersSent)
+                    res.writeHead(500, { 'content-type': 'text/plain; charset=utf-8' });
+                res.end(String(err?.message ?? err));
+            });
+        });
+        const wanted = Number(process.env.CLASSCAD_VIEWER_PORT ?? DEFAULT_PORT);
+        const bound = () => {
+            server.unref();
+            resolve({ server, port: server.address().port });
+        };
+        server.once('error', (err) => {
+            // Another MCP process of this machine has the port: any free one will do.
+            if (err.code === 'EADDRINUSE' && wanted !== 0) {
+                server.once('error', reject);
+                server.listen(0, '127.0.0.1', bound);
+            }
+            else
+                reject(err);
+        });
+        server.listen(wanted, '127.0.0.1', bound);
+    });
+    return listener;
+}
+/** A session's view. The listener starts with the first one. */
+export async function openViewerSession(source) {
+    const { port } = await listen();
+    const entry = { token: randomBytes(18).toString('base64url'), source, scene: null, body: null, version: 0, dirty: true, building: null, streams: new Set(), opened: false };
+    sessions.set(entry.token, entry);
+    const url = `http://127.0.0.1:${port}/v/${entry.token}`;
+    const open = () => {
+        entry.opened = true;
+        return process.env.CLASSCAD_VIEWER_NO_BROWSER === '1' ? false : openBrowser(url);
+    };
+    return {
+        url,
+        open,
+        touch: () => {
+            entry.dirty = true;
+            // Nobody watching and the view already offered: the next page load rebuilds.
+            if (!entry.streams.size && entry.opened)
+                return;
+            void rebuild(entry).then(() => {
+                broadcast(entry, 'scene', { version: entry.version });
+                // The first model of a session brings its view up, once.
+                if (!entry.opened && entry.scene?.bodies.length) {
+                    entry.opened = true;
+                    if (process.env.CLASSCAD_VIEWER_OPEN !== '0' && process.env.CLASSCAD_VIEWER_NO_BROWSER !== '1' && !entry.streams.size)
+                        openBrowser(url);
+                }
+            }, err => source.log?.(`viewer: ${err?.message ?? err}`));
+        },
+        close: () => {
+            broadcast(entry, 'closed', {});
+            for (const res of entry.streams)
+                res.end();
+            entry.streams.clear();
+            sessions.delete(entry.token);
+        },
+    };
+}
+/** Reads the session and packs what the page draws. One build at a time per session. */
+function rebuild(entry) {
+    entry.building ??= (async () => {
+        entry.dirty = false;
+        const state = await entry.source.load();
+        const scene = buildScene(state?.tree, state?.graphic);
+        entry.scene = scene;
+        entry.version++;
+        entry.body = gzipSync(JSON.stringify({ version: entry.version, host: entry.source.host() ?? null, engine: entry.source.engine(), scene }));
+    })().finally(() => {
+        entry.building = null;
+    });
+    return entry.building;
+}
+function broadcast(entry, event, data) {
+    const frame = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+    for (const res of entry.streams)
+        res.write(frame);
+}
+const SAFE_HEADERS = { 'cache-control': 'no-store', 'x-content-type-options': 'nosniff', 'referrer-policy': 'no-referrer' };
+async function handle(req, res) {
+    const port = (req.socket.localPort ?? 0);
+    // Only this listener's own address: no DNS rebinding, no other sites' pages.
+    if (req.headers.host !== `127.0.0.1:${port}` && req.headers.host !== `localhost:${port}`)
+        return text(res, 403, 'forbidden');
+    if (req.method !== 'GET' && req.method !== 'HEAD')
+        return text(res, 405, 'method not allowed');
+    const path = decodeURIComponent(new URL(req.url ?? '/', `http://127.0.0.1:${port}`).pathname);
+    if (path.startsWith('/assets/')) {
+        const asset = loadAssets().get(path.slice('/assets/'.length));
+        if (!asset || path.endsWith('index.html'))
+            return text(res, 404, 'not found');
+        res.writeHead(200, { ...SAFE_HEADERS, 'content-type': asset.type, 'cache-control': 'no-cache' });
+        return void res.end(asset.body);
+    }
+    const m = /^\/v\/([A-Za-z0-9_-]{16,64})(\/.*)?$/.exec(path);
+    if (!m)
+        return text(res, 404, 'not found');
+    const entry = sessions.get(m[1]);
+    const rest = m[2] ?? '';
+    if (rest === '' || rest === '/') {
+        // The page is served for an ended session too: it says so itself.
+        const page = loadAssets().get('index.html');
+        if (!page)
+            return text(res, 500, 'the viewer page is missing from this build');
+        const nonce = randomBytes(12).toString('base64');
+        res.writeHead(200, {
+            ...SAFE_HEADERS,
+            'content-type': page.type,
+            'content-security-policy': `default-src 'self'; script-src 'self' 'nonce-${nonce}'; style-src 'self'; img-src 'self' data: blob:; connect-src 'self'; font-src 'self'; frame-ancestors 'none'; base-uri 'none'`,
+        });
+        return void res.end(page.body.toString('utf8').replaceAll('__NONCE__', nonce));
+    }
+    if (!entry)
+        return json(res, 404, { error: 'This view has ended: its session is over.' });
+    if (rest === '/scene') {
+        // A build in flight may have read the model before the last change: wait for it, then look again.
+        if (entry.building)
+            await entry.building;
+        if (entry.dirty || !entry.body)
+            await rebuild(entry);
+        res.writeHead(200, { ...SAFE_HEADERS, 'content-type': 'application/json; charset=utf-8', 'content-encoding': 'gzip' });
+        return void res.end(entry.body);
+    }
+    if (rest === '/events') {
+        res.writeHead(200, { ...SAFE_HEADERS, 'content-type': 'text/event-stream; charset=utf-8', connection: 'keep-alive' });
+        res.write(`retry: 2000\nevent: hello\ndata: ${JSON.stringify({ version: entry.version })}\n\n`);
+        entry.streams.add(res);
+        entry.opened = true;
+        const beat = setInterval(() => res.write(': still here\n\n'), 20_000);
+        beat.unref();
+        req.on('close', () => {
+            clearInterval(beat);
+            entry.streams.delete(res);
+        });
+        return;
+    }
+    const file = /^\/export\/([^/]{1,80})\.(stp|step|stl|glb)$/i.exec(rest);
+    if (file) {
+        const ext = file[2].toLowerCase();
+        let body;
+        let type;
+        if (ext === 'glb') {
+            if (entry.building)
+                await entry.building;
+            if (entry.dirty || !entry.scene)
+                await rebuild(entry);
+            body = sceneToGlb(entry.scene);
+            type = 'model/gltf-binary';
+        }
+        else {
+            body = await entry.source.exportModel(ext === 'stl' ? 'STL' : 'STP');
+            type = ext === 'stl' ? 'model/stl' : 'model/step';
+        }
+        const name = file[1].replace(/[^A-Za-z0-9._ -]/g, '_');
+        res.writeHead(200, { ...SAFE_HEADERS, 'content-type': type, 'content-length': String(body.length), 'content-disposition': `attachment; filename="${name}.${ext}"` });
+        return void res.end(body);
+    }
+    return text(res, 404, 'not found');
+}
+function text(res, status, body) {
+    res.writeHead(status, { ...SAFE_HEADERS, 'content-type': 'text/plain; charset=utf-8' });
+    res.end(body);
+}
+function json(res, status, body) {
+    res.writeHead(status, { ...SAFE_HEADERS, 'content-type': 'application/json; charset=utf-8' });
+    res.end(JSON.stringify(body));
+}
+//# sourceMappingURL=server.js.map

package/dist/viewer/server.js.map

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

package/dist/viewer-page/cube.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="256" height="256" viewBox="0 0 200 200">
+  <title>ClassCAD</title>
+  <defs>
+    <mask id="cube">
+      <rect width="200" height="200" fill="#fff"/>
+      <path d="M100 -4V204M100 100L4 44.5M100 100L196 44.5" stroke="#000" stroke-width="10"/>
+    </mask>
+  </defs>
+  <g mask="url(#cube)">
+    <path d="M100 0L13 50L100 100Z" fill="#8f0d10"/>
+    <path d="M100 0L187 50L100 100Z" fill="#e8232a"/>
+    <path d="M13 50L100 100V200L13 150Z" fill="#e8232a"/>
+    <path d="M187 50L100 100V200L187 150Z" fill="#8f0d10"/>
+  </g>
+</svg>

package/dist/viewer-page/fonts/LICENSE.txt

@@ -0,0 +1,3 @@
+JetBrains Mono (latin subset, variable weight 100–800)
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+Licensed under the SIL Open Font License, Version 1.1: https://openfontlicense.org

package/dist/viewer-page/index.html

@@ -0,0 +1,135 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="color-scheme" content="light dark" />
+    <title>ClassCAD</title>
+    <link rel="icon" href="/assets/cube.svg" />
+    <link rel="stylesheet" href="/assets/viewer.css" />
+    <!-- the theme, before the first paint -->
+    <script nonce="__NONCE__">
+      ;(() => {
+        let pick = null
+        try {
+          pick = localStorage.getItem('classcad-mcp:theme')
+        } catch {}
+        const dark = pick ? pick === 'dark' : matchMedia('(prefers-color-scheme: dark)').matches
+        document.documentElement.dataset.theme = dark ? 'dark' : 'light'
+      })()
+    </script>
+    <script type="importmap" nonce="__NONCE__">
+      { "imports": { "three": "/assets/vendor/three.module.min.js", "three/addons/": "/assets/vendor/addons/" } }
+    </script>
+  </head>
+  <body>
+    <div class="app" id="app" data-state="loading">
+      <header class="bar">
+        <div class="bar__lead">
+          <svg class="mark" viewBox="0 0 200 200" width="20" height="20" aria-hidden="true">
+            <defs>
+              <mask id="cube">
+                <rect width="200" height="200" fill="#fff" />
+                <path d="M100 -4V204M100 100L4 44.5M100 100L196 44.5" stroke="#000" stroke-width="10" />
+              </mask>
+            </defs>
+            <g mask="url(#cube)">
+              <path d="M100 0L13 50L100 100Z" class="mark__b" />
+              <path d="M100 0L187 50L100 100Z" class="mark__a" />
+              <path d="M13 50L100 100V200L13 150Z" class="mark__a" />
+              <path d="M187 50L100 100V200L187 150Z" class="mark__b" />
+            </g>
+          </svg>
+          <span class="bar__name">ClassCAD</span>
+          <span class="bar__rule" aria-hidden="true"></span>
+          <div class="menu" id="export">
+            <button type="button" class="tool tool--word" id="export-button" aria-haspopup="menu" aria-expanded="false">
+              <svg viewBox="0 0 20 20" width="20" height="20" aria-hidden="true"><path class="pen" d="M10 3v9M6.5 8.5 10 12l3.5-3.5" /><path class="pen" d="M4 14v2.5h12V14" /></svg>
+              <span>Export</span>
+            </button>
+            <div class="menu__list" role="menu" hidden>
+              <p class="menu__title">The model as a file</p>
+              <a role="menuitem" class="menu__row" data-export="stp" href="#"><span class="menu__name">STEP</span><span class="call">.stp · exact geometry</span></a>
+              <a role="menuitem" class="menu__row" data-export="stl" href="#"><span class="menu__name">STL</span><span class="call">.stl · triangles</span></a>
+              <a role="menuitem" class="menu__row" data-export="glb" href="#"><span class="menu__name">glTF</span><span class="call">.glb · triangles, colours</span></a>
+            </div>
+          </div>
+        </div>
+        <div class="bar__trail">
+          <button type="button" class="theme" id="theme" aria-pressed="false" aria-label="Dark mode" title="Light or dark">
+            <span class="theme__disc" aria-hidden="true"></span>
+          </button>
+        </div>
+      </header>
+
+      <aside class="side" aria-label="The model">
+        <div class="head">
+          <p class="kicker" id="kind">Part</p>
+          <h1 class="docname" id="name">&nbsp;</h1>
+        </div>
+        <section class="pane">
+          <div class="pane__label"><span>Features</span><span class="num" id="feature-count"></span></div>
+          <ol class="rows" id="features"></ol>
+        </section>
+        <section class="pane">
+          <div class="pane__label"><span>Bodies</span><span class="num" id="body-count"></span></div>
+          <ul class="rows" id="bodies"></ul>
+        </section>
+      </aside>
+
+      <main class="stage" id="stage">
+        <canvas id="canvas" aria-label="The model, in 3D"></canvas>
+        <i class="corner corner--tl" aria-hidden="true"></i><i class="corner corner--tr" aria-hidden="true"></i>
+        <i class="corner corner--bl" aria-hidden="true"></i><i class="corner corner--br" aria-hidden="true"></i>
+        <p class="hud" id="hud"></p>
+        <div class="dock" role="toolbar" aria-label="View">
+          <button type="button" class="tool" data-view="iso" aria-label="Isometric view" data-tip="Isometric">
+            <svg viewBox="0 0 20 20" width="20" height="20" aria-hidden="true"><path class="pen" d="M10 3 16 6.5v7L10 17l-6-3.5v-7zM10 10v7M10 10 4 6.5M10 10l6-3.5" /></svg>
+          </button>
+          <button type="button" class="tool" data-view="front" aria-label="Front view" data-tip="Front">
+            <svg viewBox="0 0 20 20" width="20" height="20" aria-hidden="true"><path class="pen pen--pale" d="M4 7 7 4h9v9l-3 3M13 7l3-3" /><path class="pen pen--face" d="M4 7h9v9H4z" /></svg>
+          </button>
+          <button type="button" class="tool" data-view="top" aria-label="Top view" data-tip="Top">
+            <svg viewBox="0 0 20 20" width="20" height="20" aria-hidden="true"><path class="pen pen--pale" d="M4 7v9h9l3-3V4M13 7v9" /><path class="pen pen--face" d="M4 7 7 4h9l-3 3z" /></svg>
+          </button>
+          <button type="button" class="tool" data-view="right" aria-label="Right view" data-tip="Right">
+            <svg viewBox="0 0 20 20" width="20" height="20" aria-hidden="true"><path class="pen pen--pale" d="M13 7H4v9h9M4 7l3-3h9" /><path class="pen pen--face" d="M13 7l3-3v9l-3 3z" /></svg>
+          </button>
+          <span class="dock__rule" aria-hidden="true"></span>
+          <button type="button" class="tool" id="fit" aria-label="Fit the model in view" data-tip="Fit">
+            <svg viewBox="0 0 20 20" width="20" height="20" aria-hidden="true"><path class="pen" d="M3 7V3h4M13 3h4v4M17 13v4h-4M7 17H3v-4" /><path class="pen pen--face" d="M7.5 7.5h5v5h-5z" /></svg>
+          </button>
+          <button type="button" class="tool" id="edges" aria-pressed="true" aria-label="Edges" data-tip="Edges">
+            <svg viewBox="0 0 20 20" width="20" height="20" aria-hidden="true"><path class="pen pen--pale" d="M10 10v7M10 10 4 6.5M10 10l6-3.5" /><path class="pen" d="M10 3 16 6.5v7L10 17l-6-3.5v-7z" /></svg>
+          </button>
+        </div>
+        <svg class="triad" id="triad" viewBox="-30 -30 60 60" width="60" height="60" aria-hidden="true">
+          <line id="triad-x" class="triad__x" x1="0" y1="0" /><line id="triad-y" class="triad__y" x1="0" y1="0" /><line id="triad-z" class="triad__z" x1="0" y1="0" />
+          <text id="triad-lx" class="triad__x">X</text><text id="triad-ly" class="triad__y">Y</text><text id="triad-lz" class="triad__z">Z</text>
+        </svg>
+        <div class="waiting" id="waiting">
+          <p class="waiting__line"><span class="arc" aria-hidden="true"></span><span id="waiting-label">Waiting for the model</span></p>
+          <p class="waiting__note" id="waiting-note">No model yet. What your agent builds appears here.</p>
+        </div>
+        <div class="scrim" id="scrim" hidden>
+          <div class="card">
+            <p class="card__label">Disconnected</p>
+            <p class="card__text" id="scrim-text">The session behind this view has ended. What you see is its last model.</p>
+          </div>
+        </div>
+      </main>
+
+      <footer class="title" aria-label="Status">
+        <div class="cell cell--live"><span class="dot" id="dot" aria-hidden="true"></span><span id="engine">ClassCAD</span></div>
+        <div class="cell cell--fill" id="doing"></div>
+        <div class="cell"><span class="cell__k">Bodies</span><b id="s-bodies">0</b></div>
+        <div class="cell cell--wider"><span class="cell__k">Faces</span><b id="s-faces">0</b></div>
+        <div class="cell cell--wider"><span class="cell__k">Triangles</span><b id="s-tris">0</b></div>
+        <div class="cell"><span class="cell__k">Size</span><b id="s-size">–</b></div>
+        <div class="cell cell--wide"><span class="cell__k">Host</span><b id="s-host">–</b></div>
+      </footer>
+      <div class="tip" id="tip" role="tooltip" hidden></div>
+    </div>
+    <script type="module" src="/assets/viewer.js" nonce="__NONCE__"></script>
+  </body>
+</html>

package/dist/viewer-page/vendor/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright © 2010-2026 three.js authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/viewer-page/vendor/VERSION.txt

@@ -0,0 +1 @@
+three 0.185.1 (MIT), copied at build time