@ifc-lite/mcp 0.2.0

package/dist/validate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tiny JSON-Schema input validator (Draft 2020-12 subset).
+ *
+ * We only support the keywords our hand-authored tool schemas use:
+ *   type, properties, required, items, enum, minimum, maximum,
+ *   minLength, maxLength, default, oneOf, anyOf, additionalProperties.
+ *
+ * That's enough to surface clear `INVALID_INPUT` errors back to the LLM
+ * without bringing in `ajv` (and its 200+ KB of metaschema) or zod.
+ */
+import type { JsonSchema } from './protocol/index.js';
+export interface ValidationIssue {
+    path: string;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    /** Input with `default` values filled in. */
+    value: unknown;
+}
+export declare function validateInput(schema: JsonSchema, input: unknown): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAIlF"}

package/dist/validate.js

@@ -0,0 +1,88 @@
+/* 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 function validateInput(schema, input) {
+    const errors = [];
+    const value = walk(schema, input, '$', errors);
+    return { valid: errors.length === 0, errors, value };
+}
+function walk(schema, input, path, errors) {
+    if (input === undefined && schema.default !== undefined) {
+        input = clone(schema.default);
+    }
+    if (input === undefined || input === null)
+        return input;
+    if (schema.enum && !schema.enum.includes(input)) {
+        errors.push({ path, message: `Expected one of ${JSON.stringify(schema.enum)}; got ${JSON.stringify(input)}` });
+    }
+    const types = Array.isArray(schema.type) ? schema.type : (schema.type ? [schema.type] : []);
+    if (types.length > 0 && !types.some((t) => matchesType(t, input))) {
+        errors.push({ path, message: `Expected type ${types.join('|')}; got ${typeof input}` });
+        return input;
+    }
+    if (matchesType('object', input) && schema.properties) {
+        const obj = input;
+        const result = { ...obj };
+        for (const [key, sub] of Object.entries(schema.properties)) {
+            const childPath = `${path}.${key}`;
+            const value = walk(sub, obj[key], childPath, errors);
+            if (value !== undefined)
+                result[key] = value;
+        }
+        if (schema.required) {
+            for (const key of schema.required) {
+                if (result[key] === undefined) {
+                    errors.push({ path: `${path}.${key}`, message: 'Required property missing' });
+                }
+            }
+        }
+        if (schema.additionalProperties === false) {
+            const allowed = new Set(Object.keys(schema.properties ?? {}));
+            for (const key of Object.keys(obj)) {
+                if (!allowed.has(key)) {
+                    errors.push({ path: `${path}.${key}`, message: 'Unexpected property' });
+                }
+            }
+        }
+        return result;
+    }
+    if (matchesType('array', input) && schema.items) {
+        const arr = input;
+        return arr.map((item, i) => walk(schema.items, item, `${path}[${i}]`, errors));
+    }
+    if (typeof input === 'number') {
+        if (schema.minimum !== undefined && input < schema.minimum) {
+            errors.push({ path, message: `Must be >= ${schema.minimum}` });
+        }
+        if (schema.maximum !== undefined && input > schema.maximum) {
+            errors.push({ path, message: `Must be <= ${schema.maximum}` });
+        }
+    }
+    if (typeof input === 'string') {
+        if (schema.minLength !== undefined && input.length < schema.minLength) {
+            errors.push({ path, message: `String shorter than ${schema.minLength}` });
+        }
+        if (schema.maxLength !== undefined && input.length > schema.maxLength) {
+            errors.push({ path, message: `String longer than ${schema.maxLength}` });
+        }
+    }
+    return input;
+}
+function matchesType(t, v) {
+    switch (t) {
+        case 'string': return typeof v === 'string';
+        case 'number': return typeof v === 'number' && !Number.isNaN(v);
+        case 'integer': return typeof v === 'number' && Number.isInteger(v);
+        case 'boolean': return typeof v === 'boolean';
+        case 'array': return Array.isArray(v);
+        case 'object': return v !== null && typeof v === 'object' && !Array.isArray(v);
+        case 'null': return v === null;
+        default: return true;
+    }
+}
+function clone(v) {
+    if (v === null || typeof v !== 'object')
+        return v;
+    return JSON.parse(JSON.stringify(v));
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/dist/viewer-manager.d.ts

@@ -0,0 +1,51 @@
+import { createStreamingViewerAdapter, createStreamingVisibilityAdapter } from '@ifc-lite/viewer-core';
+import type { LoadedModel } from './context.js';
+export interface SelectionEvent {
+    expressId: number;
+    ifcType?: string;
+    globalId?: string;
+}
+export interface ViewerState {
+    port: number;
+    url: string;
+    modelId: string | null;
+    startedAt: number;
+    clientCount: number;
+    selection: SelectionEvent[];
+}
+export type SelectionListener = (selection: SelectionEvent[], model: LoadedModel | null) => void;
+export declare class ViewerManager {
+    private server;
+    private port;
+    private startedAt;
+    private modelId;
+    private currentSelection;
+    private listeners;
+    private sseAbort;
+    private resolveModel;
+    constructor(resolveModel: (id: string | null) => LoadedModel | null);
+    isOpen(): boolean;
+    state(): ViewerState | null;
+    /**
+     * Start the viewer for `model`. If already running for the same model,
+     * returns the existing state. If a different model is requested, the
+     * caller must `close()` first — we don't auto-swap to avoid surprising
+     * mid-session changes.
+     */
+    open(model: LoadedModel, requestedPort?: number): Promise<ViewerState>;
+    close(): void;
+    /** Subscribe to selection changes. Returns an unsubscribe handle. */
+    onSelection(listener: SelectionListener): () => void;
+    /** Build viewer + visibility streaming adapters bound to the running port. */
+    adapters(): {
+        viewer: ReturnType<typeof createStreamingViewerAdapter>;
+        visibility: ReturnType<typeof createStreamingVisibilityAdapter>;
+    } | null;
+    /** Send a one-off command via the viewer's REST API. */
+    sendCommand(action: string, payload?: Record<string, unknown>): Promise<void>;
+    private subscribeToEvents;
+    private consumeSse;
+    private handleSseFrame;
+    private handlePicked;
+}
+//# sourceMappingURL=viewer-manager.d.ts.map

