@pascal-app/mcp 0.2.0

package/dist/templates/two-bedroom.js

@@ -0,0 +1,270 @@
+/**
+ * 80 m² two-bedroom apartment.
+ *
+ * Footprint: 10 m × 8 m = 80 m², centered near the origin.
+ * Contents: 9 walls (4 perimeter + 5 interior), 4 zones
+ * (living/kitchen, bedroom1, bedroom2, bath), 4 doors (front + 3 interior),
+ * 5 windows (2 on the living/kitchen, 1 per bedroom, 1 on the bath).
+ * Interior partitions split the north half into two bedrooms and a bath.
+ *
+ * Coordinate system: `[x, z]` on the XZ plane, with `x` running east/west
+ * and `z` running north/south (positive z points south).
+ */
+// Perimeter extents: 10 m × 8 m.
+const X_MIN = -5;
+const X_MAX = 5;
+const Z_MIN = -4;
+const Z_MAX = 4;
+// Interior split lines.
+const CORRIDOR_Z = 0; // horizontal wall separating north half (bedrooms+bath) from south (living)
+const BED_X = -1; // vertical wall between bedroom 1 (west) and bath (east of it)
+const BATH_X = 2; // vertical wall between bath (middle) and bedroom 2 (east)
+const WALL_THICKNESS = 0.1;
+const WALL_HEIGHT = 2.5;
+function wall(id, start, end, children = []) {
+    return {
+        object: 'node',
+        id,
+        type: 'wall',
+        parentId: 'level_0',
+        visible: true,
+        metadata: {},
+        children,
+        thickness: WALL_THICKNESS,
+        height: WALL_HEIGHT,
+        start,
+        end,
+        frontSide: 'unknown',
+        backSide: 'unknown',
+    };
+}
+function door(id, parentWallId) {
+    return {
+        object: 'node',
+        id,
+        type: 'door',
+        parentId: parentWallId,
+        visible: true,
+        metadata: {},
+        wallId: parentWallId,
+        position: [0, 1.05, 0],
+        rotation: [0, 0, 0],
+        width: 0.8,
+        height: 2.1,
+        frameThickness: 0.05,
+        frameDepth: 0.07,
+        threshold: true,
+        thresholdHeight: 0.02,
+        hingesSide: 'left',
+        swingDirection: 'inward',
+        segments: [
+            {
+                type: 'panel',
+                heightRatio: 0.5,
+                columnRatios: [1],
+                dividerThickness: 0.03,
+                panelDepth: 0.01,
+                panelInset: 0.04,
+            },
+            {
+                type: 'panel',
+                heightRatio: 0.5,
+                columnRatios: [1],
+                dividerThickness: 0.03,
+                panelDepth: 0.01,
+                panelInset: 0.04,
+            },
+        ],
+        handle: true,
+        handleHeight: 1.05,
+        handleSide: 'right',
+        contentPadding: [0.04, 0.04],
+        doorCloser: false,
+        panicBar: false,
+        panicBarHeight: 1.0,
+    };
+}
+function makeWindow(id, parentWallId, width = 1.2) {
+    return {
+        object: 'node',
+        id,
+        type: 'window',
+        parentId: parentWallId,
+        visible: true,
+        metadata: {},
+        wallId: parentWallId,
+        position: [0, 1.2, 0],
+        rotation: [0, 0, 0],
+        width,
+        height: 1.2,
+        frameThickness: 0.05,
+        frameDepth: 0.07,
+        columnRatios: [1],
+        rowRatios: [1],
+        columnDividerThickness: 0.03,
+        rowDividerThickness: 0.03,
+        sill: true,
+        sillDepth: 0.08,
+        sillThickness: 0.03,
+    };
+}
+function buildTemplate() {
+    const nodes = {};
+    // Root nodes
+    nodes.site_2br = {
+        object: 'node',
+        id: 'site_2br',
+        type: 'site',
+        parentId: null,
+        visible: true,
+        metadata: {},
+        polygon: {
+            type: 'polygon',
+            points: [
+                [-15, -15],
+                [15, -15],
+                [15, 15],
+                [-15, 15],
+            ],
+        },
+        children: ['building_2br'],
+    };
+    nodes.building_2br = {
+        object: 'node',
+        id: 'building_2br',
+        type: 'building',
+        parentId: 'site_2br',
+        visible: true,
+        metadata: {},
+        position: [0, 0, 0],
+        rotation: [0, 0, 0],
+        children: ['level_0'],
+    };
+    // Openings — declared up front so walls can list them as children.
+    nodes.door_front = door('door_front', 'wall_s');
+    nodes.door_bed1 = door('door_bed1', 'wall_corr_1');
+    nodes.door_bath = door('door_bath', 'wall_corr_2');
+    nodes.door_bed2 = door('door_bed2', 'wall_corr_3');
+    nodes.window_living_a = makeWindow('window_living_a', 'wall_s', 1.5);
+    nodes.window_living_b = makeWindow('window_living_b', 'wall_e', 1.2);
+    nodes.window_bed1 = makeWindow('window_bed1', 'wall_n', 1.2);
+    nodes.window_bath = makeWindow('window_bath', 'wall_n', 0.6);
+    nodes.window_bed2 = makeWindow('window_bed2', 'wall_n', 1.2);
+    // Perimeter walls (N, E, S, W) — 4 walls.
+    // Interior partitions — 5 walls (the east/west corridor wall is split into
+    // three segments by the two vertical partitions so doors have a clear host).
+    nodes.wall_n = wall('wall_n', [X_MIN, Z_MIN], [X_MAX, Z_MIN], ['window_bed1', 'window_bath', 'window_bed2']);
+    nodes.wall_e = wall('wall_e', [X_MAX, Z_MIN], [X_MAX, Z_MAX], ['window_living_b']);
+    nodes.wall_s = wall('wall_s', [X_MAX, Z_MAX], [X_MIN, Z_MAX], ['door_front', 'window_living_a']);
+    nodes.wall_w = wall('wall_w', [X_MIN, Z_MAX], [X_MIN, Z_MIN]);
+    // Corridor wall is broken into 3 segments so each has its own interior door.
+    // Segment 1: from west to BED_X (bedroom-1 wall)
+    nodes.wall_corr_1 = wall('wall_corr_1', [X_MIN, CORRIDOR_Z], [BED_X, CORRIDOR_Z], ['door_bed1']);
+    // Segment 2: from BED_X to BATH_X (bath wall)
+    nodes.wall_corr_2 = wall('wall_corr_2', [BED_X, CORRIDOR_Z], [BATH_X, CORRIDOR_Z], ['door_bath']);
+    // Segment 3: from BATH_X to east (bedroom-2 wall)
+    nodes.wall_corr_3 = wall('wall_corr_3', [BATH_X, CORRIDOR_Z], [X_MAX, CORRIDOR_Z], ['door_bed2']);
+    // Two vertical partitions between the three north rooms.
+    nodes.wall_part_1 = wall('wall_part_1', [BED_X, Z_MIN], [BED_X, CORRIDOR_Z]);
+    nodes.wall_part_2 = wall('wall_part_2', [BATH_X, Z_MIN], [BATH_X, CORRIDOR_Z]);
+    // Zones: one per room.
+    nodes.zone_living = {
+        object: 'node',
+        id: 'zone_living',
+        type: 'zone',
+        parentId: 'level_0',
+        visible: true,
+        metadata: {},
+        name: 'Living / Kitchen',
+        color: '#60a5fa',
+        polygon: [
+            [X_MIN, CORRIDOR_Z],
+            [X_MAX, CORRIDOR_Z],
+            [X_MAX, Z_MAX],
+            [X_MIN, Z_MAX],
+        ],
+    };
+    nodes.zone_bed1 = {
+        object: 'node',
+        id: 'zone_bed1',
+        type: 'zone',
+        parentId: 'level_0',
+        visible: true,
+        metadata: {},
+        name: 'Bedroom 1',
+        color: '#f472b6',
+        polygon: [
+            [X_MIN, Z_MIN],
+            [BED_X, Z_MIN],
+            [BED_X, CORRIDOR_Z],
+            [X_MIN, CORRIDOR_Z],
+        ],
+    };
+    nodes.zone_bath = {
+        object: 'node',
+        id: 'zone_bath',
+        type: 'zone',
+        parentId: 'level_0',
+        visible: true,
+        metadata: {},
+        name: 'Bath',
+        color: '#a7f3d0',
+        polygon: [
+            [BED_X, Z_MIN],
+            [BATH_X, Z_MIN],
+            [BATH_X, CORRIDOR_Z],
+            [BED_X, CORRIDOR_Z],
+        ],
+    };
+    nodes.zone_bed2 = {
+        object: 'node',
+        id: 'zone_bed2',
+        type: 'zone',
+        parentId: 'level_0',
+        visible: true,
+        metadata: {},
+        name: 'Bedroom 2',
+        color: '#fcd34d',
+        polygon: [
+            [BATH_X, Z_MIN],
+            [X_MAX, Z_MIN],
+            [X_MAX, CORRIDOR_Z],
+            [BATH_X, CORRIDOR_Z],
+        ],
+    };
+    nodes.level_0 = {
+        object: 'node',
+        id: 'level_0',
+        type: 'level',
+        parentId: 'building_2br',
+        visible: true,
+        metadata: {},
+        level: 0,
+        children: [
+            'wall_n',
+            'wall_e',
+            'wall_s',
+            'wall_w',
+            'wall_corr_1',
+            'wall_corr_2',
+            'wall_corr_3',
+            'wall_part_1',
+            'wall_part_2',
+            'zone_living',
+            'zone_bed1',
+            'zone_bath',
+            'zone_bed2',
+        ],
+    };
+    nodes.site_2br.children = [nodes.building_2br];
+    return {
+        nodes: nodes,
+        rootNodeIds: ['site_2br'],
+    };
+}
+export const template = buildTemplate();
+export const metadata = {
+    id: 'two-bedroom',
+    name: 'Two-bedroom apartment',
+    description: '80 m² two-bedroom flat: 9 walls, 4 zones (living/kitchen, 2 bedrooms, bath), 4 doors and 5 windows.',
+};

