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

package/dist/tools/handlers/foundation/arguments/argument-helper.js

@@ -0,0 +1,109 @@
+import { executeAutomationRequest } from '../dispatch/common-handlers.js';
+import { TOOL_ACTIONS } from '../../../../utils/commands/action-constants.js';
+export { normalizeArgs } from './argument-normalization.js';
+export function extractString(params, key) {
+    const val = params[key];
+    if (typeof val !== 'string') {
+        throw new Error(`Expected string for '${key}', got ${typeof val}`);
+    }
+    return val;
+}
+export function extractOptionalString(params, key) {
+    const val = params[key];
+    if (val === undefined || val === null)
+        return undefined;
+    return typeof val === 'string' ? val : String(val);
+}
+export function extractOptionalNumber(params, key) {
+    const val = params[key];
+    if (val === undefined || val === null)
+        return undefined;
+    return typeof val === 'number' ? val : undefined;
+}
+export function extractOptionalBoolean(params, key) {
+    const val = params[key];
+    if (val === undefined || val === null)
+        return undefined;
+    return typeof val === 'boolean' ? val : undefined;
+}
+export function extractOptionalArray(params, key, validator) {
+    const val = params[key];
+    if (val === undefined || val === null)
+        return undefined;
+    if (!Array.isArray(val)) {
+        return undefined;
+    }
+    if (validator) {
+        val.forEach((item, index) => {
+            if (!validator(item, index)) {
+                throw new Error(`Invalid item in array '${key}' at index ${index}`);
+            }
+        });
+    }
+    return val;
+}
+export function extractOptionalObject(params, key) {
+    const val = params[key];
+    if (val === undefined || val === null)
+        return undefined;
+    if (typeof val === 'object' && !Array.isArray(val))
+        return val;
+    return undefined;
+}
+export function extractOptionalVector(params, key) {
+    const val = params[key];
+    if (val === undefined || val === null)
+        return undefined;
+    if (Array.isArray(val)) {
+        const nums = val.filter((n) => typeof n === 'number' && Number.isFinite(n));
+        if (nums.length !== val.length || (val.length !== 3 && val.length !== 4)) {
+            throw new Error(`Expected 3 or 4 finite numbers for '${key}', got ${JSON.stringify(val)}`);
+        }
+        return { r: nums[0], g: nums[1], b: nums[2], a: nums.length === 4 ? nums[3] : 1 };
+    }
+    if (typeof val === 'object')
+        return val;
+    throw new Error(`Expected an object or a numeric array for '${key}', got ${typeof val}`);
+}
+export async function resolveObjectPath(args, tools, config) {
+    const pathKeys = config?.pathKeys || ['objectPath', 'path'];
+    const actorKeys = config?.actorKeys || ['actorName', 'name'];
+    const fallback = config?.fallbackToName !== false;
+    for (const key of pathKeys) {
+        const val = args[key];
+        if (typeof val === 'string' && val.trim().length > 0) {
+            return val.trim().replace(/\/+$/, '');
+        }
+    }
+    let potentialName;
+    for (const key of actorKeys) {
+        const val = args[key];
+        if (typeof val === 'string' && val.trim().length > 0) {
+            potentialName = val.trim();
+            break;
+        }
+    }
+    if (potentialName) {
+        try {
+            const res = await executeAutomationRequest(tools, TOOL_ACTIONS.CONTROL_ACTOR, { action: 'find_by_name', name: potentialName });
+            const container = res && (res.result || res);
+            const actors = container && Array.isArray(container.actors) ? container.actors : [];
+            if (actors.length > 0) {
+                const first = actors[0];
+                const resolvedPath = first.path || first.objectPath || first.levelPath;
+                if (typeof resolvedPath === 'string' && resolvedPath.trim().length > 0) {
+                    return resolvedPath.trim();
+                }
+            }
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+        }
+        if (fallback)
+            return potentialName;
+    }
+    return undefined;
+}
+//# sourceMappingURL=argument-helper.js.map

package/dist/tools/handlers/foundation/arguments/argument-helper.js.map

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

package/dist/tools/handlers/foundation/arguments/argument-normalization.d.ts

