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

package/dist/tools/room-tools.js

@@ -1,11 +1,12 @@
 import { CeilingNode, DoorNode, ItemNode, SlabNode, WallNode, WindowNode, ZoneNode, } from '@pascal-app/core/schema';
 import { z } from 'zod';
+import { ADDITIVE_TOOL_ANNOTATIONS, READ_ONLY_TOOL_ANNOTATIONS } from './annotations';
 import { findCatalogItem, searchCatalogItems } from './asset-catalog';
 import { keepoutCoversPlanned, keepoutForPolygonEdge } from './door-clearance';
 import { ErrorCode, throwMcpError } from './errors';
 import { polygonArea, polygonBounds, wallLength, wallLocalXFromT } from './geometry';
 import { collectDoorKeepouts, collectOccupiedFootprints, findValidPlacement, itemPlanAabb, } from './layout-clearance';
-import { publishLiveSceneSnapshot } from './live-sync';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot, } from './live-sync';
 import { measurement } from './measurement';
 import { NodeIdSchema, Vec2Schema } from './schemas';
 const ROOM_TYPES = [
@@ -47,6 +48,7 @@ export const createRoomOutput = {
     ceilingId: z.string(),
     wallIds: z.array(z.string()),
     areaSqMeters: z.number(),
+    ...liveSyncOutput,
 };
 export const addDoorInput = {
     wallId: NodeIdSchema,
@@ -65,6 +67,7 @@ export const addDoorOutput = {
     wallLength: z.number(),
     clamped: z.boolean(),
     coordinateSystem: z.literal('wall-local-meters'),
+    ...liveSyncOutput,
 };
 export const addWindowInput = {
     wallId: NodeIdSchema,
@@ -86,6 +89,7 @@ export const addWindowOutput = {
     clamped: z.boolean(),
     coordinateSystem: z.literal('wall-local-meters'),
     sillHeight: z.number(),
+    ...liveSyncOutput,
 };
 export const furnishRoomInput = {
     levelId: NodeIdSchema.optional(),
@@ -98,6 +102,7 @@ export const furnishRoomOutput = {
     placed: z.number(),
     itemIds: z.array(z.string()),
     skipped: z.array(z.string()),
+    ...liveSyncOutput,
 };
 function textResult(payload) {
     return {
@@ -340,6 +345,7 @@ export function registerSearchAssets(server) {
         description: 'Search the built-in MCP item catalog by keyword. Call before place_item when you need a valid catalogItemId.',
         inputSchema: searchAssetsInput,
         outputSchema: searchAssetsOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ query, category }) => {
         const results = searchCatalogItems({ query, category }).map((item) => ({
             id: item.id,
@@ -358,6 +364,7 @@ export function registerCreateRoom(server, bridge) {
         description: 'Create a room on a level: zone, slab, ceiling, and one wall per polygon edge. Returns wallIds in polygon edge order.',
         inputSchema: createRoomInput,
         outputSchema: createRoomOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ levelId, name, polygon, color, wallHeight, wallThickness }) => {
         assertLevel(bridge, levelId);
         const points = polygon;
@@ -387,13 +394,14 @@ export function registerCreateRoom(server, bridge) {
                 parentId: levelId,
             })),
         ]);
-        await publishLiveSceneSnapshot(bridge, 'create_room');
+        const persistence = await publishLiveSceneSnapshot(bridge, 'create_room');
         return textResult({
             zoneId: zone.id,
             slabId: slab.id,
             ceilingId: ceiling.id,
             wallIds: walls.map((wall) => wall.id),
             areaSqMeters: Math.round(polygonArea(points) * 100) / 100,
+            ...persistencePayload(persistence),
         });
     });
 }
@@ -403,6 +411,7 @@ export function registerAddDoor(server, bridge) {
         description: 'Add a door to an existing wall. t/position is 0..1 along the wall: 0 = start, 0.5 = center, 1 = end.',
         inputSchema: addDoorInput,
         outputSchema: addDoorOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ wallId, t, position, width = 0.9, height = 2.1, hingesSide, swingDirection }) => {
         const wall = assertWall(bridge, wallId);
         const length = wallLength(wall);
@@ -421,7 +430,7 @@ export function registerAddDoor(server, bridge) {
             ...(swingDirection ? { swingDirection } : {}),
         });
         const id = bridge.createNode(door, wallId);
-        await publishLiveSceneSnapshot(bridge, 'add_door');
+        const persistence = await publishLiveSceneSnapshot(bridge, 'add_door');
         return textResult({
             doorId: id,
             localX,
@@ -430,6 +439,7 @@ export function registerAddDoor(server, bridge) {
             wallLength: length,
             clamped: Math.abs(localX - wallT * length) > 1e-9,
             coordinateSystem: 'wall-local-meters',
+            ...persistencePayload(persistence),
         });
     });
 }
