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

package/dist/automation/request-cancellation-error.js

@@ -1,11 +0,0 @@
-export class McpRequestCancelledError extends Error {
-    reason;
-    code = 'MCP_REQUEST_CANCELLED';
-    cancelled = true;
-    constructor(message, reason) {
-        super(message);
-        this.reason = reason;
-        this.name = 'McpRequestCancelledError';
-    }
-}
-//# sourceMappingURL=request-cancellation-error.js.map

package/dist/automation/request-context.d.ts

@@ -1,8 +0,0 @@
-export interface McpRequestContext {
-    readonly requestId: string;
-    readonly signal?: AbortSignal;
-}
-export declare function runWithMcpRequestContext<T>(context: McpRequestContext, fn: () => T): T;
-export declare function getMcpRequestContext(): McpRequestContext | undefined;
-export declare function canonicalizeMcpRequestId(id: string | number): string;
-//# sourceMappingURL=request-context.d.ts.map

package/dist/automation/request-context.js

@@ -1,12 +0,0 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-const mcpRequestContextStorage = new AsyncLocalStorage();
-export function runWithMcpRequestContext(context, fn) {
-    return mcpRequestContextStorage.run(context, fn);
-}
-export function getMcpRequestContext() {
-    return mcpRequestContextStorage.getStore();
-}
-export function canonicalizeMcpRequestId(id) {
-    return typeof id === 'number' ? `num:${id}` : `str:${id}`;
-}
-//# sourceMappingURL=request-context.js.map

package/dist/automation/request-correlation.d.ts

@@ -1,22 +0,0 @@
-import type { Logger } from '../utils/logging/logger.js';
-import type { QueuedRequestItem } from './types.js';
-interface CancelDelivery {
-    readonly sendFrame: (autoId: string) => void;
-    readonly rejectUnderlying: (autoId: string) => void;
-    readonly log: Logger;
-}
-export declare class RequestCorrelation {
-    private readonly autosByMcp;
-    private readonly mcpByAuto;
-    private readonly queuedByMcp;
-    register(mcpRequestId: string | undefined, autoId: string): void;
-    mcpRequestIdsForAuto(autoId: string): string[];
-    registerQueued(mcpRequestId: string | undefined, item: QueuedRequestItem): void;
-    detachQueued(item: QueuedRequestItem): void;
-    takeQueued(mcpRequestId: string): QueuedRequestItem[];
-    settle(autoId: string): void;
-    cancel(mcpRequestId: string, delivery: CancelDelivery): void;
-    clear(): void;
-}
-export {};
-//# sourceMappingURL=request-correlation.d.ts.map

package/dist/automation/request-correlation.js

