@pascal-app/mcp 1.0.6 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pascal-app/mcp",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "Model Context Protocol server for Pascal 3D editor",
   "mcpName": "app.pascal/editor",
   "type": "module",
@@ -62,21 +62,21 @@
     "prepublishOnly": "bun run build && bun test && bun run smoke:node"
   },
   "peerDependencies": {
-    "@pascal-app/core": "^1.0.6"
+    "@pascal-app/core": "^1.1.0"
   },
   "dependencies": {
-    "@hono/node-server": "^1.19.15",
-    "@modelcontextprotocol/node": "^2.1.1",
-    "@modelcontextprotocol/server": "^2.3.1",
-    "@pascal-app/geometry-script": "^1.0.6",
+    "@hono/node-server": "^2.1.6",
+    "@modelcontextprotocol/node": "^2.1.2",
+    "@modelcontextprotocol/server": "^2.4.0",
+    "@pascal-app/geometry-script": "^1.1.0",
     "@pascal-app/lingo": "^0.5.0",
     "zod": ">=4.6.7 <4.7"
   },
   "devDependencies": {
-    "@modelcontextprotocol/client": "^2.3.1",
-    "@pascal-app/core": "^1.0.6",
+    "@modelcontextprotocol/client": "^2.4.0",
+    "@pascal-app/core": "^1.1.0",
     "@pascal/typescript-config": "*",
-    "@types/node": "^26.6.5",
+    "@types/node": "^26.6.6",
     "typescript": "7.0.2"
   },
   "keywords": [
@@ -94,6 +94,6 @@
     "directory": "packages/mcp"
   },
   "license": "MIT",
-  "homepage": "https://github.com/pascalorg/editor/tree/main/packages/mcp#readme",
+  "homepage": "https://editor.pascal.app/docs/developers/mcp",
   "bugs": "https://github.com/pascalorg/editor/issues"
 }

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

@@ -1,29 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/server';
-import { z } from 'zod';
-import type { SceneOperations } from '../operations/index.js';
-export declare const createUnitInput: {
-    buildingId: z.ZodString;
-    name: z.ZodString;
-    kind: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
-        apartment: "apartment";
-        commercial: "commercial";
-        common: "common";
-        "hotel-room": "hotel-room";
-    }>>>;
-    color: z.ZodOptional<z.ZodString>;
-    memberZoneIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-};
-export declare const createUnitOutput: {
-    project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    unsaved: z.ZodOptional<z.ZodString>;
-    persistence: z.ZodOptional<z.ZodObject<{
-        status: z.ZodEnum<{
-            events_unsupported: "events_unsupported";
-            unbound: "unbound";
-        }>;
-        warning: z.ZodString;
-    }, z.core.$strip>>;
-    unitId: z.ZodString;
-};
-export declare function registerCreateUnit(server: McpServer, bridge: SceneOperations): void;
-//# sourceMappingURL=create-unit.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"create-unit.d.ts","sourceRoot":"","sources":["../../src/tools/create-unit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAG7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAMpD,eAAO,MAAM,eAAe;IAC1B,UAAU;IACV,IAAI;IACJ,IAAI;;;;;;IACJ,KAAK;IACL,aAAa;CACd,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;CAG5B,CAAA;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAuBnF"}

package/dist/tools/create-unit.js

@@ -1,36 +0,0 @@
-import { UnitNode } from '@pascal-app/core/schema';
-import { z } from 'zod';
-import { ADDITIVE_TOOL_ANNOTATIONS } from './annotations.js';
-import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync.js';
-import { NodeIdSchema } from './schemas.js';
-import { validateUnitMembers } from './unit-members.js';
-export const createUnitInput = {
-    buildingId: NodeIdSchema,
-    name: z.string(),
-    kind: UnitNode.shape.kind.optional(),
-    color: z.string().optional(),
-    memberZoneIds: z.array(NodeIdSchema).optional(),
-};
-export const createUnitOutput = {
-    unitId: z.string(),
-    ...liveSyncOutput,
-};
-export function registerCreateUnit(server, bridge) {
-    server.registerTool('create_unit', {
-        title: 'Create unit',
-        description: 'Create a named unit in a building, optionally referencing zones across its levels.',
-        inputSchema: z.object(createUnitInput),
-        outputSchema: z.object(createUnitOutput),
-        annotations: ADDITIVE_TOOL_ANNOTATIONS,
-    }, async ({ buildingId, name, kind, color, memberZoneIds }) => {
-        const members = validateUnitMembers(bridge, buildingId, memberZoneIds ?? []);
-        const unit = UnitNode.parse({ name, kind, color, members });
-        const id = bridge.createNode(unit, buildingId);
-        const persistence = await publishLiveSceneSnapshot(bridge, 'create_unit');
-        const payload = { unitId: id, ...persistencePayload(persistence) };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(payload) }],
-            structuredContent: payload,
-        };
-    });
-}

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