@@ -0,0 +1,11 @@
+import type { HandlerArgs } from '../../../../types/handlers/handler-types.js';
+export interface ArgConfig {
+    key: string;
+    aliases?: string[];
+    required?: boolean;
+    default?: unknown;
+    map?: Record<string, string>;
+    validator?: (val: unknown) => void | string;
+}
+export declare function normalizeArgs(args: HandlerArgs, configs: ArgConfig[]): Record<string, unknown>;
+//# sourceMappingURL=argument-normalization.d.ts.map

package/dist/tools/handlers/foundation/arguments/argument-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument-normalization.d.ts","sourceRoot":"","sources":["../../../../../src/tools/handlers/foundation/arguments/argument-normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAE/E,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,CAAC;CAC7C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9F"}

package/dist/tools/handlers/foundation/arguments/argument-normalization.js

@@ -0,0 +1,46 @@
+export function normalizeArgs(args, configs) {
+    return normalizeArgsInternal(args, configs);
+}
+function normalizeArgsInternal(args, configs) {
+    const normalized = { ...args };
+    for (const config of configs) {
+        let val = undefined;
+        if (args[config.key] !== undefined && args[config.key] !== null && args[config.key] !== '') {
+            val = args[config.key];
+        }
+        if (val === undefined && config.aliases) {
+            for (const alias of config.aliases) {
+                if (args[alias] !== undefined && args[alias] !== null && args[alias] !== '') {
+                    val = args[alias];
+                    break;
+                }
+            }
+        }
+        if (val === undefined && config.default !== undefined) {
+            val = config.default;
+        }
+        if (config.required) {
+            if (val === undefined || val === null || (typeof val === 'string' && val.trim() === '')) {
+                const aliasStr = config.aliases ? ` (or ${config.aliases.join(', ')})` : '';
+                throw new Error(`Missing required argument: ${config.key}${aliasStr}`);
+            }
+        }
+        if (config.map && typeof val === 'string') {
+            const mappedValue = config.map[val];
+            if (mappedValue) {
+                val = mappedValue;
+            }
+        }
+        if (config.validator && val !== undefined) {
+            const err = config.validator(val);
+            if (typeof err === 'string') {
+                throw new Error(`Invalid argument '${config.key}': ${err}`);
+            }
+        }
+        if (val !== undefined) {
+            normalized[config.key] = val;
+        }
+    }
+    return normalized;
+}
+//# sourceMappingURL=argument-normalization.js.map

package/dist/tools/handlers/foundation/arguments/argument-normalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument-normalization.js","sourceRoot":"","sources":["../../../../../src/tools/handlers/foundation/arguments/argument-normalization.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,aAAa,CAAC,IAAiB,EAAE,OAAoB;IACnE,OAAO,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAiB,EAAE,OAAoB;IACpE,MAAM,UAAU,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IAExD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,GAAG,GAAY,SAAS,CAAC;QAE7B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;YAC3F,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACxC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;oBAC5E,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;oBAClB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACtD,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;QACvB,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;gBACxF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5E,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,GAAG,GAAG,QAAQ,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,WAAW,EAAE,CAAC;gBAChB,GAAG,GAAG,WAAW,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/tools/handlers/foundation/arguments/batch-validation.d.ts

@@ -0,0 +1,2 @@
+export declare function validateRequiredFields(args: Record<string, unknown>, fields: readonly string[]): Record<string, string>;
+//# sourceMappingURL=batch-validation.d.ts.map

package/dist/tools/handlers/foundation/arguments/batch-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-validation.d.ts","sourceRoot":"","sources":["../../../../../src/tools/handlers/foundation/arguments/batch-validation.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB"}

package/dist/tools/handlers/foundation/arguments/batch-validation.js

@@ -0,0 +1,10 @@
+import { requireNonEmptyString } from './handler-argument-validation.js';
+export function validateRequiredFields(args, fields) {
+    const result = {};
+    for (const field of fields) {
+        requireNonEmptyString(args[field], field, `Missing required parameter: ${field}`);
+        result[field] = args[field];
+    }
+    return result;
+}
+//# sourceMappingURL=batch-validation.js.map