@@ -1,79 +0,0 @@
-export class RequestCorrelation {
-    autosByMcp = new Map();
-    mcpByAuto = new Map();
-    queuedByMcp = new Map();
-    register(mcpRequestId, autoId) {
-        if (!mcpRequestId)
-            return;
-        this.mcpByAuto.set(autoId, mcpRequestId);
-        const autos = this.autosByMcp.get(mcpRequestId) ?? new Set();
-        autos.add(autoId);
-        this.autosByMcp.set(mcpRequestId, autos);
-    }
-    mcpRequestIdsForAuto(autoId) {
-        const mcpRequestId = this.mcpByAuto.get(autoId);
-        return mcpRequestId ? [mcpRequestId] : [];
-    }
-    registerQueued(mcpRequestId, item) {
-        if (!mcpRequestId)
-            return;
-        const owned = this.queuedByMcp.get(mcpRequestId) ?? [];
-        owned.push(item);
-        this.queuedByMcp.set(mcpRequestId, owned);
-    }
-    detachQueued(item) {
-        if (!item.mcpRequestId)
-            return;
-        const owned = this.queuedByMcp.get(item.mcpRequestId);
-        if (!owned)
-            return;
-        const index = owned.indexOf(item);
-        if (index >= 0)
-            owned.splice(index, 1);
-        if (owned.length === 0)
-            this.queuedByMcp.delete(item.mcpRequestId);
-    }
-    takeQueued(mcpRequestId) {
-        const owned = this.queuedByMcp.get(mcpRequestId);
-        if (!owned)
-            return [];
-        this.queuedByMcp.delete(mcpRequestId);
-        return owned;
-    }
-    settle(autoId) {
-        const mcpRequestId = this.mcpByAuto.get(autoId);
-        if (mcpRequestId === undefined)
-            return;
-        this.mcpByAuto.delete(autoId);
-        const autos = this.autosByMcp.get(mcpRequestId);
-        autos?.delete(autoId);
-        if (autos?.size === 0)
-            this.autosByMcp.delete(mcpRequestId);
-    }
-    cancel(mcpRequestId, delivery) {
-        const autos = this.autosByMcp.get(mcpRequestId);
-        if (!autos)
-            return;
-        this.autosByMcp.delete(mcpRequestId);
-        for (const autoId of autos) {
-            this.mcpByAuto.delete(autoId);
-            try {
-                delivery.sendFrame(autoId);
-            }
-            catch {
-                delivery.log.warn('Failed to deliver cancel_request frame to Unreal', { autoId });
-            }
-            try {
-                delivery.rejectUnderlying(autoId);
-            }
-            catch {
-            }
-        }
-    }
-    clear() {
-        this.autosByMcp.clear();
-        this.mcpByAuto.clear();
-        this.queuedByMcp.clear();
-    }
-}
-//# sourceMappingURL=request-correlation.js.map

package/dist/automation/request-tracker.d.ts

@@ -1,32 +0,0 @@
-import { PendingRequest, AutomationBridgeResponseMessage } from './types.js';
-import type { NaturalTimeoutObserver, RequestTrackerRequestSpec } from './types.js';
-export declare class RequestTracker {
-    private maxPendingRequests;
-    private pendingRequests;
-    private lastRequestSentAt?;
-    private naturalTimeoutObserver?;
-    constructor(maxPendingRequests: number);
-    getMaxPendingRequests(): number;
-    getLastRequestSentAt(): Date | undefined;
-    updateLastRequestSentAt(): void;
-    setNaturalTimeoutObserver(observer: NaturalTimeoutObserver | undefined): void;
-    createRequest(spec: RequestTrackerRequestSpec): {
-        requestId: string;
-        promise: Promise<AutomationBridgeResponseMessage>;
-    };
-    extendTimeout(requestId: string, percent?: number): boolean;
-    private settleNaturalTimeout;
-    private clearRequestTimers;
-    private cleanupRequest;
-    getPendingRequest(requestId: string): PendingRequest | undefined;
-    resolveRequest(requestId: string, response: AutomationBridgeResponseMessage): void;
-    rejectRequest(requestId: string, error: Error): void;
-    rejectAll(error: Error): void;
-    getPendingCount(): number;
-    getPendingDetails(): Array<{
-        requestId: string;
-        action: string;
-        ageMs: number;
-    }>;
-}
-//# sourceMappingURL=request-tracker.d.ts.map

package/dist/automation/request-tracker.js

