@pascal-app/mcp 1.0.3 → 1.0.5

package/dist/server.js

@@ -1,49 +1,95 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpServer, ProtocolError, ProtocolErrorCode, } from '@modelcontextprotocol/server';
+import { recordMade, } from '@pascal-app/core/agent-operations';
 import { createSceneOperations } from './operations/index.js';
 import { registerPrompts } from './prompts/index.js';
 import { registerResources } from './resources/index.js';
 import { registerTools } from './tools/index.js';
+import { cachedCatalog } from './tools/asset-catalog.js';
+import { registerHostedServiceTools } from './tools/hosted-services.js';
 import { normalizeToolSchemaDialect } from './tools/normalize-schema-dialect.js';
+import { registerProjectFileTools } from './tools/project-files.js';
+import { answerRetiredTools } from './tools/retired-tools.js';
 import { registerVisionTools } from './tools/vision/index.js';
 import { version } from './version.js';
 export function createPascalMcpServer(opts) {
-    const server = new McpServer({
-        name: opts.name ?? 'pascal-mcp-server',
-        version: opts.version ?? version,
+    // A client shows these before the agent's first call.
+    const server = new McpServer({ name: opts.name ?? 'pascal-mcp-server', version: opts.version ?? version }, {
+        instructions: `Pascal builds and edits 3D buildings; the agent guide is the resource pascal://agent-guide.${opts.instructions ? `\n${opts.instructions}` : ''}`,
     });
-    if (opts.executeTool)
-        installToolExecutor(server, opts.executeTool);
+    answerInvalidInputWithCode(server);
     const operations = opts.operations ?? createSceneOperations({ bridge: opts.bridge, store: opts.store });
-    registerTools(server, operations);
+    const executeTool = recordingWhatToolsMake(operations, opts.executeTool);
+    if (executeTool)
+        installToolExecutor(server, executeTool);
+    const catalog = opts.catalog ? cachedCatalog(opts.catalog) : undefined;
+    registerTools(server, operations, {
+        catalog,
+        geometryScripts: opts.geometryScripts,
+        sceneViews: opts.sceneViews,
+        assetViews: opts.assetViews,
+    });
     registerVisionTools(server, operations);
-    registerResources(server, operations);
+    if (opts.services)
+        registerHostedServiceTools(server, opts.services);
+    if (opts.files)
+        registerProjectFileTools(server, opts.files);
+    registerResources(server, operations, catalog);
     registerPrompts(server, operations);
     normalizeToolSchemaDialect(server);
+    answerRetiredTools(server);
     return server;
 }
+/**
+ * Arguments a tool's schema rejects come back with the code `invalid_input`, as every other refusal
+ * names its code and as the chat answers them: the SDK's own answer is a bare message. The SDK
+ * checks the arguments in its server's validateToolInput and turns what it throws into the tool's
+ * error text, so a JSON message carries the code; `server-invalid-input.test` fails if an SDK upgrade
+ * moves that check.
+ */
+function answerInvalidInputWithCode(server) {
+    const sdk = server;
+    const validate = sdk.validateToolInput.bind(server);
+    sdk.validateToolInput = async (tool, args, name) => {
+        try {
+            return await validate(tool, args, name);
+        }
+        catch (error) {
+            if (!(error instanceof ProtocolError && error.code === ProtocolErrorCode.InvalidParams))
+                throw error;
+            throw new Error(JSON.stringify({
+                error: error.message,
+                code: 'invalid_input',
+            }));
+        }
+    };
+}
+/**
+ * Inside the host's executor, so that what a call made is in the session by the time the host
+ * saves it: every tool that writes, however it writes, leaves what it created with the agent's
+ * session, and the first call of any kind begins it.
+ */
+function recordingWhatToolsMake(operations, outer) {
+    const session = operations.agentSession;
+    if (!session)
+        return outer;
+    const recording = (input) => recordMade({
+        getNodes: () => operations.getNodes(),
+        readSession: () => session.read(),
+        keep: (keep) => session.keep(keep),
+    }, input.execute);
+    return outer ? (input) => outer({ ...input, execute: () => recording(input) }) : recording;
+}
 function installToolExecutor(server, executeTool) {
     const registerTool = server.registerTool.bind(server);
-    const wrappedRegisterTool = (name, config, callback) => {
-        const runtimeCallback = callback;
-        const registration = registerTool(name, config, wrapToolCallback(name, runtimeCallback, executeTool));
-        return wrapRegisteredTool(registration, name, runtimeCallback, executeTool);
-    };
-    server.registerTool = wrappedRegisterTool;
-    const tool = server.tool.bind(server);
-    server.tool = ((name, ...args) => {
-        const callback = args.at(-1);
-        if (typeof callback !== 'function') {
-            return Reflect.apply(tool, undefined, [name, ...args]);
-        }
-        const runtimeCallback = callback;
-        args[args.length - 1] = wrapToolCallback(name, runtimeCallback, executeTool);
-        const registration = Reflect.apply(tool, undefined, [name, ...args]);
-        return wrapRegisteredTool(registration, name, runtimeCallback, executeTool);
+    server.registerTool = ((name, config, callback) => {
+        const registration = registerTool(name, config, wrapToolCallback(name, callback, executeTool));
+        return wrapRegisteredTool(registration, name, callback, executeTool);
     });
 }
 function wrapToolCallback(name, callback, executeTool) {
     return (...args) => executeTool({
         name,
+        arguments: args.length > 1 ? args[0] : undefined,
         signal: toolRequestSignal(args),
         execute: () => Promise.resolve(Reflect.apply(callback, undefined, args)),
     });
@@ -69,5 +115,5 @@ function wrapRegisteredTool(registration, initialName, initialCallback, executeT
     return registration;
 }
 function toolRequestSignal(args) {
-    return args.at(-1).signal;
+    return args.at(-1).mcpReq.signal;
 }

package/dist/storage/disk-artifact-store.d.ts

@@ -0,0 +1,9 @@
+/** Immutable artifacts beside the SQLite scene database. */
+export declare class DiskArtifactStore {
+    readonly directory: string;
+    constructor(projectPath: string);
+    private path;
+    put(sha256: string, bytes: ArrayBuffer | Uint8Array): Promise<void>;
+    read(sha256: string): Promise<Uint8Array | null>;
+}
+//# sourceMappingURL=disk-artifact-store.d.ts.map

package/dist/storage/disk-artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-artifact-store.d.ts","sourceRoot":"","sources":["../../src/storage/disk-artifact-store.ts"],"names":[],"mappings":"AAIA,4DAA4D;AAC5D,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B,YAAY,WAAW,EAAE,MAAM,EAE9B;IAED,OAAO,CAAC,IAAI;IAKN,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBxE;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAOrD;CACF"}

package/dist/storage/disk-artifact-store.js

@@ -0,0 +1,46 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { link, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+/** Immutable artifacts beside the SQLite scene database. */
+export class DiskArtifactStore {
+    directory;
+    constructor(projectPath) {
+        this.directory = `${resolve(projectPath)}.artifacts`;
+    }
+    path(sha256) {
+        if (!/^[0-9a-f]{64}$/.test(sha256))
+            throw new Error('Invalid artifact hash');
+        return join(this.directory, sha256);
+    }
+    async put(sha256, bytes) {
+        const path = this.path(sha256);
+        const data = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
+        if (createHash('sha256').update(data).digest('hex') !== sha256) {
+            throw new Error('Artifact hash mismatch');
+        }
+        await mkdir(this.directory, { recursive: true });
+        const temporary = join(this.directory, `.${randomUUID()}`);
+        try {
+            await writeFile(temporary, data, { flag: 'wx' });
+            // A hard link publishes complete bytes atomically without replacing another writer's file.
+            await link(temporary, path);
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+    }
+    async read(sha256) {
+        try {
+            return await readFile(this.path(sha256));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+    }
+}

package/dist/storage/index.d.ts

@@ -1,4 +1,5 @@
 import type { SceneStore } from './types.js';
+export * from './disk-artifact-store.js';
 export * from './slug.js';
 export * from './sqlite-scene-store.js';
 export * from './types.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,cAAc,QAAQ,CAAA;AACtB,cAAc,sBAAsB,CAAA;AACpC,cAAc,SAAS,CAAA;AAEvB;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAGnF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,cAAc,uBAAuB,CAAA;AACrC,cAAc,QAAQ,CAAA;AACtB,cAAc,sBAAsB,CAAA;AACpC,cAAc,SAAS,CAAA;AAEvB;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAGnF"}

package/dist/storage/index.js

@@ -1,3 +1,4 @@
+export * from './disk-artifact-store.js';
 export * from './slug.js';
 export * from './sqlite-scene-store.js';
 export * from './types.js';

package/dist/storage/sqlite-scene-store.d.ts

@@ -1,4 +1,4 @@
-import { type ProjectCreateOptions, type ProjectStatus, type SceneEvent, type SceneEventAppendOptions, type SceneEventListOptions, type SceneListOptions, type SceneMeta, type SceneMutateOptions, type SceneSaveOptions, type SceneStore, type SceneWithGraph } from './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 './types.js';
 export interface SqliteSceneStoreOptions {
     /** Exact SQLite database file path. If omitted, resolved from env. */
     databasePath?: string;
@@ -25,7 +25,7 @@ export declare function resolveDefaultDatabasePath(env?: NodeJS.ProcessEnv): str
  * so a local editor and MCP process can safely share scenes on one machine.
  */
 export declare class SqliteSceneStore implements SceneStore {
-    readonly backend: "sqlite";
+    readonly backend: 'sqlite';
     readonly databasePath: string;
     private readonly maxSceneBytes;
     private readonly projectPlaceholders;
@@ -37,7 +37,7 @@ export declare class SqliteSceneStore 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/storage/sqlite-scene-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-scene-store.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite-scene-store.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAE1B,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAGf,KAAK,cAAc,EACpB,MAAM,SAAS,CAAA;AAOhB,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAgDD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAmBvF;AAkKD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAS;IAEpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAwC;IAC5E,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,SAAS,CAAuC;gBAE5C,IAAI,GAAE,uBAA4B;IAMxC,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBjE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAS3D,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IAyHhD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAUhD,IAAI,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAiCvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAenE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC;IAsCtF,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IA6BpE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmB/F,KAAK,IAAI,IAAI;YAMC,QAAQ;IAiBtB,OAAO,CAAC,OAAO;YAgDD,oBAAoB;IAiBlC,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,gBAAgB;CAOzB"}
+{"version":3,"file":"sqlite-scene-store.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite-scene-store.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAE1B,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAGf,KAAK,cAAc,EACpB,MAAM,SAAS,CAAA;AAOhB,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAgDD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAmBvF;AAkKD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAS;IAEpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAwC;IAC5E,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,SAAS,CAAuC;IAExD,YAAY,IAAI,GAAE,uBAA4B,EAM7C;IAEK,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBtE;IAEK,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAOhE;IAEK,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAuHrD;IAEK,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAQrD;IAEK,IAAI,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA+B5D;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAalF;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,CAoC3F;IAEK,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2BzE;IAEK,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiB9F;IAED,KAAK,IAAI,IAAI,CAIZ;YAEa,QAAQ;IAiBtB,OAAO,CAAC,OAAO;YAgDD,oBAAoB;IAiBlC,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/storage/sqlite-scene-store.js

@@ -207,7 +207,8 @@ export class SqliteSceneStore {
     dbPromise = null;
     constructor(opts = {}) {
         const env = opts.env ?? process.env;
-        this.databasePath = path.resolve(opts.databasePath ?? resolveDefaultDatabasePath(env));
+        this.databasePath = path.resolve(
+        /* turbopackIgnore: true */ opts.databasePath ?? resolveDefaultDatabasePath(env));
         this.maxSceneBytes = resolveMaxSceneBytes(env, opts.maxSceneBytes);
     }
     async createProject(opts) {
@@ -357,12 +358,12 @@ export class SqliteSceneStore {
             const safeId = sanitizeSlug(id);
             const existing = this.getRow(db, safeId);
             if (!existing)
-                return false;
+                return { deleted: false, hidden: false };
             if (opts.expectedVersion !== undefined && existing.version !== opts.expectedVersion) {
                 throw new SceneVersionConflictError(`Scene "${safeId}" version mismatch: expected ${opts.expectedVersion}, got ${existing.version}`);
             }
             db.query('DELETE FROM scenes WHERE id = ?').run(safeId);
-            return true;
+            return { deleted: true, hidden: false };
         });
     }
     async rename(id, newName, opts = {}) {

package/dist/storage/types.d.ts

@@ -21,7 +21,7 @@ export interface SceneMeta {
     editorUrl?: string;
     /** Backward-compatible alias for clients that still read url. */
     url?: string;
-    /** True when this save is browser-visible without a separate publish call. */
+    /** True when this version is the published one (hosted: what the project's viewers see). */
     published?: boolean;
     /** True when the saved graph is still the mutable browser-visible draft. */
     isDraft?: boolean;
@@ -50,14 +50,25 @@ export interface SceneSaveOptions {
     thumbnailUrl?: string | null;
     /** When set, save fails with `SceneVersionConflictError` on mismatch. */
     expectedVersion?: number;
+    /**
+     * When set, save fails with `SceneVersionConflictError` unless the stored graph still hashes to
+     * this. A draft saved in place keeps its version number, so only the content tells that an
+     * open editor wrote in between.
+     */
+    expectedGraphHash?: string | null;
     /** `draft` updates the browser-visible working model; `checkpoint` records version history. */
     saveMode?: SceneSaveMode;
-    /** Whether a checkpoint should become the published/browser-visible head. */
+    /** Publish this checkpoint. Only an explicit `true` publishes; a checkpoint alone never does. */
     publish?: boolean;
     /** Optional hosted MCP session id for project presence/debug metadata. */
     agentSessionId?: string;
     /** Optional high-level operation name for presence/debug metadata. */
     operation?: string;
+    /**
+     * The write empties a populated project on purpose (clear_scene). A store may refuse a write that
+     * empties the project unless this is set, with `SceneWipeBlockedError`.
+     */
+    allowSceneWipe?: boolean;
 }
 export type SceneSaveMode = 'draft' | 'checkpoint';
 export interface SceneListOptions {
@@ -68,6 +79,15 @@ export interface SceneListOptions {
 export interface SceneMutateOptions {
     expectedVersion?: number;
 }
+/**
+ * What `delete` did. A local store removes the scene; hosted Pascal never deletes a project this
+ * way and only hides it, with a `message` saying so.
+ */
+export type SceneDeleteResult = {
+    deleted: boolean;
+    hidden: boolean;
+    message?: string;
+};
 export interface SceneEventAppendOptions {
     sceneId: SceneId;
     version: number;
@@ -112,25 +132,34 @@ export interface SceneStore {
     save(opts: SceneSaveOptions): Promise<SceneMeta>;
     load(id: SceneId): Promise<SceneWithGraph | null>;
     list(opts?: SceneListOptions): Promise<SceneMeta[]>;
-    delete(id: SceneId, opts?: SceneMutateOptions): Promise<boolean>;
+    delete(id: SceneId, opts?: SceneMutateOptions): Promise<SceneDeleteResult>;
     rename(id: SceneId, newName: string, opts?: SceneMutateOptions): Promise<SceneMeta>;
     appendSceneEvent?(opts: SceneEventAppendOptions): Promise<SceneEvent>;
     listSceneEvents?(sceneId: SceneId, opts?: SceneEventListOptions): Promise<SceneEvent[]>;
 }
 export declare class SceneNotFoundError extends Error {
-    readonly code: "not_found";
+    readonly code: 'not_found';
     constructor(message?: string);
 }
 export declare class SceneVersionConflictError extends Error {
-    readonly code: "version_conflict";
+    readonly code: 'version_conflict';
     constructor(message?: string);
 }
 export declare class SceneInvalidError extends Error {
-    readonly code: "invalid";
+    readonly code: 'invalid';
+    constructor(message?: string);
+}
+/**
+ * A store refused a write that would empty a populated project without `allowSceneWipe`: far more
+ * often an accident (a client that never finished loading, a deletion of everything) than an intent.
+ * Still an invalid write to a caller that only knows `SceneInvalidError`; the MCP answers it
+ * `scene_wipe_blocked`, naming clear_scene.
+ */
+export declare class SceneWipeBlockedError extends SceneInvalidError {
     constructor(message?: string);
 }
 export declare class SceneTooLargeError extends Error {
-    readonly code: "too_large";
+    readonly code: 'too_large';
     constructor(message?: string);
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/storage/types.d.ts.map

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

package/dist/storage/types.js

@@ -19,6 +19,18 @@ export class SceneInvalidError extends Error {
         this.name = 'SceneInvalidError';
     }
 }
+/**
+ * A store refused a write that would empty a populated project without `allowSceneWipe`: far more
+ * often an accident (a client that never finished loading, a deletion of everything) than an intent.
+ * Still an invalid write to a caller that only knows `SceneInvalidError`; the MCP answers it
+ * `scene_wipe_blocked`, naming clear_scene.
+ */
+export class SceneWipeBlockedError extends SceneInvalidError {
+    constructor(message = 'Scene wipe blocked') {
+        super(message);
+        this.name = 'SceneWipeBlockedError';
+    }
+}
 export class SceneTooLargeError extends Error {
     code = 'too_large';
     constructor(message = 'Scene too large') {

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

@@ -1,8 +1,8 @@
 import type { SceneGraph } from '@pascal-app/core/clone-scene-graph';
 export declare const template: SceneGraph;
 export declare const metadata: {
-    readonly id: "empty-studio";
-    readonly name: "Empty studio";
-    readonly description: "40 m² single-room studio apartment: 4 walls, 1 living/kitchen zone, 1 window, 1 front door.";
+    readonly id: 'empty-studio';
+    readonly name: 'Empty studio';
+    readonly description: '40 m² single-room studio apartment: 4 walls, 1 living/kitchen zone, 1 window, 1 front door.';
 };
 //# sourceMappingURL=empty-studio.d.ts.map

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

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

package/dist/templates/garden-house.d.ts

@@ -1,8 +1,8 @@
 import type { SceneGraph } from '@pascal-app/core/clone-scene-graph';
 export declare const template: SceneGraph;
 export declare const metadata: {
-    readonly id: "garden-house";
-    readonly name: "Garden house";
-    readonly description: "12 × 8 m single-level house with a fenced back-garden zone; 4 walls, 2 doors, 4 windows, 3 privacy fences.";
+    readonly id: 'garden-house';
+    readonly name: 'Garden house';
+    readonly description: '12 × 8 m single-level house with a fenced back-garden zone; 4 walls, 2 doors, 4 windows, 3 privacy fences.';
 };
 //# sourceMappingURL=garden-house.d.ts.map

package/dist/templates/garden-house.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"garden-house.d.ts","sourceRoot":"","sources":["../../src/templates/garden-house.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAkRpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;;;;CAKX,CAAA"}
+{"version":3,"file":"garden-house.d.ts","sourceRoot":"","sources":["../../src/templates/garden-house.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAkRpE,eAAO,MAAM,QAAQ,EAAE,UAA4B,CAAA;AAEnD,eAAO,MAAM,QAAQ;aACnB,EAAE,EAAE,cAAc;aAClB,IAAI,EAAE,cAAc;aACpB,WAAW,EACT,4GAA4G;CACtG,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAKpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,QAAQ,EAAE,UAAU,CAAA;CACrB,CAAA;AAWD,eAAO,MAAM,SAAS;;;;CAIZ,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,SAAS,CAAA;AAE/C,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,UAAU,CAEzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAKpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,QAAQ,EAAE,UAAU,CAAA;CACrB,CAAA;AAWD,eAAO,MAAM,SAAS;aACpB,cAAc;aACd,aAAa;aACb,cAAc;CACN,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,SAAS,CAAA;AAE/C,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,UAAU,CAEzD"}

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

@@ -1,8 +1,8 @@
 import type { SceneGraph } from '@pascal-app/core/clone-scene-graph';
 export declare const template: SceneGraph;
 export declare const metadata: {
-    readonly id: "two-bedroom";
-    readonly name: "Two-bedroom apartment";
-    readonly description: "80 m² two-bedroom flat: 9 walls, 4 zones (living/kitchen, 2 bedrooms, bath), 4 doors and 5 windows.";
+    readonly id: 'two-bedroom';
+    readonly name: 'Two-bedroom apartment';
+    readonly description: '80 m² two-bedroom flat: 9 walls, 4 zones (living/kitchen, 2 bedrooms, bath), 4 doors and 5 windows.';
 };
 //# sourceMappingURL=two-bedroom.d.ts.map

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

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

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

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+import type { SceneOperations } from '../operations/index.js';
+import { type GeometryScriptHost } from './add-object.js';
+export declare function registerAddColumn(server: McpServer, bridge: SceneOperations, host?: GeometryScriptHost): void;
+//# sourceMappingURL=add-column.d.ts.map

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

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

package/dist/tools/add-column.js

@@ -0,0 +1,59 @@
+import { isScriptedNode, scriptedObjectMeta } from '@pascal-app/core';
+import { addColumn, columnScriptParams, editedScriptLanguage, } from '@pascal-app/core/agent-operations';
+import { addColumnTool, isAgentRefusal, refuse } from '@pascal-app/core/agent-tools';
+import { GeometryReuseFields } from '@pascal-app/core/schema';
+import { z } from 'zod';
+import { compileAndStore, readScript } from './add-object.js';
+import { DESTRUCTIVE_TOOL_ANNOTATIONS } from './annotations.js';
+import { refusalResult, toolError } from './errors.js';
+import { persistencePayload, publishLiveSceneSnapshot } from './live-sync.js';
+import { toPatches } from './shared-tools.js';
+export function registerAddColumn(server, bridge, host) {
+    server.registerTool(addColumnTool.name, {
+        title: addColumnTool.title,
+        description: addColumnTool.description,
+        inputSchema: z.object(addColumnTool.input),
+        annotations: DESTRUCTIVE_TOOL_ANNOTATIONS,
+    }, async (input) => {
+        try {
+            const nodes = bridge.getNodes();
+            const previous = input.nodeId ? nodes[input.nodeId] : undefined;
+            const params = columnScriptParams(previous?.type === 'column' ? previous : undefined, input);
+            let compiled;
+            if (params) {
+                if (!host)
+                    refuse('scripts_unavailable', 'This Pascal server cannot run geometry scripts.');
+                const scene = bridge.getActiveScene();
+                if (!scene)
+                    refuse('no_active_scene', 'Open or save a scene first.');
+                const code = input.code ?? (await readScript(host, scene.id, bridge, input.nodeId));
+                const language = editedScriptLanguage(previous, input);
+                compiled = await compileAndStore(host, scene.id, { code, language, params }, 'column', {
+                    nodeId: input.nodeId,
+                    metadata: {
+                        ...(isScriptedNode(previous) ? scriptedObjectMeta(previous) : {}),
+                        ...GeometryReuseFields.parse(input),
+                    },
+                });
+            }
+            const outcome = addColumn(nodes, { ...input, compiled }, { activeLevelId: bridge.activeLevelId?.() ?? null });
+            if (outcome.changes)
+                bridge.applyPatch(toPatches(outcome.changes));
+            const payload = {
+                ...outcome.result,
+                ...persistencePayload(await publishLiveSceneSnapshot(bridge, addColumnTool.name)),
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(payload) }],
+                structuredContent: payload,
+            };
+        }
+        catch (error) {
+            if (isAgentRefusal(error))
+                return refusalResult(error);
+            return toolError(error instanceof Error ? error.message : String(error), {
+                code: 'script_failed',
+            });
+        }
+    });
+}

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

@@ -0,0 +1,76 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+import { type AddObjectInput } from '@pascal-app/core/agent-operations';
+import { type CompiledGeometryScript, GeometryArtifactMetadata, type GeometryScriptLanguage, type GeometryScriptParamValue } from '@pascal-app/core/schema';
+import type { SceneOperations } from '../operations/index.js';
+/**
+ * How a host runs `add_object`'s module and keeps the result. Running
+ * model-written code is the host's call: it decides the isolation, and where
+ * artifacts live for the active scene.
+ */
+export type GeometryScriptHost = {
+    readonly signal?: AbortSignal;
+    /** Recheck the host's active authorization after a long compile and before scene mutation. */
+    assertActive?(): Promise<void>;
+    compile(input: {
+        code: string;
+        language: GeometryScriptLanguage;
+        params?: Record<string, GeometryScriptParamValue>;
+        /** What the host builds it for (a room's floor, a wall's face: `floorScriptInputs`, `wallFaceScriptInputs`), kept in the host's frame. */
+        inputs?: Record<string, unknown>;
+    }): Promise<CompiledGeometryScript & {
+        glb: Uint8Array;
+    }>;
+    storeArtifact(input: {
+        sceneId: string;
+        sha256: string;
+        bytes: Uint8Array;
+        mimeType: string;
+        nodeId?: string;
+        metadata?: GeometryArtifactMetadata;
+    }): Promise<string>;
+    /** A stored artifact's bytes (an object's script), or null when missing; only for principals who may edit the scene. */
+    readArtifact(input: {
+        sceneId: string;
+        sha256: string;
+    }): Promise<Uint8Array | null>;
+    /**
+     * Compiles and stores in one step, for a host whose compiler keeps the artifacts itself (the
+     * hosted MCP's user editor tab); preferred over `compile` + `storeArtifact` when present.
+     */
+    build?(input: {
+        sceneId: string;
+        code: string;
+        language: GeometryScriptLanguage;
+        params?: Record<string, GeometryScriptParamValue>;
+        inputs?: Record<string, unknown>;
+        /** What the script builds, for the host to name it to the user. */
+        kind: ScriptedKind;
+        nodeId: string;
+        metadata?: GeometryArtifactMetadata;
+    }): Promise<CompiledGeometryScript>;
+};
+export type ScriptedKind = 'object' | 'window' | 'door' | 'column' | 'floor' | 'wall-face';
+/** Compiles a module on the host and stores its GLB and text for the scene: the step every scripted tool shares. */
+export declare function compileAndStore(host: GeometryScriptHost, sceneId: string, { code, language, params, inputs, }: {
+    code: string;
+    language: GeometryScriptLanguage;
+    params: Record<string, GeometryScriptParamValue> | undefined;
+    inputs?: Record<string, unknown>;
+}, kind: ScriptedKind, context?: {
+    nodeId?: string;
+    metadata?: GeometryArtifactMetadata;
+}): Promise<CompiledGeometryScript>;
+export declare function readScript(host: GeometryScriptHost, sceneId: string, bridge: SceneOperations, nodeId: string): Promise<string>;
+/**
+ * One object's module compiled and stored by the host: a new one from its code, an edit from its
+ * code or its stored script, with the params it keeps. The step a lone add_object and each
+ * add_object of a run_batch share.
+ */
+export declare function compileObject(host: GeometryScriptHost, sceneId: string, bridge: SceneOperations, args: Omit<AddObjectInput, 'compiled'>): Promise<CompiledGeometryScript>;
+/** What a batch's add_object builds with: the host's compile, on the scene open now. */
+export declare function compileObjectOnHost(host: GeometryScriptHost | undefined, bridge: SceneOperations, args: Omit<AddObjectInput, 'compiled'>): Promise<CompiledGeometryScript>;
+/** `add_object` on the MCP: the shared contract and operation, with the host's compile in front. */
+export declare function registerAddObject(server: McpServer, bridge: SceneOperations, host: GeometryScriptHost | undefined): void;
+/** `get_source` on the MCP: the object's module text, read back through the host's store. */
+export declare function registerGetSource(server: McpServer, bridge: SceneOperations, host: GeometryScriptHost | undefined): void;
+//# sourceMappingURL=add-object.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add-object.d.ts","sourceRoot":"","sources":["../../src/tools/add-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE7D,OAAO,EACL,KAAK,cAAc,EAYpB,MAAM,mCAAmC,CAAA;AAQ1C,OAAO,EAEL,KAAK,sBAAsB,EAE3B,wBAAwB,EAExB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAE9B,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAMpD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,8FAA8F;IAC9F,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,OAAO,CAAC,KAAK,EAAE;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,sBAAsB,CAAA;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;QACjD,0IAA0I;QAC1I,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACjC,GAAG,OAAO,CAAC,sBAAsB,GAAG;QAAE,GAAG,EAAE,UAAU,CAAA;KAAE,CAAC,CAAA;IACzD,aAAa,CAAC,KAAK,EAAE;QACnB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,UAAU,CAAA;QACjB,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,wBAAwB,CAAA;KACpC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACnB,wHAAwH;IACxH,YAAY,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IACpF;;;OAGG;IACH,KAAK,CAAC,CAAC,KAAK,EAAE;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,sBAAsB,CAAA;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;QACjD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,mEAAmE;QACnE,IAAI,EAAE,YAAY,CAAA;QAClB,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,wBAAwB,CAAA;KACpC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAA;AAY1F,oHAAoH;AACpH,wBAAsB,eAAe,CACnC,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,EACE,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,MAAM,GACP,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,sBAAsB,CAAA;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAAG,SAAS,CAAA;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC,EACD,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAA;CAAO,GACrE,OAAO,CAAC,sBAAsB,CAAC,CAgCjC;AAYD,wBAAgB,UAAU,CACxB,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GACrC,OAAO,CAAC,sBAAsB,CAAC,CAejC;AAED,wFAAwF;AACxF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GACrC,OAAO,CAAC,sBAAsB,CAAC,CASjC;AAED,oGAAoG;AACpG,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,kBAAkB,GAAG,SAAS,GACnC,IAAI,CAiEN;AASD,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,kBAAkB,GAAG,SAAS,GACnC,IAAI,CAgCN"}