package/dist/tools/apply-patch.d.ts

@@ -0,0 +1,25 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import type { SceneOperations } from '../operations';
+export declare const applyPatchInput: {
+    patches: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        op: z.ZodLiteral<"create">;
+        node: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        parentId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"update">;
+        id: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"delete">;
+        id: z.ZodString;
+        cascade: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>], "op">>;
+};
+export declare const applyPatchOutput: {
+    appliedOps: z.ZodNumber;
+    deletedIds: z.ZodArray<z.ZodString>;
+    createdIds: z.ZodArray<z.ZodString>;
+};
+export declare function registerApplyPatch(server: McpServer, bridge: SceneOperations): void;
+//# sourceMappingURL=apply-patch.d.ts.map

package/dist/tools/apply-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patch.d.ts","sourceRoot":"","sources":["../../src/tools/apply-patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAKpD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;CAE3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmDnF"}

package/dist/tools/apply-patch.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { ErrorCode, throwMcpError } from './errors';
+import { publishLiveSceneSnapshot } from './live-sync';
+import { PatchSchema } from './schemas';
+export const applyPatchInput = {
+    patches: z.array(PatchSchema),
+};
+export const applyPatchOutput = {
+    appliedOps: z.number(),
+    deletedIds: z.array(z.string()),
+    createdIds: z.array(z.string()),
+};
+export function registerApplyPatch(server, bridge) {
+    server.registerTool('apply_patch', {
+        title: 'Apply patch',
+        description: 'Apply a batch of create/update/delete operations atomically. All patches are validated before any are applied; the entire batch forms a single undo step.',
+        inputSchema: applyPatchInput,
+        outputSchema: applyPatchOutput,
+    }, async ({ patches }) => {
+        const bridgePatches = patches.map((p) => {
+            if (p.op === 'create') {
+                return {
+                    op: 'create',
+                    node: p.node,
+                    ...(p.parentId !== undefined ? { parentId: p.parentId } : {}),
+                };
+            }
+            if (p.op === 'update') {
+                return {
+                    op: 'update',
+                    id: p.id,
+                    data: p.data,
+                };
+            }
+            return {
+                op: 'delete',
+                id: p.id,
+                ...(p.cascade !== undefined ? { cascade: p.cascade } : {}),
+            };
+        });
+        try {
+            const result = bridge.applyPatch(bridgePatches);
+            await publishLiveSceneSnapshot(bridge, 'apply_patch');
+            const payload = {
+                appliedOps: result.appliedOps,
+                deletedIds: result.deletedIds,
+                createdIds: result.createdIds,
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(payload) }],
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throwMcpError(ErrorCode.InvalidParams, msg);
+        }
+    });
+}