package/dist/tools/handlers/foundation/arguments/batch-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-validation.js","sourceRoot":"","sources":["../../../../../src/tools/handlers/foundation/arguments/batch-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,MAAM,UAAU,sBAAsB,CACpC,IAA6B,EAC7B,MAAyB;IAEzB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,+BAA+B,KAAK,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAW,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/handlers/foundation/arguments/handler-argument-validation.d.ts

@@ -0,0 +1,10 @@
+import type { HandlerArgs } from '../../../../types/handlers/handler-types.js';
+export declare function ensureArgsPresent(args: unknown): asserts args is Record<string, unknown>;
+export declare function validateSecurityPatterns(args: Record<string, unknown>): string | undefined;
+export declare function validateArgsSecurity(args: HandlerArgs): void;
+export declare function requireAction(args: HandlerArgs): string;
+export declare function requireNonEmptyString(value: unknown, field: string, message?: string): string;
+export declare function requireAssetName(value: unknown, field: string, message?: string): string;
+export declare function validateExpectedParams(args: Record<string, unknown>, allowedParams: string[], context?: string): void;
+export declare function validateRequiredParams(args: Record<string, unknown>, requiredParams: string[], context?: string): void;
+//# sourceMappingURL=handler-argument-validation.d.ts.map

package/dist/tools/handlers/foundation/arguments/handler-argument-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-argument-validation.d.ts","sourceRoot":"","sources":["../../../../../src/tools/handlers/foundation/arguments/handler-argument-validation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AA0G/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIxF;AA2DD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAQ1F;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAM5D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAOvD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQxF;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,GAAE,MAAkB,GAC1B,IAAI,CAWN;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,GAAE,MAAkB,GAC1B,IAAI,CAYN"}

package/dist/tools/handlers/foundation/arguments/handler-argument-validation.js

