@classcad/mcp 0.2.1 → 0.3.0

package/dist/share/server.js

@@ -0,0 +1,399 @@
+// share/server.ts — where sessions are joined on this machine: the local listener.
+//
+//   http://127.0.0.1:<port>/?invite=<token>     the app (Buerligons), docked into the session of that invite
+//   ws://127.0.0.1:<port>/session/?invite=…     a session, joined as a guest: what a ClassCAD server's WebSocket is
+//   ws://127.0.0.1:<port>/session/?host=…       a page that hosts a session of its own and offers an invite here
+//   …/assets/…                                  the app's own files
+//
+// Two kinds of session are joined here, by the same ?invite=:
+//   • the MCP's own (share/hub.ts): the engine is the MCP's, apps are guests.
+//   • a page's: an app that runs the engine in its own page (buerli's
+//     WASMClient) hosts its session itself, but a page cannot listen. So it
+//     connects out, with ?host=<invite>, and waits. When a guest joins with
+//     that invite the page is told and opens one more connection
+//     (?host=<invite>&guest=<id>), which is joined to the guest's: from then on
+//     the two talk to each other and this listener only passes the bytes. That
+//     is how an MCP session joins the engine of a foreign app: as its guest.
+//
+// One listener per MCP process (the daemon, or a shim serving in-process),
+// shared by all of its sessions. Every session has invites of its own: a page
+// is in exactly one session, and two sessions never see each other. The
+// listener binds 127.0.0.1 and answers only requests that name it as their
+// host. An invite is the key to its session — the link is a secret — and the
+// only one: apps of any origin may join with it, as they may join a server.
+import { createServer } from 'node:http';
+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 { WebSocketServer } from 'ws';
+import { randomUUID } from 'node:crypto';
+import { authStatus } from '../auth.js';
+/** The app's build, copied into the package (scripts/copy-build-assets.mjs). */
+const APP_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'app');
+/** The port apps look for the MCP on (DEFAULT_SESSION_URL in @buerli.io/classcad); CLASSCAD_VIEWER_PORT names another. */
+const DEFAULT_PORT = 9098;
+/** The WebSocket path the app's build connects to (its WSCLIENT_URL). */
+export const SESSION_PATH = '/session';
+/** Content types of what an app build is made of. */
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.wasm': 'application/wasm',
+    '.txt': 'text/plain; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+};
+/** Text formats: served gzipped to whoever takes it. */
+const COMPRESSIBLE = new Set(['.html', '.js', '.css', '.json', '.svg', '.txt']);
+/** The app's files, read once: path → bytes. Empty when this build has no app. */
+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 {
+                const body = readFileSync(file);
+                const ext = extname(name);
+                assets.set(relative(APP_DIR, file).split(sep).join('/'), { body, gzip: COMPRESSIBLE.has(ext) && body.length > 1024 ? gzipSync(body) : null, type: MIME[ext] ?? 'application/octet-stream' });
+            }
+        }
+    };
+    if (existsSync(APP_DIR))
+        walk(APP_DIR);
+    return assets;
+}
+/** True when this build carries the app (dist/app/index.html). */
+export function appAvailable() {
+    return existsSync(join(APP_DIR, 'index.html'));
+}
+/** Invite → the hub of its session. */
+const hubs = new Map();
+/** Makes an invite joinable on the listener. Returns the function that takes it off again. */
+export function offerInvite(token, hub) {
+    hubs.set(token, hub);
+    return () => void hubs.delete(token);
+}
+/** Invite → the page that offers it right now. */
+const pages = new Map();
+/** Invite → who waits for a page to offer it (waitForPage). */
+const pageWaiters = new Map();
+/** How long a page has to meet a guest that joined. */
+const MEET_TIMEOUT_MS = 10_000;
+/** How often a page's standing connection is pinged; one that misses a beat is closed. */
+const HEARTBEAT_MS = 30_000;
+/** True when the invite is joined on this listener: a page offers it here right now, or it is of an MCP session of this process. */
+export function joinedHere(token) {
+    return pages.has(token) || hubs.has(token);
+}
+/** Waits until a page offers the invite (a page finds the MCP again within seconds of its start). False after `timeoutMs`. */
+export function waitForPage(token, timeoutMs) {
+    if (pages.has(token))
+        return Promise.resolve(true);
+    return new Promise(resolve => {
+        let set = pageWaiters.get(token);
+        if (!set)
+            pageWaiters.set(token, (set = new Set()));
+        const waiters = set;
+        const done = () => {
+            clearTimeout(timer);
+            resolve(true);
+        };
+        const timer = setTimeout(() => {
+            waiters.delete(done);
+            if (!waiters.size)
+                pageWaiters.delete(token);
+            resolve(false);
+        }, timeoutMs);
+        waiters.add(done);
+    });
+}
+/** Closes a WebSocket that may be closing already. */
+const shut = (ws, code, reason) => {
+    try {
+        ws.close(code, reason);
+    }
+    catch {
+        /* already closing */
+    }
+};
+/** A page offers an invite: it stays joinable for as long as this connection lasts. */
+function offer(token, control) {
+    const page = { token, control, waiting: new Map(), joined: new Set() };
+    pages.set(token, page);
+    const waiters = pageWaiters.get(token);
+    if (waiters) {
+        pageWaiters.delete(token);
+        for (const done of waiters)
+            done();
+    }
+    // A page that went away without a word (a closed laptop) must not stay offered.
+    let alive = true;
+    control.on('pong', () => (alive = true));
+    const beat = setInterval(() => {
+        if (!alive)
+            return control.terminate();
+        alive = false;
+        control.ping();
+    }, HEARTBEAT_MS);
+    beat.unref();
+    const end = () => {
+        clearInterval(beat);
+        if (pages.get(token) === page)
+            pages.delete(token);
+        // The host is gone: so is its session, for everyone in it.
+        for (const { guest, timer } of page.waiting.values()) {
+            clearTimeout(timer);
+            shut(guest, 1001, 'the session is over');
+        }
+        page.waiting.clear();
+        for (const [guest, link] of page.joined) {
+            shut(guest, 1001, 'the session is over');
+            shut(link, 1001, 'the session is over');
+        }
+        page.joined.clear();
+    };
+    control.on('close', end);
+    control.on('error', end);
+}
+/** A guest joined a page's session: the page is told, and has a moment to meet it. */
+function knock(page, guest) {
+    const id = randomUUID();
+    const early = [];
+    const buffer = (data, isBinary) => void early.push({ data, isBinary });
+    guest.on('message', buffer);
+    const timer = setTimeout(() => {
+        page.waiting.delete(id);
+        shut(guest, 1011, 'the host did not answer');
+    }, MEET_TIMEOUT_MS);
+    page.waiting.set(id, { guest, early, buffer, timer });
+    guest.on('close', () => {
+        if (page.waiting.delete(id))
+            clearTimeout(timer);
+    });
+    page.control.send(JSON.stringify({ relay: 'guest', guest: id }));
+}
+/** The page's connection for one guest: from here on the two talk to each other. */
+function meet(page, id, link) {
+    const waiting = page.waiting.get(id);
+    if (!waiting)
+        return shut(link, 1008, 'nobody is waiting');
+    page.waiting.delete(id);
+    clearTimeout(waiting.timer);
+    const { guest, early, buffer } = waiting;
+    const pair = [guest, link];
+    page.joined.add(pair);
+    guest.off('message', buffer);
+    for (const m of early)
+        link.send(m.data, { binary: m.isBinary });
+    guest.on('message', (data, isBinary) => {
+        if (link.readyState === link.OPEN)
+            link.send(data, { binary: isBinary });
+    });
+    link.on('message', (data, isBinary) => {
+        if (guest.readyState === guest.OPEN)
+            guest.send(data, { binary: isBinary });
+    });
+    const end = () => {
+        if (!page.joined.delete(pair))
+            return;
+        shut(guest, 1000, '');
+        shut(link, 1000, '');
+    };
+    for (const ws of pair) {
+        ws.on('close', end);
+        ws.on('error', end);
+    }
+}
+/** How many apps are in a session here: docked into the MCP's own, or hosting one of theirs. */
+export function dockedApps() {
+    let n = pages.size;
+    for (const hub of new Set(hubs.values()))
+        n += hub.guests;
+    return n;
+}
+/** How many pages offer a session of their own here. While one does, somebody may be about to join it. */
+export function offeringPages() {
+    return pages.size;
+}
+/** The one listener of this process, once somebody asked for it. */
+let listener = null;
+/** Every WebSocket that came in: guests, pages, and the connections pages meet their guests on. */
+let sockets = null;
+/**
+ * Stops the listener (the process is shutting down). Every WebSocket is ended
+ * with it: a page that offers a session keeps its connection open for as long
+ * as it can, and a server waits for its connections before it is closed.
+ */
+export async function closeListener() {
+    const running = listener;
+    listener = null;
+    if (!running)
+        return;
+    try {
+        const { server } = await running;
+        for (const ws of sockets?.clients ?? [])
+            ws.terminate();
+        sockets = null;
+        pages.clear();
+        server.closeAllConnections?.();
+        await new Promise(resolve => server.close(() => resolve()));
+    }
+    catch {
+        /* never started */
+    }
+}
+/** Starts the listener (once per process) and returns its port. */
+export function listen() {
+    listener ??= new Promise((resolve, reject) => {
+        const server = createServer((req, res) => {
+            try {
+                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 wss = new WebSocketServer({ noServer: true, maxPayload: 256 * 1024 * 1024 });
+        sockets = wss;
+        server.on('upgrade', (req, socket, head) => {
+            upgrade(req, socket).then(to => {
+                if (!to)
+                    return;
+                wss.handleUpgrade(req, socket, head, ws => {
+                    if (to.as === 'guest')
+                        to.hub.join(ws, to.token);
+                    else if (to.as === 'visitor')
+                        knock(to.page, ws);
+                    else if (to.as === 'page')
+                        offer(to.token, ws);
+                    else
+                        meet(to.page, to.guest, ws);
+                });
+            }, () => refuse(socket, 500, 'error'));
+        });
+        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;
+}
+/** True when the request names this listener as its host: not a page of another site reaching in by a name of its own (DNS rebinding). */
+const ownHost = (req) => {
+    const port = req.socket.localPort ?? 0;
+    return req.headers.host === `127.0.0.1:${port}` || req.headers.host === `localhost:${port}`;
+};
+/** Ends a WebSocket handshake with an HTTP status: the client sees a failed connection. */
+function refuse(socket, status, reason) {
+    socket.end(`HTTP/1.1 ${status} ${reason}\r\nConnection: close\r\nContent-Length: 0\r\n\r\n`);
+}
+/** Decides whether a WebSocket may come in, and as what. */
+async function upgrade(req, socket) {
+    const port = req.socket.localPort ?? 0;
+    if (!ownHost(req))
+        return refuse(socket, 403, 'Forbidden'), null;
+    const url = new URL(req.url ?? '/', `http://127.0.0.1:${port}`);
+    if (url.pathname.replace(/\/+$/, '') !== SESSION_PATH)
+        return refuse(socket, 404, 'Not Found'), null;
+    // A page that hosts its own session: offering an invite, or meeting a guest who joined with it.
+    const hosted = url.searchParams.get('host');
+    if (hosted) {
+        const guest = url.searchParams.get('guest');
+        const page = pages.get(hosted);
+        if (guest)
+            return page?.waiting.has(guest) ? { as: 'meeting', page, guest } : (refuse(socket, 404, 'Not Found'), null);
+        // An invite is offered once; the MCP's own invites are not a page's to offer.
+        if (page || hubs.has(hosted) || !/^[A-Za-z0-9_-]{16,128}$/.test(hosted))
+            return refuse(socket, 409, 'Conflict'), null;
+        return { as: 'page', token: hosted };
+    }
+    // A guest. A server takes the invite as a query parameter (browsers) or as a header (programs).
+    const header = req.headers['classcad-invite'];
+    const token = url.searchParams.get('invite') ?? (Array.isArray(header) ? header[0] : header) ?? '';
+    const hub = hubs.get(token);
+    if (hub) {
+        // The engine behind the session is the signed-in machine's.
+        if (!(await authStatus()).signedIn)
+            return refuse(socket, 401, 'Unauthorized'), null;
+        return { as: 'guest', hub, token };
+    }
+    const page = pages.get(token);
+    if (page)
+        return { as: 'visitor', page };
+    // Like a server: no invite, no session — the handshake just fails.
+    return refuse(socket, 403, 'Forbidden'), null;
+}
+/** On every answer: no type sniffing, and the link (it carries the invite) is never sent on as a referrer. */
+const SAFE_HEADERS = { 'x-content-type-options': 'nosniff', 'referrer-policy': 'no-referrer' };
+/** HTTP: the app's page (only with an invite) and its files. */
+function handle(req, res) {
+    const port = req.socket.localPort ?? 0;
+    // Only this listener's own address: no DNS rebinding, no other sites' pages.
+    if (!ownHost(req))
+        return text(res, 403, 'forbidden');
+    if (req.method !== 'GET' && req.method !== 'HEAD')
+        return text(res, 405, 'method not allowed');
+    const url = new URL(req.url ?? '/', `http://127.0.0.1:${port}`);
+    const path = decodeURIComponent(url.pathname);
+    const files = loadAssets();
+    if (path === '/' || path === '/index.html') {
+        const page = files.get('index.html');
+        if (!page)
+            return text(res, 404, 'This build of the ClassCAD MCP carries no app.');
+        // The app without an invite would host a session of its own, and there is none to host here.
+        if (!url.searchParams.get('invite'))
+            return text(res, 404, 'Open the link your agent gave you: it carries the invite to its session.');
+        res.writeHead(200, {
+            ...SAFE_HEADERS,
+            'content-type': page.type,
+            'cache-control': 'no-store',
+            // The app's own files, and WebSockets to this listener only. Styles are set from scripts (styled-components, antd).
+            'content-security-policy': `default-src 'self'; script-src 'self' 'wasm-unsafe-eval' blob:; worker-src 'self' blob:; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; font-src 'self' data:; connect-src 'self' ws://127.0.0.1:${port} ws://localhost:${port} data: blob:; frame-ancestors 'none'; base-uri 'none'; form-action 'none'`,
+        });
+        return void res.end(req.method === 'HEAD' ? undefined : page.body);
+    }
+    const asset = files.get(path.replace(/^\/+/, ''));
+    if (!asset || path.endsWith('index.html'))
+        return text(res, 404, 'not found');
+    const zipped = asset.gzip && /\bgzip\b/.test(String(req.headers['accept-encoding'] ?? ''));
+    res.writeHead(200, {
+        ...SAFE_HEADERS,
+        'content-type': asset.type,
+        // Built files carry a hash in their name: they never change.
+        'cache-control': path.startsWith('/assets/') ? 'public, max-age=31536000, immutable' : 'no-cache',
+        ...(zipped ? { 'content-encoding': 'gzip', vary: 'accept-encoding' } : {}),
+    });
+    res.end(req.method === 'HEAD' ? undefined : zipped ? asset.gzip : asset.body);
+}
+/** A plain-text answer. */
+function text(res, status, body) {
+    res.writeHead(status, { ...SAFE_HEADERS, 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store' });
+    res.end(body);
+}
+//# sourceMappingURL=server.js.map

package/dist/share/server.js.map

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

package/dist/share/session.d.ts

@@ -0,0 +1,120 @@
+import type { Client } from '../client.js';
+import { type ClientIdentity, type Peer, type SelectionItem, type SelectTarget } from './protocol.js';
+/**
+ * How a session's app reaches the user:
+ *   browser  the MCP opens it in the user's default browser, with the first model
+ *   host     the host has a browser pane of its own, next to the conversation (the Claude desktop
+ *            app): the agent is told to open the link there, and nothing is opened from here
+ *   off      nothing is opened; the agent hands over the link
+ */
+export type Show = 'browser' | 'host' | 'off';
+/** What the environment says about it: CLASSCAD_VIEWER_OPEN (browser | host | 0), else by the host that started the MCP. */
+export declare function showFromEnv(env?: NodeJS.ProcessEnv): Show;
+/**
+ * When a session gets a link that works beyond its machine (CLASSCAD_SHARE), where a relay is there to share it on:
+ *   always  from its first model on (the default): the app's link IS that link, wherever the relay holds the
+ *           session — one link, which the user opens and may send on. A relay that cannot be reached, or that
+ *           goes away, leaves the link of this machine: the app is offered under that one instead.
+ *   ask     when the user asks for one (the `share` tool): the app's link is this machine's, the other a second one
+ *   off     never
+ * Whichever it is, the session does not depend on the relay: the listener on this machine is always there.
+ */
+export type Sharing = 'ask' | 'always' | 'off';
+/** What the environment says about it. Without a relay there is nothing to share on. */
+export declare function sharingFromEnv(env?: NodeJS.ProcessEnv): Sharing;
+/** A session's link for everybody else: whether the relay holds it right now, and why not. */
+export type Shared = {
+    url: string;
+    live: boolean;
+    problem: string | null;
+};
+/**
+ * The app, offered to the user — once per session: its link, and how it got to them or should.
+ * `shared`: the link is the session's share link (it works from anywhere); else it is this machine's.
+ * `fallback`: offered again, on this machine, because the share link it was offered under stopped working.
+ */
+export type Offer = {
+    url: string;
+    how: 'opened' | 'host' | 'link';
+    shared?: true;
+    fallback?: true;
+};
+/** What a session's sharing is opened with. */
+export type ShareOptions = {
+    /** The session's engine client. */
+    client: Client;
+    /** Runs work in the session's tool queue. */
+    queue: <T>(work: () => Promise<T>) => Promise<T>;
+    /** Offer the app's link (this build must carry the app). */
+    app: boolean;
+    /** How the app reaches the user. */
+    show: Show;
+    /** When the session gets a link for everybody else. Default: what the environment says. */
+    sharing?: Sharing;
+    /** Who this session is, for the others: asked whenever it is published (the host's name is known late). */
+    identity: () => ClientIdentity;
+    log?: (msg: string) => void;
+};
+/** What one participant has selected. `total` counts all of it; `items` may be cut to what fits a presence frame. */
+export type PeerSelection = {
+    peer: Peer;
+    items: SelectionItem[];
+    total: number;
+};
+/** A session's company, as its tools use it. */
+export type Share = {
+    /** The link that docks the app into this session on this machine; null when this build carries no app or the listener did not start. */
+    readonly url: string | null;
+    /** The link the app is offered under right now: the share link where every session is shared and the relay holds this one, else `url`. */
+    readonly appUrl: string | null;
+    /** False while this session is a guest in somebody else's (use_session with an invite): theirs is the app the user has open. */
+    readonly hosting: boolean;
+    /** How the app reaches the user. */
+    readonly show: Show;
+    /** When the session gets a link for everybody else. */
+    readonly sharing: Sharing;
+    /** The link that docks the app into this session from anywhere, while the relay holds it; null otherwise. */
+    readonly sharedUrl: string | null;
+    /**
+     * Shares the session beyond this machine: an invite of its own, offered on
+     * the relay. Whoever opens the link is in the session like the user at the
+     * app. Shared already: the same link. Waits `patience` ms at most for the
+     * relay; one that does not take the offer by then (`live: false`, with the
+     * reason) is asked again in the background until it does — nothing fails,
+     * the session just is not shared yet. Rejects only where a session cannot be
+     * shared at all (no relay, somebody else's session).
+     */
+    publish: (patience?: number) => Promise<Shared>;
+    /** Where every session is shared: starts offering this one, without waiting for it. For the moment before the first model. */
+    warm: () => void;
+    /** Takes the shared link back: it stops working, and whoever joined with it is disconnected (`kicked`). Null when the session was not shared. */
+    unpublish: () => {
+        kicked: number;
+    } | null;
+    /** Opens the app in the user's default browser now (`link`: under that link; default `appUrl`). False where there is no browser to open. */
+    open: (link?: string) => boolean;
+    /**
+     * A tool ran that may have changed the model or the engine. With the first
+     * model of a session the app is offered, once: the answer says how (and in
+     * `browser` mode it has been opened by then). Null every other time.
+     */
+    touch: () => Promise<Offer | null>;
+    /** The agent was handed `link` some other way (`view`): the app is not offered again. */
+    offered: (link?: string) => void;
+    /** How many apps are in the session (agents not counted): somebody has it open. */
+    docked: () => number;
+    /** Everyone else in the session, as far as this session knows. */
+    peers: () => Peer[];
+    /** What the others have selected: one entry per participant that shares its selection. */
+    selections: () => PeerSelection[];
+    /** Asks the others to select `items`, and returns what they have selected a moment later. */
+    select: (items: SelectTarget[], replace?: boolean) => Promise<PeerSelection[]>;
+    /** The session is over: the link stops working, docked apps are told. */
+    close: () => void;
+};
+/**
+ * Opens a session's sharing: its hub, the app's invite on the listener, and an
+ * ear for whoever is in the session. Nothing is started: the engine comes up
+ * with the first tool call, or with the first guest.
+ */
+export declare function openShare(opts: ShareOptions): Promise<Share>;