@pascal-app/mcp 1.0.3 → 1.0.5

package/dist/bin/pascal-mcp.js

@@ -6,7 +6,8 @@ import { parseArgs } from 'node:util';
 import { SceneBridge } from '../bridge/scene-bridge.js';
 import { version } from '../index.js';
 import { createPascalMcpServer } from '../server.js';
-import { createSceneStore } from '../storage/index.js';
+import { createSceneStore, resolveDefaultDatabasePath } from '../storage/index.js';
+import { localGeometryScripts } from '../tools/local-geometry-scripts.js';
 import { connectHttp } from '../transports/http.js';
 import { connectStdio } from '../transports/stdio.js';
 const HELP = `pascal-mcp — MCP server for the Pascal editor
@@ -54,7 +55,12 @@ async function main() {
             bridge.loadJSON(readFileSync(values.scene, 'utf8'));
         else
             bridge.loadDefault();
-        return createPascalMcpServer({ bridge, store });
+        bridge.clearHistory();
+        return createPascalMcpServer({
+            bridge,
+            store,
+            geometryScripts: localGeometryScripts(resolveDefaultDatabasePath()),
+        });
     };
     if (values.http) {
         const portNum = Number.parseInt(values.port ?? '3917', 10);
@@ -88,7 +94,7 @@ async function main() {
     }
     else {
         // --stdio is the default when no transport flag is passed.
-        await connectStdio(createServer());
+        connectStdio(createServer);
         console.error('[pascal-mcp] stdio server running');
     }
 }

package/dist/bridge/agent-session.d.ts

@@ -0,0 +1,18 @@
+import { type SessionKeep, type SessionRecord } from '@pascal-app/core/agent-operations';
+/**
+ * Where a host keeps what the agent's session should remember: the moments it named and what it
+ * made. Never scene data. A host with sessions that outlive the process keeps it beside them.
+ */
+export type AgentSession = {
+    read(): SessionRecord;
+    keep(keep: SessionKeep): void;
+};
+/** The standalone server's: in memory, for as long as the bridge holds a scene. */
+export declare class InMemoryAgentSession implements AgentSession {
+    #private;
+    read(): SessionRecord;
+    keep(keep: SessionKeep): void;
+    /** Binding another scene starts another session. */
+    replace(record?: SessionRecord): void;
+}
+//# sourceMappingURL=agent-session.d.ts.map

package/dist/bridge/agent-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../src/bridge/agent-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,mCAAmC,CAAA;AAE1C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,IAAI,aAAa,CAAA;IACrB,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;CAC9B,CAAA;AAED,mFAAmF;AACnF,qBAAa,oBAAqB,YAAW,YAAY;;IAGvD,IAAI,IAAI,aAAa,CAEpB;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAE5B;IAED,oDAAoD;IACpD,OAAO,CAAC,MAAM,GAAE,aAA6B,GAAG,IAAI,CAEnD;CACF"}

package/dist/bridge/agent-session.js

@@ -0,0 +1,15 @@
+import { EMPTY_SESSION, keepInSession, } from '@pascal-app/core/agent-operations';
+/** The standalone server's: in memory, for as long as the bridge holds a scene. */
+export class InMemoryAgentSession {
+    #record = EMPTY_SESSION;
+    read() {
+        return this.#record;
+    }
+    keep(keep) {
+        this.#record = keepInSession(this.#record, keep);
+    }
+    /** Binding another scene starts another session. */
+    replace(record = EMPTY_SESSION) {
+        this.#record = record;
+    }
+}

package/dist/bridge/index.d.ts

@@ -1,3 +1,3 @@
-export type { ActiveSceneMeta, CreatePatch, DeletePatch, Patch, UpdatePatch, ValidationError, ValidationResult, } from './scene-bridge.js';
+export type { ActiveSceneMeta, CreatePatch, DeletePatch, MaterialUpsertPatch, Patch, UpdatePatch, ValidationError, ValidationResult, } from './scene-bridge.js';
 export { SceneBridge } from './scene-bridge.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,KAAK,EACL,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,KAAK,EACL,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}

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

@@ -1,9 +1,11 @@
 import './node-shims.js';
+import { type NodeDeletionPlan, type NodeDeletionScene } from '@pascal-app/core';
 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 type { AnyNode, Collection, CollectionId, SceneMaterialId } from '@pascal-app/core/schema';
+import { type AnyNodeId, type AnyNodeType, SceneMaterial } from '@pascal-app/core/schema';
 import useScene from '@pascal-app/core/store';
 import type { SceneMeta } from '../storage/types.js';
+import { InMemoryAgentSession } from './agent-session.js';
 export type ValidationError = {
     nodeId: string;
     path: string;
@@ -30,8 +32,13 @@ export type DeletePatch = {
     id: AnyNodeId;
     cascade?: boolean;
 };
-export type Patch = CreatePatch | UpdatePatch | DeletePatch;
-export type ActiveSceneMeta = Pick<SceneMeta, 'id' | 'name' | 'projectId' | 'ownerId' | 'thumbnailUrl' | 'version'>;
+/** Adds or replaces a scene material, written before the nodes of the same patch. */
+export type MaterialUpsertPatch = {
+    op: 'upsert_material';
+    material: SceneMaterial;
+};
+export type Patch = CreatePatch | UpdatePatch | DeletePatch | MaterialUpsertPatch;
+export type ActiveSceneMeta = Pick<SceneMeta, 'id' | 'name' | 'projectId' | 'ownerId' | 'thumbnailUrl' | 'version' | 'graphHash'>;
 /** The `extra` bag `setScene` accepts — collections, materials, plugin state. */
 type SetSceneExtra = Parameters<ReturnType<typeof useScene.getState>['setScene']>[2];
 /**
@@ -42,7 +49,11 @@ type SetSceneExtra = Parameters<ReturnType<typeof useScene.getState>['setScene']
  * `flushDirty()` for observability.
  */
 export declare class SceneBridge {
+    /** `applyPatch` takes `upsert_material` patches, in the patch's one history step. */
+    readonly supportsMaterialUpserts = true;
     private activeScene;
+    /** What the agent's session has kept: its named moments, and what it made. */
+    readonly agentSession: InMemoryAgentSession;
     /**
      * Scene identity currently bound to this bridge. MCP tools use this to know
      * which editor scene should receive live events after mutations.
@@ -67,6 +78,9 @@ export declare class SceneBridge {
     getNode(id: AnyNodeId): AnyNode | null;
     /** All nodes (live reference into the store — do NOT mutate). */
     getNodes(): Record<AnyNodeId, AnyNode>;
+    getCollections(): Record<CollectionId, Collection>;
+    getMaterials(): Record<SceneMaterialId, SceneMaterial>;
+    setCollections(collections: Record<CollectionId, Collection>): void;
     /** Root node IDs. */
     getRootNodeIds(): AnyNodeId[];
     /**
@@ -118,14 +132,34 @@ export declare class SceneBridge {
     deleteNode(id: AnyNodeId, cascade?: boolean): string[];
     /**
      * Atomic multi-op patch. Validates EVERY patch first (dry run); only if all
-     * pass does it apply in a single batch via `createNodes` / `updateNodes` /
-     * `deleteNodes`. Throws on any validation failure without mutating state.
+     * pass does it apply through the store actions in one history step. Throws on
+     * validation failure without mutating state.
      */
     applyPatch(patches: Patch[]): {
         appliedOps: number;
         deletedIds: AnyNodeId[];
         createdIds: AnyNodeId[];
     };
+    /**
+     * Preview what deleting `ids` does to `scene` with this bridge's semantics
+     * (core's store planner), without committing or minting default gutters.
+     * The apply_patch guard runs its dry run through this.
+     */
+    planDeletion(scene: NodeDeletionScene, ids: AnyNodeId[]): NodeDeletionPlan;
+    /**
+     * Derive this scene's construction the way the browser's commit subscriber
+     * does: one pass of the shared kernel writes the room zones, the auto
+     * ceilings, the wall side classification and the floor plates.
+     *
+     * The headless bridge has no space-detection subscriber, so the semantic
+     * tools that state room intent call this to materialise the construction
+     * they report. Writes are history-paused, so undo returns to the state
+     * before the triggering tool call rather than stranding derived nodes.
+     */
+    deriveStructure(levelIds?: AnyNodeId[]): {
+        createdIds: AnyNodeId[];
+        deletedIds: AnyNodeId[];
+    };
     /** Undo. Returns the number of steps actually undone. */
     undo(steps?: number): number;
     /** Redo. Returns the number of steps actually redone. */
@@ -147,6 +181,8 @@ export declare class SceneBridge {
     };
     /** Clear the temporal undo/redo history. */
     clearHistory(): void;
+    runAsSingleHistoryStep<T>(run: () => T): T;
+    private reconcileDependentStructure;
     /**
      * Return the node whose `children` array (string or object form) contains
      * the given id, or null if none. Used as a fallback when `parentId` is

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

@@ -1,9 +1,10 @@
 // Side-effect import MUST come first: installs RAF polyfill before core loads.
 import './node-shims.js';
-import { HIDDEN_SITE_NOTE } from '@pascal-app/core';
-import { AnyNode as AnyNodeSchema, parseNode, } from '@pascal-app/core/schema';
+import { adjacentLevelId, applyStructureReconciliation, assertDerivedNodeWrites, changedStairOpeningOwners, floorOpeningTargets, HIDDEN_SITE_NOTE, pauseSceneHistory, pauseSpaceDetection, planNodeDeletion, planOwnedFloorOpenings, planWallDeletion, resumeSceneHistory, resumeSpaceDetection, runAsSingleSceneHistoryStep, stairDeckLevelId, structureChangeBatch, } from '@pascal-app/core';
+import { AnyNode as AnyNodeSchema, generateId, parseNode, SceneMaterial, } from '@pascal-app/core/schema';
 // Per PLAN §0.6: `useScene` is the DEFAULT export from `@pascal-app/core/store`.
 import useScene from '@pascal-app/core/store';
+import { InMemoryAgentSession } from './agent-session.js';
 /**
  * Headless bridge to the `@pascal-app/core` Zustand store.
  *
@@ -12,7 +13,11 @@ import useScene from '@pascal-app/core/store';
  * `flushDirty()` for observability.
  */
 export class SceneBridge {
+    /** `applyPatch` takes `upsert_material` patches, in the patch's one history step. */
+    supportsMaterialUpserts = true;
     activeScene = null;
+    /** What the agent's session has kept: its named moments, and what it made. */
+    agentSession = new InMemoryAgentSession();
     /**
      * Scene identity currently bound to this bridge. MCP tools use this to know
      * which editor scene should receive live events after mutations.
@@ -25,6 +30,7 @@ export class SceneBridge {
             ownerId: meta.ownerId,
             thumbnailUrl: meta.thumbnailUrl,
             version: meta.version,
+            ...(meta.graphHash === undefined ? {} : { graphHash: meta.graphHash }),
         };
     }
     getActiveScene() {
@@ -35,10 +41,12 @@ export class SceneBridge {
     }
     /** Load initial state; if empty, creates default Site → Building → Level. */
     loadDefault() {
+        this.agentSession.replace();
         useScene.getState().loadScene();
     }
     /** Replace entire scene (undoable via Zundo). */
     setScene(nodes, rootNodeIds, extra) {
+        this.agentSession.replace();
         useScene.getState().setScene(nodes, rootNodeIds, extra);
     }
     /** Full snapshot for export, including collections and the material palette. */
@@ -119,6 +127,17 @@ export class SceneBridge {
     getNodes() {
         return useScene.getState().nodes;
     }
+    getCollections() {
+        return useScene.getState().collections;
+    }
+    getMaterials() {
+        return useScene.getState().materials;
+    }
+    setCollections(collections) {
+        if (useScene.getState().readOnly)
+            return;
+        useScene.setState({ collections });
+    }
     /** Root node IDs. */
     getRootNodeIds() {
         return useScene.getState().rootNodeIds;
@@ -237,7 +256,12 @@ export class SceneBridge {
      * Returns the generated id.
      */
     createNode(node, parentId) {
-        useScene.getState().createNode(node, parentId);
+        const before = useScene.getState().nodes;
+        assertDerivedNodeWrites(before, { create: [{ node: parentId ? { ...node, parentId } : node }] });
+        runAsSingleSceneHistoryStep(useScene, () => {
+            useScene.getState().createNode(node, parentId);
+            this.reconcileDependentStructure(before);
+        });
         return node.id;
     }
     /** Update node fields (shallow merge through the core store). */
@@ -245,7 +269,12 @@ export class SceneBridge {
         if (!useScene.getState().nodes[id]) {
             throw new Error(`node not found: ${id}`);
         }
-        useScene.getState().updateNode(id, data);
+        const before = useScene.getState().nodes;
+        assertDerivedNodeWrites(before, { update: [{ id, data }] });
+        runAsSingleSceneHistoryStep(useScene, () => {
+            useScene.getState().updateNode(id, data);
+            this.reconcileDependentStructure(before);
+        });
     }
     /**
      * Delete a node. If the node has children and `cascade === false`, throws.
@@ -265,7 +294,18 @@ export class SceneBridge {
             throw new Error(`node has ${descendants.length - 1} descendant(s); pass cascade: true to delete recursively`);
         }
         const before = new Set(Object.keys(state.nodes));
-        useScene.getState().deleteNode(id);
+        const wallLevels = [
+            ...new Set(descendants.flatMap((nodeId) => {
+                const deleted = state.nodes[nodeId];
+                return deleted?.type === 'wall' && deleted.parentId ? [deleted.parentId] : [];
+            })),
+        ];
+        runAsSingleSceneHistoryStep(useScene, () => {
+            useScene.getState().deleteNode(id);
+            if (wallLevels.length)
+                this.deriveStructure(wallLevels);
+            this.reconcileDependentStructure(state.nodes);
+        });
         const afterNodes = useScene.getState().nodes;
         const removed = [];
         for (const prevId of before) {
@@ -276,12 +316,14 @@ export class SceneBridge {
     }
     /**
      * Atomic multi-op patch. Validates EVERY patch first (dry run); only if all
-     * pass does it apply in a single batch via `createNodes` / `updateNodes` /
-     * `deleteNodes`. Throws on any validation failure without mutating state.
+     * pass does it apply through the store actions in one history step. Throws on
+     * validation failure without mutating state.
      */
     applyPatch(patches) {
         const state = useScene.getState();
         const nodes = state.nodes;
+        if (state.readOnly)
+            throw new Error('scene_read_only');
         // Track synthesized state as we dry-run so later ops can reference
         // earlier-created ids and reflect earlier-deleted ids.
         const simAvailable = new Set(Object.keys(nodes));
@@ -290,11 +332,18 @@ export class SceneBridge {
         // Zod-normalised copy (which has a generated id if the caller omitted one)
         // instead of the unparsed input.
         const parsedCreateNodes = new Map();
+        const materialUpserts = new Map();
         for (let i = 0; i < patches.length; i++) {
             const p = patches[i];
             if (!p)
                 throw new Error(`invalid patch: patches[${i}] is undefined`);
-            if (p.op === 'create') {
+            if (p.op === 'upsert_material') {
+                const parsed = SceneMaterial.safeParse(p.material);
+                if (!parsed.success)
+                    throw new Error(`invalid patch: patches[${i}] material failed schema: ${parsed.error.message}`);
+                materialUpserts.set(parsed.data.id, parsed.data);
+            }
+            else if (p.op === 'create') {
                 const res = parseNode(p.node);
                 if (!res.success) {
                     throw new Error(`invalid patch: patches[${i}] create node failed schema: ${res.error.message}`);
@@ -302,7 +351,7 @@ export class SceneBridge {
                 if (p.parentId !== undefined && !simAvailable.has(p.parentId)) {
                     throw new Error(`invalid patch: patches[${i}] create parentId "${p.parentId}" not found`);
                 }
-                parsedCreateNodes.set(i, res.data);
+                parsedCreateNodes.set(i, p.parentId ? { ...res.data, parentId: p.parentId } : res.data);
                 simAvailable.add(res.data.id);
             }
             else if (p.op === 'update') {
@@ -334,47 +383,75 @@ export class SceneBridge {
                 throw new Error(`invalid patch: patches[${i}] unknown op`);
             }
         }
-        // Dry-run succeeded — apply in order, batching adjacent ops of the same
-        // op type so Zundo groups them tightly.
-        const createOps = [];
-        const updateOps = [];
-        const deleteIds = [];
-        const createdIds = [];
-        // Simple approach: queue by type, flush in original order by walking
-        // patches and interleaving flushes when the op type changes, so ids
-        // created/updated/deleted stay temporally consistent.
-        const flush = (kind) => {
-            if (kind !== 'create' && createOps.length > 0) {
-                useScene.getState().createNodes(createOps);
-                createOps.length = 0;
+        // Derived construction is refused BEFORE anything is applied, so a patch
+        // that tries to author a floor plate or an auto ceiling leaves the scene
+        // untouched like any other invalid patch.
+        assertDerivedNodeWrites(nodes, {
+            create: [...parsedCreateNodes.values()].map((node) => ({ node })),
+            update: patches.flatMap((patch) => patch.op === 'update' ? [{ id: patch.id, data: patch.data }] : []),
+        });
+        const createOps = new Map();
+        const updateOps = new Map();
+        const deleteIds = new Set();
+        const nextNodes = { ...nodes };
+        for (const [index, patch] of patches.entries()) {
+            if (patch.op === 'create') {
+                const parsed = parsedCreateNodes.get(index);
+                const node = { ...parsed, parentId: patch.parentId ?? parsed.parentId };
+                createOps.set(node.id, { node, parentId: patch.parentId });
+                deleteIds.delete(node.id);
+                nextNodes[node.id] = node;
             }
-            if (kind !== 'update' && updateOps.length > 0) {
-                useScene.getState().updateNodes(updateOps);
-                updateOps.length = 0;
+            else if (patch.op === 'update') {
+                nextNodes[patch.id] = { ...nextNodes[patch.id], ...patch.data };
+                const created = createOps.get(patch.id);
+                if (created) {
+                    created.node = nextNodes[patch.id];
+                    if (patch.data.parentId !== undefined)
+                        created.parentId = patch.data.parentId;
+                }
+                else
+                    updateOps.set(patch.id, { ...updateOps.get(patch.id), ...patch.data });
             }
-            if (kind !== 'delete' && deleteIds.length > 0) {
-                useScene.getState().deleteNodes(deleteIds);
-                deleteIds.length = 0;
+            else if (patch.op === 'delete') {
+                deleteIds.add(patch.id);
+                createOps.delete(patch.id);
+                updateOps.delete(patch.id);
+                delete nextNodes[patch.id];
             }
-        };
-        for (let i = 0; i < patches.length; i++) {
-            const p = patches[i];
-            if (p.op === 'create') {
-                flush('create');
-                const parsedNode = parsedCreateNodes.get(i);
-                createOps.push({ node: parsedNode, parentId: p.parentId });
-                createdIds.push(parsedNode.id);
-            }
-            else if (p.op === 'update') {
-                flush('update');
-                updateOps.push({ id: p.id, data: p.data });
+        }
+        // Plan the entire deletion selection before applying anything. Interleaved
+        // update operations must not turn an all-boundaries deletion into balconies.
+        const planned = structureChangeBatch(planWallDeletion(nodes, {
+            nodeIds: [...deleteIds],
+            nextNodes,
+            mintId: generateId,
+        }).changes);
+        for (const { id, data } of planned.update)
+            updateOps.set(id, { ...updateOps.get(id), ...data });
+        const wallLevels = [
+            ...new Set(planned.delete.flatMap((id) => {
+                const node = nodes[id];
+                return node?.type === 'wall' && node.parentId ? [node.parentId] : [];
+            })),
+        ];
+        runAsSingleSceneHistoryStep(useScene, () => {
+            pauseSpaceDetection();
+            try {
+                for (const material of materialUpserts.values())
+                    useScene.getState().addSceneMaterial(material);
+                useScene.getState().createNodes([...createOps.values(), ...planned.create]);
+                useScene.getState().updateNodes([...updateOps].map(([id, data]) => ({ id, data })));
+                useScene.getState().deleteNodes(planned.delete);
             }
-            else {
-                flush('delete');
-                deleteIds.push(p.id);
+            finally {
+                resumeSpaceDetection();
             }
-        }
-        flush('none');
+            if (wallLevels.length)
+                this.deriveStructure(wallLevels);
+            this.reconcileDependentStructure(nodes);
+        });
+        const createdIds = Object.keys(useScene.getState().nodes).filter((id) => !nodes[id]);
         // Compute actual deleted ids by diffing pre/post snapshots.
         const postNodes = useScene.getState().nodes;
         const deletedIds = [];
@@ -388,6 +465,40 @@ export class SceneBridge {
             createdIds,
         };
     }
+    /**
+     * Preview what deleting `ids` does to `scene` with this bridge's semantics
+     * (core's store planner), without committing or minting default gutters.
+     * The apply_patch guard runs its dry run through this.
+     */
+    planDeletion(scene, ids) {
+        return planNodeDeletion(scene, ids, { mintDefaults: false });
+    }
+    /**
+     * Derive this scene's construction the way the browser's commit subscriber
+     * does: one pass of the shared kernel writes the room zones, the auto
+     * ceilings, the wall side classification and the floor plates.
+     *
+     * The headless bridge has no space-detection subscriber, so the semantic
+     * tools that state room intent call this to materialise the construction
+     * they report. Writes are history-paused, so undo returns to the state
+     * before the triggering tool call rather than stranding derived nodes.
+     */
+    deriveStructure(levelIds) {
+        pauseSceneHistory(useScene);
+        try {
+            const patches = applyStructureReconciliation(useScene, {
+                levelIds,
+                mintId: (kind) => generateId(kind),
+            });
+            return {
+                createdIds: patches.flatMap((patch) => patch.op === 'create' ? [patch.node.id] : []),
+                deletedIds: patches.flatMap((patch) => (patch.op === 'delete' ? [patch.id] : [])),
+            };
+        }
+        finally {
+            resumeSceneHistory(useScene);
+        }
+    }
     /** Undo. Returns the number of steps actually undone. */
     undo(steps = 1) {
         const before = useScene.temporal.getState().pastStates.length;
@@ -451,6 +562,82 @@ export class SceneBridge {
     clearHistory() {
         useScene.temporal.getState().clear();
     }
+    runAsSingleHistoryStep(run) {
+        return runAsSingleSceneHistoryStep(useScene, run);
+    }
+    reconcileDependentStructure(before) {
+        const currentNodes = this.getNodes();
+        const authoredInputChanged = [
+            ...new Set([...Object.keys(before), ...Object.keys(currentNodes)]),
+        ].some((id) => {
+            if (before[id] === currentNodes[id])
+                return false;
+            const type = (currentNodes[id] ?? before[id])?.type;
+            return (type === 'stair' ||
+                type === 'stair-segment' ||
+                type === 'elevator' ||
+                type === 'level' ||
+                type === 'building' ||
+                type === 'slab' ||
+                type === 'ceiling');
+        });
+        if (authoredInputChanged) {
+            const ownerIds = changedStairOpeningOwners(before, currentNodes);
+            for (const node of [...Object.values(before), ...Object.values(currentNodes)]) {
+                if (node.type === 'elevator' &&
+                    (before[node.id] !== currentNodes[node.id] ||
+                        Object.values(currentNodes).some((level) => level.type === 'level' && before[level.id] !== level)))
+                    ownerIds.add(node.id);
+            }
+            const owned = planOwnedFloorOpenings(currentNodes, { ownerIds });
+            if (owned.length) {
+                pauseSpaceDetection();
+                try {
+                    useScene.getState().applyNodeChanges(structureChangeBatch(owned));
+                }
+                finally {
+                    resumeSpaceDetection();
+                }
+            }
+        }
+        const current = this.getNodes();
+        const levels = new Set();
+        for (const id of new Set([...Object.keys(before), ...Object.keys(current)])) {
+            if (before[id] === current[id])
+                continue;
+            for (const nodes of [before, current]) {
+                const level = stairDeckLevelId(nodes, nodes[id]);
+                if (level)
+                    levels.add(level);
+                const node = nodes[id];
+                if (node?.type === 'level') {
+                    levels.add(node.id);
+                    const lower = adjacentLevelId(nodes, node.id, -1);
+                    if (lower)
+                        levels.add(lower);
+                }
+                if (node?.type === 'stair')
+                    for (const opening of Object.values(nodes))
+                        if (opening.type === 'floor-opening' && opening.ownerId === node.id)
+                            for (const target of floorOpeningTargets(nodes, opening))
+                                levels.add(target.levelId);
+                if (node?.type === 'floor-opening')
+                    for (const target of floorOpeningTargets(nodes, node))
+                        levels.add(target.levelId);
+                if (node?.type === 'door' || node?.type === 'window') {
+                    const wall = nodes[node.parentId];
+                    if (wall?.type === 'wall' && wall.parentId)
+                        levels.add(wall.parentId);
+                }
+                else if ((node?.type === 'zone' || node?.type === 'slab' || node?.type === 'wall') &&
+                    node.parentId) {
+                    levels.add(node.parentId);
+                }
+            }
+        }
+        if (levels.size)
+            this.deriveStructure([...levels]);
+    }
     // ---- internal helpers ----
     /**
      * Return the node whose `children` array (string or object form) contains

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export { SceneBridge } from './bridge/scene-bridge.js';
 export { createSceneOperations, type SceneOperations } from './operations/index.js';
 export { type CreatePascalMcpServerOptions, createPascalMcpServer } from './server.js';
+export type { GeometryScriptHost, ScriptedKind } from './tools/add-object.js';
+export { type AssetCatalog, builtInCatalog } from './tools/asset-catalog.js';
+export type { SceneViewCapture, SceneViewHost } from './tools/view-scene.js';
 export { version } from './version.js';
 //# 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;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,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,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACzE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { SceneBridge } from './bridge/scene-bridge.js';
 export { createSceneOperations } from './operations/index.js';
 export { createPascalMcpServer } from './server.js';
+export { builtInCatalog } from './tools/asset-catalog.js';
 export { version } from './version.js';

package/dist/lib/safe-fetch.d.ts

@@ -1,3 +1,21 @@
+import type { LookupAddress } from 'node:dns';
+import { type IncomingMessage } from 'node:http';
+import { type LookupFunction } from 'node:net';
+/** True for any address a server-side fetch must not reach. Unparseable input is blocked. */
+export declare function isBlockedAddress(address: string): boolean;
+export type Resolver = (hostname: string) => Promise<LookupAddress[]>;
+/** A socket `lookup` that only ever answers with the given, already-checked addresses. */
+export declare function pinnedLookup(addresses: LookupAddress[]): LookupFunction;
+export type PinnedRequestInit = {
+    headers: Record<string, string>;
+    lookup: LookupFunction;
+    signal: AbortSignal;
+};
+export type Requester = (url: URL, init: PinnedRequestInit) => Promise<IncomingMessage>;
+export type SafeFetchDeps = {
+    resolve: Resolver;
+    request: Requester;
+};
 export type SafeFetchOptions = {
     maxBytes?: number;
     timeoutMs?: number;
@@ -11,9 +29,9 @@ export type SafeFetchResult = {
     hops: string[];
 };
 /**
- * SSRF-safe fetch that follows redirects manually, revalidating the host
- * allowlist + private-IP check on every hop. Throws `McpError` for blocked
- * URLs, non-2xx responses, oversize bodies, or timeouts.
+ * SSRF-safe fetch that follows redirects manually, re-resolving and rechecking
+ * the host on every hop and connecting only to the checked addresses. Throws
+ * `ProtocolError` for blocked URLs, non-2xx responses, oversize bodies, or timeouts.
  */
-export declare function safeFetch(urlStr: string, opts?: SafeFetchOptions): Promise<SafeFetchResult>;
+export declare function safeFetch(urlStr: string, opts?: SafeFetchOptions, deps?: SafeFetchDeps): Promise<SafeFetchResult>;
 //# sourceMappingURL=safe-fetch.d.ts.map