@@ -1,139 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { PROGRESS_EXTENSION_MS, MAX_PROGRESS_EXTENSIONS, PROGRESS_STALE_THRESHOLD, ABSOLUTE_MAX_TIMEOUT_MS } from '../constants.js';
-export class RequestTracker {
-    maxPendingRequests;
-    pendingRequests = new Map();
-    lastRequestSentAt;
-    naturalTimeoutObserver;
-    constructor(maxPendingRequests) {
-        this.maxPendingRequests = maxPendingRequests;
-    }
-    getMaxPendingRequests() {
-        return this.maxPendingRequests;
-    }
-    getLastRequestSentAt() {
-        return this.lastRequestSentAt;
-    }
-    updateLastRequestSentAt() {
-        this.lastRequestSentAt = new Date();
-    }
-    setNaturalTimeoutObserver(observer) {
-        this.naturalTimeoutObserver = observer;
-    }
-    createRequest(spec) {
-        const { action, payload, timeoutMs } = spec;
-        if (this.pendingRequests.size >= this.maxPendingRequests) {
-            throw new Error(`Max pending requests limit reached (${this.maxPendingRequests})`);
-        }
-        const requestId = randomUUID();
-        const promise = new Promise((resolve, reject) => {
-            const timeout = setTimeout(() => {
-                this.settleNaturalTimeout(requestId, 'ordinary_deadline', new Error(`Request ${requestId} timed out after ${timeoutMs}ms`));
-            }, timeoutMs);
-            const absoluteTimeout = setTimeout(() => {
-                this.settleNaturalTimeout(requestId, 'absolute_deadline', new Error(`Request ${requestId} exceeded absolute max timeout (${ABSOLUTE_MAX_TIMEOUT_MS}ms)`));
-            }, ABSOLUTE_MAX_TIMEOUT_MS);
-            this.pendingRequests.set(requestId, {
-                resolve,
-                reject,
-                timeout,
-                action,
-                payload,
-                requestedAt: new Date(),
-                extensionCount: 0,
-                lastProgressPercent: undefined,
-                staleCount: 0,
-                absoluteTimeout
-            });
-        });
-        return { requestId, promise };
-    }
-    extendTimeout(requestId, percent) {
-        const pending = this.pendingRequests.get(requestId);
-        if (!pending) {
-            return false;
-        }
-        if (pending.extensionCount !== undefined && pending.extensionCount >= MAX_PROGRESS_EXTENSIONS) {
-            this.settleNaturalTimeout(requestId, 'extension_cap', new Error(`Request ${requestId} exceeded max progress extensions (${MAX_PROGRESS_EXTENSIONS}) - possible deadlock detected`));
-            return false;
-        }
-        if (percent !== undefined && pending.lastProgressPercent === percent) {
-            pending.staleCount = (pending.staleCount || 0) + 1;
-            if (pending.staleCount >= PROGRESS_STALE_THRESHOLD) {
-                this.settleNaturalTimeout(requestId, 'stale_progress', new Error(`Request ${requestId} stalled - progress unchanged at ${percent}% for ${PROGRESS_STALE_THRESHOLD} updates`));
-                return false;
-            }
-        }
-        else {
-            pending.staleCount = 0;
-        }
-        clearTimeout(pending.timeout);
-        const newTimeout = setTimeout(() => {
-            this.settleNaturalTimeout(requestId, 'progress_extension_deadline', new Error(`Request ${requestId} timed out after extension`));
-        }, PROGRESS_EXTENSION_MS);
-        pending.timeout = newTimeout;
-        pending.extensionCount = (pending.extensionCount || 0) + 1;
-        pending.lastProgressPercent = percent;
-        return true;
-    }
-    settleNaturalTimeout(requestId, kind, error) {
-        const pending = this.pendingRequests.get(requestId);
-        if (!pending)
-            return;
-        this.cleanupRequest(requestId);
-        this.naturalTimeoutObserver?.({
-            requestId,
-            action: pending.action,
-            kind,
-            error
-        });
-        pending.reject(error);
-    }
-    clearRequestTimers(pending) {
-        clearTimeout(pending.timeout);
-        if (pending.absoluteTimeout)
-            clearTimeout(pending.absoluteTimeout);
-    }
-    cleanupRequest(requestId) {
-        const pending = this.pendingRequests.get(requestId);
-        if (pending) {
-            this.clearRequestTimers(pending);
-            this.pendingRequests.delete(requestId);
-        }
-        return pending;
-    }
-    getPendingRequest(requestId) {
-        return this.pendingRequests.get(requestId);
-    }
-    resolveRequest(requestId, response) {
-        const pending = this.cleanupRequest(requestId);
-        if (pending) {
-            pending.resolve(response);
-        }
-    }
-    rejectRequest(requestId, error) {
-        const pending = this.cleanupRequest(requestId);
-        if (pending) {
-            pending.reject(error);
-        }
-    }
-    rejectAll(error) {
-        for (const [, pending] of this.pendingRequests) {
-            this.clearRequestTimers(pending);
-            pending.reject(error);
-        }
-        this.pendingRequests.clear();
-    }
-    getPendingCount() {
-        return this.pendingRequests.size;
-    }
-    getPendingDetails() {
-        const now = Date.now();
-        return Array.from(this.pendingRequests.entries()).map(([id, pending]) => ({
-            requestId: id,
-            action: pending.action,
-            ageMs: Math.max(0, now - pending.requestedAt.getTime())
-        }));
-    }
-}
-//# sourceMappingURL=request-tracker.js.map