@@ -1,38 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/server';
-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";
-            commercial: "commercial";
-            common: "common";
-            "hotel-room": "hotel-room";
-        }>>;
-        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

@@ -1 +0,0 @@
-{"version":3,"file":"list-units.d.ts","sourceRoot":"","sources":["../../src/tools/list-units.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAG7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAKpD,eAAO,MAAM,cAAc;IACzB,UAAU;CACX,CAAA;AAED,eAAO,MAAM,eAAe;IAC1B,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBN,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgClF"}

package/dist/tools/list-units.js

@@ -1,61 +0,0 @@
-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: z.object(listUnitsInput),
-        outputSchema: z.object(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/set-unit-members.d.ts

@@ -1,22 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/server';
-import { z } from 'zod';
-import type { SceneOperations } from '../operations/index.js';
-export declare const setUnitMembersInput: {
-    unitId: z.ZodString;
-    memberZoneIds: z.ZodArray<z.ZodString>;
-};
-export declare const setUnitMembersOutput: {
-    project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    unsaved: z.ZodOptional<z.ZodString>;
-    persistence: z.ZodOptional<z.ZodObject<{
-        status: z.ZodEnum<{
-            events_unsupported: "events_unsupported";
-            unbound: "unbound";
-        }>;
-        warning: z.ZodString;
-    }, z.core.$strip>>;
-    unitId: z.ZodString;
-    memberCount: z.ZodNumber;
-};
-export declare function registerSetUnitMembers(server: McpServer, bridge: SceneOperations): void;
-//# sourceMappingURL=set-unit-members.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"set-unit-members.d.ts","sourceRoot":"","sources":["../../src/tools/set-unit-members.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAOpD,eAAO,MAAM,mBAAmB;IAC9B,MAAM;IACN,aAAa;CACd,CAAA;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAIhC,CAAA;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmCvF"}

package/dist/tools/set-unit-members.js

@@ -1,43 +0,0 @@
-import { z } from 'zod';
-import { DESTRUCTIVE_TOOL_ANNOTATIONS } from './annotations.js';
-import { ProtocolErrorCode, throwMcpError } from './errors.js';
-import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync.js';
-import { NodeIdSchema } from './schemas.js';
-import { validateUnitMembers } from './unit-members.js';
-export const setUnitMembersInput = {
-    unitId: NodeIdSchema,
-    memberZoneIds: z.array(NodeIdSchema),
-};
-export const setUnitMembersOutput = {
-    unitId: z.string(),
-    memberCount: z.number(),
-    ...liveSyncOutput,
-};
-export function registerSetUnitMembers(server, bridge) {
-    server.registerTool('set_unit_members', {
-        title: 'Set unit members',
-        description: 'Replace the zones referenced by a unit. Every zone must belong to a level in the same building.',
-        inputSchema: z.object(setUnitMembersInput),
-        outputSchema: z.object(setUnitMembersOutput),
-        annotations: { ...DESTRUCTIVE_TOOL_ANNOTATIONS, idempotentHint: true },
-    }, async ({ unitId, memberZoneIds }) => {
-        const unit = bridge.getNode(unitId);
-        if (!unit) {
-            throwMcpError(ProtocolErrorCode.InvalidParams, `Unit not found: ${unitId}`);
-        }
-        if (unit.type !== 'unit') {
-            throwMcpError(ProtocolErrorCode.InvalidParams, `Node ${unitId} is a ${unit.type}, expected unit`);
-        }
-        if (!unit.parentId) {
-            throwMcpError(ProtocolErrorCode.InvalidParams, `Unit ${unitId} must belong to a building`);
-        }
-        const members = validateUnitMembers(bridge, unit.parentId, memberZoneIds);
-        bridge.updateNode(unit.id, { members });
-        const persistence = await publishLiveSceneSnapshot(bridge, 'set_unit_members');
-        const payload = { unitId, memberCount: members.length, ...persistencePayload(persistence) };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(payload) }],
-            structuredContent: payload,
-        };
-    });
-}

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

@@ -1,4 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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,CAgClB"}

package/dist/tools/unit-members.js

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