@pascal-app/mcp 1.0.1 → 1.0.4

package/dist/tools/scene-lifecycle/create-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKvD,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;CAsB/B,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAiD1F"}
+{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKvD,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;CAsB/B,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA4E1F"}

package/dist/tools/scene-lifecycle/create-project.js

@@ -42,6 +42,7 @@ export function registerCreateProject(server, operations) {
             throwMcpError(ErrorCode.InvalidRequest, 'create_project_unavailable: this MCP store cannot create hosted projects');
         }
         try {
+            const bound = operations.getActiveScene();
             const status = await operations.createProject({
                 name,
                 ...(id !== undefined ? { id } : {}),
@@ -55,8 +56,32 @@ export function registerCreateProject(server, operations) {
                 thumbnailUrl: status.thumbnailUrl,
                 version: status.version,
             });
+            // A session bound to another project starts the new one empty: carried over, that
+            // project's scene was saved into the new one. Work bound to no project, a saved scene of
+            // none included, is kept: it is what the new project is for. Emptied once bound to the new
+            // project, so nothing that follows the scene can write the empty scene to the old one.
+            if (bound?.projectId && bound.projectId !== status.projectId) {
+                operations.loadJSON({ nodes: {}, rootNodeIds: [] });
+                operations.loadDefault();
+                operations.clearHistory();
+            }
+            // A scene from the first call: its first draft is what this session holds (the empty
+            // scene, or the unbound work it was made for), so any session can load it at once. Unsaved,
+            // another session's load_scene answered scene_not_found until a first save.
+            operations.setActiveScene(await operations.saveScene({
+                id: status.id,
+                name: status.name,
+                projectId: status.projectId,
+                ownerId: status.ownerId,
+                thumbnailUrl: status.thumbnailUrl,
+                graph: operations.exportSceneGraph(),
+                saveMode: 'draft',
+                publish: false,
+                operation: 'create_project',
+            }));
+            const saved = (await operations.getProjectStatus(status.id)) ?? status;
             const payload = {
-                ...projectStatusPayload(status, 'The project is now bound to this MCP session. Open editorUrl now; semantic tools will update the browser-visible draft. Call save_scene with saveMode: "checkpoint" only when you want a meaningful version.'),
+                ...projectStatusPayload(saved, 'The project is now bound to this MCP session. Open editorUrl now; semantic tools will update the browser-visible draft. Call save_scene with saveMode: "checkpoint" only when you want a meaningful version.'),
                 ...currentLevelContext(operations),
             };
             return {

package/dist/tools/scene-lifecycle/delete-scene.d.ts

@@ -7,6 +7,8 @@ export declare const deleteSceneInput: {
 };
 export declare const deleteSceneOutput: {
     deleted: z.ZodBoolean;
+    hidden: z.ZodBoolean;
+    message: z.ZodOptional<z.ZodString>;
 };
 export declare function registerDeleteScene(server: McpServer, operations: SceneOperations): void;
 //# sourceMappingURL=delete-scene.d.ts.map

package/dist/tools/scene-lifecycle/delete-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/delete-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKvD,eAAO,MAAM,gBAAgB;;;CAG5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;CAE7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAoCxF"}
+{"version":3,"file":"delete-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/delete-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKvD,eAAO,MAAM,gBAAgB;;;CAG5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAmCxF"}

package/dist/tools/scene-lifecycle/delete-scene.js

@@ -8,20 +8,21 @@ export const deleteSceneInput = {
 };
 export const deleteSceneOutput = {
     deleted: z.boolean(),
+    hidden: z.boolean(),
+    message: z.string().optional(),
 };
 export function registerDeleteScene(server, operations) {
     server.registerTool('delete_scene', {
         title: 'Delete scene',
-        description: 'Delete a scene from the SceneStore by id. Optionally pass `expectedVersion` for optimistic concurrency.',
+        description: "Remove a stored scene by id. In Pascal this never deletes the project: it hides it from Pascal's public listings until it is next saved with content, and answers `deleted: false, hidden: true` with a message; its owner can delete it from the projects page. Only someone who can manage the project may hide it. A local scene store deletes the scene. Optionally pass `expectedVersion` for optimistic concurrency.",
         inputSchema: deleteSceneInput,
         outputSchema: deleteSceneOutput,
         annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id, expectedVersion }) => {
         try {
-            const deleted = await operations.deleteStoredScene(id, {
+            const payload = await operations.deleteStoredScene(id, {
                 ...(expectedVersion !== undefined ? { expectedVersion } : {}),
             });
-            const payload = { deleted };
             return {
                 content: [{ type: 'text', text: JSON.stringify(payload) }],
                 structuredContent: payload,

package/dist/tools/scene-lifecycle/save-scene.d.ts

@@ -6,6 +6,7 @@ export declare const saveSceneInput: {
     name: z.ZodString;
     projectId: z.ZodOptional<z.ZodString>;
     expectedVersion: z.ZodOptional<z.ZodNumber>;
+    replace: z.ZodOptional<z.ZodBoolean>;
     saveMode: z.ZodDefault<z.ZodEnum<{
         draft: "draft";
         checkpoint: "checkpoint";

package/dist/tools/scene-lifecycle/save-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"save-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/save-scene.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,kBAAkB,CAAA;AAOvD,eAAO,MAAM,cAAc;;;;;;;;;;;;;CA0B1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAkGlF"}
+{"version":3,"file":"save-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/save-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAIxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAOvD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAkC1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA;AAgCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgHlF"}

package/dist/tools/scene-lifecycle/save-scene.js

@@ -1,3 +1,4 @@
+import { migrateLegacyWallAssemblies } from '@pascal-app/core/scene-migrations';
 import { AnyNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
 import { SceneVersionConflictError } from '../../storage/types.js';
@@ -10,14 +11,18 @@ export const saveSceneInput = {
     name: z.string().min(1).max(200),
     projectId: z.string().optional(),
     expectedVersion: z.number().int().positive().optional(),
+    replace: z
+        .boolean()
+        .optional()
+        .describe("Write this session's scene over a project or scene it was not loaded from, replacing what that one holds."),
     saveMode: z
         .enum(['draft', 'checkpoint'])
         .default('draft')
-        .describe('`draft` updates the browser-visible working model without polluting version history. `checkpoint` creates a meaningful saved version.'),
+        .describe('`draft` updates the browser-visible working model without polluting version history. `checkpoint` creates a meaningful saved version; it does not publish.'),
     publish: z
         .boolean()
         .optional()
-        .describe('For checkpoint saves, publish the checkpoint as the browser-visible version.'),
+        .describe("Hosted Pascal: also publish this checkpoint, making it the version the project's viewers see. Only when the user asks to publish."),
     thumbnail: z.string().url().optional(),
     includeCurrentScene: z
         .boolean()
@@ -48,15 +53,49 @@ export const saveSceneOutput = {
     levelIds: z.array(z.string()),
     defaultLevelId: z.string().nullable(),
 };
+/** A saved scene that is more than the default site, building and level. */
+const HOLDS_CONTENT = 3;
+/**
+ * The session's scene goes over a project or scene only when it was loaded from it (or created
+ * for it). After a server reload a session starts over on a blank scene, and saving it by id wrote
+ * it over the project's draft (2026-10-03: 8 levels and 10 imported plans lost).
+ */
+async function requireSceneLoadedFrom(bridge, target) {
+    if (target.id === undefined && target.projectId === undefined)
+        return;
+    const active = bridge.getActiveScene();
+    if (target.id !== undefined ? active?.id === target.id : active?.projectId === target.projectId)
+        return;
+    const nodeCount = target.projectId !== undefined && bridge.canGetProjectStatus
+        ? ((await bridge.getProjectStatus(target.projectId))?.nodeCount ?? 0)
+        : target.id !== undefined
+            ? Object.keys((await bridge.loadStoredScene(target.id))?.graph.nodes ?? {}).length
+            : 0;
+    if (nodeCount <= HOLDS_CONTENT)
+        return;
+    throwMcpError(ErrorCode.InvalidRequest, `scene_not_loaded: this session's scene was not loaded from ${target.projectId ?? target.id}, which holds ${nodeCount} nodes — the server may have reloaded and this session started over. Call load_scene with it first, or pass replace: true to write this scene over it.`, { ...target, nodeCount });
+}
 export function registerSaveScene(server, bridge) {
     server.registerTool('save_scene', {
         title: 'Save scene',
-        description: 'Save the current scene (or a provided graph) to the SceneStore. Defaults to a browser-visible draft save so agents can iterate without creating many project versions. Use saveMode: "checkpoint" for meaningful version history.',
+        description: 'Save the current scene (or a provided graph) to the SceneStore. Without id or projectId it saves to the project this session is bound to (create_project or load_scene). Defaults to a browser-visible draft save so agents can iterate without creating many project versions. Use saveMode: "checkpoint" for meaningful version history.',
         inputSchema: saveSceneInput,
         outputSchema: saveSceneOutput,
         annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
-    }, async ({ id, name, projectId, expectedVersion, saveMode, publish, thumbnail, includeCurrentScene, graph, }) => {
+    }, async ({ id, name, projectId, expectedVersion, saveMode, publish, thumbnail, includeCurrentScene, graph, replace, }) => {
+        // Without a target, the session's scene goes where it came from (create_project, load_scene,
+        // an earlier save). An agent was refused "Call create_project first" on its first save, right
+        // after create_project bound the session to its project.
+        const bound = includeCurrentScene && id === undefined && projectId === undefined
+            ? bridge.getActiveScene()
+            : null;
+        if (bound) {
+            id = bound.id;
+            projectId = bound.projectId ?? undefined;
+        }
         let sceneGraph;
+        if (includeCurrentScene && !replace)
+            await requireSceneLoadedFrom(bridge, { id, projectId });
         if (includeCurrentScene) {
             const validation = bridge.validateScene();
             if (!validation.valid) {
@@ -75,8 +114,9 @@ export function registerSaveScene(server, bridge) {
             if (!rawNodes || typeof rawNodes !== 'object') {
                 throwMcpError(ErrorCode.InvalidParams, 'graph.nodes must be an object');
             }
+            const migration = migrateLegacyWallAssemblies(rawNodes);
             const errors = [];
-            for (const [nodeId, node] of Object.entries(rawNodes)) {
+            for (const [nodeId, node] of Object.entries(migration.nodes)) {
                 const res = AnyNode.safeParse(node);
                 if (!res.success) {
                     for (const issue of res.error.issues) {
@@ -91,7 +131,7 @@ export function registerSaveScene(server, bridge) {
             if (errors.length > 0) {
                 throwMcpError(ErrorCode.InvalidParams, 'graph_invalid', { errors });
             }
-            sceneGraph = graph;
+            sceneGraph = { ...graph, nodes: migration.nodes };
         }
         try {
             const meta = await bridge.saveScene({

package/dist/tools/scene-lifecycle/test-utils.d.ts

@@ -1,6 +1,6 @@
 import { SceneBridge } from '../../bridge/scene-bridge.js';
 import { type SceneOperations } from '../../operations/index.js';
-import { type ProjectCreateOptions, type ProjectStatus, type SceneEvent, type SceneEventAppendOptions, type SceneEventListOptions, type SceneListOptions, type SceneMeta, type SceneMutateOptions, type SceneSaveOptions, type SceneStore, type SceneWithGraph } from '../../storage/types.js';
+import { type ProjectCreateOptions, type ProjectStatus, type SceneDeleteResult, type SceneEvent, type SceneEventAppendOptions, type SceneEventListOptions, type SceneListOptions, type SceneMeta, type SceneMutateOptions, type SceneSaveOptions, type SceneStore, type SceneWithGraph } from '../../storage/types.js';
 export type StoredTextContent = {
     type: string;
     text: string;
@@ -32,7 +32,7 @@ export declare class InMemorySceneStore implements SceneStore {
     save(opts: SceneSaveOptions): Promise<SceneMeta>;
     load(id: string): Promise<SceneWithGraph | null>;
     list(opts?: SceneListOptions): Promise<SceneMeta[]>;
-    delete(id: string, opts?: SceneMutateOptions): Promise<boolean>;
+    delete(id: string, opts?: SceneMutateOptions): Promise<SceneDeleteResult>;
     rename(id: string, newName: string, opts?: SceneMutateOptions): Promise<SceneMeta>;
     appendSceneEvent(opts: SceneEventAppendOptions): Promise<SceneEvent>;
     listSceneEvents(sceneId: string, opts?: SceneEventListOptions): Promise<SceneEvent[]>;

package/dist/tools/scene-lifecycle/test-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC9E,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEf,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAA;AAG5B,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9D,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC3B,GAAG;IACF,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,kBAAkB,CAAA;IACzB,UAAU,EAAE,eAAe,CAAA;CAC5B,CAKA;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAWtB;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,YAAY,CAAI;IAElB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAejE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK3D,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IA+DhD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAShD,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAanD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAW/D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAmBlF,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAapE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAU3F,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,MAAM;IAoBd,OAAO,CAAC,eAAe;CA0BxB"}
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC9E,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEf,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAA;AAG5B,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9D,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC3B,GAAG;IACF,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,kBAAkB,CAAA;IACzB,UAAU,EAAE,eAAe,CAAA;CAC5B,CAKA;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAWtB;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,YAAY,CAAI;IAElB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAejE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK3D,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IA+DhD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAShD,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAanD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAYzE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAmBlF,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAapE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAU3F,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,MAAM;IAoBd,OAAO,CAAC,eAAe;CA0BxB"}

package/dist/tools/scene-lifecycle/test-utils.js

@@ -130,7 +130,8 @@ export class InMemorySceneStore {
         if (opts?.expectedVersion !== undefined && rec.version !== opts.expectedVersion) {
             throw new SceneVersionConflictError(`Expected version ${opts.expectedVersion}, have ${rec.version}`);
         }
-        return this.data.delete(id);
+        this.data.delete(id);
+        return { deleted: true, hidden: false };
     }
     async rename(id, newName, opts) {
         const rec = this.data.get(id);

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

@@ -6,6 +6,8 @@ export declare const setUnitMembersInput: {
     memberZoneIds: z.ZodArray<z.ZodString>;
 };
 export declare const setUnitMembersOutput: {
+    project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unsaved: z.ZodOptional<z.ZodString>;
     persistence: z.ZodOptional<z.ZodObject<{
         status: z.ZodEnum<{
             unbound: "unbound";

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

@@ -1 +1 @@
-{"version":3,"file":"set-unit-members.d.ts","sourceRoot":"","sources":["../../src/tools/set-unit-members.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAOpD,eAAO,MAAM,mBAAmB;;;CAG/B,CAAA;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;CAIhC,CAAA;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgCvF"}
+{"version":3,"file":"set-unit-members.d.ts","sourceRoot":"","sources":["../../src/tools/set-unit-members.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAOpD,eAAO,MAAM,mBAAmB;;;CAG/B,CAAA;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAIhC,CAAA;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgCvF"}

package/dist/tools/set-zone.d.ts

@@ -8,6 +8,8 @@ export declare const setZoneInput: {
     properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 };
 export declare const setZoneOutput: {
+    project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unsaved: z.ZodOptional<z.ZodString>;
     persistence: z.ZodOptional<z.ZodObject<{
         status: z.ZodEnum<{
             unbound: "unbound";

package/dist/tools/set-zone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set-zone.d.ts","sourceRoot":"","sources":["../../src/tools/set-zone.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;AAMpD,eAAO,MAAM,YAAY;;;;;CAKxB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;CAGzB,CAAA;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiDhF"}
+{"version":3,"file":"set-zone.d.ts","sourceRoot":"","sources":["../../src/tools/set-zone.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;AAMpD,eAAO,MAAM,YAAY;;;;;CAKxB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;CAGzB,CAAA;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiDhF"}

package/dist/tools/set-zone.js

@@ -1,4 +1,4 @@
-import { ZoneNode } from '@pascal-app/core/schema';
+import { newZone } from '@pascal-app/core';
 import { z } from 'zod';
 import { ADDITIVE_TOOL_ANNOTATIONS } from './annotations.js';
 import { ErrorCode, throwMcpError } from './errors.js';
@@ -35,7 +35,7 @@ export function registerSetZone(server, bridge) {
             parent.metadata.role === 'roof') {
             throwMcpError(ErrorCode.InvalidParams, `Roof support level ${levelId} is not an occupied story; create zones on an occupied level instead`);
         }
-        const zone = ZoneNode.parse({
+        const zone = newZone({
             name: label,
             polygon: polygon,
             metadata: properties ?? {},

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

@@ -0,0 +1,30 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type AgentOperation, type SceneChanges } from '@pascal-app/core/agent-operations';
+import { type AgentToolAnnotations, type AgentToolContract } from '@pascal-app/core/agent-tools';
+import { z } from 'zod';
+import type { Patch } from '../bridge/scene-bridge.js';
+import type { SceneOperations } from '../operations/index.js';
+import { type AssetCatalog } from './asset-catalog.js';
+/**
+ * A tool the server runs as a core-style operation: parse with the contract, plan with the
+ * operation, apply its changes through the bridge in one history step, answer with what the scene
+ * then holds. `annotations` are the host's to choose from its own review of the operation; a
+ * plugin contract's `annotations` are only its hints.
+ */
+export type OperationTool = {
+    contract: AgentToolContract;
+    operation: AgentOperation;
+    annotations: AgentToolAnnotations;
+    outputSchema?: Record<string, z.ZodType>;
+    envelope?: (bridge: SceneOperations) => Record<string, unknown>;
+    /** Reads the host's item library: only these calls wait for it (the hosted one is a query). */
+    catalog?: true;
+};
+export declare function toPatches(changes: SceneChanges): Patch[];
+export declare function registerSharedTools(server: McpServer, bridge: SceneOperations, catalog?: AssetCatalog): void;
+/**
+ * Registers one operation tool, as the shared tools are: a host adds a plugin's `'operation'`
+ * tools with it, from the plugin's `./agent-tools` contract and `./agent-operations` operation.
+ */
+export declare function registerOperationTool(server: McpServer, bridge: SceneOperations, tool: OperationTool, catalog?: AssetCatalog): void;
+//# sourceMappingURL=shared-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared-tools.d.ts","sourceRoot":"","sources":["../../src/tools/shared-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAGL,KAAK,cAAc,EAGnB,KAAK,YAAY,EAElB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAsBvB,MAAM,8BAA8B,CAAA;AAOrC,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;AASnE;;;;;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;IAC/D,+FAA+F;IAC/F,OAAO,CAAC,EAAE,IAAI,CAAA;CACf,CAAA;AAmRD,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,CAmBxD;AAUD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,YAA6B,GACrC,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,YAA6B,GACrC,IAAI,CAkEN"}