@pascal-app/mcp 1.0.0-beta.6 → 1.0.1

package/dist/tools/scene-lifecycle/list-scenes.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { ErrorCode, throwMcpError } from '../errors';
+import { READ_ONLY_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, throwMcpError } from '../errors.js';
 const DEFAULT_LIMIT = 100;
 export const listScenesInput = {
     projectId: z.string().optional(),
@@ -29,6 +30,7 @@ export function registerListScenes(server, operations) {
         description: 'List scenes in the SceneStore. Optionally filter by `projectId` and cap results with `limit` (default 100).',
         inputSchema: listScenesInput,
         outputSchema: listScenesOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ projectId, limit }) => {
         try {
             const scenes = await operations.listScenes({

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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 export declare const loadSceneInput: {
     id: z.ZodString;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"load-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/load-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;AAIvD,eAAO,MAAM,cAAc;;CAE1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgClF"}
+{"version":3,"file":"load-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/load-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,cAAc;;CAE1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiClF"}

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

@@ -1,6 +1,7 @@
 import { z } from 'zod';
-import { ErrorCode, throwMcpError } from '../errors';
-import { currentLevelContext, sceneMetaPayload } from './metadata';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, throwMcpError } from '../errors.js';
+import { currentLevelContext, sceneMetaPayload } from './metadata.js';
 export const loadSceneInput = {
     id: z.string().min(1).max(64),
 };
@@ -30,6 +31,7 @@ export function registerLoadScene(server, bridge) {
         description: 'Load a scene from the SceneStore into the bridge. Returns the scene metadata. Throws `scene_not_found` if the id does not exist.',
         inputSchema: loadSceneInput,
         outputSchema: loadSceneOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id }) => {
         const result = await bridge.loadStoredScene(id);
         if (!result) {

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

@@ -1,6 +1,6 @@
 import type { SceneGraph } from '@pascal-app/core/clone-scene-graph';
-import type { SceneOperations } from '../../operations';
-import type { ProjectStatus, SceneMeta } from '../../storage/types';
+import type { SceneOperations } from '../../operations/index.js';
+import type { ProjectStatus, SceneMeta } from '../../storage/types.js';
 export declare function computeGraphHash(graph: SceneGraph): string;
 export declare function editorUrlFor(meta: Pick<SceneMeta, 'id' | 'editorUrl' | 'url'>): string;
 export declare function sceneMetaPayload(meta: SceneMeta, graph?: SceneGraph): {
@@ -18,7 +18,7 @@ export declare function sceneMetaPayload(meta: SceneMeta, graph?: SceneGraph): {
     url: string;
     published: boolean;
     isDraft: boolean;
-    saveMode: import("../../storage").SceneSaveMode;
+    saveMode: import("../../storage/index.js").SceneSaveMode;
     graphHash: string | undefined;
 };
 export declare function projectStatusPayload(status: ProjectStatus, nextStep?: string): {

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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 export declare const renameSceneInput: {
     id: z.ZodString;
     newName: z.ZodString;

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

@@ -1 +1 @@
-{"version":3,"file":"rename-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/rename-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;AAIvD,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;CAW7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA8CxF"}
+{"version":3,"file":"rename-scene.d.ts","sourceRoot":"","sources":["../../../src/tools/scene-lifecycle/rename-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;;;;CAI5B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;CAW7B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CA+CxF"}

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

@@ -1,6 +1,7 @@
 import { z } from 'zod';
-import { SceneNotFoundError, SceneVersionConflictError } from '../../storage/types';
-import { ErrorCode, throwMcpError } from '../errors';
+import { SceneNotFoundError, SceneVersionConflictError } from '../../storage/types.js';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, throwMcpError } from '../errors.js';
 export const renameSceneInput = {
     id: z.string().min(1).max(64),
     newName: z.string().min(1).max(200),
@@ -24,6 +25,7 @@ export function registerRenameScene(server, operations) {
         description: 'Rename a scene in the SceneStore. Returns the updated SceneMeta. Optionally pass `expectedVersion` for optimistic concurrency.',
         inputSchema: renameSceneInput,
         outputSchema: renameSceneOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id, newName, expectedVersion }) => {
         try {
             const meta = await operations.renameStoredScene(id, newName, {

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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 export declare const saveSceneInput: {
     id: z.ZodOptional<z.ZodString>;
     name: z.ZodString;

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;AAMvD,eAAO,MAAM,cAAc;;;;;;;;;;;;;CA0B1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiGlF"}
+{"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"}

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

@@ -1,9 +1,10 @@
 import { AnyNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
-import { SceneVersionConflictError } from '../../storage/types';
-import { ErrorCode, throwMcpError } from '../errors';
-import { appendLiveSceneEvent } from '../live-sync';
-import { currentLevelContext, sceneMetaPayload } from './metadata';
+import { SceneVersionConflictError } from '../../storage/types.js';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, throwMcpError } from '../errors.js';
+import { appendLiveSceneEvent } from '../live-sync.js';
+import { currentLevelContext, sceneMetaPayload } from './metadata.js';
 export const saveSceneInput = {
     id: z.string().min(1).max(64).optional(),
     name: z.string().min(1).max(200),
@@ -53,6 +54,7 @@ export function registerSaveScene(server, bridge) {
         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.',
         inputSchema: saveSceneInput,
         outputSchema: saveSceneOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id, name, projectId, expectedVersion, saveMode, publish, thumbnail, includeCurrentScene, graph, }) => {
         let sceneGraph;
         if (includeCurrentScene) {

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

@@ -1,6 +1,6 @@
-import { SceneBridge } from '../../bridge/scene-bridge';
-import { type SceneOperations } from '../../operations';
-import { type ProjectCreateOptions, type ProjectStatus, type SceneListOptions, type SceneMeta, type SceneMutateOptions, type SceneSaveOptions, type SceneStore, type SceneWithGraph } from '../../storage/types';
+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';
 export type StoredTextContent = {
     type: string;
     text: string;
@@ -23,8 +23,10 @@ export declare class InMemorySceneStore implements SceneStore {
     readonly backend: "sqlite";
     private readonly data;
     private readonly projects;
+    private readonly events;
     private idCounter;
     private projectCounter;
+    private eventCounter;
     createProject(opts: ProjectCreateOptions): Promise<ProjectStatus>;
     getProjectStatus(id: string): Promise<ProjectStatus | null>;
     save(opts: SceneSaveOptions): Promise<SceneMeta>;
@@ -32,6 +34,8 @@ export declare class InMemorySceneStore implements SceneStore {
     list(opts?: SceneListOptions): Promise<SceneMeta[]>;
     delete(id: string, opts?: SceneMutateOptions): Promise<boolean>;
     rename(id: string, newName: string, opts?: SceneMutateOptions): Promise<SceneMeta>;
+    appendSceneEvent(opts: SceneEventAppendOptions): Promise<SceneEvent>;
+    listSceneEvents(sceneId: string, opts?: SceneEventListOptions): Promise<SceneEvent[]>;
     private touchProject;
     private toMeta;
     private toProjectStatus;

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,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,SAAS,CAAI;IACrB,OAAO,CAAC,cAAc,CAAI;IAEpB,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;IAmBxF,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,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"}

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

@@ -1,7 +1,7 @@
-import { SceneBridge } from '../../bridge/scene-bridge';
-import { createSceneOperations } from '../../operations';
-import { SceneNotFoundError, SceneVersionConflictError, } from '../../storage/types';
-import { computeGraphHash, editorUrlFor } from './metadata';
+import { SceneBridge } from '../../bridge/scene-bridge.js';
+import { createSceneOperations } from '../../operations/index.js';
+import { SceneNotFoundError, SceneVersionConflictError, } from '../../storage/types.js';
+import { computeGraphHash, editorUrlFor } from './metadata.js';
 export function parseToolText(content) {
     return JSON.parse(content[0].text);
 }
@@ -20,8 +20,10 @@ export class InMemorySceneStore {
     backend = 'sqlite';
     data = new Map();
     projects = new Map();
+    events = [];
     idCounter = 0;
     projectCounter = 0;
+    eventCounter = 0;
     async createProject(opts) {
         const id = opts.id ?? `project_${++this.projectCounter}`;
         const now = new Date().toISOString();
@@ -147,6 +149,28 @@ export class InMemorySceneStore {
         this.touchProject(id, newName, updated.updatedAt);
         return this.toMeta(updated);
     }
+    async appendSceneEvent(opts) {
+        const event = {
+            eventId: ++this.eventCounter,
+            sceneId: opts.sceneId,
+            version: opts.version,
+            kind: opts.kind,
+            createdAt: new Date().toISOString(),
+            graph: opts.graph,
+        };
+        this.events.push(event);
+        return event;
+    }
+    async listSceneEvents(sceneId, opts) {
+        let events = this.events.filter((event) => event.sceneId === sceneId);
+        const afterEventId = opts?.afterEventId;
+        if (afterEventId !== undefined) {
+            events = events.filter((event) => event.eventId > afterEventId);
+        }
+        if (opts?.limit !== undefined)
+            events = events.slice(0, opts.limit);
+        return events;
+    }
     touchProject(id, name, updatedAt) {
         const existing = this.projects.get(id);
         if (existing) {

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

@@ -1,7 +1,7 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { AnyNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
-import type { SceneOperations } from '../operations';
+import type { SceneOperations } from '../operations/index.js';
 export declare const levelScopedInput: {
     levelId: z.ZodOptional<z.ZodString>;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"scene-query.d.ts","sourceRoot":"","sources":["../../src/tools/scene-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAQxE,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,yBAAyB,CAAA;AAEjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAYpD,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAID,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;CAejC,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAA;AA8CD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACvC,MAAM,CAgBR;AAkWD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAyCnF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgBxF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmBjF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmBjF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiQpF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAMxF"}
+{"version":3,"file":"scene-query.d.ts","sourceRoot":"","sources":["../../src/tools/scene-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAQxE,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,yBAAyB,CAAA;AAEjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAapD,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAID,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;CAejC,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAA;AA8CD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACvC,MAAM,CAgBR;AAkWD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA0CnF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiBxF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAoBjF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAoBjF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAkQpF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAMxF"}

package/dist/tools/scene-query.js

@@ -1,9 +1,10 @@
 import { DEFAULT_LEVEL_HEIGHT, getStoredLevelHeight, getWallPlaneTop, resolveStairTotalRise, resolveWallEffectiveHeight, } from '@pascal-app/core';
 import { computeWallSlabSupport } from '@pascal-app/core/spatial-grid';
 import { z } from 'zod';
-import { distance2D, pointInPolygon, polygonArea, polygonContainsPolygon, wallLength, } from './geometry';
-import { layoutIssuesFromScene } from './layout-clearance';
-import { NodeIdSchema } from './schemas';
+import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
+import { distance2D, pointInPolygon, polygonArea, polygonContainsPolygon, wallLength, } from './geometry.js';
+import { layoutIssuesFromScene } from './layout-clearance.js';
+import { NodeIdSchema } from './schemas.js';
 export const levelScopedInput = {
     levelId: NodeIdSchema.optional(),
 };
@@ -393,6 +394,7 @@ export function registerListLevels(server, bridge) {
         description: 'List all levels in the current scene with ids, names, floor indices, and child counts.',
         inputSchema: {},
         outputSchema: listLevelsOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async () => {
         const activeScene = bridge.getActiveScene();
         const levels = getLevels(bridge).map((level) => {
@@ -430,6 +432,7 @@ export function registerGetLevelSummary(server, bridge) {
         description: 'Get a compact model-friendly summary of one level: counts plus walls, zones, slabs, ceilings, and items. Omit levelId to use the first level.',
         inputSchema: levelScopedInput,
         outputSchema: getLevelSummaryOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ levelId }) => {
         const resolved = getDefaultLevelId(bridge, levelId);
         if (!resolved)
@@ -443,6 +446,7 @@ export function registerGetWalls(server, bridge) {
         description: 'Get walls on a level with start/end coordinates, length, height, thickness, and child doors/windows. Omit levelId to use the first level.',
         inputSchema: levelScopedInput,
         outputSchema: getWallsOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ levelId }) => {
         const resolved = getDefaultLevelId(bridge, levelId);
         if (!resolved)
@@ -459,6 +463,7 @@ export function registerGetZones(server, bridge) {
         description: 'Get room/zone polygons on a level with names, colors, bounds, and approximate areas. Omit levelId to use the first level.',
         inputSchema: levelScopedInput,
         outputSchema: getZonesOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ levelId }) => {
         const resolved = getDefaultLevelId(bridge, levelId);
         if (!resolved)
@@ -475,6 +480,7 @@ export function registerVerifyScene(server, bridge) {
         description: 'High-level self-check after complex edits. Returns validation status, per-level room/content counts, empty levels, and practical layout issues.',
         inputSchema: {},
         outputSchema: verifySceneOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async () => {
         const validation = bridge.validateScene();
         const levels = getLevels(bridge).map((level) => {

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

@@ -0,0 +1,20 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import type { SceneOperations } from '../operations/index.js';
+export declare const setUnitMembersInput: {
+    unitId: z.ZodString;
+    memberZoneIds: z.ZodArray<z.ZodString>;
+};
+export declare const setUnitMembersOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
+    unitId: z.ZodString;
+    memberCount: z.ZodNumber;
+};
+export declare function registerSetUnitMembers(server: McpServer, bridge: SceneOperations): void;
+//# sourceMappingURL=set-unit-members.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/set-unit-members.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from './annotations.js';
+import { ErrorCode, throwMcpError } from './errors.js';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync.js';
+import { NodeIdSchema } from './schemas.js';
+import { validateUnitMembers } from './unit-members.js';
+export const setUnitMembersInput = {
+    unitId: NodeIdSchema,
+    memberZoneIds: z.array(NodeIdSchema),
+};
+export const setUnitMembersOutput = {
+    unitId: z.string(),
+    memberCount: z.number(),
+    ...liveSyncOutput,
+};
+export function registerSetUnitMembers(server, bridge) {
+    server.registerTool('set_unit_members', {
+        title: 'Set unit members',
+        description: 'Replace the zones referenced by a unit. Every zone must belong to a level in the same building.',
+        inputSchema: setUnitMembersInput,
+        outputSchema: setUnitMembersOutput,
+        annotations: { ...DESTRUCTIVE_TOOL_ANNOTATIONS, idempotentHint: true },
+    }, async ({ unitId, memberZoneIds }) => {
+        const unit = bridge.getNode(unitId);
+        if (!unit) {
+            throwMcpError(ErrorCode.InvalidParams, `Unit not found: ${unitId}`);
+        }
+        if (unit.type !== 'unit') {
+            throwMcpError(ErrorCode.InvalidParams, `Node ${unitId} is a ${unit.type}, expected unit`);
+        }
+        if (!unit.parentId) {
+            throwMcpError(ErrorCode.InvalidParams, `Unit ${unitId} must belong to a building`);
+        }
+        const members = validateUnitMembers(bridge, unit.parentId, memberZoneIds);
+        bridge.updateNode(unit.id, { members });
+        const persistence = await publishLiveSceneSnapshot(bridge, 'set_unit_members');
+        const payload = { unitId, memberCount: members.length, ...persistencePayload(persistence) };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(payload) }],
+            structuredContent: payload,
+        };
+    });
+}

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

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../operations';
+import type { SceneOperations } from '../operations/index.js';
 export declare const setZoneInput: {
     levelId: z.ZodString;
     polygon: z.ZodArray<z.ZodArray<z.ZodNumber>>;
@@ -8,6 +8,13 @@ export declare const setZoneInput: {
     properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 };
 export declare const setZoneOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     zoneId: z.ZodString;
 };
 export declare function registerSetZone(server: McpServer, bridge: SceneOperations): void;

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;AAKpD,eAAO,MAAM,YAAY;;;;;CAKxB,CAAA;AAED,eAAO,MAAM,aAAa;;CAEzB,CAAA;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgDhF"}
+{"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,8 +1,9 @@
 import { ZoneNode } from '@pascal-app/core/schema';
 import { z } from 'zod';
-import { ErrorCode, throwMcpError } from './errors';
-import { publishLiveSceneSnapshot } from './live-sync';
-import { NodeIdSchema, Vec2Schema } from './schemas';
+import { ADDITIVE_TOOL_ANNOTATIONS } from './annotations.js';
+import { ErrorCode, throwMcpError } from './errors.js';
+import { liveSyncOutput, persistencePayload, publishLiveSceneSnapshot } from './live-sync.js';
+import { NodeIdSchema, Vec2Schema } from './schemas.js';
 export const setZoneInput = {
     levelId: NodeIdSchema,
     polygon: z.array(Vec2Schema).min(3),
@@ -11,6 +12,7 @@ export const setZoneInput = {
 };
 export const setZoneOutput = {
     zoneId: z.string(),
+    ...liveSyncOutput,
 };
 export function registerSetZone(server, bridge) {
     server.registerTool('set_zone', {
@@ -18,6 +20,7 @@ export function registerSetZone(server, bridge) {
         description: 'Create a polygonal zone on the given level. label is stored as the zone name and properties are merged into metadata.',
         inputSchema: setZoneInput,
         outputSchema: setZoneOutput,
+        annotations: ADDITIVE_TOOL_ANNOTATIONS,
     }, async ({ levelId, polygon, label, properties }) => {
         const parent = bridge.getNode(levelId);
         if (!parent) {
@@ -38,8 +41,8 @@ export function registerSetZone(server, bridge) {
             metadata: properties ?? {},
         });
         const id = bridge.createNode(zone, levelId);
-        await publishLiveSceneSnapshot(bridge, 'set_zone');
-        const payload = { zoneId: id };
+        const persistence = await publishLiveSceneSnapshot(bridge, 'set_zone');
+        const payload = { zoneId: id, ...persistencePayload(persistence) };
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],
             structuredContent: payload,

package/dist/tools/templates/create-from-template.d.ts

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 export declare const createFromTemplateInput: {
     id: z.ZodString;
     name: z.ZodOptional<z.ZodString>;

package/dist/tools/templates/create-from-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-from-template.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/create-from-template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAMvD,eAAO,MAAM,uBAAuB;;;IAYlC;;;;;OAKG;;;CAGJ,CAAA;AAED,eAAO,MAAM,wBAAwB;;;;IAInC,yEAAyE;;IAEzE,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;CAuB9D,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA8F3F"}
+{"version":3,"file":"create-from-template.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/create-from-template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAOvD,eAAO,MAAM,uBAAuB;;;IAYlC;;;;;OAKG;;;CAGJ,CAAA;AAED,eAAO,MAAM,wBAAwB;;;;IAInC,yEAAyE;;IAEzE,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;CAuB9D,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA+F3F"}

package/dist/tools/templates/create-from-template.js

@@ -1,10 +1,11 @@
 import { cloneSceneGraph } from '@pascal-app/core/clone-scene-graph';
 import { z } from 'zod';
-import { rehydrateSiteChildren } from '../../lib/rehydrate-site-children';
-import { isTemplateId, TEMPLATES } from '../../templates';
-import { ErrorCode, throwMcpError } from '../errors';
-import { appendLiveSceneEvent } from '../live-sync';
-import { currentLevelContext, sceneMetaPayload } from '../scene-lifecycle/metadata';
+import { rehydrateSiteChildren } from '../../lib/rehydrate-site-children.js';
+import { isTemplateId, TEMPLATES } from '../../templates/index.js';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, throwMcpError } from '../errors.js';
+import { appendLiveSceneEvent } from '../live-sync.js';
+import { currentLevelContext, sceneMetaPayload } from '../scene-lifecycle/metadata.js';
 export const createFromTemplateInput = {
     id: z
         .string()
@@ -68,6 +69,7 @@ export function registerCreateFromTemplate(server, bridge) {
         description: 'Instantiate a seed Pascal scene template into the bridge. Regenerates all ids before applying. When `save: true` and a SceneStore is wired, also persists the new scene and returns the SceneMeta.',
         inputSchema: createFromTemplateInput,
         outputSchema: createFromTemplateOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ id, name, save, projectId }) => {
         if (!isTemplateId(id)) {
             throwMcpError(ErrorCode.InvalidParams, `unknown_template: ${id}. Call list_templates for the set of valid ids.`);

package/dist/tools/templates/create-house-from-brief.d.ts

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 export declare const createHouseFromBriefInput: {
     brief: z.ZodString;
     projectId: z.ZodOptional<z.ZodString>;

package/dist/tools/templates/create-house-from-brief.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-house-from-brief.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/create-house-from-brief.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAMvD,eAAO,MAAM,yBAAyB;;;;;;;;;CASrC,CAAA;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;CAmBtC,CAAA;AAmCD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAqI7F"}
+{"version":3,"file":"create-house-from-brief.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/create-house-from-brief.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAOvD,eAAO,MAAM,yBAAyB;;;;;;;;;CASrC,CAAA;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;CAmBtC,CAAA;AAmCD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAsI7F"}

package/dist/tools/templates/create-house-from-brief.js

@@ -1,10 +1,11 @@
 import { cloneSceneGraph } from '@pascal-app/core/clone-scene-graph';
 import { z } from 'zod';
-import { rehydrateSiteChildren } from '../../lib/rehydrate-site-children';
-import { isTemplateId, TEMPLATES } from '../../templates';
-import { ErrorCode, throwMcpError } from '../errors';
-import { appendLiveSceneEvent } from '../live-sync';
-import { currentLevelContext, sceneMetaPayload } from '../scene-lifecycle/metadata';
+import { rehydrateSiteChildren } from '../../lib/rehydrate-site-children.js';
+import { isTemplateId, TEMPLATES } from '../../templates/index.js';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from '../annotations.js';
+import { ErrorCode, throwMcpError } from '../errors.js';
+import { appendLiveSceneEvent } from '../live-sync.js';
+import { currentLevelContext, sceneMetaPayload } from '../scene-lifecycle/metadata.js';
 export const createHouseFromBriefInput = {
     brief: z.string().min(1),
     projectId: z.string().optional(),
@@ -66,6 +67,7 @@ export function registerCreateHouseFromBrief(server, bridge) {
         description: 'High-level hosted workflow for external agents: choose a starter house from a brief, create/save/publish it, and return the editor URL. Use semantic tools afterward for exact customization.',
         inputSchema: createHouseFromBriefInput,
         outputSchema: createHouseFromBriefOutput,
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
     }, async ({ brief, projectId, projectName, bedroomCount, rooms, style, landscaping, constraints, }) => {
         const templateId = chooseTemplate({
             ...(bedroomCount !== undefined ? { bedroomCount } : {}),

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

@@ -1,5 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { SceneOperations } from '../../operations';
+import type { SceneOperations } from '../../operations/index.js';
 /**
  * Register the template MCP tools (`list_templates`, `create_from_template`)
  * against the given server.
@@ -8,7 +8,7 @@ import type { SceneOperations } from '../../operations';
  * applies the template to the bridge but skips the save step.
  */
 export declare function registerTemplateTools(server: McpServer, bridge: SceneOperations): void;
-export { createFromTemplateInput, createFromTemplateOutput, registerCreateFromTemplate, } from './create-from-template';
-export { createHouseFromBriefInput, createHouseFromBriefOutput, registerCreateHouseFromBrief, } from './create-house-from-brief';
-export { listTemplatesInput, listTemplatesOutput, registerListTemplates, } from './list-templates';
+export { createFromTemplateInput, createFromTemplateOutput, registerCreateFromTemplate, } from './create-from-template.js';
+export { createHouseFromBriefInput, createHouseFromBriefOutput, registerCreateHouseFromBrief, } from './create-house-from-brief.js';
+export { listTemplatesInput, listTemplatesOutput, registerListTemplates, } from './list-templates.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/templates/index.js

@@ -1,6 +1,6 @@
-import { registerCreateFromTemplate } from './create-from-template';
-import { registerCreateHouseFromBrief } from './create-house-from-brief';
-import { registerListTemplates } from './list-templates';
+import { registerCreateFromTemplate } from './create-from-template.js';
+import { registerCreateHouseFromBrief } from './create-house-from-brief.js';
+import { registerListTemplates } from './list-templates.js';
 /**
  * Register the template MCP tools (`list_templates`, `create_from_template`)
  * against the given server.
@@ -13,6 +13,6 @@ export function registerTemplateTools(server, bridge) {
     registerCreateFromTemplate(server, bridge);
     registerCreateHouseFromBrief(server, bridge);
 }
-export { createFromTemplateInput, createFromTemplateOutput, registerCreateFromTemplate, } from './create-from-template';
-export { createHouseFromBriefInput, createHouseFromBriefOutput, registerCreateHouseFromBrief, } from './create-house-from-brief';
-export { listTemplatesInput, listTemplatesOutput, registerListTemplates, } from './list-templates';
+export { createFromTemplateInput, createFromTemplateOutput, registerCreateFromTemplate, } from './create-from-template.js';
+export { createHouseFromBriefInput, createHouseFromBriefOutput, registerCreateHouseFromBrief, } from './create-house-from-brief.js';
+export { listTemplatesInput, listTemplatesOutput, registerListTemplates, } from './list-templates.js';

package/dist/tools/templates/list-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-templates.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/list-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,kBAAkB,IAAc,CAAA;AAE7C,eAAO,MAAM,mBAAmB;;;;;;;CAS/B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwB7D"}
+{"version":3,"file":"list-templates.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/list-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,kBAAkB,IAAc,CAAA;AAE7C,eAAO,MAAM,mBAAmB;;;;;;;CAS/B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyB7D"}

package/dist/tools/templates/list-templates.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { TEMPLATES } from '../../templates';
+import { TEMPLATES } from '../../templates/index.js';
+import { READ_ONLY_TOOL_ANNOTATIONS } from '../annotations.js';
 export const listTemplatesInput = {};
 export const listTemplatesOutput = {
     templates: z.array(z.object({
@@ -20,6 +21,7 @@ export function registerListTemplates(server) {
         description: 'List the seed Pascal scene templates available to `create_from_template`. Returns the id, display name, one-line description and node count for each.',
         inputSchema: listTemplatesInput,
         outputSchema: listTemplatesOutput,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async () => {
         const templates = Object.values(TEMPLATES).map((entry) => ({
             id: entry.id,

package/dist/tools/undo.d.ts

@@ -1,10 +1,17 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import type { SceneOperations } from '../operations';
+import type { SceneOperations } from '../operations/index.js';
 export declare const undoInput: {
     steps: z.ZodOptional<z.ZodNumber>;
 };
 export declare const undoOutput: {
+    persistence: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unbound: "unbound";
+            events_unsupported: "events_unsupported";
+        }>;
+        warning: z.ZodString;
+    }, z.core.$strip>>;
     undone: z.ZodNumber;
 };
 export declare function registerUndo(server: McpServer, bridge: SceneOperations): void;

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

@@ -1 +1 @@
-{"version":3,"file":"undo.d.ts","sourceRoot":"","sources":["../../src/tools/undo.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,eAAe,CAAA;AAGpD,eAAO,MAAM,SAAS;;CAErB,CAAA;AAED,eAAO,MAAM,UAAU;;CAEtB,CAAA;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAoB7E"}
+{"version":3,"file":"undo.d.ts","sourceRoot":"","sources":["../../src/tools/undo.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,eAAe,CAAA;AAIpD,eAAO,MAAM,SAAS;;CAErB,CAAA;AAED,eAAO,MAAM,UAAU;;;;;;;;;CAGtB,CAAA;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAsB7E"}