@pascal-app/mcp 1.1.0 → 1.1.2

package/dist/server.d.ts

@@ -46,6 +46,8 @@ export type CreatePascalMcpServerOptions = {
     sceneViews?: SceneViewHost;
     /** Reads catalog items' pictures and surfaces before view_assets and paint. */
     assetViews?: PlanReadingHosts['assetViews'];
+    /** A pause between the steps of a long call, for a host with a scene of its own per request. */
+    betweenSteps?: PlanReadingHosts['betweenSteps'];
     /** Lines the host adds to what a client reads at connect (the person's own settings). */
     instructions?: string;
 };

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAKV,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAG7B,MAAM,mCAAmC,CAAA;AAE1C,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;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAKzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIvD,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAC/B,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAErB,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;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,kBAAkB,CAAA;IACpC,kGAAkG;IAClG,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IAChC,yFAAyF;IACzF,KAAK,CAAC,EAAE,uBAAuB,CAAA;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,4FAA4F;IAC5F,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAA;IAC3C,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,4BAA4B,GAAG,SAAS,CA8BnF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAKV,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAG7B,MAAM,mCAAmC,CAAA;AAE1C,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;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAKzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIvD,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAC/B,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAErB,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;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,kBAAkB,CAAA;IACpC,kGAAkG;IAClG,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IAChC,yFAAyF;IACzF,KAAK,CAAC,EAAE,uBAAuB,CAAA;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,4FAA4F;IAC5F,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAA;IAC3C,gGAAgG;IAChG,YAAY,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAA;IAC/C,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,4BAA4B,GAAG,SAAS,CA+BnF"}

package/dist/server.js

@@ -29,6 +29,7 @@ export function createPascalMcpServer(opts) {
         readFile: opts.readFile,
         sceneViews: opts.sceneViews,
         assetViews: opts.assetViews,
+        betweenSteps: opts.betweenSteps,
     });
     registerVisionTools(server, operations);
     if (opts.services)

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

@@ -7,7 +7,8 @@ import { type GeometryScriptHost, type ObjectMakerHost } from './add-object.js';
  * 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.
+ * Pascal's checks run, and the gate report answered. The checks take seconds on a large building:
+ * a host that gives `betweenSteps` is awaited between them, as in verify_scene.
  */
-export declare function registerAuthorScene(server: McpServer, bridge: SceneOperations, host: GeometryScriptHost | undefined, makers?: ObjectMakerHost, readFile?: ProjectFileReader): void;
+export declare function registerAuthorScene(server: McpServer, bridge: SceneOperations, host: GeometryScriptHost | undefined, makers?: ObjectMakerHost, readFile?: ProjectFileReader, betweenSteps?: () => Promise<void>): 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,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"}
+{"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,EAOL,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;;;;;;;GAOG;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,EAC5B,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACjC,IAAI,CAqMN"}

package/dist/tools/author-scene.js

@@ -1,5 +1,5 @@
 import { filterDerivedNodeWrites } from '@pascal-app/core';
-import { achievedChanges, authorSceneChecks, verifyScene, } from '@pascal-app/core/agent-operations';
+import { achievedChanges, authorSceneChecks, inOneGo, verifySceneSteps, } from '@pascal-app/core/agent-operations';
 import { authorScenePayload, authorSceneTool, isAgentRefusal, refuse, surfaceDescription, } from '@pascal-app/core/agent-tools';
 import { GEOMETRY_SCRIPT_MIME_TYPES } from '@pascal-app/core/schema';
 import { compileAuthorScene } from '@pascal-app/geometry-script/author-scene';
@@ -8,7 +8,7 @@ import { compileAndStore } 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 { toPatches } from './shared-tools.js';
+import { pausedBetweenSteps, toPatches } from './shared-tools.js';
 /** The largest payload file read: a house with its modules inline runs to a few MiB. */
 const PAYLOAD_FILE_MAX_BYTES = 32 * 1024 * 1024;
 /** Payload keys holding a module's text; stored as `<key>Script`, the script's hash. */
@@ -18,9 +18,10 @@ const CODE_KEYS = new Set(['code', 'floorCode', 'wallCode']);
  * 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.
+ * Pascal's checks run, and the gate report answered. The checks take seconds on a large building:
+ * a host that gives `betweenSteps` is awaited between them, as in verify_scene.
  */
