unreal-engine-mcp-server 0.6.0-beta-e → 0.6.0

package/dist/tools/dynamic/dynamic-tool-manager.d.ts

@@ -1,55 +0,0 @@
-export type ToolCategory = 'core' | 'world' | 'gameplay' | 'utility' | 'all';
-export interface ToolState {
-    name: string;
-    category: ToolCategory;
-    enabled: boolean;
-}
-export interface CategoryState {
-    name: ToolCategory;
-    enabled: boolean;
-    toolCount: number;
-    enabledCount: number;
-}
-declare class DynamicToolManager {
-    private readonly tools;
-    private readonly categories;
-    private catalogStateRevision;
-    constructor();
-    isToolEnabled(toolName: string): boolean;
-    listTools(): ToolState[];
-    listCategories(): CategoryState[];
-    enableTools(toolNames: string[]): {
-        enabled: string[];
-        notFound: string[];
-    };
-    disableTools(toolNames: string[]): {
-        disabled: string[];
-        notFound: string[];
-        protected: string[];
-    };
-    enableCategory(category: ToolCategory): {
-        enabled: string[];
-        notFound: boolean;
-    };
-    disableCategory(category: ToolCategory): {
-        disabled: string[];
-        notFound: boolean;
-        protected: string[];
-    };
-    getStatus(): {
-        totalTools: number;
-        enabledTools: number;
-        disabledTools: number;
-        categories: CategoryState[];
-        catalogStateRevision: number;
-    };
-    getCatalogStateRevision(): number;
-    reset(): {
-        enabled: number;
-    };
-    private visibilityFingerprint;
-    private applyMutation;
-}
-export declare const dynamicToolManager: DynamicToolManager;
-export {};
-//# sourceMappingURL=dynamic-tool-manager.d.ts.map

package/dist/tools/dynamic/dynamic-tool-manager.js

