@ifc-lite/mcp 0.2.0

package/dist/browser.js

@@ -0,0 +1,37 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Browser-safe entrypoint for `@ifc-lite/mcp`.
+ *
+ * The web playground imports this file directly so it never pulls in any of
+ * the Node-only modules:
+ *   • loader.ts                  — uses node:fs to mmap .ifc files
+ *   • viewer-manager.ts          — uses node:child_process to open browsers
+ *   • transport/{stdio,http}.ts  — uses node:net + node:stream
+ *   • tools/{validation,mutate,
+ *           export,bcf}.ts       — uses node:fs/promises + node:path
+ *
+ * What we DO surface in the browser is the small kernel an in-page agent
+ * needs to drive the same tool surface that the stdio CLI exposes:
+ *   - `HeadlessLikeBackend`            — wraps a parsed `IfcDataStore` so
+ *                                        `createBimContext({ backend })` from
+ *                                        `@ifc-lite/sdk` returns a fully
+ *                                        functional read-side BIM context.
+ *   - error codes + types              — so the playground can mirror the
+ *                                        wire-format error envelopes the
+ *                                        Node MCP server emits.
+ *   - protocol types                   — so message shapes stay in lockstep
+ *                                        when the playground later switches
+ *                                        from a custom dispatcher to the
+ *                                        real MCP server in-process.
+ *
+ * Anything mutation/export/IDS related can be re-added to this entry once
+ * those tools learn to write through a Blob-friendly virtual filesystem
+ * (planned for v0.3 alongside the OAuth gateway).
+ */
+export { HeadlessLikeBackend, expandTypes, isProductType } from './headless-backend.js';
+export { InMemoryModelRegistry } from './context.js';
+export { ToolErrorCode, ToolExecutionError, toolError } from './errors.js';
+export { PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS, JSONRPC_VERSION, } from './protocol/types.js';
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAKrD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,qBAAqB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * `ifc-lite-mcp` — start an MCP server over stdio (default) or Streamable HTTP.
+ *
+ * Usage:
+ *   ifc-lite-mcp ./model.ifc
+ *   ifc-lite-mcp ./arch.ifc ./struct.ifc --federate
+ *   ifc-lite-mcp ./model.ifc --read-only
+ *   ifc-lite-mcp --transport http --port 8765
+ *   ifc-lite-mcp --transport http --port 8765 --token abc123
+ */
+import { resolve } from 'node:path';
+import { StdioTransport } from './transport/stdio.js';
+import { HttpTransport, BearerTokenAuth, AllowAllAuth } from './transport/http.js';
+import { createMCPServer, VERSION } from './index.js';
+import { loadIfcModel } from './loader.js';
+import { fullScope, readOnlyScope } from './auth/scope.js';
+import { InMemoryModelRegistry } from './context.js';
+function parseArgs(argv) {
+    const opts = {
+        files: [],
+        readOnly: false,
+        federate: false,
+        transport: 'stdio',
+        port: 8765,
+        autoViewer: false,
+        viewerPort: 0,
+        openBrowser: false,
+        insecure: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--read-only')
+            opts.readOnly = true;
+        else if (arg === '--federate')
+            opts.federate = true;
+        else if (arg === '--insecure')
+            opts.insecure = true;
+        else if (arg === '--transport')
+            opts.transport = argv[++i] ?? 'stdio';
+        else if (arg === '--port')
+            opts.port = Number(argv[++i] ?? 8765);
+        else if (arg === '--host')
+            opts.host = argv[++i];
+        else if (arg === '--token')
+            opts.token = argv[++i];
+        else if (arg === '--bsdd')
+            opts.bsdd = argv[++i];
+        else if (arg === '--viewer')
+            opts.autoViewer = true;
+        else if (arg === '--viewer-port')
+            opts.viewerPort = Number(argv[++i] ?? 0);
+        else if (arg === '--open') {
+            opts.autoViewer = true;
+            opts.openBrowser = true;
+        }
+        else if (arg === '--allow') {
+            const path = argv[++i];
+            if (path)
+                (opts.allowedPaths ??= []).push(resolve(path));
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+        else if (arg === '--version' || arg === '-v') {
+            process.stdout.write(`ifc-lite-mcp ${VERSION}\n`);
+            process.exit(0);
+        }
+        else if (!arg.startsWith('-')) {
+            opts.files.push(arg);
+        }
+    }
+    return opts;
+}
+function printHelp() {
+    process.stdout.write(`
+  ifc-lite-mcp v${VERSION} — Model Context Protocol server for ifc-lite
+
+  Usage: ifc-lite-mcp [files…] [options]
+
+  Options:
+    --read-only             Hide all mutation tools regardless of scope.
+    --federate              Mark explicitly that multiple files form one session.
+    --transport <stdio|http>  Default: stdio.
+    --port <n>              HTTP port (default 8765).
+    --host <h>              HTTP host. Default 127.0.0.1 (loopback). Use
+                            --insecure to allow non-loopback hosts when no
+                            token is configured.
+    --token <t>             Single bearer token for HTTP auth (full scope).
+                            Can be repeated to register multiple read-only tokens.
+    --insecure              Allow non-loopback bind without authentication.
+                            Required when combining a public --host with no
+                            --token. NEVER use in production.
+    --bsdd <url>            Override bSDD endpoint.
+    --allow <glob>          Restrict file-system access for stdio mode.
+    --viewer                Auto-open the in-process WebGL viewer at startup.
+    --viewer-port <n>       Preferred viewer port (0 = auto).
+    --open                  Implies --viewer; also tries to open the URL in
+                            the default browser via the OS opener.
+    --version, -v           Print version.
+    --help, -h              This message.
+
+  Examples:
+    ifc-lite-mcp ./model.ifc
+    ifc-lite-mcp ./arch.ifc ./struct.ifc --federate
+    ifc-lite-mcp ./model.ifc --read-only
+    ifc-lite-mcp --transport http --port 8765 --token abc
+
+  Claude Desktop config (~/.config/Claude/claude_desktop_config.json):
+    {
+      "mcpServers": {
+        "ifc-lite": {
+          "command": "npx",
+          "args": ["-y", "@ifc-lite/mcp", "/abs/path/to/model.ifc"]
+        }
+      }
+    }
+`);
+}
+async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    const scope = opts.readOnly ? readOnlyScope() : fullScope();
+    const registry = new InMemoryModelRegistry();
+    if (opts.transport === 'stdio') {
+        for (const file of opts.files) {
+            const m = await loadIfcModel(resolve(file), { allowedPaths: opts.allowedPaths });
+            registry.add(m);
+            // Use stderr — stdout is sacred for the JSON-RPC channel.
+            process.stderr.write(`[ifc-lite-mcp] loaded ${m.name} (${m.id}) — ${m.store.entityCount.toLocaleString()} entities\n`);
+        }
+        const server = createMCPServer({
+            version: VERSION,
+            registry,
+            scope,
+            config: {
+                readOnly: opts.readOnly,
+                bsddEndpoint: opts.bsdd,
+                allowedPaths: opts.allowedPaths,
+                samplingEnabled: false,
+                autoOpenViewer: opts.autoViewer,
+                viewerPort: opts.viewerPort,
+            },
+            logger: {
+                log(level, message, data) {
+                    if (level === 'debug')
+                        return;
+                    process.stderr.write(`[ifc-lite-mcp] ${level} ${message}${data ? ` ${JSON.stringify(data)}` : ''}\n`);
+                },
+            },
+        });
+        const transport = new StdioTransport();
+        await transport.connect(server);
+        process.stderr.write(`[ifc-lite-mcp] ready on stdio (read-only=${opts.readOnly})\n`);
+        if (opts.autoViewer && registry.count() > 0) {
+            const first = registry.list()[0];
+            try {
+                const state = await server.viewer.open(first, opts.viewerPort);
+                const adapters = server.viewer.adapters();
+                if (adapters)
+                    first.backend.attachStreamingAdapters(adapters.viewer, adapters.visibility);
+                process.stderr.write(`[ifc-lite-mcp] viewer ready at ${state.url}\n`);
+                if (opts.openBrowser) {
+                    const cmd = process.platform === 'darwin' ? 'open'
+                        : process.platform === 'win32' ? 'start'
+                            : 'xdg-open';
+                    try {
+                        const { spawn } = await import('node:child_process');
+                        spawn(cmd, [state.url], { detached: true, stdio: 'ignore' }).unref();
+                    }
+                    catch (err) {
+                        process.stderr.write(`[ifc-lite-mcp] could not auto-open browser: ${err.message}\n`);
+                    }
+                }
+            }
+            catch (err) {
+                process.stderr.write(`[ifc-lite-mcp] viewer auto-open failed: ${err.message}\n`);
+            }
+        }
+        else if (registry.count() > 0) {
+            process.stderr.write(`[ifc-lite-mcp] viewer is opt-in. Tell the agent to call \`viewer_ask\` and then \`viewer_open\`, or restart with --viewer to auto-open.\n`);
+        }
+    }
+    else if (opts.transport === 'http') {
+        // Pick a safe default. Loopback unless the operator explicitly opts in
+        // to a public bind. Combining a public bind with no token requires
+        // --insecure so the security tradeoff is a deliberate keystroke, not
+        // an accidental copy-paste from a tutorial.
+        const host = opts.host ?? '127.0.0.1';
+        const isLoopback = host === '127.0.0.1' || host === 'localhost' || host === '::1';
+        if (!isLoopback && !opts.token && !opts.insecure) {
+            process.stderr.write(`[ifc-lite-mcp] refusing to bind ${host} without --token. Pass --token <bearer> or --insecure to override.\n`);
+            process.exit(1);
+        }
+        const sessionFactory = {
+            build(scopeForSession) {
+                return createMCPServer({
+                    version: VERSION,
+                    // Each HTTP session gets a fresh registry so mutations don't leak.
+                    registry: new InMemoryModelRegistry(),
+                    scope: scopeForSession,
+                    config: {
+                        readOnly: opts.readOnly,
+                        bsddEndpoint: opts.bsdd,
+                        samplingEnabled: false,
+                    },
+                });
+            },
+        };
+        const auth = opts.token
+            ? new BearerTokenAuth(new Map([[opts.token, scope]]))
+            : new AllowAllAuth(scope);
+        const transport = new HttpTransport({ port: opts.port, host, authenticator: auth, sessionFactory });
+        await transport.listen();
+        process.stderr.write(`[ifc-lite-mcp] listening on http://${host}:${opts.port}` +
+            (!opts.token ? ' (no auth — loopback only unless --insecure)' : '') +
+            '\n');
+    }
+    else {
+        process.stderr.write(`Unknown transport: ${opts.transport}\n`);
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`[ifc-lite-mcp] fatal: ${err.message}\n`);
+    if (process.env.DEBUG)
+        process.stderr.write(`${err.stack ?? ''}\n`);
+    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;;+DAE+D;AAE/D;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAA+C,MAAM,qBAAqB,CAAC;AAChI,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAkB,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAmBrD,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,IAAI,GAAe;QACvB,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,IAAI;QACV,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,KAAK;KAChB,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,aAAa;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;aAC3C,IAAI,GAAG,KAAK,YAAY;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;aAC/C,IAAI,GAAG,KAAK,YAAY;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;aAC/C,IAAI,GAAG,KAAK,aAAa;YAAE,IAAI,CAAC,SAAS,GAAI,IAAI,CAAC,EAAE,CAAC,CAAsB,IAAI,OAAO,CAAC;aACvF,IAAI,GAAG,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;aAC5D,IAAI,GAAG,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aAC5C,IAAI,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aAC9C,IAAI,GAAG,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aAC5C,IAAI,GAAG,KAAK,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;aAC/C,IAAI,GAAG,KAAK,eAAe;YAAE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;aACtE,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAAC,CAAC;aAC1E,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,IAAI,IAAI;gBAAE,CAAC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,OAAO,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;kBACL,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCxB,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAc,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAEvE,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC7C,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;YACjF,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAChB,0DAA0D;YAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QACzH,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC;YAC7B,OAAO,EAAE,OAAO;YAChB,QAAQ;YACR,KAAK;YACL,MAAM,EAAE;gBACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,YAAY,EAAE,IAAI,CAAC,IAAI;gBACvB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,eAAe,EAAE,KAAK;gBACtB,cAAc,EAAE,IAAI,CAAC,UAAU;gBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B;YACD,MAAM,EAAE;gBACN,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI;oBACtB,IAAI,KAAK,KAAK,OAAO;wBAAE,OAAO;oBAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,KAAK,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACxG,CAAC;aACF;SACF,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,cAAc,EAAE,CAAC;QACvC,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4CAA4C,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;QAErF,IAAI,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC1C,IAAI,QAAQ;oBAAE,KAAK,CAAC,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAC1F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;gBACtE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM;wBAChD,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO;4BACxC,CAAC,CAAC,UAAU,CAAC;oBACf,IAAI,CAAC;wBACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;wBACrD,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;oBACvE,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+CAAgD,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;oBAClG,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA4C,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;aAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2IAA2I,CAAC,CAAC;QACpK,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QACrC,uEAAuE;QACvE,mEAAmE;QACnE,qEAAqE;QACrE,4CAA4C;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,KAAK,CAAC;QAClF,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mCAAmC,IAAI,sEAAsE,CAC9G,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,cAAc,GAAmB;YACrC,KAAK,CAAC,eAAe;gBACnB,OAAO,eAAe,CAAC;oBACrB,OAAO,EAAE,OAAO;oBAChB,mEAAmE;oBACnE,QAAQ,EAAE,IAAI,qBAAqB,EAAE;oBACrC,KAAK,EAAE,eAAe;oBACtB,MAAM,EAAE;wBACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,YAAY,EAAE,IAAI,CAAC,IAAI;wBACvB,eAAe,EAAE,KAAK;qBACvB;iBACF,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,MAAM,IAAI,GAAsB,IAAI,CAAC,KAAK;YACxC,CAAC,CAAC,IAAI,eAAe,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;YACrD,CAAC,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACpG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sCAAsC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;YACzD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CACL,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,IAAI,CAAC,CAAC;IACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Tool/resource execution context.
+ *
+ * A handler receives `ToolContext` containing:
+ *   - the federated model registry (one or many `BimContext` + `IfcDataStore`)
+ *   - the auth scope of the caller
+ *   - a `ProgressReporter` (no-op when no token is attached)
+ *   - a `Logger` for structured server logs
+ *   - a cancellation signal
+ *
+ * The registry deliberately holds the parsed `IfcDataStore` next to the
+ * `BimContext` because several tools (geometry bbox, audit, schema describe)
+ * need direct store access that the SDK doesn't yet surface as namespaces.
+ */
+import type { BimContext } from '@ifc-lite/sdk';
+import type { IfcDataStore } from '@ifc-lite/parser';
+import type { AuthScope } from './auth/scope.js';
+import type { HeadlessLikeBackend } from './headless-backend.js';
+import type { ViewerManager } from './viewer-manager.js';
+export interface LoadedModel {
+    id: string;
+    name: string;
+    bim: BimContext;
+    store: IfcDataStore;
+    /** Concrete backend, retained so mutation tools can reach the editor without reflection. */
+    backend: HeadlessLikeBackend;
+    filePath?: string;
+    loadedAt: number;
+}
+export interface ModelRegistry {
+    list(): LoadedModel[];
+    get(id: string): LoadedModel | null;
+    /**
+     * Resolve the model for a tool call.
+     *
+     * Returns the named model when `id` is provided, the single loaded model
+     * when only one is loaded, or null if the caller needs to pick.
+     */
+    resolve(id?: string): LoadedModel | null;
+    add(model: LoadedModel): void;
+    remove(id: string): boolean;
+    count(): number;
+}
+export declare class InMemoryModelRegistry implements ModelRegistry {
+    private models;
+    list(): LoadedModel[];
+    get(id: string): LoadedModel | null;
+    resolve(id?: string): LoadedModel | null;
+    add(model: LoadedModel): void;
+    remove(id: string): boolean;
+    count(): number;
+}
+export interface ProgressReporter {
+    report(progress: number, message?: string, total?: number): void;
+}
+export declare const NOOP_PROGRESS: ProgressReporter;
+export type LogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical';
+export interface Logger {
+    log(level: LogLevel, message: string, data?: Record<string, unknown>): void;
+}
+export declare const SILENT_LOGGER: Logger;
+export interface ToolContext {
+    registry: ModelRegistry;
+    scope: AuthScope;
+    progress: ProgressReporter;
+    log: Logger;
+    /** Honoured by long-running tools; aborts when client cancels. */
+    signal: AbortSignal;
+    /** Server-wide config (read-only flag, bSDD endpoint, allowed paths, …). */
+    config: ServerConfig;
+    /** Optional: present when the server has a managed in-process viewer. */
+    viewer?: ViewerManager;
+}
+export interface ServerConfig {
+    readOnly: boolean;
+    bsddEndpoint?: string;
+    /** Glob patterns the stdio server is allowed to read from. */
+    allowedPaths?: string[];
+    /** Sampling capability is opt-in per spec §10. */
+    samplingEnabled: boolean;
+    /** When true, the MCP CLI auto-opens the viewer at startup. */
+    autoOpenViewer?: boolean;
+    /** Preferred viewer port (0 = auto). */
+    viewerPort?: number;
+}
+export declare const DEFAULT_CONFIG: ServerConfig;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

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

package/dist/context.js

@@ -0,0 +1,41 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export class InMemoryModelRegistry {
+    models = new Map();
+    list() {
+        return Array.from(this.models.values());
+    }
+    get(id) {
+        return this.models.get(id) ?? null;
+    }
+    resolve(id) {
+        if (id)
+            return this.models.get(id) ?? null;
+        if (this.models.size === 1) {
+            const only = this.models.values().next().value;
+            return only ?? null;
+        }
+        return null;
+    }
+    add(model) {
+        this.models.set(model.id, model);
+    }
+    remove(id) {
+        return this.models.delete(id);
+    }
+    count() {
+        return this.models.size;
+    }
+}
+export const NOOP_PROGRESS = {
+    report() { },
+};
+export const SILENT_LOGGER = {
+    log() { },
+};
+export const DEFAULT_CONFIG = {
+    readOnly: false,
+    samplingEnabled: false,
+};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAiD/D,MAAM,OAAO,qBAAqB;IACxB,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEhD,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,EAAW;QACjB,IAAI,EAAE;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAgC,CAAC;YAC1E,OAAO,IAAI,IAAI,IAAI,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,KAAkB;QACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF;AAMD,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,MAAM,KAA4C,CAAC;CACpD,CAAC;AAQF,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,GAAG,KAAyD,CAAC;CAC9D,CAAC;AA4BF,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,QAAQ,EAAE,KAAK;IACf,eAAe,EAAE,KAAK;CACvB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Stable error codes for tool results.
+ *
+ * Critical: these are surfaced as `structuredContent.code` on tool results
+ * with `isError: true` — NEVER as JSON-RPC errors. That lets the LLM read
+ * and react to the failure inline rather than aborting the chain.
+ */
+import type { CallToolResult } from './protocol/index.js';
+export declare const ToolErrorCode: {
+    readonly ENTITY_NOT_FOUND: "ENTITY_NOT_FOUND";
+    readonly MODEL_NOT_FOUND: "MODEL_NOT_FOUND";
+    readonly MODEL_REQUIRED: "MODEL_REQUIRED";
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    readonly UNSUPPORTED_OPERATION: "UNSUPPORTED_OPERATION";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly READ_ONLY: "READ_ONLY";
+    readonly PARSE_FAILED: "PARSE_FAILED";
+    readonly EXTERNAL_SERVICE_FAILED: "EXTERNAL_SERVICE_FAILED";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+};
+export type ToolErrorCodeValue = typeof ToolErrorCode[keyof typeof ToolErrorCode];
+export interface ToolErrorOptions {
+    code: ToolErrorCodeValue;
+    message: string;
+    details?: Record<string, unknown>;
+    hint?: string;
+}
+export declare function toolError(opts: ToolErrorOptions): CallToolResult;
+export declare class ToolExecutionError extends Error {
+    readonly code: ToolErrorCodeValue;
+    readonly details?: Record<string, unknown>;
+    readonly hint?: string;
+    constructor(opts: ToolErrorOptions);
+    toToolResult(): CallToolResult;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,aAAa;;;;;;;;;;;;CAYhB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,cAAc,CAWhE;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE,gBAAgB;IAQlC,YAAY,IAAI,cAAc;CAQ/B"}

package/dist/errors.js

@@ -0,0 +1,49 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export const ToolErrorCode = {
+    ENTITY_NOT_FOUND: 'ENTITY_NOT_FOUND',
+    MODEL_NOT_FOUND: 'MODEL_NOT_FOUND',
+    MODEL_REQUIRED: 'MODEL_REQUIRED',
+    INVALID_INPUT: 'INVALID_INPUT',
+    UNSUPPORTED_OPERATION: 'UNSUPPORTED_OPERATION',
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    READ_ONLY: 'READ_ONLY',
+    PARSE_FAILED: 'PARSE_FAILED',
+    EXTERNAL_SERVICE_FAILED: 'EXTERNAL_SERVICE_FAILED',
+    RATE_LIMITED: 'RATE_LIMITED',
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+};
+export function toolError(opts) {
+    return {
+        content: [{ type: 'text', text: opts.message }],
+        structuredContent: {
+            code: opts.code,
+            message: opts.message,
+            details: opts.details ?? {},
+            hint: opts.hint,
+        },
+        isError: true,
+    };
+}
+export class ToolExecutionError extends Error {
+    code;
+    details;
+    hint;
+    constructor(opts) {
+        super(opts.message);
+        this.name = 'ToolExecutionError';
+        this.code = opts.code;
+        this.details = opts.details;
+        this.hint = opts.hint;
+    }
+    toToolResult() {
+        return toolError({
+            code: this.code,
+            message: this.message,
+            details: this.details,
+            hint: this.hint,
+        });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAY/D,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gBAAgB,EAAE,kBAAkB;IACpC,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,qBAAqB,EAAE,uBAAuB;IAC9C,iBAAiB,EAAE,mBAAmB;IACtC,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,uBAAuB,EAAE,yBAAyB;IAClD,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAWX,MAAM,UAAU,SAAS,CAAC,IAAsB;IAC9C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/C,iBAAiB,EAAE;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAqB;IACzB,OAAO,CAA2B;IAClC,IAAI,CAAU;IAEvB,YAAY,IAAsB;QAChC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,YAAY;QACV,OAAO,SAAS,CAAC;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/headless-backend.d.ts

@@ -0,0 +1,61 @@
+/**
+ * HeadlessLikeBackend — minimal `BimBackend` for MCP tool execution.
+ *
+ * Mirrors `@ifc-lite/cli`'s HeadlessBackend but trimmed to the surface MCP
+ * tools touch (model + query + selection + spatial + export + mutate +
+ * store + visibility + viewer no-ops). Splitting it out of the CLI lets the
+ * MCP package avoid the `@ifc-lite/viewer-core` dependency that the CLI
+ * pulls in for `ifc-lite view`.
+ *
+ * Tools that need richer functionality (geometry mesh data, raycast,
+ * heatmap evaluation) call the parser directly via the registry's
+ * `LoadedModel.store`, not through this backend.
+ */
+import type { BimBackend, BimEventType, ModelBackendMethods, QueryBackendMethods, SelectionBackendMethods, VisibilityBackendMethods, ViewerBackendMethods, MutateBackendMethods, StoreBackendMethods, SpatialBackendMethods, ExportBackendMethods, LensBackendMethods, FilesBackendMethods, ScheduleBackendMethods } from '@ifc-lite/sdk';
+import type { IfcDataStore } from '@ifc-lite/parser';
+import { MutablePropertyView, StoreEditor } from '@ifc-lite/mutations';
+export declare function expandTypes(types: string[]): string[];
+export declare function isProductType(type: string): boolean;
+export declare class HeadlessLikeBackend implements BimBackend {
+    readonly model: ModelBackendMethods;
+    readonly query: QueryBackendMethods;
+    readonly selection: SelectionBackendMethods;
+    /**
+     * Mutable so the MCP server can swap in streaming adapters when the
+     * viewer subprocess starts, then revert when it closes. Marked
+     * `readonly` on the BimBackend interface but the underlying instance
+     * is ours to manage.
+     */
+    visibility: VisibilityBackendMethods;
+    viewer: ViewerBackendMethods;
+    readonly mutate: MutateBackendMethods;
+    readonly store: StoreBackendMethods;
+    readonly spatial: SpatialBackendMethods;
+    readonly export: ExportBackendMethods;
+    readonly lens: LensBackendMethods;
+    readonly files: FilesBackendMethods;
+    readonly schedule: ScheduleBackendMethods;
+    private dataStore;
+    private modelName;
+    private modelId;
+    private mutationView;
+    private storeEditor;
+    constructor(store: IfcDataStore, modelName: string, modelId: string);
+    subscribe(_event: BimEventType, _handler: (data: unknown) => void): () => void;
+    private createModelAdapter;
+    private createQueryAdapter;
+    private createSelectionAdapter;
+    private getOrCreateStoreEditor;
+    /** Expose the mutation view so tools can inspect pending mutations. */
+    getMutationView(): MutablePropertyView | null;
+    /** Force creation of the editor (used by mutation tools that always need it). */
+    ensureEditor(): StoreEditor;
+    /** Replace the viewer/visibility adapters at runtime (for ViewerManager). */
+    attachStreamingAdapters(viewer: ViewerBackendMethods, visibility: VisibilityBackendMethods): void;
+    /** Restore no-op viewer/visibility adapters (for ViewerManager close). */
+    detachStreamingAdapters(): void;
+    private createStoreAdapter;
+    private createExportAdapter;
+    private createScheduleAdapter;
+}
+//# sourceMappingURL=headless-backend.d.ts.map

package/dist/headless-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-backend.d.ts","sourceRoot":"","sources":["../src/headless-backend.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EAavB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAkCvE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASrD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUnD;AAQD,qBAAa,mBAAoB,YAAW,UAAU;IACpD,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C;;;;;OAKG;IACH,UAAU,EAAE,wBAAwB,CAAC;IACrC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAE1C,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,WAAW,CAA4B;gBAEnC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAyBnE,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAI9E,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,kBAAkB;IAgJ1B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,sBAAsB;IAO9B,uEAAuE;IACvE,eAAe,IAAI,mBAAmB,GAAG,IAAI;IAI7C,iFAAiF;IACjF,YAAY,IAAI,WAAW;IAI3B,6EAA6E;IAC7E,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,wBAAwB,GAAG,IAAI;IAKjG,0EAA0E;IAC1E,uBAAuB,IAAI,IAAI;IAS/B,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,mBAAmB;IAqG3B,OAAO,CAAC,qBAAqB;CAqB9B"}