unreal-engine-mcp-server 0.5.21 → 0.6.0-a

package/dist/tools/handlers/sequence/sequence-track-actions.js

@@ -0,0 +1,123 @@
+import { cleanObject } from '../../../utils/serialization/safe-json.js';
+import { executeAutomationRequest, requireNonEmptyString } from '../foundation/dispatch/common-handlers.js';
+import { validateRequiredFields } from '../foundation/arguments/batch-validation.js';
+export async function handleSequenceTrackAction(action, args, tools) {
+    switch (action) {
+        case 'add_track': {
+            const { path, trackType } = validateRequiredFields(args, ['path', 'trackType']);
+            const trackName = typeof args.trackName === 'string' ? args.trackName : '';
+            const actorName = typeof args.actorName === 'string' ? args.actorName : undefined;
+            if (actorName) {
+                const bindingsRes = await executeAutomationRequest(tools, 'manage_sequence', {
+                    path,
+                    subAction: 'get_bindings'
+                });
+                if (bindingsRes && bindingsRes.success) {
+                    const bindings = bindingsRes.bindings || [];
+                    const isBound = bindings.some((b) => b.name === actorName);
+                    if (!isBound) {
+                        return cleanObject({
+                            success: false,
+                            error: 'BINDING_NOT_FOUND',
+                            message: `Actor '${actorName}' is not bound to this sequence. Please call 'add_actor' first.`,
+                            action: 'add_track',
+                            path,
+                            actorName
+                        });
+                    }
+                }
+            }
+            const payload = {
+                ...args,
+                path,
+                trackType,
+                trackName,
+                actorName,
+                subAction: 'add_track'
+            };
+            const res = await executeAutomationRequest(tools, 'manage_sequence', payload);
+            return cleanObject(res);
+        }
+        case 'add_section': {
+            const path = requireNonEmptyString(args.path, 'path', 'Missing required parameter: path');
+            const payload = { ...args, path, subAction: 'add_section' };
+            return cleanObject(await executeAutomationRequest(tools, 'manage_sequence', payload));
+        }
+        case 'remove_track': {
+            const { path, trackName } = validateRequiredFields(args, ['path', 'trackName']);
+            const payload = { ...args, path, trackName, subAction: 'remove_track' };
+            return cleanObject(await executeAutomationRequest(tools, 'manage_sequence', payload));
+        }
+        case 'set_track_muted': {
+            const { path, trackName } = validateRequiredFields(args, ['path', 'trackName']);
+            const payload = { ...args, path, trackName, subAction: 'set_track_muted' };
+            return cleanObject(await executeAutomationRequest(tools, 'manage_sequence', payload));
+        }
+        case 'set_track_solo': {
+            const { path, trackName } = validateRequiredFields(args, ['path', 'trackName']);
+            const payload = { ...args, path, trackName, subAction: 'set_track_solo' };
+            return cleanObject(await executeAutomationRequest(tools, 'manage_sequence', payload));
+        }
+        case 'set_track_locked': {
+            const { path, trackName } = validateRequiredFields(args, ['path', 'trackName']);
+            const payload = { ...args, path, trackName, subAction: 'set_track_locked' };
+            return cleanObject(await executeAutomationRequest(tools, 'manage_sequence', payload));
+        }
+        case 'list_tracks': {
+            const path = requireNonEmptyString(args.path, 'path', 'Missing required parameter: path');
+            const res = await executeAutomationRequest(tools, 'manage_sequence', {
+                ...args,
+                path,
+                subAction: 'list_tracks'
+            });
+            return cleanObject(res);
+        }
+        case 'set_work_range': {
+            const path = requireNonEmptyString(args.path, 'path', 'Missing required parameter: path');
+            const start = Number(args.start);
+            const end = Number(args.end);
+            if (!Number.isFinite(start))
+                throw new Error('Invalid start: must be a number');
+            if (!Number.isFinite(end))
+                throw new Error('Invalid end: must be a number');
+            const res = await executeAutomationRequest(tools, 'manage_sequence', {
+                ...args,
+                path,
+                start,
+                end,
+                subAction: 'set_work_range'
+            });
+            return cleanObject(res);
+        }
+        case 'set_tick_resolution': {
+            const path = requireNonEmptyString(args.path, 'path', 'Missing required parameter: path');
+            const resolution = args.resolution;
+            if (resolution === undefined || resolution === null) {
+                throw new Error('Missing required parameter: resolution');
+            }
+            const res = await executeAutomationRequest(tools, 'manage_sequence', {
+                ...args,
+                path,
+                resolution,
+                subAction: 'set_tick_resolution'
+            });
+            return cleanObject(res);
+        }
+        case 'set_view_range': {
+            const path = requireNonEmptyString(args.path, 'path', 'Missing required parameter: path');
+            const start = args.start !== undefined ? Number(args.start) : undefined;
+            const end = args.end !== undefined ? Number(args.end) : undefined;
+            const res = await executeAutomationRequest(tools, 'manage_sequence', {
+                ...args,
+                path,
+                start,
+                end,
+                subAction: 'set_view_range'
+            });
+            return cleanObject(res);
+        }
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=sequence-track-actions.js.map

package/dist/tools/handlers/sequence/sequence-track-actions.js.map

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

package/dist/tools/handlers/sessions/sessions-handlers.d.ts

@@ -0,0 +1,4 @@
+import { ITools } from '../../../types/tools/tool-interfaces.js';
+import type { HandlerArgs } from '../../../types/handlers/handler-types.js';
+export declare function handleSessionsTools(action: string, args: HandlerArgs, tools: ITools): Promise<Record<string, unknown>>;
+//# sourceMappingURL=sessions-handlers.d.ts.map

package/dist/tools/handlers/sessions/sessions-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-handlers.d.ts","sourceRoot":"","sources":["../../../../src/tools/handlers/sessions/sessions-handlers.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AA0B5E,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUlC"}

package/dist/tools/handlers/sessions/sessions-handlers.js

@@ -0,0 +1,30 @@
+import { createSubActionDispatcher, createUnknownActionResponse } from '../foundation/dispatch/common-handlers.js';
+const SESSIONS_ACTIONS = new Set([
+    'configure_local_session_settings',
+    'configure_session_interface',
+    'configure_split_screen',
+    'set_split_screen_type',
+    'add_local_player',
+    'remove_local_player',
+    'configure_lan_play',
+    'host_lan_server',
+    'join_lan_server',
+    'enable_voice_chat',
+    'configure_voice_settings',
+    'set_voice_channel',
+    'mute_player',
+    'set_voice_attenuation',
+    'configure_push_to_talk',
+    'get_sessions_info',
+]);
+export async function handleSessionsTools(action, args, tools) {
+    const { sendRequest } = createSubActionDispatcher(tools, args, {
+        toolName: 'manage_sessions',
+        domainName: 'sessions'
+    });
+    if (SESSIONS_ACTIONS.has(action)) {
+        return sendRequest(action);
+    }
+    return createUnknownActionResponse(`Unknown sessions action: ${action}`);
+}
+//# sourceMappingURL=sessions-handlers.js.map

package/dist/tools/handlers/sessions/sessions-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-handlers.js","sourceRoot":"","sources":["../../../../src/tools/handlers/sessions/sessions-handlers.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAGnH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,kCAAkC;IAClC,6BAA6B;IAC7B,wBAAwB;IACxB,uBAAuB;IACvB,kBAAkB;IAClB,qBAAqB;IACrB,oBAAoB;IACpB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,0BAA0B;IAC1B,mBAAmB;IACnB,aAAa;IACb,uBAAuB;IACvB,wBAAwB;IACxB,mBAAmB;CACpB,CAAC,CAAC;AAKH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,IAAiB,EACjB,KAAa;IAEb,MAAM,EAAE,WAAW,EAAE,GAAG,yBAAyB,CAAC,KAAK,EAAE,IAAI,EAAE;QAC7D,QAAQ,EAAE,iBAAiB;QAC3B,UAAU,EAAE,UAAU;KACvB,CAAC,CAAC;IAEH,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,2BAA2B,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/tools/handlers/skeleton/skeleton-handlers.d.ts

@@ -0,0 +1,4 @@
+import { ITools } from '../../../types/tools/tool-interfaces.js';
+import type { HandlerArgs } from '../../../types/handlers/handler-types.js';
+export declare function handleSkeletonTools(action: string, args: HandlerArgs, tools: ITools): Promise<Record<string, unknown>>;
+//# sourceMappingURL=skeleton-handlers.d.ts.map

package/dist/tools/handlers/skeleton/skeleton-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-handlers.d.ts","sourceRoot":"","sources":["../../../../src/tools/handlers/skeleton/skeleton-handlers.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAoG5E,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4BlC"}

package/dist/tools/handlers/skeleton/skeleton-handlers.js

@@ -0,0 +1,94 @@
+import { cleanObject } from '../../../utils/serialization/safe-json.js';
+import { executeAutomationRequest, normalizeLocation } from '../foundation/dispatch/common-handlers.js';
+import { SKELETON_ACTIONS as SHARED_SKELETON_ACTIONS } from '../../definitions/shared/action-sets.js';
+const SKELETON_ACTIONS = [...SHARED_SKELETON_ACTIONS, 'preview_physics'];
+function normalizeSkeletonArgs(action, args) {
+    const actionAliases = {
+        'add_socket': 'create_socket',
+        'modify_socket': 'configure_socket',
+        'modify_physics_body': 'configure_physics_body',
+    };
+    const canonicalAction = actionAliases[action] ?? action;
+    const normalized = { ...args, subAction: canonicalAction };
+    if (args.parentBoneName && !args.parentBone) {
+        normalized.parentBone = args.parentBoneName;
+    }
+    if (args.location) {
+        normalized.location = normalizeLocation(args.location);
+    }
+    if (args.position) {
+        normalized.position = normalizeLocation(args.position);
+    }
+    if (args.translation) {
+        normalized.translation = normalizeLocation(args.translation);
+    }
+    if (args.rotation) {
+        if (Array.isArray(args.rotation)) {
+            const [pitch, yaw, roll] = args.rotation.map((v) => Number(v) || 0);
+            normalized.rotation = { pitch, yaw, roll };
+        }
+        else if (typeof args.rotation === 'object' && args.rotation !== null) {
+            normalized.rotation = args.rotation;
+        }
+    }
+    if (args.scale) {
+        if (Array.isArray(args.scale)) {
+            const [x, y, z] = args.scale.map((v) => Number(v) || 1);
+            normalized.scale = { x, y, z };
+        }
+        else if (typeof args.scale === 'object' && args.scale !== null) {
+            normalized.scale = args.scale;
+        }
+        else if (typeof args.scale === 'number') {
+            normalized.scale = { x: args.scale, y: args.scale, z: args.scale };
+        }
+    }
+    if (args.weights && Array.isArray(args.weights)) {
+        normalized.weights = args.weights.map((w) => {
+            if (typeof w === 'object' && w !== null) {
+                const wObj = w;
+                return {
+                    boneIndex: Number(wObj.boneIndex ?? wObj.bone ?? 0),
+                    boneName: String(wObj.boneName ?? wObj.name ?? ''),
+                    weight: Number(wObj.weight ?? 0)
+                };
+            }
+            return { weight: Number(w) || 0 };
+        });
+    }
+    if (args.limits && typeof args.limits === 'object' && args.limits !== null) {
+        const limits = args.limits;
+        normalized.limits = {
+            swing1LimitAngle: Number(limits.swing1LimitAngle ?? limits.swing1 ?? 45),
+            swing2LimitAngle: Number(limits.swing2LimitAngle ?? limits.swing2 ?? 45),
+            twistLimitAngle: Number(limits.twistLimitAngle ?? limits.twist ?? 45),
+            swing1Motion: String(limits.swing1Motion ?? 'Limited'),
+            swing2Motion: String(limits.swing2Motion ?? 'Limited'),
+            twistMotion: String(limits.twistMotion ?? 'Limited')
+        };
+    }
+    return normalized;
+}
+export async function handleSkeletonTools(action, args, tools) {
+    if (!SKELETON_ACTIONS.includes(action)) {
+        return {
+            success: false,
+            error: 'INVALID_ACTION',
+            message: `Unknown skeleton action: ${action}. Valid actions: ${SKELETON_ACTIONS.join(', ')}`
+        };
+    }
+    const normalizedArgs = normalizeSkeletonArgs(action, args);
+    try {
+        const response = await executeAutomationRequest(tools, 'manage_skeleton', normalizedArgs, `Automation bridge not available for skeleton action: ${action}`);
+        return cleanObject(response);
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        return {
+            success: false,
+            error: 'SKELETON_ERROR',
+            message: err.message
+        };
+    }
+}
+//# sourceMappingURL=skeleton-handlers.js.map

package/dist/tools/handlers/skeleton/skeleton-handlers.js.map

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

package/dist/tools/handlers/spline/spline-handlers.d.ts

@@ -0,0 +1,4 @@
+import { ITools } from '../../../types/tools/tool-interfaces.js';
+import type { HandlerArgs } from '../../../types/handlers/handler-types.js';
+export declare function handleSplineTools(action: string, args: HandlerArgs, tools: ITools): Promise<Record<string, unknown>>;
+//# sourceMappingURL=spline-handlers.d.ts.map

package/dist/tools/handlers/spline/spline-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spline-handlers.d.ts","sourceRoot":"","sources":["../../../../src/tools/handlers/spline/spline-handlers.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAgC5E,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAWlC"}

package/dist/tools/handlers/spline/spline-handlers.js

@@ -0,0 +1,38 @@
+import { createSubActionDispatcher, createUnknownActionResponse } from '../foundation/dispatch/common-handlers.js';
+const SPLINE_ACTIONS = new Set([
+    'create_spline_actor',
+    'add_spline_point',
+    'remove_spline_point',
+    'set_spline_point_position',
+    'set_spline_point_tangents',
+    'set_spline_point_rotation',
+    'set_spline_point_scale',
+    'set_spline_type',
+    'create_spline_mesh_component',
+    'create_spline_mesh_actor',
+    'set_spline_mesh_asset',
+    'configure_spline_mesh_axis',
+    'set_spline_mesh_material',
+    'scatter_meshes_along_spline',
+    'configure_mesh_spacing',
+    'configure_mesh_randomization',
+    'create_road_spline',
+    'create_river_spline',
+    'create_fence_spline',
+    'create_wall_spline',
+    'create_cable_spline',
+    'create_pipe_spline',
+    'get_splines_info',
+]);
+export async function handleSplineTools(action, args, tools) {
+    const { sendRequest } = createSubActionDispatcher(tools, args, {
+        toolName: 'manage_splines',
+        domainName: 'spline',
+        pathFields: ['actorPath', 'blueprintPath', 'meshPath', 'materialPath', 'splinePath']
+    });
+    if (SPLINE_ACTIONS.has(action)) {
+        return sendRequest(action);
+    }
+    return createUnknownActionResponse(`Unknown spline action: ${action}`);
+}
+//# sourceMappingURL=spline-handlers.js.map

package/dist/tools/handlers/spline/spline-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spline-handlers.js","sourceRoot":"","sources":["../../../../src/tools/handlers/spline/spline-handlers.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAEnH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,qBAAqB;IACrB,kBAAkB;IAClB,qBAAqB;IACrB,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,wBAAwB;IACxB,iBAAiB;IACjB,8BAA8B;IAC9B,0BAA0B;IAC1B,uBAAuB;IACvB,4BAA4B;IAC5B,0BAA0B;IAC1B,6BAA6B;IAC7B,wBAAwB;IACxB,8BAA8B;IAC9B,oBAAoB;IACpB,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;IACpB,qBAAqB;IACrB,oBAAoB;IACpB,kBAAkB;CACnB,CAAC,CAAC;AAKH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,IAAiB,EACjB,KAAa;IAEb,MAAM,EAAE,WAAW,EAAE,GAAG,yBAAyB,CAAC,KAAK,EAAE,IAAI,EAAE;QAC7D,QAAQ,EAAE,gBAAgB;QAC1B,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE,CAAC,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,CAAC;KACrF,CAAC,CAAC;IAEH,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,2BAA2B,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;AACzE,CAAC"}

package/dist/tools/handlers/system/system-asset-handlers.d.ts

@@ -0,0 +1,6 @@
+import type { ITools } from '../../../types/tools/tool-interfaces.js';
+import type { SystemArgs } from '../../../types/handlers/handler-types.js';
+export declare function handleGetProjectSettings(args: SystemArgs, tools: ITools): Promise<Record<string, unknown>>;
+export declare function handleValidateAssets(args: SystemArgs, tools: ITools): Promise<Record<string, unknown>>;
+export declare function handleExportAsset(args: SystemArgs, tools: ITools): Promise<Record<string, unknown>>;
+//# sourceMappingURL=system-asset-handlers.d.ts.map

package/dist/tools/handlers/system/system-asset-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-asset-handlers.d.ts","sourceRoot":"","sources":["../../../../src/tools/handlers/system/system-asset-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAe3E,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmBhH;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmE5G;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiDzG"}

package/dist/tools/handlers/system/system-asset-handlers.js

@@ -0,0 +1,136 @@
+import { cleanObject } from '../../../utils/serialization/safe-json.js';
+import { executeAutomationRequest } from '../foundation/dispatch/common-handlers.js';
+function hasMessage(value) {
+    return value !== null && typeof value === 'object' && 'message' in value;
+}
+function errorToString(error) {
+    if (!error)
+        return null;
+    if (typeof error === 'string')
+        return error;
+    if (hasMessage(error))
+        return String(error.message);
+    return String(error);
+}
+export async function handleGetProjectSettings(args, tools) {
+    const section = typeof args.category === 'string' && args.category.trim().length > 0
+        ? args.category
+        : args.section;
+    const response = await executeAutomationRequest(tools, 'system_control', {
+        action: 'get_project_settings',
+        section
+    });
+    if (response && response.success && (response.settings || response.data || response.result)) {
+        return cleanObject({
+            success: true,
+            message: 'Project settings retrieved',
+            settings: response.settings || response.data || response.result,
+            ...response
+        });
+    }
+    return cleanObject(response);
+}
+export async function handleValidateAssets(args, tools) {
+    const argsRecord = args;
+    const paths = Array.isArray(argsRecord.paths)
+        ? argsRecord.paths.filter((path) => typeof path === 'string' && path.trim().length > 0)
+        : [];
+    const singlePath = typeof args.assetPath === 'string' && args.assetPath.trim().length > 0
+        ? args.assetPath
+        : (typeof args.path === 'string' && args.path.trim().length > 0 ? args.path : undefined);
+    if (singlePath && !paths.includes(singlePath)) {
+        paths.push(singlePath);
+    }
+    if (!paths.length) {
+        return {
+            success: false,
+            error: 'INVALID_ARGUMENT',
+            message: 'Please provide "paths", "assetPath", or "path" to validate assets.',
+            action: 'validate_assets',
+            results: []
+        };
+    }
+    const response = await executeAutomationRequest(tools, 'system_control', {
+        action: 'validate_assets',
+        paths,
+        recursive: args.recursive
+    });
+    const responseResult = typeof response.result === 'object' && response.result !== null && !Array.isArray(response.result)
+        ? response.result
+        : undefined;
+    if (Array.isArray(response.results) || Array.isArray(responseResult?.results)) {
+        return cleanObject({ ...response, ...responseResult, action: 'validate_assets' });
+    }
+    const results = await Promise.all(paths.map(async (assetPath) => {
+        try {
+            const response = await executeAutomationRequest(tools, 'manage_asset', {
+                action: 'exists',
+                subAction: 'exists',
+                assetPath
+            });
+            const result = typeof response.result === 'object' && response.result !== null
+                ? response.result
+                : undefined;
+            const exists = typeof response.exists === 'boolean'
+                ? response.exists
+                : (typeof result?.exists === 'boolean' ? result.exists : false);
+            const error = errorToString(response.error) ?? (exists ? null : 'Asset does not exist');
+            return { assetPath, success: exists, error };
+        }
+        catch (error) {
+            return {
+                assetPath,
+                success: false,
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }));
+    const allValid = results.every((result) => result.success !== false);
+    return {
+        success: allValid,
+        message: allValid ? 'Asset validation completed' : 'Asset validation failed for one or more assets',
+        action: 'validate_assets',
+        results
+    };
+}
+export async function handleExportAsset(args, tools) {
+    const assetPath = typeof args.assetPath === 'string' ? args.assetPath : '';
+    const argsRecord = args;
+    const exportPath = typeof argsRecord.exportPath === 'string' ? argsRecord.exportPath : '';
+    if (!assetPath) {
+        return {
+            success: false,
+            error: 'INVALID_ARGUMENT',
+            message: 'assetPath is required for export_asset',
+            action: 'export_asset'
+        };
+    }
+    if (!exportPath) {
+        return {
+            success: false,
+            error: 'INVALID_ARGUMENT',
+            message: 'exportPath is required for export_asset',
+            action: 'export_asset'
+        };
+    }
+    const response = await executeAutomationRequest(tools, 'system_control', { action: 'export_asset', assetPath, exportPath }, 'Export functionality not available - ensure editor is running');
+    if (response && response.success) {
+        return cleanObject({
+            success: true,
+            message: `Asset exported to ${exportPath}`,
+            action: 'export_asset',
+            assetPath,
+            exportPath,
+            ...response
+        });
+    }
+    return cleanObject({
+        success: false,
+        error: response?.error || 'EXPORT_FAILED',
+        message: response?.message || 'Export operation failed',
+        action: 'export_asset',
+        assetPath,
+        exportPath
+    });
+}
+//# sourceMappingURL=system-asset-handlers.js.map

package/dist/tools/handlers/system/system-asset-handlers.js.map

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

package/dist/tools/handlers/system/system-audio-handlers.d.ts

@@ -0,0 +1,4 @@
+import type { ITools } from '../../../types/tools/tool-interfaces.js';
+import type { SystemArgs } from '../../../types/handlers/handler-types.js';
+export declare function handlePlaySound(args: SystemArgs, tools: ITools): Promise<Record<string, unknown>>;
+//# sourceMappingURL=system-audio-handlers.d.ts.map

package/dist/tools/handlers/system/system-audio-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-audio-handlers.d.ts","sourceRoot":"","sources":["../../../../src/tools/handlers/system/system-audio-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAW3E,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkGvG"}

package/dist/tools/handlers/system/system-audio-handlers.js

@@ -0,0 +1,100 @@
+import { cleanObject } from '../../../utils/serialization/safe-json.js';
+import { executeAutomationRequest } from '../foundation/dispatch/common-handlers.js';
+const FALLBACK_SOUND_PATH = '/Engine/EditorSounds/Notifications/CompileSuccess_Cue';
+function isMissingAssetError(value) {
+    const lowered = String(value || '').toLowerCase();
+    return lowered.includes('asset_not_found') || lowered.includes('asset not found');
+}
+export async function handlePlaySound(args, tools) {
+    const argsRecord = args;
+    const soundPath = typeof argsRecord.soundPath === 'string' ? argsRecord.soundPath.trim() : '';
+    const volume = typeof argsRecord.volume === 'number' ? argsRecord.volume : undefined;
+    const pitch = typeof argsRecord.pitch === 'number' ? argsRecord.pitch : undefined;
+    if (typeof volume === 'number' && volume <= 0) {
+        return {
+            success: true,
+            message: 'Sound request handled (volume is 0 - silent)',
+            action: 'play_sound',
+            soundPath,
+            volume,
+            pitch,
+            handled: true
+        };
+    }
+    try {
+        const response = await executeAutomationRequest(tools, 'play_sound_2d', {
+            soundPath,
+            volume: volume ?? 1.0,
+            pitch: pitch ?? 1.0
+        });
+        if (!response || response.success === false) {
+            if (isMissingAssetError(response?.error) || !soundPath) {
+                if (soundPath !== FALLBACK_SOUND_PATH) {
+                    const fallbackResponse = await executeAutomationRequest(tools, 'play_sound_2d', {
+                        soundPath: FALLBACK_SOUND_PATH,
+                        volume: volume ?? 1.0,
+                        pitch: pitch ?? 1.0
+                    });
+                    if (fallbackResponse.success) {
+                        return {
+                            success: true,
+                            message: `Sound asset not found, played fallback sound: ${FALLBACK_SOUND_PATH}`,
+                            action: 'play_sound',
+                            soundPath: FALLBACK_SOUND_PATH,
+                            originalPath: soundPath,
+                            volume,
+                            pitch
+                        };
+                    }
+                }
+                return {
+                    success: false,
+                    error: 'ASSET_NOT_FOUND',
+                    message: 'Sound asset not found (and fallback failed)',
+                    action: 'play_sound',
+                    soundPath,
+                    volume,
+                    pitch
+                };
+            }
+            return cleanObject({
+                success: false,
+                error: response?.error || 'Failed to play 2D sound',
+                action: 'play_sound',
+                soundPath,
+                volume,
+                pitch
+            });
+        }
+        return cleanObject({
+            ...response,
+            action: 'play_sound',
+            soundPath,
+            volume,
+            pitch
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (isMissingAssetError(message) || !soundPath) {
+            return {
+                success: false,
+                error: 'ASSET_NOT_FOUND',
+                message: 'Sound asset not found',
+                action: 'play_sound',
+                soundPath,
+                volume,
+                pitch
+            };
+        }
+        return {
+            success: false,
+            error: `Failed to play 2D sound: ${message}`,
+            action: 'play_sound',
+            soundPath,
+            volume,
+            pitch
+        };
+    }
+}
+//# sourceMappingURL=system-audio-handlers.js.map

package/dist/tools/handlers/system/system-audio-handlers.js.map

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

package/dist/tools/handlers/system/system-console-handlers.d.ts

@@ -0,0 +1,4 @@
+import type { ITools } from '../../../types/tools/tool-interfaces.js';
+import type { HandlerArgs } from '../../../types/handlers/handler-types.js';
+export declare function handleConsoleCommand(args: HandlerArgs, tools: ITools): Promise<Record<string, unknown>>;
+//# sourceMappingURL=system-console-handlers.d.ts.map

package/dist/tools/handlers/system/system-console-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-console-handlers.d.ts","sourceRoot":"","sources":["../../../../src/tools/handlers/system/system-console-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAG5E,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoB7G"}