unreal-engine-mcp-server 0.5.21 → 0.5.30

package/dist/tools/blueprint.js

@@ -1,828 +0,0 @@
-import { BaseTool } from './base-tool.js';
-import { Logger } from '../utils/logger.js';
-import { validateAssetParams, concurrencyDelay } from '../utils/validation.js';
-import { coerceString } from '../utils/result-helpers.js';
-export class BlueprintTools extends BaseTool {
-    log = new Logger('BlueprintTools');
-    pluginBlueprintActionsAvailable = null;
-    async sendAction(action, payload = {}, options) {
-        const envDefault = Number(process.env.MCP_AUTOMATION_REQUEST_TIMEOUT_MS ?? '120000');
-        const defaultTimeout = Number.isFinite(envDefault) && envDefault > 0 ? envDefault : 120000;
-        const finalTimeout = typeof options?.timeoutMs === 'number' && options?.timeoutMs > 0 ? options.timeoutMs : defaultTimeout;
-        try {
-            const response = await this.sendAutomationRequest(action, payload, { timeoutMs: finalTimeout, waitForEvent: !!options?.waitForEvent, waitForEventTimeoutMs: options?.waitForEventTimeoutMs });
-            const success = response && response.success !== false;
-            const result = (response.result ?? response);
-            return { success, message: response.message ?? undefined, error: response.success === false ? (response.error ?? response.message) : undefined, result, requestId: response.requestId };
-        }
-        catch (err) {
-            const errMsg = err instanceof Error ? err.message : String(err);
-            return { success: false, error: errMsg, message: errMsg };
-        }
-    }
-    isUnknownActionResponse(res) {
-        if (!res)
-            return false;
-        const errStr = typeof res.error === 'string' ? res.error : '';
-        const msgStr = typeof res.message === 'string' ? res.message : '';
-        const txt = (errStr || msgStr).toLowerCase();
-        return txt.includes('unknown_action') || txt.includes('unknown automation action') || txt.includes('not_implemented') || txt === 'unknown_plugin_action';
-    }
-    buildCandidates(rawName) {
-        const trimmed = coerceString(rawName)?.trim();
-        if (!trimmed)
-            return [];
-        const normalized = trimmed.replace(/\\/g, '/').replace(/\/\/+/g, '/');
-        const withoutLeading = normalized.replace(/^\/+/, '');
-        const basename = withoutLeading.split('/').pop() ?? withoutLeading;
-        const candidates = [];
-        if (normalized.includes('/')) {
-            if (normalized.startsWith('/'))
-                candidates.push(normalized);
-            if (basename) {
-                candidates.push(`/Game/Blueprints/${basename}`);
-                candidates.push(`/Game/${basename}`);
-            }
-            if (!normalized.startsWith('/'))
-                candidates.push(`/${withoutLeading}`);
-        }
-        else {
-            if (basename) {
-                candidates.push(`/Game/Blueprints/${basename}`);
-                candidates.push(`/Game/${basename}`);
-            }
-            candidates.push(normalized);
-            candidates.push(`/${withoutLeading}`);
-        }
-        return candidates.filter(Boolean);
-    }
-    async createBlueprint(params) {
-        try {
-            const validation = validateAssetParams({ name: params.name, savePath: params.savePath || '/Game/Blueprints' });
-            if (!validation.valid)
-                return { success: false, message: `Failed to create blueprint: ${validation.error}`, error: validation.error };
-            const sanitized = validation.sanitized;
-            const payload = { name: sanitized.name, blueprintType: params.blueprintType ?? 'Actor', savePath: sanitized.savePath ?? '/Game/Blueprints', parentClass: params.parentClass, properties: params.properties, waitForCompletion: !!params.waitForCompletion };
-            await concurrencyDelay();
-            if (this.pluginBlueprintActionsAvailable === false) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_create' };
-            }
-            const envPluginTimeout = Number(process.env.MCP_AUTOMATION_PLUGIN_CREATE_TIMEOUT_MS ?? process.env.MCP_AUTOMATION_REQUEST_TIMEOUT_MS ?? '15000');
-            const pluginTimeout = Number.isFinite(envPluginTimeout) && envPluginTimeout > 0 ? envPluginTimeout : 15000;
-            try {
-                const res = await this.sendAction('blueprint_create', payload, { timeoutMs: typeof params.timeoutMs === 'number' ? params.timeoutMs : pluginTimeout, waitForEvent: !!params.waitForCompletion, waitForEventTimeoutMs: params.waitForCompletionTimeoutMs });
-                if (res && res.success) {
-                    this.pluginBlueprintActionsAvailable = true;
-                    const createdPath = `${sanitized.savePath}/${sanitized.name}`.replace('//', '/');
-                    return {
-                        ...res,
-                        blueprint: res.result ?? { name: sanitized.name },
-                        blueprintPath: createdPath,
-                        path: createdPath,
-                        message: res.message || `Created blueprint ${sanitized.name}`
-                    };
-                }
-                if (res && this.isUnknownActionResponse(res)) {
-                    this.pluginBlueprintActionsAvailable = false;
-                    return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_create' };
-                }
-                return res;
-            }
-            catch (err) {
-                const errTxt = String(err ?? '');
-                const isTimeout = errTxt.includes('Request timed out') || errTxt.includes('-32001') || errTxt.toLowerCase().includes('timeout');
-                if (isTimeout) {
-                    this.pluginBlueprintActionsAvailable = false;
-                }
-                return { success: false, error: String(err), message: String(err) };
-            }
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async modifyConstructionScript(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath)
-            return { success: false, message: 'Blueprint path is required', error: 'INVALID_BLUEPRINT_PATH' };
-        if (!Array.isArray(params.operations) || params.operations.length === 0)
-            return { success: false, message: 'At least one SCS operation is required', error: 'MISSING_OPERATIONS' };
-        const operations = params.operations.map((op) => {
-            if (op && typeof op === 'object' && op.op && !op.type) {
-                return { ...op, type: op.op };
-            }
-            return op;
-        });
-        const payload = { blueprintPath, operations };
-        if (typeof params.compile === 'boolean')
-            payload.compile = params.compile;
-        if (typeof params.save === 'boolean')
-            payload.save = params.save;
-        const res = await this.sendAction('blueprint_modify_scs', payload, { timeoutMs: params.timeoutMs, waitForEvent: !!params.waitForCompletion, waitForEventTimeoutMs: params.waitForCompletionTimeoutMs });
-        if (res && res.result && typeof res.result === 'object' && res.result?.error === 'SCS_UNAVAILABLE') {
-            this.pluginBlueprintActionsAvailable = false;
-            return { success: false, error: 'SCS_UNAVAILABLE', message: 'Plugin does not support construction script modification (blueprint_modify_scs)' };
-        }
-        if (res && res.success)
-            this.pluginBlueprintActionsAvailable = true;
-        if (res && this.isUnknownActionResponse(res)) {
-            this.pluginBlueprintActionsAvailable = false;
-        }
-        return res;
-    }
-    async addComponent(params) {
-        const blueprintName = coerceString(params.blueprintName);
-        if (!blueprintName)
-            return { success: false, message: 'Blueprint name is required', error: 'INVALID_BLUEPRINT' };
-        const componentClass = coerceString(params.componentType);
-        if (!componentClass)
-            return { success: false, message: 'Component class is required', error: 'INVALID_COMPONENT_CLASS' };
-        const rawComponentName = coerceString(params.componentName) ?? params.componentName;
-        if (!rawComponentName)
-            return { success: false, message: 'Component name is required', error: 'INVALID_COMPONENT_NAME' };
-        const sanitizedComponentName = rawComponentName.replace(/[^A-Za-z0-9_]/g, '_');
-        const candidates = this.buildCandidates(blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        try {
-            const op = { type: 'add_component', componentName: sanitizedComponentName, componentClass, attachTo: params.attachTo, transform: params.transform, properties: params.properties };
-            const svcResult = await this.modifyConstructionScript({ blueprintPath: primary, operations: [op], compile: params.compile, save: params.save, timeoutMs: params.timeoutMs, waitForCompletion: params.waitForCompletion, waitForCompletionTimeoutMs: params.waitForCompletionTimeoutMs });
-            if (svcResult && svcResult.success) {
-                this.pluginBlueprintActionsAvailable = true;
-                return { ...svcResult, component: sanitizedComponentName, componentName: sanitizedComponentName, componentType: componentClass, componentClass, blueprintPath: svcResult.blueprintPath ?? primary };
-            }
-            if (svcResult && (this.isUnknownActionResponse(svcResult) || (svcResult.error && svcResult.error === 'SCS_UNAVAILABLE'))) {
-                this.pluginBlueprintActionsAvailable = false;
-                return { success: false, error: 'SCS_UNAVAILABLE', message: 'Plugin does not support construction script modification (blueprint_modify_scs)' };
-            }
-            return svcResult;
-        }
-        catch (err) {
-            return { success: false, error: String(err) };
-        }
-    }
-    async waitForBlueprint(blueprintRef, options) {
-        const candidates = Array.isArray(blueprintRef) ? blueprintRef : this.buildCandidates(blueprintRef);
-        if (!candidates || candidates.length === 0)
-            return { success: false, error: 'Invalid blueprint reference', checked: [] };
-        const shouldExist = options?.shouldExist !== false;
-        if (this.pluginBlueprintActionsAvailable === false) {
-            return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_exists' };
-        }
-        const envDefault = Number(process.env.MCP_AUTOMATION_SCS_TIMEOUT_MS ?? process.env.MCP_AUTOMATION_REQUEST_TIMEOUT_MS ?? '15000');
-        const defaultTimeout = Number.isFinite(envDefault) && envDefault > 0 ? envDefault : 15000;
-        const totalTimeout = typeof options?.timeoutMs === 'number' && options.timeoutMs > 0 ? options.timeoutMs : defaultTimeout;
-        const perCheck = Math.min(5000, Math.max(shouldExist ? 1000 : 250, Math.floor(totalTimeout / Math.max(shouldExist ? 6 : 1, 1))));
-        const unknownResponse = () => {
-            this.pluginBlueprintActionsAvailable = false;
-            return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_exists' };
-        };
-        const successResponse = (candidate, resolvedPath) => {
-            this.pluginBlueprintActionsAvailable = true;
-            return { success: true, found: resolvedPath ?? candidate };
-        };
-        const notFoundResponse = () => ({
-            success: false,
-            error: 'BLUEPRINT_NOT_FOUND',
-            message: 'Blueprint not found',
-            checked: candidates
-        });
-        const checkCandidates = async () => {
-            for (const candidate of candidates) {
-                try {
-                    const resp = await this.sendAction('blueprint_exists', { blueprintCandidates: [candidate], requestedPath: candidate }, { timeoutMs: Math.min(perCheck, totalTimeout) });
-                    if (!resp)
-                        continue;
-                    const resultObj = resp.result && typeof resp.result === 'object' ? resp.result : null;
-                    const resolvedPath = resultObj?.blueprintPath;
-                    const exists = resultObj?.exists === true;
-                    if (exists) {
-                        return successResponse(candidate, resolvedPath);
-                    }
-                    if (!shouldExist && resultObj && resultObj.exists === false) {
-                        return notFoundResponse();
-                    }
-                    if (resp.success === false) {
-                        if (this.isUnknownActionResponse(resp)) {
-                            return unknownResponse();
-                        }
-                        return {
-                            success: false,
-                            error: resp.error ?? 'BLUEPRINT_CHECK_FAILED',
-                            message: resp.message ?? 'Failed to verify blueprint existence'
-                        };
-                    }
-                }
-                catch (_err) {
-                    continue;
-                }
-            }
-            return null;
-        };
-        if (!shouldExist) {
-            const immediate = await checkCandidates();
-            if (immediate)
-                return immediate;
-            return notFoundResponse();
-        }
-        const start = Date.now();
-        while (Date.now() - start < totalTimeout) {
-            const result = await checkCandidates();
-            if (result)
-                return result;
-            await new Promise((resolve) => setTimeout(resolve, 1000));
-        }
-        if (this.pluginBlueprintActionsAvailable === null) {
-            return unknownResponse();
-        }
-        return { success: false, error: `Timeout waiting for blueprint after ${totalTimeout}ms`, checked: candidates };
-    }
-    async getBlueprint(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        try {
-            const pluginResp = await this.sendAction('blueprint_get', { blueprintCandidates: candidates, requestedPath: primary }, { timeoutMs: params.timeoutMs });
-            if (pluginResp && pluginResp.success) {
-                if (pluginResp && typeof pluginResp === 'object') {
-                    return { ...pluginResp, blueprint: pluginResp.result, blueprintPath: primary };
-                }
-                return pluginResp;
-            }
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_get' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'BLUEPRINT_GET_FAILED', message: pluginResp?.message ?? 'Failed to get blueprint via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async getBlueprintInfo(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath) {
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        }
-        const candidates = this.buildCandidates(blueprintPath);
-        const primary = candidates[0] ?? blueprintPath;
-        try {
-            const resp = await this.sendAction('blueprint_get', { blueprintCandidates: candidates.length > 0 ? candidates : [primary], requestedPath: primary }, { timeoutMs: params.timeoutMs });
-            if (resp && resp.success) {
-                const result = resp.result ?? resp;
-                const resolvedPath = typeof result?.resolvedPath === 'string' ? result.resolvedPath : primary;
-                return {
-                    success: true,
-                    message: resp.message ?? `Blueprint metadata retrieved for ${resolvedPath}`,
-                    blueprintPath: resolvedPath,
-                    blueprint: result,
-                    result,
-                    requestId: resp.requestId
-                };
-            }
-            if (resp && this.isUnknownActionResponse(resp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_get' };
-            }
-            return { success: false, error: resp?.error ?? 'BLUEPRINT_GET_FAILED', message: resp?.message ?? 'Failed to get blueprint via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async probeSubobjectDataHandle(opts = {}) {
-        return await this.sendAction('blueprint_probe_subobject_handle', { componentClass: opts.componentClass });
-    }
-    async setBlueprintDefault(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        return await this.sendAction('blueprint_set_default', { blueprintCandidates: candidates, requestedPath: primary, propertyName: params.propertyName, value: params.value });
-    }
-    async addVariable(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        const pluginResp = await this.sendAction('blueprint_add_variable', { blueprintCandidates: candidates, requestedPath: primary, variableName: params.variableName, variableType: params.variableType, defaultValue: params.defaultValue, category: params.category, isReplicated: params.isReplicated, isPublic: params.isPublic, variablePinType: params.variablePinType }, { timeoutMs: params.timeoutMs, waitForEvent: !!params.waitForCompletion, waitForEventTimeoutMs: params.waitForCompletionTimeoutMs });
-        if (pluginResp && pluginResp.success) {
-            return pluginResp;
-        }
-        if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-            return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_add_variable' };
-        }
-        return { success: false, error: pluginResp?.error ?? 'BLUEPRINT_ADD_VARIABLE_FAILED', message: pluginResp?.message ?? 'Failed to add variable via automation bridge' };
-    }
-    async removeVariable(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        const pluginResp = await this.sendAction('blueprint_remove_variable', { blueprintCandidates: candidates, requestedPath: primary, variableName: params.variableName }, { timeoutMs: params.timeoutMs, waitForEvent: !!params.waitForCompletion, waitForEventTimeoutMs: params.waitForCompletionTimeoutMs });
-        if (pluginResp && pluginResp.success)
-            return pluginResp;
-        if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-            return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_remove_variable' };
-        }
-        return { success: false, error: pluginResp?.error ?? 'BLUEPRINT_REMOVE_VARIABLE_FAILED', message: pluginResp?.message ?? 'Failed to remove variable via automation bridge' };
-    }
-    async renameVariable(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        const pluginResp = await this.sendAction('blueprint_rename_variable', { blueprintCandidates: candidates, requestedPath: primary, oldName: params.oldName, newName: params.newName }, { timeoutMs: params.timeoutMs, waitForEvent: !!params.waitForCompletion, waitForEventTimeoutMs: params.waitForCompletionTimeoutMs });
-        if (pluginResp && pluginResp.success)
-            return pluginResp;
-        if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-            return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_rename_variable' };
-        }
-        return { success: false, error: pluginResp?.error ?? 'BLUEPRINT_RENAME_VARIABLE_FAILED', message: pluginResp?.message ?? 'Failed to rename variable via automation bridge' };
-    }
-    async addEvent(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        const pluginResp = await this.sendAction('blueprint_add_event', { blueprintCandidates: candidates, requestedPath: primary, eventType: params.eventType, customEventName: params.customEventName, parameters: params.parameters }, { timeoutMs: params.timeoutMs, waitForEvent: !!params.waitForCompletion, waitForEventTimeoutMs: params.waitForCompletionTimeoutMs });
-        if (pluginResp && pluginResp.success) {
-            return pluginResp;
-        }
-        if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-            return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_add_event' };
-        }
-        return { success: false, error: pluginResp?.error ?? 'BLUEPRINT_ADD_EVENT_FAILED', message: pluginResp?.message ?? 'Failed to add event via automation bridge' };
-    }
-    async removeEvent(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        const finalEventName = params.eventName || params.customEventName;
-        if (!finalEventName)
-            return { success: false, error: 'INVALID_ARGUMENT', message: 'eventName is required' };
-        try {
-            const pluginResp = await this.sendAction('blueprint_remove_event', { blueprintCandidates: candidates, requestedPath: primary, eventName: finalEventName }, { timeoutMs: params.timeoutMs, waitForEvent: !!params.waitForCompletion, waitForEventTimeoutMs: params.waitForCompletionTimeoutMs });
-            if (pluginResp && pluginResp.success) {
-                return pluginResp;
-            }
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_remove_event' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'BLUEPRINT_REMOVE_EVENT_FAILED', message: pluginResp?.message ?? 'Failed to remove event via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async addFunction(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        const pluginResp = await this.sendAction('blueprint_add_function', { blueprintCandidates: candidates, requestedPath: primary, functionName: params.functionName, inputs: params.inputs, outputs: params.outputs, isPublic: params.isPublic, category: params.category }, { timeoutMs: params.timeoutMs, waitForEvent: !!params.waitForCompletion, waitForEventTimeoutMs: params.waitForCompletionTimeoutMs });
-        if (pluginResp && pluginResp.success) {
-            return pluginResp;
-        }
-        if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-            return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_add_function' };
-        }
-        return { success: false, error: pluginResp?.error ?? 'BLUEPRINT_ADD_FUNCTION_FAILED', message: pluginResp?.message ?? 'Failed to add function via automation bridge' };
-    }
-    async setVariableMetadata(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        const pluginResp = await this.sendAction('blueprint_set_variable_metadata', { blueprintCandidates: candidates, requestedPath: primary, variableName: params.variableName, metadata: params.metadata }, { timeoutMs: params.timeoutMs });
-        if (pluginResp && pluginResp.success) {
-            return pluginResp;
-        }
-        if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-            return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_set_variable_metadata' };
-        }
-        return { success: false, error: pluginResp?.error ?? 'SET_VARIABLE_METADATA_FAILED', message: pluginResp?.message ?? 'Failed to set variable metadata via automation bridge' };
-    }
-    async addConstructionScript(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        const pluginResp = await this.sendAction('blueprint_add_construction_script', { blueprintCandidates: candidates, requestedPath: primary, scriptName: params.scriptName }, { timeoutMs: params.timeoutMs, waitForEvent: !!params.waitForCompletion, waitForEventTimeoutMs: params.waitForCompletionTimeoutMs });
-        if (pluginResp && pluginResp.success)
-            return pluginResp;
-        if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-            return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_add_construction_script' };
-        }
-        return { success: false, error: pluginResp?.error ?? 'ADD_CONSTRUCTION_SCRIPT_FAILED', message: pluginResp?.message ?? 'Failed to add construction script via automation bridge' };
-    }
-    async compileBlueprint(params) {
-        try {
-            const candidates = this.buildCandidates(params.blueprintName);
-            const primary = candidates[0] ?? params.blueprintName;
-            const pluginResp = await this.sendAction('blueprint_compile', { requestedPath: primary, saveAfterCompile: params.saveAfterCompile });
-            if (pluginResp && pluginResp.success) {
-                return {
-                    ...pluginResp,
-                    blueprint: primary,
-                    message: pluginResp.message || `Compiled ${primary}`
-                };
-            }
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                this.pluginBlueprintActionsAvailable = false;
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement blueprint_compile' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'BLUEPRINT_COMPILE_FAILED', message: pluginResp?.message ?? 'Failed to compile blueprint via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err) };
-        }
-    }
-    async getBlueprintSCS(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath) {
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        }
-        try {
-            const pluginResp = await this.sendAction('get_blueprint_scs', { blueprint_path: blueprintPath }, { timeoutMs: params.timeoutMs });
-            if (pluginResp && pluginResp.success)
-                return pluginResp;
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement get_blueprint_scs' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'GET_SCS_FAILED', message: pluginResp?.message ?? 'Failed to get SCS via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async addSCSComponent(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath) {
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        }
-        const componentClass = coerceString(params.componentClass);
-        if (!componentClass) {
-            return { success: false, error: 'INVALID_COMPONENT_CLASS', message: 'Component class is required' };
-        }
-        const componentName = coerceString(params.componentName);
-        if (!componentName) {
-            return { success: false, error: 'INVALID_COMPONENT_NAME', message: 'Component name is required' };
-        }
-        try {
-            const payload = {
-                blueprint_path: blueprintPath,
-                component_class: componentClass,
-                component_name: componentName
-            };
-            if (params.parentComponent) {
-                payload.parent_component = params.parentComponent;
-            }
-            if (params.meshPath) {
-                payload.mesh_path = params.meshPath;
-            }
-            if (params.materialPath) {
-                payload.material_path = params.materialPath;
-            }
-            const pluginResp = await this.sendAction('add_scs_component', payload, { timeoutMs: params.timeoutMs });
-            if (pluginResp && pluginResp.success === false) {
-                if (pluginResp?.message) {
-                    this.log.warn?.(`addSCSComponent reported warning: ${pluginResp?.message}`);
-                }
-            }
-            if (pluginResp && pluginResp.success)
-                return pluginResp;
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement add_scs_component' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'ADD_SCS_COMPONENT_FAILED', message: pluginResp?.message ?? 'Failed to add SCS component via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async removeSCSComponent(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath) {
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        }
-        const componentName = coerceString(params.componentName);
-        if (!componentName) {
-            return { success: false, error: 'INVALID_COMPONENT_NAME', message: 'Component name is required' };
-        }
-        try {
-            const pluginResp = await this.sendAction('remove_scs_component', { blueprint_path: blueprintPath, component_name: componentName }, { timeoutMs: params.timeoutMs });
-            if (pluginResp && pluginResp.success === false) {
-                if (pluginResp?.message) {
-                    this.log.warn?.(`removeSCSComponent reported warning: ${pluginResp?.message}`);
-                }
-            }
-            if (pluginResp && pluginResp.success)
-                return pluginResp;
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement remove_scs_component' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'REMOVE_SCS_COMPONENT_FAILED', message: pluginResp?.message ?? 'Failed to remove SCS component via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async reparentSCSComponent(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath) {
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        }
-        const componentName = coerceString(params.componentName);
-        if (!componentName) {
-            return { success: false, error: 'INVALID_COMPONENT_NAME', message: 'Component name is required' };
-        }
-        try {
-            const pluginResp = await this.sendAction('reparent_scs_component', {
-                blueprint_path: blueprintPath,
-                component_name: componentName,
-                new_parent: params.newParent || ''
-            }, { timeoutMs: params.timeoutMs });
-            if (pluginResp && pluginResp.success === false) {
-                if (pluginResp?.message) {
-                    this.log.warn?.(`reparentSCSComponent reported warning: ${pluginResp?.message}`);
-                }
-            }
-            if (pluginResp && pluginResp.success)
-                return pluginResp;
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement reparent_scs_component' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'REPARENT_SCS_COMPONENT_FAILED', message: pluginResp?.message ?? 'Failed to reparent SCS component via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async setSCSComponentTransform(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath) {
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        }
-        const componentName = coerceString(params.componentName);
-        if (!componentName) {
-            return { success: false, error: 'INVALID_COMPONENT_NAME', message: 'Component name is required' };
-        }
-        try {
-            const payload = {
-                blueprint_path: blueprintPath,
-                component_name: componentName
-            };
-            if (params.location)
-                payload.location = params.location;
-            if (params.rotation)
-                payload.rotation = params.rotation;
-            if (params.scale)
-                payload.scale = params.scale;
-            const pluginResp = await this.sendAction('set_scs_component_transform', payload, { timeoutMs: params.timeoutMs });
-            if (pluginResp && pluginResp.success === false) {
-                if (pluginResp?.message) {
-                    this.log.warn?.(`setSCSComponentTransform reported warning: ${pluginResp?.message}`);
-                }
-            }
-            if (pluginResp && pluginResp.success)
-                return pluginResp;
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement set_scs_component_transform' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'SET_SCS_TRANSFORM_FAILED', message: pluginResp?.message ?? 'Failed to set SCS component transform via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async setSCSComponentProperty(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath) {
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        }
-        const componentName = coerceString(params.componentName);
-        if (!componentName) {
-            return { success: false, error: 'INVALID_COMPONENT_NAME', message: 'Component name is required' };
-        }
-        const propertyName = coerceString(params.propertyName);
-        if (!propertyName) {
-            return { success: false, error: 'INVALID_PROPERTY_NAME', message: 'Property name is required' };
-        }
-        try {
-            const propertyValueJson = JSON.stringify({ value: params.propertyValue });
-            const pluginResp = await this.sendAction('set_scs_component_property', {
-                blueprint_path: blueprintPath,
-                component_name: componentName,
-                property_name: propertyName,
-                property_value: propertyValueJson
-            }, { timeoutMs: params.timeoutMs });
-            if (pluginResp && pluginResp.success === false) {
-                if (pluginResp?.message) {
-                    this.log.warn?.(`setSCSComponentProperty reported warning: ${pluginResp?.message}`);
-                }
-            }
-            if (pluginResp && pluginResp.success)
-                return pluginResp;
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement set_scs_component_property' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'SET_SCS_PROPERTY_FAILED', message: pluginResp?.message ?? 'Failed to set SCS component property via automation bridge' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async getNodes(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath) {
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        }
-        try {
-            const payload = {
-                subAction: 'get_nodes',
-                blueprintPath: blueprintPath,
-                graphName: params.graphName || 'EventGraph'
-            };
-            const pluginResp = await this.sendAction('manage_blueprint_graph', payload, { timeoutMs: params.timeoutMs });
-            if (pluginResp && pluginResp.success) {
-                return {
-                    success: true,
-                    nodes: pluginResp.result.nodes,
-                    graphName: pluginResp.result.graphName
-                };
-            }
-            if (pluginResp && this.isUnknownActionResponse(pluginResp)) {
-                return { success: false, error: 'UNKNOWN_PLUGIN_ACTION', message: 'Automation plugin does not implement get_nodes' };
-            }
-            return { success: false, error: pluginResp?.error ?? 'GET_NODES_FAILED', message: pluginResp?.message ?? 'Failed to get blueprint nodes' };
-        }
-        catch (err) {
-            return { success: false, error: String(err), message: String(err) };
-        }
-    }
-    async addNode(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        const payload = {
-            subAction: 'create_node',
-            assetPath: primary,
-            nodeType: params.nodeType,
-            graphName: params.graphName,
-            memberName: params.functionName,
-            variableName: params.variableName,
-            nodeName: params.nodeName,
-            eventName: params.eventName,
-            memberClass: params.memberClass,
-            x: params.posX,
-            y: params.posY
-        };
-        const res = await this.sendAction('manage_blueprint_graph', payload, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-    async deleteNode(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath)
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        if (!params.nodeId)
-            return { success: false, error: 'INVALID_NODE_ID', message: 'Node ID is required' };
-        const res = await this.sendAction('manage_blueprint_graph', {
-            subAction: 'delete_node',
-            blueprintPath: blueprintPath,
-            graphName: params.graphName || 'EventGraph',
-            nodeId: params.nodeId
-        }, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-    async createRerouteNode(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath)
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        const res = await this.sendAction('manage_blueprint_graph', {
-            subAction: 'create_reroute_node',
-            blueprintPath: blueprintPath,
-            graphName: params.graphName || 'EventGraph',
-            x: params.x,
-            y: params.y
-        }, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-    async setNodeProperty(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath)
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        if (!params.nodeId)
-            return { success: false, error: 'INVALID_NODE_ID', message: 'Node ID is required' };
-        if (!params.propertyName)
-            return { success: false, error: 'INVALID_PROPERTY', message: 'Property name is required' };
-        const res = await this.sendAction('manage_blueprint_graph', {
-            subAction: 'set_node_property',
-            blueprintPath: blueprintPath,
-            graphName: params.graphName || 'EventGraph',
-            nodeId: params.nodeId,
-            propertyName: params.propertyName,
-            value: params.value
-        }, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-    async getNodeDetails(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath)
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        if (!params.nodeId)
-            return { success: false, error: 'INVALID_NODE_ID', message: 'Node ID is required' };
-        const res = await this.sendAction('manage_blueprint_graph', {
-            subAction: 'get_node_details',
-            blueprintPath: blueprintPath,
-            graphName: params.graphName || 'EventGraph',
-            nodeId: params.nodeId
-        }, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-    async getGraphDetails(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath)
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        const res = await this.sendAction('manage_blueprint_graph', {
-            subAction: 'get_graph_details',
-            blueprintPath: blueprintPath,
-            graphName: params.graphName || 'EventGraph'
-        }, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-    async getPinDetails(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath)
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        if (!params.nodeId)
-            return { success: false, error: 'INVALID_NODE_ID', message: 'Node ID is required' };
-        const res = await this.sendAction('manage_blueprint_graph', {
-            subAction: 'get_pin_details',
-            blueprintPath: blueprintPath,
-            graphName: params.graphName || 'EventGraph',
-            nodeId: params.nodeId,
-            pinName: params.pinName
-        }, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-    async listNodeTypes(params = {}) {
-        const res = await this.sendAction('manage_blueprint_graph', {
-            subAction: 'list_node_types',
-            blueprintPath: params.blueprintPath || '/Game/Temp',
-            graphName: 'EventGraph'
-        }, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-    async setPinDefaultValue(params) {
-        const blueprintPath = coerceString(params.blueprintPath);
-        if (!blueprintPath)
-            return { success: false, error: 'INVALID_BLUEPRINT_PATH', message: 'Blueprint path is required' };
-        if (!params.nodeId)
-            return { success: false, error: 'INVALID_NODE_ID', message: 'Node ID is required' };
-        if (!params.pinName)
-            return { success: false, error: 'INVALID_PIN_NAME', message: 'Pin name is required' };
-        const res = await this.sendAction('manage_blueprint_graph', {
-            subAction: 'set_pin_default_value',
-            blueprintPath: blueprintPath,
-            graphName: params.graphName || 'EventGraph',
-            nodeId: params.nodeId,
-            pinName: params.pinName,
-            value: params.value
-        }, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-    async connectPins(params) {
-        const candidates = this.buildCandidates(params.blueprintName);
-        const primary = candidates[0];
-        if (!primary)
-            return { success: false, error: 'Invalid blueprint name' };
-        let fromNodeId = params.sourceNodeGuid;
-        let fromPinName = params.sourcePinName;
-        if (fromNodeId && fromNodeId.includes('.') && !fromPinName) {
-            const parts = fromNodeId.split('.');
-            fromNodeId = parts[0];
-            fromPinName = parts.slice(1).join('.');
-        }
-        let toNodeId = params.targetNodeGuid;
-        let toPinName = params.targetPinName;
-        if (toNodeId && toNodeId.includes('.') && !toPinName) {
-            const parts = toNodeId.split('.');
-            toNodeId = parts[0];
-            toPinName = parts.slice(1).join('.');
-        }
-        const res = await this.sendAction('manage_blueprint_graph', {
-            subAction: 'connect_pins',
-            assetPath: primary,
-            graphName: 'EventGraph',
-            fromNodeId: fromNodeId,
-            toNodeId: toNodeId,
-            fromPinName: fromPinName,
-            toPinName: toPinName
-        }, { timeoutMs: params.timeoutMs });
-        return res;
-    }
-}
-//# sourceMappingURL=blueprint.js.map