package/dist/tools/asset-catalog.d.ts

@@ -0,0 +1,16 @@
+import type { AssetInput } from '@pascal-app/core/schema';
+/**
+ * Small built-in catalog for standalone/headless MCP use.
+ *
+ * The editor has a much larger UI catalog, but depending on `@pascal-app/editor`
+ * from the MCP package would pull browser/React code into the headless server.
+ * These entries mirror the stable IDs and asset paths used by the editor for
+ * common AI-generated residential layouts.
+ */
+export declare const MCP_CATALOG_ITEMS: AssetInput[];
+export declare function findCatalogItem(id: string): AssetInput | undefined;
+export declare function searchCatalogItems(args: {
+    query: string;
+    category?: string | undefined;
+}): AssetInput[];
+//# sourceMappingURL=asset-catalog.d.ts.map

package/dist/tools/asset-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-catalog.d.ts","sourceRoot":"","sources":["../../src/tools/asset-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,EA6RzC,CAAA;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9B,GAAG,UAAU,EAAE,CAUf"}

package/dist/tools/asset-catalog.js

@@ -0,0 +1,308 @@
+/**
+ * Small built-in catalog for standalone/headless MCP use.
+ *
+ * The editor has a much larger UI catalog, but depending on `@pascal-app/editor`
+ * from the MCP package would pull browser/React code into the headless server.
+ * These entries mirror the stable IDs and asset paths used by the editor for
+ * common AI-generated residential layouts.
+ */
+export const MCP_CATALOG_ITEMS = [
+    {
+        id: 'double-bed',
+        category: 'furniture',
+        tags: ['floor', 'bedroom'],
+        name: 'Double Bed',
+        thumbnail: '/items/double-bed/thumbnail.webp',
+        src: '/items/double-bed/model.glb',
+        dimensions: [2, 0.8, 2.5],
+        offset: [0, 0, -0.03],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'single-bed',
+        category: 'furniture',
+        tags: ['floor', 'bedroom'],
+        name: 'Single Bed',
+        thumbnail: '/items/single-bed/thumbnail.webp',
+        src: '/items/single-bed/model.glb',
+        dimensions: [1.5, 0.7, 2.5],
+        offset: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'bedside-table',
+        category: 'furniture',
+        tags: ['floor', 'bedroom'],
+        name: 'Bedside Table',
+        thumbnail: '/items/bedside-table/thumbnail.webp',
+        src: '/items/bedside-table/model.glb',
+        dimensions: [0.5, 0.5, 0.5],
+        offset: [0, 0, -0.01],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+        surface: { height: 0.5 },
+    },
+    {
+        id: 'dresser',
+        category: 'furniture',
+        tags: ['floor', 'storage', 'bedroom'],
+        name: 'Dresser',
+        thumbnail: '/items/dresser/thumbnail.webp',
+        src: '/items/dresser/model.glb',
+        dimensions: [1.5, 0.8, 1],
+        offset: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+        surface: { height: 0.8 },
+    },
+    {
+        id: 'closet',
+        category: 'furniture',
+        tags: ['floor', 'storage', 'bedroom'],
+        name: 'Closet',
+        thumbnail: '/items/closet/thumbnail.webp',
+        src: '/items/closet/model.glb',
+        dimensions: [2, 2.5, 1],
+        offset: [0, 0, -0.01],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'sofa',
+        category: 'furniture',
+        tags: ['floor', 'seating', 'living'],
+        name: 'Sofa',
+        thumbnail: '/items/sofa/thumbnail.webp',
+        src: '/items/sofa/model.glb',
+        dimensions: [2.5, 0.8, 1.5],
+        offset: [0, 0, 0.04],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'livingroom-chair',
+        category: 'furniture',
+        tags: ['floor', 'seating', 'living'],
+        name: 'Livingroom Chair',
+        thumbnail: '/items/livingroom-chair/thumbnail.webp',
+        src: '/items/livingroom-chair/model.glb',
+        dimensions: [1.5, 0.8, 1.5],
+        offset: [0.01, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'coffee-table',
+        category: 'furniture',
+        tags: ['floor', 'table', 'living'],
+        name: 'Coffee Table',
+        thumbnail: '/items/coffee-table/thumbnail.webp',
+        src: '/items/coffee-table/model.glb',
+        dimensions: [2, 0.4, 1.5],
+        offset: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+        surface: { height: 0.3 },
+    },
+    {
+        id: 'tv-stand',
+        category: 'furniture',
+        tags: ['floor', 'storage', 'living'],
+        name: 'TV Stand',
+        thumbnail: '/items/tv-stand/thumbnail.webp',
+        src: '/items/tv-stand/model.glb',
+        dimensions: [2, 0.4, 0.5],
+        offset: [0, 0.21, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+        surface: { height: 0.36 },
+    },
+    {
+        id: 'shelf',
+        category: 'furniture',
+        tags: ['wall', 'storage'],
+        name: 'Shelf',
+        thumbnail: '/items/shelf/thumbnail.webp',
+        src: '/items/shelf/model.glb',
+        dimensions: [1, 0.5, 0.7],
+        offset: [0, 0.1, 0.01],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+        attachTo: 'wall-side',
+        surface: { height: 0.12 },
+    },
+    {
+        id: 'dining-table',
+        category: 'furniture',
+        tags: ['floor', 'table', 'dining'],
+        name: 'Dining Table',
+        thumbnail: '/items/dining-table/thumbnail.webp',
+        src: '/items/dining-table/model.glb',
+        dimensions: [2.5, 0.8, 1],
+        offset: [0, 0, -0.01],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+        surface: { height: 0.8 },
+    },
+    {
+        id: 'dining-chair',
+        category: 'furniture',
+        tags: ['floor', 'seating', 'dining'],
+        name: 'Dining Chair',
+        thumbnail: '/items/dining-chair/thumbnail.webp',
+        src: '/items/dining-chair/model.glb',
+        dimensions: [0.5, 1, 0.5],
+        offset: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'kitchen',
+        category: 'kitchen',
+        tags: ['floor', 'large', 'kitchen'],
+        name: 'Kitchen',
+        thumbnail: '/items/kitchen/thumbnail.webp',
+        src: '/items/kitchen/model.glb',
+        dimensions: [2.5, 1.1, 1],
+        offset: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'kitchen-counter',
+        category: 'kitchen',
+        tags: ['floor', 'large', 'storage', 'kitchen'],
+        name: 'Kitchen Counter',
+        thumbnail: '/items/kitchen-counter/thumbnail.webp',
+        src: '/items/kitchen-counter/model.glb',
+        dimensions: [2, 0.8, 1],
+        offset: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+        surface: { height: 0.75 },
+    },
+    {
+        id: 'stove',
+        category: 'kitchen',
+        tags: ['floor', 'large', 'kitchen'],
+        name: 'Stove',
+        thumbnail: '/items/stove/thumbnail.webp',
+        src: '/items/stove/model.glb',
+        dimensions: [1, 1, 1],
+        offset: [0, 0, -0.05],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'fridge',
+        category: 'kitchen',
+        tags: ['floor', 'large', 'kitchen'],
+        name: 'Fridge',
+        thumbnail: '/items/fridge/thumbnail.webp',
+        src: '/items/fridge/model.glb',
+        dimensions: [1, 2, 1],
+        offset: [0.01, 0, -0.05],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'toilet',
+        category: 'bathroom',
+        tags: ['floor', 'large', 'bathroom'],
+        name: 'Toilet',
+        thumbnail: '/items/toilet/thumbnail.webp',
+        src: '/items/toilet/model.glb',
+        dimensions: [1, 0.9, 1],
+        offset: [0, 0, -0.23],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'bathroom-sink',
+        category: 'bathroom',
+        tags: ['floor', 'large', 'bathroom'],
+        name: 'Bathroom Sink',
+        thumbnail: '/items/bathroom-sink/thumbnail.webp',
+        src: '/items/bathroom-sink/model.glb',
+        dimensions: [2, 1, 1.5],
+        offset: [0.11, 0, 0.02],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'shower-square',
+        category: 'bathroom',
+        tags: ['floor', 'large', 'bathroom'],
+        name: 'Squared Shower',
+        thumbnail: '/items/shower-square/thumbnail.webp',
+        src: '/items/shower-square/model.glb',
+        dimensions: [1, 2, 1],
+        offset: [0.41, 0, -0.42],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'bathtub',
+        category: 'bathroom',
+        tags: ['floor', 'large', 'bathroom'],
+        name: 'Bathtub',
+        thumbnail: '/items/bathtub/thumbnail.webp',
+        src: '/items/bathtub/model.glb',
+        dimensions: [2.5, 0.8, 1.5],
+        offset: [0, 0, 0.01],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'washing-machine',
+        category: 'bathroom',
+        tags: ['floor', 'large', 'electronics', 'laundry'],
+        name: 'Washing Machine',
+        thumbnail: '/items/washing-machine/thumbnail.webp',
+        src: '/items/washing-machine/model.glb',
+        dimensions: [1, 1, 1],
+        offset: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'drying-rack',
+        category: 'bathroom',
+        tags: ['floor', 'laundry'],
+        name: 'Drying Rack',
+        thumbnail: '/items/drying-rack/thumbnail.webp',
+        src: '/items/drying-rack/model.glb',
+        dimensions: [2, 1.1, 1],
+        offset: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+    {
+        id: 'coat-rack',
+        category: 'furniture',
+        tags: ['floor', 'storage', 'entry'],
+        name: 'Coat Rack',
+        thumbnail: '/items/coat-rack/thumbnail.webp',
+        src: '/items/coat-rack/model.glb',
+        dimensions: [0.5, 1.8, 0.5],
+        offset: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+    },
+];
+export function findCatalogItem(id) {
+    return MCP_CATALOG_ITEMS.find((item) => item.id === id);
+}
+export function searchCatalogItems(args) {
+    const terms = args.query.trim().toLowerCase().split(/\s+/).filter(Boolean);
+    return MCP_CATALOG_ITEMS.filter((item) => {
+        if (args.category && item.category !== args.category)
+            return false;
+        const haystack = [item.id, item.name, item.category, ...(item.tags ?? [])]
+            .join(' ')
+            .toLowerCase();
+        return terms.every((term) => haystack.includes(term));
+    });
+}