@classcad/mcp 0.1.0

package/dist/tools/bridge.js

@@ -0,0 +1,115 @@
+// Bridge tools: route requests to a CC app's bridge connection.
+//
+// All tools are scoped by the share token the cc MCP is currently attached
+// with (use_session: an invite for a server session, or a bridge token for
+// an in-app engine). If no app has connected a bridge for that token, tools
+// return a clean "no bridge connected" error and the user can keep using the
+// rest of the cc MCP unaffected.
+import { z } from 'zod';
+function noBridgeError(sessionId) {
+    return {
+        isError: true,
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    ok: false,
+                    error: 'no bridge connected',
+                    sessionId,
+                    hint: sessionId
+                        ? `No CC app has registered a bridge for token "${sessionId}". Create the share in the app (Session Management) and start the app with the bridge enabled (e.g. ?mcpBridge=on).`
+                        : 'No shared session is attached. Call use_session with the app\'s share link first, then try again.',
+                }),
+            }],
+    };
+}
+function pickConn(client, registry, clientId) {
+    // The token the MCP joined with (invite or bridge) selects the app.
+    const sid = client.shareToken;
+    if (!sid)
+        return { conn: null, sid: null };
+    return { conn: registry.pick(sid, clientId), sid };
+}
+export function registerBridgeTools(server, client, registry) {
+    server.registerTool('bridge.list_clients', {
+        title: 'List bridge clients',
+        description: 'List CC apps that have opened a bridge connection for the share token the MCP is attached with (use_session with an app share link; both ?invite= and ?bridge= links). Returns connection metadata and capabilities (engine.execute = the app hosts the engine). Empty list = no bridge available; the cc MCP still works for ClassCAD-only operations.',
+        inputSchema: {},
+    }, async () => {
+        const sid = client.shareToken;
+        const clients = registry.list(sid ?? undefined).map(c => ({
+            clientId: c.clientId,
+            token: c.token,
+            kind: c.kind,
+            drawingId: c.drawingId,
+            app: c.app,
+            appVersion: c.appVersion,
+            capabilities: c.capabilities,
+            protocolVersion: c.protocolVersion,
+            announcedAt: c.announcedAt,
+        }));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ shareToken: sid, transport: client.transport, count: clients.length, clients, bridgeUrl: registry.url }),
+                }],
+        };
+    });
+    server.registerTool('bridge.get_selection', {
+        title: 'Get app selection',
+        description: 'Return the currently selected entities in the connected CC app. Each entity carries both a high-level kind/position/normal AND the raw {containerId, graphicId, prodRefId} triplet — pass `raw.graphicId` straight into ClassCAD APIs like v1.sketch.create({planeId: ...}).\n\n' +
+            'STALENESS WARNING — the `raw.containerId` reflects the part\'s brep container at the time of the pick. Once any feature mutation (fillet, chamfer, boolean, extrusion, ...) creates a new solid, the part\'s active container id rotates (it tracks `inspect(partId).solids[0]`). Reusing an older containerId in bridge.set_selection round-trips fine but mis-renders: the viewer highlights the wrong graphic or nothing. After any mutation, re-fetch via `inspect(partId).solids[0]` instead of trusting an older raw triplet.',
+        inputSchema: {
+            clientId: z.string().optional()
+                .describe('Specific bridge client id (from bridge.list_clients). Omit to use the most recently announced client for the session.'),
+            cached: z.boolean().optional()
+                .describe('If true, return the cached selection (updated by push events). If false (default), round-trip to the app.'),
+        },
+    }, async ({ clientId, cached }) => {
+        const { conn, sid } = pickConn(client, registry, clientId);
+        if (!conn)
+            return noBridgeError(sid);
+        try {
+            const items = cached && conn.cachedSelection
+                ? conn.cachedSelection
+                : await conn.request('selection.get');
+            return { content: [{ type: 'text', text: JSON.stringify({ ok: true, count: items.length, items }) }] };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify({ ok: false, error: msg }) }] };
+        }
+    });
+    server.registerTool('bridge.set_selection', {
+        title: 'Set app selection',
+        description: "Set the CC app's current selection. Each item is the raw {containerId, graphicId, prodRefId} triplet. The app highlights these entities in its UI.\n\n" +
+            'CRITICAL — `containerId` must be the part\'s **current** brep container id, i.e. `inspect(partId).solids[0]` at call time. Each feature that creates a new solid (fillet, chamfer, boolean, extrusion, ...) rotates the part\'s `solids[0]` to a new id, and the bridge\'s canonical containerId rotates with it. Do NOT copy `containerId` from an earlier bridge.get_selection / bridge.pick if any feature has run since — old containerIds round-trip without error but mis-render in the viewer (the bridge accepts the triplet, but graphicIds created by later features do not exist in the old container, and the viewer either highlights the wrong graphic or nothing).\n\n' +
+            'Construction recipe from API state alone:\n' +
+            '  • containerId = `inspect(partId).solids[0]` (re-fetch every time, do not cache across mutations)\n' +
+            '  • graphicId = brep element id (from `getBrepGeometryByIndex` / `getGeometryIds`)\n' +
+            '  • prodRefId = the value echoed by a recent bridge.get_selection / bridge.pick on the same part (this differs from the part id when the part is instanced through an assembly — copy it from a pick rather than guessing).',
+        inputSchema: {
+            items: z.array(z.object({
+                containerId: z.number(),
+                graphicId: z.number(),
+                prodRefId: z.number(),
+            })).describe('Entities to select.'),
+            replace: z.boolean().optional()
+                .describe('If true (default), replace current selection. If false, add to it.'),
+            clientId: z.string().optional(),
+        },
+    }, async ({ items, replace, clientId }) => {
+        const { conn, sid } = pickConn(client, registry, clientId);
+        if (!conn)
+            return noBridgeError(sid);
+        try {
+            const params = { items, replace: replace !== false };
+            await conn.request('selection.set', params);
+            return { content: [{ type: 'text', text: JSON.stringify({ ok: true, count: items.length }) }] };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify({ ok: false, error: msg }) }] };
+        }
+    });
+}
+//# sourceMappingURL=bridge.js.map