@@ -0,0 +1,173 @@
+import * as path from 'node:path';
+import { getAdditionalPathPrefixes } from '../../../../config.js';
+import { isUrlArgumentKey, validateUrlArgument, } from './handler-url-validation.js';
+function hasParentDirectorySegment(value) {
+    return value.replace(/\\/g, '/').split('/').some(segment => segment === '..');
+}
+function normalizeKey(key) {
+    return key.toLowerCase();
+}
+function isLocalFilesystemKey(key) {
+    const normalized = normalizeKey(key);
+    return normalized === 'filepath' ||
+        normalized === 'filepaths' ||
+        normalized === 'mediapath' ||
+        normalized === 'outputdirectory' ||
+        normalized === 'outputpath';
+}
+function isPathLikeKey(key) {
+    const normalized = normalizeKey(key);
+    return normalized.includes('path') ||
+        normalized.endsWith('directory') ||
+        normalized.endsWith('directories');
+}
+function isAllowedAbsolutePath(key, value, args) {
+    const lowerValue = value.toLowerCase();
+    const normalizedForRootCheck = path.posix
+        .normalize(value.replace(/\\/g, '/'))
+        .toLowerCase();
+    const additional = getAdditionalPathPrefixes();
+    const action = typeof args.action === 'string' ? args.action.toLowerCase() : '';
+    const normalizedKey = normalizeKey(key);
+    const isSnapshotPath = (normalizedKey === 'path' || normalizedKey === 'outputpath') &&
+        (action === 'export_snapshot' || action === 'import_snapshot');
+    const localRoots = isLocalFilesystemKey(key) ? ['/tmp'] : [];
+    const allowedRoots = ['/game', '/engine', '/script', '/temp', '/niagara',
+        ...(isSnapshotPath || isLocalFilesystemKey(key) ? ['/saved'] : []),
+        ...localRoots,
+        ...additional.map(prefix => prefix.replace(/\/$/, '').toLowerCase())];
+    return allowedRoots.some(root => {
+        const candidate = normalizedForRootCheck.startsWith(`${root}/`) ||
+            normalizedForRootCheck === root;
+        const rawMatches = lowerValue === root || lowerValue.startsWith(`${root}/`);
+        return candidate || rawMatches;
+    });
+}
+function validateStringSecurity(args, key, value) {
+    const blockedPathPatterns = [
+        '/etc/',
+        '\\Windows\\',
+        '\\Program Files',
+    ];
+    const lowerValue = value.toLowerCase();
+    if (hasParentDirectorySegment(value)) {
+        return `Security violation: '${key}' contains blocked path pattern. Path traversal is not allowed.`;
+    }
+    for (const pattern of blockedPathPatterns) {
+        if (value.includes(pattern) || lowerValue.includes(pattern.toLowerCase())) {
+            return `Security violation: '${key}' contains blocked path pattern. Path traversal is not allowed.`;
+        }
+    }
+    if (isUrlArgumentKey(key)) {
+        return validateUrlArgument(key, value);
+    }
+    if (isPathLikeKey(key) && value.startsWith('/') && !isAllowedAbsolutePath(key, value, args)) {
+        const savedNote = isLocalFilesystemKey(key) ? ', /Saved/, /tmp/' : '';
+        return `Security violation: '${key}' uses unauthorized absolute path. Only /Game/, /Engine/, /Script/, /Temp/${savedNote}, /Niagara/ paths are allowed by default. Set MCP_ADDITIONAL_PATH_PREFIXES to whitelist custom plugin content mount points.`;
+    }
+    return undefined;
+}
+export function ensureArgsPresent(args) {
+    if (args === null || args === undefined) {
+        throw new Error('Invalid arguments: null or undefined');
+    }
+}
+const MAX_VALIDATION_DEPTH = 12;
+function validateValue(args, key, value, depth) {
+    if (typeof value === 'string') {
+        return validateStringSecurity(args, key, value);
+    }
+    if (Array.isArray(value)) {
+        if (depth >= MAX_VALIDATION_DEPTH) {
+            return undefined;
+        }
+        for (const entry of value) {
+            if (typeof entry === 'string') {
+                const error = validateStringSecurity(args, key, entry);
+                if (error) {
+                    return error;
+                }
+                continue;
+            }
+            if (entry !== null && typeof entry === 'object') {
+                for (const [entryKey, entryValue] of Object.entries(entry)) {
+                    const error = validateValue(args, entryKey, entryValue, depth + 1);
+                    if (error) {
+                        return error;
+                    }
+                }
+            }
+        }
+        return undefined;
+    }
+    if (value !== null && typeof value === 'object') {
+        if (depth >= MAX_VALIDATION_DEPTH) {
+            return undefined;
+        }
+        for (const [entryKey, entry] of Object.entries(value)) {
+            const error = validateValue(args, entryKey, entry, depth + 1);
+            if (error) {
+                return error;
+            }
+        }
+        return undefined;
+    }
+    return undefined;
+}
+export function validateSecurityPatterns(args) {
+    for (const [key, value] of Object.entries(args)) {
+        const error = validateValue(args, key, value, 0);
+        if (error) {
+            return error;
+        }
+    }
+    return undefined;
+}
+export function validateArgsSecurity(args) {
+    ensureArgsPresent(args);
+    const securityError = validateSecurityPatterns(args);
+    if (securityError) {
+        throw new Error(securityError);
+    }
+}
+export function requireAction(args) {
+    ensureArgsPresent(args);
+    const action = args.action;
+    if (typeof action !== 'string' || action.trim() === '') {
+        throw new Error('Missing required parameter: action');
+    }
+    return action;
+}
+export function requireNonEmptyString(value, field, message) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error(message ?? `Invalid ${field}: must be a non-empty string`);
+    }
+    return value;
+}
+export function requireAssetName(value, field, message) {
+    const strValue = requireNonEmptyString(value, field, message);
+    if (strValue.includes('/') || strValue.includes('\\')) {
+        throw new Error(message ?? `Invalid ${field}: '${strValue}' appears to be a path, not an asset name. Asset names should not contain '/' or '\\' characters. If you meant to specify a path, use the appropriate path parameter instead.`);
+    }
+    return strValue;
+}
+export function validateExpectedParams(args, allowedParams, context = 'handler') {
+    const alwaysAllowed = ['action', 'subAction', 'timeoutMs'];
+    const allAllowed = new Set([...alwaysAllowed, ...allowedParams]);
+    const unknownParams = Object.keys(args).filter(key => !allAllowed.has(key));
+    if (unknownParams.length > 0) {
+        throw new Error(`Invalid parameters for ${context}: unknown parameters [${unknownParams.join(', ')}]. ` +
+            `Allowed: [${allowedParams.join(', ')}]`);
+    }
+}
+export function validateRequiredParams(args, requiredParams, context = 'handler') {
+    const missingParams = requiredParams.filter(param => {
+        const value = args[param];
+        return value === undefined || value === null ||
+            (typeof value === 'string' && value.trim() === '');
+    });
+    if (missingParams.length > 0) {
+        throw new Error(`Missing required parameters for ${context}: [${missingParams.join(', ')}]`);
+    }
+}
+//# sourceMappingURL=handler-argument-validation.js.map

