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

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

@@ -5,6 +5,13 @@ export declare const duplicateLevelInput: {
     levelId: z.ZodString;
 };
 export declare const duplicateLevelOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     newLevelId: z.ZodString;
     newNodeIds: z.ZodArray<z.ZodString>;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"duplicate-level.d.ts","sourceRoot":"","sources":["../../src/tools/duplicate-level.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,eAAe,CAAA;AAKpD,eAAO,MAAM,mBAAmB;;CAE/B,CAAA;AAED,eAAO,MAAM,oBAAoB;;;CAGhC,CAAA;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAsDvF"}
+{"version":3,"file":"duplicate-level.d.ts","sourceRoot":"","sources":["../../src/tools/duplicate-level.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,eAAe,CAAA;AAMpD,eAAO,MAAM,mBAAmB;;CAE/B,CAAA;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;CAIhC,CAAA;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAwDvF"}

package/dist/tools/duplicate-level.js

@@ -1,7 +1,8 @@
 import { cloneLevelSubtree } from '@pascal-app/core/clone-scene-graph';
 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 } from './schemas';
 export const duplicateLevelInput = {
     levelId: NodeIdSchema,
@@ -9,6 +10,7 @@ export const duplicateLevelInput = {
 export const duplicateLevelOutput = {
     newLevelId: z.string(),
     newNodeIds: z.array(z.string()),
+    ...liveSyncOutput,
 };
 export function registerDuplicateLevel(server, bridge) {
     server.registerTool('duplicate_level', {
@@ -16,6 +18,7 @@ export function registerDuplicateLevel(server, bridge) {
         description: 'Clone a level and all its descendants into a new subtree attached to the same building.',
         inputSchema: duplicateLevelInput,
         outputSchema: duplicateLevelOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ levelId }) => {
         const node = bridge.getNode(levelId);
         if (!node) {
@@ -43,10 +46,11 @@ export function registerDuplicateLevel(server, bridge) {
             return createOp;
         });
         const result = bridge.applyPatch(patches);
-        await publishLiveSceneSnapshot(bridge, 'duplicate_level');
+        const persistence = await publishLiveSceneSnapshot(bridge, 'duplicate_level');
         const payload = {
             newLevelId: newLevelId,
             newNodeIds: result.createdIds,
+            ...persistencePayload(persistence),
         };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],

package/dist/tools/export-glb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export-glb.d.ts","sourceRoot":"","sources":["../../src/tools/export-glb.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,cAAc,IAAK,CAAA;AAEhC,eAAO,MAAM,eAAe;;;CAG3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAsBnF"}
+{"version":3,"file":"export-glb.d.ts","sourceRoot":"","sources":["../../src/tools/export-glb.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,cAAc,IAAK,CAAA;AAEhC,eAAO,MAAM,eAAe;;;CAG3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAuBnF"}

package/dist/tools/export-glb.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations';
 export const exportGlbInput = {};
 export const exportGlbOutput = {
     status: z.literal('not_implemented'),
@@ -7,9 +8,10 @@ export const exportGlbOutput = {
 export function registerExportGlb(server, _bridge) {
     server.registerTool('export_glb', {
         title: 'Export GLB',
-        description: 'GLB export is not available in headless mode — it requires the Three.js renderer, which is browser-only. Returns a structured `not_implemented` response.',
+        description: 'GLB export is not available in headless mode — it requires the Three.js renderer, which is browser-only. Returns a structured `not_implemented` tool error.',
         inputSchema: exportGlbInput,
         outputSchema: exportGlbOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async () => {
         const payload = {
             status: 'not_implemented',
@@ -18,7 +20,7 @@ export function registerExportGlb(server, _bridge) {
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],
             structuredContent: payload,
-            isError: false,
+            isError: true,
         };
     });
 }

package/dist/tools/export-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export-json.d.ts","sourceRoot":"","sources":["../../src/tools/export-json.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,eAAe;;CAE3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAoBnF"}
+{"version":3,"file":"export-json.d.ts","sourceRoot":"","sources":["../../src/tools/export-json.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,eAAe;;CAE3B,CAAA;AAED,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAqBnF"}

package/dist/tools/export-json.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations';
 export const exportJsonInput = {
     pretty: z.boolean().optional(),
 };
@@ -11,6 +12,7 @@ export function registerExportJson(server, bridge) {
         description: 'Return the scene as a serialized JSON string. Pass `pretty: true` to indent with 2 spaces.',
         inputSchema: exportJsonInput,
         outputSchema: exportJsonOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ pretty }) => {
         const scene = bridge.exportJSON();
         const json = JSON.stringify(scene, null, pretty ? 2 : 0);

package/dist/tools/find-nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-nodes.d.ts","sourceRoot":"","sources":["../../src/tools/find-nodes.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;AAuBpD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;CAK1B,CAAA;AAED,eAAO,MAAM,eAAe;;CAE3B,CAAA;AAkCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAuDlF"}
+{"version":3,"file":"find-nodes.d.ts","sourceRoot":"","sources":["../../src/tools/find-nodes.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;AAwBpD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;CAK1B,CAAA;AAED,eAAO,MAAM,eAAe;;CAE3B,CAAA;AAkCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAwDlF"}

package/dist/tools/find-nodes.js

@@ -1,5 +1,6 @@
 import { pointInPolygon } from '@pascal-app/core/spatial-grid';
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations';
 import { NodeIdSchema } from './schemas';
 const ALL_NODE_TYPES = [
     'site',
@@ -65,6 +66,7 @@ export function registerFindNodes(server, bridge) {
         description: 'Find nodes matching any combination of type, parentId, levelId, or zoneId filters.',
         inputSchema: findNodesInput,
         outputSchema: findNodesOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async (args) => {
         const { type, parentId, levelId, zoneId } = args;
         // Delegate type/parent/level filtering to the bridge.

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

@@ -1 +1 @@
-{"version":3,"file":"get-node.d.ts","sourceRoot":"","sources":["../../src/tools/get-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD,eAAO,MAAM,YAAY;;CAExB,CAAA;AAED,eAAO,MAAM,aAAa;;CAEzB,CAAA;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAqBhF"}
+{"version":3,"file":"get-node.d.ts","sourceRoot":"","sources":["../../src/tools/get-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,YAAY;;CAExB,CAAA;AAED,eAAO,MAAM,aAAa;;CAEzB,CAAA;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAsBhF"}

package/dist/tools/get-node.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations';
 import { ErrorCode, throwMcpError } from './errors';
 import { NodeIdSchema } from './schemas';
 export const getNodeInput = {
@@ -13,6 +14,7 @@ export function registerGetNode(server, bridge) {
         description: 'Return the full node payload for the given ID.',
         inputSchema: getNodeInput,
         outputSchema: getNodeOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ id }) => {
         const node = bridge.getNode(id);
         if (!node) {

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

@@ -1 +1 @@
-{"version":3,"file":"get-scene.d.ts","sourceRoot":"","sources":["../../src/tools/get-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,aAAa,IAAK,CAAA;AAE/B,eAAO,MAAM,cAAc;;;;CAI1B,CAAA;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAuBjF"}
+{"version":3,"file":"get-scene.d.ts","sourceRoot":"","sources":["../../src/tools/get-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,aAAa,IAAK,CAAA;AAE/B,eAAO,MAAM,cAAc;;;;CAI1B,CAAA;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAwBjF"}

package/dist/tools/get-scene.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations';
 export const getSceneInput = {};
 export const getSceneOutput = {
     nodes: z.record(z.string(), z.unknown()),
@@ -11,6 +12,7 @@ export function registerGetScene(server, bridge) {
         description: 'Returns the full scene graph: flat node dictionary, root node IDs, and collections.',
         inputSchema: getSceneInput,
         outputSchema: getSceneOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async () => {
         const scene = bridge.exportJSON();
         const payload = {

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

@@ -25,6 +25,8 @@ export type ItemCollision = {
     bName?: string;
     levelId?: string | null;
     kind: 'item-aabb';
+    violation: 'overlap' | 'clearance';
+    minimumClearanceMeters: number;
     message: string;
 };
 export declare function nodeItemAabb(node: AnyNode): PlanAabb | null;

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

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

package/dist/tools/layout-clearance.js

@@ -71,7 +71,11 @@ export function findItemItemCollisions(args) {
                 bName: b.name,
                 levelId: a.levelId ?? b.levelId,
                 kind: 'item-aabb',
-                message: `Items overlap: ${a.name ?? a.id} (${a.id}) and ${b.name ?? b.id} (${b.id})`,
+                violation: aabbsOverlap(a.aabb, b.aabb, 0) ? 'overlap' : 'clearance',
+                minimumClearanceMeters: gap,
+                message: aabbsOverlap(a.aabb, b.aabb, 0)
+                    ? `Items overlap: ${a.name ?? a.id} (${a.id}) and ${b.name ?? b.id} (${b.id})`
+                    : `Items are closer than ${gap} m: ${a.name ?? a.id} (${a.id}) and ${b.name ?? b.id} (${b.id})`,
             });
         }
     }

package/dist/tools/live-sync.d.ts

@@ -1,11 +1,41 @@
 import type { SceneGraph } from '@pascal-app/core/clone-scene-graph';
+import { z } from 'zod';
 import type { SceneOperations } from '../operations';
 export declare function syncDerivedStairOpenings(operations: SceneOperations): number;
+export type LiveSyncStatus = 'published' | 'unbound' | 'events_unsupported';
+type LiveSyncSkip = Exclude<LiveSyncStatus, 'published'>;
+/**
+ * Output-schema fragment for every tool that mutates the scene. Spread into
+ * the tool's `outputSchema` so `persistencePayload` fields survive the SDK's
+ * structured-content validation.
+ */
+export declare const liveSyncOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
+};
+/**
+ * Payload fragment matching `liveSyncOutput`: empty after a successful
+ * publish, a `persistence` warning when the mutation stayed in-memory.
+ */
+export declare function persistencePayload(status: LiveSyncStatus): {
+    persistence?: {
+        status: LiveSyncSkip;
+        warning: string;
+    };
+};
 /**
  * Persist the bridge's current graph to the active scene and append a live
- * event for browser subscribers. No-ops when the MCP session is not currently
- * bound to a saved scene.
+ * event for browser subscribers. Skips persistence — reporting why — when the
+ * MCP session is not currently bound to a saved scene or the store cannot
+ * append scene events; callers surface that through `persistencePayload` so
+ * the skip is never silent (#725).
  */
-export declare function publishLiveSceneSnapshot(operations: SceneOperations, kind: string): Promise<void>;
+export declare function publishLiveSceneSnapshot(operations: SceneOperations, kind: string): Promise<LiveSyncStatus>;
 export declare function appendLiveSceneEvent(operations: SceneOperations, sceneId: string, version: number, kind: string, graph: SceneGraph): Promise<void>;
+export {};
 //# sourceMappingURL=live-sync.d.ts.map

package/dist/tools/live-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-sync.d.ts","sourceRoot":"","sources":["../../src/tools/live-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAW5E;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,eAAe,EAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"version":3,"file":"live-sync.d.ts","sourceRoot":"","sources":["../../src/tools/live-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAEpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAW5E;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,oBAAoB,CAAA;AAE3E,KAAK,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;AAExD;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;CAO1B,CAAA;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG;IAC1D,WAAW,CAAC,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CACxD,CAGA;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,eAAe,EAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CAwCzB;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/tools/live-sync.js

@@ -1,4 +1,5 @@
 import { syncAutoStairOpenings } from '@pascal-app/core/stair-openings';
+import { z } from 'zod';
 import { SceneVersionConflictError } from '../storage/types';
 import { ErrorCode, throwMcpError } from './errors';
 export function syncDerivedStairOpenings(operations) {
@@ -12,16 +13,46 @@ export function syncDerivedStairOpenings(operations) {
     })));
     return updates.length;
 }
+/**
+ * Output-schema fragment for every tool that mutates the scene. Spread into
+ * the tool's `outputSchema` so `persistencePayload` fields survive the SDK's
+ * structured-content validation.
+ */
+export const liveSyncOutput = {
+    persistence: z
+        .object({
+        status: z.enum(['unbound', 'events_unsupported']),
+        warning: z.string(),
+    })
+        .optional(),
+};
+const LIVE_SYNC_WARNINGS = {
+    unbound: 'The change was applied to the in-memory session only: no active scene is bound, so nothing was persisted and no live event reached subscribers. Bind a scene with save_scene or load_scene to persist changes.',
+    events_unsupported: 'The change was applied to the in-memory session only: the attached scene store does not support live scene events, so nothing was persisted.',
+};
+/**
+ * Payload fragment matching `liveSyncOutput`: empty after a successful
+ * publish, a `persistence` warning when the mutation stayed in-memory.
+ */
+export function persistencePayload(status) {
+    if (status === 'published')
+        return {};
+    return { persistence: { status, warning: LIVE_SYNC_WARNINGS[status] } };
+}
 /**
  * Persist the bridge's current graph to the active scene and append a live
- * event for browser subscribers. No-ops when the MCP session is not currently
- * bound to a saved scene.
+ * event for browser subscribers. Skips persistence — reporting why — when the
+ * MCP session is not currently bound to a saved scene or the store cannot
+ * append scene events; callers surface that through `persistencePayload` so
+ * the skip is never silent (#725).
  */
 export async function publishLiveSceneSnapshot(operations, kind) {
     syncDerivedStairOpenings(operations);
     const active = operations.getActiveScene();
-    if (!(active && operations.canAppendSceneEvents))
-        return;
+    if (!active)
+        return 'unbound';
+    if (!operations.canAppendSceneEvents)
+        return 'events_unsupported';
     const graph = operations.exportSceneGraph();
     try {
         const meta = await operations.saveScene({
@@ -54,6 +85,7 @@ export async function publishLiveSceneSnapshot(operations, kind) {
         const message = error instanceof Error ? error.message : String(error);
         throwMcpError(ErrorCode.InternalError, `live_sync_failed: ${message}`);
     }
+    return 'published';
 }
 export async function appendLiveSceneEvent(operations, sceneId, version, kind, graph) {
     if (!operations.canAppendSceneEvents)

package/dist/tools/measure.d.ts

@@ -9,6 +9,7 @@ export declare const measureOutput: {
     distanceMeters: z.ZodNumber;
     areaSqMeters: z.ZodOptional<z.ZodNumber>;
     units: z.ZodLiteral<"meters">;
+    areaUnits: z.ZodOptional<z.ZodLiteral<"square_meters">>;
 };
 export declare function registerMeasure(server: McpServer, bridge: SceneOperations): void;
 //# sourceMappingURL=measure.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/tools/measure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD,eAAO,MAAM,YAAY;;;CAGxB,CAAA;AAED,eAAO,MAAM,aAAa;;;;CAIzB,CAAA;AAsED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAuEhF"}
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/tools/measure.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,YAAY;;;CAGxB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;CAKzB,CAAA;AAsED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAyEhF"}

package/dist/tools/measure.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations';
 import { ErrorCode, throwMcpError } from './errors';
 import { NodeIdSchema } from './schemas';
 export const measureInput = {
@@ -9,6 +10,7 @@ export const measureOutput = {
     distanceMeters: z.number(),
     areaSqMeters: z.number().optional(),
     units: z.literal('meters'),
+    areaUnits: z.literal('square_meters').optional(),
 };
 /**
  * Compute a 3D centre point in level-coordinate space for distance measurement.
@@ -85,6 +87,7 @@ export function registerMeasure(server, bridge) {
         description: 'Measure distance (in meters) between two nodes, or the net area of a polygon node when fromId === toId.',
         inputSchema: measureInput,
         outputSchema: measureOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ fromId, toId }) => {
         const from = bridge.getNode(fromId);
         if (!from) {
@@ -107,6 +110,7 @@ export function registerMeasure(server, bridge) {
                     distanceMeters: 0,
                     areaSqMeters: area,
                     units: 'meters',
+                    areaUnits: 'square_meters',
                 };
                 return {
                     content: [{ type: 'text', text: JSON.stringify(payload) }],

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

@@ -1 +1 @@
-{"version":3,"file":"photo-to-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/photo-to-scene/photo-to-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAYxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAIvD;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;CAa7B,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;;;;CAQ9B,CAAA;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,6 +1,7 @@
 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 { DESTRUCTIVE_OPEN_WORLD_TOOL_ANNOTATIONS } from '../annotations';
 import { appendLiveSceneEvent } from '../live-sync';
 import { measurement } from '../measurement';
 /**
@@ -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

@@ -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,9 +1,10 @@
 import { ItemNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
+import { ADDITIVE_TOOL_ANNOTATIONS } from './annotations';
 import { findCatalogItem } from './asset-catalog';
 import { ErrorCode, throwMcpError } from './errors';
 import { projectWorldPointToWallLocalX, wallLength } from './geometry';
-import { publishLiveSceneSnapshot } from './live-sync';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync';
 import { measurement } from './measurement';
 import { NodeIdSchema, Vec3Schema } from './schemas';
 export const placeItemInput = {
@@ -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

@@ -5,6 +5,13 @@ 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';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync';
 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

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