unreal-engine-mcp-server 0.5.0 → 0.5.2

package/dist/tools/blueprint.d.ts

@@ -1,5 +1,5 @@
 import { BaseTool } from './base-tool.js';
-import { IBlueprintTools } from '../types/tool-interfaces.js';
+import { IBlueprintTools, StandardActionResponse } from '../types/tool-interfaces.js';
 export declare class BlueprintTools extends BaseTool implements IBlueprintTools {
     private log;
     private pluginBlueprintActionsAvailable;
@@ -15,7 +15,7 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     modifyConstructionScript(params: {
         blueprintPath: string;
         operations: any[];
@@ -24,7 +24,7 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     addComponent(params: {
         blueprintName: string;
         componentType: string;
@@ -37,40 +37,24 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
-    waitForBlueprint(blueprintRef: string | string[], timeoutMs?: number): Promise<any>;
+    }): Promise<StandardActionResponse>;
+    waitForBlueprint(blueprintRef: string | string[], timeoutMs?: number): Promise<StandardActionResponse>;
     getBlueprint(params: {
         blueprintName: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     getBlueprintInfo(params: {
         blueprintPath: string;
         timeoutMs?: number;
-    }): Promise<{
-        success: boolean;
-        message: any;
-        blueprintPath: any;
-        blueprint: any;
-        result: any;
-        requestId: any;
-        error?: undefined;
-    } | {
-        readonly success: false;
-        readonly error: any;
-        readonly message: any;
-        blueprintPath?: undefined;
-        blueprint?: undefined;
-        result?: undefined;
-        requestId?: undefined;
-    }>;
+    }): Promise<StandardActionResponse>;
     probeSubobjectDataHandle(opts?: {
         componentClass?: string;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     setBlueprintDefault(params: {
         blueprintName: string;
         propertyName: string;
         value: unknown;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     addVariable(params: {
         blueprintName: string;
         variableName: string;
@@ -83,14 +67,14 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     removeVariable(params: {
         blueprintName: string;
         variableName: string;
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     renameVariable(params: {
         blueprintName: string;
         oldName: string;
@@ -98,7 +82,7 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     addEvent(params: {
         blueprintName: string;
         eventType: string;
@@ -110,7 +94,7 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     removeEvent(params: {
         blueprintName: string;
         eventName: string;
@@ -118,7 +102,7 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     addFunction(params: {
         blueprintName: string;
         functionName: string;
@@ -135,28 +119,28 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     setVariableMetadata(params: {
         blueprintName: string;
         variableName: string;
         metadata: Record<string, unknown>;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     addConstructionScript(params: {
         blueprintName: string;
         scriptName: string;
         timeoutMs?: number;
         waitForCompletion?: boolean;
         waitForCompletionTimeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     compileBlueprint(params: {
         blueprintName: string;
         saveAfterCompile?: boolean;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     getBlueprintSCS(params: {
         blueprintPath: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     addSCSComponent(params: {
         blueprintPath: string;
         componentClass: string;
@@ -165,18 +149,18 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         meshPath?: string;
         materialPath?: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     removeSCSComponent(params: {
         blueprintPath: string;
         componentName: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     reparentSCSComponent(params: {
         blueprintPath: string;
         componentName: string;
         newParent: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     setSCSComponentTransform(params: {
         blueprintPath: string;
         componentName: string;
@@ -184,31 +168,19 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         rotation?: [number, number, number];
         scale?: [number, number, number];
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     setSCSComponentProperty(params: {
         blueprintPath: string;
         componentName: string;
         propertyName: string;
         propertyValue: any;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     getNodes(params: {
         blueprintPath: string;
         graphName?: string;
         timeoutMs?: number;
-    }): Promise<{
-        success: boolean;
-        nodes: any;
-        graphName: any;
-        error?: undefined;
-        message?: undefined;
-    } | {
-        readonly success: false;
-        readonly error: any;
-        readonly message: any;
-        nodes?: undefined;
-        graphName?: undefined;
-    }>;
+    }): Promise<StandardActionResponse>;
     addNode(params: {
         blueprintName: string;
         nodeType: string;
@@ -221,20 +193,20 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         posX?: number;
         posY?: number;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     deleteNode(params: {
         blueprintPath: string;
         nodeId: string;
         graphName?: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     createRerouteNode(params: {
         blueprintPath: string;
         graphName?: string;
         x: number;
         y: number;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     setNodeProperty(params: {
         blueprintPath: string;
         nodeId: string;
@@ -242,25 +214,37 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         value: string;
         graphName?: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     getNodeDetails(params: {
         blueprintPath: string;
         nodeId: string;
         graphName?: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     getGraphDetails(params: {
         blueprintPath: string;
         graphName?: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
     getPinDetails(params: {
         blueprintPath: string;
         nodeId: string;
         pinName?: string;
         graphName?: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
+    listNodeTypes(params?: {
+        blueprintPath?: string;
+        timeoutMs?: number;
+    }): Promise<StandardActionResponse>;
+    setPinDefaultValue(params: {
+        blueprintPath: string;
+        nodeId: string;
+        pinName: string;
+        value: string;
+        graphName?: string;
+        timeoutMs?: number;
+    }): Promise<StandardActionResponse>;
     connectPins(params: {
         blueprintName: string;
         sourceNodeGuid: string;
@@ -268,6 +252,6 @@ export declare class BlueprintTools extends BaseTool implements IBlueprintTools
         sourcePinName?: string;
         targetPinName?: string;
         timeoutMs?: number;
-    }): Promise<any>;
+    }): Promise<StandardActionResponse>;
 }
 //# sourceMappingURL=blueprint.d.ts.map

package/dist/tools/blueprint.js

@@ -12,17 +12,20 @@ export class BlueprintTools extends BaseTool {
         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;
+            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) {
-            return { success: false, error: String(err), message: String(err) };
+            const errMsg = err instanceof Error ? err.message : String(err);
+            return { success: false, error: errMsg, message: errMsg };
         }
     }
     isUnknownActionResponse(res) {
         if (!res)
             return false;
-        const txt = String((res.error ?? res.message ?? '')).toLowerCase();
+        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) {
@@ -114,7 +117,7 @@ export class BlueprintTools extends BaseTool {
         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') {
+        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)' };
         }
@@ -441,8 +444,8 @@ export class BlueprintTools extends BaseTool {
             }
             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?.message) {
+                    this.log.warn?.(`addSCSComponent reported warning: ${pluginResp?.message}`);
                 }
             }
             if (pluginResp && pluginResp.success)
@@ -468,8 +471,8 @@ export class BlueprintTools extends BaseTool {
         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?.message) {
+                    this.log.warn?.(`removeSCSComponent reported warning: ${pluginResp?.message}`);
                 }
             }
             if (pluginResp && pluginResp.success)
@@ -499,8 +502,8 @@ export class BlueprintTools extends BaseTool {
                 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?.message) {
+                    this.log.warn?.(`reparentSCSComponent reported warning: ${pluginResp?.message}`);
                 }
             }
             if (pluginResp && pluginResp.success)
@@ -536,8 +539,8 @@ export class BlueprintTools extends BaseTool {
                 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?.message) {
+                    this.log.warn?.(`setSCSComponentTransform reported warning: ${pluginResp?.message}`);
                 }
             }
             if (pluginResp && pluginResp.success)
@@ -573,8 +576,8 @@ export class BlueprintTools extends BaseTool {
                 property_value: propertyValueJson
             }, { timeoutMs: params.timeoutMs });
             if (pluginResp && pluginResp.success === false) {
-                if (pluginResp.message) {
-                    this.log.warn?.(`setSCSComponentProperty reported warning: ${pluginResp.message}`);
+                if (pluginResp?.message) {
+                    this.log.warn?.(`setSCSComponentProperty reported warning: ${pluginResp?.message}`);
                 }
             }
             if (pluginResp && pluginResp.success)
@@ -722,6 +725,32 @@ export class BlueprintTools extends BaseTool {
         }, { 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];

package/dist/tools/consolidated-tool-definitions.js

@@ -917,7 +917,8 @@ Supported actions: create_node, delete_node, connect_pins, break_pin_links, set_
                     type: 'string',
                     enum: [
                         'create_node', 'delete_node', 'connect_pins', 'break_pin_links', 'set_node_property',
-                        'create_reroute_node', 'get_node_details', 'get_graph_details', 'get_pin_details'
+                        'create_reroute_node', 'get_node_details', 'get_graph_details', 'get_pin_details',
+                        'list_node_types', 'set_pin_default_value'
                     ],
                     description: 'Action'
                 },