@pascal-app/mcp 1.0.0-beta.6 → 1.0.1

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

@@ -1,5 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 /**
  * Register the `photo_to_scene` orchestrator tool. Chains the vision
  * (`analyze_floorplan_image`-equivalent sampling call) → SceneGraph
@@ -7,5 +7,5 @@ import type { SceneOperations } from '../../operations';
  * Pascal scene from a single photo upload.
  */
 export declare function registerPhotoToSceneTool(server: McpServer, bridge: SceneOperations): void;
-export { photoToSceneInput, photoToSceneOutput, registerPhotoToScene, } from './photo-to-scene';
+export { photoToSceneInput, photoToSceneOutput, registerPhotoToScene, } from './photo-to-scene.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,4 +1,4 @@
-import { registerPhotoToScene } from './photo-to-scene';
+import { registerPhotoToScene } from './photo-to-scene.js';
 /**
  * Register the `photo_to_scene` orchestrator tool. Chains the vision
  * (`analyze_floorplan_image`-equivalent sampling call) → SceneGraph
@@ -8,4 +8,4 @@ import { registerPhotoToScene } from './photo-to-scene';
 export function registerPhotoToSceneTool(server, bridge) {
     registerPhotoToScene(server, bridge);
 }
-export { photoToSceneInput, photoToSceneOutput, registerPhotoToScene, } from './photo-to-scene';
+export { photoToSceneInput, photoToSceneOutput, registerPhotoToScene, } from './photo-to-scene.js';

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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 /**
  * Input shape for the `photo_to_scene` orchestrator. `image` matches the
  * contract documented on `analyze_floorplan_image` — base64 or http(s) URL.

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;AAmTD,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;AAKvD;;;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,CA8ErF"}

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

@@ -1,8 +1,9 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
 import { AnyNode, BuildingNode, LevelNode, SiteNode, WallNode, ZoneNode, } from '@pascal-app/core/schema';
 import { z } from 'zod';
-import { appendLiveSceneEvent } from '../live-sync';
-import { measurement } from '../measurement';
+import { DESTRUCTIVE_OPEN_WORLD_TOOL_ANNOTATIONS } from '../annotations.js';
+import { appendLiveSceneEvent } from '../live-sync.js';
+import { measurement } from '../measurement.js';
 /**
  * Input shape for the `photo_to_scene` orchestrator. `image` matches the
  * contract documented on `analyze_floorplan_image` — base64 or http(s) URL.
@@ -82,7 +83,7 @@ const DATA_URI_RE = /^data:(image\/[a-z0-9.+-]+);base64,(.+)$/i;
 async function resolveImageBlock(image) {
     if (/^https?:\/\//i.test(image)) {
         // SSRF-safe fetch (see packages/mcp/src/lib/safe-fetch.ts).
-        const { safeFetch } = await import('../../lib/safe-fetch');
+        const { safeFetch } = await import('../../lib/safe-fetch.js');
         const res = await safeFetch(image, { accept: 'image/*' });
         const data = res.buffer.toString('base64');
         const mimeType = res.contentType ?? 'image/jpeg';
@@ -280,6 +281,7 @@ export function registerPhotoToScene(server, bridge) {
         description: 'Orchestrator: analyse a floor-plan photo via MCP sampling, translate the structured vision result into a Pascal SceneGraph (site → building → level with walls and zones), optionally save it, and swap the bridge to the new scene. Requires host support for sampling.',
         inputSchema: photoToSceneInput,
         outputSchema: photoToSceneOutput,
+        annotations: DESTRUCTIVE_OPEN_WORLD_TOOL_ANNOTATIONS,
     }, async ({ image, scaleHint, name, save, defaultWallThickness, defaultWallHeight }) => {
         // 1. Vision.
         const vision = await callVisionSampling(server, image, scaleHint);

package/dist/tools/place-item.d.ts

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../operations';
+import type { SceneOperations } from '../operations/index.js';
 export declare const placeItemInput: {
     catalogItemId: z.ZodString;
     targetNodeId: z.ZodString;
@@ -8,6 +8,13 @@ export declare const placeItemInput: {
     rotation: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
 };
 export declare const placeItemOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     itemId: z.ZodString;
     status: z.ZodOptional<z.ZodString>;
 };

package/dist/tools/place-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"place-item.d.ts","sourceRoot":"","sources":["../../src/tools/place-item.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,cAAc;;;;;CAK1B,CAAA;AAED,eAAO,MAAM,eAAe;;;CAG3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAsFlF"}
+{"version":3,"file":"place-item.d.ts","sourceRoot":"","sources":["../../src/tools/place-item.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;AASpD,eAAO,MAAM,cAAc;;;;;CAK1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;CAI3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAwFlF"}

package/dist/tools/place-item.js

@@ -1,11 +1,12 @@
 import { ItemNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
-import { findCatalogItem } from './asset-catalog';
-import { ErrorCode, throwMcpError } from './errors';
-import { projectWorldPointToWallLocalX, wallLength } from './geometry';
-import { publishLiveSceneSnapshot } from './live-sync';
-import { measurement } from './measurement';
-import { NodeIdSchema, Vec3Schema } from './schemas';
+import { ADDITIVE_TOOL_ANNOTATIONS } from './annotations.js';
+import { findCatalogItem } from './asset-catalog.js';
+import { ErrorCode, throwMcpError } from './errors.js';
+import { projectWorldPointToWallLocalX, wallLength } from './geometry.js';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync.js';
+import { measurement } from './measurement.js';
+import { NodeIdSchema, Vec3Schema } from './schemas.js';
 export const placeItemInput = {
     catalogItemId: z.string().min(1),
     targetNodeId: NodeIdSchema,
@@ -15,6 +16,7 @@ export const placeItemInput = {
 export const placeItemOutput = {
     itemId: z.string(),
     status: z.string().optional(),
+    ...liveSyncOutput,
 };
 export function registerPlaceItem(server, bridge) {
     server.registerTool('place_item', {
@@ -22,6 +24,7 @@ export function registerPlaceItem(server, bridge) {
         description: 'Place a catalog item into the scene. Target a level/slab/zone for floor items, a wall for wall-attached items, or a ceiling for ceiling-attached items. Do not target the site node directly.',
         inputSchema: placeItemInput,
         outputSchema: placeItemOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ catalogItemId, targetNodeId, position, rotation }) => {
         const target = bridge.getNode(targetNodeId);
         if (!target) {
@@ -72,10 +75,11 @@ export function registerPlaceItem(server, bridge) {
             ...wallExtras,
         });
         const id = bridge.createNode(item, parentId);
-        await publishLiveSceneSnapshot(bridge, 'place_item');
+        const persistence = await publishLiveSceneSnapshot(bridge, 'place_item');
         const payload = {
             itemId: id,
             status: catalogAsset ? 'ok' : 'catalog_unavailable',
+            ...persistencePayload(persistence),
         };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],

package/dist/tools/redo.d.ts

@@ -1,10 +1,17 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../operations';
+import type { SceneOperations } from '../operations/index.js';
 export declare const redoInput: {
     steps: z.ZodOptional<z.ZodNumber>;
 };
 export declare const redoOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     redone: z.ZodNumber;
 };
 export declare function registerRedo(server: McpServer, bridge: SceneOperations): void;

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

@@ -1 +1 @@
-{"version":3,"file":"redo.d.ts","sourceRoot":"","sources":["../../src/tools/redo.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":"redo.d.ts","sourceRoot":"","sources":["../../src/tools/redo.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/redo.js

@@ -1,10 +1,12 @@
 import { z } from 'zod';
-import { publishLiveSceneSnapshot } from './live-sync';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from './annotations.js';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync.js';
 export const redoInput = {
     steps: z.number().int().positive().optional(),
 };
 export const redoOutput = {
     redone: z.number(),
+    ...liveSyncOutput,
 };
 export function registerRedo(server, bridge) {
     server.registerTool('redo', {
@@ -12,11 +14,11 @@ export function registerRedo(server, bridge) {
         description: 'Redo the next N previously-undone steps (default 1). Returns the number of steps actually redone.',
         inputSchema: redoInput,
         outputSchema: redoOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ steps }) => {
         const redone = bridge.redo(steps ?? 1);
-        if (redone > 0)
-            await publishLiveSceneSnapshot(bridge, 'redo');
-        const payload = { redone };
+        const persistence = redone > 0 ? await publishLiveSceneSnapshot(bridge, 'redo') : 'published';
+        const payload = { redone, ...persistencePayload(persistence) };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],
             structuredContent: payload,

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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../operations';
+import type { SceneOperations } from '../operations/index.js';
 export declare const searchAssetsInput: {
     query: z.ZodString;
     category: z.ZodOptional<z.ZodString>;
@@ -18,6 +18,13 @@ export declare const createRoomInput: {
     wallThickness: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
 };
 export declare const createRoomOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     zoneId: z.ZodString;
     slabId: z.ZodString;
     ceilingId: z.ZodString;
@@ -40,6 +47,13 @@ export declare const addDoorInput: {
     }>>;
 };
 export declare const addDoorOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     doorId: z.ZodString;
     localX: z.ZodNumber;
     t: z.ZodNumber;
@@ -57,6 +71,13 @@ export declare const addWindowInput: {
     sillHeight: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
 };
 export declare const addWindowOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     windowId: z.ZodString;
     localX: z.ZodNumber;
     t: z.ZodNumber;
@@ -84,6 +105,13 @@ export declare const furnishRoomInput: {
     doorWallIndex: z.ZodOptional<z.ZodNumber>;
 };
 export declare const furnishRoomOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     placed: z.ZodNumber;
     itemIds: z.ZodArray<z.ZodString>;
     skipped: z.ZodArray<z.ZodString>;

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

@@ -1 +1 @@
-{"version":3,"file":"room-tools.d.ts","sourceRoot":"","sources":["../../src/tools/room-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAWxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AA4BpD,eAAO,MAAM,iBAAiB;;;CAG7B,CAAA;AAED,eAAO,MAAM,kBAAkB;;;CAG9B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;CAa3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;CAM5B,CAAA;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAQxB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;CAQzB,CAAA;AAED,eAAO,MAAM,cAAc;;;;;;;CAU1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;CAS3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;CAM5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAA;AA4QD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB5D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAqDnF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA2ChF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA0ClF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAuHpF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAMlF"}
+{"version":3,"file":"room-tools.d.ts","sourceRoot":"","sources":["../../src/tools/room-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAWxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAkCpD,eAAO,MAAM,iBAAiB;;;CAG7B,CAAA;AAED,eAAO,MAAM,kBAAkB;;;CAG9B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;CAa3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAO5B,CAAA;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAQxB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;CASzB,CAAA;AAED,eAAO,MAAM,cAAc;;;;;;;CAU1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;CAU3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;CAM5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;CAK7B,CAAA;AA4QD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuB5D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAuDnF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA6ChF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA4ClF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA0HpF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAMlF"}

package/dist/tools/room-tools.js

@@ -1,13 +1,14 @@
 import { CeilingNode, DoorNode, ItemNode, SlabNode, WallNode, WindowNode, ZoneNode, } from '@pascal-app/core/schema';
 import { z } from 'zod';
-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 { measurement } from './measurement';
-import { NodeIdSchema, Vec2Schema } from './schemas';
+import { ADDITIVE_TOOL_ANNOTATIONS, READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
+import { findCatalogItem, searchCatalogItems } from './asset-catalog.js';
+import { keepoutCoversPlanned, keepoutForPolygonEdge } from './door-clearance.js';
+import { ErrorCode, throwMcpError } from './errors.js';
+import { polygonArea, polygonBounds, wallLength, wallLocalXFromT } from './geometry.js';
+import { collectDoorKeepouts, collectOccupiedFootprints, findValidPlacement, itemPlanAabb, } from './layout-clearance.js';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot, } from './live-sync.js';
+import { measurement } from './measurement.js';
+import { NodeIdSchema, Vec2Schema } from './schemas.js';
 const ROOM_TYPES = [
     'bedroom',
     'kitchen',
@@ -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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 export declare const createProjectInput: {
     name: z.ZodString;
     id: z.ZodOptional<z.ZodString>;

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,6 +1,7 @@
 import { z } from 'zod';
-import { ErrorCode, throwMcpError } from '../errors';
-import { currentLevelContext, projectStatusPayload } from './metadata';
+import { ADDITIVE_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, throwMcpError } from '../errors.js';
+import { currentLevelContext, projectStatusPayload } from './metadata.js';
 export const createProjectInput = {
     name: z.string().min(1).max(200),
     id: z.string().min(1).max(64).optional(),
@@ -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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 export declare const deleteSceneInput: {
     id: z.ZodString;
     expectedVersion: z.ZodOptional<z.ZodNumber>;

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,6 +1,7 @@
 import { z } from 'zod';
-import { SceneNotFoundError, SceneVersionConflictError } from '../../storage/types';
-import { ErrorCode, throwMcpError } from '../errors';
+import { SceneNotFoundError, SceneVersionConflictError } from '../../storage/types.js';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, throwMcpError } from '../errors.js';
 export const deleteSceneInput = {
     id: z.string().min(1).max(64),
     expectedVersion: z.number().int().positive().optional(),
@@ -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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 export declare const getProjectStatusInput: {
     id: z.ZodString;
 };

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,6 +1,7 @@
 import { z } from 'zod';
-import { ErrorCode, McpError, throwMcpError } from '../errors';
-import { currentLevelContext, projectStatusPayload } from './metadata';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, McpError, throwMcpError } from '../errors.js';
+import { currentLevelContext, projectStatusPayload } from './metadata.js';
 export const getProjectStatusInput = {
     id: z.string().min(1).max(64),
 };
@@ -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/index.d.ts

@@ -1,5 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 /**
  * Register the scene-lifecycle MCP tools (`save_scene`, `load_scene`,
  * `list_scenes`, `delete_scene`, `rename_scene`) against the given server.
@@ -7,11 +7,11 @@ import type { SceneOperations } from '../../operations';
  * entry points share the same storage boundary.
  */
 export declare function registerSceneLifecycleTools(server: McpServer, operations: SceneOperations): void;
