@pascal-app/mcp 0.3.2 → 1.0.0-beta.1

package/dist/operations/scene-operations.js

@@ -166,17 +166,17 @@ class SceneOperationsFacade {
         return this.requireStore().rename(id, newName, options);
     }
     async appendSceneEvent(options) {
-        const append = this.requireStore().appendSceneEvent;
-        if (!append)
+        const store = this.requireStore();
+        if (!store.appendSceneEvent)
             return null;
-        return append(options);
+        return store.appendSceneEvent(options);
     }
     async listSceneEvents(id, options) {
-        const list = this.requireStore().listSceneEvents;
-        if (!list) {
+        const store = this.requireStore();
+        if (!store.listSceneEvents) {
             throw new Error('scene_events_unavailable');
         }
-        return list(id, options);
+        return store.listSceneEvents(id, options);
     }
     requireBridge() {
         if (!this.#bridge) {

package/dist/templates/empty-studio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"empty-studio.d.ts","sourceRoot":"","sources":["../../src/templates/empty-studio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAsPpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;;;;CAKX,CAAA"}
+{"version":3,"file":"empty-studio.d.ts","sourceRoot":"","sources":["../../src/templates/empty-studio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAmPpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;;;;CAKX,CAAA"}

package/dist/templates/empty-studio.js

@@ -1,3 +1,4 @@
+import { DEFAULT_LEVEL_HEIGHT } from '@pascal-app/core';
 /**
  * 40 m² studio apartment — a single open room with one window, one front door
  * and a single "Living/Kitchen" zone. Used as a starting point for small unit
@@ -117,7 +118,6 @@ function buildNodes() {
         metadata: {},
         children: [],
         thickness: 0.1,
-        height: 2.5,
         start: [-W, -D],
         end: [W, -D],
         frontSide: 'unknown',
@@ -132,7 +132,6 @@ function buildNodes() {
         metadata: {},
         children: [],
         thickness: 0.1,
-        height: 2.5,
         start: [W, -D],
         end: [W, D],
         frontSide: 'unknown',
@@ -147,7 +146,6 @@ function buildNodes() {
         metadata: {},
         children: ['door_front'],
         thickness: 0.1,
-        height: 2.5,
         start: [W, D],
         end: [-W, D],
         frontSide: 'unknown',
@@ -162,7 +160,6 @@ function buildNodes() {
         metadata: {},
         children: ['window_w'],
         thickness: 0.1,
-        height: 2.5,
         start: [-W, D],
         end: [-W, -D],
         frontSide: 'unknown',
@@ -192,6 +189,7 @@ function buildNodes() {
         visible: true,
         metadata: {},
         level: 0,
+        height: DEFAULT_LEVEL_HEIGHT,
         children: [...wallIds, 'zone_living'],
     };
     return {

package/dist/templates/garden-house.js

@@ -28,7 +28,6 @@ function wall(id, start, end, children = []) {
         metadata: {},
         children,
         thickness: WALL_THICKNESS,
-        height: WALL_HEIGHT,
         start,
         end,
         frontSide: 'unknown',
@@ -216,6 +215,7 @@ function buildTemplate() {
         visible: true,
         metadata: {},
         level: 0,
+        height: WALL_HEIGHT,
         children: [
             'wall_n',
             'wall_e',

package/dist/templates/two-bedroom.js

@@ -31,7 +31,6 @@ function wall(id, start, end, children = []) {
         metadata: {},
         children,
         thickness: WALL_THICKNESS,
-        height: WALL_HEIGHT,
         start,
         end,
         frontSide: 'unknown',
@@ -240,6 +239,7 @@ function buildTemplate() {
         visible: true,
         metadata: {},
         level: 0,
+        height: WALL_HEIGHT,
         children: [
             'wall_n',
             'wall_e',

package/dist/tools/construction-tools.d.ts

@@ -4,7 +4,7 @@ import type { SceneOperations } from '../operations';
 export declare const createStoryShellInput: {
     levelId: z.ZodString;
     footprint: z.ZodArray<z.ZodArray<z.ZodNumber>>;
-    wallHeight: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+    wallHeight: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
     wallThickness: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
     createSlab: z.ZodDefault<z.ZodBoolean>;
     createCeiling: z.ZodDefault<z.ZodBoolean>;
@@ -62,7 +62,7 @@ export declare const createStairBetweenLevelsInput: {
     rotation: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
     width: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
     runLength: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
-    totalRise: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+    totalRise: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
     stepCount: z.ZodDefault<z.ZodNumber>;
     railingMode: z.ZodDefault<z.ZodEnum<{
         none: "none";

package/dist/tools/construction-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"construction-tools.d.ts","sourceRoot":"","sources":["../../src/tools/construction-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAaxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAQpD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAqBjC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;CAMlC,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;CA0B3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;CAM5B,CAAA;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCzC,CAAA;AAED,eAAO,MAAM,8BAA8B;;;;;;CAM1C,CAAA;AA4GD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiT1F"}
+{"version":3,"file":"construction-tools.d.ts","sourceRoot":"","sources":["../../src/tools/construction-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAcxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAQpD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAsBjC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;CAMlC,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;CA0B3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;CAM5B,CAAA;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCzC,CAAA;AAED,eAAO,MAAM,8BAA8B;;;;;;CAM1C,CAAA;AA4GD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmU1F"}

package/dist/tools/construction-tools.js

@@ -1,3 +1,4 @@
+import { resolveStairTotalRise } from '@pascal-app/core';
 import { CeilingNode, getActiveRoofHeight, LevelNode, RoofNode, RoofSegmentNode, SlabNode, StairNode, StairSegmentNode, WallNode, } from '@pascal-app/core/schema';
 import { z } from 'zod';
 import { publishLiveSceneSnapshot } from './live-sync';
@@ -8,7 +9,10 @@ const RAILING_MODES = ['none', 'left', 'right', 'both'];
 export const createStoryShellInput = {
     levelId: NodeIdSchema,
     footprint: z.array(Vec2Schema).min(3),
-    wallHeight: measurement('length', 'm', { positive: true, description: 'Wall height.' }).default(2.8),
+    wallHeight: measurement('length', 'm', {
+        positive: true,
+        description: 'Explicit wall height override. Omit for level-plane-bound walls.',
+    }).optional(),
     wallThickness: measurement('length', 'm', {
         positive: true,
         description: 'Wall thickness.',
@@ -77,7 +81,7 @@ export const createStairBetweenLevelsInput = {
     totalRise: measurement('length', 'm', {
         positive: true,
         description: 'Total vertical rise.',
-    }).default(2.8),
+    }).optional(),
     stepCount: z.number().int().positive().default(14),
     railingMode: z.enum(RAILING_MODES).default('both'),
     destinationSlabId: NodeIdSchema.optional(),
@@ -200,7 +204,7 @@ export function registerConstructionTools(server, bridge) {
                 start: points[i],
                 end: points[(i + 1) % points.length],
                 thickness: wallThickness,
-                height: wallHeight,
+                ...(wallHeight !== undefined ? { height: wallHeight } : {}),
                 frontSide: 'exterior',
                 backSide: 'interior',
                 ...(wallMaterialPreset ? { materialPreset: wallMaterialPreset } : {}),
@@ -215,6 +219,11 @@ export function registerConstructionTools(server, bridge) {
                 name: namePrefix ? `${namePrefix} Slab` : undefined,
                 polygon: points,
                 elevation: slabElevation,
+                // Grounded solid: underside on the level plane, so the created
+                // story slab occupies [0, slabElevation] like the legacy
+                // extrude-from-zero model.
+                thickness: Math.max(slabElevation, 0),
+                recessed: slabElevation < 0,
                 ...(slabMaterialPreset ? { materialPreset: slabMaterialPreset } : {}),
                 metadata: { role: 'story-slab' },
             });
@@ -223,10 +232,13 @@ export function registerConstructionTools(server, bridge) {
         }
         let ceilingId = null;
         if (createCeiling) {
+            // Height-less unless the caller pinned one: a new story ceiling
+            // follows the level top automatically.
+            const explicitCeilingHeight = ceilingHeight ?? wallHeight;
             const ceiling = CeilingNode.parse({
                 name: namePrefix ? `${namePrefix} Ceiling` : undefined,
                 polygon: points,
-                height: ceilingHeight ?? wallHeight,
+                ...(explicitCeilingHeight !== undefined ? { height: explicitCeilingHeight } : {}),
                 ...(ceilingMaterialPreset ? { materialPreset: ceilingMaterialPreset } : {}),
                 metadata: { role: 'story-ceiling' },
             });
@@ -268,12 +280,12 @@ export function registerConstructionTools(server, bridge) {
             const roofLevel = LevelNode.parse({
                 name: roofLevelLabel,
                 level: roofLevelElevation ?? nextLevelIndex(bridge, buildingId, referenceLevel),
+                height: roofLevelHeight ?? Math.max(wallHeight + peakHeight, 0.2),
                 children: [],
                 metadata: {
                     role: 'roof',
                     label: roofLevelLabel,
                     referenceLevelId: levelId,
-                    height: roofLevelHeight ?? Math.max(wallHeight + peakHeight, 0.2),
                 },
             });
             targetRoofLevelId = roofLevel.id;
@@ -325,15 +337,7 @@ export function registerConstructionTools(server, bridge) {
         if (isRoofLevel(fromLevel) || isRoofLevel(toLevel)) {
             throw new Error('Roof support levels are not occupied stories; create a separate occupied attic/story level if a stair-accessible attic is required');
         }
-        const segment = StairSegmentNode.parse({
-            segmentType: 'stair',
-            width,
-            length: runLength,
-            height: totalRise,
-            stepCount,
-            ...(materialPreset ? { materialPreset } : {}),
-        });
-        const stair = StairNode.parse({
+        const stairDraft = StairNode.parse({
             name: name ?? 'Stair',
             position: position,
             rotation,
@@ -343,15 +347,33 @@ export function registerConstructionTools(server, bridge) {
             slabOpeningMode: 'none',
             openingOffset,
             width,
-            totalRise,
+            ...(totalRise !== undefined ? { totalRise } : {}),
             stepCount,
             railingMode,
-            children: [segment.id],
+            children: [],
             ...(materialPreset ? { materialPreset } : {}),
             metadata: {
                 openingManaged: 'manual-rectangular',
             },
         });
+        const riseNodes = {
+            ...bridge.getNodes(),
+            [fromLevel.id]: {
+                ...fromLevel,
+                children: [...fromLevel.children, stairDraft.id],
+            },
+            [stairDraft.id]: stairDraft,
+        };
+        const resolvedTotalRise = resolveStairTotalRise(stairDraft, riseNodes);
+        const segment = StairSegmentNode.parse({
+            segmentType: 'stair',
+            width,
+            length: runLength,
+            height: resolvedTotalRise,
+            stepCount,
+            ...(materialPreset ? { materialPreset } : {}),
+        });
+        const stair = { ...stairDraft, children: [segment.id] };
         const openingPolygon = rectangularOpening({
             position: position,
             rotation,

package/dist/tools/create-level.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-level.d.ts","sourceRoot":"","sources":["../../src/tools/create-level.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAMpD,eAAO,MAAM,gBAAgB;;;;;CAQ5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;CAE7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA0CpF"}
+{"version":3,"file":"create-level.d.ts","sourceRoot":"","sources":["../../src/tools/create-level.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAIxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAMpD,eAAO,MAAM,gBAAgB;;;;;CAW5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;CAE7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA+CpF"}

package/dist/tools/create-level.js

@@ -1,3 +1,4 @@
+import { DEFAULT_LEVEL_HEIGHT } from '@pascal-app/core';
 import { LevelNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
 import { ErrorCode, throwMcpError } from './errors';
@@ -6,10 +7,13 @@ import { measurement } from './measurement';
 import { NodeIdSchema } from './schemas';
 export const createLevelInput = {
     buildingId: NodeIdSchema,
-    elevation: z.number().optional(),
+    elevation: z
+        .number()
+        .optional()
+        .describe("Legacy parameter; new levels are appended above the building's current top level."),
     height: measurement('length', 'm', {
         min: 0,
-        description: 'Level height (stored in metadata).',
+        description: 'Stored floor-to-floor storey height.',
     }).optional(),
     label: z.string().optional(),
 };
@@ -19,10 +23,10 @@ export const createLevelOutput = {
 export function registerCreateLevel(server, bridge) {
     server.registerTool('create_level', {
         title: 'Create level',
-        description: 'Create a new level node attached to the given building. height and label are stored in metadata.',
+        description: "Append a new level above the given building's current top level. height is stored as the level's floor-to-floor storey height.",
         inputSchema: createLevelInput,
         outputSchema: createLevelOutput,
-    }, async ({ buildingId, elevation, height, label }) => {
+    }, async ({ buildingId, height, label }) => {
         const parent = bridge.getNode(buildingId);
         if (!parent) {
             throwMcpError(ErrorCode.InvalidParams, `Building not found: ${buildingId}`);
@@ -31,12 +35,16 @@ export function registerCreateLevel(server, bridge) {
             throwMcpError(ErrorCode.InvalidParams, `Node ${buildingId} is a ${parent.type}, expected building`);
         }
         const metadata = {};
-        if (height !== undefined)
-            metadata.height = height;
         if (label !== undefined)
             metadata.label = label;
+        const existingOrdinals = bridge
+            .getChildren(buildingId)
+            .filter((node) => node.type === 'level')
+            .map((node) => node.level);
+        const nextOrdinal = Math.max(-1, ...existingOrdinals) + 1;
         const levelNode = LevelNode.parse({
-            level: elevation ?? 0,
+            level: nextOrdinal,
+            height: height ?? DEFAULT_LEVEL_HEIGHT,
             children: [],
             ...(Object.keys(metadata).length > 0 ? { metadata } : {}),
             ...(label !== undefined ? { name: label } : {}),

package/dist/tools/describe-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describe-node.d.ts","sourceRoot":"","sources":["../../src/tools/describe-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD,eAAO,MAAM,iBAAiB;;CAE7B,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;;;;CAQ9B,CAAA;AA0CD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAwCrF"}
+{"version":3,"file":"describe-node.d.ts","sourceRoot":"","sources":["../../src/tools/describe-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAKpD,eAAO,MAAM,iBAAiB;;CAE7B,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;;;;CAQ9B,CAAA;AA0CD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgDrF"}

package/dist/tools/describe-node.js

@@ -1,5 +1,7 @@
+import { resolveCeilingHeight } from '@pascal-app/core';
 import { z } from 'zod';
 import { ErrorCode, throwMcpError } from './errors';
+import { resolveReportedWallHeight } from './scene-query';
 import { NodeIdSchema } from './schemas';
 export const describeNodeInput = {
     id: NodeIdSchema,
@@ -17,13 +19,13 @@ export const describeNodeOutput = {
  * Build a short, human-readable one-liner describing the node.
  * Covers the common shapes; falls back to a generic sentence otherwise.
  */
-function describe(node) {
+function describe(node, bridge) {
     switch (node.type) {
         case 'wall': {
             const [x1, z1] = node.start;
             const [x2, z2] = node.end;
             const t = node.thickness ?? 0.1;
-            const h = node.height ?? 2.5;
+            const h = resolveReportedWallHeight(bridge, node);
             return `Wall from (${x1},${z1}) to (${x2},${z2}), thickness ${t.toFixed(2)}m, height ${h.toFixed(2)}m`;
         }
         case 'level':
@@ -39,7 +41,7 @@ function describe(node) {
         case 'slab':
             return `Slab with ${node.polygon.length} vertices`;
         case 'ceiling':
-            return `Ceiling with ${node.polygon.length} vertices, height ${node.height.toFixed(2)}m`;
+            return `Ceiling with ${node.polygon.length} vertices, height ${resolveCeilingHeight(node, bridge.getNodes()).toFixed(2)}m`;
         case 'door':
             return `Door (${node.width.toFixed(2)}m x ${node.height.toFixed(2)}m)`;
         case 'window':
@@ -69,14 +71,21 @@ export function registerDescribeNode(server, bridge) {
         const children = bridge.getChildren(id);
         const childrenIds = children.map((n) => n.id);
         const n = node;
+        const properties = n.type === 'wall'
+            ? {
+                ...n,
+                resolvedHeight: resolveReportedWallHeight(bridge, n),
+                heightIsExplicit: n.height !== undefined,
+            }
+            : n;
         const payload = {
             id: n.id,
             type: n.type,
             parentId: (n.parentId ?? null),
             ancestryIds,
             childrenIds,
-            properties: n,
-            description: describe(n),
+            properties: properties,
+            description: describe(n, bridge),
         };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],

package/dist/tools/photo-to-scene/photo-to-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"photo-to-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/photo-to-scene/photo-to-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAYxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAIvD;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;CAa7B,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;;;;CAQ9B,CAAA;AAiTD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA6ErF"}
+{"version":3,"file":"photo-to-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/photo-to-scene/photo-to-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAYxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAIvD;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;CAa7B,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;;;;CAQ9B,CAAA;AAmTD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA6ErF"}

package/dist/tools/photo-to-scene/photo-to-scene.js

@@ -40,6 +40,7 @@ const VisionResponseSchema = z.object({
         start: z.tuple([z.number(), z.number()]),
         end: z.tuple([z.number(), z.number()]),
         thickness: z.number().optional(),
+        height: z.number().positive().optional(),
     })),
     rooms: z.array(z.object({
         name: z.string(),
@@ -61,13 +62,14 @@ const SYSTEM_PROMPT = `You are a vision assistant that extracts structured floor
 Your ONLY job: return a JSON object that exactly matches this schema — no prose, no markdown fences.
 
 {
-  "walls": [{ "start": [x, z], "end": [x, z], "thickness": number? }, ...],
+  "walls": [{ "start": [x, z], "end": [x, z], "thickness": number?, "height": number? }, ...],
   "rooms": [{ "name": string, "polygon": [[x,z], ...], "approximateAreaSqM": number? }, ...],
   "approximateDimensions": { "widthM": number, "depthM": number },
   "confidence": number 0..1
 }
 
 Coordinates are in metres. Origin can be the floor plan's centre or bottom-left — be consistent.
+Only include a wall height when it is visibly measured or annotated in the image.
 If the image is unclear, lower the confidence score but still produce your best attempt.
 DO NOT wrap the JSON in markdown. DO NOT explain. Just output the raw JSON.`;
 const DATA_URI_RE = /^data:(image\/[a-z0-9.+-]+);base64,(.+)$/i;
@@ -170,7 +172,7 @@ function buildSceneGraphFromVision(vision, defaultWallThickness, defaultWallHeig
     const warnings = [];
     // Build the skeleton: site → building → level.
     const building = BuildingNode.parse({});
-    const level = LevelNode.parse({ level: 0 });
+    const level = LevelNode.parse({ level: 0, height: defaultWallHeight });
     const site = SiteNode.parse({ children: [building.id] });
     // Link parent ids so downstream traversal works.
     const siteId = site.id;
@@ -208,7 +210,7 @@ function buildSceneGraphFromVision(vision, defaultWallThickness, defaultWallHeig
                 start: w.start,
                 end: w.end,
                 thickness: w.thickness ?? defaultWallThickness,
-                height: defaultWallHeight,
+                ...(w.height !== undefined ? { height: w.height } : {}),
             });
             const linkedWall = {
                 ...wall,

package/dist/tools/scene-query.d.ts

@@ -1,4 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AnyNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
 import type { SceneOperations } from '../operations';
 export declare const levelScopedInput: {
@@ -48,6 +49,9 @@ export declare const verifySceneOutput: {
     issues: z.ZodArray<z.ZodString>;
     hasIssues: z.ZodBoolean;
 };
+export declare function resolveReportedWallHeight(bridge: SceneOperations, wall: Extract<AnyNode, {
+    type: 'wall';
+}>): number;
 export declare function registerListLevels(server: McpServer, bridge: SceneOperations): void;
 export declare function registerGetLevelSummary(server: McpServer, bridge: SceneOperations): void;
 export declare function registerGetWalls(server: McpServer, bridge: SceneOperations): void;

package/dist/tools/scene-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-query.d.ts","sourceRoot":"","sources":["../../src/tools/scene-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAWpD,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAID,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;CAcjC,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAA;AA2YD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAyCnF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgBxF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmBjF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmBjF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAkQpF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAMxF"}
+{"version":3,"file":"scene-query.d.ts","sourceRoot":"","sources":["../../src/tools/scene-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAQxE,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,yBAAyB,CAAA;AAEjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAWpD,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAID,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;CAcjC,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAA;AA8CD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACvC,MAAM,CAgBR;AAkWD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAyCnF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgBxF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmBjF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmBjF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA4PpF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAMxF"}

package/dist/tools/scene-query.js

@@ -1,3 +1,5 @@
+import { DEFAULT_LEVEL_HEIGHT, getStoredLevelHeight, getWallPlaneTop, resolveStairTotalRise, resolveWallEffectiveHeight, } from '@pascal-app/core';
+import { computeWallSlabSupport } from '@pascal-app/core/spatial-grid';
 import { z } from 'zod';
 import { distance2D, pointInPolygon, polygonArea, polygonContainsPolygon, wallLength, } from './geometry';
 import { NodeIdSchema } from './schemas';
@@ -71,6 +73,19 @@ function getDefaultLevelId(bridge, requested) {
 function nodesOnLevel(bridge, levelId) {
     return Object.values(bridge.getNodes()).filter((node) => node.id !== levelId && bridge.resolveLevelId(node.id) === levelId);
 }
+export function resolveReportedWallHeight(bridge, wall) {
+    const levelId = bridge.resolveLevelId(wall.id);
+    // Covering-clamped plane for plane-bound walls; explicit heights pass
+    // through resolveWallEffectiveHeight untouched.
+    const planeTop = levelId
+        ? getWallPlaneTop(wall, levelId, bridge.getNodes())
+        : DEFAULT_LEVEL_HEIGHT;
+    const levelNodes = levelId ? nodesOnLevel(bridge, levelId) : [];
+    const slabs = levelNodes.filter((node) => node.type === 'slab');
+    const walls = levelNodes.filter((node) => node.type === 'wall');
+    const support = computeWallSlabSupport(wall, slabs, walls, wall.supportSlabId);
+    return resolveWallEffectiveHeight(wall, planeTop, support.elevation);
+}
 function metadataRecord(node) {
     return typeof node.metadata === 'object' && node.metadata !== null
         ? node.metadata
@@ -116,6 +131,7 @@ function wallSummary(bridge, wall) {
     if (wall.type !== 'wall')
         return null;
     const length = distance2D(wall.start, wall.end);
+    const resolvedHeight = resolveReportedWallHeight(bridge, wall);
     return {
         id: wall.id,
         name: wall.name,
@@ -123,6 +139,8 @@ function wallSummary(bridge, wall) {
         end: wall.end,
         length: Math.round(length * 100) / 100,
         height: wall.height,
+        resolvedHeight,
+        heightIsExplicit: wall.height !== undefined,
         thickness: wall.thickness,
         openings: openingSummaries(bridge, wall.id),
     };
@@ -235,7 +253,7 @@ function stairFootprintPolygons(bridge, stair) {
             {
                 width: stair.width ?? 1,
                 length: 3,
-                height: stair.totalRise ?? 2.5,
+                height: resolveStairTotalRise(stair, nodes),
                 stepCount: stair.stepCount ?? 10,
                 attachmentSide: 'front',
             },
@@ -524,14 +542,9 @@ export function registerVerifyScene(server, bridge) {
                 const summary = levels.find((entry) => entry.levelId === level.id);
                 if (!summary?.isOccupiedStory)
                     continue;
-                const expectedHeight = typeof level.metadata === 'object' &&
-                    level.metadata !== null &&
-                    'height' in level.metadata &&
-                    typeof level.metadata.height === 'number'
-                    ? level.metadata.height
-                    : 3.2;
+                const expectedHeight = getStoredLevelHeight(level);
                 for (const wall of nodesOnLevel(bridge, level.id).filter((node) => node.type === 'wall')) {
-                    const wallHeight = wall.height ?? 2.5;
+                    const wallHeight = resolveReportedWallHeight(bridge, wall);
                     if (wallHeight > expectedHeight + 0.25) {
                         issues.push(`Wall ${wall.name ?? wall.id} on ${level.name ?? level.id} is ${wallHeight}m high; multi-story exterior walls should be split into level-owned story walls`);
                     }
@@ -558,7 +571,7 @@ export function registerVerifyScene(server, bridge) {
                 if (localX - width / 2 < -0.01 || localX + width / 2 > length + 0.01) {
                     issues.push(`${node.type} ${node.id} extends outside wall ${parent.id}`);
                 }
-                const wallHeight = parent.height ?? 2.5;
+                const wallHeight = resolveReportedWallHeight(bridge, parent);
                 const bottom = node.position[1] - height / 2;
                 const top = node.position[1] + height / 2;
                 if (bottom < -0.01 || top > wallHeight + 0.01) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pascal-app/mcp",
-  "version": "0.3.2",
+  "version": "1.0.0-beta.1",
   "description": "Model Context Protocol server for Pascal 3D editor",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,7 +55,7 @@
     "prepublishOnly": "bun run build && bun test"
   },
   "peerDependencies": {
-    "@pascal-app/core": "^0.9.2"
+    "@pascal-app/core": "^1.0.0-beta.1"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -63,7 +63,7 @@
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@pascal-app/core": "^0.9.2",
+    "@pascal-app/core": "^1.0.0-beta.1",
     "@pascal/typescript-config": "*",
     "@types/node": "^22.19.20",
     "typescript": "6.0.3"