@pascal-app/mcp 1.0.0-beta.4 → 1.0.0-beta.5

package/README.md

@@ -3,47 +3,68 @@
 Model Context Protocol server for the Pascal 3D editor. Drives the
 `@pascal-app/core` scene graph from any MCP-compatible AI host.
 
-The server runs headlessly in Bun with no browser, WebGPU, React, or external
-database service. It exposes the same scene mutations used by the editor UI
-(create walls, place items, cut openings, undo, etc.) as MCP tools, resources,
-and prompts.
+For the hosted Pascal MCP endpoint and copy-ready setup for Claude Code, Codex,
+Cursor, and OpenClaw, read [Connect an AI agent](https://editor.pascal.app/docs/developers/mcp).
+The hosted endpoint edits projects in a Pascal account; this package is the
+open-source, local server for custom hosts and local scene storage.
 
-## Install
+The server runs headlessly in Node.js 22.13 or newer or Bun, with no browser,
+WebGPU, React, or external database service. It exposes the same scene mutations used
+by the editor UI (create walls, place items, cut openings, undo, etc.) as MCP tools,
+resources, and prompts.
+
+## Recommended local setup
+
+For a local editor and MCP that share projects automatically, install the Pascal CLI:
+
+```bash
+npx @pascal-app/cli editor
+pascal mcp setup codex
+```
+
+`pascal editor` starts the editor and an authenticated MCP service together.
+`pascal mcp connect` is a stable stdio connector that discovers the dynamic loopback
+port, so MCP client configuration contains neither a changing port nor a secret.
+
+Use this package directly when embedding the MCP server, supplying a custom store, or
+running MCP without the Pascal editor.
+
+## Install the package directly
 
 ```bash
 bun add @pascal-app/mcp
 ```
 
-`@pascal-app/core` is a peer dependency; Bun workspaces resolve it automatically.
-The MCP CLI is intended to run with Bun. When the storage package is consumed by
-the Next.js editor server, it opens the same local database through Node's
-built-in SQLite driver.
+`@pascal-app/core` is a peer dependency. The local store uses Bun SQLite under Bun and
+Node's built-in SQLite driver under Node.js.
 
 ## Quick start
 
 Launch the server over stdio in one line:
 
 ```bash
-bunx pascal-mcp
+bunx @pascal-app/mcp
+# or
+npm exec --package=@pascal-app/mcp -- pascal-mcp
 ```
 
 Load an initial scene from disk:
 
 ```bash
-pascal-mcp --stdio --scene ./my-scene.json
+bunx @pascal-app/mcp --stdio --scene ./my-scene.json
 ```
 
 Expose it over loopback HTTP:
 
 ```bash
-pascal-mcp --http --port 8787
+bunx @pascal-app/mcp --http --port 8787
 ```
 
 Binding a non-loopback host requires a bearer token:
 
 ```bash
 PASCAL_MCP_HTTP_TOKEN="$(openssl rand -hex 32)" \
-  pascal-mcp --http --host 0.0.0.0 --port 8787 --cors-origin https://editor.example
+  bunx @pascal-app/mcp --http --host 0.0.0.0 --port 8787 --cors-origin https://editor.example
 ```
 
 ## Local scene storage
@@ -89,7 +110,10 @@ another MCP process saved a newer version first, the MCP tool returns
 `live_sync_version_conflict`; reload the scene with `load_scene` before
 continuing.
 
-## Claude Desktop config
+## Managed CLI client configuration
+
+The recommended JSON configuration for Claude Desktop, Cursor, and compatible clients
+is:
 
 Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
 (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
@@ -98,25 +122,19 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
 {
   "mcpServers": {
     "pascal": {
-      "command": "bunx",
-      "args": ["pascal-mcp"],
-      "env": {
-        "PASCAL_DATA_DIR": "/Users/you/.pascal/data"
-      }
+      "command": "pascal",
+      "args": ["mcp", "connect"]
     }
   }
 }
 ```
 
-If `bunx` is not on your PATH, point `command` at the absolute path to `bun`
-and pass the built `dist/bin/pascal-mcp.js` file as the first arg.
-
-## Claude Code config
+### Claude Code
 
 Via the CLI:
 
 ```bash
-claude mcp add pascal bunx pascal-mcp
+pascal mcp setup claude
 ```
 
 Or add to `.mcp.json` at the repo root:
@@ -125,24 +143,21 @@ Or add to `.mcp.json` at the repo root:
 {
   "mcpServers": {
     "pascal": {
-      "command": "bunx",
-      "args": ["pascal-mcp"],
-      "env": {
-        "PASCAL_DATA_DIR": "/Users/you/.pascal/data"
-      }
+      "command": "pascal",
+      "args": ["mcp", "connect"]
     }
   }
 }
 ```
 
-For local workspace testing before publish, build first and point Claude Code at
-the built binary:
+For package-development testing without the managed CLI, build first and point Claude
+Code at the built binary:
 
 ```json
 {
   "mcpServers": {
     "pascal": {
-      "command": "bun",
+      "command": "node",
       "args": ["/absolute/path/to/editor/packages/mcp/dist/bin/pascal-mcp.js"],
       "env": {
         "PASCAL_DATA_DIR": "/Users/you/.pascal/data"
@@ -152,12 +167,12 @@ the built binary:
 }
 ```
 
-## Codex CLI config
+### Codex CLI
 
 Via the CLI:
 
 ```bash
-codex mcp add pascal --env PASCAL_DATA_DIR="$HOME/.pascal/data" -- bunx pascal-mcp
+pascal mcp setup codex
 ```
 
 For local workspace testing before publish:
@@ -166,21 +181,21 @@ For local workspace testing before publish:
 bun run --cwd packages/mcp build
 codex mcp add pascal-dev \
   --env PASCAL_DATA_DIR="$HOME/.pascal/data" \
-  -- bun "$PWD/packages/mcp/dist/bin/pascal-mcp.js"
+  -- node "$PWD/packages/mcp/dist/bin/pascal-mcp.js"
 ```
 
 This writes an entry like this to `~/.codex/config.toml`:
 
 ```toml
 [mcp_servers.pascal-dev]
-command = "bun"
+command = "node"
 args = ["/absolute/path/to/editor/packages/mcp/dist/bin/pascal-mcp.js"]
 
 [mcp_servers.pascal-dev.env]
 PASCAL_DATA_DIR = "/Users/you/.pascal/data"
 ```
 
-## Cursor config
+### Cursor config
 
 In Cursor settings (`settings.json`):
 
@@ -188,11 +203,8 @@ In Cursor settings (`settings.json`):
 {
   "mcp.servers": {
     "pascal": {
-      "command": "bunx",
-      "args": ["pascal-mcp"],
-      "env": {
-        "PASCAL_DATA_DIR": "/Users/you/.pascal/data"
-      }
+      "command": "pascal",
+      "args": ["mcp", "connect"]
     }
   }
 }
@@ -200,7 +212,7 @@ In Cursor settings (`settings.json`):
 
 ## Programmatic use
 
-Embed the server in your own Bun process using the in-memory transport. The
+Embed the server in your own Node.js or Bun process using the in-memory transport. The
 example below runs a full client/server pair inside a single script — useful
 for agent frameworks and tests.
 
@@ -272,7 +284,7 @@ external-coordinate gotcha — lives in
 [`examples/coordinate-conventions-demo.md`](./examples/coordinate-conventions-demo.md)
 and [`examples/coordinate-conventions-demo.json`](./examples/coordinate-conventions-demo.json).
 Load the JSON with
-`pascal-mcp --stdio --scene examples/coordinate-conventions-demo.json`.
+`bunx @pascal-app/mcp --stdio --scene examples/coordinate-conventions-demo.json`.
 
 **Example — a 6 × 4 m slab rotated 30° about its first corner** (coordinates
 rounded to 3 dp; sides ≈ 6 m / 4 m; not axis-aligned, so the mapping is

package/dist/bin/pascal-mcp.d.ts

@@ -1,3 +1,3 @@
-#!/usr/bin/env bun
+#!/usr/bin/env node
 import '../bridge/node-shims';
 //# sourceMappingURL=pascal-mcp.d.ts.map

package/dist/bin/pascal-mcp.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun
+#!/usr/bin/env node
 // Load shims FIRST so any subsequent core import sees the RAF polyfill.
 import '../bridge/node-shims';
 import { readFileSync } from 'node:fs';
@@ -47,25 +47,32 @@ async function main() {
         console.log(version);
         process.exit(0);
     }
-    const bridge = new SceneBridge();
-    if (values.scene) {
-        const raw = readFileSync(values.scene, 'utf8');
-        bridge.loadJSON(raw);
-    }
-    else {
-        bridge.loadDefault();
-    }
     const store = await createSceneStore();
-    const server = createPascalMcpServer({ bridge, store });
+    const createServer = () => {
+        const bridge = new SceneBridge();
+        if (values.scene)
+            bridge.loadJSON(readFileSync(values.scene, 'utf8'));
+        else
+            bridge.loadDefault();
+        return createPascalMcpServer({ bridge, store });
+    };
     if (values.http) {
         const portNum = Number.parseInt(values.port ?? '3917', 10);
         if (!Number.isFinite(portNum) || portNum < 0 || portNum > 65_535) {
             throw new Error(`invalid --port value: ${values.port}`);
         }
-        const handle = await connectHttp(server, portNum, {
+        const handle = await connectHttp(createServer, portNum, {
             host: values.host,
             authToken: values['auth-token'],
             allowedOrigins: values['cors-origin'],
+            ...(process.env.PASCAL_INSTANCE_ID
+                ? {
+                    health: {
+                        version: process.env.PASCAL_RUNTIME_VERSION ?? version,
+                        instanceId: process.env.PASCAL_INSTANCE_ID,
+                    },
+                }
+                : {}),
         });
         console.error(`[pascal-mcp] HTTP server listening on ${handle.host}:${handle.port}`);
         const shutdown = async () => {
@@ -81,7 +88,7 @@ async function main() {
     }
     else {
         // --stdio is the default when no transport flag is passed.
-        await connectStdio(server);
+        await connectStdio(createServer());
         console.error('[pascal-mcp] stdio server running');
     }
 }

package/dist/bridge/scene-bridge.d.ts

@@ -2,6 +2,7 @@ import './node-shims';
 import type { SceneGraph } from '@pascal-app/core/clone-scene-graph';
 import type { AnyNode } from '@pascal-app/core/schema';
 import { type AnyNodeId, type AnyNodeType } from '@pascal-app/core/schema';
+import useScene from '@pascal-app/core/store';
 import type { SceneMeta } from '../storage/types';
 export type ValidationError = {
     nodeId: string;
@@ -29,6 +30,8 @@ export type DeletePatch = {
 };
 export type Patch = CreatePatch | UpdatePatch | DeletePatch;
 export type ActiveSceneMeta = Pick<SceneMeta, 'id' | 'name' | 'projectId' | 'ownerId' | 'thumbnailUrl' | 'version'>;
+/** The `extra` bag `setScene` accepts — collections, materials, plugin state. */
+type SetSceneExtra = Parameters<ReturnType<typeof useScene.getState>['setScene']>[2];
 /**
  * Headless bridge to the `@pascal-app/core` Zustand store.
  *
@@ -48,8 +51,8 @@ export declare class SceneBridge {
     /** Load initial state; if empty, creates default Site → Building → Level. */
     loadDefault(): void;
     /** Replace entire scene (undoable via Zundo). */
-    setScene(nodes: Record<AnyNodeId, AnyNode>, rootNodeIds: AnyNodeId[]): void;
-    /** Full snapshot for export, including collections. */
+    setScene(nodes: Record<AnyNodeId, AnyNode>, rootNodeIds: AnyNodeId[], extra?: SetSceneExtra): void;
+    /** Full snapshot for export, including collections and the material palette. */
     exportJSON(): SceneGraph & {
         collections: Record<string, unknown>;
     };
@@ -155,4 +158,5 @@ export declare class SceneBridge {
      */
     private _collectDescendants;
 }
+export {};
 //# sourceMappingURL=scene-bridge.d.ts.map

package/dist/bridge/scene-bridge.d.ts.map

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

package/dist/bridge/scene-bridge.js

@@ -37,10 +37,10 @@ export class SceneBridge {
         useScene.getState().loadScene();
     }
     /** Replace entire scene (undoable via Zundo). */
-    setScene(nodes, rootNodeIds) {
-        useScene.getState().setScene(nodes, rootNodeIds);
+    setScene(nodes, rootNodeIds, extra) {
+        useScene.getState().setScene(nodes, rootNodeIds, extra);
     }
-    /** Full snapshot for export, including collections. */
+    /** Full snapshot for export, including collections and the material palette. */
     exportJSON() {
         const state = useScene.getState();
         // Deep-clone so callers can't mutate store state directly.
@@ -48,6 +48,7 @@ export class SceneBridge {
             nodes: state.nodes,
             rootNodeIds: state.rootNodeIds,
             collections: state.collections ?? {},
+            materials: state.materials ?? {},
             ...(state.hasExplicitPluginInstallState || state.installedPlugins.length > 0
                 ? { installedPlugins: state.installedPlugins }
                 : {}),
@@ -90,10 +91,23 @@ export class SceneBridge {
                 throw new Error(`invalid scene: forbidden key "${key}" in nodes`);
             }
         }
-        this.setScene(nodes, rootNodeIds);
-        if (Array.isArray(obj.installedPlugins)) {
-            useScene.getState().setInstalledPlugins(obj.installedPlugins.filter((id) => typeof id === 'string'), { explicit: true });
-        }
+        const record = (value) => value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+        const collections = record(obj.collections);
+        const materials = record(obj.materials);
+        const installedPlugins = Array.isArray(obj.installedPlugins)
+            ? obj.installedPlugins.filter((id) => typeof id === 'string')
+            : undefined;
+        // One `setScene` call rather than a follow-up `setInstalledPlugins`:
+        // `setScene` overwrites `collections` and `materials` with `{}` whenever
+        // they aren't in the `extra` bag, so anything applied afterwards is lost.
+        // It also marks every node dirty at the end, and `markDirty` skips nodes
+        // whose plugin isn't installed — so plugin state has to be in place by
+        // then or plugin-owned nodes never get validated.
+        this.setScene(nodes, rootNodeIds, {
+            ...(collections && { collections }),
+            ...(materials && { materials }),
+            ...(installedPlugins && { installedPlugins, hasExplicitPluginInstallState: true }),
+        });
     }
     /** Read a single node, or `null` if not present. */
     getNode(id) {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { SceneBridge } from './bridge/scene-bridge';
 export { createSceneOperations, type SceneOperations } from './operations';
 export { type CreatePascalMcpServerOptions, createPascalMcpServer } from './server';
-export declare const version = "0.1.0";
+export { version } from './version';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,KAAK,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAEnF,eAAO,MAAM,OAAO,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,KAAK,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -1,4 +1,4 @@
 export { SceneBridge } from './bridge/scene-bridge';
 export { createSceneOperations } from './operations';
 export { createPascalMcpServer } from './server';
-export const version = '0.1.0';
+export { version } from './version';

package/dist/operations/scene-operations.js

@@ -56,6 +56,7 @@ class SceneOperationsFacade {
             nodes: exported.nodes,
             rootNodeIds: exported.rootNodeIds,
             collections: exported.collections,
+            materials: exported.materials,
             installedPlugins: exported.installedPlugins,
         };
     }

package/dist/prompts/from-brief.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"from-brief.d.ts","sourceRoot":"","sources":["../../src/prompts/from-brief.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAmBpD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC,GAAG,MAAM,CAWT;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAwBnF"}
+{"version":3,"file":"from-brief.d.ts","sourceRoot":"","sources":["../../src/prompts/from-brief.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAoBpD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC,GAAG,MAAM,CAeT;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAwBnF"}

package/dist/prompts/from-brief.js

@@ -3,8 +3,9 @@ import { SCENE_DESIGN_GUIDANCE } from './scene-guidance';
 const PREAMBLE = [
     'You are a Pascal 3D scene designer.',
     'You have access to semantic scene tools and the lower-level `apply_patch` tool. Prefer semantic construction/room/opening/furnishing tools for architectural work, and use `apply_patch` for bulk graph edits that need exact control.',
-    'If the user asks for a new project, call `create_project` before building. Use `create_house_from_brief` for a fast starter, then refine with semantic tools. Semantic tools update the browser-visible draft; call `save_scene` with `saveMode: "checkpoint"` only for meaningful milestones, then call `verify_scene` and `get_project_status`, and return the final `editorUrl`.',
+    'Bind an active scene before mutating anything. Call `create_project` for a new project, `list_scenes` then `load_scene` for an existing one, or `create_house_from_brief` to create and load a starter in one step. Without a bound scene, mutations apply in memory only — they are not persisted and never appear in the browser.',
     'Build incrementally with visible progress. Starting from an empty scene, first create/load a Site and Building, then create occupied Levels and `create_story_shell` once per story before detailed rooms, openings, furniture, a dedicated roof level via `create_roof`, and landscaping.',
+    'Semantic tools update the browser-visible draft. Call `save_scene` with `saveMode: "checkpoint"` only for meaningful milestones, then call `verify_scene` and `get_project_status`, and return the final `editorUrl`.',
     'Respect these invariants:',
     '  - Levels live under a Building.',
     '  - Walls, fences, zones, slabs, ceilings, roofs, stairs live under a Level.',
@@ -23,13 +24,13 @@ export function buildFromBriefPrompt(args) {
     if (args.constraints && args.constraints.trim().length > 0) {
         parts.push('', '## Constraints', args.constraints.trim());
     }
-    parts.push('', '## Task', 'Produce tool calls that realise the brief within the stated constraints. For a new project, call create_project first. Use create_house_from_brief for a fast starter or prefer create_story_shell/create_room/add_door/add_window/create_stair_between_levels/create_roof/furnish_room for architectural layout, use apply_patch for exact bulk graph work, call save_scene with saveMode: "checkpoint" only when the design reaches a meaningful milestone, then call validate_scene, verify_scene, and get_project_status.');
+    parts.push('', '## Task', 'Produce tool calls that realise the brief within the stated constraints.', '1. Bind a scene — `create_project` (new), `list_scenes` then `load_scene` (existing), or `create_house_from_brief` (starter template).', '2. Build the design — `create_story_shell` for exterior shells, `create_room`/`add_door`/`add_window`/`create_stair_between_levels`/`furnish_room` for interior layout, `create_roof` for roofing, `apply_patch` for exact bulk graph work.', '3. Finish — call `validate_scene`, `verify_scene`, and `get_project_status`, then return the `editorUrl`.', 'Call `save_scene` with `saveMode: "checkpoint"` only when the design reaches a meaningful milestone.');
     return parts.join('\n');
 }
 export function registerFromBrief(server, _bridge) {
     server.registerPrompt('from_brief', {
         title: 'Generate a Pascal scene from a brief',
-        description: 'Produces a plan of apply_patch calls to create a scene from a natural-language brief.',
+        description: 'Generate a Pascal 3D scene from a natural-language brief. Binds an active scene, then produces semantic tool calls to realise the design.',
         argsSchema: {
             brief: z.string(),
             constraints: z.string().optional(),

package/dist/resources/agent-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-guide.d.ts","sourceRoot":"","sources":["../../src/resources/agent-guide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,eAAO,MAAM,WAAW,QAwDZ,CAAA;AAEZ,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAuCpF"}
+{"version":3,"file":"agent-guide.d.ts","sourceRoot":"","sources":["../../src/resources/agent-guide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,eAAO,MAAM,WAAW,QA0DZ,CAAA;AAEZ,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAuCpF"}

package/dist/resources/agent-guide.js

@@ -32,6 +32,8 @@ export const AGENT_GUIDE = [
     '- Prefer semantic tools over raw graph patches.',
     '- Do not hand-write node graphs unless no semantic tool exists.',
     '- For rooms, use `create_room` -> `add_door` -> `add_window` -> `furnish_room`.',
+    '- `furnish_room` skips or nudges poses that block door clear zones or overlap other items; `verify_scene` and `check_collisions` report remaining issues.',
+    '- Between adjacent rooms, prefer one shared wall (or only cut openings that line up). Leave ~0.65 m clear on both sides of each door; do not stack furniture footprints.',
     '- For complete homes, create exterior shell, interior rooms, openings, roof, furniture, then landscaping.',
     '- For doors/windows, use `t` or `position` from 0 to 1 along the wall unless a tool explicitly says otherwise.',
     '- X/Z are floor-plan axes and Y is vertical; dimensions are meters.',

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAG1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAIjD,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,mFAAmF;IACnF,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,4BAA4B,GAAG,SAAS,CAYnF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAG1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAKjD,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,mFAAmF;IACnF,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,4BAA4B,GAAG,SAAS,CAYnF"}

package/dist/server.js

@@ -4,10 +4,11 @@ import { registerPrompts } from './prompts';
 import { registerResources } from './resources';
 import { registerTools } from './tools';
 import { registerVisionTools } from './tools/vision';
+import { version } from './version';
 export function createPascalMcpServer(opts) {
     const server = new McpServer({
-        name: opts.name ?? 'pascal-mcp',
-        version: opts.version ?? '0.1.0',
+        name: opts.name ?? 'pascal-mcp-server',
+        version: opts.version ?? version,
     });
     const operations = opts.operations ?? createSceneOperations({ bridge: opts.bridge, store: opts.store });
     registerTools(server, operations);

package/dist/storage/sqlite-scene-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-scene-store.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite-scene-store.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAE1B,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAGf,KAAK,cAAc,EACpB,MAAM,SAAS,CAAA;AAOhB,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAwCD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAmBvF;AAiKD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAS;IAEpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAwC;IAC5E,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,SAAS,CAAuC;gBAE5C,IAAI,GAAE,uBAA4B;IAMxC,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBjE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAS3D,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IAyHhD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAUhD,IAAI,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAiCvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAenE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC;IAsCtF,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IA6BpE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmB/F,KAAK,IAAI,IAAI;YAMC,QAAQ;IAiBtB,OAAO,CAAC,OAAO;YAgDD,oBAAoB;IAiBlC,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,gBAAgB;CAOzB"}
+{"version":3,"file":"sqlite-scene-store.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite-scene-store.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAE1B,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAGf,KAAK,cAAc,EACpB,MAAM,SAAS,CAAA;AAOhB,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAgDD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAmBvF;AAkKD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAS;IAEpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAwC;IAC5E,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,SAAS,CAAuC;gBAE5C,IAAI,GAAE,uBAA4B;IAMxC,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBjE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAS3D,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IAyHhD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAUhD,IAAI,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAiCvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAenE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC;IAsCtF,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IA6BpE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmB/F,KAAK,IAAI,IAAI;YAMC,QAAQ;IAiBtB,OAAO,CAAC,OAAO;YAgDD,oBAAoB;IAiBlC,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/storage/sqlite-scene-store.js

@@ -10,10 +10,18 @@ const DEFAULT_MAX_SCENE_BYTES = 10 * 1024 * 1024;
 const DEFAULT_LIST_LIMIT = 100;
 const MAX_NAME_LENGTH = 200;
 const MIN_NAME_LENGTH = 1;
+// `z.object()` strips keys it doesn't name, so every field that must survive a
+// save→load round trip has to be listed here. Values stay `unknown` rather than
+// being validated against `SceneMaterial`/`Collection`: nothing validates on the
+// way in, and `parseGraph` throws, so a strict shape here would let one odd
+// stored value make a saved scene permanently unloadable. Validation belongs on
+// the write path, where the caller can still react to it.
 const GraphSchema = z.object({
     nodes: z.record(z.string(), z.unknown()),
     rootNodeIds: z.array(z.string()),
     collections: z.record(z.string(), z.unknown()).optional(),
+    materials: z.record(z.string(), z.unknown()).optional(),
+    installedPlugins: z.array(z.string()).optional(),
 });
 /**
  * Resolves Pascal's local SQLite database path.
@@ -81,7 +89,8 @@ function rowToMeta(row) {
     };
 }
 function editorUrlForScene(id) {
-    return `/editor/${id}`;
+    const origin = process.env.PASCAL_EDITOR_ORIGIN?.replace(/\/$/, '');
+    return origin ? `${origin}/scene/${encodeURIComponent(id)}` : `/editor/${id}`;
 }
 function hashGraphJson(graphJson) {
     return createHash('sha256').update(graphJson).digest('hex');

package/dist/templates/garden-house.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"garden-house.d.ts","sourceRoot":"","sources":["../../src/templates/garden-house.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AA+QpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;;;;CAKX,CAAA"}
+{"version":3,"file":"garden-house.d.ts","sourceRoot":"","sources":["../../src/templates/garden-house.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAkRpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;;;;CAKX,CAAA"}

package/dist/templates/garden-house.js

@@ -12,10 +12,13 @@
  *   - 2 windows on the south wall, 1 window on each of east and west
  *   - 1 indoor "living" zone, 1 outdoor "garden" zone
  *   - 3 fence segments bounding the north/east/west of the garden
+ *
+ * Coordinate system: `[x, z]` on the XZ plane, with `x` running east/west
+ * and `z` running north/south (positive z points south).
  */
 const HOUSE_W = 6; // half-width of the house (12 m total)
 const HOUSE_D = 4; // half-depth of the house (8 m total)
-const GARDEN_DEPTH = 6; // depth of the back-garden zone along +z direction
+const GARDEN_DEPTH = 6; // depth of the back-garden zone along -z (north)
 const WALL_THICKNESS = 0.15;
 const WALL_HEIGHT = 2.7;
 function wall(id, start, end, children = []) {

package/dist/tools/check-collisions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-collisions.d.ts","sourceRoot":"","sources":["../../src/tools/check-collisions.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;AAGpD,eAAO,MAAM,oBAAoB;;CAEhC,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;CAQjC,CAAA;AAqBD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAsCxF"}
+{"version":3,"file":"check-collisions.d.ts","sourceRoot":"","sources":["../../src/tools/check-collisions.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,oBAAoB;;CAEhC,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;CAQjC,CAAA;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA4CxF"}

package/dist/tools/check-collisions.js

@@ -1,5 +1,5 @@
-import { getScaledDimensions } from '@pascal-app/core/schema';
 import { z } from 'zod';
+import { findItemItemCollisions } from './layout-clearance';
 import { NodeIdSchema } from './schemas';
 export const checkCollisionsInput = {
     levelId: NodeIdSchema.optional(),
@@ -11,47 +11,35 @@ export const checkCollisionsOutput = {
         kind: z.string(),
     })),
 };
-function itemAabb(item) {
-    const [x, , z] = item.position;
-    const [w, , d] = getScaledDimensions(item);
-    const halfW = w / 2;
-    const halfD = d / 2;
-    return {
-        minX: x - halfW,
-        maxX: x + halfW,
-        minZ: z - halfD,
-        maxZ: z + halfD,
-    };
-}
-function aabbOverlap(a, b) {
-    return a.minX < b.maxX && a.maxX > b.minX && a.minZ < b.maxZ && a.maxZ > b.minZ;
-}
 export function registerCheckCollisions(server, bridge) {
     server.registerTool('check_collisions', {
         title: 'Check collisions',
-        description: 'Detect overlapping item footprints via an axis-aligned 2D bounding-box test. Optionally scoped to a single level.',
+        description: 'Detect overlapping item footprints via a rotation-aware plan AABB test. Optionally scoped to a single level (items parented to that level).',
         inputSchema: checkCollisionsInput,
         outputSchema: checkCollisionsOutput,
     }, async ({ levelId }) => {
-        const filter = { type: 'item' };
-        if (levelId)
-            filter.levelId = levelId;
-        const items = bridge.findNodes(filter);
-        const boxes = items.map((i) => ({ item: i, aabb: itemAabb(i) }));
-        const collisions = [];
-        for (let i = 0; i < boxes.length; i++) {
-            for (let j = i + 1; j < boxes.length; j++) {
-                const a = boxes[i];
-                const b = boxes[j];
-                if (aabbOverlap(a.aabb, b.aabb)) {
-                    collisions.push({
-                        aId: a.item.id,
-                        bId: b.item.id,
-                        kind: 'item-aabb',
-                    });
-                }
-            }
+        const nodes = Object.values(bridge.getNodes());
+        let scoped = nodes;
+        if (levelId) {
+            const levelItems = new Set(bridge
+                .findNodes({ type: 'item', levelId: levelId })
+                .map((n) => n.id));
+            scoped = nodes.filter((n) => n.type !== 'item' || levelItems.has(n.id));
         }
+        // gap: 0 keeps this tool's contract — it reports *actual* overlap.
+        // findItemItemCollisions defaults to DEFAULT_ITEM_GAP (8cm), which is the
+        // breathing room furnish_room wants when placing new items; applied here
+        // it would report items merely standing close together as colliding.
+        const found = findItemItemCollisions({
+            nodes: scoped,
+            levelId: levelId,
+            gap: 0,
+        });
+        const collisions = found.map((c) => ({
+            aId: c.aId,
+            bId: c.bId,
+            kind: c.kind,
+        }));
         const payload = { collisions };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],