-export { createProjectInput, createProjectOutput, registerCreateProject } from './create-project';
-export { deleteSceneInput, deleteSceneOutput, registerDeleteScene } from './delete-scene';
-export { getProjectStatusInput, getProjectStatusOutput, registerGetProjectStatus, } from './get-project-status';
-export { listScenesInput, listScenesOutput, registerListScenes } from './list-scenes';
-export { loadSceneInput, loadSceneOutput, registerLoadScene } from './load-scene';
-export { registerRenameScene, renameSceneInput, renameSceneOutput } from './rename-scene';
-export { registerSaveScene, saveSceneInput, saveSceneOutput } from './save-scene';
+export { createProjectInput, createProjectOutput, registerCreateProject } from './create-project.js';
+export { deleteSceneInput, deleteSceneOutput, registerDeleteScene } from './delete-scene.js';
+export { getProjectStatusInput, getProjectStatusOutput, registerGetProjectStatus, } from './get-project-status.js';
+export { listScenesInput, listScenesOutput, registerListScenes } from './list-scenes.js';
+export { loadSceneInput, loadSceneOutput, registerLoadScene } from './load-scene.js';
+export { registerRenameScene, renameSceneInput, renameSceneOutput } from './rename-scene.js';
+export { registerSaveScene, saveSceneInput, saveSceneOutput } from './save-scene.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,10 +1,10 @@
-import { registerCreateProject } from './create-project';
-import { registerDeleteScene } from './delete-scene';
-import { registerGetProjectStatus } from './get-project-status';
-import { registerListScenes } from './list-scenes';
-import { registerLoadScene } from './load-scene';
-import { registerRenameScene } from './rename-scene';
-import { registerSaveScene } from './save-scene';
+import { registerCreateProject } from './create-project.js';
+import { registerDeleteScene } from './delete-scene.js';
+import { registerGetProjectStatus } from './get-project-status.js';
+import { registerListScenes } from './list-scenes.js';
+import { registerLoadScene } from './load-scene.js';
+import { registerRenameScene } from './rename-scene.js';
+import { registerSaveScene } from './save-scene.js';
 /**
  * Register the scene-lifecycle MCP tools (`save_scene`, `load_scene`,
  * `list_scenes`, `delete_scene`, `rename_scene`) against the given server.
@@ -20,10 +20,10 @@ export function registerSceneLifecycleTools(server, operations) {
     registerDeleteScene(server, operations);
     registerRenameScene(server, operations);
 }
-export { createProjectInput, createProjectOutput, registerCreateProject } from './create-project';
-export { deleteSceneInput, deleteSceneOutput, registerDeleteScene } from './delete-scene';
-export { getProjectStatusInput, getProjectStatusOutput, registerGetProjectStatus, } from './get-project-status';
-export { listScenesInput, listScenesOutput, registerListScenes } from './list-scenes';
-export { loadSceneInput, loadSceneOutput, registerLoadScene } from './load-scene';
-export { registerRenameScene, renameSceneInput, renameSceneOutput } from './rename-scene';
-export { registerSaveScene, saveSceneInput, saveSceneOutput } from './save-scene';
+export { createProjectInput, createProjectOutput, registerCreateProject } from './create-project.js';
+export { deleteSceneInput, deleteSceneOutput, registerDeleteScene } from './delete-scene.js';
+export { getProjectStatusInput, getProjectStatusOutput, registerGetProjectStatus, } from './get-project-status.js';
+export { listScenesInput, listScenesOutput, registerListScenes } from './list-scenes.js';
+export { loadSceneInput, loadSceneOutput, registerLoadScene } from './load-scene.js';
+export { registerRenameScene, renameSceneInput, renameSceneOutput } from './rename-scene.js';
+export { registerSaveScene, saveSceneInput, saveSceneOutput } from './save-scene.js';

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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 export declare const listScenesInput: {
     projectId: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;

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"}