@@ -439,6 +449,7 @@ export function registerAddWindow(server, bridge) {
         description: 'Add a window to an existing wall. t/position is 0..1 along the wall; sillHeight is the height from floor to window bottom.',
         inputSchema: addWindowInput,
         outputSchema: addWindowOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ wallId, t, position, width = 1.5, height = 1.5, sillHeight = 0.9 }) => {
         const wall = assertWall(bridge, wallId);
         const length = wallLength(wall);
@@ -455,7 +466,7 @@ export function registerAddWindow(server, bridge) {
             height,
         });
         const id = bridge.createNode(windowNode, wallId);
-        await publishLiveSceneSnapshot(bridge, 'add_window');
+        const persistence = await publishLiveSceneSnapshot(bridge, 'add_window');
         return textResult({
             windowId: id,
             localX,
@@ -465,6 +476,7 @@ export function registerAddWindow(server, bridge) {
             clamped: Math.abs(localX - wallT * length) > 1e-9,
             coordinateSystem: 'wall-local-meters',
             sillHeight,
+            ...persistencePayload(persistence),
         });
     });
 }
@@ -474,6 +486,7 @@ export function registerFurnishRoom(server, bridge) {
         description: 'Place furniture for a room type (levelId+polygon or zoneId). Skips or nudges poses that block door clear zones or overlap existing items (rotation-aware). Parent floor items to the level.',
         inputSchema: furnishRoomInput,
         outputSchema: furnishRoomOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ levelId, zoneId, roomType, polygon, doorWallIndex }) => {
         const room = inferRoomGeometry(bridge, levelId, polygon, zoneId);
         assertLevel(bridge, room.levelId);
@@ -552,18 +565,20 @@ export function registerFurnishRoom(server, bridge) {
                 },
             }));
         }
+        let persistence = 'published';
         if (items.length > 0) {
             bridge.applyPatch(items.map((item) => ({
                 op: 'create',
                 node: item,
                 parentId: room.levelId,
             })));
-            await publishLiveSceneSnapshot(bridge, 'furnish_room');
+            persistence = await publishLiveSceneSnapshot(bridge, 'furnish_room');
         }
         return textResult({
             placed: items.length,
             itemIds: items.map((item) => item.id),
             skipped,
+            ...persistencePayload(persistence),
         });
     });
 }

