@pascal-app/mcp 1.0.0-beta.5 → 1.0.0

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

@@ -16,6 +16,13 @@ export declare const createStoryShellInput: {
     ceilingMaterialPreset: z.ZodOptional<z.ZodString>;
 };
 export declare const createStoryShellOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     levelId: z.ZodString;
     wallIds: z.ZodArray<z.ZodString>;
     slabId: z.ZodNullable<z.ZodString>;
@@ -33,13 +40,14 @@ export declare const createRoofInput: {
     width: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
     depth: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
     roofType: z.ZodDefault<z.ZodEnum<{
+        gable: "gable";
         flat: "flat";
         hip: "hip";
-        gable: "gable";
         shed: "shed";
         gambrel: "gambrel";
         dutch: "dutch";
         mansard: "mansard";
+        conical: "conical";
     }>>;
     pitch: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
     wallHeight: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
@@ -49,6 +57,13 @@ export declare const createRoofInput: {
     name: z.ZodOptional<z.ZodString>;
 };
 export declare const createRoofOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     referenceLevelId: z.ZodString;
     roofLevelId: z.ZodString;
     createdRoofLevelId: z.ZodNullable<z.ZodString>;
@@ -83,6 +98,13 @@ export declare const createStairBetweenLevelsInput: {
     name: z.ZodOptional<z.ZodString>;
 };
 export declare const createStairBetweenLevelsOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     stairId: z.ZodString;
     stairSegmentId: z.ZodString;
     destinationSlabId: z.ZodNullable<z.ZodString>;

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;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"}
+{"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;AAkBpD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAsBjC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAOlC,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAO5B,CAAA;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCzC,CAAA;AAED,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;CAO1C,CAAA;AA4GD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgV1F"}

package/dist/tools/construction-tools.js

@@ -1,10 +1,20 @@
 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';
+import { ADDITIVE_TOOL_ANNOTATIONS, DESTRUCTIVE_TOOL_ANNOTATIONS } from './annotations';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync';
 import { measurement } from './measurement';
 import { NodeIdSchema, Vec2Schema, Vec3Schema } from './schemas';
-const ROOF_TYPES = ['hip', 'gable', 'shed', 'gambrel', 'dutch', 'mansard', 'flat'];
+const ROOF_TYPES = [
+    'hip',
+    'gable',
+    'shed',
+    'gambrel',
+    'dutch',
+    'mansard',
+    'flat',
+    'conical',
+];
 const RAILING_MODES = ['none', 'left', 'right', 'both'];
 export const createStoryShellInput = {
     levelId: NodeIdSchema,
@@ -35,6 +45,7 @@ export const createStoryShellOutput = {
     slabId: z.string().nullable(),
     ceilingId: z.string().nullable(),
     createdIds: z.array(z.string()),
+    ...liveSyncOutput,
 };
 export const createRoofInput = {
     levelId: NodeIdSchema,
@@ -67,6 +78,7 @@ export const createRoofOutput = {
     createdRoofLevelId: z.string().nullable(),
     roofId: z.string(),
     roofSegmentId: z.string(),
+    ...liveSyncOutput,
 };
 export const createStairBetweenLevelsInput = {
     fromLevelId: NodeIdSchema,
@@ -108,6 +120,7 @@ export const createStairBetweenLevelsOutput = {
     destinationSlabId: z.string().nullable(),
     sourceCeilingId: z.string().nullable(),
     openingPolygon: z.array(Vec2Schema),
+    ...liveSyncOutput,
 };
 function textResult(payload) {
     return {
@@ -190,6 +203,7 @@ export function registerConstructionTools(server, bridge) {
         description: 'Create one level-owned building shell from a footprint: perimeter walls plus optional slab and ceiling. Use once per story; do not make first-floor walls span multiple stories.',
         inputSchema: createStoryShellInput,
         outputSchema: createStoryShellOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ levelId, footprint, wallHeight, wallThickness, createSlab, createCeiling, slabElevation, ceilingHeight, namePrefix, wallMaterialPreset, slabMaterialPreset, ceilingMaterialPreset, }) => {
         const level = assertNode(bridge, levelId, 'level');
         if (isRoofLevel(level)) {
@@ -246,13 +260,14 @@ export function registerConstructionTools(server, bridge) {
             patches.push({ op: 'create', node: ceiling, parentId: levelId });
         }
         const result = bridge.applyPatch(patches);
-        await publishLiveSceneSnapshot(bridge, 'create_story_shell');
+        const persistence = await publishLiveSceneSnapshot(bridge, 'create_story_shell');
         return textResult({
             levelId,
             wallIds,
             slabId,
             ceilingId,
             createdIds: result.createdIds,
+            ...persistencePayload(persistence),
         });
     });
     server.registerTool('create_roof', {
@@ -260,10 +275,18 @@ export function registerConstructionTools(server, bridge) {
         description: 'Create a roof container with one roof segment. By default creates a dedicated roof level above the reference level so exploded/solo level views can isolate the roof.',
         inputSchema: createRoofInput,
         outputSchema: createRoofOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ levelId, roofLevelId, useDedicatedRoofLevel, roofLevelLabel, roofLevelElevation, roofLevelHeight, center, width, depth, roofType, pitch, wallHeight, wallThickness, overhang, materialPreset, name, }) => {
+        const effectiveWidth = roofType === 'conical' ? Math.max(width, depth) : width;
+        const effectiveDepth = roofType === 'conical' ? effectiveWidth : depth;
         // Peak height is derived from pitch + footprint + type; we still
         // need it to size the auto-generated roof level container below.
-        const peakHeight = getActiveRoofHeight({ roofType, pitch, width, depth });
+        const peakHeight = getActiveRoofHeight({
+            roofType,
+            pitch,
+            width: effectiveWidth,
+            depth: effectiveDepth,
+        });
         const referenceLevel = assertNode(bridge, levelId, 'level');
         const patches = [];
         let targetRoofLevelId = levelId;
@@ -294,8 +317,8 @@ export function registerConstructionTools(server, bridge) {
         }
         const segment = RoofSegmentNode.parse({
             roofType,
-            width,
-            depth,
+            width: effectiveWidth,
+            depth: effectiveDepth,
             wallHeight,
             pitch,
             wallThickness,
@@ -317,13 +340,14 @@ export function registerConstructionTools(server, bridge) {
             { op: 'create', node: roof, parentId: targetRoofLevelId },
             { op: 'create', node: segment, parentId: roof.id },
         ]);
-        await publishLiveSceneSnapshot(bridge, 'create_roof');
+        const persistence = await publishLiveSceneSnapshot(bridge, 'create_roof');
         return textResult({
             referenceLevelId: levelId,
             roofLevelId: targetRoofLevelId,
             createdRoofLevelId,
             roofId: roof.id,
             roofSegmentId: segment.id,
+            ...persistencePayload(persistence),
         });
     });
     server.registerTool('create_stair_between_levels', {
@@ -331,6 +355,7 @@ export function registerConstructionTools(server, bridge) {
         description: 'Create a straight stair and a single rectangular manual opening in the destination slab/source ceiling. This disables stair auto-opening mode to avoid duplicate or irregular holes.',
         inputSchema: createStairBetweenLevelsInput,
         outputSchema: createStairBetweenLevelsOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ fromLevelId, toLevelId, position, rotation, width, runLength, totalRise, stepCount, railingMode, destinationSlabId, sourceCeilingId, createDestinationSlabOpening, createSourceCeilingOpening, openingWidth, openingLength, openingOffset, openingCenter, openingRotation, materialPreset, name, }) => {
         const fromLevel = assertNode(bridge, fromLevelId, 'level');
         const toLevel = assertNode(bridge, toLevelId, 'level');
@@ -408,13 +433,14 @@ export function registerConstructionTools(server, bridge) {
             });
         }
         bridge.applyPatch(patches);
-        await publishLiveSceneSnapshot(bridge, 'create_stair_between_levels');
+        const persistence = await publishLiveSceneSnapshot(bridge, 'create_stair_between_levels');
         return textResult({
             stairId: stair.id,
             stairSegmentId: segment.id,
             destinationSlabId: destinationSlab?.id ?? null,
             sourceCeilingId: sourceCeiling?.id ?? null,
             openingPolygon,
+            ...persistencePayload(persistence),
         });
     });
 }

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

@@ -8,6 +8,13 @@ export declare const createLevelInput: {
     label: z.ZodOptional<z.ZodString>;
 };
 export declare const createLevelOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     levelId: z.ZodString;
 };
 export declare function registerCreateLevel(server: McpServer, bridge: SceneOperations): void;

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;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"}
+{"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;AAOpD,eAAO,MAAM,gBAAgB;;;;;CAW5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;CAG7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgDpF"}

package/dist/tools/create-level.js

@@ -1,8 +1,9 @@
 import { DEFAULT_LEVEL_HEIGHT } from '@pascal-app/core';
 import { LevelNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
+import { ADDITIVE_TOOL_ANNOTATIONS } from './annotations';
 import { ErrorCode, throwMcpError } from './errors';
-import { publishLiveSceneSnapshot } from './live-sync';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync';
 import { measurement } from './measurement';
 import { NodeIdSchema } from './schemas';
 export const createLevelInput = {
@@ -19,6 +20,7 @@ export const createLevelInput = {
 };
 export const createLevelOutput = {
     levelId: z.string(),
+    ...liveSyncOutput,
 };
 export function registerCreateLevel(server, bridge) {
     server.registerTool('create_level', {
@@ -26,6 +28,7 @@ export function registerCreateLevel(server, bridge) {
         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,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ buildingId, height, label }) => {
         const parent = bridge.getNode(buildingId);
         if (!parent) {
@@ -50,8 +53,8 @@ export function registerCreateLevel(server, bridge) {
             ...(label !== undefined ? { name: label } : {}),
         });
         const id = bridge.createNode(levelNode, buildingId);
-        await publishLiveSceneSnapshot(bridge, 'create_level');
-        const payload = { levelId: id };
+        const persistence = await publishLiveSceneSnapshot(bridge, 'create_level');
+        const payload = { levelId: id, ...persistencePayload(persistence) };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],
             structuredContent: payload,

package/dist/tools/create-wall.d.ts

@@ -9,6 +9,13 @@ export declare const createWallInput: {
     height: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
 };
 export declare const createWallOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     wallId: z.ZodString;
 };
 export declare function registerCreateWall(server: McpServer, bridge: SceneOperations): void;

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

@@ -1 +1 @@
-{"version":3,"file":"create-wall.d.ts","sourceRoot":"","sources":["../../src/tools/create-wall.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,eAAe;;;;;;CAS3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgDnF"}
+{"version":3,"file":"create-wall.d.ts","sourceRoot":"","sources":["../../src/tools/create-wall.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;AAOpD,eAAO,MAAM,eAAe;;;;;;CAS3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;CAG5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiDnF"}

package/dist/tools/create-wall.js

@@ -1,7 +1,8 @@
 import { WallNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
+import { ADDITIVE_TOOL_ANNOTATIONS } from './annotations';
 import { ErrorCode, throwMcpError } from './errors';
-import { publishLiveSceneSnapshot } from './live-sync';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync';
 import { measurement } from './measurement';
 import { NodeIdSchema, Vec2Schema } from './schemas';
 export const createWallInput = {
@@ -16,6 +17,7 @@ export const createWallInput = {
 };
 export const createWallOutput = {
     wallId: z.string(),
+    ...liveSyncOutput,
 };
 export function registerCreateWall(server, bridge) {
     server.registerTool('create_wall', {
@@ -23,6 +25,7 @@ export function registerCreateWall(server, bridge) {
         description: 'Create a new wall on the given level between two 2D points. Thickness and height default to the core library defaults when omitted.',
         inputSchema: createWallInput,
         outputSchema: createWallOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ levelId, start, end, thickness, height }) => {
         const parent = bridge.getNode(levelId);
         if (!parent) {
@@ -44,8 +47,8 @@ export function registerCreateWall(server, bridge) {
             ...(height !== undefined ? { height } : {}),
         });
         const id = bridge.createNode(wall, levelId);
-        await publishLiveSceneSnapshot(bridge, 'create_wall');
-        const payload = { wallId: id };
+        const persistence = await publishLiveSceneSnapshot(bridge, 'create_wall');
+        const payload = { wallId: id, ...persistencePayload(persistence) };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],
             structuredContent: payload,

package/dist/tools/cut-opening.d.ts

@@ -12,6 +12,13 @@ export declare const cutOpeningInput: {
     height: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
 };
 export declare const cutOpeningOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     openingId: z.ZodString;
 };
 export declare function registerCutOpening(server: McpServer, bridge: SceneOperations): void;

package/dist/tools/cut-opening.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cut-opening.d.ts","sourceRoot":"","sources":["../../src/tools/cut-opening.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;AAOpD,eAAO,MAAM,eAAe;;;;;;;;;CAM3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAyDnF"}
+{"version":3,"file":"cut-opening.d.ts","sourceRoot":"","sources":["../../src/tools/cut-opening.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;AAQpD,eAAO,MAAM,eAAe;;;;;;;;;CAM3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;CAG5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA0DnF"}

package/dist/tools/cut-opening.js

@@ -1,8 +1,9 @@
 import { DoorNode, WindowNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
+import { ADDITIVE_TOOL_ANNOTATIONS } from './annotations';
 import { ErrorCode, throwMcpError } from './errors';
 import { wallLength, wallLocalXFromT } from './geometry';
-import { publishLiveSceneSnapshot } from './live-sync';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync';
 import { measurement } from './measurement';
 import { NodeIdSchema } from './schemas';
 export const cutOpeningInput = {
@@ -14,6 +15,7 @@ export const cutOpeningInput = {
 };
 export const cutOpeningOutput = {
     openingId: z.string(),
+    ...liveSyncOutput,
 };
 export function registerCutOpening(server, bridge) {
     server.registerTool('cut_opening', {
@@ -21,6 +23,7 @@ export function registerCutOpening(server, bridge) {
         description: 'Cut a door or window opening into an existing wall. position is a parametric 0..1 offset along the wall centreline.',
         inputSchema: cutOpeningInput,
         outputSchema: cutOpeningOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ wallId, type, position, width, height }) => {
         const wall = bridge.getNode(wallId);
         if (!wall) {
@@ -48,8 +51,8 @@ export function registerCutOpening(server, bridge) {
                 position: [base.position[0], 0.9 + height / 2, 0],
             });
         const id = bridge.createNode(opening, wallId);
-        await publishLiveSceneSnapshot(bridge, 'cut_opening');
-        const payload = { openingId: id };
+        const persistence = await publishLiveSceneSnapshot(bridge, 'cut_opening');
+        const payload = { openingId: id, ...persistencePayload(persistence) };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],
             structuredContent: payload,

package/dist/tools/delete-node.d.ts

@@ -6,6 +6,13 @@ export declare const deleteNodeInput: {
     cascade: z.ZodOptional<z.ZodBoolean>;
 };
 export declare const deleteNodeOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     deletedIds: z.ZodArray<z.ZodString>;
 };
 export declare function registerDeleteNode(server: McpServer, bridge: SceneOperations): void;

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

@@ -1 +1 @@
-{"version":3,"file":"delete-node.d.ts","sourceRoot":"","sources":["../../src/tools/delete-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;AAKpD,eAAO,MAAM,eAAe;;;CAG3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA6BnF"}
+{"version":3,"file":"delete-node.d.ts","sourceRoot":"","sources":["../../src/tools/delete-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;AAMpD,eAAO,MAAM,eAAe;;;CAG3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;CAG5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA8BnF"}

package/dist/tools/delete-node.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from './annotations';
 import { ErrorCode, throwMcpError } from './errors';
-import { publishLiveSceneSnapshot } from './live-sync';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync';
 import { NodeIdSchema } from './schemas';
 export const deleteNodeInput = {
     id: NodeIdSchema,
@@ -8,6 +9,7 @@ export const deleteNodeInput = {
 };
 export const deleteNodeOutput = {
     deletedIds: z.array(z.string()),
+    ...liveSyncOutput,
 };
 export function registerDeleteNode(server, bridge) {
     server.registerTool('delete_node', {
@@ -15,6 +17,7 @@ export function registerDeleteNode(server, bridge) {
         description: 'Delete a node. If it has children, pass `cascade: true` to delete descendants recursively.',
         inputSchema: deleteNodeInput,
         outputSchema: deleteNodeOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id, cascade }) => {
         const node = bridge.getNode(id);
         if (!node) {
@@ -22,8 +25,8 @@ export function registerDeleteNode(server, bridge) {
         }
         try {
             const removed = bridge.deleteNode(id, cascade ?? false);
-            await publishLiveSceneSnapshot(bridge, 'delete_node');
-            const payload = { deletedIds: removed };
+            const persistence = await publishLiveSceneSnapshot(bridge, 'delete_node');
+            const payload = { deletedIds: removed, ...persistencePayload(persistence) };
             return {
                 content: [{ type: 'text', text: JSON.stringify(payload) }],
                 structuredContent: payload,

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;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"}
+{"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;AAMpD,eAAO,MAAM,iBAAiB;;CAE7B,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;;;;CAQ9B,CAAA;AA0CD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiDrF"}

package/dist/tools/describe-node.js

@@ -1,5 +1,6 @@
 import { resolveCeilingHeight } from '@pascal-app/core';
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations';
 import { ErrorCode, throwMcpError } from './errors';
 import { resolveReportedWallHeight } from './scene-query';
 import { NodeIdSchema } from './schemas';
@@ -60,6 +61,7 @@ export function registerDescribeNode(server, bridge) {
         description: 'Return a structured summary of a node including its ancestry, children IDs, key properties, and a short human description.',
         inputSchema: describeNodeInput,
         outputSchema: describeNodeOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ id }) => {
         const node = bridge.getNode(id);
         if (!node) {

package/dist/tools/door-clearance.d.ts

@@ -6,7 +6,7 @@
  *
  * See docs/layout-clearance-error-log.md for pitfalls (levels, gap sign, scale).
  */
-import type { AnyNode } from '@pascal-app/core/schema';
+import { type AnyNode } from '@pascal-app/core/schema';
 import { type Vec2 } from './geometry';
 export type PlanAabb = {
     minX: number;
@@ -14,6 +14,17 @@ export type PlanAabb = {
     minZ: number;
     maxZ: number;
 };
+export type ItemFootprintFailureReason = 'missing_dimensions' | 'non_finite_position' | 'non_finite_rotation' | 'non_finite_dimensions' | 'non_positive_plan_dimensions' | 'non_finite_scale' | 'zero_plan_scale' | 'non_planar_rotation' | 'unsupported_attachment';
+export type ItemFootprintInspection = {
+    ok: true;
+    aabb: PlanAabb;
+    sourceDimensions: [number, number, number];
+    effectiveDimensions: [number, number, number];
+    rotationY: number;
+} | {
+    ok: false;
+    reason: ItemFootprintFailureReason;
+};
 export type DoorKeepout = {
     doorId: string;
     wallId: string;
@@ -63,8 +74,13 @@ export declare function resolveNodeLevelId(nodeId: string, byId: Map<string, Any
  * Prefer scaled dimensions when the node is available.
  */
 export declare function itemPlanAabb(position: [number, number, number] | number[], dimensions: [number, number, number] | number[] | undefined, rotationYRad?: number): PlanAabb;
-/** Footprint for a scene item node (uses getScaledDimensions). */
+/** Scaled plan footprint used by legacy placement and door-clearance callers. */
 export declare function itemNodePlanAabb(node: AnyNode): PlanAabb | null;
+export declare function inspectItemPlanFootprint(node: Extract<AnyNode, {
+    type: 'item';
+}>, options?: {
+    floorOnly?: boolean;
+}): ItemFootprintInspection;
 /**
  * Build a rectangular keep-out around a wall door, extruded perpendicular to the wall
  * on both faces so either swing side is protected.

package/dist/tools/door-clearance.d.ts.map

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

package/dist/tools/door-clearance.js

@@ -34,12 +34,31 @@ export function resolveNodeLevelId(nodeId, byId) {
         if (current.type === 'level')
             return current.id;
         const parentId = current.parentId;
-        if (!parentId)
-            return null;
-        current = byId.get(parentId);
+        if (parentId && byId.has(parentId)) {
+            current = byId.get(parentId);
+            continue;
+        }
+        current = findParentByChildren(current.id, byId);
     }
     return null;
 }
+function findParentByChildren(nodeId, byId) {
+    for (const candidate of byId.values()) {
+        if (!('children' in candidate) || !Array.isArray(candidate.children))
+            continue;
+        const containsNode = candidate.children.some((child) => {
+            if (typeof child === 'string')
+                return child === nodeId;
+            return (child !== null &&
+                typeof child === 'object' &&
+                'id' in child &&
+                child.id === nodeId);
+        });
+        if (containsNode)
+            return candidate;
+    }
+    return undefined;
+}
 /**
  * Axis-aligned item footprint in plan (x/z), rotation-aware.
  * Prefer scaled dimensions when the node is available.
@@ -59,13 +78,88 @@ export function itemPlanAabb(position, dimensions, rotationYRad = 0) {
         maxZ: z + halfD,
     };
 }
-/** Footprint for a scene item node (uses getScaledDimensions). */
+/** Scaled plan footprint used by legacy placement and door-clearance callers. */
 export function itemNodePlanAabb(node) {
     if (node.type !== 'item')
         return null;
-    const [w, , d] = getScaledDimensions(node);
-    const rotY = Array.isArray(node.rotation) ? (node.rotation[1] ?? 0) : 0;
-    return itemPlanAabb(node.position, [w, 0, d], rotY);
+    if (!Array.isArray(node.asset.dimensions))
+        return null;
+    const [width, height, depth] = getScaledDimensions(node);
+    const rotationY = Array.isArray(node.rotation) ? (node.rotation[1] ?? 0) : 0;
+    if (![node.position[0], node.position[2], width, height, depth, rotationY].every(Number.isFinite)) {
+        return null;
+    }
+    return itemPlanAabb(node.position, [Math.abs(width), Math.abs(height), Math.abs(depth)], rotationY);
+}
+export function inspectItemPlanFootprint(node, options) {
+    if (options?.floorOnly &&
+        (node.asset.attachTo === 'wall' ||
+            node.asset.attachTo === 'wall-side' ||
+            node.asset.attachTo === 'ceiling')) {
+        return { ok: false, reason: 'unsupported_attachment' };
+    }
+    const position = node.position;
+    if (!Array.isArray(position)) {
+        return { ok: false, reason: 'non_finite_position' };
+    }
+    const x = position[0];
+    const y = position[1];
+    const z = position[2];
+    if (!(Number.isFinite(x) && Number.isFinite(y) && Number.isFinite(z))) {
+        return { ok: false, reason: 'non_finite_position' };
+    }
+    const rotation = Array.isArray(node.rotation) ? node.rotation : [0, 0, 0];
+    const rotationX = rotation[0] ?? Number.NaN;
+    const rotationY = rotation[1] ?? Number.NaN;
+    const rotationZ = rotation[2] ?? Number.NaN;
+    if (!(Number.isFinite(rotationX) && Number.isFinite(rotationY) && Number.isFinite(rotationZ))) {
+        return { ok: false, reason: 'non_finite_rotation' };
+    }
+    if (Math.abs(rotationX) > 1e-6 || Math.abs(rotationZ) > 1e-6) {
+        return { ok: false, reason: 'non_planar_rotation' };
+    }
+    const dimensions = node.asset.dimensions;
+    if (!Array.isArray(dimensions) || dimensions.length !== 3) {
+        return { ok: false, reason: 'missing_dimensions' };
+    }
+    const width = dimensions[0] ?? Number.NaN;
+    const height = dimensions[1] ?? Number.NaN;
+    const depth = dimensions[2] ?? Number.NaN;
+    if (!(Number.isFinite(width) && Number.isFinite(height) && Number.isFinite(depth))) {
+        return { ok: false, reason: 'non_finite_dimensions' };
+    }
+    if (width <= 0 || depth <= 0) {
+        return { ok: false, reason: 'non_positive_plan_dimensions' };
+    }
+    const scale = Array.isArray(node.scale) ? node.scale : [1, 1, 1];
+    const scaleX = scale[0] ?? Number.NaN;
+    const scaleY = scale[1] ?? Number.NaN;
+    const scaleZ = scale[2] ?? Number.NaN;
+    if (!(Number.isFinite(scaleX) && Number.isFinite(scaleY) && Number.isFinite(scaleZ))) {
+        return { ok: false, reason: 'non_finite_scale' };
+    }
+    if (scaleX === 0 || scaleZ === 0) {
+        return { ok: false, reason: 'zero_plan_scale' };
+    }
+    const [scaledWidth, scaledHeight, scaledDepth] = getScaledDimensions(node);
+    const effectiveDimensions = [
+        Math.abs(scaledWidth),
+        Math.abs(scaledHeight),
+        Math.abs(scaledDepth),
+    ];
+    if (!effectiveDimensions.every(Number.isFinite)) {
+        return { ok: false, reason: 'non_finite_dimensions' };
+    }
+    if (effectiveDimensions[0] <= 0 || effectiveDimensions[2] <= 0) {
+        return { ok: false, reason: 'non_positive_plan_dimensions' };
+    }
+    return {
+        ok: true,
+        aabb: itemPlanAabb(node.position, effectiveDimensions, rotationY),
+        sourceDimensions: [width, height, depth],
+        effectiveDimensions,
+        rotationY,
+    };
 }
 /**
  * Build a rectangular keep-out around a wall door, extruded perpendicular to the wall