@mlightcad/cad-mcp-server 0.0.0-stage → 1.7.8-preview.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mlightcad
+
+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/README.md

@@ -1,3 +1,147 @@
-# Temporary Holding Version
+# @mlightcad/cad-mcp-server
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+stdio [Model Context Protocol](https://modelcontextprotocol.io) server that lets
+third-party agents (Claude Code, Cursor, Codex, …) drive CAD drawings through
+the same **script-first** API as the in-app CAD Agent.
+
+## Why scripts, not hundreds of tools?
+
+MCP is a great way to connect agents to CAD. It is a poor place to re-export
+every drawing primitive as its own tool. A catalog of `draw_line`,
+`draw_circle`, `set_entity_layer`, … never finishes, burns tokens on every
+request, and still cannot cover one-off analysis (“find bolt-hole outliers by
+layer and report them”).
+
+This server follows the design in
+[Building a CAD Agent: MCP, Tools, or Let AI Write Code?](https://dev.to/mlightcad/building-a-cad-agent-mcp-tools-or-let-ai-write-code-2nc4):
+
+- **Tools** for clear lifecycle steps (open / blank drawing)
+- **Scripts** for combining the CAD API into analysis, edits, and verification
+
+The model writes a `cad.*` function body; the headless viewer runs it. Same
+runtime as the in-app CAD Agent (`@mlightcad/cad-agent-core`), so external
+agents (Claude Code, Cursor, Codex, …) get flexibility without a ballooning
+tool list — and with lower token and round-trip cost for bulk work.
+
+## Tools (intentionally small)
+
+| Tool | Purpose |
+| --- | --- |
+| `open_drawing` | Open a local/remote DXF/DWG, or omit `path` for a blank ISO template |
+| `execute_cad_script` | Run a `cad.*` JavaScript function body ([script API](https://mlightcad.github.io/cad-viewer/guide/script/overview.html)) |
+
+There are **no** per-entity `draw_line` / `draw_circle` tools. All drawing,
+queries, edits, and context live inside one script call.
+
+## Works with cad-simple-viewer and cad-viewer
+
+Both products share `AcApDocManager` from `@mlightcad/cad-simple-viewer`. This
+server’s headless runner boots that kernel (not the Vue UI package). Scripts
+you write for the Script panel or CAD Agent in either product are valid here,
+and the reverse is true.
+
+This package does **not** depend on `@mlightcad/cad-viewer`.
+
+## Requirements
+
+- Node.js ≥ 20
+- Chromium for Playwright (`pnpm --filter @mlightcad/cad-mcp-server install-browser`)
+
+## Install / run
+
+```bash
+pnpm --filter @mlightcad/cad-mcp-server build
+pnpm --filter @mlightcad/cad-mcp-server install-browser
+cad-mcp-server
+# or: node packages/cad-mcp-server/dist/cli.js
+```
+
+## MCP client config
+
+### Cursor (`.cursor/mcp.json`)
+
+Prefer `${workspaceFolder}` over a hardcoded absolute path or a bare
+relative path (MCP cwd is not always the repo root):
+
+```json
+{
+  "mcpServers": {
+    "cad": {
+      "command": "node",
+      "args": [
+        "${workspaceFolder}/packages/cad-mcp-server/dist/cli.js"
+      ]
+    }
+  }
+}
+```
+
+### Claude Code / Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "cad": {
+      "command": "npx",
+      "args": ["-y", "@mlightcad/cad-mcp-server"]
+    }
+  }
+}
+```
+
+(After the package is published; for local monorepo use the `node …/dist/cli.js` form.)
+
+## Typical flow
+
+1. `open_drawing` with `{ "path": "./plan.dxf", "mode": "write" }`  
+   (local path or http(s) URL; omit `path` to start blank).
+2. `execute_cad_script` with a function body:
+
+```js
+let id
+cad.edit.transaction('circle', tx => {
+  id = tx.drawCircle({ center: { x: 0, y: 0 }, radius: 100 })
+})
+cad.view.zoomExtents()
+return cad.measure.report([
+  cad.measure.check('r', 100, cad.measure.radius(id))
+])
+```
+
+`cad.view.capturePreview` is enabled; screenshots are returned as MCP image
+content.
+
+## Architecture
+
+```
+MCP client  --stdio-->  cad-mcp-server (Node)
+                           |
+                           | Playwright (lazy)
+                           v
+                     headless Chromium
+                     cad-simple-viewer + cad-agent-core
+                     createCadToolCatalog / execute_cad_script
+```
+
+The browser session stays alive for the process lifetime so drawing state
+persists across tool calls.
+
+## Library API
+
+```ts
+import {
+  createCadMcpServer,
+  registerCadMcpTools,
+  CadMcpSession
+} from '@mlightcad/cad-mcp-server'
+```
+
+`registerCadMcpTools` maps the same tool surface for a custom `McpServer`
+(e.g. a future in-page WebMCP host that already has `AcApDocManager`).
+
+## Related packages
+
+- `@mlightcad/cad-agent-core` — script host and tool catalog
+- `@mlightcad/cad-agent-plugin` — in-app chat agent
+- `@mlightcad/cad-script-plugin` — manual script console
+- `@mlightcad/cad-simple-viewer-cli` — AutoCAD `.scr` headless CLI (different script model)

package/dist/catalogTools.d.ts

@@ -0,0 +1,51 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+/**
+ * Input schema for `execute_cad_script`.
+ *
+ * Kept in sync with {@link createCadToolCatalog} in `@mlightcad/cad-agent-core`
+ * (`code` first so streaming providers do not finalize on `intent` alone).
+ */
+export declare const executeCadScriptInputSchema: {
+    code: z.ZodString;
+    intent: z.ZodOptional<z.ZodString>;
+};
+/**
+ * Input schema for MCP-only document lifecycle tool `open_drawing`.
+ */
+export declare const openDrawingInputSchema: {
+    path: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<["read", "write"]>>;
+};
+export interface RegisterCadMcpToolsOptions {
+    /**
+     * Opens a drawing (or blank template) in the CAD session.
+     */
+    openDrawing: (input: {
+        path?: string;
+        mode?: 'read' | 'write';
+    }) => Promise<{
+        ok: true;
+        title: string;
+        mode: 'read' | 'write';
+    }>;
+    /**
+     * Runs `execute_cad_script` against the live CadSession (typically in-page).
+     */
+    executeCadScript: (input: {
+        code: string;
+        intent?: string;
+    }) => Promise<unknown>;
+}
+/**
+ * Registers the script-first CAD tool surface on an MCP server.
+ *
+ * Tools:
+ * - `open_drawing` — document lifecycle (not part of agent-core catalog)
+ * - `execute_cad_script` — same catalog tool as the in-app CAD Agent / Script
+ *   panel on both cad-simple-viewer and cad-viewer hosts
+ *
+ * @param server - MCP server instance
+ * @param options - Session-backed executors
+ */
+export declare function registerCadMcpTools(server: McpServer, options: RegisterCadMcpToolsOptions): void;

package/dist/catalogTools.js

@@ -0,0 +1,104 @@
+import { CAD_SCRIPT_API_SUMMARY } from '@mlightcad/cad-agent-core/script-api';
+import { z } from 'zod';
+import { toolResultToMcpContent } from './toolResult.js';
+/**
+ * Input schema for `execute_cad_script`.
+ *
+ * Kept in sync with {@link createCadToolCatalog} in `@mlightcad/cad-agent-core`
+ * (`code` first so streaming providers do not finalize on `intent` alone).
+ */
+export const executeCadScriptInputSchema = {
+    code: z
+        .string()
+        .min(1)
+        .describe('JavaScript function body using cad.* (required). Prefer short scripts; for complex drawings use multiple calls.'),
+    intent: z
+        .string()
+        .max(200)
+        .optional()
+        .describe('Optional short label for the tool result. Never send intent alone — code is required. Prefer emitting code before intent.')
+};
+/**
+ * Input schema for MCP-only document lifecycle tool `open_drawing`.
+ */
+export const openDrawingInputSchema = {
+    path: z
+        .string()
+        .optional()
+        .describe('Local .dxf/.dwg path or http(s) URL. Omit to create a blank ISO template drawing.'),
+    mode: z
+        .enum(['read', 'write'])
+        .optional()
+        .describe('Open mode. Default: write when path is omitted, read when path is set. Use write to edit an existing file.')
+};
+/**
+ * Registers the script-first CAD tool surface on an MCP server.
+ *
+ * Tools:
+ * - `open_drawing` — document lifecycle (not part of agent-core catalog)
+ * - `execute_cad_script` — same catalog tool as the in-app CAD Agent / Script
+ *   panel on both cad-simple-viewer and cad-viewer hosts
+ *
+ * @param server - MCP server instance
+ * @param options - Session-backed executors
+ */
+export function registerCadMcpTools(server, options) {
+    // MCP SDK + zod generics often hit TS2589; register via a loose shim.
+    const register = server.registerTool.bind(server);
+    register('open_drawing', {
+        description: 'Open a DXF/DWG drawing (local path or http(s) URL), or omit path to create a blank ISO template. Call before editing an existing file. Drawing ops use execute_cad_script.',
+        inputSchema: openDrawingInputSchema
+    }, async (input) => {
+        try {
+            const result = await options.openDrawing({
+                path: input.path,
+                mode: input.mode
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            ok: false,
+                            error: error instanceof Error ? error.message : String(error)
+                        })
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    register('execute_cad_script', {
+        description: CAD_SCRIPT_API_SUMMARY,
+        inputSchema: executeCadScriptInputSchema
+    }, async (input) => {
+        try {
+            const raw = await options.executeCadScript({
+                code: input.code,
+                intent: input.intent
+            });
+            return toolResultToMcpContent(raw);
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            message: 'Script execution failed',
+                            error: error instanceof Error ? error.message : String(error)
+                        })
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=catalogTools.js.map

package/dist/catalogTools.js.map

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

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createCadMcpServer } from './server.js';
+/**
+ * stdio entry for `@mlightcad/cad-mcp-server`.
+ *
+ * stdout is reserved for MCP JSON-RPC — log only to stderr.
+ */
+async function main() {
+    const server = createCadMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[cad-mcp-server] listening on stdio');
+}
+main().catch(error => {
+    console.error('[cad-mcp-server] fatal:', error instanceof Error ? error.message : error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;GAIG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAA;IACnC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAA;AACtD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACnB,OAAO,CAAC,KAAK,CACX,yBAAyB,EACzB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAA;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/headlessGpu.d.ts

@@ -0,0 +1,32 @@
+import { type Browser } from 'playwright';
+/**
+ * ANGLE / GL backend tried for headless WebGL, in preference order.
+ * `swiftshader` is the software renderer used when no hardware backend works.
+ */
+type GpuBackend = 'd3d11' | 'd3d9' | 'metal' | 'vulkan' | 'gl' | 'egl' | 'gles' | 'swiftshader';
+export interface HeadlessGpuLaunch {
+    browser: Browser;
+    /** UNMASKED_RENDERER_WEBGL string, or `unavailable`. */
+    renderer: string;
+    backend: GpuBackend;
+}
+/**
+ * Hardware backends for this OS, then SwiftShader.
+ */
+export declare function gpuBackendOrder(platform?: NodeJS.Platform): GpuBackend[];
+/** True for CPU rasterizers (SwiftShader, llvmpipe, WARP, …). */
+export declare function isSoftwareWebGlRenderer(renderer: string): boolean;
+export interface LaunchHeadlessChromiumOptions {
+    channel?: string;
+    platform?: NodeJS.Platform;
+    /**
+     * Prefer hardware GPU WebGL. Default `true`.
+     * When hardware is unavailable, falls back to SwiftShader.
+     */
+    useGpu?: boolean;
+}
+/**
+ * Launches headless Chromium for WebGL (same strategy as cad-simple-viewer-cli).
+ */
+export declare function launchHeadlessChromium(options?: LaunchHeadlessChromiumOptions): Promise<HeadlessGpuLaunch>;
+export {};

package/dist/headlessGpu.js

@@ -0,0 +1,122 @@
+import { chromium } from 'playwright';
+/**
+ * Hardware backends for this OS, then SwiftShader.
+ */
+export function gpuBackendOrder(platform = process.platform) {
+    switch (platform) {
+        case 'win32':
+            return ['d3d11', 'd3d9', 'swiftshader'];
+        case 'darwin':
+            return ['metal', 'gl', 'swiftshader'];
+        default:
+            return ['vulkan', 'gl', 'egl', 'gles', 'swiftshader'];
+    }
+}
+/** True for CPU rasterizers (SwiftShader, llvmpipe, WARP, …). */
+export function isSoftwareWebGlRenderer(renderer) {
+    return /swiftshader|llvmpipe|softpipe|lavapipe|microsoft basic render|software raster/i.test(renderer);
+}
+function chromiumArgsForBackend(backend) {
+    const shared = ['--ignore-gpu-blocklist', '--enable-gpu', '--enable-webgl'];
+    if (backend === 'swiftshader') {
+        return [
+            ...shared,
+            '--use-gl=angle',
+            '--use-angle=swiftshader',
+            '--enable-unsafe-swiftshader'
+        ];
+    }
+    if (backend === 'egl') {
+        return [...shared, '--use-gl=egl'];
+    }
+    return [...shared, '--use-gl=angle', `--use-angle=${backend}`];
+}
+async function probeWebGlRenderer(browser) {
+    const page = await browser.newPage();
+    try {
+        return await page.evaluate(() => {
+            const canvas = document.createElement('canvas');
+            const gl = canvas.getContext('webgl2') || canvas.getContext('webgl');
+            if (!gl)
+                return 'unavailable';
+            const ext = gl.getExtension('WEBGL_debug_renderer_info');
+            const renderer = ext
+                ? gl.getParameter(ext.UNMASKED_RENDERER_WEBGL)
+                : gl.getParameter(gl.RENDERER);
+            return renderer ? String(renderer) : 'unavailable';
+        });
+    }
+    catch {
+        return 'unavailable';
+    }
+    finally {
+        await page.close().catch(() => undefined);
+    }
+}
+async function launchSwiftShader(base) {
+    const browser = await chromium.launch({
+        ...base,
+        args: chromiumArgsForBackend('swiftshader')
+    });
+    const renderer = await probeWebGlRenderer(browser);
+    return { browser, renderer, backend: 'swiftshader' };
+}
+/**
+ * Launches headless Chromium for WebGL (same strategy as cad-simple-viewer-cli).
+ */
+export async function launchHeadlessChromium(options = {}) {
+    const channel = options.channel;
+    const platform = options.platform ?? process.platform;
+    const useGpu = options.useGpu !== false;
+    const base = {
+        headless: true,
+        ...(channel ? { channel } : {})
+    };
+    if (!useGpu) {
+        console.error('[cad-mcp-server] GPU disabled; using software renderer (SwiftShader)');
+        return launchSwiftShader(base);
+    }
+    let software;
+    const skipped = [];
+    for (const backend of gpuBackendOrder(platform)) {
+        let browser;
+        try {
+            browser = await chromium.launch({
+                ...base,
+                args: chromiumArgsForBackend(backend)
+            });
+        }
+        catch (error) {
+            skipped.push(`${backend} (${error instanceof Error ? error.message : String(error)})`);
+            continue;
+        }
+        const renderer = await probeWebGlRenderer(browser);
+        if (renderer === 'unavailable') {
+            skipped.push(`${backend} (no WebGL)`);
+            await browser.close().catch(() => undefined);
+            continue;
+        }
+        if (!isSoftwareWebGlRenderer(renderer)) {
+            if (software) {
+                await software.browser.close().catch(() => undefined);
+            }
+            return { browser, renderer, backend };
+        }
+        skipped.push(`${backend} (${renderer})`);
+        if (!software) {
+            software = { browser, renderer, backend };
+        }
+        else {
+            await browser.close().catch(() => undefined);
+        }
+    }
+    if (software) {
+        if (skipped.length > 0) {
+            console.error(`[cad-mcp-server] no hardware WebGL; using software renderer. Tried ${skipped.join('; ')}`);
+        }
+        return software;
+    }
+    console.error('[cad-mcp-server] no hardware WebGL; falling back to SwiftShader');
+    return launchSwiftShader(base);
+}
+//# sourceMappingURL=headlessGpu.js.map

package/dist/headlessGpu.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Public API for embedding or testing the CAD MCP server.
+ *
+ * The CLI entry is {@link ./cli.ts}; most hosts run `cad-mcp-server` via stdio.
+ *
+ * @packageDocumentation
+ */
+export { executeCadScriptInputSchema, openDrawingInputSchema, registerCadMcpTools, type RegisterCadMcpToolsOptions } from './catalogTools.js';
+export { createCadMcpServer } from './server.js';
+export { CadMcpSession, type CadMcpOpenMode, type CadMcpSessionCreateOptions } from './session.js';
+export { toolResultToMcpContent, type McpContentBlock } from './toolResult.js';

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Public API for embedding or testing the CAD MCP server.
+ *
+ * The CLI entry is {@link ./cli.ts}; most hosts run `cad-mcp-server` via stdio.
+ *
+ * @packageDocumentation
+ */
+export { executeCadScriptInputSchema, openDrawingInputSchema, registerCadMcpTools } from './catalogTools.js';
+export { createCadMcpServer } from './server.js';
+export { CadMcpSession } from './session.js';
+export { toolResultToMcpContent } from './toolResult.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EAEpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EACL,aAAa,EAGd,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,sBAAsB,EAEvB,MAAM,iBAAiB,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Builds the stdio MCP server that exposes CAD script tools.
+ *
+ * The headless Chromium session is started lazily on the first tool call.
+ */
+export declare function createCadMcpServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,29 @@
+import { createRequire } from 'node:module';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerCadMcpTools } from './catalogTools.js';
+import { CadMcpSession } from './session.js';
+const require = createRequire(import.meta.url);
+const { version: packageVersion } = require('../package.json');
+/**
+ * Builds the stdio MCP server that exposes CAD script tools.
+ *
+ * The headless Chromium session is started lazily on the first tool call.
+ */
+export function createCadMcpServer() {
+    const server = new McpServer({
+        name: 'cad-mcp-server',
+        version: packageVersion
+    });
+    registerCadMcpTools(server, {
+        openDrawing: async (input) => {
+            const session = await CadMcpSession.shared();
+            return session.openDrawing(input);
+        },
+        executeCadScript: async (input) => {
+            const session = await CadMcpSession.shared();
+            return session.executeCadScript(input);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAE5D,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAA;IAEF,mBAAmB,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACzB,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,CAAA;YAC5C,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QACnC,CAAC;QACD,gBAAgB,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC9B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,CAAA;YAC5C,OAAO,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;QACxC,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,37 @@
+import type { ToolResult } from '@mlightcad/cad-agent-core';
+export type CadMcpOpenMode = 'read' | 'write';
+export interface CadMcpSessionCreateOptions {
+    /** Prefer hardware GPU WebGL. Default `true`. */
+    useGpu?: boolean;
+}
+/**
+ * Long-lived headless Chromium session hosting cad-simple-viewer + agent-core.
+ *
+ * Started lazily on the first tool call and kept for the process lifetime so
+ * drawing state persists across MCP tool invocations.
+ */
+export declare class CadMcpSession {
+    private readonly browser;
+    private readonly page;
+    private readonly server;
+    private constructor();
+    private static instance;
+    /**
+     * Returns the shared session, creating it on first call.
+     */
+    static shared(options?: CadMcpSessionCreateOptions): Promise<CadMcpSession>;
+    static create(options?: CadMcpSessionCreateOptions): Promise<CadMcpSession>;
+    openDrawing(input: {
+        path?: string;
+        mode?: CadMcpOpenMode;
+    }): Promise<{
+        ok: true;
+        title: string;
+        mode: CadMcpOpenMode;
+    }>;
+    executeCadScript(input: {
+        code: string;
+        intent?: string;
+    }): Promise<ToolResult>;
+    close(): Promise<void>;
+}