package/dist/tools/scene-lifecycle/create-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/create-project.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,kBAAkB,CAAA;AAIvD,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;CAsB/B,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAgD1F"}
+{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/create-project.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,kBAAkB,CAAA;AAKvD,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;CAsB/B,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAiD1F"}

package/dist/tools/scene-lifecycle/create-project.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { ADDITIVE_TOOL_ANNOTATIONS } from '../annotations';
 import { ErrorCode, throwMcpError } from '../errors';
 import { currentLevelContext, projectStatusPayload } from './metadata';
 export const createProjectInput = {
@@ -35,6 +36,7 @@ export function registerCreateProject(server, operations) {
         description: 'Create a browser-visible Pascal project for the authenticated user. Use this before save_scene when the user asks for a new project.',
         inputSchema: createProjectInput,
         outputSchema: createProjectOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ name, id, isPrivate }) => {
         if (!operations.canCreateProject) {
             throwMcpError(ErrorCode.InvalidRequest, 'create_project_unavailable: this MCP store cannot create hosted projects');

package/dist/tools/scene-lifecycle/delete-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/delete-scene.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,kBAAkB,CAAA;AAIvD,eAAO,MAAM,gBAAgB;;;CAG5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;CAE7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAmCxF"}
+{"version":3,"file":"delete-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/delete-scene.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,kBAAkB,CAAA;AAKvD,eAAO,MAAM,gBAAgB;;;CAG5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;CAE7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAoCxF"}

package/dist/tools/scene-lifecycle/delete-scene.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { SceneNotFoundError, SceneVersionConflictError } from '../../storage/types';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations';
 import { ErrorCode, throwMcpError } from '../errors';
 export const deleteSceneInput = {
     id: z.string().min(1).max(64),
@@ -14,6 +15,7 @@ export function registerDeleteScene(server, operations) {
         description: 'Delete a scene from the SceneStore by id. Optionally pass `expectedVersion` for optimistic concurrency.',
         inputSchema: deleteSceneInput,
         outputSchema: deleteSceneOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id, expectedVersion }) => {
         try {
             const deleted = await operations.deleteStoredScene(id, {

package/dist/tools/scene-lifecycle/get-project-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-project-status.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/get-project-status.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,kBAAkB,CAAA;AAIvD,eAAO,MAAM,qBAAqB;;CAEjC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;CAsBlC,CAAA;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA2C7F"}
+{"version":3,"file":"get-project-status.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/get-project-status.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,kBAAkB,CAAA;AAKvD,eAAO,MAAM,qBAAqB;;CAEjC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;CAsBlC,CAAA;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA4C7F"}

package/dist/tools/scene-lifecycle/get-project-status.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations';
 import { ErrorCode, McpError, throwMcpError } from '../errors';
 import { currentLevelContext, projectStatusPayload } from './metadata';
 export const getProjectStatusInput = {
@@ -33,6 +34,7 @@ export function registerGetProjectStatus(server, operations) {
         description: 'Authoritative status/debug call for a Pascal project: editor URL, browser-visible version, latest saved version, published version, node count, and graph hash.',
         inputSchema: getProjectStatusInput,
         outputSchema: getProjectStatusOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id }) => {
         try {
             const status = await operations.getProjectStatus(id);

package/dist/tools/scene-lifecycle/list-scenes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-scenes.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/list-scenes.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,kBAAkB,CAAA;AAKvD,eAAO,MAAM,eAAe;;;CAG3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;CAmB5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA2BvF"}
+{"version":3,"file":"list-scenes.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/list-scenes.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,kBAAkB,CAAA;AAMvD,eAAO,MAAM,eAAe;;;CAG3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;CAmB5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA4BvF"}

package/dist/tools/scene-lifecycle/list-scenes.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from '../annotations';
 import { ErrorCode, throwMcpError } from '../errors';
 const DEFAULT_LIMIT = 100;
 export const listScenesInput = {
@@ -29,6 +30,7 @@ export function registerListScenes(server, operations) {
         description: 'List scenes in the SceneStore. Optionally filter by `projectId` and cap results with `limit` (default 100).',
         inputSchema: listScenesInput,
         outputSchema: listScenesOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ projectId, limit }) => {
         try {
             const scenes = await operations.listScenes({

package/dist/tools/scene-lifecycle/load-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/load-scene.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,kBAAkB,CAAA;AAIvD,eAAO,MAAM,cAAc;;CAE1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgClF"}
+{"version":3,"file":"load-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/load-scene.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,kBAAkB,CAAA;AAKvD,eAAO,MAAM,cAAc;;CAE1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiClF"}

package/dist/tools/scene-lifecycle/load-scene.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations';
 import { ErrorCode, throwMcpError } from '../errors';
 import { currentLevelContext, sceneMetaPayload } from './metadata';
 export const loadSceneInput = {
@@ -30,6 +31,7 @@ export function registerLoadScene(server, bridge) {
         description: 'Load a scene from the SceneStore into the bridge. Returns the scene metadata. Throws `scene_not_found` if the id does not exist.',
         inputSchema: loadSceneInput,
         outputSchema: loadSceneOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id }) => {
         const result = await bridge.loadStoredScene(id);
         if (!result) {

package/dist/tools/scene-lifecycle/rename-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rename-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/rename-scene.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,kBAAkB,CAAA;AAIvD,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;CAW7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA8CxF"}
+{"version":3,"file":"rename-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/rename-scene.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,kBAAkB,CAAA;AAKvD,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;CAW7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA+CxF"}

package/dist/tools/scene-lifecycle/rename-scene.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { SceneNotFoundError, SceneVersionConflictError } from '../../storage/types';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations';
 import { ErrorCode, throwMcpError } from '../errors';
 export const renameSceneInput = {
     id: z.string().min(1).max(64),
@@ -24,6 +25,7 @@ export function registerRenameScene(server, operations) {
         description: 'Rename a scene in the SceneStore. Returns the updated SceneMeta. Optionally pass `expectedVersion` for optimistic concurrency.',
         inputSchema: renameSceneInput,
         outputSchema: renameSceneOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id, newName, expectedVersion }) => {
         try {
             const meta = await operations.renameStoredScene(id, newName, {

package/dist/tools/scene-lifecycle/save-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"save-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/save-scene.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,kBAAkB,CAAA;AAMvD,eAAO,MAAM,cAAc;;;;;;;;;;;;;CA0B1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiGlF"}
+{"version":3,"file":"save-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/save-scene.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,kBAAkB,CAAA;AAOvD,eAAO,MAAM,cAAc;;;;;;;;;;;;;CA0B1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAkGlF"}

package/dist/tools/scene-lifecycle/save-scene.js

@@ -1,6 +1,7 @@
 import { AnyNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
 import { SceneVersionConflictError } from '../../storage/types';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations';
 import { ErrorCode, throwMcpError } from '../errors';
 import { appendLiveSceneEvent } from '../live-sync';
 import { currentLevelContext, sceneMetaPayload } from './metadata';
@@ -53,6 +54,7 @@ export function registerSaveScene(server, bridge) {
         description: 'Save the current scene (or a provided graph) to the SceneStore. Defaults to a browser-visible draft save so agents can iterate without creating many project versions. Use saveMode: "checkpoint" for meaningful version history.',
         inputSchema: saveSceneInput,
         outputSchema: saveSceneOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id, name, projectId, expectedVersion, saveMode, publish, thumbnail, includeCurrentScene, graph, }) => {
         let sceneGraph;
         if (includeCurrentScene) {

package/dist/tools/scene-lifecycle/test-utils.d.ts

@@ -1,6 +1,6 @@
 import { SceneBridge } from '../../bridge/scene-bridge';
 import { type SceneOperations } from '../../operations';
-import { type ProjectCreateOptions, type ProjectStatus, type SceneListOptions, type SceneMeta, type SceneMutateOptions, type SceneSaveOptions, type SceneStore, type SceneWithGraph } from '../../storage/types';
+import { type ProjectCreateOptions, type ProjectStatus, type SceneEvent, type SceneEventAppendOptions, type SceneEventListOptions, type SceneListOptions, type SceneMeta, type SceneMutateOptions, type SceneSaveOptions, type SceneStore, type SceneWithGraph } from '../../storage/types';
 export type StoredTextContent = {
     type: string;
     text: string;
@@ -23,8 +23,10 @@ export declare class InMemorySceneStore implements SceneStore {
     readonly backend: "sqlite";
     private readonly data;
     private readonly projects;
+    private readonly events;
     private idCounter;
     private projectCounter;
+    private eventCounter;
     createProject(opts: ProjectCreateOptions): Promise<ProjectStatus>;
     getProjectStatus(id: string): Promise<ProjectStatus | null>;
     save(opts: SceneSaveOptions): Promise<SceneMeta>;
@@ -32,6 +34,8 @@ export declare class InMemorySceneStore implements SceneStore {
     list(opts?: SceneListOptions): Promise<SceneMeta[]>;
     delete(id: string, opts?: SceneMutateOptions): Promise<boolean>;
     rename(id: string, newName: string, opts?: SceneMutateOptions): Promise<SceneMeta>;
+    appendSceneEvent(opts: SceneEventAppendOptions): Promise<SceneEvent>;
+    listSceneEvents(sceneId: string, opts?: SceneEventListOptions): Promise<SceneEvent[]>;
     private touchProject;
     private toMeta;
     private toProjectStatus;

package/dist/tools/scene-lifecycle/test-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC9E,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEf,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAA;AAG5B,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9D,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC3B,GAAG;IACF,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,kBAAkB,CAAA;IACzB,UAAU,EAAE,eAAe,CAAA;CAC5B,CAKA;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAWtB;IACH,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,cAAc,CAAI;IAEpB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAejE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK3D,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IA+DhD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAShD,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAanD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAW/D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAmBxF,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,MAAM;IAoBd,OAAO,CAAC,eAAe;CA0BxB"}
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC9E,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEf,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAA;AAG5B,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9D,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC3B,GAAG;IACF,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,kBAAkB,CAAA;IACzB,UAAU,EAAE,eAAe,CAAA;CAC5B,CAKA;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAWtB;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,YAAY,CAAI;IAElB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAejE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK3D,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IA+DhD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAShD,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAanD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAW/D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAmBlF,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAapE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAU3F,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,MAAM;IAoBd,OAAO,CAAC,eAAe;CA0BxB"}

package/dist/tools/scene-lifecycle/test-utils.js

@@ -20,8 +20,10 @@ export class InMemorySceneStore {
     backend = 'sqlite';
     data = new Map();
     projects = new Map();
+    events = [];
     idCounter = 0;
     projectCounter = 0;
+    eventCounter = 0;
     async createProject(opts) {
         const id = opts.id ?? `project_${++this.projectCounter}`;
         const now = new Date().toISOString();
@@ -147,6 +149,28 @@ export class InMemorySceneStore {
         this.touchProject(id, newName, updated.updatedAt);
         return this.toMeta(updated);
     }
+    async appendSceneEvent(opts) {
+        const event = {
+            eventId: ++this.eventCounter,
+            sceneId: opts.sceneId,
+            version: opts.version,
+            kind: opts.kind,
+            createdAt: new Date().toISOString(),
+            graph: opts.graph,
+        };
+        this.events.push(event);
+        return event;
+    }
+    async listSceneEvents(sceneId, opts) {
+        let events = this.events.filter((event) => event.sceneId === sceneId);
+        const afterEventId = opts?.afterEventId;
+        if (afterEventId !== undefined) {
+            events = events.filter((event) => event.eventId > afterEventId);
+        }
+        if (opts?.limit !== undefined)
+            events = events.slice(0, opts.limit);
+        return events;
+    }
     touchProject(id, name, updatedAt) {
         const existing = this.projects.get(id);
         if (existing) {

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;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;AAYpD,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAID,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;CAejC,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,CAiQpF;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;AAapD,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAID,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;CAejC,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,CA0CnF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiBxF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAoBjF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAoBjF;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"}

package/dist/tools/scene-query.js

@@ -1,6 +1,7 @@
 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 { READ_ONLY_TOOL_ANNOTATIONS } from './annotations';
 import { distance2D, pointInPolygon, polygonArea, polygonContainsPolygon, wallLength, } from './geometry';
 import { layoutIssuesFromScene } from './layout-clearance';
 import { NodeIdSchema } from './schemas';
@@ -393,6 +394,7 @@ export function registerListLevels(server, bridge) {
         description: 'List all levels in the current scene with ids, names, floor indices, and child counts.',
         inputSchema: {},
         outputSchema: listLevelsOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async () => {
         const activeScene = bridge.getActiveScene();
         const levels = getLevels(bridge).map((level) => {
@@ -430,6 +432,7 @@ export function registerGetLevelSummary(server, bridge) {
         description: 'Get a compact model-friendly summary of one level: counts plus walls, zones, slabs, ceilings, and items. Omit levelId to use the first level.',
         inputSchema: levelScopedInput,
         outputSchema: getLevelSummaryOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ levelId }) => {
         const resolved = getDefaultLevelId(bridge, levelId);
         if (!resolved)
@@ -443,6 +446,7 @@ export function registerGetWalls(server, bridge) {
         description: 'Get walls on a level with start/end coordinates, length, height, thickness, and child doors/windows. Omit levelId to use the first level.',
         inputSchema: levelScopedInput,
         outputSchema: getWallsOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ levelId }) => {
         const resolved = getDefaultLevelId(bridge, levelId);
         if (!resolved)
@@ -459,6 +463,7 @@ export function registerGetZones(server, bridge) {
         description: 'Get room/zone polygons on a level with names, colors, bounds, and approximate areas. Omit levelId to use the first level.',
         inputSchema: levelScopedInput,
         outputSchema: getZonesOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ levelId }) => {
         const resolved = getDefaultLevelId(bridge, levelId);
         if (!resolved)
@@ -475,6 +480,7 @@ export function registerVerifyScene(server, bridge) {
         description: 'High-level self-check after complex edits. Returns validation status, per-level room/content counts, empty levels, and practical layout issues.',
         inputSchema: {},
         outputSchema: verifySceneOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async () => {
         const validation = bridge.validateScene();
         const levels = getLevels(bridge).map((level) => {

package/dist/tools/set-zone.d.ts

@@ -8,6 +8,13 @@ export declare const setZoneInput: {
     properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 };
 export declare const setZoneOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     zoneId: z.ZodString;
 };
 export declare function registerSetZone(server: McpServer, bridge: SceneOperations): void;

package/dist/tools/set-zone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set-zone.d.ts","sourceRoot":"","sources":["../../src/tools/set-zone.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,YAAY;;;;;CAKxB,CAAA;AAED,eAAO,MAAM,aAAa;;CAEzB,CAAA;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgDhF"}
+{"version":3,"file":"set-zone.d.ts","sourceRoot":"","sources":["../../src/tools/set-zone.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,YAAY;;;;;CAKxB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;CAGzB,CAAA;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiDhF"}

package/dist/tools/set-zone.js

@@ -1,7 +1,8 @@
 import { ZoneNode } 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 { NodeIdSchema, Vec2Schema } from './schemas';
 export const setZoneInput = {
     levelId: NodeIdSchema,
@@ -11,6 +12,7 @@ export const setZoneInput = {
 };
 export const setZoneOutput = {
     zoneId: z.string(),
+    ...liveSyncOutput,
 };
 export function registerSetZone(server, bridge) {
     server.registerTool('set_zone', {
@@ -18,6 +20,7 @@ export function registerSetZone(server, bridge) {
         description: 'Create a polygonal zone on the given level. label is stored as the zone name and properties are merged into metadata.',
         inputSchema: setZoneInput,
         outputSchema: setZoneOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ levelId, polygon, label, properties }) => {
         const parent = bridge.getNode(levelId);
         if (!parent) {
@@ -38,8 +41,8 @@ export function registerSetZone(server, bridge) {
             metadata: properties ?? {},
         });
         const id = bridge.createNode(zone, levelId);
-        await publishLiveSceneSnapshot(bridge, 'set_zone');
-        const payload = { zoneId: id };
+        const persistence = await publishLiveSceneSnapshot(bridge, 'set_zone');
+        const payload = { zoneId: id, ...persistencePayload(persistence) };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],
             structuredContent: payload,

package/dist/tools/templates/create-from-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-from-template.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/create-from-template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAMvD,eAAO,MAAM,uBAAuB;;;IAYlC;;;;;OAKG;;;CAGJ,CAAA;AAED,eAAO,MAAM,wBAAwB;;;;IAInC,yEAAyE;;IAEzE,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;CAuB9D,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA8F3F"}
+{"version":3,"file":"create-from-template.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/create-from-template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAOvD,eAAO,MAAM,uBAAuB;;;IAYlC;;;;;OAKG;;;CAGJ,CAAA;AAED,eAAO,MAAM,wBAAwB;;;;IAInC,yEAAyE;;IAEzE,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;CAuB9D,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA+F3F"}

package/dist/tools/templates/create-from-template.js

@@ -2,6 +2,7 @@ import { cloneSceneGraph } from '@pascal-app/core/clone-scene-graph';
 import { z } from 'zod';
 import { rehydrateSiteChildren } from '../../lib/rehydrate-site-children';
 import { isTemplateId, TEMPLATES } from '../../templates';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations';
 import { ErrorCode, throwMcpError } from '../errors';
 import { appendLiveSceneEvent } from '../live-sync';
 import { currentLevelContext, sceneMetaPayload } from '../scene-lifecycle/metadata';
@@ -68,6 +69,7 @@ export function registerCreateFromTemplate(server, bridge) {
         description: 'Instantiate a seed Pascal scene template into the bridge. Regenerates all ids before applying. When `save: true` and a SceneStore is wired, also persists the new scene and returns the SceneMeta.',
         inputSchema: createFromTemplateInput,
         outputSchema: createFromTemplateOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id, name, save, projectId }) => {
         if (!isTemplateId(id)) {
             throwMcpError(ErrorCode.InvalidParams, `unknown_template: ${id}. Call list_templates for the set of valid ids.`);

package/dist/tools/templates/create-house-from-brief.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-house-from-brief.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/create-house-from-brief.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAMvD,eAAO,MAAM,yBAAyB;;;;;;;;;CASrC,CAAA;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;CAmBtC,CAAA;AAmCD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAqI7F"}
+{"version":3,"file":"create-house-from-brief.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/create-house-from-brief.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAOvD,eAAO,MAAM,yBAAyB;;;;;;;;;CASrC,CAAA;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;CAmBtC,CAAA;AAmCD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAsI7F"}

package/dist/tools/templates/create-house-from-brief.js

@@ -2,6 +2,7 @@ import { cloneSceneGraph } from '@pascal-app/core/clone-scene-graph';
 import { z } from 'zod';
 import { rehydrateSiteChildren } from '../../lib/rehydrate-site-children';
 import { isTemplateId, TEMPLATES } from '../../templates';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations';
 import { ErrorCode, throwMcpError } from '../errors';
 import { appendLiveSceneEvent } from '../live-sync';
 import { currentLevelContext, sceneMetaPayload } from '../scene-lifecycle/metadata';
@@ -66,6 +67,7 @@ export function registerCreateHouseFromBrief(server, bridge) {
         description: 'High-level hosted workflow for external agents: choose a starter house from a brief, create/save/publish it, and return the editor URL. Use semantic tools afterward for exact customization.',
         inputSchema: createHouseFromBriefInput,
         outputSchema: createHouseFromBriefOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ brief, projectId, projectName, bedroomCount, rooms, style, landscaping, constraints, }) => {
         const templateId = chooseTemplate({
             ...(bedroomCount !== undefined ? { bedroomCount } : {}),

package/dist/tools/templates/list-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-templates.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/list-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,kBAAkB,IAAc,CAAA;AAE7C,eAAO,MAAM,mBAAmB;;;;;;;CAS/B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwB7D"}
+{"version":3,"file":"list-templates.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/list-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,kBAAkB,IAAc,CAAA;AAE7C,eAAO,MAAM,mBAAmB;;;;;;;CAS/B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyB7D"}

package/dist/tools/templates/list-templates.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { TEMPLATES } from '../../templates';
+import { READ_ONLY_TOOL_ANNOTATIONS } from '../annotations';
 export const listTemplatesInput = {};
 export const listTemplatesOutput = {
     templates: z.array(z.object({
@@ -20,6 +21,7 @@ export function registerListTemplates(server) {
         description: 'List the seed Pascal scene templates available to `create_from_template`. Returns the id, display name, one-line description and node count for each.',
         inputSchema: listTemplatesInput,
         outputSchema: listTemplatesOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async () => {
         const templates = Object.values(TEMPLATES).map((entry) => ({
             id: entry.id,

package/dist/tools/undo.d.ts

@@ -5,6 +5,13 @@ export declare const undoInput: {
     steps: z.ZodOptional<z.ZodNumber>;
 };
 export declare const undoOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     undone: z.ZodNumber;
 };
 export declare function registerUndo(server: McpServer, bridge: SceneOperations): void;

package/dist/tools/undo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"undo.d.ts","sourceRoot":"","sources":["../../src/tools/undo.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;AAGpD,eAAO,MAAM,SAAS;;CAErB,CAAA;AAED,eAAO,MAAM,UAAU;;CAEtB,CAAA;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAoB7E"}
+{"version":3,"file":"undo.d.ts","sourceRoot":"","sources":["../../src/tools/undo.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;AAIpD,eAAO,MAAM,SAAS;;CAErB,CAAA;AAED,eAAO,MAAM,UAAU;;;;;;;;;CAGtB,CAAA;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAsB7E"}

package/dist/tools/undo.js

@@ -1,10 +1,12 @@
 import { z } from 'zod';
-import { publishLiveSceneSnapshot } from './live-sync';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from './annotations';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync';
 export const undoInput = {
     steps: z.number().int().positive().optional(),
 };
 export const undoOutput = {
     undone: z.number(),
+    ...liveSyncOutput,
 };
 export function registerUndo(server, bridge) {
     server.registerTool('undo', {
@@ -12,11 +14,11 @@ export function registerUndo(server, bridge) {
         description: 'Undo the most recent N steps in the scene history (default 1). Returns the number of steps actually undone.',
         inputSchema: undoInput,
         outputSchema: undoOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ steps }) => {
         const undone = bridge.undo(steps ?? 1);
-        if (undone > 0)
-            await publishLiveSceneSnapshot(bridge, 'undo');
-        const payload = { undone };
+        const persistence = undone > 0 ? await publishLiveSceneSnapshot(bridge, 'undo') : 'published';
+        const payload = { undone, ...persistencePayload(persistence) };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],
             structuredContent: payload,

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

@@ -1 +1 @@
-{"version":3,"file":"validate-scene.d.ts","sourceRoot":"","sources":["../../src/tools/validate-scene.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;AAEpD,eAAO,MAAM,kBAAkB,IAAK,CAAA;AAEpC,eAAO,MAAM,mBAAmB;;;;;;;CAS/B,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAkBtF"}
+{"version":3,"file":"validate-scene.d.ts","sourceRoot":"","sources":["../../src/tools/validate-scene.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;AAGpD,eAAO,MAAM,kBAAkB,IAAK,CAAA;AAEpC,eAAO,MAAM,mBAAmB;;;;;;;CAS/B,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmBtF"}