package/dist/tools/bridge.js.map

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

package/dist/tools/docs.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Daemon lifecycle for agents. Shared by the instructions and session_info:
+ * hosts may cut long instructions, a tool description always arrives.
+ */
+export declare const DAEMON_NOTE: string;
+/**
+ * Server instructions for the MCP initialize handshake — hosts put this into
+ * the agent's context, so it knows the FULL method surface from turn one
+ * (mirrors the method index buerli-ai injects into its system prompt).
+ */
+export declare function serverInstructions(): string;
+export declare function registerDocsTools(server: McpServer): void;

package/dist/tools/docs.js

@@ -0,0 +1,180 @@
+// Discovery tools: list_methods, describe_method — thin MCP wrappers around the
+// shared @classcad/skill/discovery module (the SAME search/describe logic as
+// buerli-ai): CAD-synonym-expanded ranked search, fuzzy method resolution, and
+// whole-document serving (skill bundle + @classcad/script data-contract docs).
+//
+// Dev override: with CLASSCAD_SKILL_PATH set, docs are read live from that
+// skill checkout instead of the built bundle — edits show up without a rebuild.
+import { z } from 'zod';
+import { existsSync, readFileSync } from 'fs';
+import { createRequire } from 'module';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { DEFAULT_DAEMON_PORT } from '../ports.js';
+import { RECIPES_POINTER, REFERENCE_IMAGE_POINTER } from '@classcad/skill/prompts';
+import { createDiscovery, DOCS_MAX_KEYS, DOCS_TOOL } from '@classcad/skill/discovery';
+import { docs as scriptDocs } from '@classcad/script/docs';
+// Loaded at runtime, NOT as static imports: tsc otherwise ingests the multi-MB
+// bundle.json as a literal type — observed to OOM the compiler on some setups.
+const requireJson = createRequire(import.meta.url);
+const registry = requireJson('@classcad/skill/method-registry.json');
+const bundle = requireJson('@classcad/skill/bundle.json');
+// Live-doc override (development): resolve doc keys against a skill checkout.
+function diskResolver() {
+    const override = process.env.CLASSCAD_SKILL_PATH;
+    const root = override ??
+        (() => {
+            try {
+                return dirname(createRequire(import.meta.url).resolve('@classcad/skill/package.json'));
+            }
+            catch {
+                return undefined;
+            }
+        })();
+    if (!override || !root)
+        return undefined; // no override → serve the built bundle
+    return (key) => {
+        const safe = key.replace(/[^a-zA-Z0-9/_-]/g, '');
+        // Keys map to files: references/<domain>/<method>.md, or top-level dirs for
+        // prefixed keys (recipes/<name>.md lives at the package root).
+        for (const c of [
+            join(root, 'references', `${safe}.md`),
+            join(root, `${safe}.md`),
+            join(root, 'references', `${safe.toUpperCase()}.md`),
+        ]) {
+            if (existsSync(c))
+                return readFileSync(c, 'utf8');
+        }
+        return null;
+    };
+}
+const discovery = createDiscovery({
+    registry: registry,
+    bundle: bundle,
+    extraDocs: scriptDocs,
+    resolveDoc: diskResolver(),
+});
+/** This install's CLI, so agents get a command that runs as written. */
+const CLI = `node "${fileURLToPath(new URL('../server.js', import.meta.url))}"`;
+/**
+ * Daemon lifecycle for agents. Shared by the instructions and session_info:
+ * hosts may cut long instructions, a tool description always arrives.
+ */
+export const DAEMON_NOTE = `DAEMON: every tab of this MCP is a session in ONE shared daemon process per machine (127.0.0.1:${DEFAULT_DAEMON_PORT}); it exits a minute after its last session. ` +
+    'Rebuilt MCP/renderer code only runs in a new daemon — an idle one is replaced automatically. Shell commands: ' +
+    `\`${CLI} status\` (pid, build, sessions); ` +
+    `\`${CLI} stop\` (stops it only when no session is active); ` +
+    `\`${CLI} stop --force\` (terminates it NOW — every connected tab, this one included, loses its drawing: ask the user first. ` +
+    'Tabs reconnect to a fresh daemon on their next tool call; tabs started before this MCP version need a host restart). Never kill daemon processes by hand.';
+/**
+ * Server instructions for the MCP initialize handshake — hosts put this into
+ * the agent's context, so it knows the FULL method surface from turn one
+ * (mirrors the method index buerli-ai injects into its system prompt).
+ */
+export function serverInstructions() {
+    return [
+        'ClassCAD MCP. run_script is the ONLY way to execute API calls (JavaScript against the live CAD session; ' +
+            'state persists between scripts — follow-up scripts ATTACH via api.tree(), never part.create twice). ' +
+            'PLAN FIRST, THEN FETCH ONCE: decide the whole build, pick every method you will need from the index below, ' +
+            'then request ALL their docs in ONE docs([...]) call, recipes first — include "DATA" whenever a script reads api.tree()/api.graphic(). ' +
+            'A docs response is size-capped: keys listed under "NOT included yet" at its top must be requested in a follow-up call before building. ' +
+            RECIPES_POINTER +
+            ' After that, build in a FEW substantial staged scripts — ' +
+            'not one method per round. Verify with numbers (calculateMassProperties) and snapshot renders. ' +
+            'REFERENCE IMAGES: ' +
+            REFERENCE_IMAGE_POINTER,
+        '',
+        'ENGINES: the MCP runs on a ClassCAD worker (Drogon server), inside a buerli app (share link with ?bridge=), or on its OWN local ' +
+            'WASM engine (no server, no browser). A share link/URL decides by itself; otherwise use_session(engine="auto"|"drogon"|"wasm") — ' +
+            'auto = worker if reachable else local WASM; a worker that comes up later takes over while the local drawing is still empty (a modeled session stays put). ' +
+            '"use WASM / local / offline" → engine "wasm"; "my Drogon/ClassCAD server" → "drogon". ' +
+            'session_info shows what is in use.',
+        '',
+        DAEMON_NOTE,
+        '',
+        'Method Index (v1) — every method, one line. Pick directly from here; use docs([...]) for exact parameters ' +
+            'and trap notes, list_methods to filter. Never conclude an operation does not exist without checking this index:',
+        '',
+        discovery.methodIndex(),
+        '',
+        'Document Index — recipes (composed workflows) and guides (cross-cutting behavior), key — title. ' +
+            'Fetch with docs([...]); list_methods({ search }) also ranks these by topic:',
+        '',
+        discovery.docIndex(),
+    ].join('\n');
+}
+export function registerDocsTools(server) {
+    server.registerTool('list_methods', {
+        title: 'List API methods',
+        description: 'Search/list the v1.<domain>.<method> surface. `search` as a string: one BM25-ranked list over method name + summary (whole words), ' +
+            'CAD synonyms expanded (split→slice, hole→bore, round→fillet, …). `search` as an ARRAY with ONE CONCEPT PER ENTRY ' +
+            '(e.g. ["expression", "box", "fastened constraint", "mass properties"]): one group per entry, each ranked on its own, ' +
+            'so every concept gets its own top matches (a group note flags entries that are likely workflows, not methods). ' +
+            'PLUS `docs`: the recipes/guides whose title, headings or text match (e.g. "shared parameters assembly" → ' +
+            'recipes/assembly-parameters) — search by what you want to build, then fetch those docs. ' +
+            'Without `search`: the full method listing plus `documents` (every recipe and guide, key — title). ' +
+            'withSummaries=false returns bare names (token-cheap). ' +
+            'A no-hit result does NOT mean the operation is missing — browse the domain instead.',
+        inputSchema: {
+            domain: z
+                .enum(['assembly', 'common', 'curve', 'drawing2d', 'part', 'sketch', 'solid'])
+                .optional()
+                .describe('Restrict to one domain.'),
+            search: z
+                .union([z.string(), z.array(z.string())])
+                .optional()
+                .describe('Keyword(s) to rank against name + summary (case-insensitive, synonyms expanded). Array = one group per entry — put one concept in each.'),
+            withSummaries: z.boolean().optional().describe('Include one-line summaries (default true).'),
+            limit: z.number().int().min(1).max(300).optional().describe('Max ranked results: total for a string search (default 25), per group for an array (default 8).'),
+        },
+    }, async ({ domain, search, withSummaries, limit }) => {
+        const result = discovery.searchMethods({ domain, search, withSummaries, limit });
+        const hasSearch = search != null && (Array.isArray(search) ? search.length > 0 : String(search).trim() !== '');
+        const docs = hasSearch ? discovery.searchDocs({ search }) : null;
+        const payload = hasSearch
+            ? docs && docs.count > 0
+                ? { ...result, docs: docs.docs, docsNote: docs.note }
+                : result
+            : domain
+                ? result
+                : { ...result, documents: discovery.docIndex().split('\n') };
+        return { content: [{ type: 'text', text: JSON.stringify(payload) }] };
+    });
+    // Bulk documentation — the PRIMARY doc tool. Contract AND implementation are
+    // the shared single source in @classcad/skill/discovery (DOCS_TOOL/bulkDocs);
+    // buerli-ai registers the identical tool from the same source.
+    server.registerTool(DOCS_TOOL.name, {
+        title: 'Fetch documentation (bulk)',
+        description: DOCS_TOOL.description,
+        inputSchema: {
+            keys: z
+                .array(z.string())
+                .min(1)
+                .max(DOCS_MAX_KEYS)
+                .describe('Documentation keys, e.g. ["DATA", "v1.part.extrusion", "v1.part.chamfer", "recipes/parametric-part"].'),
+        },
+    }, async ({ keys }) => {
+        const res = await discovery.bulkDocs(keys);
+        return { content: [{ type: 'text', text: res.text }] };
+    });
+    server.registerTool('describe_method', {
+        title: 'Describe API method',
+        description: 'Full documentation for ONE key — prefer docs([...]) to fetch everything you need in a single round; ' +
+            'use this only for a single follow-up lookup. Accepts full ("v1.part.box") or bare ("box") names — ' +
+            'ambiguous bare names list the candidates. Also serves whole documents ("DATA", "api/part", ' +
+            '"recipes/parametric-part"). Same size cap and paging as docs: a large document answers with page 1 and ' +
+            'names the next page ("api/part#2").',
+        inputSchema: {
+            method: z
+                .string()
+                .describe('Method name ("v1.part.box", "box"), topic doc ("DATA") or recipe ("recipes/constrained-sketching", "recipes/parametric-part").'),
+        },
+    }, async ({ method }) => {
+        const res = await discovery.bulkDocs([method]);
+        if (res.found.length === 0) {
+            return { isError: true, content: [{ type: 'text', text: res.text }] };
+        }
+        return { content: [{ type: 'text', text: res.text }] };
+    });
+}
+//# sourceMappingURL=docs.js.map