@@ -1,171 +0,0 @@
-import { Logger } from '../../utils/logging/logger.js';
-import { generatedParentToolDefinitions } from '../catalog/capabilities/generated/parent-tool-definitions.generated.js';
-const PROTECTED_TOOL_NAMES = new Set(['manage_tools', 'inspect']);
-const PROTECTED_CATEGORY = 'core';
-const log = new Logger('DynamicToolManager');
-class DynamicToolManager {
-    tools = new Map();
-    categories = new Map();
-    catalogStateRevision = 0;
-    constructor() {
-        for (const def of generatedParentToolDefinitions) {
-            const category = def.category ?? 'utility';
-            this.tools.set(def.name, { category, enabled: true });
-            this.categories.set(category, true);
-        }
-        log.info(`Initialized with ${this.tools.size} tools across ${this.categories.size} categories`);
-    }
-    isToolEnabled(toolName) {
-        const tool = this.tools.get(toolName);
-        return tool !== undefined && tool.enabled && (this.categories.get(tool.category) ?? true);
-    }
-    listTools() {
-        return [...this.tools].map(([name, { category }]) => ({ name, category, enabled: this.isToolEnabled(name) }));
-    }
-    listCategories() {
-        const tools = this.listTools();
-        return [...this.categories].map(([name, enabled]) => {
-            const members = tools.filter((tool) => tool.category === name);
-            return { name, enabled, toolCount: members.length, enabledCount: members.filter((tool) => tool.enabled).length };
-        });
-    }
-    enableTools(toolNames) {
-        const enabled = [];
-        const notFound = [];
-        this.applyMutation(() => {
-            for (const name of toolNames) {
-                const tool = this.tools.get(name);
-                if (tool === undefined) {
-                    notFound.push(name);
-                    continue;
-                }
-                this.categories.set(tool.category, true);
-                tool.enabled = true;
-                enabled.push(name);
-            }
-        });
-        if (enabled.length > 0)
-            log.info(`Enabled tools: ${enabled.join(', ')}`);
-        if (notFound.length > 0)
-            log.warn(`Tools not found: ${notFound.join(', ')}`);
-        return { enabled, notFound };
-    }
-    disableTools(toolNames) {
-        const disabled = [];
-        const notFound = [];
-        const protectedTools = [];
-        this.applyMutation(() => {
-            for (const name of toolNames) {
-                const tool = this.tools.get(name);
-                if (PROTECTED_TOOL_NAMES.has(name))
-                    protectedTools.push(name);
-                else if (tool === undefined)
-                    notFound.push(name);
-                else {
-                    tool.enabled = false;
-                    disabled.push(name);
-                }
-            }
-        });
-        if (disabled.length > 0)
-            log.info(`Disabled tools: ${disabled.join(', ')}`);
-        if (protectedTools.length > 0)
-            log.warn(`Cannot disable protected tools: ${protectedTools.join(', ')}`);
-        return { disabled, notFound, protected: protectedTools };
-    }
-    enableCategory(category) {
-        if (category !== 'all' && !this.categories.has(category))
-            return { enabled: [], notFound: true };
-        const enabled = [];
-        this.applyMutation(() => {
-            for (const name of this.categories.keys()) {
-                if (category === 'all' || name === category)
-                    this.categories.set(name, true);
-            }
-            for (const [name, tool] of this.tools) {
-                if ((category === 'all' || tool.category === category) && !tool.enabled) {
-                    tool.enabled = true;
-                    enabled.push(name);
-                }
-            }
-        });
-        if (enabled.length > 0)
-            log.info(`Enabled ${category === 'all' ? 'all categories' : `category '${category}'`}: ${enabled.length} tools`);
-        return { enabled, notFound: false };
-    }
-    disableCategory(category) {
-        if (category !== 'all' && !this.categories.has(category))
-            return { disabled: [], notFound: true, protected: [] };
-        const disabled = [];
-        const protectedTools = [];
-        if (category === PROTECTED_CATEGORY) {
-            for (const [name, tool] of this.tools) {
-                if (tool.category === category && PROTECTED_TOOL_NAMES.has(name))
-                    protectedTools.push(name);
-            }
-            log.warn(`Cannot disable protected category: ${category}`);
-            return { disabled, notFound: false, protected: protectedTools };
-        }
-        this.applyMutation(() => {
-            for (const name of this.categories.keys()) {
-                if (category === 'all' ? name !== PROTECTED_CATEGORY : name === category)
-                    this.categories.set(name, false);
-            }
-            for (const [name, tool] of this.tools) {
-                if (category !== 'all' && tool.category !== category)
-                    continue;
-                if (PROTECTED_TOOL_NAMES.has(name) || (category === 'all' && tool.category === PROTECTED_CATEGORY)) {
-                    protectedTools.push(name);
-                }
-                else if (tool.enabled) {
-                    tool.enabled = false;
-                    disabled.push(name);
-                }
-            }
-        });
-        if (disabled.length > 0)
-            log.info(`Disabled ${category === 'all' ? 'all categories' : `category '${category}'`}: ${disabled.length} tools`);
-        return { disabled, notFound: false, protected: protectedTools };
-    }
-    getStatus() {
-        const enabledTools = this.listTools().filter((tool) => tool.enabled).length;
-        return {
-            totalTools: this.tools.size,
-            enabledTools,
-            disabledTools: this.tools.size - enabledTools,
-            categories: this.listCategories(),
-            catalogStateRevision: this.catalogStateRevision
-        };
-    }
-    getCatalogStateRevision() {
-        return this.catalogStateRevision;
-    }
-    reset() {
-        let count = 0;
-        this.applyMutation(() => {
-            for (const tool of this.tools.values()) {
-                if (!tool.enabled) {
-                    tool.enabled = true;
-                    count++;
-                }
-            }
-            for (const name of this.categories.keys())
-                this.categories.set(name, true);
-        });
-        log.info(`Reset ${count} tools to enabled state`);
-        return { enabled: count };
-    }
-    visibilityFingerprint() {
-        const tools = [...this.tools].map(([name, tool]) => `${name}=${tool.enabled ? 1 : 0}`);
-        const categories = [...this.categories].map(([name, enabled]) => `${name}=${enabled ? 1 : 0}`);
-        return `${tools.join(',')}|${categories.join(',')}`;
-    }
-    applyMutation(mutate) {
-        const before = this.visibilityFingerprint();
-        mutate();
-        if (this.visibilityFingerprint() !== before)
-            this.catalogStateRevision++;
-    }
-}
-export const dynamicToolManager = new DynamicToolManager();
-//# sourceMappingURL=dynamic-tool-manager.js.map

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

@@ -1,2 +0,0 @@
-export declare function validateArgsSecurity(args: Record<string, unknown>): void;
-//# sourceMappingURL=handler-argument-validation.d.ts.map

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