package/dist/viewer-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-manager.d.ts","sourceRoot":"","sources":["../src/viewer-manager.ts"],"names":[],"mappings":"AAwBA,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAEjC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;AAEjG,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,YAAY,CAA4C;gBAEpD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,WAAW,GAAG,IAAI;IAInE,MAAM,IAAI,OAAO;IAIjB,KAAK,IAAI,WAAW,GAAG,IAAI;IAY3B;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,SAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAgCvE,KAAK,IAAI,IAAI;IAgBb,qEAAqE;IACrE,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAKpD,8EAA8E;IAC9E,QAAQ,IAAI;QAAE,MAAM,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;QAAC,UAAU,EAAE,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAA;KAAE,GAAG,IAAI;IAQ/I,wDAAwD;IAClD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvF,OAAO,CAAC,iBAAiB;YASX,UAAU;IAsBxB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,YAAY;CAmBrB"}

package/dist/viewer-manager.js

@@ -0,0 +1,183 @@
+/* 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/. */
+import { createStreamingViewerAdapter, createStreamingVisibilityAdapter, startViewerServer, } from '@ifc-lite/viewer-core';
+import { EntityNode } from '@ifc-lite/query';
+export class ViewerManager {
+    server = null;
+    port = 0;
+    startedAt = 0;
+    modelId = null;
+    currentSelection = [];
+    listeners = new Set();
+    sseAbort = null;
+    resolveModel;
+    constructor(resolveModel) {
+        this.resolveModel = resolveModel;
+    }
+    isOpen() {
+        return this.server !== null;
+    }
+    state() {
+        if (!this.server)
+            return null;
+        return {
+            port: this.port,
+            url: `http://localhost:${this.port}/`,
+            modelId: this.modelId,
+            startedAt: this.startedAt,
+            clientCount: this.server.clientCount(),
+            selection: [...this.currentSelection],
+        };
+    }
+    /**
+     * Start the viewer for `model`. If already running for the same model,
+     * returns the existing state. If a different model is requested, the
+     * caller must `close()` first — we don't auto-swap to avoid surprising
+     * mid-session changes.
+     */
+    async open(model, requestedPort = 0) {
+        if (this.server) {
+            if (this.modelId === model.id) {
+                return this.state();
+            }
+            throw new Error(`Viewer already open for model '${this.modelId}'. Call viewer_close before switching to '${model.id}'.`);
+        }
+        if (!model.filePath) {
+            throw new Error(`Cannot open viewer: model '${model.id}' has no on-disk file path. The viewer streams the .ifc directly from disk.`);
+        }
+        let resolvedPort = requestedPort;
+        this.server = await startViewerServer({
+            filePath: model.filePath,
+            fileName: model.name,
+            port: requestedPort,
+            onReady: (boundPort) => {
+                resolvedPort = boundPort;
+            },
+        });
+        this.port = resolvedPort;
+        this.modelId = model.id;
+        this.startedAt = Date.now();
+        this.currentSelection = [];
+        this.subscribeToEvents();
+        return this.state();
+    }
+    close() {
+        this.sseAbort?.abort();
+        this.sseAbort = null;
+        if (this.server) {
+            try {
+                this.server.close();
+            }
+            catch (err) {
+                // Server already disposed — surface for diagnostics, then move on.
+                // eslint-disable-next-line no-console
+                console.error('[viewer-manager] close error', err);
+            }
+        }
+        this.server = null;
+        this.port = 0;
+        this.modelId = null;
+        this.currentSelection = [];
+    }
+    /** Subscribe to selection changes. Returns an unsubscribe handle. */
+    onSelection(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** Build viewer + visibility streaming adapters bound to the running port. */
+    adapters() {
+        if (!this.server)
+            return null;
+        return {
+            viewer: createStreamingViewerAdapter(this.port),
+            visibility: createStreamingVisibilityAdapter(this.port),
+        };
+    }
+    /** Send a one-off command via the viewer's REST API. */
+    async sendCommand(action, payload = {}) {
+        if (!this.server)
+            throw new Error('Viewer is not open. Call viewer_open first.');
+        const res = await fetch(`http://localhost:${this.port}/api/command`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action, ...payload }),
+        });
+        if (!res.ok) {
+            throw new Error(`Viewer command '${action}' failed: HTTP ${res.status}`);
+        }
+    }
+    // ── internals ──────────────────────────────────────────────────────────
+    subscribeToEvents() {
+        this.sseAbort = new AbortController();
+        void this.consumeSse(this.sseAbort.signal).catch((err) => {
+            if (err.name === 'AbortError')
+                return;
+            // eslint-disable-next-line no-console
+            console.error('[viewer-manager] SSE error', err);
+        });
+    }
+    async consumeSse(signal) {
+        const url = `http://localhost:${this.port}/events`;
+        const res = await fetch(url, { signal, headers: { Accept: 'text/event-stream' } });
+        if (!res.body)
+            return;
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buf = '';
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            let idx = buf.indexOf('\n\n');
+            while (idx !== -1) {
+                const frame = buf.slice(0, idx);
+                buf = buf.slice(idx + 2);
+                this.handleSseFrame(frame);
+                idx = buf.indexOf('\n\n');
+            }
+        }
+    }
+    handleSseFrame(frame) {
+        // Each frame is one or more `data: ...` lines.
+        const dataLines = frame.split('\n').filter((l) => l.startsWith('data:')).map((l) => l.slice(5).trim());
+        if (dataLines.length === 0)
+            return;
+        const payload = dataLines.join('\n');
+        let parsed;
+        try {
+            parsed = JSON.parse(payload);
+        }
+        catch {
+            return;
+        }
+        if (parsed.action === 'picked' && typeof parsed.expressId === 'number') {
+            this.handlePicked(parsed.expressId, parsed.ifcType);
+        }
+    }
+    handlePicked(expressId, ifcType) {
+        const model = this.resolveModel(this.modelId);
+        let globalId;
+        if (model && model.store.entityIndex.byId.has(expressId)) {
+            try {
+                globalId = new EntityNode(model.store, expressId).globalId || undefined;
+            }
+            catch {
+                globalId = undefined;
+            }
+        }
+        this.currentSelection = [{ expressId, ifcType, globalId }];
+        for (const listener of this.listeners) {
+            try {
+                listener(this.currentSelection, model);
+            }
+            catch (err) {
+                // eslint-disable-next-line no-console
+                console.error('[viewer-manager] listener error', err);
+            }
+        }
+    }
+}
+//# sourceMappingURL=viewer-manager.js.map