package/dist/tools/docs.js.map

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

package/dist/tools/lifecycle.d.ts

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

package/dist/tools/lifecycle.js

@@ -0,0 +1,156 @@
+// Lifecycle tools: clear, save, load.
+import { z } from 'zod';
+export function registerLifecycleTools(server, client) {
+    server.registerTool('clear', {
+        title: 'Clear drawing',
+        description: 'Delete all objects in the current drawing. Wraps v1.common.clear.',
+        inputSchema: {
+            keepIds: z.array(z.union([z.string(), z.number()])).optional()
+                .describe('Object IDs to preserve. Omit to wipe everything.'),
+        },
+    }, async ({ keepIds }) => {
+        const arg = keepIds ? { keepIds } : {};
+        const r = await client.execute({ 'v1.common.clear': [arg] });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ ok: r.maxLevel <= 31, maxLevel: r.maxLevel, messages: r.messages }),
+                }],
+        };
+    });
+    server.registerTool('save', {
+        title: 'Save drawing',
+        description: 'Serialize the current drawing. Returns base64-encoded content. Formats: STP (STEP), STL, JSON. (OFB export is not available in this release.)',
+        inputSchema: {
+            format: z.enum(['STP', 'STL', 'JSON']).describe('Output format.'),
+        },
+    }, async ({ format }) => {
+        const args = { format, encoding: 'base64' };
+        if (format === 'STP')
+            args.stp = { version: 2 };
+        if (format === 'STL')
+            args.stl = { binary: true, facetingTol: 0.1, angleTol: 6 };
+        const r = await client.execute({
+            'v1.common.save': [args],
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        format,
+                        success: r.result?.success ?? false,
+                        bytes: r.result?.content ? Buffer.from(r.result.content, 'base64').length : 0,
+                        content: r.result?.content ?? null,
+                        maxLevel: r.maxLevel,
+                    }),
+                }],
+        };
+    });
+    server.registerTool('load', {
+        title: 'Load drawing',
+        description: 'Load a previously saved drawing from base64-encoded content. Format must match what save produced.',
+        inputSchema: {
+            format: z.enum(['OFB', 'STP', 'STL', 'JSON']).describe('Input format.'),
+            content: z.string().describe('Base64-encoded payload.'),
+        },
+    }, async ({ format, content }) => {
+        // NOTE: the engine's load parameter is `data` (a prior save's payload) —
+        // `content` is silently ignored (error 1004 "Either data, file or url…").
+        const r = await client.execute({
+            'v1.common.load': [{ format, encoding: 'base64', data: content, doClear: 1 }],
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ ok: r.maxLevel <= 31, maxLevel: r.maxLevel, messages: r.messages }),
+                }],
+        };
+    });
+    // ── checkpoint / restore — cheap rollback (same semantics as buerli-ai) ─────
+    // A failed multi-feature attempt leaves half-built features and consumed
+    // bodies behind; recovering by delete-archaeology is error-prone. checkpoint
+    // = in-memory OFB save held in THIS server process (never enters the model
+    // context), restore = clear + reload. Keyed per reconnect generation — a
+    // use_session switch invalidates checkpoints from the previous session.
+    const MAX_CHECKPOINTS = 5;
+    const checkpoints = new Map();
+    let checkpointGen = -1;
+    function bucket() {
+        if (checkpointGen !== client.generation) {
+            checkpoints.clear();
+            checkpointGen = client.generation;
+        }
+        return checkpoints;
+    }
+    server.registerTool('checkpoint', {
+        title: 'Checkpoint drawing',
+        description: 'Save the WHOLE drawing state under a label (in-memory, server-side — cheap and instant). ' +
+            'Use BEFORE risky sequences (large booleans, trims, experiments): if the attempt goes wrong, ' +
+            'restore({label}) brings the drawing back exactly instead of delete-archaeology. ' +
+            'Re-using a label overwrites it; at most 5 checkpoints are kept (oldest dropped). ' +
+            'Checkpoints die with the server process and with a use_session switch.',
+        inputSchema: {
+            label: z.string().optional().describe('Checkpoint name, e.g. "before-boolean". Default "checkpoint".'),
+        },
+    }, async ({ label }) => {
+        const name = (label || 'checkpoint').trim().slice(0, 60) || 'checkpoint';
+        // The one OFB save this release makes: held in this process, never returned.
+        const r = await client.execute({
+            'v1.common.save': [{ format: 'OFB', encoding: 'base64' }],
+        }, { internalOfb: true });
+        if (!r.result?.content) {
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify({ error: 'Checkpoint failed: the engine returned no OFB data.', maxLevel: r.maxLevel }) }] };
+        }
+        const m = bucket();
+        m.delete(name);
+        m.set(name, { data: r.result.content, createdAt: Date.now() });
+        while (m.size > MAX_CHECKPOINTS) {
+            const oldest = m.keys().next().value;
+            m.delete(oldest);
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        label: name,
+                        size: Math.floor((r.result.content.length * 3) / 4),
+                        stored: [...m.keys()],
+                        note: `Drawing state saved server-side. restore({ label: "${name}" }) brings it back exactly.`,
+                    }),
+                }],
+        };
+    });
+    server.registerTool('restore', {
+        title: 'Restore checkpoint',
+        description: 'Replace the drawing with a previously checkpointed state (clear + reload). Without a label, ' +
+            'the MOST RECENT checkpoint is restored. All ids from after the checkpoint are stale afterwards — ' +
+            're-read them (tree/find) before further operations.',
+        inputSchema: {
+            label: z.string().optional().describe('Checkpoint name. Default: the most recently created one.'),
+        },
+    }, async ({ label }) => {
+        const m = bucket();
+        if (m.size === 0) {
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify({ error: 'No checkpoints exist for this session. Create one with checkpoint first.' }) }] };
+        }
+        const name = (label && label.trim()) ||
+            [...m.entries()].sort((a, b) => b[1].createdAt - a[1].createdAt)[0][0];
+        const snap = m.get(name);
+        if (!snap) {
+            return { isError: true, content: [{ type: 'text', text: JSON.stringify({ error: `No checkpoint named "${name}".`, available: [...m.keys()] }) }] };
+        }
+        const r = await client.execute({ 'v1.common.load': [{ format: 'OFB', encoding: 'base64', data: snap.data, doClear: 1 }] });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        restored: name,
+                        ok: r.maxLevel <= 31,
+                        maxLevel: r.maxLevel,
+                        note: 'Drawing replaced with the checkpointed state. All ids from after the checkpoint are stale — re-read them (tree/find) before further operations.',
+                    }),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/tools/lifecycle.js.map

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

