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

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

package/dist/tools/unit-members.d.ts

@@ -0,0 +1,4 @@
+import type { ZoneNode } from '@pascal-app/core/schema';
+import type { SceneOperations } from '../operations/index.js';
+export declare function validateUnitMembers(bridge: SceneOperations, buildingId: string, memberZoneIds: string[]): ZoneNode['id'][];
+//# sourceMappingURL=unit-members.d.ts.map

package/dist/tools/unit-members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-members.d.ts","sourceRoot":"","sources":["../../src/tools/unit-members.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EAAE,GACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,CA6BlB"}

package/dist/tools/unit-members.js

@@ -0,0 +1,24 @@
+import { ErrorCode, throwMcpError } from './errors.js';
+export function validateUnitMembers(bridge, buildingId, memberZoneIds) {
+    const building = bridge.getNode(buildingId);
+    if (!building) {
+        throwMcpError(ErrorCode.InvalidParams, `Building not found: ${buildingId}`);
+    }
+    if (building.type !== 'building') {
+        throwMcpError(ErrorCode.InvalidParams, `Node ${buildingId} is a ${building.type}, expected building`);
+    }
+    return memberZoneIds.map((zoneId) => {
+        const zone = bridge.getNode(zoneId);
+        if (!zone) {
+            throwMcpError(ErrorCode.InvalidParams, `Zone not found: ${zoneId}`);
+        }
+        if (zone.type !== 'zone') {
+            throwMcpError(ErrorCode.InvalidParams, `Node ${zoneId} is a ${zone.type}, expected zone`);
+        }
+        const [, level, parent] = bridge.getAncestry(zone.id);
+        if (level?.type !== 'level' || parent?.id !== building.id) {
+            throwMcpError(ErrorCode.InvalidParams, `Zone ${zoneId} must belong to a level in building ${buildingId}`);
+        }
+        return zone.id;
+    });
+}