package/dist/viewer-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-manager.js","sourceRoot":"","sources":["../src/viewer-manager.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAsB/D,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAoB7C,MAAM,OAAO,aAAa;IAChB,MAAM,GAAwB,IAAI,CAAC;IACnC,IAAI,GAAG,CAAC,CAAC;IACT,SAAS,GAAG,CAAC,CAAC;IACd,OAAO,GAAkB,IAAI,CAAC;IAC9B,gBAAgB,GAAqB,EAAE,CAAC;IACxC,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;IACzC,QAAQ,GAA2B,IAAI,CAAC;IACxC,YAAY,CAA4C;IAEhE,YAAY,YAAuD;QACjE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,oBAAoB,IAAI,CAAC,IAAI,GAAG;YACrC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YACtC,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC;SACtC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,KAAkB,EAAE,aAAa,GAAG,CAAC;QAC9C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC,KAAK,EAAiB,CAAC;YACrC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,CAAC,OAAO,6CAA6C,KAAK,CAAC,EAAE,IAAI,CACxG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,CAAC,EAAE,6EAA6E,CACpH,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,GAAG,aAAa,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,iBAAiB,CAAC;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,IAAI;YACpB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE;gBACrB,YAAY,GAAG,SAAS,CAAC;YAC3B,CAAC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,EAAiB,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACxC,mEAAmE;gBACnE,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,qEAAqE;IACrE,WAAW,CAAC,QAA2B;QACrC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,8EAA8E;IAC9E,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC9B,OAAO;YACL,MAAM,EAAE,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC;YAC/C,UAAU,EAAE,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,UAAmC,EAAE;QACrE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,CAAC,IAAI,cAAc,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;SAC7C,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,0EAA0E;IAElE,iBAAiB;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACtC,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YAChE,IAAK,GAAyB,CAAC,IAAI,KAAK,YAAY;gBAAE,OAAO;YAC7D,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,MAAmB;QAC1C,MAAM,GAAG,GAAG,oBAAoB,IAAI,CAAC,IAAI,SAAS,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,OAAO;QACtB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,iDAAiD;QACjD,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,IAAI,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBAChC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBACzB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC3B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,KAAa;QAClC,+CAA+C;QAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvG,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACnC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,MAAiE,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YACvE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,SAAiB,EAAE,OAAgB;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,QAA4B,CAAC;QACjC,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC;gBACH,QAAQ,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,QAAQ,IAAI,SAAS,CAAC;YAC1E,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,GAAG,SAAS,CAAC;YACvB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YAAC,CAAC;YAC/C,OAAO,GAAG,EAAE,CAAC;gBACX,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@ifc-lite/mcp",
+  "version": "0.2.0",
+  "description": "Model Context Protocol server for ifc-lite — agent-native BIM via MCP (stdio + Streamable HTTP)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "ifc-lite-mcp": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    },
+    "./protocol": {
+      "import": "./dist/protocol/index.js",
+      "types": "./dist/protocol/index.d.ts"
+    },
+    "./browser": {
+      "import": "./dist/browser.js",
+      "types": "./dist/browser.d.ts"
+    }
+  },
+  "dependencies": {
+    "@types/node": "^20.0.0",
+    "@ifc-lite/bcf": "^1.15.3",
+    "@ifc-lite/create": "^1.15.0",
+    "@ifc-lite/data": "^1.15.2",
+    "@ifc-lite/encoding": "^1.14.6",
+    "@ifc-lite/export": "^1.18.0",
+    "@ifc-lite/ids": "^1.14.11",
+    "@ifc-lite/mutations": "^1.15.0",
+    "@ifc-lite/parser": "^2.3.0",
+    "@ifc-lite/query": "^1.14.7",
+    "@ifc-lite/sdk": "^1.15.0",
+    "@ifc-lite/viewer-core": "^0.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MPL-2.0",
+  "author": "Louis True",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/louistrue/ifc-lite.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://louistrue.github.io/ifc-lite/",
+  "bugs": "https://github.com/louistrue/ifc-lite/issues",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ifc",
+    "bim",
+    "ai-agent",
+    "llm",
+    "claude",
+    "cursor",
+    "json-rpc",
+    "ifc-lite",
+    "aec"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "pnpm exec tsc",
+    "dev": "pnpm exec tsc --watch",
+    "start": "node dist/cli.js",
+    "test": "vitest run"
+  }
+}