@quenty/studio-bridge 0.23.0 → 0.24.0

package/dist/src/roblox-mcp/index.js

@@ -0,0 +1,3 @@
+export { tryListStudiosAsync, tryExecuteLuauAsync, tryCallStudioToolAsync, closeStudioMcpAsync, } from './roblox-studio-mcp.js';
+export { getStudioMcpSnapshotAsync, resetStudioMcpSnapshot, } from './studio-mcp-snapshot.js';
+//# sourceMappingURL=index.js.map

package/dist/src/roblox-mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/roblox-mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GAMpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GAGvB,MAAM,0BAA0B,CAAC"}

package/dist/src/roblox-mcp/mcp/mcp-stdio-client.d.ts

@@ -0,0 +1,60 @@
+import { type ChildProcessWithoutNullStreams } from 'child_process';
+export declare const MCP_PROTOCOL_VERSION = "2025-06-18";
+export declare class McpTimeoutError extends Error {
+}
+export interface McpTool {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface McpContent {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}
+export interface McpToolResult {
+    isError: boolean;
+    content: McpContent[];
+    text: string;
+}
+export type SpawnMcpProcess = (command: string, args: string[]) => ChildProcessWithoutNullStreams;
+export interface McpStdioClientOptions {
+    args?: string[];
+    env?: Record<string, string>;
+    spawnProcess?: SpawnMcpProcess;
+    requestTimeoutMs?: number;
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+}
+export declare class McpStdioClient {
+    private _child;
+    private _pending;
+    private _nextId;
+    private _buffer;
+    private _stderrTail;
+    private _exitError;
+    private _exited;
+    private _requestTimeoutMs;
+    private _protocolVersion;
+    private _serverInfo;
+    private constructor();
+    static startAsync(command: string, options?: McpStdioClientOptions): Promise<McpStdioClient>;
+    get protocolVersion(): string | undefined;
+    get serverInfo(): {
+        name?: string;
+        version?: string;
+    } | undefined;
+    listToolsAsync(): Promise<McpTool[]>;
+    callToolAsync(name: string, args?: Record<string, unknown>, timeoutMs?: number): Promise<McpToolResult>;
+    requestAsync(method: string, params: unknown, timeoutMs?: number): Promise<unknown>;
+    get isRunning(): boolean;
+    closeAsync(): Promise<void>;
+    private _notify;
+    private _write;
+    private _onStdout;
+    private _onLine;
+    private _fail;
+}
+//# sourceMappingURL=mcp-stdio-client.d.ts.map

package/dist/src/roblox-mcp/mcp/mcp-stdio-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-stdio-client.d.ts","sourceRoot":"","sources":["../../../../src/roblox-mcp/mcp/mcp-stdio-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAG3E,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAMjD,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,KACX,8BAA8B,CAAC;AAEpC,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AASD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,WAAW,CAAkD;IAErE,OAAO;WA+BM,UAAU,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC;IAoC1B,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAExC;IAED,IAAI,UAAU,IAAI;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAEhE;IAEK,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAOpC,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC;IAiBzB,YAAY,CACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,SAAS,SAAyB,GACjC,OAAO,CAAC,OAAO,CAAC;IAenB,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,OAAO;IAmCf,OAAO,CAAC,KAAK;CAQd"}

package/dist/src/roblox-mcp/mcp/mcp-stdio-client.js

@@ -0,0 +1,171 @@
+import { spawn } from 'child_process';
+import { repairListResult } from './repair-list-result.js';
+export const MCP_PROTOCOL_VERSION = '2025-06-18';
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+const STDERR_TAIL_BYTES = 4096;
+const CLOSE_TIMEOUT_MS = 2000;
+export class McpTimeoutError extends Error {
+}
+export class McpStdioClient {
+    _child;
+    _pending = new Map();
+    _nextId = 1;
+    _buffer = '';
+    _stderrTail = '';
+    _exitError;
+    _exited = false;
+    _requestTimeoutMs;
+    _protocolVersion;
+    _serverInfo;
+    constructor(child, requestTimeoutMs) {
+        this._child = child;
+        this._requestTimeoutMs = requestTimeoutMs;
+        child.stdout.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => this._onStdout(chunk));
+        child.stderr.setEncoding('utf8');
+        child.stderr.on('data', (chunk) => {
+            this._stderrTail = (this._stderrTail + chunk).slice(-STDERR_TAIL_BYTES);
+        });
+        child.stdin.on('error', () => { });
+        child.unref?.();
+        for (const stream of [child.stdin, child.stdout, child.stderr]) {
+            stream.unref?.();
+        }
+        child.on('error', (err) => this._fail(err));
+        child.on('close', (code) => {
+            this._exited = true;
+            this._fail(new Error(`Studio's MCP server exited (code ${code ?? 'none'})${this._stderrTail.trim() ? `: ${this._stderrTail.trim()}` : ''}`));
+        });
+    }
+    static async startAsync(command, options = {}) {
+        const spawnProcess = options.spawnProcess ??
+            ((cmd, args) => spawn(cmd, args, {
+                stdio: 'pipe',
+                windowsHide: true,
+                ...(options.env ? { env: options.env } : {}),
+            }));
+        const client = new McpStdioClient(spawnProcess(command, options.args ?? []), options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);
+        try {
+            const result = (await client.requestAsync('initialize', {
+                protocolVersion: MCP_PROTOCOL_VERSION,
+                capabilities: {},
+                clientInfo: options.clientInfo ?? {
+                    name: 'studio-bridge',
+                    version: '0.0.0',
+                },
+            }));
+            client._protocolVersion = result?.protocolVersion;
+            client._serverInfo = result?.serverInfo;
+            client._notify('notifications/initialized');
+        }
+        catch (err) {
+            await client.closeAsync();
+            throw err;
+        }
+        return client;
+    }
+    get protocolVersion() {
+        return this._protocolVersion;
+    }
+    get serverInfo() {
+        return this._serverInfo;
+    }
+    async listToolsAsync() {
+        const result = (await this.requestAsync('tools/list', {}));
+        return Array.isArray(result?.tools) ? result.tools : [];
+    }
+    async callToolAsync(name, args = {}, timeoutMs) {
+        const result = (await this.requestAsync('tools/call', { name, arguments: args }, timeoutMs));
+        const content = Array.isArray(result?.content) ? result.content : [];
+        return {
+            isError: result?.isError === true,
+            content,
+            text: content
+                .filter((c) => c.type === 'text' && typeof c.text === 'string')
+                .map((c) => c.text)
+                .join('\n'),
+        };
+    }
+    requestAsync(method, params, timeoutMs = this._requestTimeoutMs) {
+        if (this._exitError) {
+            return Promise.reject(this._exitError);
+        }
+        const id = this._nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this._pending.delete(id);
+                reject(new McpTimeoutError(`${method} timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this._pending.set(id, { method, resolve, reject, timer });
+            this._write({ jsonrpc: '2.0', id, method, params });
+        });
+    }
+    get isRunning() {
+        return !this._exited;
+    }
+    async closeAsync() {
+        this._fail(new Error("Studio's MCP client was closed"));
+        if (this._exited) {
+            return;
+        }
+        let timer;
+        const exited = new Promise((resolve) => {
+            this._child.once('close', () => resolve());
+            timer = setTimeout(resolve, CLOSE_TIMEOUT_MS);
+        });
+        this._child.stdin.end();
+        this._child.kill();
+        await exited;
+        clearTimeout(timer);
+    }
+    _notify(method, params) {
+        this._write({ jsonrpc: '2.0', method, ...(params ? { params } : {}) });
+    }
+    _write(message) {
+        this._child.stdin.write(JSON.stringify(message) + '\n');
+    }
+    _onStdout(chunk) {
+        this._buffer += chunk;
+        let newline;
+        while ((newline = this._buffer.indexOf('\n')) >= 0) {
+            const line = this._buffer.slice(0, newline).trim();
+            this._buffer = this._buffer.slice(newline + 1);
+            if (line) {
+                this._onLine(line);
+            }
+        }
+    }
+    _onLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (typeof message?.id !== 'number' || message.method !== undefined) {
+            return;
+        }
+        const pending = this._pending.get(message.id);
+        if (!pending) {
+            return;
+        }
+        this._pending.delete(message.id);
+        clearTimeout(pending.timer);
+        if (message.error) {
+            pending.reject(new Error(`${pending.method} failed: ${message.error.message ?? `error ${message.error.code ?? ''}`}`.trim()));
+        }
+        else {
+            pending.resolve(repairListResult(message.result));
+        }
+    }
+    _fail(err) {
+        this._exitError ??= err;
+        for (const pending of this._pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(this._exitError);
+        }
+        this._pending.clear();
+    }
+}
+//# sourceMappingURL=mcp-stdio-client.js.map

package/dist/src/roblox-mcp/mcp/mcp-stdio-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-stdio-client.js","sourceRoot":"","sources":["../../../../src/roblox-mcp/mcp/mcp-stdio-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAuC,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAEjD,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,OAAO,eAAgB,SAAQ,KAAK;CAAG;AAwC7C,MAAM,OAAO,cAAc;IACjB,MAAM,CAAiC;IACvC,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC7C,OAAO,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,EAAE,CAAC;IACb,WAAW,GAAG,EAAE,CAAC;IACjB,UAAU,CAAoB;IAC9B,OAAO,GAAG,KAAK,CAAC;IAChB,iBAAiB,CAAS;IAC1B,gBAAgB,CAAqB;IACrC,WAAW,CAAkD;IAErE,YACE,KAAqC,EACrC,gBAAwB;QAExB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;QAE1C,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,KAAK,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9D,MAAiC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,KAAK,CACR,IAAI,KAAK,CACP,oCAAoC,IAAI,IAAI,MAAM,IAChD,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAC7D,EAAE,CACH,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,UAAU,CACrB,OAAe,EACf,UAAiC,EAAE;QAEnC,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY;YACpB,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACb,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;gBACf,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,IAAI;gBACjB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C,CAAC,CAAC,CAAC;QACR,MAAM,MAAM,GAAG,IAAI,cAAc,CAC/B,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EACzC,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CACvD,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE;gBACtD,eAAe,EAAE,oBAAoB;gBACrC,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI;oBAChC,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,OAAO;iBACjB;aACF,CAAC,CAGD,CAAC;YACF,MAAM,CAAC,gBAAgB,GAAG,MAAM,EAAE,eAAe,CAAC;YAClD,MAAM,CAAC,WAAW,GAAG,MAAM,EAAE,UAAU,CAAC;YACxC,MAAM,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,CAAC,CAExD,CAAC;QACF,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,IAAY,EACZ,OAAgC,EAAE,EAClC,SAAkB;QAElB,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CACrC,YAAY,EACZ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EACzB,SAAS,CACV,CAAkD,CAAC;QACpD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO;YACL,OAAO,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI;YACjC,OAAO;YACP,IAAI,EAAE,OAAO;iBACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAC9D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAClB,IAAI,CAAC,IAAI,CAAC;SACd,CAAC;IACJ,CAAC;IAED,YAAY,CACV,MAAc,EACd,MAAe,EACf,SAAS,GAAG,IAAI,CAAC,iBAAiB;QAElC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACzB,MAAM,CAAC,IAAI,eAAe,CAAC,GAAG,MAAM,oBAAoB,SAAS,IAAI,CAAC,CAAC,CAAC;YAC1E,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS;QACX,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,KAAiC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3C,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,MAAM,CAAC;QACb,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAEO,OAAO,CAAC,MAAc,EAAE,MAAgB;QAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAEO,MAAM,CAAC,OAAgB;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;QACtB,IAAI,OAAe,CAAC;QACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACnD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAC/C,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,IAAY;QAC1B,IAAI,OAKH,CAAC;QACF,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,OAAO,OAAO,EAAE,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACpE,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE5B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,CAAC,MAAM,CACZ,IAAI,KAAK,CACP,GAAG,OAAO,CAAC,MAAM,YACf,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,SAAS,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,EAC5D,EAAE,CAAC,IAAI,EAAE,CACV,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,GAAU;QACtB,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;QACxB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/src/roblox-mcp/mcp/mcp-stdio-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-stdio-client.test.d.ts.map

package/dist/src/roblox-mcp/mcp/mcp-stdio-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-stdio-client.test.d.ts","sourceRoot":"","sources":["../../../../src/roblox-mcp/mcp/mcp-stdio-client.test.ts"],"names":[],"mappings":""}

package/dist/src/roblox-mcp/mcp/mcp-stdio-client.test.js

@@ -0,0 +1,104 @@
+import { describe, expect, it, vi } from 'vitest';
+import { McpStdioClient } from './mcp-stdio-client.js';
+import { createFakeMcpServer, toolText, } from '../test/fake-mcp-server.js';
+const initialize = (method) => method === 'initialize'
+    ? {
+        result: {
+            protocolVersion: '2025-06-18',
+            capabilities: { tools: {} },
+            serverInfo: { name: 'RobloxStudio', version: '1.0.0' },
+        },
+    }
+    : undefined;
+async function startAsync(handler, requestTimeoutMs) {
+    const server = createFakeMcpServer((method, params) => initialize(method, params) ?? handler(method, params));
+    const client = await McpStdioClient.startAsync('StudioMCP.exe', {
+        spawnProcess: () => server.child,
+        requestTimeoutMs,
+    });
+    return { server, client };
+}
+describe('McpStdioClient', () => {
+    it('initializes, then says it is initialized', async () => {
+        const { server, client } = await startAsync(() => undefined);
+        expect(client.protocolVersion).toBe('2025-06-18');
+        expect(client.serverInfo?.name).toBe('RobloxStudio');
+        expect(server.requests.map((r) => r.method)).toEqual([
+            'initialize',
+            'notifications/initialized',
+        ]);
+        await client.closeAsync();
+    });
+    it('lists tools, repairing a list result without caching hints', async () => {
+        const { client } = await startAsync((method) => method === 'tools/list'
+            ? {
+                result: {
+                    resultType: 'complete',
+                    tools: [{ name: 'execute_luau' }],
+                },
+            }
+            : undefined);
+        expect(await client.listToolsAsync()).toEqual([{ name: 'execute_luau' }]);
+        await expect(client.requestAsync('tools/list', {})).resolves.toMatchObject({
+            ttlMs: 0,
+            cacheScope: 'private',
+        });
+        await client.closeAsync();
+    });
+    it('calls a tool and joins its text content', async () => {
+        const { server, client } = await startAsync((method) => method === 'tools/call' ? toolText('42') : undefined);
+        const result = await client.callToolAsync('execute_luau', { code: 'x' });
+        expect(result).toMatchObject({ isError: false, text: '42' });
+        expect(server.requests.at(-1)?.params).toEqual({
+            name: 'execute_luau',
+            arguments: { code: 'x' },
+        });
+        await client.closeAsync();
+    });
+    it('reports a tool error as isError rather than throwing', async () => {
+        const { client } = await startAsync(() => toolText('boom', true));
+        await expect(client.callToolAsync('execute_luau')).resolves.toMatchObject({
+            isError: true,
+            text: 'boom',
+        });
+        await client.closeAsync();
+    });
+    it('rejects a JSON-RPC error with its message', async () => {
+        const { client } = await startAsync(() => ({
+            error: { code: -32602, message: 'bad params' },
+        }));
+        await expect(client.requestAsync('tools/call', {})).rejects.toThrow('tools/call failed: bad params');
+        await client.closeAsync();
+    });
+    it('rejects requests in flight when the server exits, with its stderr', async () => {
+        const { server, client } = await startAsync(() => undefined);
+        const pending = client.callToolAsync('execute_luau');
+        server.exit(3, 'Studio went away');
+        await expect(pending).rejects.toThrow("Studio's MCP server exited (code 3): Studio went away");
+        await expect(client.callToolAsync('execute_luau')).rejects.toThrow('exited');
+    });
+    it('waits for the server to exit when closed', async () => {
+        const { server, client } = await startAsync(() => undefined);
+        await client.closeAsync();
+        expect(server.child.killed).toBe(true);
+        expect(client.isRunning).toBe(false);
+        await expect(client.callToolAsync('execute_luau')).rejects.toThrow('closed');
+    });
+    it('closes a server that already exited without killing it again', async () => {
+        const { server, client } = await startAsync(() => undefined);
+        server.exit(0);
+        await new Promise((resolve) => setImmediate(resolve));
+        await client.closeAsync();
+        expect(server.child.killed).toBe(false);
+    });
+    it('times out a request the server never answers', async () => {
+        const { client } = await startAsync(() => undefined);
+        vi.useFakeTimers({ toFake: ['setTimeout', 'clearTimeout'] });
+        const pending = expect(client.callToolAsync('execute_luau')).rejects.toThrow('tools/call timed out after 30000ms');
+        await vi.advanceTimersByTimeAsync(30_000);
+        await pending;
+        vi.useRealTimers();
+        await client.closeAsync();
+    });
+});
+//# sourceMappingURL=mcp-stdio-client.test.js.map

package/dist/src/roblox-mcp/mcp/mcp-stdio-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-stdio-client.test.js","sourceRoot":"","sources":["../../../../src/roblox-mcp/mcp/mcp-stdio-client.test.ts"],"names":[],"mappings":"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"}

package/dist/src/roblox-mcp/mcp/repair-list-result.d.ts

@@ -0,0 +1,2 @@
+export declare function repairListResult<T>(result: T): T;
+//# sourceMappingURL=repair-list-result.d.ts.map

package/dist/src/roblox-mcp/mcp/repair-list-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-list-result.d.ts","sourceRoot":"","sources":["../../../../src/roblox-mcp/mcp/repair-list-result.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAoBhD"}

package/dist/src/roblox-mcp/mcp/repair-list-result.js

@@ -0,0 +1,22 @@
+const LIST_KEYS = ['tools', 'prompts', 'resources', 'resourceTemplates'];
+export function repairListResult(result) {
+    if (!result || typeof result !== 'object') {
+        return result;
+    }
+    const record = result;
+    if (record.resultType === undefined) {
+        return result;
+    }
+    if (!LIST_KEYS.some((key) => Array.isArray(record[key]))) {
+        return result;
+    }
+    if (record.ttlMs !== undefined && record.cacheScope !== undefined) {
+        return result;
+    }
+    return {
+        ...record,
+        ttlMs: record.ttlMs ?? 0,
+        cacheScope: record.cacheScope ?? 'private',
+    };
+}
+//# sourceMappingURL=repair-list-result.js.map

package/dist/src/roblox-mcp/mcp/repair-list-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-list-result.js","sourceRoot":"","sources":["../../../../src/roblox-mcp/mcp/repair-list-result.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;AAEzE,MAAM,UAAU,gBAAgB,CAAI,MAAS;IAC3C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;KACtC,CAAC;AACT,CAAC"}

package/dist/src/roblox-mcp/mcp/repair-list-result.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=repair-list-result.test.d.ts.map

package/dist/src/roblox-mcp/mcp/repair-list-result.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-list-result.test.d.ts","sourceRoot":"","sources":["../../../../src/roblox-mcp/mcp/repair-list-result.test.ts"],"names":[],"mappings":""}

package/dist/src/roblox-mcp/mcp/repair-list-result.test.js

@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest';
+import { repairListResult } from './repair-list-result.js';
+describe('repairListResult', () => {
+    it('fills in the caching hints a 2026-07-28 list result left out', () => {
+        expect(repairListResult({ resultType: 'complete', tools: [] })).toEqual({
+            resultType: 'complete',
+            tools: [],
+            ttlMs: 0,
+            cacheScope: 'private',
+        });
+    });
+    it('keeps hints the server sent', () => {
+        const result = {
+            resultType: 'complete',
+            tools: [],
+            ttlMs: 500,
+            cacheScope: 'shared',
+        };
+        expect(repairListResult(result)).toBe(result);
+    });
+    it('fills only the hint that is missing', () => {
+        expect(repairListResult({ resultType: 'complete', prompts: [], ttlMs: 10 })).toEqual({
+            resultType: 'complete',
+            prompts: [],
+            ttlMs: 10,
+            cacheScope: 'private',
+        });
+    });
+    it('leaves an older protocol result alone', () => {
+        const result = { tools: [] };
+        expect(repairListResult(result)).toBe(result);
+    });
+    it('leaves a result that is not a list alone', () => {
+        const result = { resultType: 'complete', content: [] };
+        expect(repairListResult(result)).toBe(result);
+    });
+    it('passes non-objects through', () => {
+        expect(repairListResult(undefined)).toBeUndefined();
+        expect(repairListResult('text')).toBe('text');
+    });
+});
+//# sourceMappingURL=repair-list-result.test.js.map

package/dist/src/roblox-mcp/mcp/repair-list-result.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-list-result.test.js","sourceRoot":"","sources":["../../../../src/roblox-mcp/mcp/repair-list-result.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACtE,UAAU,EAAE,UAAU;YACtB,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG;YACb,UAAU,EAAE,UAAU;YACtB,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,GAAG;YACV,UAAU,EAAE,QAAQ;SACrB,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CACJ,gBAAgB,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CACrE,CAAC,OAAO,CAAC;YACR,UAAU,EAAE,UAAU;YACtB,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAE7B,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAEvD,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACpD,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/roblox-mcp/roblox-studio-mcp.d.ts

@@ -0,0 +1,34 @@
+import type { SessionContext, SessionInfo } from '../bridge/types.js';
+import { type SpawnMcpProcess } from './mcp/mcp-stdio-client.js';
+import { type MatchedStudio, type StudioWindow } from './studio/studio-session.js';
+export type StudioMcpTarget = MatchedStudio;
+export type StudioMcpFailure = 'unsupported' | 'unavailable' | 'no-studio' | 'failed' | 'timeout';
+export type StudioMcpResult<T> = {
+    success: true;
+    value: T;
+    studio?: StudioMcpTarget;
+    settled?: boolean;
+} | {
+    success: false;
+    reason: StudioMcpFailure;
+    message: string;
+    studio?: StudioMcpTarget;
+};
+export interface StudioMcpOptions {
+    target?: string;
+    sessions?: SessionInfo[];
+    timeoutMs?: number;
+    executablePath?: string;
+    spawnProcess?: SpawnMcpProcess;
+    listWindowsAsync?: () => Promise<StudioWindow[]>;
+    readPlaceIds?: boolean;
+    sessionPids?: Map<string, number>;
+}
+export interface StudioMcpLuauOptions extends StudioMcpOptions {
+    context?: SessionContext;
+}
+export declare function tryListStudiosAsync(options?: StudioMcpOptions): Promise<StudioMcpResult<StudioMcpTarget[]>>;
+export declare function tryExecuteLuauAsync(code: string, options?: StudioMcpLuauOptions): Promise<StudioMcpResult<string>>;
+export declare function tryCallStudioToolAsync(tool: string, args?: Record<string, unknown>, options?: StudioMcpLuauOptions): Promise<StudioMcpResult<string>>;
+export declare function closeStudioMcpAsync(): Promise<void>;
+//# sourceMappingURL=roblox-studio-mcp.d.ts.map

package/dist/src/roblox-mcp/roblox-studio-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roblox-studio-mcp.d.ts","sourceRoot":"","sources":["../../../src/roblox-mcp/roblox-studio-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EAOL,KAAK,aAAa,EAElB,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,aAAa,GACb,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACxE;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAmBD,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,eAAe,EAAE,CAAC,CAAC,CAS7C;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAElC;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAiClC;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOzD"}