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

package/dist/tools/export-glb.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
 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

@@ -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 exportJsonInput: {
     pretty: z.ZodOptional<z.ZodBoolean>;
 };

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.js';
 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

@@ -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 findNodesInput: {
     type: z.ZodOptional<z.ZodEnum<{
         site: "site";

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,6 +1,7 @@
 import { pointInPolygon } from '@pascal-app/core/spatial-grid';
 import { z } from 'zod';
-import { NodeIdSchema } from './schemas';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
+import { NodeIdSchema } from './schemas.js';
 const ALL_NODE_TYPES = [
     'site',
     'building',
@@ -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

@@ -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 getNodeInput: {
     id: z.ZodString;
 };

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,6 +1,7 @@
 import { z } from 'zod';
-import { ErrorCode, throwMcpError } from './errors';
-import { NodeIdSchema } from './schemas';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
+import { ErrorCode, throwMcpError } from './errors.js';
+import { NodeIdSchema } from './schemas.js';
 export const getNodeInput = {
     id: NodeIdSchema,
 };
@@ -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

@@ -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 getSceneInput: {};
 export declare const getSceneOutput: {
     nodes: z.ZodRecord<z.ZodString, z.ZodUnknown>;

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.js';
 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/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 every non-vision MCP tool against the given server.
  * Vision tools (analyze_floorplan_image, analyze_room_photo) are registered

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AA4BpD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA6BlF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AA+BpD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAgClF"}

package/dist/tools/index.js

@@ -1,29 +1,32 @@
-import { registerApplyPatch } from './apply-patch';
-import { registerCheckCollisions } from './check-collisions';
-import { registerConstructionTools } from './construction-tools';
-import { registerCreateLevel } from './create-level';
-import { registerCreateWall } from './create-wall';
-import { registerCutOpening } from './cut-opening';
-import { registerDeleteNode } from './delete-node';
-import { registerDescribeNode } from './describe-node';
-import { registerDuplicateLevel } from './duplicate-level';
-import { registerExportGlb } from './export-glb';
-import { registerExportJson } from './export-json';
-import { registerFindNodes } from './find-nodes';
-import { registerGetNode } from './get-node';
-import { registerGetScene } from './get-scene';
-import { registerMeasure } from './measure';
-import { registerPhotoToSceneTool } from './photo-to-scene';
-import { registerPlaceItem } from './place-item';
-import { registerRedo } from './redo';
-import { registerRoomTools } from './room-tools';
-import { registerSceneLifecycleTools } from './scene-lifecycle';
-import { registerSceneQueryTools } from './scene-query';
-import { registerSetZone } from './set-zone';
-import { registerTemplateTools } from './templates';
-import { registerUndo } from './undo';
-import { registerValidateScene } from './validate-scene';
-import { registerVariantTools } from './variants';
+import { registerApplyPatch } from './apply-patch.js';
+import { registerCheckCollisions } from './check-collisions.js';
+import { registerConstructionTools } from './construction-tools.js';
+import { registerCreateLevel } from './create-level.js';
+import { registerCreateUnit } from './create-unit.js';
+import { registerCreateWall } from './create-wall.js';
+import { registerCutOpening } from './cut-opening.js';
+import { registerDeleteNode } from './delete-node.js';
+import { registerDescribeNode } from './describe-node.js';
+import { registerDuplicateLevel } from './duplicate-level.js';
+import { registerExportGlb } from './export-glb.js';
+import { registerExportJson } from './export-json.js';
+import { registerFindNodes } from './find-nodes.js';
+import { registerGetNode } from './get-node.js';
+import { registerGetScene } from './get-scene.js';
+import { registerListUnits } from './list-units.js';
+import { registerMeasure } from './measure.js';
+import { registerPhotoToSceneTool } from './photo-to-scene/index.js';
+import { registerPlaceItem } from './place-item.js';
+import { registerRedo } from './redo.js';
+import { registerRoomTools } from './room-tools.js';
+import { registerSceneLifecycleTools } from './scene-lifecycle/index.js';
+import { registerSceneQueryTools } from './scene-query.js';
+import { registerSetUnitMembers } from './set-unit-members.js';
+import { registerSetZone } from './set-zone.js';
+import { registerTemplateTools } from './templates/index.js';
+import { registerUndo } from './undo.js';
+import { registerValidateScene } from './validate-scene.js';
+import { registerVariantTools } from './variants/index.js';
 /**
  * Register every non-vision MCP tool against the given server.
  * Vision tools (analyze_floorplan_image, analyze_room_photo) are registered
@@ -43,6 +46,9 @@ export function registerTools(server, operations) {
     registerRoomTools(server, operations);
     registerApplyPatch(server, operations);
     registerCreateLevel(server, operations);
+    registerCreateUnit(server, operations);
+    registerSetUnitMembers(server, operations);
+    registerListUnits(server, operations);
     registerCreateWall(server, operations);
     registerPlaceItem(server, operations);
     registerCutOpening(server, operations);

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

@@ -8,8 +8,8 @@
  * See docs/layout-clearance-error-log.md for regression checklist.
  */
 import type { AnyNode } from '@pascal-app/core/schema';
-import { type PlanAabb } from './door-clearance';
-export { aabbsOverlap, collectDoorKeepouts, findBlockedDoors, itemNodePlanAabb, itemPlanAabb, type PlanAabb, resolveNodeLevelId, } from './door-clearance';
+import { type PlanAabb } from './door-clearance.js';
+export { aabbsOverlap, collectDoorKeepouts, findBlockedDoors, itemNodePlanAabb, itemPlanAabb, type PlanAabb, resolveNodeLevelId, } from './door-clearance.js';
 /** Minimum free space (m) required between item footprints. */
 export declare const DEFAULT_ITEM_GAP = 0.08;
 export type OccupiedFootprint = {
@@ -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

@@ -7,8 +7,8 @@
  *
  * See docs/layout-clearance-error-log.md for regression checklist.
  */
-import { aabbsOverlap, findBlockedDoors, itemNodePlanAabb, itemPlanAabb, resolveNodeLevelId, } from './door-clearance';
-export { aabbsOverlap, collectDoorKeepouts, findBlockedDoors, itemNodePlanAabb, itemPlanAabb, resolveNodeLevelId, } from './door-clearance';
+import { aabbsOverlap, findBlockedDoors, itemNodePlanAabb, itemPlanAabb, resolveNodeLevelId, } from './door-clearance.js';
+export { aabbsOverlap, collectDoorKeepouts, findBlockedDoors, itemNodePlanAabb, itemPlanAabb, resolveNodeLevelId, } from './door-clearance.js';
 /** Minimum free space (m) required between item footprints. */
 export const DEFAULT_ITEM_GAP = 0.08;
 export function nodeItemAabb(node) {
@@ -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/list-units.d.ts

@@ -0,0 +1,38 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import type { SceneOperations } from '../operations/index.js';
+export declare const listUnitsInput: {
+    buildingId: z.ZodOptional<z.ZodString>;
+};
+export declare const listUnitsOutput: {
+    units: z.ZodArray<z.ZodObject<{
+        unitId: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<{
+            apartment: "apartment";
+            "hotel-room": "hotel-room";
+            commercial: "commercial";
+            common: "common";
+        }>>;
+        color: z.ZodString;
+        members: z.ZodArray<z.ZodString>;
+        report: z.ZodObject<{
+            memberCount: z.ZodNumber;
+            levelSpan: z.ZodNullable<z.ZodObject<{
+                minOrdinal: z.ZodNumber;
+                maxOrdinal: z.ZodNumber;
+                count: z.ZodNumber;
+            }, z.core.$strip>>;
+            grossAreaM2: z.ZodNumber;
+            members: z.ZodArray<z.ZodObject<{
+                zoneId: z.ZodString;
+                name: z.ZodString;
+                levelId: z.ZodNullable<z.ZodString>;
+                levelOrdinal: z.ZodNullable<z.ZodNumber>;
+                areaM2: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+};
+export declare function registerListUnits(server: McpServer, bridge: SceneOperations): void;
+//# sourceMappingURL=list-units.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-units.d.ts","sourceRoot":"","sources":["../../src/tools/list-units.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,cAAc;;CAE1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgClF"}

package/dist/tools/list-units.js

@@ -0,0 +1,61 @@
+import { buildUnitReport } from '@pascal-app/core';
+import { UnitNode } from '@pascal-app/core/schema';
+import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
+import { NodeIdSchema } from './schemas.js';
+import { validateUnitMembers } from './unit-members.js';
+export const listUnitsInput = {
+    buildingId: NodeIdSchema.optional(),
+};
+export const listUnitsOutput = {
+    units: z.array(z.object({
+        unitId: z.string(),
+        name: z.string(),
+        kind: UnitNode.shape.kind,
+        color: z.string(),
+        members: z.array(z.string()),
+        report: z.object({
+            memberCount: z.number(),
+            levelSpan: z
+                .object({ minOrdinal: z.number(), maxOrdinal: z.number(), count: z.number() })
+                .nullable(),
+            grossAreaM2: z.number(),
+            members: z.array(z.object({
+                zoneId: z.string(),
+                name: z.string(),
+                levelId: z.string().nullable(),
+                levelOrdinal: z.number().nullable(),
+                areaM2: z.number(),
+            })),
+        }),
+    })),
+};
+export function registerListUnits(server, bridge) {
+    server.registerTool('list_units', {
+        title: 'List units',
+        description: 'List units with their member zones and current area reports, optionally filtered by building.',
+        inputSchema: listUnitsInput,
+        outputSchema: listUnitsOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
+    }, async ({ buildingId }) => {
+        if (buildingId !== undefined)
+            validateUnitMembers(bridge, buildingId, []);
+        const nodes = bridge.getNodes();
+        const units = Object.values(nodes)
+            .filter((node) => node.type === 'unit')
+            .filter((unit) => buildingId === undefined || unit.parentId === buildingId)
+            .map((unit) => ({
+            unitId: unit.id,
+            name: unit.name,
+            kind: unit.kind,
+            color: unit.color,
+            members: unit.members,
+            report: buildUnitReport(unit, nodes),
+        }));
+        const payload = { units };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(payload) }],
+            structuredContent: payload,
+        };
+    });
+}

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

@@ -1,11 +1,41 @@
 import type { SceneGraph } from '@pascal-app/core/clone-scene-graph';
-import type { SceneOperations } from '../operations';
+import { z } from 'zod';
+import type { SceneOperations } from '../operations/index.js';
 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,6 +1,7 @@
 import { syncAutoStairOpenings } from '@pascal-app/core/stair-openings';
-import { SceneVersionConflictError } from '../storage/types';
-import { ErrorCode, throwMcpError } from './errors';
+import { z } from 'zod';
+import { SceneVersionConflictError } from '../storage/types.js';
+import { ErrorCode, throwMcpError } from './errors.js';
 export function syncDerivedStairOpenings(operations) {
     const updates = syncAutoStairOpenings(operations.getNodes());
     if (updates.length === 0)
@@ -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

@@ -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 measureInput: {
     fromId: z.ZodString;
     toId: z.ZodString;
@@ -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,6 +1,7 @@
 import { z } from 'zod';
-import { ErrorCode, throwMcpError } from './errors';
-import { NodeIdSchema } from './schemas';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
+import { ErrorCode, throwMcpError } from './errors.js';
+import { NodeIdSchema } from './schemas.js';
 export const measureInput = {
     fromId: NodeIdSchema,
     toId: NodeIdSchema,
@@ -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/normalize-schema-dialect.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function normalizeToolSchemaDialect(server: McpServer): void;
+//# sourceMappingURL=normalize-schema-dialect.d.ts.map

package/dist/tools/normalize-schema-dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-schema-dialect.d.ts","sourceRoot":"","sources":["../../src/tools/normalize-schema-dialect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAuBxE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAWlE"}

package/dist/tools/normalize-schema-dialect.js

@@ -0,0 +1,28 @@
+import { ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+const DIALECT_2020_12 = 'https://json-schema.org/draft/2020-12/schema';
+function retargetDialect(value) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            retargetDialect(item);
+        return;
+    }
+    if (value && typeof value === 'object') {
+        const record = value;
+        if (typeof record.$schema === 'string')
+            record.$schema = DIALECT_2020_12;
+        for (const key of Object.keys(record))
+            retargetDialect(record[key]);
+    }
+}
+export function normalizeToolSchemaDialect(server) {
+    const registry = server.server;
+    const original = registry._requestHandlers.get('tools/list');
+    if (!original)
+        return;
+    server.server.removeRequestHandler('tools/list');
+    server.server.setRequestHandler(ListToolsRequestSchema, async (request, extra) => {
+        const result = (await original(request, extra));
+        retargetDialect(result.tools);
+        return result;
+    });
+}