package/dist/automation/socket.test-support.d.ts

@@ -1,9 +0,0 @@
-import net from 'node:net';
-import { WebSocket, WebSocketServer } from 'ws';
-export declare function listenTcp(server: net.Server): Promise<number>;
-export declare function startAckServer(ack?: Record<string, unknown>, onMessage?: (message: Record<string, unknown>, socket: WebSocket) => void, sameWrite?: readonly Record<string, unknown>[]): Promise<{
-    server: WebSocketServer;
-    port: number;
-}>;
-export declare function closeServer(server: net.Server | WebSocketServer): Promise<void>;
-//# sourceMappingURL=socket.test-support.d.ts.map

package/dist/automation/socket.test-support.js

@@ -1,55 +0,0 @@
-import { WebSocketServer } from 'ws';
-function portOf(address) {
-    if (!address || typeof address === 'string')
-        throw new Error('Failed to bind test server');
-    return address.port;
-}
-export async function listenTcp(server) {
-    await new Promise((resolve, reject) => {
-        server.once('error', reject);
-        server.listen(0, '127.0.0.1', resolve);
-    });
-    return portOf(server.address());
-}
-function textFrame(message) {
-    const payload = Buffer.from(JSON.stringify(message), 'utf8');
-    if (payload.length > 0xffff)
-        throw new Error('textFrame: payload over 64 KiB');
-    const header = payload.length < 126
-        ? Buffer.from([0x81, payload.length])
-        : Buffer.from([0x81, 126, payload.length >> 8, payload.length & 0xff]);
-    return Buffer.concat([header, payload]);
-}
-export async function startAckServer(ack = {}, onMessage, sameWrite = []) {
-    const server = new WebSocketServer({ host: '127.0.0.1', port: 0 });
-    server.on('connection', (socket) => {
-        socket.on('message', (data) => {
-            const message = JSON.parse(data.toString());
-            if (message.type !== 'bridge_hello') {
-                onMessage?.(message, socket);
-                return;
-            }
-            const ackMessage = { type: 'bridge_ack', ...ack };
-            if (sameWrite.length === 0) {
-                socket.send(JSON.stringify(ackMessage));
-                return;
-            }
-            const raw = socket._socket;
-            raw.write(Buffer.concat([ackMessage, ...sameWrite].map(textFrame)));
-        });
-    });
-    await new Promise((resolve, reject) => {
-        server.once('error', reject);
-        server.once('listening', () => resolve());
-    });
-    return { server, port: portOf(server.address()) };
-}
-export async function closeServer(server) {
-    if (server instanceof WebSocketServer)
-        for (const client of server.clients)
-            client.terminate();
-    await new Promise((resolve, reject) => {
-        server.close((error) => (error ? reject(error) : resolve()));
-    });
-}
-//# sourceMappingURL=socket.test-support.js.map

package/dist/automation/types.d.ts

