@darkclaw921/umgt 0.0.0-stage → 0.2.0

package/dist/server/reports.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+/** Core determines identity from its session; the browser cannot supply an account. */
+export function registerReports(app, core) {
+    const params = z.object({ id: z.string().uuid() });
+    const message = z
+        .object({
+        body: z.string().trim().min(1).max(10000),
+        attachments: z
+            .array(z
+            .object({
+            name: z.string().min(1).max(150),
+            data: z.string().max(2800000),
+        })
+            .strict())
+            .max(3)
+            .default([]),
+    })
+        .strict();
+    app.get("/api/v1/reports", async (req) => {
+        const query = z
+            .object({
+            limit: z.coerce.number().int().min(1).max(100).default(50),
+            offset: z.coerce.number().int().nonnegative().max(1000000).default(0),
+        })
+            .strict()
+            .parse(req.query);
+        return core.request(`/reports?${new URLSearchParams({ limit: String(query.limit), offset: String(query.offset) })}`);
+    });
+    app.get("/api/v1/reports/:id", async (req) => core.request(`/reports/${params.parse(req.params).id}`));
+    app.post("/api/v1/reports", { bodyLimit: 8500000 }, async (req, reply) => reply
+        .code(201)
+        .send(await core.request("/reports", message
+        .extend({
+        kind: z.enum(["bug", "wish"]),
+        title: z.string().trim().min(1).max(160),
+    })
+        .parse(req.body))));
+    app.post("/api/v1/reports/:id/messages", { bodyLimit: 8500000 }, async (req) => core.request(`/reports/${params.parse(req.params).id}/messages`, message.parse(req.body)));
+}
+//# sourceMappingURL=reports.js.map

package/dist/server/reports.js.map

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

package/dist/server/roblox-assets.d.ts

@@ -0,0 +1,41 @@
+import type { FastifyInstance } from 'fastify';
+import type { Asset, Project, HubSettings } from '../shared/types.js';
+import type { HubContext } from './app.js';
+import type { StudioConnection } from './roblox-connection.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const robloxAssetTerms = "https://en.help.roblox.com/hc/en-us/articles/115004647846-Roblox-Terms-of-Use";
+export declare function robloxResult(result: CallToolResult): unknown;
+export declare function creatorStoreAssets(result: CallToolResult): Asset[];
+export declare function registerRobloxAssets(app: FastifyInstance, hub: HubContext, connection: StudioConnection, settings: () => HubSettings, projectById: (id: string) => Project, assertIdle: (id: string) => void): {
+    search: (p: Project, q: string, type?: string, signal?: AbortSignal) => Promise<{
+        assets: Asset[];
+        warnings: never[];
+    }>;
+    details: (p: Project, id: string) => {
+        provider: string;
+        name: string;
+        type: string;
+        thumbnail?: string;
+        media?: import("../shared/types.js").AssetMedia[];
+        mediaTotal?: number;
+        mediaGalleryUrl?: string;
+        previewVideoUrl?: string;
+        sourceUrl: string;
+        license: string;
+        author?: string;
+        tags: string[];
+        downloadUrl?: string;
+        formats?: string[];
+        importMode: 'automatic' | 'manual';
+        previewAudioUrl?: string;
+        licenseUrl?: string;
+        attribution?: string;
+        provenanceUrl?: string;
+        verifiedAt?: string;
+        id: string;
+    };
+    import: (p: Project, id: string, signal?: AbortSignal) => Promise<Asset & {
+        sourceId?: string;
+        directory: string;
+    }>;
+};

package/dist/server/roblox-assets.js