@@ -1,160 +0,0 @@
-import * as path from 'node:path';
-import { getConfiguredContentRoots, getEditorContentRoots, } from '../../../../utils/paths/path-security.js';
-function hasParentDirectorySegment(value) {
-    return value.replace(/\\/g, '/').split('/').some(segment => segment === '..');
-}
-function normalizeKey(key) {
-    return key.toLowerCase();
-}
-function effectiveAction(args) {
-    if (typeof args.subAction === 'string' && args.subAction !== '') {
-        return args.subAction.toLowerCase();
-    }
-    return typeof args.action === 'string' ? args.action.toLowerCase() : '';
-}
-const FILE_KEYS = new Set([
-    'filepath',
-    'filepaths',
-    'mediapath',
-    'outputdirectory',
-    'outputpath',
-    'heightmappath',
-    'externalpath',
-]);
-const FILE_KEYS_BY_ACTION = {
-    sourcepath: new Set(['import', 'import_struct']),
-    path: new Set(['screenshot', 'take_screenshot', 'export_heightmap']),
-};
-function isLocalFilesystemKey(key, action, value) {
-    const normalized = normalizeKey(key);
-    if (normalized === 'exportpath') {
-        return action !== 'export_level' || value.toLowerCase().endsWith('.t3d');
-    }
-    const scoped = FILE_KEYS_BY_ACTION[normalized];
-    if (scoped) {
-        return scoped.has(action);
-    }
-    return FILE_KEYS.has(normalized);
-}
-function isPathLikeKey(key) {
-    const normalized = normalizeKey(key);
-    return normalized.includes('path') ||
-        normalized.endsWith('directory') ||
-        normalized.endsWith('directories');
-}
-function isUnderRoot(value, root) {
-    return value === root || value.startsWith(`${root}/`);
-}
-function isAllowedAbsolutePath(key, value, args) {
-    if (/^[\\/]{2}/u.test(value)) {
-        return false;
-    }
-    const slashed = value.replace(/\\/g, '/');
-    const normalizedForRootCheck = path.posix.normalize(slashed).toLowerCase();
-    const lowerValue = value.toLowerCase();
-    const action = effectiveAction(args);
-    const normalizedKey = normalizeKey(key);
-    const isSnapshotPath = (normalizedKey === 'path' || normalizedKey === 'outputpath') &&
-        (action === 'export_snapshot' || action === 'import_snapshot');
-    const isFileKey = isLocalFilesystemKey(key, action, value);
-    const staticRoots = [
-        ...getConfiguredContentRoots().map(root => root.toLowerCase()),
-        ...(isSnapshotPath || isFileKey ? ['/saved'] : []),
-        ...(isFileKey ? ['/tmp'] : []),
-    ];
-    if (staticRoots.some(root => isUnderRoot(normalizedForRootCheck, root) || isUnderRoot(lowerValue, root))) {
-        return true;
-    }
-    if (isFileKey || isSnapshotPath || path.posix.normalize(slashed) !== slashed) {
-        return false;
-    }
-    const lowerSlashed = slashed.toLowerCase();
-    return getEditorContentRoots().some(root => isUnderRoot(lowerSlashed, root.toLowerCase()));
-}
-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 (isPathLikeKey(key) && value.startsWith('/') && !isAllowedAbsolutePath(key, value, args)) {
-        if (isLocalFilesystemKey(key, effectiveAction(args), value)) {
-            return `Security violation: '${key}' uses unauthorized absolute path. A file path must be under /Game/, /Engine/, /Script/, /Temp/, /Niagara/, /Saved/ or /tmp/, or a prefix listed in MCP_ADDITIONAL_PATH_PREFIXES.`;
-        }
-        return `Security violation: '${key}' uses unauthorized absolute path. Only /Game/, /Engine/, /Script/, /Temp/, /Niagara/, the content mounts the connected editor reports, and MCP_ADDITIONAL_PATH_PREFIXES are allowed; a path may not start with two separators.`;
-    }
-    return undefined;
-}
-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;
-}
-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);
-    }
-}
-//# sourceMappingURL=handler-argument-validation.js.map

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