@@ -1,198 +0,0 @@
-import { WebSocket } from 'ws';
-import type { ExpectedRevisions } from '../tools/catalog/capabilities/semantic/execution-options.js';
-import type { LiveStateRevisions } from '../tools/catalog/capabilities/semantic/live-state-revisions.js';
-import type { Logger } from '../utils/logging/logger.js';
-export interface AutomationBridgeOptions {
-    host?: string | null;
-    port?: number;
-    protocols?: string[];
-    capabilityToken?: string;
-    enabled?: boolean;
-    serverName?: string;
-    serverVersion?: string;
-    heartbeatIntervalMs?: number;
-    connectionTimeoutMs?: number;
-    maxPendingRequests?: number;
-    maxQueuedRequests?: number;
-    maxInboundMessagesPerMinute?: number;
-    useTls?: boolean;
-    allowNonLoopback?: boolean;
-}
-export interface AutomationBridgeMessage {
-    type: string;
-    [key: string]: unknown;
-}
-export interface AutomationBridgeAutomationEvent {
-    [key: string]: unknown;
-    type: 'automation_event';
-    event: string;
-    requestId?: string;
-    payload?: unknown;
-    result?: unknown;
-    message?: string;
-}
-export interface CancelRequestMessage extends AutomationBridgeMessage {
-    type: 'cancel_request';
-    requestId: string;
-    reason?: string;
-}
-export interface AutomationBridgeResponseMessage extends AutomationBridgeMessage {
-    requestId: string;
-    success?: boolean;
-    message?: string;
-    error?: string;
-    result?: unknown;
-    liveRevisions?: LiveStateRevisions;
-}
-export type PendingRequestDetail = {
-    requestId: string;
-    action: string;
-    ageMs: number;
-};
-export type AutomationBridgeConnectionInfo = {
-    connectionId: string;
-    sessionId: string | null;
-    remoteAddress: string | null;
-    remotePort: number | null;
-    port: number;
-    connectedAt: string;
-    protocol: string | null;
-    readyState: number;
-    isPrimary: boolean;
-};
-export type AutomationBridgeConnectedEvent = {
-    socket: WebSocket;
-    metadata: Record<string, unknown>;
-    port: number;
-    protocol: string | null;
-};
-export type AutomationBridgeDisconnectedEvent = {
-    code: number;
-    reason: string;
-    port: number;
-    protocol: string | null;
-};
-export type AutomationBridgePortError = Error & {
-    port?: number;
-};
-export interface ProgressUpdateMessage extends AutomationBridgeMessage {
-    type: 'progress_update';
-    requestId: string;
-    percent?: number;
-    message?: string;
-    timestamp?: string;
-    stillWorking?: boolean;
-}
-export interface AutomationBridgeStatus {
-    enabled: boolean;
-    host: string;
-    port: number;
-    connected: boolean;
-    connectedAt: string | null;
-    activePort: number | null;
-    negotiatedProtocol: string | null;
-    supportedProtocols: string[];
-    capabilityTokenRequired: boolean;
-    lastHandshakeAt: string | null;
-    lastHandshakeMetadata: Record<string, unknown> | null;
-    lastHandshakeFailure: {
-        reason: string;
-        at: string;
-    } | null;
-    lastDisconnect: {
-        code: number;
-        reason: string;
-        at: string;
-    } | null;
-    lastError: {
-        message: string;
-        at: string;
-    } | null;
-    lastMessageAt: string | null;
-    lastRequestSentAt: string | null;
-    pendingRequests: number;
-    pendingRequestDetails: PendingRequestDetail[];
-    connections: AutomationBridgeConnectionInfo[];
-    serverName: string;
-    serverVersion: string;
-    maxPendingRequests: number;
-    heartbeatIntervalMs: number;
-}
-export interface AutomationProgressUpdate {
-    readonly progress: number;
-    readonly total?: number;
-    readonly message?: string;
-}
-export type AutomationProgressListener = (mcpRequestId: string, update: AutomationProgressUpdate) => void;
-export interface RequestTrackerRequestSpec {
-    readonly action: string;
-    readonly payload: Record<string, unknown>;
-    readonly timeoutMs: number;
-}
-export type NaturalTimeoutKind = 'ordinary_deadline' | 'progress_extension_deadline' | 'stale_progress' | 'extension_cap' | 'absolute_deadline';
-export interface NaturalTimeoutNotification {
-    readonly requestId: string;
-    readonly action: string;
-    readonly kind: NaturalTimeoutKind;
-    readonly error: Error;
-}
-export type NaturalTimeoutObserver = (notification: NaturalTimeoutNotification) => void;
-export interface PendingRequest {
-    resolve: (value: AutomationBridgeResponseMessage) => void;
-    reject: (reason: Error) => void;
-    timeout: NodeJS.Timeout;
-    action: string;
-    payload: Record<string, unknown>;
-    requestedAt: Date;
-    extensionCount?: number;
-    lastProgressPercent?: number;
-    staleCount?: number;
-    absoluteTimeout?: NodeJS.Timeout;
-}
-export type AutomationRequestOptions = {
-    timeoutMs?: number;
-    mcpRequestId?: string;
-    correlationId?: string;
-    consent?: {
-        capability: string;
-        acknowledge: 'explicit' | 'elevated';
-    };
-    expectedRevisions?: ExpectedRevisions;
-};
-export interface QueuedRequestItem {
-    resolve: (value: unknown) => void;
-    reject: (reason: unknown) => void;
-    action: string;
-    payload: Record<string, unknown>;
-    options: AutomationRequestOptions;
-    mcpRequestId?: string;
-}
-export interface SocketInfo {
-    connectionId: string;
-    port: number;
-    connectedAt: Date;
-    protocol?: string;
-    sessionId?: string;
-    remoteAddress?: string;
-    remotePort?: number;
-}
-export type AutomationBridgeEvents = {
-    connected: (info: AutomationBridgeConnectedEvent) => void;
-    disconnected: (info: AutomationBridgeDisconnectedEvent) => void;
-    message: (message: AutomationBridgeMessage) => void;
-    automationEvent: (event: AutomationBridgeAutomationEvent) => void;
-    error: (error: AutomationBridgePortError) => void;
-    handshakeFailed: (info: {
-        reason: string;
-        port: number;
-    }) => void;
-};
-export interface ConnectionControlDependencies {
-    readonly log: Logger;
-    readonly startClient: () => void;
-    readonly abortPendingConnection: (reason: Error) => void;
-    readonly describeTarget?: () => string;
-    readonly once: <K extends keyof AutomationBridgeEvents>(event: K, listener: AutomationBridgeEvents[K]) => void;
-    readonly off: <K extends keyof AutomationBridgeEvents>(event: K, listener: AutomationBridgeEvents[K]) => void;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/automation/types.js

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

package/dist/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/config.d.ts

@@ -1,38 +0,0 @@
-import { z } from 'zod';
-export declare const stringToPositiveInteger: (val: unknown, defaultVal: number) => number;
-export declare const EnvSchema: z.ZodPreprocess<z.ZodObject<{
-    NODE_ENV: z.ZodDefault<z.ZodEnum<{
-        test: "test";
-        development: "development";
-        production: "production";
-    }>>;
-    UE_PROJECT_PATH: z.ZodOptional<z.ZodString>;
-    MCP_CONNECTION_TIMEOUT_MS: z.ZodDefault<z.ZodPreprocess<z.ZodNumber>>;
-    MCP_ADDITIONAL_PATH_PREFIXES: z.ZodDefault<z.ZodString>;
-}, z.core.$strip>>;
-export type Config = z.infer<typeof EnvSchema>;
-declare let config: Config;
-export { config };
-export declare function requestTimeoutOverrideMs(env?: NodeJS.ProcessEnv): number | undefined;
-export declare const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
-export declare const MIN_CAPABILITY_TIMEOUT_MS = 15000;
-export declare const CAPABILITY_TIMEOUT_TIER_MS: Readonly<{
-    instant: Readonly<{
-        low: 15000;
-        medium: 30000;
-        high: 60000;
-    }>;
-    interactive: Readonly<{
-        low: 60000;
-        medium: 120000;
-        high: 240000;
-    }>;
-    'long-running': Readonly<{
-        low: 300000;
-        medium: 600000;
-        high: 1200000;
-    }>;
-}>;
-export declare const UNKNOWN_CAPABILITY_TIMEOUT_MS: 120000;
-export declare function getAdditionalPathPrefixes(): string[];
-//# sourceMappingURL=config.d.ts.map