@pascal-app/mcp 1.0.6 → 1.1.0

package/dist/server.js

@@ -1,10 +1,10 @@
 import { McpServer, ProtocolError, ProtocolErrorCode, } from '@modelcontextprotocol/server';
 import { recordMade, } from '@pascal-app/core/agent-operations';
+import { untracked } from '@pascal-app/core/runtime';
 import { createSceneOperations } from './operations/index.js';
 import { registerPrompts } from './prompts/index.js';
 import { registerResources } from './resources/index.js';
 import { registerTools } from './tools/index.js';
-import { cachedCatalog } from './tools/asset-catalog.js';
 import { registerHostedServiceTools } from './tools/hosted-services.js';
 import { normalizeToolSchemaDialect } from './tools/normalize-schema-dialect.js';
 import { registerProjectFileTools } from './tools/project-files.js';
@@ -21,10 +21,12 @@ export function createPascalMcpServer(opts) {
     const executeTool = recordingWhatToolsMake(operations, opts.executeTool);
     if (executeTool)
         installToolExecutor(server, executeTool);
-    const catalog = opts.catalog ? cachedCatalog(opts.catalog) : undefined;
+    installSceneScope(server, operations);
     registerTools(server, operations, {
-        catalog,
+        catalog: opts.catalog,
         geometryScripts: opts.geometryScripts,
+        objectMakers: opts.objectMakers,
+        readFile: opts.readFile,
         sceneViews: opts.sceneViews,
         assetViews: opts.assetViews,
     });
@@ -33,7 +35,7 @@ export function createPascalMcpServer(opts) {
         registerHostedServiceTools(server, opts.services);
     if (opts.files)
         registerProjectFileTools(server, opts.files);
-    registerResources(server, operations, catalog);
+    registerResources(server, operations, opts.catalog);
     registerPrompts(server, operations);
     normalizeToolSchemaDialect(server);
     answerRetiredTools(server);
@@ -73,12 +75,26 @@ function recordingWhatToolsMake(operations, outer) {
     if (!session)
         return outer;
     const recording = (input) => recordMade({
-        getNodes: () => operations.getNodes(),
+        // What the tool made is bookkeeping, not what it read: the scene as stored.
+        getNodes: () => untracked(operations.getNodes()),
         readSession: () => session.read(),
         keep: (keep) => session.keep(keep),
     }, input.execute);
     return outer ? (input) => outer({ ...input, execute: () => recording(input) }) : recording;
 }
+/**
+ * Every handler starts in the scene's scope (`SceneOperations.runInScene`): ids it mints and
+ * schema defaults it fills before its first await come from the scene's allocator, so a detached
+ * scene recomputed from the same snapshot and effect mints the same ones. Work after an await
+ * re-enters the scope itself (add_object, add_column).
+ */
+function installSceneScope(server, operations) {
+    const runInScene = operations.runInScene?.bind(operations);
+    if (!runInScene)
+        return;
+    const registerTool = server.registerTool.bind(server);
+    server.registerTool = ((name, config, callback) => registerTool(name, config, (...args) => runInScene(() => Reflect.apply(callback, undefined, args))));
+}
 function installToolExecutor(server, executeTool) {
     const registerTool = server.registerTool.bind(server);
     server.registerTool = ((name, config, callback) => {

package/dist/templates/empty-studio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"empty-studio.d.ts","sourceRoot":"","sources":["../../src/templates/empty-studio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAmPpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;aACnB,EAAE,EAAE,cAAc;aAClB,IAAI,EAAE,cAAc;aACpB,WAAW,EACT,6FAA6F;CACvF,CAAA"}
+{"version":3,"file":"empty-studio.d.ts","sourceRoot":"","sources":["../../src/templates/empty-studio.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAiPpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;aACnB,EAAE,EAAE,cAAc;aAClB,IAAI,EAAE,cAAc;aACpB,WAAW,EACT,6FAA6F;CACvF,CAAA"}

package/dist/templates/empty-studio.js

@@ -1,4 +1,5 @@
 import { DEFAULT_LEVEL_HEIGHT } from '@pascal-app/core';
+import { NEW_DOOR_FRAME_THICKNESS } from '@pascal-app/core/building';
 /**
  * 40 m² studio apartment — a single open room with one window, one front door
  * and a single "Living/Kitchen" zone. Used as a starting point for small unit
@@ -55,8 +56,7 @@ function buildNodes() {
         rotation: [0, 0, 0],
         width: 0.9,
         height: 2.1,
-        frameThickness: 0.05,
-        frameDepth: 0.07,
+        frameThickness: NEW_DOOR_FRAME_THICKNESS,
         threshold: true,
         thresholdHeight: 0.02,
         hingesSide: 'left',
@@ -100,7 +100,6 @@ function buildNodes() {
         width: 1.5,
         height: 1.2,
         frameThickness: 0.05,
-        frameDepth: 0.07,
         columnRatios: [1],
         rowRatios: [1],
         columnDividerThickness: 0.03,

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;AAkRpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;aACnB,EAAE,EAAE,cAAc;aAClB,IAAI,EAAE,cAAc;aACpB,WAAW,EACT,4GAA4G;CACtG,CAAA"}
+{"version":3,"file":"garden-house.d.ts","sourceRoot":"","sources":["../../src/templates/garden-house.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAgRpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;aACnB,EAAE,EAAE,cAAc;aAClB,IAAI,EAAE,cAAc;aACpB,WAAW,EACT,4GAA4G;CACtG,CAAA"}

package/dist/templates/garden-house.js

@@ -1,3 +1,4 @@
+import { NEW_DOOR_FRAME_THICKNESS } from '@pascal-app/core/building';
 /**
  * "Garden house" — a simplified take on the Casa del Sol layout used in the
  * MCP research fixtures.
@@ -50,8 +51,7 @@ function door(id, parentWallId, width = 0.9) {
         rotation: [0, 0, 0],
         width,
         height: 2.1,
-        frameThickness: 0.05,
-        frameDepth: 0.07,
+        frameThickness: NEW_DOOR_FRAME_THICKNESS,
         threshold: true,
         thresholdHeight: 0.02,
         hingesSide: 'left',
@@ -97,7 +97,6 @@ function makeWindow(id, parentWallId, width = 1.2) {
         width,
         height: 1.2,
         frameThickness: 0.05,
-        frameDepth: 0.07,
         columnRatios: [1],
         rowRatios: [1],
         columnDividerThickness: 0.03,

package/dist/templates/two-bedroom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"two-bedroom.d.ts","sourceRoot":"","sources":["../../src/templates/two-bedroom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AA2SpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;aACnB,EAAE,EAAE,aAAa;aACjB,IAAI,EAAE,uBAAuB;aAC7B,WAAW,EACT,qGAAqG;CAC/F,CAAA"}
+{"version":3,"file":"two-bedroom.d.ts","sourceRoot":"","sources":["../../src/templates/two-bedroom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAySpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;aACnB,EAAE,EAAE,aAAa;aACjB,IAAI,EAAE,uBAAuB;aAC7B,WAAW,EACT,qGAAqG;CAC/F,CAAA"}

package/dist/templates/two-bedroom.js

@@ -1,3 +1,4 @@
+import { NEW_DOOR_FRAME_THICKNESS } from '@pascal-app/core/building';
 /**
  * 80 m² two-bedroom apartment.
  *
@@ -50,8 +51,7 @@ function door(id, parentWallId) {
         rotation: [0, 0, 0],
         width: 0.8,
         height: 2.1,
-        frameThickness: 0.05,
-        frameDepth: 0.07,
+        frameThickness: NEW_DOOR_FRAME_THICKNESS,
         threshold: true,
         thresholdHeight: 0.02,
         hingesSide: 'left',
@@ -97,7 +97,6 @@ function makeWindow(id, parentWallId, width = 1.2) {
         width,
         height: 1.2,
         frameThickness: 0.05,
-        frameDepth: 0.07,
         columnRatios: [1],
         rowRatios: [1],
         columnDividerThickness: 0.03,

package/dist/tools/add-column.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-column.d.ts","sourceRoot":"","sources":["../../src/tools/add-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAW7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAmB,KAAK,kBAAkB,EAAc,MAAM,cAAc,CAAA;AAMnF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE,kBAAkB,QAqD1B"}
+{"version":3,"file":"add-column.d.ts","sourceRoot":"","sources":["../../src/tools/add-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAgB7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAmB,KAAK,kBAAkB,EAAc,MAAM,cAAc,CAAA;AAOnF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE,kBAAkB,QAyD1B"}

package/dist/tools/add-column.js

@@ -1,17 +1,18 @@
 import { isScriptedNode, scriptedObjectMeta } from '@pascal-app/core';
 import { addColumn, columnScriptParams, editedScriptLanguage, } from '@pascal-app/core/agent-operations';
-import { addColumnTool, isAgentRefusal, refuse } from '@pascal-app/core/agent-tools';
-import { GeometryReuseFields } from '@pascal-app/core/schema';
+import { addColumnTool, isAgentRefusal, refuse, surfaceDescription, } from '@pascal-app/core/agent-tools';
+import { GeometryReuseFields, generateId } from '@pascal-app/core/schema';
 import { z } from 'zod';
 import { compileAndStore, readScript } from './add-object.js';
 import { DESTRUCTIVE_TOOL_ANNOTATIONS } from './annotations.js';
 import { refusalResult, toolError } from './errors.js';
 import { persistencePayload, publishLiveSceneSnapshot } from './live-sync.js';
+import { inScene } from './scene-scope.js';
 import { toPatches } from './shared-tools.js';
 export function registerAddColumn(server, bridge, host) {
     server.registerTool(addColumnTool.name, {
         title: addColumnTool.title,
-        description: addColumnTool.description,
+        description: surfaceDescription(addColumnTool, 'mcp'),
         inputSchema: z.object(addColumnTool.input),
         annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async (input) => {
@@ -26,17 +27,19 @@ export function registerAddColumn(server, bridge, host) {
                 const scene = bridge.getActiveScene();
                 if (!scene)
                     refuse('no_active_scene', 'Open or save a scene first.');
-                const code = input.code ?? (await readScript(host, scene.id, bridge, input.nodeId));
+                // A new column's id is the scene's, minted before anything is awaited.
+                const nodeId = input.nodeId ?? inScene(bridge, () => generateId('column'));
                 const language = editedScriptLanguage(previous, input);
+                const code = input.code ?? (await readScript(host, scene.id, bridge, input.nodeId));
                 compiled = await compileAndStore(host, scene.id, { code, language, params }, 'column', {
-                    nodeId: input.nodeId,
+                    nodeId,
                     metadata: {
                         ...(isScriptedNode(previous) ? scriptedObjectMeta(previous) : {}),
                         ...GeometryReuseFields.parse(input),
                     },
                 });
             }
-            const outcome = addColumn(nodes, { ...input, compiled }, { activeLevelId: bridge.activeLevelId?.() ?? null });
+            const outcome = inScene(bridge, () => addColumn(nodes, { ...input, compiled }, { activeLevelId: bridge.activeLevelId?.() ?? null }));
             if (outcome.changes)
                 bridge.applyPatch(toPatches(outcome.changes));
             const payload = {

package/dist/tools/add-object.d.ts

@@ -1,5 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/server';
-import { type AddObjectInput } from '@pascal-app/core/agent-operations';
+import { type AddObjectInput, type PlannedPiece } from '@pascal-app/core/agent-operations';
 import { type CompiledGeometryScript, GeometryArtifactMetadata, type GeometryScriptLanguage, type GeometryScriptParamValue } from '@pascal-app/core/schema';
 import type { SceneOperations } from '../operations/index.js';
 /**
@@ -15,7 +15,7 @@ export type GeometryScriptHost = {
         code: string;
         language: GeometryScriptLanguage;
         params?: Record<string, GeometryScriptParamValue>;
-        /** What the host builds it for (a room's floor, a wall's face: `floorScriptInputs`, `wallFaceScriptInputs`), kept in the host's frame. */
+        /** What the host builds it for (a room's floor or a slab's top, y = 0 its surface; a wall's face: `floorScriptInputs`, `slabSurfaceScriptInputs`, `wallFaceScriptInputs`), kept in the host's frame. */
         inputs?: Record<string, unknown>;
     }): Promise<CompiledGeometryScript & {
         glb: Uint8Array;
@@ -33,6 +33,16 @@ export type GeometryScriptHost = {
         sceneId: string;
         sha256: string;
     }): Promise<Uint8Array | null>;
+    /**
+     * Runs a design's adapter (`author_scene`'s), model code, where the host runs modules: the
+     * payload it returns. Throws with the adapter's own error.
+     */
+    runAdapter?(input: {
+        adapter: string;
+        design: string;
+    }): Promise<{
+        payload: Record<string, unknown>;
+    }>;
     /**
      * Compiles and stores in one step, for a host whose compiler keeps the artifacts itself (the
      * hosted MCP's user editor tab); preferred over `compile` + `storeArtifact` when present.
@@ -49,6 +59,34 @@ export type GeometryScriptHost = {
         metadata?: GeometryArtifactMetadata;
     }): Promise<CompiledGeometryScript>;
 };
+/** A piece as the host that makes it knows it. */
+export type PieceState = {
+    status: 'made';
+    code: string;
+} | {
+    status: 'making';
+} | {
+    status: 'failed';
+    error: string;
+};
+/**
+ * Makes objects from words (`add_object`'s `piece`) with the host's own models, in the background:
+ * the host bills them, writes each module under add_object's conventions, and when one lands places
+ * it where the call asked, and writes again the conversion whose items wait for it.
+ */
+export type ObjectMakerHost = {
+    /** Records the piece and starts its maker; answers long before the module lands. */
+    start(input: {
+        sceneId: string;
+        piece: PlannedPiece;
+        metadata: GeometryArtifactMetadata;
+    }): Promise<void>;
+    /** The pieces by id; an id never started is absent. */
+    pieces(input: {
+        sceneId: string;
+        ids: readonly string[];
+    }): Promise<Record<string, PieceState>>;
+};
 export type ScriptedKind = 'object' | 'window' | 'door' | 'column' | 'floor' | 'wall-face';
 /** Compiles a module on the host and stores its GLB and text for the scene: the step every scripted tool shares. */
 export declare function compileAndStore(host: GeometryScriptHost, sceneId: string, { code, language, params, inputs, }: {
@@ -64,13 +102,14 @@ export declare function readScript(host: GeometryScriptHost, sceneId: string, br
 /**
  * One object's module compiled and stored by the host: a new one from its code, an edit from its
  * code or its stored script, with the params it keeps. The step a lone add_object and each
- * add_object of a run_batch share.
+ * add_object of a run_batch share. What it reads from the scene it reads before its first await;
+ * `nodeId` is a new object's id, minted by the caller in the scene's scope.
  */
-export declare function compileObject(host: GeometryScriptHost, sceneId: string, bridge: SceneOperations, args: Omit<AddObjectInput, 'compiled'>): Promise<CompiledGeometryScript>;
+export declare function compileObject(host: GeometryScriptHost, sceneId: string, bridge: SceneOperations, args: Omit<AddObjectInput, 'compiled'>, nodeId?: string | undefined): Promise<CompiledGeometryScript>;
 /** What a batch's add_object builds with: the host's compile, on the scene open now. */
 export declare function compileObjectOnHost(host: GeometryScriptHost | undefined, bridge: SceneOperations, args: Omit<AddObjectInput, 'compiled'>): Promise<CompiledGeometryScript>;
 /** `add_object` on the MCP: the shared contract and operation, with the host's compile in front. */
-export declare function registerAddObject(server: McpServer, bridge: SceneOperations, host: GeometryScriptHost | undefined): void;
+export declare function registerAddObject(server: McpServer, bridge: SceneOperations, host: GeometryScriptHost | undefined, makers?: ObjectMakerHost): void;
 /** `get_source` on the MCP: the object's module text, read back through the host's store. */
 export declare function registerGetSource(server: McpServer, bridge: SceneOperations, host: GeometryScriptHost | undefined): void;
 //# sourceMappingURL=add-object.d.ts.map

package/dist/tools/add-object.d.ts.map

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

package/dist/tools/add-object.js

@@ -1,11 +1,13 @@
 import { isScriptedNode, scriptedObjectMeta } from '@pascal-app/core';
-import { achievedChanges, addObject, authoredObject, editedScriptLanguage, editedScriptParams, furnishingRefusal, readableScript, readSourceResult, requireAddObjectReason, } from '@pascal-app/core/agent-operations';
-import { addObjectTool, CATALOG_SOURCE, getSourceTool, isAgentRefusal, refuse, } from '@pascal-app/core/agent-tools';
+import { achievedChanges, addObject, authoredObject, editedScriptLanguage, editedScriptParams, furnishingRefusal, planPiece, readableScript, readSourceResult, requireAddObjectReason, } from '@pascal-app/core/agent-operations';
+import { addObjectTool, CATALOG_SOURCE, getSourceTool, isAgentRefusal, refuse, surfaceDescription, } from '@pascal-app/core/agent-tools';
+import { untracked } from '@pascal-app/core/runtime';
 import { GEOMETRY_SCRIPT_MIME_TYPES, GeometryArtifactMetadata, GeometryReuseFields, generateId, } from '@pascal-app/core/schema';
 import { z } from 'zod';
 import { DESTRUCTIVE_TOOL_ANNOTATIONS, READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
 import { refusalResult, toolError } from './errors.js';
 import { persistencePayload, publishLiveSceneSnapshot } from './live-sync.js';
+import { inScene } from './scene-scope.js';
 import { briefInForce, toPatches } from './shared-tools.js';
 /** The kind an artifact records; a room's floor finish and a wall face's are none of the node kinds. */
 const ARTIFACT_KIND = {
@@ -31,13 +33,20 @@ export async function compileAndStore(host, sceneId, { code, language, params, i
     const { glb, ...compiled } = await host.compile({ code, language, params, inputs });
     metadata.mount = compiled.mount;
     const [sha256] = await Promise.all([
-        host.storeArtifact({
+        host
+            .storeArtifact({
             sceneId,
             nodeId,
             metadata,
             sha256: compiled.sha256,
             bytes: glb,
             mimeType: 'model/gltf-binary',
+        })
+            .catch((error) => {
+            // 413, Payload Too Large: the host's store refuses a build this size.
+            if (error.status !== 413)
+                throw error;
+            throw new Error(`${error instanceof Error ? error.message : String(error)}: the build is ${(glb.byteLength / 1048576).toFixed(1)} MB for ${compiled.manifest.triangles.toLocaleString('en')} triangles. Build it with fewer triangles: fewer segments on curves, spheres and tubes, fewer repeated tufts, slats or links, a flat back where it stands against a wall.`);
         }),
         host.storeArtifact({
             sceneId,
@@ -62,22 +71,21 @@ export function readScript(host, sceneId, bridge, nodeId) {
 /**
  * One object's module compiled and stored by the host: a new one from its code, an edit from its
  * code or its stored script, with the params it keeps. The step a lone add_object and each
- * add_object of a run_batch share.
+ * add_object of a run_batch share. What it reads from the scene it reads before its first await;
+ * `nodeId` is a new object's id, minted by the caller in the scene's scope.
  */
-export async function compileObject(host, sceneId, bridge, args) {
-    const code = args.code ??
-        (args.nodeId ? await readScript(host, sceneId, bridge, args.nodeId) : refuseMissingCode());
+export async function compileObject(host, sceneId, bridge, args, nodeId = args.nodeId) {
     const nodes = bridge.getNodes();
     const previous = args.nodeId ? nodes[args.nodeId] : undefined;
     const language = editedScriptLanguage(previous, args);
     const params = editedScriptParams(previous, args.params);
-    return compileAndStore(host, sceneId, { code, language, params }, 'object', {
-        nodeId: args.nodeId,
-        metadata: {
-            ...(isScriptedNode(previous) ? scriptedObjectMeta(previous) : {}),
-            ...GeometryReuseFields.parse(args),
-        },
-    });
+    const metadata = {
+        ...(isScriptedNode(previous) ? scriptedObjectMeta(previous) : {}),
+        ...GeometryReuseFields.parse(args),
+    };
+    const code = args.code ??
+        (args.nodeId ? await readScript(host, sceneId, bridge, args.nodeId) : refuseMissingCode());
+    return compileAndStore(host, sceneId, { code, language, params }, 'object', { nodeId, metadata });
 }
 /** What a batch's add_object builds with: the host's compile, on the scene open now. */
 export async function compileObjectOnHost(host, bridge, args) {
@@ -86,13 +94,14 @@ export async function compileObjectOnHost(host, bridge, args) {
     const scene = bridge.getActiveScene();
     if (!scene)
         refuse('no_active_scene', 'Open or save a scene first: authored objects are stored with a scene.');
-    return compileObject(host, scene.id, bridge, args);
+    const nodeId = args.nodeId ?? inScene(bridge, () => generateId('item'));
+    return compileObject(host, scene.id, bridge, args, nodeId);
 }
 /** `add_object` on the MCP: the shared contract and operation, with the host's compile in front. */
-export function registerAddObject(server, bridge, host) {
+export function registerAddObject(server, bridge, host, makers) {
     server.registerTool(addObjectTool.name, {
         title: addObjectTool.title,
-        description: addObjectTool.description,
+        description: surfaceDescription(addObjectTool, 'mcp'),
         inputSchema: z.object(addObjectTool.input),
         annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async (input) => {
@@ -114,10 +123,14 @@ export function registerAddObject(server, bridge, host) {
             });
         }
         const args = input;
+        if (args.piece)
+            return startPiece(bridge, scene.id, makers, args);
+        // A new object's id is the scene's, minted before anything is awaited.
+        const nodeId = args.nodeId ?? inScene(bridge, () => generateId('item'));
         let compiled;
         try {
             requireAddObjectReason(args);
-            compiled = await compileObject(host, scene.id, bridge, args);
+            compiled = await compileObject(host, scene.id, bridge, args, nodeId);
         }
         catch (error) {
             if (isAgentRefusal(error))
@@ -126,10 +139,17 @@ export function registerAddObject(server, bridge, host) {
         }
         // A copy: the hosted bridge writes its map in place, and a "before" that grows with the call
         // reads every creation as unchanged.
-        const before = { ...bridge.getNodes() };
+        // Copying is not a read: on a detached scene the operation records what it selects.
+        const nodes = bridge.getNodes();
+        const before = { ...untracked(nodes) };
         let outcome;
         try {
-            outcome = addObject(before, { ...args, compiled }, { activeLevelId: bridge.activeLevelId?.() ?? null });
+            outcome = inScene(bridge, () => addObject(nodes, { ...args, compiled }, {
+                activeLevelId: bridge.activeLevelId?.() ?? null,
+                ...(bridge.supportsMaterialUpserts && bridge.getMaterials
+                    ? { materials: bridge.getMaterials() }
+                    : {}),
+            }));
         }
         catch (error) {
             return refusalResult(error);
@@ -149,6 +169,40 @@ export function registerAddObject(server, bridge, host) {
         };
     });
 }
+/** add_object from words: the piece planned, its maker started on the host, answered at once. */
+async function startPiece(bridge, sceneId, makers, args) {
+    if (!makers)
+        return toolError('This Pascal server cannot make objects from words: pass the module as code.', {
+            code: 'pieces_unavailable',
+        });
+    let piece;
+    try {
+        piece = planPiece(args);
+        if (piece.place?.parentId && !(piece.place.parentId in bridge.getNodes()))
+            refuse('parent_not_found', `No node ${piece.place.parentId} to place the object on.`);
+        await makers.start({ sceneId, piece, metadata: GeometryReuseFields.parse(args) });
+    }
+    catch (error) {
+        if (isAgentRefusal(error))
+            return refusalResult(error);
+        return toolError(error instanceof Error ? error.message : String(error), {
+            code: 'piece_not_started',
+        });
+    }
+    const payload = {
+        piece: piece.id,
+        status: 'pending',
+        size: piece.size,
+        mount: piece.mount,
+        placed: piece.place
+            ? 'Where you asked, once its module lands.'
+            : `Not placed: author_scene items place it by its id (piece: "${piece.id}").`,
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload) }],
+        structuredContent: payload,
+    };
+}
 function refuseMissingCode() {
     refuse('code_required', 'Pass code to build a new object; params alone rebuild an existing one (nodeId).');
 }
@@ -156,7 +210,7 @@ function refuseMissingCode() {
 export function registerGetSource(server, bridge, host) {
     server.registerTool(getSourceTool.name, {
         title: getSourceTool.title,
-        description: getSourceTool.description,
+        description: surfaceDescription(getSourceTool, 'mcp'),
         inputSchema: z.object(getSourceTool.input),
         annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ nodeId, face }) => {

package/dist/tools/apply-patch.js

@@ -22,7 +22,7 @@ export const applyPatchOutput = {
 export function registerApplyPatch(server, bridge) {
     server.registerTool('apply_patch', {
         title: 'Apply patch',
-        description: "Apply a batch of create/update/delete operations atomically. All patches are validated before any are applied; the entire batch forms a single undo step. Batch-first is the default: prefer one apply_patch call containing all create/update/delete ops for a build step, in stable order so later ops can reference ids created by earlier ops. A single call is atomic (all or nothing) and pays the snapshot and save cost once; do not loop one-op calls. A create whose id already exists fails the whole patch with node_exists; to replace a node, delete it earlier in the same patch. An update cannot change id or type (identity_change) or object or children (immutable_field); restating the current value is fine. A parentId change must name an existing node that holds children (invalid_parent). An update cannot add schema issues to a node (invalid_update). After a delete or a roof update that regenerates a roof's default gutters, those gutters and their downspouts are addressable only in a later call (regenerated_default). A roof created or moved onto the storey whose walls carry it goes to the level above them (the roof level over a top storey), said in notes; storey content (walls, zones, slabs, ceilings, items, stairs) on a roof level (roof_level), a walled level declared the roof level (roof_level_holds_storey) and floor indexes putting a roof level under a storey (roof_level_on_top) are refused. Refusals come back as a tool error whose text is JSON {code, patchIndex, id, message}.",
+        description: "Apply a batch of create/update/delete operations atomically. All patches are validated before any are applied; the entire batch forms a single undo step. Batch-first is the default: prefer one apply_patch call containing all create/update/delete ops for a build step, in stable order so later ops can reference ids created by earlier ops. A single call is atomic (all or nothing) and pays the snapshot and save cost once; do not loop one-op calls. A create whose id already exists fails the whole patch with node_exists; to replace a node, delete it earlier in the same patch. An update cannot change id or type (identity_change) or object or children (immutable_field); restating the current value is fine. A parentId change must name an existing node that holds children and cannot point to the node or one of its descendants (invalid_parent). An update cannot add schema issues to a node (invalid_update). After a delete or a roof update that regenerates a roof's default gutters, those gutters and their downspouts are addressable only in a later call (regenerated_default). A roof created or moved onto the storey whose walls carry it goes to the level above them (the roof level over a top storey), said in notes; storey content (walls, zones, slabs, ceilings, items, stairs) on a roof level (roof_level), a walled level declared the roof level (roof_level_holds_storey) and floor indexes putting a roof level under a storey (roof_level_on_top) are refused. Refusals come back as a tool error whose text is JSON {code, patchIndex, id, message}.",
         inputSchema: z.object(applyPatchInput),
         outputSchema: z.object(applyPatchOutput),
         annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,

package/dist/tools/asset-catalog.d.ts

@@ -9,12 +9,11 @@ import type { AssetInput } from '@pascal-app/core/schema';
  */
 export declare const MCP_CATALOG_ITEMS: AssetInput[];
 /**
- * The items search_assets, place_items and furnish_room draw from. A host passes its own (the hosted
- * app: its published library, as the chat searches); a standalone server keeps the built-in list.
+ * The items search_assets, place_items and furnish_room draw from: a host passes its own (the
+ * hosted app: a source over its published library, as the chat searches it); a standalone server
+ * keeps the built-in list.
  */
-export type AssetCatalog = () => Promise<readonly AssetInput[]>;
-export declare const builtInCatalog: AssetCatalog;
-/** A host's catalog, read once by the first call that needs it; a failed read is tried again. */
-export declare function cachedCatalog(load: AssetCatalog): AssetCatalog;
+export type { AssetCatalog } from '@pascal-app/core/agent-operations';
+export declare const builtInCatalog: readonly AssetInput[];
 export declare function findCatalogItem(items: readonly AssetInput[], id: string): AssetInput | undefined;
 //# sourceMappingURL=asset-catalog.d.ts.map

package/dist/tools/asset-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-catalog.d.ts","sourceRoot":"","sources":["../../src/tools/asset-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAoTzC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAA;AAE/D,eAAO,MAAM,cAAc,EAAE,YAA4C,CAAA;AAEzE,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAO9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEhG"}
+{"version":3,"file":"asset-catalog.d.ts","sourceRoot":"","sources":["../../src/tools/asset-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAoTzC,CAAA;AAED;;;;GAIG;AACH,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAErE,eAAO,MAAM,cAAc,EAAE,SAAS,UAAU,EAAsB,CAAA;AAEtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEhG"}

package/dist/tools/asset-catalog.js

@@ -315,15 +315,7 @@ export const MCP_CATALOG_ITEMS = [
         scale: [1, 1, 1],
     },
 ];
-export const builtInCatalog = async () => MCP_CATALOG_ITEMS;
-/** A host's catalog, read once by the first call that needs it; a failed read is tried again. */
-export function cachedCatalog(load) {
-    let items = null;
-    return () => (items ??= load().catch((error) => {
-        items = null;
-        throw error;
-    }));
-}
+export const builtInCatalog = MCP_CATALOG_ITEMS;
 export function findCatalogItem(items, id) {
     return items.find((item) => item.id === id);
 }

package/dist/tools/author-scene.d.ts

@@ -1,10 +1,13 @@
 import type { McpServer } from '@modelcontextprotocol/server';
+import { type ProjectFileReader } from '@pascal-app/core/agent-operations';
 import type { SceneOperations } from '../operations/index.js';
-import { type GeometryScriptHost } from './add-object.js';
+import { type GeometryScriptHost, type ObjectMakerHost } from './add-object.js';
 /**
- * `author_scene` on the MCP: every item's module compiled and stored through the host, the
- * module and the adapter kept as the scene's provenance, the operation applied, Pascal's checks
- * run, and the gate report answered. Replay is the same payload through the same operation.
+ * `author_scene` on the MCP: the payload given, or the one the adapter answers on the module (the
+ * stored module and adapter, changed by edits, when left out), or the stored conversion again;
+ * items naming a piece written with its module, those still being made left for the host to write
+ * when they land; every module compiled and stored through the host, the operation applied,
+ * Pascal's checks run, and the gate report answered.
  */
-export declare function registerAuthorScene(server: McpServer, bridge: SceneOperations, host: GeometryScriptHost | undefined): void;
+export declare function registerAuthorScene(server: McpServer, bridge: SceneOperations, host: GeometryScriptHost | undefined, makers?: ObjectMakerHost, readFile?: ProjectFileReader): void;
 //# sourceMappingURL=author-scene.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"author-scene.d.ts","sourceRoot":"","sources":["../../src/tools/author-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAe7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAevE;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,kBAAkB,GAAG,SAAS,GACnC,IAAI,CA0HN"}
+{"version":3,"file":"author-scene.d.ts","sourceRoot":"","sources":["../../src/tools/author-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE7D,OAAO,EAML,KAAK,iBAAiB,EAGvB,MAAM,mCAAmC,CAAA;AAY1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAmB,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAoC7F;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,MAAM,CAAC,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,IAAI,CAkMN"}