@@ -1,13 +0,0 @@
-import { ITools } from '../../../../types/tools/tool-interfaces.js';
-import type { ExpectedRevisions } from '../../../catalog/capabilities/semantic/execution-options.js';
-export interface GatewayControls {
-    readonly timeoutMs?: number;
-    readonly correlationId?: string;
-    readonly consent?: {
-        capability: string;
-        acknowledge: 'explicit' | 'elevated';
-    };
-    readonly expectedRevisions?: ExpectedRevisions;
-}
-export declare function executeAutomationRequest(tools: ITools, toolName: string, args: Record<string, unknown>, controls?: GatewayControls): Promise<unknown>;
-//# sourceMappingURL=automation-request-dispatch.d.ts.map

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

@@ -1,60 +0,0 @@
-import { CommandValidator } from '../../../../utils/commands/command-validator.js';
-import { validateArgsSecurity } from '../arguments/handler-argument-validation.js';
-import { getMcpRequestContext } from '../../../../automation/request-context.js';
-import { resolveActionTimeoutMs } from './handler-timeout.js';
-const CONSOLE_ACTIONS = new Set(['console_command', 'execute_command']);
-function firstNonEmpty(args, keys) {
-    for (const key of keys) {
-        const value = args[key];
-        if (typeof value === 'string' && value.trim() !== '')
-            return value.trim();
-    }
-    return '';
-}
-function composedConsoleCommand(action, args) {
-    if (action === 'set_cvar') {
-        const name = firstNonEmpty(args, ['name', 'cvar', 'key', 'command']);
-        if (name === '')
-            return undefined;
-        const raw = args.value;
-        const value = typeof raw === 'boolean' ? (raw ? '1' : '0')
-            : typeof raw === 'number' || typeof raw === 'string' ? String(raw) : '';
-        return value === '' ? name : `${name} ${value}`;
-    }
-    if (action === 'set_resolution' || action === 'set_fullscreen') {
-        const resolution = firstNonEmpty(args, ['resolution']);
-        return resolution === '' ? undefined : `r.SetRes ${resolution}`;
-    }
-    return undefined;
-}
-export async function executeAutomationRequest(tools, toolName, args, controls = {}) {
-    validateArgsSecurity(args);
-    const action = typeof args.action === 'string' ? args.action : undefined;
-    if (CONSOLE_ACTIONS.has(action ?? toolName)) {
-        CommandValidator.validate(typeof args.command === 'string' ? args.command : '');
-    }
-    const composed = composedConsoleCommand(action, args);
-    if (composed !== undefined)
-        CommandValidator.validate(composed);
-    const automationBridge = tools.automationBridge;
-    if (!automationBridge) {
-        throw new Error('Automation bridge not available');
-    }
-    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 = controls.timeoutMs ?? resolveActionTimeoutMs(toolName, action);
-    const sendOptions = { timeoutMs };
-    const mcpRequestId = getMcpRequestContext()?.requestId;
-    const { correlationId, consent, expectedRevisions } = controls;
-    if (mcpRequestId !== undefined)
-        sendOptions.mcpRequestId = mcpRequestId;
-    if (correlationId !== undefined)
-        sendOptions.correlationId = correlationId;
-    if (consent !== undefined)
-        sendOptions.consent = consent;
-    if (expectedRevisions !== undefined)
-        sendOptions.expectedRevisions = expectedRevisions;
-    return await automationBridge.sendAutomationRequest(toolName, args, sendOptions);
-}
-//# sourceMappingURL=automation-request-dispatch.js.map

package/dist/tools/handlers/foundation/dispatch/handler-timeout.d.ts

@@ -1,5 +0,0 @@
-import type { CapabilityCost } from '../../../catalog/capabilities/model.js';
-export declare function resolveCostTimeoutMs(cost: CapabilityCost): number;
-export declare const MRQ_START_RENDER_TRANSPORT_MS = 335000;
-export declare function resolveActionTimeoutMs(toolName: string, action?: string): number;
-//# sourceMappingURL=handler-timeout.d.ts.map

package/dist/tools/handlers/foundation/dispatch/handler-timeout.js