-export function registerAuthorScene(server, bridge, host, makers, readFile) {
+export function registerAuthorScene(server, bridge, host, makers, readFile, betweenSteps) {
     server.registerTool(authorSceneTool.name, {
         title: authorSceneTool.title,
         description: surfaceDescription(authorSceneTool, 'mcp'),
@@ -141,9 +142,10 @@ export function registerAuthorScene(server, bridge, host, makers, readFile) {
         const patches = toPatches(filterDerivedNodeWrites(bridge.getNodes(), outcome.changes));
         if (patches.length)
             bridge.applyPatch(patches);
-        const verified = verifyScene(bridge.getNodes(), undefined, {
+        const checking = verifySceneSteps(bridge.getNodes(), undefined, {
             activeLevelId: null,
-        }).result;
+        });
+        const verified = (betweenSteps ? await pausedBetweenSteps(checking, betweenSteps) : inOneGo(checking)).result;
         const byType = new Map();
         for (const issue of verified.issues)
             byType.set(issue.type ?? 'unknown', (byType.get(issue.type ?? 'unknown') ?? 0) + 1);

package/dist/tools/index.d.ts

@@ -23,5 +23,5 @@ export type ToolHosts = PlanReadingHosts & {
     readFile?: ProjectFileReader;
     sceneViews?: SceneViewHost;
 };
-export declare function registerTools(server: McpServer, operations: SceneOperations, { catalog, geometryScripts, objectMakers, readFile, sceneViews, assetViews }?: ToolHosts): void;
+export declare function registerTools(server: McpServer, operations: SceneOperations, { catalog, geometryScripts, objectMakers, readFile, sceneViews, assetViews, betweenSteps, }?: ToolHosts): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAGrB,MAAM,cAAc,CAAA;AAErB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAcnD,OAAO,EAAE,KAAK,gBAAgB,EAAuB,MAAM,gBAAgB,CAAA;AAI3E,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAEpE;;;;;;;GAOG;AACH,gFAAgF;AAChF,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG;IACzC,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,eAAe,CAAC,EAAE,kBAAkB,CAAA;IACpC,gGAAgG;IAChG,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,UAAU,CAAC,EAAE,aAAa,CAAA;CAC3B,CAAA;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,eAAe,EAC3B,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,GAAE,SAAc,GAC3F,IAAI,CA4BN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAGrB,MAAM,cAAc,CAAA;AAErB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAcnD,OAAO,EAAE,KAAK,gBAAgB,EAAuB,MAAM,gBAAgB,CAAA;AAI3E,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAEpE;;;;;;;GAOG;AACH,gFAAgF;AAChF,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG;IACzC,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,eAAe,CAAC,EAAE,kBAAkB,CAAA;IACpC,gGAAgG;IAChG,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,UAAU,CAAC,EAAE,aAAa,CAAA;CAC3B,CAAA;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,eAAe,EAC3B,EACE,OAAO,EACP,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,YAAY,GACb,GAAE,SAAc,GAChB,IAAI,CA6BN"}

package/dist/tools/index.js

@@ -19,15 +19,16 @@ import { registerTemplateTools } from './templates/index.js';
 import { registerUndo } from './undo.js';
 import { registerVariantTools } from './variants/index.js';
 import { registerViewScene } from './view-scene.js';
-export function registerTools(server, operations, { catalog, geometryScripts, objectMakers, readFile, sceneViews, assetViews } = {}) {
+export function registerTools(server, operations, { catalog, geometryScripts, objectMakers, readFile, sceneViews, assetViews, betweenSteps, } = {}) {
     registerGetScene(server, operations);
     registerSharedTools(server, operations, catalog, {
         assetViews,
+        betweenSteps,
         buildObject: (input) => compileObjectOnHost(geometryScripts, operations, input),
     });
     registerAddColumn(server, operations, geometryScripts);
     registerAddObject(server, operations, geometryScripts, objectMakers);
-    registerAuthorScene(server, operations, geometryScripts, objectMakers, readFile);
+    registerAuthorScene(server, operations, geometryScripts, objectMakers, readFile, betweenSteps);
     registerGetSource(server, operations, geometryScripts);
     registerMeasure(server, operations);
     registerViewScene(server, operations, sceneViews);

package/dist/tools/shared-tools.d.ts

@@ -1,5 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/server';
-import { type AddObjectInput, type AgentHostRuntime, type AgentOperation, type AssetViewLoader, type SceneChanges } from '@pascal-app/core/agent-operations';
+import { type AddObjectInput, type AgentHostRuntime, type AgentOperation, type AssetViewLoader, type SceneChanges, type Steps } from '@pascal-app/core/agent-operations';
 import { type AgentToolAnnotations, type AgentToolContract, type DesignBrief } from '@pascal-app/core/agent-tools';
 import { type CompiledGeometryScript } from '@pascal-app/core/schema';
 import { z } from 'zod';
@@ -24,11 +24,21 @@ export type PlanReadingHosts = {
     assetViews?: AssetViewLoader;
     /** Compiles one add_object module for a batch before the synchronous operations run. */
     buildObject?: (input: Omit<AddObjectInput, 'compiled'>) => Promise<CompiledGeometryScript>;
+    /**
+     * Awaited between the steps of a call that takes seconds on a large building (after each call of
+     * a run_batch, after each check of a verify_scene, author_scene's closing one included), so the
+     * host's timers and I/O run meanwhile. Only for a host whose scene no other call can reach then
+     * (a bridge of its own for each request): a batch is planned on the scene as its first call
+     * found it and applied after its last. Without it these calls run uninterrupted.
+     */
+    betweenSteps?: () => Promise<void>;
 };
 export declare function toPatches(changes: SceneChanges): Patch[];
 /** How an outcome reaches this bridge: its patches, its derived construction, its session record. */
 export declare function agentRuntime(bridge: SceneOperations): AgentHostRuntime;
 export declare function briefInForce(bridge: SceneOperations): DesignBrief | null | undefined;
+/** Work one step at a time, the host's pause after each; `scope` is where each step runs. */
+export declare function pausedBetweenSteps<Result>(steps: Steps<Result>, pause: () => Promise<void>, scope?: (step: () => IteratorResult<void, Result>) => IteratorResult<void, Result>): Promise<Result>;
 export declare function registerSharedTools(server: McpServer, bridge: SceneOperations, catalog?: AssetCatalog, hosts?: PlanReadingHosts): void;
 /**
  * Registers one operation tool, as the shared tools are: a host adds a plugin's `'operation'`

package/dist/tools/shared-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-tools.d.ts","sourceRoot":"","sources":["../../src/tools/shared-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EASpB,KAAK,YAAY,EAGlB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAUtB,KAAK,WAAW,EAyCjB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EAGL,KAAK,sBAAsB,EAI5B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAMpD,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,iBAAiB,CAAA;AAUnE;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,SAAS,EAAE,cAAc,CAAA;IACzB,WAAW,EAAE,oBAAoB,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChE,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wEAAwE;IACxE,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,wFAAwF;IACxF,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;CAC3F,CAAA;AAoeD,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,CAmBxD;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAyBtE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAIpF;AA+CD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,YAA6B,EACtC,KAAK,GAAE,gBAAqB,GAC3B,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,YAA6B,EACtC,KAAK,GAAE,gBAAqB,GAC3B,IAAI,CAwIN"}
+{"version":3,"file":"shared-tools.d.ts","sourceRoot":"","sources":["../../src/tools/shared-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EACL,KAAK,cAAc,EAInB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EASpB,KAAK,YAAY,EACjB,KAAK,KAAK,EAGX,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAUtB,KAAK,WAAW,EAyCjB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EAGL,KAAK,sBAAsB,EAI5B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAMpD,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,iBAAiB,CAAA;AAUnE;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,SAAS,EAAE,cAAc,CAAA;IACzB,WAAW,EAAE,oBAAoB,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChE,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wEAAwE;IACxE,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,wFAAwF;IACxF,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAC1F;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC,CAAA;AAoeD,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,CAmBxD;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAyBtE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAIpF;AAuDD,6FAA6F;AAC7F,wBAAsB,kBAAkB,CAAC,MAAM,EAC7C,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EACpB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC1B,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,cAAc,CAAC,IAAI,EAAE,MAAM,CACxE,GACP,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,YAA6B,EACtC,KAAK,GAAE,gBAAqB,GAC3B,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,YAA6B,EACtC,KAAK,GAAE,gBAAqB,GAC3B,IAAI,CAmJN"}

package/dist/tools/shared-tools.js

@@ -1,4 +1,4 @@
-import { AGENT_OPERATIONS, achievedChanges, applyAgentOutcome, assetViewNeeds, buildBatchObjects, createAssetViewLoader, createFetchAssetViewIO, furnishingRefusal, readCatalog, startOfSession, writeCollections, } from '@pascal-app/core/agent-operations';
+import { AGENT_OPERATION_STEPS, AGENT_OPERATIONS, achievedChanges, applyAgentOutcome, assetViewNeeds, buildBatchObjects, createAssetViewLoader, createFetchAssetViewIO, furnishingRefusal, readCatalog, startOfSession, writeCollections, } from '@pascal-app/core/agent-operations';
 import { addCornerWindowTool, addFenceTool, addLevelTool, addObjectTool, addWallTool, createRoofTool, createRoomTool, createStairTool, createUnitTool, deleteNodeTool, designBriefTool, duplicateLevelTool, duplicateNodeOutput, duplicateNodeTool, findByTypeTool, fitStairTool, furnishRoomTool, getLevelSummaryTool, getNodeTool, getSiteTool, getWallsTool, getZonesTool, isAgentRefusal, listLevelsTool, listUnitsTool, measureStairTool, mergeWindowsTool, moveNodeOutput, moveNodeTool, moveRoofsToRoofLevelTool, paintTool, placeBuildingTool, placeDesignTool, placeInRoomTool, placeItemsTool, ROOM_TOOL_CONTRACTS, refuse, runBatchTool, searchAssetsTool, searchMaterialsTool, setCheckpointTool, setGroundLevelTool, setUnitMembersTool, setWallTypeTool, surfaceDescription, validateDesignTool, verifySceneModelResult, verifySceneTool, viewAssetsTool, } from '@pascal-app/core/agent-tools';
 import { DesignValidationSchema } from '@pascal-app/core/procedural-items';
 import { untracked } from '@pascal-app/core/runtime';
@@ -523,8 +523,9 @@ function writesScene(changes) {
             (changes.collections && Object.keys(changes.collections).length)));
 }
 /**
- * search_assets as the model reads it: each item's id, name and placement facts; the category
- * and the floor's null attachTo stay in the structured result.
+ * search_assets as the model reads it: each item's id, name and placement facts, and the params
+ * of one built from a script (add_object changes them once placed); the category and the floor's
+ * null attachTo stay in the structured result.
  */
 function searchAssetsModelResult(output) {
     const groups = output.groups;
@@ -532,11 +533,12 @@ function searchAssetsModelResult(output) {
         ...output,
         groups: groups.map((group) => ({
             ...group,
-            results: group.results.map(({ id, name, dimensions, attachTo }) => ({
+            results: group.results.map(({ id, name, dimensions, attachTo, params }) => ({
                 id,
                 name,
                 dimensions,
                 ...(attachTo && { attachTo }),
+                ...(params && { params }),
             })),
         })),
     };
@@ -553,6 +555,15 @@ function modelResult(name, output, input) {
         return searchAssetsModelResult(output);
     return output;
 }
+/** Work one step at a time, the host's pause after each; `scope` is where each step runs. */
+export async function pausedBetweenSteps(steps, pause, scope = (step) => step()) {
+    for (;;) {
+        const step = scope(() => steps.next());
+        if (step.done)
+            return step.value;
+        await pause();
+    }
+}
 export function registerSharedTools(server, bridge, catalog = builtInCatalog, hosts = {}) {
     for (const tool of SHARED_TOOLS)
         registerOperationTool(server, bridge, tool, catalog, hosts);
@@ -627,7 +638,13 @@ export function registerOperationTool(server, bridge, tool, catalog = builtInCat
                 pictures: needs.pictures,
             });
         try {
-            outcome = inScene(bridge, () => tool.operation(nodes, input, context));
+            const steps = hosts.betweenSteps && Object.hasOwn(AGENT_OPERATION_STEPS, tool.contract.name)
+                ? AGENT_OPERATION_STEPS[tool.contract.name]
+                : undefined;
+            outcome =
+                steps && hosts.betweenSteps
+                    ? await pausedBetweenSteps(steps(nodes, input, context), hosts.betweenSteps, (step) => inScene(bridge, step))
+                    : inScene(bridge, () => tool.operation(nodes, input, context));
         }
         catch (error) {
             // A refusal can ask the session to remember what it refused (a catalog piece under an open source).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pascal-app/mcp",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Model Context Protocol server for Pascal 3D editor",
   "mcpName": "app.pascal/editor",
   "type": "module",
@@ -62,19 +62,19 @@
     "prepublishOnly": "bun run build && bun test && bun run smoke:node"
   },
   "peerDependencies": {
-    "@pascal-app/core": "^1.1.0"
+    "@pascal-app/core": "^1.1.2"
   },
   "dependencies": {
     "@hono/node-server": "^2.1.6",
     "@modelcontextprotocol/node": "^2.1.2",
     "@modelcontextprotocol/server": "^2.4.0",
-    "@pascal-app/geometry-script": "^1.1.0",
+    "@pascal-app/geometry-script": "^1.1.2",
     "@pascal-app/lingo": "^0.5.0",
     "zod": ">=4.6.7 <4.7"
   },
   "devDependencies": {
     "@modelcontextprotocol/client": "^2.4.0",
-    "@pascal-app/core": "^1.1.0",
+    "@pascal-app/core": "^1.1.2",
     "@pascal/typescript-config": "*",
     "@types/node": "^26.6.6",
     "typescript": "7.0.2"