package/dist/tools/script.d.ts

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

package/dist/tools/script.js

@@ -0,0 +1,102 @@
+import { setDrawingBusy } from '../queue.js';
+// run_script — execute model-written JavaScript against the live session.
+//
+// Powered by @classcad/script: the same script medium as buerli-ai and
+// headless Node. Scripts using the guaranteed surface (api.v1.*,
+// api.tree(), api.graphic(), api.env) run unchanged in all of them.
+import { z } from 'zod';
+import { createRequire } from 'module';
+import { runScript, isSessionBusy } from '@classcad/script';
+// Runtime require — keeps the registry JSON out of tsc's type space (OOM risk).
+const REGISTRY = createRequire(import.meta.url)('@classcad/skill/method-registry.json');
+/**
+ * Adapt the MCP's WS client to the @classcad/script session contract. Tree and
+ * graphic come from the client's cached, pull-on-demand accessors; the
+ * emission config pair lets runScript suppress payloads for the duration of
+ * the script (and restore the connection's previous flags afterwards), so a
+ * 100-command script costs 100 small Results while the MCP's connection
+ * otherwise keeps the engine defaults - important when it is docked into a
+ * session shared with an interactive app.
+ */
+const sessions = new WeakMap();
+function sessionFor(client) {
+    const previous = sessions.get(client);
+    if (previous)
+        return previous;
+    const session = {
+        executionKey: client,
+        env: 'node',
+        execute: (task) => client.execute(task),
+        getTree: (o) => client.getTree(o),
+        getGraphic: (o) => client.getGraphic(o),
+        getEmissionConfig: () => client.getEmissionConfig(),
+        setEmissionConfig: (partial) => client.setEmissionConfig(partial),
+    };
+    sessions.set(client, session);
+    return session;
+}
+export function registerScriptTool(server, client) {
+    setDrawingBusy(server, () => isSessionBusy(sessionFor(client)));
+    server.registerTool('run_script', {
+        title: 'Run script',
+        description: 'Execute JavaScript against the CAD session — THE tool for any build involving computation, ' +
+            'repetition, or more than a handful of operations. The script runs as an async function body with:\n' +
+            '• api.v1.<domain>.<method>(params) — ClassCAD calls, await-able, → { result, maxLevel, messages }. ' +
+            'Typos throw immediately with suggestions. Strict: a call that ends at maxLevel ≥ 51 THROWS (the message carries ' +
+            'the engine error) — method docs describing "null/[] with maxLevel 51" are the non-script result; wrap intentional ' +
+            'probes (e.g. getGeometryIds where a miss is expected) in try/catch.\n' +
+            '• await api.tree({ refresh? }) — the structure tree (id → node): find parts, features, sketches by class/name. ' +
+            'Returns a Promise: without await, Object.values(api.tree()) is silently [] (looks like an empty drawing).\n' +
+            '• await api.graphic({ recalc? }) — the graphic payload (containers with face meshes, edges, vertices): ' +
+            'find and FILTER GEOMETRY yourself — e.g. locate a bore wall by vertex radius, collect edge ids for a chamfer. ' +
+            'Exact shapes + selection idioms: describe_method("DATA").\n' +
+            '• Math, full JS (variables, loops, functions); console.log/log(...) captured and returned.\n' +
+            '• return <small summary> — results are size-capped; keep big data in the drawing, not the return value.\n' +
+            'Compute coordinates IN the script (trigonometry, loops) instead of inlining hand-evaluated numbers. ' +
+            'Pass recalc:false to api.graphic() in solid.*/entity-injection sessions (a recalc invalidates curve shape ids and can destroy injected bodies in complex cases). ' +
+            'No DOM/network/filesystem access; awaited work times out (default 60s). ' +
+            'Prefer several small verified scripts over one huge one — STATE PERSISTS in the drawing between ' +
+            'scripts: a follow-up script ATTACHES to the existing model (re-discover via await api.tree(); tree ids' +
+            'are stable; NEVER part.create when a part already exists). Even a single operation is a run_script.',
+        inputSchema: {
+            script: z
+                .string()
+                .describe('JavaScript source. Executed as an async function body — use await directly, return a (small) summary value.'),
+            label: z.string().optional().describe('Short label describing what this script does.'),
+            timeoutMs: z.number().int().min(1000).max(300000).optional().describe('Timeout for awaited work in ms (default 60000).'),
+        },
+    }, async ({ script, timeoutMs }, extra) => {
+        let operationCount = 0;
+        const session = sessionFor(client);
+        const res = await runScript(script, session, { registry: REGISTRY, timeoutMs, strict: true, signal: extra.signal,
+            onOperation: event => {
+                if (extra._meta?.progressToken !== undefined && event.phase === 'start') {
+                    void extra.sendNotification({ method: 'notifications/progress', params: {
+                            progressToken: extra._meta.progressToken, progress: ++operationCount,
+                            message: `${event.method}${event.name ? ': ' + event.name : ''}`,
+                        } }).catch(() => { });
+                }
+            },
+        });
+        // The script ran with payloads suppressed and the connection's flags
+        // are restored again. One GetTree now: its Result carries the full
+        // structure and graphic, refreshes our caches, and - broadcast by the
+        // server - brings a shared session's other clients up to date with
+        // everything the script changed while they received nothing.
+        try {
+            if (!isSessionBusy(session))
+                await client.pull();
+        }
+        catch {
+            /* the tools pull again on demand */
+        }
+        if (!res.ok) {
+            const tail = res.logs.length ? `\nConsole output before the error:\n${res.logs.slice(-20).join('\n')}` : '';
+            return { content: [{ type: 'text', text: `${res.error}${tail}` }], isError: true };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ returned: res.returned, logs: res.logs }) }],
+        };
+    });
+}
+//# sourceMappingURL=script.js.map

package/dist/tools/script.js.map

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

package/dist/tools/snapshot.d.ts

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