@@ -1,28 +0,0 @@
-import { CAPABILITY_TIMEOUT_TIER_MS, MIN_CAPABILITY_TIMEOUT_MS, UNKNOWN_CAPABILITY_TIMEOUT_MS, requestTimeoutOverrideMs } from '../../../../config.js';
-import { CAPABILITY_COST_INDEX } from '../../../catalog/capabilities/generated/capability-cost-index.generated.js';
-const isLatencyClass = (value) => value in CAPABILITY_TIMEOUT_TIER_MS;
-const isResourceClass = (value) => value in CAPABILITY_TIMEOUT_TIER_MS.instant;
-export function resolveCostTimeoutMs(cost) {
-    return Math.max(CAPABILITY_TIMEOUT_TIER_MS[cost.latency][cost.resources], MIN_CAPABILITY_TIMEOUT_MS);
-}
-export const MRQ_START_RENDER_TRANSPORT_MS = 335_000;
-export function resolveActionTimeoutMs(toolName, action) {
-    const budget = requestTimeoutOverrideMs() ?? tierTimeoutMs(toolName, action);
-    return toolName === 'manage_sequence' && action === 'start_render'
-        ? Math.max(budget, MRQ_START_RENDER_TRANSPORT_MS)
-        : budget;
-}
-function tierTimeoutMs(toolName, action) {
-    if (action === undefined || action.length === 0)
-        return UNKNOWN_CAPABILITY_TIMEOUT_MS;
-    const encoded = CAPABILITY_COST_INDEX[`${toolName}::${action}`];
-    if (encoded === undefined)
-        return UNKNOWN_CAPABILITY_TIMEOUT_MS;
-    const [latency, resources] = encoded.split('|');
-    if (latency === undefined || resources === undefined)
-        return UNKNOWN_CAPABILITY_TIMEOUT_MS;
-    if (!isLatencyClass(latency) || !isResourceClass(resources))
-        return UNKNOWN_CAPABILITY_TIMEOUT_MS;
-    return resolveCostTimeoutMs({ latency, resources });
-}
-//# sourceMappingURL=handler-timeout.js.map

package/dist/types/automation/automation-responses.d.ts

@@ -1,18 +0,0 @@
-export interface AutomationErrorDetail {
-    message: string;
-    code?: string;
-    [key: string]: unknown;
-}
-export interface AutomationResponse {
-    success: boolean;
-    message?: string;
-    error?: string | AutomationErrorDetail;
-    errorCode?: string;
-    result?: unknown;
-    assetPath?: string;
-    warnings?: string[];
-    details?: unknown;
-    data?: unknown;
-    [key: string]: unknown;
-}
-//# sourceMappingURL=automation-responses.d.ts.map

package/dist/types/automation/automation-responses.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=automation-responses.js.map

package/dist/types/tools/tool-interfaces.d.ts

@@ -1,26 +0,0 @@
-import type { AutomationBridgeStatus } from '../../automation/index.js';
-import type { BridgeAuthority } from '../../automation/message-schema.js';
-import type { ExpectedRevisions } from '../../tools/catalog/capabilities/semantic/execution-options.js';
-export interface AutomationRequestBridge {
-    isConnected(): boolean;
-    sendAutomationRequest(action: string, payload: Record<string, unknown>, options?: {
-        timeoutMs?: number;
-        mcpRequestId?: string;
-        correlationId?: string;
-        consent?: {
-            capability: string;
-            acknowledge: 'explicit' | 'elevated';
-        };
-        expectedRevisions?: ExpectedRevisions;
-    }): Promise<unknown>;
-    getAuthority?(): BridgeAuthority | undefined;
-    getVersionMismatch?(): string | undefined;
-    getClientUrl?(): string;
-}
-export interface AutomationStatusBridge {
-    getStatus(): AutomationBridgeStatus;
-}
-export interface ITools {
-    automationBridge?: AutomationRequestBridge;
-}
-//# sourceMappingURL=tool-interfaces.d.ts.map

package/dist/types/tools/tool-interfaces.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=tool-interfaces.js.map

package/dist/unreal-bridge.d.ts

@@ -1,27 +0,0 @@
-import type { AutomationBridge } from './automation/index.js';
-export interface EngineVersionInfo {
-    readonly version: string;
-    readonly major: number;
-    readonly minor: number;
-    readonly patch: number;
-    readonly isUE56OrAbove: boolean;
-}
-export interface FeatureFlagsInfo {
-    readonly subsystems: {
-        readonly unrealEditor: boolean;
-        readonly levelEditor: boolean;
-        readonly editorActor: boolean;
-    };
-}
-export declare class UnrealBridge {
-    private readonly log;
-    private automationBridge?;
-    get isConnected(): boolean;
-    setAutomationBridge(automationBridge?: AutomationBridge): void;
-    getAutomationBridge(): AutomationBridge;
-    tryConnect(): Promise<boolean>;
-    executeConsoleCommand(command: string): Promise<unknown>;
-    getEngineVersion(): Promise<EngineVersionInfo>;
-    getFeatureFlags(): FeatureFlagsInfo;
-}
-//# sourceMappingURL=unreal-bridge.d.ts.map