@@ -0,0 +1,131 @@
+import { mkdir, readFile, writeFile, lstat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+export const robloxAssetTerms = 'https://en.help.roblox.com/hc/en-us/articles/115004647846-Roblox-Terms-of-Use';
+export function robloxResult(result) {
+    if (result.isError)
+        throw new Error(result.content.filter(b => b.type === 'text').map(b => b.text).join('\n'));
+    for (const b of result.content)
+        if (b.type === 'text') {
+            try {
+                return JSON.parse(b.text);
+            }
+            catch { }
+        }
+    throw new Error('Studio returned no asset metadata');
+}
+export function creatorStoreAssets(result) {
+    const data = z.object({ results: z.array(z.object({ assetId: z.string().regex(/^\d+$/), assetType: z.enum(['Model', 'Audio']), name: z.string(), creatorName: z.string().optional(), isFree: z.boolean(), source: z.string(), creatorStoreUrl: z.string().url() })) }).parse(robloxResult(result));
+    return data.results.filter(x => x.isFree && x.source === 'creator_store').map(x => ({ id: x.assetId, provider: 'roblox', name: x.name, type: x.assetType === 'Audio' ? 'audio' : 'models', sourceUrl: `https://create.roblox.com/store/asset/${x.assetId}`, author: x.creatorName ?? 'Creator Store', license: 'Roblox Creator Store', licenseUrl: robloxAssetTerms, provenanceUrl: `https://create.roblox.com/store/asset/${x.assetId}`, verifiedAt: new Date().toISOString(), formats: [x.assetType === 'Audio' ? 'Roblox Audio ID' : 'Roblox Model'], tags: ['roblox', 'creator-store', 'free'], importMode: 'automatic' }));
+}
+export function registerRobloxAssets(app, hub, connection, settings, projectById, assertIdle) {
+    const selected = new Map();
+    const pending = new Set();
+    const project = (id) => { const p = projectById(id); if (p.engine !== 'roblox')
+        throw Object.assign(new Error('Creator Store requires a Roblox project'), { statusCode: 422 }); return p; };
+    const search = async (p, q, type, signal) => {
+        signal?.throwIfAborted();
+        q = z.string().max(200).parse(q);
+        await connection.connect(settings(), signal);
+        const kinds = type === 'audio' ? ['Audio'] : type === 'models' ? ['Model'] : type && type !== 'all' ? [] : ['Model', 'Audio'];
+        const assets = [];
+        for (const assetType of kinds) {
+            const found = creatorStoreAssets(await connection.call(p.id, 'search_asset', { query: q, assetType, scope: 'creator_store', priceFilter: 'free', maxResults: 8 }, signal));
+            assets.push(...found);
+            for (const a of found)
+                selected.set(p.id + ':' + a.id, a);
+        }
+        if (selected.size > 1000) {
+            const keep = assets.map(a => [p.id + ':' + a.id, a]);
+            selected.clear();
+            for (const [key, a] of keep)
+                selected.set(key, a);
+        }
+        return { assets, warnings: [] };
+    };
+    const importSelected = async (p, id, signal) => {
+        signal?.throwIfAborted();
+        const existing = hub.store.project(p.id).list('assets').find(a => a.provider === 'roblox' && (a.sourceId === id || a.id === id));
+        if (existing)
+            return existing;
+        const asset = selected.get(p.id + ':' + id);
+        if (!asset)
+            throw Object.assign(new Error('Find this free asset in Creator Store before importing'), { statusCode: 409 });
+        if (pending.has(p.id))
+            throw Object.assign(new Error('Asset import already running'), { statusCode: 409 });
+        pending.add(p.id);
+        try {
+            await connection.connect(settings(), signal);
+            if ((await connection.playing(p.id, undefined, signal)).playing)
+                throw Object.assign(new Error('Остановите игру перед добавлением ассетов'), { statusCode: 409 });
+            const folder = 'LMHubAssets', name = 'Asset' + id;
+            const setup = await connection.call(p.id, 'execute_luau', { datamodel_type: 'Edit', code: `local r=game:GetService("ReplicatedStorage"); if not r:FindFirstChild("${folder}") then local f=Instance.new("Folder");f.Name="${folder}";f.Parent=r end; return "ready"` }, signal);
+            if (setup.isError)
+                throw new Error('Cannot create asset folder');
+            const inserted = await connection.call(p.id, 'insert_asset', { assetId: id, assetName: name, assetType: asset.type === 'audio' ? 'Audio' : 'Model', parentPath: 'game.ReplicatedStorage.' + folder }, signal);
+            if (inserted.isError)
+                throw new Error(JSON.stringify(inserted.content));
+            const snapshot = robloxResult(await connection.call(p.id, 'execute_luau', { datamodel_type: 'Edit', code: `
+local model=game:GetService("ReplicatedStorage").${folder}:FindFirstChild("${name}");assert(model,"Asset was not inserted"); local removed=0
+for _,d in model:GetDescendants() do if d:IsA("LuaSourceContainer") then d:Destroy();removed+=1 end end
+local node={['$className']='Model'}; local count=0
+local function vector(v) return {v.X,v.Y,v.Z} end
+local function content(v) return tostring(v) end
+if model:IsA('Sound') then node={['$className']='Sound',['$properties']={SoundId=model.SoundId,Volume=0.3,Looped=false}}
+else
+for _,d in model:GetDescendants() do if d:IsA('BasePart') then
+ count+=1;assert(count<=500,'Model too large');d.Anchored=true;d.CanCollide=false;d.CanTouch=false
+ local props={Anchored=true,CanCollide=false,CanTouch=false,Size=vector(d.Size),CFrame={d.CFrame:GetComponents()},Color={d.Color.R,d.Color.G,d.Color.B},Material=d.Material.Value,Transparency=d.Transparency}
+ if d:IsA('MeshPart') then props.MeshId=content(d.MeshId);props.TextureID=content(d.TextureID) end
+ local child={['$className']=d:IsA('MeshPart') and 'MeshPart' or 'Part',['$properties']=props}
+ if d:IsA('Part') then props.Shape=d.Shape.Value end
+ local mesh=d:FindFirstChildOfClass('SpecialMesh');if mesh then child.Mesh={['$className']='SpecialMesh',['$properties']={MeshId=content(mesh.MeshId),TextureId=content(mesh.TextureId),MeshType=mesh.MeshType.Value,Scale=vector(mesh.Scale),Offset=vector(mesh.Offset)}} end
+ node['Part'..count]=child
+end end
+end
+return game:GetService('HttpService'):JSONEncode({node=node,parts=count,removedScripts=removed})` }, signal));
+            const parsed = z.object({ node: z.record(z.string(), z.unknown()), parts: z.number(), removedScripts: z.number() }).parse(snapshot);
+            const manifestPath = join(p.path, 'default.project.json'), manifest = JSON.parse(await readFile(manifestPath, 'utf8'));
+            manifest.tree.ReplicatedStorage ??= { $className: 'ReplicatedStorage' };
+            manifest.tree.ReplicatedStorage.LMHubAssets ??= { $className: 'Folder' };
+            manifest.tree.ReplicatedStorage.LMHubAssets[name] = parsed.node;
+            const directory = `assets/roblox-${id}`;
+            for (const path of [join(p.path, 'assets'), join(p.path, directory)]) {
+                try {
+                    if ((await lstat(path)).isSymbolicLink())
+                        throw new Error('Asset path is a symlink');
+                }
+                catch (e) {
+                    if (e.code !== 'ENOENT')
+                        throw e;
+                }
+            }
+            await mkdir(join(p.path, directory), { recursive: true });
+            const record = { ...asset, id: 'roblox-' + id, sourceId: id, importedAt: new Date().toISOString(), directory, files: ['asset.json', 'CREDITS.txt'], nativePath: 'ReplicatedStorage.' + folder + '.' + name, removedScripts: parsed.removedScripts, parts: parsed.parts };
+            await writeFile(join(p.path, directory, 'asset.json'), JSON.stringify({ record, scene: parsed.node }, null, 2));
+            await writeFile(join(p.path, directory, 'CREDITS.txt'), `${asset.name}\nAuthor: ${asset.author}\nSource: ${asset.sourceUrl}\nTerms: ${robloxAssetTerms}\nFree to use in Roblox under Creator Store terms; not CC0.\nImported scripts removed; decorative collisions disabled.\n`);
+            await writeFile(manifestPath, JSON.stringify(manifest, null, 2));
+            hub.store.project(p.id).put('assets', record);
+            hub.events.publish('asset.imported', record, p.id);
+            return record;
+        }
+        finally {
+            pending.delete(p.id);
+        }
+    };
+    app.get('/api/v1/projects/:id/roblox/assets', async (request) => search(project(request.params.id), request.query.q ?? '', request.query.type));
+    app.post('/api/v1/projects/:id/roblox/assets', async (request) => {
+        const p = project(request.params.id);
+        assertIdle(p.id);
+        const { id } = z.object({ id: z.string().regex(/^\d+$/) }).strict().parse(request.body);
+        return importSelected(p, id);
+    });
+    const details = (p, id) => {
+        const known = selected.get(p.id + ':' + id) ?? hub.store.project(p.id).list('assets').find(a => a.provider === 'roblox' && (a.sourceId === id || a.id === id));
+        if (!known)
+            throw Object.assign(new Error('Search Creator Store before requesting this asset'), { statusCode: 404 });
+        return { ...known, id: known.sourceId ?? known.id };
+    };
+    return { search, details, import: importSelected };
+}
+//# sourceMappingURL=roblox-assets.js.map

package/dist/server/roblox-assets.js.map

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

package/dist/server/roblox-connection.d.ts

@@ -0,0 +1,54 @@
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { HubSettings, Diagnostic } from '../shared/types.js';
+import type { AgentMcpServer } from './agents/types.js';
+export declare const markerName = "LMGameHubProject";
+export interface StudioInstance {
+    id: string;
+    name: string;
+    placeId?: string;
+}
+export declare class StudioConnectionError extends Error {
+    reason: 'permission_denied' | 'mcp_missing' | 'connection_failed' | 'protocol_error' | 'target_missing' | 'target_ambiguous';
+    constructor(reason: 'permission_denied' | 'mcp_missing' | 'connection_failed' | 'protocol_error' | 'target_missing' | 'target_ambiguous', message: string);
+}
+export declare function discoverStudioMcp(settings: HubSettings): Promise<AgentMcpServer | undefined>;
+export declare function parseStudios(result: unknown): StudioInstance[];
+export declare function markerMatches(result: unknown, projectId: string): boolean;
+/** Studio's built-in GetStudioState tool returns this explicit mode line. */
+export declare function studioPlayState(result: CallToolResult): boolean;
+export declare class StudioConnection {
+    private options;
+    private client?;
+    private transport?;
+    private opening?;
+    private tools;
+    private signature;
+    private controller;
+    private toolsChanged;
+    constructor(options?: {
+        discoveryTimeoutMs?: number;
+        preferredStudio?: (projectId: string) => string | undefined;
+    });
+    connect(settings: HubSettings, signal?: AbortSignal): Promise<void>;
+    private open;
+    private refreshTools;
+    raw(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<CallToolResult>;
+    instances(signal?: AbortSignal): Promise<StudioInstance[]>;
+    owns(studioId: string, projectId: string, signal?: AbortSignal): Promise<boolean>;
+    target(projectId: string, signal?: AbortSignal): Promise<StudioInstance>;
+    scopedTools(): Tool[];
+    call(projectId: string, name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<CallToolResult>;
+    private playTool;
+    playing(projectId: string, studioId?: string, signal?: AbortSignal): Promise<{
+        playing: boolean;
+        studioId: string;
+    }>;
+    setPlaying(projectId: string, playing: boolean, signal?: AbortSignal, timeoutMs?: number): Promise<{
+        playing: boolean;
+        studioId: string;
+    }>;
+    close(): Promise<void>;
+}
+export declare function diagnoseStudioMcp(settings: HubSettings, signal?: AbortSignal): Promise<Diagnostic & {
+    reason?: string;
+}>;

package/dist/server/roblox-connection.js

@@ -0,0 +1,331 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { ToolListChangedNotificationSchema } from '@modelcontextprotocol/sdk/types.js';
+import { stat } from 'node:fs/promises';
+import { setTimeout as delay } from 'node:timers/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { detectRoblox } from './roblox.js';
+export const markerName = 'LMGameHubProject';
+export class StudioConnectionError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.reason = reason;
+    }
+}
+export async function discoverStudioMcp(settings) {
+    const explicit = settings.robloxMcpPath?.trim();
+    if (explicit)
+        return await stat(explicit).then(x => x.isFile() ? (process.platform === 'win32' && /\.(bat|cmd)$/i.test(explicit) ? { command: 'cmd.exe', args: ['/d', '/s', '/c', `"${explicit}"`], env: {} } : { command: explicit, args: [], env: {} }) : undefined).catch(() => undefined);
+    if (process.platform === 'win32') {
+        const launcher = join(process.env.LOCALAPPDATA ?? join(homedir(), 'AppData/Local'), 'Roblox/mcp.bat');
+        return await stat(launcher).then(x => x.isFile() ? { command: 'cmd.exe', args: ['/d', '/s', '/c', `"${launcher}"`], env: {} } : undefined).catch(() => undefined);
+    }
+    const studio = await detectRoblox(settings.robloxStudioPath);
+    return studio.mcpExecutable ? { command: studio.mcpExecutable, args: [], env: {} } : undefined;
+}
+function values(value) {
+    if (Array.isArray(value))
+        return value.flatMap(values);
+    if (value && typeof value === 'object') {
+        const object = value;
+        return [object, ...Object.values(object).flatMap(values)];
+    }
+    if (typeof value === 'string') {
+        try {
+            return [value, ...values(JSON.parse(value))];
+        }
+        catch {
+            return [value];
+        }
+    }
+    return [];
+}
+export function parseStudios(result) {
+    const studios = new Map();
+    for (const value of values(result)) {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            continue;
+        const record = value;
+        const id = record.studio_id ?? record.studioId ?? record.id;
+        const name = record.name ?? record.studio_name ?? record.place_name;
+        if (typeof id === 'string' && id.length <= 200 && id.trim() && typeof name === 'string')
+            studios.set(id, { id, name, placeId: String(record.place_id ?? record.placeId ?? '') || undefined });
+    }
+    // Some Studio builds return a prose list rather than structured JSON.
+    if (!studios.size)
+        for (const value of values(result))
+            if (typeof value === 'string') {
+                const pattern = /(?:studio[_ ]id|studioId)\s*[:=]\s*[`"']?([a-zA-Z0-9_-]{1,200})[`"']?/gi;
+                for (const match of value.matchAll(pattern))
+                    studios.set(match[1], { id: match[1], name: match[1] });
+            }
+    return [...studios.values()];
+}
+export function markerMatches(result, projectId) {
+    if (result?.isError)
+        return false;
+    // Exact leaf values only. A partial UUID, script text or error mentioning the
+    // project cannot establish ownership.
+    return values(result).some(value => value === projectId || value === JSON.stringify(projectId));
+}
+/** Studio's built-in GetStudioState tool returns this explicit mode line. */
+export function studioPlayState(result) {
+    if (result.isError)
+        throw new StudioConnectionError('connection_failed', 'get_studio_state вернул ошибку. Состояние Play не подтверждено.');
+    const modes = new Set();
+    for (const block of result.content)
+        if (block.type === 'text')
+            for (const match of block.text.matchAll(/^\s*-?\s*Current Studio Mode:\s*(Play|Edit)\s*$/gmi))
+                modes.add(match[1].toLowerCase() === 'play');
+    if (modes.size !== 1)
+        throw new StudioConnectionError('protocol_error', 'Неизвестный ответ get_studio_state: ожидается Current Studio Mode: Play или Edit. Состояние игры не подтверждено; проверьте Studio MCP.');
+    return [...modes][0];
+}
+export class StudioConnection {
+    options;
+    client;
+    transport;
+    opening;
+    tools = [];
+    signature = '';
+    controller = new AbortController();
+    toolsChanged = true;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async connect(settings, signal) {
+        signal?.throwIfAborted();
+        const config = await discoverStudioMcp(settings);
+        if (!config)
+            throw new StudioConnectionError('mcp_missing', 'StudioMCP не найден. Обновите Studio; путь к MCP можно переопределить в дополнительных настройках.');
+        const signature = JSON.stringify(config);
+        if (this.client && this.signature === signature) {
+            await this.refreshTools(signal);
+            return;
+        }
+        if (this.opening) {
+            await this.opening;
+            return this.connect(settings, signal);
+        }
+        this.opening = this.open(config, signature, signal);
+        try {
+            await this.opening;
+        }
+        finally {
+            this.opening = undefined;
+        }
+    }
+    async open(config, signature, signal) {
+        await this.close();
+        this.controller = new AbortController();
+        signal = signal ? AbortSignal.any([signal, this.controller.signal]) : this.controller.signal;
+        const transport = new StdioClientTransport({ ...config, stderr: 'pipe' }), client = new Client({ name: 'lm-game-hub-studio', version: '0.1.0' });
+        client.setNotificationHandler(ToolListChangedNotificationSchema, () => { if (this.client === client)
+            this.toolsChanged = true; });
+        let denied = false;
+        transport.stderr?.on('data', chunk => { if (/operation not permitted|permission denied|access is denied|os error (?:1|13)/i.test(String(chunk)))
+            denied = true; });
+        // Close the spawned proxy on cancellation, including during initialize.
+        const abort = () => { void transport.close(); };
+        signal?.addEventListener('abort', abort, { once: true });
+        try {
+            await client.connect(transport, { timeout: 12_000, signal });
+            // StudioMCP starts before a Studio window has registered. Its first list
+            // can be empty or contain only list_roblox_studios; execute_luau arrives
+            // with tools/list_changed. Keep this proxy alive so Studio can join it.
+            this.client = client;
+            this.transport = transport;
+            this.signature = signature;
+            await this.refreshTools(signal);
+            client.onclose = () => { if (this.client === client) {
+                this.client = undefined;
+                this.tools = [];
+            } };
+        }
+        catch (error) {
+            if (this.client === client) {
+                this.client = undefined;
+                this.transport = undefined;
+                this.tools = [];
+                this.signature = '';
+            }
+            await client.close().catch(() => { });
+            await transport.close().catch(() => { });
+            signal?.throwIfAborted();
+            if (denied)
+                throw new StudioConnectionError('permission_denied', 'Среда запрещает локальные сокеты StudioMCP (Operation not permitted). Запустите Hub в обычной локальной сессии с доступом к loopback; Hub не меняет разрешения CLI.');
+            if (error instanceof StudioConnectionError)
+                throw error;
+            throw new StudioConnectionError('connection_failed', 'StudioMCP не отвечает. Войдите в Studio, откройте place и включите Assistant → … → Manage MCP Servers → Enable Studio as MCP server. Затем нажмите «Проверить подключение».');
+        }
+        finally {
+            signal?.removeEventListener('abort', abort);
+        }
+    }
+    async refreshTools(signal) {
+        const client = this.client;
+        if (!client)
+            throw new StudioConnectionError('connection_failed', 'Соединение со Studio закрыто. Повторите проверку.');
+        signal = signal ? AbortSignal.any([signal, this.controller.signal]) : this.controller.signal;
+        const tools = [], cursors = new Set();
+        let cursor;
+        this.toolsChanged = false;
+        do {
+            const page = await client.listTools(cursor ? { cursor } : {}, { timeout: 12_000, signal });
+            tools.push(...page.tools);
+            cursor = page.nextCursor;
+            if (tools.length > 300 || cursor && cursors.has(cursor))
+                throw new StudioConnectionError('protocol_error', 'StudioMCP вернул некорректный список инструментов.');
+            if (cursor)
+                cursors.add(cursor);
+        } while (cursor);
+        if (this.client === client)
+            this.tools = tools;
+    }
+    async raw(name, args, signal) {
+        if (!this.client)
+            throw new StudioConnectionError('connection_failed', 'Соединение со Studio закрыто. Повторите проверку.');
+        return await this.client.callTool({ name, arguments: args }, undefined, { timeout: name === 'execute_luau' ? 90_000 : 30_000, signal });
+    }
+    async instances(signal) {
+        if (this.toolsChanged)
+            await this.refreshTools(signal);
+        if (!this.tools.some(tool => tool.name === 'list_roblox_studios'))
+            return [];
+        const result = await this.raw('list_roblox_studios', {}, signal);
+        if (result.isError)
+            throw new StudioConnectionError('connection_failed', 'Studio MCP не вернула подключённые окна. Включите Assistant → … → Manage MCP Servers → Enable Studio as MCP server и повторите проверку.');
+        return parseStudios(result);
+    }
+    async owns(studioId, projectId, signal) {
+        const tool = this.tools.find(x => x.name === 'execute_luau');
+        const properties = tool?.inputSchema.properties ?? {};
+        const codeKey = ['code', 'luau_code', 'script'].find(key => properties[key]?.type === 'string');
+        const modelSchema = properties.datamodel_type;
+        if (!codeKey || properties.studio_id?.type !== 'string' || modelSchema?.type !== 'string' || modelSchema.enum && !modelSchema.enum.includes('Edit') || tool?.inputSchema.required?.some(key => ![codeKey, 'studio_id', 'datamodel_type'].includes(key)))
+            throw new StudioConnectionError('protocol_error', 'Схема execute_luau не позволяет проверить идентификатор проекта в указанном окне Studio. Подробности можно получить через scripts/diagnose-roblox-mcp.mjs.');
+        const code = `local r = game:GetService("ReplicatedStorage"):FindFirstChild("${markerName}"); return if r and r:IsA("StringValue") then r.Value else ""`;
+        let result = await this.raw('execute_luau', { studio_id: studioId, datamodel_type: 'Edit', [codeKey]: code }, signal);
+        // Play exposes Server/Client instead of Edit. The replicated project
+        // marker can still be read without modifying the running game.
+        if (result.isError && (!modelSchema.enum || modelSchema.enum.includes('Server'))) {
+            this.playTool('get_studio_state');
+            const playing = studioPlayState(await this.raw('get_studio_state', { studio_id: studioId }, signal));
+            if (playing)
+                result = await this.raw('execute_luau', { studio_id: studioId, datamodel_type: 'Server', [codeKey]: code }, signal);
+        }
+        if (result.isError)
+            throw new StudioConnectionError('protocol_error', 'Studio MCP не смог прочитать идентификатор проекта в Edit. Проверка остановлена; существующая сцена не будет открыта повторно.');
+        return markerMatches(result, projectId);
+    }
+    async target(projectId, signal) {
+        signal = signal ? AbortSignal.any([signal, this.controller.signal]) : this.controller.signal;
+        const matches = [];
+        const deadline = Date.now() + (this.options.discoveryTimeoutMs ?? 5000);
+        let instances = [];
+        do {
+            await this.refreshTools(signal);
+            instances = await this.instances(signal);
+            // A registered window can announce its tools after list_studios returns.
+            if (instances.length) {
+                await this.refreshTools(signal);
+                if (this.tools.some(tool => tool.name === 'execute_luau'))
+                    break;
+            }
+            if (Date.now() >= deadline)
+                break;
+            await delay(Math.min(250, deadline - Date.now()), undefined, { signal });
+        } while (true);
+        if (!this.tools.length)
+            throw new StudioConnectionError('connection_failed', 'Studio MCP запущен, но Studio не передала инструменты. В открытой сцене включите Assistant → … → Manage MCP Servers → Enable Studio as MCP server, затем нажмите «Проверить подключение».');
+        if (!this.tools.some(tool => tool.name === 'list_roblox_studios'))
+            throw new StudioConnectionError('protocol_error', 'StudioMCP не предоставил list_roblox_studios для безопасного выбора окна. Проверьте подключение через scripts/diagnose-roblox-mcp.mjs.');
+        if (!instances.length)
+            throw new StudioConnectionError('connection_failed', 'Studio MCP запущен, но ни одно окно Studio не подключено. В открытой сцене включите Assistant → … → Manage MCP Servers → Enable Studio as MCP server, затем нажмите «Проверить подключение».');
+        if (!this.tools.some(tool => tool.name === 'execute_luau'))
+            throw new StudioConnectionError('protocol_error', 'Окно Studio подключено, но MCP ещё не предоставил execute_luau для проверки проекта. Повторите проверку; подробности доступны через scripts/diagnose-roblox-mcp.mjs.');
+        if (instances.length > 20)
+            throw new StudioConnectionError('target_ambiguous', 'Слишком много окон Studio для безопасного выбора. Закройте лишние окна.');
+        for (const studio of instances)
+            if (await this.owns(studio.id, projectId, signal))
+                matches.push(studio);
+        const preferred = this.options.preferredStudio?.(projectId), selected = matches.find(studio => studio.id === preferred);
+        if (selected)
+            return selected;
+        if (matches.length > 1)
+            throw new StudioConnectionError('target_ambiguous', 'Открыто несколько копий place этого проекта. Закройте лишнюю копию и повторите проверку.');
+        if (!matches.length)
+            throw new StudioConnectionError('target_missing', 'Place этого проекта не подключён. Нажмите «Настроить автоматически»: Hub откроет сборку с идентификатором проекта. Включите Studio MCP, если это первый запуск.');
+        return matches[0];
+    }
+    scopedTools() { return this.tools.filter(tool => !['upload_image', 'subagent'].includes(tool.name) && (tool.name === 'list_roblox_studios' || tool.inputSchema.properties?.studio_id?.type === 'string')); }
+    async call(projectId, name, args, signal) {
+        const target = await this.target(projectId, signal);
+        if (!this.scopedTools().some(tool => tool.name === name))
+            throw new Error('Инструмент недоступен в подключении проекта');
+        if (name === 'list_roblox_studios')
+            return { content: [{ type: 'text', text: JSON.stringify({ studios: [{ studio_id: target.id, name: target.name, place_id: target.placeId }] }) }] };
+        if (args.studio_id !== undefined && args.studio_id !== target.id)
+            throw new Error('Запрещено обращаться к другому окну Studio');
+        return this.raw(name, { ...args, studio_id: target.id }, signal);
+    }
+    playTool(name) {
+        const tool = this.scopedTools().find(tool => tool.name === name), properties = tool?.inputSchema.properties ?? {};
+        const keys = name === 'start_stop_play' ? ['studio_id', 'is_start'] : ['studio_id'];
+        if (!tool || properties.studio_id?.type !== 'string' || name === 'start_stop_play' && properties.is_start?.type !== 'boolean' || tool.inputSchema.required?.some(key => !keys.includes(key)))
+            throw new StudioConnectionError('protocol_error', `Схема ${name} не поддерживает безопасное управление Play. Ожидается studio_id${name === 'start_stop_play' ? ' и boolean is_start' : ''}; проверьте схемы через scripts/diagnose-roblox-mcp.mjs.`);
+    }
+    async playing(projectId, studioId, signal) {
+        const target = await this.target(projectId, signal);
+        if (studioId !== undefined && target.id !== studioId)
+            throw new StudioConnectionError('target_missing', 'Окно Studio изменилось во время запуска игры. Команда остановлена; повторите проверку подключения.');
+        this.playTool('get_studio_state');
+        return { playing: studioPlayState(await this.raw('get_studio_state', { studio_id: target.id }, signal)), studioId: target.id };
+    }
+    async setPlaying(projectId, playing, signal, timeoutMs = 15_000) {
+        const before = await this.playing(projectId, undefined, signal);
+        this.playTool('start_stop_play');
+        if (before.playing === playing)
+            return before;
+        // Revalidate ownership immediately before the mutation and pin subsequent
+        // confirmation to that same window, even if another project copy appears.
+        const target = await this.target(projectId, signal);
+        if (target.id !== before.studioId)
+            throw new StudioConnectionError('target_missing', 'Окно Studio изменилось перед командой Play. Повторите проверку подключения.');
+        this.playTool('start_stop_play');
+        const result = await this.raw('start_stop_play', { studio_id: target.id, is_start: playing }, signal);
+        if (result.isError) {
+            const detail = result.content.filter(block => block.type === 'text').map(block => block.text).join('\n').slice(0, 2000);
+            throw new StudioConnectionError('connection_failed', `Studio не смогла ${playing ? 'запустить' : 'остановить'} Play${detail ? ': ' + detail : '.'}`);
+        }
+        const deadline = Date.now() + timeoutMs;
+        do {
+            const state = await this.playing(projectId, before.studioId, signal);
+            if (state.playing === playing)
+                return state;
+            if (Date.now() >= deadline)
+                break;
+            await delay(Math.min(250, deadline - Date.now()), undefined, { signal });
+        } while (true);
+        throw new StudioConnectionError('connection_failed', `Studio не подтвердила ${playing ? 'запуск' : 'остановку'} Play. Проверьте состояние игры в Studio и повторите команду.`);
+    }
+    async close() { this.controller.abort(); const client = this.client, transport = this.transport; this.client = undefined; this.transport = undefined; this.tools = []; this.signature = ''; await client?.close().catch(() => { }); await transport?.close().catch(() => { }); }
+}
+export async function diagnoseStudioMcp(settings, signal) {
+    const connection = new StudioConnection();
+    try {
+        await connection.connect(settings, signal);
+        const instances = await connection.instances(signal);
+        return { id: 'roblox-mcp', name: 'Studio MCP', available: true, message: `MCP initialize выполнен; подключено окон: ${instances.length}. Доступ агента требует совпадения идентификатора проекта.` };
+    }
+    catch (error) {
+        signal?.throwIfAborted();
+        return { id: 'roblox-mcp', name: 'Studio MCP', available: false, reason: error instanceof StudioConnectionError ? error.reason : 'connection_failed', message: error instanceof Error ? error.message : String(error) };
+    }
+    finally {
+        await connection.close();
+    }
+}
+//# sourceMappingURL=roblox-connection.js.map