package/dist/tools/validate-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 validateSceneInput: {};
 export declare const validateSceneOutput: {
     valid: z.ZodBoolean;

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

@@ -1 +1 @@
-{"version":3,"file":"validate-scene.d.ts","sourceRoot":"","sources":["../../src/tools/validate-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,eAAO,MAAM,kBAAkB,IAAK,CAAA;AAEpC,eAAO,MAAM,mBAAmB;;;;;;;CAS/B,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAkBtF"}
+{"version":3,"file":"validate-scene.d.ts","sourceRoot":"","sources":["../../src/tools/validate-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,eAAO,MAAM,kBAAkB,IAAK,CAAA;AAEpC,eAAO,MAAM,mBAAmB;;;;;;;CAS/B,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmBtF"}

package/dist/tools/validate-scene.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
 export const validateSceneInput = {};
 export const validateSceneOutput = {
     valid: z.boolean(),
@@ -14,6 +15,7 @@ export function registerValidateScene(server, bridge) {
         description: 'Run Zod validation against every node in the scene. Returns `{ valid, errors }` where each error has `{ nodeId, path, message }`.',
         inputSchema: validateSceneInput,
         outputSchema: validateSceneOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async () => {
         const result = bridge.validateScene();
         return {

package/dist/tools/variants/generate-variants.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 generateVariantsInput: {
     baseSceneId: z.ZodOptional<z.ZodString>;
     count: z.ZodDefault<z.ZodNumber>;

package/dist/tools/variants/generate-variants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-variants.d.ts","sourceRoot":"","sources":["../../../src/tools/variants/generate-variants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAcvD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;CAYjC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;CAWlC,CAAA;AAcD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA0FzF"}
+{"version":3,"file":"generate-variants.d.ts","sourceRoot":"","sources":["../../../src/tools/variants/generate-variants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAevD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;CAYjC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;CAWlC,CAAA;AAcD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA2FzF"}

package/dist/tools/variants/generate-variants.js

@@ -1,8 +1,9 @@
 import { forkSceneGraph } from '@pascal-app/core/clone-scene-graph';
 import { AnyNode as AnyNodeSchema } from '@pascal-app/core/schema';
 import { z } from 'zod';
-import { ErrorCode, throwMcpError } from '../errors';
-import { applyMutation, describeVariant, mulberry32 } from './mutations';
+import { ADDITIVE_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, throwMcpError } from '../errors.js';
+import { applyMutation, describeVariant, mulberry32 } from './mutations.js';
 const MUTATION_KINDS = [
     'wall-thickness',
     'wall-height',
@@ -53,6 +54,7 @@ export function registerGenerateVariants(server, bridge) {
         description: 'Generate N variations of a base scene by forking and applying seeded mutations. Example: "give me 5 variations of this kitchen". If `save=true`, each variant is persisted via scene operations and returned with an id + URL; otherwise the graph is returned inline.',
         inputSchema: generateVariantsInput,
         outputSchema: generateVariantsOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ baseSceneId, count, vary, seed, save }) => {
         // 1. Obtain the base SceneGraph.
         let base;

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

@@ -1,9 +1,9 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 /**
  * Register the variant-generation MCP tools against shared scene operations.
  */
 export declare function registerVariantTools(server: McpServer, bridge: SceneOperations): void;
-export { generateVariantsInput, generateVariantsOutput, registerGenerateVariants, } from './generate-variants';
-export { applyMutation, describeVariant, type MutationKind, mulberry32, type Rng, } from './mutations';
+export { generateVariantsInput, generateVariantsOutput, registerGenerateVariants, } from './generate-variants.js';
+export { applyMutation, describeVariant, type MutationKind, mulberry32, type Rng, } from './mutations.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/variants/index.js

@@ -1,9 +1,9 @@
-import { registerGenerateVariants } from './generate-variants';
+import { registerGenerateVariants } from './generate-variants.js';
 /**
  * Register the variant-generation MCP tools against shared scene operations.
  */
 export function registerVariantTools(server, bridge) {
     registerGenerateVariants(server, bridge);
 }
-export { generateVariantsInput, generateVariantsOutput, registerGenerateVariants, } from './generate-variants';
-export { applyMutation, describeVariant, mulberry32, } from './mutations';
+export { generateVariantsInput, generateVariantsOutput, registerGenerateVariants, } from './generate-variants.js';
+export { applyMutation, describeVariant, mulberry32, } from './mutations.js';

package/dist/tools/vision/analyze-floorplan-image.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 `analyze_floorplan_image`.
  *

package/dist/tools/vision/analyze-floorplan-image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-floorplan-image.d.ts","sourceRoot":"","sources":["../../../src/tools/vision/analyze-floorplan-image.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,kBAAkB,CAAA;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;CAMtC,CAAA;AAED,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;CAoBvC,CAAA;AAgFD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAiE/F"}
+{"version":3,"file":"analyze-floorplan-image.d.ts","sourceRoot":"","sources":["../../../src/tools/vision/analyze-floorplan-image.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,kBAAkB,CAAA;AAGvD;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;CAMtC,CAAA;AAED,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;CAoBvC,CAAA;AAgFD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAkE/F"}

package/dist/tools/vision/analyze-floorplan-image.js

@@ -1,5 +1,6 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from '../annotations.js';
 /**
  * Input shape for `analyze_floorplan_image`.
  *
@@ -59,7 +60,7 @@ async function resolveImageBlock(image) {
     if (/^https?:\/\//i.test(image)) {
         // SSRF-safe fetch: blocks loopback / private / link-local / metadata IPs,
         // caps size at 20 MB, times out at 10s, validates each redirect hop.
-        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';
@@ -94,6 +95,7 @@ export function registerAnalyzeFloorplanImage(server, _bridge) {
         description: 'Defer to the MCP host (via sampling) to extract walls, rooms, and approximate dimensions from a floor-plan image. Requires host support for sampling.',
         inputSchema: analyzeFloorplanImageInput,
         outputSchema: analyzeFloorplanImageOutput,
+        annotations: READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS,
     }, async ({ image, scaleHint }) => {
         const caps = server.server.getClientCapabilities();
         if (!caps?.sampling) {

package/dist/tools/vision/analyze-room-photo.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 `analyze_room_photo`.
  *

package/dist/tools/vision/analyze-room-photo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-room-photo.d.ts","sourceRoot":"","sources":["../../../src/tools/vision/analyze-room-photo.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,kBAAkB,CAAA;AAEvD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;CAEjC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;CAmBlC,CAAA;AAoED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAoE1F"}
+{"version":3,"file":"analyze-room-photo.d.ts","sourceRoot":"","sources":["../../../src/tools/vision/analyze-room-photo.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,kBAAkB,CAAA;AAGvD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;CAEjC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;CAmBlC,CAAA;AAoED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAqE1F"}

package/dist/tools/vision/analyze-room-photo.js

@@ -1,5 +1,6 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from '../annotations.js';
 /**
  * Input shape for `analyze_room_photo`.
  *
@@ -41,7 +42,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';
@@ -75,6 +76,7 @@ export function registerAnalyzeRoomPhoto(server, _bridge) {
         description: 'Defer to the MCP host (via sampling) to extract approximate dimensions, fixtures, and windows from a single-room photograph. Requires host support for sampling.',
         inputSchema: analyzeRoomPhotoInput,
         outputSchema: analyzeRoomPhotoOutput,
+        annotations: READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS,
     }, async ({ image }) => {
         const caps = server.server.getClientCapabilities();
         if (!caps?.sampling) {

package/dist/tools/vision/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 vision-input tools that defer to the MCP host's sampling
  * capability. No vision model is bundled in this package — if the host does
@@ -7,6 +7,6 @@ import type { SceneOperations } from '../../operations';
  * `sampling_unavailable`.
  */
 export declare function registerVisionTools(server: McpServer, operations: SceneOperations): void;
-export { analyzeFloorplanImageInput, analyzeFloorplanImageOutput, registerAnalyzeFloorplanImage, } from './analyze-floorplan-image';
-export { analyzeRoomPhotoInput, analyzeRoomPhotoOutput, registerAnalyzeRoomPhoto, } from './analyze-room-photo';
+export { analyzeFloorplanImageInput, analyzeFloorplanImageOutput, registerAnalyzeFloorplanImage, } from './analyze-floorplan-image.js';
+export { analyzeRoomPhotoInput, analyzeRoomPhotoOutput, registerAnalyzeRoomPhoto, } from './analyze-room-photo.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/vision/index.js

@@ -1,5 +1,5 @@
-import { registerAnalyzeFloorplanImage } from './analyze-floorplan-image';
-import { registerAnalyzeRoomPhoto } from './analyze-room-photo';
+import { registerAnalyzeFloorplanImage } from './analyze-floorplan-image.js';
+import { registerAnalyzeRoomPhoto } from './analyze-room-photo.js';
 /**
  * Register the vision-input tools that defer to the MCP host's sampling
  * capability. No vision model is bundled in this package — if the host does
@@ -10,5 +10,5 @@ export function registerVisionTools(server, operations) {
     registerAnalyzeFloorplanImage(server, operations);
     registerAnalyzeRoomPhoto(server, operations);
 }
-export { analyzeFloorplanImageInput, analyzeFloorplanImageOutput, registerAnalyzeFloorplanImage, } from './analyze-floorplan-image';
-export { analyzeRoomPhotoInput, analyzeRoomPhotoOutput, registerAnalyzeRoomPhoto, } from './analyze-room-photo';
+export { analyzeFloorplanImageInput, analyzeFloorplanImageOutput, registerAnalyzeFloorplanImage, } from './analyze-floorplan-image.js';
+export { analyzeRoomPhotoInput, analyzeRoomPhotoOutput, registerAnalyzeRoomPhoto, } from './analyze-room-photo.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pascal-app/mcp",
-  "version": "1.0.0-beta.6",
+  "version": "1.0.1",
   "description": "Model Context Protocol server for Pascal 3D editor",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,23 +47,24 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "tsc --build",
+    "build": "tsc --build && bun ../../scripts/fix-node-esm-imports.ts ../core/dist && bun ../../scripts/fix-node-esm-imports.ts dist",
     "dev": "tsgo --build --watch",
     "start": "bun dist/bin/pascal-mcp.js",
     "test": "bun test",
     "smoke": "bun run scripts/smoke.ts",
-    "prepublishOnly": "bun run build && bun test"
+    "smoke:node": "node dist/bin/pascal-mcp.js --help",
+    "prepublishOnly": "bun run build && bun test && bun run smoke:node"
   },
   "peerDependencies": {
-    "@pascal-app/core": "^1.0.0-beta.5"
+    "@pascal-app/core": "^1.0.1"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "@pascal-app/lingo": "^0.2.0",
-    "zod": "^4.3.5"
+    "zod": ">=4.5.4 <4.6"
   },
   "devDependencies": {
-    "@pascal-app/core": "^1.0.0-beta.5",
+    "@pascal-app/core": "^1.0.1",
     "@pascal/typescript-config": "*",
     "@types/node": "^22.19.20",
     "typescript": "6.0.3"