package/dist/unreal-bridge.js

@@ -1,59 +0,0 @@
-import { CONSOLE_COMMAND_TIMEOUT_MS, ENGINE_QUERY_TIMEOUT_MS } from './constants.js';
-import { CommandValidator } from './utils/commands/command-validator.js';
-import { Logger } from './utils/logging/logger.js';
-import { isRecord } from './utils/validation/type-guards.js';
-const isMock = () => process.env.MOCK_UNREAL_CONNECTION === 'true';
-function payloadOf(response) {
-    if (isRecord(response) && isRecord(response.result))
-        return response.result;
-    return isRecord(response) ? response : {};
-}
-export class UnrealBridge {
-    log = new Logger('UnrealBridge');
-    automationBridge;
-    get isConnected() {
-        return isMock() || this.automationBridge?.isConnected() === true;
-    }
-    setAutomationBridge(automationBridge) {
-        this.automationBridge = automationBridge;
-    }
-    getAutomationBridge() {
-        if (!this.automationBridge)
-            throw new Error('Automation bridge is not configured');
-        return this.automationBridge;
-    }
-    async tryConnect() {
-        if (this.isConnected)
-            return true;
-        return (await this.automationBridge?.connect()) ?? false;
-    }
-    async executeConsoleCommand(command) {
-        CommandValidator.validate(command);
-        if (isMock())
-            return { success: true, message: `Mock execution of '${command.trim()}' successful` };
-        const response = await this.getAutomationBridge().sendAutomationRequest('console_command', { command: command.trim() }, { timeoutMs: CONSOLE_COMMAND_TIMEOUT_MS });
-        if (isRecord(response) && response.success === false) {
-            throw new Error(String(response.message ?? response.error ?? 'Console command failed'));
-        }
-        return response;
-    }
-    async getEngineVersion() {
-        if (isMock())
-            return { version: '5.6.0-Mock', major: 5, minor: 6, patch: 0, isUE56OrAbove: true };
-        try {
-            const raw = payloadOf(await this.getAutomationBridge().sendAutomationRequest('inspect', { action: 'get_project_settings' }, { timeoutMs: ENGINE_QUERY_TIMEOUT_MS }));
-            const version = typeof raw.engineVersion === 'string' ? raw.engineVersion : 'unknown';
-            const [major = 0, minor = 0, patch = 0] = (/^(\d+)\.(\d+)\.(\d+)/.exec(version)?.slice(1) ?? []).map(Number);
-            return { version, major, minor, patch, isUE56OrAbove: major > 5 || (major === 5 && minor >= 6) };
-        }
-        catch (error) {
-            this.log.warn('getEngineVersion failed', error instanceof Error ? error.message : String(error));
-            return { version: 'unknown', major: 0, minor: 0, patch: 0, isUE56OrAbove: false };
-        }
-    }
-    getFeatureFlags() {
-        const up = this.isConnected;
-        return { subsystems: { unrealEditor: up, levelEditor: up, editorActor: up } };
-    }
-}
-//# sourceMappingURL=unreal-bridge.js.map

package/dist/utils/collections/bounded.d.ts

@@ -1,7 +0,0 @@
-export interface InsertionOrdered<K> {
-    readonly size: number;
-    delete(key: K): boolean;
-    keys(): IterableIterator<K>;
-}
-export declare function evictOldestUntilUnder<K>(collection: InsertionOrdered<K>, maxSize: number, onEvict?: (key: K) => void): number;
-//# sourceMappingURL=bounded.d.ts.map

package/dist/utils/collections/bounded.js

@@ -1,13 +0,0 @@
-export function evictOldestUntilUnder(collection, maxSize, onEvict) {
-    let evicted = 0;
-    while (collection.size >= maxSize) {
-        const oldest = collection.keys().next();
-        if (oldest.done === true)
-            break;
-        collection.delete(oldest.value);
-        evicted += 1;
-        onEvict?.(oldest.value);
-    }
-    return evicted;
-}
-//# sourceMappingURL=bounded.js.map

package/dist/utils/commands/command-validator.d.ts

@@ -1,4 +0,0 @@
-export declare class CommandValidator {
-    static validate(command: string): void;
-}
-//# sourceMappingURL=command-validator.d.ts.map