package/dist/tools/handlers/foundation/arguments/handler-argument-validation.js.map

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

package/dist/tools/handlers/foundation/arguments/handler-url-validation.d.ts

@@ -0,0 +1,3 @@
+export declare function isUrlArgumentKey(key: string): boolean;
+export declare function validateUrlArgument(key: string, value: string): string | undefined;
+//# sourceMappingURL=handler-url-validation.d.ts.map

package/dist/tools/handlers/foundation/arguments/handler-url-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-url-validation.d.ts","sourceRoot":"","sources":["../../../../../src/tools/handlers/foundation/arguments/handler-url-validation.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKrD;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CA8BpB"}

package/dist/tools/handlers/foundation/arguments/handler-url-validation.js

@@ -0,0 +1,29 @@
+export function isUrlArgumentKey(key) {
+    const normalized = key.toLowerCase();
+    return normalized === 'url' ||
+        normalized === 'urls' ||
+        normalized === 'streamurl';
+}
+export function validateUrlArgument(key, value) {
+    const trimmed = value.trim();
+    if (trimmed === '') {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch (error) {
+        if (error instanceof TypeError) {
+            return 'Security violation: \'' + key + '\' is not a valid absolute URL. ' +
+                'Network media URLs are disabled — use filePath or mediaPath with an allowed filesystem root instead.';
+        }
+        throw error;
+    }
+    const scheme = parsed.protocol.slice(0, -1).toLowerCase();
+    if (scheme === 'file') {
+        return `Security violation: '${key}' uses a file URL. Use filePath/mediaPath with an allowed filesystem root instead.`;
+    }
+    return `Security violation: '${key}' uses a network media URL, but network media URLs are disabled because redirect destinations and resolved addresses cannot be pinned by the media backend. Use filePath or mediaPath with an allowed filesystem root instead.`;
+}
+//# sourceMappingURL=handler-url-validation.js.map

package/dist/tools/handlers/foundation/arguments/handler-url-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-url-validation.js","sourceRoot":"","sources":["../../../../../src/tools/handlers/foundation/arguments/handler-url-validation.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,UAAU,KAAK,KAAK;QACzB,UAAU,KAAK,MAAM;QACrB,UAAU,KAAK,WAAW,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,KAAa;IAEb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAKnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAOD,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC/B,OAAO,wBAAwB,GAAG,GAAG,GAAG,kCAAkC;gBACxE,sGAAsG,CAAC;QAC3G,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,wBAAwB,GAAG,oFAAoF,CAAC;IACzH,CAAC;IACD,OAAO,wBAAwB,GAAG,gOAAgO,CAAC;AACrQ,CAAC"}

package/dist/tools/handlers/foundation/dispatch/automation-request-dispatch.d.ts

@@ -0,0 +1,27 @@
+import { ITools } from '../../../../types/tools/tool-interfaces.js';
+import type { HandlerArgs } from '../../../../types/handlers/handler-types.js';
+export interface SubActionDispatcher {
+    argsRecord: Record<string, unknown>;
+    sendRequest(subAction: string, extraPayload?: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+export declare function executeAutomationRequest(tools: ITools, toolName: string, args: HandlerArgs, errorMessage?: string, options?: {
+    timeoutMs?: number;
+    forwardTimeoutMsToUnreal?: boolean;
+    mcpRequestId?: string;
+}): Promise<unknown>;
+export declare function createSubActionDispatcher(tools: ITools, args: HandlerArgs, options: {
+    toolName: string;
+    domainName: string;
+    pathFields?: readonly string[];
+    timeoutMs?: number;
+    preparePayload?: (payload: Record<string, unknown>, subAction: string) => Record<string, unknown>;
+}): SubActionDispatcher;
+export declare function executeBatchConsoleCommands(tools: ITools, commands: string[], options?: {
+    timeoutMs?: number;
+}): Promise<{
+    success: boolean;
+    totalCommands: number;
+    executedCount: number;
+    failedCount: number;
+}>;
+//# sourceMappingURL=automation-request-dispatch.d.ts.map

package/dist/tools/handlers/foundation/dispatch/automation-request-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation-request-dispatch.d.ts","sourceRoot":"","sources":["../../../../../src/tools/handlers/foundation/dispatch/automation-request-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4CAA4C,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAa/E,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1G;AA4CD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,YAAY,GAAE,MAA0C,EACxD,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,OAAO,CAAC,OAAO,CAAC,CA6ElB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnG,GACA,mBAAmB,CA4BrB;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CA2CD"}

package/dist/tools/handlers/foundation/dispatch/automation-request-dispatch.js

@@ -0,0 +1,135 @@
+import { CommandValidator } from '../../../../utils/commands/command-validator.js';
+import { cleanObject } from '../../../../utils/serialization/safe-json.js';
+import { validateArgsSecurity } from '../arguments/handler-argument-validation.js';
+import { getMcpRequestContext } from '../../../../automation/request-context.js';
+import { getGatewayCorrelationId } from '../../../../automation/gateway-correlation-context.js';
+import { getGatewayConsent } from '../../../../automation/gateway-consent-context.js';
+import { getGatewayExpectedRevisions } from '../../../../automation/gateway-expected-revisions-context.js';
+import { getGatewayTimeoutMs } from '../../../../automation/gateway-timeout-context.js';
+import { resolveActionTimeoutMs } from './handler-timeout.js';
+import { normalizePathFields } from '../normalization/ue-path-normalization.js';
+function requireConsoleCommandString(value, context) {
+    if (typeof value !== 'string') {
+        throw new Error(`${context} must be a string`);
+    }
+    return value;
+}
+function validateConsoleCommandPayload(toolName, args) {
+    const normalizedToolName = toolName.toLowerCase();
+    if (normalizedToolName === 'console_command') {
+        CommandValidator.validate(requireConsoleCommandString(args.command, 'console_command.command'));
+        return;
+    }
+    if (normalizedToolName !== 'batch_console_commands') {
+        return;
+    }
+    const commands = args.commands;
+    if (!Array.isArray(commands)) {
+        throw new Error('batch_console_commands.commands must be an array');
+    }
+    for (const [index, entry] of commands.entries()) {
+        if (typeof entry === 'string') {
+            CommandValidator.validate(entry);
+            continue;
+        }
+        if (entry && typeof entry === 'object' && !Array.isArray(entry)) {
+            const commandRecord = entry;
+            const command = typeof commandRecord.command === 'string' && commandRecord.command.trim().length > 0
+                ? commandRecord.command
+                : commandRecord.cmd;
+            CommandValidator.validate(requireConsoleCommandString(command, `batch_console_commands.commands[${index}]`));
+            continue;
+        }
+        throw new Error(`batch_console_commands.commands[${index}] must be a string or command object`);
+    }
+}
+export async function executeAutomationRequest(tools, toolName, args, errorMessage = 'Automation bridge not available', options = {}) {
+    validateArgsSecurity(args);
+    validateConsoleCommandPayload(toolName, args);
+    const automationBridge = tools.automationBridge;
+    if (!automationBridge || typeof automationBridge.sendAutomationRequest !== 'function') {
+        throw new Error(errorMessage);
+    }
+    if (!automationBridge.isConnected()) {
+        throw new Error(`Automation bridge is not connected to Unreal Engine. Please check if the editor is running and the plugin is enabled. Action: ${toolName}`);
+    }
+    const timeoutMs = options.timeoutMs
+        ?? getGatewayTimeoutMs()
+        ?? (typeof args.timeoutMs === 'number'
+            ? args.timeoutMs
+            : resolveActionTimeoutMs(toolName, typeof args.action === 'string' ? args.action : undefined));
+    const cleanedArgs = { ...args };
+    if (options.forwardTimeoutMsToUnreal) {
+        const action = typeof cleanedArgs.action === 'string' ? cleanedArgs.action : undefined;
+        if (toolName !== 'manage_sequence' || action !== 'start_render') {
+            throw new Error(`forwardTimeoutMsToUnreal is only valid for manage_sequence/start_render (got ${toolName}${action ? `/${action}` : ''}).`);
+        }
+    }
+    else {
+        delete cleanedArgs.timeoutMs;
+    }
+    const mcpRequestId = options.mcpRequestId ?? getMcpRequestContext()?.requestId;
+    const gatewayCorrelationId = getGatewayCorrelationId();
+    const gatewayConsent = getGatewayConsent();
+    const gatewayExpectedRevisions = getGatewayExpectedRevisions();
+    const sendOptions = {};
+    if (timeoutMs !== undefined)
+        sendOptions.timeoutMs = timeoutMs;
+    if (mcpRequestId !== undefined)
+        sendOptions.mcpRequestId = mcpRequestId;
+    if (gatewayCorrelationId !== undefined)
+        sendOptions.correlationId = gatewayCorrelationId;
+    if (gatewayConsent !== undefined)
+        sendOptions.consent = gatewayConsent;
+    if (gatewayExpectedRevisions !== undefined)
+        sendOptions.expectedRevisions = gatewayExpectedRevisions;
+    return await automationBridge.sendAutomationRequest(toolName, cleanedArgs, sendOptions);
+}
+export function createSubActionDispatcher(tools, args, options) {
+    const rawArgs = args;
+    const argsRecord = options.pathFields && options.pathFields.length > 0
+        ? normalizePathFields(rawArgs, options.pathFields)
+        : { ...rawArgs };
+    const timeoutMs = options.timeoutMs
+        ?? (typeof argsRecord.timeoutMs === 'number'
+            ? argsRecord.timeoutMs
+            : resolveActionTimeoutMs(options.toolName, typeof argsRecord.action === 'string' ? argsRecord.action : undefined));
+    return {
+        argsRecord,
+        async sendRequest(subAction, extraPayload = {}) {
+            const rawPayload = { ...argsRecord, ...extraPayload, subAction };
+            const normalizedPayload = options.pathFields && options.pathFields.length > 0
+                ? normalizePathFields(rawPayload, options.pathFields)
+                : rawPayload;
+            const payload = options.preparePayload ? options.preparePayload(normalizedPayload, subAction) : normalizedPayload;
+            const result = await executeAutomationRequest(tools, options.toolName, payload, `Automation bridge not available for ${options.domainName} action: ${subAction}`, { timeoutMs });
+            return cleanObject(result);
+        }
+    };
+}
+export async function executeBatchConsoleCommands(tools, commands, options = {}) {
+    const validCommands = commands
+        .map(command => command?.trim())
+        .filter(command => command && command.length > 0);
+    if (validCommands.length === 0) {
+        return {
+            success: true,
+            totalCommands: 0,
+            executedCount: 0,
+            failedCount: 0
+        };
+    }
+    const result = await executeAutomationRequest(tools, 'batch_console_commands', { commands: validCommands }, 'Automation bridge not available for batch commands', options);
+    const failedCount = result.failedCount ?? 0;
+    if (result.success === false || failedCount > 0) {
+        throw new Error(`Batch command execution failed: ${failedCount}/${validCommands.length} commands failed. ` +
+            (result.message || result.error || 'Unknown error'));
+    }
+    return {
+        success: true,
+        totalCommands: result.totalCommands ?? validCommands.length,
+        executedCount: result.executedCount ?? validCommands.length,
+        failedCount: 0
+    };
+}
+//# sourceMappingURL=automation-request-dispatch.js.map